@oracle/oraclejet 14.0.10 → 14.1.1

package/dist/js/libs/oj/debug_esm/ojknockout.js

@@ -14,7 +14,8 @@ import { bindingHandlers, applyBindingsToDescendants, ignoreDependencies, comput
 import * as DomUtils from 'ojs/ojdomutils';
 import { setInKoCleanExternal, isTouchSupported } from 'ojs/ojdomutils';
 import $ from 'jquery';
-import { CustomElementUtils, AttributeUtils, JetElementError, ElementUtils } from 'ojs/ojcustomelement-utils';
+import { isElementRegistered, isComposite, isVComponent, getMetadata } from 'ojs/ojcustomelement-registry';
+import { AttributeUtils, CustomElementUtils, JetElementError, ElementUtils } from 'ojs/ojcustomelement-utils';
 import { getPropagationMetadataViaCache, ROOT_BINDING_PROPAGATION } from 'ojs/ojbindpropagation';
 import KeySetImpl from 'ojs/ojkeysetimpl';
 import Context from 'ojs/ojcontext';
@@ -1339,25 +1340,22 @@ BindingProviderImpl.addPostprocessor({
     if (!oj$1.BaseCustomElementBridge) {
       return wrappedReturn;
     }
-    return (
-      wrappedReturn ||
-      (node.nodeType === 1 && CustomElementUtils.isElementRegistered(node.nodeName))
-    );
+    return wrappedReturn || (node.nodeType === 1 && isElementRegistered(node.nodeName));
   },
 
   getBindingAccessors: function (node, bindingContext, wrappedReturn) {
     if (node.nodeType === 1) {
       var name = node.nodeName;
 
-      if (CustomElementUtils.isElementRegistered(name)) {
+      if (isElementRegistered(name)) {
         // eslint-disable-next-line no-param-reassign
         wrappedReturn = wrappedReturn || {};
 
         // eslint-disable-next-line no-param-reassign
         wrappedReturn._ojCustomElement = function () {
-          const isComposite = CustomElementUtils.isComposite(name);
-          const isVComponent = CustomElementUtils.isVComponent(name);
-          return { skipThrottling: isComposite || isVComponent };
+          const isComposite$1 = isComposite(name);
+          const isVComponent$1 = isVComponent(name);
+          return { skipThrottling: isComposite$1 || isVComponent$1 };
         };
       }
     }
@@ -2188,7 +2186,7 @@ const ExpressionPropertyUpdater = function (element, bindingContext, skipThrottl
       var attribute = AttributeUtils.propertyNameToAttribute(property);
       var message = `Invalid type '${typeof listener}' found for attribute '${attribute}'.\
  Expected value of type 'function'."`;
-      if (CustomElementUtils.isElementRegistered(element.tagName)) {
+      if (isElementRegistered(element.tagName)) {
         const elementState = CustomElementUtils.getElementState(element);
         elementState.rejectBindingProvider(message);
       }
@@ -2520,7 +2518,7 @@ oj._registerLegacyNamespaceProp('_KnockoutBindingProvider', _KnockoutBindingProv
       var _expressionHandler;
       var attributeListener;
 
-      const compMetadata = CustomElementUtils.getMetadata(element.tagName);
+      const compMetadata = getMetadata(element.tagName);
       const metadataProps = compMetadata.properties || {};
 
       // Compute data about the provided and consumed properties.
@@ -3420,10 +3418,7 @@ ComponentBinding.getDefaultInstance().setupManagedAttributes({
 
         // Handle event binding for native HTML elements.
         // The event binding for custom elements is handled by the bridge.
-        if (
-          !CustomElementUtils.isElementRegistered(node.nodeName) &&
-          attr.name.substring(0, 3) === 'on-'
-        ) {
+        if (!isElementRegistered(node.nodeName) && attr.name.substring(0, 3) === 'on-') {
           boundEvents.push(attr);
         }
       }

package/dist/js/libs/oj/debug_esm/ojlegend-toolkit.js

@@ -2391,8 +2391,7 @@ class Legend extends BaseComponent {
       // Combine the user options with the defaults and store
       this.Options = this.Defaults.calcOptions(options);
 
-      // Transfer the category visibility properties to the hiddenCategories.
-      this._transferVisibilityProps(this.Options['sections']);
+      this._processData(this.Options['sections']);
     } else if (!this.Options)
       // Create a default options object if none has been specified
       this.Options = this.GetDefaults();
@@ -2641,24 +2640,26 @@ class Legend extends BaseComponent {
   }
 
   /**
-   * Transfer categoryVisibility property from legend item to hiddenCategories on the legend.
+   * Processes the sections data. Transfers categoryVisibility property from legend item to hiddenCategories on the legend.
    * @param {array} sections The array of legend section definitions
    * @private
    */
-  _transferVisibilityProps(sections) {
+  _processData(sections) {
+    let hasCollapsible = false;
     if (!sections || sections.length <= 0) return;
 
     var hiddenCategories = this.getOptions()['hiddenCategories'];
     for (var i = 0; i < sections.length; i++) {
       var section = sections[i];
-
+      hasCollapsible = hasCollapsible || section.collapsible === 'on';
       // If this section has nested sections, recurse.
-      if (section['sections']) this._transferVisibilityProps(section['sections']);
+      if (section['sections']) this._processData(section['sections']);
 
       // Iterate through the items and transfer properties.
       var items = section['items'];
       if (!items || items.length <= 0) continue;
 
+      // Transfer the category visibility properties to the hiddenCategories.
       for (var j = 0; j < items.length; j++) {
         var item = items[j];
         var itemCategory = DvtLegendUtils.getItemCategory(item, this);
@@ -2669,6 +2670,7 @@ class Legend extends BaseComponent {
         item['categoryVisibility'] = null;
       }
     }
+    this.getCache().putToCache('hasCollapsible', hasCollapsible);
   }
 
   /**
@@ -2679,7 +2681,12 @@ class Legend extends BaseComponent {
       var options = this.getOptions();
       var translations = options.translations;
       var hideAndShow = options['hideAndShowBehavior'];
-      if ((hideAndShow != 'off' && hideAndShow != 'none') || options['hoverBehavior'] == 'dim') {
+      const hasCollapsible = this.getCache().getFromCache('hasCollapsible');
+      if (
+        (hideAndShow != 'off' && hideAndShow != 'none') ||
+        options['hoverBehavior'] == 'dim' ||
+        hasCollapsible
+      ) {
         this.getCtx().setAriaRole('application');
         this.getCtx().setAriaLabel(
           ResourceUtils.format(translations.labelAndValue, [

package/dist/js/libs/oj/debug_esm/ojlegend.js

@@ -476,6 +476,7 @@ var __oj_legend_section_metadata =
  * @property {string=} title The title of the legend section.
  * @property {"center"|"end"|"start"} [titleHalign="start"] The horizontal alignment of the section title. If the section is collapsible or nested, only start alignment is supported.
  * @property {Object=} titleStyle The CSS style object defining the style of the section title. The following style properties are supported: color, cursor, fontFamily, fontSize, fontStyle, fontWeight, textDecoration.
+ * @ojdeprecated {since: '14.1.0', description: 'This attribute is deprecated. Applications should use the expanded API on oj-legend instead', target: 'property', for: 'expanded' }
  * @ojsignature [{target: "Type", value: "K", for: "id"},
  *               {target: "Type", value: "Array.<oj.ojLegend.Item<K>>", for: "items", jsdocOverride: true},
  *               {target: "Type", value: "Array.<oj.ojLegend.Section<K>>", for: "sections", jsdocOverride: true},
@@ -505,6 +506,11 @@ var __oj_legend_section_metadata =
  * @property {Object=} svgStyle The inline style to apply to the legend item. The style class and inline style will override any other styling specified through the options. For tooltips and hover interactivity, it's recommended to also pass a representative color to the color attribute. Only SVG CSS style properties are supported.
  * @property {"image"|"line"|"lineWithMarker"|"marker"} [symbolType="marker"] The type of legend symbol to display.
  * @property {string} text The legend item text.
+ * @ojdeprecated [{since: '14.1.0', description: 'This is not recommended in the Redwood design system.', target: 'property', for: 'svgStyle'},
+ *                {since: '14.1.0', description: 'This is not recommended in the Redwood design system.', target: 'property', for: 'svgClassName'},
+ *                {since: '14.1.0', description: 'This is not recommended in the Redwood design system.', target: 'property', for: 'markerSvgClassName'},
+ *                {since: '14.1.0', description: 'This is not recommended in the Redwood design system.', target: 'property', for: 'markerSvgStyle'},
+ *                {since: '14.1.0', description: 'This api is deprecated. Use hidden-categories in oj-legend instead.', target: 'property', for: 'categoryVisibility'}]
  * @ojsignature [{target: "Type", value: "K", for: "id"},
  *               {target: "Type", value: "Partial<CSSStyleDeclaration>", for: "svgStyle", jsdocOverride: true},
  *               {target: "Type", value: "Partial<CSSStyleDeclaration>", for: "markerSvgStyle", jsdocOverride: true},
@@ -512,7 +518,6 @@ var __oj_legend_section_metadata =
  */
 
 // METHOD TYPEDEFS
-
 /**
  * @typedef {Object} oj.ojLegend.SectionContext
  * @ojtsignore
@@ -706,7 +711,7 @@ var __oj_legend_section_metadata =
  *               }
  *              ]
  *
- * @ojpropertylayout {propertyGroup: "common", items: ["orientation", "halign", "valign", "hoverBehavior", "hoverBehaviorDelay", "style"]}
+ * @ojpropertylayout {propertyGroup: "common", items: ["orientation", "halign", "valign", "hoverBehavior", "style"]}
  * @ojpropertylayout {propertyGroup: "data", items: ["data"]}
  * @ojvbdefaultcolumns 2
  * @ojvbmincolumns 1
@@ -967,6 +972,7 @@ oj.__registerWidget('oj.ojLegend', $.oj.dvtBaseComponent, {
      * @ojunits milliseconds
      * @ojmin 0
      * @default 200
+     * @ojdeprecated {since: '14.1.0', description: 'This is not recommended in the Redwood design system.'}
      *
      * @example <caption>Initialize the Legend with the <code class="prettyprint">hover-behavior-delay</code> attribute specified:</caption>
      * &lt;oj-legend hover-behavior-delay="150">&lt;/oj-legend>
@@ -1654,6 +1660,7 @@ setDefaultOptions({
  * @instance
  * @type {string=}
  * @default ""
+ * @ojdeprecated {since: '14.1.0', description: 'This is not recommended in the Redwood design system.'}
  */
 /**
  * The inline style to apply to the legend item symbol. This inline style and <code> svg-class-name </code> will override any other styling specified through the options except for <code>marker-svg-style</code> and <code>marker-svg-class-name</code>.
@@ -1666,6 +1673,7 @@ setDefaultOptions({
  * @instance
  * @type {Object=}
  * @ojsignature {target: "Type", value: "Partial<CSSStyleDeclaration>", jsdocOverride: true}
+ * @ojdeprecated {since: '14.1.0', description: 'This is not recommended in the Redwood design system.'}
  */
 /**
  * The CSS style class to apply to the marker of the legend item symbol. This style class and <code> marker-svg-style </code> will override any other styling specified for the marker. For tooltips and hover interactivity, it's recommended to also pass a representative color to the markerColor attribute.
@@ -1676,6 +1684,7 @@ setDefaultOptions({
  * @instance
  * @type {string=}
  * @default ""
+ * @ojdeprecated {since: '14.1.0', description: 'This is not recommended in the Redwood design system.'}
  */
 /**
  * The inline style to apply to the marker of the legend item symbol. This inline style and <code> marker-svg-class-name </code> will override any other styling specified for the marker. For tooltips and hover interactivity, it's recommended to also pass a representative color to the markerColor attribute.
@@ -1687,6 +1696,7 @@ setDefaultOptions({
  * @instance
  * @type {Object=}
  * @ojsignature {target: "Type", value: "Partial<CSSStyleDeclaration>", jsdocOverride: true}
+ * @ojdeprecated {since: '14.1.0', description: 'This is not recommended in the Redwood design system.'}
  */
 /**
  * The shape of the marker. Only applies if symbolType is "marker" or "lineWithMarker". Can take the name of a built-in shape or the SVG path commands for a custom shape. Does not apply if a custom image is specified.
@@ -1717,6 +1727,7 @@ setDefaultOptions({
  * @ojvalue {string} "hidden" Legend item will have a hollow symbol.
  * @ojvalue {string} "visible" Legend item will be filled.
  * @default "visible"
+ * @ojdeprecated {since: '14.1.0', description: 'This attribute is deprecated. Use hidden-categories on oj-legend instead'}
  */
 /**
  *  Whether drilling is enabled on the legend item. Drillable objects will show a pointer cursor on hover and fire <code class="prettyprint">ojDrill</code> event on click. To enable drilling for all legend items at once, use the drilling attribute in the top level.

package/dist/js/libs/oj/debug_esm/ojmenu.js

@@ -18,6 +18,7 @@ import { startAnimation } from 'ojs/ojanimation';
 import { warn } from 'ojs/ojlogger';
 import { getDeviceRenderMode } from 'ojs/ojconfig';
 import { CustomElementUtils } from 'ojs/ojcustomelement-utils';
+import { isElementRegistered } from 'ojs/ojcustomelement-registry';
 
 (function () {
   // -----------------------------------------------------------------------------
@@ -4327,7 +4328,7 @@ import { CustomElementUtils } from 'ojs/ojcustomelement-utils';
     ojMenu: {
       openOptions: createDynamicPropertyGetter(function (context) {
         var position;
-        if (CustomElementUtils.isElementRegistered(context.element.tagName)) {
+        if (isElementRegistered(context.element.tagName)) {
           if (context.containers.indexOf('ojMenu') >= 0) {
             position = {
               my: { horizontal: 'start', vertical: 'top' },

package/dist/js/libs/oj/debug_esm/ojmessage.js

@@ -1201,6 +1201,12 @@ MessageViewModel.prototype._computeCategory = function () {
   }
 
   var severity = this._computeSeverity();
+
+  // If severity is none, return undefined as we do not want to show the category
+  if (severity === 'none') {
+    return undefined;
+  }
+
   var translations = this._properties.translations;
 
   var translatedCategory =
@@ -1926,6 +1932,9 @@ var __oj_message_metadata =
             "info": {
               "type": "string"
             },
+            "none": {
+              "type": "string"
+            },
             "warning": {
               "type": "string"
             }

package/dist/js/libs/oj/debug_esm/ojmessages.js

@@ -1139,17 +1139,23 @@ MessagesViewModel.prototype._handleOpen = function (event) {
 };
 
 MessagesViewModel.prototype._updateLiveRegionAndContainer = function (message) {
-  var translations = getComponentTranslations('oj-ojMessage').categories;
+  const translations = getComponentTranslations('oj-ojMessage').categories;
 
   // oj.Message has 'fatal' severity which is no different from 'error', oj-message does not support
   //  'fatal' for this reason. Map 'fatal' to 'error' just to be compatible with cases where the
   //  message stream could come from existing oj.Message sources.
-  var severity = message.severity === 'fatal' ? 'error' : message.severity;
-  var category = !message.category ? translations[severity] : message.category;
-  var options = { category: category, summary: message.summary, detail: message.detail };
-
-  var liveRegion = this._getLiveRegion();
-  var text = this._getTranslationsDefault('ariaLiveRegion.newMessage', options);
+  const severity = (message.severity === 'fatal' ? 'error' : message.severity) || 'none';
+  const category = !message.category ? translations[severity] : message.category;
+  // check if the message has detail text or not (as it is an optional property)
+  // and determine which translation resource needs to be used.
+  const options = {
+    category: category,
+    summary: message.summary,
+    detail: message.detail || this._getTranslationsDefault('ariaLiveRegion.noDetail')
+  };
+
+  const liveRegion = this._getLiveRegion();
+  const text = this._getTranslationsDefault('ariaLiveRegion.newMessage', options);
   liveRegion.announce(text);
 
   this._refresh(); // re-evaluate the position as the overlay size can change.
@@ -2056,6 +2062,9 @@ var __oj_messages_metadata =
             },
             "newMessage": {
               "type": "string"
+            },
+            "noDetail": {
+              "type": "string"
             }
           }
         },

package/dist/js/libs/oj/debug_esm/ojnbox-toolkit.js

@@ -4495,8 +4495,10 @@ const DvtNBoxNodeRenderer = {
               : ' oj-avatar-bg-' + bgColor + ' oj-nbox-node-initials-' + bgColor)
         );
         if (hasSource) {
+          // for ios use a smaller cropped image JET-53563
+          var isIos = Agent.os === 'ios';
           var iconContainer = new Container(nbox.getCtx());
-          var iconBackgroundSize = icon['backgroundSize'];
+          var iconBackgroundSize = isIos ? icon['backgroundIosSize'] : icon['backgroundSize'];
           var backgroundMarker = new ImageMarker(
             nbox.getCtx(),
             iconX,
@@ -4511,7 +4513,11 @@ const DvtNBoxNodeRenderer = {
           );
           iconContainer.addChild(iconMarker);
           iconContainer.addChild(backgroundMarker);
-          backgroundMarker.setClassName('oj-nbox-node-initials-background-pattern');
+          backgroundMarker.setClassName(
+            isIos
+              ? 'oj-nbox-node-initials-background-pattern oj-nbox-ios'
+              : 'oj-nbox-node-initials-background-pattern'
+          );
           iconMarker = iconContainer;
         }
 

package/dist/js/libs/oj/debug_esm/ojnbox.js

@@ -2101,6 +2101,10 @@ oj.__registerWidget('oj.ojNBox', $.oj.dvtBaseComponent, {
       path: 'styleDefaults/nodeDefaults/iconDefaults/backgroundSize',
       property: 'width'
     };
+    styleClasses['oj-nbox-node-initials-background oj-nbox-ios'] = {
+      path: 'styleDefaults/nodeDefaults/iconDefaults/backgroundIosSize',
+      property: 'width'
+    };
     styleClasses['oj-nbox-node-categorylabel'] = {
       path: 'styleDefaults/_categoryNodeDefaults/labelStyle',
       property: 'TEXT'

package/dist/js/libs/oj/debug_esm/ojpopup.js

@@ -186,8 +186,8 @@ import { CustomElementUtils } from 'ojs/ojcustomelement-utils';
    *   <li>"alertdialog" defines type of dialog that contains an alert message, where initial focus
    *       goes to an element within the dialog.</li>
    * </ul>
-   * The popup also adds the <code class="prettyprint">aria-describedby="popup-id"</code> attribute
-   * to the assocaited launcher while the popup is open.
+   * The non-modal (modeless) popup also adds the <code class="prettyprint">aria-describedby="popup-id"</code>
+   * attribute to the assocaited launcher while the popup is open.
    * </p>
    *
    * On platforms that support voice over mode (VO), the popup injects anchor tags "skip links"
@@ -196,12 +196,12 @@ import { CustomElementUtils } from 'ojs/ojcustomelement-utils';
    *  <ul>
    *    <li>A close link, {@link oj.ojPopup#translations.ariaCloseSkipLink}, is injected as a
    *        sibling to the popup's content. Activation of this link will close the popup.</li>
-   *    <li>For cases where the popup doesn't steal focus when it's open, a content navigation
+   *    <li>For cases where the non-modal popup doesn't steal focus when it's open, a content navigation
    *        skip link, {@link oj.ojPopup#translations.ariaFocusSkipLink}, is injected as a
    *        sibling to the launcher (first required argument of the open method). If the launcher
    *        selector targets a sub-element of the launcher, the skip link could be injected under
    *        the launcher, which can be problematic for oj-button as skip link activation will
-   *        also activate the associated launcher.</li>
+   *        also activate the associated launcher. The focus skip link is not injected for modal popups.</li>
    *  </ul>
    *
    * <p>One point often overlooked is making the gestures that launch a popup accessible.
@@ -1047,7 +1047,9 @@ import { CustomElementUtils } from 'ojs/ojcustomelement-utils';
       this._setPosition(position);
 
       this._setAutoDismiss(options.autoDismiss);
-      this._addDescribedBy();
+      if (options.modality !== 'modal') {
+        this._addDescribedBy();
+      }
 
       if (!this._IsCustomElement() || !element[0].hasAttribute('role')) {
         element.attr('role', options.role);
@@ -2243,38 +2245,46 @@ import { CustomElementUtils } from 'ojs/ojcustomelement-utils';
      * @private
      */
     _initVoiceOverAssist: function () {
+      var isModal = this.options.modality === 'modal';
       var isVOSupported =
         oj.AgentUtils.getAgentInfo().os === oj.AgentUtils.OS.IOS ||
         oj.AgentUtils.getAgentInfo().os === oj.AgentUtils.OS.ANDROID;
-      var liveRegion = this._liveRegion;
-      if (!liveRegion) {
-        liveRegion = new PopupLiveRegion();
-        this._liveRegion = liveRegion;
-      }
-
       var message;
-      var initialFocus = this._deriveInitialFocus();
-      if (isVOSupported) {
-        message = this.getTranslatedString(
-          initialFocus === 'none'
-            ? 'ariaLiveRegionInitialFocusNoneTouch'
-            : 'ariaLiveRegionInitialFocusFirstFocusableTouch'
-        );
-      } else {
-        message = this.getTranslatedString(
-          initialFocus === 'none'
-            ? 'ariaLiveRegionInitialFocusNone'
-            : 'ariaLiveRegionInitialFocusFirstFocusable'
-        );
+
+      if (!isModal) {
+        // for non-modal popups install the live region for keybard/VO navigation
+        var liveRegion = this._liveRegion;
+        if (!liveRegion) {
+          liveRegion = new PopupLiveRegion();
+          this._liveRegion = liveRegion;
+        }
+        var initialFocus = this._deriveInitialFocus();
+        if (isVOSupported) {
+          message = this.getTranslatedString(
+            initialFocus === 'none'
+              ? 'ariaLiveRegionInitialFocusNoneTouch'
+              : 'ariaLiveRegionInitialFocusFirstFocusableTouch'
+          );
+        } else {
+          message = this.getTranslatedString(
+            initialFocus === 'none'
+              ? 'ariaLiveRegionInitialFocusNone'
+              : 'ariaLiveRegionInitialFocusFirstFocusable'
+          );
+        }
+        liveRegion.announce(message);
       }
-      liveRegion.announce(message);
 
       if (isVOSupported) {
-        var focusSkipLinkId = this._getSubId('focusSkipLink');
-        var launcher = this._launcher;
-        var callback = this._intialFocus.bind(this, true);
-        message = this.getTranslatedString('ariaFocusSkipLink');
-        this._focusSkipLink = new PopupSkipLink(launcher, message, callback, focusSkipLinkId);
+        var callback;
+
+        if (!isModal) {
+          var focusSkipLinkId = this._getSubId('focusSkipLink');
+          var launcher = this._launcher;
+          callback = this._intialFocus.bind(this, true);
+          message = this.getTranslatedString('ariaFocusSkipLink');
+          this._focusSkipLink = new PopupSkipLink(launcher, message, callback, focusSkipLinkId);
+        }
 
         var content = this._content;
         var closeSkipLinkId = this._getSubId('closeSkipLink');
@@ -2290,8 +2300,10 @@ import { CustomElementUtils } from 'ojs/ojcustomelement-utils';
      */
     _destroyVoiceOverAssist: function () {
       var liveRegion = this._liveRegion;
-      liveRegion.destroy();
-      delete this._liveRegion;
+      if (liveRegion) {
+        liveRegion.destroy();
+        delete this._liveRegion;
+      }
 
       var focusSkipLink = this._focusSkipLink;
       if (focusSkipLink) {

package/dist/js/libs/oj/debug_esm/ojpopupcore.js

@@ -1501,9 +1501,9 @@ ZOrderUtils.removeFromAncestorLayer = function (popup) {
 
   ZOrderUtils.preOrderVisit(layer, ZOrderUtils._closeDescendantPopupsCallback);
 
+  ZOrderUtils._removeOverlayFromAncestorLayer(layer);
   ZOrderUtils._resetAriaHiddenOnBackround(layer);
   ZOrderUtils._restoreBodyOverflow();
-  ZOrderUtils._removeOverlayFromAncestorLayer(layer);
 
   layer.removeData(ZOrderUtils._EVENTS_DATA);
   layer.removeData(ZOrderUtils._MODALITY_DATA);
@@ -1557,8 +1557,11 @@ ZOrderUtils._disableBodyOverflow = function (layer) {
 };
 
 ZOrderUtils._restoreBodyOverflow = function () {
-  const body = document.body;
-  body.classList.remove('oj-component-modal-open');
+  // if there are no more modals left, enable scrolling on body
+  if (!ZOrderUtils.hasModalDialogOpen()) {
+    const body = document.body;
+    body.classList.remove('oj-component-modal-open');
+  }
 };
 
 ZOrderUtils._removeFocusWithinFromOverlayedContent = function () {
@@ -3412,6 +3415,11 @@ PositionUtils.calcAvailablePopupSize = function (pos, feedback, withinElem) {
         }
       });
 
+      // JET-56620: normalize position left/top to integer values to avoid unnecessary
+      // repositioning caused by potential floating number oscillations
+      position.left = Math.round(position.left);
+      position.top = Math.round(position.top);
+
       if (options.using) {
         // Adds feedback as second argument to using callback, if present
         using = function (props) {