@globalpayments/vega 2.89.0 → 2.91.0

package/dist/types/components/vega-rich-text-editor/extensions/link/type.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Configurable options for the link extension.
+ */
+export declare type VegaRTELinkExtensionConfig = {
+  /**
+   * Optional protocol prefix used to normalize user-entered links.
+   *
+   * Examples:
+   * - `https://` + `abc.com` => `https://abc.com`
+   * - `mailto:` + `test@example.com` => `mailto:test@example.com`
+   * - `tel:` + `123456` => `tel:123456`
+   * - `/` + `about` => `/about`
+   */
+  defaultProtocol?: string;
+};

package/dist/types/components/vega-rich-text-editor/extensions/link/utils.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Normalizes URL by prepending default protocol when URL does not already include one.
+ *
+ * @param {string} url URL value to normalize.
+ * @param {string} defaultProtocol Configured default protocol, for example: https:// or mailto:.
+ * @returns {string} Normalized URL.
+ */
+export declare function normalizeUrlByDefaultProtocol(url: string, defaultProtocol: string): string;

package/dist/types/components/vega-rich-text-editor/extensions/rte-extension-state-store.d.ts

@@ -0,0 +1,30 @@
+import { Nullable } from '../../../types/general';
+/**
+ * Generic per-host state store using WeakMap keyed by HTMLVegaRichTextEditorElement.
+ * Create via {@link VegaRTEExtension.createStateStore} and declare as `static readonly` on your extension class.
+ *
+ * @template T - The type of the state value to store per host.
+ */
+export declare class RTEExtensionStateStore<T> {
+  private readonly stateMap;
+  /**
+   * Store a value for the given host.
+   *
+   * @param {HTMLElement} host - The editor host.
+   * @param {T} value - The value to store.
+   */
+  set(host: HTMLVegaRichTextEditorElement, value: T): void;
+  /**
+   * Retrieve the stored value for the given host.
+   *
+   * @param {Nullable<HTMLElement>} host - The editor host.
+   * @returns {Nullable<T>} The stored value, or null if not found.
+   */
+  get(host: Nullable<HTMLVegaRichTextEditorElement>): Nullable<T>;
+  /**
+   * Remove the stored value for the given host.
+   *
+   * @param {HTMLElement} host - The editor host.
+   */
+  delete(host: HTMLVegaRichTextEditorElement): void;
+}

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

@@ -20,6 +20,7 @@ export { VegaRTEHorizontalLineExtension } from './extensions/horizontal-line/hor
 export { VegaRTESpecialCharactersExtension } from './extensions/special-characters/special-characters-extension';
 export { VegaRTESpecialCharactersEssentials, VegaRTESpecialCharactersLatin, VegaRTESpecialCharactersMathematical, VegaRTESpecialCharactersArrows, VegaRTESpecialCharactersCurrency, VegaRTESpecialCharactersText, } from './extensions/special-characters/constants/default-categories';
 export { VegaRTELineHeightExtension } from './extensions/line-height/line-height-extension';
+export { VegaRTELinkExtension } from './extensions/link/link-extension';
 export { ModifyContentAction, ModifyContentActionType } from './dto/actions/modify-content-action.abstract';
 export { AppendChildrenAction } from './dto/actions/append-child-nodes-action';
 export { RemoveChildrenAction } from './dto/actions/remove-child-action';
@@ -41,4 +42,5 @@ export { htmlElementToAnnotationGenerator };
 export { VegaRTEDefaultTextStyleItems, VegaRTEPresetToolbarItems } from './constants/constant';
 export { VegaRTEDefaultLineHeightOptions } from './extensions/line-height/constants';
 export { VegaRTELineHeightOption } from './extensions/type';
+export { VegaRTELinkExtensionConfig } from './extensions/link/type';
 export { RTEFilterStylesStrategy } from './dto/filter-styles-strategies/filter-styles-strategy.abstract';

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

@@ -104,6 +104,28 @@ export declare class SelectionController extends AutoRunWhenReRenderTaskQueueSli
    * The method invoke after the component re-render.
    */
   protected doTask: () => Promise<void>;
+  /**
+   * Scroll the editor's scrollable viewport so the caret stays visible.
+   * Setting the selection range programmatically does not trigger the browser's
+   * native auto-scroll, so when the cursor is moved (e.g. after inserting a
+   * function block) it can land outside the visible area of a fixed-height
+   * (rows) editor. This keeps the caret within view.
+   *
+   * Note: This method performs getBoundingClientRect() reads and is called during
+   * the re-render task path every time the saved selection is restored.
+   *
+   * @param {Range} range - The range that was applied to the selection.
+   */
+  private scrollCaretIntoView;
+  /**
+   * Get the bounding rect of the caret for the given range.
+   * A collapsed range inside an empty node can return an empty rect, so in that
+   * case fall back to the nearest element's bounding rect.
+   *
+   * @param {Range} range - The range to measure.
+   * @returns {Nullable<DOMRect>} The caret bounding rect, or null if it cannot be resolved.
+   */
+  private getCaretRect;
   /**
    * Save the current selection range detail
    */

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

@@ -1,7 +1,7 @@
 import { VegaSlimmer } from '../../../../vega-slimmer/vega-slimmer-core';
 import { VegaRichTextEditor } from '../../vega-rich-text-editor';
 export declare class ToolbarRenderer extends VegaSlimmer {
-  toolbarItems: VegaRichTextEditor['toolbarItems'];
+  uniqueToolbarItems: VegaRichTextEditor['uniqueToolbarItems'];
   allowSourceEdit: VegaRichTextEditor['allowSourceEdit'];
   host: VegaRichTextEditor['host'];
   clearStyleToolbarButtonSlimmer: VegaRichTextEditor['clearStyleToolbarButtonSlimmer'];

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

@@ -99,6 +99,19 @@ export declare class VegaRichTextEditor {
   selectionMap: Map<RTEBlock, RTENode[]>;
   isInDarkMode: boolean;
   sourceView: boolean;
+  /**
+   * Internal state that holds unique toolbar items.
+   * Computed from `toolbarItems` to ensure each button renders only once.
+   *
+   *
+   * When `toolbarItems` contains duplicates across groups (e.g.,
+   * `[['bold'], ['italic'], ['bold']]`), only the first occurrence of each
+   * button is preserved. The group structure is maintained, but duplicate
+   * buttons are filtered out.
+   *
+   * @internal
+   */
+  uniqueToolbarItems: VegaRTEToolbarItem[][];
   /**
    * Specifies the label for the rich text editor.
    *
@@ -150,11 +163,14 @@ export declare class VegaRichTextEditor {
    */
   hint: string;
   /**
-   * Specifies editable section rows for the rich text editor
+   * Specifies editable section rows for the rich text editor.
+   * When not set, the editor uses stretching behavior with a default visual height of 5 rows.
+   * When set, the editor height is fixed and content overflow is scrollable.
+   * The value accepts integers ≥ 2; for optimal display, values below 2 are internally normalized to 5 rows.
    *
    * @vegaVersion 2.34.0
    */
-  rows: number;
+  rows?: number;
   /**
    * Specifies the value of the rich text editor, which can be either VegaRTEContent or VegaRTEContentBlock.
    * It is recommended to use the VegaRTEContent type.
@@ -171,6 +187,7 @@ export declare class VegaRichTextEditor {
    * @vegaVersion 2.34.0
    */
   toolbarItems: VegaRTEToolbarItem[][];
+  watchToolbarItems(): void;
   /**
    * Determines whether to allow source edit mode in the rich text editor.
    *
@@ -265,4 +282,12 @@ export declare class VegaRichTextEditor {
   sourceCodeChange: EventEmitter<string>;
   componentWillLoad(): void;
   render(): VegaRichTextEditor;
+  /**
+   * Synchronizes {@link uniqueToolbarItems} from {@link toolbarItems} using global uniqueness enforcement.
+   *
+   * Example:
+   * - input: [["bold", "italic"], ["bold", "link"], ["italic"]]
+   * - output: [["bold", "italic"], ["link"], []]
+   */
+  private syncUniqueToolbarItems;
 }

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

@@ -27,4 +27,5 @@ export declare class VegaRichTextLinkEditorRenderer extends VegaSlimmer {
   private renderLinkEditContent;
   private handleKeyDown;
   private updatePopoverTarget;
+  private normalizeUrlByDefaultProtocol;
 }

package/dist/types/components/vega-selection-chip/vega-selection-chip-group/slimmers/renderers/vega-selection-chip-group-renderer.d.ts

@@ -4,6 +4,7 @@ export declare class VegaSelectionChipGroupRenderer extends VegaSlimmer {
   host: VegaSelectionChipGroup['host'];
   label: VegaSelectionChipGroup['label'];
   required: VegaSelectionChipGroup['required'];
+  optional: VegaSelectionChipGroup['optional'];
   hint: VegaSelectionChipGroup['hint'];
   disabled: VegaSelectionChipGroup['disabled'];
   private groupContainerRef;

package/dist/types/components/vega-selection-chip/vega-selection-chip-group/vega-selection-chip-group.d.ts

@@ -65,6 +65,16 @@ export declare class VegaSelectionChipGroup {
    * @vegaVersion 2.22.0
    */
   required: boolean;
+  /**
+   * Indicates whether the field should be presented as optional.
+   *
+   * This property only takes effect when `required` is `false`.
+   * When `true`, an "optional" label is displayed next to the field label.
+   *
+   * @default false
+   * @vegaVersion 2.90.0
+   */
+  optional: boolean;
   /**
    * Indicates if the selection chip group is disabled.
    *

package/dist/types/components/vega-tab-group/slimmers/vega-tab-group/controllers/vega-tab-group-pages-controller.d.ts

@@ -81,8 +81,9 @@ export declare class VegaTabGroupPagesController extends PageResizeObserverSlimm
    */
   private emptySourceAndHiddenDropdown;
   /**
-   * 1.record the width of tab.
-   * 2.the width of every tab is zero if the tab group component embedded in modal, so need recalculate the width of tab.
+   * 1. Record the width of each tab.
+   * 2. Recalculate when widths are zero, such as when the tab group is embedded in a modal before render.
+   * 3. Recalculate when tab count changes to ensure overflow navigation buttons stay in sync.
    */
   private initTabsWidthArray;
 }

package/dist/types/components/vega-tab-group/vega-tab-group.d.ts

@@ -85,9 +85,10 @@ export declare class VegaTabGroup {
   /**
    * Defines the tab items that appear within the tab group.
    *
-   * The `tabItems` property can only be set once during
-   *    initialization and cannot be overridden or
-   *    modified dynamically.
+   * The `tabItems` property supports dynamic updates.
+   *
+   * - When items are added or removed, the tab group
+   *      will update tabs and overflow layout automatically.
    *
    * @vegaVersion 1.3.0
    */

package/dist/types/components.d.ts

@@ -18,7 +18,7 @@ import { VegaButtonCircleSize, VegaButtonCircleTooltip, VegaButtonCircleVariant
 import { DropdownPropsForButtonGroup, VegaButtonGroupIconAlign, VegaButtonGroupSize, VegaButtonGroupVariant } from "./components/vega-button-group/types";
 import { DropdownSourceGroup, DropdownSourceItem, VegaDropdownSearchTriggerByType, VegaDropdownSearchTriggerEventDetail, VegaDropdownSourceItem } from "./components/vega-dropdown/types";
 import { VegaButtonLinkTarget } from "./components/vega-button-link/types";
-import { CalendarEventActionsCallback, DisabledDate, DropdownPropsForCalendar, VegaCalendarChangeEventType, VegaCalendarDateClickInfo, VegaCalendarEventClickInfo, VegaCalendarEventEditInfo, VegaCalendarRawEvent, VegaCalendarViewModeType } from "./components/vega-calendar/types";
+import { CalendarEventActionsCallback, DisabledDate, DropdownPropsForCalendar, VegaCalendarChangeEventType, VegaCalendarDateClickInfo, VegaCalendarEventClickInfo, VegaCalendarEventEditInfo, VegaCalendarPeriodType, VegaCalendarRawEvent, VegaCalendarViewModeType } from "./components/vega-calendar/types";
 import { Nullable, TimeFormat } from "./types/general";
 import { CalendarEvent } from "./helpers/calendar/calendar-event";
 import { FormFieldValidationRule } from "./helpers/validator/rules/form-field-validation-rule";
@@ -710,6 +710,11 @@ export namespace Components {
           * @vegaVersion 2.14.0
          */
         "events": VegaCalendarRawEvent[];
+        /**
+          * Invoke this method to get the current calendar period.
+          * @vegaVersion 2.91.0
+         */
+        "getCurrentPeriod": () => Promise<VegaCalendarPeriodType>;
         /**
           * A callback function that determines the visibility of action buttons in the event preview popover for each calendar event. It receives the raw event data and the associated date, and should return an object indicating which action buttons should be visible in the popover. This allows for dynamic customization of the event preview based on the specific event being clicked.
           * @vegaVersion 2.87.0
@@ -727,6 +732,11 @@ export namespace Components {
           * @vegaVersion 2.20.0
          */
         "moreActionDropdownProps": DropdownPropsForCalendar;
+        /**
+          * Invoke this method to set the current calendar period. Use `VegaCalendarPeriodFactory.fromDate` to create a `VegaCalendarPeriodType` from a date if needed.
+          * @vegaVersion 2.91.0
+         */
+        "setCurrentPeriod": (period: VegaCalendarPeriodType) => Promise<void>;
         /**
           * Controls the visibility of the calendar's event color bar.
           * @vegaVersion 2.21.0
@@ -774,6 +784,33 @@ export namespace Components {
          */
         "eventKey": string;
     }
+    interface VegaCalendarPeriodSwitcher {
+        /**
+          * Invoke this method to get the current calendar period.
+          * @vegaVersion 2.91.0
+         */
+        "getCurrentPeriod": () => Promise<VegaCalendarPeriodType>;
+        /**
+          * Invoke this method to set the current calendar period. Use `VegaCalendarPeriodFactory.fromDate` to create a `VegaCalendarPeriodType` from a date if needed.
+          * @vegaVersion 2.91.0
+         */
+        "setCurrentPeriod": (period: VegaCalendarPeriodType) => Promise<void>;
+        /**
+          * Determines whether weekends are displayed in the calendar period switcher.
+          * @vegaVersion 2.91.0
+         */
+        "showWeekends": boolean;
+        /**
+          * Specifies the IANA time zone or Etc/GMT±n format.  It accepts values such as "America/New_York" or "Etc/GMT+12".  If not set, the component defaults to the system's time zone.  For a complete list of IANA time zones, see Time Zone DB(https://timezonedb.com/time-zones).
+          * @vegaVersion 2.91.0
+         */
+        "timezone": string;
+        /**
+          * Specifies the current view mode of the calendar period switcher.
+          * @vegaVersion 2.91.0
+         */
+        "viewMode": VegaCalendarViewModeType;
+    }
     interface VegaCard {
         /**
           * Defines the background color of the card element.    It accepts a string value representing a valid    background color token.
@@ -914,6 +951,12 @@ export namespace Components {
           * @vegaVersion 1.3.0
          */
         "label": string;
+        /**
+          * Indicates whether the field should be presented as optional.  This property only takes effect when `required` is `false`. When `true`, an "optional" label is displayed next to the field label.
+          * @default false
+          * @vegaVersion 2.90.0
+         */
+        "optional": boolean;
         /**
           * Indicates whether at least one checkbox in the    checkbox group must be checked to pass    form validation.
           * @vegaVersion 1.3.0
@@ -1216,7 +1259,7 @@ export namespace Components {
          */
         "close": () => Promise<void>;
         /**
-          * Specifies the maximum height of the combo box container,    including selected chips and input area.  When set, vertical scrolling will be enabled once the    container content exceeds the configured height.  Note: values smaller than the input minimum height (26px)    are floored to keep the input usable. Use    `vegaDropdownProps.maxHeight` to control the dropdown    menu height independently.
+          * Specifies the maximum height of the combo box container.    When the content exceeds this limit, vertical scrolling is enabled.
           * @vegaVersion 2.89.0
          */
         "containerMaxHeight": ResponsiveType<MaxHeightType>;
@@ -2477,6 +2520,12 @@ export namespace Components {
           * @vegaVersion 1.26.0
          */
         "label": string;
+        /**
+          * Indicates whether the field should be presented as optional.  This property only takes effect when `required` is `false`. When `true`, an "optional" label is displayed next to the field label.
+          * @default false
+          * @vegaVersion 2.90.0
+         */
+        "optional": boolean;
         /**
           * Specifies a placeholder string that displays as a temporary hint or    example inside the credit card input field.  It indicates the expected format or pattern of the credit card input.
           * @vegaVersion 1.26.0
@@ -3613,6 +3662,12 @@ export namespace Components {
           * @vegaVersion 1.3.0
          */
         "name": string;
+        /**
+          * Indicates whether the field should be presented as optional.  This property only takes effect when `required` is `false`. When `true`, an "optional" label is displayed next to the field label.
+          * @default false
+          * @vegaVersion 2.90.0
+         */
+        "optional": boolean;
         /**
           * Specifies whether the radio button within the radio group    must be checked to pass form validation.
           * @vegaVersion 1.3.0
@@ -3704,10 +3759,10 @@ export namespace Components {
          */
         "required": boolean;
         /**
-          * Specifies editable section rows for the rich text editor
+          * Specifies editable section rows for the rich text editor. When not set, the editor uses stretching behavior with a default visual height of 5 rows. When set, the editor height is fixed and content overflow is scrollable. The value accepts integers ≥ 2; for optimal display, values below 2 are internally normalized to 5 rows.
           * @vegaVersion 2.34.0
          */
-        "rows": number;
+        "rows"?: number;
         /**
           * Specifies the configuration options for source edit mode. It includes settings such as autoMatchFormat, which controls whether the editor automatically matches formatting when switching to source edit mode.
           * @vegaVersion 2.59.0
@@ -3984,6 +4039,12 @@ export namespace Components {
           * @vegaVersion 2.22.0
          */
         "label": string;
+        /**
+          * Indicates whether the field should be presented as optional.  This property only takes effect when `required` is `false`. When `true`, an "optional" label is displayed next to the field label.
+          * @default false
+          * @vegaVersion 2.90.0
+         */
+        "optional": boolean;
         /**
           * Indicates whether at least one selection chip in the    selection chip group must be checked to pass    form validation.
           * @vegaVersion 2.22.0
@@ -4345,7 +4406,7 @@ export namespace Components {
          */
         "showCloseButton": boolean;
         /**
-          * Defines the tab items that appear within the tab group.  The `tabItems` property can only be set once during    initialization and cannot be overridden or    modified dynamically.
+          * Defines the tab items that appear within the tab group.  The `tabItems` property supports dynamic updates.  - When items are added or removed, the tab group      will update tabs and overflow layout automatically.
           * @vegaVersion 1.3.0
          */
         "tabItems": TabConfig[];
@@ -5058,6 +5119,10 @@ export interface VegaAccordionCustomEvent<T> extends CustomEvent<T> {
     detail: T;
     target: HTMLVegaAccordionElement;
 }
+export interface VegaAppFooterCustomEvent<T> extends CustomEvent<T> {
+    detail: T;
+    target: HTMLVegaAppFooterElement;
+}
 export interface VegaAppHeaderButtonCustomEvent<T> extends CustomEvent<T> {
     detail: T;
     target: HTMLVegaAppHeaderButtonElement;
@@ -5094,6 +5159,10 @@ export interface VegaCalendarCustomEvent<T> extends CustomEvent<T> {
     detail: T;
     target: HTMLVegaCalendarElement;
 }
+export interface VegaCalendarPeriodSwitcherCustomEvent<T> extends CustomEvent<T> {
+    detail: T;
+    target: HTMLVegaCalendarPeriodSwitcherElement;
+}
 export interface VegaCarouselCustomEvent<T> extends CustomEvent<T> {
     detail: T;
     target: HTMLVegaCarouselElement;
@@ -5439,6 +5508,12 @@ declare global {
         prototype: HTMLVegaCalendarEventSlotElement;
         new (): HTMLVegaCalendarEventSlotElement;
     };
+    interface HTMLVegaCalendarPeriodSwitcherElement extends Components.VegaCalendarPeriodSwitcher, HTMLStencilElement {
+    }
+    var HTMLVegaCalendarPeriodSwitcherElement: {
+        prototype: HTMLVegaCalendarPeriodSwitcherElement;
+        new (): HTMLVegaCalendarPeriodSwitcherElement;
+    };
     interface HTMLVegaCardElement extends Components.VegaCard, HTMLStencilElement {
     }
     var HTMLVegaCardElement: {
@@ -6070,6 +6145,7 @@ declare global {
         "vega-calendar-event": HTMLVegaCalendarEventElement;
         "vega-calendar-event-preview": HTMLVegaCalendarEventPreviewElement;
         "vega-calendar-event-slot": HTMLVegaCalendarEventSlotElement;
+        "vega-calendar-period-switcher": HTMLVegaCalendarPeriodSwitcherElement;
         "vega-card": HTMLVegaCardElement;
         "vega-carousel": HTMLVegaCarouselElement;
         "vega-checkbox": HTMLVegaCheckboxElement;
@@ -6256,6 +6332,17 @@ declare namespace LocalJSX {
           * @vegaVersion 1.35.1
          */
         "hideDefaultLinks"?: boolean;
+        /**
+          * An event emitter notifying the click event of the additional link in the app footer.
+          * @eventSemantics namespace:native
+          * @vegaVersion 2.91.0
+         */
+        "onAdditionalLinkClick"?: (event: VegaAppFooterCustomEvent<VegaAppFooterLink>) => void;
+        /**
+          * An event emitter notifying the click event of the additional link in the app footer.
+          * @vegaVersion 2.91.0
+         */
+        "onVegaAdditionalLinkClick"?: (event: VegaAppFooterCustomEvent<VegaAppFooterLink>) => void;
         /**
           * Specifies the label or text to be displayed    for the Privacy Policy link in the app footer.
           * @vegaVersion 1.15.0
@@ -7076,6 +7163,34 @@ declare namespace LocalJSX {
          */
         "eventKey": string;
     }
+    interface VegaCalendarPeriodSwitcher {
+        /**
+          * An event emitter notifying that the calendar period has changed.
+          * @eventSemantics namespace:native
+          * @vegaVersion 2.91.0
+         */
+        "onChange"?: (event: VegaCalendarPeriodSwitcherCustomEvent<VegaCalendarPeriodType>) => void;
+        /**
+          * An event emitter notifying that the calendar period has changed.
+          * @vegaVersion 2.91.0
+         */
+        "onVegaChange"?: (event: VegaCalendarPeriodSwitcherCustomEvent<VegaCalendarPeriodType>) => void;
+        /**
+          * Determines whether weekends are displayed in the calendar period switcher.
+          * @vegaVersion 2.91.0
+         */
+        "showWeekends"?: boolean;
+        /**
+          * Specifies the IANA time zone or Etc/GMT±n format.  It accepts values such as "America/New_York" or "Etc/GMT+12".  If not set, the component defaults to the system's time zone.  For a complete list of IANA time zones, see Time Zone DB(https://timezonedb.com/time-zones).
+          * @vegaVersion 2.91.0
+         */
+        "timezone"?: string;
+        /**
+          * Specifies the current view mode of the calendar period switcher.
+          * @vegaVersion 2.91.0
+         */
+        "viewMode"?: VegaCalendarViewModeType;
+    }
     interface VegaCard {
         /**
           * Defines the background color of the card element.    It accepts a string value representing a valid    background color token.
@@ -7259,6 +7374,12 @@ declare namespace LocalJSX {
           * @vegaVersion 2.89.0
          */
         "onVegaUserChange"?: (event: VegaCheckboxGroupCustomEvent<string[]>) => void;
+        /**
+          * Indicates whether the field should be presented as optional.  This property only takes effect when `required` is `false`. When `true`, an "optional" label is displayed next to the field label.
+          * @default false
+          * @vegaVersion 2.90.0
+         */
+        "optional"?: boolean;
         /**
           * Indicates whether at least one checkbox in the    checkbox group must be checked to pass    form validation.
           * @vegaVersion 1.3.0
@@ -7628,7 +7749,7 @@ declare namespace LocalJSX {
          */
         "autoValidation"?: boolean;
         /**
-          * Specifies the maximum height of the combo box container,    including selected chips and input area.  When set, vertical scrolling will be enabled once the    container content exceeds the configured height.  Note: values smaller than the input minimum height (26px)    are floored to keep the input usable. Use    `vegaDropdownProps.maxHeight` to control the dropdown    menu height independently.
+          * Specifies the maximum height of the combo box container.    When the content exceeds this limit, vertical scrolling is enabled.
           * @vegaVersion 2.89.0
          */
         "containerMaxHeight"?: ResponsiveType<MaxHeightType>;
@@ -9215,6 +9336,12 @@ declare namespace LocalJSX {
           * @vegaVersion 1.26.0
          */
         "onVegaFocus"?: (event: VegaInputCreditCardCustomEvent<undefined>) => void;
+        /**
+          * Indicates whether the field should be presented as optional.  This property only takes effect when `required` is `false`. When `true`, an "optional" label is displayed next to the field label.
+          * @default false
+          * @vegaVersion 2.90.0
+         */
+        "optional"?: boolean;
         /**
           * Specifies a placeholder string that displays as a temporary hint or    example inside the credit card input field.  It indicates the expected format or pattern of the credit card input.
           * @vegaVersion 1.26.0
@@ -10582,6 +10709,12 @@ declare namespace LocalJSX {
           * @vegaVersion 1.0.10
          */
         "onVegaChange"?: (event: VegaRadioGroupCustomEvent<string>) => void;
+        /**
+          * Indicates whether the field should be presented as optional.  This property only takes effect when `required` is `false`. When `true`, an "optional" label is displayed next to the field label.
+          * @default false
+          * @vegaVersion 2.90.0
+         */
+        "optional"?: boolean;
         /**
           * Specifies whether the radio button within the radio group    must be checked to pass form validation.
           * @vegaVersion 1.3.0
@@ -10701,7 +10834,7 @@ declare namespace LocalJSX {
          */
         "required"?: boolean;
         /**
-          * Specifies editable section rows for the rich text editor
+          * Specifies editable section rows for the rich text editor. When not set, the editor uses stretching behavior with a default visual height of 5 rows. When set, the editor height is fixed and content overflow is scrollable. The value accepts integers ≥ 2; for optimal display, values below 2 are internally normalized to 5 rows.
           * @vegaVersion 2.34.0
          */
         "rows"?: number;
@@ -11066,6 +11199,12 @@ declare namespace LocalJSX {
           * @vegaVersion 2.22.0
          */
         "onVegaChange"?: (event: VegaSelectionChipGroupCustomEvent<string>) => void;
+        /**
+          * Indicates whether the field should be presented as optional.  This property only takes effect when `required` is `false`. When `true`, an "optional" label is displayed next to the field label.
+          * @default false
+          * @vegaVersion 2.90.0
+         */
+        "optional"?: boolean;
         /**
           * Indicates whether at least one selection chip in the    selection chip group must be checked to pass    form validation.
           * @vegaVersion 2.22.0
@@ -11494,7 +11633,7 @@ declare namespace LocalJSX {
          */
         "showCloseButton"?: boolean;
         /**
-          * Defines the tab items that appear within the tab group.  The `tabItems` property can only be set once during    initialization and cannot be overridden or    modified dynamically.
+          * Defines the tab items that appear within the tab group.  The `tabItems` property supports dynamic updates.  - When items are added or removed, the tab group      will update tabs and overflow layout automatically.
           * @vegaVersion 1.3.0
          */
         "tabItems"?: TabConfig[];
@@ -12288,6 +12427,7 @@ declare namespace LocalJSX {
         "vega-calendar-event": VegaCalendarEvent;
         "vega-calendar-event-preview": VegaCalendarEventPreview;
         "vega-calendar-event-slot": VegaCalendarEventSlot;
+        "vega-calendar-period-switcher": VegaCalendarPeriodSwitcher;
         "vega-card": VegaCard;
         "vega-carousel": VegaCarousel;
         "vega-checkbox": VegaCheckbox;
@@ -12414,6 +12554,7 @@ declare module "@stencil/core" {
             "vega-calendar-event": LocalJSX.VegaCalendarEvent & JSXBase.HTMLAttributes<HTMLVegaCalendarEventElement>;
             "vega-calendar-event-preview": LocalJSX.VegaCalendarEventPreview & JSXBase.HTMLAttributes<HTMLVegaCalendarEventPreviewElement>;
             "vega-calendar-event-slot": LocalJSX.VegaCalendarEventSlot & JSXBase.HTMLAttributes<HTMLVegaCalendarEventSlotElement>;
+            "vega-calendar-period-switcher": LocalJSX.VegaCalendarPeriodSwitcher & JSXBase.HTMLAttributes<HTMLVegaCalendarPeriodSwitcherElement>;
             "vega-card": LocalJSX.VegaCard & JSXBase.HTMLAttributes<HTMLVegaCardElement>;
             "vega-carousel": LocalJSX.VegaCarousel & JSXBase.HTMLAttributes<HTMLVegaCarouselElement>;
             "vega-checkbox": LocalJSX.VegaCheckbox & JSXBase.HTMLAttributes<HTMLVegaCheckboxElement>;

package/dist/types/constants/ui.d.ts

@@ -13,5 +13,5 @@ export declare const FlexWrap: readonly ["nowrap", "wrap", "wrap-reverse"];
 export declare const BoxDisplay: readonly ["block", "inline-block", "none"];
 export declare const BorderStyle: readonly ["solid", "dashed", "dotted", "double", "none"];
 export declare const TextAlign: readonly ["start", "end", "left", "right", "center", "justify"];
-export declare const VegaNativeEventName: readonly ["change", "userChange", "click", "focus", "blur", "close", "modalOpen", "validate", "formSubmit", "formReset", "rowClick", "rowExpand", "selectChange", "selectAllChange", "pageSizeChange", "dropdownClick", "create", "search", "searchTrigger", "hide", "show", "popoverShow", "popoverHide", "cancel", "remove", "pageUpdate", "currentStepUpdate", "toggleStatus", "stateUpdate", "groupClick", "menuClick", "accordionExpand", "dropdownShow", "dropdownHide", "dropdownSearch", "actionClick", "eventClick", "dateDblClick", "dateClick", "countryChange", "actionButtonClick", "moreActionClick", "expand", "rowSelect", "rowSelectAll", "retry", "selectedFileChange", "preview", "labelButtonClick", "imageInserted", "reset", "eventPreviewShow", "monthYearChange", "complete", "paste", "clear", "periodChange", "selectionChange", "suggestionItemClick", "nativeInputChange", "sourceCodeChange", "rowDragDrop", "eventEdit", "todayClick"];
+export declare const VegaNativeEventName: readonly ["change", "userChange", "click", "focus", "blur", "close", "modalOpen", "validate", "formSubmit", "formReset", "rowClick", "rowExpand", "selectChange", "selectAllChange", "pageSizeChange", "dropdownClick", "create", "search", "searchTrigger", "hide", "show", "popoverShow", "popoverHide", "cancel", "remove", "pageUpdate", "currentStepUpdate", "toggleStatus", "stateUpdate", "groupClick", "menuClick", "accordionExpand", "dropdownShow", "dropdownHide", "dropdownSearch", "actionClick", "eventClick", "dateDblClick", "dateClick", "countryChange", "actionButtonClick", "moreActionClick", "expand", "rowSelect", "rowSelectAll", "retry", "selectedFileChange", "preview", "labelButtonClick", "imageInserted", "reset", "eventPreviewShow", "monthYearChange", "complete", "paste", "clear", "periodChange", "selectionChange", "suggestionItemClick", "nativeInputChange", "sourceCodeChange", "rowDragDrop", "eventEdit", "todayClick", "additionalLinkClick"];
 export declare const CssStates: readonly ["default", "hover", "active", "focus-visible"];

package/dist/types/helpers/calendar/calendar-period/calendar-period.abstract.d.ts

@@ -92,6 +92,12 @@ export declare abstract class CalendarPeriod {
    * @returns {this} - The updated period
    */
   abstract previous(): this;
+  /**
+   * Get the summary of the current period for view.
+   *
+   * @returns {string} The summary of the current period for view.
+   */
+  abstract getViewDateSummary(): string;
   /**
    * Create a new period by the given date.
    *

package/dist/types/helpers/calendar/calendar-period/day-period.d.ts

@@ -22,6 +22,10 @@ export declare class DayPeriod extends CalendarPeriod {
    * @returns {this} - The current period.
    */
   now(): this;
+  /**
+   * @inheritDoc
+   */
+  getViewDateSummary(): string;
   /**
    * @inheritDoc
    */

package/dist/types/helpers/calendar/calendar-period/internal-calendar-period-factory.d.ts

@@ -0,0 +1,33 @@
+import { VegaCalendarPeriodType } from '../../../components/vega-calendar/types';
+import { CalendarPeriod } from './calendar-period.abstract';
+/**
+ * Factory class for creating CalendarPeriod instances and converting them to VegaCalendarPeriodType.
+ */
+export declare class InternalCalendarPeriodConverter {
+  /**
+   * Create a CalendarPeriod instance based on the specified view mode and date string.
+   *
+   * @param {string} dateString - The date string to base the period on, in 'MM/DD/YYYY' format
+   * @param {'month'|'week'|'day'} [viewMode='month'] - The view mode for the period, defaults to 'month'
+   * @param {string} [timezone] - Optional timezone for the period calculation
+   * @param {boolean} [showWeekends=true] - Whether to show weekends in the period, It's flag for calendar component, will effect the calendar view only.
+   * @returns {CalendarPeriod} The created CalendarPeriod instance
+   */
+  static createCalendarPeriod(dateString: string, viewMode?: 'month' | 'week' | 'day', timezone?: string, showWeekends?: boolean): CalendarPeriod;
+  /**
+   * Convert a VegaCalendarPeriodType to calendar period
+   *
+   * @param {VegaCalendarPeriodType} periodType - The converted period type
+   * @param {string} [timezone] - Optional timezone for the period calculation
+   * @param {boolean} [showWeekends=true] - Whether to show weekends in the period, It's flag for calendar component, will effect the calendar view only.
+   * @returns {CalendarPeriod} - The period to convert
+   */
+  static fromCalendarPeriodType(periodType: VegaCalendarPeriodType, timezone?: string, showWeekends?: boolean): CalendarPeriod;
+  /**
+   * Convert a period to VegaCalendarPeriodType
+   *
+   * @param {CalendarPeriod} period - The period to convert
+   * @returns {VegaCalendarPeriodType} The converted period type
+   */
+  static toCalendarPeriodType(period: CalendarPeriod): VegaCalendarPeriodType;
+}