@oracle/oraclejet 20.1.2 → 20.1.3

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

@@ -2148,7 +2148,14 @@ oj.__registerWidget(
        * myInputComp.help.definition = "Enter your name";
        */
       /**
-       * <p>help source url.  See the top-level <code class="prettyprint">help</code> option for details.
+       * <p>help source url. See the top-level
+       * <code class="prettyprint">help</code> option for details.</p>
+       * <p><b>Note:</b> For security, JET validates the URL protocol before
+       * navigation and currently supports <code class="prettyprint">http:</code>
+       * and <code class="prettyprint">https:</code> protocols. JET does not
+       * validate whether the URL is trusted for the application. Applications
+       * are responsible for providing sanitized URLs and enforcing any required
+       * origin or host allowlist.</p>
        *
        * @expose
        * @name help.source
@@ -2252,9 +2259,13 @@ oj.__registerWidget(
          * it shows all the time.
          * </p>
          * <p>
-         * For security reasons we only support urls with protocol 'http:' or 'https:'.
-         * If the url doesn't comply we ignore it and throw an error.
-         * Pass in an encoded URL since we do not encode the URL.</p>
+         * <p><b>Note:</b> For security, JET validates the URL protocol before navigation and
+         * currently supports <code class="prettyprint">http:</code> and
+         * <code class="prettyprint">https:</code> protocols. If the url doesn't
+         * comply we ignore it and throw an error. JET does not validate whether
+         * the URL is trusted for the application. Applications are responsible
+         * for providing sanitized URLs and enforcing any required origin or host
+         * allowlist. Pass in an encoded URL since we do not encode the URL.</p>
          *
          * <p>See the <a href="#helpHints">help-hints</a> attribute for usage examples.</p>
          *
@@ -2357,6 +2368,8 @@ oj.__registerWidget(
        * hints and message summary text cannot. If you use formatted text, it should be accessible
        * and make sense to the user if formatting wasn't there.
        * The allowed html tags are: span, b, i, em, br, hr, li, ol, ul, p, small, pre.
+       * Inline style attributes are sanitized; the retained styling is limited to color, font
+       * style, font weight, and text decoration. Use CSS classes for other styling.
        * To format the message detail, you could do this:
        * <pre class="prettyprint"><code>&lt;html>Enter &lt;b>at least&lt;/b> 6 characters&lt;/html></code></pre>
        * </p>
@@ -2513,6 +2526,8 @@ oj.__registerWidget(
        * <p>
        * To include formatted text in the help.instruction, format the string using html tags.
        * The allowed html tags are: span, b, i, em, br, hr, li, ol, ul, p, small, pre.
+       * Inline style attributes are sanitized; the retained styling is limited to color, font
+       * style, font weight, and text decoration. Use CSS classes for other styling.
        * For example the
        * help.instruction might look like:
        * <pre class="prettyprint"><code>&lt;oj-some-element help.instruction="&lt;html>Enter &lt;b>at least&lt;/b> 6 characters&lt;/html>">&lt;/oj-some-element></code></pre>
@@ -9378,6 +9393,7 @@ InlineHelpHintsStrategy.prototype._getHelpSourceDom = function (source) {
 
   helpSourceAnchor.setAttribute('tabindex', '0');
   helpSourceAnchor.setAttribute('target', '_blank');
+  helpSourceAnchor.setAttribute('rel', 'noopener noreferrer');
   try {
     validateURL(source);
     helpSourceAnchor.setAttribute('href', source);

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

@@ -1412,6 +1412,12 @@ class DvtGaugeDefaults extends BaseComponentDefaults {
       alta: JsonUtils.merge(defaultsMap['alta'], SKIN_ALTA)
     });
   }
+
+  getNoCloneObject() {
+    const noClone = super.getNoCloneObject();
+    noClone.metricLabel = { converter: true };
+    return noClone;
+  }
 }
 
 /**
@@ -1810,7 +1816,7 @@ class LedGauge extends DvtGauge {
    */
   SetOptions(options) {
     // NOTE: This extra clone should be removed once we stop supporting the deprecated attrs
-    options = JsonUtils.clone(options);
+    options = JsonUtils.clone(options, null, this.Defaults.getNoCloneObject());
 
     if (options['title']) {
       options['label'] = options['title'];
@@ -4403,7 +4409,7 @@ class StatusMeterGauge extends DvtGauge {
    */
   SetOptions(options) {
     // NOTE: This extra clone should be removed once we stop supporting the deprecated attrs
-    options = JsonUtils.clone(options);
+    options = JsonUtils.clone(options, null, this.Defaults.getNoCloneObject());
 
     if (options['title']) options['label'] = options['title'];
 

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

@@ -1023,6 +1023,13 @@ oj.__registerWidget(
       return this.element;
     },
 
+    _GetComponentNoClonePaths: function () {
+      var noClonePaths = this._super();
+      // Don't clone converter instances because their class methods must be preserved.
+      noClonePaths.metricLabel = { converter: true };
+      return noClonePaths;
+    },
+
     _GetChildStyleClasses: function () {
       var styleClasses = this._super();
       styleClasses['oj-gauge-metric-label'] = { path: 'metricLabel/style', property: 'TEXT' };

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

@@ -18,6 +18,20 @@
  * the input to prevent unsafe content from being added to the page.</p>
  */
 const HtmlUtils = {};
+const _ESCAPED_TAGS = [
+  'table',
+  'caption',
+  'colgroup',
+  'col',
+  'thead',
+  'tfoot',
+  'th',
+  'tbody',
+  'tr',
+  'td',
+  'template',
+  'p'
+];
 
 /**
  * Utility that will parse an HTML string into an array of DOM Nodes.
@@ -28,20 +42,7 @@ const HtmlUtils = {};
  */
 HtmlUtils.stringToNodeArray = function (html) {
   // escape html for the predefined tags
-  var tags = [
-    'table',
-    'caption',
-    'colgroup',
-    'col',
-    'thead',
-    'tfoot',
-    'th',
-    'tbody',
-    'tr',
-    'td',
-    'template',
-    'p'
-  ];
+  var tags = _ESCAPED_TAGS;
   var i;
 
   for (i = 0; i < tags.length; i++) {
@@ -120,25 +121,21 @@ function _unescapeTag(parent) {
     const BIND_REPLACE = 'oj-bind-replace-';
     if (nodeName.substr(0, 16) === BIND_REPLACE) {
       var replName = nodeName.substr(16);
-      replNode = document.createElement(replName); // @HTMLUpdateOK
-      for (j = 0; j < child.attributes.length; j++) {
-        attr = child.attributes[j];
-        replNode.setAttribute(attr.name, attr.value); // @HTMLUpdateOK
+      if (_ESCAPED_TAGS.indexOf(replName) !== -1) {
+        replNode = document.createElement(replName); // @HTMLUpdateOK
+        for (j = 0; j < child.attributes.length; j++) {
+          attr = child.attributes[j];
+          replNode.setAttribute(attr.name, attr.value); // @HTMLUpdateOK
+        }
+        var childHolder = replNode.content ? replNode.content : replNode;
+        for (j = 0; child.childNodes.length > 0; ) {
+          childHolder.appendChild(child.childNodes[0]);
+        }
+        parent.replaceChild(replNode, child);
       }
-      var childHolder = replNode.content ? replNode.content : replNode;
-      for (j = 0; child.childNodes.length > 0; ) {
-        childHolder.appendChild(child.childNodes[0]);
-      }
-      parent.replaceChild(replNode, child);
     } else if (nodeName === 'script' || nodeName === 'style') {
-      replNode = document.createElement(nodeName); // @HTMLUpdateOK
-      for (j = 0; j < child.attributes.length; j++) {
-        attr = child.attributes[j];
-        replNode.setAttribute(attr.name, attr.value); // @HTMLUpdateOK
-      }
-      var origHTML = child.innerHTML; // @HTMLUpdateOK
-      replNode.innerHTML = origHTML.replace(new RegExp(BIND_REPLACE, 'g'), ''); // @HTMLUpdateOK
-      parent.replaceChild(replNode, child);
+      var origText = child.textContent || '';
+      child.textContent = origText.replace(new RegExp(BIND_REPLACE, 'g'), '');
     } else if (child.nodeType === 8) {
       // comment node
       var origValue = child.nodeValue;

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

@@ -408,11 +408,14 @@ import { isTouchSupported, validateURL, PRESS_HOLD_THRESHOLD, recentTouchStart,
        * and holds the help icon on a mobile device. No formatted text is available for
        * help definition attribute.</li>
        * <li><code class="prettyprint">source</code> - this is the help source url.
-       * If present, a help icon will
-       * render next to the label. For security reasons
-       *  we only support urls with protocol http: or https:.
-       * If the url doesn't comply we ignore it and throw an error.
-       * Pass in an encoded URL since we do not encode the URL.
+       * If present, a help icon will render next to the label.
+       * <p><b>Note:</b> For security, JET validates the URL protocol before navigation
+       * and currently supports <code class="prettyprint">http:</code> and
+       * <code class="prettyprint">https:</code> protocols. If the url doesn't
+       * comply we ignore it and throw an error. JET does not validate whether
+       * the URL is trusted for the application. Applications are responsible
+       * for providing sanitized URLs and enforcing any required origin or host
+       * allowlist. Pass in an encoded URL since we do not encode the URL.</p>
        * </ul>
        *
        * @expose
@@ -1404,6 +1407,7 @@ import { isTouchSupported, validateURL, PRESS_HOLD_THRESHOLD, recentTouchStart,
       helpIconAnchor = document.createElement('a');
       helpIconAnchor.setAttribute('tabindex', '0');
       helpIconAnchor.setAttribute('target', '_blank');
+      helpIconAnchor.setAttribute('rel', 'noopener noreferrer');
       helpIconAnchor.className =
         'oj-label-help-icon-anchor oj-label-help-icon oj-component-icon oj-clickable-icon-nocontext';
       if (source) {

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

@@ -2010,7 +2010,7 @@ const _ojListView = _ListViewUtils.clazz(
                 // if event target is within listview, but not around items, e.g. the padding
                 var active = self.m_active && self.m_active.elem;
                 if (active == null && self.element.attr('tabIndex') === '0') {
-                  self.element.focus();
+                  self._initFocus(event, true);
                 } else if (active != null) {
                   self._makeFocusable(active);
                   self.HighlightActive();
@@ -7630,7 +7630,9 @@ const _ojListView = _ListViewUtils.clazz(
      */
     ActiveAndFocus: function (item, event, skipFocus, preventScroll) {
       // make sure that it is visible
-      this._scrollToVisible(item[0]);
+      if (!preventScroll) {
+        this._scrollToVisible(item[0]);
+      }
 
       // unhighlight any previous active item
       this.UnhighlightActive();

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

@@ -26,11 +26,12 @@ import { error as error$1, info as info$1, warn as warn$1, log as log$1, getLogL
  *
  * <p>If the logging options are changed at a later point, the Logger will use the modified options for the subsequent log operations.
  *
- * <p>The logging level can be overridden via sessionStorage.setItem() call for the current browser session.
+ * <p>In debug builds, the logging level can be overridden via sessionStorage.setItem() call for the current browser session.
  * Use 'ojet.logLevel' as the key with one of the following values: 'none' (least verbose), 'error', 'warning', 'info', 'log' (most verbose).
  * Set the value in the browser console and refresh the browser in order for the value to take effect.
+ * Production builds ignore this key.
  * </p>
- * <h3> Session storage usage : </h3>
+ * <h3> Session storage usage in debug builds : </h3>
  * <pre class="prettyprint">
  * <code>
  * // override logging level for the current session

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

@@ -13,7 +13,7 @@ import oj from 'ojs/ojcore-base';
 import $ from 'jquery';
 import { observable } from 'knockout';
 import { startAnimation } from 'ojs/ojanimation';
-import { isTouchSupported, getReadingDirection } from 'ojs/ojdomutils';
+import { isTouchSupported, getReadingDirection, validateURL } from 'ojs/ojdomutils';
 import { subtreeHidden } from 'ojs/ojcomponentcore';
 import { register } from 'ojs/ojcomposite';
 import Context from 'ojs/ojcontext';
@@ -24,6 +24,34 @@ import { getComponentTranslations, getTranslatedString } from 'ojs/ojtranslation
 
 const ojMessage = {};
 
+const ALLOWED_AUDIO_URL_PROTOCOLS = ['http:', 'https:', 'data:', 'blob:'];
+
+function encodeCssUrlControlCharacter(char) {
+  var hex = char.charCodeAt(0).toString(16).toUpperCase();
+  return '%' + (hex.length < 2 ? '0' + hex : hex);
+}
+
+function escapeCssUrlString(url) {
+  var escapedUrl = '';
+  var urlString = String(url);
+  for (var i = 0; i < urlString.length; i++) {
+    var char = urlString.charAt(i);
+    var charCode = char.charCodeAt(0);
+    if (char === '"' || char === '\\') {
+      escapedUrl += '\\' + char;
+    } else if (charCode <= 0x1f || charCode === 0x7f) {
+      escapedUrl += encodeCssUrlControlCharacter(char);
+    } else {
+      escapedUrl += char;
+    }
+  }
+  return escapedUrl;
+}
+
+function getCssUrl(url) {
+  return 'url("' + escapeCssUrlString(url) + '")';
+}
+
 /**
  * @ojcomponent oj.ojMessage
  * @since 5.0.0
@@ -61,10 +89,13 @@ const ojMessage = {};
  *
  * <p>The {@link oj.ojMessage#message.sound} property is an accessibility feature for playing a
  * sound when a message is opened. This property defaults to "none", and can be enabled by setting
- * it to "defaults" or by providing URL to an audio file of a format that the browser supports. An
- * accessible application must provide a way for users to enable sound on a settings or preferences
- * page. Some browsers will have auto-play disabled by default, enabling it may require adjusting
- * the browser settings.</p>
+ * it to "defaults" or by providing a URL to an audio file of a format that the browser supports.
+ * Custom sound URLs are validated before playback. Relative URLs and URLs that resolve to
+ * <code class="prettyprint">http:</code>, <code class="prettyprint">https:</code>,
+ * <code class="prettyprint">data:</code>, or <code class="prettyprint">blob:</code> are
+ * supported. An accessible application must provide a way for users to enable sound on a settings
+ * or preferences page. Some browsers will have auto-play disabled by default, enabling it may
+ * require adjusting the browser settings.</p>
  *
  * <h3 id="touch-section">
  *   Touch End User Information
@@ -416,9 +447,12 @@ const ojMessage = {};
  * required for low vision users who view a zoomed section of the UI. Because messages may be shown
  * outside of the zoomed section, such users require sound to be played to notify of new messages.</p>
  *
- * <p>This attribute can take a URL of the audio file for the custom sound to be played. The
- * supported formats are mp3, wav and ogg. Browser support should also be considered while choosing
- * the format of the audio file. Literal string values
+ * <p>This attribute can take a URL of the audio file for the custom sound to be played. Custom
+ * sound URLs are validated before playback. Relative URLs and URLs that resolve to
+ * <code class="prettyprint">http:</code>, <code class="prettyprint">https:</code>,
+ * <code class="prettyprint">data:</code>, or <code class="prettyprint">blob:</code> are
+ * supported. The supported formats are mp3, wav and ogg. Browser support should also be considered
+ * while choosing the format of the audio file. Literal string values
  * <code class="prettyprint">"defaults"</code> and <code class="prettyprint">"none"</code> can also
  * be used for this attribute. If the value is set to "none", then the sound will be disabled. If
  * the value is set to "defaults", then a default sound is played.<p>
@@ -1252,7 +1286,7 @@ MessageViewModel.prototype._computeIconStyle = function () {
     return undefined;
   }
 
-  return ["url('", message.icon, "') no-repeat"].join('');
+  return getCssUrl(message.icon) + ' no-repeat';
 };
 
 MessageViewModel.prototype._computeIconClass = function () {
@@ -1485,6 +1519,13 @@ MessageViewModel.prototype._handleKeydown = function (event) {
 MessageViewModel.prototype._playSound = function (sound) {
   // Custom URL was specified for the sound, using <audio> element is simple and best for this case.
   if (sound !== 'defaults') {
+    try {
+      validateURL(sound, ALLOWED_AUDIO_URL_PROTOCOLS);
+    } catch (error) {
+      info(`JET oj-message: Invalid URL in message.sound='${sound}'. Error: ${error}`);
+      return;
+    }
+
     var audio = document.createElement('AUDIO');
     audio.src = sound;
 

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

@@ -1366,9 +1366,12 @@ var __decorate = (null && null.__decorate) || function (decorators, target, key,
  * <p>The <code class="prettyprint">MessageBannerItem["sound"]</code> property is an accessibility
  * feature for playing a sound when a message is opened. This property defaults to "none", and can
  * be enabled by setting it to "default" or by providing a URL to an audio file of a format that the
- * browser supports. An accessible application must provide a way for users to enable sound on a
- * settings or preferences page. Some browsers will have auto-play disabled by default, enabling
- * it may require adjusting the browser settings.</p>
+ * browser supports. Custom sound URLs are validated before playback. Relative URLs and URLs that
+ * resolve to <code class="prettyprint">http:</code>, <code class="prettyprint">https:</code>,
+ * <code class="prettyprint">data:</code>, or <code class="prettyprint">blob:</code> are
+ * supported. An accessible application must provide a way for users to enable sound on a settings
+ * or preferences page. Some browsers will have auto-play disabled by default, enabling it may
+ * require adjusting the browser settings.</p>
  *
  * <h3 id="keyboard-section">
  *   Keyboard End User Information

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

@@ -158,7 +158,15 @@ MetadataUtils.getComplexPropertyMetadata = function (propPath, metadata) {
   if (subProp) {
     const namePath = propPath.split('.');
     for (let i = 0; i < namePath.length; i++) {
-      subProp = subProp[namePath[i]];
+      const propName = namePath[i];
+      if (
+        oj.CollectionUtils._isBlockedKey(propName) ||
+        !Object.prototype.hasOwnProperty.call(subProp, propName)
+      ) {
+        subProp = undefined;
+      } else {
+        subProp = subProp[propName];
+      }
       if (i === 0) {
         prop = subProp;
       }