virtual-scroller 1.13.1 → 1.15.0

package/modules/VirtualScroller.state.js.map

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

package/modules/VirtualScroller.verticalSpacing.js

@@ -1,23 +1,55 @@
 import log from './utility/debug.js';
 import getVerticalSpacing from './getVerticalSpacing.js';
-export default function createVerticalSpacingHelpers() {
+import { DEFAULT_INTER_ITEM_VERTICAL_SPACING } from './Layout.defaults.js';
+export default function createVerticalSpacingHelpers(_ref) {
   var _this = this;
 
+  var getEstimatedInterItemVerticalSpacing = _ref.getEstimatedInterItemVerticalSpacing;
+
   // Bind to `this` in order to prevent bugs when this function is passed by reference
   // and then called with its `this` being unintentionally `window` resulting in
   // the `if` condition being "falsy".
   this.getVerticalSpacing = function () {
-    return _this.verticalSpacing || 0;
+    var verticalSpacing = _this.verticalSpacing;
+
+    if (typeof verticalSpacing === 'number') {
+      return verticalSpacing;
+    }
+
+    return _this.getEstimatedInterItemVerticalSpacing();
   };
 
   this.getVerticalSpacingBeforeResize = function () {
-    // `beforeResize.verticalSpacing` can be `undefined`.
-    // For example, if `this.updateState({ verticalSpacing })` call hasn't been applied
-    // before the resize happened (in case of an "asynchronous" state update).
     var _this$getState = _this.getState(),
         beforeResize = _this$getState.beforeResize;
 
-    return beforeResize && beforeResize.verticalSpacing || 0;
+    if (beforeResize) {
+      var verticalSpacing = beforeResize.verticalSpacing; // `beforeResize.verticalSpacing` can be `undefined`.
+      // For example, if `this.updateState({ verticalSpacing })` call hasn't been applied
+      // before the resize happened (in case of an "asynchronous" state update).
+
+      if (typeof verticalSpacing === 'number') {
+        return verticalSpacing;
+      }
+
+      return _this.getEstimatedInterItemVerticalSpacing();
+    }
+  };
+
+  this.getEstimatedInterItemVerticalSpacing = function () {
+    if (getEstimatedInterItemVerticalSpacing) {
+      var estimatedVerticalSpacing = getEstimatedInterItemVerticalSpacing();
+
+      if (typeof estimatedVerticalSpacing === 'number') {
+        return estimatedVerticalSpacing;
+      }
+
+      throw new Error('[virtual-scroller] `getEstimatedInterItemVerticalSpacing()` must return a number');
+    } // `DEFAULT_INTER_ITEM_VERTICAL_SPACING` will be used in server-side render
+    // unless `getEstimatedInterItemVerticalSpacing()` parameter is specified.
+
+
+    return DEFAULT_INTER_ITEM_VERTICAL_SPACING;
   };
   /**
    * Measures item vertical spacing, if not measured.

package/modules/VirtualScroller.verticalSpacing.js.map

@@ -1 +1 @@
-{"version":3,"file":"VirtualScroller.verticalSpacing.js","names":["log","getVerticalSpacing","createVerticalSpacingHelpers","verticalSpacing","getVerticalSpacingBeforeResize","getState","beforeResize","measureVerticalSpacingIfNotMeasured","undefined","measureVerticalSpacing","call","firstShownItemIndex","lastShownItemIndex","itemsContainer","renderedItemsCount"],"sources":["../source/VirtualScroller.verticalSpacing.js"],"sourcesContent":["import log from './utility/debug.js'\r\nimport getVerticalSpacing from './getVerticalSpacing.js'\r\n\r\nexport default function createVerticalSpacingHelpers() {\r\n\t// Bind to `this` in order to prevent bugs when this function is passed by reference\r\n\t// and then called with its `this` being unintentionally `window` resulting in\r\n\t// the `if` condition being \"falsy\".\r\n\tthis.getVerticalSpacing = () => {\r\n\t\treturn this.verticalSpacing || 0\r\n\t}\r\n\r\n\tthis.getVerticalSpacingBeforeResize = () => {\r\n\t\t// `beforeResize.verticalSpacing` can be `undefined`.\r\n\t\t// For example, if `this.updateState({ verticalSpacing })` call hasn't been applied\r\n\t\t// before the resize happened (in case of an \"asynchronous\" state update).\r\n\t\tconst { beforeResize } = this.getState()\r\n\t\treturn beforeResize && beforeResize.verticalSpacing || 0\r\n\t}\r\n\r\n\t/**\r\n\t * Measures item vertical spacing, if not measured.\r\n\t * @return {object} [stateUpdate]\r\n\t */\r\n\tthis.measureVerticalSpacingIfNotMeasured = () => {\r\n\t\tif (this.verticalSpacing === undefined) {\r\n\t\t\tthis.verticalSpacing = measureVerticalSpacing.call(this)\r\n\t\t\treturn this.verticalSpacing\r\n\t\t}\r\n\t}\r\n\r\n\tfunction measureVerticalSpacing() {\r\n\t\tconst {\r\n\t\t\tfirstShownItemIndex,\r\n\t\t\tlastShownItemIndex\r\n\t\t} = this.getState()\r\n\r\n\t\tlog('~ Measure item vertical spacing ~')\r\n\r\n\t\tconst verticalSpacing = getVerticalSpacing({\r\n\t\t\titemsContainer: this.itemsContainer,\r\n\t\t\trenderedItemsCount: lastShownItemIndex - firstShownItemIndex + 1\r\n\t\t})\r\n\r\n\t\tif (verticalSpacing === undefined) {\r\n\t\t\tlog('Not enough items rendered to measure vertical spacing')\r\n\t\t} else {\r\n\t\t\tlog('Item vertical spacing', verticalSpacing)\r\n\t\t\treturn verticalSpacing\r\n\t\t}\r\n\t}\r\n}"],"mappings":"AAAA,OAAOA,GAAP,MAAgB,oBAAhB;AACA,OAAOC,kBAAP,MAA+B,yBAA/B;AAEA,eAAe,SAASC,4BAAT,GAAwC;EAAA;;EACtD;EACA;EACA;EACA,KAAKD,kBAAL,GAA0B,YAAM;IAC/B,OAAO,KAAI,CAACE,eAAL,IAAwB,CAA/B;EACA,CAFD;;EAIA,KAAKC,8BAAL,GAAsC,YAAM;IAC3C;IACA;IACA;IACA,qBAAyB,KAAI,CAACC,QAAL,EAAzB;IAAA,IAAQC,YAAR,kBAAQA,YAAR;;IACA,OAAOA,YAAY,IAAIA,YAAY,CAACH,eAA7B,IAAgD,CAAvD;EACA,CAND;EAQA;AACD;AACA;AACA;;;EACC,KAAKI,mCAAL,GAA2C,YAAM;IAChD,IAAI,KAAI,CAACJ,eAAL,KAAyBK,SAA7B,EAAwC;MACvC,KAAI,CAACL,eAAL,GAAuBM,sBAAsB,CAACC,IAAvB,CAA4B,KAA5B,CAAvB;MACA,OAAO,KAAI,CAACP,eAAZ;IACA;EACD,CALD;;EAOA,SAASM,sBAAT,GAAkC;IACjC,sBAGI,KAAKJ,QAAL,EAHJ;IAAA,IACCM,mBADD,mBACCA,mBADD;IAAA,IAECC,kBAFD,mBAECA,kBAFD;;IAKAZ,GAAG,CAAC,mCAAD,CAAH;IAEA,IAAMG,eAAe,GAAGF,kBAAkB,CAAC;MAC1CY,cAAc,EAAE,KAAKA,cADqB;MAE1CC,kBAAkB,EAAEF,kBAAkB,GAAGD,mBAArB,GAA2C;IAFrB,CAAD,CAA1C;;IAKA,IAAIR,eAAe,KAAKK,SAAxB,EAAmC;MAClCR,GAAG,CAAC,uDAAD,CAAH;IACA,CAFD,MAEO;MACNA,GAAG,CAAC,uBAAD,EAA0BG,eAA1B,CAAH;MACA,OAAOA,eAAP;IACA;EACD;AACD"}
+{"version":3,"file":"VirtualScroller.verticalSpacing.js","names":["log","getVerticalSpacing","DEFAULT_INTER_ITEM_VERTICAL_SPACING","createVerticalSpacingHelpers","getEstimatedInterItemVerticalSpacing","verticalSpacing","getVerticalSpacingBeforeResize","getState","beforeResize","estimatedVerticalSpacing","Error","measureVerticalSpacingIfNotMeasured","undefined","measureVerticalSpacing","call","firstShownItemIndex","lastShownItemIndex","itemsContainer","renderedItemsCount"],"sources":["../source/VirtualScroller.verticalSpacing.js"],"sourcesContent":["import log from './utility/debug.js'\r\nimport getVerticalSpacing from './getVerticalSpacing.js'\r\nimport { DEFAULT_INTER_ITEM_VERTICAL_SPACING } from './Layout.defaults.js'\r\n\r\nexport default function createVerticalSpacingHelpers({\r\n\tgetEstimatedInterItemVerticalSpacing\r\n}) {\r\n\t// Bind to `this` in order to prevent bugs when this function is passed by reference\r\n\t// and then called with its `this` being unintentionally `window` resulting in\r\n\t// the `if` condition being \"falsy\".\r\n\tthis.getVerticalSpacing = () => {\r\n\t\tconst { verticalSpacing } = this\r\n\t\tif (typeof verticalSpacing === 'number') {\r\n\t\t\treturn verticalSpacing\r\n\t\t}\r\n\t\treturn this.getEstimatedInterItemVerticalSpacing()\r\n\t}\r\n\r\n\tthis.getVerticalSpacingBeforeResize = () => {\r\n\t\tconst { beforeResize } = this.getState()\r\n\t\tif (beforeResize) {\r\n\t\t\tconst { verticalSpacing } = beforeResize\r\n\t\t\t// `beforeResize.verticalSpacing` can be `undefined`.\r\n\t\t\t// For example, if `this.updateState({ verticalSpacing })` call hasn't been applied\r\n\t\t\t// before the resize happened (in case of an \"asynchronous\" state update).\r\n\t\t\tif (typeof verticalSpacing === 'number') {\r\n\t\t\t\treturn verticalSpacing\r\n\t\t\t}\r\n\t\t\treturn this.getEstimatedInterItemVerticalSpacing()\r\n\t\t}\r\n\t}\r\n\r\n\tthis.getEstimatedInterItemVerticalSpacing = () => {\r\n\t\tif (getEstimatedInterItemVerticalSpacing) {\r\n\t\t\tconst estimatedVerticalSpacing = getEstimatedInterItemVerticalSpacing()\r\n\t\t\tif (typeof estimatedVerticalSpacing === 'number') {\r\n\t\t\t\treturn estimatedVerticalSpacing\r\n\t\t\t}\r\n\t\t\tthrow new Error('[virtual-scroller] `getEstimatedInterItemVerticalSpacing()` must return a number')\r\n\t\t}\r\n\t\t// `DEFAULT_INTER_ITEM_VERTICAL_SPACING` will be used in server-side render\r\n\t\t// unless `getEstimatedInterItemVerticalSpacing()` parameter is specified.\r\n\t\treturn DEFAULT_INTER_ITEM_VERTICAL_SPACING\r\n\t}\r\n\r\n\t/**\r\n\t * Measures item vertical spacing, if not measured.\r\n\t * @return {object} [stateUpdate]\r\n\t */\r\n\tthis.measureVerticalSpacingIfNotMeasured = () => {\r\n\t\tif (this.verticalSpacing === undefined) {\r\n\t\t\tthis.verticalSpacing = measureVerticalSpacing.call(this)\r\n\t\t\treturn this.verticalSpacing\r\n\t\t}\r\n\t}\r\n\r\n\tfunction measureVerticalSpacing() {\r\n\t\tconst {\r\n\t\t\tfirstShownItemIndex,\r\n\t\t\tlastShownItemIndex\r\n\t\t} = this.getState()\r\n\r\n\t\tlog('~ Measure item vertical spacing ~')\r\n\r\n\t\tconst verticalSpacing = getVerticalSpacing({\r\n\t\t\titemsContainer: this.itemsContainer,\r\n\t\t\trenderedItemsCount: lastShownItemIndex - firstShownItemIndex + 1\r\n\t\t})\r\n\r\n\t\tif (verticalSpacing === undefined) {\r\n\t\t\tlog('Not enough items rendered to measure vertical spacing')\r\n\t\t} else {\r\n\t\t\tlog('Item vertical spacing', verticalSpacing)\r\n\t\t\treturn verticalSpacing\r\n\t\t}\r\n\t}\r\n}"],"mappings":"AAAA,OAAOA,GAAP,MAAgB,oBAAhB;AACA,OAAOC,kBAAP,MAA+B,yBAA/B;AACA,SAASC,mCAAT,QAAoD,sBAApD;AAEA,eAAe,SAASC,4BAAT,OAEZ;EAAA;;EAAA,IADFC,oCACE,QADFA,oCACE;;EACF;EACA;EACA;EACA,KAAKH,kBAAL,GAA0B,YAAM;IAC/B,IAAQI,eAAR,GAA4B,KAA5B,CAAQA,eAAR;;IACA,IAAI,OAAOA,eAAP,KAA2B,QAA/B,EAAyC;MACxC,OAAOA,eAAP;IACA;;IACD,OAAO,KAAI,CAACD,oCAAL,EAAP;EACA,CAND;;EAQA,KAAKE,8BAAL,GAAsC,YAAM;IAC3C,qBAAyB,KAAI,CAACC,QAAL,EAAzB;IAAA,IAAQC,YAAR,kBAAQA,YAAR;;IACA,IAAIA,YAAJ,EAAkB;MACjB,IAAQH,eAAR,GAA4BG,YAA5B,CAAQH,eAAR,CADiB,CAEjB;MACA;MACA;;MACA,IAAI,OAAOA,eAAP,KAA2B,QAA/B,EAAyC;QACxC,OAAOA,eAAP;MACA;;MACD,OAAO,KAAI,CAACD,oCAAL,EAAP;IACA;EACD,CAZD;;EAcA,KAAKA,oCAAL,GAA4C,YAAM;IACjD,IAAIA,oCAAJ,EAA0C;MACzC,IAAMK,wBAAwB,GAAGL,oCAAoC,EAArE;;MACA,IAAI,OAAOK,wBAAP,KAAoC,QAAxC,EAAkD;QACjD,OAAOA,wBAAP;MACA;;MACD,MAAM,IAAIC,KAAJ,CAAU,kFAAV,CAAN;IACA,CAPgD,CAQjD;IACA;;;IACA,OAAOR,mCAAP;EACA,CAXD;EAaA;AACD;AACA;AACA;;;EACC,KAAKS,mCAAL,GAA2C,YAAM;IAChD,IAAI,KAAI,CAACN,eAAL,KAAyBO,SAA7B,EAAwC;MACvC,KAAI,CAACP,eAAL,GAAuBQ,sBAAsB,CAACC,IAAvB,CAA4B,KAA5B,CAAvB;MACA,OAAO,KAAI,CAACT,eAAZ;IACA;EACD,CALD;;EAOA,SAASQ,sBAAT,GAAkC;IACjC,sBAGI,KAAKN,QAAL,EAHJ;IAAA,IACCQ,mBADD,mBACCA,mBADD;IAAA,IAECC,kBAFD,mBAECA,kBAFD;;IAKAhB,GAAG,CAAC,mCAAD,CAAH;IAEA,IAAMK,eAAe,GAAGJ,kBAAkB,CAAC;MAC1CgB,cAAc,EAAE,KAAKA,cADqB;MAE1CC,kBAAkB,EAAEF,kBAAkB,GAAGD,mBAArB,GAA2C;IAFrB,CAAD,CAA1C;;IAKA,IAAIV,eAAe,KAAKO,SAAxB,EAAmC;MAClCZ,GAAG,CAAC,uDAAD,CAAH;IACA,CAFD,MAEO;MACNA,GAAG,CAAC,uBAAD,EAA0BK,eAA1B,CAAH;MACA,OAAOA,eAAP;IACA;EACD;AACD"}

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,20 +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);
 
-  // List items "container" DOM Element reference.
-  var container = useRef(); // Create a `VirtualScroller` instance.
+  // 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` 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 _useForwardedRef = useForwardedRef(itemsContainerRef),
+      setItemsContainerRef = _useForwardedRef.setRef,
+      itemsContainer = _useForwardedRef.internalRef; // Create a `VirtualScroller` instance.
+
 
   var virtualScroller = useVirtualScroller({
     items: itemsProperty,
@@ -70,9 +104,9 @@ function VirtualScroller(_ref, ref) {
     estimatedItemHeight: estimatedItemHeight,
     getEstimatedItemHeight: getEstimatedItemHeight,
     getEstimatedVisibleItemRowsCount: getEstimatedVisibleItemRowsCount,
+    getEstimatedInterItemVerticalSpacing: getEstimatedInterItemVerticalSpacing,
     bypass: bypass,
     // bypassBatchSize,
-    tbody: tbody,
     onItemInitialRender: onItemInitialRender,
     // `onItemFirstRender(i)` is deprecated, use `onItemInitialRender(item)` instead.
     onItemFirstRender: onItemFirstRender,
@@ -85,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 () {
@@ -101,8 +134,7 @@ function VirtualScroller(_ref, ref) {
 
   var _useState = useState({
     initialState: _initialState,
-    onRender: virtualScroller.onRender,
-    itemsProperty: itemsProperty
+    onRender: virtualScroller.onRender
   }),
       getState = _useState.getState,
       setState = _useState.setState,
@@ -126,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.
 
@@ -167,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()`:
@@ -182,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
   });
@@ -193,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, {
@@ -241,18 +289,29 @@ 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: PropTypes.bool,
+  // `tbody` property is deprecated.
+  // Pass `as: "tbody"` property instead.
+  // tbody: PropTypes.bool,
   preserveScrollPositionOnPrependItems: PropTypes.bool,
   // `preserveScrollPosition` property name is deprecated,
   // use `preserveScrollPositionOnPrependItems` instead.

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","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\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// 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\ttbody,\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\titemsProperty\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\ttbody: 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;