@ekz/lexical-link 0.40.0

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

package/EkzLexicalLink.mjs

@@ -0,0 +1,28 @@
+/**
+ * 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 './EkzLexicalLink.dev.mjs';
+import * as modProd from './EkzLexicalLink.prod.mjs';
+const mod = process.env.NODE_ENV !== 'production' ? modDev : modProd;
+export const $createAutoLinkNode = mod.$createAutoLinkNode;
+export const $createLinkNode = mod.$createLinkNode;
+export const $isAutoLinkNode = mod.$isAutoLinkNode;
+export const $isLinkNode = mod.$isLinkNode;
+export const $toggleLink = mod.$toggleLink;
+export const AutoLinkExtension = mod.AutoLinkExtension;
+export const AutoLinkNode = mod.AutoLinkNode;
+export const ClickableLinkExtension = mod.ClickableLinkExtension;
+export const LinkExtension = mod.LinkExtension;
+export const LinkNode = mod.LinkNode;
+export const TOGGLE_LINK_COMMAND = mod.TOGGLE_LINK_COMMAND;
+export const createLinkMatcherWithRegExp = mod.createLinkMatcherWithRegExp;
+export const formatUrl = mod.formatUrl;
+export const registerAutoLink = mod.registerAutoLink;
+export const registerClickableLink = mod.registerClickableLink;
+export const registerLink = mod.registerLink;
+export const toggleLink = mod.toggleLink;

package/EkzLexicalLink.node.mjs

@@ -0,0 +1,26 @@
+/**
+ * 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('./EkzLexicalLink.dev.mjs') : import('./EkzLexicalLink.prod.mjs'));
+export const $createAutoLinkNode = mod.$createAutoLinkNode;
+export const $createLinkNode = mod.$createLinkNode;
+export const $isAutoLinkNode = mod.$isAutoLinkNode;
+export const $isLinkNode = mod.$isLinkNode;
+export const $toggleLink = mod.$toggleLink;
+export const AutoLinkExtension = mod.AutoLinkExtension;
+export const AutoLinkNode = mod.AutoLinkNode;
+export const ClickableLinkExtension = mod.ClickableLinkExtension;
+export const LinkExtension = mod.LinkExtension;
+export const LinkNode = mod.LinkNode;
+export const TOGGLE_LINK_COMMAND = mod.TOGGLE_LINK_COMMAND;
+export const createLinkMatcherWithRegExp = mod.createLinkMatcherWithRegExp;
+export const formatUrl = mod.formatUrl;
+export const registerAutoLink = mod.registerAutoLink;
+export const registerClickableLink = mod.registerClickableLink;
+export const registerLink = mod.registerLink;
+export const toggleLink = mod.toggleLink;

package/EkzLexicalLink.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-utils"),t=require("@ekz/lexical"),n=require("@ekz/lexical-extension");const r=new Set(["http:","https:","mailto:","sms:","tel:"]);class i extends t.ElementNode{__url;__target;__rel;__title;static getType(){return"link"}static clone(e){return new i(e.__url,{rel:e.__rel,target:e.__target,title:e.__title},e.__key)}constructor(e="",t={},n){super(n);const{target:r=null,rel:i=null,title:s=null}=t;this.__url=e,this.__target=r,this.__rel=i,this.__title=s}createDOM(t){const n=document.createElement("a");return this.updateLinkDOM(null,n,t),e.addClassNamesToElement(n,t.theme.link),n}updateLinkDOM(t,n,r){if(e.isHTMLAnchorElement(n)){t&&t.__url===this.__url||(n.href=this.sanitizeUrl(this.__url));for(const e of["target","rel","title"]){const r=`__${e}`,i=this[r];t&&t[r]===i||(i?n[e]=i:n.removeAttribute(e))}}}updateDOM(e,t,n){return this.updateLinkDOM(e,t,n),!1}static importDOM(){return{a:e=>({conversion:s,priority:1})}}static importJSON(e){return l().updateFromJSON(e)}updateFromJSON(e){return super.updateFromJSON(e).setURL(e.url).setRel(e.rel||null).setTarget(e.target||null).setTitle(e.title||null)}sanitizeUrl(e){e=p(e);try{const t=new URL(p(e));if(!r.has(t.protocol))return"about:blank"}catch(t){return e}return e}exportJSON(){return{...super.exportJSON(),rel:this.getRel(),target:this.getTarget(),title:this.getTitle(),url:this.getURL()}}getURL(){return this.getLatest().__url}setURL(e){const t=this.getWritable();return t.__url=e,t}getTarget(){return this.getLatest().__target}setTarget(e){const t=this.getWritable();return t.__target=e,t}getRel(){return this.getLatest().__rel}setRel(e){const t=this.getWritable();return t.__rel=e,t}getTitle(){return this.getLatest().__title}setTitle(e){const t=this.getWritable();return t.__title=e,t}insertNewAfter(e,t=!0){const n=l(this.__url,{rel:this.__rel,target:this.__target,title:this.__title});return this.insertAfter(n,t),n}canInsertTextBefore(){return!1}canInsertTextAfter(){return!1}canBeEmpty(){return!1}isInline(){return!0}extractWithChild(e,n,r){if(!t.$isRangeSelection(n))return!1;const i=n.anchor.getNode(),s=n.focus.getNode();return this.isParentOf(i)&&this.isParentOf(s)&&n.getTextContent().length>0}isEmailURI(){return this.__url.startsWith("mailto:")}isWebSiteURI(){return this.__url.startsWith("https://")||this.__url.startsWith("http://")}}function s(t){let n=null;if(e.isHTMLAnchorElement(t)){const e=t.textContent;(null!==e&&""!==e||t.children.length>0)&&(n=l(t.getAttribute("href")||"",{rel:t.getAttribute("rel"),target:t.getAttribute("target"),title:t.getAttribute("title")}))}return{node:n}}function l(e="",n){return t.$applyNodeReplacement(new i(e,n))}function o(e){return e instanceof i}class a extends i{__isUnlinked;constructor(e="",t={},n){super(e,t,n),this.__isUnlinked=void 0!==t.isUnlinked&&null!==t.isUnlinked&&t.isUnlinked}static getType(){return"autolink"}static clone(e){return new a(e.__url,{isUnlinked:e.__isUnlinked,rel:e.__rel,target:e.__target,title:e.__title},e.__key)}getIsUnlinked(){return this.__isUnlinked}setIsUnlinked(e){const t=this.getWritable();return t.__isUnlinked=e,t}createDOM(e){return this.__isUnlinked?document.createElement("span"):super.createDOM(e)}updateDOM(e,t,n){return super.updateDOM(e,t,n)||e.__isUnlinked!==this.__isUnlinked}static importJSON(e){return u().updateFromJSON(e)}updateFromJSON(e){return super.updateFromJSON(e).setIsUnlinked(e.isUnlinked||!1)}static importDOM(){return null}exportJSON(){return{...super.exportJSON(),isUnlinked:this.__isUnlinked}}insertNewAfter(e,n=!0){const r=this.getParentOrThrow().insertNewAfter(e,n);if(t.$isElementNode(r)){const e=u(this.__url,{isUnlinked:this.__isUnlinked,rel:this.__rel,target:this.__target,title:this.__title});return r.append(e),e}return null}}function u(e="",n){return t.$applyNodeReplacement(new a(e,n))}function c(e){return e instanceof a}const g=t.createCommand("TOGGLE_LINK_COMMAND");function d(e,n){if("element"===e.type){const r=e.getNode();t.$isElementNode(r)||function(e,...t){const n=new URL("https://lexical.dev/docs/error"),r=new URLSearchParams;r.append("code",e);for(const e of t)r.append("v",e);throw n.search=r.toString(),Error(`Minified Lexical error #${e}; visit ${n.toString()} for the full message or use the non-minified dev environment for full errors and additional helpful warnings.`)}(252);return r.getChildren()[e.offset+n]||null}return null}function f(n,r={}){let i;if(n&&"object"==typeof n){const{url:e,...t}=n;i=e,r={...t,...r}}else i=n;const{target:s,title:a}=r,u=void 0===r.rel?"noreferrer":r.rel,g=t.$getSelection();if(null===g||!t.$isRangeSelection(g)&&!t.$isNodeSelection(g))return;if(t.$isNodeSelection(g)){const t=g.getNodes();if(0===t.length)return;return void t.forEach(t=>{if(null===i){const n=e.$findMatchingParent(t,e=>!c(e)&&o(e));n&&(n.insertBefore(t),0===n.getChildren().length&&n.remove())}else{const n=e.$findMatchingParent(t,e=>!c(e)&&o(e));if(n)n.setURL(i),void 0!==s&&n.setTarget(s),void 0!==u&&n.setRel(u);else{const e=l(i,{rel:u,target:s});t.insertBefore(e),e.append(t)}}})}const f=g.extract();if(null===i){const e=new Set;return void f.forEach(t=>{const n=t.getParent();if(o(n)&&!c(n)){const t=n.getKey();if(e.has(t))return;!function(e,t){const n=new Set(t.filter(t=>e.isParentOf(t)).map(e=>e.getKey())),r=e.getChildren(),i=r.filter(e=>n.has(e.getKey()));if(i.length===r.length)return r.forEach(t=>e.insertBefore(t)),void e.remove();const s=r.findIndex(e=>n.has(e.getKey())),o=r.findLastIndex(e=>n.has(e.getKey())),a=0===s,u=o===r.length-1;if(a)i.forEach(t=>e.insertBefore(t));else if(u)for(let t=i.length-1;t>=0;t--)e.insertAfter(i[t]);else{for(let t=i.length-1;t>=0;t--)e.insertAfter(i[t]);const t=r.slice(o+1);if(t.length>0){const n=l(e.getURL(),{rel:e.getRel(),target:e.getTarget(),title:e.getTitle()});i[i.length-1].insertAfter(n),t.forEach(e=>n.append(e))}}}(n,f),e.add(t)}})}const h=new Set,p=e=>{h.has(e.getKey())||(h.add(e.getKey()),e.setURL(i),void 0!==s&&e.setTarget(s),void 0!==u&&e.setRel(u),void 0!==a&&e.setTitle(a))};if(1===f.length){const t=f[0],n=e.$findMatchingParent(t,o);if(null!==n)return p(n)}!function(e){const n=t.$getSelection();if(!t.$isRangeSelection(n))return e();const r=t.$normalizeSelection__EXPERIMENTAL(n),i=r.isBackward(),s=d(r.anchor,i?-1:0),l=d(r.focus,i?0:-1),o=e();if(s||l){const e=t.$getSelection();if(t.$isRangeSelection(e)){const n=e.clone();if(s){const e=s.getParent();e&&n.anchor.set(e.getKey(),s.getIndexWithinParent()+(i?1:0),"element")}if(l){const e=l.getParent();e&&n.focus.set(e.getKey(),l.getIndexWithinParent()+(i?0:1),"element")}t.$setSelection(t.$normalizeSelection__EXPERIMENTAL(n))}}}(()=>{let n=null;for(const r of f){if(!r.isAttached())continue;const g=e.$findMatchingParent(r,o);if(g){p(g);continue}if(t.$isElementNode(r)){if(!r.isInline())continue;if(o(r)){if(!(c(r)||null!==n&&n.getParentOrThrow().isParentOf(r))){p(r),n=r;continue}for(const e of r.getChildren())r.insertBefore(e);r.remove();continue}}const d=r.getPreviousSibling();o(d)&&d.is(n)?d.append(r):(n=l(i,{rel:u,target:s,title:a}),r.insertAfter(n),n.append(r))}})}const h=/^\+?[0-9\s()-]{5,}$/;function p(e){return e.match(/^[a-z][a-z0-9+.-]*:/i)||e.match(/^[/#.]/)?e:e.includes("@")?`mailto:${e}`:h.test(e)?`tel:${e}`:`https://${e}`}const _={attributes:void 0,validateUrl:void 0};function m(r,i){return e.mergeRegister(n.effect(()=>r.registerCommand(g,e=>{const t=i.validateUrl.peek(),n=i.attributes.peek();if(null===e)return f(null),!0;if("string"==typeof e)return!(void 0!==t&&!t(e))&&(f(e,n),!0);{const{url:t,target:r,rel:i,title:s}=e;return f(t,{...n,rel:i,target:r,title:s}),!0}},t.COMMAND_PRIORITY_LOW)),n.effect(()=>{const n=i.validateUrl.value;if(!n)return;const s=i.attributes.value;return r.registerCommand(t.PASTE_COMMAND,i=>{const l=t.$getSelection();if(!t.$isRangeSelection(l)||l.isCollapsed()||!e.objectKlassEquals(i,ClipboardEvent))return!1;if(null===i.clipboardData)return!1;const o=i.clipboardData.getData("text");return!!n(o)&&(!l.getNodes().some(e=>t.$isElementNode(e))&&(r.dispatchCommand(g,{...s,url:o}),i.preventDefault(),!0))},t.COMMAND_PRIORITY_LOW)}))}const x=t.defineExtension({build:(e,t,r)=>n.namedSignals(t),config:_,mergeConfig(e,n){const r=t.shallowMergeConfig(e,n);return e.attributes&&(r.attributes=t.shallowMergeConfig(e.attributes,r.attributes)),r},name:"@ekz/lexical-link/Link",nodes:()=>[i],register:(e,t,n)=>m(e,n.getOutput())});function k(n,r,i={}){const s=i=>{const s=i.target;if(!t.isDOMNode(s))return;const l=t.getNearestEditorFromDOMNode(s);if(null===l)return;let a=null,u=null;if(l.update(()=>{const n=t.$getNearestNodeFromDOMNode(s);if(null!==n){const i=e.$findMatchingParent(n,t.$isElementNode);if(!r.disabled.peek())if(o(i))a=i.sanitizeUrl(i.getURL()),u=i.getTarget();else{const t=function(e,t){let n=e;for(;null!=n;){if(t(n))return n;n=n.parentNode}return null}(s,e.isHTMLAnchorElement);null!==t&&(a=t.href,u=t.target)}}}),null===a||""===a)return;const c=n.getEditorState().read(t.$getSelection);if(t.$isRangeSelection(c)&&!c.isCollapsed())return void i.preventDefault();const g="auxclick"===i.type&&1===i.button;window.open(a,r.newTab.peek()||g||i.metaKey||i.ctrlKey||"_blank"===u?"_blank":"_self"),i.preventDefault()},l=e=>{1===e.button&&s(e)};return n.registerRootListener((e,t)=>{null!==t&&(t.removeEventListener("click",s),t.removeEventListener("mouseup",l)),null!==e&&(e.addEventListener("click",s,i),e.addEventListener("mouseup",l,i))})}const N=t.defineExtension({build:(e,t,r)=>n.namedSignals(t),config:t.safeCast({disabled:!1,newTab:!1}),dependencies:[x],name:"@ekz/lexical-link/ClickableLink",register:(e,t,n)=>k(e,n.getOutput())});function L(e,t){for(let n=0;n<t.length;n++){const r=t[n](e);if(r)return r}return null}const T=/[.,;\s]/;function S(e){return T.test(e)}function $(e){return S(e[e.length-1])}function b(e){return S(e[0])}function U(e){let n=e.getPreviousSibling();return t.$isElementNode(n)&&(n=n.getLastDescendant()),null===n||t.$isLineBreakNode(n)||t.$isTextNode(n)&&$(n.getTextContent())}function R(e){let n=e.getNextSibling();return t.$isElementNode(n)&&(n=n.getFirstDescendant()),null===n||t.$isLineBreakNode(n)||t.$isTextNode(n)&&b(n.getTextContent())}function v(e,t,n,r){if(!(e>0?S(n[e-1]):U(r[0])))return!1;return t<n.length?S(n[t]):R(r[r.length-1])}function O(e,t,n){const r=[],i=[],s=[];let l=0,o=0;const a=[...e];for(;a.length>0;){const e=a[0],u=e.getTextContent().length,c=o;o+u<=t?(r.push(e),l+=u):c>=n?s.push(e):i.push(e),o+=u,a.shift()}return[l,r,i,s]}function E(e,n,r,i){const s=u(i.url,i.attributes);if(1===e.length){let l,o=e[0];0===n?[l,o]=o.splitText(r):[,l,o]=o.splitText(n,r);const a=t.$createTextNode(i.text);return a.setFormat(l.getFormat()),a.setDetail(l.getDetail()),a.setStyle(l.getStyle()),s.append(a),l.replace(s),o}if(e.length>1){const i=e[0];let l,o=i.getTextContent().length;0===n?l=i:[,l]=i.splitText(n);const a=[];let u;for(let t=1;t<e.length;t++){const n=e[t],i=n.getTextContent().length,s=o;if(s<r)if(o+i<=r)a.push(n);else{const[e,t]=n.splitText(r-s);a.push(e),u=t}o+=i}const c=t.$getSelection(),g=c?c.getNodes().find(t.$isTextNode):void 0,d=t.$createTextNode(l.getTextContent());return d.setFormat(l.getFormat()),d.setDetail(l.getDetail()),d.setStyle(l.getStyle()),s.append(d,...a),g&&g===l&&(t.$isRangeSelection(c)?d.select(c.anchor.offset,c.focus.offset):t.$isNodeSelection(c)&&d.select(0,d.getTextContent().length)),l.replace(s),u}}function C(e,n,r){const i=e.getChildren(),s=i.length;for(let n=0;n<s;n++){const s=i[n];if(!t.$isTextNode(s)||!s.isSimpleText())return M(e),void r(null,e.getURL())}const l=e.getTextContent(),o=L(l,n);if(null===o||o.text!==l)return M(e),void r(null,e.getURL());if(!U(e)||!R(e))return M(e),void r(null,e.getURL());const a=e.getURL();if(a!==o.url&&(e.setURL(o.url),r(o.url,a)),o.attributes){const t=e.getRel();t!==o.attributes.rel&&(e.setRel(o.attributes.rel||null),r(o.attributes.rel||null,t));const n=e.getTarget();n!==o.attributes.target&&(e.setTarget(o.attributes.target||null),r(o.attributes.target||null,n))}}function M(e){const t=e.getChildren();for(let n=t.length-1;n>=0;n--)e.insertAfter(t[n]);return e.remove(),t.map(e=>e.getLatest())}const A={changeHandlers:[],matchers:[]};function D(n,r=A){const{matchers:i,changeHandlers:s}=r,l=(e,t)=>{for(const n of s)n(e,t)};return e.mergeRegister(n.registerNodeTransform(t.TextNode,e=>{const n=e.getParentOrThrow(),r=e.getPreviousSibling();if(c(n)&&!n.getIsUnlinked())C(n,i,l);else if(!o(n)){if(e.isSimpleText()&&(b(e.getTextContent())||!c(r))){const n=function(e){const n=[e];let r=e.getNextSibling();for(;null!==r&&t.$isTextNode(r)&&r.isSimpleText()&&(n.push(r),!/[\s]/.test(r.getTextContent()));)r=r.getNextSibling();return n}(e);!function(e,t,n){let r=[...e];const i=r.map(e=>e.getTextContent()).join("");let s,l=i,o=0;for(;(s=L(l,t))&&null!==s;){const e=s.index,t=e+s.length;if(v(o+e,o+t,i,r)){const[i,,l,a]=O(r,o+e,o+t),u=E(l,o+e-i,o+t-i,s);r=u?[u,...a]:a,n(s.url,null),o=0}else o+=t;l=l.substring(t)}}(n,i,l)}!function(e,t,n){const r=e.getPreviousSibling(),i=e.getNextSibling(),s=e.getTextContent();var l;!c(r)||r.getIsUnlinked()||b(s)&&(l=s,!(r.isEmailURI()?/^\.[a-zA-Z]{2,}/.test(l):/^\.[a-zA-Z0-9]{1,}/.test(l)))||(r.append(e),C(r,t,n),n(null,r.getURL())),!c(i)||i.getIsUnlinked()||$(s)||(M(i),C(i,t,n),n(null,i.getURL()))}(e,i,l)}}),n.registerCommand(g,e=>{const n=t.$getSelection();if(null!==e||!t.$isRangeSelection(n))return!1;return n.extract().forEach(e=>{const t=e.getParent();c(t)&&(t.setIsUnlinked(!t.getIsUnlinked()),t.markDirty())}),!1},t.COMMAND_PRIORITY_LOW))}const y=t.defineExtension({config:A,dependencies:[x],mergeConfig(e,n){const r=t.shallowMergeConfig(e,n);for(const t of["matchers","changeHandlers"]){const i=n[t];Array.isArray(i)&&(r[t]=[...e[t],...i])}return r},name:"@ekz/lexical-link/AutoLink",register:D}),I=f;exports.$createAutoLinkNode=u,exports.$createLinkNode=l,exports.$isAutoLinkNode=c,exports.$isLinkNode=o,exports.$toggleLink=f,exports.AutoLinkExtension=y,exports.AutoLinkNode=a,exports.ClickableLinkExtension=N,exports.LinkExtension=x,exports.LinkNode=i,exports.TOGGLE_LINK_COMMAND=g,exports.createLinkMatcherWithRegExp=function(e,t=e=>e){return n=>{const r=e.exec(n);return null===r?null:{index:r.index,length:r[0].length,text:r[0],url:t(r[0])}}},exports.formatUrl=p,exports.registerAutoLink=D,exports.registerClickableLink=k,exports.registerLink=m,exports.toggleLink=I;

package/EkzLexicalLink.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{addClassNamesToElement as t,isHTMLAnchorElement as e,$findMatchingParent as n,mergeRegister as r,objectKlassEquals as i}from"@ekz/lexical-utils";import{createCommand as l,ElementNode as s,$isRangeSelection as o,$applyNodeReplacement as u,$isElementNode as a,$getSelection as c,$isNodeSelection as g,$normalizeSelection__EXPERIMENTAL as f,$setSelection as d,defineExtension as h,shallowMergeConfig as p,COMMAND_PRIORITY_LOW as _,PASTE_COMMAND as m,safeCast as x,isDOMNode as k,getNearestEditorFromDOMNode as b,$getNearestNodeFromDOMNode as U,TextNode as v,$isTextNode as T,$isLineBreakNode as L,$createTextNode as S}from"@ekz/lexical";import{namedSignals as O,effect as C}from"@ekz/lexical-extension";const R=new Set(["http:","https:","mailto:","sms:","tel:"]);class y extends s{__url;__target;__rel;__title;static getType(){return"link"}static clone(t){return new y(t.__url,{rel:t.__rel,target:t.__target,title:t.__title},t.__key)}constructor(t="",e={},n){super(n);const{target:r=null,rel:i=null,title:l=null}=e;this.__url=t,this.__target=r,this.__rel=i,this.__title=l}createDOM(e){const n=document.createElement("a");return this.updateLinkDOM(null,n,e),t(n,e.theme.link),n}updateLinkDOM(t,n,r){if(e(n)){t&&t.__url===this.__url||(n.href=this.sanitizeUrl(this.__url));for(const e of["target","rel","title"]){const r=`__${e}`,i=this[r];t&&t[r]===i||(i?n[e]=i:n.removeAttribute(e))}}}updateDOM(t,e,n){return this.updateLinkDOM(t,e,n),!1}static importDOM(){return{a:t=>({conversion:N,priority:1})}}static importJSON(t){return D().updateFromJSON(t)}updateFromJSON(t){return super.updateFromJSON(t).setURL(t.url).setRel(t.rel||null).setTarget(t.target||null).setTitle(t.title||null)}sanitizeUrl(t){t=K(t);try{const e=new URL(K(t));if(!R.has(e.protocol))return"about:blank"}catch(e){return t}return t}exportJSON(){return{...super.exportJSON(),rel:this.getRel(),target:this.getTarget(),title:this.getTitle(),url:this.getURL()}}getURL(){return this.getLatest().__url}setURL(t){const e=this.getWritable();return e.__url=t,e}getTarget(){return this.getLatest().__target}setTarget(t){const e=this.getWritable();return e.__target=t,e}getRel(){return this.getLatest().__rel}setRel(t){const e=this.getWritable();return e.__rel=t,e}getTitle(){return this.getLatest().__title}setTitle(t){const e=this.getWritable();return e.__title=t,e}insertNewAfter(t,e=!0){const n=D(this.__url,{rel:this.__rel,target:this.__target,title:this.__title});return this.insertAfter(n,e),n}canInsertTextBefore(){return!1}canInsertTextAfter(){return!1}canBeEmpty(){return!1}isInline(){return!0}extractWithChild(t,e,n){if(!o(e))return!1;const r=e.anchor.getNode(),i=e.focus.getNode();return this.isParentOf(r)&&this.isParentOf(i)&&e.getTextContent().length>0}isEmailURI(){return this.__url.startsWith("mailto:")}isWebSiteURI(){return this.__url.startsWith("https://")||this.__url.startsWith("http://")}}function N(t){let n=null;if(e(t)){const e=t.textContent;(null!==e&&""!==e||t.children.length>0)&&(n=D(t.getAttribute("href")||"",{rel:t.getAttribute("rel"),target:t.getAttribute("target"),title:t.getAttribute("title")}))}return{node:n}}function D(t="",e){return u(new y(t,e))}function w(t){return t instanceof y}class A extends y{__isUnlinked;constructor(t="",e={},n){super(t,e,n),this.__isUnlinked=void 0!==e.isUnlinked&&null!==e.isUnlinked&&e.isUnlinked}static getType(){return"autolink"}static clone(t){return new A(t.__url,{isUnlinked:t.__isUnlinked,rel:t.__rel,target:t.__target,title:t.__title},t.__key)}getIsUnlinked(){return this.__isUnlinked}setIsUnlinked(t){const e=this.getWritable();return e.__isUnlinked=t,e}createDOM(t){return this.__isUnlinked?document.createElement("span"):super.createDOM(t)}updateDOM(t,e,n){return super.updateDOM(t,e,n)||t.__isUnlinked!==this.__isUnlinked}static importJSON(t){return I().updateFromJSON(t)}updateFromJSON(t){return super.updateFromJSON(t).setIsUnlinked(t.isUnlinked||!1)}static importDOM(){return null}exportJSON(){return{...super.exportJSON(),isUnlinked:this.__isUnlinked}}insertNewAfter(t,e=!0){const n=this.getParentOrThrow().insertNewAfter(t,e);if(a(n)){const t=I(this.__url,{isUnlinked:this.__isUnlinked,rel:this.__rel,target:this.__target,title:this.__title});return n.append(t),t}return null}}function I(t="",e){return u(new A(t,e))}function E(t){return t instanceof A}const P=l("TOGGLE_LINK_COMMAND");function M(t,e){if("element"===t.type){const n=t.getNode();a(n)||function(t,...e){const n=new URL("https://lexical.dev/docs/error"),r=new URLSearchParams;r.append("code",t);for(const t of e)r.append("v",t);throw n.search=r.toString(),Error(`Minified Lexical error #${t}; visit ${n.toString()} for the full message or use the non-minified dev environment for full errors and additional helpful warnings.`)}(252);return n.getChildren()[t.offset+e]||null}return null}function z(t,e={}){let r;if(t&&"object"==typeof t){const{url:n,...i}=t;r=n,e={...i,...e}}else r=t;const{target:i,title:l}=e,s=void 0===e.rel?"noreferrer":e.rel,u=c();if(null===u||!o(u)&&!g(u))return;if(g(u)){const t=u.getNodes();if(0===t.length)return;return void t.forEach(t=>{if(null===r){const e=n(t,t=>!E(t)&&w(t));e&&(e.insertBefore(t),0===e.getChildren().length&&e.remove())}else{const e=n(t,t=>!E(t)&&w(t));if(e)e.setURL(r),void 0!==i&&e.setTarget(i),void 0!==s&&e.setRel(s);else{const e=D(r,{rel:s,target:i});t.insertBefore(e),e.append(t)}}})}const h=u.extract();if(null===r){const t=new Set;return void h.forEach(e=>{const n=e.getParent();if(w(n)&&!E(n)){const e=n.getKey();if(t.has(e))return;!function(t,e){const n=new Set(e.filter(e=>t.isParentOf(e)).map(t=>t.getKey())),r=t.getChildren(),i=r.filter(t=>n.has(t.getKey()));if(i.length===r.length)return r.forEach(e=>t.insertBefore(e)),void t.remove();const l=r.findIndex(t=>n.has(t.getKey())),s=r.findLastIndex(t=>n.has(t.getKey())),o=0===l,u=s===r.length-1;if(o)i.forEach(e=>t.insertBefore(e));else if(u)for(let e=i.length-1;e>=0;e--)t.insertAfter(i[e]);else{for(let e=i.length-1;e>=0;e--)t.insertAfter(i[e]);const e=r.slice(s+1);if(e.length>0){const n=D(t.getURL(),{rel:t.getRel(),target:t.getTarget(),title:t.getTitle()});i[i.length-1].insertAfter(n),e.forEach(t=>n.append(t))}}}(n,h),t.add(e)}})}const p=new Set,_=t=>{p.has(t.getKey())||(p.add(t.getKey()),t.setURL(r),void 0!==i&&t.setTarget(i),void 0!==s&&t.setRel(s),void 0!==l&&t.setTitle(l))};if(1===h.length){const t=h[0],e=n(t,w);if(null!==e)return _(e)}!function(t){const e=c();if(!o(e))return t();const n=f(e),r=n.isBackward(),i=M(n.anchor,r?-1:0),l=M(n.focus,r?0:-1),s=t();if(i||l){const t=c();if(o(t)){const e=t.clone();if(i){const t=i.getParent();t&&e.anchor.set(t.getKey(),i.getIndexWithinParent()+(r?1:0),"element")}if(l){const t=l.getParent();t&&e.focus.set(t.getKey(),l.getIndexWithinParent()+(r?0:1),"element")}d(f(e))}}}(()=>{let t=null;for(const e of h){if(!e.isAttached())continue;const o=n(e,w);if(o){_(o);continue}if(a(e)){if(!e.isInline())continue;if(w(e)){if(!(E(e)||null!==t&&t.getParentOrThrow().isParentOf(e))){_(e),t=e;continue}for(const t of e.getChildren())e.insertBefore(t);e.remove();continue}}const u=e.getPreviousSibling();w(u)&&u.is(t)?u.append(e):(t=D(r,{rel:s,target:i,title:l}),e.insertAfter(t),t.append(e))}})}const J=/^\+?[0-9\s()-]{5,}$/;function K(t){return t.match(/^[a-z][a-z0-9+.-]*:/i)||t.match(/^[/#.]/)?t:t.includes("@")?`mailto:${t}`:J.test(t)?`tel:${t}`:`https://${t}`}function W(t,e){return r(C(()=>t.registerCommand(P,t=>{const n=e.validateUrl.peek(),r=e.attributes.peek();if(null===t)return z(null),!0;if("string"==typeof t)return!(void 0!==n&&!n(t))&&(z(t,r),!0);{const{url:e,target:n,rel:i,title:l}=t;return z(e,{...r,rel:i,target:n,title:l}),!0}},_)),C(()=>{const n=e.validateUrl.value;if(!n)return;const r=e.attributes.value;return t.registerCommand(m,e=>{const l=c();if(!o(l)||l.isCollapsed()||!i(e,ClipboardEvent))return!1;if(null===e.clipboardData)return!1;const s=e.clipboardData.getData("text");return!!n(s)&&(!l.getNodes().some(t=>a(t))&&(t.dispatchCommand(P,{...r,url:s}),e.preventDefault(),!0))},_)}))}const F=h({build:(t,e,n)=>O(e),config:{attributes:void 0,validateUrl:void 0},mergeConfig(t,e){const n=p(t,e);return t.attributes&&(n.attributes=p(t.attributes,n.attributes)),n},name:"@ekz/lexical-link/Link",nodes:()=>[y],register:(t,e,n)=>W(t,n.getOutput())});function B(t,r,i={}){const l=i=>{const l=i.target;if(!k(l))return;const s=b(l);if(null===s)return;let u=null,g=null;if(s.update(()=>{const t=U(l);if(null!==t){const i=n(t,a);if(!r.disabled.peek())if(w(i))u=i.sanitizeUrl(i.getURL()),g=i.getTarget();else{const t=function(t,e){let n=t;for(;null!=n;){if(e(n))return n;n=n.parentNode}return null}(l,e);null!==t&&(u=t.href,g=t.target)}}}),null===u||""===u)return;const f=t.getEditorState().read(c);if(o(f)&&!f.isCollapsed())return void i.preventDefault();const d="auxclick"===i.type&&1===i.button;window.open(u,r.newTab.peek()||d||i.metaKey||i.ctrlKey||"_blank"===g?"_blank":"_self"),i.preventDefault()},s=t=>{1===t.button&&l(t)};return t.registerRootListener((t,e)=>{null!==e&&(e.removeEventListener("click",l),e.removeEventListener("mouseup",s)),null!==t&&(t.addEventListener("click",l,i),t.addEventListener("mouseup",s,i))})}const $=h({build:(t,e,n)=>O(e),config:x({disabled:!1,newTab:!1}),dependencies:[F],name:"@ekz/lexical-link/ClickableLink",register:(t,e,n)=>B(t,n.getOutput())});function H(t,e=t=>t){return n=>{const r=t.exec(n);return null===r?null:{index:r.index,length:r[0].length,text:r[0],url:e(r[0])}}}function j(t,e){for(let n=0;n<e.length;n++){const r=e[n](t);if(r)return r}return null}const G=/[.,;\s]/;function Z(t){return G.test(t)}function q(t){return Z(t[t.length-1])}function Q(t){return Z(t[0])}function V(t){let e=t.getPreviousSibling();return a(e)&&(e=e.getLastDescendant()),null===e||L(e)||T(e)&&q(e.getTextContent())}function X(t){let e=t.getNextSibling();return a(e)&&(e=e.getFirstDescendant()),null===e||L(e)||T(e)&&Q(e.getTextContent())}function Y(t,e,n,r){if(!(t>0?Z(n[t-1]):V(r[0])))return!1;return e<n.length?Z(n[e]):X(r[r.length-1])}function tt(t,e,n){const r=[],i=[],l=[];let s=0,o=0;const u=[...t];for(;u.length>0;){const t=u[0],a=t.getTextContent().length,c=o;o+a<=e?(r.push(t),s+=a):c>=n?l.push(t):i.push(t),o+=a,u.shift()}return[s,r,i,l]}function et(t,e,n,r){const i=I(r.url,r.attributes);if(1===t.length){let l,s=t[0];0===e?[l,s]=s.splitText(n):[,l,s]=s.splitText(e,n);const o=S(r.text);return o.setFormat(l.getFormat()),o.setDetail(l.getDetail()),o.setStyle(l.getStyle()),i.append(o),l.replace(i),s}if(t.length>1){const r=t[0];let l,s=r.getTextContent().length;0===e?l=r:[,l]=r.splitText(e);const u=[];let a;for(let e=1;e<t.length;e++){const r=t[e],i=r.getTextContent().length,l=s;if(l<n)if(s+i<=n)u.push(r);else{const[t,e]=r.splitText(n-l);u.push(t),a=e}s+=i}const f=c(),d=f?f.getNodes().find(T):void 0,h=S(l.getTextContent());return h.setFormat(l.getFormat()),h.setDetail(l.getDetail()),h.setStyle(l.getStyle()),i.append(h,...u),d&&d===l&&(o(f)?h.select(f.anchor.offset,f.focus.offset):g(f)&&h.select(0,h.getTextContent().length)),l.replace(i),a}}function nt(t,e,n){const r=t.getChildren(),i=r.length;for(let e=0;e<i;e++){const i=r[e];if(!T(i)||!i.isSimpleText())return rt(t),void n(null,t.getURL())}const l=t.getTextContent(),s=j(l,e);if(null===s||s.text!==l)return rt(t),void n(null,t.getURL());if(!V(t)||!X(t))return rt(t),void n(null,t.getURL());const o=t.getURL();if(o!==s.url&&(t.setURL(s.url),n(s.url,o)),s.attributes){const e=t.getRel();e!==s.attributes.rel&&(t.setRel(s.attributes.rel||null),n(s.attributes.rel||null,e));const r=t.getTarget();r!==s.attributes.target&&(t.setTarget(s.attributes.target||null),n(s.attributes.target||null,r))}}function rt(t){const e=t.getChildren();for(let n=e.length-1;n>=0;n--)t.insertAfter(e[n]);return t.remove(),e.map(t=>t.getLatest())}const it={changeHandlers:[],matchers:[]};function lt(t,e=it){const{matchers:n,changeHandlers:i}=e,l=(t,e)=>{for(const n of i)n(t,e)};return r(t.registerNodeTransform(v,t=>{const e=t.getParentOrThrow(),r=t.getPreviousSibling();if(E(e)&&!e.getIsUnlinked())nt(e,n,l);else if(!w(e)){if(t.isSimpleText()&&(Q(t.getTextContent())||!E(r))){const e=function(t){const e=[t];let n=t.getNextSibling();for(;null!==n&&T(n)&&n.isSimpleText()&&(e.push(n),!/[\s]/.test(n.getTextContent()));)n=n.getNextSibling();return e}(t);!function(t,e,n){let r=[...t];const i=r.map(t=>t.getTextContent()).join("");let l,s=i,o=0;for(;(l=j(s,e))&&null!==l;){const t=l.index,e=t+l.length;if(Y(o+t,o+e,i,r)){const[i,,s,u]=tt(r,o+t,o+e),a=et(s,o+t-i,o+e-i,l);r=a?[a,...u]:u,n(l.url,null),o=0}else o+=e;s=s.substring(e)}}(e,n,l)}!function(t,e,n){const r=t.getPreviousSibling(),i=t.getNextSibling(),l=t.getTextContent();var s;!E(r)||r.getIsUnlinked()||Q(l)&&(s=l,!(r.isEmailURI()?/^\.[a-zA-Z]{2,}/.test(s):/^\.[a-zA-Z0-9]{1,}/.test(s)))||(r.append(t),nt(r,e,n),n(null,r.getURL())),!E(i)||i.getIsUnlinked()||q(l)||(rt(i),nt(i,e,n),n(null,i.getURL()))}(t,n,l)}}),t.registerCommand(P,t=>{const e=c();if(null!==t||!o(e))return!1;return e.extract().forEach(t=>{const e=t.getParent();E(e)&&(e.setIsUnlinked(!e.getIsUnlinked()),e.markDirty())}),!1},_))}const st=h({config:it,dependencies:[F],mergeConfig(t,e){const n=p(t,e);for(const r of["matchers","changeHandlers"]){const i=e[r];Array.isArray(i)&&(n[r]=[...t[r],...i])}return n},name:"@ekz/lexical-link/AutoLink",register:lt}),ot=z;export{I as $createAutoLinkNode,D as $createLinkNode,E as $isAutoLinkNode,w as $isLinkNode,z as $toggleLink,st as AutoLinkExtension,A as AutoLinkNode,$ as ClickableLinkExtension,F as LinkExtension,y as LinkNode,P as TOGGLE_LINK_COMMAND,H as createLinkMatcherWithRegExp,K as formatUrl,lt as registerAutoLink,B as registerClickableLink,W as registerLink,ot as toggleLink};

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) Meta Platforms, Inc. and affiliates.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/LexicalAutoLinkExtension.d.ts

@@ -0,0 +1,41 @@
+/**
+ * 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 { LexicalEditor } from '@ekz/lexical';
+import { type AutoLinkAttributes } from './LexicalLinkNode';
+export type ChangeHandler = (url: string | null, prevUrl: string | null) => void;
+export interface LinkMatcherResult {
+    attributes?: AutoLinkAttributes;
+    index: number;
+    length: number;
+    text: string;
+    url: string;
+}
+export type LinkMatcher = (text: string) => LinkMatcherResult | null;
+export declare function createLinkMatcherWithRegExp(regExp: RegExp, urlTransformer?: (text: string) => string): (text: string) => {
+    index: number;
+    length: number;
+    text: string;
+    url: string;
+} | null;
+export interface AutoLinkConfig {
+    matchers: LinkMatcher[];
+    changeHandlers: ChangeHandler[];
+}
+export declare function registerAutoLink(editor: LexicalEditor, config?: AutoLinkConfig): () => void;
+/**
+ * An extension to automatically create AutoLinkNode from text
+ * that matches the configured matchers. No default implementation
+ * is provided for any matcher, see {@link createLinkMatcherWithRegExp}
+ * for a helper function to create a matcher from a RegExp, and the
+ * Playground's [AutoLinkPlugin](https://github.com/facebook/lexical/blob/main/packages/lexical-playground/src/plugins/AutoLinkPlugin/index.tsx)
+ * for some example RegExps that could be used.
+ *
+ * The given `matchers` and `changeHandlers` will be merged by
+ * concatenating the configured arrays.
+ */
+export declare const AutoLinkExtension: import("@ekz/lexical").LexicalExtension<AutoLinkConfig, "@ekz/lexical-link/AutoLink", unknown, unknown>;

package/LexicalLink.js.flow

@@ -0,0 +1,168 @@
+/**
+ * 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 {
+  DOMConversionMap,
+  EditorConfig,
+  LexicalNode,
+  NodeKey,
+  RangeSelection,
+  LexicalCommand,
+  SerializedElementNode,
+  LexicalEditor,
+} from '@ekz/lexical';
+import {addClassNamesToElement} from '@ekz/lexical-utils';
+import {$isElementNode, ElementNode} from '@ekz/lexical';
+import type {LexicalExtension, NamedSignalsOutput} from '@ekz/lexical-extension';
+
+export type LinkAttributes = $ReadOnly<{
+  rel?: null | string,
+  target?: null | string,
+  title?: null | string,
+}>;
+export type SerializedLinkNode = {
+  ...SerializedElementNode,
+  rel?: null | string,
+  target?: null | string,
+  title?: null | string,
+  url: string,
+  ...
+};
+declare export class LinkNode extends ElementNode {
+  __url: string;
+  __target: null | string;
+  __rel: null | string;
+  __title: null | string;
+  static getType(): string;
+  static clone(node: LinkNode): LinkNode;
+  constructor(url: string, attributes?: LinkAttributes, key?: NodeKey): void;
+  createDOM(config: EditorConfig): HTMLElement;
+  static importDOM(): DOMConversionMap | null;
+  exportJSON(): SerializedLinkNode;
+  getURL(): string;
+  setURL(url: string): void;
+  getTarget(): null | string;
+  setTarget(target: null | string): void;
+  getRel(): null | string;
+  setRel(rel: null | string): void;
+  getTitle(): null | string;
+  setTitle(title: null | string): void;
+  insertNewAfter(
+    selection: RangeSelection,
+    restoreSelection?: boolean,
+  ): null | ElementNode;
+  canInsertTextBefore(): false;
+  canInsertTextAfter(): false;
+  canBeEmpty(): false;
+  isInline(): true;
+}
+declare export function $createLinkNode(
+  url: string,
+  attributes?: LinkAttributes,
+): LinkNode;
+declare export function $isLinkNode(
+  node: ?LexicalNode,
+): node is LinkNode;
+export type SerializedAutoLinkNode = {
+  ...SerializedLinkNode,
+  isUnlinked: boolean,
+  ...
+};
+declare export class AutoLinkNode extends LinkNode {
+  static getType(): string;
+  // $FlowFixMe[incompatible-type] clone method inheritance
+  static clone(node: AutoLinkNode): AutoLinkNode;
+  insertNewAfter(
+    selection: RangeSelection,
+    restoreSelection?: boolean,
+  ): null | ElementNode;
+}
+declare export function $createAutoLinkNode(
+  url: string,
+  attributes?: LinkAttributes,
+): AutoLinkNode;
+declare export function $isAutoLinkNode(
+  node: ?LexicalNode,
+): node is AutoLinkNode;
+
+declare export var TOGGLE_LINK_COMMAND: LexicalCommand<
+  string | {url: string, ...LinkAttributes} | null,
+>;
+declare export function $toggleLink(
+  url: null | string,
+  attributes: LinkAttributes,
+): void;
+/** @deprecated renamed to {@link $toggleLink} by @lexical/eslint-plugin rules-of-lexical */
+declare const toggleLink: typeof $toggleLink;
+declare export function formatUrl(url: string): string;
+
+export type ClickableLinkConfig = {
+  newTab: boolean;
+  disabled: boolean;
+}
+
+type AddEventListenerOptions = Exclude<AddEventListenerOptionsOrUseCapture, boolean>;
+
+declare export function registerClickableLink(
+  editor: LexicalEditor,
+  stores: NamedSignalsOutput<ClickableLinkConfig>,
+  eventOptions?: Pick<AddEventListenerOptions, 'signal'>,
+): () => void;
+
+declare export var ClickableLinkExtension: LexicalExtension<ClickableLinkConfig, "@ekz/lexical-link/ClickableLink", NamedSignalsOutput<ClickableLinkConfig>, void>;
+declare export function registerClickableLink(
+  editor: LexicalEditor,
+  stores: NamedSignalsOutput<ClickableLinkConfig>,
+  eventOptions?: Pick<AddEventListenerOptions, 'signal'>,
+): () => void;
+
+export type AutoLinkConfig = {
+  matchers: LinkMatcher[];
+  changeHandlers: ChangeHandler[];
+}
+
+export type ChangeHandler = (
+  url: string | null,
+  prevUrl: string | null,
+) => void;
+
+export type AutoLinkAttributes = Partial<
+  {...LinkAttributes, isUnlinked?: boolean}
+>;
+
+export type LinkMatcherResult = {
+  attributes?: AutoLinkAttributes;
+  index: number;
+  length: number;
+  text: string;
+  url: string;
+}
+
+export type LinkMatcher = (text: string) => LinkMatcherResult | null;
+
+declare export function createLinkMatcherWithRegExp(
+  regExp: RegExp,
+  urlTransformer?: (text: string) => string,
+): LinkMatcher;
+
+declare export var AutoLinkExtension: LexicalExtension<AutoLinkConfig, "@ekz/lexical-link/AutoLink", void, void>;
+
+declare export function registerAutoLink(
+  editor: LexicalEditor,
+  config?: AutoLinkConfig,
+): () => void;
+
+export type LinkConfig = {
+  validateUrl: void | ((url: string) => boolean);
+  attributes: void | LinkAttributes;
+}
+declare export var LinkExtension: LexicalExtension<LinkConfig, "@ekz/lexical-link/Link", NamedSignalsOutput<LinkConfig>, void>;
+declare export function registerLink(
+  editor: LexicalEditor,
+  stores: NamedSignalsOutput<LinkConfig>,
+): () => void;

package/LexicalLinkExtension.d.ts

@@ -0,0 +1,37 @@
+/**
+ * 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 { NamedSignalsOutput } from '@ekz/lexical-extension';
+import { LexicalEditor } from '@ekz/lexical';
+import { LinkAttributes } from './LexicalLinkNode';
+export interface LinkConfig {
+    /**
+     * If this function is specified a {@link PASTE_COMMAND}
+     * listener will be registered to wrap selected nodes
+     * when a URL is pasted and `validateUrl(url)` returns true.
+     * The default of `undefined` will not register this listener.
+     *
+     * In the implementation of {@link TOGGLE_LINK_COMMAND}
+     * it will reject URLs that return false when specified.
+     * The default of `undefined` will always accept URLs.
+     */
+    validateUrl: undefined | ((url: string) => boolean);
+    /**
+     * The default anchor tag attributes to use for
+     * {@link TOGGLE_LINK_COMMAND}
+     */
+    attributes: undefined | LinkAttributes;
+}
+/** @internal */
+export declare function registerLink(editor: LexicalEditor, stores: NamedSignalsOutput<LinkConfig>): () => void;
+/**
+ * Provides {@link LinkNode}, an implementation of
+ * {@link TOGGLE_LINK_COMMAND}, and a {@link PASTE_COMMAND}
+ * listener to wrap selected nodes in a link when a
+ * URL is pasted and `validateUrl` is defined.
+ */
+export declare const LinkExtension: import("@ekz/lexical").LexicalExtension<LinkConfig, "@ekz/lexical-link/Link", NamedSignalsOutput<LinkConfig>, unknown>;

package/LexicalLinkNode.d.ts

@@ -0,0 +1,126 @@
+/**
+ * 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 { BaseSelection, DOMConversionMap, EditorConfig, LexicalCommand, LexicalNode, LexicalUpdateJSON, NodeKey, RangeSelection, SerializedElementNode } from '@ekz/lexical';
+import { ElementNode, Spread } from '@ekz/lexical';
+export type LinkAttributes = {
+    rel?: null | string;
+    target?: null | string;
+    title?: null | string;
+};
+export type AutoLinkAttributes = Partial<Spread<LinkAttributes, {
+    isUnlinked?: boolean;
+}>>;
+export type SerializedLinkNode = Spread<{
+    url: string;
+}, Spread<LinkAttributes, SerializedElementNode>>;
+type LinkHTMLElementType = HTMLAnchorElement | HTMLSpanElement;
+/** @noInheritDoc */
+export declare class LinkNode extends ElementNode {
+    /** @internal */
+    __url: string;
+    /** @internal */
+    __target: null | string;
+    /** @internal */
+    __rel: null | string;
+    /** @internal */
+    __title: null | string;
+    static getType(): string;
+    static clone(node: LinkNode): LinkNode;
+    constructor(url?: string, attributes?: LinkAttributes, key?: NodeKey);
+    createDOM(config: EditorConfig): LinkHTMLElementType;
+    updateLinkDOM(prevNode: this | null, anchor: LinkHTMLElementType, config: EditorConfig): void;
+    updateDOM(prevNode: this, anchor: LinkHTMLElementType, config: EditorConfig): boolean;
+    static importDOM(): DOMConversionMap | null;
+    static importJSON(serializedNode: SerializedLinkNode): LinkNode;
+    updateFromJSON(serializedNode: LexicalUpdateJSON<SerializedLinkNode>): this;
+    sanitizeUrl(url: string): string;
+    exportJSON(): SerializedLinkNode | SerializedAutoLinkNode;
+    getURL(): string;
+    setURL(url: string): this;
+    getTarget(): null | string;
+    setTarget(target: null | string): this;
+    getRel(): null | string;
+    setRel(rel: null | string): this;
+    getTitle(): null | string;
+    setTitle(title: null | string): this;
+    insertNewAfter(_: RangeSelection, restoreSelection?: boolean): null | ElementNode;
+    canInsertTextBefore(): false;
+    canInsertTextAfter(): false;
+    canBeEmpty(): false;
+    isInline(): true;
+    extractWithChild(child: LexicalNode, selection: BaseSelection, destination: 'clone' | 'html'): boolean;
+    isEmailURI(): boolean;
+    isWebSiteURI(): boolean;
+}
+/**
+ * Takes a URL and creates a LinkNode.
+ * @param url - The URL the LinkNode should direct to.
+ * @param attributes - Optional HTML a tag attributes \\{ target, rel, title \\}
+ * @returns The LinkNode.
+ */
+export declare function $createLinkNode(url?: string, attributes?: LinkAttributes): LinkNode;
+/**
+ * Determines if node is a LinkNode.
+ * @param node - The node to be checked.
+ * @returns true if node is a LinkNode, false otherwise.
+ */
+export declare function $isLinkNode(node: LexicalNode | null | undefined): node is LinkNode;
+export type SerializedAutoLinkNode = Spread<{
+    isUnlinked: boolean;
+}, SerializedLinkNode>;
+export declare class AutoLinkNode extends LinkNode {
+    /** @internal */
+    /** Indicates whether the autolink was ever unlinked. **/
+    __isUnlinked: boolean;
+    constructor(url?: string, attributes?: AutoLinkAttributes, key?: NodeKey);
+    static getType(): string;
+    static clone(node: AutoLinkNode): AutoLinkNode;
+    getIsUnlinked(): boolean;
+    setIsUnlinked(value: boolean): this;
+    createDOM(config: EditorConfig): LinkHTMLElementType;
+    updateDOM(prevNode: this, anchor: LinkHTMLElementType, config: EditorConfig): boolean;
+    static importJSON(serializedNode: SerializedAutoLinkNode): AutoLinkNode;
+    updateFromJSON(serializedNode: LexicalUpdateJSON<SerializedAutoLinkNode>): this;
+    static importDOM(): null;
+    exportJSON(): SerializedAutoLinkNode;
+    insertNewAfter(selection: RangeSelection, restoreSelection?: boolean): null | ElementNode;
+}
+/**
+ * Takes a URL and creates an AutoLinkNode. AutoLinkNodes are generally automatically generated
+ * during typing, which is especially useful when a button to generate a LinkNode is not practical.
+ * @param url - The URL the LinkNode should direct to.
+ * @param attributes - Optional HTML a tag attributes. \\{ target, rel, title \\}
+ * @returns The LinkNode.
+ */
+export declare function $createAutoLinkNode(url?: string, attributes?: AutoLinkAttributes): AutoLinkNode;
+/**
+ * Determines if node is an AutoLinkNode.
+ * @param node - The node to be checked.
+ * @returns true if node is an AutoLinkNode, false otherwise.
+ */
+export declare function $isAutoLinkNode(node: LexicalNode | null | undefined): node is AutoLinkNode;
+export declare const TOGGLE_LINK_COMMAND: LexicalCommand<string | ({
+    url: string;
+} & LinkAttributes) | null>;
+/**
+ * Generates or updates a LinkNode. It can also delete a LinkNode if the URL is null,
+ * but saves any children and brings them up to the parent node.
+ * @param urlOrAttributes - The URL the link directs to, or an attributes object with an url property
+ * @param attributes - Optional HTML a tag attributes. \\{ target, rel, title \\}
+ */
+export declare function $toggleLink(urlOrAttributes: null | string | (LinkAttributes & {
+    url: null | string;
+}), attributes?: LinkAttributes): void;
+/**
+ * Formats a URL string by adding appropriate protocol if missing
+ *
+ * @param url - URL to format
+ * @returns Formatted URL with appropriate protocol
+ */
+export declare function formatUrl(url: string): string;
+export {};

package/README.md

@@ -0,0 +1,7 @@
+# `@lexical/link`
+
+[![See API Documentation](https://lexical.dev/img/see-api-documentation.svg)](https://lexical.dev/docs/api/modules/lexical_link)
+
+This package contains the functionality for Lexical links.
+
+More documentation coming soon.

package/index.d.ts

@@ -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 { $toggleLink } from './LexicalLinkNode';
+export { type ClickableLinkConfig, ClickableLinkExtension, registerClickableLink, } from './ClickableLinkExtension';
+export { type AutoLinkConfig, AutoLinkExtension, type ChangeHandler, createLinkMatcherWithRegExp, type LinkMatcher, registerAutoLink, } from './LexicalAutoLinkExtension';
+export { LinkExtension, registerLink } from './LexicalLinkExtension';
+export { $createAutoLinkNode, $createLinkNode, $isAutoLinkNode, $isLinkNode, $toggleLink, type AutoLinkAttributes, AutoLinkNode, formatUrl, type LinkAttributes, LinkNode, type SerializedAutoLinkNode, type SerializedLinkNode, TOGGLE_LINK_COMMAND, } from './LexicalLinkNode';
+/** @deprecated renamed to {@link $toggleLink} by @lexical/eslint-plugin rules-of-lexical */
+export declare const toggleLink: typeof $toggleLink;

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "@ekz/lexical-link",
+  "description": "This package contains the functionality for Lexical links.",
+  "keywords": [
+    "lexical",
+    "editor",
+    "rich-text",
+    "link"
+  ],
+  "license": "MIT",
+  "version": "0.40.0",
+  "main": "LexicalLink.js",
+  "types": "index.d.ts",
+  "dependencies": {
+    "@ekz/lexical-extension": "0.40.0",
+    "@ekz/lexical-utils": "0.40.0",
+    "@ekz/lexical": "0.40.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/facebook/lexical.git",
+    "directory": "packages/lexical-link"
+  },
+  "module": "LexicalLink.mjs",
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./index.d.ts",
+        "development": "./LexicalLink.dev.mjs",
+        "production": "./LexicalLink.prod.mjs",
+        "node": "./LexicalLink.node.mjs",
+        "default": "./LexicalLink.mjs"
+      },
+      "require": {
+        "types": "./index.d.ts",
+        "development": "./LexicalLink.dev.js",
+        "production": "./LexicalLink.prod.js",
+        "default": "./LexicalLink.js"
+      }
+    }
+  }
+}