@heartlandone/vega 2.76.0 → 2.77.1

package/dist/types/components/vega-app-header-button/types.d.ts

@@ -1,4 +1,5 @@
 import { BackgroundColorsTokenType, TextColorsTokenType } from '../../types/design-token.type';
+import { ResponsiveType, SizeType } from '../../types/ui.type';
 
 /**
  * Configuration options for the dropdown used by the app header button.
@@ -60,3 +61,20 @@ export type VegaAppHeaderAvatarConfig = {
  * Allowed size values for the app header button.
  */
 export type VegaAppHeaderButtonSize = 'default' | 'small';
+
+/**
+ * Settings for the label displayed in the app header button.
+ *
+ * Allows providing configuration options for the label, such as max width and display rules.
+ */
+export type VegaAppHeaderLabelConfig = {
+	/**
+	 * Maximum width of the label.
+	 */
+	maxWidth?: ResponsiveType<SizeType>;
+
+	/**
+	 * Rule for how to display the label when it exceeds the maximum width. Can be 'ellipsis' or 'newline'.
+	 */
+	displayRule?: 'newline' | 'ellipsis';
+};

package/dist/types/components/vega-app-header-button/vega-app-header-button.d.ts

@@ -2,7 +2,7 @@ import { EventEmitter } from '../../stencil-public-runtime';
 import { BreakpointsTokenType } from '../../types/design-token.type';
 import { ResponsiveType } from '../../types/ui.type';
 import { GlobalSlimmers } from '../../vega-slimmer/vega-slimmer-core';
-import { VegaAppHeaderAvatarConfig, VegaAppHeaderButtonDropdownConfig, VegaAppHeaderButtonSize } from './types';
+import { VegaAppHeaderAvatarConfig, VegaAppHeaderButtonDropdownConfig, VegaAppHeaderButtonSize, VegaAppHeaderLabelConfig } from './types';
 import { PageResizeObserverSlimmer } from '../../helpers/slimmers/page-resize-observer-slimmer';
 import { ChildNodesEventPreventSlimmer } from '../../helpers/event-manager/slimmers/child-nodes-event-prevent-slimmer';
 import { EventEmitSlimmerBase } from '../../helpers/event-manager/slimmers/event-emit-slimmer';
@@ -48,6 +48,12 @@ export declare class VegaAppHeaderButton {
    * @vegaVersion 1.11.0
    */
   size: ResponsiveType<VegaAppHeaderButtonSize>;
+  /**
+   * Specifies the display configuration of the app header button label.
+   *
+   * @vegaVersion 2.77.1
+   */
+  labelConfig: VegaAppHeaderLabelConfig;
   /**
    * Specifies the label or text content of the app header button.
    *
@@ -142,6 +148,7 @@ export declare class VegaAppHeaderButton {
   reset: EventEmitter<string>;
   render(): VegaAppHeaderButton;
   private renderButton;
+  private renderButtonLabel;
   private renderAvatar;
   private renderFallbackTextAvatar;
   /**

package/dist/types/components/vega-button-circle/vega-button-circle.d.ts

@@ -6,6 +6,7 @@ import { GlobalSlimmers } from '../../vega-slimmer/vega-slimmer-core';
 import { EventEmitSlimmerBase } from '../../helpers/event-manager/slimmers/event-emit-slimmer';
 import { ChildNodesEventPreventSlimmer } from '../../helpers/event-manager/slimmers/child-nodes-event-prevent-slimmer';
 import { VegaComponentUsageRuntimeMetricsSlimmer } from '../../helpers/slimmers/component-usage-runtime-metrics';
+import { AriaAttributesValueMapper } from '../../helpers/slimmers/mutation-observer/aria-attributes-value-mapper';
 /**
  * @vegaVersion 1.0.2
  */
@@ -13,6 +14,7 @@ export declare class VegaButtonCircle {
   protected readonly globalSlimmers: GlobalSlimmers;
   protected clickEventEmitter: EventEmitSlimmerBase;
   protected eventPrevent: ChildNodesEventPreventSlimmer;
+  protected ariaAttributesValueMapper: AriaAttributesValueMapper;
   protected vegaComponentUsageRuntimeMetricsSlimmer: VegaComponentUsageRuntimeMetricsSlimmer<HTMLVegaButtonCircleElement>;
   host: HTMLVegaButtonCircleElement;
   /**

package/dist/types/components/vega-button-link/vega-button-link.d.ts

@@ -4,6 +4,7 @@ import { EventEmitSlimmerBase } from '../../helpers/event-manager/slimmers/event
 import { ChildNodesEventPreventSlimmer } from '../../helpers/event-manager/slimmers/child-nodes-event-prevent-slimmer';
 import { VegaComponentUsageRuntimeMetricsSlimmer } from '../../helpers/slimmers/component-usage-runtime-metrics';
 import { VegaButtonLinkTarget } from './types';
+import { AriaAttributesValueMapper } from '../../helpers/slimmers/mutation-observer/aria-attributes-value-mapper';
 /**
  * @vegaVersion 1.0.2
  */
@@ -13,6 +14,7 @@ export declare class VegaButtonLink {
   protected clickEventEmitter: EventEmitSlimmerBase;
   protected eventPrevent: ChildNodesEventPreventSlimmer;
   protected vegaComponentUsageRuntimeMetricsSlimmer: VegaComponentUsageRuntimeMetricsSlimmer<HTMLVegaButtonLinkElement>;
+  protected ariaAttributesValueMapper: AriaAttributesValueMapper;
   host: HTMLVegaButtonLinkElement;
   /**
    * Specifies the URL associated with the button link.

package/dist/types/components/vega-date-picker/slimmers/controllers/vega-date-picker-calendar-open-state-controller.d.ts

@@ -5,6 +5,9 @@ export declare class VegaDatePickerCalendarOpenStateController extends ElementAp
   dropdownConfig: VegaDatePicker['dropdownConfig'];
   vegaDatePickerRenderer: VegaDatePicker['vegaDatePickerRenderer'];
   vegaDatePickerCalendarRenderer: VegaDatePicker['vegaDatePickerCalendarRenderer'];
+  value: VegaDatePicker['value'];
+  format: VegaDatePicker['format'];
+  mode: VegaDatePicker['mode'];
   isCalendarShow: VegaDatePicker['isCalendarShow'];
   isMobileDevice: VegaDatePicker['isMobileDevice'];
   private clearCalendarStateTaskQueue;
@@ -45,6 +48,8 @@ export declare class VegaDatePickerCalendarOpenStateController extends ElementAp
   showCalendar(): Promise<void>;
   /**
    * Hide calendar in both mobile and desktop mode.
+   * After hiding, focuses the input container with a temporary
+   * aria-label so the screen reader announces the selection.
    */
   hideCalendar(): Promise<void>;
   /**
@@ -53,6 +58,22 @@ export declare class VegaDatePickerCalendarOpenStateController extends ElementAp
    * @param {boolean} isShow - is calendar show
    */
   updateIsCalendarShowState(isShow: boolean): void;
+  /**
+   * Focus the input container div with a temporary aria-label.
+   * VoiceOver always reads aria-label on programmatic .focus().
+   *
+   * The role, aria-label, and tabIndex attributes are set imperatively
+   * only during the announcement and removed on blur, so they don't
+   * interfere with VoiceOver navigation while the calendar is open.
+   */
+  private focusContainerWithAnnouncement;
+  /**
+   * Builds an aria announcement string based on the selected date value.
+   *
+   * @param {DatePickerValueType<DatePickerModeType>} value The date picker value to build announcement for
+   * @returns {string} The aria announcement string
+   */
+  private buildAriaAnnouncement;
   /**
    * Clear selecting state in calendar.
    */

package/dist/types/components/vega-date-picker/types.d.ts

@@ -1,3 +1,5 @@
+import { Nullable } from '../../types/general';
+
 /**
  * Modes supported by the date picker component.
  */
@@ -63,3 +65,15 @@ export type VegaDropdownPropsForDatePickerCalendar = Partial<
  * Size variants for the date picker calendar.
  */
 export type DatePickerCalendarSizeType = 'small' | 'regular' | 'large';
+
+/**
+ * Indicator function type for calendar dates, returning tooltip properties or null.
+ */
+export type DatePickerCalendarIndicatorTooltipProps = Partial<
+	Pick<HTMLVegaTooltipElement, 'text' | 'size' | 'maxWidth' | 'minWidth' | 'trigger'>
+>;
+
+/**
+ * Function type for providing date indicators in the calendar, returning tooltip properties or null for a given date.
+ */
+export type DatePickerCalendarIndicator = (date: Date) => Nullable<DatePickerCalendarIndicatorTooltipProps>;

package/dist/types/components/vega-date-picker/vega-date-picker-calendar/slimmers/controllers/vega-date-picker-calendar-selection-controller.d.ts

@@ -13,6 +13,7 @@ export declare class VegaDatePickerCalendarSelectionController extends VegaDateP
   clearEventEmitter: VegaDatePickerCalendar['clearEventEmitter'];
   vegaSelectionChangeEventEmitter: VegaDatePickerCalendar['vegaSelectionChangeEventEmitter'];
   allowRepickController: VegaDatePickerCalendar['allowRepickController'];
+  translationSlimmer: VegaDatePickerCalendar['translationSlimmer'];
   private previousCalendarSelection;
   /** componentWillLoad */
   componentWillLoad(): void;

package/dist/types/components/vega-date-picker/vega-date-picker-calendar/slimmers/renderers/vega-date-picker-calendar-renderer.d.ts

@@ -3,6 +3,7 @@ import { VegaDatePickerCalendar } from '../../vega-date-picker-calendar';
 export declare class VegaDatePickerCalendarRenderer extends VegaSlimmer {
   host: VegaDatePickerCalendar['host'];
   clearButton: VegaDatePickerCalendar['clearButton'];
+  calendarSelection: VegaDatePickerCalendar['calendarSelection'];
   monthItemRenderer: VegaDatePickerCalendar['monthItemRenderer'];
   staticHeight: VegaDatePickerCalendar['staticHeight'];
   translationSlimmer: VegaDatePickerCalendar['translationSlimmer'];
@@ -16,4 +17,10 @@ export declare class VegaDatePickerCalendarRenderer extends VegaSlimmer {
   private renderFooter;
   private shouldRenderRangeMonth;
   private clearCalendar;
+  /**
+   * Build aria announcement string based on current calendar selection.
+   *
+   * @returns {string} - Aria announcement string.
+   */
+  private buildAnnouncement;
 }

package/dist/types/components/vega-date-picker/vega-date-picker-calendar/slimmers/renderers/vega-date-picker-month-item-renderer.d.ts

@@ -14,12 +14,15 @@ export declare class VegaDatePickerMonthItemRenderer extends VegaSlimmer {
   mode: VegaDatePickerCalendar['mode'];
   size: VegaDatePickerCalendar['size'];
   isDateDisabled: VegaDatePickerCalendar['isDateDisabled'];
+  dateIndicator: VegaDatePickerCalendar['dateIndicator'];
   private isMobileDevice;
   private monthViewGenerator;
   render(type: DatePickerCalendarMonthRenderType): HTMLElement;
   private renderCurrentYearMonth;
   private renderWeek;
   private renderDays;
+  private renderItem;
+  private renderDayWithIndicator;
   private renderDay;
   private getCurrentRangeDates;
   private isBeforeMinDate;

package/dist/types/components/vega-date-picker/vega-date-picker-calendar/vega-date-picker-calendar.d.ts

@@ -3,7 +3,7 @@ import { GlobalSlimmers } from '../../../vega-slimmer/vega-slimmer-core';
 import { VegaComponentUsageRuntimeMetricsSlimmer } from '../../../helpers/slimmers/component-usage-runtime-metrics';
 import { VegaDatePickerCalendarRenderer } from './slimmers/renderers/vega-date-picker-calendar-renderer';
 import { VegaDatePickerCalendarYearMonthSwitcherRenderer } from './slimmers/renderers/vega-date-picker-calendar-year-month-switcher-renderer';
-import { DatePickerCalendarRepickType, DatePickerCalendarSizeType, DatePickerModeType, DatePickerMonthYearTypes, DatePickerValueType, VegaDropdownPropsForDatePickerCalendar } from '../types';
+import { DatePickerCalendarIndicator, DatePickerCalendarRepickType, DatePickerCalendarSizeType, DatePickerModeType, DatePickerMonthYearTypes, DatePickerValueType, VegaDropdownPropsForDatePickerCalendar } from '../types';
 import { TranslationSlimmer } from '../../../helpers/slimmers/translation/translation-slimmer';
 import { CalendarDate, MonthPeriod } from '../../../helpers/calendar';
 import { VegaDatePickerCalendarCurrentPeriodController } from './slimmers/controllers/vega-date-picker-calendar-current-period-controller';
@@ -138,6 +138,14 @@ export declare class VegaDatePickerCalendar {
    * @vegaVersion 2.72.0
    */
   isDateDisabled: DisabledDate;
+  /**
+   * Specifies a function that returns the properties for the date indicator tooltip for a given date in the date picker.
+   *
+   * The function is called for each date cell before rendering.
+   *
+   * @vegaVersion 2.77.0
+   */
+  dateIndicator: DatePickerCalendarIndicator;
   /**
    * An event emitter notifying the change of the value in the date picker,
    *    whether triggered programmatically or through user interaction.

package/dist/types/components/vega-dropdown/slimmers/controllers/vega-dropdown-appender-controller.d.ts

@@ -24,6 +24,7 @@ export declare class VegaDropdownAppenderController extends ElementAppenderSlimm
   hideEventEmitter: VegaDropdown['hideEventEmitter'];
   isScreenPosition: VegaDropdown['isScreenPosition'];
   private target;
+  private lastFocusedElement;
   /**
    * Component lifecycle - [componentDidLoad]{@link VegaPopover.connectedCallback}
    */
@@ -50,6 +51,16 @@ export declare class VegaDropdownAppenderController extends ElementAppenderSlimm
    * The function `userHide` hides a dropdown if it is currently being shown.
    */
   userHide(): void;
+  /**
+   * Restores focus to the dropdown trigger element.
+   * Should be called after programmatic hide actions (item selection, Escape, reset)
+   * to maintain proper screen reader context per WAI-ARIA menu button pattern.
+   */
+  private focusTriggerForAria;
+  /**
+   * Updates the last focused element by getting the currently active element in the shadow DOM.
+   */
+  private updateLastFocusedElement;
   /**
    * Generate the show configuration for the dropdown.
    *

package/dist/types/components/vega-input/slimmers/controllers/vega-input-render-mode-controller.d.ts

@@ -5,7 +5,6 @@ export declare class VegaInputRenderModeController extends VegaSlimmer {
   host: VegaInput['host'];
   suggestionsDropdownSource: VegaInput['suggestionsDropdownSource'];
   private hasItemsSlot;
-  private hasDropdownSource;
   /** Sets the render mode based on the presence of the items slot. */
   connectedCallback(): void;
   /**

package/dist/types/components/vega-input/slimmers/renderers/vega-input-input-renderer.d.ts

@@ -5,7 +5,6 @@ export declare class VegaInputInputRenderer extends VegaSlimmer {
   private value;
   private disabled;
   private type;
-  private label;
   private name;
   private autocomplete;
   private inputmode;

package/dist/types/components/vega-input/vega-input.d.ts

@@ -21,11 +21,15 @@ import { VegaInputValueController } from './slimmers/controllers/vega-input-valu
 import { VegaInputInputSuggestionsRenderer } from './slimmers/renderers/vega-input-input-suggestions-renderer';
 import { VegaDropdownSourceItem } from '../vega-dropdown/types';
 import { VegaInputRenderModeController } from './slimmers/controllers/vega-input-render-mode-controller';
+import { AriaAttributesValueMapper } from '../../helpers/slimmers/mutation-observer/aria-attributes-value-mapper';
+import { DataTabIndexValueMapper } from '../../helpers/slimmers/mutation-observer/data-tab-index-value-mapper';
 /**
  * @vegaVersion 1.0.5
  */
 export declare class VegaInput {
   protected readonly globalSlimmers: GlobalSlimmers;
+  protected ariaAttributesValueMapper: AriaAttributesValueMapper;
+  protected dataTabIndexValueMapper: DataTabIndexValueMapper;
   protected readonly formFieldController: FormFieldControllerSlimmer<string>;
   protected readonly pageResizeObserverSlimmer: PageResizeObserverSlimmer;
   protected renderModeController: VegaInputRenderModeController;

package/dist/types/components/vega-input-passcode/slimmers/renderers/vega-input-passcode-renderer.d.ts

@@ -26,5 +26,19 @@ export declare class VegaInputPasscodeRenderer extends VegaSlimmer {
   private handleVegaBlur;
   private handleVegaChange;
   private handleVegaPaste;
+  /**
+   * Find the index of the first empty input box for rendering purposes. If all boxes are filled, return -1.
+   *
+   * @param {number} inputLength - the input length of the passcode, which is also the number of input boxes to render
+   * @returns {number} - the index of the first empty input box, or -1 if all boxes are filled
+   */
+  private getFirstEmptyIndexForRender;
+  /**
+   * Determine whether the input box at the given index should be accessible to screen readers. Only the boxes up to and including the first empty box should be accessible, as screen readers will read out all accessible boxes and we don't want them to read out empty boxes that come before filled boxes.
+   *
+   * @param {number} index - the index of the input box to check
+   * @returns {boolean} - true if the input box should be accessible to screen readers, false otherwise
+   */
+  private isInputAccessibleForScreenReader;
   private generateNewInputValue;
 }

package/dist/types/components/vega-rich-text-content/slimmers/renderers/vega-rich-text-content-renderer.d.ts

@@ -21,4 +21,10 @@ export declare class VegaRichTextContentRenderer extends VegaSlimmer {
   private renderRichTextContent;
   private renderContent;
   private shouldShowPlaceholder;
+  /**
+   * Inject the reference of rich text editor into render context for the usage of extensions.
+   *
+   * @param {RTERenderContext} renderContext - The render context which may contain the host reference.
+   */
+  private injectRTERefIntoContext;
 }

package/dist/types/components/vega-rich-text-editor/extensions/base-extension-renderer.d.ts

@@ -3,7 +3,7 @@ import { Nullable } from '../../../types/general';
 import { RTEBlock } from '../dto/blocks/block.abstract';
 import { RTENode } from '../dto/nodes/node.abstract';
 import { VegaRTEBaseRenderer } from '../dto/renderers/base-renderer';
-import { RTERenderContext, VegaRTECreateElementFunction, VegaRTERenderResult } from '../interface';
+import { RTEExtensionContext, RTERenderContext, VegaRTECreateElementFunction, VegaRTERenderResult } from '../interface';
 declare type VegaRTEUseRef = (element: HTMLElement) => void;
 /**
  * Base renderer for Vega Rich Text Editor.
@@ -40,6 +40,14 @@ export declare abstract class VegaRTEExtensionRenderer extends VegaRTEBaseRender
    * @returns {Nullable<BaseRenderer>} - The registered renderer or null if not found.
    */
   protected getDTORenderer(key: string): Nullable<BaseRenderer>;
+  /**
+   * Get the extension context for the given rich text editor host element.
+   *
+   * @typedef HTMLVegaRichTextEditorElement - The type definition for the rich text editor host element.
+   * @param {HTMLVegaRichTextEditorElement} el - The host rich text editor element.
+   * @returns {Nullable<RTEExtensionContext>} - The extension context associated with the host.
+   */
+  protected getExtensionContext(el?: HTMLVegaRichTextEditorElement): Nullable<RTEExtensionContext>;
   /**
    * Auto render the block children if the block element is not exist
    *

package/dist/types/components/vega-rich-text-editor/extensions/base-toolbar-button-renderer.d.ts

@@ -1,5 +1,5 @@
 import { Nullable } from '../../../types/general';
-import { VegaRTECreateElementFunction, VegaRTEToolbarRenderContext, VegaRTERenderResult, RTEToolbarDropdownProps, RTEDropdownListItem, RTEToolbarButtonProps, RTEDropdownListGroup } from '../interface';
+import { VegaRTECreateElementFunction, VegaRTEToolbarRenderContext, VegaRTERenderResult, RTEToolbarDropdownProps, RTEDropdownListItem, RTEToolbarButtonProps, RTEDropdownListGroup, RTEExtensionContext } from '../interface';
 /**
  * Base class for rendering extension toolbar button in the rich text editor.
  * The renderer provides common functionalities for rendering toolbar buttons, including:
@@ -26,6 +26,14 @@ export declare abstract class VegaRTEToolbarButtonRenderer {
    * @returns {VegaRTERenderResult} Toolbar button.
    */
   abstract render(createElement: VegaRTECreateElementFunction, editorContext?: VegaRTEToolbarRenderContext): VegaRTERenderResult;
+  /**
+   * Get the extension context for the given rich text editor host element.
+   *
+   * @typedef HTMLVegaRichTextEditorElement - The type definition for the rich text editor host element.
+   * @param {HTMLVegaRichTextEditorElement} el - The host rich text editor element.
+   * @returns {Nullable<RTEExtensionContext>} - The extension context associated with the host.
+   */
+  protected getExtensionContext(el: HTMLVegaRichTextEditorElement): Nullable<RTEExtensionContext>;
   /**
    * Renders a dropdown component with the specified properties and children.
    *

package/dist/types/components/vega-rich-text-editor/extensions/functions/function-extension.d.ts

@@ -1,17 +1,10 @@
 import { VegaRTEExtension } from '../extension.abstract';
-import { RTEExtensionContext } from '../../interface';
 /**
  * Function extension class for Vega Rich Text Editor.
  */
 export declare class VegaRTEFunctionExtension extends VegaRTEExtension {
   private toolbarButtonRenderer;
   constructor();
-  /**
-   * Initializes the extension with the given context
-   *
-   * @param {RTEExtensionContext} context - extension context
-   */
-  initialExtension(context: RTEExtensionContext): void;
   /**
    * Remove the appen children strategies to prevent default insert new paragraph logic in function block
    */

package/dist/types/components/vega-rich-text-editor/extensions/functions/renderers/function-toolbar-button-renderer.d.ts

@@ -1,4 +1,4 @@
-import { VegaRTECreateElementFunction, VegaRTEToolbarRenderContext, VegaRTERenderResult, RTEDropdownListItem, RTEExtensionContext } from '../../../interface';
+import { VegaRTECreateElementFunction, VegaRTEToolbarRenderContext, VegaRTERenderResult, RTEDropdownListItem } from '../../../interface';
 import { VegaRTEToolbarButtonRenderer } from '../../base-toolbar-button-renderer';
 import { RTEExtensionFunctionType } from '../actions/insert-function-block-action';
 /**
@@ -6,13 +6,6 @@ import { RTEExtensionFunctionType } from '../actions/insert-function-block-actio
  */
 export declare class FunctionToolbarButtonRenderer extends VegaRTEToolbarButtonRenderer {
   static FUNCTION_LIST: RTEDropdownListItem[];
-  private extensionContext?;
-  /**
-   * Injects the extension context
-   *
-   * @param {RTEExtensionContext} context - extension context
-   */
-  injectExtensionContext(context: RTEExtensionContext): void;
   /**
    * @inheritDoc
    */
@@ -20,14 +13,16 @@ export declare class FunctionToolbarButtonRenderer extends VegaRTEToolbarButtonR
   /**
    * Overrides the isDisabled method to determine if the button should be disabled.
    *
+   * @param {VegaRTEToolbarRenderContext} editorContext The render context for the editor.
    * @returns {boolean} - true if the button should be disabled, false otherwise.
    */
-  protected isDisabled(): boolean;
+  protected isDisabled(editorContext: VegaRTEToolbarRenderContext): boolean;
   protected handleButtonClick(): void;
   /**
    * Handles dropdown click event
    *
    * @param {RTEExtensionFunctionType} itemKey - key of the clicked item
+   * @param {VegaRTEToolbarRenderContext} editorContext The render context for the editor.
    */
-  protected handleDropdownClick(itemKey: RTEExtensionFunctionType): void;
+  protected handleDropdownClick(itemKey: RTEExtensionFunctionType, editorContext?: VegaRTEToolbarRenderContext): void;
 }

package/dist/types/components/vega-rich-text-editor/extensions/tokens/token-extension.d.ts

@@ -1,4 +1,4 @@
-import { RTEExtensionContext, RTEDropdownListGroup, RTEDropdownListItem } from '../../interface';
+import { RTEDropdownListGroup, RTEDropdownListItem } from '../../interface';
 import { VegaRTEExtension } from '../extension.abstract';
 /**
  * Vega Rich Text Editor Token Extension
@@ -7,8 +7,4 @@ export declare class VegaRTETokenExtension extends VegaRTEExtension {
   private tokenRenderer;
   private tokenToolbarButtonRenderer;
   constructor(tokenList?: (RTEDropdownListItem | RTEDropdownListGroup)[]);
-  /**
-   * @inheritDoc
-   */
-  initialExtension(context: RTEExtensionContext): void;
 }

package/dist/types/components/vega-rich-text-editor/extensions/tokens/token-node-renderer.d.ts

@@ -1,11 +1,10 @@
-import { RTEExtensionContext, RTERenderContext, VegaRTECreateElementFunction, VegaRTERenderResult } from '../../interface';
+import { RTERenderContext, VegaRTECreateElementFunction, VegaRTERenderResult } from '../../interface';
 import { VegaRTEExtensionRenderer } from '../base-extension-renderer';
 import { RTETokenNode } from './token-node';
 /**
  * Token node renderer for the rich text editor.
  */
 export declare class RTETokenNodeRenderer extends VegaRTEExtensionRenderer {
-  private extensionContext;
   /**
    * Renders the token node as a DOM element.
    *
@@ -15,12 +14,6 @@ export declare class RTETokenNodeRenderer extends VegaRTEExtensionRenderer {
    * @returns {VegaRTERenderResult} - The rendered DOM element.
    */
   doRender(createElement: VegaRTECreateElementFunction, node: RTETokenNode, editorContent?: RTERenderContext): VegaRTERenderResult;
-  /**
-   * Sets the RTE extension context.
-   *
-   * @param {RTEExtensionContext} context - The context of the RTE extension.
-   */
-  injectExtensionContext(context: RTEExtensionContext): void;
   /**
    * Override to inject RTE scope styles for the token node.
    *
@@ -30,8 +23,10 @@ export declare class RTETokenNodeRenderer extends VegaRTEExtensionRenderer {
   /**
    * Handle the click event on the token element.
    *
+   * @typedef HTMLVegaRichTextEditorElement - The type definition for the rich text editor host element.
    * @param {MouseEvent} event - The click event.
    * @param {RTETokenNode} node - The token node that was clicked.
+   * @param {HTMLVegaRichTextEditorElement} [richTextEditor] - The rich text editor host element.
    */
   private handleTokenElementClick;
   /**

package/dist/types/components/vega-rich-text-editor/extensions/tokens/token-toolbar-button-renderer.d.ts

@@ -1,18 +1,11 @@
-import { RTEExtensionContext, VegaRTECreateElementFunction, VegaRTEToolbarRenderContext, VegaRTERenderResult, RTEDropdownListItem, RTEDropdownListGroup } from '../../interface';
+import { VegaRTECreateElementFunction, VegaRTEToolbarRenderContext, VegaRTERenderResult, RTEDropdownListItem, RTEDropdownListGroup } from '../../interface';
 import { VegaRTEToolbarButtonRenderer } from '../base-toolbar-button-renderer';
 /**
  * Renderer for the token toolbar button in the Vega Rich Text Editor.
  */
 export declare class RTETokenToolbarButtonRenderer extends VegaRTEToolbarButtonRenderer {
   private tokenList;
-  private extensionContext;
   constructor(tokenList: (RTEDropdownListItem | RTEDropdownListGroup)[]);
-  /**
-   * Sets the RTE extension context.
-   *
-   * @param {RTEExtensionContext} context - The context of the RTE extension.
-   */
-  injectExtensionContext(context: RTEExtensionContext): void;
   /**
    * Renders the token toolbar button.
    *
@@ -24,9 +17,10 @@ export declare class RTETokenToolbarButtonRenderer extends VegaRTEToolbarButtonR
   /**
    * Checks if the token toolbar button is disabled.
    *
+   * @param {VegaRTEToolbarRenderContext} editorContext The render context for the editor.
    * @returns {boolean} True if the button is disabled, false otherwise.
    */
-  protected isDisabled(): boolean;
+  protected isDisabled(editorContext: VegaRTEToolbarRenderContext): boolean;
   /**
    * Handles the button click event. No need this method for token button.
    *
@@ -42,6 +36,8 @@ export declare class RTETokenToolbarButtonRenderer extends VegaRTEToolbarButtonR
   protected handleDropdownClick(itemKey: string, editorContext: VegaRTEToolbarRenderContext): void;
   /**
    * Refreshes the editor UI.
+   *
+   * @param {VegaRTEToolbarRenderContext} editorContext - The render context for the editor.
    */
   private flushEditorUI;
 }

package/dist/types/components/vega-rich-text-editor/helpers/extension-context-manager.d.ts

@@ -0,0 +1,26 @@
+import { Nullable } from '../../../types/general';
+import { RTEExtensionContext } from '../interface';
+/**
+ * Manager for storing and retrieving the extension context associated with each rich text editor host element.
+ *
+ * @todo Currently, there are three types of contexts in RTE: toolbar render context, extension context, and DTO render context. The second and third types are bound to the extension context via host props. We are considering optimizing these three types of contexts to make the program more flexible and easier to maintain.
+ */
+declare class RTEExtensionContextManager {
+  private extensionContextMap;
+  /**
+   * Store the extension context for the given rich text editor host element.
+   *
+   * @param {RTEExtensionContext} context - The extension context to store.
+   */
+  setExtensionContext(context: RTEExtensionContext): void;
+  /**
+   * Get the extension context for the given rich text editor host element.
+   *
+   * @typedef HTMLVegaRichTextEditorElement - The type definition for the rich text editor host element.
+   * @param {Nullable<HTMLVegaRichTextEditorElement>} el - The host rich text editor element.
+   * @returns {Nullable<RTEExtensionContext>} - The extension context associated with the host.
+   */
+  getExtensionContext(el: Nullable<HTMLVegaRichTextEditorElement>): Nullable<RTEExtensionContext>;
+}
+declare const _default: RTEExtensionContextManager;
+export default _default;

package/dist/types/components/vega-rich-text-editor/helpers/extension-context-manager.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/components/vega-rich-text-editor/interface.d.ts

@@ -549,6 +549,10 @@ export type RTERenderContext = {
 	 * If `false`, use CSS classes for integration within the RTE content view.
 	 */
 	standalone?: boolean;
+	/**
+	 * Host rich text editor element reference.
+	 */
+	host?: HTMLVegaRichTextEditorElement;
 } & Partial<Pick<VegaRTETransformOptions, 'autoMatchFormat'>>;
 
 /**

package/dist/types/components/vega-rich-text-editor/slimmers/controllers/insert-image-controller.d.ts

@@ -1,6 +1,9 @@
 import { VegaSlimmer } from '../../../../vega-slimmer/vega-slimmer-core';
 import { VegaRichTextEditor } from '../../vega-rich-text-editor';
+import { RTEBlock } from '../../dto/blocks/block.abstract';
 import { RTEImageNode } from '../../dto/nodes/image-node';
+import { RTENode } from '../../dto/nodes/node.abstract';
+import { RTERange } from '../../dto/range';
 /** Used to control the insert image tool button actions */
 export declare class InsertImageController extends VegaSlimmer {
   protected selectionController: VegaRichTextEditor['selectionController'];
@@ -11,9 +14,12 @@ export declare class InsertImageController extends VegaSlimmer {
    * Insert a image to current state
    *
    * @param {string} imageUrl The image url
+   * @param {RTEBlock[]} selectedBlocks The current selected blocks, if not provided, will get from selectionController
+   * @param {RTENode[]} selectedNodes The current selected nodes, if not provided, will get from selectionController
+   * @param {RTERange} currentRange The current selected range, if not provided, will get from selectionController
    * @returns {RTEImageNode} RTEImageNode
    */
-  insertImageToCaretPosition(imageUrl: string): RTEImageNode;
+  insertImageToCaretPosition(imageUrl: string, selectedBlocks?: RTEBlock[], selectedNodes?: RTENode[], currentRange?: RTERange): RTEImageNode;
   /**
    * Add image selected observer
    */

package/dist/types/components/vega-rich-text-editor/slimmers/renderers/tools/image-toolbar-button-slimmer.d.ts

@@ -1,20 +1,48 @@
 import { ToolbarInternalButtonConfig } from './toolbar-button-slimmer.abstract';
 import { VegaRichTextEditor } from '../../../vega-rich-text-editor';
 import { VisualModeToolbarButtonSlimmer } from './visual-mode-toolbar-button-slimmer.abstract';
+export declare type InsertImageType = 'upload' | 'url';
+export declare type InsertImageItem = {
+  key: InsertImageType;
+  label: string;
+};
+export declare type InsertURLForm = {
+  url: string;
+};
 export declare class ImageToolbarButtonSlimmer extends VisualModeToolbarButtonSlimmer {
+  private static readonly items;
   protected insertImageController: VegaRichTextEditor['insertImageController'];
   protected imageInsertedEventEmitter: VegaRichTextEditor['imageInsertedEventEmitter'];
   protected selectionController: VegaRichTextEditor['selectionController'];
-  private inputElementRef;
+  private uploadInputRef;
+  private dropdownRef;
+  private insertURLInputRef;
+  private insertURLModalRef;
   private updateNodeURLMap;
+  private currentRange;
+  private currentSelectedBlocks;
+  private currentSelectedNodes;
   constructor();
   protected renderBtnWrapper(renderBtn: (toolbarInternalButton: ToolbarInternalButtonConfig) => HTMLElement): HTMLElement;
-  protected onClick: () => void;
   protected isSelected(): boolean;
   protected isDisabled(): boolean;
+  private renderDropdownContent;
+  private renderUploadInput;
+  private renderInsertURLModal;
+  private addDropdownObserver;
+  private addModalCancelObserver;
+  private addModalInsertObserver;
+  private insertURLImage;
+  private handleDropdownItemClick;
   /**
    * The below method is e2e-test covered in
    * @see{module:should-update-url-properly-when-upload-images}
    */
   private fileInputChange;
+  /**
+   * The below method is e2e-test covered in
+   * @see{module:should-update-url-properly-when-upload-images}
+   */
+  private applyImageNode;
+  private normalizeSafeImageUrl;
 }