@heartlandone/vega 2.77.1 → 2.79.0

package/dist/esm/aria-dialog-focusable-trap-slimmer-cc98a7a4.js

@@ -0,0 +1,216 @@
+import { M as MapToComponentMethod, V as VegaSlimmer } from './global-slimmer-registry-17c4efd4.js';
+import { l as checkIsVoiceOverClick, e as getDeepActiveElementInShadow } from './ui-ac244bf0.js';
+import { S as SynchronizeTaskQueue } from './synchronize-task-queue-ac8acc3b.js';
+
+var __decorate = (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;
+};
+const focusableSelector = [
+  'a[href]',
+  'area[href]',
+  'button',
+  'input',
+  'select',
+  'textarea',
+  'iframe',
+  'object',
+  'embed',
+  '[contenteditable="true"]',
+  '[contenteditable=""]',
+  '[tabindex]',
+].join(',');
+/**
+ * The `AriaDialogFocusableTrapSlimmer` class is designed to manage focus behavior for dialog elements appended to the DOM, particularly in scenarios where screen readers like VoiceOver are used.
+ * It detects when a click event is likely triggered by VoiceOver and ensures that focus is appropriately set to the first focusable element
+ * within the dialog content when it is shown, and returns focus to the triggering element when the dialog is hidden.
+ * This helps maintain a logical focus order and improves accessibility for keyboard users and screen reader users.
+ */
+class AriaDialogFocusableTrapSlimmer extends VegaSlimmer {
+  constructor(entry) {
+    super();
+    this.isVoiceOverClick = false;
+    this.focusTriggerElement = null;
+    this.focusDialogTaskQueue = new SynchronizeTaskQueue();
+    /**
+     * Sets up the event listener for click events on the trigger element or the window.
+     */
+    this.eventListenerHandler = () => {
+      const target = this.entry.triggerEl() || window;
+      target.addEventListener('click', this.handleClickEvent, { capture: true });
+    };
+    /**
+     * Removes the event listener for click events from the trigger element or the window.
+     */
+    this.eventListenerRemover = () => {
+      const target = this.entry.triggerEl();
+      target && target.removeEventListener('click', this.handleClickEvent, { capture: true });
+      window.removeEventListener('click', this.handleClickEvent, { capture: true });
+    };
+    /**
+     * Handles the click event and determines if it is likely triggered by VoiceOver.
+     *  If it is a VoiceOver click, it sets the `isVoiceOverClick` flag to true and stores the currently focused element as the trigger element.
+     * 	If it is not a VoiceOver click, it resets the `focusTriggerElement` to null.
+     *
+     * @param {MouseEvent} e - The click event object that is passed to the event handler.
+     */
+    this.handleClickEvent = (e) => {
+      this.isVoiceOverClick = checkIsVoiceOverClick(e);
+      if (!this.isVoiceOverClick) {
+        this.focusTriggerElement = null;
+      }
+    };
+    /**
+     * Recursively searches for the first focusable element within the given container, including its shadow DOM descendants.
+     * 	If the container itself is focusable, it will be returned.
+     *
+     * @param {HTMLElement | ShadowRoot} container - The container to search within.
+     * @returns {Nullable<HTMLElement>} The first focusable element found, or null if none exists.
+     */
+    this.getFirstFocusableElement = (container) => {
+      /**
+       * Recursively search for the first focusable element within the given node and its shadow DOM descendants.
+       *
+       * @param {ParentNode} node - The node to search within.
+       * @returns {Nullable<HTMLElement>} The first focusable element found, or null if none exists.
+       */
+      const findFirst = (node) => {
+        if (node instanceof HTMLElement && this.isFocusableElement(node)) {
+          return node;
+        }
+        const elements = Array.from(node.querySelectorAll('*'));
+        for (const element of elements) {
+          if (this.isFocusableElement(element)) {
+            return element;
+          }
+          if (element.shadowRoot) {
+            const found = findFirst(element.shadowRoot);
+            if (found)
+              return found;
+          }
+        }
+        return null;
+      };
+      if (container instanceof HTMLElement && container.shadowRoot) {
+        if (this.isFocusableElement(container))
+          return container;
+        return findFirst(container) || findFirst(container.shadowRoot);
+      }
+      else {
+        return findFirst(container);
+      }
+    };
+    /**
+     * It returns the first focusable element in the modal container, or the modal container itself if it is focusable.
+     *
+     * @param {HTMLElement} element - The element to check for focusable and to search within if it is not focusable.
+     * @returns {boolean} True if the element is focusable, false otherwise.
+     */
+    this.isFocusableElement = (element) => {
+      if (!element.matches(focusableSelector))
+        return false;
+      if (element.hasAttribute('disabled') || element.hasAttribute('inert'))
+        return false;
+      if (element.getAttribute('aria-hidden') === 'true')
+        return false;
+      if (element instanceof HTMLInputElement && element.type === 'hidden')
+        return false;
+      return element.tabIndex >= 0;
+    };
+    this.entry = entry;
+  }
+  /**
+   * Ensures that the event listener for click events is set up when the component is connected to the DOM. This is important for cases where the component might be added to the DOM after it has been initialized, ensuring that the click events are properly handled to manage focus behavior for dialog elements.
+   */
+  connectedCallback() {
+    this.eventListenerHandler();
+  }
+  /**
+   * Removes the event listener for click events from the trigger element or the window when the component is disconnected from the DOM.
+   */
+  disconnectedCallback() {
+    this.eventListenerRemover();
+  }
+  /**
+   * Sets up the event listener for click events on the trigger element or the window after the component has loaded.
+   */
+  componentDidLoad() {
+    this.eventListenerHandler();
+  }
+  /**
+   * Ensures that any pending focus actions are executed after the component has rendered.
+   */
+  async componentDidRender() {
+    await this.focusDialogTaskQueue.runTask();
+  }
+  /**
+   * When showing the dialog, if the last active element before the click event is detected as a VoiceOver click,
+   *
+   * @param {boolean} isOpen - A boolean indicating whether the dialog should be shown or hidden.
+   * @returns {Promise<void>} A promise that resolves when the focus action is complete.
+   */
+  async toggle(isOpen) {
+    if (isOpen) {
+      await this.show();
+    }
+    else {
+      await this.hide();
+    }
+  }
+  /**
+   * When showing the appended element, if the last active element before the click event is detected as a VoiceOver click,
+   *   it will attempt to focus the first focusable element within the appended element.
+   *
+   * @returns {Promise<void>} A promise that resolves when the focus action is complete.
+   */
+  async show() {
+    const activeEl = getDeepActiveElementInShadow();
+    if (activeEl) {
+      await this.focusDialogTaskQueue.enqueue({
+        // eslint-disable-next-line jsdoc/require-jsdoc
+        run: async () => {
+          if (this.isVoiceOverClick) {
+            this.focusTriggerElement = activeEl;
+            const dialogElement = this.entry.dialogEl();
+            const focusableElement = this.getFirstFocusableElement(dialogElement) || dialogElement;
+            focusableElement.focus();
+            this.isVoiceOverClick = false;
+          }
+        },
+      }, false);
+    }
+  }
+  /**
+   * When hiding the appended element, if the last active element before the click event is detected as a VoiceOver click,
+   *    it will attempt to focus back on the element that triggered the show action.
+   *
+   * @returns {Promise<void>} A promise that resolves when the focus action is complete.
+   */
+  async hide() {
+    if (this.focusTriggerElement) {
+      await this.focusDialogTaskQueue.enqueue({
+        // eslint-disable-next-line jsdoc/require-jsdoc
+        run: async () => {
+          this.focusTriggerElement && this.focusTriggerElement.focus();
+          this.focusTriggerElement = null;
+        },
+      }, false);
+    }
+  }
+}
+__decorate([
+  MapToComponentMethod('connectedCallback')
+], AriaDialogFocusableTrapSlimmer.prototype, "connectedCallback", null);
+__decorate([
+  MapToComponentMethod('disconnectedCallback')
+], AriaDialogFocusableTrapSlimmer.prototype, "disconnectedCallback", null);
+__decorate([
+  MapToComponentMethod('componentDidLoad')
+], AriaDialogFocusableTrapSlimmer.prototype, "componentDidLoad", null);
+__decorate([
+  MapToComponentMethod('componentDidRender')
+], AriaDialogFocusableTrapSlimmer.prototype, "componentDidRender", null);
+
+export { AriaDialogFocusableTrapSlimmer as A };

package/dist/esm/auto-run-when-re-render-task-queue-slimmer.abstract-27820d4c.js

@@ -0,0 +1,49 @@
+import { M as MapToComponentMethod, V as VegaSlimmer, L as LogUtility } from './global-slimmer-registry-17c4efd4.js';
+import { S as SynchronizeTaskQueue } from './synchronize-task-queue-ac8acc3b.js';
+
+var __decorate = (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;
+};
+/**
+ * The current slimmer contains a task queue and will call the task after component re-render.
+ */
+class AutoRunWhenReRenderTaskQueueSlimmer extends VegaSlimmer {
+  constructor(maxCount) {
+    super();
+    this.autoRunTaskQueue = new SynchronizeTaskQueue(maxCount);
+  }
+  /**
+   * Update the caret position after the component re-render
+   */
+  async executeTaskHook() {
+    if (this.autoRunTaskQueue.queue.length) {
+      await this.autoRunTaskQueue.runTask();
+    }
+  }
+  /**
+   * Push the update task to a queue.
+   *
+   * @param {boolean} [immediatelyRun] - Should the task run immediately. default is false
+   */
+  enqueueTheTaskIntoQueue(immediatelyRun = false) {
+    void this.autoRunTaskQueue.enqueue({
+      /** Add task to the queue and run it until component did render */
+      run: async () => {
+        try {
+          await this.doTask();
+        }
+        catch (e) {
+          LogUtility.error('The auto task run failed.', e);
+        }
+      },
+    }, immediatelyRun);
+  }
+}
+__decorate([
+  MapToComponentMethod('componentDidUpdate')
+], AutoRunWhenReRenderTaskQueueSlimmer.prototype, "executeTaskHook", null);
+
+export { AutoRunWhenReRenderTaskQueueSlimmer as A };

package/dist/esm/{breakpoints-56e5407b.js → breakpoints-332702ed.js}

@@ -1,4 +1,4 @@
-import { e as BreakpointKeys } from './ui-28fd4193.js';
+import { e as BreakpointKeys } from './ui-93922c59.js';
 import { B as Breakpoints } from './breakpoints-d9faf11c.js';
 
 /**

package/dist/esm/{child-nodes-event-prevent-slimmer-331312b8.js → child-nodes-event-prevent-slimmer-2ecc3e1f.js}

@@ -1,5 +1,5 @@
 import { c as MapToComponentField, M as MapToComponentMethod, V as VegaSlimmer } from './global-slimmer-registry-17c4efd4.js';
-import { i as internalVegaEventManager, j as jqueryDelegatedStrategyController } from './internal-vega-event-manager-32a3d848.js';
+import { i as internalVegaEventManager, j as jqueryDelegatedStrategyController } from './internal-vega-event-manager-59f5bd47.js';
 import { v as vegaEnvManager } from './vega-env-manager-8f8dc473.js';
 import { F as FeatureFlag } from './feature-flag-controller-30f7b625.js';
 

package/dist/esm/{child-nodes-notify-observer-slimmer-541dd6a4.js → child-nodes-notify-observer-slimmer-c7297b9f.js}

@@ -1,7 +1,7 @@
 import { c as MapToComponentField, M as MapToComponentMethod, V as VegaSlimmer } from './global-slimmer-registry-17c4efd4.js';
 import { O as Observer } from './observer-3959f9dd.js';
 import { C as ChangeManager } from './change-manager-6a7eb88c.js';
-import { b as isParent } from './ui-ee31416b.js';
+import { b as isParent } from './ui-ac244bf0.js';
 
 var __decorate = (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;

package/dist/esm/{code-block-2408a812.js → code-block-58d1dbe5.js}

@@ -1,13 +1,13 @@
 import { C as ChangeManager } from './change-manager-6a7eb88c.js';
-import { d as domNodeSubjectFactory } from './dom-node-subject-observer-factory-82f346e3.js';
-import { a as VegaInternalRichTextEditorFlushChanges, b as VegaInternalRichTextEditorSelectionRangeChange } from './vega-internal-event-id-799d012e.js';
+import { d as domNodeSubjectFactory } from './dom-node-subject-observer-factory-94b2e2c3.js';
+import { d as VegaInternalRichTextEditorFlushChanges, e as VegaInternalRichTextEditorSelectionRangeChange } from './vega-internal-event-id-8002b179.js';
 import { c as camelToDashCase } from './string-a953eafc.js';
 import { L as LogUtility } from './global-slimmer-registry-17c4efd4.js';
-import { i as isNonNullable } from './type-guard-af324dcd.js';
+import { i as isNonNullable } from './type-guard-c20cbbff.js';
 import { g as generateUUID } from './misc-9fdbcfbb.js';
 import { V as VegaInternalThemeManager } from './dark-mode-style-controller-82e5c1c6.js';
-import { c as cleanObject } from './object-66c37948.js';
-import { f as findParent } from './ui-ee31416b.js';
+import { c as cleanObject } from './object-0c277f57.js';
+import { f as findParent } from './ui-ac244bf0.js';
 
 var InternalAnnotationTypeEnum;
 (function (InternalAnnotationTypeEnum) {
@@ -1248,7 +1248,7 @@ class RTEBlock {
    * Get annotation by type
    *
    * @typedef T generic type
-   * @param {keyof typeof BlockAnnotationTypeEnum} type - Annotation type
+   * @param {string} type - Annotation type
    * @returns {Nullable<T>} - Annotation
    */
   getAnnotationByType(type) {
@@ -1271,6 +1271,20 @@ class RTEBlock {
       }
     }
   }
+  /**
+   * Get the first node of the block
+   *
+   * @returns {Nullable<RTENode>} The first RTENode or null if no children exist.
+   */
+  getFirstNode() {
+    if (!this.children || !this.children[0])
+      return null;
+    const firstItem = this.children[0];
+    if (firstItem instanceof RTEBlock) {
+      return firstItem.getFirstNode();
+    }
+    return firstItem;
+  }
   /**
    * Check if the block is a list item block
    *
@@ -1354,7 +1368,15 @@ class RTEBlock {
     if (!(annotation instanceof LinkGroupAnnotation)) {
       this.annotationMap.set(annotation.type, annotation);
     }
-    typeof this.doAnnotationActionApply === 'function' && this.doAnnotationActionApply(action);
+    if (typeof this.doAnnotationActionApply === 'function') {
+      this.doAnnotationActionApply(action);
+    }
+    else {
+      const strategy = ActionHandleStrategyRegistry.get(action.constructor.name, this.constructor.name);
+      if (strategy) {
+        strategy.execute(action, this);
+      }
+    }
   }
   /**
    * clone annotations of the block
@@ -1962,6 +1984,15 @@ class ActionHandleStrategy {
       return this.isCaretPositionAtTextBlockEnd(block, node, offset);
     }
   }
+  /**
+   * Get the registered DOM element by the RTE entity.
+   *
+   * @param {RTEBlock | RTENode} instance - The RTE block or node instance.
+   * @returns {Nullable<HTMLElement>} The registered DOM element.
+   */
+  getDOMByEntity(instance) {
+    return stateEntityRenderingRegistry.getDOMByEntity(instance);
+  }
   /**
    * Checks if the caret position is at the end of a specified RTETextNode.
    *
@@ -4361,4 +4392,4 @@ class RTECodeBlock extends RTEBlock {
 })();
 RTECodeBlock.CODE_BLOCK_PLACEHOLDER_CLASS_NAME = 'code-block-placeholder-element';
 
-export { TextColorAnnotationAction as $, ActionHandleStrategyRegistry as A, BlockUpdateTextStyleStrategy as B, CustomAttributeAnnotation as C, NodeTypeEnum as D, CommonAnnotation as E, AnnotationAction as F, ReplaceChildNodesAction as G, HorizontalAlignmentAnnotationAction as H, InsertChildrenAfterAction as I, SplitBlockWithNodeAction as J, BlockDeleteNodeContentStrategy as K, RemoveChildrenStrategy as L, ModifyContentAction as M, NodeAnnotation as N, RTE_TEXT_COLORS as O, RTE_DEFAULT_TEXT_COLOR as P, CodeLanguage as Q, RTEDTOClassManager$1 as R, SyncUpSelectionAction as S, TextStyleAnnotationAction as T, UpdateTextAction as U, VegaRTEPresetToolbarItems as V, LinkAnnotationAction as W, CommonAnnotationTypeEnum as X, UpdateCodeBlockAction as Y, ZERO_WIDTH_SPACE as Z, SelectionChangeAction as _, ActionHandlerInterceptorRegistry as a, RTECodeBlockNode as a0, BoldAnnotationAction as a1, ItalicAnnotationAction as a2, UnderlineAnnotationAction as a3, TextStyleAnnotation as a4, BoldAnnotation as a5, ClearFormattingAnnotationAction as a6, CodeAnnotationAction as a7, StrikethroughAnnotationAction as a8, IndentAnnotationAction as a9, RTETextNode as b, RTEBlock as c, RTETextBlock as d, RTEAnnotationStyle as e, ActionHandleStrategy as f, AppendChildrenAction as g, RTENode as h, InsertChildrenBeforeAction as i, InternalAnnotationTypeEnum as j, ModifyContentActionType as k, BlockUpdateHorizontalAlignmentStrategy as l, BlockInsertLineBreakStrategy as m, BlockInsertLineBreakWithBlocksStrategy as n, BlockSplitWithTextNodeStrategy as o, BlockReplaceNodesStrategy as p, BlockMergeNodesStrategy as q, RemoveChildrenAction as r, stateEntityRenderingRegistry as s, BlockAnnotation as t, BlockAnnotationTypeEnum as u, CustomStyleAnnotation as v, CustomClassAnnotation as w, RTECodeBlock as x, NodeAnnotationTypeEnum as y, RTEDecoratorNode as z };
+export { TextColorAnnotationAction as $, ActionHandleStrategyRegistry as A, BlockAnnotation as B, CommonAnnotationTypeEnum as C, NodeAnnotationTypeEnum as D, RTEDecoratorNode as E, NodeTypeEnum as F, CommonAnnotation as G, HorizontalAlignmentAnnotationAction as H, InsertChildrenAfterAction as I, ReplaceChildNodesAction as J, SplitBlockWithNodeAction as K, BlockDeleteNodeContentStrategy as L, ModifyContentAction as M, NodeAnnotation as N, RemoveChildrenStrategy as O, RTE_TEXT_COLORS as P, RTE_DEFAULT_TEXT_COLOR as Q, RTEDTOClassManager$1 as R, SyncUpSelectionAction as S, TextStyleAnnotationAction as T, UpdateTextAction as U, VegaRTEPresetToolbarItems as V, CodeLanguage as W, LinkAnnotationAction as X, UpdateCodeBlockAction as Y, ZERO_WIDTH_SPACE as Z, SelectionChangeAction as _, ActionHandlerInterceptorRegistry as a, RTECodeBlockNode as a0, BoldAnnotationAction as a1, ItalicAnnotationAction as a2, UnderlineAnnotationAction as a3, TextStyleAnnotation as a4, BoldAnnotation as a5, ClearFormattingAnnotationAction as a6, CodeAnnotationAction as a7, StrikethroughAnnotationAction as a8, IndentAnnotationAction as a9, RTETextNode as b, RTEBlock as c, RTETextBlock as d, RTEAnnotationStyle as e, ActionHandleStrategy as f, AppendChildrenAction as g, RTENode as h, InsertChildrenBeforeAction as i, InternalAnnotationTypeEnum as j, ModifyContentActionType as k, AnnotationAction as l, RemoveChildrenAction as m, CustomAttributeAnnotation as n, BlockUpdateTextStyleStrategy as o, BlockUpdateHorizontalAlignmentStrategy as p, BlockInsertLineBreakStrategy as q, BlockInsertLineBreakWithBlocksStrategy as r, stateEntityRenderingRegistry as s, BlockSplitWithTextNodeStrategy as t, BlockReplaceNodesStrategy as u, BlockMergeNodesStrategy as v, BlockAnnotationTypeEnum as w, CustomStyleAnnotation as x, CustomClassAnnotation as y, RTECodeBlock as z };

package/dist/esm/{component-value-history-controller-slimmer.abstract-ac40820f.js → component-value-history-controller-slimmer.abstract-5beb8acb.js}

@@ -1,15 +1,15 @@
-import { M as MapToComponentMethod, V as VegaSlimmer, L as LogUtility, c as MapToComponentField } from './global-slimmer-registry-17c4efd4.js';
-import { a0 as RTECodeBlockNode, b as RTETextNode, Z as ZERO_WIDTH_SPACE, _ as SelectionChangeAction, j as InternalAnnotationTypeEnum, s as stateEntityRenderingRegistry, c as RTEBlock, h as RTENode, z as RTEDecoratorNode, x as RTECodeBlock } from './code-block-2408a812.js';
+import { c as MapToComponentField, M as MapToComponentMethod } from './global-slimmer-registry-17c4efd4.js';
+import { a0 as RTECodeBlockNode, b as RTETextNode, Z as ZERO_WIDTH_SPACE, _ as SelectionChangeAction, j as InternalAnnotationTypeEnum, s as stateEntityRenderingRegistry, c as RTEBlock, h as RTENode, E as RTEDecoratorNode, z as RTECodeBlock } from './code-block-58d1dbe5.js';
 import { d as debounce } from './timer-9321173b.js';
 import { g as getActiveElement } from './component-7d906393.js';
 import { C as ChangeManager } from './change-manager-6a7eb88c.js';
-import { d as domNodeSubjectFactory, D as DomNodeSubjectObserverFactory } from './dom-node-subject-observer-factory-82f346e3.js';
-import { b as VegaInternalRichTextEditorSelectionRangeChange, V as VegaInternalUpdateRTECursorPosition } from './vega-internal-event-id-799d012e.js';
+import { d as domNodeSubjectFactory, D as DomNodeSubjectObserverFactory } from './dom-node-subject-observer-factory-94b2e2c3.js';
+import { e as VegaInternalRichTextEditorSelectionRangeChange, c as VegaInternalUpdateRTECursorPosition } from './vega-internal-event-id-8002b179.js';
 import { O as Observer } from './observer-3959f9dd.js';
-import { R as RTERange } from './range-a5d78e69.js';
-import { S as SynchronizeTaskQueue } from './synchronize-task-queue-ac8acc3b.js';
-import { i as isHTMLElement } from './ui-ee31416b.js';
-import { K as KeyboardManagerSlimmer } from './keyboard-manager-slimmer-c8898843.js';
+import { R as RTERange } from './range-4f9bf69d.js';
+import { A as AutoRunWhenReRenderTaskQueueSlimmer } from './auto-run-when-re-render-task-queue-slimmer.abstract-27820d4c.js';
+import { i as isHTMLElement } from './ui-ac244bf0.js';
+import { K as KeyboardManagerSlimmer } from './keyboard-manager-slimmer-4722d20c.js';
 
 let processing = false;
 /**
@@ -179,51 +179,6 @@ class ShadowSelectionPolyfill {
 }
 const ShadowSelectionPolyfill$1 = new ShadowSelectionPolyfill();
 
-var __decorate$1 = (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;
-};
-/**
- * The current slimmer contains a task queue and will call the task after component re-render.
- */
-class AutoRunWhenReRenderTaskQueueSlimmer extends VegaSlimmer {
-  constructor(maxCount) {
-    super();
-    this.autoRunTaskQueue = new SynchronizeTaskQueue(maxCount);
-  }
-  /**
-   * Update the caret position after the component re-render
-   */
-  async executeTaskHook() {
-    if (this.autoRunTaskQueue.queue.length) {
-      await this.autoRunTaskQueue.runTask();
-    }
-  }
-  /**
-   * Push the update task to a queue.
-   *
-   * @param {boolean} [immediatelyRun] - Should the task run immediately. default is false
-   */
-  enqueueTheTaskIntoQueue(immediatelyRun = false) {
-    void this.autoRunTaskQueue.enqueue({
-      /** Add task to the queue and run it until component did render */
-      run: async () => {
-        try {
-          await this.doTask();
-        }
-        catch (e) {
-          LogUtility.error('The auto task run failed.', e);
-        }
-      },
-    }, immediatelyRun);
-  }
-}
-__decorate$1([
-  MapToComponentMethod('componentDidUpdate')
-], AutoRunWhenReRenderTaskQueueSlimmer.prototype, "executeTaskHook", null);
-
 /**
  * Represents the state of the selection in the RTE.
  */
@@ -313,6 +268,19 @@ class SelectionController extends AutoRunWhenReRenderTaskQueueSlimmer {
   getSelectedNodes() {
     return Array.from(this.selectionMap.values()).flat();
   }
+  /**
+   * Set the selected rich text nodes
+   *
+   * @param {RTENode[]} nodes - The rich text nodes to set as selected
+   * @param {RTERangeOptions} [rangeOptions] - The range options to set the selection range
+   */
+  setSelectedNodes(nodes, rangeOptions) {
+    this.clearSelectionMap();
+    this.addNodesToSelectionMap(nodes);
+    if (rangeOptions) {
+      this.currentRange = this.currentRange.updateRTERange(rangeOptions);
+    }
+  }
   /**
    * Get the selected rich text blocks
    *
@@ -468,7 +436,16 @@ class SelectionController extends AutoRunWhenReRenderTaskQueueSlimmer {
       node.childNodes.forEach(filterNode);
     };
     filterNode(commonAncestor);
-    selectedNodes.forEach((node) => {
+    this.addNodesToSelectionMap(selectedNodes);
+    this.getSelectedNodes().forEach((node) => node.apply(new SelectionChangeAction(range)));
+  }
+  /**
+   * Add nodes to the selection map
+   *
+   * @param {RTENode[]} nodes - The rich text nodes to add
+   */
+  addNodesToSelectionMap(nodes) {
+    nodes.forEach((node) => {
       if (this.selectionMap.has(node.parent)) {
         this.selectionMap.get(node.parent).push(node);
       }
@@ -476,7 +453,6 @@ class SelectionController extends AutoRunWhenReRenderTaskQueueSlimmer {
         this.selectionMap.set(node.parent, [node]);
       }
     });
-    this.getSelectedNodes().forEach((node) => node.apply(new SelectionChangeAction(range)));
   }
   /**
    * Clear the selection map.
@@ -574,6 +550,9 @@ class SelectionController extends AutoRunWhenReRenderTaskQueueSlimmer {
           selectedNodes.push(startNode);
           this.currentRange = this.currentRange.updateRTERange({ startNode, endNode: startNode, startOffset, endOffset: startOffset }, range);
         }
+        else {
+          this.selectionMap.set(entity, []);
+        }
       }
     }
   }
@@ -727,4 +706,4 @@ class ComponentValueHistoryControllerSlimmer extends KeyboardManagerSlimmer {
   }
 }
 
-export { AutoRunWhenReRenderTaskQueueSlimmer as A, ComponentValueHistoryControllerSlimmer as C, RTESelectionState as R, ShadowSelectionPolyfill$1 as S, SelectionController as a };
+export { ComponentValueHistoryControllerSlimmer as C, RTESelectionState as R, ShadowSelectionPolyfill$1 as S, SelectionController as a };

package/dist/esm/{dto-renderer-manager-d413de1e.js → content-state-dad1fd71.js}

@@ -1,12 +1,12 @@
-import { f as ActionHandleStrategy, d as RTETextBlock, b as RTETextNode, g as AppendChildrenAction, A as ActionHandleStrategyRegistry, T as TextStyleAnnotationAction, B as BlockUpdateTextStyleStrategy, H as HorizontalAlignmentAnnotationAction, l as BlockUpdateHorizontalAlignmentStrategy, k as ModifyContentActionType, m as BlockInsertLineBreakStrategy, n as BlockInsertLineBreakWithBlocksStrategy, o as BlockSplitWithTextNodeStrategy, p as BlockReplaceNodesStrategy, q as BlockMergeNodesStrategy, I as InsertChildrenAfterAction, r as RemoveChildrenAction, S as SyncUpSelectionAction, i as InsertChildrenBeforeAction, t as BlockAnnotation, u as BlockAnnotationTypeEnum, c as RTEBlock, v as CustomStyleAnnotation, w as CustomClassAnnotation, C as CustomAttributeAnnotation, x as RTECodeBlock, s as stateEntityRenderingRegistry, N as NodeAnnotation, y as NodeAnnotationTypeEnum, z as RTEDecoratorNode, D as NodeTypeEnum, E as CommonAnnotation, F as AnnotationAction, G as ReplaceChildNodesAction, M as ModifyContentAction, J as SplitBlockWithNodeAction, K as BlockDeleteNodeContentStrategy, U as UpdateTextAction, L as RemoveChildrenStrategy, O as RTE_TEXT_COLORS, P as RTE_DEFAULT_TEXT_COLOR, R as RTEDTOClassManager } from './code-block-2408a812.js';
+import { f as ActionHandleStrategy, d as RTETextBlock, b as RTETextNode, g as AppendChildrenAction, A as ActionHandleStrategyRegistry, T as TextStyleAnnotationAction, o as BlockUpdateTextStyleStrategy, H as HorizontalAlignmentAnnotationAction, p as BlockUpdateHorizontalAlignmentStrategy, k as ModifyContentActionType, q as BlockInsertLineBreakStrategy, r as BlockInsertLineBreakWithBlocksStrategy, t as BlockSplitWithTextNodeStrategy, u as BlockReplaceNodesStrategy, v as BlockMergeNodesStrategy, I as InsertChildrenAfterAction, m as RemoveChildrenAction, S as SyncUpSelectionAction, i as InsertChildrenBeforeAction, B as BlockAnnotation, w as BlockAnnotationTypeEnum, c as RTEBlock, x as CustomStyleAnnotation, y as CustomClassAnnotation, n as CustomAttributeAnnotation, z as RTECodeBlock, s as stateEntityRenderingRegistry, N as NodeAnnotation, D as NodeAnnotationTypeEnum, E as RTEDecoratorNode, F as NodeTypeEnum, G as CommonAnnotation, l as AnnotationAction, J as ReplaceChildNodesAction, M as ModifyContentAction, K as SplitBlockWithNodeAction, L as BlockDeleteNodeContentStrategy, U as UpdateTextAction, O as RemoveChildrenStrategy, P as RTE_TEXT_COLORS, Q as RTE_DEFAULT_TEXT_COLOR, R as RTEDTOClassManager } from './code-block-58d1dbe5.js';
 import { g as generateUUID } from './misc-9fdbcfbb.js';
-import { i as isNonNullable } from './type-guard-af324dcd.js';
+import { i as isNonNullable } from './type-guard-c20cbbff.js';
 import { C as ChangeManager } from './change-manager-6a7eb88c.js';
-import { d as domNodeSubjectFactory } from './dom-node-subject-observer-factory-82f346e3.js';
-import { V as VegaInternalUpdateRTECursorPosition, a as VegaInternalRichTextEditorFlushChanges } from './vega-internal-event-id-799d012e.js';
+import { d as domNodeSubjectFactory } from './dom-node-subject-observer-factory-94b2e2c3.js';
+import { c as VegaInternalUpdateRTECursorPosition, d as VegaInternalRichTextEditorFlushChanges } from './vega-internal-event-id-8002b179.js';
 import { d as dashCaseToCamel } from './string-a953eafc.js';
-import { r as rgbToHex, i as isHTMLElement } from './ui-ee31416b.js';
-import { c as cleanObject } from './object-66c37948.js';
+import { r as rgbToHex, i as isHTMLElement } from './ui-ac244bf0.js';
+import { c as cleanObject } from './object-0c277f57.js';
 import { L as LogUtility } from './global-slimmer-registry-17c4efd4.js';
 
 /**
@@ -2559,6 +2559,16 @@ class HtmlElementToAnnotationGenerator {
       new InlineHtmlAnnotationHandler(),
     ];
   }
+  /**
+   * Register a custom annotation handler.
+   * Custom handlers are added to the beginning of the handlers array,
+   * giving them higher priority than default handlers.
+   *
+   * @param {AnnotationGeneratorStrategyAbstract} handler - The annotation handler to register.
+   */
+  registerHandler(handler) {
+    this.handlers.unshift(handler);
+  }
   /**
    * The function generates annotations for a given target DTO and HTML element based on a set of
    * strategies.
@@ -4043,59 +4053,4 @@ class VegaRTEContent {
   ActionHandleStrategyRegistry.register(ModifyContentActionType.UPDATE_CURSOR_POSITION, VegaRTEContent.name, new UpdateCursorPositionStrategy());
 })();
 
-/**
- * RTEDTORendererManager is a singleton class that manages the registration and retrieval of RTE DTO renderers.
- */
-class RTEDTORendererManager {
-  constructor() {
-    // Register RTE DTO renderers, mapping type strings to their respective renderer instances.
-    this.RTE_DTO_RENDERER_MAP = new Map();
-    // Register RTE Toolbar Button Renderers, mapping type strings to their respective renderer instances.
-    this.RTE_TOOLBAR_BUTTON_RENDERER_MAP = new Map();
-  }
-  /**
-   * Registers a new RTE DTO renderer.
-   *
-   * @param {string} type - The type identifier for the RTE DTO renderer.
-   * @param {VegaRTEBaseRenderer} RTEDTORenderer - The renderer instance for the RTE DTO.
-   */
-  registerRTEDTORenderer(type, RTEDTORenderer) {
-    const existRenderer = this.RTE_DTO_RENDERER_MAP.get(type);
-    if (RTEDTORenderer &&
-      existRenderer &&
-      existRenderer.constructor.name !== RTEDTORenderer.constructor.name) {
-      throw new Error(`Renderer for type ${type} is already registered with a different class(${existRenderer.constructor.name}).`);
-    }
-    this.RTE_DTO_RENDERER_MAP.set(type, RTEDTORenderer);
-  }
-  /**
-   * Registers a new RTE Toolbar Button Renderer.
-   *
-   * @param {string} type - The type identifier for the RTE Toolbar Button Renderer.
-   * @param {VegaRTEToolbarButtonRenderer} RTEToolbarButtonRenderer - The renderer instance for the RTE Toolbar Button.
-   */
-  registerRTEToolbarButtonRenderer(type, RTEToolbarButtonRenderer) {
-    this.RTE_TOOLBAR_BUTTON_RENDERER_MAP.set(type, RTEToolbarButtonRenderer);
-  }
-  /**
-   * Retrieves the RTE renderer for a given type.
-   *
-   * @param {string} type - The type identifier for the RTE block.
-   * @returns {Nullable<BaseRenderer>} - The renderer instance for the RTE block, or null if not found.
-   */
-  getRTERenderer(type) {
-    return this.RTE_DTO_RENDERER_MAP.get(type);
-  }
-  /**
-   * Retrieves the RTE Toolbar Button Renderer for a given type.
-   *
-   * @param {string} type - The type identifier for the RTE Toolbar Button Renderer.
-   * @returns {Nullable<VegaRTEToolbarButtonRenderer>} - The renderer instance for the RTE Toolbar Button, or null if not found.
-   */
-  getRTEToolbarButtonRenderer(type) {
-    return this.RTE_TOOLBAR_BUTTON_RENDERER_MAP.get(type);
-  }
-}
-const RTEDTORendererManager$1 = new RTEDTORendererManager();
-
-export { BlockToRTEBlockStrategyAbstract as B, ElementToDTOClassStrategyManager as E, InsertNewParagraphAction as I, MergeTwoBlocksNodesAction as M, RTEDTORendererManager$1 as R, StylePreservator as S, UpdateCursorPositionAction as U, VegaRTEContent as V, RTEDTOActionStrategyManager$1 as a, ElementToDTOStrategy as b, RTEImageBlock as c, RTEListItemBlock as d, RTEListBlock as e, RTEImageNode as f, ImageAnnotation as g, htmlElementToAnnotationGenerator as h, ElementToDtoStrategyProcessor$1 as i };
+export { AnnotationGeneratorStrategyAbstract as A, BlockToRTEBlockStrategyAbstract as B, ElementToDTOClassStrategyManager as E, InsertNewParagraphAction as I, MergeTwoBlocksNodesAction as M, PasteContentStrategy as P, RTEDTOActionStrategyManager$1 as R, StylePreservator as S, UpdateCursorPositionAction as U, VegaRTEContent as V, ElementToDTOStrategy as a, RTEImageBlock as b, InsertChildrenBeforeStrategy as c, RTEListItemBlock as d, RTEListBlock as e, RTEImageNode as f, ImageAnnotation as g, htmlElementToAnnotationGenerator as h, ElementToDtoStrategyProcessor$1 as i };

package/dist/esm/{date-required-rule-09d5aa16.js → date-required-rule-4c40a4eb.js}

@@ -1,4 +1,4 @@
-import { Q as isDateStr } from './type-guard-af324dcd.js';
+import { R as isDateStr } from './type-guard-c20cbbff.js';
 import { I as InternalFormFieldValidationRule } from './internal-form-field-validation-rule.abstract-f5b6bdbf.js';
 
 /**

package/dist/esm/{deprecated-property-slimmer-2c14df89.js → deprecated-property-slimmer-ea34fa7b.js}

@@ -1,6 +1,6 @@
 import { V as VegaSlimmer } from './global-slimmer-registry-17c4efd4.js';
 import { c as createDynamicSlimmer } from './dynamic-slimmer-90b8af32.js';
-import { g as getValueByPath, d as deepEqual } from './object-66c37948.js';
+import { g as getValueByPath, d as deepEqual } from './object-0c277f57.js';
 
 /** DeprecatedPropertySlimmer compares new property with default value, if they are different, return new property; otherwise, return old property */
 class DeprecatedPropertySlimmerBase extends VegaSlimmer {

package/dist/esm/{design-token-7dec1eab.js → design-token-9c4eb6b1.js}

@@ -1,9 +1,9 @@
-import { j as StateVariantFormatter, k as isBorderColorTokenType, b as BorderColors, e as BorderColorMap, l as isShadowsTokenType, f as Shadows, g as ShadowMap, m as isBorderTokenType, n as Borders, o as BorderMap, p as StateBackgroundColorFormatter, q as isSpacingTokenType, r as isBorderRadiusTokenType, s as isBackgroundColorTokenType, t as isTextColorTokenType, u as isBreakpointsTokenType, h as Spacing, v as isBorderStyleType, B as BorderRadius, C as Colors, w as isTypographyTokenType } from './type-guard-af324dcd.js';
+import { j as StateVariantFormatter, k as isBorderColorTokenType, b as BorderColors, e as BorderColorMap, l as isShadowsTokenType, f as Shadows, g as ShadowMap, m as isBorderTokenType, n as Borders, o as BorderMap, p as StateBackgroundColorFormatter, q as isSpacingTokenType, r as isBorderRadiusTokenType, s as isBackgroundColorTokenType, t as isTextColorTokenType, u as isBreakpointsTokenType, h as Spacing, v as isBorderStyleType, B as BorderRadius, C as Colors, w as isTypographyTokenType } from './type-guard-c20cbbff.js';
 import { B as Breakpoints } from './breakpoints-d9faf11c.js';
 import { L as LogUtility } from './global-slimmer-registry-17c4efd4.js';
-import { R as ResponsiveFormatFacade } from './responsive-format-facade-2a36c54a.js';
+import { R as ResponsiveFormatFacade } from './responsive-format-facade-e8534e59.js';
 import { a as TypographyKeys } from './typography-396de03f.js';
-import { B as BorderStyle } from './ui-28fd4193.js';
+import { B as BorderStyle } from './ui-93922c59.js';
 
 /**
  * The `StateBorderColorFormatter` class in TypeScript formats border color tokens based on