virtual-scroller 1.7.9 → 1.9.0

package/modules/VirtualScroller.items.js

@@ -0,0 +1,288 @@
+function ownKeys(object, enumerableOnly) { var keys = Object.keys(object); if (Object.getOwnPropertySymbols) { var symbols = Object.getOwnPropertySymbols(object); enumerableOnly && (symbols = symbols.filter(function (sym) { return Object.getOwnPropertyDescriptor(object, sym).enumerable; })), keys.push.apply(keys, symbols); } return keys; }
+
+function _objectSpread(target) { for (var i = 1; i < arguments.length; i++) { var source = null != arguments[i] ? arguments[i] : {}; i % 2 ? ownKeys(Object(source), !0).forEach(function (key) { _defineProperty(target, key, source[key]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(target, Object.getOwnPropertyDescriptors(source)) : ownKeys(Object(source)).forEach(function (key) { Object.defineProperty(target, key, Object.getOwnPropertyDescriptor(source, key)); }); } return target; }
+
+function _defineProperty(obj, key, value) { if (key in obj) { Object.defineProperty(obj, key, { value: value, enumerable: true, configurable: true, writable: true }); } else { obj[key] = value; } return obj; }
+
+import log, { isDebug } from './utility/debug.js';
+import getItemsDiff from './getItemsDiff.js';
+export default function () {
+  var _this = this;
+
+  this.getItemsCount = function () {
+    return _this.getState().items.length;
+  };
+  /**
+   * Updates `items`. For example, can prepend or append new items to the list.
+   * @param  {any[]} newItems
+   * @param {boolean} [options.preserveScrollPositionOnPrependItems] — Set to `true` to enable "restore scroll position after prepending items" feature (could be useful when implementing "Show previous items" button).
+   */
+
+
+  this._setItems = function (newItems) {
+    var options = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {};
+
+    var _this$getState = _this.getState(),
+        previousItems = _this$getState.items; // Even if `newItems` are equal to `this.state.items`,
+    // still perform a `updateState()` call, because, if `updateState()` calls
+    // were "asynchronous", there could be a situation when a developer
+    // first calls `setItems(newItems)` and then `setItems(oldItems)`:
+    // if this function did `return` `if (newItems === this.state.items)`
+    // then `updateState({ items: newItems })` would be scheduled as part of
+    // `setItems(newItems)` call, but the subsequent `setItems(oldItems)` call
+    // wouldn't do anything resulting in `newItems` being set as a result,
+    // and that wouldn't be what the developer intended.
+
+
+    var _this$getState2 = _this.getState(),
+        itemStates = _this$getState2.itemStates;
+
+    var _ref = _this.widthHasChanged ? _this.widthHasChanged.stateUpdate : _this.getState(),
+        itemHeights = _ref.itemHeights;
+
+    log('~ Update items ~');
+    var layoutUpdate;
+    var itemsUpdateInfo; // Compare the new items to the current items.
+
+    var itemsDiff = _this.getItemsDiff(previousItems, newItems); // See if it's an "incremental" items update.
+
+
+    if (itemsDiff) {
+      var _ref2 = _this.widthHasChanged ? _this.widthHasChanged.stateUpdate : _this.getState(),
+          firstShownItemIndex = _ref2.firstShownItemIndex,
+          lastShownItemIndex = _ref2.lastShownItemIndex,
+          beforeItemsHeight = _ref2.beforeItemsHeight,
+          afterItemsHeight = _ref2.afterItemsHeight;
+
+      var shouldRestoreScrollPosition = firstShownItemIndex === 0 && ( // `preserveScrollPosition` option name is deprecated,
+      // use `preserveScrollPositionOnPrependItems` instead.
+      options.preserveScrollPositionOnPrependItems || options.preserveScrollPosition);
+      var prependedItemsCount = itemsDiff.prependedItemsCount,
+          appendedItemsCount = itemsDiff.appendedItemsCount;
+      var shouldResetGridLayout;
+      layoutUpdate = _this.layout.getLayoutUpdateForItemsDiff({
+        firstShownItemIndex: firstShownItemIndex,
+        lastShownItemIndex: lastShownItemIndex,
+        beforeItemsHeight: beforeItemsHeight,
+        afterItemsHeight: afterItemsHeight
+      }, {
+        prependedItemsCount: prependedItemsCount,
+        appendedItemsCount: appendedItemsCount
+      }, {
+        itemsCount: newItems.length,
+        columnsCount: _this.getActualColumnsCount(),
+        shouldRestoreScrollPosition: shouldRestoreScrollPosition,
+        onResetGridLayout: function onResetGridLayout() {
+          return shouldResetGridLayout = true;
+        }
+      });
+
+      if (prependedItemsCount > 0) {
+        log('Prepend', prependedItemsCount, 'items');
+        itemHeights = new Array(prependedItemsCount).concat(itemHeights);
+
+        if (itemStates) {
+          itemStates = new Array(prependedItemsCount).concat(itemStates);
+        } // Restore scroll position after prepending items (if requested).
+
+
+        if (shouldRestoreScrollPosition) {
+          log('Will restore scroll position');
+
+          _this.listHeightMeasurement.snapshotListHeightBeforeAddingNewItems({
+            previousItems: previousItems,
+            newItems: newItems,
+            prependedItemsCount: prependedItemsCount
+          }); // "Seamless prepend" scenario doesn't result in a re-layout,
+          // so if any "non measured item" is currently pending,
+          // it doesn't get reset and will be handled after `state` is updated.
+
+
+          if (_this.firstNonMeasuredItemIndex !== undefined) {
+            _this.firstNonMeasuredItemIndex += prependedItemsCount;
+          }
+        } else {
+          log('Reset layout');
+
+          if (shouldResetGridLayout) {
+            log('Reason: Prepended items count', prependedItemsCount, 'is not divisible by Columns Count', _this.getActualColumnsCount()); // Reset item heights because the whole grid is going to be rebalanced
+            // and re-rendered in a different configuration.
+
+            itemHeights = new Array(newItems.length);
+          } else {
+            // Reset layout because none of the prepended items have been measured.
+            log('Reason: Prepended items\' heights are unknown');
+          }
+
+          layoutUpdate = _this.layout.getInitialLayoutValues({
+            itemsCount: newItems.length,
+            columnsCount: _this.getActualColumnsCount()
+          }); // Unschedule a potentially scheduled layout update
+          // after measuring a previously non-measured item
+          // because the list will be re-layout anyway
+          // due to the new items being set.
+
+          _this.firstNonMeasuredItemIndex = undefined;
+        }
+      }
+
+      if (appendedItemsCount > 0) {
+        log('Append', appendedItemsCount, 'items');
+        itemHeights = itemHeights.concat(new Array(appendedItemsCount));
+
+        if (itemStates) {
+          itemStates = itemStates.concat(new Array(appendedItemsCount));
+        }
+      }
+
+      itemsUpdateInfo = {
+        prepend: prependedItemsCount > 0,
+        append: appendedItemsCount > 0
+      };
+    } else {
+      log('Items have changed, and', itemsDiff ? 'a re-layout from scratch has been requested.' : 'it\'s not a simple append and/or prepend.', 'Rerender the entire list from scratch.');
+      log('Previous items', previousItems);
+      log('New items', newItems); // Reset item heights and item states.
+
+      itemHeights = new Array(newItems.length);
+      itemStates = new Array(newItems.length);
+      layoutUpdate = _this.layout.getInitialLayoutValues({
+        itemsCount: newItems.length,
+        columnsCount: _this.getActualColumnsCount()
+      }); // Unschedule a potentially scheduled layout update
+      // after measuring a previously non-measured item
+      // because the list will be re-layout from scratch
+      // due to the new items being set.
+
+      _this.firstNonMeasuredItemIndex = undefined; // Also reset any potential pending scroll position restoration.
+      // For example, imagine a developer first called `.setItems(incrementalItemsUpdate)`
+      // and then called `.setItems(differentItems)` and there was no state update
+      // in between those two calls. This could happen because state updates aren't
+      // required to be "synchronous". On other words, calling `this.updateState()`
+      // doesn't necessarily mean that the state is applied immediately.
+      // Imagine also that such "delayed" state updates could be batched,
+      // like they do in React inside event handlers (though that doesn't apply to this case):
+      // https://github.com/facebook/react/issues/10231#issuecomment-316644950
+      // If `this.listHeightMeasurement` wasn't reset on `.setItems(differentItems)`
+      // and if the second `this.updateState()` call overwrites the first one
+      // then it would attempt to restore scroll position in a situation when
+      // it should no longer do that. Hence the reset here.
+
+      _this.listHeightMeasurement.reset();
+
+      itemsUpdateInfo = {
+        replace: true
+      };
+    }
+
+    log('~ Update state ~'); // const layoutValuesAfterUpdate = {
+    // 	...this.getState(),
+    // 	...layoutUpdate
+    // }
+    // `layoutUpdate` is equivalent to `layoutValuesAfterUpdate` because
+    // `layoutUpdate` contains all the relevant properties.
+
+    log('First shown item index', layoutUpdate.firstShownItemIndex);
+    log('Last shown item index', layoutUpdate.lastShownItemIndex);
+    log('Before items height', layoutUpdate.beforeItemsHeight);
+    log('After items height (actual or estimated)', layoutUpdate.afterItemsHeight); // Optionally preload items to be rendered.
+    //
+    // `layoutUpdate` is equivalent to `layoutValuesAfterUpdate` because
+    // `layoutUpdate` contains all the relevant properties.
+    //
+
+    _this.onBeforeShowItems(newItems, itemHeights, layoutUpdate.firstShownItemIndex, layoutUpdate.lastShownItemIndex); // `this.newItemsWillBeRendered` signals that new `items` are being rendered,
+    // and that `VirtualScroller` should temporarily stop all other updates.
+    //
+    // `this.newItemsWillBeRendered` is cleared in `onRender()`.
+    //
+    // The values in `this.newItemsWillBeRendered` are used, for example,
+    // in `.onResize()` handler in order to not break state consistency when
+    // state updates are "asynchronous" (delayed) and there's a window resize event
+    // in between calling `updateState()` below and that call actually being applied.
+    //
+
+
+    _this.newItemsWillBeRendered = _objectSpread(_objectSpread({}, itemsUpdateInfo), {}, {
+      count: newItems.length,
+      // `layoutUpdate` now contains all layout-related properties, even if those that
+      // didn't change. So `firstShownItemIndex` is always in `this.newItemsWillBeRendered`.
+      layout: layoutUpdate
+    }); // `layoutUpdate` now contains all layout-related properties, even if those that
+    // didn't change. So this part is no longer relevant.
+    //
+    // // If `firstShownItemIndex` is gonna be modified as a result of setting new items
+    // // then keep that "new" `firstShownItemIndex` in order for it to be used by
+    // // `onResize()` handler when it calculates "new" `firstShownItemIndex`
+    // // based on the new columns count (corresponding to the new window width).
+    // if (layoutUpdate.firstShownItemIndex !== undefined) {
+    // 	this.newItemsWillBeRendered = {
+    // 		...this.newItemsWillBeRendered,
+    // 		firstShownItemIndex: layoutUpdate.firstShownItemIndex
+    // 	}
+    // }
+    // Update `VirtualScroller` state.
+    //
+    // This state update should overwrite all the `state` properties
+    // that are also updated in the "on scroll" handler (`getShownItemIndexes()`):
+    //
+    // * `firstShownItemIndex`
+    // * `lastShownItemIndex`
+    // * `beforeItemsHeight`
+    // * `afterItemsHeight`
+    //
+    // That's because this `updateState()` update has a higher priority
+    // than that of the "on scroll" handler, so it should overwrite
+    // any potential state changes dispatched by the "on scroll" handler.
+    //
+
+    var newState = _objectSpread(_objectSpread({}, layoutUpdate), {}, {
+      items: newItems,
+      itemStates: itemStates,
+      itemHeights: itemHeights
+    }); // Introduced `shouldIncludeBeforeResizeValuesInState()` getter just to prevent
+    // cluttering `state` with `beforeResize: undefined` property if `beforeResize`
+    // hasn't ever been set in `state` previously.
+
+
+    if (_this.beforeResize.shouldIncludeBeforeResizeValuesInState()) {
+      if (_this.shouldDiscardBeforeResizeItemHeights()) {
+        // Reset "before resize" item heights because now there're new items prepended
+        // with unknown heights, or completely new items with unknown heights, so
+        // `beforeItemsHeight` value won't be preserved anyway.
+        newState.beforeResize = undefined;
+      } else {
+        // Overwrite `beforeResize` property in `state` even if it wasn't modified
+        // because state updates could be "asynchronous" and in that case there could be
+        // some previous `updateState()` call from some previous `setItems()` call that
+        // hasn't yet been applied, and that previous call might have scheduled setting
+        // `state.beforeResize` property to `undefined` in order to reset it, but this
+        // next `updateState()` call might not require resetting `state.beforeResize` property
+        // so it should undo resetting it by simply overwriting it with its normal value.
+        newState.beforeResize = _this.widthHasChanged ? _this.widthHasChanged.stateUpdate.beforeResize : _this.getState().beforeResize;
+      }
+    } // `newState` should also overwrite all `state` properties that're updated in `onResize()`
+    // because `setItems()`'s state updates always overwrite `onResize()`'s state updates.
+    // (The least-priority ones are `onScroll()` state updates, but those're simply skipped
+    // if there's a pending `setItems()` or `onResize()` update).
+    //
+    // `state` property exceptions:
+    //
+    // `verticalSpacing` property is not updated here because it's fine setting it to
+    // `undefined` in `onResize()` — it will simply be re-measured after the component re-renders.
+    //
+    // `columnsCount` property is also not updated here because by definition it's only
+    // updated in `onResize()`.
+    // Render.
+
+
+    _this._isSettingNewItems = true;
+
+    _this.updateState(newState);
+  };
+
+  this.getItemsDiff = function (previousItems, newItems) {
+    return getItemsDiff(previousItems, newItems, _this.isItemEqual);
+  };
+}
+//# sourceMappingURL=VirtualScroller.items.js.map

package/modules/VirtualScroller.items.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"VirtualScroller.items.js","names":["log","isDebug","getItemsDiff","getItemsCount","getState","items","length","_setItems","newItems","options","previousItems","itemStates","widthHasChanged","stateUpdate","itemHeights","layoutUpdate","itemsUpdateInfo","itemsDiff","firstShownItemIndex","lastShownItemIndex","beforeItemsHeight","afterItemsHeight","shouldRestoreScrollPosition","preserveScrollPositionOnPrependItems","preserveScrollPosition","prependedItemsCount","appendedItemsCount","shouldResetGridLayout","layout","getLayoutUpdateForItemsDiff","itemsCount","columnsCount","getActualColumnsCount","onResetGridLayout","Array","concat","listHeightMeasurement","snapshotListHeightBeforeAddingNewItems","firstNonMeasuredItemIndex","undefined","getInitialLayoutValues","prepend","append","reset","replace","onBeforeShowItems","newItemsWillBeRendered","count","newState","beforeResize","shouldIncludeBeforeResizeValuesInState","shouldDiscardBeforeResizeItemHeights","_isSettingNewItems","updateState","isItemEqual"],"sources":["../source/VirtualScroller.items.js"],"sourcesContent":["import log, { isDebug } from './utility/debug.js'\r\nimport getItemsDiff from './getItemsDiff.js'\r\n\r\nexport default function() {\r\n\tthis.getItemsCount = () => {\r\n\t\treturn this.getState().items.length\r\n\t}\r\n\r\n\t/**\r\n\t * Updates `items`. For example, can prepend or append new items to the list.\r\n\t * @param  {any[]} newItems\r\n\t * @param {boolean} [options.preserveScrollPositionOnPrependItems] — Set to `true` to enable \"restore scroll position after prepending items\" feature (could be useful when implementing \"Show previous items\" button).\r\n\t */\r\n\tthis._setItems = (newItems, options = {}) => {\r\n\t\tconst {\r\n\t\t\titems: previousItems\r\n\t\t} = this.getState()\r\n\r\n\t\t// Even if `newItems` are equal to `this.state.items`,\r\n\t\t// still perform a `updateState()` call, because, if `updateState()` calls\r\n\t\t// were \"asynchronous\", there could be a situation when a developer\r\n\t\t// first calls `setItems(newItems)` and then `setItems(oldItems)`:\r\n\t\t// if this function did `return` `if (newItems === this.state.items)`\r\n\t\t// then `updateState({ items: newItems })` would be scheduled as part of\r\n\t\t// `setItems(newItems)` call, but the subsequent `setItems(oldItems)` call\r\n\t\t// wouldn't do anything resulting in `newItems` being set as a result,\r\n\t\t// and that wouldn't be what the developer intended.\r\n\r\n\t\tlet { itemStates } = this.getState()\r\n\t\tlet { itemHeights } = this.widthHasChanged\r\n\t\t\t? this.widthHasChanged.stateUpdate\r\n\t\t\t: this.getState()\r\n\r\n\t\tlog('~ Update items ~')\r\n\r\n\t\tlet layoutUpdate\r\n\t\tlet itemsUpdateInfo\r\n\r\n\t\t// Compare the new items to the current items.\r\n\t\tconst itemsDiff = this.getItemsDiff(previousItems, newItems)\r\n\r\n\t\t// See if it's an \"incremental\" items update.\r\n\t\tif (itemsDiff) {\r\n\t\t\tconst {\r\n\t\t\t\tfirstShownItemIndex,\r\n\t\t\t\tlastShownItemIndex,\r\n\t\t\t\tbeforeItemsHeight,\r\n\t\t\t\tafterItemsHeight\r\n\t\t\t} = this.widthHasChanged\r\n\t\t\t\t? this.widthHasChanged.stateUpdate\r\n\t\t\t\t: this.getState()\r\n\r\n\t\t\tconst shouldRestoreScrollPosition = firstShownItemIndex === 0 &&\r\n\t\t\t\t// `preserveScrollPosition` option name is deprecated,\r\n\t\t\t\t// use `preserveScrollPositionOnPrependItems` instead.\r\n\t\t\t\t(options.preserveScrollPositionOnPrependItems || options.preserveScrollPosition)\r\n\r\n\t\t\tconst {\r\n\t\t\t\tprependedItemsCount,\r\n\t\t\t\tappendedItemsCount\r\n\t\t\t} = itemsDiff\r\n\r\n\t\t\tlet shouldResetGridLayout\r\n\r\n\t\t\tlayoutUpdate = this.layout.getLayoutUpdateForItemsDiff({\r\n\t\t\t\tfirstShownItemIndex,\r\n\t\t\t\tlastShownItemIndex,\r\n\t\t\t\tbeforeItemsHeight,\r\n\t\t\t\tafterItemsHeight\r\n\t\t\t}, {\r\n\t\t\t\tprependedItemsCount,\r\n\t\t\t\tappendedItemsCount\r\n\t\t\t}, {\r\n\t\t\t\titemsCount: newItems.length,\r\n\t\t\t\tcolumnsCount: this.getActualColumnsCount(),\r\n\t\t\t\tshouldRestoreScrollPosition,\r\n\t\t\t\tonResetGridLayout: () => shouldResetGridLayout = true\r\n\t\t\t})\r\n\r\n\t\t\tif (prependedItemsCount > 0) {\r\n\t\t\t\tlog('Prepend', prependedItemsCount, 'items')\r\n\r\n\t\t\t\titemHeights = new Array(prependedItemsCount).concat(itemHeights)\r\n\r\n\t\t\t\tif (itemStates) {\r\n\t\t\t\t\titemStates = new Array(prependedItemsCount).concat(itemStates)\r\n\t\t\t\t}\r\n\r\n\t\t\t\t// Restore scroll position after prepending items (if requested).\r\n\t\t\t\tif (shouldRestoreScrollPosition) {\r\n\t\t\t\t\tlog('Will restore scroll position')\r\n\t\t\t\t\tthis.listHeightMeasurement.snapshotListHeightBeforeAddingNewItems({\r\n\t\t\t\t\t\tpreviousItems,\r\n\t\t\t\t\t\tnewItems,\r\n\t\t\t\t\t\tprependedItemsCount\r\n\t\t\t\t\t})\r\n\t\t\t\t\t// \"Seamless prepend\" scenario doesn't result in a re-layout,\r\n\t\t\t\t\t// so if any \"non measured item\" is currently pending,\r\n\t\t\t\t\t// it doesn't get reset and will be handled after `state` is updated.\r\n\t\t\t\t\tif (this.firstNonMeasuredItemIndex !== undefined) {\r\n\t\t\t\t\t\tthis.firstNonMeasuredItemIndex += prependedItemsCount\r\n\t\t\t\t\t}\r\n\t\t\t\t} else {\r\n\t\t\t\t\tlog('Reset layout')\r\n\t\t\t\t\tif (shouldResetGridLayout) {\r\n\t\t\t\t\t\tlog('Reason: Prepended items count', prependedItemsCount, 'is not divisible by Columns Count', this.getActualColumnsCount())\r\n\t\t\t\t\t\t// Reset item heights because the whole grid is going to be rebalanced\r\n\t\t\t\t\t\t// and re-rendered in a different configuration.\r\n\t\t\t\t\t\titemHeights = new Array(newItems.length)\r\n\t\t\t\t\t} else {\r\n\t\t\t\t\t\t// Reset layout because none of the prepended items have been measured.\r\n\t\t\t\t\t\tlog('Reason: Prepended items\\' heights are unknown')\r\n\t\t\t\t\t}\r\n\t\t\t\t\tlayoutUpdate = this.layout.getInitialLayoutValues({\r\n\t\t\t\t\t\titemsCount: newItems.length,\r\n\t\t\t\t\t\tcolumnsCount: this.getActualColumnsCount()\r\n\t\t\t\t\t})\r\n\t\t\t\t\t// Unschedule a potentially scheduled layout update\r\n\t\t\t\t\t// after measuring a previously non-measured item\r\n\t\t\t\t\t// because the list will be re-layout anyway\r\n\t\t\t\t\t// due to the new items being set.\r\n\t\t\t\t\tthis.firstNonMeasuredItemIndex = undefined\r\n\t\t\t\t}\r\n\t\t\t}\r\n\r\n\t\t\tif (appendedItemsCount > 0) {\r\n\t\t\t\tlog('Append', appendedItemsCount, 'items')\r\n\t\t\t\titemHeights = itemHeights.concat(new Array(appendedItemsCount))\r\n\t\t\t\tif (itemStates) {\r\n\t\t\t\t\titemStates = itemStates.concat(new Array(appendedItemsCount))\r\n\t\t\t\t}\r\n\t\t\t}\r\n\r\n\t\t\titemsUpdateInfo = {\r\n\t\t\t\tprepend: prependedItemsCount > 0,\r\n\t\t\t\tappend: appendedItemsCount > 0\r\n\t\t\t}\r\n\t\t} else {\r\n\t\t\tlog('Items have changed, and', (itemsDiff ? 'a re-layout from scratch has been requested.' : 'it\\'s not a simple append and/or prepend.'), 'Rerender the entire list from scratch.')\r\n\t\t\tlog('Previous items', previousItems)\r\n\t\t\tlog('New items', newItems)\r\n\r\n\t\t\t// Reset item heights and item states.\r\n\t\t\titemHeights = new Array(newItems.length)\r\n\t\t\titemStates = new Array(newItems.length)\r\n\r\n\t\t\tlayoutUpdate = this.layout.getInitialLayoutValues({\r\n\t\t\t\titemsCount: newItems.length,\r\n\t\t\t\tcolumnsCount: this.getActualColumnsCount()\r\n\t\t\t})\r\n\r\n\t\t\t// Unschedule a potentially scheduled layout update\r\n\t\t\t// after measuring a previously non-measured item\r\n\t\t\t// because the list will be re-layout from scratch\r\n\t\t\t// due to the new items being set.\r\n\t\t\tthis.firstNonMeasuredItemIndex = undefined\r\n\r\n\t\t\t// Also reset any potential pending scroll position restoration.\r\n\t\t\t// For example, imagine a developer first called `.setItems(incrementalItemsUpdate)`\r\n\t\t\t// and then called `.setItems(differentItems)` and there was no state update\r\n\t\t\t// in between those two calls. This could happen because state updates aren't\r\n\t\t\t// required to be \"synchronous\". On other words, calling `this.updateState()`\r\n\t\t\t// doesn't necessarily mean that the state is applied immediately.\r\n\t\t\t// Imagine also that such \"delayed\" state updates could be batched,\r\n\t\t\t// like they do in React inside event handlers (though that doesn't apply to this case):\r\n\t\t\t// https://github.com/facebook/react/issues/10231#issuecomment-316644950\r\n\t\t\t// If `this.listHeightMeasurement` wasn't reset on `.setItems(differentItems)`\r\n\t\t\t// and if the second `this.updateState()` call overwrites the first one\r\n\t\t\t// then it would attempt to restore scroll position in a situation when\r\n\t\t\t// it should no longer do that. Hence the reset here.\r\n\t\t\tthis.listHeightMeasurement.reset()\r\n\r\n\t\t\titemsUpdateInfo = {\r\n\t\t\t\treplace: true\r\n\t\t\t}\r\n\t\t}\r\n\r\n\t\tlog('~ Update state ~')\r\n\r\n\t\t// const layoutValuesAfterUpdate = {\r\n\t\t// \t...this.getState(),\r\n\t\t// \t...layoutUpdate\r\n\t\t// }\r\n\r\n\t\t// `layoutUpdate` is equivalent to `layoutValuesAfterUpdate` because\r\n\t\t// `layoutUpdate` contains all the relevant properties.\r\n\t\tlog('First shown item index', layoutUpdate.firstShownItemIndex)\r\n\t\tlog('Last shown item index', layoutUpdate.lastShownItemIndex)\r\n\t\tlog('Before items height', layoutUpdate.beforeItemsHeight)\r\n\t\tlog('After items height (actual or estimated)', layoutUpdate.afterItemsHeight)\r\n\r\n\t\t// Optionally preload items to be rendered.\r\n\t\t//\r\n\t\t// `layoutUpdate` is equivalent to `layoutValuesAfterUpdate` because\r\n\t\t// `layoutUpdate` contains all the relevant properties.\r\n\t\t//\r\n\t\tthis.onBeforeShowItems(\r\n\t\t\tnewItems,\r\n\t\t\titemHeights,\r\n\t\t\tlayoutUpdate.firstShownItemIndex,\r\n\t\t\tlayoutUpdate.lastShownItemIndex\r\n\t\t)\r\n\r\n\t\t// `this.newItemsWillBeRendered` signals that new `items` are being rendered,\r\n\t\t// and that `VirtualScroller` should temporarily stop all other updates.\r\n\t\t//\r\n\t\t// `this.newItemsWillBeRendered` is cleared in `onRender()`.\r\n\t\t//\r\n\t\t// The values in `this.newItemsWillBeRendered` are used, for example,\r\n\t\t// in `.onResize()` handler in order to not break state consistency when\r\n\t\t// state updates are \"asynchronous\" (delayed) and there's a window resize event\r\n\t\t// in between calling `updateState()` below and that call actually being applied.\r\n\t\t//\r\n\t\tthis.newItemsWillBeRendered = {\r\n\t\t\t...itemsUpdateInfo,\r\n\t\t\tcount: newItems.length,\r\n\t\t\t// `layoutUpdate` now contains all layout-related properties, even if those that\r\n\t\t\t// didn't change. So `firstShownItemIndex` is always in `this.newItemsWillBeRendered`.\r\n\t\t\tlayout: layoutUpdate\r\n\t\t}\r\n\r\n\t\t// `layoutUpdate` now contains all layout-related properties, even if those that\r\n\t\t// didn't change. So this part is no longer relevant.\r\n\t\t//\r\n\t\t// // If `firstShownItemIndex` is gonna be modified as a result of setting new items\r\n\t\t// // then keep that \"new\" `firstShownItemIndex` in order for it to be used by\r\n\t\t// // `onResize()` handler when it calculates \"new\" `firstShownItemIndex`\r\n\t\t// // based on the new columns count (corresponding to the new window width).\r\n\t\t// if (layoutUpdate.firstShownItemIndex !== undefined) {\r\n\t\t// \tthis.newItemsWillBeRendered = {\r\n\t\t// \t\t...this.newItemsWillBeRendered,\r\n\t\t// \t\tfirstShownItemIndex: layoutUpdate.firstShownItemIndex\r\n\t\t// \t}\r\n\t\t// }\r\n\r\n\t\t// Update `VirtualScroller` state.\r\n\t\t//\r\n\t\t// This state update should overwrite all the `state` properties\r\n\t\t// that are also updated in the \"on scroll\" handler (`getShownItemIndexes()`):\r\n\t\t//\r\n\t\t// * `firstShownItemIndex`\r\n\t\t// * `lastShownItemIndex`\r\n\t\t// * `beforeItemsHeight`\r\n\t\t// * `afterItemsHeight`\r\n\t\t//\r\n\t\t// That's because this `updateState()` update has a higher priority\r\n\t\t// than that of the \"on scroll\" handler, so it should overwrite\r\n\t\t// any potential state changes dispatched by the \"on scroll\" handler.\r\n\t\t//\r\n\t\tconst newState = {\r\n\t\t\t...layoutUpdate,\r\n\t\t\titems: newItems,\r\n\t\t\titemStates,\r\n\t\t\titemHeights\r\n\t\t}\r\n\r\n\t\t// Introduced `shouldIncludeBeforeResizeValuesInState()` getter just to prevent\r\n\t\t// cluttering `state` with `beforeResize: undefined` property if `beforeResize`\r\n\t\t// hasn't ever been set in `state` previously.\r\n\t\tif (this.beforeResize.shouldIncludeBeforeResizeValuesInState()) {\r\n\t\t\tif (this.shouldDiscardBeforeResizeItemHeights()) {\r\n\t\t\t\t// Reset \"before resize\" item heights because now there're new items prepended\r\n\t\t\t\t// with unknown heights, or completely new items with unknown heights, so\r\n\t\t\t\t// `beforeItemsHeight` value won't be preserved anyway.\r\n\t\t\t\tnewState.beforeResize = undefined\r\n\t\t\t}\r\n\t\t\telse {\r\n\t\t\t\t// Overwrite `beforeResize` property in `state` even if it wasn't modified\r\n\t\t\t\t// because state updates could be \"asynchronous\" and in that case there could be\r\n\t\t\t\t// some previous `updateState()` call from some previous `setItems()` call that\r\n\t\t\t\t// hasn't yet been applied, and that previous call might have scheduled setting\r\n\t\t\t\t// `state.beforeResize` property to `undefined` in order to reset it, but this\r\n\t\t\t\t// next `updateState()` call might not require resetting `state.beforeResize` property\r\n\t\t\t\t// so it should undo resetting it by simply overwriting it with its normal value.\r\n\t\t\t\tnewState.beforeResize = this.widthHasChanged\r\n\t\t\t\t\t? this.widthHasChanged.stateUpdate.beforeResize\r\n\t\t\t\t\t: this.getState().beforeResize\r\n\t\t\t}\r\n\t\t}\r\n\r\n\t\t// `newState` should also overwrite all `state` properties that're updated in `onResize()`\r\n\t\t// because `setItems()`'s state updates always overwrite `onResize()`'s state updates.\r\n\t\t// (The least-priority ones are `onScroll()` state updates, but those're simply skipped\r\n\t\t// if there's a pending `setItems()` or `onResize()` update).\r\n\t\t//\r\n\t\t// `state` property exceptions:\r\n\t\t//\r\n\t\t// `verticalSpacing` property is not updated here because it's fine setting it to\r\n\t\t// `undefined` in `onResize()` — it will simply be re-measured after the component re-renders.\r\n\t\t//\r\n\t\t// `columnsCount` property is also not updated here because by definition it's only\r\n\t\t// updated in `onResize()`.\r\n\r\n\t\t// Render.\r\n\t\tthis._isSettingNewItems = true\r\n\t\tthis.updateState(newState)\r\n\t}\r\n\r\n\tthis.getItemsDiff = (previousItems, newItems) => {\r\n\t\treturn getItemsDiff(previousItems, newItems, this.isItemEqual)\r\n\t}\r\n}"],"mappings":"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"}