@globalpayments/vega 2.97.0 → 2.98.0

package/dist/collection/components/vega-code-block/slimmers/controllers/code-highlight-parser.abstract.js

@@ -15,6 +15,7 @@ export class CodeHighlightParser extends VegaSlimmer {
    * Split the HTML tag to avoid the content render to a html element.
    *
    * @example <div> -> ['<', 'div', '>']
+   * @example a&nbsp;b -> ['a', '&', 'nbsp;', 'b']
    * @param {string} text - The code content.
    * @returns {string[]} - The code content array.
    */
@@ -22,21 +23,7 @@ export class CodeHighlightParser extends VegaSlimmer {
     if (!this.hasSpecialCharacter(text) || text.length < 2) {
       return [text];
     }
-    else {
-      const result = [];
-      const textArray = text.split('');
-      let nextIndex = 0;
-      textArray.forEach((item) => {
-        if (item === '<' || item === '>' || item === '/') {
-          result.push(item);
-          nextIndex = result.length;
-        }
-        else {
-          result[nextIndex] = result[nextIndex] ? result[nextIndex] + item : item;
-        }
-      });
-      return result;
-    }
+    return text.split(/([<>&/])/).filter(Boolean);
   }
   /**
    * Check the current language is a preset language and the language is not plain text.
@@ -76,10 +63,10 @@ export class CodeHighlightParser extends VegaSlimmer {
    * Check the text has special character.
    *
    * @param {string} text - The test text.
-   * @returns {boolean} - Return true is the text has <, > , /.
+   * @returns {boolean} - Return true is the text has <, > , /, &.
    */
   hasSpecialCharacter(text) {
-    return /[<|>|\\/]/.test(text);
+    return /[<>&/]/.test(text);
   }
 }
 __decorate([

package/dist/collection/components/vega-color-picker/vega-color-picker.js

@@ -18,6 +18,8 @@ import { VegaChange } from '../../helpers/event-manager/event-id/vega-event-id';
 import { VegaComponentUsageRuntimeMetricsSlimmer } from '../../helpers/slimmers/component-usage-runtime-metrics';
 import { VegaColorPickerRuntimeMetricsPayloadDefinition } from '../../constants/runtime-metrics-payload-definition/vega-color-picker/runtime-metrics-payload-definition';
 /**
+ * The color picker component is used to select a color from a predefined palette.
+ *
  * @vegaVersion 1.13.0
  */
 export class VegaColorPicker {

package/dist/collection/components/vega-combo-box/vega-combo-box.js

@@ -25,6 +25,8 @@ import { VegaComboBoxItemsSlotController } from './slimmers/controllers/vega-com
 import { VegaComboBoxSourceController } from './slimmers/controllers/vega-combo-box-source-controller';
 import { PageResizeObserverSlimmer } from '../../helpers/slimmers/page-resize-observer-slimmer';
 /**
+ * The Combo Box is an input field with the ability to select multiple predefined values.
+ *
  * @vegaVersion 1.11.0
  */
 export class VegaComboBox {

package/dist/collection/components/vega-counter-badge/vega-counter-badge.js

@@ -9,6 +9,8 @@ import { sanitizeVegaComponent } from '../../utils/component';
 import { InjectVegaGlobalSlimmer, InjectVegaSlimmer } from 'vega-slimmer/core';
 import { VegaComponentUsageRuntimeMetricsSlimmer } from '../../helpers/slimmers/component-usage-runtime-metrics';
 /**
+ * A Counter Badge visually indicates unread alerts or a count of items, and draws the user's attention through a small emblem or count overlay.
+ *
  * @vegaVersion 1.15.0
  */
 export class VegaCounterBadge {

package/dist/collection/components/vega-date-picker/vega-date-picker.js

@@ -29,6 +29,8 @@ import { DeviceType } from '../../types/ui.type';
 import { getDeviceType } from '../../utils/ui';
 import { VegaDatePickerCalendarOpenStateController } from './slimmers/controllers/vega-date-picker-calendar-open-state-controller';
 /**
+ * The Date Picker allows users to select a date or date range, either by entering a text value or through a calendar interface.
+ *
  * @vegaVersion 1.3.0
  */
 export class VegaDatePicker {

package/dist/collection/components/vega-divider/vega-divider.js

@@ -14,6 +14,8 @@ import { PageResizeObserverSlimmer } from '../../helpers/slimmers/page-resize-ob
 import { getCurrentBreakpoint } from '../../utils/breakpoints';
 import { VegaComponentUsageRuntimeMetricsSlimmer } from '../../helpers/slimmers/component-usage-runtime-metrics';
 /**
+ * A divider is a vertical or horizontal line that separates content or actions on a page.
+ *
  * @vegaVersion 2.10.0
  */
 export class VegaDivider {

package/dist/collection/components/vega-dropdown/constants.js

@@ -1 +1,11 @@
 export const VEGA_DROPDOWN_SELECT_ALL_KEY = '__SELECT_ALL__';
+export const VEGA_DROPDOWN_DEFAULT_CONFIG = {
+  alignment: 'start',
+  caseSensitive: false,
+  isLoading: false,
+  isScreenPosition: false,
+  itemDisplayRule: 'newline',
+  placement: ['bottom', 'top'],
+  positionRelativeTo: undefined,
+  searchNoResultsText: 'No results found',
+};

package/dist/collection/components/vega-dropdown/vega-dropdown.js

@@ -19,6 +19,7 @@ import { VegaDropdownGroupLevelRenderer } from './slimmers/renderers/vega-dropdo
 import { VegaDropdownSearchController } from './slimmers/controllers/vega-dropdown-search-controller';
 import { VegaDropdownSelectedController } from './slimmers/controllers/vega-dropdown-selected-controller';
 import { VegaDropdownRenderModeController } from './slimmers/controllers/vega-dropdown-render-mode-controller';
+import { VEGA_DROPDOWN_DEFAULT_CONFIG } from './constants';
 import { createSubStateNotifySlimmer } from '../../helpers/slimmers/sub-state/sub-state-notify-slimmer';
 import { VegaDropdownChildrenController } from './slimmers/controllers/vega-dropdown-children-controller';
 import { createEventEmitSlimmer, } from '../../helpers/event-manager/slimmers/event-emit-slimmer';
@@ -33,6 +34,8 @@ import { TranslationSlimmer } from '../../helpers/slimmers/translation';
 import { VegaDropdownResetRenderer } from './slimmers/renderers/vega-dropdown-reset-renderer';
 import { VegaDropdownSelectAllController } from './slimmers/controllers/vega-dropdown-select-all-controller';
 /**
+ * The dropdown menu component displays a menu with multiple actions or options, triggered by a button.
+ *
  * @vegaVersion 1.3.0
  */
 export class VegaDropdown {
@@ -163,9 +166,10 @@ export class VegaDropdown {
      * Specifies the display rule for items in the dropdown.
      *
      * @VegaWarning Specifies the display rule for items in the dropdown, only be active if matchTargetWidth is true or maxWidth has value.
+     * @defaultValue 'newline'
      * @vegaVersion 1.13.0
      */
-    this.itemDisplayRule = 'newline';
+    this.itemDisplayRule = VEGA_DROPDOWN_DEFAULT_CONFIG.itemDisplayRule;
     /**
      * Determines if the dropdown height should be automatically adjusted
      *    to fit its container height.
@@ -182,9 +186,10 @@ export class VegaDropdown {
      * Note that the default filter rules are fuzzy matching and case-insensitive.
      *    This parameter only takes effect when `searchable` is set to `true`.
      *
+     * @defaultValue false
      * @vegaVersion 1.4.0
      */
-    this.caseSensitive = false;
+    this.caseSensitive = VEGA_DROPDOWN_DEFAULT_CONFIG.caseSensitive;
     /**
      * Controls whether the dropdown can add a new item when
      *    no proper item is available. It becomes active only when
@@ -210,23 +215,26 @@ export class VegaDropdown {
     /**
      * Determines whether the dropdown displays a loading status.
      *
+     * @defaultValue false
      * @vegaVersion 1.24.0
      */
-    this.isLoading = false;
+    this.isLoading = VEGA_DROPDOWN_DEFAULT_CONFIG.isLoading;
     /**
      * Specifies the vertical positioning of the dropdown
      *    within its container or relative to a reference point.
      *
+     * @defaultValue ['bottom', 'top']
      * @vegaVersion 1.41.0
      */
-    this.placement = ['bottom', 'top'];
+    this.placement = VEGA_DROPDOWN_DEFAULT_CONFIG.placement;
     /**
      * Determines the horizontal positioning of the dropdown
      *    within its container or relative to a reference point.
      *
+     * @defaultValue 'start'
      * @vegaVersion 1.41.0
      */
-    this.alignment = 'start';
+    this.alignment = VEGA_DROPDOWN_DEFAULT_CONFIG.alignment;
     /**
      * Determines whether the dropdown displays a lazy loading status.
      *
@@ -261,9 +269,10 @@ export class VegaDropdown {
      *
      * @VegaWarning - Setting this to `true` override the `positionRelativeTo` and `matchContainerHeight` properties, rendering them ineffective.
      * 			    - Currently, when set to `true`, the position calculation may be inaccurate if the popover is placed inside a scrollable container within a shadowRoot (e.g., inside a vega-modal with scrollable content).
+     * @defaultValue false
      * @vegaVersion 2.36.0
      */
-    this.isScreenPosition = false;
+    this.isScreenPosition = VEGA_DROPDOWN_DEFAULT_CONFIG.isScreenPosition;
     /**
      * Specifies whether the selected option in the dropdown can be cleared.
      *    It allows users to reset the selectedSourceKey when a selection has already been made.
@@ -288,9 +297,10 @@ export class VegaDropdown {
     /**
      * Specifies the no search results text for the dropdown.
      *
+     * @defaultValue 'No results found'
      * @vegaVersion 2.74.0
      */
-    this.searchNoResultsText = 'No results found';
+    this.searchNoResultsText = VEGA_DROPDOWN_DEFAULT_CONFIG.searchNoResultsText;
     /**
      * Allows users to select or deselect all items in the dropdown.
      *    Only applicable when selectType is set to 'multiple'.
@@ -748,6 +758,9 @@ export class VegaDropdown {
         "tags": [{
             "name": "VegaWarning",
             "text": "Specifies the display rule for items in the dropdown, only be active if matchTargetWidth is true or maxWidth has value."
+          }, {
+            "name": "defaultValue",
+            "text": "'newline'"
           }, {
             "name": "vegaVersion",
             "text": "1.13.0"
@@ -756,7 +769,7 @@ export class VegaDropdown {
       },
       "attribute": "item-display-rule",
       "reflect": false,
-      "defaultValue": "'newline'"
+      "defaultValue": "VEGA_DROPDOWN_DEFAULT_CONFIG.itemDisplayRule"
     },
     "itemTooltipProps": {
       "type": "unknown",
@@ -819,6 +832,9 @@ export class VegaDropdown {
       "optional": false,
       "docs": {
         "tags": [{
+            "name": "defaultValue",
+            "text": "false"
+          }, {
             "name": "vegaVersion",
             "text": "1.4.0"
           }],
@@ -826,7 +842,7 @@ export class VegaDropdown {
       },
       "attribute": "case-sensitive",
       "reflect": false,
-      "defaultValue": "false"
+      "defaultValue": "VEGA_DROPDOWN_DEFAULT_CONFIG.caseSensitive"
     },
     "dynamicOption": {
       "type": "boolean",
@@ -885,6 +901,9 @@ export class VegaDropdown {
       "optional": false,
       "docs": {
         "tags": [{
+            "name": "defaultValue",
+            "text": "false"
+          }, {
             "name": "vegaVersion",
             "text": "1.24.0"
           }],
@@ -892,7 +911,7 @@ export class VegaDropdown {
       },
       "attribute": "is-loading",
       "reflect": false,
-      "defaultValue": "false"
+      "defaultValue": "VEGA_DROPDOWN_DEFAULT_CONFIG.isLoading"
     },
     "placement": {
       "type": "string",
@@ -911,6 +930,9 @@ export class VegaDropdown {
       "optional": false,
       "docs": {
         "tags": [{
+            "name": "defaultValue",
+            "text": "['bottom', 'top']"
+          }, {
             "name": "vegaVersion",
             "text": "1.41.0"
           }],
@@ -918,7 +940,7 @@ export class VegaDropdown {
       },
       "attribute": "placement",
       "reflect": false,
-      "defaultValue": "['bottom', 'top']"
+      "defaultValue": "VEGA_DROPDOWN_DEFAULT_CONFIG.placement"
     },
     "alignment": {
       "type": "string",
@@ -937,6 +959,9 @@ export class VegaDropdown {
       "optional": false,
       "docs": {
         "tags": [{
+            "name": "defaultValue",
+            "text": "'start'"
+          }, {
             "name": "vegaVersion",
             "text": "1.41.0"
           }],
@@ -944,7 +969,7 @@ export class VegaDropdown {
       },
       "attribute": "alignment",
       "reflect": false,
-      "defaultValue": "'start'"
+      "defaultValue": "VEGA_DROPDOWN_DEFAULT_CONFIG.alignment"
     },
     "isLazyLoading": {
       "type": "boolean",
@@ -1006,6 +1031,9 @@ export class VegaDropdown {
         "tags": [{
             "name": "VegaWarning",
             "text": "- Setting this to `true` override the `positionRelativeTo` and `matchContainerHeight` properties, rendering them ineffective.\n- Currently, when set to `true`, the position calculation may be inaccurate if the popover is placed inside a scrollable container within a shadowRoot (e.g., inside a vega-modal with scrollable content)."
+          }, {
+            "name": "defaultValue",
+            "text": "false"
           }, {
             "name": "vegaVersion",
             "text": "2.36.0"
@@ -1014,7 +1042,7 @@ export class VegaDropdown {
       },
       "attribute": "is-screen-position",
       "reflect": false,
-      "defaultValue": "false"
+      "defaultValue": "VEGA_DROPDOWN_DEFAULT_CONFIG.isScreenPosition"
     },
     "resettable": {
       "type": "boolean",
@@ -1091,6 +1119,9 @@ export class VegaDropdown {
       "optional": false,
       "docs": {
         "tags": [{
+            "name": "defaultValue",
+            "text": "'No results found'"
+          }, {
             "name": "vegaVersion",
             "text": "2.74.0"
           }],
@@ -1098,7 +1129,7 @@ export class VegaDropdown {
       },
       "attribute": "search-no-results-text",
       "reflect": false,
-      "defaultValue": "'No results found'"
+      "defaultValue": "VEGA_DROPDOWN_DEFAULT_CONFIG.searchNoResultsText"
     },
     "allowSelectAll": {
       "type": "boolean",

package/dist/collection/components/vega-field-error/vega-field-error.js

@@ -10,6 +10,8 @@ import { InjectVegaGlobalSlimmer, InjectVegaSlimmer, methodPlaceholder, } from '
 import { VegaFieldErrorMessageController } from './slimmers/controllers/vega-field-error-message-controller';
 import { VegaComponentUsageRuntimeMetricsSlimmer } from '../../helpers/slimmers/component-usage-runtime-metrics';
 /**
+ * The Field Error component is a utility element used to independently manage the error state of form fields.
+ *
  * @vegaVersion 1.45.0
  */
 /** The VegaFieldBox class is a TypeScript React component that renders a box with a message and a slot for additional content. */

package/dist/collection/components/vega-file-uploader/slimmers/renderers/vega-file-uploader-file-list-renderer.js

@@ -15,6 +15,18 @@ import { VegaClick } from '../../../../helpers/event-manager/event-id/vega-event
 export class VegaFileUploaderFileListRenderer extends VegaSlimmer {
   constructor() {
     super(...arguments);
+    /**
+     * Determines whether delete should be disabled for a specific file.
+     */
+    this.isDeleteButtonDisabled = (file) => {
+      return this.disabled || (this.disableDeleteOnUpload && file.status === 'uploading');
+    };
+    /**
+     * Determines whether delete button should be hidden.
+     */
+    this.isDeleteButtonHidden = (file) => {
+      return this.hideDeleteButton || file.hideDeleteButton === true;
+    };
     /**
      * Used to trigger an event or action related to remove a specific file in the file uploader component
      *
@@ -57,6 +69,8 @@ export class VegaFileUploaderFileListRenderer extends VegaSlimmer {
         'vega-file-list-hidden': isFileListEmpty,
       } }, !isFileListEmpty &&
       this.value.map((file) => {
+        const isDeleteButtonDisabled = this.isDeleteButtonDisabled(file);
+        const isDeleteButtonHidden = this.isDeleteButtonHidden(file);
         return (h("vega-box", { key: file.key, class: "vega-file-uploader-file", padding: "size-8", corners: "rounded-8" },
           h("vega-flex", { alignItems: "start", justifyContent: "space-between" },
             h("vega-flex", { class: "vega-file-status-and-name", gap: "size-8", alignItems: "start" },
@@ -77,11 +91,11 @@ export class VegaFileUploaderFileListRenderer extends VegaSlimmer {
                     this.fileReUploadHandler(file);
                   });
                 } })),
-              h("vega-button-circle", { variant: "icon-only", size: "small", icon: VegaInternalIconManager.getIconKey('trash-can'), iconColor: "text-secondary", label: "Delete", tooltip: { disableInteractive: true }, disabled: this.disabled, ref: (button) => {
+              !isDeleteButtonHidden && (h("vega-button-circle", { variant: "icon-only", size: "small", icon: VegaInternalIconManager.getIconKey('trash-can'), iconColor: "text-secondary", label: "Delete", tooltip: { disableInteractive: true }, disabled: isDeleteButtonDisabled, ref: (button) => {
                   DomNodeSubjectObserverFactory.addUniqueObserverToNode(button, VegaClick, () => {
                     this.fileRemoveHandler(file);
                   });
-                } })))));
+                } }))))));
       })));
   }
 }
@@ -97,6 +111,12 @@ __decorate([
 __decorate([
   MapToComponentField()
 ], VegaFileUploaderFileListRenderer.prototype, "disabled", void 0);
+__decorate([
+  MapToComponentField()
+], VegaFileUploaderFileListRenderer.prototype, "hideDeleteButton", void 0);
+__decorate([
+  MapToComponentField()
+], VegaFileUploaderFileListRenderer.prototype, "disableDeleteOnUpload", void 0);
 __decorate([
   MapToComponentField()
 ], VegaFileUploaderFileListRenderer.prototype, "vegaFileUploaderFileStatusRenderer", void 0);

package/dist/collection/components/vega-file-uploader/vega-file-uploader.js

@@ -21,6 +21,8 @@ import { DropFileAcceptFilterSlimmer } from '../../helpers/slimmers/drop-file-ac
 import { TranslationSlimmer } from '../../helpers/slimmers/translation';
 import { VegaFileUploaderFileLimitController } from './slimmers/controllers/vega-file-uploader-file-limit-controller';
 /**
+ * The File Uploader allows users to select files for upload, either by dragging them into a drop area, or by opening files directly from their device.
+ *
  * @vegaVersion 2.25.0
  */
 export class VegaFileUploader {
@@ -91,6 +93,19 @@ export class VegaFileUploader {
      * @vegaVersion 2.25.0
      */
     this.disabled = false;
+    /**
+     * Specifies whether delete buttons for files should be hidden.
+     *
+     * @vegaVersion 2.98.0
+     */
+    this.hideDeleteButton = false;
+    /**
+     * Specifies whether delete buttons should be disabled only for files
+     *    that are currently uploading.
+     *
+     * @vegaVersion 2.98.0
+     */
+    this.disableDeleteOnUpload = false;
     /**
      * Specifies the maximum number of files that can be uploaded using the File Uploader. The value must be a positive integer.
      *
@@ -284,6 +299,48 @@ export class VegaFileUploader {
       "reflect": false,
       "defaultValue": "false"
     },
+    "hideDeleteButton": {
+      "type": "boolean",
+      "mutable": false,
+      "complexType": {
+        "original": "boolean",
+        "resolved": "boolean",
+        "references": {}
+      },
+      "required": false,
+      "optional": false,
+      "docs": {
+        "tags": [{
+            "name": "vegaVersion",
+            "text": "2.98.0"
+          }],
+        "text": "Specifies whether delete buttons for files should be hidden."
+      },
+      "attribute": "hide-delete-button",
+      "reflect": false,
+      "defaultValue": "false"
+    },
+    "disableDeleteOnUpload": {
+      "type": "boolean",
+      "mutable": false,
+      "complexType": {
+        "original": "boolean",
+        "resolved": "boolean",
+        "references": {}
+      },
+      "required": false,
+      "optional": false,
+      "docs": {
+        "tags": [{
+            "name": "vegaVersion",
+            "text": "2.98.0"
+          }],
+        "text": "Specifies whether delete buttons should be disabled only for files\n   that are currently uploading."
+      },
+      "attribute": "disable-delete-on-upload",
+      "reflect": false,
+      "defaultValue": "false"
+    },
     "maxCount": {
       "type": "number",
       "mutable": false,
@@ -577,7 +634,7 @@ export class VegaFileUploader {
       },
       "complexType": {
         "original": "VegaFileUploaderFile",
-        "resolved": "{ key: string; name: string; url: string | File; previewable?: boolean; status?: VegaFileUploaderFileStatus; errorMessage?: string; uploadingPercent?: number; }",
+        "resolved": "{ key: string; name: string; url: string | File; previewable?: boolean; status?: VegaFileUploaderFileStatus; errorMessage?: string; uploadingPercent?: number; hideDeleteButton?: boolean; }",
         "references": {
           "VegaFileUploaderFile": {
             "location": "import",
@@ -603,7 +660,7 @@ export class VegaFileUploader {
       },
       "complexType": {
         "original": "VegaFileUploaderFile",
-        "resolved": "{ key: string; name: string; url: string | File; previewable?: boolean; status?: VegaFileUploaderFileStatus; errorMessage?: string; uploadingPercent?: number; }",
+        "resolved": "{ key: string; name: string; url: string | File; previewable?: boolean; status?: VegaFileUploaderFileStatus; errorMessage?: string; uploadingPercent?: number; hideDeleteButton?: boolean; }",
         "references": {
           "VegaFileUploaderFile": {
             "location": "import",
@@ -626,7 +683,7 @@ export class VegaFileUploader {
       },
       "complexType": {
         "original": "VegaFileUploaderFile",
-        "resolved": "{ key: string; name: string; url: string | File; previewable?: boolean; status?: VegaFileUploaderFileStatus; errorMessage?: string; uploadingPercent?: number; }",
+        "resolved": "{ key: string; name: string; url: string | File; previewable?: boolean; status?: VegaFileUploaderFileStatus; errorMessage?: string; uploadingPercent?: number; hideDeleteButton?: boolean; }",
         "references": {
           "VegaFileUploaderFile": {
             "location": "import",
@@ -652,7 +709,7 @@ export class VegaFileUploader {
       },
       "complexType": {
         "original": "VegaFileUploaderFile",
-        "resolved": "{ key: string; name: string; url: string | File; previewable?: boolean; status?: VegaFileUploaderFileStatus; errorMessage?: string; uploadingPercent?: number; }",
+        "resolved": "{ key: string; name: string; url: string | File; previewable?: boolean; status?: VegaFileUploaderFileStatus; errorMessage?: string; uploadingPercent?: number; hideDeleteButton?: boolean; }",
         "references": {
           "VegaFileUploaderFile": {
             "location": "import",
@@ -675,7 +732,7 @@ export class VegaFileUploader {
       },
       "complexType": {
         "original": "VegaFileUploaderFile",
-        "resolved": "{ key: string; name: string; url: string | File; previewable?: boolean; status?: VegaFileUploaderFileStatus; errorMessage?: string; uploadingPercent?: number; }",
+        "resolved": "{ key: string; name: string; url: string | File; previewable?: boolean; status?: VegaFileUploaderFileStatus; errorMessage?: string; uploadingPercent?: number; hideDeleteButton?: boolean; }",
         "references": {
           "VegaFileUploaderFile": {
             "location": "import",
@@ -701,7 +758,7 @@ export class VegaFileUploader {
       },
       "complexType": {
         "original": "VegaFileUploaderFile",
-        "resolved": "{ key: string; name: string; url: string | File; previewable?: boolean; status?: VegaFileUploaderFileStatus; errorMessage?: string; uploadingPercent?: number; }",
+        "resolved": "{ key: string; name: string; url: string | File; previewable?: boolean; status?: VegaFileUploaderFileStatus; errorMessage?: string; uploadingPercent?: number; hideDeleteButton?: boolean; }",
         "references": {
           "VegaFileUploaderFile": {
             "location": "import",

package/dist/collection/components/vega-flag-icon/vega-flag-icon.js

@@ -11,6 +11,8 @@ import { VegaComponentUsageRuntimeMetricsSlimmer } from '../../helpers/slimmers/
 import { VegaFlagIconRenderer } from './slimmers/renderers/vega-flag-icon-renderer';
 import { VegaFlagIconController } from './slimmers/controllers/vega-flag-icon-controller';
 /**
+ * The flag icon component can render flags of different countries.
+ *
  * @vegaVersion 2.46.0
  */
 export class VegaFlagIcon {

package/dist/collection/components/vega-flex/vega-flex.js

@@ -15,6 +15,8 @@ import { VegaFlexRuntimeMetricsPayloadDefinition } from '../../constants/runtime
 import { PageResizeObserverSlimmer } from '../../helpers/slimmers/page-resize-observer-slimmer';
 import { formatFlexStyles } from '../../helpers/formatter/style-formatter';
 /**
+ * The Flex component is a low-level utility container that implements CSS Flexbox, and allows setting gap and margin values using predefined size tokens.
+ *
  * @vegaVersion 1.0.4
  */
 export class VegaFlex {

package/dist/collection/components/vega-font/vega-font.js

@@ -17,6 +17,8 @@ import { VegaFontRenderer } from './slimmers/renderers/vega-font-renderer';
 import { VegaComponentUsageRuntimeMetricsSlimmer } from '../../helpers/slimmers/component-usage-runtime-metrics';
 import { VegaFontRuntimeMetricsPayloadDefinition } from '../../constants/runtime-metrics-payload-definition/vega-font/runtime-metrics-payload-definition';
 /**
+ * The Font component functions much like an HTML font element, and is used to style text by applying typography and color tokens.
+ *
  * @vegaVersion 1.46.0
  */
 export class VegaFont {

package/dist/collection/components/vega-form/vega-form.js

@@ -21,6 +21,8 @@ import { VegaFormSubmitController } from './slimmers/controllers/vega-form-submi
 import { VegaFormFieldController } from './slimmers/controllers/vega-form-field-controller';
 import { VegaFormResetController } from './slimmers/controllers/vega-form-reset-controller';
 /**
+ * The Form component is a utility element used to manage data validation and submission of form fields.
+ *
  * @vegaVersion 1.3.0
  */
 export class VegaForm {

package/dist/collection/components/vega-grid/vega-grid.js

@@ -11,6 +11,8 @@ import { arrayToClassString } from '../../utils/ui';
 import { InjectVegaGlobalSlimmer, InjectVegaSlimmer } from 'vega-slimmer/core';
 import { VegaComponentUsageRuntimeMetricsSlimmer } from '../../helpers/slimmers/component-usage-runtime-metrics';
 /**
+ * The Grid component is a low-level utility container that implements features of CSS Grid, and allows setting gap values using predefined size tokens.
+ *
  * @vegaVersion 1.3.0
  */
 export class VegaGrid {

package/dist/collection/components/vega-icon/vega-icon.js

@@ -17,6 +17,8 @@ import { VegaComponentUsageRuntimeMetricsSlimmer } from '../../helpers/slimmers/
 import { tryGetDocument } from '../../utils/try-get-document';
 import { htmlSanitizer, styleSanitizeStrategy } from '../../utils/sanitize';
 /**
+ * The Icon component is a wrapper for Font Awesome icons, sized and colored using design tokens.
+ *
  * @vegaVersion 1.0.4
  */
 export class VegaIcon {

package/dist/collection/components/vega-image-uploader/vega-image-uploader.js

@@ -31,6 +31,8 @@ import { DarkModeStateControllerSlimmer } from '../../helpers/slimmers/dark-mode
 import { VegaInternalThemeManager } from '../../helpers/theme/internal-theme-manager';
 const IMAGE_FILE_TYPES = ['jpg', 'png', 'jpeg'];
 /**
+ * The Image Uploader allows users to select and upload an image file from their device.
+ *
  * @vegaVersion 1.14.0
  */
 export class VegaImageUploader {

package/dist/collection/components/vega-input/slimmers/renderers/vega-input-input-suggestions-renderer.js

@@ -12,6 +12,7 @@ import domNodeSubjectFactory from '../../../../helpers/change-manager/subject/do
 import { VegaInternalDropdownTemplateItemsChange, VegaInternalUpdateVegaInputValue, } from '../../../../helpers/event-manager/event-id/vega-internal-event-id';
 import { VegaDropdownClick } from '../../../../helpers/event-manager/event-id/vega-event-id';
 import { ClickOutsideOnlyToDismissStrategy } from '../../../../helpers/slimmers/element-appender/trigger-strategies/click-outside-only-to-dismiss-strategy';
+import { VEGA_DROPDOWN_DEFAULT_CONFIG } from '../../../vega-dropdown/constants';
 /**
  * Renderer class for the Vega App Header Button Dropdown.
  * This class extends the VegaSlimmer and is responsible for rendering the dropdown component and managing its state and events.
@@ -43,7 +44,11 @@ export class VegaInputInputSuggestionsRenderer extends VegaSlimmer {
     }
   }
   async showSuggestionsDropdown(dropdownConfig = {}) {
-    this.suggestionsDropdownConfig = dropdownConfig;
+    this.suggestionsDropdownConfig = Object.assign(Object.assign(Object.assign({}, VEGA_DROPDOWN_DEFAULT_CONFIG), { placement: ['top', 'bottom'] }), dropdownConfig);
+    if (this.dropdownRef) {
+      // Sync live dropdown ref with latest config (JSX spread in render doesn't update existing instance)
+      Object.assign(this.dropdownRef, this.suggestionsDropdownConfig);
+    }
     await this.showSuggestions();
   }
   async hideSuggestionsDropdown() {
@@ -62,7 +67,7 @@ export class VegaInputInputSuggestionsRenderer extends VegaSlimmer {
    * @returns {HTMLElement} The rendered dropdown component.
    */
   render(children) {
-    return (h("vega-dropdown", Object.assign({}, this.suggestionsDropdownConfig, { source: this.suggestionsDropdownSource, trigger: new ClickOutsideOnlyToDismissStrategy(), matchTargetWidth: true, searchable: false, placement: ['top', 'bottom'], translocation: { X: 0, Y: 6 }, ref: (ref) => {
+    return (h("vega-dropdown", Object.assign({}, this.suggestionsDropdownConfig, { source: this.suggestionsDropdownSource, trigger: new ClickOutsideOnlyToDismissStrategy(), matchTargetWidth: true, searchable: false, translocation: { X: 0, Y: 6 }, ref: (ref) => {
         this.dropdownRef = ref;
         this.addDropdownObserver(ref);
       }, style: { display: 'block' } }),

package/dist/collection/components/vega-input/vega-input.js

@@ -35,6 +35,8 @@ import { VegaInputRenderModeController } from './slimmers/controllers/vega-input
 import { AriaAttributesValueMapper } from '../../helpers/slimmers/mutation-observer/aria-attributes-value-mapper';
 import { DataTabIndexValueMapper } from '../../helpers/slimmers/mutation-observer/data-tab-index-value-mapper';
 /**
+ * An Input Field component allows users to enter a few words or a single line of text.
+ *
  * @vegaVersion 1.0.5
  */
 export class VegaInput {

package/dist/collection/components/vega-input-credit-card/vega-input-credit-card.js

@@ -25,6 +25,8 @@ import { VegaInputCreditCardRuntimeMetricsPayloadDefinition } from '../../consta
 import { CreditCardInputMaskStrategy } from '../../helpers/formatter/string-formatter/credit-card-input-mask-strategy';
 import { CreditCardBlurMaskStrategy } from '../../helpers/formatter/string-formatter/credit-card-blur-mask-strategy';
 /**
+ * The Credit Card Input is a text field designed specifically for entering credit card numbers.
+ *
  * @vegaVersion 1.26.0
  */
 export class VegaInputCreditCard {