@heartlandone/vega 2.88.0 → 2.90.0

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

@@ -17,6 +17,18 @@ export declare class VegaText {
    * @vegaVersion 1.18.0
    */
   overflow: 'ellipsis' | 'newline';
+  /**
+   * Specifies the text content to display.
+   *
+   * @vegaVersion 2.89.0
+   */
+  text: string;
+  /**
+   * The below method is e2e-test covered in
+   * @see{module:vega-text-with-dynamic-update-content}
+   */
+  /** Watching the text prop. */
+  watchText(): void;
   /**
    * Specifies the properties of the vega-tooltip in vega-text.
    *
@@ -30,5 +42,12 @@ export declare class VegaText {
   /** Watching the tooltip prop. */
   watchTooltip(): void;
   componentDidLoad(): void;
+  /**
+   * Renders the VegaText component.
+   * span.placeholder-text is used as a placeholder to maintain an optimal, fixed width when the displayed text changes, thereby preventing anomalous line breaks caused by secondary width adjustments within a flex container.
+   * span.width-checker is used to calculate the maximum length of text that can be displayed without overflow based on the available width, which is essential for the tooltip functionality to determine when to show the tooltip and what content to display in it.
+   *
+   * @returns {VegaText} The rendered JSX element.
+   */
   render(): VegaText;
 }

package/dist/types/components/vega-time-picker/slimmers/renderers/vega-time-picker-label-renderer.d.ts

@@ -4,6 +4,7 @@ export declare class VegaTimePickerLabelRenderer extends VegaSlimmer {
   private label;
   private mode;
   private required;
+  private optional;
   private disabled;
   private singleInputRenderer;
   private rangeInputRenderer;

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

@@ -84,6 +84,16 @@ export declare class VegaTimePicker {
    * @vegaVersion 1.12.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.89.0
+   */
+  optional: boolean;
   /**
    * Specifies placeholder strings that provide a temporary hint
    *    or example inside the time input field.

package/dist/types/components/vega-toggle-switch/vega-toggle-switch.d.ts

@@ -48,6 +48,16 @@ export declare class VegaToggleSwitch {
    * @vegaVersion 2.25.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.89.0
+   */
+  optional: boolean;
   /**
    * Specifies whether the toggle switch is disabled.
    *

package/dist/types/components.d.ts

@@ -914,6 +914,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
@@ -1071,6 +1077,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
@@ -1209,6 +1221,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
@@ -1378,6 +1395,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
@@ -2180,6 +2203,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
@@ -2454,6 +2483,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
@@ -2541,6 +2576,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
@@ -2798,6 +2839,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
@@ -2890,6 +2937,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
@@ -3572,6 +3625,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
@@ -3943,6 +4002,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
@@ -4032,6 +4097,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
@@ -4150,6 +4221,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
@@ -4292,7 +4369,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[];
@@ -4647,6 +4724,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
@@ -4782,6 +4864,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
@@ -4859,6 +4947,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
@@ -7099,11 +7193,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
@@ -7152,11 +7263,32 @@ 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 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
@@ -7364,6 +7496,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
@@ -7519,6 +7657,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
@@ -7726,6 +7869,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
@@ -8717,6 +8866,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
@@ -9090,6 +9245,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
@@ -9190,6 +9351,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
@@ -9510,6 +9677,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
@@ -9641,6 +9814,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
@@ -10439,6 +10618,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
@@ -10923,6 +11108,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
@@ -11034,6 +11225,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
@@ -11175,6 +11372,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
@@ -11339,7 +11542,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[];
@@ -11705,6 +11908,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
@@ -11890,6 +12098,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
@@ -11978,6 +12192,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

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", "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"];
 export declare const CssStates: readonly ["default", "hover", "active", "focus-visible"];

package/dist/types/helpers/change-manager/subject/static-subject/static-subject-title.d.ts

@@ -1,5 +1,5 @@
 import { Subject } from '../subject-interface';
-export declare type SubjectTitle = 'SIDENAV_LINK_SELECTED_TOPIC' | 'LEFT_NAV_LINK_SELECTED_TOPIC' | 'ACCORDION_EXPAND_TOPIC' | 'FORM_RESET_OPERATION_TRIGGERED' | 'FORM_FIELD_ELEMENT_DISCONNECTED' | 'FORM_SUBMIT' | 'FORM_RESET' | 'RADIO_GROUP_DISABLED_CHANGE' | 'CHECKBOX_GROUP_DISABLED_CHANGE' | 'FORM_FIELD_PENDING_VALID_CHANGE' | 'TAB_PANEL_ADD_OR_DEL_TO_GROUP' | 'TABLE_EXPAND_ROW' | 'TABLE_ROW_SELECTION' | 'TABLE_ROW_SELECTION_ALL' | 'TABLE_SELECTION' | 'TABLE_ROW_CLICK' | 'TABLE_ROW_SELECT' | 'TABLE_ROW_SELECT_ALL' | 'FIELD_ERROR_MESSAGE_CHANGE' | 'DROPDOWN_ITEM_CLICK' | 'CHECKBOX_VALUE_CHANGE' | 'RADIO_VALUE_CHANGE' | 'FORM_ELEMENT_VALUE_CHANGE' | 'FORM_EMEMENT_VALIDATE' | 'FIELD_ERROR_STATE_CHANGE' | 'VEGA_VIRTUAL_SCROLL_TO_BOTTOM' | 'SELECTION_TILE_VALUE_CHANGE' | 'DROPDOWN_RENDER_ITEM_INTERNAL_OVERRIDEN' | 'DROPDOWN_SEARCH_INTERNAL_OVERRIDEN' | 'UPDATE_TRANSLATION' | 'DARK_MODE_CHANGE' | 'SHADOW_ROOT_ELEMENT_SCROLLING' | 'FLAG_ICON_LOADED' | 'GP_BRAND_CHANGE';
+export declare type SubjectTitle = 'SIDENAV_LINK_SELECTED_TOPIC' | 'LEFT_NAV_LINK_SELECTED_TOPIC' | 'ACCORDION_EXPAND_TOPIC' | 'FORM_RESET_OPERATION_TRIGGERED' | 'FORM_FIELD_ELEMENT_DISCONNECTED' | 'FORM_SUBMIT' | 'FORM_RESET' | 'RADIO_GROUP_DISABLED_CHANGE' | 'CHECKBOX_GROUP_DISABLED_CHANGE' | 'FORM_FIELD_PENDING_VALID_CHANGE' | 'TAB_PANEL_ADD_OR_DEL_TO_GROUP' | 'TABLE_EXPAND_ROW' | 'TABLE_ROW_SELECTION' | 'TABLE_ROW_SELECTION_ALL' | 'TABLE_SELECTION' | 'TABLE_ROW_CLICK' | 'TABLE_ROW_SELECT' | 'TABLE_ROW_SELECT_ALL' | 'FIELD_ERROR_MESSAGE_CHANGE' | 'DROPDOWN_ITEM_CLICK' | 'CHECKBOX_VALUE_CHANGE' | 'CHECKBOX_USER_INTERACTION' | 'RADIO_VALUE_CHANGE' | 'FORM_ELEMENT_VALUE_CHANGE' | 'FORM_EMEMENT_VALIDATE' | 'FIELD_ERROR_STATE_CHANGE' | 'VEGA_VIRTUAL_SCROLL_TO_BOTTOM' | 'SELECTION_TILE_VALUE_CHANGE' | 'DROPDOWN_RENDER_ITEM_INTERNAL_OVERRIDEN' | 'DROPDOWN_SEARCH_INTERNAL_OVERRIDEN' | 'UPDATE_TRANSLATION' | 'DARK_MODE_CHANGE' | 'SHADOW_ROOT_ELEMENT_SCROLLING' | 'FLAG_ICON_LOADED' | 'GP_BRAND_CHANGE';
 export declare const SIDENAV_LINK_SELECTED_TOPIC: Subject;
 export declare const LEFT_NAV_LINK_SELECTED_TOPIC: Subject;
 export declare const ACCORDION_EXPAND_TOPIC: Subject;
@@ -16,6 +16,7 @@ export declare const TABLE_ROW_CLICK: Subject;
 export declare const FIELD_ERROR_MESSAGE_CHANGE: Subject;
 export declare const DROPDOWN_ITEM_CLICK: Subject;
 export declare const CHECKBOX_VALUE_CHANGE: Subject;
+export declare const CHECKBOX_USER_INTERACTION: Subject;
 export declare const RADIO_VALUE_CHANGE: Subject;
 export declare const FORM_ELEMENT_VALUE_CHANGE: Subject;
 export declare const FORM_ELEMENT_VALIDATE: Subject;

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

@@ -45,6 +45,7 @@ export declare class VegaEventID implements VegaEventIDInterface {
   isBrowserRawEvent(): boolean;
 }
 export declare const VegaChange: VegaEventID;
+export declare const VegaUserChange: VegaEventID;
 export declare const VegaClick: VegaEventID;
 export declare const VegaFocus: VegaEventID;
 export declare const VegaBlur: VegaEventID;

package/dist/types/helpers/slimmers/translation/translation-slimmer.d.ts

@@ -7,6 +7,17 @@ import { TranslationKeyMap, TranslationKeyType } from '../../translation/interfa
  */
 export declare class TranslationSlimmer<T extends HTMLStencilElement> extends VegaSlimmer {
   host: T;
+  /**
+   * Component lifecycle - [connectedCallback]
+   *
+   * Registers the host with the translation controller on every (re)connect.
+   * Without this, components whose hosts are moved across the DOM (e.g. popover
+   * slot content that gets appended into the popover content box at show time)
+   * are unregistered by their disconnect but never re-registered until the next
+   * `t()` call, which can leave the global translation observer unable to find
+   * them in `connectedComponents` and skip the re-render on locale change.
+   */
+  connectedCallback(): void;
   /**
    * Component lifecycle - [disconnectedCallback]
    */

package/dist/types/helpers/translation/interface.d.ts

@@ -160,6 +160,10 @@ export type StaticTranslationKey =
 	| 'Paragraph'
 	| 'Reset Selection'
 	| 'Select Language'
+	| 'Functions'
+	| 'Insert function'
+	| 'Conditional'
+	| 'Foreach'
 	| 'Delete Code'
 	| 'Copy Code'
 	| 'Code Block'
@@ -198,6 +202,7 @@ export type StaticTranslationKey =
 	| 'Color {0}'
 	| 'Apply'
 	| 'Enter color'
+	| 'Horizontal line'
 	// RTE Special characters extension
 	| 'Special Characters'
 	| 'All'
@@ -205,4 +210,6 @@ export type StaticTranslationKey =
 	| 'Mathematical'
 	| 'Arrows'
 	| 'Currency'
-	| '(Optional)';
+	| 'Required'
+	| 'Disabled'
+	| 'Optional';