@globalpayments/vega 2.98.0 → 2.100.0

package/dist/esm/vega-rich-text-editor_4.entry.js

@@ -1,51 +1,52 @@
-import { h, H as Host, F as Fragment, f as forceUpdate, r as registerInstance, c as createEvent, g as getElement } from './index-090d31ca.js';
+import { h, f as forceUpdate, H as Host, F as Fragment, r as registerInstance, c as createEvent, g as getElement } from './index-090d31ca.js';
 import { c as MapToComponentField, M as MapToComponentMethod, V as VegaSlimmer, I as InjectVegaSlimmer } from './global-slimmer-registry-17c4efd4.js';
 import { V as VegaComponentUsageRuntimeMetricsSlimmer, I as InjectVegaGlobalSlimmer } from './component-usage-runtime-metrics-4b1afd04.js';
 import { s as sanitizeVegaComponent } from './component-7d906393.js';
-import { c as createEnterKeyHandlerToTriggerClick } from './accessibility-6af5cf2e.js';
+import { c as createEnterKeyHandlerToTriggerClick } from './accessibility-c899a968.js';
 import { C as ChangeManager } from './change-manager-6a7eb88c.js';
-import { d as domNodeSubjectFactory, D as DomNodeSubjectObserverFactory } from './dom-node-subject-observer-factory-ddff8662.js';
+import { d as domNodeSubjectFactory, D as DomNodeSubjectObserverFactory } from './dom-node-subject-observer-factory-bb7e68a0.js';
 import { t as VegaInternalComponentDidRender, e as VegaInternalRichTextEditorFlushChanges, d as VegaInternalRichTextEditDeleteSelectedNodes, H as VegaInternalRichTextImageClick, I as VegaInternalRichTextImageDeleteButtonClicked, z as VegaInternalCodeBlockBlur, a as VegaInternalPopoverUpdateTarget } from './vega-internal-event-id-86fce049.js';
 import { S as SHADOW_ROOT_ELEMENT_SCROLLING, F as FORM_ELEMENT_VALUE_CHANGE } from './static-subject-title-1c86e974.js';
-import { ah as VegaRTEOneRowHeightPx, R as RTETextNode, ai as BoldAnnotationAction, N as NodeAnnotationTypeEnum, aj as ItalicAnnotationAction, ak as UnderlineAnnotationAction, b as RTETextBlock, al as TextStyleAnnotationAction, _ as TextStyleAnnotation, am as BoldAnnotation, an as BlockAnnotationTypeEnum, ao as ClearFormattingAnnotationAction, ap as CodeAnnotationAction, aq as StrikethroughAnnotationAction, af as SelectionChangeAction, ad as LinkAnnotationAction, ar as IndentAnnotationAction, M as ModifyContentAction, i as ModifyContentActionType, q as RTEListItemBlock, $ as RTEHtmlBlock, as as TransformParagraphAction, r as RTECodeBlockNode, A as ActionHandleStrategyRegistry, H as HorizontalAlignmentAnnotationAction, s as stateEntityRenderingRegistry, e as AppendChildrenAction, ac as ZERO_WIDTH_SPACE, U as UpdateTextAction, g as InsertChildrenBeforeAction, S as SplitBlockWithNodeAction, f as RTENode, a as RTEBlock, k as RemoveChildrenAction, y as ReplaceChildNodesAction, at as escapeHtml, p as RTECodeBlock, I as InsertChildrenAfterAction, V as VegaRTEPresetToolbarItems, ab as VegaRTEDefaultTextStyleItems, au as RTE_EMAIL_LINK_TYPE_KEY, av as RTE_DEFAULT_LINK_TYPE_KEY, aw as RTE_SUPPORTED_LINK_TYPE_KEYS } from './code-block-9c513169.js';
-import { d as RTEDTORendererManager, V as VegaRTELinkExtension } from './link-extension-e8ee103e.js';
-import { i as isNonNullable } from './type-guard-f2624334.js';
+import { ah as ZERO_WIDTH_SPACE, am as VegaRTEOneRowHeightPx, R as RTETextNode, an as BoldAnnotationAction, N as NodeAnnotationTypeEnum, ao as ItalicAnnotationAction, ap as UnderlineAnnotationAction, b as RTETextBlock, aq as TextStyleAnnotationAction, a2 as TextStyleAnnotation, ar as BoldAnnotation, as as BlockAnnotationTypeEnum, at as ClearFormattingAnnotationAction, au as CodeAnnotationAction, av as StrikethroughAnnotationAction, ak as SelectionChangeAction, ai as LinkAnnotationAction, aw as IndentAnnotationAction, M as ModifyContentAction, j as ModifyContentActionType, r as RTEListItemBlock, a3 as RTEHtmlBlock, ax as TransformParagraphAction, t as RTECodeBlockNode, A as ActionHandleStrategyRegistry, J as HorizontalAlignmentAnnotationAction, ay as RTEUpdateSource, s as stateEntityRenderingRegistry, f as AppendChildrenAction, U as UpdateTextAction, h as InsertChildrenBeforeAction, S as SplitBlockWithNodeAction, g as RTENode, a as RTEBlock, l as RemoveChildrenAction, E as ReplaceChildNodesAction, az as escapeHtml, w as RTE_PASTE_MODE_DATA_TYPE, aA as RTE_PASTE_MODE_WORD, q as RTECodeBlock, aB as RTE_UPDATE_SOURCE_KEY, I as InsertChildrenAfterAction, x as RTE_WORD_COUNT_KEY, V as VegaRTEPresetToolbarItems, ag as VegaRTEDefaultTextStyleItems, aC as RTE_EMAIL_LINK_TYPE_KEY, aD as RTE_DEFAULT_LINK_TYPE_KEY, aE as RTE_SUPPORTED_LINK_TYPE_KEYS } from './code-block-741d6b8e.js';
+import { i as isNonNullable } from './type-guard-26d83e7e.js';
+import { R as RTEDTORendererManager, e as extensionContextManager, V as VegaRTELinkExtension } from './link-extension-e89acb5c.js';
 import { V as VegaInternalIconManager } from './internal-icon-manager-e7c57096.js';
-import { V as VisualModeToolbarButtonSlimmer, I as ImageAnnotationAction, a as ToolbarButtonSlimmer, T as TextColorToolbarButtonSlimmer, n as normalizeUrlByDefaultProtocol } from './image-annotation-action-d7f2aecc.js';
+import { V as VisualModeToolbarButtonSlimmer, I as ImageAnnotationAction, a as ToolbarButtonSlimmer, T as TextColorToolbarButtonSlimmer, n as normalizeUrlByDefaultProtocol } from './image-annotation-action-972c1074.js';
 import { V as VegaDropdownClick, d as VegaChange, a as VegaClick, a0 as VegaImageInserted, a1 as VegaSourceCodeChange, c as VegaPopoverShow, b as VegaPopoverHide } from './vega-event-id-f55f6977.js';
 import { g as generateUUID } from './misc-9fdbcfbb.js';
-import { w as waitForComponentDidRender } from './wait-for-component-did-render-ff7062aa.js';
-import { V as VegaRTEImageExtension, R as ReplaceSelectedTextAction } from './image-extension-fbd1ed6e.js';
-import { F as FormFieldControllerSlimmer } from './form-field-controller-slimmer-68fc5380.js';
-import { c as createEventEmitSlimmer } from './event-emit-slimmer-2452278f.js';
-import { c as createSubStateNotifySlimmer } from './sub-state-notify-slimmer-23b7d0e8.js';
-import { V as VegaRTEContent, d as RTEImageNode, M as MergeTwoBlocksNodesAction, I as InsertNewParagraphAction, S as StylePreservator, f as ElementToDtoStrategyProcessor, R as RTEImageBlock } from './content-state-25c81c08.js';
+import { w as waitForComponentDidRender } from './wait-for-component-did-render-9b91a826.js';
+import { V as VegaRTEImageExtension, R as ReplaceSelectedTextAction } from './image-extension-59484e9a.js';
+import { F as FormFieldControllerSlimmer } from './form-field-controller-slimmer-02165dbe.js';
+import { c as createEventEmitSlimmer } from './event-emit-slimmer-e8bb2292.js';
+import { c as createSubStateNotifySlimmer } from './sub-state-notify-slimmer-e306c849.js';
+import { V as VegaRTEContent, b as RTEImageNode, f as CommitValueAction, M as MergeTwoBlocksNodesAction, I as InsertNewParagraphAction, S as StylePreservator, g as ElementToDtoStrategyProcessor, R as RTEImageBlock } from './content-state-2f6f4204.js';
 import { b as AlignLeft, A as AlignCenter, c as AlignRight, a as AlignJustify } from './align-left-7f959adf.js';
-import { R as RTESelectionState, C as ComponentValueHistoryControllerSlimmer, a as SelectionController } from './component-value-history-controller-slimmer.abstract-9cef2a2a.js';
+import { R as RTESelectionState, C as ComponentValueHistoryControllerSlimmer, a as SelectionController } from './component-value-history-controller-slimmer.abstract-2bcd749e.js';
 import { O as Observer } from './observer-3959f9dd.js';
 import { d as debounce } from './timer-9321173b.js';
 import { D as DarkModeStateControllerSlimmer } from './dark-mode-state-controller-slimmer-778dd929.js';
-import { f as findParent } from './ui-d73f756a.js';
-import { R as RichTextEditorRequiredRule } from './rich-text-editor-required-rule-578e0958.js';
+import { f as findParent, b as getDeepActiveElementInShadow, j as checkIsVoiceOverClick, k as getFirstFocusableElement } from './ui-80e610f4.js';
+import { R as RichTextEditorRequiredRule } from './rich-text-editor-required-rule-878e91c6.js';
 import { C as ChildNodesEventPreventSlimmer } from './child-nodes-event-prevent-slimmer-82626871.js';
-import { T as TranslationSlimmer } from './translation-slimmer-ee0f0e76.js';
-import { V as VegaInternalThemeManager } from './dark-mode-style-controller-ca5afd2d.js';
+import { T as TranslationSlimmer } from './translation-slimmer-77022f2e.js';
+import { V as VegaInternalThemeManager } from './dark-mode-style-controller-352f15ff.js';
 import { A as AutoRunWhenReRenderTaskQueueSlimmer } from './auto-run-when-re-render-task-queue-slimmer.abstract-27820d4c.js';
 import { i as isArrayEqual } from './array-7888f339.js';
+import { d as deepEqual } from './object-0c277f57.js';
+import { A as AriaAttributesValueMapper } from './aria-attributes-value-mapper-a5c7478e.js';
 import { c as chevronDown } from './chevron-down-4a75d28e.js';
 import { c as chevronUp } from './chevron-up-b1989751.js';
 import { t as trashCan } from './trash-can-8819a939.js';
 import { r as remoteInvocationRegistry } from './remote-invocation-registry-d69245c2.js';
 import './string-a953eafc.js';
 import './typography-19c3b9be.js';
-import './object-0c277f57.js';
 import './breakpoints-d9faf11c.js';
 import './ui-93922c59.js';
-import './internal-translation-controller-fac22598.js';
+import './internal-translation-controller-fff376d2.js';
 import './icon-manager-4ef3f6dd.js';
 import './create-public-api-runtime-metrics-slimmer-48f85199.js';
 import './dynamic-slimmer-90b8af32.js';
-import './index-3b327f29.js';
+import './index-35451d12.js';
 import './try-get-document-bef0f526.js';
 import './page-resize-observer-slimmer-e24d36c5.js';
 import './breakpoints-332702ed.js';
@@ -53,11 +54,11 @@ import './internal-form-field-validation-rule.abstract-f5b6bdbf.js';
 import './form-field-key-44ab39d0.js';
 import './mutation-observer-slimmer-58ebc13c.js';
 import './mutation-observer-filters-1a054fb0.js';
-import './sub-state-observer-slimmer-722f6b92.js';
+import './sub-state-observer-slimmer-bd85f381.js';
 import './internal-vega-event-manager-2ecc9186.js';
-import './range-b678c693.js';
-import './keyboard-manager-slimmer-1f7c8bfb.js';
-import './keyboard-manager-50da85d7.js';
+import './range-c818a1eb.js';
+import './keyboard-manager-slimmer-133b86cd.js';
+import './keyboard-manager-a58288df.js';
 import './vega-env-manager-8f8dc473.js';
 import './feature-flag-controller-3fd04ea9.js';
 import './index-9c9865c0.js';
@@ -66,7 +67,7 @@ import './vega-nonce-manager-497e5eb5.js';
 import './synchronize-task-queue-ac8acc3b.js';
 import './number-4398f2e1.js';
 
-var __decorate$H = (undefined && undefined.__decorate) || function (decorators, target, key, desc) {
+var __decorate$I = (undefined && undefined.__decorate) || function (decorators, target, key, desc) {
   var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
   if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
   else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
@@ -87,11 +88,21 @@ class VegaRichTextEditorRenderer extends VegaSlimmer {
       const containerStyle = this.rows !== undefined
         ? { height: this.rows >= 2 ? `${this.rows * VegaRTEOneRowHeightPx}px` : defaultHeight }
         : { minHeight: defaultHeight };
-      return (h("div", { class: {
+      return (
+      // This container delegates focus to the inner <vega-rich-text-content> editor when
+      // clicking anywhere in the editing area. It is a layout wrapper, not an interactive
+      // widget, so giving it a widget role (e.g. `textbox`) would expose a second,
+      // non-editable textbox that traps VoiceOver focus and prevents typing.
+      // eslint-disable-next-line jsx-a11y/no-static-element-interactions
+      h("div", { class: {
           'rich-text-editor-container': true,
           'disabled': this.disabled,
           'vega-hidden': this.sourceView,
-        }, style: containerStyle, onClick: this.richTextContentFocus, role: "textbox", tabIndex: !this.disabled ? -1 : 0, onKeyDown: createEnterKeyHandlerToTriggerClick(), ref: (node) => (this.richTextContainerRef = node) },
+        }, style: containerStyle, onClick: this.richTextContentFocus, 
+        // Keep this wrapper out of the tab order so AT lands directly on the inner text
+        // region (focusable via contenteditable when enabled, via tabindex when disabled)
+        // rather than announcing this generic wrapper as a group.
+        tabIndex: -1, onKeyDown: createEnterKeyHandlerToTriggerClick(), ref: (node) => (this.richTextContainerRef = node) },
         h("vega-rich-text-content", { ref: (ref) => (this.richTextContentRef = ref), content: this.value, extensions: this.extensions, onScroll: this.notifyContentScrolling }),
         this.renderCharacterCounter()));
     };
@@ -105,12 +116,20 @@ class VegaRichTextEditorRenderer extends VegaSlimmer {
       });
     };
     this.renderCharacterCounter = () => {
+      if (!this.wordCountController.shouldShowUI()) {
+        return null;
+      }
+      // The word count extension is registered, so the data is guaranteed to be non-null.
+      const data = this.wordCountController.getData();
+      const isSetMaxChars = isNonNullable(data.maxChars);
       return (h("div", { class: {
           'text-editor-counter': true,
-          'counter-exceed-max-length': false,
-        }, style: { display: 'none' } },
-        h("span", null, "0"),
-        h("span", null, "/100")));
+          'counter-exceed-max-length': isSetMaxChars && data.count > data.maxChars,
+        } },
+        h("span", null, data.count),
+        isSetMaxChars && h("span", null,
+          "/",
+          data.maxChars)));
     };
     this.renderErrorMessage = () => {
       return h("div", { class: "vega-error vega-hidden" });
@@ -159,6 +178,35 @@ class VegaRichTextEditorRenderer extends VegaSlimmer {
       return this.richTextContentRef.shadowRoot.querySelector('.rich-text-content');
     }
   }
+  /**
+   * Re-injects the zero-width space placeholder into empty text spans.
+   * When a commit is rejected and the model rolls back unchanged, the framework
+   * short-circuits the text diff and leaves the span empty, collapsing the line
+   * height, so the placeholder is restored here.
+   */
+  restoreEmptyTextPlaceholders() {
+    const editableElement = this.getRTEEditableElementRef();
+    if (!editableElement) {
+      return;
+    }
+    // The text node will only be rendered as a span and a code.
+    editableElement.querySelectorAll('span:empty, code:empty').forEach((element) => {
+      const textNode = element.firstChild;
+      if (textNode && textNode.nodeType === Node.TEXT_NODE) {
+        // Reuse the existing text node, `textContent` would swap in a new one and leave the framework patching a detached node.
+        textNode.nodeValue = ZERO_WIDTH_SPACE;
+      }
+      else {
+        element.textContent = ZERO_WIDTH_SPACE;
+      }
+    });
+  }
+  /**
+   * Forces a re-render of the rich text content component, which is useful when the content has changed but the framework has not detected it.
+   */
+  forceContentRepaint() {
+    forceUpdate(this.richTextContentRef);
+  }
   render() {
     return h(Host, null, this.renderRichTextEditor());
   }
@@ -179,59 +227,62 @@ class VegaRichTextEditorRenderer extends VegaSlimmer {
       this.richTextEditorSourceViewRenderer.render()));
   }
 }
-__decorate$H([
+__decorate$I([
   MapToComponentField()
 ], VegaRichTextEditorRenderer.prototype, "host", void 0);
-__decorate$H([
+__decorate$I([
   MapToComponentField()
 ], VegaRichTextEditorRenderer.prototype, "toolbarRenderer", void 0);
-__decorate$H([
+__decorate$I([
   MapToComponentField()
 ], VegaRichTextEditorRenderer.prototype, "label", void 0);
-__decorate$H([
+__decorate$I([
   MapToComponentField()
 ], VegaRichTextEditorRenderer.prototype, "required", void 0);
-__decorate$H([
+__decorate$I([
   MapToComponentField()
 ], VegaRichTextEditorRenderer.prototype, "optional", void 0);
-__decorate$H([
+__decorate$I([
   MapToComponentField()
 ], VegaRichTextEditorRenderer.prototype, "hint", void 0);
-__decorate$H([
+__decorate$I([
   MapToComponentField()
 ], VegaRichTextEditorRenderer.prototype, "disabled", void 0);
-__decorate$H([
+__decorate$I([
   MapToComponentField()
 ], VegaRichTextEditorRenderer.prototype, "rows", void 0);
-__decorate$H([
+__decorate$I([
   MapToComponentField()
 ], VegaRichTextEditorRenderer.prototype, "placeholder", void 0);
-__decorate$H([
+__decorate$I([
   MapToComponentField()
 ], VegaRichTextEditorRenderer.prototype, "value", void 0);
-__decorate$H([
+__decorate$I([
   MapToComponentField()
 ], VegaRichTextEditorRenderer.prototype, "sourceView", void 0);
-__decorate$H([
+__decorate$I([
   MapToComponentField()
 ], VegaRichTextEditorRenderer.prototype, "toolbarItems", void 0);
-__decorate$H([
+__decorate$I([
   MapToComponentField()
 ], VegaRichTextEditorRenderer.prototype, "sourceEditConfig", void 0);
-__decorate$H([
+__decorate$I([
   MapToComponentField()
 ], VegaRichTextEditorRenderer.prototype, "allowSourceEdit", void 0);
-__decorate$H([
+__decorate$I([
   MapToComponentField()
 ], VegaRichTextEditorRenderer.prototype, "extensions", void 0);
-__decorate$H([
+__decorate$I([
+  MapToComponentField()
+], VegaRichTextEditorRenderer.prototype, "wordCountController", void 0);
+__decorate$I([
   MapToComponentField()
 ], VegaRichTextEditorRenderer.prototype, "richTextEditorSourceViewRenderer", void 0);
-__decorate$H([
+__decorate$I([
   MapToComponentMethod('componentDidRender')
 ], VegaRichTextEditorRenderer.prototype, "componentDidRender", null);
 
-var __decorate$G = (undefined && undefined.__decorate) || function (decorators, target, key, desc) {
+var __decorate$H = (undefined && undefined.__decorate) || function (decorators, target, key, desc) {
   var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
   if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
   else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
@@ -283,14 +334,17 @@ class ToolbarRenderer extends VegaSlimmer {
     const [renderedItems, totalVisibleCount] = this.renderToolbarItems();
     return (h("vega-flex", { gap: "size-8", alignItems: "center", flexWrap: "wrap" },
       this.allowSourceEdit && (h(Fragment, null,
-        h("div", { class: "toolbar-btn-group" }, this.sourceEditToolbarButtonSlimmer.render()),
+        h("div", { class: "toolbar-btn-group", role: "presentation" }, this.sourceEditToolbarButtonSlimmer.render()),
         this.uniqueToolbarItems.length > 0 &&
           totalVisibleCount > 0 &&
           this.renderVegaDivider())),
       renderedItems));
   }
   renderVegaDivider() {
-    return (h("vega-box", { height: "size-32" },
+    // Mark the divider as decorative so screen readers (e.g. VoiceOver
+    // on Firefox) skip it when navigating from the Edit Source button
+    // to the next toolbar item.
+    return (h("vega-box", { height: "size-32", "aria-hidden": "true", role: "presentation" },
       h("vega-divider", { direction: "vertical" })));
   }
   /**
@@ -329,81 +383,81 @@ class ToolbarRenderer extends VegaSlimmer {
         return null;
       })
         .filter(isNonNullable);
-      return (h("div", { class: { 'toolbar-btn-group': true, 'vega-hidden': visibleCountPerGroup < 1 } }, groupElement));
+      return (h("div", { class: { 'toolbar-btn-group': true, 'vega-hidden': visibleCountPerGroup < 1 }, role: "presentation" }, groupElement));
     });
     return [renderedItems, totalVisibleCount];
   }
 }
-__decorate$G([
+__decorate$H([
   MapToComponentField()
 ], ToolbarRenderer.prototype, "uniqueToolbarItems", void 0);
-__decorate$G([
+__decorate$H([
   MapToComponentField()
 ], ToolbarRenderer.prototype, "allowSourceEdit", void 0);
-__decorate$G([
+__decorate$H([
   MapToComponentField()
 ], ToolbarRenderer.prototype, "host", void 0);
-__decorate$G([
+__decorate$H([
   MapToComponentField()
 ], ToolbarRenderer.prototype, "clearStyleToolbarButtonSlimmer", void 0);
-__decorate$G([
+__decorate$H([
   MapToComponentField()
 ], ToolbarRenderer.prototype, "boldToolbarButtonSlimmer", void 0);
-__decorate$G([
+__decorate$H([
   MapToComponentField()
 ], ToolbarRenderer.prototype, "textStylesToolbarButtonSlimmer", void 0);
-__decorate$G([
+__decorate$H([
   MapToComponentField()
 ], ToolbarRenderer.prototype, "italicToolbarButtonSlimmer", void 0);
-__decorate$G([
+__decorate$H([
   MapToComponentField()
 ], ToolbarRenderer.prototype, "underlineToolbarButtonSlimmer", void 0);
-__decorate$G([
+__decorate$H([
   MapToComponentField()
 ], ToolbarRenderer.prototype, "textColorToolbarButtonSlimmer", void 0);
-__decorate$G([
+__decorate$H([
   MapToComponentField()
 ], ToolbarRenderer.prototype, "bulletsNumbersToolbarButtonSlimmer", void 0);
-__decorate$G([
+__decorate$H([
   MapToComponentField()
 ], ToolbarRenderer.prototype, "horizontalAlignmentToolbarButtonSlimmer", void 0);
-__decorate$G([
+__decorate$H([
   MapToComponentField()
 ], ToolbarRenderer.prototype, "strikethroughToolbarButtonSlimmer", void 0);
-__decorate$G([
+__decorate$H([
   MapToComponentField()
 ], ToolbarRenderer.prototype, "imageToolbarButtonSlimmer", void 0);
-__decorate$G([
+__decorate$H([
   MapToComponentField()
 ], ToolbarRenderer.prototype, "moreIndentToolbarButtonSlimmer", void 0);
-__decorate$G([
+__decorate$H([
   MapToComponentField()
 ], ToolbarRenderer.prototype, "lessIndentToolbarButtonSlimmer", void 0);
-__decorate$G([
+__decorate$H([
   MapToComponentField()
 ], ToolbarRenderer.prototype, "codeToolbarButtonSlimmer", void 0);
-__decorate$G([
+__decorate$H([
   MapToComponentField()
 ], ToolbarRenderer.prototype, "linkToolbarButtonSlimmer", void 0);
-__decorate$G([
+__decorate$H([
   MapToComponentField()
 ], ToolbarRenderer.prototype, "codeBlockToolbarButtonSlimmer", void 0);
-__decorate$G([
+__decorate$H([
   MapToComponentField()
 ], ToolbarRenderer.prototype, "undoToolbarButtonSlimmer", void 0);
-__decorate$G([
+__decorate$H([
   MapToComponentField()
 ], ToolbarRenderer.prototype, "redoToolbarButtonSlimmer", void 0);
-__decorate$G([
+__decorate$H([
   MapToComponentField()
 ], ToolbarRenderer.prototype, "sourceEditToolbarButtonSlimmer", void 0);
-__decorate$G([
+__decorate$H([
   MapToComponentField()
 ], ToolbarRenderer.prototype, "selectionController", void 0);
-__decorate$G([
+__decorate$H([
   MapToComponentField()
 ], ToolbarRenderer.prototype, "translationSlimmer", void 0);
-__decorate$G([
+__decorate$H([
   MapToComponentField()
 ], ToolbarRenderer.prototype, "sourceView", void 0);
 
@@ -411,7 +465,7 @@ const bold = {
   icon: `<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 384 512"><!--! Font Awesome Pro 6.3.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license (Commercial License) Copyright 2023 Fonticons, Inc. --><path fill="currentColor" d="M0 64C0 46.3 14.3 32 32 32H80 96 224c70.7 0 128 57.3 128 128c0 31.3-11.3 60.1-30 82.3c37.1 22.4 62 63.1 62 109.7c0 70.7-57.3 128-128 128H96 80 32c-17.7 0-32-14.3-32-32s14.3-32 32-32H48V256 96H32C14.3 96 0 81.7 0 64zM224 224c35.3 0 64-28.7 64-64s-28.7-64-64-64H112V224H224zM112 288V416H256c35.3 0 64-28.7 64-64s-28.7-64-64-64H224 112z"/></svg>`,
 };
 
-var __decorate$F = (undefined && undefined.__decorate) || function (decorators, target, key, desc) {
+var __decorate$G = (undefined && undefined.__decorate) || function (decorators, target, key, desc) {
   var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
   if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
   else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
@@ -453,7 +507,7 @@ class BoldToolbarButtonSlimmer extends VisualModeToolbarButtonSlimmer {
 (() => {
   VegaInternalIconManager.register({ bold });
 })();
-__decorate$F([
+__decorate$G([
   MapToComponentField()
 ], BoldToolbarButtonSlimmer.prototype, "selectionController", void 0);
 
@@ -461,7 +515,7 @@ const italic = {
   icon: `<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 384 512"><!--! Font Awesome Pro 6.3.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license (Commercial License) Copyright 2023 Fonticons, Inc. --><path fill="currentColor" d="M128 64c0-17.7 14.3-32 32-32H352c17.7 0 32 14.3 32 32s-14.3 32-32 32H293.3L160 416h64c17.7 0 32 14.3 32 32s-14.3 32-32 32H32c-17.7 0-32-14.3-32-32s14.3-32 32-32H90.7L224 96H160c-17.7 0-32-14.3-32-32z"/></svg>`,
 };
 
-var __decorate$E = (undefined && undefined.__decorate) || function (decorators, target, key, desc) {
+var __decorate$F = (undefined && undefined.__decorate) || function (decorators, target, key, desc) {
   var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
   if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
   else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
@@ -501,7 +555,7 @@ class ItalicToolbarButtonSlimmer extends VisualModeToolbarButtonSlimmer {
 (() => {
   VegaInternalIconManager.register({ italic });
 })();
-__decorate$E([
+__decorate$F([
   MapToComponentField()
 ], ItalicToolbarButtonSlimmer.prototype, "selectionController", void 0);
 
@@ -509,7 +563,7 @@ const underline = {
   icon: `<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Pro 6.3.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license (Commercial License) Copyright 2023 Fonticons, Inc. --><path fill="currentColor" d="M16 64c0-17.7 14.3-32 32-32h96c17.7 0 32 14.3 32 32s-14.3 32-32 32H128V224c0 53 43 96 96 96s96-43 96-96V96H304c-17.7 0-32-14.3-32-32s14.3-32 32-32h96c17.7 0 32 14.3 32 32s-14.3 32-32 32H384V224c0 88.4-71.6 160-160 160s-160-71.6-160-160V96H48C30.3 96 16 81.7 16 64zM0 448c0-17.7 14.3-32 32-32H416c17.7 0 32 14.3 32 32s-14.3 32-32 32H32c-17.7 0-32-14.3-32-32z"/></svg>`,
 };
 
-var __decorate$D = (undefined && undefined.__decorate) || function (decorators, target, key, desc) {
+var __decorate$E = (undefined && undefined.__decorate) || function (decorators, target, key, desc) {
   var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
   if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
   else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
@@ -552,7 +606,7 @@ class UnderlineToolbarButtonSlimmer extends VisualModeToolbarButtonSlimmer {
 (() => {
   VegaInternalIconManager.register({ underline });
 })();
-__decorate$D([
+__decorate$E([
   MapToComponentField()
 ], UnderlineToolbarButtonSlimmer.prototype, "selectionController", void 0);
 
@@ -560,7 +614,7 @@ const textSize = {
   icon: `<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 640 512"><!--! Font Awesome Pro 6.3.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license (Commercial License) Copyright 2023 Fonticons, Inc. --><path fill="currentColor" d="M64 128V96h96l0 320H128c-17.7 0-32 14.3-32 32s14.3 32 32 32H256c17.7 0 32-14.3 32-32s-14.3-32-32-32H224l0-320h96v32c0 17.7 14.3 32 32 32s32-14.3 32-32V80c0-26.5-21.5-48-48-48H192 48C21.5 32 0 53.5 0 80v48c0 17.7 14.3 32 32 32s32-14.3 32-32zM384 304V288h64l0 128H432c-17.7 0-32 14.3-32 32s14.3 32 32 32h96c17.7 0 32-14.3 32-32s-14.3-32-32-32H512l0-128h64v16c0 17.7 14.3 32 32 32s32-14.3 32-32V272c0-26.5-21.5-48-48-48H368c-26.5 0-48 21.5-48 48v32c0 17.7 14.3 32 32 32s32-14.3 32-32z"/></svg>`,
 };
 
-var __decorate$C = (undefined && undefined.__decorate) || function (decorators, target, key, desc) {
+var __decorate$D = (undefined && undefined.__decorate) || function (decorators, target, key, desc) {
   var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
   if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
   else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
@@ -597,7 +651,7 @@ class TextStylesToolbarButtonSlimmer extends VisualModeToolbarButtonSlimmer {
     };
   }
   renderBtnWrapper(renderBtn) {
-    return (h("vega-dropdown", { selectType: "single", trigger: "click", alignment: "center", isScreenPosition: true, selectedSourceKey: this.getSelectedSourceKey(), ref: (ref) => {
+    return (h("vega-dropdown", { selectType: "single", trigger: "click", alignment: "center", isScreenPosition: true, role: "presentation", selectedSourceKey: this.getSelectedSourceKey(), ref: (ref) => {
         this.addDropdownObserver(ref);
       } },
       renderBtn({ showArrowIcon: true }),
@@ -688,13 +742,13 @@ TextStylesToolbarButtonSlimmer.allItems = [
     label: 'Paragraph',
   },
 ];
-__decorate$C([
+__decorate$D([
   MapToComponentField()
 ], TextStylesToolbarButtonSlimmer.prototype, "selectionController", void 0);
-__decorate$C([
+__decorate$D([
   MapToComponentField()
 ], TextStylesToolbarButtonSlimmer.prototype, "focusController", void 0);
-__decorate$C([
+__decorate$D([
   MapToComponentField()
 ], TextStylesToolbarButtonSlimmer.prototype, "textStyleItems", void 0);
 
@@ -702,7 +756,7 @@ const TextSlash = {
   icon: `<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 640 512"><!--! Font Awesome Pro 6.3.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license (Commercial License) Copyright 2023 Fonticons, Inc. --><path fill="currentColor" d="M38.8 5.1C28.4-3.1 13.3-1.2 5.1 9.2S-1.2 34.7 9.2 42.9l592 464c10.4 8.2 25.5 6.3 33.7-4.1s6.3-25.5-4.1-33.7L355.7 253.5 400.2 96H503L497 120.2c-4.3 17.1 6.1 34.5 23.3 38.8s34.5-6.1 38.8-23.3l11-44.1C577.6 61.3 554.7 32 523.5 32H376.1h-.3H204.5c-22 0-41.2 15-46.6 36.4l-6.3 25.2L38.8 5.1zm168 131.7c.1-.3 .2-.7 .3-1L217 96H333.7L301.3 210.8l-94.5-74.1zM243.3 416H192c-17.7 0-32 14.3-32 32s14.3 32 32 32H352c17.7 0 32-14.3 32-32s-14.3-32-32-32H309.8l17.6-62.1L272.9 311 243.3 416z"/></svg>`,
 };
 
-var __decorate$B = (undefined && undefined.__decorate) || function (decorators, target, key, desc) {
+var __decorate$C = (undefined && undefined.__decorate) || function (decorators, target, key, desc) {
   var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
   if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
   else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
@@ -739,7 +793,7 @@ class ClearStyleToolbarButtonSlimmer extends VisualModeToolbarButtonSlimmer {
     'text-slash': TextSlash,
   });
 })();
-__decorate$B([
+__decorate$C([
   MapToComponentField()
 ], ClearStyleToolbarButtonSlimmer.prototype, "selectionController", void 0);
 
@@ -747,7 +801,7 @@ const codeSimple = {
   icon: `<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 576 512"><!--! Font Awesome Pro 6.3.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license (Commercial License) Copyright 2023 Fonticons, Inc. --><path fill="currentColor" d="M214.6 118.6c12.5-12.5 12.5-32.8 0-45.3s-32.8-12.5-45.3 0l-160 160c-12.5 12.5-12.5 32.8 0 45.3l160 160c12.5 12.5 32.8 12.5 45.3 0s12.5-32.8 0-45.3L77.3 256 214.6 118.6zm146.7 0L498.7 256 361.4 393.4c-12.5 12.5-12.5 32.8 0 45.3s32.8 12.5 45.3 0l160-160c12.5-12.5 12.5-32.8 0-45.3l-160-160c-12.5-12.5-32.8-12.5-45.3 0s-12.5 32.8 0 45.3z"/></svg>`,
 };
 
-var __decorate$A = (undefined && undefined.__decorate) || function (decorators, target, key, desc) {
+var __decorate$B = (undefined && undefined.__decorate) || function (decorators, target, key, desc) {
   var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
   if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
   else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
@@ -785,7 +839,7 @@ class CodeToolbarButtonSlimmer extends VisualModeToolbarButtonSlimmer {
 (() => {
   VegaInternalIconManager.register({ 'code-simple': codeSimple });
 })();
-__decorate$A([
+__decorate$B([
   MapToComponentField()
 ], CodeToolbarButtonSlimmer.prototype, "selectionController", void 0);
 
@@ -793,7 +847,7 @@ const strikethrough = {
   icon: `<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512"><!--! Font Awesome Free 6.1.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2022 Fonticons, Inc. --><path fill="currentColor" d="M332.2 319.9c17.22 12.17 22.33 26.51 18.61 48.21c-3.031 17.59-10.88 29.34-24.72 36.99c-35.44 19.75-108.5 11.96-186-19.68c-16.34-6.686-35.03 1.156-41.72 17.53s1.188 35.05 17.53 41.71c31.75 12.93 95.69 35.37 157.6 35.37c29.62 0 58.81-5.156 83.72-18.96c30.81-17.09 50.44-45.46 56.72-82.11c3.998-23.27 2.168-42.58-3.488-59.05H332.2zM488 239.9l-176.5-.0309c-15.85-5.613-31.83-10.34-46.7-14.62c-85.47-24.62-110.9-39.05-103.7-81.33c2.5-14.53 10.16-25.96 22.72-34.03c20.47-13.15 64.06-23.84 155.4 .3438c17.09 4.531 34.59-5.654 39.13-22.74c4.531-17.09-5.656-34.59-22.75-39.12c-91.31-24.18-160.7-21.62-206.3 7.654C121.8 73.72 103.6 101.1 98.09 133.1C89.26 184.5 107.9 217.3 137.2 239.9L24 239.9c-13.25 0-24 10.75-24 23.1c0 13.25 10.75 23.1 24 23.1h464c13.25 0 24-10.75 24-23.1C512 250.7 501.3 239.9 488 239.9z"/></svg>`,
 };
 
-var __decorate$z = (undefined && undefined.__decorate) || function (decorators, target, key, desc) {
+var __decorate$A = (undefined && undefined.__decorate) || function (decorators, target, key, desc) {
   var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
   if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
   else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
@@ -836,7 +890,7 @@ class StrikethroughToolbarButtonSlimmer extends VisualModeToolbarButtonSlimmer {
 (() => {
   VegaInternalIconManager.register({ strikethrough });
 })();
-__decorate$z([
+__decorate$A([
   MapToComponentField()
 ], StrikethroughToolbarButtonSlimmer.prototype, "selectionController", void 0);
 
@@ -844,12 +898,16 @@ const link = {
   icon: `<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 640 512"><!--! Font Awesome Pro 6.3.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license (Commercial License) Copyright 2023 Fonticons, Inc. --><path fill="currentColor" d="M562.8 267.7c56.5-56.5 56.5-148 0-204.5c-50-50-128.8-56.5-186.3-15.4l-1.6 1.1c-14.4 10.3-17.7 30.3-7.4 44.6s30.3 17.7 44.6 7.4l1.6-1.1c32.1-22.9 76-19.3 103.8 8.6c31.5 31.5 31.5 82.5 0 114L405.3 334.8c-31.5 31.5-82.5 31.5-114 0c-27.9-27.9-31.5-71.8-8.6-103.8l1.1-1.6c10.3-14.4 6.9-34.4-7.4-44.6s-34.4-6.9-44.6 7.4l-1.1 1.6C189.5 251.2 196 330 246 380c56.5 56.5 148 56.5 204.5 0L562.8 267.7zM43.2 244.3c-56.5 56.5-56.5 148 0 204.5c50 50 128.8 56.5 186.3 15.4l1.6-1.1c14.4-10.3 17.7-30.3 7.4-44.6s-30.3-17.7-44.6-7.4l-1.6 1.1c-32.1 22.9-76 19.3-103.8-8.6C57 372 57 321 88.5 289.5L200.7 177.2c31.5-31.5 82.5-31.5 114 0c27.9 27.9 31.5 71.8 8.6 103.9l-1.1 1.6c-10.3 14.4-6.9 34.4 7.4 44.6s34.4 6.9 44.6-7.4l1.1-1.6C416.5 260.8 410 182 360 132c-56.5-56.5-148-56.5-204.5 0L43.2 244.3z"/></svg>`,
 };
 
-var __decorate$y = (undefined && undefined.__decorate) || function (decorators, target, key, desc) {
+var __decorate$z = (undefined && undefined.__decorate) || function (decorators, target, key, desc) {
   var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
   if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
   else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
   return c > 3 && r && Object.defineProperty(target, key, r), r;
 };
+// One rAF is ~16 ms; 50 ms gives roughly two frames of buffer for the popover's
+// internal focus trap to settle (and for screen readers such as VoiceOver to
+// observe focus on <body>) before we restore focus to the trigger button.
+const FOCUS_RESTORE_DELAY_MS = 50;
 class LinkToolbarButtonSlimmer extends VisualModeToolbarButtonSlimmer {
   constructor() {
     super({
@@ -857,7 +915,21 @@ class LinkToolbarButtonSlimmer extends VisualModeToolbarButtonSlimmer {
       tooltip: {
         text: 'Link',
       },
+      ariaLabel: 'Insert Link',
     });
+    // Restoring focus to the link button on Escape: the popover lives in
+    // vega-rich-text-link-editor's shadow root and is portalled to <body>, so
+    // the popover's built-in focus trap can't put focus back on our trigger.
+    // We track an Escape press during the popover lifetime and restore focus
+    // on hide; submit / outside-click flows leave the flag false. Stale
+    // Escape presses (pressed while the popover was closed) are cleared by
+    // `handleWrapperClickCapture` on the next open.
+    this.escapePressedDuringPopover = false;
+    // Tracks whether the document-level keydown listener has been registered
+    // so it can be removed in disconnectedCallback. Without removal, document
+    // keeps a strong reference to this slimmer instance after the rich-text
+    // editor is destroyed, leaking memory.
+    this.documentKeydownRegistered = false;
     this.handleLinkEditorChange = ({ detail, }) => {
       switch (detail.action) {
         case 'link': {
@@ -882,9 +954,97 @@ class LinkToolbarButtonSlimmer extends VisualModeToolbarButtonSlimmer {
         }
       }
     };
+    this.handleWrapperClickCapture = () => {
+      // Reset the Escape flag for each new open; only an Escape during this
+      // popover's lifetime should trigger focus restoration. Activating the
+      // trigger via keyboard (Enter / Space on the inner native <button>) also
+      // dispatches a synthetic click in the capture phase, so this handler
+      // runs in both pointer and keyboard activation paths. Also clears any
+      // stale Escape press recorded while the popover was closed. The
+      // `vegaPopoverShow` listener provides the same guarantee for
+      // programmatic-open paths that don't go through a wrapper click.
+      this.escapePressedDuringPopover = false;
+    };
+    this.handlePopoverShow = () => {
+      // Belt-and-suspenders reset for programmatic opens (e.g. an external
+      // caller invoking `linkEditorRef.show()`): without this, an Escape press
+      // recorded while the popover was previously closed could survive into
+      // the new open and trigger a spurious focus restore on the next hide.
+      this.escapePressedDuringPopover = false;
+    };
+    this.handleDocumentKeydown = (event) => {
+      // We cannot guard on a local `isPopoverOpen` flag here: vega-popover's
+      // own KeyboardManager registers its capture-phase keydown listener on
+      // document before this slimmer's listener, so it runs first, calls
+      // hidePopover(), and synchronously fires `vegaPopoverHide` — which
+      // would flip our flag to closed before this handler ever observes the
+      // Escape key. Instead, always record the Escape press; stale presses
+      // (made while the popover was closed) are cleared by
+      // `handleWrapperClickCapture` on the next open.
+      // Use `event.code` for consistency with vega-modal's Escape handling
+      // (vega-modal-open-state-controller.ts).
+      if (event.code === 'Escape') {
+        this.escapePressedDuringPopover = true;
+      }
+    };
+    this.handlePopoverHide = () => {
+      // vegaPopoverHide fires synchronously from the popover's own Escape
+      // handler — before our document-capture keydown observes the key, and
+      // before the popover's internal focus trap settles focus on <body>.
+      // Defer the decision/restore past that internal restore.
+      // eslint-disable-next-line no-restricted-globals
+      setTimeout(() => {
+        var _a, _b, _c, _d;
+        const shouldRestore = this.escapePressedDuringPopover;
+        this.escapePressedDuringPopover = false;
+        if (shouldRestore) {
+          // The toolbar button uses shadow DOM without delegatesFocus,
+          // so focusing the host is a no-op — focus the inner <button>.
+          // The toolbar button may have been removed from the DOM during
+          // the timeout window (e.g. editor destroyed), so guard each step.
+          /* istanbul ignore next */
+          (_d = (_c = (_b = (_a = this.linkBtnWrapperRef) === null || _a === void 0 ? void 0 : _a.querySelector('vega-rich-text-editor-toolbar-button')) === null || _b === void 0 ? void 0 : _b.shadowRoot) === null || _c === void 0 ? void 0 : _c.querySelector('button')) === null || _d === void 0 ? void 0 : _d.focus();
+        }
+      }, FOCUS_RESTORE_DELAY_MS);
+    };
+  }
+  /**
+   * Component lifecycle - [disconnectedCallback]
+   *
+   * Removes the document-level Escape listener registered in the wrapper
+   * ref callback so the slimmer instance is not retained by document after
+   * the rich-text editor is destroyed.
+   */
+  disconnectedCallback() {
+    if (this.documentKeydownRegistered) {
+      // eslint-disable-next-line no-restricted-globals
+      document.removeEventListener('keydown', this.handleDocumentKeydown, { capture: true });
+      this.documentKeydownRegistered = false;
+    }
+    this.linkBtnWrapperRef = undefined;
   }
   renderBtnWrapper(renderBtn) {
-    return (h("div", { class: "toolbar-btn-link-wrapper", ref: (ref) => (this.linkBtnWrapperRef = ref) },
+    return (h("div", { class: "toolbar-btn-link-wrapper", role: "presentation", ref: (ref) => {
+        if (ref && ref !== this.linkBtnWrapperRef) {
+          this.linkBtnWrapperRef = ref;
+          ref.addEventListener('click', this.handleWrapperClickCapture, { capture: true });
+          // `vegaPopoverShow` clears any stale Escape recorded while the
+          // popover was closed, covering programmatic-open paths
+          // (e.g. linkEditorRef.show()) where no wrapper click fires.
+          ref.addEventListener('vegaPopoverShow', this.handlePopoverShow);
+          ref.addEventListener('vegaPopoverHide', this.handlePopoverHide);
+          // Esc inside the portalled popover doesn't bubble to the wrapper,
+          // so observe it on document capture. Tracked so it can be removed
+          // in disconnectedCallback to avoid leaking this slimmer instance.
+          if (!this.documentKeydownRegistered) {
+            // eslint-disable-next-line no-restricted-globals
+            document.addEventListener('keydown', this.handleDocumentKeydown, {
+              capture: true,
+            });
+            this.documentKeydownRegistered = true;
+          }
+        }
+      } },
       renderBtn(),
       h("vega-rich-text-link-editor", { resetStatusAfterHide: false, status: "linkEdit", ref: (ref) => {
           if (ref) {
@@ -933,15 +1093,18 @@ class LinkToolbarButtonSlimmer extends VisualModeToolbarButtonSlimmer {
 (() => {
   VegaInternalIconManager.register({ link: link });
 })();
-__decorate$y([
+__decorate$z([
   MapToComponentField()
 ], LinkToolbarButtonSlimmer.prototype, "selectionController", void 0);
+__decorate$z([
+  MapToComponentMethod('disconnectedCallback')
+], LinkToolbarButtonSlimmer.prototype, "disconnectedCallback", null);
 
 const indent = {
   icon: `<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Pro 6.3.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license (Commercial License) Copyright 2023 Fonticons, Inc. --><path fill="currentColor" d="M0 64C0 46.3 14.3 32 32 32H416c17.7 0 32 14.3 32 32s-14.3 32-32 32H32C14.3 96 0 81.7 0 64zM192 192c0-17.7 14.3-32 32-32H416c17.7 0 32 14.3 32 32s-14.3 32-32 32H224c-17.7 0-32-14.3-32-32zm32 96H416c17.7 0 32 14.3 32 32s-14.3 32-32 32H224c-17.7 0-32-14.3-32-32s14.3-32 32-32zM0 448c0-17.7 14.3-32 32-32H416c17.7 0 32 14.3 32 32s-14.3 32-32 32H32c-17.7 0-32-14.3-32-32zM127.8 268.6L25.8 347.9C15.3 356.1 0 348.6 0 335.3V176.7c0-13.3 15.3-20.8 25.8-12.6l101.9 79.3c8.2 6.4 8.2 18.9 0 25.3z"/></svg>`,
 };
 
-var __decorate$x = (undefined && undefined.__decorate) || function (decorators, target, key, desc) {
+var __decorate$y = (undefined && undefined.__decorate) || function (decorators, target, key, desc) {
   var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
   if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
   else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
@@ -975,7 +1138,7 @@ class MoreIndentToolbarButtonSlimmer extends VisualModeToolbarButtonSlimmer {
 (() => {
   VegaInternalIconManager.register({ indent: indent });
 })();
-__decorate$x([
+__decorate$y([
   MapToComponentField()
 ], MoreIndentToolbarButtonSlimmer.prototype, "selectionController", void 0);
 
@@ -983,7 +1146,7 @@ const outdent = {
   icon: `<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512"><!--! Font Awesome Pro 6.3.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license (Commercial License) Copyright 2023 Fonticons, Inc. --><path fill="currentColor" d="M6 64C6 46.3 20.3 32 38 32H422c17.7 0 32 14.3 32 32s-14.3 32-32 32H38C20.3 96 6 81.7 6 64zM198 192c0-17.7 14.3-32 32-32H422c17.7 0 32 14.3 32 32s-14.3 32-32 32H230c-17.7 0-32-14.3-32-32zm32 96H422c17.7 0 32 14.3 32 32s-14.3 32-32 32H230c-17.7 0-32-14.3-32-32s14.3-32 32-32zM6 448c0-17.7 14.3-32 32-32H422c17.7 0 32 14.3 32 32s-14.3 32-32 32H38c-17.7 0-32-14.3-32-32zm.2-179.4c-8.2-6.4-8.2-18.9 0-25.3l101.9-79.3c10.5-8.2 25.8-.7 25.8 12.6V335.3c0 13.3-15.3 20.8-25.8 12.6L6.2 268.6z"/></svg>`,
 };
 
-var __decorate$w = (undefined && undefined.__decorate) || function (decorators, target, key, desc) {
+var __decorate$x = (undefined && undefined.__decorate) || function (decorators, target, key, desc) {
   var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
   if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
   else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
@@ -1018,7 +1181,7 @@ class LessIndentToolbarButtonSlimmer extends VisualModeToolbarButtonSlimmer {
 (() => {
   VegaInternalIconManager.register({ outdent: outdent });
 })();
-__decorate$w([
+__decorate$x([
   MapToComponentField()
 ], LessIndentToolbarButtonSlimmer.prototype, "selectionController", void 0);
 
@@ -1039,7 +1202,7 @@ class ImageUpdateUrlAction extends ModifyContentAction {
   }
 }
 
-var __decorate$v = (undefined && undefined.__decorate) || function (decorators, target, key, desc) {
+var __decorate$w = (undefined && undefined.__decorate) || function (decorators, target, key, desc) {
   var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
   if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
   else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
@@ -1051,6 +1214,7 @@ class ImageToolbarButtonSlimmer extends VisualModeToolbarButtonSlimmer {
       icon: 'image',
       tooltip: { text: 'Image' },
       autoFocusOnClick: false,
+      ariaLabel: 'Insert Image',
     });
     this.insertURLImage = async () => {
       const url = this.normalizeSafeImageUrl(this.insertURLInputRef.value);
@@ -1105,8 +1269,8 @@ class ImageToolbarButtonSlimmer extends VisualModeToolbarButtonSlimmer {
     if (!shouldRenderUpload && !shouldRenderUrlInsertion) {
       return null;
     }
-    return (h("vega-box", null,
-      shouldRenderDropdown ? (h("vega-dropdown", { selectType: "none", trigger: "click", alignment: "center", isScreenPosition: true, ref: (ref) => {
+    return (h("vega-box", { role: "presentation" },
+      shouldRenderDropdown ? (h("vega-dropdown", { selectType: "none", trigger: "click", alignment: "center", isScreenPosition: true, role: "presentation", ref: (ref) => {
           this.dropdownRef = ref;
           this.addDropdownObserver(ref);
         } },
@@ -1238,16 +1402,16 @@ ImageToolbarButtonSlimmer.allItems = [
     label: 'Insert via URL',
   },
 ];
-__decorate$v([
+__decorate$w([
   MapToComponentField()
 ], ImageToolbarButtonSlimmer.prototype, "host", void 0);
-__decorate$v([
+__decorate$w([
   MapToComponentField()
 ], ImageToolbarButtonSlimmer.prototype, "insertImageController", void 0);
-__decorate$v([
+__decorate$w([
   MapToComponentField()
 ], ImageToolbarButtonSlimmer.prototype, "imageInsertedEventEmitter", void 0);
-__decorate$v([
+__decorate$w([
   MapToComponentField()
 ], ImageToolbarButtonSlimmer.prototype, "selectionController", void 0);
 
@@ -1557,7 +1721,7 @@ class ListShiftTabOutdentHandler extends AbstractListKeyboardHandler {
   }
 }
 
-var __decorate$u = (undefined && undefined.__decorate) || function (decorators, target, key, desc) {
+var __decorate$v = (undefined && undefined.__decorate) || function (decorators, target, key, desc) {
   var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
   if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
   else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
@@ -1709,28 +1873,28 @@ class ListKeyboardSlimmer extends VegaSlimmer {
     this.selectionController.enqueueSelectionRangeFutureState(firstNode, Math.min(startOffset, firstNode.getRangeEndOffset()), lastNode, Math.min(endOffset, lastNode.getRangeEndOffset()), true);
   }
 }
-__decorate$u([
+__decorate$v([
   MapToComponentField()
 ], ListKeyboardSlimmer.prototype, "selectionController", void 0);
-__decorate$u([
+__decorate$v([
   MapToComponentField()
 ], ListKeyboardSlimmer.prototype, "valueController", void 0);
-__decorate$u([
+__decorate$v([
   MapToComponentField()
 ], ListKeyboardSlimmer.prototype, "value", void 0);
-__decorate$u([
+__decorate$v([
   MapToComponentField()
 ], ListKeyboardSlimmer.prototype, "toolbarItems", void 0);
-__decorate$u([
+__decorate$v([
   MapToComponentField()
 ], ListKeyboardSlimmer.prototype, "vegaRichTextEditorRenderer", void 0);
-__decorate$u([
+__decorate$v([
   MapToComponentMethod('disconnectedCallback')
 ], ListKeyboardSlimmer.prototype, "disconnectedCallback", null);
-__decorate$u([
+__decorate$v([
   MapToComponentMethod('componentDidLoad')
 ], ListKeyboardSlimmer.prototype, "componentDidLoad", null);
-__decorate$u([
+__decorate$v([
   MapToComponentMethod('watchToolbarItems')
 ], ListKeyboardSlimmer.prototype, "watchToolbarItems", null);
 
@@ -1747,7 +1911,7 @@ class TransformListAction extends ModifyContentAction {
   }
 }
 
-var __decorate$t = (undefined && undefined.__decorate) || function (decorators, target, key, desc) {
+var __decorate$u = (undefined && undefined.__decorate) || function (decorators, target, key, desc) {
   var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
   if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
   else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
@@ -1806,14 +1970,14 @@ class BulletsToolbarButtonSlimmer extends VisualModeToolbarButtonSlimmer {
     }
   }
 }
-__decorate$t([
+__decorate$u([
   MapToComponentField()
 ], BulletsToolbarButtonSlimmer.prototype, "selectionController", void 0);
-__decorate$t([
+__decorate$u([
   MapToComponentField()
 ], BulletsToolbarButtonSlimmer.prototype, "popoverRef", void 0);
 
-var __decorate$s = (undefined && undefined.__decorate) || function (decorators, target, key, desc) {
+var __decorate$t = (undefined && undefined.__decorate) || function (decorators, target, key, desc) {
   var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
   if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
   else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
@@ -1870,14 +2034,14 @@ class NumbersToolbarButtonSlimmer extends VisualModeToolbarButtonSlimmer {
     }
   }
 }
-__decorate$s([
+__decorate$t([
   MapToComponentField()
 ], NumbersToolbarButtonSlimmer.prototype, "selectionController", void 0);
-__decorate$s([
+__decorate$t([
   MapToComponentField()
 ], NumbersToolbarButtonSlimmer.prototype, "popoverRef", void 0);
 
-var __decorate$r = (undefined && undefined.__decorate) || function (decorators, target, key, desc) {
+var __decorate$s = (undefined && undefined.__decorate) || function (decorators, target, key, desc) {
   var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
   if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
   else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
@@ -1890,6 +2054,7 @@ class BulletsNumbersToolbarButtonSlimmer extends VisualModeToolbarButtonSlimmer
       tooltip: {
         text: 'Bullets',
       },
+      ariaLabel: 'Bullets and Numbers',
     });
     this.bulletsToolbarButtonSlimmer = new BulletsToolbarButtonSlimmer();
     this.numbersToolbarButtonSlimmer = new NumbersToolbarButtonSlimmer();
@@ -1908,7 +2073,7 @@ class BulletsNumbersToolbarButtonSlimmer extends VisualModeToolbarButtonSlimmer
     }
   }
   renderBtnWrapper(renderBtn) {
-    return (h("vega-popover", { showArrow: false, trigger: "click", placement: "bottom", alignment: "center", isScreenPosition: true, ref: (ref) => (this.popoverRef = ref) },
+    return (h("vega-popover", { showArrow: false, trigger: "click", placement: "bottom", alignment: "center", isScreenPosition: true, role: "presentation", ref: (ref) => (this.popoverRef = ref) },
       h("div", { slot: "popover-content" }, renderBtn({ showArrowIcon: true })),
       h("div", { slot: "popover" }, this.renderContent())));
   }
@@ -1957,41 +2122,41 @@ class BulletsNumbersToolbarButtonSlimmer extends VisualModeToolbarButtonSlimmer
     'list-ol': ListOL,
   });
 })();
-__decorate$r([
+__decorate$s([
   MapToComponentField()
 ], BulletsNumbersToolbarButtonSlimmer.prototype, "selectionController", void 0);
-__decorate$r([
+__decorate$s([
   MapToComponentField()
 ], BulletsNumbersToolbarButtonSlimmer.prototype, "valueController", void 0);
-__decorate$r([
+__decorate$s([
   MapToComponentField()
 ], BulletsNumbersToolbarButtonSlimmer.prototype, "value", void 0);
-__decorate$r([
+__decorate$s([
   MapToComponentField()
 ], BulletsNumbersToolbarButtonSlimmer.prototype, "toolbarItems", void 0);
-__decorate$r([
+__decorate$s([
   MapToComponentField()
 ], BulletsNumbersToolbarButtonSlimmer.prototype, "vegaRichTextEditorRenderer", void 0);
-__decorate$r([
+__decorate$s([
   InjectVegaSlimmer()
 ], BulletsNumbersToolbarButtonSlimmer.prototype, "bulletsToolbarButtonSlimmer", void 0);
-__decorate$r([
+__decorate$s([
   InjectVegaSlimmer()
 ], BulletsNumbersToolbarButtonSlimmer.prototype, "numbersToolbarButtonSlimmer", void 0);
-__decorate$r([
+__decorate$s([
   InjectVegaSlimmer()
 ], BulletsNumbersToolbarButtonSlimmer.prototype, "listKeyboardSlimmer", void 0);
-__decorate$r([
+__decorate$s([
   MapToComponentMethod('disconnectedCallback')
 ], BulletsNumbersToolbarButtonSlimmer.prototype, "disconnectedCallback", null);
-__decorate$r([
+__decorate$s([
   MapToComponentMethod('componentDidLoad')
 ], BulletsNumbersToolbarButtonSlimmer.prototype, "componentDidLoad", null);
-__decorate$r([
+__decorate$s([
   MapToComponentMethod('componentWillRender')
 ], BulletsNumbersToolbarButtonSlimmer.prototype, "componentWillRender", null);
 
-var __decorate$q = (undefined && undefined.__decorate) || function (decorators, target, key, desc) {
+var __decorate$r = (undefined && undefined.__decorate) || function (decorators, target, key, desc) {
   var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
   if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
   else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
@@ -2026,14 +2191,14 @@ class LeftAlignToolbarButtonSlimmer extends VisualModeToolbarButtonSlimmer {
     'align-left': AlignLeft,
   });
 })();
-__decorate$q([
+__decorate$r([
   MapToComponentField()
 ], LeftAlignToolbarButtonSlimmer.prototype, "selectionController", void 0);
-__decorate$q([
+__decorate$r([
   MapToComponentField()
 ], LeftAlignToolbarButtonSlimmer.prototype, "popoverRef", void 0);
 
-var __decorate$p = (undefined && undefined.__decorate) || function (decorators, target, key, desc) {
+var __decorate$q = (undefined && undefined.__decorate) || function (decorators, target, key, desc) {
   var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
   if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
   else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
@@ -2068,14 +2233,14 @@ class CenterAlignToolbarButtonSlimmer extends VisualModeToolbarButtonSlimmer {
     'align-center': AlignCenter,
   });
 })();
-__decorate$p([
+__decorate$q([
   MapToComponentField()
 ], CenterAlignToolbarButtonSlimmer.prototype, "selectionController", void 0);
-__decorate$p([
+__decorate$q([
   MapToComponentField()
 ], CenterAlignToolbarButtonSlimmer.prototype, "popoverRef", void 0);
 
-var __decorate$o = (undefined && undefined.__decorate) || function (decorators, target, key, desc) {
+var __decorate$p = (undefined && undefined.__decorate) || function (decorators, target, key, desc) {
   var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
   if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
   else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
@@ -2110,14 +2275,14 @@ class RightAlignToolbarButtonSlimmer extends VisualModeToolbarButtonSlimmer {
     'align-right': AlignRight,
   });
 })();
-__decorate$o([
+__decorate$p([
   MapToComponentField()
 ], RightAlignToolbarButtonSlimmer.prototype, "selectionController", void 0);
-__decorate$o([
+__decorate$p([
   MapToComponentField()
 ], RightAlignToolbarButtonSlimmer.prototype, "popoverRef", void 0);
 
-var __decorate$n = (undefined && undefined.__decorate) || function (decorators, target, key, desc) {
+var __decorate$o = (undefined && undefined.__decorate) || function (decorators, target, key, desc) {
   var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
   if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
   else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
@@ -2152,14 +2317,14 @@ class JustifyAlignToolbarButtonSlimmer extends VisualModeToolbarButtonSlimmer {
     'align-justify': AlignJustify,
   });
 })();
-__decorate$n([
+__decorate$o([
   MapToComponentField()
 ], JustifyAlignToolbarButtonSlimmer.prototype, "selectionController", void 0);
-__decorate$n([
+__decorate$o([
   MapToComponentField()
 ], JustifyAlignToolbarButtonSlimmer.prototype, "popoverRef", void 0);
 
-var __decorate$m = (undefined && undefined.__decorate) || function (decorators, target, key, desc) {
+var __decorate$n = (undefined && undefined.__decorate) || function (decorators, target, key, desc) {
   var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
   if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
   else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
@@ -2172,6 +2337,7 @@ class HorizontalAlignmentToolbarButtonSlimmer extends VisualModeToolbarButtonSli
       tooltip: {
         text: 'Left Align',
       },
+      ariaLabel: 'Horizontal Alignment',
     });
     this.leftAlignToolbarButtonSlimmer = new LeftAlignToolbarButtonSlimmer();
     this.centerAlignToolbarButtonSlimmer = new CenterAlignToolbarButtonSlimmer();
@@ -2196,7 +2362,7 @@ class HorizontalAlignmentToolbarButtonSlimmer extends VisualModeToolbarButtonSli
     }
   }
   renderBtnWrapper(renderBtn) {
-    return (h("vega-popover", { trigger: "click", showArrow: false, alignment: "center", placement: "bottom", isScreenPosition: true, ref: (ref) => (this.popoverRef = ref) },
+    return (h("vega-popover", { trigger: "click", showArrow: false, alignment: "center", placement: "bottom", isScreenPosition: true, role: "presentation", ref: (ref) => (this.popoverRef = ref) },
       h("div", { slot: "popover-content" }, renderBtn({ showArrowIcon: true })),
       h("div", { slot: "popover" }, this.renderContent())));
   }
@@ -2217,22 +2383,22 @@ class HorizontalAlignmentToolbarButtonSlimmer extends VisualModeToolbarButtonSli
         .some((block) => this.shouldDisabledToolbar(block, HorizontalAlignmentAnnotationAction.name)));
   }
 }
-__decorate$m([
+__decorate$n([
   MapToComponentField()
 ], HorizontalAlignmentToolbarButtonSlimmer.prototype, "selectionController", void 0);
-__decorate$m([
+__decorate$n([
   InjectVegaSlimmer()
 ], HorizontalAlignmentToolbarButtonSlimmer.prototype, "leftAlignToolbarButtonSlimmer", void 0);
-__decorate$m([
+__decorate$n([
   InjectVegaSlimmer()
 ], HorizontalAlignmentToolbarButtonSlimmer.prototype, "centerAlignToolbarButtonSlimmer", void 0);
-__decorate$m([
+__decorate$n([
   InjectVegaSlimmer()
 ], HorizontalAlignmentToolbarButtonSlimmer.prototype, "rightAlignToolbarButtonSlimmer", void 0);
-__decorate$m([
+__decorate$n([
   InjectVegaSlimmer()
 ], HorizontalAlignmentToolbarButtonSlimmer.prototype, "justifiedToolbarButtonSlimmer", void 0);
-__decorate$m([
+__decorate$n([
   MapToComponentMethod('componentWillRender')
 ], HorizontalAlignmentToolbarButtonSlimmer.prototype, "componentWillRender", null);
 
@@ -2273,7 +2439,7 @@ class RTEEditorState {
   }
 }
 
-var __decorate$l = (undefined && undefined.__decorate) || function (decorators, target, key, desc) {
+var __decorate$m = (undefined && undefined.__decorate) || function (decorators, target, key, desc) {
   var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
   if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
   else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
@@ -2283,6 +2449,11 @@ var __decorate$l = (undefined && undefined.__decorate) || function (decorators,
  * The value controller is responsible for updating the value of the rich text editor.
  */
 class ValueController extends VegaSlimmer {
+  constructor() {
+    super(...arguments);
+    // Deep clone of the last committed value, kept only while a commit validator is active, used to roll back rejected changes.
+    this.committedSnapshot = null;
+  }
   /**
    * Component lifecycle - [connectedCallback]{@link VegaRichTextEditor.connectedCallback}
    */
@@ -2327,15 +2498,47 @@ class ValueController extends VegaSlimmer {
       });
     }
     this.registerEditorRefAndContent();
+    this.seedCommittedSnapshot();
+  }
+  /**
+   * Seeds the rollback snapshot from the current value while a commit interceptor is active.
+   * Runs on load and on extension changes so runtime re-registration stays protected.
+   */
+  seedCommittedSnapshot() {
+    if (this.wordCountController.hasWordCountHardLimit()) {
+      this.committedSnapshot = this.value ? this.value.clone(true) : null;
+    }
   }
   /**
    * Updates the value of the editor and restore the selection.
    *
    * @param {VegaRTEContent} newValue The new value to set.
    * @param {boolean} recordHistory - Whether to record the change in history.
-   */
-  async flushChanges(newValue, recordHistory = true) {
-    this.value = newValue.clone();
+   * @param {RTEUpdateSource} updateSource - The source of the update, defaulting to 'default'.
+   */
+  async flushChanges(newValue, recordHistory = true, updateSource = RTEUpdateSource.Default) {
+    const previous = this.committedSnapshot;
+    const action = new CommitValueAction(newValue, previous, this.host);
+    const committed = ActionHandleStrategyRegistry.executeTheStrategy(action, newValue);
+    if (!committed) {
+      if (updateSource === RTEUpdateSource.Composition) {
+        // The composition input characters cannot be deleted, so we force a repaint to restore the content from the model.
+        this.vegaRichTextEditorRenderer.forceContentRepaint();
+      }
+      else {
+        // The commit was vetoed, so restore the placeholder the framework skipped repainting and roll back.
+        this.vegaRichTextEditorRenderer.restoreEmptyTextPlaceholders();
+      }
+      // Deep clone so the rolled-back value never shares nodes with the snapshot, which in-place edits would otherwise corrupt.
+      this.value = (previous !== null && previous !== void 0 ? previous : newValue).clone(true);
+      if (previous) {
+        // Seed the snapshot again so the next commit attempt has a valid rollback point.
+        this.seedCommittedSnapshot();
+      }
+      await waitForComponentDidRender(this.host);
+      return;
+    }
+    this.value = committed.clone();
     if (recordHistory) {
       this.historyController.registerHistory(new RTEEditorState(this.value, new RTESelectionState(this.selectionController.getCurrentRange())));
     }
@@ -2359,39 +2562,49 @@ class ValueController extends VegaSlimmer {
   }
 }
 ValueController.VALUE_CHANGE_DEBOUNCE_TIME = 50;
-__decorate$l([
+__decorate$m([
   MapToComponentField()
 ], ValueController.prototype, "host", void 0);
-__decorate$l([
+__decorate$m([
   MapToComponentField({ writable: true })
 ], ValueController.prototype, "value", void 0);
-__decorate$l([
+__decorate$m([
   MapToComponentField()
 ], ValueController.prototype, "changeEventEmitter", void 0);
-__decorate$l([
+__decorate$m([
   MapToComponentField()
 ], ValueController.prototype, "valueController", void 0);
-__decorate$l([
+__decorate$m([
   MapToComponentField()
 ], ValueController.prototype, "historyController", void 0);
-__decorate$l([
+__decorate$m([
   MapToComponentField()
 ], ValueController.prototype, "selectionController", void 0);
-__decorate$l([
+__decorate$m([
+  MapToComponentField()
+], ValueController.prototype, "wordCountController", void 0);
+__decorate$m([
+  MapToComponentField()
+], ValueController.prototype, "vegaRichTextEditorRenderer", void 0);
+__decorate$m([
   MapToComponentField()
 ], ValueController.prototype, "sourceEditConfig", void 0);
-__decorate$l([
+__decorate$m([
   MapToComponentMethod('connectedCallback')
 ], ValueController.prototype, "connectedCallback", null);
-__decorate$l([
+__decorate$m([
   MapToComponentMethod('disconnectedCallback')
 ], ValueController.prototype, "disconnectedCallback", null);
-__decorate$l([
+__decorate$m([
   MapToComponentMethod('componentWillLoad')
 ], ValueController.prototype, "componentWillLoad", null);
-__decorate$l([
+__decorate$m([
   MapToComponentMethod('watchValueUpdate')
 ], ValueController.prototype, "watchValueUpdate", null);
+__decorate$m([
+  MapToComponentMethod('componentDidLoad'),
+  MapToComponentMethod('watchExtensions')
+], ValueController.prototype, "seedCommittedSnapshot", null);
 
 /**
  * The rich text content controller
@@ -3223,8 +3436,11 @@ class InsertPasteHandler extends BaseHandler {
     const body = parsedDoc.body;
     // Extract plain text from the parsed document
     const plainText = (body.textContent || '').replace(/\r\n?/g, '\n');
-    // Check for rich inline formatting
-    let hasFormatting = Boolean(body.querySelector('b,strong,i,em,s,del,strike,u,mark'));
+    // Check for rich inline formatting. Code blocks (`pre` carrying
+    // `data-language`, the marker the code-block strategy recognizes) count as
+    // formatting so they are never flattened to inline plain text, which would
+    // drop the code block on single-line pastes whose text equals the HTML text.
+    let hasFormatting = Boolean(body.querySelector('b,strong,i,em,s,del,strike,u,mark,code,pre[data-language]'));
     if (!hasFormatting) {
       hasFormatting = Array.from(body.querySelectorAll('span')).some((span) => {
         const style = span.getAttribute('style') || span.getAttribute('data-style') || '';
@@ -3315,9 +3531,18 @@ class InsertPasteHandler extends BaseHandler {
     context.restore(rootElements);
     this.normalizeImportedHtmlArtifacts(parsedDoc.body);
     const htmlElements = Array.from(parsedDoc.body.childNodes);
-    const resultBlocks = ElementToDtoStrategyProcessor.process(htmlElements)
+    // Word paste enables custom-annotation processing (skipCustomAnnotations: false)
+    // so that inline styles produced by WordPasteStrategy (colors, font-weight, etc.)
+    // are mapped to RTE annotations. Regular rich paste skips them (undefined → default).
+    const transformOptions = payload.type === RTE_PASTE_MODE_WORD
+      ? {
+        autoMatchFormat: true,
+        skipCustomAnnotations: false,
+      }
+      : undefined;
+    const resultBlocks = ElementToDtoStrategyProcessor.process(htmlElements, transformOptions)
       .filter(Boolean)
-      .map((output) => output.toDto())
+      .map((output) => output.toDto(transformOptions))
       .filter(Boolean);
     // Fallback for synthetic payloads: if strategy conversion yields no blocks
     // but we still have plain text, create paragraph/text blocks directly.
@@ -3586,6 +3811,7 @@ class InsertPasteHandler extends BaseHandler {
     return {
       html: event.dataTransfer.getData('text/html') || eventPayload.html || '',
       text: event.dataTransfer.getData('text/plain') || eventPayload.text || '',
+      type: event.dataTransfer.getData(RTE_PASTE_MODE_DATA_TYPE) || '',
     };
   }
 }
@@ -3883,7 +4109,7 @@ class KeyboardLinkHandler extends BaseHandler {
   }
 }
 
-var __decorate$k = (undefined && undefined.__decorate) || function (decorators, target, key, desc) {
+var __decorate$l = (undefined && undefined.__decorate) || function (decorators, target, key, desc) {
   var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
   if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
   else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
@@ -3924,6 +4150,7 @@ class UserInputController extends VegaSlimmer {
       }
       this.insertCompositionTextController.removeObserver();
       let updateFlag = false;
+      let updateSource = RTEUpdateSource.Default;
       switch (inputType) {
         case 'insertParagraph':
           updateFlag = true;
@@ -3931,6 +4158,10 @@ class UserInputController extends VegaSlimmer {
           break;
         case 'insertText':
           updateFlag = true;
+          updateSource =
+            e[RTE_UPDATE_SOURCE_KEY] === RTEUpdateSource.Composition
+              ? RTEUpdateSource.Composition
+              : RTEUpdateSource.Default;
           this.insertTextHandler.execute(this.value, this.selectionController, this.host, e);
           break;
         case 'insertLineBreak':
@@ -3951,7 +4182,7 @@ class UserInputController extends VegaSlimmer {
           break;
       }
       if (updateFlag) {
-        void this.valueController.flushChanges(this.value);
+        void this.valueController.flushChanges(this.value, true, updateSource);
       }
     };
   }
@@ -4027,28 +4258,28 @@ class UserInputController extends VegaSlimmer {
     return false;
   }
 }
-__decorate$k([
+__decorate$l([
   MapToComponentField()
 ], UserInputController.prototype, "host", void 0);
-__decorate$k([
+__decorate$l([
   MapToComponentField()
 ], UserInputController.prototype, "value", void 0);
-__decorate$k([
+__decorate$l([
   MapToComponentField()
 ], UserInputController.prototype, "valueController", void 0);
-__decorate$k([
+__decorate$l([
   MapToComponentField()
 ], UserInputController.prototype, "vegaRichTextEditorRenderer", void 0);
-__decorate$k([
+__decorate$l([
   MapToComponentField()
 ], UserInputController.prototype, "selectionController", void 0);
-__decorate$k([
+__decorate$l([
   MapToComponentField()
 ], UserInputController.prototype, "insertCompositionTextController", void 0);
-__decorate$k([
+__decorate$l([
   MapToComponentMethod('componentDidLoad')
 ], UserInputController.prototype, "addActionListener", null);
-__decorate$k([
+__decorate$l([
   MapToComponentMethod('disconnectedCallback')
 ], UserInputController.prototype, "removeActionListener", null);
 
@@ -4068,7 +4299,7 @@ class InsertImageToBlockAction extends ModifyContentAction {
   }
 }
 
-var __decorate$j = (undefined && undefined.__decorate) || function (decorators, target, key, desc) {
+var __decorate$k = (undefined && undefined.__decorate) || function (decorators, target, key, desc) {
   var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
   if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
   else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
@@ -4160,26 +4391,26 @@ class InsertImageController extends VegaSlimmer {
     }
   }
 }
-__decorate$j([
+__decorate$k([
   MapToComponentField()
 ], InsertImageController.prototype, "selectionController", void 0);
-__decorate$j([
+__decorate$k([
   MapToComponentField()
 ], InsertImageController.prototype, "value", void 0);
-__decorate$j([
+__decorate$k([
   MapToComponentField()
 ], InsertImageController.prototype, "valueController", void 0);
-__decorate$j([
+__decorate$k([
   MapToComponentField()
 ], InsertImageController.prototype, "vegaRichTextEditorRenderer", void 0);
-__decorate$j([
+__decorate$k([
   MapToComponentMethod('componentDidLoad')
 ], InsertImageController.prototype, "registerObserver", null);
-__decorate$j([
+__decorate$k([
   MapToComponentMethod('disconnectedCallback')
 ], InsertImageController.prototype, "unRegisterObserver", null);
 
-var __decorate$i = (undefined && undefined.__decorate) || function (decorators, target, key, desc) {
+var __decorate$j = (undefined && undefined.__decorate) || function (decorators, target, key, desc) {
   var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
   if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
   else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
@@ -4245,20 +4476,20 @@ class FocusController extends VegaSlimmer {
     this.selectionController.setSelectionRange(range);
   }
 }
-__decorate$i([
+__decorate$j([
   MapToComponentField()
 ], FocusController.prototype, "vegaRichTextEditorRenderer", void 0);
-__decorate$i([
+__decorate$j([
   MapToComponentField()
 ], FocusController.prototype, "selectionController", void 0);
-__decorate$i([
+__decorate$j([
   MapToComponentField()
 ], FocusController.prototype, "valueController", void 0);
-__decorate$i([
+__decorate$j([
   MapToComponentField()
 ], FocusController.prototype, "value", void 0);
 
-var __decorate$h = (undefined && undefined.__decorate) || function (decorators, target, key, desc) {
+var __decorate$i = (undefined && undefined.__decorate) || function (decorators, target, key, desc) {
   var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
   if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
   else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
@@ -4465,38 +4696,39 @@ class InsertCompositionTextController extends VegaSlimmer {
     const inputEvent = new CustomEvent('beforeinput');
     inputEvent['data'] = text;
     inputEvent['inputType'] = 'insertText';
+    inputEvent[RTE_UPDATE_SOURCE_KEY] = RTEUpdateSource.Composition;
     this.editableElementRef.dispatchEvent(inputEvent);
   }
 }
-__decorate$h([
+__decorate$i([
   MapToComponentField()
 ], InsertCompositionTextController.prototype, "selectionController", void 0);
-__decorate$h([
+__decorate$i([
   MapToComponentField()
 ], InsertCompositionTextController.prototype, "host", void 0);
-__decorate$h([
+__decorate$i([
   MapToComponentField()
 ], InsertCompositionTextController.prototype, "value", void 0);
-__decorate$h([
+__decorate$i([
   MapToComponentField()
 ], InsertCompositionTextController.prototype, "valueController", void 0);
-__decorate$h([
+__decorate$i([
   MapToComponentField()
 ], InsertCompositionTextController.prototype, "userInputController", void 0);
-__decorate$h([
+__decorate$i([
   MapToComponentField()
 ], InsertCompositionTextController.prototype, "vegaRichTextEditorRenderer", void 0);
-__decorate$h([
+__decorate$i([
   MapToComponentMethod('componentDidLoad')
 ], InsertCompositionTextController.prototype, "addCompositionTextEventListener", null);
-__decorate$h([
+__decorate$i([
   MapToComponentMethod('disconnectedCallback')
 ], InsertCompositionTextController.prototype, "removeCompositionTextEventListener", null);
-__decorate$h([
+__decorate$i([
   MapToComponentMethod('componentDidRender')
 ], InsertCompositionTextController.prototype, "reConnectObserver", null);
 
-var __decorate$g = (undefined && undefined.__decorate) || function (decorators, target, key, desc) {
+var __decorate$h = (undefined && undefined.__decorate) || function (decorators, target, key, desc) {
   var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
   if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
   else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
@@ -4705,23 +4937,23 @@ class DeleteSelectedNodesController extends VegaSlimmer {
     }
   }
 }
-__decorate$g([
+__decorate$h([
   MapToComponentField()
 ], DeleteSelectedNodesController.prototype, "host", void 0);
-__decorate$g([
+__decorate$h([
   MapToComponentField()
 ], DeleteSelectedNodesController.prototype, "selectionController", void 0);
-__decorate$g([
+__decorate$h([
   MapToComponentField()
 ], DeleteSelectedNodesController.prototype, "value", void 0);
-__decorate$g([
+__decorate$h([
   MapToComponentMethod('connectedCallback')
 ], DeleteSelectedNodesController.prototype, "addDeleteObserver", null);
-__decorate$g([
+__decorate$h([
   MapToComponentMethod('disconnectedCallback')
 ], DeleteSelectedNodesController.prototype, "removeDeleteObserver", null);
 
-var __decorate$f = (undefined && undefined.__decorate) || function (decorators, target, key, desc) {
+var __decorate$g = (undefined && undefined.__decorate) || function (decorators, target, key, desc) {
   var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
   if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
   else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
@@ -4798,22 +5030,22 @@ class HistoryController extends ComponentValueHistoryControllerSlimmer {
     await this.valueController.flushChanges(content, false);
   }
 }
-__decorate$f([
+__decorate$g([
   MapToComponentField()
 ], HistoryController.prototype, "host", void 0);
-__decorate$f([
+__decorate$g([
   MapToComponentField()
 ], HistoryController.prototype, "vegaRichTextEditorRenderer", void 0);
-__decorate$f([
+__decorate$g([
   MapToComponentField()
 ], HistoryController.prototype, "valueController", void 0);
-__decorate$f([
+__decorate$g([
   MapToComponentField()
 ], HistoryController.prototype, "value", void 0);
-__decorate$f([
+__decorate$g([
   MapToComponentField()
 ], HistoryController.prototype, "selectionController", void 0);
-__decorate$f([
+__decorate$g([
   MapToComponentMethod('componentDidLoad')
 ], HistoryController.prototype, "registerInitState", null);
 
@@ -4834,7 +5066,7 @@ class TransformToCodeBlockAction extends ModifyContentAction {
   }
 }
 
-var __decorate$e = (undefined && undefined.__decorate) || function (decorators, target, key, desc) {
+var __decorate$f = (undefined && undefined.__decorate) || function (decorators, target, key, desc) {
   var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
   if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
   else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
@@ -4890,13 +5122,13 @@ class CodeBlockToolbarButtonSlimmer extends VisualModeToolbarButtonSlimmer {
 (() => {
   VegaInternalIconManager.register({ 'rectangle-code': rectangleCode });
 })();
-__decorate$e([
+__decorate$f([
   MapToComponentField()
 ], CodeBlockToolbarButtonSlimmer.prototype, "selectionController", void 0);
-__decorate$e([
+__decorate$f([
   MapToComponentField()
 ], CodeBlockToolbarButtonSlimmer.prototype, "valueController", void 0);
-__decorate$e([
+__decorate$f([
   MapToComponentField()
 ], CodeBlockToolbarButtonSlimmer.prototype, "value", void 0);
 
@@ -4904,7 +5136,7 @@ const undoIcon = {
   icon: `<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512"><!--! Font Awesome Pro 7.2.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license (Commercial License) Copyright 2026 Fonticons, Inc. --><path fill="currentColor" d="M464 424c0 13.3 10.7 24 24 24s24-10.7 24-24l0-96c0-53-43-96-96-96l-334.1 0 95-95c9.4-9.4 9.4-24.6 0-33.9s-24.6-9.4-33.9 0L7 239c-4.5 4.5-7 10.6-7 17s2.5 12.5 7 17L143 409c9.4 9.4 24.6 9.4 33.9 0s9.4-24.6 0-33.9l-95-95 334.1 0c26.5 0 48 21.5 48 48l0 96z"/></svg>`,
 };
 
-var __decorate$d = (undefined && undefined.__decorate) || function (decorators, target, key, desc) {
+var __decorate$e = (undefined && undefined.__decorate) || function (decorators, target, key, desc) {
   var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
   if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
   else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
@@ -4933,7 +5165,7 @@ class UndoToolbarButtonSlimmer extends VisualModeToolbarButtonSlimmer {
 (() => {
   VegaInternalIconManager.register({ 'arrow-turn-left': undoIcon });
 })();
-__decorate$d([
+__decorate$e([
   MapToComponentField()
 ], UndoToolbarButtonSlimmer.prototype, "historyController", void 0);
 
@@ -4941,7 +5173,7 @@ const redoIcon = {
   icon: `<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512"><!--! Font Awesome Pro 7.2.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license (Commercial License) Copyright 2026 Fonticons, Inc. --><path fill="currentColor" d="M48 424c0 13.3-10.7 24-24 24S0 437.3 0 424l0-96c0-53 43-96 96-96l334.1 0-95-95c-9.4-9.4-9.4-24.6 0-33.9s24.6-9.4 33.9 0L505 239c4.5 4.5 7 10.6 7 17s-2.5 12.5-7 17L369 409c-9.4 9.4-24.6 9.4-33.9 0s-9.4-24.6 0-33.9l95-95-334.1 0c-26.5 0-48 21.5-48 48l0 96z"/></svg>`,
 };
 
-var __decorate$c = (undefined && undefined.__decorate) || function (decorators, target, key, desc) {
+var __decorate$d = (undefined && undefined.__decorate) || function (decorators, target, key, desc) {
   var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
   if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
   else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
@@ -4970,7 +5202,7 @@ class RedoToolbarButtonSlimmer extends VisualModeToolbarButtonSlimmer {
 (() => {
   VegaInternalIconManager.register({ 'arrow-turn-right': redoIcon });
 })();
-__decorate$c([
+__decorate$d([
   MapToComponentField()
 ], RedoToolbarButtonSlimmer.prototype, "historyController", void 0);
 
@@ -5041,7 +5273,7 @@ const displayCode = {
   icon: `<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 576 512"><!--! Font Awesome Pro 6.3.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license (Commercial License) Copyright 2023 Fonticons, Inc. --><path fill="currentColor" d="M512 48c8.8 0 16 7.2 16 16V352c0 8.8-7.2 16-16 16H336.5c-.3 0-.6 0-.8 0H240.4c-.3 0-.6 0-.8 0H64c-8.8 0-16-7.2-16-16V64c0-8.8 7.2-16 16-16H512zM64 416H211.7l-8 48H152c-13.3 0-24 10.7-24 24s10.7 24 24 24h72H352h72c13.3 0 24-10.7 24-24s-10.7-24-24-24H372.3l-8-48H512c35.3 0 64-28.7 64-64V64c0-35.3-28.7-64-64-64H64C28.7 0 0 28.7 0 64V352c0 35.3 28.7 64 64 64zm188.3 48l8-48h55.3l8 48H252.3zM249 177c9.4-9.4 9.4-24.6 0-33.9s-24.6-9.4-33.9 0l-48 48c-9.4 9.4-9.4 24.6 0 33.9l48 48c9.4 9.4 24.6 9.4 33.9 0s9.4-24.6 0-33.9l-31-31 31-31zM361 143c-9.4-9.4-24.6-9.4-33.9 0s-9.4 24.6 0 33.9l31 31-31 31c-9.4 9.4-9.4 24.6 0 33.9s24.6 9.4 33.9 0l48-48c9.4-9.4 9.4-24.6 0-33.9l-48-48z"/></svg>`,
 };
 
-var __decorate$b = (undefined && undefined.__decorate) || function (decorators, target, key, desc) {
+var __decorate$c = (undefined && undefined.__decorate) || function (decorators, target, key, desc) {
   var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
   if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
   else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
@@ -5062,11 +5294,25 @@ class SourceEditToolbarButtonSlimmer extends ToolbarButtonSlimmer {
     if (isSelected) {
       await this.saveSourceCode();
     }
-    else {
-      this.selectionController.setSelectionRange(new Range());
-    }
+    // VD-8789 (keyboard a11y): the previous implementation cleared the editor
+    // selection here via `selectionController.setSelectionRange(new Range())`
+    // when entering source view. That call is intentionally removed so the
+    // caret position is preserved when toggling back to visual mode, and so
+    // the source-edit button can be re-activated from the keyboard without
+    // the selection being reset out from under the user.
     this.sourceView = !isSelected;
   }
+  // VD-8789 (keyboard a11y): the default `preventLostFocus` calls
+  // `e.preventDefault()` on mousedown so the button never receives focus and
+  // the rich-text editor selection is preserved. The source-edit toggle is
+  // different — activating it switches the editor to source-view mode, where
+  // the visual-mode selection is no longer relevant. We override with a no-op
+  // so the button is allowed to take focus on click, matching its keyboard
+  // activation path and giving keyboard / screen-reader users a stable focus
+  // target to toggle back out of source view.
+  preventLostFocus() {
+    return {};
+  }
   isSelected() {
     return this.sourceView;
   }
@@ -5074,7 +5320,9 @@ class SourceEditToolbarButtonSlimmer extends ToolbarButtonSlimmer {
     return super.isDisabled();
   }
   async saveSourceCode() {
+    var _a;
     const sourceViewValue = this.richTextEditorSourceViewRenderer.getSourceCode();
+    const blockBoundaryRegistry = (_a = extensionContextManager.getExtensionContext(this.host)) === null || _a === void 0 ? void 0 : _a.blockBoundaryRegistry;
     if (!sourceViewValue && this.value.isEmpty()) {
       return;
     }
@@ -5082,6 +5330,7 @@ class SourceEditToolbarButtonSlimmer extends ToolbarButtonSlimmer {
       await this.valueController.flushChanges(VegaRTEContent.fromHtml(sourceViewValue, {
         autoMatchFormat: this.sourceEditConfig.autoMatchFormat,
         filterInlineStyles: this.sourceEditConfig.filterInlineStyles,
+        blockBoundaryRegistry,
       }));
     }
   }
@@ -5089,26 +5338,61 @@ class SourceEditToolbarButtonSlimmer extends ToolbarButtonSlimmer {
 (() => {
   VegaInternalIconManager.register({ 'display-code': displayCode });
 })();
-__decorate$b([
+__decorate$c([
   MapToComponentField({ writable: true })
 ], SourceEditToolbarButtonSlimmer.prototype, "sourceView", void 0);
-__decorate$b([
-  MapToComponentField()
-], SourceEditToolbarButtonSlimmer.prototype, "selectionController", void 0);
-__decorate$b([
+__decorate$c([
   MapToComponentField()
 ], SourceEditToolbarButtonSlimmer.prototype, "valueController", void 0);
-__decorate$b([
+__decorate$c([
   MapToComponentField()
 ], SourceEditToolbarButtonSlimmer.prototype, "richTextEditorSourceViewRenderer", void 0);
-__decorate$b([
+__decorate$c([
   MapToComponentField()
 ], SourceEditToolbarButtonSlimmer.prototype, "sourceEditConfig", void 0);
-__decorate$b([
+__decorate$c([
+  MapToComponentField()
+], SourceEditToolbarButtonSlimmer.prototype, "host", void 0);
+__decorate$c([
   MapToComponentField()
 ], SourceEditToolbarButtonSlimmer.prototype, "value", void 0);
 
-var __decorate$a = (undefined && undefined.__decorate) || function (decorators, target, key, desc) {
+/**
+ * Per-editor registry for block-boundary predicates contributed by extensions.
+ */
+class BlockBoundaryRegistry {
+  constructor() {
+    this.predicates = new Set();
+  }
+  /**
+   * Register a block-boundary predicate.
+   *
+   * @param {BlockBoundaryPredicate} predicate - Predicate to register.
+   * @returns {() => void} Unregister callback.
+   */
+  register(predicate) {
+    this.predicates.add(predicate);
+    return () => {
+      this.predicates.delete(predicate);
+    };
+  }
+  /**
+   * Returns true when any registered predicate marks the element as a boundary.
+   *
+   * @param {HTMLElement} element - Element to inspect.
+   * @returns {boolean} Whether the element is a boundary.
+   */
+  isBoundary(element) {
+    for (const predicate of this.predicates) {
+      if (predicate(element)) {
+        return true;
+      }
+    }
+    return false;
+  }
+}
+
+var __decorate$b = (undefined && undefined.__decorate) || function (decorators, target, key, desc) {
   var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
   if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
   else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
@@ -5220,37 +5504,114 @@ class RTEExtensionController extends VegaSlimmer {
       getSelectedNodes: this.getSelectedNodes,
       setSelectedNodes: this.selectionController.setSelectedNodes.bind(this.selectionController),
       getSelection: this.selectionController.getSelection.bind(this.selectionController),
+      blockBoundaryRegistry: new BlockBoundaryRegistry(),
     };
   }
 }
-__decorate$a([
+__decorate$b([
   MapToComponentField()
 ], RTEExtensionController.prototype, "extensions", void 0);
-__decorate$a([
+__decorate$b([
   MapToComponentField()
 ], RTEExtensionController.prototype, "host", void 0);
-__decorate$a([
+__decorate$b([
   MapToComponentField()
 ], RTEExtensionController.prototype, "sourceView", void 0);
-__decorate$a([
+__decorate$b([
   MapToComponentField()
 ], RTEExtensionController.prototype, "valueController", void 0);
-__decorate$a([
+__decorate$b([
   MapToComponentField()
 ], RTEExtensionController.prototype, "selectionController", void 0);
-__decorate$a([
+__decorate$b([
   MapToComponentMethod('componentWillLoad')
 ], RTEExtensionController.prototype, "prepareExtensionsBeforeLoad", null);
-__decorate$a([
+__decorate$b([
   MapToComponentMethod('componentDidLoad')
 ], RTEExtensionController.prototype, "initialExtensionContext", null);
-__decorate$a([
+__decorate$b([
   MapToComponentMethod('disconnectedCallback')
 ], RTEExtensionController.prototype, "destroyExtension", null);
-__decorate$a([
+__decorate$b([
   MapToComponentMethod('watchExtensions')
 ], RTEExtensionController.prototype, "handleExtensionsChange", null);
 
+var __decorate$a = (undefined && undefined.__decorate) || function (decorators, target, key, desc) {
+  var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+  if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+  else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+  return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+/**
+ * Bridges the word count extension to the editor component so the footer UI can
+ * read whether the character count should be shown and its current value.
+ */
+class WordCountController extends VegaSlimmer {
+  constructor() {
+    super(...arguments);
+    this.cachedValue = null;
+    this.cachedConfig = null;
+    this.cachedData = null;
+  }
+  /**
+   * Whether the character count UI should be rendered.
+   *
+   * @returns {boolean} True when a word count extension requests the UI.
+   */
+  shouldShowUI() {
+    var _a;
+    return !!((_a = this.findWordCountExtension()) === null || _a === void 0 ? void 0 : _a.getConfig().showCharCount);
+  }
+  /**
+   * Compute the current character count data from the editor content.
+   *
+   * @returns {Nullable<VegaRTEWordCountData>} The count data or null when no word count extension is registered.
+   */
+  getData() {
+    const extension = this.findWordCountExtension();
+    if (!extension) {
+      return null;
+    }
+    const value = this.host.value;
+    const config = extension.getConfig();
+    // VegaRTEContent is immutable, so a matching value/config reference means the data is unchanged.
+    if (this.cachedData && value === this.cachedValue && deepEqual(config, this.cachedConfig)) {
+      return this.cachedData;
+    }
+    this.cachedData = extension.getData(value);
+    this.cachedValue = value;
+    this.cachedConfig = config;
+    return this.cachedData;
+  }
+  /**
+   * Whether the word count extension gates commits with a hard character limit.
+   *
+   * @returns {boolean} True when a hard limit with a max character count is configured for this host.
+   */
+  hasWordCountHardLimit() {
+    var _a;
+    const config = (_a = this.findWordCountExtension()) === null || _a === void 0 ? void 0 : _a.getConfig();
+    return !!config && Boolean(config.hardLimit) && isNonNullable(config.maxChars);
+  }
+  /**
+   * Locate the word count extension by its runtime `type` discriminator.
+   * Use this way instead of instanceof to avoid direct dependency on the extension class.
+   *
+   * @returns {Nullable<VegaRTEWordCountExtension>} The word count extension or null.
+   */
+  findWordCountExtension() {
+    var _a;
+    const extension = ((_a = this.extensions) !== null && _a !== void 0 ? _a : []).find((ext) => 'type' in ext && ext['type'] === RTE_WORD_COUNT_KEY);
+    return extension !== null && extension !== void 0 ? extension : null;
+  }
+}
+__decorate$a([
+  MapToComponentField()
+], WordCountController.prototype, "extensions", void 0);
+__decorate$a([
+  MapToComponentField()
+], WordCountController.prototype, "host", void 0);
+
 /**
  * Class to format HTML code with proper indentation and style cleanup.
  */
@@ -5435,14 +5796,16 @@ class VegaRichTextEditorSourceViewRenderer extends VegaSlimmer {
      * Handle the blur event of the code block. When the code block loses focus, emit the source code change event with the current source code.
      */
     this.handleCodeBlockBlur = () => {
-      var _a;
+      var _a, _b;
       // If source view is closed while blurring, it means the user switch back to normal mode, so we can skip emitting the change event.
       if (this.sourceView) {
         const filterInlineStyles = Boolean(this.sourceEditConfig.filterInlineStyles);
         const sourceCode = this.getSourceCode();
+        const blockBoundaryRegistry = (_a = extensionContextManager.getExtensionContext(this.host)) === null || _a === void 0 ? void 0 : _a.blockBoundaryRegistry;
         const newValue = VegaRTEContent.fromHtml(sourceCode, {
-          autoMatchFormat: (_a = this.sourceEditConfig.autoMatchFormat) !== null && _a !== void 0 ? _a : true,
+          autoMatchFormat: (_b = this.sourceEditConfig.autoMatchFormat) !== null && _b !== void 0 ? _b : true,
           filterInlineStyles,
+          blockBoundaryRegistry,
         });
         const newSourceCode = newValue.toHtml({ filterInlineStyles });
         if (newSourceCode !== this.prevRecord) {
@@ -5565,6 +5928,13 @@ const VegaRichTextEditor = class {
     this.vegaSourceCodeChange = createEvent(this, "vegaSourceCodeChange", 7);
     this.sourceCodeChange = createEvent(this, "sourceCodeChange", 7);
     this.globalSlimmers = {};
+    this.ariaAttributesValueMapper = new AriaAttributesValueMapper(() => this.vegaRichTextEditorRenderer.getRTEEditableElementRef(), {
+      'aria-label': {
+        dependency: ['data-aria-label', 'label'],
+        // When no label is provided, announce a meaningful role name
+        defaultValue: () => this.translationSlimmer.t('Rich Text Editor. Editing area: main. '),
+      },
+    });
     this.translationSlimmer = new TranslationSlimmer();
     this.vegaComponentUsageRuntimeMetricsSlimmer = new VegaComponentUsageRuntimeMetricsSlimmer();
     this.formFieldController = new FormFieldControllerSlimmer({
@@ -5617,6 +5987,7 @@ const VegaRichTextEditor = class {
     this.historyController = new HistoryController();
     this.internalCodeBlockSelectionController = new InternalCodeBlockSelectionController();
     this.rteExtensionController = new RTEExtensionController();
+    this.wordCountController = new WordCountController();
     this.sourceCodeChangeEventEmitter = createEventEmitSlimmer(VegaRichTextEditor, VegaSourceCodeChange);
     this.richTextEditorSourceViewRenderer = new VegaRichTextEditorSourceViewRenderer();
     this.richTextContentEditable = true;
@@ -5815,6 +6186,9 @@ const VegaRichTextEditor = class {
 __decorate$8([
   InjectVegaGlobalSlimmer()
 ], VegaRichTextEditor.prototype, "globalSlimmers", void 0);
+__decorate$8([
+  InjectVegaSlimmer()
+], VegaRichTextEditor.prototype, "ariaAttributesValueMapper", void 0);
 __decorate$8([
   InjectVegaSlimmer()
 ], VegaRichTextEditor.prototype, "translationSlimmer", void 0);
@@ -5935,6 +6309,9 @@ __decorate$8([
 __decorate$8([
   InjectVegaSlimmer()
 ], VegaRichTextEditor.prototype, "rteExtensionController", void 0);
+__decorate$8([
+  InjectVegaSlimmer()
+], VegaRichTextEditor.prototype, "wordCountController", void 0);
 __decorate$8([
   InjectVegaSlimmer()
 ], VegaRichTextEditor.prototype, "sourceCodeChangeEventEmitter", void 0);
@@ -5968,7 +6345,7 @@ class VegaRichTextEditorToolbarButtonRenderer extends VegaSlimmer {
         'rich-text-editor-toolbar-button-hidden': this.hidden,
         'rich-text-editor-toolbar-button-selected': this.selected,
       }, onClick: this.handleClick, disabled: this.disabled, hidden: this.hidden },
-      h("vega-flex", { gap: "size-8", justifyContent: "center", alignItems: "center" },
+      h("vega-flex", { "aria-hidden": "true", gap: "size-8", justifyContent: "center", alignItems: "center" },
         this.icon && (h("vega-icon", { size: "size-16", color: this.iconColor, icon: VegaInternalIconManager.getIconKey(this.icon) })),
         this.showArrowIcon && (h("vega-icon", { size: "size-8", color: "text-secondary", icon: VegaInternalIconManager.getIconKey(this.arrowIcon || 'chevron-down') }))),
       h("slot", null)));
@@ -6034,6 +6411,12 @@ const VegaRichTextEditorToolbarButton = class {
       },
     });
     this.renderer = new VegaRichTextEditorToolbarButtonRenderer();
+    this.ariaAttributesValueMapper = new AriaAttributesValueMapper(() => this.host.shadowRoot.querySelector('button'), {
+      'aria-label': {
+        dependency: ['data-aria-label'],
+        defaultValue: 'No label defined',
+      },
+    });
     /**
      * Specifies whether the rich text editor toolbar button element is disabled.
      *
@@ -6078,7 +6461,9 @@ const VegaRichTextEditorToolbarButton = class {
     this.iconColor = 'text-primary';
   }
   render() {
-    return sanitizeVegaComponent(h(Host, null, this.renderer.render()), this.host);
+    // The host is a decorative wrapper around the shadow <button>; keep it out of the
+    // a11y tree so VoiceOver doesn't announce it as a "group" when entering the button.
+    return sanitizeVegaComponent(h(Host, { role: "presentation" }, this.renderer.render()), this.host);
   }
   get host() { return getElement(this); }
 };
@@ -6097,6 +6482,9 @@ __decorate$6([
 __decorate$6([
   InjectVegaSlimmer()
 ], VegaRichTextEditorToolbarButton.prototype, "renderer", void 0);
+__decorate$6([
+  InjectVegaSlimmer()
+], VegaRichTextEditorToolbarButton.prototype, "ariaAttributesValueMapper", void 0);
 VegaRichTextEditorToolbarButton.style = vegaRichTextEditorToolbarButtonCss;
 
 var __decorate$5 = (undefined && undefined.__decorate) || function (decorators, target, key, desc) {
@@ -6324,6 +6712,11 @@ class VegaRichTextLinkEditorRenderer extends VegaSlimmer {
     this.handleFormRef = (ref) => {
       this.formRef = ref;
     };
+    this.handlePopoverContentRef = (ref) => {
+      if (ref) {
+        this.popoverContentRef = ref;
+      }
+    };
     this.handleUrlInputRef = (ref) => {
       if (ref) {
         this.urlInputRef = ref;
@@ -6357,6 +6750,9 @@ class VegaRichTextLinkEditorRenderer extends VegaSlimmer {
   getPopoverRef() {
     return this.popoverRef;
   }
+  getPopoverContentRef() {
+    return this.popoverContentRef;
+  }
   getFormRef() {
     return this.formRef;
   }
@@ -6370,7 +6766,7 @@ class VegaRichTextLinkEditorRenderer extends VegaSlimmer {
     return (h("vega-popover", { trigger: "click", alignment: "start", placement: "bottom", showArrow: false, isScreenPosition: true, ref: this.handlePopoverRef },
       h("span", { slot: "popover-content" },
         h("slot", null)),
-      h("div", { slot: "popover" },
+      h("div", { slot: "popover", ref: this.handlePopoverContentRef },
         this.renderLinkUnlinkContent(),
         this.renderLinkEditContent())));
   }
@@ -6596,10 +6992,41 @@ class LinkEditorController extends VegaSlimmer {
     super(...arguments);
     this.linkUrlNormalizer = new LinkUrlNormalizer();
     this.linkTypeHandlers = LINK_TYPE_HANDLER_MAP;
+    /**
+     * The element the trigger click listener is currently attached to (the link
+     * wrapper acting as the popover target).
+     */
+    this.triggerListenerEl = null;
+    /**
+     * Whether the popover was opened via a keyboard or screen-reader (VoiceOver)
+     * activation. When true, focus is moved into the popover so screen reader
+     * users land on the Edit button.
+     */
+    this.isVoiceOverTrigger = false;
+    /**
+     * The element that had focus when the VoiceOver activation happened, so focus
+     * can be restored to the link once the popover is hidden.
+     */
+    this.focusReturnEl = null;
+    /**
+     * Records whether the popover was opened via a keyboard/VoiceOver activation
+     * and, if so, the element to restore focus to when the popover closes.
+     *
+     * @param {MouseEvent} e - The click event on the link wrapper.
+     * @returns {void} No return value.
+     */
+    this.handleTriggerClick = (e) => {
+      this.isVoiceOverTrigger = this.isKeyboardOrScreenReaderActivation(e);
+      this.focusReturnEl = this.isVoiceOverTrigger
+        ? // eslint-disable-next-line no-restricted-globals
+          getDeepActiveElementInShadow(document, true)
+        : null;
+    };
   }
   /** Initializes the popover target after the component loads. */
   componentDidLoad() {
     this.updatePopoverTarget();
+    this.attachTriggerListener();
   }
   /** Notifies observers after each render cycle. */
   componentDidRender() {
@@ -6618,6 +7045,7 @@ class LinkEditorController extends VegaSlimmer {
   watchTargetChange() {
     this.linkTypeConfigController.invalidateConfiguredLinkTypesCache();
     this.updatePopoverTarget();
+    this.attachTriggerListener();
   }
   /**
    * Prepares the editor state before the popover is shown.
@@ -6648,6 +7076,9 @@ class LinkEditorController extends VegaSlimmer {
       }
       await this.populateEditForm();
     }
+    if (this.status !== 'linkEdit' && this.isVoiceOverTrigger) {
+      this.focusPopoverContentForVoiceOver();
+    }
   }
   /**
    * Clears form state after the popover hides.
@@ -6664,6 +7095,7 @@ class LinkEditorController extends VegaSlimmer {
     if (this.resetStatusAfterHide) {
       this.linkEditorStateManager.setShouldResetStatusOnNextShow(true);
     }
+    this.restoreFocusAfterVoiceOver();
   }
   /**
    * Switches the editor into link edit mode.
@@ -6825,6 +7257,93 @@ class LinkEditorController extends VegaSlimmer {
   updatePopoverTarget() {
     remoteInvocationRegistry.call(domNodeSubjectFactory.getSubject(this.renderer.getPopoverRef(), VegaInternalPopoverUpdateTarget), this.target);
   }
+  /**
+   * Attaches a capture-phase click listener to the link wrapper (the popover
+   * target) so a keyboard/VoiceOver activation can be distinguished from a real
+   * pointer click before the popover opens. Re-attaches when the target changes.
+   *
+   * @returns {void} No return value.
+   */
+  attachTriggerListener() {
+    if (this.triggerListenerEl === this.target) {
+      return;
+    }
+    this.detachTriggerListener();
+    if (this.target) {
+      this.triggerListenerEl = this.target;
+      this.target.addEventListener('click', this.handleTriggerClick, { capture: true });
+    }
+  }
+  /**
+   * Removes the trigger listener from the previously observed element.
+   *
+   * @returns {void} No return value.
+   */
+  detachTriggerListener() {
+    if (this.triggerListenerEl) {
+      this.triggerListenerEl.removeEventListener('click', this.handleTriggerClick, { capture: true });
+      this.triggerListenerEl = null;
+    }
+  }
+  /**
+   * Determines whether a click on the link wrapper came from a keyboard or
+   * screen reader (VoiceOver) rather than a real pointer.
+   *
+   * A genuine pointer click lands inside the activated element. Keyboard (Enter,
+   * `detail === 0`) and VoiceOver activations dispatch a click with coordinates
+   * that are not on the element, so we treat any click whose point falls outside
+   * the wrapper as an assistive-technology activation.
+   *
+   * @param {MouseEvent} e - The click event on the link wrapper.
+   * @returns {boolean} True when the activation is keyboard/screen-reader driven.
+   */
+  isKeyboardOrScreenReaderActivation(e) {
+    if (checkIsVoiceOverClick(e)) {
+      return true;
+    }
+    const rect = this.target ? this.target.getBoundingClientRect() : null;
+    if (!rect || (rect.width === 0 && rect.height === 0)) {
+      return false;
+    }
+    const isInsideTarget = e.clientX >= rect.left &&
+      e.clientX <= rect.right &&
+      e.clientY >= rect.top &&
+      e.clientY <= rect.bottom;
+    return !isInsideTarget;
+  }
+  /**
+   * Moves focus to the first focusable element within the popover content (the
+   * Edit button) so VoiceOver users land inside the opened toolbar.
+   *
+   * Deferred to the next macrotask so it runs after the editor has finished
+   * placing the caret/focus into the content area on the activating click.
+   *
+   * @returns {void} No return value.
+   */
+  focusPopoverContentForVoiceOver() {
+    setTimeout(() => {
+      const contentRef = this.renderer.getPopoverContentRef();
+      if (!contentRef) {
+        return;
+      }
+      const focusable = getFirstFocusableElement(contentRef);
+      (focusable !== null && focusable !== void 0 ? focusable : contentRef).focus();
+    });
+  }
+  /**
+   * Restores focus to the link wrapper after the popover is hidden following a
+   * VoiceOver activation.
+   *
+   * @returns {void} No return value.
+   */
+  restoreFocusAfterVoiceOver() {
+    if (this.isVoiceOverTrigger && this.focusReturnEl) {
+      const returnEl = this.focusReturnEl;
+      setTimeout(() => returnEl.focus());
+    }
+    this.isVoiceOverTrigger = false;
+    this.focusReturnEl = null;
+  }
   /**
    * Preserves an unchanged mailto URL when the form edits are equivalent.
    *