@globalpayments/vega 2.87.0 → 2.89.0

package/dist/types/components.d.ts

@@ -5,12 +5,12 @@
  * It contains typing information for all components that exist in this project.
  */
 import { HTMLStencilElement, JSXBase } from "./stencil-public-runtime";
+import { BackgroundColorsTokenType, BorderColorsTokenType, BordersTokenType, BreakpointsTokenType, ShadowsTokenType, SpacingTokenType, TextColorsTokenType, TypographyTokenType } from "./types/design-token.type";
 import { BorderStyleType, BoxDisplayType, CornersType, CssStatesType, DragDropEventPayload, ElementAppenderAlignmentType, ElementAppenderPlacementType, FlexAlignItemType, FlexDirectionType, FlexJustifyContentType, FlexWrapType, GapType, GridColumnsType, GridJustifyItemsType, GridRowsType, HeightType, IconAlignType, MarginType, MaxHeightType, MinHeightType, PaddingType, PlacementType, PositionAlignmentType, ResponsiveType, SizeType, StateVariantType, TextAlignType, TranslocationType, VegaComponentInterface, VegaEATriggerType, VegaFlexProps, WidthType } from "./types/ui.type";
 import { LinkTargetType, VegaAppFooterLink } from "./components/vega-app-footer/types";
 import { VegaAppHeaderAvatarConfig, VegaAppHeaderButtonDropdownConfig, VegaAppHeaderButtonSize, VegaAppHeaderLabelConfig } from "./components/vega-app-header-button/types";
 import { VegaBannerActionButtonType, VegaBannerPropType } from "./components/vega-banner/types";
 import { VegaBarChartOptionsType } from "./components/vega-chart/vega-bar-chart/types";
-import { BackgroundColorsTokenType, BorderColorsTokenType, BordersTokenType, BreakpointsTokenType, ShadowsTokenType, SpacingTokenType, TextColorsTokenType, TypographyTokenType } from "./types/design-token.type";
 import { AlignSelfType, FlexBasisType, FlexGrowType, FlexShrinkType, FlexType, GridAreaType, GridColumnType, GridRowType, JustifySelfType, OrderType } from "./components/vega-box/interface";
 import { VegaBreadcrumbCollapsedThresholdType, VegaBreadcrumbItemType } from "./components/vega-breadcrumb/types";
 import { VegaButtonIconAlign, VegaButtonSize, VegaButtonType, VegaButtonVariant } from "./components/vega-button/types";
@@ -56,6 +56,7 @@ import { VegaRTEExtension } from "./components/vega-rich-text-editor/extensions/
 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 { VegaRTESpecialCharacterCategory } from "./components/vega-rich-text-editor/extensions/special-characters/types";
 import { RTETableCellBlock } from "./components/vega-rich-text-editor/extensions/table/dto/table-cell-block";
 import { VegaSectionTitleSizeType } from "./components/vega-section-title/types";
 import { VegaSegmentControlVariant, VegaSegmentProps } from "./components/vega-segment-control/types";
@@ -111,6 +112,12 @@ export namespace Components {
           * @vegaVersion 1.3.0
          */
         "showExpandIcon": ResponsiveType<boolean>;
+        /**
+          * Specifies the background color of the accordion header row    (prefix icon, title and expand icon).  When unset, the header has no background of its own.
+          * @VegaWarning Note: To ensure sufficient visual contrast and maintain accessibility standards, avoid choosing a background color that closely matches the expand icon color (such as `bg-action`), as it may make the icon difficult to perceive.
+          * @vegaVersion 2.88.0
+         */
+        "titleBackgroundColor": BackgroundColorsTokenType;
     }
     interface VegaAppFooter {
         /**
@@ -1008,6 +1015,7 @@ export namespace Components {
         "readOnly": boolean;
         /**
           * Specifies whether to display the copy button in the code block.
+          * @VegaWarning Only has effect when `readOnly` is `true`.
           * @vegaVersion 2.50.0
          */
         "showCopyButton": boolean;
@@ -1063,6 +1071,12 @@ export namespace Components {
           * @vegaVersion 1.13.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.89.0
+         */
+        "optional": boolean;
         /**
           * Specifies whether a color must be selected for    the color picker to pass form validation.
           * @vegaVersion 1.13.0
@@ -1201,6 +1215,11 @@ export namespace Components {
           * @vegaVersion 1.11.0
          */
         "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.
+          * @vegaVersion 2.89.0
+         */
+        "containerMaxHeight": ResponsiveType<MaxHeightType>;
         /**
           * Specifies whether the combo box element is disabled.
           * @vegaVersion 1.11.0
@@ -1226,6 +1245,12 @@ export namespace Components {
           * @vegaVersion 1.11.0
          */
         "open": () => Promise<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.88.0
+         */
+        "optional": boolean;
         /**
           * Sets a placeholder string that provides a temporary hint    or example inside the combo box input field.  It indicates the expected format or pattern of the input.
           * @vegaVersion 1.11.0
@@ -1364,6 +1389,12 @@ export namespace Components {
           * @vegaVersion 1.3.0
          */
         "mode": DatePickerModeType;
+        /**
+          * 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.89.0
+         */
+        "optional": boolean;
         /**
           * Specifies a placeholder string that displays as a temporary hint    or example inside the date picker field.  It indicates the expected format or pattern of the date picker field.
           * @vegaVersion 1.3.0
@@ -1474,10 +1505,10 @@ export namespace Components {
          */
         "showYearMonthDropdowns": boolean;
         /**
-          * Renders the calendar picker in different sizes. Defaults to regular size
+          * Renders the calendar picker in different sizes. Defaults to regular size.    Responsive sizing is supported starting with version 2.88.0.
           * @vegaVersion 2.72.0
          */
-        "size": DatePickerCalendarSizeType;
+        "size": ResponsiveType<DatePickerCalendarSizeType>;
         /**
           * Specifies the calendar is static height.    It means the height of calendar will not change according to the number of weeks in the month.
           * @vegaVersion 2.72.0
@@ -1819,6 +1850,12 @@ export namespace Components {
           * @vegaVersion 1.10.0
          */
         "label": string;
+        /**
+          * Indicates whether the field should be presented as optional.  This property only takes effect when `isFieldRequired` is `false`. When `true`, an "optional" label is displayed next to the field label.
+          * @default false
+          * @vegaVersion 2.88.0
+         */
+        "optional": boolean;
         /**
           * Specifies the properties for the suffix button associated with the input.  It provides essential information and functionality related to    the suffix button's role and behavior.
           * @vegaVersion 2.68.0
@@ -1867,6 +1904,12 @@ export namespace Components {
           * @vegaVersion 2.36.0
          */
         "maxCount": number | null;
+        /**
+          * 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.88.0
+         */
+        "optional": boolean;
         /**
           * Specifies whether uploading a file is mandatory.
           * @vegaVersion 2.25.0
@@ -2154,6 +2197,12 @@ export namespace Components {
           * @vegaVersion 2.5.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.89.0
+         */
+        "optional": boolean;
         /**
           * Specifies whether uploading an image is mandatory.
           * @vegaVersion 1.14.0
@@ -2320,6 +2369,12 @@ export namespace Components {
           * @vegaVersion 1.0.5
          */
         "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.88.0
+         */
+        "optional": boolean;
         /**
           * Sets the placeholder text displayed inside the input when the value is empty.  Use this to provide a short hint about the expected input format or content (e.g., `'Enter your email'`, `'MM/DD/YYYY'`). The placeholder text disappears as soon as the user begins typing.  **Note:** Placeholder text is not a substitute for a `label` — always provide a descriptive label for accessibility.
           * @vegaVersion 1.3.0
@@ -2509,6 +2564,12 @@ export namespace Components {
           * @vegaVersion 2.29.0
          */
         "minorIncrement": number;
+        /**
+          * 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.89.0
+         */
+        "optional": boolean;
         /**
           * Specifies placeholder text displayed inside the input field when it is empty. The placeholder disappears once the user begins typing and is typically used to indicate the expected format (e.g., `'0.00'`).
           * @default undefined
@@ -2613,6 +2674,12 @@ export namespace Components {
           * @vegaVersion 2.66.0
          */
         "length": number;
+        /**
+          * 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.88.0
+         */
+        "optional": boolean;
         /**
           * Determines whether the passcode field must have a value before the form can be submitted. When `true`, the built-in `RequiredFieldRule` is applied during validation and a required indicator is shown on the label.
           * @default false
@@ -2687,6 +2754,12 @@ export namespace Components {
           * @vegaVersion 2.18.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.88.0
+         */
+        "optional": boolean;
         /**
           * Specifies placeholder text displayed inside the phone number text field when it is empty. The placeholder disappears once the user begins typing and is typically used to indicate the expected format (e.g., `'(555) 555-5555'`).
           * @default undefined
@@ -2754,6 +2827,12 @@ export namespace Components {
           * @vegaVersion 2.2.0
          */
         "min": number;
+        /**
+          * 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.89.0
+         */
+        "optional": boolean;
         /**
           * Specifies a placeholder string that displays as a temporary hint    or example inside the input field.  It indicates the expected format or pattern of the input.
           * @vegaVersion 2.2.0
@@ -2846,6 +2925,12 @@ export namespace Components {
           * @vegaVersion 2.68.0
          */
         "labelSuffixButtonConfig": Nullable<LabelSuffixButtonConfig>;
+        /**
+          * 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.89.0
+         */
+        "optional": boolean;
         /**
           * Specifies a placeholder string that displays as a temporary hint or    example inside the input select field.  It indicates the expected format or pattern of the input.
           * @vegaVersion 1.0.7
@@ -3602,6 +3687,12 @@ export namespace Components {
           * @vegaVersion 2.34.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.88.0
+         */
+        "optional": boolean;
         /**
           * Specifies a placeholder string that displays as a    temporary hint or example within the rich text editor.  It indicates the expected format or pattern of    the input within the rich text editor.
           * @vegaVersion 2.34.0
@@ -3716,6 +3807,18 @@ export namespace Components {
          */
         "target": HTMLElement;
     }
+    interface VegaRichTextSpecialCharactersPanel {
+        /**
+          * The special character categories to display.
+          * @vegaVersion 2.88.0
+         */
+        "categories": VegaRTESpecialCharacterCategory[];
+        /**
+          * Resets the panel to its initial state (all categories, no hovered item) and moves focus to the category select. Called whenever the popover opens.
+          * @vegaVersion 2.88.0
+         */
+        "resetPanel": () => Promise<void>;
+    }
     interface VegaRichTextTableProperties {
         /**
           * @vegaVersion 2.79.0
@@ -3970,6 +4073,12 @@ export namespace Components {
           * @vegaVersion 2.7.0
          */
         "layout": 'vertical' | 'horizontal';
+        /**
+          * 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.89.0
+         */
+        "optional": boolean;
         /**
           * Indicates whether at least one selection tile in the    selection tile group must be checked to pass    form validation.
           * @vegaVersion 2.7.0
@@ -4088,6 +4197,12 @@ export namespace Components {
           * @vegaVersion 2.19.0
          */
         "mode": VegaSignatureCaptureMode;
+        /**
+          * 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.89.0
+         */
+        "optional": boolean;
         /**
           * Specifies a placeholder string that displays as a temporary hint    or example inside the signature capture.  It indicates the expected format or pattern of the signature capture.
           * @vegaVersion 2.19.0
@@ -4585,6 +4700,11 @@ export namespace Components {
           * @vegaVersion 1.18.0
          */
         "overflow": 'ellipsis' | 'newline';
+        /**
+          * Specifies the text content to display.
+          * @vegaVersion 2.89.0
+         */
+        "text": string;
         /**
           * Specifies the properties of the vega-tooltip in vega-text.
           * @vegaVersion 2.0.0
@@ -4640,6 +4760,12 @@ export namespace Components {
           * @vegaVersion 1.11.0
          */
         "minLength": number;
+        /**
+          * 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.88.0
+         */
+        "optional": boolean;
         /**
           * Specifies a placeholder string that displays as a temporary hint or example within the text area. The placeholder text is shown when the field is empty and disappears once the user begins typing.  Use this to indicate the expected format or content of the input, for example `'Enter your comments here...'`.
           * @default ''
@@ -4714,6 +4840,12 @@ export namespace Components {
           * @vegaVersion 1.48.0
          */
         "mode": TimePickerModeType;
+        /**
+          * 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.89.0
+         */
+        "optional": boolean;
         /**
           * Specifies placeholder strings that provide a temporary hint    or example inside the time input field.
           * @vegaVersion 1.12.0
@@ -4791,6 +4923,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.89.0
+         */
+        "optional": boolean;
         /**
           * Specifies whether the toggle switch must be checked    to pass form validation.
           * @vegaVersion 2.25.0
@@ -5112,6 +5250,10 @@ export interface VegaRichTextLinkEditorCustomEvent<T> extends CustomEvent<T> {
     detail: T;
     target: HTMLVegaRichTextLinkEditorElement;
 }
+export interface VegaRichTextSpecialCharactersPanelCustomEvent<T> extends CustomEvent<T> {
+    detail: T;
+    target: HTMLVegaRichTextSpecialCharactersPanelElement;
+}
 export interface VegaRichTextTablePropertiesCustomEvent<T> extends CustomEvent<T> {
     detail: T;
     target: HTMLVegaRichTextTablePropertiesElement;
@@ -5681,6 +5823,12 @@ declare global {
         prototype: HTMLVegaRichTextLinkEditorElement;
         new (): HTMLVegaRichTextLinkEditorElement;
     };
+    interface HTMLVegaRichTextSpecialCharactersPanelElement extends Components.VegaRichTextSpecialCharactersPanel, HTMLStencilElement {
+    }
+    var HTMLVegaRichTextSpecialCharactersPanelElement: {
+        prototype: HTMLVegaRichTextSpecialCharactersPanelElement;
+        new (): HTMLVegaRichTextSpecialCharactersPanelElement;
+    };
     interface HTMLVegaRichTextTablePropertiesElement extends Components.VegaRichTextTableProperties, HTMLStencilElement {
     }
     var HTMLVegaRichTextTablePropertiesElement: {
@@ -5986,6 +6134,7 @@ declare global {
         "vega-rich-text-editor-toolbar-button": HTMLVegaRichTextEditorToolbarButtonElement;
         "vega-rich-text-image-editor": HTMLVegaRichTextImageEditorElement;
         "vega-rich-text-link-editor": HTMLVegaRichTextLinkEditorElement;
+        "vega-rich-text-special-characters-panel": HTMLVegaRichTextSpecialCharactersPanelElement;
         "vega-rich-text-table-properties": HTMLVegaRichTextTablePropertiesElement;
         "vega-rich-text-table-selection-widget": HTMLVegaRichTextTableSelectionWidgetElement;
         "vega-rich-text-table-setting": HTMLVegaRichTextTableSettingElement;
@@ -6078,6 +6227,12 @@ declare namespace LocalJSX {
           * @vegaVersion 1.3.0
          */
         "showExpandIcon"?: ResponsiveType<boolean>;
+        /**
+          * Specifies the background color of the accordion header row    (prefix icon, title and expand icon).  When unset, the header has no background of its own.
+          * @VegaWarning Note: To ensure sufficient visual contrast and maintain accessibility standards, avoid choosing a background color that closely matches the expand icon color (such as `bg-action`), as it may make the icon difficult to perceive.
+          * @vegaVersion 2.88.0
+         */
+        "titleBackgroundColor"?: BackgroundColorsTokenType;
     }
     interface VegaAppFooter {
         /**
@@ -7014,11 +7169,28 @@ declare namespace LocalJSX {
           * @vegaVersion 2.0.0
          */
         "onChange"?: (event: VegaCheckboxCustomEvent<string | boolean>) => void;
+        /**
+          * An event emitter notifying changes in the value of the checkbox    triggered exclusively by user interaction (mouse click or keyboard activation).
+          * @eventSemantics namespace:native
+          * @vegaVersion 2.89.0
+         */
+        "onUserChange"?: (event: VegaCheckboxCustomEvent<string | boolean>) => void;
         /**
           * An event emitter notifying changes in the value of the checkbox,    whether triggered programmatically or through user interaction.
           * @vegaVersion 1.0.10
          */
         "onVegaChange"?: (event: VegaCheckboxCustomEvent<string | boolean>) => void;
+        /**
+          * An event emitter notifying changes in the value of the checkbox    triggered exclusively by user interaction (mouse click or keyboard activation).  Unlike `vegaChange`, this event does NOT fire when the `checked` or `value`    prop is reassigned programmatically. Use this event when you want to react    only to real user input (e.g., analytics, derived "select all" state).
+          * @remarks Calling `event.preventDefault()` is a no-op — it does not roll back `checked`/`value` nor suppress the paired `vegaChange` event. `cancelable: true` is retained only for parity with `vegaChange`.
+          * @see {module :vega-checkbox-user-change}
+          * @see {module :vega-checkbox-user-change-keyboard}
+          * @see {module :vega-checkbox-user-change-keyboard-enter}
+          * @see {module :vega-checkbox-user-change-programmatic}
+          * @see {module :vega-checkbox-user-change-containment}
+          * @vegaVersion 2.89.0
+         */
+        "onVegaUserChange"?: (event: VegaCheckboxCustomEvent<string | boolean>) => void;
         /**
           * Specifies whether the checkbox must be checked    to pass form validation.
           * @vegaVersion 1.3.0
@@ -7067,11 +7239,26 @@ declare namespace LocalJSX {
           * @vegaVersion 2.0.0
          */
         "onChange"?: (event: VegaCheckboxGroupCustomEvent<string[]>) => void;
+        /**
+          * An event emitter notifying changes in the value   of any nested checkbox within the checkbox group,   triggered exclusively by user interaction (mouse click or keyboard activation).
+          * @eventSemantics namespace:native
+          * @vegaVersion 2.89.0
+         */
+        "onUserChange"?: (event: VegaCheckboxGroupCustomEvent<string[]>) => void;
         /**
           * An event emitter notifying changes in the value   of any nested checkbox within the checkbox group,   whether triggered programmatically or through   user interaction.
           * @vegaVersion 1.0.10
          */
         "onVegaChange"?: (event: VegaCheckboxGroupCustomEvent<string[]>) => void;
+        /**
+          * An event emitter notifying changes in the value of the checkbox group   triggered exclusively by user interaction (mouse click or keyboard   activation) on a nested checkbox.  Unlike `vegaChange`, this event does NOT fire when the `value` prop   is reassigned programmatically. Use this event when you want to   react only to real user input (e.g., analytics, derived   "select all" state).
+          * @remarks Calling `event.preventDefault()` is a no-op — it does not roll back `value` nor suppress the paired `vegaChange` event. `cancelable: true` is retained only for parity with `vegaChange`.
+          * @see {module :vega-checkbox-group-user-change}
+          * @see {module :vega-checkbox-group-user-change-programmatic}
+          * @see {module :vega-checkbox-group-user-change-no-double}
+          * @vegaVersion 2.89.0
+         */
+        "onVegaUserChange"?: (event: VegaCheckboxGroupCustomEvent<string[]>) => void;
         /**
           * Indicates whether at least one checkbox in the    checkbox group must be checked to pass    form validation.
           * @vegaVersion 1.3.0
@@ -7212,6 +7399,7 @@ declare namespace LocalJSX {
         "readOnly"?: boolean;
         /**
           * Specifies whether to display the copy button in the code block.
+          * @VegaWarning Only has effect when `readOnly` is `true`.
           * @vegaVersion 2.50.0
          */
         "showCopyButton"?: boolean;
@@ -7278,6 +7466,12 @@ declare namespace LocalJSX {
           * @vegaVersion 1.13.0
          */
         "onVegaChange"?: (event: VegaColorPickerCustomEvent<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.89.0
+         */
+        "optional"?: boolean;
         /**
           * Specifies whether a color must be selected for    the color picker to pass form validation.
           * @vegaVersion 1.13.0
@@ -7433,6 +7627,11 @@ declare namespace LocalJSX {
           * @vegaVersion 1.11.0
          */
         "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.
+          * @vegaVersion 2.89.0
+         */
+        "containerMaxHeight"?: ResponsiveType<MaxHeightType>;
         /**
           * Specifies whether the combo box element is disabled.
           * @vegaVersion 1.11.0
@@ -7486,6 +7685,12 @@ declare namespace LocalJSX {
           * @vegaVersion 1.24.0
          */
         "onVegaSearch"?: (event: VegaComboBoxCustomEvent<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.88.0
+         */
+        "optional"?: boolean;
         /**
           * Sets a placeholder string that provides a temporary hint    or example inside the combo box input field.  It indicates the expected format or pattern of the input.
           * @vegaVersion 1.11.0
@@ -7634,6 +7839,12 @@ declare namespace LocalJSX {
           * @vegaVersion 2.61.0
          */
         "onVegaMonthYearChange"?: (event: VegaDatePickerCustomEvent<DatePickerMonthYearTypes>) => 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.89.0
+         */
+        "optional"?: boolean;
         /**
           * Specifies a placeholder string that displays as a temporary hint    or example inside the date picker field.  It indicates the expected format or pattern of the date picker field.
           * @vegaVersion 1.3.0
@@ -7746,6 +7957,12 @@ declare namespace LocalJSX {
           * @vegaVersion 2.72.0
          */
         "onSelectionChange"?: (event: VegaDatePickerCalendarCustomEvent<string | string[]>) => void;
+        /**
+          * An event emitter notifying the today button is clicked in the date picker.
+          * @eventSemantics namespace:native
+          * @vegaVersion 2.88.0
+         */
+        "onTodayClick"?: (event: VegaDatePickerCalendarCustomEvent<string>) => void;
         /**
           * An event emitter notifying the change of the value in the date picker,    whether triggered programmatically or through user interaction.
           * @vegaVersion 2.72.0
@@ -7761,6 +7978,11 @@ declare namespace LocalJSX {
           * @vegaVersion 2.72.0
          */
         "onVegaSelectionChange"?: (event: VegaDatePickerCalendarCustomEvent<string | string[]>) => void;
+        /**
+          * An event emitter notifying the today button is clicked in the date picker.
+          * @vegaVersion 2.88.0
+         */
+        "onVegaTodayClick"?: (event: VegaDatePickerCalendarCustomEvent<string>) => void;
         /**
           * Specifies the selected date or date range in the date picker calendar.
           * @vegaVersion 2.72.0
@@ -7772,10 +7994,10 @@ declare namespace LocalJSX {
          */
         "showYearMonthDropdowns"?: boolean;
         /**
-          * Renders the calendar picker in different sizes. Defaults to regular size
+          * Renders the calendar picker in different sizes. Defaults to regular size.    Responsive sizing is supported starting with version 2.88.0.
           * @vegaVersion 2.72.0
          */
-        "size"?: DatePickerCalendarSizeType;
+        "size"?: ResponsiveType<DatePickerCalendarSizeType>;
         /**
           * Specifies the calendar is static height.    It means the height of calendar will not change according to the number of weeks in the month.
           * @vegaVersion 2.72.0
@@ -8185,6 +8407,12 @@ declare namespace LocalJSX {
           * @vegaVersion 2.25.0
          */
         "onVegaLabelButtonClick"?: (event: VegaFieldLabelCustomEvent<any>) => void;
+        /**
+          * Indicates whether the field should be presented as optional.  This property only takes effect when `isFieldRequired` is `false`. When `true`, an "optional" label is displayed next to the field label.
+          * @default false
+          * @vegaVersion 2.88.0
+         */
+        "optional"?: boolean;
         /**
           * Specifies the properties for the suffix button associated with the input.  It provides essential information and functionality related to    the suffix button's role and behavior.
           * @vegaVersion 2.68.0
@@ -8288,6 +8516,12 @@ declare namespace LocalJSX {
           * @vegaVersion 2.25.0
          */
         "onVegaSelectedFileChange"?: (event: VegaFileUploaderCustomEvent<VegaFileUploaderFiles>) => 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.88.0
+         */
+        "optional"?: boolean;
         /**
           * Specifies whether uploading a file is mandatory.
           * @vegaVersion 2.25.0
@@ -8602,6 +8836,12 @@ declare namespace LocalJSX {
           * @vegaVersion 1.14.0
          */
         "onVegaRemove"?: (event: VegaImageUploaderCustomEvent<any>) => 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.89.0
+         */
+        "optional"?: boolean;
         /**
           * Specifies whether uploading an image is mandatory.
           * @vegaVersion 1.14.0
@@ -8841,6 +9081,12 @@ declare namespace LocalJSX {
           * @vegaVersion 2.75.0
          */
         "onVegaSuggestionItemClick"?: (event: VegaInputCustomEvent<VegaDropdownSourceItem>) => 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.88.0
+         */
+        "optional"?: boolean;
         /**
           * Sets the placeholder text displayed inside the input when the value is empty.  Use this to provide a short hint about the expected input format or content (e.g., `'Enter your email'`, `'MM/DD/YYYY'`). The placeholder text disappears as soon as the user begins typing.  **Note:** Placeholder text is not a substitute for a `label` — always provide a descriptive label for accessibility.
           * @vegaVersion 1.3.0
@@ -9069,6 +9315,12 @@ declare namespace LocalJSX {
           * @vegaVersion 2.29.0
          */
         "onVegaChange"?: (event: VegaInputNumericCustomEvent<number>) => 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.89.0
+         */
+        "optional"?: boolean;
         /**
           * Specifies placeholder text displayed inside the input field when it is empty. The placeholder disappears once the user begins typing and is typically used to indicate the expected format (e.g., `'0.00'`).
           * @default undefined
@@ -9199,6 +9451,12 @@ declare namespace LocalJSX {
           * @vegaVersion 2.66.0
          */
         "onVegaComplete"?: (event: VegaInputPasscodeCustomEvent<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.88.0
+         */
+        "optional"?: boolean;
         /**
           * Determines whether the passcode field must have a value before the form can be submitted. When `true`, the built-in `RequiredFieldRule` is applied during validation and a required indicator is shown on the label.
           * @default false
@@ -9299,6 +9557,12 @@ declare namespace LocalJSX {
           * @vegaVersion 2.18.0
          */
         "onVegaCountryChange"?: (event: VegaInputPhoneNumberCustomEvent<VegaCountryType>) => 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.88.0
+         */
+        "optional"?: boolean;
         /**
           * Specifies placeholder text displayed inside the phone number text field when it is empty. The placeholder disappears once the user begins typing and is typically used to indicate the expected format (e.g., `'(555) 555-5555'`).
           * @default undefined
@@ -9377,6 +9641,12 @@ declare namespace LocalJSX {
           * @vegaVersion 2.2.0
          */
         "onVegaChange"?: (event: VegaInputRangeCustomEvent<[number, number]>) => 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.89.0
+         */
+        "optional"?: boolean;
         /**
           * Specifies a placeholder string that displays as a temporary hint    or example inside the input field.  It indicates the expected format or pattern of the input.
           * @vegaVersion 2.2.0
@@ -9508,6 +9778,12 @@ declare namespace LocalJSX {
           * @vegaVersion 2.32.0
          */
         "onVegaShow"?: (event: VegaInputSelectCustomEvent<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.89.0
+         */
+        "optional"?: boolean;
         /**
           * Specifies a placeholder string that displays as a temporary hint or    example inside the input select field.  It indicates the expected format or pattern of the input.
           * @vegaVersion 1.0.7
@@ -10408,6 +10684,12 @@ declare namespace LocalJSX {
           * @vegaVersion 2.78.0
          */
         "onVegaSourceCodeChange"?: (event: VegaRichTextEditorCustomEvent<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.88.0
+         */
+        "optional"?: boolean;
         /**
           * Specifies a placeholder string that displays as a    temporary hint or example within the rich text editor.  It indicates the expected format or pattern of    the input within the rich text editor.
           * @vegaVersion 2.34.0
@@ -10548,6 +10830,23 @@ declare namespace LocalJSX {
          */
         "target"?: HTMLElement;
     }
+    interface VegaRichTextSpecialCharactersPanel {
+        /**
+          * The special character categories to display.
+          * @vegaVersion 2.88.0
+         */
+        "categories"?: VegaRTESpecialCharacterCategory[];
+        /**
+          * Emitted when a character cell is clicked. The payload is the Unicode character string.
+          * @vegaVersion 2.88.0
+         */
+        "onClick"?: (event: VegaRichTextSpecialCharactersPanelCustomEvent<string>) => void;
+        /**
+          * Emitted when a character cell is clicked. The payload is the Unicode character string.
+          * @vegaVersion 2.88.0
+         */
+        "onVegaClick"?: (event: VegaRichTextSpecialCharactersPanelCustomEvent<string>) => void;
+    }
     interface VegaRichTextTableProperties {
         /**
           * @vegaVersion 2.79.0
@@ -10878,6 +11177,12 @@ declare namespace LocalJSX {
           * @vegaVersion 2.7.0
          */
         "onVegaChange"?: (event: VegaSelectionTileGroupCustomEvent<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.89.0
+         */
+        "optional"?: boolean;
         /**
           * Indicates whether at least one selection tile in the    selection tile group must be checked to pass    form validation.
           * @vegaVersion 2.7.0
@@ -11019,6 +11324,12 @@ declare namespace LocalJSX {
           * @vegaVersion 2.19.0
          */
         "onVegaChange"?: (event: VegaSignatureCaptureCustomEvent<VegaSignatureValue>) => 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.89.0
+         */
+        "optional"?: boolean;
         /**
           * Specifies a placeholder string that displays as a temporary hint    or example inside the signature capture.  It indicates the expected format or pattern of the signature capture.
           * @vegaVersion 2.19.0
@@ -11549,6 +11860,11 @@ declare namespace LocalJSX {
           * @vegaVersion 1.18.0
          */
         "overflow"?: 'ellipsis' | 'newline';
+        /**
+          * Specifies the text content to display.
+          * @vegaVersion 2.89.0
+         */
+        "text"?: string;
         /**
           * Specifies the properties of the vega-tooltip in vega-text.
           * @vegaVersion 2.0.0
@@ -11643,6 +11959,12 @@ declare namespace LocalJSX {
           * @vegaVersion 2.68.0
          */
         "onVegaLabelButtonClick"?: (event: VegaTextareaCustomEvent<any>) => 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.88.0
+         */
+        "optional"?: boolean;
         /**
           * Specifies a placeholder string that displays as a temporary hint or example within the text area. The placeholder text is shown when the field is empty and disappears once the user begins typing.  Use this to indicate the expected format or content of the input, for example `'Enter your comments here...'`.
           * @default ''
@@ -11728,6 +12050,12 @@ declare namespace LocalJSX {
           * @vegaVersion 1.12.0
          */
         "onVegaChange"?: (event: VegaTimePickerCustomEvent<string | 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.89.0
+         */
+        "optional"?: boolean;
         /**
           * Specifies placeholder strings that provide a temporary hint    or example inside the time input field.
           * @vegaVersion 1.12.0
@@ -11816,6 +12144,12 @@ declare namespace LocalJSX {
           * @vegaVersion 1.3.0
          */
         "onVegaChange"?: (event: VegaToggleSwitchCustomEvent<boolean>) => 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.89.0
+         */
+        "optional"?: boolean;
         /**
           * Specifies whether the toggle switch must be checked    to pass form validation.
           * @vegaVersion 2.25.0
@@ -12018,6 +12352,7 @@ declare namespace LocalJSX {
         "vega-rich-text-editor-toolbar-button": VegaRichTextEditorToolbarButton;
         "vega-rich-text-image-editor": VegaRichTextImageEditor;
         "vega-rich-text-link-editor": VegaRichTextLinkEditor;
+        "vega-rich-text-special-characters-panel": VegaRichTextSpecialCharactersPanel;
         "vega-rich-text-table-properties": VegaRichTextTableProperties;
         "vega-rich-text-table-selection-widget": VegaRichTextTableSelectionWidget;
         "vega-rich-text-table-setting": VegaRichTextTableSetting;
@@ -12143,6 +12478,7 @@ declare module "@stencil/core" {
             "vega-rich-text-editor-toolbar-button": LocalJSX.VegaRichTextEditorToolbarButton & JSXBase.HTMLAttributes<HTMLVegaRichTextEditorToolbarButtonElement>;
             "vega-rich-text-image-editor": LocalJSX.VegaRichTextImageEditor & JSXBase.HTMLAttributes<HTMLVegaRichTextImageEditorElement>;
             "vega-rich-text-link-editor": LocalJSX.VegaRichTextLinkEditor & JSXBase.HTMLAttributes<HTMLVegaRichTextLinkEditorElement>;
+            "vega-rich-text-special-characters-panel": LocalJSX.VegaRichTextSpecialCharactersPanel & JSXBase.HTMLAttributes<HTMLVegaRichTextSpecialCharactersPanelElement>;
             "vega-rich-text-table-properties": LocalJSX.VegaRichTextTableProperties & JSXBase.HTMLAttributes<HTMLVegaRichTextTablePropertiesElement>;
             "vega-rich-text-table-selection-widget": LocalJSX.VegaRichTextTableSelectionWidget & JSXBase.HTMLAttributes<HTMLVegaRichTextTableSelectionWidgetElement>;
             "vega-rich-text-table-setting": LocalJSX.VegaRichTextTableSetting & JSXBase.HTMLAttributes<HTMLVegaRichTextTableSettingElement>;