virtual-scroller 1.14.0 → 1.15.0

package/modules/react/VirtualScroller.js

@@ -1,4 +1,4 @@
-var _excluded = ["as", "items", "itemComponent", "itemComponentProps", "estimatedItemHeight", "getEstimatedItemHeight", "getEstimatedVisibleItemRowsCount", "bypass", "tbody", "preserveScrollPosition", "preserveScrollPositionOnPrependItems", "measureItemsBatchSize", "scrollableContainer", "getScrollableContainer", "getColumnsCount", "getItemId", "className", "readyToStart", "onMount", "onItemFirstRender", "onItemInitialRender", "initialScrollPosition", "onScrollPositionChange", "onStateChange", "initialState", "getInitialItemState"];
+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"];
 
 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,7 +6,7 @@ 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, { useRef, useMemo, useLayoutEffect } from 'react';
+import React, { useMemo, useLayoutEffect } from 'react';
 import PropTypes from 'prop-types';
 import useState from './useState.js';
 import useVirtualScroller from './useVirtualScroller.js';
@@ -17,6 +17,8 @@ import useSetItemState from './useSetItemState.js';
 import useOnItemHeightDidChange from './useOnItemHeightDidChange.js';
 import useSetNewItemsOnItemsPropertyChange from './useSetNewItemsOnItemsPropertyChange.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:
@@ -31,16 +33,22 @@ import { warn } from '../utility/debug.js'; // When `items` property changes:
 // * The React component re-renders itself the second time.
 
 function VirtualScroller(_ref, ref) {
-  var _ref$as = _ref.as,
-      AsComponent = _ref$as === void 0 ? 'div' : _ref$as,
+  var as = _ref.as,
       itemsProperty = _ref.items,
-      Component = _ref.itemComponent,
+      ItemComponent = _ref.itemComponent,
       itemComponentProps = _ref.itemComponentProps,
+      ItemsContainerComponent = _ref.itemsContainerComponent,
+      itemsContainerComponentProps = _ref.itemsContainerComponentProps,
+      itemsContainerRef = _ref.itemsContainerRef,
       estimatedItemHeight = _ref.estimatedItemHeight,
       getEstimatedItemHeight = _ref.getEstimatedItemHeight,
       getEstimatedVisibleItemRowsCount = _ref.getEstimatedVisibleItemRowsCount,
-      bypass = _ref.bypass,
+      getEstimatedInterItemVerticalSpacing = _ref.getEstimatedInterItemVerticalSpacing,
+      onMount = _ref.onMount,
       tbody = _ref.tbody,
+      readyToStart = _ref.readyToStart,
+      classNameProperty = _ref.className,
+      bypass = _ref.bypass,
       preserveScrollPosition = _ref.preserveScrollPosition,
       preserveScrollPositionOnPrependItems = _ref.preserveScrollPositionOnPrependItems,
       measureItemsBatchSize = _ref.measureItemsBatchSize,
@@ -48,30 +56,46 @@ function VirtualScroller(_ref, ref) {
       getScrollableContainer = _ref.getScrollableContainer,
       getColumnsCount = _ref.getColumnsCount,
       getItemId = _ref.getItemId,
-      className = _ref.className,
-      readyToStart = _ref.readyToStart,
-      onMount = _ref.onMount,
       onItemFirstRender = _ref.onItemFirstRender,
       onItemInitialRender = _ref.onItemInitialRender,
       initialScrollPosition = _ref.initialScrollPosition,
       onScrollPositionChange = _ref.onScrollPositionChange,
-      onStateChange = _ref.onStateChange,
       initialState = _ref.initialState,
       getInitialItemState = _ref.getInitialItemState,
+      onStateChange = _ref.onStateChange,
       rest = _objectWithoutProperties(_ref, _excluded);
 
-  // It turns out that since May 2022, `useVirtualScroller()` hook completely ignored the `tbody` property.
+  // Previously, `as` property was being used instead of `itemsContainerComponent`,
+  // and the default `as` property value was a generic `<div/>`.
+  // Starting from version `1.14.1`, it is recommended to explicitly specify the `itemsContainerComponent`.
+  // 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.
+
+
   if (tbody === undefined) {
-    tbody = AsComponent === 'tbody';
+    // `tbody` should be somehow detected before any DOM Elements have been mounted.
+    // 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.
+    tbody = ItemsContainerComponent === 'tbody';
   } // List items "container" DOM Element reference.
 
 
-  var container = useRef(); // Create a `VirtualScroller` instance.
+  var _useForwardedRef = useForwardedRef(itemsContainerRef),
+      setItemsContainerRef = _useForwardedRef.setRef,
+      itemsContainer = _useForwardedRef.internalRef; // Create a `VirtualScroller` instance.
+
 
   var virtualScroller = useVirtualScroller({
     items: itemsProperty,
@@ -80,6 +104,7 @@ function VirtualScroller(_ref, ref) {
     estimatedItemHeight: estimatedItemHeight,
     getEstimatedItemHeight: getEstimatedItemHeight,
     getEstimatedVisibleItemRowsCount: getEstimatedVisibleItemRowsCount,
+    getEstimatedInterItemVerticalSpacing: getEstimatedInterItemVerticalSpacing,
     bypass: bypass,
     // bypassBatchSize,
     onItemInitialRender: onItemInitialRender,
@@ -94,12 +119,11 @@ function VirtualScroller(_ref, ref) {
     getScrollableContainer: getScrollableContainer,
     getColumnsCount: getColumnsCount,
     getItemId: getItemId,
-    AsComponent: AsComponent,
     initialState: initialState,
     getInitialItemState: getInitialItemState,
     onStateChange: onStateChange
   }, {
-    container: container
+    itemsContainer: itemsContainer
   }); // Only compute the initial state once.
 
   var _initialState = useMemo(function () {
@@ -134,19 +158,22 @@ function VirtualScroller(_ref, ref) {
     getItemId: getItemId
   }),
       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.
 
 
   var getSetItemState = useSetItemState({
-    initialItemsCount: itemsProperty.length,
+    getItemKey: getItemKey,
+    onItemKeysReset: onItemKeysReset,
     virtualScroller: virtualScroller
   }); // Cache per-item `onItemHeightDidChange` functions' "references"
   // so that item components don't get re-rendered needlessly.
 
   var getOnItemHeightDidChange = useOnItemHeightDidChange({
-    initialItemsCount: itemsProperty.length,
+    getItemKey: getItemKey,
+    onItemKeysReset: onItemKeysReset,
     virtualScroller: virtualScroller
   }); // Calls `.setItems()` if `items` property has changed.
 
@@ -175,7 +202,14 @@ function VirtualScroller(_ref, ref) {
       warn('`onMount` property is deprecated');
       onMount();
     }
-  }, []); // `willRender()` function is no longer used.
+  }, []); // 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.
   //
   // // `getSnapshotBeforeUpdate()` is called right before `componentDidUpdate()`.
   // // A hook equivalent/workaround for `getSnapshotBeforeUpdate()`:
@@ -190,10 +224,12 @@ function VirtualScroller(_ref, ref) {
   // 	return null
   // }
 
-  className = useClassName(className, {
+  var classNamePassThrough = classNameProperty || itemsContainerComponentProps && itemsContainerComponentProps.className;
+  var className = useClassName(classNamePassThrough, {
     tbody: tbody
   });
-  var style = useStyle({
+  var stylePassThrough = itemsContainerComponentProps && itemsContainerComponentProps.style;
+  var style = useStyle(stylePassThrough, {
     tbody: tbody,
     state: stateToRender
   });
@@ -201,32 +237,36 @@ function VirtualScroller(_ref, ref) {
       itemStates = stateToRender.itemStates,
       firstShownItemIndex = stateToRender.firstShownItemIndex,
       lastShownItemIndex = stateToRender.lastShownItemIndex;
-  return /*#__PURE__*/React.createElement(AsComponent, _extends({}, rest, {
-    ref: container,
+  return /*#__PURE__*/React.createElement(ItemsContainerComponent, _extends({}, itemsContainerComponentProps, rest, {
+    ref: setItemsContainerRef,
     className: className,
     style: style
   }), currentItems.map(function (item, i) {
     if (i >= firstShownItemIndex && i <= lastShownItemIndex) {
-      // * Passing `item` as `children` property is legacy and is deprecated.
+      // * Passing the `item` as `children` property is legacy and is deprecated.
       //   If version `2.x` is published in some hypothetical future,
-      //   the `item` and `itemIndex` properties should be moved below
-      //   `{...itemComponentProps}`.
+      //   the `item` property should be moved below `{...itemComponentProps}`.
       //
-      // * Passing `itemIndex` property is legacy and is deprecated.
-      //   The rationale is that setting new `items` on a React component
-      //   is an asynchronous operation, so when a user obtains `itemIndex`,
-      //   they don't know which `items` list does that index correspond to,
-      //   therefore making it useless, or even buggy if used incorreclty.
+      // * Passing `itemIndex` property is legacy and is deprecated
+      //   and could be removed in some future.
+      //   The rationale for deprecation is that the `items` property
+      //   is not constant and could change, in which case the `itemIndex` value
+      //   would be of no use because the application wouldn't know
+      //   which exact `items` it corresponds to at any given moment in time.
+      //   Having just the `itemIndex` and no actual `item` is therefore considered useless.
+      //   Instead, a developer could simply use `getItemKey(item)` function.
       //
-      // * Passing `onStateChange` property for legacy reasons.
+      // * `onStateChange` property is passed here for legacy reasons.
       //   The new property name is `setState`.
-      //   The old property name `onStateChange` is deprecated.
+      //   The old property name `onStateChange` is deprecated
+      //   and could be removed in some future.
       //
-      // * Passing `onHeightChange` property for legacy reasons.
+      // * `onHeightChange` property is passed here for legacy reasons.
       //   The new property name is `onHeightDidChange`.
-      //   The old property name `onHeightChange` is deprecated.
+      //   The old property name `onHeightChange` is deprecated
+      //   and could be removed in some future.
       //
-      return /*#__PURE__*/React.createElement(Component, _extends({
+      return /*#__PURE__*/React.createElement(ItemComponent, _extends({
         item: item,
         itemIndex: i
       }, itemComponentProps, {
@@ -249,15 +289,24 @@ export default VirtualScroller; // `PropTypes.elementType` is available in some
 
 var elementType = PropTypes.elementType || PropTypes.oneOfType([PropTypes.string, PropTypes.func, PropTypes.object]);
 VirtualScroller.propTypes = {
+  // `as` property is deprecated, use `itemsContainerComponent` property instead.
   as: elementType,
   items: PropTypes.arrayOf(PropTypes.any).isRequired,
   itemComponent: elementType.isRequired,
   itemComponentProps: PropTypes.object,
+  // `itemsContainerComponent` property is not required just for legacy compatibility reasons.
+  // Any new applications should explicitly specify it.
+  itemsContainerComponent: elementType,
+  itemsContainerComponentProps: PropTypes.object,
+  itemsContainerRef: PropTypes.oneOfType([PropTypes.func, PropTypes.shape({
+    current: PropTypes.object
+  })]),
   // `estimatedItemHeight` property name is deprecated,
   // use `getEstimatedItemHeight` property instead.
   estimatedItemHeight: PropTypes.number,
   getEstimatedItemHeight: PropTypes.func,
   getEstimatedVisibleItemRowsCount: PropTypes.func,
+  getEstimatedInterItemVerticalSpacing: PropTypes.func,
   bypass: PropTypes.bool,
   // bypassBatchSize: PropTypes.number,
   // `tbody` property is deprecated.

package/modules/react/VirtualScroller.js.map

@@ -1 +1 @@
-{"version":3,"file":"VirtualScroller.js","names":["React","useRef","useMemo","useLayoutEffect","PropTypes","useState","useVirtualScroller","useVirtualScrollerStartStop","useInstanceMethods","useItemKeys","useSetItemState","useOnItemHeightDidChange","useSetNewItemsOnItemsPropertyChange","useUpdateItemKeysOnItemsChange","useClassName","useStyle","warn","VirtualScroller","ref","as","AsComponent","itemsProperty","items","Component","itemComponent","itemComponentProps","estimatedItemHeight","getEstimatedItemHeight","getEstimatedVisibleItemRowsCount","bypass","tbody","preserveScrollPosition","preserveScrollPositionOnPrependItems","measureItemsBatchSize","scrollableContainer","getScrollableContainer","getColumnsCount","getItemId","className","readyToStart","onMount","onItemFirstRender","onItemInitialRender","initialScrollPosition","onScrollPositionChange","onStateChange","initialState","getInitialItemState","rest","undefined","container","virtualScroller","_initialState","getInitialState","onRender","getState","setState","stateToRender","getItemKey","usesAutogeneratedItemKeys","updateItemKeysForNewItems","getSetItemState","initialItemsCount","length","getOnItemHeightDidChange","style","state","currentItems","itemStates","firstShownItemIndex","lastShownItemIndex","map","item","i","forwardRef","elementType","oneOfType","string","func","object","propTypes","arrayOf","any","isRequired","number","bool","shape","beforeItemsHeight","afterItemsHeight","itemHeights","columnsCount","verticalSpacing"],"sources":["../../source/react/VirtualScroller.js"],"sourcesContent":["import React, { useRef, useMemo, useLayoutEffect } from 'react'\r\nimport PropTypes from 'prop-types'\r\n\r\nimport useState from './useState.js'\r\nimport useVirtualScroller from './useVirtualScroller.js'\r\nimport useVirtualScrollerStartStop from './useVirtualScrollerStartStop.js'\r\nimport useInstanceMethods from './useInstanceMethods.js'\r\nimport useItemKeys from './useItemKeys.js'\r\nimport useSetItemState from './useSetItemState.js'\r\nimport useOnItemHeightDidChange from './useOnItemHeightDidChange.js'\r\nimport useSetNewItemsOnItemsPropertyChange from './useSetNewItemsOnItemsPropertyChange.js'\r\nimport useUpdateItemKeysOnItemsChange from './useUpdateItemKeysOnItemsChange.js'\r\nimport useClassName from './useClassName.js'\r\nimport useStyle from './useStyle.js'\r\n\r\nimport { warn } from '../utility/debug.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\nfunction VirtualScroller({\r\n\tas: AsComponent = 'div',\r\n\titems: itemsProperty,\r\n\titemComponent: Component,\r\n\titemComponentProps,\r\n\t// `estimatedItemHeight` property name is deprecated,\r\n\t// use `getEstimatedItemHeight` property instead.\r\n\testimatedItemHeight,\r\n\tgetEstimatedItemHeight,\r\n\tgetEstimatedVisibleItemRowsCount,\r\n\tbypass,\r\n\t// `tbody` property is deprecated.\r\n\t// Pass `as: \"tbody\"` property instead.\r\n\ttbody,\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\tclassName,\r\n\treadyToStart,\r\n\tonMount,\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\tonStateChange,\r\n\tinitialState,\r\n\tgetInitialItemState,\r\n\t...rest\r\n}, ref) {\r\n\t// It turns out that since May 2022, `useVirtualScroller()` hook completely ignored the `tbody` property.\r\n\t// Instead, it always derived `tbody` property value from `as` property value by comparing it to `\"tbody\"` string.\r\n\t// As a result, it seemed like the explicit passing of `tbody` property didn't really work as intended.\r\n\t// In the end, it was decided that perhaps `tbody` property value should always be derived from `as` property\r\n\t// without a developer having to manually specify it. So the `tbody` property was deprecated.\r\n\t// It still exists though for backwards compatibility with the older versions of the package.\r\n\tif (tbody === undefined) {\r\n\t\ttbody = AsComponent === 'tbody'\r\n\t}\r\n\r\n\t// List items \"container\" DOM Element reference.\r\n\tconst container = useRef()\r\n\r\n\t// Create a `VirtualScroller` instance.\r\n\tconst virtualScroller = useVirtualScroller({\r\n\t\titems: itemsProperty,\r\n\t\t// `estimatedItemHeight` property name is deprecated,\r\n\t\t// use `getEstimatedItemHeight` property instead.\r\n\t\testimatedItemHeight,\r\n\t\tgetEstimatedItemHeight,\r\n\t\tgetEstimatedVisibleItemRowsCount,\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\tAsComponent,\r\n\t\tinitialState,\r\n\t\tgetInitialItemState,\r\n\t\tonStateChange\r\n\t}, {\r\n\t\tcontainer\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\tuseVirtualScrollerStartStop(virtualScroller, { readyToStart })\r\n\r\n\t// List items are rendered with `key`s so that React doesn't\r\n\t// \"reuse\" `itemComponent`s in cases when `items` are changed.\r\n\tconst {\r\n\t\tgetItemKey,\r\n\t\tusesAutogeneratedItemKeys,\r\n\t\tupdateItemKeysForNewItems\r\n\t} = useItemKeys({\r\n\t\tgetItemId\r\n\t})\r\n\r\n\t// Cache per-item `setItemState` functions' \"references\"\r\n\t// so that item components don't get re-rendered needlessly.\r\n\tconst getSetItemState = useSetItemState({\r\n\t\tinitialItemsCount: itemsProperty.length,\r\n\t\tvirtualScroller\r\n\t})\r\n\r\n\t// Cache per-item `onItemHeightDidChange` functions' \"references\"\r\n\t// so that item components don't get re-rendered needlessly.\r\n\tconst getOnItemHeightDidChange = useOnItemHeightDidChange({\r\n\t\tinitialItemsCount: itemsProperty.length,\r\n\t\tvirtualScroller\r\n\t})\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// Updates `key`s if item indexes have changed.\r\n\tuseUpdateItemKeysOnItemsChange(stateToRender.items, {\r\n\t\tvirtualScroller,\r\n\t\tusesAutogeneratedItemKeys,\r\n\t\tupdateItemKeysForNewItems\r\n\t})\r\n\r\n\t// Add instance methods to the React component.\r\n\tuseInstanceMethods(ref, {\r\n\t\tvirtualScroller\r\n\t})\r\n\r\n\tuseLayoutEffect(() => {\r\n\t\t// (deprecated)\r\n\t\t// `onMount()` option is deprecated due to no longer being used.\r\n\t\t// If someone thinks there's a valid use case for it, create an issue.\r\n\t\tif (onMount) {\r\n\t\t\twarn('`onMount` property is deprecated')\r\n\t\t\tonMount()\r\n\t\t}\r\n\t}, [])\r\n\r\n\t// `willRender()` function is no longer used.\r\n\t//\r\n\t// // `getSnapshotBeforeUpdate()` is called right before `componentDidUpdate()`.\r\n\t// // A hook equivalent/workaround for `getSnapshotBeforeUpdate()`:\r\n\t// // https://github.com/facebook/react/issues/15221#issuecomment-583448887\r\n\t// //\r\n\t// getSnapshotBeforeUpdate(prevProps, prevState) {\r\n\t// \tif (this.state !== prevState) {\r\n\t// \t\tthis.willRender(this.state, prevState)\r\n\t// \t}\r\n\t// \t// Returns `null` to avoid React warning:\r\n\t// \t// \"A snapshot value (or null) must be returned. You have returned undefined\".\r\n\t// \treturn null\r\n\t// }\r\n\r\n\tclassName = useClassName(className, {\r\n\t\ttbody\r\n\t})\r\n\r\n\tconst style = useStyle({\r\n\t\ttbody,\r\n\t\tstate: stateToRender\r\n\t})\r\n\r\n\tconst {\r\n\t\titems: currentItems,\r\n\t\titemStates,\r\n\t\tfirstShownItemIndex,\r\n\t\tlastShownItemIndex\r\n\t} = stateToRender\r\n\r\n\treturn (\r\n\t\t<AsComponent\r\n\t\t\t{...rest}\r\n\t\t\tref={container}\r\n\t\t\tclassName={className}\r\n\t\t\tstyle={style}>\r\n\t\t\t{currentItems.map((item, i) => {\r\n\t\t\t\tif (i >= firstShownItemIndex && i <= lastShownItemIndex) {\r\n\t\t\t\t\t// * Passing `item` as `children` property is legacy and is deprecated.\r\n\t\t\t\t\t//   If version `2.x` is published in some hypothetical future,\r\n\t\t\t\t\t//   the `item` and `itemIndex` properties should be moved below\r\n\t\t\t\t\t//   `{...itemComponentProps}`.\r\n\t\t\t\t\t//\r\n\t\t\t\t\t// * Passing `itemIndex` property is legacy and is deprecated.\r\n\t\t\t\t\t//   The rationale is that setting new `items` on a React component\r\n\t\t\t\t\t//   is an asynchronous operation, so when a user obtains `itemIndex`,\r\n\t\t\t\t\t//   they don't know which `items` list does that index correspond to,\r\n\t\t\t\t\t//   therefore making it useless, or even buggy if used incorreclty.\r\n\t\t\t\t\t//\r\n\t\t\t\t\t// * Passing `onStateChange` property for legacy reasons.\r\n\t\t\t\t\t//   The new property name is `setState`.\r\n\t\t\t\t\t//   The old property name `onStateChange` is deprecated.\r\n\t\t\t\t\t//\r\n\t\t\t\t\t// * Passing `onHeightChange` property for legacy reasons.\r\n\t\t\t\t\t//   The new property name is `onHeightDidChange`.\r\n\t\t\t\t\t//   The old property name `onHeightChange` is deprecated.\r\n\t\t\t\t\t//\r\n\t\t\t\t\treturn (\r\n\t\t\t\t\t\t<Component\r\n\t\t\t\t\t\t\titem={item}\r\n\t\t\t\t\t\t\titemIndex={i}\r\n\t\t\t\t\t\t\t{...itemComponentProps}\r\n\t\t\t\t\t\t\tkey={getItemKey(item, i)}\r\n\t\t\t\t\t\t\tstate={itemStates && itemStates[i]}\r\n\t\t\t\t\t\t\tsetState={getSetItemState(i)}\r\n\t\t\t\t\t\t\tonStateChange={getSetItemState(i)}\r\n\t\t\t\t\t\t\tonHeightChange={getOnItemHeightDidChange(i)}\r\n\t\t\t\t\t\t\tonHeightDidChange={getOnItemHeightDidChange(i)}>\r\n\t\t\t\t\t\t\t{item}\r\n\t\t\t\t\t\t</Component>\r\n\t\t\t\t\t)\r\n\t\t\t\t}\r\n\t\t\t\treturn null\r\n\t\t\t})}\r\n\t\t</AsComponent>\r\n\t)\r\n}\r\n\r\nVirtualScroller = React.forwardRef(VirtualScroller)\r\n\r\nexport default VirtualScroller\r\n\r\n// `PropTypes.elementType` is available in some version of `prop-types`.\r\n// https://github.com/facebook/prop-types/issues/200\r\nconst elementType = PropTypes.elementType || PropTypes.oneOfType([\r\n\tPropTypes.string,\r\n\tPropTypes.func,\r\n\tPropTypes.object\r\n])\r\n\r\nVirtualScroller.propTypes = {\r\n\tas: elementType,\r\n\titems: PropTypes.arrayOf(PropTypes.any).isRequired,\r\n\titemComponent: elementType.isRequired,\r\n\titemComponentProps: PropTypes.object,\r\n\t// `estimatedItemHeight` property name is deprecated,\r\n\t// use `getEstimatedItemHeight` property instead.\r\n\testimatedItemHeight: PropTypes.number,\r\n\tgetEstimatedItemHeight: PropTypes.func,\r\n\tgetEstimatedVisibleItemRowsCount: PropTypes.func,\r\n\tbypass: PropTypes.bool,\r\n\t// bypassBatchSize: PropTypes.number,\r\n\t// `tbody` property is deprecated.\r\n\t// Pass `as: \"tbody\"` property instead.\r\n\t// tbody: PropTypes.bool,\r\n\tpreserveScrollPositionOnPrependItems: PropTypes.bool,\r\n\t// `preserveScrollPosition` property name is deprecated,\r\n\t// use `preserveScrollPositionOnPrependItems` instead.\r\n\tpreserveScrollPosition: PropTypes.bool,\r\n\tmeasureItemsBatchSize: PropTypes.number,\r\n\t// `scrollableContainer` property is deprecated.\r\n\t// Use `getScrollableContainer()` property instead.\r\n\tscrollableContainer: PropTypes.any,\r\n\tgetScrollableContainer: PropTypes.func,\r\n\tgetColumnsCount: PropTypes.func,\r\n\tgetItemId: PropTypes.func,\r\n\tclassName: PropTypes.string,\r\n\treadyToStart: PropTypes.bool,\r\n\tonMount: PropTypes.func,\r\n\tonItemInitialRender: PropTypes.func,\r\n\t// `onItemFirstRender(i)` is deprecated, use `onItemInitialRender(item)` instead.\r\n\tonItemFirstRender: PropTypes.func,\r\n\tinitialScrollPosition: PropTypes.number,\r\n\tonScrollPositionChange: PropTypes.func,\r\n\tonStateChange: PropTypes.func,\r\n\tinitialState: PropTypes.shape({\r\n\t\titems: PropTypes.arrayOf(PropTypes.object).isRequired,\r\n\t\titemStates: PropTypes.arrayOf(PropTypes.any).isRequired,\r\n\t\tfirstShownItemIndex: PropTypes.number.isRequired,\r\n\t\tlastShownItemIndex: PropTypes.number.isRequired,\r\n\t\tbeforeItemsHeight: PropTypes.number.isRequired,\r\n\t\tafterItemsHeight: PropTypes.number.isRequired,\r\n\t\titemHeights: PropTypes.arrayOf(PropTypes.number).isRequired,\r\n\t\tcolumnsCount: PropTypes.number,\r\n\t\tverticalSpacing: PropTypes.number\r\n\t}),\r\n\tgetInitialItemState: PropTypes.func\r\n}\r\n"],"mappings":"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"}
+{"version":3,"file":"VirtualScroller.js","names":["React","useMemo","useLayoutEffect","PropTypes","useState","useVirtualScroller","useVirtualScrollerStartStop","useInstanceMethods","useItemKeys","useSetItemState","useOnItemHeightDidChange","useSetNewItemsOnItemsPropertyChange","useUpdateItemKeysOnItemsChange","useValidateTableBodyItemsContainer","useForwardedRef","useClassName","useStyle","warn","VirtualScroller","ref","as","itemsProperty","items","ItemComponent","itemComponent","itemComponentProps","ItemsContainerComponent","itemsContainerComponent","itemsContainerComponentProps","itemsContainerRef","estimatedItemHeight","getEstimatedItemHeight","getEstimatedVisibleItemRowsCount","getEstimatedInterItemVerticalSpacing","onMount","tbody","readyToStart","classNameProperty","className","bypass","preserveScrollPosition","preserveScrollPositionOnPrependItems","measureItemsBatchSize","scrollableContainer","getScrollableContainer","getColumnsCount","getItemId","onItemFirstRender","onItemInitialRender","initialScrollPosition","onScrollPositionChange","initialState","getInitialItemState","onStateChange","rest","undefined","setItemsContainerRef","setRef","itemsContainer","internalRef","virtualScroller","_initialState","getInitialState","onRender","getState","setState","stateToRender","getItemKey","onItemKeysReset","usesAutogeneratedItemKeys","updateItemKeysForNewItems","getSetItemState","getOnItemHeightDidChange","classNamePassThrough","stylePassThrough","style","state","currentItems","itemStates","firstShownItemIndex","lastShownItemIndex","map","item","i","forwardRef","elementType","oneOfType","string","func","object","propTypes","arrayOf","any","isRequired","shape","current","number","bool","beforeItemsHeight","afterItemsHeight","itemHeights","columnsCount","verticalSpacing"],"sources":["../../source/react/VirtualScroller.js"],"sourcesContent":["import React, { useMemo, useLayoutEffect } from 'react'\r\nimport PropTypes from 'prop-types'\r\n\r\nimport useState from './useState.js'\r\nimport useVirtualScroller from './useVirtualScroller.js'\r\nimport useVirtualScrollerStartStop from './useVirtualScrollerStartStop.js'\r\nimport useInstanceMethods from './useInstanceMethods.js'\r\nimport useItemKeys from './useItemKeys.js'\r\nimport useSetItemState from './useSetItemState.js'\r\nimport useOnItemHeightDidChange from './useOnItemHeightDidChange.js'\r\nimport useSetNewItemsOnItemsPropertyChange from './useSetNewItemsOnItemsPropertyChange.js'\r\nimport useUpdateItemKeysOnItemsChange from './useUpdateItemKeysOnItemsChange.js'\r\nimport useValidateTableBodyItemsContainer from './useValidateTableBodyItemsContainer.js'\r\nimport useForwardedRef from './useForwardedRef.js'\r\nimport useClassName from './useClassName.js'\r\nimport useStyle from './useStyle.js'\r\n\r\nimport { warn } from '../utility/debug.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\nfunction VirtualScroller({\r\n\t// The following are `<VirtualScroller/>` properties.\r\n\t//\r\n\t// `as` property is deprecated, use `itemsContainerComponent` property instead.\r\n\tas,\r\n\titems: itemsProperty,\r\n\titemComponent: ItemComponent,\r\n\titemComponentProps,\r\n\titemsContainerComponent: ItemsContainerComponent,\r\n\titemsContainerComponentProps,\r\n\titemsContainerRef,\r\n\t// `estimatedItemHeight` property name is deprecated,\r\n\t// use `getEstimatedItemHeight` property instead.\r\n\testimatedItemHeight,\r\n\tgetEstimatedItemHeight,\r\n\tgetEstimatedVisibleItemRowsCount,\r\n\tgetEstimatedInterItemVerticalSpacing,\r\n\tonMount,\r\n\t// `tbody` property is deprecated.\r\n\t// Pass `as: \"tbody\"` property instead.\r\n\ttbody,\r\n\treadyToStart,\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\r\n\t// \"Rest\" properties that will be passed through to the `itemsContainerComponent`.\r\n\t...rest\r\n}, ref) {\r\n\t// Previously, `as` property was being used instead of `itemsContainerComponent`,\r\n\t// and the default `as` property value was a generic `<div/>`.\r\n\t// Starting from version `1.14.1`, it is recommended to explicitly specify the `itemsContainerComponent`.\r\n\t// The default `\"div\"` fallback value is just a legacy compatibility relic, and so is the `as` property.\r\n\tif (!ItemsContainerComponent) {\r\n\t\tItemsContainerComponent = as || 'div'\r\n\t}\r\n\r\n\t// It turns out that since May 2022, `useVirtualScroller()` hook completely ignored the `tbody` property.\r\n\t// Instead, it always derived `tbody` property value from `as` property value by comparing it to `\"tbody\"` string.\r\n\t// As a result, it seemed like the explicit passing of `tbody` property didn't really work as intended.\r\n\t// In the end, it was decided that perhaps `tbody` property value should always be derived from `as` property\r\n\t// without a developer having to manually specify it. So the `tbody` property was deprecated.\r\n\t// It still exists though for backwards compatibility with the older versions of the package.\r\n\tif (tbody === undefined) {\r\n\t\t// `tbody` should be somehow detected before any DOM Elements have been mounted.\r\n\t\t// This is because during Server-Side Render there's no DOM Elements tree at all.\r\n\t\t// And server-sider render result is required to be exactly the same as client-side render result.\r\n\t\t// This means that `tbody` detection for the purposes of getting the initial\r\n\t\t// `className` or `style` property values must not rely on any DOM Elements at all,\r\n\t\t// and should use some other means such as explicitly passing a `tbody: true` property\r\n\t\t// (as it used to be in the past) or detecting `<tbody/>` tag usage from the\r\n\t\t// `itemsContainerCompoent` property value.\r\n\t\ttbody = ItemsContainerComponent === 'tbody'\r\n\t}\r\n\r\n\t// List items \"container\" DOM Element reference.\r\n\tconst {\r\n\t\tsetRef: setItemsContainerRef,\r\n\t\tinternalRef: itemsContainer\r\n\t} = useForwardedRef(itemsContainerRef)\r\n\r\n\t// Create a `VirtualScroller` instance.\r\n\tconst virtualScroller = useVirtualScroller({\r\n\t\titems: itemsProperty,\r\n\t\t// `estimatedItemHeight` property name is deprecated,\r\n\t\t// use `getEstimatedItemHeight` property instead.\r\n\t\testimatedItemHeight,\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\titemsContainer\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\tuseVirtualScrollerStartStop(virtualScroller, { readyToStart })\r\n\r\n\t// List items are rendered with `key`s so that React doesn't\r\n\t// \"reuse\" `itemComponent`s in cases when `items` are changed.\r\n\tconst {\r\n\t\tgetItemKey,\r\n\t\tonItemKeysReset,\r\n\t\tusesAutogeneratedItemKeys,\r\n\t\tupdateItemKeysForNewItems\r\n\t} = useItemKeys({\r\n\t\tgetItemId\r\n\t})\r\n\r\n\t// Cache per-item `setItemState` functions' \"references\"\r\n\t// so that item components don't get re-rendered needlessly.\r\n\tconst getSetItemState = useSetItemState({\r\n\t\tgetItemKey,\r\n\t\tonItemKeysReset,\r\n\t\tvirtualScroller\r\n\t})\r\n\r\n\t// Cache per-item `onItemHeightDidChange` functions' \"references\"\r\n\t// so that item components don't get re-rendered needlessly.\r\n\tconst getOnItemHeightDidChange = useOnItemHeightDidChange({\r\n\t\tgetItemKey,\r\n\t\tonItemKeysReset,\r\n\t\tvirtualScroller\r\n\t})\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// Updates `key`s if item indexes have changed.\r\n\tuseUpdateItemKeysOnItemsChange(stateToRender.items, {\r\n\t\tvirtualScroller,\r\n\t\tusesAutogeneratedItemKeys,\r\n\t\tupdateItemKeysForNewItems\r\n\t})\r\n\r\n\t// Add instance methods to the React component.\r\n\tuseInstanceMethods(ref, {\r\n\t\tvirtualScroller\r\n\t})\r\n\r\n\tuseLayoutEffect(() => {\r\n\t\t// (deprecated)\r\n\t\t// `onMount()` option is deprecated due to no longer being used.\r\n\t\t// If someone thinks there's a valid use case for it, create an issue.\r\n\t\tif (onMount) {\r\n\t\t\twarn('`onMount` property is deprecated')\r\n\t\t\tonMount()\r\n\t\t}\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\t// `willRender()` function is no longer used.\r\n\t//\r\n\t// // `getSnapshotBeforeUpdate()` is called right before `componentDidUpdate()`.\r\n\t// // A hook equivalent/workaround for `getSnapshotBeforeUpdate()`:\r\n\t// // https://github.com/facebook/react/issues/15221#issuecomment-583448887\r\n\t// //\r\n\t// getSnapshotBeforeUpdate(prevProps, prevState) {\r\n\t// \tif (this.state !== prevState) {\r\n\t// \t\tthis.willRender(this.state, prevState)\r\n\t// \t}\r\n\t// \t// Returns `null` to avoid React warning:\r\n\t// \t// \"A snapshot value (or null) must be returned. You have returned undefined\".\r\n\t// \treturn null\r\n\t// }\r\n\r\n\tconst classNamePassThrough = classNameProperty || itemsContainerComponentProps && itemsContainerComponentProps.className\r\n\r\n\tconst className = useClassName(classNamePassThrough, {\r\n\t\ttbody\r\n\t})\r\n\r\n\tconst stylePassThrough = itemsContainerComponentProps && itemsContainerComponentProps.style\r\n\r\n\tconst style = useStyle(stylePassThrough, {\r\n\t\ttbody,\r\n\t\tstate: stateToRender\r\n\t})\r\n\r\n\tconst {\r\n\t\titems: currentItems,\r\n\t\titemStates,\r\n\t\tfirstShownItemIndex,\r\n\t\tlastShownItemIndex\r\n\t} = stateToRender\r\n\r\n\treturn (\r\n\t\t<ItemsContainerComponent\r\n\t\t\t{...itemsContainerComponentProps}\r\n\t\t\t{...rest}\r\n\t\t\tref={setItemsContainerRef}\r\n\t\t\tclassName={className}\r\n\t\t\tstyle={style}>\r\n\t\t\t{currentItems.map((item, i) => {\r\n\t\t\t\tif (i >= firstShownItemIndex && i <= lastShownItemIndex) {\r\n\t\t\t\t\t// * Passing the `item` as `children` property is legacy and is deprecated.\r\n\t\t\t\t\t//   If version `2.x` is published in some hypothetical future,\r\n\t\t\t\t\t//   the `item` property should be moved below `{...itemComponentProps}`.\r\n\t\t\t\t\t//\r\n\t\t\t\t\t// * Passing `itemIndex` property is legacy and is deprecated\r\n\t\t\t\t\t//   and could be removed in some future.\r\n\t\t\t\t\t//   The rationale for deprecation is that the `items` property\r\n\t\t\t\t\t//   is not constant and could change, in which case the `itemIndex` value\r\n\t\t\t\t\t//   would be of no use because the application wouldn't know\r\n\t\t\t\t\t//   which exact `items` it corresponds to at any given moment in time.\r\n\t\t\t\t\t//   Having just the `itemIndex` and no actual `item` is therefore considered useless.\r\n\t\t\t\t\t//   Instead, a developer could simply use `getItemKey(item)` function.\r\n\t\t\t\t\t//\r\n\t\t\t\t\t// * `onStateChange` property is passed here for legacy reasons.\r\n\t\t\t\t\t//   The new property name is `setState`.\r\n\t\t\t\t\t//   The old property name `onStateChange` is deprecated\r\n\t\t\t\t\t//   and could be removed in some future.\r\n\t\t\t\t\t//\r\n\t\t\t\t\t// * `onHeightChange` property is passed here for legacy reasons.\r\n\t\t\t\t\t//   The new property name is `onHeightDidChange`.\r\n\t\t\t\t\t//   The old property name `onHeightChange` is deprecated\r\n\t\t\t\t\t//   and could be removed in some future.\r\n\t\t\t\t\t//\r\n\t\t\t\t\treturn (\r\n\t\t\t\t\t\t<ItemComponent\r\n\t\t\t\t\t\t\titem={item}\r\n\t\t\t\t\t\t\titemIndex={i}\r\n\t\t\t\t\t\t\t{...itemComponentProps}\r\n\t\t\t\t\t\t\tkey={getItemKey(item, i)}\r\n\t\t\t\t\t\t\tstate={itemStates && itemStates[i]}\r\n\t\t\t\t\t\t\tsetState={getSetItemState(i)}\r\n\t\t\t\t\t\t\tonStateChange={getSetItemState(i)}\r\n\t\t\t\t\t\t\tonHeightChange={getOnItemHeightDidChange(i)}\r\n\t\t\t\t\t\t\tonHeightDidChange={getOnItemHeightDidChange(i)}>\r\n\t\t\t\t\t\t\t{item}\r\n\t\t\t\t\t\t</ItemComponent>\r\n\t\t\t\t\t)\r\n\t\t\t\t}\r\n\t\t\t\treturn null\r\n\t\t\t})}\r\n\t\t</ItemsContainerComponent>\r\n\t)\r\n}\r\n\r\nVirtualScroller = React.forwardRef(VirtualScroller)\r\n\r\nexport default VirtualScroller\r\n\r\n// `PropTypes.elementType` is available in some version of `prop-types`.\r\n// https://github.com/facebook/prop-types/issues/200\r\nconst elementType = PropTypes.elementType || PropTypes.oneOfType([\r\n\tPropTypes.string,\r\n\tPropTypes.func,\r\n\tPropTypes.object\r\n])\r\n\r\nVirtualScroller.propTypes = {\r\n\t// `as` property is deprecated, use `itemsContainerComponent` property instead.\r\n\tas: elementType,\r\n\titems: PropTypes.arrayOf(PropTypes.any).isRequired,\r\n\titemComponent: elementType.isRequired,\r\n\titemComponentProps: PropTypes.object,\r\n\t// `itemsContainerComponent` property is not required just for legacy compatibility reasons.\r\n\t// Any new applications should explicitly specify it.\r\n\titemsContainerComponent: elementType,\r\n\titemsContainerComponentProps: PropTypes.object,\r\n\titemsContainerRef: PropTypes.oneOfType([\r\n\t\tPropTypes.func,\r\n\t\tPropTypes.shape({ current: PropTypes.object })\r\n\t]),\r\n\t// `estimatedItemHeight` property name is deprecated,\r\n\t// use `getEstimatedItemHeight` property instead.\r\n\testimatedItemHeight: PropTypes.number,\r\n\tgetEstimatedItemHeight: PropTypes.func,\r\n\tgetEstimatedVisibleItemRowsCount: PropTypes.func,\r\n\tgetEstimatedInterItemVerticalSpacing: PropTypes.func,\r\n\tbypass: PropTypes.bool,\r\n\t// bypassBatchSize: PropTypes.number,\r\n\t// `tbody` property is deprecated.\r\n\t// Pass `as: \"tbody\"` property instead.\r\n\t// tbody: PropTypes.bool,\r\n\tpreserveScrollPositionOnPrependItems: PropTypes.bool,\r\n\t// `preserveScrollPosition` property name is deprecated,\r\n\t// use `preserveScrollPositionOnPrependItems` instead.\r\n\tpreserveScrollPosition: PropTypes.bool,\r\n\tmeasureItemsBatchSize: PropTypes.number,\r\n\t// `scrollableContainer` property is deprecated.\r\n\t// Use `getScrollableContainer()` property instead.\r\n\tscrollableContainer: PropTypes.any,\r\n\tgetScrollableContainer: PropTypes.func,\r\n\tgetColumnsCount: PropTypes.func,\r\n\tgetItemId: PropTypes.func,\r\n\tclassName: PropTypes.string,\r\n\treadyToStart: PropTypes.bool,\r\n\tonMount: PropTypes.func,\r\n\tonItemInitialRender: PropTypes.func,\r\n\t// `onItemFirstRender(i)` is deprecated, use `onItemInitialRender(item)` instead.\r\n\tonItemFirstRender: PropTypes.func,\r\n\tinitialScrollPosition: PropTypes.number,\r\n\tonScrollPositionChange: PropTypes.func,\r\n\tonStateChange: PropTypes.func,\r\n\tinitialState: PropTypes.shape({\r\n\t\titems: PropTypes.arrayOf(PropTypes.object).isRequired,\r\n\t\titemStates: PropTypes.arrayOf(PropTypes.any).isRequired,\r\n\t\tfirstShownItemIndex: PropTypes.number.isRequired,\r\n\t\tlastShownItemIndex: PropTypes.number.isRequired,\r\n\t\tbeforeItemsHeight: PropTypes.number.isRequired,\r\n\t\tafterItemsHeight: PropTypes.number.isRequired,\r\n\t\titemHeights: PropTypes.arrayOf(PropTypes.number).isRequired,\r\n\t\tcolumnsCount: PropTypes.number,\r\n\t\tverticalSpacing: PropTypes.number\r\n\t}),\r\n\tgetInitialItemState: PropTypes.func\r\n}\r\n"],"mappings":"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"}

package/modules/react/useClassName.js

@@ -1,4 +1,4 @@
-import { TBODY_CLASS_NAME } from '../DOM/tbody.js';
+import { CLASS_NAME_FOR_TBODY_WORKAROUND } from '../DOM/tbody.js';
 export default function useClassName(className, _ref) {
   var tbody = _ref.tbody;
 
@@ -7,10 +7,10 @@ export default function useClassName(className, _ref) {
   // See `addTbodyStyles()` function in `../DOM/tbody.js` for more details.
   if (tbody) {
     if (className) {
-      return className + ' ' + TBODY_CLASS_NAME;
+      return className + ' ' + CLASS_NAME_FOR_TBODY_WORKAROUND;
     }
 
-    return TBODY_CLASS_NAME;
+    return CLASS_NAME_FOR_TBODY_WORKAROUND;
   }
 
   return className;

package/modules/react/useClassName.js.map

@@ -1 +1 @@
-{"version":3,"file":"useClassName.js","names":["TBODY_CLASS_NAME","useClassName","className","tbody"],"sources":["../../source/react/useClassName.js"],"sourcesContent":["import { TBODY_CLASS_NAME } from '../DOM/tbody.js'\r\n\r\nexport default function useClassName(className, { tbody }) {\r\n\t// For `<tbody/>`, a workaround is used which uses CSS variables\r\n\t// and a special CSS class name \"VirtualScroller\".\r\n\t// See `addTbodyStyles()` function in `../DOM/tbody.js` for more details.\r\n\tif (tbody) {\r\n\t\tif (className) {\r\n\t\t\treturn className + ' ' + TBODY_CLASS_NAME\r\n\t\t}\r\n\t\treturn TBODY_CLASS_NAME\r\n\t}\r\n\treturn className\r\n}"],"mappings":"AAAA,SAASA,gBAAT,QAAiC,iBAAjC;AAEA,eAAe,SAASC,YAAT,CAAsBC,SAAtB,QAA4C;EAAA,IAATC,KAAS,QAATA,KAAS;;EAC1D;EACA;EACA;EACA,IAAIA,KAAJ,EAAW;IACV,IAAID,SAAJ,EAAe;MACd,OAAOA,SAAS,GAAG,GAAZ,GAAkBF,gBAAzB;IACA;;IACD,OAAOA,gBAAP;EACA;;EACD,OAAOE,SAAP;AACA"}
+{"version":3,"file":"useClassName.js","names":["CLASS_NAME_FOR_TBODY_WORKAROUND","useClassName","className","tbody"],"sources":["../../source/react/useClassName.js"],"sourcesContent":["import { CLASS_NAME_FOR_TBODY_WORKAROUND } from '../DOM/tbody.js'\r\n\r\nexport default function useClassName(className, { tbody }) {\r\n\t// For `<tbody/>`, a workaround is used which uses CSS variables\r\n\t// and a special CSS class name \"VirtualScroller\".\r\n\t// See `addTbodyStyles()` function in `../DOM/tbody.js` for more details.\r\n\tif (tbody) {\r\n\t\tif (className) {\r\n\t\t\treturn className + ' ' + CLASS_NAME_FOR_TBODY_WORKAROUND\r\n\t\t}\r\n\t\treturn CLASS_NAME_FOR_TBODY_WORKAROUND\r\n\t}\r\n\treturn className\r\n}"],"mappings":"AAAA,SAASA,+BAAT,QAAgD,iBAAhD;AAEA,eAAe,SAASC,YAAT,CAAsBC,SAAtB,QAA4C;EAAA,IAATC,KAAS,QAATA,KAAS;;EAC1D;EACA;EACA;EACA,IAAIA,KAAJ,EAAW;IACV,IAAID,SAAJ,EAAe;MACd,OAAOA,SAAS,GAAG,GAAZ,GAAkBF,+BAAzB;IACA;;IACD,OAAOA,+BAAP;EACA;;EACD,OAAOE,SAAP;AACA"}

package/modules/react/useForwardedRef.js

@@ -0,0 +1,42 @@
+// import type { MutableRefObject } from 'react'
+import { useCallback, useRef } from 'react'; // When a React component receives a `ref` which it is supposed to "forward"
+// and when it would like to also read that `ref` in its internal implementation,
+// this `useForwardedRef()` hook could be used to get read access to such "forwarded" ref
+// inside the component's internal implementation.
+//
+// ```js
+// const FormWithAutoFocus = forwardRef((props, ref) => {
+//   const { setRef, internalRef } = useForwardedRef<RefValueType>(ref)
+//
+//   useEffect(() => {
+//     internalRef.current.focus()
+//   }, [])
+//
+//   return (
+//     <Form ref={setRef} {...props}/>
+//   )
+// })
+// ```
+//
+// export default function useForwardedRef<T extends MutableRefObject<any>>(ref) {
+
+export default function useForwardedRef(ref) {
+  var internalRef = useRef(); // as T
+
+  var setRef = useCallback(function (instance) {
+    internalRef.current = instance;
+
+    if (ref) {
+      if (typeof ref === 'function') {
+        ref(instance);
+      } else {
+        ref.current = instance;
+      }
+    }
+  }, [ref]);
+  return {
+    setRef: setRef,
+    internalRef: internalRef
+  };
+}
+//# sourceMappingURL=useForwardedRef.js.map

package/modules/react/useForwardedRef.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useForwardedRef.js","names":["useCallback","useRef","useForwardedRef","ref","internalRef","setRef","instance","current"],"sources":["../../source/react/useForwardedRef.js"],"sourcesContent":["// import type { MutableRefObject } from 'react'\r\nimport { useCallback, useRef } from 'react'\r\n\r\n// When a React component receives a `ref` which it is supposed to \"forward\"\r\n// and when it would like to also read that `ref` in its internal implementation,\r\n// this `useForwardedRef()` hook could be used to get read access to such \"forwarded\" ref\r\n// inside the component's internal implementation.\r\n//\r\n// ```js\r\n// const FormWithAutoFocus = forwardRef((props, ref) => {\r\n//   const { setRef, internalRef } = useForwardedRef<RefValueType>(ref)\r\n//\r\n//   useEffect(() => {\r\n//     internalRef.current.focus()\r\n//   }, [])\r\n//\r\n//   return (\r\n//     <Form ref={setRef} {...props}/>\r\n//   )\r\n// })\r\n// ```\r\n//\r\n// export default function useForwardedRef<T extends MutableRefObject<any>>(ref) {\r\nexport default function useForwardedRef(ref) {\r\n\tconst internalRef = useRef() // as T\r\n\r\n\tconst setRef = useCallback((instance) => {\r\n\t\tinternalRef.current = instance\r\n\t\tif (ref) {\r\n\t\t\tif (typeof ref === 'function') {\r\n\t\t\t\tref(instance)\r\n\t\t\t} else {\r\n\t\t\t\tref.current = instance\r\n\t\t\t}\r\n\t\t}\r\n\t}, [ref])\r\n\r\n\treturn { setRef, internalRef }\r\n}\r\n"],"mappings":"AAAA;AACA,SAASA,WAAT,EAAsBC,MAAtB,QAAoC,OAApC,C,CAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AACA,eAAe,SAASC,eAAT,CAAyBC,GAAzB,EAA8B;EAC5C,IAAMC,WAAW,GAAGH,MAAM,EAA1B,CAD4C,CACf;;EAE7B,IAAMI,MAAM,GAAGL,WAAW,CAAC,UAACM,QAAD,EAAc;IACxCF,WAAW,CAACG,OAAZ,GAAsBD,QAAtB;;IACA,IAAIH,GAAJ,EAAS;MACR,IAAI,OAAOA,GAAP,KAAe,UAAnB,EAA+B;QAC9BA,GAAG,CAACG,QAAD,CAAH;MACA,CAFD,MAEO;QACNH,GAAG,CAACI,OAAJ,GAAcD,QAAd;MACA;IACD;EACD,CATyB,EASvB,CAACH,GAAD,CATuB,CAA1B;EAWA,OAAO;IAAEE,MAAM,EAANA,MAAF;IAAUD,WAAW,EAAXA;EAAV,CAAP;AACA"}

package/modules/react/useInstanceMethods.js

@@ -7,20 +7,20 @@ export default function useInstanceMethods(ref, _ref) {
     return {
       // This is a proxy for `VirtualScroller`'s `.updateLayout` instance method.
       updateLayout: function updateLayout() {
-        return virtualScroller.updateLayout();
+        virtualScroller.updateLayout();
       },
       // (deprecated)
       // `.layout()` method name is deprecated, use `.updateLayout()` instead.
       layout: function layout() {
-        return virtualScroller.updateLayout();
+        virtualScroller.updateLayout();
       },
       // (deprecated)
       updateItem: function updateItem(i) {
-        return reportError("[virtual-scroller] \".updateItem(i)\" method of React <VirtualScroller/> has been removed");
+        reportError("[virtual-scroller] \".updateItem(i)\" method of React <VirtualScroller/> has been removed");
       },
       // (deprecated)
       renderItem: function renderItem(i) {
-        return reportError("[virtual-scroller] \".renderItem(i)\" method of React <VirtualScroller/> has been removed");
+        reportError("[virtual-scroller] \".renderItem(i)\" method of React <VirtualScroller/> has been removed");
       }
     };
   }, [virtualScroller]);

package/modules/react/useInstanceMethods.js.map

@@ -1 +1 @@
-{"version":3,"file":"useInstanceMethods.js","names":["useImperativeHandle","reportError","useInstanceMethods","ref","virtualScroller","updateLayout","layout","updateItem","i","renderItem"],"sources":["../../source/react/useInstanceMethods.js"],"sourcesContent":["import { useImperativeHandle } from 'react'\r\n\r\nimport { reportError } from '../utility/debug.js'\r\n\r\n// Adds instance methods to the React component.\r\nexport default function useInstanceMethods(ref, {\r\n\tvirtualScroller\r\n}) {\r\n\tuseImperativeHandle(ref, () => ({\r\n\t\t// This is a proxy for `VirtualScroller`'s `.updateLayout` instance method.\r\n\t\tupdateLayout: () => virtualScroller.updateLayout(),\r\n\r\n\t\t// (deprecated)\r\n\t\t// `.layout()` method name is deprecated, use `.updateLayout()` instead.\r\n    layout: () => virtualScroller.updateLayout(),\r\n\r\n\t\t// (deprecated)\r\n\t\tupdateItem: (i) => reportError(`[virtual-scroller] \".updateItem(i)\" method of React <VirtualScroller/> has been removed`),\r\n\r\n\t\t// (deprecated)\r\n\t\trenderItem: (i) => reportError(`[virtual-scroller] \".renderItem(i)\" method of React <VirtualScroller/> has been removed`)\r\n\t}), [\r\n\t\tvirtualScroller\r\n\t])\r\n}"],"mappings":"AAAA,SAASA,mBAAT,QAAoC,OAApC;AAEA,SAASC,WAAT,QAA4B,qBAA5B,C,CAEA;;AACA,eAAe,SAASC,kBAAT,CAA4BC,GAA5B,QAEZ;EAAA,IADFC,eACE,QADFA,eACE;EACFJ,mBAAmB,CAACG,GAAD,EAAM;IAAA,OAAO;MAC/B;MACAE,YAAY,EAAE;QAAA,OAAMD,eAAe,CAACC,YAAhB,EAAN;MAAA,CAFiB;MAI/B;MACA;MACEC,MAAM,EAAE;QAAA,OAAMF,eAAe,CAACC,YAAhB,EAAN;MAAA,CANqB;MAQ/B;MACAE,UAAU,EAAE,oBAACC,CAAD;QAAA,OAAOP,WAAW,6FAAlB;MAAA,CATmB;MAW/B;MACAQ,UAAU,EAAE,oBAACD,CAAD;QAAA,OAAOP,WAAW,6FAAlB;MAAA;IAZmB,CAAP;EAAA,CAAN,EAaf,CACHG,eADG,CAbe,CAAnB;AAgBA"}
+{"version":3,"file":"useInstanceMethods.js","names":["useImperativeHandle","reportError","useInstanceMethods","ref","virtualScroller","updateLayout","layout","updateItem","i","renderItem"],"sources":["../../source/react/useInstanceMethods.js"],"sourcesContent":["import { useImperativeHandle } from 'react'\r\n\r\nimport { reportError } from '../utility/debug.js'\r\n\r\n// Adds instance methods to the React component.\r\nexport default function useInstanceMethods(ref, {\r\n\tvirtualScroller\r\n}) {\r\n\tuseImperativeHandle(ref, () => ({\r\n\t\t// This is a proxy for `VirtualScroller`'s `.updateLayout` instance method.\r\n\t\tupdateLayout: () => {\r\n\t\t\tvirtualScroller.updateLayout()\r\n\t\t},\r\n\r\n\t\t// (deprecated)\r\n\t\t// `.layout()` method name is deprecated, use `.updateLayout()` instead.\r\n    layout: () => {\r\n\t\t\tvirtualScroller.updateLayout()\r\n\t\t},\r\n\r\n\t\t// (deprecated)\r\n\t\tupdateItem: (i) => {\r\n\t\t\treportError(`[virtual-scroller] \".updateItem(i)\" method of React <VirtualScroller/> has been removed`)\r\n\t\t},\r\n\r\n\t\t// (deprecated)\r\n\t\trenderItem: (i) => {\r\n\t\t\treportError(`[virtual-scroller] \".renderItem(i)\" method of React <VirtualScroller/> has been removed`)\r\n\t\t}\r\n\t}), [\r\n\t\tvirtualScroller\r\n\t])\r\n}"],"mappings":"AAAA,SAASA,mBAAT,QAAoC,OAApC;AAEA,SAASC,WAAT,QAA4B,qBAA5B,C,CAEA;;AACA,eAAe,SAASC,kBAAT,CAA4BC,GAA5B,QAEZ;EAAA,IADFC,eACE,QADFA,eACE;EACFJ,mBAAmB,CAACG,GAAD,EAAM;IAAA,OAAO;MAC/B;MACAE,YAAY,EAAE,wBAAM;QACnBD,eAAe,CAACC,YAAhB;MACA,CAJ8B;MAM/B;MACA;MACEC,MAAM,EAAE,kBAAM;QACfF,eAAe,CAACC,YAAhB;MACA,CAV8B;MAY/B;MACAE,UAAU,EAAE,oBAACC,CAAD,EAAO;QAClBP,WAAW,6FAAX;MACA,CAf8B;MAiB/B;MACAQ,UAAU,EAAE,oBAACD,CAAD,EAAO;QAClBP,WAAW,6FAAX;MACA;IApB8B,CAAP;EAAA,CAAN,EAqBf,CACHG,eADG,CArBe,CAAnB;AAwBA"}

package/modules/react/useItemKeys.js

@@ -1,16 +1,38 @@
+function _createForOfIteratorHelperLoose(o, allowArrayLike) { var it = typeof Symbol !== "undefined" && o[Symbol.iterator] || o["@@iterator"]; if (it) return (it = it.call(o)).next.bind(it); if (Array.isArray(o) || (it = _unsupportedIterableToArray(o)) || allowArrayLike && o && typeof o.length === "number") { if (it) o = it; var i = 0; return function () { if (i >= o.length) return { done: true }; return { done: false, value: o[i++] }; }; } throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
+
+function _unsupportedIterableToArray(o, minLen) { if (!o) return; if (typeof o === "string") return _arrayLikeToArray(o, minLen); var n = Object.prototype.toString.call(o).slice(8, -1); if (n === "Object" && o.constructor) n = o.constructor.name; if (n === "Map" || n === "Set") return Array.from(o); if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _arrayLikeToArray(o, minLen); }
+
+function _arrayLikeToArray(arr, len) { if (len == null || len > arr.length) len = arr.length; for (var i = 0, arr2 = new Array(len); i < len; i++) { arr2[i] = arr[i]; } return arr2; }
+
 import log from '../utility/debug.js';
 import { useRef, useMemo, useCallback } from 'react';
 export default function useItemKeys(_ref) {
   var getItemId = _ref.getItemId;
-  // List items are rendered with `key`s so that React doesn't
+  // These "listeners" will be called in case the auto-generated item keys are reset
+  // due to the prefix counter number reaching its maximum allowed value.
+  var itemKeysResetEventListeners = useMemo(function () {
+    return [];
+  }, []); // Adds an "on item keys reset" listener.
+
+  var onItemKeysReset = useCallback(function (listener) {
+    itemKeysResetEventListeners.push(listener);
+  }, []); // List items are rendered with `key`s so that React doesn't
   // "reuse" `itemComponent`s in cases when `items` are changed.
-  var itemKeyPrefix = useRef(); // Generates a unique `key` prefix for list item components.
+
+  var itemKeyPrefix = useRef(); // When no `getItemId()` function is specified, it creates an item key
+  // from an auto-generated unique prefix and the item's index in the `items` array.
+  // This way, when the `items` change, their keys are also changed.
 
   var generateItemKeyPrefix = useMemo(function () {
     var counter = 0;
 
     function getNextCounter() {
       if (counter === Number.MAX_SAFE_INTEGER) {
+        for (var _iterator = _createForOfIteratorHelperLoose(itemKeysResetEventListeners), _step; !(_step = _iterator()).done;) {
+          var listener = _step.value;
+          listener();
+        }
+
         counter = 0;
       }
 
@@ -21,9 +43,9 @@ export default function useItemKeys(_ref) {
     return function () {
       itemKeyPrefix.current = String(getNextCounter());
     };
-  }, [itemKeyPrefix]);
+  }, [itemKeyPrefix, itemKeysResetEventListeners]);
   useMemo(function () {
-    // Generate an initial unique `key` prefix for list item components.
+    // Generate an initial unique `key` prefix for list items.
     generateItemKeyPrefix();
   }, []); // If `getItemId()` function is defined, then item `id`s are gonna be the item element `key`s.
 
@@ -43,13 +65,14 @@ export default function useItemKeys(_ref) {
 
   var getItemKey = useCallback(function (item, i) {
     if (getItemId) {
-      return getItemId(item);
+      return String(getItemId(item));
     }
 
     return "".concat(itemKeyPrefix.current, ":").concat(i);
   }, [getItemId, itemKeyPrefix]);
   return {
     getItemKey: getItemKey,
+    onItemKeysReset: onItemKeysReset,
     usesAutogeneratedItemKeys: usesAutogeneratedItemKeys,
     updateItemKeysForNewItems: generateItemKeyPrefixIfNotUsingItemIds
   };

package/modules/react/useItemKeys.js.map

@@ -1 +1 @@
-{"version":3,"file":"useItemKeys.js","names":["log","useRef","useMemo","useCallback","useItemKeys","getItemId","itemKeyPrefix","generateItemKeyPrefix","counter","getNextCounter","Number","MAX_SAFE_INTEGER","current","String","usesAutogeneratedItemKeys","generateItemKeyPrefixIfNotUsingItemIds","getItemKey","item","i","updateItemKeysForNewItems"],"sources":["../../source/react/useItemKeys.js"],"sourcesContent":["import log from '../utility/debug.js'\r\n\r\nimport { useRef, useMemo, useCallback } from 'react'\r\n\r\nexport default function useItemKeys({ getItemId }) {\r\n\t// List items are rendered with `key`s so that React doesn't\r\n\t// \"reuse\" `itemComponent`s in cases when `items` are changed.\r\n  const itemKeyPrefix = useRef()\r\n\r\n\t// Generates a unique `key` prefix for list item components.\r\n\tconst generateItemKeyPrefix = useMemo(() => {\r\n\t\tlet counter = 0\r\n\t\tfunction getNextCounter() {\r\n\t\t\tif (counter === Number.MAX_SAFE_INTEGER) {\r\n\t\t\t\tcounter = 0\r\n\t\t\t}\r\n\t\t\tcounter++\r\n\t\t\treturn counter\r\n\t\t}\r\n\t\treturn () => {\r\n\t\t\titemKeyPrefix.current = String(getNextCounter())\r\n\t\t}\r\n\t}, [\r\n\t\titemKeyPrefix\r\n\t])\r\n\r\n\tuseMemo(() => {\r\n\t\t// Generate an initial unique `key` prefix for list item components.\r\n\t\tgenerateItemKeyPrefix()\r\n\t}, [])\r\n\r\n\t// If `getItemId()` function is defined, then item `id`s are gonna be the item element `key`s.\r\n\tconst usesAutogeneratedItemKeys = !getItemId\r\n\r\n\tconst generateItemKeyPrefixIfNotUsingItemIds = useCallback(() => {\r\n\t\tif (usesAutogeneratedItemKeys) {\r\n\t\t\tgenerateItemKeyPrefix()\r\n\t\t\tlog('React: ~ Item key prefix:', itemKeyPrefix.current)\r\n\t\t}\r\n\t}, [\r\n\t\tusesAutogeneratedItemKeys,\r\n\t\tgenerateItemKeyPrefix\r\n\t])\r\n\r\n\t/**\r\n\t * Returns a `key` for an `item`'s element.\r\n\t * @param  {object} item — The item.\r\n\t * @param  {number} i — Item's index in `items` list.\r\n\t * @return {any}\r\n\t */\r\n\tconst getItemKey = useCallback((item, i) => {\r\n\t\tif (getItemId) {\r\n\t\t\treturn getItemId(item)\r\n\t\t}\r\n\t\treturn `${itemKeyPrefix.current}:${i}`\r\n\t}, [\r\n\t\tgetItemId,\r\n\t\titemKeyPrefix\r\n\t])\r\n\r\n\treturn {\r\n\t\tgetItemKey,\r\n\t\tusesAutogeneratedItemKeys,\r\n\t\tupdateItemKeysForNewItems: generateItemKeyPrefixIfNotUsingItemIds\r\n\t}\r\n}"],"mappings":"AAAA,OAAOA,GAAP,MAAgB,qBAAhB;AAEA,SAASC,MAAT,EAAiBC,OAAjB,EAA0BC,WAA1B,QAA6C,OAA7C;AAEA,eAAe,SAASC,WAAT,OAAoC;EAAA,IAAbC,SAAa,QAAbA,SAAa;EAClD;EACA;EACC,IAAMC,aAAa,GAAGL,MAAM,EAA5B,CAHiD,CAKlD;;EACA,IAAMM,qBAAqB,GAAGL,OAAO,CAAC,YAAM;IAC3C,IAAIM,OAAO,GAAG,CAAd;;IACA,SAASC,cAAT,GAA0B;MACzB,IAAID,OAAO,KAAKE,MAAM,CAACC,gBAAvB,EAAyC;QACxCH,OAAO,GAAG,CAAV;MACA;;MACDA,OAAO;MACP,OAAOA,OAAP;IACA;;IACD,OAAO,YAAM;MACZF,aAAa,CAACM,OAAd,GAAwBC,MAAM,CAACJ,cAAc,EAAf,CAA9B;IACA,CAFD;EAGA,CAZoC,EAYlC,CACFH,aADE,CAZkC,CAArC;EAgBAJ,OAAO,CAAC,YAAM;IACb;IACAK,qBAAqB;EACrB,CAHM,EAGJ,EAHI,CAAP,CAtBkD,CA2BlD;;EACA,IAAMO,yBAAyB,GAAG,CAACT,SAAnC;EAEA,IAAMU,sCAAsC,GAAGZ,WAAW,CAAC,YAAM;IAChE,IAAIW,yBAAJ,EAA+B;MAC9BP,qBAAqB;MACrBP,GAAG,CAAC,2BAAD,EAA8BM,aAAa,CAACM,OAA5C,CAAH;IACA;EACD,CALyD,EAKvD,CACFE,yBADE,EAEFP,qBAFE,CALuD,CAA1D;EAUA;AACD;AACA;AACA;AACA;AACA;;EACC,IAAMS,UAAU,GAAGb,WAAW,CAAC,UAACc,IAAD,EAAOC,CAAP,EAAa;IAC3C,IAAIb,SAAJ,EAAe;MACd,OAAOA,SAAS,CAACY,IAAD,CAAhB;IACA;;IACD,iBAAUX,aAAa,CAACM,OAAxB,cAAmCM,CAAnC;EACA,CAL6B,EAK3B,CACFb,SADE,EAEFC,aAFE,CAL2B,CAA9B;EAUA,OAAO;IACNU,UAAU,EAAVA,UADM;IAENF,yBAAyB,EAAzBA,yBAFM;IAGNK,yBAAyB,EAAEJ;EAHrB,CAAP;AAKA"}
+{"version":3,"file":"useItemKeys.js","names":["log","useRef","useMemo","useCallback","useItemKeys","getItemId","itemKeysResetEventListeners","onItemKeysReset","listener","push","itemKeyPrefix","generateItemKeyPrefix","counter","getNextCounter","Number","MAX_SAFE_INTEGER","current","String","usesAutogeneratedItemKeys","generateItemKeyPrefixIfNotUsingItemIds","getItemKey","item","i","updateItemKeysForNewItems"],"sources":["../../source/react/useItemKeys.js"],"sourcesContent":["import log from '../utility/debug.js'\r\n\r\nimport { useRef, useMemo, useCallback } from 'react'\r\n\r\nexport default function useItemKeys({ getItemId }) {\r\n\t// These \"listeners\" will be called in case the auto-generated item keys are reset\r\n\t// due to the prefix counter number reaching its maximum allowed value.\r\n\tconst itemKeysResetEventListeners = useMemo(() => {\r\n\t\treturn []\r\n\t}, [])\r\n\r\n\t// Adds an \"on item keys reset\" listener.\r\n\tconst onItemKeysReset = useCallback((listener) => {\r\n\t\titemKeysResetEventListeners.push(listener)\r\n\t}, [])\r\n\r\n\t// List items are rendered with `key`s so that React doesn't\r\n\t// \"reuse\" `itemComponent`s in cases when `items` are changed.\r\n  const itemKeyPrefix = useRef()\r\n\r\n\t// When no `getItemId()` function is specified, it creates an item key\r\n\t// from an auto-generated unique prefix and the item's index in the `items` array.\r\n\t// This way, when the `items` change, their keys are also changed.\r\n\tconst generateItemKeyPrefix = useMemo(() => {\r\n\t\tlet counter = 0\r\n\t\tfunction getNextCounter() {\r\n\t\t\tif (counter === Number.MAX_SAFE_INTEGER) {\r\n\t\t\t\tfor (const listener of itemKeysResetEventListeners) {\r\n\t\t\t\t\tlistener()\r\n\t\t\t\t}\r\n\t\t\t\tcounter = 0\r\n\t\t\t}\r\n\t\t\tcounter++\r\n\t\t\treturn counter\r\n\t\t}\r\n\t\treturn () => {\r\n\t\t\titemKeyPrefix.current = String(getNextCounter())\r\n\t\t}\r\n\t}, [\r\n\t\titemKeyPrefix,\r\n\t\titemKeysResetEventListeners\r\n\t])\r\n\r\n\tuseMemo(() => {\r\n\t\t// Generate an initial unique `key` prefix for list items.\r\n\t\tgenerateItemKeyPrefix()\r\n\t}, [])\r\n\r\n\t// If `getItemId()` function is defined, then item `id`s are gonna be the item element `key`s.\r\n\tconst usesAutogeneratedItemKeys = !getItemId\r\n\r\n\tconst generateItemKeyPrefixIfNotUsingItemIds = useCallback(() => {\r\n\t\tif (usesAutogeneratedItemKeys) {\r\n\t\t\tgenerateItemKeyPrefix()\r\n\t\t\tlog('React: ~ Item key prefix:', itemKeyPrefix.current)\r\n\t\t}\r\n\t}, [\r\n\t\tusesAutogeneratedItemKeys,\r\n\t\tgenerateItemKeyPrefix\r\n\t])\r\n\r\n\t/**\r\n\t * Returns a `key` for an `item`'s element.\r\n\t * @param  {object} item — The item.\r\n\t * @param  {number} i — Item's index in `items` list.\r\n\t * @return {any}\r\n\t */\r\n\tconst getItemKey = useCallback((item, i) => {\r\n\t\tif (getItemId) {\r\n\t\t\treturn String(getItemId(item))\r\n\t\t}\r\n\t\treturn `${itemKeyPrefix.current}:${i}`\r\n\t}, [\r\n\t\tgetItemId,\r\n\t\titemKeyPrefix\r\n\t])\r\n\r\n\treturn {\r\n\t\tgetItemKey,\r\n\t\tonItemKeysReset,\r\n\t\tusesAutogeneratedItemKeys,\r\n\t\tupdateItemKeysForNewItems: generateItemKeyPrefixIfNotUsingItemIds\r\n\t}\r\n}"],"mappings":";;;;;;AAAA,OAAOA,GAAP,MAAgB,qBAAhB;AAEA,SAASC,MAAT,EAAiBC,OAAjB,EAA0BC,WAA1B,QAA6C,OAA7C;AAEA,eAAe,SAASC,WAAT,OAAoC;EAAA,IAAbC,SAAa,QAAbA,SAAa;EAClD;EACA;EACA,IAAMC,2BAA2B,GAAGJ,OAAO,CAAC,YAAM;IACjD,OAAO,EAAP;EACA,CAF0C,EAExC,EAFwC,CAA3C,CAHkD,CAOlD;;EACA,IAAMK,eAAe,GAAGJ,WAAW,CAAC,UAACK,QAAD,EAAc;IACjDF,2BAA2B,CAACG,IAA5B,CAAiCD,QAAjC;EACA,CAFkC,EAEhC,EAFgC,CAAnC,CARkD,CAYlD;EACA;;EACC,IAAME,aAAa,GAAGT,MAAM,EAA5B,CAdiD,CAgBlD;EACA;EACA;;EACA,IAAMU,qBAAqB,GAAGT,OAAO,CAAC,YAAM;IAC3C,IAAIU,OAAO,GAAG,CAAd;;IACA,SAASC,cAAT,GAA0B;MACzB,IAAID,OAAO,KAAKE,MAAM,CAACC,gBAAvB,EAAyC;QACxC,qDAAuBT,2BAAvB,wCAAoD;UAAA,IAAzCE,QAAyC;UACnDA,QAAQ;QACR;;QACDI,OAAO,GAAG,CAAV;MACA;;MACDA,OAAO;MACP,OAAOA,OAAP;IACA;;IACD,OAAO,YAAM;MACZF,aAAa,CAACM,OAAd,GAAwBC,MAAM,CAACJ,cAAc,EAAf,CAA9B;IACA,CAFD;EAGA,CAfoC,EAelC,CACFH,aADE,EAEFJ,2BAFE,CAfkC,CAArC;EAoBAJ,OAAO,CAAC,YAAM;IACb;IACAS,qBAAqB;EACrB,CAHM,EAGJ,EAHI,CAAP,CAvCkD,CA4ClD;;EACA,IAAMO,yBAAyB,GAAG,CAACb,SAAnC;EAEA,IAAMc,sCAAsC,GAAGhB,WAAW,CAAC,YAAM;IAChE,IAAIe,yBAAJ,EAA+B;MAC9BP,qBAAqB;MACrBX,GAAG,CAAC,2BAAD,EAA8BU,aAAa,CAACM,OAA5C,CAAH;IACA;EACD,CALyD,EAKvD,CACFE,yBADE,EAEFP,qBAFE,CALuD,CAA1D;EAUA;AACD;AACA;AACA;AACA;AACA;;EACC,IAAMS,UAAU,GAAGjB,WAAW,CAAC,UAACkB,IAAD,EAAOC,CAAP,EAAa;IAC3C,IAAIjB,SAAJ,EAAe;MACd,OAAOY,MAAM,CAACZ,SAAS,CAACgB,IAAD,CAAV,CAAb;IACA;;IACD,iBAAUX,aAAa,CAACM,OAAxB,cAAmCM,CAAnC;EACA,CAL6B,EAK3B,CACFjB,SADE,EAEFK,aAFE,CAL2B,CAA9B;EAUA,OAAO;IACNU,UAAU,EAAVA,UADM;IAENb,eAAe,EAAfA,eAFM;IAGNW,yBAAyB,EAAzBA,yBAHM;IAINK,yBAAyB,EAAEJ;EAJrB,CAAP;AAMA"}