virtual-scroller 1.7.9 → 1.9.0

package/modules/VirtualScroller.state.js

@@ -0,0 +1,283 @@
+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, { warn, isDebug, reportError } from './utility/debug.js';
+import { cleanUpBeforeResizeState } from './BeforeResize.js';
+import getStateSnapshot from './utility/getStateSnapshot.js'; // There're three main places where state is updated:
+//
+// * On scroll.
+// * On window resize.
+// * On set new items.
+//
+// State updates may be "asynchronous" (like in React), in which case the
+// corresponding operation is "pending" until the state update is applied.
+//
+// If there's a "pending" window resize or a "pending" update of the set of items,
+// then "on scroll" updates aren't dispatched.
+//
+// If there's a "pending" on scroll update and the window is resize or a new set
+// of items is set, then that "pending" on scroll update gets overwritten.
+//
+// If there's a "pending" update of the set of items, then window resize handler
+// sees that "pending" update and dispatches its own state update so that the
+// "pending" state update originating from `setItems()` is not lost.
+//
+// If there's a "pending" window resize, and a new set of items is set,
+// then the state update of the window resize handler gets overwritten.
+
+export default function createStateHelpers(_ref) {
+  var _this = this;
+
+  var state = _ref.state,
+      onStateChange = _ref.onStateChange,
+      render = _ref.render,
+      initialItems = _ref.items;
+  this.onStateChange = onStateChange;
+  this._render = render;
+
+  this._onItemStateChange = function (i, newItemState) {
+    if (isDebug()) {
+      log('~ Item state changed ~');
+      log('Item', i); // Uses `JSON.stringify()` here instead of just outputting the JSON objects as is
+      // because outputting JSON objects as is would show different results later when
+      // the developer inspects those in the web browser console if those state objects
+      // get modified in between they've been output to the console and the developer
+      // decided to inspect them.
+
+      log('Previous state' + '\n' + JSON.stringify(_this.getState().itemStates[i], null, 2));
+      log('New state' + '\n' + JSON.stringify(newItemState, null, 2));
+    }
+
+    _this.getState().itemStates[i] = newItemState; // Schedule the item state update for after the new items have been rendered.
+
+    if (_this.newItemsWillBeRendered) {
+      if (!_this.itemStatesThatChangedWhileNewItemsWereBeingRendered) {
+        _this.itemStatesThatChangedWhileNewItemsWereBeingRendered = {};
+      }
+
+      _this.itemStatesThatChangedWhileNewItemsWereBeingRendered[String(i)] = newItemState;
+    }
+  };
+
+  this.getState = function () {
+    return _this._getState();
+  };
+
+  this.updateState = function (stateUpdate) {
+    if (isDebug()) {
+      log('~ Set state ~');
+      log(getStateSnapshot(stateUpdate));
+    } // Ensure that a non-initial `stateUpdate` can only contain an `items`
+    // property when it comes from a `setItems()` call.
+
+
+    if (stateUpdate.items) {
+      if (!_this._isSettingNewItems) {
+        reportError('A `stateUpdate` can only contain `items` property as a result of calling `.setItems()`');
+      }
+    }
+
+    _this._isSettingNewItems = undefined; // Update `state`.
+
+    _this.previousState = _this.getState();
+
+    _this._updateState(stateUpdate);
+  };
+
+  this.getInitialState = function () {
+    if (state) {
+      return getRestoredState.call(_this, state);
+    }
+
+    return getInitialStateFromScratch.call(_this);
+  };
+
+  this.useState = function (_ref2) {
+    var getState = _ref2.getState,
+        updateState = _ref2.updateState;
+
+    if (_this._isActive) {
+      throw new Error('[virtual-scroller] `VirtualScroller` has already been started');
+    }
+
+    if (_this._getState) {
+      throw new Error('[virtual-scroller] Custom state storage has already been configured');
+    }
+
+    if (render) {
+      throw new Error('[virtual-scroller] Creating a `VirtualScroller` class instance with a `render()` parameter means using the default (internal) state storage');
+    }
+
+    if (!getState || !updateState) {
+      throw new Error('[virtual-scroller] When using a custom state storage, one must supply both `getState()` and `updateState()` functions');
+    }
+
+    _this._usesCustomStateStorage = true;
+    _this._getState = getState;
+    _this._updateState = updateState;
+  };
+
+  this.useDefaultStateStorage = function () {
+    if (!render) {
+      throw new Error('[virtual-scroller] When using the default (internal) state management, one must supply a `render(state, prevState)` function parameter');
+    } // Create default `getState()`/`updateState()` functions.
+
+
+    _this._getState = defaultGetState.bind(_this);
+    _this._updateState = defaultUpdateState.bind(_this); // When `state` is stored externally, a developer is responsible for
+    // initializing it with the initial value.
+    // Otherwise, if default state management is used, set the initial state now.
+
+    var setInitialState = defaultSetInitialState.bind(_this);
+    setInitialState(_this.getInitialState());
+  };
+
+  function defaultGetState() {
+    return this.state;
+  }
+
+  function defaultSetInitialState(newState) {
+    this.state = newState;
+  }
+
+  function defaultUpdateState(stateUpdate) {
+    // Because this variant of `.updateState()` is "synchronous" (immediate),
+    // it can be written like `...prevState`, and no state updates would be lost.
+    // But if it was "asynchronous" (not immediate), then `...prevState`
+    // wouldn't work in all cases, because it could be stale in cases
+    // when more than a single `updateState()` call is made before
+    // the state actually updates, making `prevState` stale.
+    this.state = _objectSpread(_objectSpread({}, this.state), stateUpdate);
+    render(this.state, this.previousState);
+    this.onRender();
+  }
+  /**
+   * Returns the initial state of the `VirtualScroller` "from scratch".
+   * (i.e. not from a previously saved one).
+   * @return {object}
+   */
+
+
+  function getInitialStateFromScratch() {
+    var items = initialItems;
+
+    var state = _objectSpread(_objectSpread({}, getInitialLayoutState.call(this, items)), {}, {
+      items: items,
+      itemStates: new Array(items.length)
+    });
+
+    if (isDebug()) {
+      log('Initial state (autogenerated)', getStateSnapshot(state));
+    }
+
+    log('First shown item index', state.firstShownItemIndex);
+    log('Last shown item index', state.lastShownItemIndex);
+    return state;
+  }
+
+  function getRestoredState(state) {
+    if (isDebug()) {
+      log('Restore state', getStateSnapshot(state));
+    } // Possibly clean up "before resize" property in state.
+    // "Before resize" state property is cleaned up when all "before resize" item heights
+    // have been re-measured in an asynchronous `this.updateState({ beforeResize: undefined })` call.
+    // If `VirtualScroller` state was snapshotted externally before that `this.updateState()` call
+    // has been applied, then "before resize" property might have not been cleaned up properly.
+
+
+    state = cleanUpBeforeResizeState(state); // Reset `verticalSpacing` so that it re-measures it after the list
+    // has been rendered initially. The rationale is that a previously captured
+    // inter-item vertical spacing can't be "trusted" in a sense that the user
+    // might have resized the window after the previous `state` has been snapshotted.
+    // If the user has resized the window, then changing window width might have
+    // activated different CSS `@media()` "queries" resulting in a potentially different
+    // vertical spacing when the `VirtualScroller` is re-created with such previously
+    // snapshotted state.
+
+    state = _objectSpread(_objectSpread({}, state), {}, {
+      verticalSpacing: undefined
+    }); // `this.verticalSpacing` acts as a "true" source for vertical spacing value.
+    // Vertical spacing is also stored in `state` but `state` updates could be
+    // "asynchronous" (not applied immediately) and `this.onUpdateShownItemIndexes()`
+    // requires vertical spacing to be correct at any time, without any delays.
+    // So, vertical spacing is also duplicated in `state`, but the "true" source
+    // is still `this.verticalSpacing`.
+    //
+    // `this.verticalSpacing` must be initialized before calling `this.getInitialStateFromScratch()`
+    // because `this.getInitialStateFromScratch()` uses `this.verticalSpacing` in its calculations.
+    //
+    // With the code above, `state.verticalSpacing` is always gonna be `undefined`,
+    // so commented out this code. It's safer to just re-measure vertical spacing
+    // from scratch when `VirtualScroller` is mounted.
+    //
+    // this.verticalSpacing = state ? state.verticalSpacing : undefined
+    // Check if the actual `columnsCount` on the screen matches the one from state.
+
+    if (isStateColumnsCountMismatch(state, {
+      columnsCount: this.getActualColumnsCount()
+    })) {
+      warn('Reset Layout');
+      state = _objectSpread(_objectSpread({}, state), getInitialLayoutState.call(this, state.items));
+    }
+
+    return state;
+  }
+
+  function getInitialLayoutState(items) {
+    var itemsCount = items.length;
+
+    var _this$layout$getIniti = this.layout.getInitialLayoutValues({
+      itemsCount: itemsCount,
+      columnsCount: this.getActualColumnsCount()
+    }),
+        firstShownItemIndex = _this$layout$getIniti.firstShownItemIndex,
+        lastShownItemIndex = _this$layout$getIniti.lastShownItemIndex,
+        beforeItemsHeight = _this$layout$getIniti.beforeItemsHeight,
+        afterItemsHeight = _this$layout$getIniti.afterItemsHeight;
+
+    var itemHeights = new Array(itemsCount); // Optionally preload items to be rendered.
+
+    this.onBeforeShowItems(items, itemHeights, firstShownItemIndex, lastShownItemIndex);
+    return {
+      itemHeights: itemHeights,
+      columnsCount: this.getActualColumnsCountForState(),
+      verticalSpacing: this.verticalSpacing,
+      firstShownItemIndex: firstShownItemIndex,
+      lastShownItemIndex: lastShownItemIndex,
+      beforeItemsHeight: beforeItemsHeight,
+      afterItemsHeight: afterItemsHeight
+    };
+  } // Checks if the actual `columnsCount` on the screen matches the one from state.
+  //
+  // For example, a developer might snapshot `VirtualScroller` state
+  // when the user navigates from the page containing the list
+  // in order to later restore the list's state when the user goes "Back".
+  // But, the user might have also resized the window while being on that
+  // "other" page, and when they come "Back", their snapshotted state
+  // no longer qualifies. Well, it does qualify, but only partially.
+  // For example, `itemStates` are still valid, but first and last shown
+  // item indexes aren't.
+  //
+
+
+  function isStateColumnsCountMismatch(state, _ref3) {
+    var columnsCount = _ref3.columnsCount;
+    var stateColumnsCount = state.columnsCount || 1;
+
+    if (stateColumnsCount !== columnsCount) {
+      warn('~ Columns Count changed from', stateColumnsCount, 'to', columnsCount, '~');
+      return true;
+    }
+
+    var firstShownItemIndex = Math.floor(state.firstShownItemIndex / columnsCount) * columnsCount;
+
+    if (firstShownItemIndex !== state.firstShownItemIndex) {
+      warn('~ First Shown Item Index', state.firstShownItemIndex, 'is not divisible by Columns Count', columnsCount, '~');
+      return true;
+    }
+  }
+}
+//# sourceMappingURL=VirtualScroller.state.js.map

package/modules/VirtualScroller.state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"VirtualScroller.state.js","names":["log","warn","isDebug","reportError","cleanUpBeforeResizeState","getStateSnapshot","createStateHelpers","state","onStateChange","render","initialItems","items","_render","_onItemStateChange","i","newItemState","JSON","stringify","getState","itemStates","newItemsWillBeRendered","itemStatesThatChangedWhileNewItemsWereBeingRendered","String","_getState","updateState","stateUpdate","_isSettingNewItems","undefined","previousState","_updateState","getInitialState","getRestoredState","call","getInitialStateFromScratch","useState","_isActive","Error","_usesCustomStateStorage","useDefaultStateStorage","defaultGetState","bind","defaultUpdateState","setInitialState","defaultSetInitialState","newState","onRender","getInitialLayoutState","Array","length","firstShownItemIndex","lastShownItemIndex","verticalSpacing","isStateColumnsCountMismatch","columnsCount","getActualColumnsCount","itemsCount","layout","getInitialLayoutValues","beforeItemsHeight","afterItemsHeight","itemHeights","onBeforeShowItems","getActualColumnsCountForState","stateColumnsCount","Math","floor"],"sources":["../source/VirtualScroller.state.js"],"sourcesContent":["import log, { warn, isDebug, reportError } from './utility/debug.js'\r\nimport { cleanUpBeforeResizeState } from './BeforeResize.js'\r\nimport getStateSnapshot from './utility/getStateSnapshot.js'\r\n\r\n// There're three main places where state is updated:\r\n//\r\n// * On scroll.\r\n// * On window resize.\r\n// * On set new items.\r\n//\r\n// State updates may be \"asynchronous\" (like in React), in which case the\r\n// corresponding operation is \"pending\" until the state update is applied.\r\n//\r\n// If there's a \"pending\" window resize or a \"pending\" update of the set of items,\r\n// then \"on scroll\" updates aren't dispatched.\r\n//\r\n// If there's a \"pending\" on scroll update and the window is resize or a new set\r\n// of items is set, then that \"pending\" on scroll update gets overwritten.\r\n//\r\n// If there's a \"pending\" update of the set of items, then window resize handler\r\n// sees that \"pending\" update and dispatches its own state update so that the\r\n// \"pending\" state update originating from `setItems()` is not lost.\r\n//\r\n// If there's a \"pending\" window resize, and a new set of items is set,\r\n// then the state update of the window resize handler gets overwritten.\r\n\r\nexport default function createStateHelpers({\r\n\tstate,\r\n\tonStateChange,\r\n\trender,\r\n\titems: initialItems\r\n}) {\r\n\tthis.onStateChange = onStateChange\r\n\tthis._render = render\r\n\r\n\tthis._onItemStateChange = (i, newItemState) => {\r\n\t\tif (isDebug()) {\r\n\t\t\tlog('~ Item state changed ~')\r\n\t\t\tlog('Item', i)\r\n\t\t\t// Uses `JSON.stringify()` here instead of just outputting the JSON objects as is\r\n\t\t\t// because outputting JSON objects as is would show different results later when\r\n\t\t\t// the developer inspects those in the web browser console if those state objects\r\n\t\t\t// get modified in between they've been output to the console and the developer\r\n\t\t\t// decided to inspect them.\r\n\t\t\tlog('Previous state' + '\\n' + JSON.stringify(this.getState().itemStates[i], null, 2))\r\n\t\t\tlog('New state' + '\\n' + JSON.stringify(newItemState, null, 2))\r\n\t\t}\r\n\r\n\t\tthis.getState().itemStates[i] = newItemState\r\n\r\n\t\t// Schedule the item state update for after the new items have been rendered.\r\n\t\tif (this.newItemsWillBeRendered) {\r\n\t\t\tif (!this.itemStatesThatChangedWhileNewItemsWereBeingRendered) {\r\n\t\t\t\tthis.itemStatesThatChangedWhileNewItemsWereBeingRendered = {}\r\n\t\t\t}\r\n\t\t\tthis.itemStatesThatChangedWhileNewItemsWereBeingRendered[String(i)] = newItemState\r\n\t\t}\r\n\t}\r\n\r\n\tthis.getState = () => this._getState()\r\n\r\n\tthis.updateState = (stateUpdate) => {\r\n\t\tif (isDebug()) {\r\n\t\t\tlog('~ Set state ~')\r\n\t\t\tlog(getStateSnapshot(stateUpdate))\r\n\t\t}\r\n\r\n\t\t// Ensure that a non-initial `stateUpdate` can only contain an `items`\r\n\t\t// property when it comes from a `setItems()` call.\r\n\t\tif (stateUpdate.items) {\r\n\t\t\tif (!this._isSettingNewItems) {\r\n\t\t\t\treportError('A `stateUpdate` can only contain `items` property as a result of calling `.setItems()`')\r\n\t\t\t}\r\n\t\t}\r\n\t\tthis._isSettingNewItems = undefined\r\n\r\n\t\t// Update `state`.\r\n\t\tthis.previousState = this.getState()\r\n\t\tthis._updateState(stateUpdate)\r\n\t}\r\n\r\n\tthis.getInitialState = () => {\r\n\t\tif (state) {\r\n\t\t\treturn getRestoredState.call(this, state)\r\n\t\t}\r\n\t\treturn getInitialStateFromScratch.call(this)\r\n\t}\r\n\r\n\tthis.useState = ({\r\n\t\tgetState,\r\n\t\tupdateState\r\n\t}) => {\r\n\t\tif (this._isActive) {\r\n\t\t\tthrow new Error('[virtual-scroller] `VirtualScroller` has already been started')\r\n\t\t}\r\n\r\n\t\tif (this._getState) {\r\n\t\t\tthrow new Error('[virtual-scroller] Custom state storage has already been configured')\r\n\t\t}\r\n\r\n\t\tif (render) {\r\n\t\t\tthrow new Error('[virtual-scroller] Creating a `VirtualScroller` class instance with a `render()` parameter means using the default (internal) state storage')\r\n\t\t}\r\n\r\n\t\tif (!getState || !updateState) {\r\n\t\t\tthrow new Error('[virtual-scroller] When using a custom state storage, one must supply both `getState()` and `updateState()` functions')\r\n\t\t}\r\n\r\n\t\tthis._usesCustomStateStorage = true\r\n\r\n\t\tthis._getState = getState\r\n\t\tthis._updateState = updateState\r\n\t}\r\n\r\n\tthis.useDefaultStateStorage = () => {\r\n\t\tif (!render) {\r\n\t\t\tthrow new Error('[virtual-scroller] When using the default (internal) state management, one must supply a `render(state, prevState)` function parameter')\r\n\t\t}\r\n\r\n\t\t// Create default `getState()`/`updateState()` functions.\r\n\t\tthis._getState = defaultGetState.bind(this)\r\n\t\tthis._updateState = defaultUpdateState.bind(this)\r\n\r\n\t\t// When `state` is stored externally, a developer is responsible for\r\n\t\t// initializing it with the initial value.\r\n\t\t// Otherwise, if default state management is used, set the initial state now.\r\n\t\tconst setInitialState = defaultSetInitialState.bind(this)\r\n\t\tsetInitialState(this.getInitialState())\r\n\t}\r\n\r\n\tfunction defaultGetState() {\r\n\t\treturn this.state\r\n\t}\r\n\r\n\tfunction defaultSetInitialState(newState) {\r\n\t\tthis.state = newState\r\n\t}\r\n\r\n\tfunction defaultUpdateState(stateUpdate) {\r\n\t\t// Because this variant of `.updateState()` is \"synchronous\" (immediate),\r\n\t\t// it can be written like `...prevState`, and no state updates would be lost.\r\n\t\t// But if it was \"asynchronous\" (not immediate), then `...prevState`\r\n\t\t// wouldn't work in all cases, because it could be stale in cases\r\n\t\t// when more than a single `updateState()` call is made before\r\n\t\t// the state actually updates, making `prevState` stale.\r\n\t\tthis.state = {\r\n\t\t\t...this.state,\r\n\t\t\t...stateUpdate\r\n\t\t}\r\n\r\n\t\trender(this.state, this.previousState)\r\n\r\n\t\tthis.onRender()\r\n\t}\r\n\r\n\t/**\r\n\t * Returns the initial state of the `VirtualScroller` \"from scratch\".\r\n\t * (i.e. not from a previously saved one).\r\n\t * @return {object}\r\n\t */\r\n\tfunction getInitialStateFromScratch() {\r\n\t\tconst items = initialItems\r\n\t\tconst state = {\r\n\t\t\t...getInitialLayoutState.call(this, items),\r\n\t\t\titems,\r\n\t\t\titemStates: new Array(items.length)\r\n\t\t}\r\n\t\tif (isDebug()) {\r\n\t\t\tlog('Initial state (autogenerated)', getStateSnapshot(state))\r\n\t\t}\r\n\t\tlog('First shown item index', state.firstShownItemIndex)\r\n\t\tlog('Last shown item index', state.lastShownItemIndex)\r\n\t\treturn state\r\n\t}\r\n\r\n\tfunction getRestoredState(state) {\r\n\t\tif (isDebug()) {\r\n\t\t\tlog('Restore state', getStateSnapshot(state))\r\n\t\t}\r\n\r\n\t\t// Possibly clean up \"before resize\" property in state.\r\n\t\t// \"Before resize\" state property is cleaned up when all \"before resize\" item heights\r\n\t\t// have been re-measured in an asynchronous `this.updateState({ beforeResize: undefined })` call.\r\n\t\t// If `VirtualScroller` state was snapshotted externally before that `this.updateState()` call\r\n\t\t// has been applied, then \"before resize\" property might have not been cleaned up properly.\r\n\t\tstate = cleanUpBeforeResizeState(state)\r\n\r\n\t\t// Reset `verticalSpacing` so that it re-measures it after the list\r\n\t\t// has been rendered initially. The rationale is that a previously captured\r\n\t\t// inter-item vertical spacing can't be \"trusted\" in a sense that the user\r\n\t\t// might have resized the window after the previous `state` has been snapshotted.\r\n\t\t// If the user has resized the window, then changing window width might have\r\n\t\t// activated different CSS `@media()` \"queries\" resulting in a potentially different\r\n\t\t// vertical spacing when the `VirtualScroller` is re-created with such previously\r\n\t\t// snapshotted state.\r\n\t\tstate = {\r\n\t\t\t...state,\r\n\t\t\tverticalSpacing: undefined\r\n\t\t}\r\n\r\n\t\t// `this.verticalSpacing` acts as a \"true\" source for vertical spacing value.\r\n\t\t// Vertical spacing is also stored in `state` but `state` updates could be\r\n\t\t// \"asynchronous\" (not applied immediately) and `this.onUpdateShownItemIndexes()`\r\n\t\t// requires vertical spacing to be correct at any time, without any delays.\r\n\t\t// So, vertical spacing is also duplicated in `state`, but the \"true\" source\r\n\t\t// is still `this.verticalSpacing`.\r\n\t\t//\r\n\t\t// `this.verticalSpacing` must be initialized before calling `this.getInitialStateFromScratch()`\r\n\t\t// because `this.getInitialStateFromScratch()` uses `this.verticalSpacing` in its calculations.\r\n\t\t//\r\n\t\t// With the code above, `state.verticalSpacing` is always gonna be `undefined`,\r\n\t\t// so commented out this code. It's safer to just re-measure vertical spacing\r\n\t\t// from scratch when `VirtualScroller` is mounted.\r\n\t\t//\r\n\t\t// this.verticalSpacing = state ? state.verticalSpacing : undefined\r\n\r\n\t\t// Check if the actual `columnsCount` on the screen matches the one from state.\r\n\t\tif (isStateColumnsCountMismatch(state, {\r\n\t\t\tcolumnsCount: this.getActualColumnsCount()\r\n\t\t})) {\r\n\t\t\twarn('Reset Layout')\r\n\t\t\tstate = {\r\n\t\t\t\t...state,\r\n\t\t\t\t...getInitialLayoutState.call(this, state.items)\r\n\t\t\t}\r\n\t\t}\r\n\r\n\t\treturn state\r\n\t}\r\n\r\n\tfunction getInitialLayoutState(items) {\r\n\t\tconst itemsCount = items.length\r\n\t\tconst {\r\n\t\t\tfirstShownItemIndex,\r\n\t\t\tlastShownItemIndex,\r\n\t\t\tbeforeItemsHeight,\r\n\t\t\tafterItemsHeight\r\n\t\t} = this.layout.getInitialLayoutValues({\r\n\t\t\titemsCount,\r\n\t\t\tcolumnsCount: this.getActualColumnsCount()\r\n\t\t})\r\n\t\tconst itemHeights = new Array(itemsCount)\r\n\t\t// Optionally preload items to be rendered.\r\n\t\tthis.onBeforeShowItems(\r\n\t\t\titems,\r\n\t\t\titemHeights,\r\n\t\t\tfirstShownItemIndex,\r\n\t\t\tlastShownItemIndex\r\n\t\t)\r\n\t\treturn {\r\n\t\t\titemHeights,\r\n\t\t\tcolumnsCount: this.getActualColumnsCountForState(),\r\n\t\t\tverticalSpacing: this.verticalSpacing,\r\n\t\t\tfirstShownItemIndex,\r\n\t\t\tlastShownItemIndex,\r\n\t\t\tbeforeItemsHeight,\r\n\t\t\tafterItemsHeight\r\n\t\t}\r\n\t}\r\n\r\n\t// Checks if the actual `columnsCount` on the screen matches the one from state.\r\n\t//\r\n\t// For example, a developer might snapshot `VirtualScroller` state\r\n\t// when the user navigates from the page containing the list\r\n\t// in order to later restore the list's state when the user goes \"Back\".\r\n\t// But, the user might have also resized the window while being on that\r\n\t// \"other\" page, and when they come \"Back\", their snapshotted state\r\n\t// no longer qualifies. Well, it does qualify, but only partially.\r\n\t// For example, `itemStates` are still valid, but first and last shown\r\n\t// item indexes aren't.\r\n\t//\r\n\tfunction isStateColumnsCountMismatch(state, { columnsCount }) {\r\n\t\tconst stateColumnsCount = state.columnsCount || 1\r\n\t\tif (stateColumnsCount !== columnsCount) {\r\n\t\t\twarn('~ Columns Count changed from', stateColumnsCount, 'to', columnsCount, '~')\r\n\t\t\treturn true\r\n\t\t}\r\n\t\tconst firstShownItemIndex = Math.floor(state.firstShownItemIndex / columnsCount) * columnsCount\r\n\t\tif (firstShownItemIndex !== state.firstShownItemIndex) {\r\n\t\t\twarn('~ First Shown Item Index', state.firstShownItemIndex, 'is not divisible by Columns Count', columnsCount, '~')\r\n\t\t\treturn true\r\n\t\t}\r\n\t}\r\n}"],"mappings":"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"}

package/modules/VirtualScroller.verticalSpacing.js

@@ -0,0 +1,54 @@
+import log from './utility/debug.js';
+import getVerticalSpacing from './getVerticalSpacing.js';
+export default function createVerticalSpacingHelpers() {
+  var _this = this;
+
+  // Bind to `this` in order to prevent bugs when this function is passed by reference
+  // and then called with its `this` being unintentionally `window` resulting in
+  // the `if` condition being "falsy".
+  this.getVerticalSpacing = function () {
+    return _this.verticalSpacing || 0;
+  };
+
+  this.getVerticalSpacingBeforeResize = function () {
+    // `beforeResize.verticalSpacing` can be `undefined`.
+    // For example, if `this.updateState({ verticalSpacing })` call hasn't been applied
+    // before the resize happened (in case of an "asynchronous" state update).
+    var _this$getState = _this.getState(),
+        beforeResize = _this$getState.beforeResize;
+
+    return beforeResize && beforeResize.verticalSpacing || 0;
+  };
+  /**
+   * Measures item vertical spacing, if not measured.
+   * @return {object} [stateUpdate]
+   */
+
+
+  this.measureVerticalSpacingIfNotMeasured = function () {
+    if (_this.verticalSpacing === undefined) {
+      _this.verticalSpacing = measureVerticalSpacing.call(_this);
+      return _this.verticalSpacing;
+    }
+  };
+
+  function measureVerticalSpacing() {
+    var _this$getState2 = this.getState(),
+        firstShownItemIndex = _this$getState2.firstShownItemIndex,
+        lastShownItemIndex = _this$getState2.lastShownItemIndex;
+
+    log('~ Measure item vertical spacing ~');
+    var verticalSpacing = getVerticalSpacing({
+      itemsContainer: this.itemsContainer,
+      renderedItemsCount: lastShownItemIndex - firstShownItemIndex + 1
+    });
+
+    if (verticalSpacing === undefined) {
+      log('Not enough items rendered to measure vertical spacing');
+    } else {
+      log('Item vertical spacing', verticalSpacing);
+      return verticalSpacing;
+    }
+  }
+}
+//# sourceMappingURL=VirtualScroller.verticalSpacing.js.map

package/modules/VirtualScroller.verticalSpacing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"VirtualScroller.verticalSpacing.js","names":["log","getVerticalSpacing","createVerticalSpacingHelpers","verticalSpacing","getVerticalSpacingBeforeResize","getState","beforeResize","measureVerticalSpacingIfNotMeasured","undefined","measureVerticalSpacing","call","firstShownItemIndex","lastShownItemIndex","itemsContainer","renderedItemsCount"],"sources":["../source/VirtualScroller.verticalSpacing.js"],"sourcesContent":["import log from './utility/debug.js'\r\nimport getVerticalSpacing from './getVerticalSpacing.js'\r\n\r\nexport default function createVerticalSpacingHelpers() {\r\n\t// Bind to `this` in order to prevent bugs when this function is passed by reference\r\n\t// and then called with its `this` being unintentionally `window` resulting in\r\n\t// the `if` condition being \"falsy\".\r\n\tthis.getVerticalSpacing = () => {\r\n\t\treturn this.verticalSpacing || 0\r\n\t}\r\n\r\n\tthis.getVerticalSpacingBeforeResize = () => {\r\n\t\t// `beforeResize.verticalSpacing` can be `undefined`.\r\n\t\t// For example, if `this.updateState({ verticalSpacing })` call hasn't been applied\r\n\t\t// before the resize happened (in case of an \"asynchronous\" state update).\r\n\t\tconst { beforeResize } = this.getState()\r\n\t\treturn beforeResize && beforeResize.verticalSpacing || 0\r\n\t}\r\n\r\n\t/**\r\n\t * Measures item vertical spacing, if not measured.\r\n\t * @return {object} [stateUpdate]\r\n\t */\r\n\tthis.measureVerticalSpacingIfNotMeasured = () => {\r\n\t\tif (this.verticalSpacing === undefined) {\r\n\t\t\tthis.verticalSpacing = measureVerticalSpacing.call(this)\r\n\t\t\treturn this.verticalSpacing\r\n\t\t}\r\n\t}\r\n\r\n\tfunction measureVerticalSpacing() {\r\n\t\tconst {\r\n\t\t\tfirstShownItemIndex,\r\n\t\t\tlastShownItemIndex\r\n\t\t} = this.getState()\r\n\r\n\t\tlog('~ Measure item vertical spacing ~')\r\n\r\n\t\tconst verticalSpacing = getVerticalSpacing({\r\n\t\t\titemsContainer: this.itemsContainer,\r\n\t\t\trenderedItemsCount: lastShownItemIndex - firstShownItemIndex + 1\r\n\t\t})\r\n\r\n\t\tif (verticalSpacing === undefined) {\r\n\t\t\tlog('Not enough items rendered to measure vertical spacing')\r\n\t\t} else {\r\n\t\t\tlog('Item vertical spacing', verticalSpacing)\r\n\t\t\treturn verticalSpacing\r\n\t\t}\r\n\t}\r\n}"],"mappings":"AAAA,OAAOA,GAAP,MAAgB,oBAAhB;AACA,OAAOC,kBAAP,MAA+B,yBAA/B;AAEA,eAAe,SAASC,4BAAT,GAAwC;EAAA;;EACtD;EACA;EACA;EACA,KAAKD,kBAAL,GAA0B,YAAM;IAC/B,OAAO,KAAI,CAACE,eAAL,IAAwB,CAA/B;EACA,CAFD;;EAIA,KAAKC,8BAAL,GAAsC,YAAM;IAC3C;IACA;IACA;IACA,qBAAyB,KAAI,CAACC,QAAL,EAAzB;IAAA,IAAQC,YAAR,kBAAQA,YAAR;;IACA,OAAOA,YAAY,IAAIA,YAAY,CAACH,eAA7B,IAAgD,CAAvD;EACA,CAND;EAQA;AACD;AACA;AACA;;;EACC,KAAKI,mCAAL,GAA2C,YAAM;IAChD,IAAI,KAAI,CAACJ,eAAL,KAAyBK,SAA7B,EAAwC;MACvC,KAAI,CAACL,eAAL,GAAuBM,sBAAsB,CAACC,IAAvB,CAA4B,KAA5B,CAAvB;MACA,OAAO,KAAI,CAACP,eAAZ;IACA;EACD,CALD;;EAOA,SAASM,sBAAT,GAAkC;IACjC,sBAGI,KAAKJ,QAAL,EAHJ;IAAA,IACCM,mBADD,mBACCA,mBADD;IAAA,IAECC,kBAFD,mBAECA,kBAFD;;IAKAZ,GAAG,CAAC,mCAAD,CAAH;IAEA,IAAMG,eAAe,GAAGF,kBAAkB,CAAC;MAC1CY,cAAc,EAAE,KAAKA,cADqB;MAE1CC,kBAAkB,EAAEF,kBAAkB,GAAGD,mBAArB,GAA2C;IAFrB,CAAD,CAA1C;;IAKA,IAAIR,eAAe,KAAKK,SAAxB,EAAmC;MAClCR,GAAG,CAAC,uDAAD,CAAH;IACA,CAFD,MAEO;MACNA,GAAG,CAAC,uBAAD,EAA0BG,eAA1B,CAAH;MACA,OAAOA,eAAP;IACA;EACD;AACD"}

package/modules/getItemCoordinates.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../source/getItemCoordinates.js"],"names":["getItemCoordinates","i","itemHeights","columnsCount","verticalSpacing","listTopOffsetInsideScrollableContainer","rowTop","itemRowIndex","Math","floor","rowIndex","rowHeight","columnIndex","itemHeight","undefined","max","top","bottom","height"],"mappings":"AAAA;;AAEA;;;;;;;;AAQA,eAAe,SAASA,kBAAT,CAA4BC,CAA5B,QAKZ;AAAA,MAJFC,WAIE,QAJFA,WAIE;AAAA,MAHFC,YAGE,QAHFA,YAGE;AAAA,MAFFC,eAEE,QAFFA,eAEE;AAAA,MADFC,sCACE,QADFA,sCACE;AACF,MAAIC,MAAM,GAAGD,sCAAb;AACA,MAAME,YAAY,GAAGC,IAAI,CAACC,KAAL,CAAWR,CAAC,GAAGE,YAAf,CAArB;AACA,MAAIO,QAAQ,GAAG,CAAf;;AACA,SAAOA,QAAQ,GAAGH,YAAlB,EAAgC;AAC/B,QAAII,SAAS,GAAG,CAAhB;AACA,QAAIC,WAAW,GAAG,CAAlB;;AACA,WAAOA,WAAW,GAAGT,YAArB,EAAmC;AAClC,UAAMU,UAAU,GAAGX,WAAW,CAACQ,QAAQ,GAAGP,YAAX,GAA0BS,WAA3B,CAA9B;;AACA,UAAIC,UAAU,KAAKC,SAAnB,EAA8B;AAC7B;AACA;;AACDH,MAAAA,SAAS,GAAGH,IAAI,CAACO,GAAL,CAASJ,SAAT,EAAoBE,UAApB,CAAZ;AACAD,MAAAA,WAAW;AACX;;AACDN,IAAAA,MAAM,IAAIK,SAAV;AACAL,IAAAA,MAAM,IAAIF,eAAV;AACAM,IAAAA,QAAQ;AACR;;AACD,SAAO;AACNM,IAAAA,GAAG,EAAEV,MADC;AAENW,IAAAA,MAAM,EAAEX,MAAM,GAAGJ,WAAW,CAACD,CAAD,CAFtB;AAGNiB,IAAAA,MAAM,EAAEhB,WAAW,CAACD,CAAD;AAHb,GAAP;AAKA","sourcesContent":["// This function isn't currenly used.\r\n\r\n/**\r\n * Returns coordinates of item with index `i` relative to the document.\r\n * `top` is the top offset of the item relative to the start of the document.\r\n * `bottom` is the top offset of the item's bottom edge relative to the start of the document.\r\n * `height` is the item's height.\r\n * @param  {number} i\r\n * @return {object} [coordinates] — An object of shape `{ top, bottom, height }`. Returns `undefined` if some of the items along the way haven't been measured.\r\n */\r\nexport default function getItemCoordinates(i, {\r\n\titemHeights,\r\n\tcolumnsCount,\r\n\tverticalSpacing,\r\n\tlistTopOffsetInsideScrollableContainer\r\n}) {\r\n\tlet rowTop = listTopOffsetInsideScrollableContainer\r\n\tconst itemRowIndex = Math.floor(i / columnsCount)\r\n\tlet rowIndex = 0\r\n\twhile (rowIndex < itemRowIndex) {\r\n\t\tlet rowHeight = 0\r\n\t\tlet columnIndex = 0\r\n\t\twhile (columnIndex < columnsCount) {\r\n\t\t\tconst itemHeight = itemHeights[rowIndex * columnsCount + columnIndex]\r\n\t\t\tif (itemHeight === undefined) {\r\n\t\t\t\treturn\r\n\t\t\t}\r\n\t\t\trowHeight = Math.max(rowHeight, itemHeight)\r\n\t\t\tcolumnIndex++\r\n\t\t}\r\n\t\trowTop += rowHeight\r\n\t\trowTop += verticalSpacing\r\n\t\trowIndex++\r\n\t}\r\n\treturn {\r\n\t\ttop: rowTop,\r\n\t\tbottom: rowTop + itemHeights[i],\r\n\t\theight: itemHeights[i]\r\n\t}\r\n}"],"file":"getItemCoordinates.js"}
+{"version":3,"file":"getItemCoordinates.js","names":["getItemCoordinates","i","itemHeights","columnsCount","verticalSpacing","listTopOffsetInsideScrollableContainer","rowTop","itemRowIndex","Math","floor","rowIndex","rowHeight","columnIndex","itemHeight","undefined","max","top","bottom","height"],"sources":["../source/getItemCoordinates.js"],"sourcesContent":["// This function isn't currenly used.\r\n\r\n/**\r\n * Returns coordinates of item with index `i` relative to the document.\r\n * `top` is the top offset of the item relative to the start of the document.\r\n * `bottom` is the top offset of the item's bottom edge relative to the start of the document.\r\n * `height` is the item's height.\r\n * @param  {number} i\r\n * @return {object} [coordinates] — An object of shape `{ top, bottom, height }`. Returns `undefined` if some of the items along the way haven't been measured.\r\n */\r\nexport default function getItemCoordinates(i, {\r\n\titemHeights,\r\n\tcolumnsCount,\r\n\tverticalSpacing,\r\n\tlistTopOffsetInsideScrollableContainer\r\n}) {\r\n\tlet rowTop = listTopOffsetInsideScrollableContainer\r\n\tconst itemRowIndex = Math.floor(i / columnsCount)\r\n\tlet rowIndex = 0\r\n\twhile (rowIndex < itemRowIndex) {\r\n\t\tlet rowHeight = 0\r\n\t\tlet columnIndex = 0\r\n\t\twhile (columnIndex < columnsCount) {\r\n\t\t\tconst itemHeight = itemHeights[rowIndex * columnsCount + columnIndex]\r\n\t\t\tif (itemHeight === undefined) {\r\n\t\t\t\treturn\r\n\t\t\t}\r\n\t\t\trowHeight = Math.max(rowHeight, itemHeight)\r\n\t\t\tcolumnIndex++\r\n\t\t}\r\n\t\trowTop += rowHeight\r\n\t\trowTop += verticalSpacing\r\n\t\trowIndex++\r\n\t}\r\n\treturn {\r\n\t\ttop: rowTop,\r\n\t\tbottom: rowTop + itemHeights[i],\r\n\t\theight: itemHeights[i]\r\n\t}\r\n}"],"mappings":"AAAA;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,eAAe,SAASA,kBAAT,CAA4BC,CAA5B,QAKZ;EAAA,IAJFC,WAIE,QAJFA,WAIE;EAAA,IAHFC,YAGE,QAHFA,YAGE;EAAA,IAFFC,eAEE,QAFFA,eAEE;EAAA,IADFC,sCACE,QADFA,sCACE;EACF,IAAIC,MAAM,GAAGD,sCAAb;EACA,IAAME,YAAY,GAAGC,IAAI,CAACC,KAAL,CAAWR,CAAC,GAAGE,YAAf,CAArB;EACA,IAAIO,QAAQ,GAAG,CAAf;;EACA,OAAOA,QAAQ,GAAGH,YAAlB,EAAgC;IAC/B,IAAII,SAAS,GAAG,CAAhB;IACA,IAAIC,WAAW,GAAG,CAAlB;;IACA,OAAOA,WAAW,GAAGT,YAArB,EAAmC;MAClC,IAAMU,UAAU,GAAGX,WAAW,CAACQ,QAAQ,GAAGP,YAAX,GAA0BS,WAA3B,CAA9B;;MACA,IAAIC,UAAU,KAAKC,SAAnB,EAA8B;QAC7B;MACA;;MACDH,SAAS,GAAGH,IAAI,CAACO,GAAL,CAASJ,SAAT,EAAoBE,UAApB,CAAZ;MACAD,WAAW;IACX;;IACDN,MAAM,IAAIK,SAAV;IACAL,MAAM,IAAIF,eAAV;IACAM,QAAQ;EACR;;EACD,OAAO;IACNM,GAAG,EAAEV,MADC;IAENW,MAAM,EAAEX,MAAM,GAAGJ,WAAW,CAACD,CAAD,CAFtB;IAGNiB,MAAM,EAAEhB,WAAW,CAACD,CAAD;EAHb,CAAP;AAKA"}

package/modules/getItemsDiff.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../source/getItemsDiff.js"],"names":["getItemsDiff","previousItems","newItems","isEqual","firstPreviousItemIndex","lastPreviousItemIndex","length","findInArray","arePreviousItemsPreserved","isIncrementalUpdate","prependedItemsCount","appendedItemsCount","offset","i","array","element"],"mappings":"AAAA;;;;;;AAMA,eAAe,SAASA,YAAT,CAAsBC,aAAtB,EAAqCC,QAArC,EAA+CC,OAA/C,EAAwD;AACtE,MAAIC,sBAAsB,GAAG,CAAC,CAA9B;AACA,MAAIC,qBAAqB,GAAG,CAAC,CAA7B;;AACA,MAAIJ,aAAa,CAACK,MAAd,GAAuB,CAA3B,EAA8B;AAC7BF,IAAAA,sBAAsB,GAAGG,WAAW,CAACL,QAAD,EAAWD,aAAa,CAAC,CAAD,CAAxB,EAA6BE,OAA7B,CAApC;;AACA,QAAIC,sBAAsB,IAAI,CAA9B,EAAiC;AAChC,UAAII,yBAAyB,CAACP,aAAD,EAAgBC,QAAhB,EAA0BE,sBAA1B,EAAkDD,OAAlD,CAA7B,EAAyF;AACxFE,QAAAA,qBAAqB,GAAGD,sBAAsB,GAAGH,aAAa,CAACK,MAAvC,GAAgD,CAAxE;AACA;AACD;AACD;;AACD,MAAMG,mBAAmB,GAAGL,sBAAsB,IAAI,CAA1B,IAA+BC,qBAAqB,IAAI,CAApF;;AACA,MAAII,mBAAJ,EAAyB;AACxB,WAAO;AACNC,MAAAA,mBAAmB,EAAEN,sBADf;AAENO,MAAAA,kBAAkB,EAAET,QAAQ,CAACI,MAAT,IAAmBD,qBAAqB,GAAG,CAA3C;AAFd,KAAP;AAIA;AACD;;AAED,SAASG,yBAAT,CAAmCP,aAAnC,EAAkDC,QAAlD,EAA4DU,MAA5D,EAAoET,OAApE,EAA6E;AAC5E;AACA;AACA;AACA,MAAIU,CAAC,GAAG,CAAR;;AACA,SAAOA,CAAC,GAAGZ,aAAa,CAACK,MAAzB,EAAiC;AAChC,QAAIJ,QAAQ,CAACI,MAAT,IAAmBM,MAAM,GAAGC,CAA5B,IACH,CAACV,OAAO,CAACD,QAAQ,CAACU,MAAM,GAAGC,CAAV,CAAT,EAAuBZ,aAAa,CAACY,CAAD,CAApC,CADT,EACmD;AAClD,aAAO,KAAP;AACA;;AACDA,IAAAA,CAAC;AACD;;AACD,SAAO,IAAP;AACA;;AAED,SAASN,WAAT,CAAqBO,KAArB,EAA4BC,OAA5B,EAAqCZ,OAArC,EAA8C;AAC7C,MAAIU,CAAC,GAAG,CAAR;;AACA,SAAOA,CAAC,GAAGC,KAAK,CAACR,MAAjB,EAAyB;AACxB,QAAIH,OAAO,CAACW,KAAK,CAACD,CAAD,CAAN,EAAWE,OAAX,CAAX,EAAgC;AAC/B,aAAOF,CAAP;AACA;;AACDA,IAAAA,CAAC;AACD;;AACD,SAAO,CAAC,CAAR;AACA","sourcesContent":["/**\r\n * Checks whether it's an \"incremental\" items update, and returns the \"diff\".\r\n * @param  {any[]} previousItems\r\n * @param  {any[]} newItems\r\n * @return {object} [diff]\r\n */\r\nexport default function getItemsDiff(previousItems, newItems, isEqual) {\r\n\tlet firstPreviousItemIndex = -1\r\n\tlet lastPreviousItemIndex = -1\r\n\tif (previousItems.length > 0) {\r\n\t\tfirstPreviousItemIndex = findInArray(newItems, previousItems[0], isEqual)\r\n\t\tif (firstPreviousItemIndex >= 0) {\r\n\t\t\tif (arePreviousItemsPreserved(previousItems, newItems, firstPreviousItemIndex, isEqual)) {\r\n\t\t\t\tlastPreviousItemIndex = firstPreviousItemIndex + previousItems.length - 1\r\n\t\t\t}\r\n\t\t}\r\n\t}\r\n\tconst isIncrementalUpdate = firstPreviousItemIndex >= 0 && lastPreviousItemIndex >= 0\r\n\tif (isIncrementalUpdate) {\r\n\t\treturn {\r\n\t\t\tprependedItemsCount: firstPreviousItemIndex,\r\n\t\t\tappendedItemsCount: newItems.length - (lastPreviousItemIndex + 1)\r\n\t\t}\r\n\t}\r\n}\r\n\r\nfunction arePreviousItemsPreserved(previousItems, newItems, offset, isEqual) {\r\n\t// Check each item of the `previousItems` to determine\r\n\t// whether it's an \"incremental\" items update.\r\n\t// (an update when items are prepended or appended)\r\n\tlet i = 0\r\n\twhile (i < previousItems.length) {\r\n\t\tif (newItems.length <= offset + i ||\r\n\t\t\t!isEqual(newItems[offset + i], previousItems[i])) {\r\n\t\t\treturn false\r\n\t\t}\r\n\t\ti++\r\n\t}\r\n\treturn true\r\n}\r\n\r\nfunction findInArray(array, element, isEqual) {\r\n\tlet i = 0\r\n\twhile (i < array.length) {\r\n\t\tif (isEqual(array[i], element)) {\r\n\t\t\treturn i\r\n\t\t}\r\n\t\ti++\r\n\t}\r\n\treturn -1\r\n}"],"file":"getItemsDiff.js"}
+{"version":3,"file":"getItemsDiff.js","names":["getItemsDiff","previousItems","newItems","isEqual","firstPreviousItemIndex","lastPreviousItemIndex","length","findInArray","arePreviousItemsPreserved","isIncrementalUpdate","prependedItemsCount","appendedItemsCount","offset","i","array","element"],"sources":["../source/getItemsDiff.js"],"sourcesContent":["/**\r\n * Checks whether it's an \"incremental\" items update, and returns the \"diff\".\r\n * @param  {any[]} previousItems\r\n * @param  {any[]} newItems\r\n * @return {object} [diff]\r\n */\r\nexport default function getItemsDiff(previousItems, newItems, isEqual) {\r\n\tlet firstPreviousItemIndex = -1\r\n\tlet lastPreviousItemIndex = -1\r\n\tif (previousItems.length > 0) {\r\n\t\tfirstPreviousItemIndex = findInArray(newItems, previousItems[0], isEqual)\r\n\t\tif (firstPreviousItemIndex >= 0) {\r\n\t\t\tif (arePreviousItemsPreserved(previousItems, newItems, firstPreviousItemIndex, isEqual)) {\r\n\t\t\t\tlastPreviousItemIndex = firstPreviousItemIndex + previousItems.length - 1\r\n\t\t\t}\r\n\t\t}\r\n\t}\r\n\tconst isIncrementalUpdate = firstPreviousItemIndex >= 0 && lastPreviousItemIndex >= 0\r\n\tif (isIncrementalUpdate) {\r\n\t\treturn {\r\n\t\t\tprependedItemsCount: firstPreviousItemIndex,\r\n\t\t\tappendedItemsCount: newItems.length - (lastPreviousItemIndex + 1)\r\n\t\t}\r\n\t}\r\n}\r\n\r\nfunction arePreviousItemsPreserved(previousItems, newItems, offset, isEqual) {\r\n\t// Check each item of the `previousItems` to determine\r\n\t// whether it's an \"incremental\" items update.\r\n\t// (an update when items are prepended or appended)\r\n\tlet i = 0\r\n\twhile (i < previousItems.length) {\r\n\t\tif (newItems.length <= offset + i ||\r\n\t\t\t!isEqual(newItems[offset + i], previousItems[i])) {\r\n\t\t\treturn false\r\n\t\t}\r\n\t\ti++\r\n\t}\r\n\treturn true\r\n}\r\n\r\nfunction findInArray(array, element, isEqual) {\r\n\tlet i = 0\r\n\twhile (i < array.length) {\r\n\t\tif (isEqual(array[i], element)) {\r\n\t\t\treturn i\r\n\t\t}\r\n\t\ti++\r\n\t}\r\n\treturn -1\r\n}"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA,eAAe,SAASA,YAAT,CAAsBC,aAAtB,EAAqCC,QAArC,EAA+CC,OAA/C,EAAwD;EACtE,IAAIC,sBAAsB,GAAG,CAAC,CAA9B;EACA,IAAIC,qBAAqB,GAAG,CAAC,CAA7B;;EACA,IAAIJ,aAAa,CAACK,MAAd,GAAuB,CAA3B,EAA8B;IAC7BF,sBAAsB,GAAGG,WAAW,CAACL,QAAD,EAAWD,aAAa,CAAC,CAAD,CAAxB,EAA6BE,OAA7B,CAApC;;IACA,IAAIC,sBAAsB,IAAI,CAA9B,EAAiC;MAChC,IAAII,yBAAyB,CAACP,aAAD,EAAgBC,QAAhB,EAA0BE,sBAA1B,EAAkDD,OAAlD,CAA7B,EAAyF;QACxFE,qBAAqB,GAAGD,sBAAsB,GAAGH,aAAa,CAACK,MAAvC,GAAgD,CAAxE;MACA;IACD;EACD;;EACD,IAAMG,mBAAmB,GAAGL,sBAAsB,IAAI,CAA1B,IAA+BC,qBAAqB,IAAI,CAApF;;EACA,IAAII,mBAAJ,EAAyB;IACxB,OAAO;MACNC,mBAAmB,EAAEN,sBADf;MAENO,kBAAkB,EAAET,QAAQ,CAACI,MAAT,IAAmBD,qBAAqB,GAAG,CAA3C;IAFd,CAAP;EAIA;AACD;;AAED,SAASG,yBAAT,CAAmCP,aAAnC,EAAkDC,QAAlD,EAA4DU,MAA5D,EAAoET,OAApE,EAA6E;EAC5E;EACA;EACA;EACA,IAAIU,CAAC,GAAG,CAAR;;EACA,OAAOA,CAAC,GAAGZ,aAAa,CAACK,MAAzB,EAAiC;IAChC,IAAIJ,QAAQ,CAACI,MAAT,IAAmBM,MAAM,GAAGC,CAA5B,IACH,CAACV,OAAO,CAACD,QAAQ,CAACU,MAAM,GAAGC,CAAV,CAAT,EAAuBZ,aAAa,CAACY,CAAD,CAApC,CADT,EACmD;MAClD,OAAO,KAAP;IACA;;IACDA,CAAC;EACD;;EACD,OAAO,IAAP;AACA;;AAED,SAASN,WAAT,CAAqBO,KAArB,EAA4BC,OAA5B,EAAqCZ,OAArC,EAA8C;EAC7C,IAAIU,CAAC,GAAG,CAAR;;EACA,OAAOA,CAAC,GAAGC,KAAK,CAACR,MAAjB,EAAyB;IACxB,IAAIH,OAAO,CAACW,KAAK,CAACD,CAAD,CAAN,EAAWE,OAAX,CAAX,EAAgC;MAC/B,OAAOF,CAAP;IACA;;IACDA,CAAC;EACD;;EACD,OAAO,CAAC,CAAR;AACA"}

package/modules/getVerticalSpacing.js

@@ -1,15 +1,15 @@
 export default function getVerticalSpacing(_ref) {
-  var container = _ref.container,
-      screen = _ref.screen;
+  var itemsContainer = _ref.itemsContainer,
+      renderedItemsCount = _ref.renderedItemsCount;
 
-  if (screen.getChildElementsCount(container) > 1) {
-    var firstShownRowTopOffset = screen.getChildElementTopOffset(container, 0);
-    var firstShownRowHeight = screen.getChildElementHeight(container, 0);
+  if (renderedItemsCount > 1) {
+    var firstShownRowTopOffset = itemsContainer.getNthRenderedItemTopOffset(0);
+    var firstShownRowHeight = itemsContainer.getNthRenderedItemHeight(0);
     var i = 1;
 
-    while (i < screen.getChildElementsCount(container)) {
-      var itemTopOffset = screen.getChildElementTopOffset(container, i);
-      var itemHeight = screen.getChildElementHeight(container, i); // If next row is detected.
+    while (i < renderedItemsCount) {
+      var itemTopOffset = itemsContainer.getNthRenderedItemTopOffset(i);
+      var itemHeight = itemsContainer.getNthRenderedItemHeight(i); // If next row is detected.
 
       if (itemTopOffset !== firstShownRowTopOffset) {
         // Measure inter-row spacing.

package/modules/getVerticalSpacing.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../source/getVerticalSpacing.js"],"names":["getVerticalSpacing","container","screen","getChildElementsCount","firstShownRowTopOffset","getChildElementTopOffset","firstShownRowHeight","getChildElementHeight","i","itemTopOffset","itemHeight","Math","max"],"mappings":"AAAA,eAAe,SAASA,kBAAT,OAAmD;AAAA,MAArBC,SAAqB,QAArBA,SAAqB;AAAA,MAAVC,MAAU,QAAVA,MAAU;;AACjE,MAAIA,MAAM,CAACC,qBAAP,CAA6BF,SAA7B,IAA0C,CAA9C,EAAiD;AAChD,QAAMG,sBAAsB,GAAGF,MAAM,CAACG,wBAAP,CAAgCJ,SAAhC,EAA2C,CAA3C,CAA/B;AACA,QAAIK,mBAAmB,GAAGJ,MAAM,CAACK,qBAAP,CAA6BN,SAA7B,EAAwC,CAAxC,CAA1B;AACA,QAAIO,CAAC,GAAG,CAAR;;AACA,WAAOA,CAAC,GAAGN,MAAM,CAACC,qBAAP,CAA6BF,SAA7B,CAAX,EAAoD;AACnD,UAAMQ,aAAa,GAAGP,MAAM,CAACG,wBAAP,CAAgCJ,SAAhC,EAA2CO,CAA3C,CAAtB;AACA,UAAME,UAAU,GAAGR,MAAM,CAACK,qBAAP,CAA6BN,SAA7B,EAAwCO,CAAxC,CAAnB,CAFmD,CAGnD;;AACA,UAAIC,aAAa,KAAKL,sBAAtB,EAA8C;AAC7C;AACA,eAAOK,aAAa,IAAIL,sBAAsB,GAAGE,mBAA7B,CAApB;AACA,OAPkD,CAQnD;;;AACAA,MAAAA,mBAAmB,GAAGK,IAAI,CAACC,GAAL,CAASN,mBAAT,EAA8BI,UAA9B,CAAtB;AACAF,MAAAA,CAAC;AACD;AACD;AACD","sourcesContent":["export default function getVerticalSpacing({ container, screen }) {\r\n\tif (screen.getChildElementsCount(container) > 1) {\r\n\t\tconst firstShownRowTopOffset = screen.getChildElementTopOffset(container, 0)\r\n\t\tlet firstShownRowHeight = screen.getChildElementHeight(container, 0)\r\n\t\tlet i = 1\r\n\t\twhile (i < screen.getChildElementsCount(container)) {\r\n\t\t\tconst itemTopOffset = screen.getChildElementTopOffset(container, i)\r\n\t\t\tconst itemHeight = screen.getChildElementHeight(container, i)\r\n\t\t\t// If next row is detected.\r\n\t\t\tif (itemTopOffset !== firstShownRowTopOffset) {\r\n\t\t\t\t// Measure inter-row spacing.\r\n\t\t\t\treturn itemTopOffset - (firstShownRowTopOffset + firstShownRowHeight)\r\n\t\t\t}\r\n\t\t\t// A row height is the maximum of its item heights.\r\n\t\t\tfirstShownRowHeight = Math.max(firstShownRowHeight, itemHeight)\r\n\t\t\ti++\r\n\t\t}\r\n\t}\r\n}"],"file":"getVerticalSpacing.js"}
+{"version":3,"file":"getVerticalSpacing.js","names":["getVerticalSpacing","itemsContainer","renderedItemsCount","firstShownRowTopOffset","getNthRenderedItemTopOffset","firstShownRowHeight","getNthRenderedItemHeight","i","itemTopOffset","itemHeight","Math","max"],"sources":["../source/getVerticalSpacing.js"],"sourcesContent":["export default function getVerticalSpacing({ itemsContainer, renderedItemsCount }) {\r\n\tif (renderedItemsCount > 1) {\r\n\t\tconst firstShownRowTopOffset = itemsContainer.getNthRenderedItemTopOffset(0)\r\n\t\tlet firstShownRowHeight = itemsContainer.getNthRenderedItemHeight(0)\r\n\t\tlet i = 1\r\n\t\twhile (i < renderedItemsCount) {\r\n\t\t\tconst itemTopOffset = itemsContainer.getNthRenderedItemTopOffset(i)\r\n\t\t\tconst itemHeight = itemsContainer.getNthRenderedItemHeight(i)\r\n\t\t\t// If next row is detected.\r\n\t\t\tif (itemTopOffset !== firstShownRowTopOffset) {\r\n\t\t\t\t// Measure inter-row spacing.\r\n\t\t\t\treturn itemTopOffset - (firstShownRowTopOffset + firstShownRowHeight)\r\n\t\t\t}\r\n\t\t\t// A row height is the maximum of its item heights.\r\n\t\t\tfirstShownRowHeight = Math.max(firstShownRowHeight, itemHeight)\r\n\t\t\ti++\r\n\t\t}\r\n\t}\r\n}"],"mappings":"AAAA,eAAe,SAASA,kBAAT,OAAoE;EAAA,IAAtCC,cAAsC,QAAtCA,cAAsC;EAAA,IAAtBC,kBAAsB,QAAtBA,kBAAsB;;EAClF,IAAIA,kBAAkB,GAAG,CAAzB,EAA4B;IAC3B,IAAMC,sBAAsB,GAAGF,cAAc,CAACG,2BAAf,CAA2C,CAA3C,CAA/B;IACA,IAAIC,mBAAmB,GAAGJ,cAAc,CAACK,wBAAf,CAAwC,CAAxC,CAA1B;IACA,IAAIC,CAAC,GAAG,CAAR;;IACA,OAAOA,CAAC,GAAGL,kBAAX,EAA+B;MAC9B,IAAMM,aAAa,GAAGP,cAAc,CAACG,2BAAf,CAA2CG,CAA3C,CAAtB;MACA,IAAME,UAAU,GAAGR,cAAc,CAACK,wBAAf,CAAwCC,CAAxC,CAAnB,CAF8B,CAG9B;;MACA,IAAIC,aAAa,KAAKL,sBAAtB,EAA8C;QAC7C;QACA,OAAOK,aAAa,IAAIL,sBAAsB,GAAGE,mBAA7B,CAApB;MACA,CAP6B,CAQ9B;;;MACAA,mBAAmB,GAAGK,IAAI,CAACC,GAAL,CAASN,mBAAT,EAA8BI,UAA9B,CAAtB;MACAF,CAAC;IACD;EACD;AACD"}