carbon-react 158.38.3 → 158.39.0

package/esm/components/text-editor/__internal__/__plugins__/FormSubmission/form-submission.plugin.d.ts

@@ -0,0 +1,22 @@
+import type { EditorFormattedValuesWithInlineStyles } from "../../__utils__/interfaces.types";
+/**
+ * FormSubmissionPlugin - A Lexical plugin that listens for form submission events
+ * and calls the onFormSubmission callback with the current editor state.
+ *
+ * Returns the editor's current formatted values (HTML and JSON) including HTML with inline styles.
+ *
+ * @param onFormSubmission - Callback function that receives EditorFormattedValuesWithInlineStyles containing:
+ *   - htmlString: string - HTML representation of the editor content
+ *   - json: object - JSON representation of the editor state
+ *   - htmlStringWithInlineStyles: string - HTML with inline styles instead of classes
+ *
+ * @example
+ * <TextEditor labelText="...">
+ *   <FormSubmissionPlugin onFormSubmission={(values) => console.log(values.htmlStringWithInlineStyles)} />
+ * </TextEditor>
+ */
+export interface FormSubmissionPluginProps {
+    onFormSubmission?: (value: EditorFormattedValuesWithInlineStyles) => void;
+}
+export declare const FormSubmissionPlugin: ({ onFormSubmission, }: FormSubmissionPluginProps) => null;
+export default FormSubmissionPlugin;

package/esm/components/text-editor/__internal__/__plugins__/FormSubmission/form-submission.plugin.js

@@ -0,0 +1 @@
+import{useLexicalComposerContext as e}from"@lexical/react/LexicalComposerContext";import{useEffect as t}from"react";import{SerializeLexical as r,generateHTMLWithInlineStyles as n}from"../../__utils__/helpers.js";function o(e,t,r){return t in e?Object.defineProperty(e,t,{value:r,enumerable:!0,configurable:!0,writable:!0}):e[t]=r,e}const i=({onFormSubmission:i})=>{const[c]=e();return t((()=>{var e;if(!i)return;const t=null===(e=c.getRootElement())||void 0===e?void 0:e.closest("form");if(!t)return;const l=()=>{if(!c.isEditable())return;const e=r(c),t=e.htmlString&&n(e.htmlString);var l,s;i((l=function(e){for(var t=1;t<arguments.length;t++){var r=null!=arguments[t]?arguments[t]:{},n=Object.keys(r);"function"==typeof Object.getOwnPropertySymbols&&(n=n.concat(Object.getOwnPropertySymbols(r).filter((function(e){return Object.getOwnPropertyDescriptor(r,e).enumerable})))),n.forEach((function(t){o(e,t,r[t])}))}return e}({},e),s=null!=(s={htmlStringWithInlineStyles:t||""})?s:{},Object.getOwnPropertyDescriptors?Object.defineProperties(l,Object.getOwnPropertyDescriptors(s)):function(e){var t=Object.keys(e);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(e);t.push.apply(t,r)}return t}(Object(s)).forEach((function(e){Object.defineProperty(l,e,Object.getOwnPropertyDescriptor(s,e))})),l))};return t.addEventListener("submit",l),()=>{t.removeEventListener("submit",l)}}),[c,i]),null};export{i as FormSubmissionPlugin,i as default};

package/esm/components/text-editor/__internal__/__plugins__/FormSubmission/index.d.ts

@@ -0,0 +1 @@
+export { default } from "./form-submission.plugin";

package/esm/components/text-editor/__internal__/__plugins__/FormSubmission/index.js

@@ -0,0 +1 @@
+export{FormSubmissionPlugin as default}from"./form-submission.plugin.js";

package/esm/components/text-editor/__internal__/__plugins__/index.d.ts

@@ -2,3 +2,4 @@ export { default as AutoLinkerPlugin } from "./AutoLinker";
 export { default as LinkMonitorPlugin } from "./LinkMonitor";
 export { default as StyledSpanEnterPlugin } from "./StyledSpanEnter";
 export { default as useCursorAtEnd } from "./useCursorAtEnd";
+export { default as FormSubmissionPlugin } from "./FormSubmission";

package/esm/components/text-editor/__internal__/__plugins__/index.js

@@ -1 +1 @@
-export{default as AutoLinkerPlugin}from"./AutoLinker/auto-link.component.js";export{default as LinkMonitorPlugin}from"./LinkMonitor/link-monitor.plugin.js";export{default as StyledSpanEnterPlugin}from"./StyledSpanEnter/styled-span-enter.plugin.js";export{default as useCursorAtEnd}from"./useCursorAtEnd/index.js";
+export{default as AutoLinkerPlugin}from"./AutoLinker/auto-link.component.js";export{default as LinkMonitorPlugin}from"./LinkMonitor/link-monitor.plugin.js";export{default as StyledSpanEnterPlugin}from"./StyledSpanEnter/styled-span-enter.plugin.js";export{default as useCursorAtEnd}from"./useCursorAtEnd/index.js";export{FormSubmissionPlugin}from"./FormSubmission/form-submission.plugin.js";

package/esm/components/text-editor/__internal__/__utils__/helpers.d.ts

@@ -1,4 +1,19 @@
 import { LexicalEditor } from "lexical";
+/**
+ * Post-processes HTML serialised from the Lexical editor, converting class-based
+ * text formatting to inline styles and applying brand-consistent defaults to all elements.
+ *
+ * Specifically:
+ * - Converts Lexical's text format classes (textBold, textItalic, textUnderline)
+ *   to their inline style equivalents
+ * - Applies the Sage UI font family to all elements
+ * - Applies link styles (color, cursor, underline) to anchor elements
+ * - Preserves any existing inline styles set by Lexical (e.g. white-space: pre-wrap)
+ *
+ * This ensures the output HTML is portable and renders correctly in contexts where
+ * the Lexical stylesheet is not present, such as email templates or external consumers.
+ */
+declare const generateHTMLWithInlineStyles: (html: string) => string;
 /**
  * This helper takes the current state of the editor and serializes it into two formats:
  * 1. HTML
@@ -20,4 +35,4 @@ declare function validateUrl(url: string): boolean;
 declare const createFromHTML: (html: string) => string;
 /** Creates and returns a string representation of an empty editor */
 declare const createEmpty: () => string;
-export { createEmpty, createFromHTML, DeserializeHTML, SerializeLexical, validateUrl, };
+export { createEmpty, createFromHTML, DeserializeHTML, SerializeLexical, generateHTMLWithInlineStyles, validateUrl, };

package/esm/components/text-editor/__internal__/__utils__/helpers.js

@@ -1 +1 @@
-import{createHeadlessEditor as t}from"@lexical/headless";import{$generateNodesFromDOM as e,$generateHtmlFromNodes as r}from"@lexical/html";import{$getRoot as o,$getSelection as n}from"lexical";import{MARKDOWN_NODES as i}from"./constants.js";import{getTheme as s}from"./theme.js";import l from"../../../../__internal__/utils/logger/index.js";const a=t=>{let e,o;return t.read((()=>{const n=t.getEditorState();o=n.toJSON(),e=r(t,null)})),{htmlString:e,json:o}},m=r=>{const a=t({namespace:"html-to-json",onError:t=>l.error(t.message),theme:s(),nodes:i});let m;if(a.update((()=>{const t=(new DOMParser).parseFromString(r,"text/html"),i=e(a,t);o().select();const s=n();if(s)try{s.insertNodes(i)}catch(t){m=t}}),{discrete:!0}),m)throw m;const c=a.getEditorState().toJSON();return JSON.stringify(c)},c=new RegExp(/((([A-Za-z]{3,9}:(?:\/\/)?)(?:[-;:&=+$,\w]+@)?[A-Za-z0-9.-]+|(?:www.|[-;:&=+$,\w]+@)[A-Za-z0-9.-]+)((?:\/[+~%/.\w-_]*)?\??(?:[-+=&;%@.\w_]*)#?(?:[\w]*))?)/);function p(t){return"https://"===t||c.test(t)}const d=t=>m(t),h=()=>'{"root":{"children":[{"children":[],"direction":null,"format":"","indent":0,"type":"paragraph","version":1}],"direction":null,"format":"","indent":0,"type":"root","version":1}}';export{m as DeserializeHTML,a as SerializeLexical,h as createEmpty,d as createFromHTML,p as validateUrl};
+import{createHeadlessEditor as t}from"@lexical/headless";import{$generateNodesFromDOM as e,$generateHtmlFromNodes as r}from"@lexical/html";import{$getRoot as o,$getSelection as n}from"lexical";import{MARKDOWN_NODES as s}from"./constants.js";import{getTheme as i}from"./theme.js";import l from"../../../../__internal__/utils/logger/index.js";const a="font-family: 'Sage UI', sans-serif;",c=`color: #007e45ff; cursor: pointer; text-decoration: underline; ${a}`,m={textBold:"font-weight: bold;",textItalic:"font-style: italic;",textUnderline:"text-decoration: underline;"},d=t=>{const e=(new DOMParser).parseFromString(t,"text/html");return e.body.querySelectorAll("*").forEach((t=>{const e=t,r=[];var o;Array.from(e.classList).forEach((t=>{const o=m[t];o&&(r.push(o),e.classList.remove(t))})),"A"===e.tagName?r.push(c):r.push(a);const n=[null!==(o=e.getAttribute("style"))&&void 0!==o?o:"",...r].filter(Boolean).join(" ");e.setAttribute("style",n),0===e.classList.length&&e.removeAttribute("class")})),e.body.innerHTML},f=t=>{let e,o;return t.read((()=>{const n=t.getEditorState();o=n.toJSON(),e=r(t,null)})),{htmlString:e,json:o}},h=r=>{const a=t({namespace:"html-to-json",onError:t=>l.error(t.message),theme:i(),nodes:s});let c;if(a.update((()=>{const t=(new DOMParser).parseFromString(r,"text/html"),s=e(a,t);o().select();const i=n();if(i)try{i.insertNodes(s)}catch(t){c=t}}),{discrete:!0}),c)throw c;const m=a.getEditorState().toJSON();return JSON.stringify(m)},p=new RegExp(/((([A-Za-z]{3,9}:(?:\/\/)?)(?:[-;:&=+$,\w]+@)?[A-Za-z0-9.-]+|(?:www.|[-;:&=+$,\w]+@)[A-Za-z0-9.-]+)((?:\/[+~%/.\w-_]*)?\??(?:[-+=&;%@.\w_]*)#?(?:[\w]*))?)/);function u(t){return"https://"===t||p.test(t)}const g=t=>h(t),w=()=>'{"root":{"children":[{"children":[],"direction":null,"format":"","indent":0,"type":"paragraph","version":1}],"direction":null,"format":"","indent":0,"type":"root","version":1}}';export{h as DeserializeHTML,f as SerializeLexical,w as createEmpty,g as createFromHTML,d as generateHTMLWithInlineStyles,u as validateUrl};

package/esm/components/text-editor/__internal__/__utils__/interfaces.types.d.ts

@@ -43,6 +43,11 @@ export interface TextEditorProps extends MarginProps, TagProps {
      * @deprecated Please ensure that `TextEditor` is used as a part of a `Form` component, which will handle the save functionality.
      */
     onSave?: (value: EditorFormattedValues) => void;
+    /**
+     * Callback that is triggered when a parent form of the editor is submitted.
+     * The callback returns the current content of the editor in multiple formats, including HTML with inline styles.
+     */
+    onFormSubmission?: (value: EditorFormattedValuesWithInlineStyles) => void;
     /** The placeholder to display when the editor is empty */
     placeholder?: string;
     /** An array of link preview nodes to render in the editor */
@@ -180,6 +185,10 @@ export interface EditorFormattedValues {
         };
     };
 }
+export interface EditorFormattedValuesWithInlineStyles extends EditorFormattedValues {
+    htmlStringWithInlineStyles?: string;
+}
+export type onFormSubmissionCallback = (value: EditorFormattedValuesWithInlineStyles) => void;
 export interface SaveButtonProps {
     /** The namespace of the editor that this button belongs to */
     namespace: string;

package/esm/components/text-editor/index.d.ts

@@ -1,5 +1,5 @@
 export { default } from "./text-editor.component";
 export { createEmpty, createFromHTML } from "./__internal__/__utils__/helpers";
-export type { TextEditorHandle, TextEditorProps, EditorFormattedValues, } from "./__internal__/__utils__/interfaces.types";
+export type { TextEditorHandle, TextEditorProps, EditorFormattedValues, EditorFormattedValuesWithInlineStyles, } from "./__internal__/__utils__/interfaces.types";
 export { default as MentionsPlugin } from "./__internal__/__ui__/Mentions/";
 export type { Mention } from "./__internal__/__ui__/Mentions";

package/esm/components/text-editor/text-editor.component.js

@@ -1 +1 @@
-import{jsx as e,jsxs as r,Fragment as t}from"react/jsx-runtime";import{LexicalComposer as n}from"@lexical/react/LexicalComposer";import{ClickableLinkPlugin as o}from"@lexical/react/LexicalClickableLinkPlugin";import{LexicalErrorBoundary as i}from"@lexical/react/LexicalErrorBoundary";import{HistoryPlugin as a}from"@lexical/react/LexicalHistoryPlugin";import{MarkdownShortcutPlugin as l}from"@lexical/react/LexicalMarkdownShortcutPlugin";import{RichTextPlugin as s}from"@lexical/react/LexicalRichTextPlugin";import{LinkPlugin as c}from"@lexical/react/LexicalLinkPlugin";import{ListPlugin as p}from"@lexical/react/LexicalListPlugin";import{OnChangePlugin as d}from"@lexical/react/LexicalOnChangePlugin";import{PluginProvider as _}from"./__internal__/__providers__/plugin-provider.js";import{$getRoot as u}from"lexical";import{forwardRef as m,useRef as f,useState as g,useImperativeHandle as h,useEffect as v,useMemo as b,useCallback as x}from"react";import y from"../../__internal__/label/label.component.js";import j from"../../hooks/__internal__/useLocale/useLocale.js";import w from"../../__internal__/utils/logger/index.js";import{COMPONENT_PREFIX as O,MARKDOWN_NODES as P}from"./__internal__/__utils__/constants.js";import L from"./__internal__/__plugins__/AutoLinker/auto-link.component.js";import C from"./__internal__/__plugins__/LinkMonitor/link-monitor.plugin.js";import E from"./__internal__/__plugins__/StyledSpanEnter/styled-span-enter.plugin.js";import"./__internal__/__plugins__/useCursorAtEnd/index.js";import T from"./text-editor.context.js";import{StyledTextEditorWrapper as k,StyledWrapper as S,StyledEditorToolbarWrapper as M,StyledHeaderWrapper as $,StyledTextEditor as B,StyledFooterWrapper as F}from"./text-editor.style.js";import{createEmpty as H,SerializeLexical as z,validateUrl as A}from"./__internal__/__utils__/helpers.js";import{HintText as R}from"../../__internal__/hint-text/hint-text.component.js";import q from"../../__internal__/validation-message/validation-message.component.js";import D from"../textbox/textbox.style.js";import"../../style/utils/filter-styled-system-padding-props.js";import I from"../../style/utils/filter-styled-system-margin-props.js";import V from"../../__internal__/utils/helpers/tags/tags.js";import U from"./__internal__/__ui__/ReadOnlyEditor/read-only-rte.component.js";import{getTheme as G}from"./__internal__/__utils__/theme.js";import J from"./__internal__/__ui__/CharacterCounter/character-counter.component.js";import K from"./__internal__/__ui__/ContentEditor/content-editor.component.js";import"./__internal__/__ui__/LinkPreviewer/link-previewer.style.js";import"@lexical/react/LexicalComposerContext";import"@lexical/react/LexicalTypeaheadMenuPlugin";import"react-dom";import"./__internal__/__ui__/Mentions/constants.js";import"./__internal__/__ui__/Mentions/mentions.style.js";import"../tooltip/tooltip.component.js";import"../portrait/portrait.style.js";import N from"./__internal__/__ui__/Placeholder/placeholder.component.js";import Q from"./__internal__/__ui__/Toolbar/toolbar.component.js";function W(e,r,t){return r in e?Object.defineProperty(e,r,{value:t,enumerable:!0,configurable:!0,writable:!0}):e[r]=t,e}function X(e){for(var r=1;r<arguments.length;r++){var t=null!=arguments[r]?arguments[r]:{},n=Object.keys(t);"function"==typeof Object.getOwnPropertySymbols&&(n=n.concat(Object.getOwnPropertySymbols(t).filter((function(e){return Object.getOwnPropertyDescriptor(t,e).enumerable})))),n.forEach((function(r){W(e,r,t[r])}))}return e}let Y=!1,Z=!1,ee=!1;const re=m(((m,W)=>{var re,te,ne,{characterLimit:oe=3e3,error:ie,footer:ae,header:le,inputHint:se,labelText:ce,namespace:pe=O,id:de,onBlur:_e,onCancel:ue,onChange:me,onFocus:fe,onLinkAdded:ge,onSave:he,placeholder:ve,previews:be=[],readOnly:xe=!1,required:ye=!1,rows:je,size:we="medium",warning:Oe,customPlugins:Pe,validationMessagePositionTop:Le=!1,toolbarControls:Ce}=m,Ee=function(e,r){if(null==e)return{};var t,n,o=function(e,r){if(null==e)return{};var t,n,o={},i=Object.keys(e);for(n=0;n<i.length;n++)t=i[n],r.indexOf(t)>=0||(o[t]=e[t]);return o}(e,r);if(Object.getOwnPropertySymbols){var i=Object.getOwnPropertySymbols(e);for(n=0;n<i.length;n++)t=i[n],r.indexOf(t)>=0||Object.prototype.propertyIsEnumerable.call(e,t)&&(o[t]=e[t])}return o}(m,["characterLimit","error","footer","header","inputHint","labelText","namespace","id","onBlur","onCancel","onChange","onFocus","onLinkAdded","onSave","placeholder","previews","readOnly","required","rows","size","warning","customPlugins","validationMessagePositionTop","toolbarControls"]);!Y&&Ee.value&&(Y=!0,w.deprecate("`value` is deprecated in TextEditor and support will soon be removed. Please use `initialValue` instead.")),!Z&&ue&&(Z=!0,w.deprecate("`onCancel` is deprecated in TextEditor and support will soon be removed. Please ensure that `TextEditor` is used as a part of a `Form` component, which will handle the cancel functionality.")),!ee&&he&&(ee=!0,w.deprecate("`onSave` is deprecated in TextEditor and support will soon be removed. Please ensure that `TextEditor` is used as a part of a `Form` component, which will handle the save functionality."));const Te=f(null!==(ne=null!==(te=Ee.initialValue)&&void 0!==te?te:Ee.value)&&void 0!==ne?ne:H()),ke=j(),[Se,Me]=g(void 0),$e=f(null),[Be,Fe]=g(null),[He,ze]=g(!1);h(W,(()=>({focus(){var e;null===(e=$e.current)||void 0===e||e.focus()}})),[]),v((()=>{const e=null==$e?void 0:$e.current,r=()=>{ze(!0)},t=()=>{ze(!1)};return null==e||e.addEventListener("focus",r),null==e||e.addEventListener("blur",t),()=>{null==e||e.removeEventListener("focus",r),null==e||e.removeEventListener("blur",t)}}),[$e]);const Ae=b((()=>({namespace:pe,nodes:P,onError:e=>w.error(e.message),theme:G(),editorState:Te.current,editable:!xe})),[pe,xe]),Re=x(((e,r)=>{const t=e.read((()=>u().getChildren().map((e=>e.getTextContent())).join("\n\n")));if(me){const e=z(r);null==me||me(t,e)}if(oe>0){const e=oe-t.length;Me(e<0?ke.textEditor.characterLimit(Math.abs(e)):void 0)}}),[oe,ke.textEditor,me]),qe=x((e=>{if(!e.isEditable())return;if(!ue)return;const r=e.parseEditorState(Te.current);e.setEditorState(r),ue()}),[ue]),De=b((()=>({namespace:pe,onCancel:ue?qe:void 0,onSave:he,toolbarControls:Ce})),[qe,pe,ue,he,Ce]),Ie=Oe||Se,Ve=()=>{switch(we){case"large":return"var(--spacing150)";case"small":return"var(--spacing050)";default:return"var(--spacing100)"}};return e(k,(Ue=X({"data-role":`${pe}-editor-wrapper`,onBlur:e=>{e.currentTarget.contains(e.relatedTarget)||null==_e||_e(e)},onFocus:e=>{e.currentTarget.contains(e.relatedTarget)||null==fe||fe(e)}},I(Ee),V("text-editor",Ee)),Ge={children:r(T.Provider,{value:{onLinkAdded:ge},children:[e(y,{onClick:()=>{var e;return null===(e=$e.current)||void 0===e?void 0:e.focus()},isRequired:ye,labelId:`${pe}-label`,children:ce}),se&&!xe&&e(R,{id:`${pe}-input-hint`,marginBottom:Ve(),children:se}),e(n,{initialConfig:Ae,children:r(S,{"data-role":`${pe}-wrapper`,ref:Fe,children:[Le&&r(t,{children:[e(q,{error:ie,warning:Ie,validationId:`${pe}-validation-message`,"data-role":`${pe}-validation-message`,validationMessagePositionTop:Le}),(ie||Ie)&&e(D,{warning:!(ie||!Ie)})]}),r(M,{"data-role":`${pe}-editor-toolbar-wrapper`,error:!!ie,id:`${pe}-editor-toolbar-wrapper`,children:[le&&e($,{"data-role":`${pe}-header-wrapper`,children:le}),xe?e(U,{"aria-label":ce,initialValue:(null===(re=$e.current)||void 0===re?void 0:re.innerHTML)||Te.current,size:we}):r(t,{children:[e(Q,X({contentEditorRef:$e,hasHeader:Boolean(le),size:we},De)),r(B,{"data-role":`${pe}-editor`,error:!!ie,children:[e(s,{contentEditable:e(K,{id:de,ref:$e,inputHint:se,isFocused:He,namespace:pe,previews:be,rows:je,readOnly:xe,required:ye,error:!!ie,warning:!!Oe||!!Se,validationMessagePositionTop:Le,size:we}),placeholder:e(N,{namespace:pe,text:ve}),ErrorBoundary:i}),e(p,{}),e(a,{}),e(l,{}),e(d,{onChange:Re,ignoreHistoryMergeTagChange:!0,ignoreSelectionChange:!0}),e(c,{validateUrl:A}),e(o,{newTab:!0}),e(L,{}),e(E,{}),e(_,{parentRef:Be,children:Pe})]})]}),ae&&e(F,{"data-role":`${pe}-footer-wrapper`,size:we,children:ae}),e(C,{})]}),!Le&&r(t,{children:[e(q,{error:ie,warning:Ie,validationId:`${pe}-validation-message`,"data-role":`${pe}-validation-message`,validationMessagePositionTop:Le}),(ie||Ie)&&e(D,{warning:!(ie||!Ie)})]}),oe>0&&!xe&&e(J,{isFocused:He,maxChars:oe,namespace:pe,marginTop:Ve()})]})})]})},Ge=null!=Ge?Ge:{},Object.getOwnPropertyDescriptors?Object.defineProperties(Ue,Object.getOwnPropertyDescriptors(Ge)):function(e){var r=Object.keys(e);if(Object.getOwnPropertySymbols){var t=Object.getOwnPropertySymbols(e);r.push.apply(r,t)}return r}(Object(Ge)).forEach((function(e){Object.defineProperty(Ue,e,Object.getOwnPropertyDescriptor(Ge,e))})),Ue));var Ue,Ge}));export{re as TextEditor,re as default};
+import{jsx as e,jsxs as r,Fragment as t}from"react/jsx-runtime";import{LexicalComposer as n}from"@lexical/react/LexicalComposer";import{ClickableLinkPlugin as o}from"@lexical/react/LexicalClickableLinkPlugin";import{LexicalErrorBoundary as i}from"@lexical/react/LexicalErrorBoundary";import{HistoryPlugin as a}from"@lexical/react/LexicalHistoryPlugin";import{MarkdownShortcutPlugin as l}from"@lexical/react/LexicalMarkdownShortcutPlugin";import{RichTextPlugin as s}from"@lexical/react/LexicalRichTextPlugin";import{LinkPlugin as c}from"@lexical/react/LexicalLinkPlugin";import{ListPlugin as p}from"@lexical/react/LexicalListPlugin";import{OnChangePlugin as d}from"@lexical/react/LexicalOnChangePlugin";import{PluginProvider as _}from"./__internal__/__providers__/plugin-provider.js";import{$getRoot as m}from"lexical";import{forwardRef as u,useRef as f,useState as g,useImperativeHandle as h,useEffect as v,useMemo as b,useCallback as x}from"react";import j from"../../__internal__/label/label.component.js";import y from"../../hooks/__internal__/useLocale/useLocale.js";import w from"../../__internal__/utils/logger/index.js";import{COMPONENT_PREFIX as O,MARKDOWN_NODES as P}from"./__internal__/__utils__/constants.js";import L from"./__internal__/__plugins__/AutoLinker/auto-link.component.js";import C from"./__internal__/__plugins__/LinkMonitor/link-monitor.plugin.js";import E from"./__internal__/__plugins__/StyledSpanEnter/styled-span-enter.plugin.js";import"./__internal__/__plugins__/useCursorAtEnd/index.js";import{FormSubmissionPlugin as T}from"./__internal__/__plugins__/FormSubmission/form-submission.plugin.js";import S from"./text-editor.context.js";import{StyledTextEditorWrapper as k,StyledWrapper as M,StyledEditorToolbarWrapper as $,StyledHeaderWrapper as F,StyledTextEditor as B,StyledFooterWrapper as H}from"./text-editor.style.js";import{createEmpty as z,SerializeLexical as A,validateUrl as R}from"./__internal__/__utils__/helpers.js";import{HintText as q}from"../../__internal__/hint-text/hint-text.component.js";import D from"../../__internal__/validation-message/validation-message.component.js";import I from"../textbox/textbox.style.js";import"../../style/utils/filter-styled-system-padding-props.js";import V from"../../style/utils/filter-styled-system-margin-props.js";import U from"../../__internal__/utils/helpers/tags/tags.js";import G from"./__internal__/__ui__/ReadOnlyEditor/read-only-rte.component.js";import{getTheme as J}from"./__internal__/__utils__/theme.js";import K from"./__internal__/__ui__/CharacterCounter/character-counter.component.js";import N from"./__internal__/__ui__/ContentEditor/content-editor.component.js";import"./__internal__/__ui__/LinkPreviewer/link-previewer.style.js";import"@lexical/react/LexicalComposerContext";import"@lexical/react/LexicalTypeaheadMenuPlugin";import"react-dom";import"./__internal__/__ui__/Mentions/constants.js";import"./__internal__/__ui__/Mentions/mentions.style.js";import"../tooltip/tooltip.component.js";import"../portrait/portrait.style.js";import Q from"./__internal__/__ui__/Placeholder/placeholder.component.js";import W from"./__internal__/__ui__/Toolbar/toolbar.component.js";function X(e,r,t){return r in e?Object.defineProperty(e,r,{value:t,enumerable:!0,configurable:!0,writable:!0}):e[r]=t,e}function Y(e){for(var r=1;r<arguments.length;r++){var t=null!=arguments[r]?arguments[r]:{},n=Object.keys(t);"function"==typeof Object.getOwnPropertySymbols&&(n=n.concat(Object.getOwnPropertySymbols(t).filter((function(e){return Object.getOwnPropertyDescriptor(t,e).enumerable})))),n.forEach((function(r){X(e,r,t[r])}))}return e}let Z=!1,ee=!1,re=!1;const te=u(((u,X)=>{var te,ne,oe,{characterLimit:ie=3e3,error:ae,footer:le,header:se,inputHint:ce,labelText:pe,namespace:de=O,id:_e,onBlur:me,onCancel:ue,onChange:fe,onFocus:ge,onLinkAdded:he,onSave:ve,onFormSubmission:be,placeholder:xe,previews:je=[],readOnly:ye=!1,required:we=!1,rows:Oe,size:Pe="medium",warning:Le,customPlugins:Ce,validationMessagePositionTop:Ee=!1,toolbarControls:Te}=u,Se=function(e,r){if(null==e)return{};var t,n,o=function(e,r){if(null==e)return{};var t,n,o={},i=Object.keys(e);for(n=0;n<i.length;n++)t=i[n],r.indexOf(t)>=0||(o[t]=e[t]);return o}(e,r);if(Object.getOwnPropertySymbols){var i=Object.getOwnPropertySymbols(e);for(n=0;n<i.length;n++)t=i[n],r.indexOf(t)>=0||Object.prototype.propertyIsEnumerable.call(e,t)&&(o[t]=e[t])}return o}(u,["characterLimit","error","footer","header","inputHint","labelText","namespace","id","onBlur","onCancel","onChange","onFocus","onLinkAdded","onSave","onFormSubmission","placeholder","previews","readOnly","required","rows","size","warning","customPlugins","validationMessagePositionTop","toolbarControls"]);!Z&&Se.value&&(Z=!0,w.deprecate("`value` is deprecated in TextEditor and support will soon be removed. Please use `initialValue` instead.")),!ee&&ue&&(ee=!0,w.deprecate("`onCancel` is deprecated in TextEditor and support will soon be removed. Please ensure that `TextEditor` is used as a part of a `Form` component, which will handle the cancel functionality.")),!re&&ve&&(re=!0,w.deprecate("`onSave` is deprecated in TextEditor and support will soon be removed. Please ensure that `TextEditor` is used as a part of a `Form` component, which will handle the save functionality."));const ke=f(null!==(oe=null!==(ne=Se.initialValue)&&void 0!==ne?ne:Se.value)&&void 0!==oe?oe:z()),Me=y(),[$e,Fe]=g(void 0),Be=f(null),[He,ze]=g(null),[Ae,Re]=g(!1);h(X,(()=>({focus(){var e;null===(e=Be.current)||void 0===e||e.focus()}})),[]),v((()=>{const e=null==Be?void 0:Be.current,r=()=>{Re(!0)},t=()=>{Re(!1)};return null==e||e.addEventListener("focus",r),null==e||e.addEventListener("blur",t),()=>{null==e||e.removeEventListener("focus",r),null==e||e.removeEventListener("blur",t)}}),[Be]);const qe=b((()=>({namespace:de,nodes:P,onError:e=>w.error(e.message),theme:J(),editorState:ke.current,editable:!ye})),[de,ye]),De=x(((e,r)=>{const t=e.read((()=>m().getChildren().map((e=>e.getTextContent())).join("\n\n")));if(fe){const e=A(r);null==fe||fe(t,e)}if(ie>0){const e=ie-t.length;Fe(e<0?Me.textEditor.characterLimit(Math.abs(e)):void 0)}}),[ie,Me.textEditor,fe]),Ie=x((e=>{if(!e.isEditable())return;if(!ue)return;const r=e.parseEditorState(ke.current);e.setEditorState(r),ue()}),[ue]),Ve=b((()=>({namespace:de,onCancel:ue?Ie:void 0,onSave:ve,toolbarControls:Te})),[Ie,de,ue,ve,Te]),Ue=Le||$e,Ge=()=>{switch(Pe){case"large":return"var(--spacing150)";case"small":return"var(--spacing050)";default:return"var(--spacing100)"}};return e(k,(Je=Y({"data-role":`${de}-editor-wrapper`,onBlur:e=>{e.currentTarget.contains(e.relatedTarget)||null==me||me(e)},onFocus:e=>{e.currentTarget.contains(e.relatedTarget)||null==ge||ge(e)}},V(Se),U("text-editor",Se)),Ke={children:r(S.Provider,{value:{onLinkAdded:he},children:[e(j,{onClick:()=>{var e;return null===(e=Be.current)||void 0===e?void 0:e.focus()},isRequired:we,labelId:`${de}-label`,children:pe}),ce&&!ye&&e(q,{id:`${de}-input-hint`,marginBottom:Ge(),children:ce}),e(n,{initialConfig:qe,children:r(M,{"data-role":`${de}-wrapper`,ref:ze,children:[Ee&&r(t,{children:[e(D,{error:ae,warning:Ue,validationId:`${de}-validation-message`,"data-role":`${de}-validation-message`,validationMessagePositionTop:Ee}),(ae||Ue)&&e(I,{warning:!(ae||!Ue)})]}),r($,{"data-role":`${de}-editor-toolbar-wrapper`,error:!!ae,id:`${de}-editor-toolbar-wrapper`,children:[se&&e(F,{"data-role":`${de}-header-wrapper`,children:se}),ye?e(G,{"aria-label":pe,initialValue:(null===(te=Be.current)||void 0===te?void 0:te.innerHTML)||ke.current,size:Pe}):r(t,{children:[e(W,Y({contentEditorRef:Be,hasHeader:Boolean(se),size:Pe},Ve)),r(B,{"data-role":`${de}-editor`,error:!!ae,children:[e(s,{contentEditable:e(N,{id:_e,ref:Be,inputHint:ce,isFocused:Ae,namespace:de,previews:je,rows:Oe,readOnly:ye,required:we,error:!!ae,warning:!!Le||!!$e,validationMessagePositionTop:Ee,size:Pe}),placeholder:e(Q,{namespace:de,text:xe}),ErrorBoundary:i}),e(p,{}),e(a,{}),e(l,{}),e(d,{onChange:De,ignoreHistoryMergeTagChange:!0,ignoreSelectionChange:!0}),e(c,{validateUrl:R}),e(o,{newTab:!0}),e(L,{}),e(E,{}),e(T,{onFormSubmission:be}),e(_,{parentRef:He,children:Ce})]})]}),le&&e(H,{"data-role":`${de}-footer-wrapper`,size:Pe,children:le}),e(C,{})]}),!Ee&&r(t,{children:[e(D,{error:ae,warning:Ue,validationId:`${de}-validation-message`,"data-role":`${de}-validation-message`,validationMessagePositionTop:Ee}),(ae||Ue)&&e(I,{warning:!(ae||!Ue)})]}),ie>0&&!ye&&e(K,{isFocused:Ae,maxChars:ie,namespace:de,marginTop:Ge()})]})})]})},Ke=null!=Ke?Ke:{},Object.getOwnPropertyDescriptors?Object.defineProperties(Je,Object.getOwnPropertyDescriptors(Ke)):function(e){var r=Object.keys(e);if(Object.getOwnPropertySymbols){var t=Object.getOwnPropertySymbols(e);r.push.apply(r,t)}return r}(Object(Ke)).forEach((function(e){Object.defineProperty(Je,e,Object.getOwnPropertyDescriptor(Ke,e))})),Je));var Je,Ke}));export{te as TextEditor,te as default};

package/lib/components/text-editor/__internal__/__plugins__/FormSubmission/form-submission.plugin.d.ts

@@ -0,0 +1,22 @@
+import type { EditorFormattedValuesWithInlineStyles } from "../../__utils__/interfaces.types";
+/**
+ * FormSubmissionPlugin - A Lexical plugin that listens for form submission events
+ * and calls the onFormSubmission callback with the current editor state.
+ *
+ * Returns the editor's current formatted values (HTML and JSON) including HTML with inline styles.
+ *
+ * @param onFormSubmission - Callback function that receives EditorFormattedValuesWithInlineStyles containing:
+ *   - htmlString: string - HTML representation of the editor content
+ *   - json: object - JSON representation of the editor state
+ *   - htmlStringWithInlineStyles: string - HTML with inline styles instead of classes
+ *
+ * @example
+ * <TextEditor labelText="...">
+ *   <FormSubmissionPlugin onFormSubmission={(values) => console.log(values.htmlStringWithInlineStyles)} />
+ * </TextEditor>
+ */
+export interface FormSubmissionPluginProps {
+    onFormSubmission?: (value: EditorFormattedValuesWithInlineStyles) => void;
+}
+export declare const FormSubmissionPlugin: ({ onFormSubmission, }: FormSubmissionPluginProps) => null;
+export default FormSubmissionPlugin;

package/lib/components/text-editor/__internal__/__plugins__/FormSubmission/form-submission.plugin.js

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,"__esModule",{value:!0});var e=require("@lexical/react/LexicalComposerContext"),t=require("react"),r=require("../../__utils__/helpers.js");function n(e,t,r){return t in e?Object.defineProperty(e,t,{value:r,enumerable:!0,configurable:!0,writable:!0}):e[t]=r,e}const o=({onFormSubmission:o})=>{const[i]=e.useLexicalComposerContext();return t.useEffect((()=>{var e;if(!o)return;const t=null===(e=i.getRootElement())||void 0===e?void 0:e.closest("form");if(!t)return;const c=()=>{if(!i.isEditable())return;const e=r.SerializeLexical(i),t=e.htmlString&&r.generateHTMLWithInlineStyles(e.htmlString);var c,s;o((c=function(e){for(var t=1;t<arguments.length;t++){var r=null!=arguments[t]?arguments[t]:{},o=Object.keys(r);"function"==typeof Object.getOwnPropertySymbols&&(o=o.concat(Object.getOwnPropertySymbols(r).filter((function(e){return Object.getOwnPropertyDescriptor(r,e).enumerable})))),o.forEach((function(t){n(e,t,r[t])}))}return e}({},e),s=null!=(s={htmlStringWithInlineStyles:t||""})?s:{},Object.getOwnPropertyDescriptors?Object.defineProperties(c,Object.getOwnPropertyDescriptors(s)):function(e){var t=Object.keys(e);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(e);t.push.apply(t,r)}return t}(Object(s)).forEach((function(e){Object.defineProperty(c,e,Object.getOwnPropertyDescriptor(s,e))})),c))};return t.addEventListener("submit",c),()=>{t.removeEventListener("submit",c)}}),[i,o]),null};exports.FormSubmissionPlugin=o,exports.default=o;

package/lib/components/text-editor/__internal__/__plugins__/FormSubmission/index.d.ts

@@ -0,0 +1 @@
+export { default } from "./form-submission.plugin";

package/lib/components/text-editor/__internal__/__plugins__/FormSubmission/index.js

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,"__esModule",{value:!0});var e=require("./form-submission.plugin.js");exports.default=e.FormSubmissionPlugin;

package/lib/components/text-editor/__internal__/__plugins__/FormSubmission/package.json

@@ -0,0 +1,6 @@
+{
+  "sideEffects": false,
+  "main": "./index.js",
+  "module": "../../../esm/components/text-editor/__internal__/__plugins__/FormSubmission/index.js",
+  "types": "./index.d.ts"
+}

package/lib/components/text-editor/__internal__/__plugins__/index.d.ts

@@ -2,3 +2,4 @@ export { default as AutoLinkerPlugin } from "./AutoLinker";
 export { default as LinkMonitorPlugin } from "./LinkMonitor";
 export { default as StyledSpanEnterPlugin } from "./StyledSpanEnter";
 export { default as useCursorAtEnd } from "./useCursorAtEnd";
+export { default as FormSubmissionPlugin } from "./FormSubmission";

package/lib/components/text-editor/__internal__/__plugins__/index.js

@@ -1 +1 @@
-"use strict";var e=require("./AutoLinker/auto-link.component.js"),r=require("./LinkMonitor/link-monitor.plugin.js"),n=require("./StyledSpanEnter/styled-span-enter.plugin.js"),t=require("./useCursorAtEnd/index.js");exports.AutoLinkerPlugin=e.default,exports.LinkMonitorPlugin=r.default,exports.StyledSpanEnterPlugin=n.default,exports.useCursorAtEnd=t.default;
+"use strict";var e=require("./AutoLinker/auto-link.component.js"),r=require("./LinkMonitor/link-monitor.plugin.js"),i=require("./StyledSpanEnter/styled-span-enter.plugin.js"),n=require("./useCursorAtEnd/index.js"),u=require("./FormSubmission/form-submission.plugin.js");exports.AutoLinkerPlugin=e.default,exports.LinkMonitorPlugin=r.default,exports.StyledSpanEnterPlugin=i.default,exports.useCursorAtEnd=n.default,exports.FormSubmissionPlugin=u.FormSubmissionPlugin;

package/lib/components/text-editor/__internal__/__utils__/helpers.d.ts

@@ -1,4 +1,19 @@
 import { LexicalEditor } from "lexical";
+/**
+ * Post-processes HTML serialised from the Lexical editor, converting class-based
+ * text formatting to inline styles and applying brand-consistent defaults to all elements.
+ *
+ * Specifically:
+ * - Converts Lexical's text format classes (textBold, textItalic, textUnderline)
+ *   to their inline style equivalents
+ * - Applies the Sage UI font family to all elements
+ * - Applies link styles (color, cursor, underline) to anchor elements
+ * - Preserves any existing inline styles set by Lexical (e.g. white-space: pre-wrap)
+ *
+ * This ensures the output HTML is portable and renders correctly in contexts where
+ * the Lexical stylesheet is not present, such as email templates or external consumers.
+ */
+declare const generateHTMLWithInlineStyles: (html: string) => string;
 /**
  * This helper takes the current state of the editor and serializes it into two formats:
  * 1. HTML
@@ -20,4 +35,4 @@ declare function validateUrl(url: string): boolean;
 declare const createFromHTML: (html: string) => string;
 /** Creates and returns a string representation of an empty editor */
 declare const createEmpty: () => string;
-export { createEmpty, createFromHTML, DeserializeHTML, SerializeLexical, validateUrl, };
+export { createEmpty, createFromHTML, DeserializeHTML, SerializeLexical, generateHTMLWithInlineStyles, validateUrl, };

package/lib/components/text-editor/__internal__/__utils__/helpers.js

@@ -1 +1 @@
-"use strict";var e=require("@lexical/headless"),t=require("@lexical/html"),r=require("lexical"),o=require("./constants.js"),n=require("./theme.js"),s=require("../../../../__internal__/utils/logger/index.js");const i=i=>{const a=e.createHeadlessEditor({namespace:"html-to-json",onError:e=>s.default.error(e.message),theme:n.getTheme(),nodes:o.MARKDOWN_NODES});let l;if(a.update((()=>{const e=(new DOMParser).parseFromString(i,"text/html"),o=t.$generateNodesFromDOM(a,e);r.$getRoot().select();const n=r.$getSelection();if(n)try{n.insertNodes(o)}catch(e){l=e}}),{discrete:!0}),l)throw l;const c=a.getEditorState().toJSON();return JSON.stringify(c)},a=new RegExp(/((([A-Za-z]{3,9}:(?:\/\/)?)(?:[-;:&=+$,\w]+@)?[A-Za-z0-9.-]+|(?:www.|[-;:&=+$,\w]+@)[A-Za-z0-9.-]+)((?:\/[+~%/.\w-_]*)?\??(?:[-+=&;%@.\w_]*)#?(?:[\w]*))?)/);exports.DeserializeHTML=i,exports.SerializeLexical=e=>{let r,o;return e.read((()=>{const n=e.getEditorState();o=n.toJSON(),r=t.$generateHtmlFromNodes(e,null)})),{htmlString:r,json:o}},exports.createEmpty=()=>'{"root":{"children":[{"children":[],"direction":null,"format":"","indent":0,"type":"paragraph","version":1}],"direction":null,"format":"","indent":0,"type":"root","version":1}}',exports.createFromHTML=e=>i(e),exports.validateUrl=function(e){return"https://"===e||a.test(e)};
+"use strict";var e=require("@lexical/headless"),t=require("@lexical/html"),r=require("lexical"),o=require("./constants.js"),s=require("./theme.js"),n=require("../../../../__internal__/utils/logger/index.js");const i="font-family: 'Sage UI', sans-serif;",l=`color: #007e45ff; cursor: pointer; text-decoration: underline; ${i}`,a={textBold:"font-weight: bold;",textItalic:"font-style: italic;",textUnderline:"text-decoration: underline;"},c=i=>{const l=e.createHeadlessEditor({namespace:"html-to-json",onError:e=>n.default.error(e.message),theme:s.getTheme(),nodes:o.MARKDOWN_NODES});let a;if(l.update((()=>{const e=(new DOMParser).parseFromString(i,"text/html"),o=t.$generateNodesFromDOM(l,e);r.$getRoot().select();const s=r.$getSelection();if(s)try{s.insertNodes(o)}catch(e){a=e}}),{discrete:!0}),a)throw a;const c=l.getEditorState().toJSON();return JSON.stringify(c)},d=new RegExp(/((([A-Za-z]{3,9}:(?:\/\/)?)(?:[-;:&=+$,\w]+@)?[A-Za-z0-9.-]+|(?:www.|[-;:&=+$,\w]+@)[A-Za-z0-9.-]+)((?:\/[+~%/.\w-_]*)?\??(?:[-+=&;%@.\w_]*)#?(?:[\w]*))?)/);exports.DeserializeHTML=c,exports.SerializeLexical=e=>{let r,o;return e.read((()=>{const s=e.getEditorState();o=s.toJSON(),r=t.$generateHtmlFromNodes(e,null)})),{htmlString:r,json:o}},exports.createEmpty=()=>'{"root":{"children":[{"children":[],"direction":null,"format":"","indent":0,"type":"paragraph","version":1}],"direction":null,"format":"","indent":0,"type":"root","version":1}}',exports.createFromHTML=e=>c(e),exports.generateHTMLWithInlineStyles=e=>{const t=(new DOMParser).parseFromString(e,"text/html");return t.body.querySelectorAll("*").forEach((e=>{const t=e,r=[];var o;Array.from(t.classList).forEach((e=>{const o=a[e];o&&(r.push(o),t.classList.remove(e))})),"A"===t.tagName?r.push(l):r.push(i);const s=[null!==(o=t.getAttribute("style"))&&void 0!==o?o:"",...r].filter(Boolean).join(" ");t.setAttribute("style",s),0===t.classList.length&&t.removeAttribute("class")})),t.body.innerHTML},exports.validateUrl=function(e){return"https://"===e||d.test(e)};

package/lib/components/text-editor/__internal__/__utils__/interfaces.types.d.ts

@@ -43,6 +43,11 @@ export interface TextEditorProps extends MarginProps, TagProps {
      * @deprecated Please ensure that `TextEditor` is used as a part of a `Form` component, which will handle the save functionality.
      */
     onSave?: (value: EditorFormattedValues) => void;
+    /**
+     * Callback that is triggered when a parent form of the editor is submitted.
+     * The callback returns the current content of the editor in multiple formats, including HTML with inline styles.
+     */
+    onFormSubmission?: (value: EditorFormattedValuesWithInlineStyles) => void;
     /** The placeholder to display when the editor is empty */
     placeholder?: string;
     /** An array of link preview nodes to render in the editor */
@@ -180,6 +185,10 @@ export interface EditorFormattedValues {
         };
     };
 }
+export interface EditorFormattedValuesWithInlineStyles extends EditorFormattedValues {
+    htmlStringWithInlineStyles?: string;
+}
+export type onFormSubmissionCallback = (value: EditorFormattedValuesWithInlineStyles) => void;
 export interface SaveButtonProps {
     /** The namespace of the editor that this button belongs to */
     namespace: string;

package/lib/components/text-editor/index.d.ts

@@ -1,5 +1,5 @@
 export { default } from "./text-editor.component";
 export { createEmpty, createFromHTML } from "./__internal__/__utils__/helpers";
-export type { TextEditorHandle, TextEditorProps, EditorFormattedValues, } from "./__internal__/__utils__/interfaces.types";
+export type { TextEditorHandle, TextEditorProps, EditorFormattedValues, EditorFormattedValuesWithInlineStyles, } from "./__internal__/__utils__/interfaces.types";
 export { default as MentionsPlugin } from "./__internal__/__ui__/Mentions/";
 export type { Mention } from "./__internal__/__ui__/Mentions";

package/lib/components/text-editor/text-editor.component.js

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:!0});var e=require("react/jsx-runtime"),r=require("@lexical/react/LexicalComposer"),t=require("@lexical/react/LexicalClickableLinkPlugin"),n=require("@lexical/react/LexicalErrorBoundary"),i=require("@lexical/react/LexicalHistoryPlugin"),a=require("@lexical/react/LexicalMarkdownShortcutPlugin"),l=require("@lexical/react/LexicalRichTextPlugin"),o=require("@lexical/react/LexicalLinkPlugin"),s=require("@lexical/react/LexicalListPlugin"),u=require("@lexical/react/LexicalOnChangePlugin"),d=require("./__internal__/__providers__/plugin-provider.js"),c=require("lexical"),_=require("react"),p=require("../../__internal__/label/label.component.js"),x=require("../../hooks/__internal__/useLocale/useLocale.js"),g=require("../../__internal__/utils/logger/index.js"),j=require("./__internal__/__utils__/constants.js"),f=require("./__internal__/__plugins__/AutoLinker/auto-link.component.js"),m=require("./__internal__/__plugins__/LinkMonitor/link-monitor.plugin.js"),v=require("./__internal__/__plugins__/StyledSpanEnter/styled-span-enter.plugin.js");require("./__internal__/__plugins__/useCursorAtEnd/index.js");var h=require("./text-editor.context.js"),b=require("./text-editor.style.js"),y=require("./__internal__/__utils__/helpers.js"),q=require("../../__internal__/hint-text/hint-text.component.js"),P=require("../../__internal__/validation-message/validation-message.component.js"),w=require("../textbox/textbox.style.js");require("../../style/utils/filter-styled-system-padding-props.js");var O=require("../../style/utils/filter-styled-system-margin-props.js"),E=require("../../__internal__/utils/helpers/tags/tags.js"),L=require("./__internal__/__ui__/ReadOnlyEditor/read-only-rte.component.js"),C=require("./__internal__/__utils__/theme.js"),T=require("./__internal__/__ui__/CharacterCounter/character-counter.component.js"),S=require("./__internal__/__ui__/ContentEditor/content-editor.component.js");require("./__internal__/__ui__/LinkPreviewer/link-previewer.style.js"),require("@lexical/react/LexicalComposerContext"),require("@lexical/react/LexicalTypeaheadMenuPlugin"),require("react-dom"),require("./__internal__/__ui__/Mentions/constants.js"),require("./__internal__/__ui__/Mentions/mentions.style.js"),require("../tooltip/tooltip.component.js"),require("../portrait/portrait.style.js");var k=require("./__internal__/__ui__/Placeholder/placeholder.component.js"),M=require("./__internal__/__ui__/Toolbar/toolbar.component.js");function $(e,r,t){return r in e?Object.defineProperty(e,r,{value:t,enumerable:!0,configurable:!0,writable:!0}):e[r]=t,e}function F(e){for(var r=1;r<arguments.length;r++){var t=null!=arguments[r]?arguments[r]:{},n=Object.keys(t);"function"==typeof Object.getOwnPropertySymbols&&(n=n.concat(Object.getOwnPropertySymbols(t).filter((function(e){return Object.getOwnPropertyDescriptor(t,e).enumerable})))),n.forEach((function(r){$(e,r,t[r])}))}return e}let R=!1,H=!1,B=!1;const z=_.forwardRef((($,z)=>{var A,D,I,{characterLimit:W=3e3,error:N,footer:V,header:U,inputHint:K,labelText:X,namespace:G=j.COMPONENT_PREFIX,id:J,onBlur:Q,onCancel:Y,onChange:Z,onFocus:ee,onLinkAdded:re,onSave:te,placeholder:ne,previews:ie=[],readOnly:ae=!1,required:le=!1,rows:oe,size:se="medium",warning:ue,customPlugins:de,validationMessagePositionTop:ce=!1,toolbarControls:_e}=$,pe=function(e,r){if(null==e)return{};var t,n,i=function(e,r){if(null==e)return{};var t,n,i={},a=Object.keys(e);for(n=0;n<a.length;n++)t=a[n],r.indexOf(t)>=0||(i[t]=e[t]);return i}(e,r);if(Object.getOwnPropertySymbols){var a=Object.getOwnPropertySymbols(e);for(n=0;n<a.length;n++)t=a[n],r.indexOf(t)>=0||Object.prototype.propertyIsEnumerable.call(e,t)&&(i[t]=e[t])}return i}($,["characterLimit","error","footer","header","inputHint","labelText","namespace","id","onBlur","onCancel","onChange","onFocus","onLinkAdded","onSave","placeholder","previews","readOnly","required","rows","size","warning","customPlugins","validationMessagePositionTop","toolbarControls"]);!R&&pe.value&&(R=!0,g.default.deprecate("`value` is deprecated in TextEditor and support will soon be removed. Please use `initialValue` instead.")),!H&&Y&&(H=!0,g.default.deprecate("`onCancel` is deprecated in TextEditor and support will soon be removed. Please ensure that `TextEditor` is used as a part of a `Form` component, which will handle the cancel functionality.")),!B&&te&&(B=!0,g.default.deprecate("`onSave` is deprecated in TextEditor and support will soon be removed. Please ensure that `TextEditor` is used as a part of a `Form` component, which will handle the save functionality."));const xe=_.useRef(null!==(I=null!==(D=pe.initialValue)&&void 0!==D?D:pe.value)&&void 0!==I?I:y.createEmpty()),ge=x.default(),[je,fe]=_.useState(void 0),me=_.useRef(null),[ve,he]=_.useState(null),[be,ye]=_.useState(!1);_.useImperativeHandle(z,(()=>({focus(){var e;null===(e=me.current)||void 0===e||e.focus()}})),[]),_.useEffect((()=>{const e=null==me?void 0:me.current,r=()=>{ye(!0)},t=()=>{ye(!1)};return null==e||e.addEventListener("focus",r),null==e||e.addEventListener("blur",t),()=>{null==e||e.removeEventListener("focus",r),null==e||e.removeEventListener("blur",t)}}),[me]);const qe=_.useMemo((()=>({namespace:G,nodes:j.MARKDOWN_NODES,onError:e=>g.default.error(e.message),theme:C.getTheme(),editorState:xe.current,editable:!ae})),[G,ae]),Pe=_.useCallback(((e,r)=>{const t=e.read((()=>c.$getRoot().getChildren().map((e=>e.getTextContent())).join("\n\n")));if(Z){const e=y.SerializeLexical(r);null==Z||Z(t,e)}if(W>0){const e=W-t.length;fe(e<0?ge.textEditor.characterLimit(Math.abs(e)):void 0)}}),[W,ge.textEditor,Z]),we=_.useCallback((e=>{if(!e.isEditable())return;if(!Y)return;const r=e.parseEditorState(xe.current);e.setEditorState(r),Y()}),[Y]),Oe=_.useMemo((()=>({namespace:G,onCancel:Y?we:void 0,onSave:te,toolbarControls:_e})),[we,G,Y,te,_e]),Ee=ue||je,Le=()=>{switch(se){case"large":return"var(--spacing150)";case"small":return"var(--spacing050)";default:return"var(--spacing100)"}};return e.jsx(b.StyledTextEditorWrapper,(Ce=F({"data-role":`${G}-editor-wrapper`,onBlur:e=>{e.currentTarget.contains(e.relatedTarget)||null==Q||Q(e)},onFocus:e=>{e.currentTarget.contains(e.relatedTarget)||null==ee||ee(e)}},O.default(pe),E.default("text-editor",pe)),Te={children:e.jsxs(h.default.Provider,{value:{onLinkAdded:re},children:[e.jsx(p.default,{onClick:()=>{var e;return null===(e=me.current)||void 0===e?void 0:e.focus()},isRequired:le,labelId:`${G}-label`,children:X}),K&&!ae&&e.jsx(q.HintText,{id:`${G}-input-hint`,marginBottom:Le(),children:K}),e.jsx(r.LexicalComposer,{initialConfig:qe,children:e.jsxs(b.StyledWrapper,{"data-role":`${G}-wrapper`,ref:he,children:[ce&&e.jsxs(e.Fragment,{children:[e.jsx(P.default,{error:N,warning:Ee,validationId:`${G}-validation-message`,"data-role":`${G}-validation-message`,validationMessagePositionTop:ce}),(N||Ee)&&e.jsx(w.default,{warning:!(N||!Ee)})]}),e.jsxs(b.StyledEditorToolbarWrapper,{"data-role":`${G}-editor-toolbar-wrapper`,error:!!N,id:`${G}-editor-toolbar-wrapper`,children:[U&&e.jsx(b.StyledHeaderWrapper,{"data-role":`${G}-header-wrapper`,children:U}),ae?e.jsx(L.default,{"aria-label":X,initialValue:(null===(A=me.current)||void 0===A?void 0:A.innerHTML)||xe.current,size:se}):e.jsxs(e.Fragment,{children:[e.jsx(M.default,F({contentEditorRef:me,hasHeader:Boolean(U),size:se},Oe)),e.jsxs(b.StyledTextEditor,{"data-role":`${G}-editor`,error:!!N,children:[e.jsx(l.RichTextPlugin,{contentEditable:e.jsx(S.default,{id:J,ref:me,inputHint:K,isFocused:be,namespace:G,previews:ie,rows:oe,readOnly:ae,required:le,error:!!N,warning:!!ue||!!je,validationMessagePositionTop:ce,size:se}),placeholder:e.jsx(k.default,{namespace:G,text:ne}),ErrorBoundary:n.LexicalErrorBoundary}),e.jsx(s.ListPlugin,{}),e.jsx(i.HistoryPlugin,{}),e.jsx(a.MarkdownShortcutPlugin,{}),e.jsx(u.OnChangePlugin,{onChange:Pe,ignoreHistoryMergeTagChange:!0,ignoreSelectionChange:!0}),e.jsx(o.LinkPlugin,{validateUrl:y.validateUrl}),e.jsx(t.ClickableLinkPlugin,{newTab:!0}),e.jsx(f.default,{}),e.jsx(v.default,{}),e.jsx(d.PluginProvider,{parentRef:ve,children:de})]})]}),V&&e.jsx(b.StyledFooterWrapper,{"data-role":`${G}-footer-wrapper`,size:se,children:V}),e.jsx(m.default,{})]}),!ce&&e.jsxs(e.Fragment,{children:[e.jsx(P.default,{error:N,warning:Ee,validationId:`${G}-validation-message`,"data-role":`${G}-validation-message`,validationMessagePositionTop:ce}),(N||Ee)&&e.jsx(w.default,{warning:!(N||!Ee)})]}),W>0&&!ae&&e.jsx(T.default,{isFocused:be,maxChars:W,namespace:G,marginTop:Le()})]})})]})},Te=null!=Te?Te:{},Object.getOwnPropertyDescriptors?Object.defineProperties(Ce,Object.getOwnPropertyDescriptors(Te)):function(e){var r=Object.keys(e);if(Object.getOwnPropertySymbols){var t=Object.getOwnPropertySymbols(e);r.push.apply(r,t)}return r}(Object(Te)).forEach((function(e){Object.defineProperty(Ce,e,Object.getOwnPropertyDescriptor(Te,e))})),Ce));var Ce,Te}));exports.TextEditor=z,exports.default=z;
+"use strict";Object.defineProperty(exports,"__esModule",{value:!0});var e=require("react/jsx-runtime"),r=require("@lexical/react/LexicalComposer"),t=require("@lexical/react/LexicalClickableLinkPlugin"),n=require("@lexical/react/LexicalErrorBoundary"),i=require("@lexical/react/LexicalHistoryPlugin"),a=require("@lexical/react/LexicalMarkdownShortcutPlugin"),l=require("@lexical/react/LexicalRichTextPlugin"),o=require("@lexical/react/LexicalLinkPlugin"),s=require("@lexical/react/LexicalListPlugin"),u=require("@lexical/react/LexicalOnChangePlugin"),d=require("./__internal__/__providers__/plugin-provider.js"),c=require("lexical"),_=require("react"),p=require("../../__internal__/label/label.component.js"),g=require("../../hooks/__internal__/useLocale/useLocale.js"),x=require("../../__internal__/utils/logger/index.js"),m=require("./__internal__/__utils__/constants.js"),j=require("./__internal__/__plugins__/AutoLinker/auto-link.component.js"),f=require("./__internal__/__plugins__/LinkMonitor/link-monitor.plugin.js"),v=require("./__internal__/__plugins__/StyledSpanEnter/styled-span-enter.plugin.js");require("./__internal__/__plugins__/useCursorAtEnd/index.js");var h=require("./__internal__/__plugins__/FormSubmission/form-submission.plugin.js"),b=require("./text-editor.context.js"),y=require("./text-editor.style.js"),q=require("./__internal__/__utils__/helpers.js"),P=require("../../__internal__/hint-text/hint-text.component.js"),w=require("../../__internal__/validation-message/validation-message.component.js"),O=require("../textbox/textbox.style.js");require("../../style/utils/filter-styled-system-padding-props.js");var E=require("../../style/utils/filter-styled-system-margin-props.js"),L=require("../../__internal__/utils/helpers/tags/tags.js"),S=require("./__internal__/__ui__/ReadOnlyEditor/read-only-rte.component.js"),C=require("./__internal__/__utils__/theme.js"),T=require("./__internal__/__ui__/CharacterCounter/character-counter.component.js"),k=require("./__internal__/__ui__/ContentEditor/content-editor.component.js");require("./__internal__/__ui__/LinkPreviewer/link-previewer.style.js"),require("@lexical/react/LexicalComposerContext"),require("@lexical/react/LexicalTypeaheadMenuPlugin"),require("react-dom"),require("./__internal__/__ui__/Mentions/constants.js"),require("./__internal__/__ui__/Mentions/mentions.style.js"),require("../tooltip/tooltip.component.js"),require("../portrait/portrait.style.js");var M=require("./__internal__/__ui__/Placeholder/placeholder.component.js"),F=require("./__internal__/__ui__/Toolbar/toolbar.component.js");function $(e,r,t){return r in e?Object.defineProperty(e,r,{value:t,enumerable:!0,configurable:!0,writable:!0}):e[r]=t,e}function R(e){for(var r=1;r<arguments.length;r++){var t=null!=arguments[r]?arguments[r]:{},n=Object.keys(t);"function"==typeof Object.getOwnPropertySymbols&&(n=n.concat(Object.getOwnPropertySymbols(t).filter((function(e){return Object.getOwnPropertyDescriptor(t,e).enumerable})))),n.forEach((function(r){$(e,r,t[r])}))}return e}let H=!1,B=!1,z=!1;const A=_.forwardRef((($,A)=>{var D,I,W,{characterLimit:N=3e3,error:V,footer:U,header:K,inputHint:X,labelText:G,namespace:J=m.COMPONENT_PREFIX,id:Q,onBlur:Y,onCancel:Z,onChange:ee,onFocus:re,onLinkAdded:te,onSave:ne,onFormSubmission:ie,placeholder:ae,previews:le=[],readOnly:oe=!1,required:se=!1,rows:ue,size:de="medium",warning:ce,customPlugins:_e,validationMessagePositionTop:pe=!1,toolbarControls:ge}=$,xe=function(e,r){if(null==e)return{};var t,n,i=function(e,r){if(null==e)return{};var t,n,i={},a=Object.keys(e);for(n=0;n<a.length;n++)t=a[n],r.indexOf(t)>=0||(i[t]=e[t]);return i}(e,r);if(Object.getOwnPropertySymbols){var a=Object.getOwnPropertySymbols(e);for(n=0;n<a.length;n++)t=a[n],r.indexOf(t)>=0||Object.prototype.propertyIsEnumerable.call(e,t)&&(i[t]=e[t])}return i}($,["characterLimit","error","footer","header","inputHint","labelText","namespace","id","onBlur","onCancel","onChange","onFocus","onLinkAdded","onSave","onFormSubmission","placeholder","previews","readOnly","required","rows","size","warning","customPlugins","validationMessagePositionTop","toolbarControls"]);!H&&xe.value&&(H=!0,x.default.deprecate("`value` is deprecated in TextEditor and support will soon be removed. Please use `initialValue` instead.")),!B&&Z&&(B=!0,x.default.deprecate("`onCancel` is deprecated in TextEditor and support will soon be removed. Please ensure that `TextEditor` is used as a part of a `Form` component, which will handle the cancel functionality.")),!z&&ne&&(z=!0,x.default.deprecate("`onSave` is deprecated in TextEditor and support will soon be removed. Please ensure that `TextEditor` is used as a part of a `Form` component, which will handle the save functionality."));const me=_.useRef(null!==(W=null!==(I=xe.initialValue)&&void 0!==I?I:xe.value)&&void 0!==W?W:q.createEmpty()),je=g.default(),[fe,ve]=_.useState(void 0),he=_.useRef(null),[be,ye]=_.useState(null),[qe,Pe]=_.useState(!1);_.useImperativeHandle(A,(()=>({focus(){var e;null===(e=he.current)||void 0===e||e.focus()}})),[]),_.useEffect((()=>{const e=null==he?void 0:he.current,r=()=>{Pe(!0)},t=()=>{Pe(!1)};return null==e||e.addEventListener("focus",r),null==e||e.addEventListener("blur",t),()=>{null==e||e.removeEventListener("focus",r),null==e||e.removeEventListener("blur",t)}}),[he]);const we=_.useMemo((()=>({namespace:J,nodes:m.MARKDOWN_NODES,onError:e=>x.default.error(e.message),theme:C.getTheme(),editorState:me.current,editable:!oe})),[J,oe]),Oe=_.useCallback(((e,r)=>{const t=e.read((()=>c.$getRoot().getChildren().map((e=>e.getTextContent())).join("\n\n")));if(ee){const e=q.SerializeLexical(r);null==ee||ee(t,e)}if(N>0){const e=N-t.length;ve(e<0?je.textEditor.characterLimit(Math.abs(e)):void 0)}}),[N,je.textEditor,ee]),Ee=_.useCallback((e=>{if(!e.isEditable())return;if(!Z)return;const r=e.parseEditorState(me.current);e.setEditorState(r),Z()}),[Z]),Le=_.useMemo((()=>({namespace:J,onCancel:Z?Ee:void 0,onSave:ne,toolbarControls:ge})),[Ee,J,Z,ne,ge]),Se=ce||fe,Ce=()=>{switch(de){case"large":return"var(--spacing150)";case"small":return"var(--spacing050)";default:return"var(--spacing100)"}};return e.jsx(y.StyledTextEditorWrapper,(Te=R({"data-role":`${J}-editor-wrapper`,onBlur:e=>{e.currentTarget.contains(e.relatedTarget)||null==Y||Y(e)},onFocus:e=>{e.currentTarget.contains(e.relatedTarget)||null==re||re(e)}},E.default(xe),L.default("text-editor",xe)),ke={children:e.jsxs(b.default.Provider,{value:{onLinkAdded:te},children:[e.jsx(p.default,{onClick:()=>{var e;return null===(e=he.current)||void 0===e?void 0:e.focus()},isRequired:se,labelId:`${J}-label`,children:G}),X&&!oe&&e.jsx(P.HintText,{id:`${J}-input-hint`,marginBottom:Ce(),children:X}),e.jsx(r.LexicalComposer,{initialConfig:we,children:e.jsxs(y.StyledWrapper,{"data-role":`${J}-wrapper`,ref:ye,children:[pe&&e.jsxs(e.Fragment,{children:[e.jsx(w.default,{error:V,warning:Se,validationId:`${J}-validation-message`,"data-role":`${J}-validation-message`,validationMessagePositionTop:pe}),(V||Se)&&e.jsx(O.default,{warning:!(V||!Se)})]}),e.jsxs(y.StyledEditorToolbarWrapper,{"data-role":`${J}-editor-toolbar-wrapper`,error:!!V,id:`${J}-editor-toolbar-wrapper`,children:[K&&e.jsx(y.StyledHeaderWrapper,{"data-role":`${J}-header-wrapper`,children:K}),oe?e.jsx(S.default,{"aria-label":G,initialValue:(null===(D=he.current)||void 0===D?void 0:D.innerHTML)||me.current,size:de}):e.jsxs(e.Fragment,{children:[e.jsx(F.default,R({contentEditorRef:he,hasHeader:Boolean(K),size:de},Le)),e.jsxs(y.StyledTextEditor,{"data-role":`${J}-editor`,error:!!V,children:[e.jsx(l.RichTextPlugin,{contentEditable:e.jsx(k.default,{id:Q,ref:he,inputHint:X,isFocused:qe,namespace:J,previews:le,rows:ue,readOnly:oe,required:se,error:!!V,warning:!!ce||!!fe,validationMessagePositionTop:pe,size:de}),placeholder:e.jsx(M.default,{namespace:J,text:ae}),ErrorBoundary:n.LexicalErrorBoundary}),e.jsx(s.ListPlugin,{}),e.jsx(i.HistoryPlugin,{}),e.jsx(a.MarkdownShortcutPlugin,{}),e.jsx(u.OnChangePlugin,{onChange:Oe,ignoreHistoryMergeTagChange:!0,ignoreSelectionChange:!0}),e.jsx(o.LinkPlugin,{validateUrl:q.validateUrl}),e.jsx(t.ClickableLinkPlugin,{newTab:!0}),e.jsx(j.default,{}),e.jsx(v.default,{}),e.jsx(h.FormSubmissionPlugin,{onFormSubmission:ie}),e.jsx(d.PluginProvider,{parentRef:be,children:_e})]})]}),U&&e.jsx(y.StyledFooterWrapper,{"data-role":`${J}-footer-wrapper`,size:de,children:U}),e.jsx(f.default,{})]}),!pe&&e.jsxs(e.Fragment,{children:[e.jsx(w.default,{error:V,warning:Se,validationId:`${J}-validation-message`,"data-role":`${J}-validation-message`,validationMessagePositionTop:pe}),(V||Se)&&e.jsx(O.default,{warning:!(V||!Se)})]}),N>0&&!oe&&e.jsx(T.default,{isFocused:qe,maxChars:N,namespace:J,marginTop:Ce()})]})})]})},ke=null!=ke?ke:{},Object.getOwnPropertyDescriptors?Object.defineProperties(Te,Object.getOwnPropertyDescriptors(ke)):function(e){var r=Object.keys(e);if(Object.getOwnPropertySymbols){var t=Object.getOwnPropertySymbols(e);r.push.apply(r,t)}return r}(Object(ke)).forEach((function(e){Object.defineProperty(Te,e,Object.getOwnPropertyDescriptor(ke,e))})),Te));var Te,ke}));exports.TextEditor=A,exports.default=A;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "carbon-react",
-  "version": "158.38.3",
+  "version": "158.39.0",
   "description": "A library of reusable React components for easily building user interfaces.",
   "files": [
     "lib",