@oracle/oraclejet 10.0.3 → 10.0.7

package/dist/css/redwood/oj-redwood-novars.css

@@ -6,7 +6,7 @@
   visibility: hidden; }
 
 .oj-theme-json {
-  font-family: '{"name":"redwood","targetPlatform":"all","behavior":"redwood","jetReleaseVersion":"v10.0.3"}' !important; }
+  font-family: '{"name":"redwood","targetPlatform":"all","behavior":"redwood","jetReleaseVersion":"v10.0.7"}' !important; }
 
 .oj-helper-hidden-accessible {
   border: 0;
@@ -7999,6 +7999,9 @@ oj-label-value:not(.oj-formlayout-labels-inline) .oj-label {
   .oj-form-control-inherit:not(.oj-form-control-default) .oj-text-field .oj-text-field-container {
     text-align: inherit; }
 
+.oj-form-control-inherit:not(.oj-form-control-default) .oj-text-field-readonly-div {
+  white-space: inherit; }
+
 .oj-form-control-inherit:not(.oj-form-control-default) .oj-text-field:not(.oj-disabled) .oj-text-field-input,
 .oj-form-control-inherit:not(.oj-form-control-default) .oj-text-field:not(.oj-disabled) .oj-text-field-readonly-div,
 .oj-form-control-inherit:not(.oj-form-control-default) .oj-text-field:not(.oj-disabled) .oj-text-field-container {
@@ -20843,7 +20846,6 @@ oj-tree-view {
   -webkit-user-select: none;
       -ms-user-select: none;
           user-select: none;
-  min-width: -webkit-fit-content;
   min-width: fit-content;
   min-width: -moz-fit-content; }
 

package/dist/css/redwood/oj-redwood.css

@@ -370,7 +370,7 @@
   visibility: hidden; }
 
 .oj-theme-json {
-  font-family: '{"name":"redwood","targetPlatform":"all","behavior":"redwood","jetReleaseVersion":"v10.0.3"}' !important; }
+  font-family: '{"name":"redwood","targetPlatform":"all","behavior":"redwood","jetReleaseVersion":"v10.0.7"}' !important; }
 
 .oj-helper-hidden-accessible {
   border: 0;
@@ -9417,6 +9417,9 @@ oj-label-value:not(.oj-formlayout-labels-inline) .oj-label {
   .oj-form-control-inherit:not(.oj-form-control-default) .oj-text-field .oj-text-field-container {
     text-align: inherit; }
 
+.oj-form-control-inherit:not(.oj-form-control-default) .oj-text-field-readonly-div {
+  white-space: inherit; }
+
 .oj-form-control-inherit:not(.oj-form-control-default) .oj-text-field:not(.oj-disabled) .oj-text-field-input,
 .oj-form-control-inherit:not(.oj-form-control-default) .oj-text-field:not(.oj-disabled) .oj-text-field-readonly-div,
 .oj-form-control-inherit:not(.oj-form-control-default) .oj-text-field:not(.oj-disabled) .oj-text-field-container {
@@ -23489,7 +23492,6 @@ oj-tree-view {
   -webkit-user-select: none;
       -ms-user-select: none;
           user-select: none;
-  min-width: -webkit-fit-content;
   min-width: fit-content;
   min-width: -moz-fit-content; }
 

package/dist/js/libs/oj/debug/ojactioncard.js

@@ -54,8 +54,6 @@ define(['exports', 'ojs/ojvcomponent-element', 'ojs/ojdomutils', 'ojs/ojdatacoll
             if (!this._isFromActiveSource(event)) {
                 if (this.state.active) {
                     this.updateState({ active: false });
-                    event.preventDefault();
-                    event.stopPropagation();
                     (_b = (_a = this.props).onOjAction) === null || _b === void 0 ? void 0 : _b.call(_a, { originalEvent: event });
                 }
             }
@@ -83,8 +81,6 @@ define(['exports', 'ojs/ojvcomponent-element', 'ojs/ojdomutils', 'ojs/ojdatacoll
             var _a, _b;
             if (!this._isFromActiveSource(event)) {
                 if (event.key === 'Enter' || event.key === ' ') {
-                    event.preventDefault();
-                    event.stopPropagation();
                     this.updateState({ active: false });
                     (_b = (_a = this.props).onOjAction) === null || _b === void 0 ? void 0 : _b.call(_a, { originalEvent: event });
                 }
@@ -99,8 +95,6 @@ define(['exports', 'ojs/ojvcomponent-element', 'ojs/ojdomutils', 'ojs/ojdatacoll
             var _a, _b;
             if (!this._isFromActiveSource(event)) {
                 if (this.state.active) {
-                    event.preventDefault();
-                    event.stopPropagation();
                     this.updateState({ active: false });
                     (_b = (_a = this.props).onOjAction) === null || _b === void 0 ? void 0 : _b.call(_a, { originalEvent: event });
                 }

package/dist/js/libs/oj/debug/ojbufferingdataprovider.js

@@ -159,11 +159,42 @@ define(['ojs/ojcore-base', 'ojs/ojdataprovider', 'ojs/ojeventtarget', 'ojs/ojmap
      */
 
     /**
-     * @inheritdoc
+     * Get an AsyncIterable object for iterating the data.
+     * <p>
+     * AsyncIterable contains a Symbol.asyncIterator method that returns an AsyncIterator.
+     * AsyncIterator contains a “next” method for fetching the next block of data.
+     * </p><p>
+     * The "next" method returns a promise that resolves to an object, which contains a "value" property for the data and a "done" property
+     * that is set to true when there is no more data to be fetched.  The "done" property should be set to true only if there is no "value"
+     * in the result.  Note that "done" only reflects whether the iterator is done at the time "next" is called.  Future calls to "next"
+     * may or may not return more rows for a mutable data source.
+     * </p>
+     * <p>
+     * Please see the <a href="DataProvider.html#custom-implementations-section">DataProvider documentation</a> for
+     * more information on custom implementations.
+     * </p>
+     *
+     * @param {FetchListParameters=} params fetch parameters
+     * @return {AsyncIterable.<FetchListResult>} AsyncIterable with {@link FetchListResult}
+     * @see {@link https://github.com/tc39/proposal-async-iteration} for further information on AsyncIterable.
+     * @export
+     * @expose
      * @memberof BufferingDataProvider
      * @instance
      * @method
      * @name fetchFirst
+     * @ojsignature {target: "Type",
+     *               value: "(parameters?: FetchListParameters<D>): AsyncIterable<FetchListResult<K, D>>"}
+     * @ojtsexample <caption>Get an asyncIterator and then fetch first block of data by executing next() on the iterator. Subsequent blocks can be fetched by executing next() again.</caption>
+     * let asyncIterator = dataprovider.fetchFirst(options)[Symbol.asyncIterator]();
+     * let result = await asyncIterator.next();
+     * let value = result.value;
+     * let data = value.data;
+     * let keys = value.metadata.map(function(val) {
+     *   return val.key;
+     * });
+     * // true or false for done
+     * let done = result.done;
      */
 
     /**

package/dist/js/libs/oj/debug/ojcollectiondataprovider.js

@@ -62,11 +62,45 @@ define(['ojs/ojcore-base', 'ojs/ojcollectiontabledatasource', 'ojs/ojdataprovide
      */
 
     /**
-     * @inheritdoc
+     * Get an AsyncIterable object for iterating the data.
+     * <p>
+     * AsyncIterable contains a Symbol.asyncIterator method that returns an AsyncIterator.
+     * AsyncIterator contains a “next” method for fetching the next block of data.
+     * </p><p>
+     * The "next" method returns a promise that resolves to an object, which contains a "value" property for the data and a "done" property
+     * that is set to true when there is no more data to be fetched.  The "done" property should be set to true only if there is no "value"
+     * in the result.  Note that "done" only reflects whether the iterator is done at the time "next" is called.  Future calls to "next"
+     * may or may not return more rows for a mutable data source.
+     * </p><p>
+     * The iterator accounts for data mutations when returning the next block of data, so that no row is duplicated or skipped.
+     * It will adjust the offset from which the next block of data starts if rows
+     * have been added or removed in the returned data.
+     * </p><p>
+     * Please see the <a href="DataProvider.html#custom-implementations-section">DataProvider documentation</a> for
+     * more information on custom implementations.
+     * </p>
+     *
+     * @param {FetchListParameters=} params fetch parameters
+     * @return {AsyncIterable.<FetchListResult>} AsyncIterable with {@link FetchListResult}
+     * @see {@link https://github.com/tc39/proposal-async-iteration} for further information on AsyncIterable.
+     * @export
+     * @expose
      * @memberof CollectionDataProvider
      * @instance
      * @method
      * @name fetchFirst
+     * @ojsignature {target: "Type",
+     *               value: "(parameters?: FetchListParameters<D>): AsyncIterable<FetchListResult<K, D>>"}
+     * @ojtsexample <caption>Get an asyncIterator and then fetch first block of data by executing next() on the iterator. Subsequent blocks can be fetched by executing next() again.</caption>
+     * let asyncIterator = dataprovider.fetchFirst(options)[Symbol.asyncIterator]();
+     * let result = await asyncIterator.next();
+     * let value = result.value;
+     * let data = value.data;
+     * let keys = value.metadata.map(function(val) {
+     *   return val.key;
+     * });
+     * // true or false for done
+     * let done = result.done;
      */
 
     /**

package/dist/js/libs/oj/debug/ojcore-base.js

@@ -52,12 +52,12 @@
      * @global
      * @member {string} version JET version numberr
      */
-    version: '10.0.3',
+    version: '10.0.7',
     /**
      * @global
      * @member {string} revision JET source code revision number
      */
-    revision: '2021-03-17_12-00-27',
+    revision: '2021-12-14_08-10-04',
 
     // This function is only meant to be used outside the library, so quoting the name
     // to avoid renaming is appropriate

package/dist/js/libs/oj/debug/ojdataprovider.js

@@ -224,13 +224,95 @@ define(['exports', 'ojs/ojcore-base', 'ojs/ojeventtarget'], function (exports, o
      * It is for convenience and may not provide the most efficient implementation for your data provider.
      * Classes that implement the DataProvider interface are encouraged to provide a more efficient implementation.
      * </p>
+     * <p>
+     * In order for JET components to work correctly, DataProvider implementations should ensure that:
+     * <ul>
+     *   <li>
+     *     The iterator accounts for data mutations when returning the next block of data, and that no row is duplicated or skipped.
+     *     For example, an offset-based implementation may need to adjust the offset from which the next block of data starts if rows
+     *     have been added or removed in the returned data.
+     *   </li>
+     *   <li>
+     *     JET components may call "next" on the iterator even after the iterator has returned done:true.  If new data is available after
+     *     the last returned row, the iterator is expected to return the new data and set "done" to false.
+     *     This differs from the AsyncIterator spec for performance reasons.
+     *   </li>
+     * </ul>
+     * </p>
+     * <p>Assuming that a DataProvider has returned rows indexed 0 to 9. Normally it should start the next block at index 10. Now consider
+     *    the following distinct mutation cases:</p>
+     * <ul>
+     *   <li>If a row is added at index 5, the DataProvider should fire a "mutate" event with the added row, and starts the
+     *       next block at index 11.</li>
+     *   <li>On the other hand, if a row is removed at index 5, the DataProvider should fire a "mutate" event with the removed row, and starts the
+     *       next block at index 9.</li>
+     * </ul>
+     * <i>Example of adjusting the offset upon mutations for a DataProvider implementation that keeps track of its own offset.
+     * This is just an illustration of what some implementations might do. The necessary adjustment is highly dependent of the
+     * individual implementation.
+     * </i>
+     * <pre class="prettyprint"><code>
+     * // offset is the current offset to start the next fetch
+     * // removeIndexes is an array of indexes for removed items relative to the original dataset
+     * // addIndexes is an array of indexes for added items relative to the dataset after the mutations
+     * function getNewOffset(offset, removeIndexes, addIndexes) {
+     *   let removeCount = 0;
+     *
+     *   if (removeIndexes) {
+     *     removeIndexes.forEach(function (index) {
+     *       // only count the changes below the last offset
+     *       if (index < offset) {
+     *         ++removeCount;
+     *       }
+     *     });
+     *   }
+     *
+     *   offset -= removeCount;
+     *   if (addIndexes) {
+     *     addIndexes.forEach(function (index) {
+     *       // only count the changes below the last offset
+     *       if (index < offset) {
+     *         ++offset;
+     *       }
+     *     });
+     *   }
+     *
+     *   return offset;
+     * }
+     * </code></pre>
      */
     oj.DataProvider = function () {
     };
 
     /**
-     * Get an asyncIterator which can be used to fetch a block of data.
-     *
+     * Get an AsyncIterable object for iterating the data.
+     * <p>
+     * AsyncIterable contains a Symbol.asyncIterator method that returns an AsyncIterator.
+     * AsyncIterator contains a “next” method for fetching the next block of data.
+     * </p><p>
+     * The "next" method returns a promise that resolves to an object, which contains a "value" property for the data and a "done" property
+     * that is set to true when there is no more data to be fetched.  The "done" property should be set to true only if there is no "value"
+     * in the result.  Note that "done" only reflects whether the iterator is done at the time "next" is called.  Future calls to "next"
+     * may or may not return more rows for a mutable data source.
+     * </p><p>
+     * In order for JET components to work correctly, DataProvider implementations should ensure that:
+     * </p>
+     * <ul>
+     *   <li>
+     *     The iterator accounts for data mutations when returning the next block of data, and that no row is duplicated or skipped.
+     *     For example, an offset-based implementation may need to adjust the offset from which the next block of data starts if rows
+     *     have been added or removed in the returned data.
+     *   </li>
+     *   <li>
+     *     JET components may call "next" on the iterator even after the iterator has returned done:true.  If new data is available after
+     *     the last returned row, the iterator is expected to return the new data and set "done" to false.
+     *     This differs from the AsyncIterator spec for performance reasons.
+     *   </li>
+     * </ul>
+     * <p>
+     * Please see the <a href="DataProvider.html#custom-implementations-section">DataProvider documentation</a> for
+     * more information on custom implementations.
+     * </p>
      *
      * @since 4.2.0
      * @param {FetchListParameters=} params fetch parameters

package/dist/js/libs/oj/debug/ojdataproviderscroller.js

@@ -619,7 +619,7 @@ define(['exports', 'ojs/ojcore-base', 'jquery', 'ojs/ojcontext', 'ojs/ojconfig',
    */
   DataProviderContentHandler.prototype.handleModelAddEvent = function (event) {
     // if listview is busy, queue it for processing later
-    if (!this.IsReadyForMutation()) {
+    if (!this.IsReady()) {
       this._pushToEventQueue({ type: event.type, event: event });
       return;
     }
@@ -825,8 +825,8 @@ define(['exports', 'ojs/ojcore-base', 'jquery', 'ojs/ojcontext', 'ojs/ojconfig',
       return false;
     }
 
-      // if listview is busy, hold that off until later
-    if (!this.IsReadyForMutation()) {
+    // if listview is busy, hold that off until later
+    if (!this.IsReady()) {
       this._pushToEventQueue({ type: event.type, event: event });
       return false;
     }
@@ -2590,12 +2590,31 @@ define(['exports', 'ojs/ojcore-base', 'jquery', 'ojs/ojcontext', 'ojs/ojconfig',
     return referenceNode;
   };
 
+  /**
+   * @private
+   */
+  IteratingDataProviderContentHandler.prototype._isIterateAfterDoneNotAllowed = function () {
+    var dataProvider = this.getDataProvider();
+    if (dataProvider && dataProvider.getCapability) {
+      var capability = dataProvider.getCapability('fetchFirst');
+      if (capability && capability.iterateAfterDone === 'notAllowed') {
+        return true;
+      }
+    }
+    return false;
+  };
+
   /**
    * Gets the maximum index for insert event
    * @private
    */
   IteratingDataProviderContentHandler.prototype._getMaxIndexForInsert = function () {
     var max = Number.MAX_VALUE;
+    // temporary solution for SDP
+    if (this._isIterateAfterDoneNotAllowed() && !this.hasMoreToFetch()) {
+      return max;
+    }
+
     // only care about child count if there's more to fetch
     if (this._isLoadMoreOnScroll()) {
       max = $(this.m_root).children('li.' + this.m_widget.getItemElementStyleClass()).length;
@@ -2623,6 +2642,12 @@ define(['exports', 'ojs/ojcore-base', 'jquery', 'ojs/ojcontext', 'ojs/ojconfig',
 
       var promises = [];
       for (var i = 0; i < data.length; i++) {
+        // ignore if the item with key already exists
+        if (this.FindElementByKey(keys[i]) != null) {
+          // eslint-disable-next-line no-continue
+          continue;
+        }
+
         this.signalTaskStart('handling model add event for item: ' + keys[i]); // signal add item start
         // indexes takes precedence
         var index;
@@ -2634,7 +2659,9 @@ define(['exports', 'ojs/ojcore-base', 'jquery', 'ojs/ojcontext', 'ojs/ojconfig',
             index = isBeforeKeys ? index : index + 1;
           } else if (this._isLoadMoreOnScroll()) {
             // if append to the end
-            index = max;
+            if (!this._isIterateAfterDoneNotAllowed() || this.hasMoreToFetch()) {
+              index = max;
+            }
           }
         }
         // we skip any insert/append outside of range if there's still more to fetch

package/dist/js/libs/oj/debug/ojdeferreddataprovider.js

@@ -73,11 +73,42 @@ define(['ojs/ojcore-base', 'ojs/ojcomponentcore'], function (oj, ojcomponentcore
      */
 
     /**
-     * @inheritdoc
+     * Get an AsyncIterable object for iterating the data.
+     * <p>
+     * AsyncIterable contains a Symbol.asyncIterator method that returns an AsyncIterator.
+     * AsyncIterator contains a “next” method for fetching the next block of data.
+     * </p><p>
+     * The "next" method returns a promise that resolves to an object, which contains a "value" property for the data and a "done" property
+     * that is set to true when there is no more data to be fetched.  The "done" property should be set to true only if there is no "value"
+     * in the result.  Note that "done" only reflects whether the iterator is done at the time "next" is called.  Future calls to "next"
+     * may or may not return more rows for a mutable data source.
+     * </p>
+     * <p>
+     * Please see the <a href="DataProvider.html#custom-implementations-section">DataProvider documentation</a> for
+     * more information on custom implementations.
+     * </p>
+     *
+     * @param {FetchListParameters=} params fetch parameters
+     * @return {AsyncIterable.<FetchListResult>} AsyncIterable with {@link FetchListResult}
+     * @see {@link https://github.com/tc39/proposal-async-iteration} for further information on AsyncIterable.
+     * @export
+     * @expose
      * @memberof DeferredDataProvider
      * @instance
      * @method
      * @name fetchFirst
+     * @ojsignature {target: "Type",
+     *               value: "(parameters?: FetchListParameters<D>): AsyncIterable<FetchListResult<K, D>>"}
+     * @ojtsexample <caption>Get an asyncIterator and then fetch first block of data by executing next() on the iterator. Subsequent blocks can be fetched by executing next() again.</caption>
+     * let asyncIterator = dataprovider.fetchFirst(options)[Symbol.asyncIterator]();
+     * let result = await asyncIterator.next();
+     * let value = result.value;
+     * let data = value.data;
+     * let keys = value.metadata.map(function(val) {
+     *   return val.key;
+     * });
+     * // true or false for done
+     * let done = result.done;
      */
 
     /**

package/dist/js/libs/oj/debug/ojdvt-toolkit.js

@@ -10895,8 +10895,8 @@ define(['exports', 'ojs/ojthemeutils'], function (exports, ThemeUtils) { 'use st
    */
   HtmlTooltipManager._restoreTag = function (text, tag) {
     // Match the following: <tag...>, </tag...>, and <tag.../>
-    var regExp = new RegExp('&lt;(/?)' + tag + '([^&]*)(/?)&gt;', 'g');
-    return text.replace(regExp, '<$1' + tag + '$2$3>');
+    var regExp = new RegExp('&lt;(/?)(' + tag + ')(?=[\\s&/])([^&]*)(/?)&gt;', 'g');
+    return text.replace(regExp, '<$1' + tag + '$3$4>');
   };
 
   /**

package/dist/js/libs/oj/debug/ojfilepickerutils.js

@@ -5,7 +5,9 @@
  * as shown at https://oss.oracle.com/licenses/upl/
  * @ignore
  */
-define(['exports'], function (exports) { 'use strict';
+define(['exports', 'ojs/ojcore-base'], function (exports, oj) { 'use strict';
+
+    oj = oj && Object.prototype.hasOwnProperty.call(oj, 'default') ? oj['default'] : oj;
 
     /**
      * @license
@@ -43,8 +45,17 @@ define(['exports'], function (exports) { 'use strict';
      * @property {'single' | 'multiple'} selectionMode - Whether to allow single or multiple file selection.  Single is the default.
      */
 
-    function pickFiles(callback, fileOptions) {
-        const input = document.createElement('input');
+    let input;
+    const isIOS = oj.AgentUtils.getAgentInfo().os === oj.AgentUtils.OS.IOS;
+    const teardownInput = () => {
+        if (isIOS)
+            document.body.removeChild(input);
+        input = null;
+    };
+    const setupInput = (fileOptions) => {
+        if (input)
+            teardownInput();
+        input = document.createElement('input');
         input.type = 'file';
         if ((fileOptions === null || fileOptions === void 0 ? void 0 : fileOptions.capture) && fileOptions.capture != 'none') {
             input.capture = fileOptions.capture;
@@ -53,8 +64,15 @@ define(['exports'], function (exports) { 'use strict';
         const accept = acceptProp && acceptProp.length ? acceptProp.join(',') : null;
         input.accept = accept;
         input.multiple = (fileOptions === null || fileOptions === void 0 ? void 0 : fileOptions.selectionMode) == 'multiple';
+        input.style.display = 'none';
+        if (isIOS)
+            document.body.appendChild(input);
+    };
+    function pickFiles(callback, fileOptions) {
+        setupInput(fileOptions);
         input.onchange = function () {
             callback(input.files);
+            teardownInput();
         };
         input.click();
     }

package/dist/js/libs/oj/debug/ojflattenedtreedataproviderview.js

@@ -160,11 +160,42 @@ define(['ojs/ojcore-base', 'ojs/ojset', 'ojs/ojeventtarget', 'ojs/ojkeyset', 'oj
      */
 
     /**
-     * @inheritdoc
+     * Get an AsyncIterable object for iterating the data.
+     * <p>
+     * AsyncIterable contains a Symbol.asyncIterator method that returns an AsyncIterator.
+     * AsyncIterator contains a “next” method for fetching the next block of data.
+     * </p><p>
+     * The "next" method returns a promise that resolves to an object, which contains a "value" property for the data and a "done" property
+     * that is set to true when there is no more data to be fetched.  The "done" property should be set to true only if there is no "value"
+     * in the result.  Note that "done" only reflects whether the iterator is done at the time "next" is called.  Future calls to "next"
+     * may or may not return more rows for a mutable data source.
+     * </p>
+     * <p>
+     * Please see the <a href="DataProvider.html#custom-implementations-section">DataProvider documentation</a> for
+     * more information on custom implementations.
+     * </p>
+     *
+     * @param {FetchListParameters=} params fetch parameters
+     * @return {AsyncIterable.<FetchListResult>} AsyncIterable with {@link FetchListResult}
+     * @see {@link https://github.com/tc39/proposal-async-iteration} for further information on AsyncIterable.
+     * @export
+     * @expose
      * @memberof FlattenedTreeDataProviderView
      * @instance
      * @method
      * @name fetchFirst
+     * @ojsignature {target: "Type",
+     *               value: "(parameters?: FetchListParameters<D>): AsyncIterable<FetchListResult<K, D>>"}
+     * @ojtsexample <caption>Get an asyncIterator and then fetch first block of data by executing next() on the iterator. Subsequent blocks can be fetched by executing next() again.</caption>
+     * let asyncIterator = dataprovider.fetchFirst(options)[Symbol.asyncIterator]();
+     * let result = await asyncIterator.next();
+     * let value = result.value;
+     * let data = value.data;
+     * let keys = value.metadata.map(function(val) {
+     *   return val.key;
+     * });
+     * // true or false for done
+     * let done = result.done;
      */
 
     /**

package/dist/js/libs/oj/debug/ojgroupingdataprovider.js

@@ -115,12 +115,24 @@ define(['ojs/ojcore-base', 'jquery', 'knockout', 'ojs/ojarraytreedataprovider',
      *               value: "(params: FetchByOffsetParameters<D>): Promise<FetchByOffsetResults<K, D>>"}
      */
 
-
     /**
-     * Fetch the first block of data.
+     * Get an AsyncIterable object for iterating the data.
+     * <p>
+     * AsyncIterable contains a Symbol.asyncIterator method that returns an AsyncIterator.
+     * AsyncIterator contains a “next” method for fetching the next block of data.
+     * </p><p>
+     * The "next" method returns a promise that resolves to an object, which contains a "value" property for the data and a "done" property
+     * that is set to true when there is no more data to be fetched.  The "done" property should be set to true only if there is no "value"
+     * in the result.  Note that "done" only reflects whether the iterator is done at the time "next" is called.  Future calls to "next"
+     * may or may not return more rows for a mutable data source.
+     * </p>
+     * <p>
+     * Please see the <a href="DataProvider.html#custom-implementations-section">DataProvider documentation</a> for
+     * more information on custom implementations.
+     * </p>
      *
-     * @param {oj.FetchListParameters=} params Fetch parameters
-     * @return {AsyncIterable.<oj.FetchListResult>} AsyncIterable with {@link oj.FetchListResult}
+     * @param {FetchListParameters=} params fetch parameters
+     * @return {AsyncIterable.<FetchListResult>} AsyncIterable with {@link FetchListResult}
      * @see {@link https://github.com/tc39/proposal-async-iteration} for further information on AsyncIterable.
      * @export
      * @expose
@@ -129,7 +141,17 @@ define(['ojs/ojcore-base', 'jquery', 'knockout', 'ojs/ojarraytreedataprovider',
      * @method
      * @name fetchFirst
      * @ojsignature {target: "Type",
-     *               value: "(params?: FetchListParameters<D>): AsyncIterable<FetchListResult<K, D>>"}
+     *               value: "(parameters?: FetchListParameters<D>): AsyncIterable<FetchListResult<K, D>>"}
+     * @ojtsexample <caption>Get an asyncIterator and then fetch first block of data by executing next() on the iterator. Subsequent blocks can be fetched by executing next() again.</caption>
+     * let asyncIterator = dataprovider.fetchFirst(options)[Symbol.asyncIterator]();
+     * let result = await asyncIterator.next();
+     * let value = result.value;
+     * let data = value.data;
+     * let keys = value.metadata.map(function(val) {
+     *   return val.key;
+     * });
+     * // true or false for done
+     * let done = result.done;
      */
 
     /**

package/dist/js/libs/oj/debug/ojjoiningdataprovider.js

@@ -136,11 +136,42 @@ define(['ojs/ojmap', 'ojs/ojset', 'ojs/ojeventtarget', 'ojs/ojlogger'], function
      */
 
     /**
-     * @inheritdoc
+     * Get an AsyncIterable object for iterating the data.
+     * <p>
+     * AsyncIterable contains a Symbol.asyncIterator method that returns an AsyncIterator.
+     * AsyncIterator contains a “next” method for fetching the next block of data.
+     * </p><p>
+     * The "next" method returns a promise that resolves to an object, which contains a "value" property for the data and a "done" property
+     * that is set to true when there is no more data to be fetched.  The "done" property should be set to true only if there is no "value"
+     * in the result.  Note that "done" only reflects whether the iterator is done at the time "next" is called.  Future calls to "next"
+     * may or may not return more rows for a mutable data source.
+     * </p>
+     * <p>
+     * Please see the <a href="DataProvider.html#custom-implementations-section">DataProvider documentation</a> for
+     * more information on custom implementations.
+     * </p>
+     *
+     * @param {FetchListParameters=} params fetch parameters
+     * @return {AsyncIterable.<FetchListResult>} AsyncIterable with {@link FetchListResult}
+     * @see {@link https://github.com/tc39/proposal-async-iteration} for further information on AsyncIterable.
+     * @export
+     * @expose
      * @memberof JoiningDataProvider
      * @instance
      * @method
      * @name fetchFirst
+     * @ojsignature {target: "Type",
+     *               value: "(parameters?: FetchListParameters<D>): AsyncIterable<FetchListResult<K, D>>"}
+     * @ojtsexample <caption>Get an asyncIterator and then fetch first block of data by executing next() on the iterator. Subsequent blocks can be fetched by executing next() again.</caption>
+     * let asyncIterator = dataprovider.fetchFirst(options)[Symbol.asyncIterator]();
+     * let result = await asyncIterator.next();
+     * let value = result.value;
+     * let data = value.data;
+     * let keys = value.metadata.map(function(val) {
+     *   return val.key;
+     * });
+     * // true or false for done
+     * let done = result.done;
      */
 
     /**

package/dist/js/libs/oj/debug/ojlistdataproviderview.js

@@ -80,11 +80,42 @@ define(['ojs/ojcore-base', 'ojs/ojdataprovider', 'ojs/ojeventtarget'], function
      */
 
     /**
-     * @inheritdoc
+     * Get an AsyncIterable object for iterating the data.
+     * <p>
+     * AsyncIterable contains a Symbol.asyncIterator method that returns an AsyncIterator.
+     * AsyncIterator contains a “next” method for fetching the next block of data.
+     * </p><p>
+     * The "next" method returns a promise that resolves to an object, which contains a "value" property for the data and a "done" property
+     * that is set to true when there is no more data to be fetched.  The "done" property should be set to true only if there is no "value"
+     * in the result.  Note that "done" only reflects whether the iterator is done at the time "next" is called.  Future calls to "next"
+     * may or may not return more rows for a mutable data source.
+     * </p>
+     * <p>
+     * Please see the <a href="DataProvider.html#custom-implementations-section">DataProvider documentation</a> for
+     * more information on custom implementations.
+     * </p>
+     *
+     * @param {FetchListParameters=} params fetch parameters
+     * @return {AsyncIterable.<FetchListResult>} AsyncIterable with {@link FetchListResult}
+     * @see {@link https://github.com/tc39/proposal-async-iteration} for further information on AsyncIterable.
+     * @export
+     * @expose
      * @memberof ListDataProviderView
      * @instance
      * @method
      * @name fetchFirst
+     * @ojsignature {target: "Type",
+     *               value: "(parameters?: FetchListParameters<D>): AsyncIterable<FetchListResult<K, D>>"}
+     * @ojtsexample <caption>Get an asyncIterator and then fetch first block of data by executing next() on the iterator. Subsequent blocks can be fetched by executing next() again.</caption>
+     * let asyncIterator = dataprovider.fetchFirst(options)[Symbol.asyncIterator]();
+     * let result = await asyncIterator.next();
+     * let value = result.value;
+     * let data = value.data;
+     * let keys = value.metadata.map(function(val) {
+     *   return val.key;
+     * });
+     * // true or false for done
+     * let done = result.done;
      */
 
     /**