@heartlandone/vega 2.81.0 → 2.83.0

package/dist/types/components.d.ts

@@ -24,6 +24,7 @@ import { CalendarEvent } from "./helpers/calendar/calendar-event";
 import { FormFieldValidationRule } from "./helpers/validator/rules/form-field-validation-rule";
 import { VegaChipIconAlign, VegaChipSize, VegaChipType, VegaChipVariant } from "./components/vega-chip/types";
 import { VegaCodeBlockValue } from "./components/vega-code-block/types";
+import { VegaColorSwatchShape, VegaColorSwatchSize, VegaColorSwatchVariant } from "./components/vega-color-swatch/types";
 import { VegaComboBoxSize, VegaDropdownPropsForComboBox } from "./components/vega-combo-box/types";
 import { DatePickerCalendarIndicator, DatePickerCalendarRepickType, DatePickerCalendarSizeType, DatePickerModeType, DatePickerMonthYearTypes, DatePickerValueType, DropdownConfigForDatePicker, VegaDropdownPropsForDatePickerCalendar } from "./components/vega-date-picker/types";
 import { VegaDialogAction, VegaDialogActionButtonProps } from "./components/vega-dialog/types";
@@ -39,7 +40,7 @@ import { DataTransferType, InputAutocompleteTypes, InputEnterKeyHintTypes, Input
 import { FormFieldValidationRule as FormFieldValidationRule1 } from "./types/components.type";
 import { VegaCountryType } from "./components/vega-input-phone-number/types";
 import { InputRangeStackType, InputRangeValueType } from "./components/vega-input-range/types";
-import { SelectedLabelType, SelectedLabelTypeForAllModes, SelectSourceItem, SelectType, SelectValueType, VegaDropdownPropsForSelect, VegaInputSelectSize, VegaInputSelectSourceLazyLoadCallback } from "./components/vega-input-select/types";
+import { SelectedLabelType, SelectedLabelTypeForAllModes, SelectSourceItem, SelectType, SelectValueType, VegaDropdownPropsForSelect, VegaInputSelectDropdownTooltipProps, VegaInputSelectSize, VegaInputSelectSourceLazyLoadCallback, VegaInputSelectTooltipProps } from "./components/vega-input-select/types";
 import { ItemToggleStatusMap } from "./components/vega-item-toggle/types";
 import { autoCollapseGroupsType, LeftNavCounterBadgeConfig, LeftNavHeaderConfig, LeftNavSectionHeaderConfig, LeftNavSourceItem } from "./components/vega-nav/interface";
 import { LineChartOptionsType } from "./helpers/chart/line-chart";
@@ -51,7 +52,7 @@ import { PieChartOptions } from "./helpers/chart/pie-chart";
 import { VegaProgressTrackerDirectionType, VegaProgressTrackerStepItem } from "./components/vega-progress-tracker/type";
 import { VegaRTEContent } from "./components/vega-rich-text-editor/dto/content-state";
 import { VegaRTEExtension } from "./components/vega-rich-text-editor/extensions/extension.abstract";
-import { RTETablePropertiesType, TableCellStylePropertiesMap, VegaRichTextEditorImage, VegaRTEColorSchema, VegaRTESourceEditConfig, VegaRTEToolbarItem } from "./components/vega-rich-text-editor/interface";
+import { RTETablePropertiesType, TableCellStylePropertiesMap, VegaRichTextEditorImage, VegaRTEColorSchema, VegaRTESourceEditConfig, VegaRTETextStyleItem, VegaRTEToolbarItem } from "./components/vega-rich-text-editor/interface";
 import { VegaRichTextImageEditorChangeDetail, VegaRichTextImageEditorSizeType } from "./components/vega-rich-text-editor/vega-rich-text-image-editor/types";
 import { VegaRichTextLinkEditorChangeDetail, VegaRichTextLinkEditorStatus, VegaRTELinkEditorRecord } from "./components/vega-rich-text-editor/vega-rich-text-link-editor/types";
 import { RTETableCellBlock } from "./components/vega-rich-text-editor/extensions/table/dto/table-cell-block";
@@ -261,7 +262,7 @@ export namespace Components {
          */
         "bannerTitle": string;
         /**
-          * Specifies the content displayed within the banner.
+          * Specifies the content displayed within the banner. Also supports slot-based content: place a child element with `slot="content"` inside the banner to render rich HTML content. The slot takes precedence over this property.
           * @vegaVersion 2.8.0
          */
         "content": string;
@@ -838,6 +839,11 @@ export namespace Components {
           * @vegaVersion 1.10.0
          */
         "identifier": string;
+        /**
+          * Specifies whether the checkbox is in an indeterminate state.  The indeterminate state is a visual-only state typically used to represent    a checkbox whose value is neither fully checked nor fully unchecked,    such as a "select all" control where only some children are selected.  Setting this property does not affect the `checked` or `value` properties.    User interaction (clicking) will clear the indeterminate state and    toggle `checked` as usual.
+          * @vegaVersion 2.83.0
+         */
+        "indeterminate": boolean;
         /**
           * Specifies the validation status of the checkbox component.
           * @vegaVersion 1.10.0
@@ -1016,6 +1022,11 @@ export namespace Components {
           * @vegaVersion 1.13.0
          */
         "colors": string[];
+        /**
+          * Specifies the maximum number of color swatches displayed per row.  When the number of `colors` exceeds `columns`, the remaining swatches    wrap to additional rows. For example, `columns={5}` with 10 colors    renders 2 rows of 5 swatches.  Defaults to `8` to preserve the original single-row layout for the    default 8-color palette.
+          * @vegaVersion 2.82.0
+         */
+        "columns": number;
         /**
           * Specifies whether the color picker element is disabled.
           * @vegaVersion 1.13.0
@@ -1057,6 +1068,43 @@ export namespace Components {
          */
         "value": string;
     }
+    interface VegaColorSwatch {
+        /**
+          * Specifies the CSS color value for the swatch (e.g. '#841AC1', 'rgb(15, 137, 82)', 'rgba(15, 137, 82, 0.5)'). Applies only when `variant` is set to 'swatch'.
+          * @vegaVersion 2.82.0
+         */
+        "color": string;
+        /**
+          * Specifies whether the swatch is disabled.
+          * @vegaVersion 2.82.0
+         */
+        "disabled": boolean;
+        /**
+          * Specifies the label or title for the swatch.    It provides descriptive text that helps identify the purpose or content expected in the swatch.
+          * @vegaVersion 2.82.0
+         */
+        "label": string;
+        /**
+          * Indicates whether the swatch is currently selected. When selected, a check mark is shown, and its color automatically adjusts to maintain contrast against the swatch color.
+          * @vegaVersion 2.82.0
+         */
+        "selected": boolean;
+        /**
+          * Controls the outer shape of the swatch. - 'basket': Rounded corners for spaced layouts. - 'block': Square corners for dense or flush layouts.
+          * @vegaVersion 2.82.0
+         */
+        "shape": VegaColorSwatchShape;
+        /**
+          * Specifies the size of the swatch.
+          * @vegaVersion 2.82.0
+         */
+        "size": VegaColorSwatchSize;
+        /**
+          * Specifies the visual style and prominence of the swatch.    It determines how the swatch will be presented to the user. - 'swatch': Displays the color fill. - 'clear': Displays a diagonal line to indicate no color (clear selection).
+          * @vegaVersion 2.82.0
+         */
+        "variant": VegaColorSwatchVariant;
+    }
     interface VegaComboBox {
         /**
           * Determines whether automatic validation should be implemented    when a value is edited in the combo box.
@@ -1478,6 +1526,11 @@ export namespace Components {
           * @vegaVersion 1.13.0
          */
         "itemDisplayRule": 'ellipsis' | 'newline';
+        /**
+          * Provides tooltip configuration options for dropdown items.  Useful for controlling tooltip width for long item labels.
+          * @vegaVersion 2.82.0
+         */
+        "itemTooltipProps": Partial<Pick<HTMLVegaTooltipElement, 'placement' | 'maxWidth' | 'minWidth'>>;
         /**
           * Determines if the dropdown height should be automatically adjusted    to fit its container height.  If set to `true`, the dropdown will always be positioned at    the bottom of the available space.
           * @vegaVersion 1.3.0
@@ -2678,6 +2731,11 @@ export namespace Components {
           * @vegaVersion 1.0.7
          */
         "doOpen": () => Promise<void>;
+        /**
+          * Provides tooltip configuration for dropdown items.  Use this to control tooltip placement and width for long item labels.
+          * @vegaVersion 2.82.0
+         */
+        "dropdownItemTooltipProps": VegaInputSelectDropdownTooltipProps;
         /**
           * Provides a supplementary prompt message that assists users in    understanding the expected value for the input select field.
           * @vegaVersion 1.3.0
@@ -2723,6 +2781,11 @@ export namespace Components {
           * @vegaVersion 1.35.0
          */
         "selectedLabel": SelectedLabelType | SelectedLabelTypeForAllModes;
+        /**
+          * Provides tooltip configuration for the selected label text.  Use this to control tooltip placement, width, and other display properties.
+          * @vegaVersion 2.82.0
+         */
+        "selectedLabelTooltipProps": VegaInputSelectTooltipProps;
         /**
           * Defines the size of the input select field.
           * @vegaVersion 1.18.0
@@ -3247,6 +3310,12 @@ export namespace Components {
         "showArrow": boolean;
     }
     interface VegaProgressTracker {
+        /**
+          * When enabled, `current = -1` becomes a valid state that indicates    no highlighted/current step (e.g. all steps are pending or the    workflow has not started).  Two ways to enter this state: - Set the `current` prop to `-1`. - Call the `setCurrent(-1)` method.
+          * @VegaHint `prevStep()` still clamps at `0` and will not take `current` into `-1`.
+          * @vegaVersion 2.82.0
+         */
+        "allowNoCurrentStep": boolean;
         /**
           * Enables the ability to click on the steps in    the Progress Tracker component.
           * @vegaVersion 1.5.0
@@ -3463,6 +3532,12 @@ export namespace Components {
           * @vegaVersion 2.59.0
          */
         "sourceEditConfig": VegaRTESourceEditConfig;
+        /**
+          * Specifies which text style items appear in the Text Styles toolbar dropdown.  Use this to control which heading levels and text styles are available to users. For example, omit `{ key: 'heading-1' }` to prevent users from applying H1 (which is typically reserved for the page title).  Items are displayed in a fixed internal order regardless of the order in this array.
+          * @vegaVersion 2.83.0
+          * @defaultValue [{ key: 'title' }, { key: 'subtitle' }, { key: 'heading-1' }, { key: 'heading-2' }, { key: 'heading-3' }, { key: 'paragraph' }]
+         */
+        "textStyleItems": VegaRTETextStyleItem[];
         /**
           * Specifies the built-in toolbar items available in the rich-text editor.
           * @vegaVersion 2.34.0
@@ -4675,7 +4750,7 @@ export namespace Components {
          */
         "size": ResponsiveType<SizeType>;
         /**
-          * Specifies the text that is displayed    inside the tooltip.
+          * Specifies the text that is displayed    inside the tooltip.  Line breaks (`\n`) are supported and rendered as new lines. Consecutive regular spaces are collapsed; to preserve indentation (e.g. hanging indent for bullet lists) use the non-breaking space character `\u00A0`.
           * @vegaVersion 2.0.0
          */
         "text": string;
@@ -4687,7 +4762,7 @@ export namespace Components {
     }
     interface VegaTooltipContentBox {
         /**
-          * Specifies the text that is displayed inside the tooltip.
+          * Specifies the text that is displayed inside the tooltip.  Line breaks (`\n`) are supported and rendered as new lines. Consecutive regular spaces are collapsed; to preserve indentation (e.g. hanging indent for bullet lists) use the non-breaking space character `\u00A0`.
           * @vegaVersion 2.0.0
          */
         "text": string;
@@ -4799,6 +4874,10 @@ export interface VegaColorPickerCustomEvent<T> extends CustomEvent<T> {
     detail: T;
     target: HTMLVegaColorPickerElement;
 }
+export interface VegaColorSwatchCustomEvent<T> extends CustomEvent<T> {
+    detail: T;
+    target: HTMLVegaColorSwatchElement;
+}
 export interface VegaComboBoxCustomEvent<T> extends CustomEvent<T> {
     detail: T;
     target: HTMLVegaComboBoxElement;
@@ -5150,6 +5229,12 @@ declare global {
         prototype: HTMLVegaColorPickerElement;
         new (): HTMLVegaColorPickerElement;
     };
+    interface HTMLVegaColorSwatchElement extends Components.VegaColorSwatch, HTMLStencilElement {
+    }
+    var HTMLVegaColorSwatchElement: {
+        prototype: HTMLVegaColorSwatchElement;
+        new (): HTMLVegaColorSwatchElement;
+    };
     interface HTMLVegaComboBoxElement extends Components.VegaComboBox, HTMLStencilElement {
     }
     var HTMLVegaComboBoxElement: {
@@ -5728,6 +5813,7 @@ declare global {
         "vega-chip": HTMLVegaChipElement;
         "vega-code-block": HTMLVegaCodeBlockElement;
         "vega-color-picker": HTMLVegaColorPickerElement;
+        "vega-color-swatch": HTMLVegaColorSwatchElement;
         "vega-combo-box": HTMLVegaComboBoxElement;
         "vega-counter-badge": HTMLVegaCounterBadgeElement;
         "vega-date-picker": HTMLVegaDatePickerElement;
@@ -6065,7 +6151,7 @@ declare namespace LocalJSX {
          */
         "bannerTitle"?: string;
         /**
-          * Specifies the content displayed within the banner.
+          * Specifies the content displayed within the banner. Also supports slot-based content: place a child element with `slot="content"` inside the banner to render rich HTML content. The slot takes precedence over this property.
           * @vegaVersion 2.8.0
          */
         "content"?: string;
@@ -6763,6 +6849,11 @@ declare namespace LocalJSX {
           * @vegaVersion 1.10.0
          */
         "identifier"?: string;
+        /**
+          * Specifies whether the checkbox is in an indeterminate state.  The indeterminate state is a visual-only state typically used to represent    a checkbox whose value is neither fully checked nor fully unchecked,    such as a "select all" control where only some children are selected.  Setting this property does not affect the `checked` or `value` properties.    User interaction (clicking) will clear the indeterminate state and    toggle `checked` as usual.
+          * @vegaVersion 2.83.0
+         */
+        "indeterminate"?: boolean;
         /**
           * Specifies the validation status of the checkbox component.
           * @vegaVersion 1.10.0
@@ -6997,6 +7088,11 @@ declare namespace LocalJSX {
           * @vegaVersion 1.13.0
          */
         "colors"?: string[];
+        /**
+          * Specifies the maximum number of color swatches displayed per row.  When the number of `colors` exceeds `columns`, the remaining swatches    wrap to additional rows. For example, `columns={5}` with 10 colors    renders 2 rows of 5 swatches.  Defaults to `8` to preserve the original single-row layout for the    default 8-color palette.
+          * @vegaVersion 2.82.0
+         */
+        "columns"?: number;
         /**
           * Specifies whether the color picker element is disabled.
           * @vegaVersion 1.13.0
@@ -7049,6 +7145,54 @@ declare namespace LocalJSX {
          */
         "value"?: string;
     }
+    interface VegaColorSwatch {
+        /**
+          * Specifies the CSS color value for the swatch (e.g. '#841AC1', 'rgb(15, 137, 82)', 'rgba(15, 137, 82, 0.5)'). Applies only when `variant` is set to 'swatch'.
+          * @vegaVersion 2.82.0
+         */
+        "color"?: string;
+        /**
+          * Specifies whether the swatch is disabled.
+          * @vegaVersion 2.82.0
+         */
+        "disabled"?: boolean;
+        /**
+          * Specifies the label or title for the swatch.    It provides descriptive text that helps identify the purpose or content expected in the swatch.
+          * @vegaVersion 2.82.0
+         */
+        "label"?: string;
+        /**
+          * An event emitter notifying the click event of the swatch.
+          * @vegaVersion 2.82.0
+          * @eventSemantics namespace:native
+         */
+        "onClick"?: (event: VegaColorSwatchCustomEvent<void>) => void;
+        /**
+          * An event emitter notifying the click event of the swatch.
+          * @vegaVersion 2.82.0
+         */
+        "onVegaClick"?: (event: VegaColorSwatchCustomEvent<void>) => void;
+        /**
+          * Indicates whether the swatch is currently selected. When selected, a check mark is shown, and its color automatically adjusts to maintain contrast against the swatch color.
+          * @vegaVersion 2.82.0
+         */
+        "selected"?: boolean;
+        /**
+          * Controls the outer shape of the swatch. - 'basket': Rounded corners for spaced layouts. - 'block': Square corners for dense or flush layouts.
+          * @vegaVersion 2.82.0
+         */
+        "shape"?: VegaColorSwatchShape;
+        /**
+          * Specifies the size of the swatch.
+          * @vegaVersion 2.82.0
+         */
+        "size"?: VegaColorSwatchSize;
+        /**
+          * Specifies the visual style and prominence of the swatch.    It determines how the swatch will be presented to the user. - 'swatch': Displays the color fill. - 'clear': Displays a diagonal line to indicate no color (clear selection).
+          * @vegaVersion 2.82.0
+         */
+        "variant"?: VegaColorSwatchVariant;
+    }
     interface VegaComboBox {
         /**
           * Determines whether automatic validation should be implemented    when a value is edited in the combo box.
@@ -7511,6 +7655,11 @@ declare namespace LocalJSX {
           * @vegaVersion 1.13.0
          */
         "itemDisplayRule"?: 'ellipsis' | 'newline';
+        /**
+          * Provides tooltip configuration options for dropdown items.  Useful for controlling tooltip width for long item labels.
+          * @vegaVersion 2.82.0
+         */
+        "itemTooltipProps"?: Partial<Pick<HTMLVegaTooltipElement, 'placement' | 'maxWidth' | 'minWidth'>>;
         /**
           * Determines if the dropdown height should be automatically adjusted    to fit its container height.  If set to `true`, the dropdown will always be positioned at    the bottom of the available space.
           * @vegaVersion 1.3.0
@@ -9041,6 +9190,11 @@ declare namespace LocalJSX {
           * @vegaVersion 1.3.0
          */
         "disabled"?: boolean;
+        /**
+          * Provides tooltip configuration for dropdown items.  Use this to control tooltip placement and width for long item labels.
+          * @vegaVersion 2.82.0
+         */
+        "dropdownItemTooltipProps"?: VegaInputSelectDropdownTooltipProps;
         /**
           * Provides a supplementary prompt message that assists users in    understanding the expected value for the input select field.
           * @vegaVersion 1.3.0
@@ -9140,6 +9294,11 @@ declare namespace LocalJSX {
           * @vegaVersion 1.35.0
          */
         "selectedLabel"?: SelectedLabelType | SelectedLabelTypeForAllModes;
+        /**
+          * Provides tooltip configuration for the selected label text.  Use this to control tooltip placement, width, and other display properties.
+          * @vegaVersion 2.82.0
+         */
+        "selectedLabelTooltipProps"?: VegaInputSelectTooltipProps;
         /**
           * Defines the size of the input select field.
           * @vegaVersion 1.18.0
@@ -9745,6 +9904,12 @@ declare namespace LocalJSX {
         "showArrow"?: boolean;
     }
     interface VegaProgressTracker {
+        /**
+          * When enabled, `current = -1` becomes a valid state that indicates    no highlighted/current step (e.g. all steps are pending or the    workflow has not started).  Two ways to enter this state: - Set the `current` prop to `-1`. - Call the `setCurrent(-1)` method.
+          * @VegaHint `prevStep()` still clamps at `0` and will not take `current` into `-1`.
+          * @vegaVersion 2.82.0
+         */
+        "allowNoCurrentStep"?: boolean;
         /**
           * Enables the ability to click on the steps in    the Progress Tracker component.
           * @vegaVersion 1.5.0
@@ -10024,6 +10189,12 @@ declare namespace LocalJSX {
           * @vegaVersion 2.59.0
          */
         "sourceEditConfig"?: VegaRTESourceEditConfig;
+        /**
+          * Specifies which text style items appear in the Text Styles toolbar dropdown.  Use this to control which heading levels and text styles are available to users. For example, omit `{ key: 'heading-1' }` to prevent users from applying H1 (which is typically reserved for the page title).  Items are displayed in a fixed internal order regardless of the order in this array.
+          * @vegaVersion 2.83.0
+          * @defaultValue [{ key: 'title' }, { key: 'subtitle' }, { key: 'heading-1' }, { key: 'heading-2' }, { key: 'heading-3' }, { key: 'paragraph' }]
+         */
+        "textStyleItems"?: VegaRTETextStyleItem[];
         /**
           * Specifies the built-in toolbar items available in the rich-text editor.
           * @vegaVersion 2.34.0
@@ -11444,7 +11615,7 @@ declare namespace LocalJSX {
          */
         "size"?: ResponsiveType<SizeType>;
         /**
-          * Specifies the text that is displayed    inside the tooltip.
+          * Specifies the text that is displayed    inside the tooltip.  Line breaks (`\n`) are supported and rendered as new lines. Consecutive regular spaces are collapsed; to preserve indentation (e.g. hanging indent for bullet lists) use the non-breaking space character `\u00A0`.
           * @vegaVersion 2.0.0
          */
         "text"?: string;
@@ -11456,7 +11627,7 @@ declare namespace LocalJSX {
     }
     interface VegaTooltipContentBox {
         /**
-          * Specifies the text that is displayed inside the tooltip.
+          * Specifies the text that is displayed inside the tooltip.  Line breaks (`\n`) are supported and rendered as new lines. Consecutive regular spaces are collapsed; to preserve indentation (e.g. hanging indent for bullet lists) use the non-breaking space character `\u00A0`.
           * @vegaVersion 2.0.0
          */
         "text"?: string;
@@ -11524,6 +11695,7 @@ declare namespace LocalJSX {
         "vega-chip": VegaChip;
         "vega-code-block": VegaCodeBlock;
         "vega-color-picker": VegaColorPicker;
+        "vega-color-swatch": VegaColorSwatch;
         "vega-combo-box": VegaComboBox;
         "vega-counter-badge": VegaCounterBadge;
         "vega-date-picker": VegaDatePicker;
@@ -11647,6 +11819,7 @@ declare module "@stencil/core" {
             "vega-chip": LocalJSX.VegaChip & JSXBase.HTMLAttributes<HTMLVegaChipElement>;
             "vega-code-block": LocalJSX.VegaCodeBlock & JSXBase.HTMLAttributes<HTMLVegaCodeBlockElement>;
             "vega-color-picker": LocalJSX.VegaColorPicker & JSXBase.HTMLAttributes<HTMLVegaColorPickerElement>;
+            "vega-color-swatch": LocalJSX.VegaColorSwatch & JSXBase.HTMLAttributes<HTMLVegaColorSwatchElement>;
             "vega-combo-box": LocalJSX.VegaComboBox & JSXBase.HTMLAttributes<HTMLVegaComboBoxElement>;
             "vega-counter-badge": LocalJSX.VegaCounterBadge & JSXBase.HTMLAttributes<HTMLVegaCounterBadgeElement>;
             "vega-date-picker": LocalJSX.VegaDatePicker & JSXBase.HTMLAttributes<HTMLVegaDatePickerElement>;

package/dist/types/helpers/event-manager/event-id/vega-internal-event-id.d.ts

@@ -50,6 +50,7 @@ export declare const VegaInternalCodeBlockSelectionChange: VegaInternalEventID;
 export declare const VegaInternalColumnHeadRowRenderInputRIC: VegaInternalEventID;
 export declare const VegaInternalColumnHeadCellRenderInputRIC: VegaInternalEventID;
 export declare const VegaInternalColumnBodyCellRenderInputRIC: VegaInternalEventID;
+export declare const VegaInternalVegaTableRenderInputChange: VegaInternalEventID;
 export declare const VegaInternalCalendarEventPreviewUpdate: VegaInternalEventID;
 export declare const VegaInternalCalendarEventPreviewClear: VegaInternalEventID;
 export declare const VegaInternalUpdateRTECursorPosition: VegaInternalEventID;

package/dist/types/helpers/formatter/string-formatter/string-mask-strategy.d.ts

@@ -1,17 +1,70 @@
 import { Nullable } from '../../../types/general';
 import { InputStatus, StringFormatStrategy } from './string-format-strategy.abstract';
+/**
+ * Defines how raw input is transformed into a masked string.
+ *
+ * Typical use cases:
+ * - Phone numbers
+ * - Zip or postal codes
+ * - Tax ID values
+ * - Custom alphanumeric patterns
+ *
+ * Rendering flow:
+ * 1. `accept` filters valid characters from input.
+ * 2. `mask` defines the output shape.
+ * 3. `slot` marks replaceable mask characters.
+ * 4. `insertMode` controls insert vs replace behavior.
+ */
 export declare type MaskConfig = {
+  /**
+   * Output template for the final formatted string.
+   * Characters matched by `slot` are replaceable placeholders.
+   * Examples:
+   * - `(999) 999-9999`
+   * - `99999`
+   * - `99-9999999`
+   */
   mask: string;
+  /**
+   * Placeholder rule used to identify replaceable positions in `mask`.
+   * Supported forms:
+   * - Literal character, for example `9`
+   * - RegExp, for example `/\d/`
+   */
   slot: string | RegExp;
+  /**
+   * RegExp used to filter valid input characters.
+   * Only matched characters are allowed to fill `slot` positions.
+   * Examples:
+   * - `/\d/g` for digits
+   * - `/[A-Z]/g` for uppercase letters
+   * - `/[a-zA-Z0-9]/g` for alphanumeric input
+   */
   accept: RegExp;
+  /**
+   * Controls how incoming characters are applied.
+   * - `true` (default): insert mode
+   * - `false`: replace mode
+   * Example:
+   * Set mask = ****9999, slot = 9, input = 12345678
+   * - insertMode = true  -> ****1234
+   * - insertMode = false -> ****5678
+   */
   insertMode?: boolean;
   /**
-   * Whether to override the component value on blur when using 'blur' trigger.
+   * Whether to override component value on blur.
    *
-   * @deprecated This property is deprecated since we have overrideValue in MaskConfigType which has the same function but more flexible to use.
-   *   Please use overrideValue in MaskConfigType instead of this one. If both of them exist, the overrideValue in MaskConfigType will be used and this property will be ignored.
+   * @deprecated Use `overrideValue` in `MaskConfigType` instead.
+   * If both are provided, `MaskConfigType.overrideValue` takes precedence.
    */
   overrideValue?: boolean;
+  /**
+   * Applies mask formatting during component initialization when `true`.
+   * Example:
+   * - Initial value: `5551234567`
+   * - Phone mask: `(999) 999-9999`
+   * - Result at init: `(555) 123-4567`
+   */
   triggerAtInit?: boolean;
 };
 /**

package/dist/types/helpers/rte-manager/dto-renderer-manager.d.ts

@@ -11,6 +11,14 @@ export declare type BaseRenderer = VegaRTEBaseRenderer<RTEBlock | RTENode, VegaR
 declare class RTEDTORendererManager {
   private RTE_DTO_RENDERER_MAP;
   private RTE_TOOLBAR_BUTTON_RENDERER_MAP;
+  /**
+   * Per-host toolbar button renderer map.
+   * Stores a host-specific renderer map so that extensions that register during
+   * {@link VegaRTEExtension#prepareBeforeLoad} can provide isolated renderer instances
+   * for each {@link HTMLVegaRichTextEditorElement}.  At render time this map is checked
+   * first; the global singleton map is used as a fallback.
+   */
+  private hostToolbarButtonRendererMap;
   /**
    * Registers a new RTE DTO renderer.
    *
@@ -25,6 +33,17 @@ declare class RTEDTORendererManager {
    * @param {VegaRTEToolbarButtonRenderer} RTEToolbarButtonRenderer - The renderer instance for the RTE Toolbar Button.
    */
   registerRTEToolbarButtonRenderer(type: string, RTEToolbarButtonRenderer: VegaRTEToolbarButtonRenderer): void;
+  /**
+   * Registers a host-specific toolbar button renderer.
+   * The per-host renderer takes precedence over the global singleton when the host
+   * element is passed to {@link getRTEToolbarButtonRenderer}.
+   *
+   * @typedef HTMLVegaRichTextEditorElement - The rich text editor host element type.
+   * @param {HTMLVegaRichTextEditorElement} host - The rich text editor host element.
+   * @param {string} type - The type identifier for the toolbar button renderer.
+   * @param {VegaRTEToolbarButtonRenderer} renderer - The renderer instance to register for this host.
+   */
+  registerRTEToolbarButtonRendererForHost(host: HTMLVegaRichTextEditorElement, type: string, renderer: VegaRTEToolbarButtonRenderer): void;
   /**
    * Retrieves the RTE renderer for a given type.
    *
@@ -34,11 +53,17 @@ declare class RTEDTORendererManager {
   getRTERenderer(type: string): Nullable<BaseRenderer>;
   /**
    * Retrieves the RTE Toolbar Button Renderer for a given type.
+   * When a host element is provided the per-host map registered via
+   * {@link registerRTEToolbarButtonRendererForHost} is checked first; the global
+   * singleton map is used as a fallback so that extensions that do not override
+   * {@link VegaRTEExtension#prepareBeforeLoad} continue to work unchanged.
    *
+   * @typedef HTMLVegaRichTextEditorElement - The rich text editor host element type.
    * @param {string} type - The type identifier for the RTE Toolbar Button Renderer.
+   * @param {HTMLVegaRichTextEditorElement} [host] - Optional host element for per-host lookup.
    * @returns {Nullable<VegaRTEToolbarButtonRenderer>} - The renderer instance for the RTE Toolbar Button, or null if not found.
    */
-  getRTEToolbarButtonRenderer(type: string): Nullable<VegaRTEToolbarButtonRenderer>;
+  getRTEToolbarButtonRenderer(type: string, host?: HTMLVegaRichTextEditorElement): Nullable<VegaRTEToolbarButtonRenderer>;
 }
 declare const _default: RTEDTORendererManager;
 export default _default;

package/dist/types/helpers/slimmers/drop-file-accept-filter-slimmer.d.ts

@@ -0,0 +1,29 @@
+import { VegaSlimmer } from '../../vega-slimmer/vega-slimmer-core';
+import { Nullable } from '../../types/general';
+/**
+ * Filters dropped/selected files based on the accepted file types specified in the host component's `accept` property.
+ *
+ * The host component is expected to expose a string `accept` property using the same syntax as the standard
+ * HTML `<input type="file">` `accept` attribute (file extensions like `.png`, MIME types like `image/png`,
+ * MIME wildcards like `image/*`, or the universal wildcards `*` / `*\/*` / `/*`).
+ *
+ * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Attributes/accept
+ */
+export declare class DropFileAcceptFilterSlimmer<T extends string = string> extends VegaSlimmer {
+  protected accept: Nullable<T>;
+  /**
+   * Filters the files based on accepted file types if specified.
+   *
+   * @param {FileList|null} fileList - FileList is a FileList object
+   * @returns {File[]} An array of `File` objects after filtering based on the accepted file types specified in the `accept` property
+   */
+  process(fileList: Nullable<FileList>): File[];
+  /**
+   * Checks if a given file matches any of the accepted file types based on file name, MIME type, or base type.
+   *
+   * @param {File} file - File object
+   * @param {string[]} acceptTypes - An array of strings that represent the file types that are accepted.
+   * @returns {boolean} A boolean value, indicating whether the provided file matches any of the accepted file types specified in the `acceptTypes` array.
+   */
+  private validateFileType;
+}

package/dist/types/helpers/slimmers/element-appender/body-positioned-wrapper/third-party-dialog-wrapper.d.ts

@@ -0,0 +1,45 @@
+import { ElementAppenderShowConfig } from '../../../ui/element-appender';
+import { BodyPositionedWrapper } from './body-positioned-wrapper.abstract';
+/**
+ * Appends the popover content box inside the nearest third-party dialog/modal (e.g. Bootstrap,
+ * MUI) so that their focus trap does not block focus on vega-popover content.
+ *
+ * Detection strategy:
+ * 1. Walk up from the target to find `dialog` or `[aria-modal="true"]`.
+ * 2. Skip Vega-owned elements (tag starts with `VEGA-`).
+ * 3. Locate the focus-trap root via `closest('[tabindex="-1"]')`.
+ */
+export declare class ThirdPartyDialogWrapper extends BodyPositionedWrapper {
+  showConfig: ElementAppenderShowConfig;
+  private focusTrapRoot;
+  /**
+   * Returns true when the target lives inside a third-party dialog.
+   *
+   * NOTE: Does NOT call super.canRetrieve() — must activate even when isScreenPosition=true
+   * (e.g. image editor popover) so the content box stays inside the focus-trap root.
+   *
+   * @returns {boolean} Whether the target is inside a third-party dialog.
+   */
+  canRetrieve(): boolean;
+  /**
+   * Appends the popover content box inside the focus-trap root.
+   *
+   * @returns {HTMLElement} The focus-trap root element.
+   */
+  retrieve(): HTMLElement;
+  /**
+   * Finds the focus-trap root of the nearest third-party dialog ancestor.
+   * Returns null if not inside a third-party dialog or if the dialog is Vega-owned.
+   *
+   * @param {Nullable<HTMLElement>} el - The element to start searching from.
+   * @returns {Nullable<HTMLElement>} The focus-trap root, or null.
+   */
+  private findFocusTrapRoot;
+  /**
+   * Returns true when the element is a Vega custom element (tag starts with `VEGA-`).
+   *
+   * @param {HTMLElement} el - The element to check.
+   * @returns {boolean} True if the element is Vega-owned.
+   */
+  private isVegaOwned;
+}

package/dist/types/helpers/slimmers/element-appender/element-appender-container-controller.d.ts

@@ -4,6 +4,7 @@ import { DefaultWrapper } from './body-positioned-wrapper/default-wrapper';
 import { PositionRelativeToWrapper } from './body-positioned-wrapper/position-relative-to-wrapper';
 import { VegaModalWrapper } from './body-positioned-wrapper/vega-modal-wrapper';
 import { VegaPopoverWrapper } from './body-positioned-wrapper/vega-popover-wrapper';
+import { ThirdPartyDialogWrapper } from './body-positioned-wrapper/third-party-dialog-wrapper';
 export interface ElementAppenderContainerRetriever {
   canRetrieve: () => boolean;
   retrieve: () => HTMLElement;
@@ -20,6 +21,7 @@ export declare class ElementAppenderContainerController extends VegaSlimmer {
   protected readonly positionRelativeToWrapper: PositionRelativeToWrapper;
   protected readonly vegaPopoverWrapper: VegaPopoverWrapper;
   protected readonly vegaModalWrapper: VegaModalWrapper;
+  protected readonly thirdPartyDialogWrapper: ThirdPartyDialogWrapper;
   protected readonly defaultWrapper: DefaultWrapper;
   private containerRetrievers;
   /**