virtual-scroller 1.10.0 → 1.10.2

package/modules/VirtualScroller.constructor.js.map

@@ -1 +1 @@
-{"version":3,"file":"VirtualScroller.constructor.js","names":["supportsTbody","BROWSER_NOT_SUPPORTED_ERROR","DOMEngine","Layout","LAYOUT_REASON","Resize","BeforeResize","Scroll","ListHeightMeasurement","ItemHeights","log","warn","isDebug","reportError","createStateHelpers","createVerticalSpacingHelpers","createColumnsHelpers","createLayoutHelpers","createOnRenderHelpers","createResizeHelpers","createItemsHelpers","VirtualScrollerConstructor","getItemsContainerElement","items","options","render","state","onStateChange","initialScrollPosition","onScrollPositionChange","scrollableContainer","measureItemsBatchSize","getColumnsCount","getItemId","tbody","estimatedItemHeight","onItemInitialRender","onItemFirstRender","_useTimeoutInRenderLoop","_waitForScrollingToStop","engine","bypass","getScrollableContainer","getState","setState","Error","isItemEqual","a","b","item","i","indexOf","length","call","createHelpers","waitForScrollingToStop","itemHeights","readItemHeightsFromState","beforeResize","initializeFromState","itemsContainer","createItemsContainer","clear","createScrollableContainer","container","getItemHeight","setItemHeight","height","layout","getPrerenderMargin","getVerticalSpacing","getVerticalSpacingBeforeResize","getColumnsCountBeforeResize","columnsCount","getItemHeightBeforeResize","getBeforeResizeItemsCount","getAverageItemHeight","getAverage","getMaxVisibleAreaHeight","getHeight","getPreviouslyCalculatedLayout","previouslyCalculatedLayout","resize","getWidth","listenForResize","listener","onResize","onResizeStart","_isResizing","onResizeStop","undefined","onNoChange","onUpdateShownItemIndexes","reason","VIEWPORT_SIZE_UNCHANGED","onHeightChange","VIEWPORT_HEIGHT_CHANGED","onWidthChange","prevWidth","newWidth","scroll","onScroll","delayed","STOPPED_SCROLLING","SCROLL","isImmediateLayoutScheduled","Boolean","layoutTimer","hasNonRenderedItemsAtTheTop","firstShownItemIndex","hasNonRenderedItemsAtTheBottom","lastShownItemIndex","getItemsCount","getLatestLayoutVisibleArea","latestLayoutVisibleArea","getListTopOffset","getListTopOffsetInsideScrollableContainer","listHeightMeasurement","watchListTopOffset","listTopOffsetWatcher","onListTopOffsetChange","TOP_OFFSET_CHANGED"],"sources":["../source/VirtualScroller.constructor.js"],"sourcesContent":["import {\r\n\tsupportsTbody,\r\n\tBROWSER_NOT_SUPPORTED_ERROR\r\n} from './DOM/tbody.js'\r\n\r\nimport DOMEngine from './DOM/Engine.js'\r\n\r\nimport Layout, { LAYOUT_REASON } from './Layout.js'\r\nimport Resize from './Resize.js'\r\nimport BeforeResize from './BeforeResize.js'\r\nimport Scroll from './Scroll.js'\r\nimport ListHeightMeasurement from './ListHeightMeasurement.js'\r\nimport ItemHeights from './ItemHeights.js'\r\n\r\nimport log, { warn, isDebug, reportError } from './utility/debug.js'\r\n\r\nimport createStateHelpers from './VirtualScroller.state.js'\r\nimport createVerticalSpacingHelpers from './VirtualScroller.verticalSpacing.js'\r\nimport createColumnsHelpers from './VirtualScroller.columns.js'\r\nimport createLayoutHelpers from './VirtualScroller.layout.js'\r\nimport createOnRenderHelpers from './VirtualScroller.onRender.js'\r\nimport createResizeHelpers from './VirtualScroller.resize.js'\r\nimport createItemsHelpers from './VirtualScroller.items.js'\r\n\r\n/**\r\n * @param  {function} getItemsContainerElement — Returns the container DOM `Element`.\r\n * @param  {any[]} items — The list of items.\r\n * @param  {Object} [options] — See README.md.\r\n * @return {VirtualScroller}\r\n */\r\nexport default function VirtualScrollerConstructor(\r\n\tgetItemsContainerElement,\r\n\titems,\r\n\toptions = {}\r\n) {\r\n\tconst {\r\n\t\trender,\r\n\t\tstate,\r\n\t\tonStateChange,\r\n\t\tinitialScrollPosition,\r\n\t\tonScrollPositionChange,\r\n\t\t// `scrollableContainer` option is deprecated.\r\n\t\t// Use `getScrollableContainer()` option instead.\r\n\t\tscrollableContainer,\r\n\t\tmeasureItemsBatchSize = 50,\r\n\t\tgetColumnsCount,\r\n\t\tgetItemId,\r\n\t\ttbody,\r\n\t\testimatedItemHeight,\r\n\t\tonItemInitialRender,\r\n\t\t// `onItemFirstRender(i)` is deprecated, use `onItemInitialRender(item)` instead.\r\n\t\tonItemFirstRender,\r\n\t\t_useTimeoutInRenderLoop,\r\n\t\t_waitForScrollingToStop,\r\n\t\tengine\r\n\t} = options\r\n\r\n\tlet {\r\n\t\tbypass,\r\n\t\tgetScrollableContainer\r\n\t} = options\r\n\r\n\tlog('~ Initialize ~')\r\n\r\n\t// Could support non-DOM rendering engines.\r\n\t// For example, React Native, `<canvas/>`, etc.\r\n\tthis.engine = engine || DOMEngine\r\n\r\n\t// `scrollableContainer` option is deprecated.\r\n\t// Use `getScrollableContainer()` option instead.\r\n\tif (!getScrollableContainer && scrollableContainer) {\r\n\t\tgetScrollableContainer = () => scrollableContainer\r\n\t}\r\n\r\n\t// Sometimes, when `new VirtualScroller()` instance is created,\r\n\t// `getItemsContainerElement()` might not be ready to return the \"container\" DOM Element yet\r\n\t// (for example, because it's not rendered yet). That's the reason why it's a getter function.\r\n\t// For example, in React `<VirtualScroller/>` component, a `VirtualScroller`\r\n\t// instance is created in the React component's `constructor()`, and at that time\r\n\t// the container Element is not yet available. The container Element is available\r\n\t// in `componentDidMount()`, but `componentDidMount()` is not executed on server,\r\n\t// which would mean that React `<VirtualScroller/>` wouldn't render at all\r\n\t// on server side, while with the `getItemsContainerElement()` approach, on server side,\r\n\t// it still \"renders\" a list with a predefined amount of items in it by default.\r\n\t// (`initiallyRenderedItemsCount`, or `1`).\r\n\tthis.getItemsContainerElement = getItemsContainerElement\r\n\r\n\t// if (prerenderMargin === undefined) {\r\n\t// \t// Renders items which are outside of the screen by this \"prerender margin\".\r\n\t// \t// Is the screen height by default: seems to be the optimal value\r\n\t// \t// for \"Page Up\" / \"Page Down\" navigation and optimized mouse wheel scrolling.\r\n\t// \tprerenderMargin = this.scrollableContainer ? this.scrollableContainer.getHeight() : 0\r\n\t// }\r\n\r\n\tif (options.getState || options.setState) {\r\n\t\tthrow new Error('[virtual-scroller] `getState`/`setState` options usage has changed in the new version. See the readme for more details.')\r\n\t}\r\n\r\n\t// Work around `<tbody/>` not being able to have `padding`.\r\n\t// https://gitlab.com/catamphetamine/virtual-scroller/-/issues/1\r\n\tif (tbody) {\r\n\t\tif (this.engine !== DOMEngine) {\r\n\t\t\tthrow new Error('[virtual-scroller] `tbody` option is only supported for DOM rendering engine')\r\n\t\t}\r\n\t\tlog('~ <tbody/> detected ~')\r\n\t\tthis.tbody = true\r\n\t\tif (!supportsTbody()) {\r\n\t\t\tlog('~ <tbody/> not supported ~')\r\n\t\t\treportError(BROWSER_NOT_SUPPORTED_ERROR)\r\n\t\t\tbypass = true\r\n\t\t}\r\n\t}\r\n\r\n\tif (bypass) {\r\n\t\tlog('~ \"bypass\" mode ~')\r\n\t}\r\n\r\n\t// In `bypass` mode, `VirtualScroller` doesn't wait\r\n\t// for the user to scroll down to render all items:\r\n\t// instead, it renders all items right away, as if\r\n\t// the list is rendered without using `VirtualScroller`.\r\n\t// It was added just to measure how much is the\r\n\t// performance difference between using a `VirtualScroller`\r\n\t// and not using a `VirtualScroller`.\r\n\t// It turned out that unmounting large React component trees\r\n\t// is a very long process, so `VirtualScroller` does seem to\r\n\t// make sense when used in a React application.\r\n\tthis.bypass = bypass\r\n\t// this.bypassBatchSize = bypassBatchSize || 10\r\n\r\n\t// Using `setTimeout()` in render loop is a workaround\r\n\t// for avoiding a React error message:\r\n\t// \"Maximum update depth exceeded.\r\n\t//  This can happen when a component repeatedly calls\r\n\t//  `.setState()` inside `componentWillUpdate()` or `componentDidUpdate()`.\r\n\t//  React limits the number of nested updates to prevent infinite loops.\"\r\n\tthis._useTimeoutInRenderLoop = _useTimeoutInRenderLoop\r\n\r\n\tif (getItemId) {\r\n\t\tthis.isItemEqual = (a, b) => getItemId(a) === getItemId(b)\r\n\t} else {\r\n\t\tthis.isItemEqual = (a, b) => a === b\r\n\t}\r\n\r\n\tif (onItemInitialRender) {\r\n\t\tthis.onItemInitialRender = onItemInitialRender\r\n\t}\r\n\t// `onItemFirstRender(i)` is deprecated, use `onItemInitialRender(item)` instead.\r\n\telse if (onItemFirstRender) {\r\n\t\tthis.onItemInitialRender = (item) => {\r\n\t\t\twarn('`onItemFirstRender(i)` is deprecated, use `onItemInitialRender(item)` instead.')\r\n\t\t\tconst { items } = this.getState()\r\n\t\t\tconst i = items.indexOf(item)\r\n\t\t\t// The `item` could also be non-found due to the inconsistency bug:\r\n\t\t\t// The reason is that `i` can be non-consistent with the `items`\r\n\t\t\t// passed to `<VirtualScroller/>` in React due to `updateState()` not being\r\n\t\t\t// instanteneous: when new `items` are passed to `<VirtualScroller/>`,\r\n\t\t\t// `VirtualScroller.updateState({ items })` is called, and if `onItemFirstRender(i)`\r\n\t\t\t// is called after the aforementioned `updateState()` is called but before it finishes,\r\n\t\t\t// `i` would point to an index in \"previous\" `items` while the application\r\n\t\t\t// would assume that `i` points to an index in the \"new\" `items`,\r\n\t\t\t// resulting in an incorrect item being assumed by the application\r\n\t\t\t// or even in an \"array index out of bounds\" error.\r\n\t\t\tif (i >= 0) {\r\n\t\t\t\tonItemFirstRender(i)\r\n\t\t\t}\r\n\t\t}\r\n\t}\r\n\r\n\t// If initial `state` is passed then use `items` from `state`\r\n\t// instead of the `items` argument.\r\n\tif (state) {\r\n\t\titems = state.items\r\n\t}\r\n\r\n\tlog('Items count', items.length)\r\n\tif (estimatedItemHeight) {\r\n\t\tlog('Estimated item height', estimatedItemHeight)\r\n\t}\r\n\r\n\tcreateStateHelpers.call(this, { state, onStateChange, render, items })\r\n\r\n\tcreateVerticalSpacingHelpers.call(this)\r\n\tcreateColumnsHelpers.call(this, { getColumnsCount })\r\n\r\n\tcreateLayoutHelpers.call(this)\r\n\tcreateOnRenderHelpers.call(this)\r\n\tcreateResizeHelpers.call(this)\r\n\tcreateItemsHelpers.call(this)\r\n\r\n\tcreateHelpers.call(this, {\r\n\t\tgetScrollableContainer,\r\n\t\testimatedItemHeight,\r\n\t\tmeasureItemsBatchSize,\r\n\t\tinitialScrollPosition,\r\n\t\tonScrollPositionChange,\r\n\t\twaitForScrollingToStop: _waitForScrollingToStop\r\n\t})\r\n\r\n\tif (state) {\r\n\t\t// Initialize `ItemHeights` from previously measured `state.itemHeights`.\r\n\t\tthis.itemHeights.readItemHeightsFromState(state)\r\n\r\n\t\t// Initialize some `BeforeResize` internal flags from a previously saved state.\r\n\t\tthis.beforeResize.initializeFromState(state)\r\n\t}\r\n}\r\n\r\nfunction createHelpers({\r\n\tgetScrollableContainer,\r\n\testimatedItemHeight,\r\n\tmeasureItemsBatchSize,\r\n\tinitialScrollPosition,\r\n\tonScrollPositionChange,\r\n\twaitForScrollingToStop\r\n}) {\r\n\tthis.itemsContainer = this.engine.createItemsContainer(\r\n\t\tthis.getItemsContainerElement\r\n\t)\r\n\r\n\t// If the items \"container\" element is mounted at this stage,\r\n\t// remove any accidental text nodes from it (like whitespace).\r\n\t//\r\n\t// Also, this guards against cases when someone accidentally tries\r\n\t// using `VirtualScroller` on a non-empty element.\r\n\t//\r\n\tif (this.getItemsContainerElement()) {\r\n\t\tthis.itemsContainer.clear()\r\n\t}\r\n\r\n\tthis.scrollableContainer = this.engine.createScrollableContainer(\r\n\t\tgetScrollableContainer,\r\n\t\tthis.getItemsContainerElement\r\n\t)\r\n\r\n\t// Create `ItemHeights` instance.\r\n\tthis.itemHeights = new ItemHeights({\r\n\t\tcontainer: this.itemsContainer,\r\n\t\tgetItemHeight: (i) => this.getState().itemHeights[i],\r\n\t\tsetItemHeight: (i, height) => this.getState().itemHeights[i] = height\r\n\t})\r\n\r\n\tthis.layout = new Layout({\r\n\t\tbypass: this.bypass,\r\n\t\testimatedItemHeight,\r\n\t\tmeasureItemsBatchSize,\r\n\t\tgetPrerenderMargin: () => this.getPrerenderMargin(),\r\n\t\tgetVerticalSpacing: () => this.getVerticalSpacing(),\r\n\t\tgetVerticalSpacingBeforeResize: () => this.getVerticalSpacingBeforeResize(),\r\n\t\tgetColumnsCount: () => this.getColumnsCount(),\r\n\t\tgetColumnsCountBeforeResize: () => this.getState().beforeResize && this.getState().beforeResize.columnsCount,\r\n\t\tgetItemHeight: (i) => this.getState().itemHeights[i],\r\n\t\tgetItemHeightBeforeResize: (i) => this.getState().beforeResize && this.getState().beforeResize.itemHeights[i],\r\n\t\tgetBeforeResizeItemsCount: () => this.getState().beforeResize ? this.getState().beforeResize.itemHeights.length : 0,\r\n\t\tgetAverageItemHeight: () => this.itemHeights.getAverage(),\r\n\t\tgetMaxVisibleAreaHeight: () => this.scrollableContainer && this.scrollableContainer.getHeight(),\r\n\t\t//\r\n\t\t// The \"previously calculated layout\" feature is not currently used.\r\n\t\t//\r\n\t\t// The current layout snapshot could be stored as a \"previously calculated layout\" variable\r\n\t\t// so that it could theoretically be used when calculating new layout incrementally\r\n\t\t// rather than from scratch, which would be an optimization.\r\n\t\t//\r\n\t\tgetPreviouslyCalculatedLayout: () => this.previouslyCalculatedLayout\r\n\t})\r\n\r\n\tthis.resize = new Resize({\r\n\t\tbypass: this.bypass,\r\n\t\tgetWidth: () => this.scrollableContainer.getWidth(),\r\n\t\tgetHeight: () => this.scrollableContainer.getHeight(),\r\n\t\tlistenForResize: (listener) => this.scrollableContainer.onResize(listener),\r\n\t\tonResizeStart: () => {\r\n\t\t\tlog('~ Scrollable container resize started ~')\r\n\t\t\tthis._isResizing = true\r\n\t\t},\r\n\t\tonResizeStop: () => {\r\n\t\t\tlog('~ Scrollable container resize finished ~')\r\n\t\t\tthis._isResizing = undefined\r\n\t\t},\r\n\t\tonNoChange: () => {\r\n\t\t\t// There might have been some missed `this.onUpdateShownItemIndexes()` calls\r\n\t\t\t// due to setting `this._isResizing` flag to `true` during the resize.\r\n\t\t\t// So, update shown item indexes just in case.\r\n\t\t\tthis.onUpdateShownItemIndexes({\r\n\t\t\t\treason: LAYOUT_REASON.VIEWPORT_SIZE_UNCHANGED\r\n\t\t\t})\r\n\t\t},\r\n\t\tonHeightChange: () => this.onUpdateShownItemIndexes({\r\n\t\t\treason: LAYOUT_REASON.VIEWPORT_HEIGHT_CHANGED\r\n\t\t}),\r\n\t\tonWidthChange: (prevWidth, newWidth) => {\r\n\t\t\tlog('~ Scrollable container width changed from', prevWidth, 'to', newWidth, '~')\r\n\t\t\tthis.onResize()\r\n\t\t}\r\n\t})\r\n\r\n\tthis.scroll = new Scroll({\r\n\t\tbypass: this.bypass,\r\n\t\tscrollableContainer: this.scrollableContainer,\r\n\t\titemsContainer: this.itemsContainer,\r\n\t\twaitForScrollingToStop,\r\n\t\tonScroll: ({ delayed } = {}) => {\r\n\t\t\tthis.onUpdateShownItemIndexes({\r\n\t\t\t\treason: delayed ? LAYOUT_REASON.STOPPED_SCROLLING : LAYOUT_REASON.SCROLL\r\n\t\t\t})\r\n\t\t},\r\n\t\tinitialScrollPosition,\r\n\t\tonScrollPositionChange,\r\n\t\tisImmediateLayoutScheduled: () => Boolean(this.layoutTimer),\r\n\t\thasNonRenderedItemsAtTheTop: () => this.getState().firstShownItemIndex > 0,\r\n\t\thasNonRenderedItemsAtTheBottom: () => this.getState().lastShownItemIndex < this.getItemsCount() - 1,\r\n\t\tgetLatestLayoutVisibleArea: () => this.latestLayoutVisibleArea,\r\n\t\tgetListTopOffset: this.getListTopOffsetInsideScrollableContainer,\r\n\t\tgetPrerenderMargin: () => this.getPrerenderMargin()\r\n\t})\r\n\r\n\tthis.listHeightMeasurement = new ListHeightMeasurement({\r\n\t\titemsContainer: this.itemsContainer,\r\n\t\tgetListTopOffset: this.getListTopOffsetInsideScrollableContainer\r\n\t})\r\n\r\n\tif (this.engine.watchListTopOffset) {\r\n\t\tthis.listTopOffsetWatcher = this.engine.watchListTopOffset({\r\n\t\t\tgetListTopOffset: this.getListTopOffsetInsideScrollableContainer,\r\n\t\t\tonListTopOffsetChange: ({ reason }) => this.onUpdateShownItemIndexes({\r\n\t\t\t\treason: LAYOUT_REASON.TOP_OFFSET_CHANGED\r\n\t\t\t})\r\n\t\t})\r\n\t}\r\n\r\n\tthis.beforeResize = new BeforeResize({\r\n\t\tgetState: this.getState,\r\n\t\tgetVerticalSpacing: this.getVerticalSpacing,\r\n\t\tgetColumnsCount: this.getColumnsCount\r\n\t})\r\n}"],"mappings":"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"}
+{"version":3,"file":"VirtualScroller.constructor.js","names":["supportsTbody","BROWSER_NOT_SUPPORTED_ERROR","DOMEngine","Layout","LAYOUT_REASON","Resize","BeforeResize","Scroll","ListHeightMeasurement","ItemHeights","log","warn","isDebug","reportError","createStateHelpers","createVerticalSpacingHelpers","createColumnsHelpers","createLayoutHelpers","createOnRenderHelpers","createResizeHelpers","createItemsHelpers","VirtualScrollerConstructor","getItemsContainerElement","items","options","render","state","onStateChange","initialScrollPosition","onScrollPositionChange","scrollableContainer","measureItemsBatchSize","getColumnsCount","getItemId","tbody","estimatedItemHeight","getEstimatedVisibleItemRowsCount","onItemInitialRender","onItemFirstRender","_useTimeoutInRenderLoop","_waitForScrollingToStop","engine","bypass","getEstimatedItemHeight","getScrollableContainer","getState","setState","Error","isItemEqual","a","b","item","i","indexOf","length","call","createHelpers","waitForScrollingToStop","itemHeights","readItemHeightsFromState","beforeResize","initializeFromState","itemsContainer","createItemsContainer","clear","createScrollableContainer","container","getItemHeight","setItemHeight","height","layout","getInitialEstimatedItemHeight","getInitialEstimatedVisibleItemRowsCount","getPrerenderMargin","getVerticalSpacing","getVerticalSpacingBeforeResize","getColumnsCountBeforeResize","columnsCount","getItemHeightBeforeResize","getBeforeResizeItemsCount","getAverageItemHeight","getAverage","getMaxVisibleAreaHeight","getHeight","getPreviouslyCalculatedLayout","previouslyCalculatedLayout","resize","getWidth","listenForResize","listener","onResize","onResizeStart","_isResizing","onResizeStop","undefined","onNoChange","onUpdateShownItemIndexes","reason","VIEWPORT_SIZE_UNCHANGED","onHeightChange","VIEWPORT_HEIGHT_CHANGED","onWidthChange","prevWidth","newWidth","scroll","onScroll","delayed","STOPPED_SCROLLING","SCROLL","isImmediateLayoutScheduled","Boolean","layoutTimer","hasNonRenderedItemsAtTheTop","firstShownItemIndex","hasNonRenderedItemsAtTheBottom","lastShownItemIndex","getItemsCount","getLatestLayoutVisibleArea","latestLayoutVisibleArea","getListTopOffset","getListTopOffsetInsideScrollableContainer","listHeightMeasurement","watchListTopOffset","listTopOffsetWatcher","onListTopOffsetChange","TOP_OFFSET_CHANGED"],"sources":["../source/VirtualScroller.constructor.js"],"sourcesContent":["import {\r\n\tsupportsTbody,\r\n\tBROWSER_NOT_SUPPORTED_ERROR\r\n} from './DOM/tbody.js'\r\n\r\nimport DOMEngine from './DOM/Engine.js'\r\n\r\nimport Layout, { LAYOUT_REASON } from './Layout.js'\r\nimport Resize from './Resize.js'\r\nimport BeforeResize from './BeforeResize.js'\r\nimport Scroll from './Scroll.js'\r\nimport ListHeightMeasurement from './ListHeightMeasurement.js'\r\nimport ItemHeights from './ItemHeights.js'\r\n\r\nimport log, { warn, isDebug, reportError } from './utility/debug.js'\r\n\r\nimport createStateHelpers from './VirtualScroller.state.js'\r\nimport createVerticalSpacingHelpers from './VirtualScroller.verticalSpacing.js'\r\nimport createColumnsHelpers from './VirtualScroller.columns.js'\r\nimport createLayoutHelpers from './VirtualScroller.layout.js'\r\nimport createOnRenderHelpers from './VirtualScroller.onRender.js'\r\nimport createResizeHelpers from './VirtualScroller.resize.js'\r\nimport createItemsHelpers from './VirtualScroller.items.js'\r\n\r\n/**\r\n * @param  {function} getItemsContainerElement — Returns the container DOM `Element`.\r\n * @param  {any[]} items — The list of items.\r\n * @param  {Object} [options] — See README.md.\r\n * @return {VirtualScroller}\r\n */\r\nexport default function VirtualScrollerConstructor(\r\n\tgetItemsContainerElement,\r\n\titems,\r\n\toptions = {}\r\n) {\r\n\tconst {\r\n\t\trender,\r\n\t\tstate,\r\n\t\tonStateChange,\r\n\t\tinitialScrollPosition,\r\n\t\tonScrollPositionChange,\r\n\t\t// `scrollableContainer` option is deprecated.\r\n\t\t// Use `getScrollableContainer()` option instead.\r\n\t\tscrollableContainer,\r\n\t\tmeasureItemsBatchSize = 50,\r\n\t\tgetColumnsCount,\r\n\t\tgetItemId,\r\n\t\ttbody,\r\n\t\t// `estimatedItemHeight` is deprecated, use `getEstimatedItemHeight()` instead.\r\n\t\testimatedItemHeight,\r\n\t\tgetEstimatedVisibleItemRowsCount,\r\n\t\tonItemInitialRender,\r\n\t\t// `onItemFirstRender(i)` is deprecated, use `onItemInitialRender(item)` instead.\r\n\t\tonItemFirstRender,\r\n\t\t_useTimeoutInRenderLoop,\r\n\t\t_waitForScrollingToStop,\r\n\t\tengine\r\n\t} = options\r\n\r\n\tlet {\r\n\t\tbypass,\r\n\t\tgetEstimatedItemHeight,\r\n\t\tgetScrollableContainer\r\n\t} = options\r\n\r\n\tlog('~ Initialize ~')\r\n\r\n\t// Could support non-DOM rendering engines.\r\n\t// For example, React Native, `<canvas/>`, etc.\r\n\tthis.engine = engine || DOMEngine\r\n\r\n\tif (!getEstimatedItemHeight && typeof estimatedItemHeight === 'number') {\r\n\t\tgetEstimatedItemHeight = () => estimatedItemHeight\r\n\t}\r\n\r\n\t// `scrollableContainer` option is deprecated.\r\n\t// Use `getScrollableContainer()` option instead.\r\n\tif (!getScrollableContainer && scrollableContainer) {\r\n\t\tgetScrollableContainer = () => scrollableContainer\r\n\t}\r\n\r\n\t// Sometimes, when `new VirtualScroller()` instance is created,\r\n\t// `getItemsContainerElement()` might not be ready to return the \"container\" DOM Element yet\r\n\t// (for example, because it's not rendered yet). That's the reason why it's a getter function.\r\n\t// For example, in React `<VirtualScroller/>` component, a `VirtualScroller`\r\n\t// instance is created in the React component's `constructor()`, and at that time\r\n\t// the container Element is not yet available. The container Element is available\r\n\t// in `componentDidMount()`, but `componentDidMount()` is not executed on server,\r\n\t// which would mean that React `<VirtualScroller/>` wouldn't render at all\r\n\t// on server side, while with the `getItemsContainerElement()` approach, on server side,\r\n\t// it still \"renders\" a list with a predefined amount of items in it by default.\r\n\t// (`initiallyRenderedItemsCount`, or `1`).\r\n\tthis.getItemsContainerElement = getItemsContainerElement\r\n\r\n\t// if (prerenderMargin === undefined) {\r\n\t// \t// Renders items which are outside of the screen by this \"prerender margin\".\r\n\t// \t// Is the screen height by default: seems to be the optimal value\r\n\t// \t// for \"Page Up\" / \"Page Down\" navigation and optimized mouse wheel scrolling.\r\n\t// \tprerenderMargin = this.scrollableContainer ? this.scrollableContainer.getHeight() : 0\r\n\t// }\r\n\r\n\tif (options.getState || options.setState) {\r\n\t\tthrow new Error('[virtual-scroller] `getState`/`setState` options usage has changed in the new version. See the readme for more details.')\r\n\t}\r\n\r\n\t// Work around `<tbody/>` not being able to have `padding`.\r\n\t// https://gitlab.com/catamphetamine/virtual-scroller/-/issues/1\r\n\tif (tbody) {\r\n\t\tif (this.engine !== DOMEngine) {\r\n\t\t\tthrow new Error('[virtual-scroller] `tbody` option is only supported for DOM rendering engine')\r\n\t\t}\r\n\t\tlog('~ <tbody/> detected ~')\r\n\t\tthis.tbody = true\r\n\t\tif (!supportsTbody()) {\r\n\t\t\tlog('~ <tbody/> not supported ~')\r\n\t\t\treportError(BROWSER_NOT_SUPPORTED_ERROR)\r\n\t\t\tbypass = true\r\n\t\t}\r\n\t}\r\n\r\n\tif (bypass) {\r\n\t\tlog('~ \"bypass\" mode ~')\r\n\t}\r\n\r\n\t// In `bypass` mode, `VirtualScroller` doesn't wait\r\n\t// for the user to scroll down to render all items:\r\n\t// instead, it renders all items right away, as if\r\n\t// the list is rendered without using `VirtualScroller`.\r\n\t// It was added just to measure how much is the\r\n\t// performance difference between using a `VirtualScroller`\r\n\t// and not using a `VirtualScroller`.\r\n\t// It turned out that unmounting large React component trees\r\n\t// is a very long process, so `VirtualScroller` does seem to\r\n\t// make sense when used in a React application.\r\n\tthis.bypass = bypass\r\n\t// this.bypassBatchSize = bypassBatchSize || 10\r\n\r\n\t// Using `setTimeout()` in render loop is a workaround\r\n\t// for avoiding a React error message:\r\n\t// \"Maximum update depth exceeded.\r\n\t//  This can happen when a component repeatedly calls\r\n\t//  `.setState()` inside `componentWillUpdate()` or `componentDidUpdate()`.\r\n\t//  React limits the number of nested updates to prevent infinite loops.\"\r\n\tthis._useTimeoutInRenderLoop = _useTimeoutInRenderLoop\r\n\r\n\tif (getItemId) {\r\n\t\tthis.isItemEqual = (a, b) => getItemId(a) === getItemId(b)\r\n\t} else {\r\n\t\tthis.isItemEqual = (a, b) => a === b\r\n\t}\r\n\r\n\tif (onItemInitialRender) {\r\n\t\tthis.onItemInitialRender = onItemInitialRender\r\n\t}\r\n\t// `onItemFirstRender(i)` is deprecated, use `onItemInitialRender(item)` instead.\r\n\telse if (onItemFirstRender) {\r\n\t\tthis.onItemInitialRender = (item) => {\r\n\t\t\twarn('`onItemFirstRender(i)` is deprecated, use `onItemInitialRender(item)` instead.')\r\n\t\t\tconst { items } = this.getState()\r\n\t\t\tconst i = items.indexOf(item)\r\n\t\t\t// The `item` could also be non-found due to the inconsistency bug:\r\n\t\t\t// The reason is that `i` can be non-consistent with the `items`\r\n\t\t\t// passed to `<VirtualScroller/>` in React due to `updateState()` not being\r\n\t\t\t// instanteneous: when new `items` are passed to `<VirtualScroller/>`,\r\n\t\t\t// `VirtualScroller.updateState({ items })` is called, and if `onItemFirstRender(i)`\r\n\t\t\t// is called after the aforementioned `updateState()` is called but before it finishes,\r\n\t\t\t// `i` would point to an index in \"previous\" `items` while the application\r\n\t\t\t// would assume that `i` points to an index in the \"new\" `items`,\r\n\t\t\t// resulting in an incorrect item being assumed by the application\r\n\t\t\t// or even in an \"array index out of bounds\" error.\r\n\t\t\tif (i >= 0) {\r\n\t\t\t\tonItemFirstRender(i)\r\n\t\t\t}\r\n\t\t}\r\n\t}\r\n\r\n\t// If initial `state` is passed then use `items` from `state`\r\n\t// instead of the `items` argument.\r\n\tif (state) {\r\n\t\titems = state.items\r\n\t}\r\n\r\n\tlog('Items count', items.length)\r\n\tif (getEstimatedItemHeight) {\r\n\t\tlog('Estimated item height', getEstimatedItemHeight())\r\n\t}\r\n\r\n\tcreateStateHelpers.call(this, { state, onStateChange, render, items })\r\n\r\n\tcreateVerticalSpacingHelpers.call(this)\r\n\tcreateColumnsHelpers.call(this, { getColumnsCount })\r\n\r\n\tcreateLayoutHelpers.call(this)\r\n\tcreateOnRenderHelpers.call(this)\r\n\tcreateResizeHelpers.call(this)\r\n\tcreateItemsHelpers.call(this)\r\n\r\n\tcreateHelpers.call(this, {\r\n\t\tgetScrollableContainer,\r\n\t\tgetEstimatedItemHeight,\r\n\t\tgetEstimatedVisibleItemRowsCount,\r\n\t\tmeasureItemsBatchSize,\r\n\t\tinitialScrollPosition,\r\n\t\tonScrollPositionChange,\r\n\t\twaitForScrollingToStop: _waitForScrollingToStop\r\n\t})\r\n\r\n\tif (state) {\r\n\t\t// Initialize `ItemHeights` from previously measured `state.itemHeights`.\r\n\t\tthis.itemHeights.readItemHeightsFromState(state)\r\n\r\n\t\t// Initialize some `BeforeResize` internal flags from a previously saved state.\r\n\t\tthis.beforeResize.initializeFromState(state)\r\n\t}\r\n}\r\n\r\nfunction createHelpers({\r\n\tgetScrollableContainer,\r\n\tgetEstimatedItemHeight,\r\n\tgetEstimatedVisibleItemRowsCount,\r\n\tmeasureItemsBatchSize,\r\n\tinitialScrollPosition,\r\n\tonScrollPositionChange,\r\n\twaitForScrollingToStop\r\n}) {\r\n\tthis.itemsContainer = this.engine.createItemsContainer(\r\n\t\tthis.getItemsContainerElement\r\n\t)\r\n\r\n\t// If the items \"container\" element is mounted at this stage,\r\n\t// remove any accidental text nodes from it (like whitespace).\r\n\t//\r\n\t// Also, this guards against cases when someone accidentally tries\r\n\t// using `VirtualScroller` on a non-empty element.\r\n\t//\r\n\tif (this.getItemsContainerElement()) {\r\n\t\tthis.itemsContainer.clear()\r\n\t}\r\n\r\n\tthis.scrollableContainer = this.engine.createScrollableContainer(\r\n\t\tgetScrollableContainer,\r\n\t\tthis.getItemsContainerElement\r\n\t)\r\n\r\n\t// Create `ItemHeights` instance.\r\n\tthis.itemHeights = new ItemHeights({\r\n\t\tcontainer: this.itemsContainer,\r\n\t\tgetItemHeight: (i) => this.getState().itemHeights[i],\r\n\t\tsetItemHeight: (i, height) => this.getState().itemHeights[i] = height\r\n\t})\r\n\r\n\tthis.layout = new Layout({\r\n\t\tbypass: this.bypass,\r\n\t\tgetInitialEstimatedItemHeight: getEstimatedItemHeight,\r\n\t\tgetInitialEstimatedVisibleItemRowsCount: getEstimatedVisibleItemRowsCount,\r\n\t\tmeasureItemsBatchSize,\r\n\t\tgetPrerenderMargin: () => this.getPrerenderMargin(),\r\n\t\tgetVerticalSpacing: () => this.getVerticalSpacing(),\r\n\t\tgetVerticalSpacingBeforeResize: () => this.getVerticalSpacingBeforeResize(),\r\n\t\tgetColumnsCount: () => this.getColumnsCount(),\r\n\t\tgetColumnsCountBeforeResize: () => this.getState().beforeResize && this.getState().beforeResize.columnsCount,\r\n\t\tgetItemHeight: (i) => this.getState().itemHeights[i],\r\n\t\tgetItemHeightBeforeResize: (i) => this.getState().beforeResize && this.getState().beforeResize.itemHeights[i],\r\n\t\tgetBeforeResizeItemsCount: () => this.getState().beforeResize ? this.getState().beforeResize.itemHeights.length : 0,\r\n\t\tgetAverageItemHeight: () => this.itemHeights.getAverage(),\r\n\t\t// `this.scrollableContainer` is gonna be `undefined` during server-side rendering.\r\n\t\t// https://gitlab.com/catamphetamine/virtual-scroller/-/issues/30\r\n\t\tgetMaxVisibleAreaHeight: () => this.scrollableContainer && this.scrollableContainer.getHeight(),\r\n\t\t//\r\n\t\t// The \"previously calculated layout\" feature is not currently used.\r\n\t\t//\r\n\t\t// The current layout snapshot could be stored as a \"previously calculated layout\" variable\r\n\t\t// so that it could theoretically be used when calculating new layout incrementally\r\n\t\t// rather than from scratch, which would be an optimization.\r\n\t\t//\r\n\t\tgetPreviouslyCalculatedLayout: () => this.previouslyCalculatedLayout\r\n\t})\r\n\r\n\tthis.resize = new Resize({\r\n\t\tbypass: this.bypass,\r\n\t\tgetWidth: () => this.scrollableContainer.getWidth(),\r\n\t\tgetHeight: () => this.scrollableContainer.getHeight(),\r\n\t\tlistenForResize: (listener) => this.scrollableContainer.onResize(listener),\r\n\t\tonResizeStart: () => {\r\n\t\t\tlog('~ Scrollable container resize started ~')\r\n\t\t\tthis._isResizing = true\r\n\t\t},\r\n\t\tonResizeStop: () => {\r\n\t\t\tlog('~ Scrollable container resize finished ~')\r\n\t\t\tthis._isResizing = undefined\r\n\t\t},\r\n\t\tonNoChange: () => {\r\n\t\t\t// There might have been some missed `this.onUpdateShownItemIndexes()` calls\r\n\t\t\t// due to setting `this._isResizing` flag to `true` during the resize.\r\n\t\t\t// So, update shown item indexes just in case.\r\n\t\t\tthis.onUpdateShownItemIndexes({\r\n\t\t\t\treason: LAYOUT_REASON.VIEWPORT_SIZE_UNCHANGED\r\n\t\t\t})\r\n\t\t},\r\n\t\tonHeightChange: () => this.onUpdateShownItemIndexes({\r\n\t\t\treason: LAYOUT_REASON.VIEWPORT_HEIGHT_CHANGED\r\n\t\t}),\r\n\t\tonWidthChange: (prevWidth, newWidth) => {\r\n\t\t\tlog('~ Scrollable container width changed from', prevWidth, 'to', newWidth, '~')\r\n\t\t\tthis.onResize()\r\n\t\t}\r\n\t})\r\n\r\n\tthis.scroll = new Scroll({\r\n\t\tbypass: this.bypass,\r\n\t\tscrollableContainer: this.scrollableContainer,\r\n\t\titemsContainer: this.itemsContainer,\r\n\t\twaitForScrollingToStop,\r\n\t\tonScroll: ({ delayed } = {}) => {\r\n\t\t\tthis.onUpdateShownItemIndexes({\r\n\t\t\t\treason: delayed ? LAYOUT_REASON.STOPPED_SCROLLING : LAYOUT_REASON.SCROLL\r\n\t\t\t})\r\n\t\t},\r\n\t\tinitialScrollPosition,\r\n\t\tonScrollPositionChange,\r\n\t\tisImmediateLayoutScheduled: () => Boolean(this.layoutTimer),\r\n\t\thasNonRenderedItemsAtTheTop: () => this.getState().firstShownItemIndex > 0,\r\n\t\thasNonRenderedItemsAtTheBottom: () => this.getState().lastShownItemIndex < this.getItemsCount() - 1,\r\n\t\tgetLatestLayoutVisibleArea: () => this.latestLayoutVisibleArea,\r\n\t\tgetListTopOffset: this.getListTopOffsetInsideScrollableContainer,\r\n\t\tgetPrerenderMargin: () => this.getPrerenderMargin()\r\n\t})\r\n\r\n\tthis.listHeightMeasurement = new ListHeightMeasurement({\r\n\t\titemsContainer: this.itemsContainer,\r\n\t\tgetListTopOffset: this.getListTopOffsetInsideScrollableContainer\r\n\t})\r\n\r\n\tif (this.engine.watchListTopOffset) {\r\n\t\tthis.listTopOffsetWatcher = this.engine.watchListTopOffset({\r\n\t\t\tgetListTopOffset: this.getListTopOffsetInsideScrollableContainer,\r\n\t\t\tonListTopOffsetChange: ({ reason }) => this.onUpdateShownItemIndexes({\r\n\t\t\t\treason: LAYOUT_REASON.TOP_OFFSET_CHANGED\r\n\t\t\t})\r\n\t\t})\r\n\t}\r\n\r\n\tthis.beforeResize = new BeforeResize({\r\n\t\tgetState: this.getState,\r\n\t\tgetVerticalSpacing: this.getVerticalSpacing,\r\n\t\tgetColumnsCount: this.getColumnsCount\r\n\t})\r\n}"],"mappings":"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"}

package/modules/VirtualScroller.state.js

@@ -164,7 +164,9 @@ export default function createStateHelpers(_ref) {
   function getInitialStateFromScratch() {
     var items = initialItems;
 
-    var state = _objectSpread(_objectSpread({}, getInitialLayoutState.call(this, items)), {}, {
+    var state = _objectSpread(_objectSpread({}, getInitialLayoutState.call(this, items, {
+      beforeStart: true
+    })), {}, {
       items: items,
       itemStates: new Array(items.length)
     });
@@ -220,18 +222,30 @@ export default function createStateHelpers(_ref) {
       columnsCount: this.getActualColumnsCount()
     })) {
       warn('Reset Layout');
-      state = _objectSpread(_objectSpread({}, state), getInitialLayoutState.call(this, state.items));
+      state = _objectSpread(_objectSpread({}, state), getInitialLayoutState.call(this, state.items, {
+        beforeStart: false
+      }));
     }
 
     return state;
   }
 
-  function getInitialLayoutState(items) {
+  function getInitialLayoutState(items, _ref3) {
+    var _this2 = this;
+
+    var beforeStart = _ref3.beforeStart;
     var itemsCount = items.length;
 
+    var getColumnsCount = function getColumnsCount() {
+      return _this2.getActualColumnsCount();
+    };
+
+    var columnsCount = beforeStart ? this.layout.getInitialLayoutValueWithFallback('columnsCount', getColumnsCount, 1) : getColumnsCount();
+
     var _this$layout$getIniti = this.layout.getInitialLayoutValues({
       itemsCount: itemsCount,
-      columnsCount: this.getActualColumnsCount()
+      columnsCount: this.getActualColumnsCount(),
+      beforeStart: beforeStart
     }),
         firstShownItemIndex = _this$layout$getIniti.firstShownItemIndex,
         lastShownItemIndex = _this$layout$getIniti.lastShownItemIndex,
@@ -263,8 +277,8 @@ export default function createStateHelpers(_ref) {
   //
 
 
-  function isStateColumnsCountMismatch(state, _ref3) {
-    var columnsCount = _ref3.columnsCount;
+  function isStateColumnsCountMismatch(state, _ref4) {
+    var columnsCount = _ref4.columnsCount;
     var stateColumnsCount = state.columnsCount || 1;
 
     if (stateColumnsCount !== columnsCount) {

package/modules/VirtualScroller.state.js.map

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

package/modules/react/VirtualScroller.js

@@ -1,4 +1,4 @@
-var _excluded = ["as", "items", "itemComponent", "itemComponentProps", "estimatedItemHeight", "bypass", "tbody", "preserveScrollPosition", "preserveScrollPositionOnPrependItems", "measureItemsBatchSize", "scrollableContainer", "getScrollableContainer", "getColumnsCount", "getItemId", "className", "onMount", "onItemFirstRender", "onItemInitialRender", "initialScrollPosition", "onScrollPositionChange", "onStateChange", "initialState"];
+var _excluded = ["as", "items", "itemComponent", "itemComponentProps", "estimatedItemHeight", "getEstimatedItemHeight", "getEstimatedVisibleItemRowsCount", "bypass", "tbody", "preserveScrollPosition", "preserveScrollPositionOnPrependItems", "measureItemsBatchSize", "scrollableContainer", "getScrollableContainer", "getColumnsCount", "getItemId", "className", "onMount", "onItemFirstRender", "onItemInitialRender", "initialScrollPosition", "onScrollPositionChange", "onStateChange", "initialState"];
 
 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); }
 
@@ -25,6 +25,8 @@ function VirtualScroller(_ref, ref) {
       Component = _ref.itemComponent,
       itemComponentProps = _ref.itemComponentProps,
       estimatedItemHeight = _ref.estimatedItemHeight,
+      getEstimatedItemHeight = _ref.getEstimatedItemHeight,
+      getEstimatedVisibleItemRowsCount = _ref.getEstimatedVisibleItemRowsCount,
       bypass = _ref.bypass,
       tbody = _ref.tbody,
       preserveScrollPosition = _ref.preserveScrollPosition,
@@ -49,7 +51,11 @@ function VirtualScroller(_ref, ref) {
 
   var virtualScroller = useVirtualScroller({
     items: items,
+    // `estimatedItemHeight` property name is deprecated,
+    // use `getEstimatedItemHeight` property instead.
     estimatedItemHeight: estimatedItemHeight,
+    getEstimatedItemHeight: getEstimatedItemHeight,
+    getEstimatedVisibleItemRowsCount: getEstimatedVisibleItemRowsCount,
     bypass: bypass,
     // bypassBatchSize,
     tbody: tbody,
@@ -74,7 +80,8 @@ function VirtualScroller(_ref, ref) {
 
   var _initialState = useMemo(function () {
     return virtualScroller.getInitialState();
-  }, []); // Create state management functions.
+  }, []); // Use React's `useState()` hook for managing `VirtualScroller`'s state lifecycle.
+  // This way, React will re-render the component on every state update.
 
 
   var _useState = useState({
@@ -199,7 +206,11 @@ VirtualScroller.propTypes = {
   items: PropTypes.arrayOf(PropTypes.any).isRequired,
   itemComponent: elementType.isRequired,
   itemComponentProps: PropTypes.object,
+  // `estimatedItemHeight` property name is deprecated,
+  // use `getEstimatedItemHeight` property instead.
   estimatedItemHeight: PropTypes.number,
+  getEstimatedItemHeight: PropTypes.func,
+  getEstimatedVisibleItemRowsCount: PropTypes.func,
   bypass: PropTypes.bool,
   // bypassBatchSize: PropTypes.number,
   tbody: PropTypes.bool,

package/modules/react/VirtualScroller.js.map

@@ -1 +1 @@
-{"version":3,"file":"VirtualScroller.js","names":["React","useRef","useMemo","useLayoutEffect","PropTypes","useState","useVirtualScroller","useVirtualScrollerStartStop","useInstanceMethods","useItemKeys","useOnItemStateChange","useOnItemHeightChange","useHandleItemsChange","useClassName","useStyle","VirtualScroller","ref","AsComponent","as","items","Component","itemComponent","itemComponentProps","estimatedItemHeight","bypass","tbody","preserveScrollPosition","preserveScrollPositionOnPrependItems","measureItemsBatchSize","scrollableContainer","getScrollableContainer","getColumnsCount","getItemId","className","onMount","onItemFirstRender","onItemInitialRender","initialScrollPosition","onScrollPositionChange","onStateChange","initialState","rest","container","virtualScroller","_initialState","getInitialState","onRender","getState","updateState","getItemKey","updateItemKeysForNewItems","getOnItemStateChange","getOnItemHeightChange","style","renderedItems","itemStates","firstShownItemIndex","lastShownItemIndex","map","item","i","forwardRef","elementType","oneOfType","string","func","object","propTypes","arrayOf","any","isRequired","number","bool","shape","beforeItemsHeight","afterItemsHeight","itemHeights","columnsCount","verticalSpacing","defaultProps"],"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 useOnItemStateChange from './useOnItemStateChange.js'\r\nimport useOnItemHeightChange from './useOnItemHeightChange.js'\r\nimport useHandleItemsChange from './useHandleItemsChange.js'\r\nimport useClassName from './useClassName.js'\r\nimport useStyle from './useStyle.js'\r\n\r\nfunction VirtualScroller({\r\n\tas: AsComponent,\r\n\titems,\r\n\titemComponent: Component,\r\n\titemComponentProps,\r\n\testimatedItemHeight,\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\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\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,\r\n\t\testimatedItemHeight,\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\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// Create state management functions.\r\n\tconst {\r\n\t\tgetState,\r\n\t\tupdateState\r\n\t} = useState({\r\n\t\tinitialState: _initialState,\r\n\t\tonRender: virtualScroller.onRender,\r\n\t\titems\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\tupdateState\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)\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\tupdateItemKeysForNewItems\r\n\t} = useItemKeys({\r\n\t\tgetItemId\r\n\t})\r\n\r\n\t// Cache per-item `onItemStateChange` functions' \"references\"\r\n\t// so that item components don't get re-rendered needlessly.\r\n\tconst getOnItemStateChange = useOnItemStateChange({\r\n\t\titems,\r\n\t\tvirtualScroller\r\n\t})\r\n\r\n\t// Cache per-item `onItemHeightChange` functions' \"references\"\r\n\t// so that item components don't get re-rendered needlessly.\r\n\tconst getOnItemHeightChange = useOnItemHeightChange({\r\n\t\titems,\r\n\t\tvirtualScroller\r\n\t})\r\n\r\n\t// Detect if `items` have changed.\r\n\tuseHandleItemsChange(items, {\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\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\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\tvirtualScroller\r\n\t})\r\n\r\n\tconst {\r\n\t\titems: renderedItems,\r\n\t\titemStates,\r\n\t\tfirstShownItemIndex,\r\n\t\tlastShownItemIndex\r\n\t} = virtualScroller.getState()\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{renderedItems.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\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\tonStateChange={getOnItemStateChange(i)}\r\n\t\t\t\t\t\t\tonHeightChange={getOnItemHeightChange(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\testimatedItemHeight: PropTypes.number,\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\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),\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}\r\n\r\nVirtualScroller.defaultProps = {\r\n\tas: 'div'\r\n}\r\n"],"mappings":"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"}
+{"version":3,"file":"VirtualScroller.js","names":["React","useRef","useMemo","useLayoutEffect","PropTypes","useState","useVirtualScroller","useVirtualScrollerStartStop","useInstanceMethods","useItemKeys","useOnItemStateChange","useOnItemHeightChange","useHandleItemsChange","useClassName","useStyle","VirtualScroller","ref","AsComponent","as","items","Component","itemComponent","itemComponentProps","estimatedItemHeight","getEstimatedItemHeight","getEstimatedVisibleItemRowsCount","bypass","tbody","preserveScrollPosition","preserveScrollPositionOnPrependItems","measureItemsBatchSize","scrollableContainer","getScrollableContainer","getColumnsCount","getItemId","className","onMount","onItemFirstRender","onItemInitialRender","initialScrollPosition","onScrollPositionChange","onStateChange","initialState","rest","container","virtualScroller","_initialState","getInitialState","onRender","getState","updateState","getItemKey","updateItemKeysForNewItems","getOnItemStateChange","getOnItemHeightChange","style","renderedItems","itemStates","firstShownItemIndex","lastShownItemIndex","map","item","i","forwardRef","elementType","oneOfType","string","func","object","propTypes","arrayOf","any","isRequired","number","bool","shape","beforeItemsHeight","afterItemsHeight","itemHeights","columnsCount","verticalSpacing","defaultProps"],"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 useOnItemStateChange from './useOnItemStateChange.js'\r\nimport useOnItemHeightChange from './useOnItemHeightChange.js'\r\nimport useHandleItemsChange from './useHandleItemsChange.js'\r\nimport useClassName from './useClassName.js'\r\nimport useStyle from './useStyle.js'\r\n\r\nfunction VirtualScroller({\r\n\tas: AsComponent,\r\n\titems,\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\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\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,\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\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\tupdateState\r\n\t} = useState({\r\n\t\tinitialState: _initialState,\r\n\t\tonRender: virtualScroller.onRender,\r\n\t\titems\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\tupdateState\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)\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\tupdateItemKeysForNewItems\r\n\t} = useItemKeys({\r\n\t\tgetItemId\r\n\t})\r\n\r\n\t// Cache per-item `onItemStateChange` functions' \"references\"\r\n\t// so that item components don't get re-rendered needlessly.\r\n\tconst getOnItemStateChange = useOnItemStateChange({\r\n\t\titems,\r\n\t\tvirtualScroller\r\n\t})\r\n\r\n\t// Cache per-item `onItemHeightChange` functions' \"references\"\r\n\t// so that item components don't get re-rendered needlessly.\r\n\tconst getOnItemHeightChange = useOnItemHeightChange({\r\n\t\titems,\r\n\t\tvirtualScroller\r\n\t})\r\n\r\n\t// Detect if `items` have changed.\r\n\tuseHandleItemsChange(items, {\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\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\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\tvirtualScroller\r\n\t})\r\n\r\n\tconst {\r\n\t\titems: renderedItems,\r\n\t\titemStates,\r\n\t\tfirstShownItemIndex,\r\n\t\tlastShownItemIndex\r\n\t} = virtualScroller.getState()\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{renderedItems.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\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\tonStateChange={getOnItemStateChange(i)}\r\n\t\t\t\t\t\t\tonHeightChange={getOnItemHeightChange(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\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),\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}\r\n\r\nVirtualScroller.defaultProps = {\r\n\tas: 'div'\r\n}\r\n"],"mappings":"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"}

package/modules/react/useVirtualScroller.js

@@ -6,6 +6,8 @@ import VirtualScroller from '../VirtualScroller.js'; // Creates a `VirtualScroll
 export default function useVirtualScroller(_ref, _ref2) {
   var items = _ref.items,
       estimatedItemHeight = _ref.estimatedItemHeight,
+      getEstimatedItemHeight = _ref.getEstimatedItemHeight,
+      getEstimatedVisibleItemRowsCount = _ref.getEstimatedVisibleItemRowsCount,
       bypass = _ref.bypass,
       tbody = _ref.tbody,
       onItemInitialRender = _ref.onItemInitialRender,
@@ -29,7 +31,10 @@ export default function useVirtualScroller(_ref, _ref2) {
       return container.current;
     }, items, (_VirtualScroller = {
       _useTimeoutInRenderLoop: true,
+      // `estimatedItemHeight` is deprecated, use `getEstimatedItemHeight()` instead.
       estimatedItemHeight: estimatedItemHeight,
+      getEstimatedItemHeight: getEstimatedItemHeight,
+      getEstimatedVisibleItemRowsCount: getEstimatedVisibleItemRowsCount,
       bypass: bypass,
       // bypassBatchSize,
       tbody: tbody,

package/modules/react/useVirtualScroller.js.map

@@ -1 +1 @@
-{"version":3,"file":"useVirtualScroller.js","names":["useMemo","VirtualScroller","useVirtualScroller","items","estimatedItemHeight","bypass","tbody","onItemInitialRender","onItemFirstRender","initialScrollPosition","onScrollPositionChange","measureItemsBatchSize","scrollableContainer","getScrollableContainer","getColumnsCount","getItemId","AsComponent","initialState","onStateChange","container","current","_useTimeoutInRenderLoop"],"sources":["../../source/react/useVirtualScroller.js"],"sourcesContent":["import { useMemo } from 'react'\r\n\r\nimport VirtualScroller from '../VirtualScroller.js'\r\n\r\n// Creates a `VirtualScroller` instance.\r\nexport default function useVirtualScroller({\r\n\titems,\r\n\testimatedItemHeight,\r\n\tbypass,\r\n\t// bypassBatchSize,\r\n\ttbody,\r\n\tonItemInitialRender,\r\n\t// `onItemFirstRender(i)` is deprecated, use `onItemInitialRender(item)` instead.\r\n\tonItemFirstRender,\r\n\tinitialScrollPosition,\r\n\tonScrollPositionChange,\r\n\tmeasureItemsBatchSize,\r\n\t// `scrollableContainer` property is deprecated.\r\n\t// Use `getScrollableContainer()` property instead.\r\n\tscrollableContainer,\r\n\tgetScrollableContainer,\r\n\tgetColumnsCount,\r\n\tgetItemId,\r\n\tAsComponent,\r\n\tinitialState,\r\n\tonStateChange\r\n}, {\r\n\tcontainer\r\n}) {\r\n\treturn useMemo(() => {\r\n\t\t// Create `virtual-scroller` instance.\r\n\t\treturn new VirtualScroller(\r\n\t\t\t() => container.current,\r\n\t\t\titems,\r\n\t\t\t{\r\n\t\t\t\t_useTimeoutInRenderLoop: true,\r\n\t\t\t\testimatedItemHeight,\r\n\t\t\t\tbypass,\r\n\t\t\t\t// bypassBatchSize,\r\n\t\t\t\ttbody,\r\n\t\t\t\tonItemInitialRender,\r\n\t\t\t\t// `onItemFirstRender(i)` is deprecated, use `onItemInitialRender(item)` instead.\r\n\t\t\t\tonItemFirstRender,\r\n\t\t\t\tinitialScrollPosition,\r\n\t\t\t\tonScrollPositionChange,\r\n\t\t\t\tmeasureItemsBatchSize,\r\n\t\t\t\t// `scrollableContainer` property is deprecated.\r\n\t\t\t\t// Use `getScrollableContainer()` property instead.\r\n\t\t\t\tscrollableContainer,\r\n\t\t\t\tgetScrollableContainer,\r\n\t\t\t\tgetColumnsCount,\r\n\t\t\t\tgetItemId,\r\n\t\t\t\ttbody: AsComponent === 'tbody',\r\n\t\t\t\tstate: initialState,\r\n\t\t\t\tonStateChange\r\n\t\t\t}\r\n\t\t)\r\n\t}, [])\r\n}"],"mappings":";;AAAA,SAASA,OAAT,QAAwB,OAAxB;AAEA,OAAOC,eAAP,MAA4B,uBAA5B,C,CAEA;;AACA,eAAe,SAASC,kBAAT,cAuBZ;EAAA,IAtBFC,KAsBE,QAtBFA,KAsBE;EAAA,IArBFC,mBAqBE,QArBFA,mBAqBE;EAAA,IApBFC,MAoBE,QApBFA,MAoBE;EAAA,IAlBFC,KAkBE,QAlBFA,KAkBE;EAAA,IAjBFC,mBAiBE,QAjBFA,mBAiBE;EAAA,IAfFC,iBAeE,QAfFA,iBAeE;EAAA,IAdFC,qBAcE,QAdFA,qBAcE;EAAA,IAbFC,sBAaE,QAbFA,sBAaE;EAAA,IAZFC,qBAYE,QAZFA,qBAYE;EAAA,IATFC,mBASE,QATFA,mBASE;EAAA,IARFC,sBAQE,QARFA,sBAQE;EAAA,IAPFC,eAOE,QAPFA,eAOE;EAAA,IANFC,SAME,QANFA,SAME;EAAA,IALFC,WAKE,QALFA,WAKE;EAAA,IAJFC,YAIE,QAJFA,YAIE;EAAA,IAHFC,aAGE,QAHFA,aAGE;EAAA,IADFC,SACE,SADFA,SACE;EACF,OAAOnB,OAAO,CAAC,YAAM;IAAA;;IACpB;IACA,OAAO,IAAIC,eAAJ,CACN;MAAA,OAAMkB,SAAS,CAACC,OAAhB;IAAA,CADM,EAENjB,KAFM;MAILkB,uBAAuB,EAAE,IAJpB;MAKLjB,mBAAmB,EAAnBA,mBALK;MAMLC,MAAM,EAANA,MANK;MAOL;MACAC,KAAK,EAALA,KARK;MASLC,mBAAmB,EAAnBA,mBATK;MAUL;MACAC,iBAAiB,EAAjBA,iBAXK;MAYLC,qBAAqB,EAArBA,qBAZK;MAaLC,sBAAsB,EAAtBA,sBAbK;MAcLC,qBAAqB,EAArBA,qBAdK;MAeL;MACA;MACAC,mBAAmB,EAAnBA,mBAjBK;MAkBLC,sBAAsB,EAAtBA,sBAlBK;MAmBLC,eAAe,EAAfA,eAnBK;MAoBLC,SAAS,EAATA;IApBK,8CAqBEC,WAAW,KAAK,OArBlB,8CAsBEC,YAtBF,sDAuBLC,aAvBK,qBAAP;EA0BA,CA5Ba,EA4BX,EA5BW,CAAd;AA6BA"}
+{"version":3,"file":"useVirtualScroller.js","names":["useMemo","VirtualScroller","useVirtualScroller","items","estimatedItemHeight","getEstimatedItemHeight","getEstimatedVisibleItemRowsCount","bypass","tbody","onItemInitialRender","onItemFirstRender","initialScrollPosition","onScrollPositionChange","measureItemsBatchSize","scrollableContainer","getScrollableContainer","getColumnsCount","getItemId","AsComponent","initialState","onStateChange","container","current","_useTimeoutInRenderLoop"],"sources":["../../source/react/useVirtualScroller.js"],"sourcesContent":["import { useMemo } from 'react'\r\n\r\nimport VirtualScroller from '../VirtualScroller.js'\r\n\r\n// Creates a `VirtualScroller` instance.\r\nexport default function useVirtualScroller({\r\n\titems,\r\n\t// `estimatedItemHeight` is deprecated, use `getEstimatedItemHeight()` instead.\r\n\testimatedItemHeight,\r\n\tgetEstimatedItemHeight,\r\n\tgetEstimatedVisibleItemRowsCount,\r\n\tbypass,\r\n\t// bypassBatchSize,\r\n\ttbody,\r\n\tonItemInitialRender,\r\n\t// `onItemFirstRender(i)` is deprecated, use `onItemInitialRender(item)` instead.\r\n\tonItemFirstRender,\r\n\tinitialScrollPosition,\r\n\tonScrollPositionChange,\r\n\tmeasureItemsBatchSize,\r\n\t// `scrollableContainer` property is deprecated.\r\n\t// Use `getScrollableContainer()` property instead.\r\n\tscrollableContainer,\r\n\tgetScrollableContainer,\r\n\tgetColumnsCount,\r\n\tgetItemId,\r\n\tAsComponent,\r\n\tinitialState,\r\n\tonStateChange\r\n}, {\r\n\tcontainer\r\n}) {\r\n\treturn useMemo(() => {\r\n\t\t// Create `virtual-scroller` instance.\r\n\t\treturn new VirtualScroller(\r\n\t\t\t() => container.current,\r\n\t\t\titems,\r\n\t\t\t{\r\n\t\t\t\t_useTimeoutInRenderLoop: true,\r\n\t\t\t\t// `estimatedItemHeight` is deprecated, use `getEstimatedItemHeight()` instead.\r\n\t\t\t\testimatedItemHeight,\r\n\t\t\t\tgetEstimatedItemHeight,\r\n\t\t\t\tgetEstimatedVisibleItemRowsCount,\r\n\t\t\t\tbypass,\r\n\t\t\t\t// bypassBatchSize,\r\n\t\t\t\ttbody,\r\n\t\t\t\tonItemInitialRender,\r\n\t\t\t\t// `onItemFirstRender(i)` is deprecated, use `onItemInitialRender(item)` instead.\r\n\t\t\t\tonItemFirstRender,\r\n\t\t\t\tinitialScrollPosition,\r\n\t\t\t\tonScrollPositionChange,\r\n\t\t\t\tmeasureItemsBatchSize,\r\n\t\t\t\t// `scrollableContainer` property is deprecated.\r\n\t\t\t\t// Use `getScrollableContainer()` property instead.\r\n\t\t\t\tscrollableContainer,\r\n\t\t\t\tgetScrollableContainer,\r\n\t\t\t\tgetColumnsCount,\r\n\t\t\t\tgetItemId,\r\n\t\t\t\ttbody: AsComponent === 'tbody',\r\n\t\t\t\tstate: initialState,\r\n\t\t\t\tonStateChange\r\n\t\t\t}\r\n\t\t)\r\n\t}, [])\r\n}"],"mappings":";;AAAA,SAASA,OAAT,QAAwB,OAAxB;AAEA,OAAOC,eAAP,MAA4B,uBAA5B,C,CAEA;;AACA,eAAe,SAASC,kBAAT,cA0BZ;EAAA,IAzBFC,KAyBE,QAzBFA,KAyBE;EAAA,IAvBFC,mBAuBE,QAvBFA,mBAuBE;EAAA,IAtBFC,sBAsBE,QAtBFA,sBAsBE;EAAA,IArBFC,gCAqBE,QArBFA,gCAqBE;EAAA,IApBFC,MAoBE,QApBFA,MAoBE;EAAA,IAlBFC,KAkBE,QAlBFA,KAkBE;EAAA,IAjBFC,mBAiBE,QAjBFA,mBAiBE;EAAA,IAfFC,iBAeE,QAfFA,iBAeE;EAAA,IAdFC,qBAcE,QAdFA,qBAcE;EAAA,IAbFC,sBAaE,QAbFA,sBAaE;EAAA,IAZFC,qBAYE,QAZFA,qBAYE;EAAA,IATFC,mBASE,QATFA,mBASE;EAAA,IARFC,sBAQE,QARFA,sBAQE;EAAA,IAPFC,eAOE,QAPFA,eAOE;EAAA,IANFC,SAME,QANFA,SAME;EAAA,IALFC,WAKE,QALFA,WAKE;EAAA,IAJFC,YAIE,QAJFA,YAIE;EAAA,IAHFC,aAGE,QAHFA,aAGE;EAAA,IADFC,SACE,SADFA,SACE;EACF,OAAOrB,OAAO,CAAC,YAAM;IAAA;;IACpB;IACA,OAAO,IAAIC,eAAJ,CACN;MAAA,OAAMoB,SAAS,CAACC,OAAhB;IAAA,CADM,EAENnB,KAFM;MAILoB,uBAAuB,EAAE,IAJpB;MAKL;MACAnB,mBAAmB,EAAnBA,mBANK;MAOLC,sBAAsB,EAAtBA,sBAPK;MAQLC,gCAAgC,EAAhCA,gCARK;MASLC,MAAM,EAANA,MATK;MAUL;MACAC,KAAK,EAALA,KAXK;MAYLC,mBAAmB,EAAnBA,mBAZK;MAaL;MACAC,iBAAiB,EAAjBA,iBAdK;MAeLC,qBAAqB,EAArBA,qBAfK;MAgBLC,sBAAsB,EAAtBA,sBAhBK;MAiBLC,qBAAqB,EAArBA,qBAjBK;MAkBL;MACA;MACAC,mBAAmB,EAAnBA,mBApBK;MAqBLC,sBAAsB,EAAtBA,sBArBK;MAsBLC,eAAe,EAAfA,eAtBK;MAuBLC,SAAS,EAATA;IAvBK,8CAwBEC,WAAW,KAAK,OAxBlB,8CAyBEC,YAzBF,sDA0BLC,aA1BK,qBAAP;EA6BA,CA/Ba,EA+BX,EA/BW,CAAd;AAgCA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "virtual-scroller",
-  "version": "1.10.0",
+  "version": "1.10.2",
   "description": "A component for efficiently rendering large lists of variable height items",
   "main": "index.cjs",
   "module": "index.js",

package/source/DOM/ScrollableContainer.js

@@ -1,3 +1,5 @@
+import ScrollableContainerNotReadyError from '../ScrollableContainerNotReadyError.js'
+
 export default class ScrollableContainer {
 	/**
 	 * Constructs a new "scrollable container" from an element.
@@ -38,6 +40,9 @@ export default class ScrollableContainer {
 	 * @return {number}
 	 */
 	getWidth() {
+		if (!this.getElement()) {
+			throw new ScrollableContainerNotReadyError()
+		}
 		return this.getElement().offsetWidth
 	}
 
@@ -47,6 +52,9 @@ export default class ScrollableContainer {
 	 * @return {number}
 	 */
 	getHeight() {
+		if (!this.getElement()) {
+			throw new ScrollableContainerNotReadyError()
+		}
 		// if (!this.getElement() && !precise) {
 		// 	return getScreenHeight()
 		// }

package/source/Layout.js

@@ -1,9 +1,11 @@
 import log, { warn } from './utility/debug.js'
+import ScrollableContainerNotReadyError from './ScrollableContainerNotReadyError.js'
 
 export default class Layout {
 	constructor({
 		bypass,
-		estimatedItemHeight,
+		getInitialEstimatedItemHeight,
+		getInitialEstimatedVisibleItemRowsCount,
 		measureItemsBatchSize,
 		getPrerenderMargin,
 		getVerticalSpacing,
@@ -18,7 +20,8 @@ export default class Layout {
 		getPreviouslyCalculatedLayout
 	}) {
 		this.bypass = bypass
-		this.estimatedItemHeight = estimatedItemHeight
+		this.getInitialEstimatedItemHeight = getInitialEstimatedItemHeight
+		this.getInitialEstimatedVisibleItemRowsCount = getInitialEstimatedVisibleItemRowsCount
 		this.measureItemsBatchSize = measureItemsBatchSize
 		this.getPrerenderMargin = getPrerenderMargin
 		this.getVerticalSpacing = getVerticalSpacing
@@ -40,20 +43,49 @@ export default class Layout {
 		this.getPreviouslyCalculatedLayout = getPreviouslyCalculatedLayout
 	}
 
+	// React `<VirtualScroller/>` component attempts to create the initial state
+	// before the component tree has mounted. This could result in an inability to
+	// calculate some initial layout values like `columnsCount` or `lastShownItemIndex`.
+	// Such errors aren't considered critical because layout will be re-calculated
+	// after the component mounts. The workaround is to use some sane default values
+	// until the scrollable container has mounted.
+	getInitialLayoutValueWithFallback(name, getValue, defaultValue) {
+		try {
+			return getValue()
+		} catch (error) {
+			if (error instanceof ScrollableContainerNotReadyError) {
+				log('Couldn\'t calculate', name, 'before scrollable container is ready. Default to', defaultValue);
+				return defaultValue
+			} else {
+				throw error
+			}
+		}
+	}
+
 	getInitialLayoutValues({
 		itemsCount,
-		columnsCount
+		columnsCount,
+		beforeStart
 	}) {
 		let firstShownItemIndex
 		let lastShownItemIndex
 		// If there're no items then `firstShownItemIndex` stays `undefined`.
 		if (itemsCount > 0) {
+			const getLastShownItemIndex = () => {
+				return this.getInitialLastShownItemIndex({
+					itemsCount,
+					columnsCount,
+					firstShownItemIndex
+				})
+			}
 			firstShownItemIndex = 0
-			lastShownItemIndex = this.getInitialLastShownItemIndex({
-				itemsCount,
-				columnsCount,
-				firstShownItemIndex
-			})
+			lastShownItemIndex = beforeStart
+				? this.getInitialLayoutValueWithFallback(
+					'lastShownItemIndex',
+					getLastShownItemIndex,
+					0
+				)
+				: getLastShownItemIndex()
 		}
 		return {
 			beforeItemsHeight: 0,
@@ -77,6 +109,11 @@ export default class Layout {
 		let estimatedRowsCount = 1
 		if (this.getMaxVisibleAreaHeight()) {
 			estimatedRowsCount = this.getEstimatedRowsCountForHeight(this.getMaxVisibleAreaHeight() + this.getPrerenderMargin())
+		} else if (this.getInitialEstimatedVisibleItemRowsCount) {
+			estimatedRowsCount = this.getInitialEstimatedVisibleItemRowsCount()
+			if (isNaN(estimatedRowsCount)) {
+				throw new Error('[virtual-scroller] `getEstimatedVisibleItemRowsCount()` must return a number')
+			}
 		}
 		return Math.min(
 			firstShownItemIndex + (estimatedRowsCount * columnsCount - 1),
@@ -102,7 +139,18 @@ export default class Layout {
 	 * @return {number}
 	 */
 	getEstimatedItemHeight() {
-		return this.getAverageItemHeight() || this.estimatedItemHeight || 0
+		const averageItemHeight = this.getAverageItemHeight()
+		if (averageItemHeight) {
+			return averageItemHeight
+		}
+		if (this.getInitialEstimatedItemHeight) {
+			const estimatedItemHeight = this.getInitialEstimatedItemHeight()
+			if (isNaN(estimatedItemHeight)) {
+				throw new Error('[virtual-scroller] `getInitialEstimatedItemHeight()` must return a number')
+			}
+			return estimatedItemHeight
+		}
+		return 0
 	}
 
 	getLayoutUpdateForItemsDiff({

package/source/ScrollableContainerNotReadyError.js

@@ -0,0 +1,5 @@
+export default class ScrollableContainerNotReadyError extends Error {
+	constructor() {
+		super('[virtual-scroller] Scrollable container not found');
+	}
+}