virtual-scroller 1.15.0 → 1.15.1

package/commonjs/react/useStyle.js

@@ -7,6 +7,8 @@ exports["default"] = useStyle;
 
 var _px = _interopRequireDefault(require("../utility/px.js"));
 
+var _debug = require("../utility/debug.js");
+
 function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { "default": obj }; }
 
 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; }
@@ -21,6 +23,22 @@ function useStyle(style, _ref) {
 
   if (tbody) {
     return style;
+  } // Validate that the passed `style` property doesn't include
+  // `padding-top` or `padding-bottom` or `padding`.
+
+
+  if (style) {
+    if (typeof style.padding === 'number') {
+      (0, _debug.reportError)('`style` property can\'t include any `padding`');
+    }
+
+    if (typeof style.paddingTop === 'number') {
+      (0, _debug.reportError)('`style` property can\'t include any `paddingTop`');
+    }
+
+    if (typeof style.paddingBottom === 'number') {
+      (0, _debug.reportError)('`style` property can\'t include any `paddingBottom`');
+    }
   }
 
   var beforeItemsHeight = state.beforeItemsHeight,

package/commonjs/react/useStyle.js.map

@@ -1 +1 @@
-{"version":3,"file":"useStyle.js","names":["useStyle","style","tbody","state","beforeItemsHeight","afterItemsHeight","paddingTop","px","paddingBottom"],"sources":["../../source/react/useStyle.js"],"sourcesContent":["import px from '../utility/px.js'\r\n\r\nexport default function useStyle(style, {\r\n\ttbody,\r\n\tstate\r\n}) {\r\n\tif (tbody) {\r\n\t\treturn style\r\n\t}\r\n\r\n\tconst {\r\n\t\tbeforeItemsHeight,\r\n\t\tafterItemsHeight\r\n\t} = state\r\n\r\n\treturn {\r\n\t\t...style,\r\n\t\tpaddingTop: px(beforeItemsHeight),\r\n\t\tpaddingBottom: px(afterItemsHeight)\r\n\t}\r\n}"],"mappings":";;;;;;;AAAA;;;;;;;;;;AAEe,SAASA,QAAT,CAAkBC,KAAlB,QAGZ;EAAA,IAFFC,KAEE,QAFFA,KAEE;EAAA,IADFC,KACE,QADFA,KACE;;EACF,IAAID,KAAJ,EAAW;IACV,OAAOD,KAAP;EACA;;EAED,IACCG,iBADD,GAGID,KAHJ,CACCC,iBADD;EAAA,IAECC,gBAFD,GAGIF,KAHJ,CAECE,gBAFD;EAKA,uCACIJ,KADJ;IAECK,UAAU,EAAE,IAAAC,cAAA,EAAGH,iBAAH,CAFb;IAGCI,aAAa,EAAE,IAAAD,cAAA,EAAGF,gBAAH;EAHhB;AAKA"}
+{"version":3,"file":"useStyle.js","names":["useStyle","style","tbody","state","padding","reportError","paddingTop","paddingBottom","beforeItemsHeight","afterItemsHeight","px"],"sources":["../../source/react/useStyle.js"],"sourcesContent":["import px from '../utility/px.js'\r\nimport { reportError } from '../utility/debug.js'\r\n\r\nexport default function useStyle(style, {\r\n\ttbody,\r\n\tstate\r\n}) {\r\n\tif (tbody) {\r\n\t\treturn style\r\n\t}\r\n\r\n\t// Validate that the passed `style` property doesn't include\r\n\t// `padding-top` or `padding-bottom` or `padding`.\r\n\tif (style) {\r\n\t\tif (typeof style.padding === 'number') {\r\n\t\t\treportError('`style` property can\\'t include any `padding`')\r\n\t\t}\r\n\t\tif (typeof style.paddingTop === 'number') {\r\n\t\t\treportError('`style` property can\\'t include any `paddingTop`')\r\n\t\t}\r\n\t\tif (typeof style.paddingBottom === 'number') {\r\n\t\t\treportError('`style` property can\\'t include any `paddingBottom`')\r\n\t\t}\r\n\t}\r\n\r\n\tconst {\r\n\t\tbeforeItemsHeight,\r\n\t\tafterItemsHeight\r\n\t} = state\r\n\r\n\treturn {\r\n\t\t...style,\r\n\t\tpaddingTop: px(beforeItemsHeight),\r\n\t\tpaddingBottom: px(afterItemsHeight)\r\n\t}\r\n}"],"mappings":";;;;;;;AAAA;;AACA;;;;;;;;;;AAEe,SAASA,QAAT,CAAkBC,KAAlB,QAGZ;EAAA,IAFFC,KAEE,QAFFA,KAEE;EAAA,IADFC,KACE,QADFA,KACE;;EACF,IAAID,KAAJ,EAAW;IACV,OAAOD,KAAP;EACA,CAHC,CAKF;EACA;;;EACA,IAAIA,KAAJ,EAAW;IACV,IAAI,OAAOA,KAAK,CAACG,OAAb,KAAyB,QAA7B,EAAuC;MACtC,IAAAC,kBAAA,EAAY,+CAAZ;IACA;;IACD,IAAI,OAAOJ,KAAK,CAACK,UAAb,KAA4B,QAAhC,EAA0C;MACzC,IAAAD,kBAAA,EAAY,kDAAZ;IACA;;IACD,IAAI,OAAOJ,KAAK,CAACM,aAAb,KAA+B,QAAnC,EAA6C;MAC5C,IAAAF,kBAAA,EAAY,qDAAZ;IACA;EACD;;EAED,IACCG,iBADD,GAGIL,KAHJ,CACCK,iBADD;EAAA,IAECC,gBAFD,GAGIN,KAHJ,CAECM,gBAFD;EAKA,uCACIR,KADJ;IAECK,UAAU,EAAE,IAAAI,cAAA,EAAGF,iBAAH,CAFb;IAGCD,aAAa,EAAE,IAAAG,cAAA,EAAGD,gBAAH;EAHhB;AAKA"}

package/commonjs/react/useVirtualScroller.js

@@ -7,60 +7,159 @@ exports["default"] = useVirtualScroller;
 
 var _react = require("react");
 
-var _VirtualScroller = _interopRequireDefault(require("../VirtualScroller.js"));
+var _useState2 = _interopRequireDefault(require("./useState.js"));
+
+var _useCreateVirtualScroller = _interopRequireDefault(require("./useCreateVirtualScroller.js"));
+
+var _useStartStopVirtualScroller = _interopRequireDefault(require("./useStartStopVirtualScroller.js"));
+
+var _useSetNewItemsOnItemsPropertyChange = _interopRequireDefault(require("./useSetNewItemsOnItemsPropertyChange.js"));
+
+var _useValidateTableBodyItemsContainer = _interopRequireDefault(require("./useValidateTableBodyItemsContainer.js"));
+
+var _useClassName = _interopRequireDefault(require("./useClassName.js"));
+
+var _useStyle = _interopRequireDefault(require("./useStyle.js"));
 
 function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { "default": obj }; }
 
-// Creates a `VirtualScroller` instance.
-function useVirtualScroller(_ref, _ref2) {
-  var items = _ref.items,
-      estimatedItemHeight = _ref.estimatedItemHeight,
-      getEstimatedItemHeight = _ref.getEstimatedItemHeight,
-      getEstimatedVisibleItemRowsCount = _ref.getEstimatedVisibleItemRowsCount,
-      getEstimatedInterItemVerticalSpacing = _ref.getEstimatedInterItemVerticalSpacing,
+// When `items` property changes:
+// * A new `items` property is supplied to the React component.
+// * The React component re-renders itself.
+// * `useSetNewItemsOnItemsPropertyChange()` hook is run.
+// * `useSetNewItemsOnItemsPropertyChange()` hook detects that the `items` property
+//   has changed and calls `VirtualScroller.setItems(items)`.
+// * `VirtualScroller.setItems(items)` calls `VirtualScroller.setState()`.
+// * `VirtualScroller.setState()` calls the `setState()` function.
+// * The `setState()` function calls a setter from a `useState()` hook.
+// * The React component re-renders itself the second time.
+function useVirtualScroller(_ref) {
+  var itemsProperty = _ref.items,
+      tbody = _ref.tbody,
+      readyToStart = _ref.readyToStart,
+      styleProperty = _ref.style,
+      classNameProperty = _ref.className,
       bypass = _ref.bypass,
-      onItemInitialRender = _ref.onItemInitialRender,
-      onItemFirstRender = _ref.onItemFirstRender,
-      initialScrollPosition = _ref.initialScrollPosition,
-      onScrollPositionChange = _ref.onScrollPositionChange,
+      preserveScrollPosition = _ref.preserveScrollPosition,
+      preserveScrollPositionOnPrependItems = _ref.preserveScrollPositionOnPrependItems,
       measureItemsBatchSize = _ref.measureItemsBatchSize,
       scrollableContainer = _ref.scrollableContainer,
       getScrollableContainer = _ref.getScrollableContainer,
       getColumnsCount = _ref.getColumnsCount,
       getItemId = _ref.getItemId,
+      onItemFirstRender = _ref.onItemFirstRender,
+      onItemInitialRender = _ref.onItemInitialRender,
+      initialScrollPosition = _ref.initialScrollPosition,
+      onScrollPositionChange = _ref.onScrollPositionChange,
       initialState = _ref.initialState,
       getInitialItemState = _ref.getInitialItemState,
-      onStateChange = _ref.onStateChange;
-  var itemsContainer = _ref2.itemsContainer;
-  return (0, _react.useMemo)(function () {
-    // Create `virtual-scroller` instance.
-    return new _VirtualScroller["default"](function () {
-      return itemsContainer.current;
-    }, items, {
-      _useTimeoutInRenderLoop: true,
-      // `estimatedItemHeight` is deprecated, use `getEstimatedItemHeight()` instead.
-      estimatedItemHeight: estimatedItemHeight,
-      getEstimatedItemHeight: getEstimatedItemHeight,
-      getEstimatedVisibleItemRowsCount: getEstimatedVisibleItemRowsCount,
-      getEstimatedInterItemVerticalSpacing: getEstimatedInterItemVerticalSpacing,
-      bypass: bypass,
-      // bypassBatchSize,
-      onItemInitialRender: onItemInitialRender,
-      // `onItemFirstRender(i)` is deprecated, use `onItemInitialRender(item)` instead.
-      onItemFirstRender: onItemFirstRender,
-      initialScrollPosition: initialScrollPosition,
-      onScrollPositionChange: onScrollPositionChange,
-      measureItemsBatchSize: measureItemsBatchSize,
-      // `scrollableContainer` property is deprecated.
-      // Use `getScrollableContainer()` property instead.
-      scrollableContainer: scrollableContainer,
-      getScrollableContainer: getScrollableContainer,
-      getColumnsCount: getColumnsCount,
-      getItemId: getItemId,
-      state: initialState,
-      getInitialItemState: getInitialItemState,
-      onStateChange: onStateChange
+      onStateChange = _ref.onStateChange,
+      getEstimatedItemHeight = _ref.getEstimatedItemHeight,
+      getEstimatedVisibleItemRowsCount = _ref.getEstimatedVisibleItemRowsCount,
+      getEstimatedInterItemVerticalSpacing = _ref.getEstimatedInterItemVerticalSpacing;
+  // A `ref` to the items container element.
+  var itemsContainerRef = (0, _react.useRef)(); // Use `hasMounted` flag to decide if `itemsContainerRef` value should be validated.
+
+  var hasMounted = (0, _react.useRef)(false);
+  (0, _react.useLayoutEffect)(function () {
+    hasMounted.current = true;
+  }, []); // Create a `VirtualScroller` instance.
+
+  var virtualScroller = (0, _useCreateVirtualScroller["default"])({
+    items: itemsProperty,
+    getEstimatedItemHeight: getEstimatedItemHeight,
+    getEstimatedVisibleItemRowsCount: getEstimatedVisibleItemRowsCount,
+    getEstimatedInterItemVerticalSpacing: getEstimatedInterItemVerticalSpacing,
+    bypass: bypass,
+    // bypassBatchSize,
+    onItemInitialRender: onItemInitialRender,
+    // `onItemFirstRender(i)` is deprecated, use `onItemInitialRender(item)` instead.
+    onItemFirstRender: onItemFirstRender,
+    initialScrollPosition: initialScrollPosition,
+    onScrollPositionChange: onScrollPositionChange,
+    measureItemsBatchSize: measureItemsBatchSize,
+    // `scrollableContainer` property is deprecated.
+    // Use `getScrollableContainer()` property instead.
+    scrollableContainer: scrollableContainer,
+    getScrollableContainer: getScrollableContainer,
+    getColumnsCount: getColumnsCount,
+    getItemId: getItemId,
+    initialState: initialState,
+    getInitialItemState: getInitialItemState,
+    onStateChange: onStateChange
+  }, {
+    getItemsContainerElement: function getItemsContainerElement() {
+      // Validate that the developer has correctly passed the returned `itemsContainerRef` property
+      // as the items container component's `ref`.
+      //
+      // `getItemsContainerElement()` function is called both before it has mounted
+      // and after it has mounted. Only validate the ref's value after it has mounted.
+      //
+      if (hasMounted.current) {
+        if (!itemsContainerRef.current) {
+          throw new Error('[virtual-scroller] Did you forget to pass the returned `itemsContainerRef` property as the items container component\'s `ref`?');
+        }
+      } // Return the items container element.
+
+
+      return itemsContainerRef.current;
+    }
+  }); // Only compute the initial state once.
+
+  var _initialState = (0, _react.useMemo)(function () {
+    return virtualScroller.getInitialState();
+  }, []); // Use React's `useState()` hook for managing `VirtualScroller`'s state lifecycle.
+  // This way, React will re-render the component on every state update.
+
+
+  var _useState = (0, _useState2["default"])({
+    initialState: _initialState,
+    onRender: virtualScroller.onRender
+  }),
+      getState = _useState.getState,
+      setState = _useState.setState,
+      stateToRender = _useState.stateToRender; // Use custom (external) state storage in the `VirtualScroller`.
+
+
+  (0, _react.useMemo)(function () {
+    virtualScroller.useState({
+      getState: getState,
+      setState: setState
     });
-  }, []);
+  }, []); // Start `VirtualScroller` on mount.
+  // Stop `VirtualScroller` on unmount.
+
+  (0, _useStartStopVirtualScroller["default"])(virtualScroller, {
+    readyToStart: readyToStart
+  }); // Calls `.setItems()` if `items` property has changed.
+
+  (0, _useSetNewItemsOnItemsPropertyChange["default"])(itemsProperty, {
+    virtualScroller: virtualScroller,
+    // `preserveScrollPosition` property name is deprecated,
+    // use `preserveScrollPositionOnPrependItems` property instead.
+    preserveScrollPosition: preserveScrollPosition,
+    preserveScrollPositionOnPrependItems: preserveScrollPositionOnPrependItems
+  }); // A developer might "forget" to pass `itemsContainerComponent="tbody"` property
+  // when using a `<tbody/>` as a container for list items.
+  // This hook validates that the developer didn't "forget" to do that in such case.
+
+  (0, _useValidateTableBodyItemsContainer["default"])({
+    virtualScroller: virtualScroller,
+    tbody: tbody
+  });
+  var className = (0, _useClassName["default"])(classNameProperty, {
+    tbody: tbody
+  });
+  var style = (0, _useStyle["default"])(styleProperty, {
+    tbody: tbody,
+    state: stateToRender
+  });
+  return {
+    state: stateToRender,
+    style: style,
+    className: className,
+    itemsContainerRef: itemsContainerRef,
+    virtualScroller: virtualScroller
+  };
 }
 //# sourceMappingURL=useVirtualScroller.js.map

package/commonjs/react/useVirtualScroller.js.map

@@ -1 +1 @@
-{"version":3,"file":"useVirtualScroller.js","names":["useVirtualScroller","items","estimatedItemHeight","getEstimatedItemHeight","getEstimatedVisibleItemRowsCount","getEstimatedInterItemVerticalSpacing","bypass","onItemInitialRender","onItemFirstRender","initialScrollPosition","onScrollPositionChange","measureItemsBatchSize","scrollableContainer","getScrollableContainer","getColumnsCount","getItemId","initialState","getInitialItemState","onStateChange","itemsContainer","useMemo","VirtualScroller","current","_useTimeoutInRenderLoop","state"],"sources":["../../source/react/useVirtualScroller.js"],"sourcesContent":["import { useMemo } from 'react'\r\n\r\nimport VirtualScroller from '../VirtualScroller.js'\r\n\r\n// Creates a `VirtualScroller` instance.\r\nexport default function useVirtualScroller({\r\n\titems,\r\n\t// `estimatedItemHeight` is deprecated, use `getEstimatedItemHeight()` instead.\r\n\testimatedItemHeight,\r\n\tgetEstimatedItemHeight,\r\n\tgetEstimatedVisibleItemRowsCount,\r\n\tgetEstimatedInterItemVerticalSpacing,\r\n\tbypass,\r\n\t// bypassBatchSize,\r\n\tonItemInitialRender,\r\n\t// `onItemFirstRender(i)` is deprecated, use `onItemInitialRender(item)` instead.\r\n\tonItemFirstRender,\r\n\tinitialScrollPosition,\r\n\tonScrollPositionChange,\r\n\tmeasureItemsBatchSize,\r\n\t// `scrollableContainer` property is deprecated.\r\n\t// Use `getScrollableContainer()` property instead.\r\n\tscrollableContainer,\r\n\tgetScrollableContainer,\r\n\tgetColumnsCount,\r\n\tgetItemId,\r\n\tinitialState,\r\n\tgetInitialItemState,\r\n\tonStateChange\r\n}, {\r\n\titemsContainer\r\n}) {\r\n\treturn useMemo(() => {\r\n\t\t// Create `virtual-scroller` instance.\r\n\t\treturn new VirtualScroller(\r\n\t\t\t() => itemsContainer.current,\r\n\t\t\titems,\r\n\t\t\t{\r\n\t\t\t\t_useTimeoutInRenderLoop: true,\r\n\t\t\t\t// `estimatedItemHeight` is deprecated, use `getEstimatedItemHeight()` instead.\r\n\t\t\t\testimatedItemHeight,\r\n\t\t\t\tgetEstimatedItemHeight,\r\n\t\t\t\tgetEstimatedVisibleItemRowsCount,\r\n\t\t\t\tgetEstimatedInterItemVerticalSpacing,\r\n\t\t\t\tbypass,\r\n\t\t\t\t// bypassBatchSize,\r\n\t\t\t\tonItemInitialRender,\r\n\t\t\t\t// `onItemFirstRender(i)` is deprecated, use `onItemInitialRender(item)` instead.\r\n\t\t\t\tonItemFirstRender,\r\n\t\t\t\tinitialScrollPosition,\r\n\t\t\t\tonScrollPositionChange,\r\n\t\t\t\tmeasureItemsBatchSize,\r\n\t\t\t\t// `scrollableContainer` property is deprecated.\r\n\t\t\t\t// Use `getScrollableContainer()` property instead.\r\n\t\t\t\tscrollableContainer,\r\n\t\t\t\tgetScrollableContainer,\r\n\t\t\t\tgetColumnsCount,\r\n\t\t\t\tgetItemId,\r\n\t\t\t\tstate: initialState,\r\n\t\t\t\tgetInitialItemState,\r\n\t\t\t\tonStateChange\r\n\t\t\t}\r\n\t\t)\r\n\t}, [])\r\n}"],"mappings":";;;;;;;AAAA;;AAEA;;;;AAEA;AACe,SAASA,kBAAT,cA0BZ;EAAA,IAzBFC,KAyBE,QAzBFA,KAyBE;EAAA,IAvBFC,mBAuBE,QAvBFA,mBAuBE;EAAA,IAtBFC,sBAsBE,QAtBFA,sBAsBE;EAAA,IArBFC,gCAqBE,QArBFA,gCAqBE;EAAA,IApBFC,oCAoBE,QApBFA,oCAoBE;EAAA,IAnBFC,MAmBE,QAnBFA,MAmBE;EAAA,IAjBFC,mBAiBE,QAjBFA,mBAiBE;EAAA,IAfFC,iBAeE,QAfFA,iBAeE;EAAA,IAdFC,qBAcE,QAdFA,qBAcE;EAAA,IAbFC,sBAaE,QAbFA,sBAaE;EAAA,IAZFC,qBAYE,QAZFA,qBAYE;EAAA,IATFC,mBASE,QATFA,mBASE;EAAA,IARFC,sBAQE,QARFA,sBAQE;EAAA,IAPFC,eAOE,QAPFA,eAOE;EAAA,IANFC,SAME,QANFA,SAME;EAAA,IALFC,YAKE,QALFA,YAKE;EAAA,IAJFC,mBAIE,QAJFA,mBAIE;EAAA,IAHFC,aAGE,QAHFA,aAGE;EAAA,IADFC,cACE,SADFA,cACE;EACF,OAAO,IAAAC,cAAA,EAAQ,YAAM;IACpB;IACA,OAAO,IAAIC,2BAAJ,CACN;MAAA,OAAMF,cAAc,CAACG,OAArB;IAAA,CADM,EAENrB,KAFM,EAGN;MACCsB,uBAAuB,EAAE,IAD1B;MAEC;MACArB,mBAAmB,EAAnBA,mBAHD;MAICC,sBAAsB,EAAtBA,sBAJD;MAKCC,gCAAgC,EAAhCA,gCALD;MAMCC,oCAAoC,EAApCA,oCAND;MAOCC,MAAM,EAANA,MAPD;MAQC;MACAC,mBAAmB,EAAnBA,mBATD;MAUC;MACAC,iBAAiB,EAAjBA,iBAXD;MAYCC,qBAAqB,EAArBA,qBAZD;MAaCC,sBAAsB,EAAtBA,sBAbD;MAcCC,qBAAqB,EAArBA,qBAdD;MAeC;MACA;MACAC,mBAAmB,EAAnBA,mBAjBD;MAkBCC,sBAAsB,EAAtBA,sBAlBD;MAmBCC,eAAe,EAAfA,eAnBD;MAoBCC,SAAS,EAATA,SApBD;MAqBCS,KAAK,EAAER,YArBR;MAsBCC,mBAAmB,EAAnBA,mBAtBD;MAuBCC,aAAa,EAAbA;IAvBD,CAHM,CAAP;EA6BA,CA/BM,EA+BJ,EA/BI,CAAP;AAgCA"}
+{"version":3,"file":"useVirtualScroller.js","names":["useVirtualScroller","itemsProperty","items","tbody","readyToStart","styleProperty","style","classNameProperty","className","bypass","preserveScrollPosition","preserveScrollPositionOnPrependItems","measureItemsBatchSize","scrollableContainer","getScrollableContainer","getColumnsCount","getItemId","onItemFirstRender","onItemInitialRender","initialScrollPosition","onScrollPositionChange","initialState","getInitialItemState","onStateChange","getEstimatedItemHeight","getEstimatedVisibleItemRowsCount","getEstimatedInterItemVerticalSpacing","itemsContainerRef","useRef","hasMounted","useLayoutEffect","current","virtualScroller","useCreateVirtualScroller","getItemsContainerElement","Error","_initialState","useMemo","getInitialState","useState","onRender","getState","setState","stateToRender","useStartStopVirtualScroller","useSetNewItemsOnItemsPropertyChange","useValidateTableBodyItemsContainer","useClassName","useStyle","state"],"sources":["../../source/react/useVirtualScroller.js"],"sourcesContent":["import { useLayoutEffect, useMemo, useRef } from 'react'\r\n\r\nimport useState from './useState.js'\r\nimport useCreateVirtualScroller from './useCreateVirtualScroller.js'\r\nimport useStartStopVirtualScroller from './useStartStopVirtualScroller.js'\r\nimport useSetNewItemsOnItemsPropertyChange from './useSetNewItemsOnItemsPropertyChange.js'\r\nimport useValidateTableBodyItemsContainer from './useValidateTableBodyItemsContainer.js'\r\nimport useClassName from './useClassName.js'\r\nimport useStyle from './useStyle.js'\r\n\r\n// When `items` property changes:\r\n// * A new `items` property is supplied to the React component.\r\n// * The React component re-renders itself.\r\n// * `useSetNewItemsOnItemsPropertyChange()` hook is run.\r\n// * `useSetNewItemsOnItemsPropertyChange()` hook detects that the `items` property\r\n//   has changed and calls `VirtualScroller.setItems(items)`.\r\n// * `VirtualScroller.setItems(items)` calls `VirtualScroller.setState()`.\r\n// * `VirtualScroller.setState()` calls the `setState()` function.\r\n// * The `setState()` function calls a setter from a `useState()` hook.\r\n// * The React component re-renders itself the second time.\r\n\r\nexport default function useVirtualScroller({\r\n\t// The following are `<VirtualScroller/>` properties.\r\n\t//\r\n\titems: itemsProperty,\r\n\t// Because the use of a `<tbody/>` tag as an items container component can't always be auto-detected,\r\n\t// a developer could manually pass a `tbody: boolean` property.\r\n\t// Futhermore, when using `useVirtualScroller()` hook instead of `<VirtualScroller/>` component,\r\n\t// `itemsContainerComponent` property is not accessible for tag name detection.\r\n\ttbody,\r\n\treadyToStart,\r\n\tstyle: styleProperty,\r\n\tclassName: classNameProperty,\r\n\r\n\t// The following are the \"core\" component options.\r\n\t//\r\n\tbypass,\r\n\t// `preserveScrollPosition` property name is deprecated,\r\n\t// use `preserveScrollPositionOnPrependItems` property instead.\r\n\tpreserveScrollPosition,\r\n\tpreserveScrollPositionOnPrependItems,\r\n\tmeasureItemsBatchSize,\r\n\t// `scrollableContainer` property is deprecated.\r\n\t// Use `getScrollableContainer()` property instead.\r\n\tscrollableContainer,\r\n\tgetScrollableContainer,\r\n\tgetColumnsCount,\r\n\tgetItemId,\r\n\t// `onItemFirstRender(i)` is deprecated, use `onItemInitialRender(item)` instead.\r\n\tonItemFirstRender,\r\n\tonItemInitialRender,\r\n\tinitialScrollPosition,\r\n\tonScrollPositionChange,\r\n\tinitialState,\r\n\tgetInitialItemState,\r\n\tonStateChange,\r\n\tgetEstimatedItemHeight,\r\n\tgetEstimatedVisibleItemRowsCount,\r\n\tgetEstimatedInterItemVerticalSpacing\r\n}) {\r\n\t// A `ref` to the items container element.\r\n\tconst itemsContainerRef = useRef()\r\n\r\n\t// Use `hasMounted` flag to decide if `itemsContainerRef` value should be validated.\r\n\tconst hasMounted = useRef(false)\r\n\tuseLayoutEffect(() => {\r\n\t\thasMounted.current = true\r\n\t}, [])\r\n\r\n\t// Create a `VirtualScroller` instance.\r\n\tconst virtualScroller = useCreateVirtualScroller({\r\n\t\titems: itemsProperty,\r\n\t\tgetEstimatedItemHeight,\r\n\t\tgetEstimatedVisibleItemRowsCount,\r\n\t\tgetEstimatedInterItemVerticalSpacing,\r\n\t\tbypass,\r\n\t\t// bypassBatchSize,\r\n\t\tonItemInitialRender,\r\n\t\t// `onItemFirstRender(i)` is deprecated, use `onItemInitialRender(item)` instead.\r\n\t\tonItemFirstRender,\r\n\t\tinitialScrollPosition,\r\n\t\tonScrollPositionChange,\r\n\t\tmeasureItemsBatchSize,\r\n\t\t// `scrollableContainer` property is deprecated.\r\n\t\t// Use `getScrollableContainer()` property instead.\r\n\t\tscrollableContainer,\r\n\t\tgetScrollableContainer,\r\n\t\tgetColumnsCount,\r\n\t\tgetItemId,\r\n\t\tinitialState,\r\n\t\tgetInitialItemState,\r\n\t\tonStateChange\r\n\t}, {\r\n\t\tgetItemsContainerElement: () => {\r\n\t\t\t// Validate that the developer has correctly passed the returned `itemsContainerRef` property\r\n\t\t\t// as the items container component's `ref`.\r\n\t\t\t//\r\n\t\t\t// `getItemsContainerElement()` function is called both before it has mounted\r\n\t\t\t// and after it has mounted. Only validate the ref's value after it has mounted.\r\n\t\t\t//\r\n\t\t\tif (hasMounted.current) {\r\n\t\t\t\tif (!itemsContainerRef.current) {\r\n\t\t\t\t\tthrow new Error('[virtual-scroller] Did you forget to pass the returned `itemsContainerRef` property as the items container component\\'s `ref`?')\r\n\t\t\t\t}\r\n\t\t\t}\r\n\t\t\t// Return the items container element.\r\n\t\t\treturn itemsContainerRef.current\r\n\t\t}\r\n\t})\r\n\r\n\t// Only compute the initial state once.\r\n\tconst _initialState = useMemo(() => {\r\n\t\treturn virtualScroller.getInitialState()\r\n\t}, [])\r\n\r\n\t// Use React's `useState()` hook for managing `VirtualScroller`'s state lifecycle.\r\n\t// This way, React will re-render the component on every state update.\r\n\tconst {\r\n\t\tgetState,\r\n\t\tsetState,\r\n\t\tstateToRender\r\n\t} = useState({\r\n\t\tinitialState: _initialState,\r\n\t\tonRender: virtualScroller.onRender\r\n\t})\r\n\r\n\t// Use custom (external) state storage in the `VirtualScroller`.\r\n\tuseMemo(() => {\r\n\t\tvirtualScroller.useState({\r\n\t\t\tgetState,\r\n\t\t\tsetState\r\n\t\t})\r\n\t}, [])\r\n\r\n\t// Start `VirtualScroller` on mount.\r\n\t// Stop `VirtualScroller` on unmount.\r\n\tuseStartStopVirtualScroller(virtualScroller, { readyToStart })\r\n\r\n\t// Calls `.setItems()` if `items` property has changed.\r\n\tuseSetNewItemsOnItemsPropertyChange(itemsProperty, {\r\n\t\tvirtualScroller,\r\n\t\t// `preserveScrollPosition` property name is deprecated,\r\n\t\t// use `preserveScrollPositionOnPrependItems` property instead.\r\n\t\tpreserveScrollPosition,\r\n\t\tpreserveScrollPositionOnPrependItems\r\n\t})\r\n\r\n\t// A developer might \"forget\" to pass `itemsContainerComponent=\"tbody\"` property\r\n\t// when using a `<tbody/>` as a container for list items.\r\n\t// This hook validates that the developer didn't \"forget\" to do that in such case.\r\n\tuseValidateTableBodyItemsContainer({\r\n\t\tvirtualScroller,\r\n\t\ttbody\r\n\t})\r\n\r\n\tconst className = useClassName(classNameProperty, {\r\n\t\ttbody\r\n\t})\r\n\r\n\tconst style = useStyle(styleProperty, {\r\n\t\ttbody,\r\n\t\tstate: stateToRender\r\n\t})\r\n\r\n\treturn {\r\n\t\tstate: stateToRender,\r\n\t\tstyle,\r\n\t\tclassName,\r\n\t\titemsContainerRef,\r\n\t\tvirtualScroller\r\n\t}\r\n}"],"mappings":"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"}

package/modules/react/VirtualScroller.js

@@ -1,4 +1,4 @@
-var _excluded = ["as", "items", "itemComponent", "itemComponentProps", "itemsContainerComponent", "itemsContainerComponentProps", "itemsContainerRef", "estimatedItemHeight", "getEstimatedItemHeight", "getEstimatedVisibleItemRowsCount", "getEstimatedInterItemVerticalSpacing", "onMount", "tbody", "readyToStart", "className", "bypass", "preserveScrollPosition", "preserveScrollPositionOnPrependItems", "measureItemsBatchSize", "scrollableContainer", "getScrollableContainer", "getColumnsCount", "getItemId", "onItemFirstRender", "onItemInitialRender", "initialScrollPosition", "onScrollPositionChange", "initialState", "getInitialItemState", "onStateChange"];
+var _excluded = ["as", "items", "itemComponent", "itemComponentProps", "itemsContainerComponent", "itemsContainerComponentProps", "itemsContainerRef", "onMount", "tbody", "readyToStart", "className", "bypass", "preserveScrollPosition", "preserveScrollPositionOnPrependItems", "measureItemsBatchSize", "scrollableContainer", "getScrollableContainer", "getColumnsCount", "getItemId", "onItemFirstRender", "onItemInitialRender", "initialScrollPosition", "onScrollPositionChange", "initialState", "getInitialItemState", "onStateChange", "estimatedItemHeight", "getEstimatedItemHeight", "getEstimatedVisibleItemRowsCount", "getEstimatedInterItemVerticalSpacing"];
 
 function _extends() { _extends = Object.assign || function (target) { for (var i = 1; i < arguments.length; i++) { var source = arguments[i]; for (var key in source) { if (Object.prototype.hasOwnProperty.call(source, key)) { target[key] = source[key]; } } } return target; }; return _extends.apply(this, arguments); }
 
@@ -6,31 +6,16 @@ function _objectWithoutProperties(source, excluded) { if (source == null) return
 
 function _objectWithoutPropertiesLoose(source, excluded) { if (source == null) return {}; var target = {}; var sourceKeys = Object.keys(source); var key, i; for (i = 0; i < sourceKeys.length; i++) { key = sourceKeys[i]; if (excluded.indexOf(key) >= 0) continue; target[key] = source[key]; } return target; }
 
-import React, { useMemo, useLayoutEffect } from 'react';
+import React, { useLayoutEffect } from 'react';
 import PropTypes from 'prop-types';
-import useState from './useState.js';
 import useVirtualScroller from './useVirtualScroller.js';
-import useVirtualScrollerStartStop from './useVirtualScrollerStartStop.js';
-import useInstanceMethods from './useInstanceMethods.js';
 import useItemKeys from './useItemKeys.js';
 import useSetItemState from './useSetItemState.js';
 import useOnItemHeightDidChange from './useOnItemHeightDidChange.js';
-import useSetNewItemsOnItemsPropertyChange from './useSetNewItemsOnItemsPropertyChange.js';
+import useMergeRefs from './useMergeRefs.js';
+import useInstanceMethods from './useInstanceMethods.js';
 import useUpdateItemKeysOnItemsChange from './useUpdateItemKeysOnItemsChange.js';
-import useValidateTableBodyItemsContainer from './useValidateTableBodyItemsContainer.js';
-import useForwardedRef from './useForwardedRef.js';
-import useClassName from './useClassName.js';
-import useStyle from './useStyle.js';
-import { warn } from '../utility/debug.js'; // When `items` property changes:
-// * A new `items` property is supplied to the React component.
-// * The React component re-renders itself.
-// * `useSetNewItemsOnItemsPropertyChange()` hook is run.
-// * `useSetNewItemsOnItemsPropertyChange()` hook detects that the `items` property
-//   has changed and calls `VirtualScroller.setItems(items)`.
-// * `VirtualScroller.setItems(items)` calls `VirtualScroller.setState()`.
-// * `VirtualScroller.setState()` calls the `setState()` function.
-// * The `setState()` function calls a setter from a `useState()` hook.
-// * The React component re-renders itself the second time.
+import { warn } from '../utility/debug.js';
 
 function VirtualScroller(_ref, ref) {
   var as = _ref.as,
@@ -39,11 +24,7 @@ function VirtualScroller(_ref, ref) {
       itemComponentProps = _ref.itemComponentProps,
       ItemsContainerComponent = _ref.itemsContainerComponent,
       itemsContainerComponentProps = _ref.itemsContainerComponentProps,
-      itemsContainerRef = _ref.itemsContainerRef,
-      estimatedItemHeight = _ref.estimatedItemHeight,
-      getEstimatedItemHeight = _ref.getEstimatedItemHeight,
-      getEstimatedVisibleItemRowsCount = _ref.getEstimatedVisibleItemRowsCount,
-      getEstimatedInterItemVerticalSpacing = _ref.getEstimatedInterItemVerticalSpacing,
+      itemsContainerRefProperty = _ref.itemsContainerRef,
       onMount = _ref.onMount,
       tbody = _ref.tbody,
       readyToStart = _ref.readyToStart,
@@ -63,6 +44,10 @@ function VirtualScroller(_ref, ref) {
       initialState = _ref.initialState,
       getInitialItemState = _ref.getInitialItemState,
       onStateChange = _ref.onStateChange,
+      estimatedItemHeight = _ref.estimatedItemHeight,
+      getEstimatedItemHeight = _ref.getEstimatedItemHeight,
+      getEstimatedVisibleItemRowsCount = _ref.getEstimatedVisibleItemRowsCount,
+      getEstimatedInterItemVerticalSpacing = _ref.getEstimatedInterItemVerticalSpacing,
       rest = _objectWithoutProperties(_ref, _excluded);
 
   // Previously, `as` property was being used instead of `itemsContainerComponent`,
@@ -71,47 +56,34 @@ function VirtualScroller(_ref, ref) {
   // The default `"div"` fallback value is just a legacy compatibility relic, and so is the `as` property.
   if (!ItemsContainerComponent) {
     ItemsContainerComponent = as || 'div';
-  } // It turns out that since May 2022, `useVirtualScroller()` hook completely ignored the `tbody` property.
-  // Instead, it always derived `tbody` property value from `as` property value by comparing it to `"tbody"` string.
-  // As a result, it seemed like the explicit passing of `tbody` property didn't really work as intended.
-  // In the end, it was decided that perhaps `tbody` property value should always be derived from `as` property
-  // without a developer having to manually specify it. So the `tbody` property was deprecated.
-  // It still exists though for backwards compatibility with the older versions of the package.
+  } // In simple cases, the use of a `<tbody/>` tag as an items container component could be auto-detected.
 
 
   if (tbody === undefined) {
-    // `tbody` should be somehow detected before any DOM Elements have been mounted.
+    // `tbody` auto-detection should happen before any DOM Elements have been mounted,
+    // i.e. it can't rely on the trivial `getItemsContainerElement().tagName === 'TBODY'` check.
     // This is because during Server-Side Render there's no DOM Elements tree at all.
     // And server-sider render result is required to be exactly the same as client-side render result.
     // This means that `tbody` detection for the purposes of getting the initial
     // `className` or `style` property values must not rely on any DOM Elements at all,
     // and should use some other means such as explicitly passing a `tbody: true` property
-    // (as it used to be in the past) or detecting `<tbody/>` tag usage from the
-    // `itemsContainerCompoent` property value.
+    // or detecting `<tbody/>` tag usage from the `itemsContainerCompoent` property value.
     tbody = ItemsContainerComponent === 'tbody';
-  } // List items "container" DOM Element reference.
-
-
-  var _useForwardedRef = useForwardedRef(itemsContainerRef),
-      setItemsContainerRef = _useForwardedRef.setRef,
-      itemsContainer = _useForwardedRef.internalRef; // Create a `VirtualScroller` instance.
+  }
 
-
-  var virtualScroller = useVirtualScroller({
+  var _useVirtualScroller = useVirtualScroller({
     items: itemsProperty,
-    // `estimatedItemHeight` property name is deprecated,
-    // use `getEstimatedItemHeight` property instead.
-    estimatedItemHeight: estimatedItemHeight,
-    getEstimatedItemHeight: getEstimatedItemHeight,
-    getEstimatedVisibleItemRowsCount: getEstimatedVisibleItemRowsCount,
-    getEstimatedInterItemVerticalSpacing: getEstimatedInterItemVerticalSpacing,
+    tbody: tbody,
+    readyToStart: readyToStart,
+    style: itemsContainerComponentProps && itemsContainerComponentProps.style,
+    className: classNameProperty || itemsContainerComponentProps && itemsContainerComponentProps.className,
+    // The following are the "core" component options.
+    //
     bypass: bypass,
-    // bypassBatchSize,
-    onItemInitialRender: onItemInitialRender,
-    // `onItemFirstRender(i)` is deprecated, use `onItemInitialRender(item)` instead.
-    onItemFirstRender: onItemFirstRender,
-    initialScrollPosition: initialScrollPosition,
-    onScrollPositionChange: onScrollPositionChange,
+    // `preserveScrollPosition` property name is deprecated,
+    // use `preserveScrollPositionOnPrependItems` property instead.
+    preserveScrollPosition: preserveScrollPosition,
+    preserveScrollPositionOnPrependItems: preserveScrollPositionOnPrependItems,
     measureItemsBatchSize: measureItemsBatchSize,
     // `scrollableContainer` property is deprecated.
     // Use `getScrollableContainer()` property instead.
@@ -119,39 +91,30 @@ function VirtualScroller(_ref, ref) {
     getScrollableContainer: getScrollableContainer,
     getColumnsCount: getColumnsCount,
     getItemId: getItemId,
+    // `onItemFirstRender(i)` is deprecated, use `onItemInitialRender(item)` instead.
+    onItemFirstRender: onItemFirstRender,
+    onItemInitialRender: onItemInitialRender,
+    initialScrollPosition: initialScrollPosition,
+    onScrollPositionChange: onScrollPositionChange,
     initialState: initialState,
     getInitialItemState: getInitialItemState,
-    onStateChange: onStateChange
-  }, {
-    itemsContainer: itemsContainer
-  }); // Only compute the initial state once.
-
-  var _initialState = useMemo(function () {
-    return virtualScroller.getInitialState();
-  }, []); // Use React's `useState()` hook for managing `VirtualScroller`'s state lifecycle.
-  // This way, React will re-render the component on every state update.
-
-
-  var _useState = useState({
-    initialState: _initialState,
-    onRender: virtualScroller.onRender
+    onStateChange: onStateChange,
+    getEstimatedItemHeight: getEstimatedItemHeight || ( // `estimatedItemHeight` property name is deprecated,
+    // use `getEstimatedItemHeight` property instead.
+    typeof estimatedItemHeight === 'number' ? function () {
+      return estimatedItemHeight;
+    } : undefined),
+    getEstimatedVisibleItemRowsCount: getEstimatedVisibleItemRowsCount,
+    getEstimatedInterItemVerticalSpacing: getEstimatedInterItemVerticalSpacing
   }),
-      getState = _useState.getState,
-      setState = _useState.setState,
-      stateToRender = _useState.stateToRender; // Use custom (external) state storage in the `VirtualScroller`.
-
+      stateToRender = _useVirtualScroller.state,
+      style = _useVirtualScroller.style,
+      className = _useVirtualScroller.className,
+      itemsContainerRef = _useVirtualScroller.itemsContainerRef,
+      virtualScroller = _useVirtualScroller.virtualScroller; // List items "container" DOM Element reference.
 
-  useMemo(function () {
-    virtualScroller.useState({
-      getState: getState,
-      setState: setState
-    });
-  }, []); // Start `VirtualScroller` on mount.
-  // Stop `VirtualScroller` on unmount.
 
-  useVirtualScrollerStartStop(virtualScroller, {
-    readyToStart: readyToStart
-  }); // List items are rendered with `key`s so that React doesn't
+  var setItemsContainerRef = useMergeRefs(itemsContainerRef, itemsContainerRefProperty); // List items are rendered with `key`s so that React doesn't
   // "reuse" `itemComponent`s in cases when `items` are changed.
 
   var _useItemKeys = useItemKeys({
@@ -160,10 +123,16 @@ function VirtualScroller(_ref, ref) {
       getItemKey = _useItemKeys.getItemKey,
       onItemKeysReset = _useItemKeys.onItemKeysReset,
       usesAutogeneratedItemKeys = _useItemKeys.usesAutogeneratedItemKeys,
-      updateItemKeysForNewItems = _useItemKeys.updateItemKeysForNewItems; // Cache per-item `setItemState` functions' "references"
-  // so that item components don't get re-rendered needlessly.
+      updateItemKeysForNewItems = _useItemKeys.updateItemKeysForNewItems; // Updates `key`s if item indexes have changed.
 
 
+  useUpdateItemKeysOnItemsChange(stateToRender.items, {
+    virtualScroller: virtualScroller,
+    usesAutogeneratedItemKeys: usesAutogeneratedItemKeys,
+    updateItemKeysForNewItems: updateItemKeysForNewItems
+  }); // Cache per-item `setItemState` functions' "references"
+  // so that item components don't get re-rendered needlessly.
+
   var getSetItemState = useSetItemState({
     getItemKey: getItemKey,
     onItemKeysReset: onItemKeysReset,
@@ -175,20 +144,6 @@ function VirtualScroller(_ref, ref) {
     getItemKey: getItemKey,
     onItemKeysReset: onItemKeysReset,
     virtualScroller: virtualScroller
-  }); // Calls `.setItems()` if `items` property has changed.
-
-  useSetNewItemsOnItemsPropertyChange(itemsProperty, {
-    virtualScroller: virtualScroller,
-    // `preserveScrollPosition` property name is deprecated,
-    // use `preserveScrollPositionOnPrependItems` property instead.
-    preserveScrollPosition: preserveScrollPosition,
-    preserveScrollPositionOnPrependItems: preserveScrollPositionOnPrependItems
-  }); // Updates `key`s if item indexes have changed.
-
-  useUpdateItemKeysOnItemsChange(stateToRender.items, {
-    virtualScroller: virtualScroller,
-    usesAutogeneratedItemKeys: usesAutogeneratedItemKeys,
-    updateItemKeysForNewItems: updateItemKeysForNewItems
   }); // Add instance methods to the React component.
 
   useInstanceMethods(ref, {
@@ -202,14 +157,7 @@ function VirtualScroller(_ref, ref) {
       warn('`onMount` property is deprecated');
       onMount();
     }
-  }, []); // A developer might "forget" to pass `itemsContainerComponent="tbody"` property
-  // when using a `<tbody/>` as a container for list items.
-  // This hook validates that the developer didn't "forget" to do that in such case.
-
-  useValidateTableBodyItemsContainer({
-    virtualScroller: virtualScroller,
-    tbody: tbody
-  }); // `willRender()` function is no longer used.
+  }, []); // `willRender()` function is no longer used.
   //
   // // `getSnapshotBeforeUpdate()` is called right before `componentDidUpdate()`.
   // // A hook equivalent/workaround for `getSnapshotBeforeUpdate()`:
@@ -224,15 +172,6 @@ function VirtualScroller(_ref, ref) {
   // 	return null
   // }
 
-  var classNamePassThrough = classNameProperty || itemsContainerComponentProps && itemsContainerComponentProps.className;
-  var className = useClassName(classNamePassThrough, {
-    tbody: tbody
-  });
-  var stylePassThrough = itemsContainerComponentProps && itemsContainerComponentProps.style;
-  var style = useStyle(stylePassThrough, {
-    tbody: tbody,
-    state: stateToRender
-  });
   var currentItems = stateToRender.items,
       itemStates = stateToRender.itemStates,
       firstShownItemIndex = stateToRender.firstShownItemIndex,
@@ -309,9 +248,7 @@ VirtualScroller.propTypes = {
   getEstimatedInterItemVerticalSpacing: PropTypes.func,
   bypass: PropTypes.bool,
   // bypassBatchSize: PropTypes.number,
-  // `tbody` property is deprecated.
-  // Pass `as: "tbody"` property instead.
-  // tbody: PropTypes.bool,
+  tbody: PropTypes.bool,
   preserveScrollPositionOnPrependItems: PropTypes.bool,
   // `preserveScrollPosition` property name is deprecated,
   // use `preserveScrollPositionOnPrependItems` instead.
@@ -344,5 +281,17 @@ VirtualScroller.propTypes = {
     verticalSpacing: PropTypes.number
   }),
   getInitialItemState: PropTypes.func
-};
+}; // Legacy compatibility:
+//
+// Originally, the default export of the `virtual-scroller/react` subpackage
+// was only the `VirtualScroller` component, and there were no other exports.
+//
+// Later, `useVirtualScroller()` hook export was added.
+// In order to maintain legacy compatibility, the new exports shouldn't "break"
+// the existing environments that were using the old versions of the package.
+// This means that in non-ES6-import environments, any additional exports
+// should be added directly to the default `VirtualScroller` export.
+//
+
+VirtualScroller.useVirtualScroller = useVirtualScroller;
 //# sourceMappingURL=VirtualScroller.js.map