@pega/lists-react 9.0.0-build.9.8 → 9.0.0-build.9.9

package/lib/Core/Components/Virtualise/VariableHeightVirtualizer/usePagination.d.ts

@@ -22,9 +22,9 @@ interface PaginationParams {
     /** Default height for items if not measured. */
     defaultItemHeight: number;
     /** Ref to the parent scrollable container element. */
-    parentContainerRef: RefObject<HTMLElement>;
+    parentContainerRef: RefObject<HTMLDivElement>;
     /** Ref to the container holding the rendered items. */
-    itemContainerRef: RefObject<HTMLElement>;
+    itemContainerRef: RefObject<HTMLDivElement>;
     /** Setter for the start index. */
     setStartIndex: (v: number) => void;
     /** Setter for the end index. */

package/lib/Core/Components/Virtualise/VariableHeightVirtualizer/usePagination.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"usePagination.d.ts","sourceRoot":"","sources":["../../../../../Core/Components/Virtualise/VariableHeightVirtualizer/usePagination.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEzD,OAAO,KAAK,EAAE,WAAW,EAAE,8BAA8B,EAAE,MAAM,6BAA6B,CAAC;AAG/F,UAAU,gBAAgB;IACxB,wCAAwC;IACxC,WAAW,EAAE,8BAA8B,CAAC,aAAa,CAAC,CAAC;IAC3D,sDAAsD;IACtD,EAAE,EAAE,MAAM,CAAC;IACX,gEAAgE;IAChE,MAAM,EAAE,MAAM,CAAC;IACf,iDAAiD;IACjD,eAAe,EAAE,MAAM,CAAC;IACxB,gDAAgD;IAChD,UAAU,EAAE,MAAM,CAAC;IACnB,8CAA8C;IAC9C,QAAQ,EAAE,MAAM,CAAC;IACjB,qDAAqD;IACrD,gBAAgB,EAAE,MAAM,CAAC;IACzB,kDAAkD;IAClD,cAAc,EAAE,OAAO,CAAC;IACxB,uDAAuD;IACvD,WAAW,EAAE,WAAW,CAAC;IACzB,gDAAgD;IAChD,iBAAiB,EAAE,MAAM,CAAC;IAC1B,sDAAsD;IACtD,kBAAkB,EAAE,SAAS,CAAC,WAAW,CAAC,CAAC;IAC3C,uDAAuD;IACvD,gBAAgB,EAAE,SAAS,CAAC,WAAW,CAAC,CAAC;IACzC,kCAAkC;IAClC,aAAa,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IACnC,gCAAgC;IAChC,WAAW,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IACjC,yDAAyD;IACzD,6BAA6B,EAAE,gBAAgB,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;CAChE;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,OAAO,UAAU,aAAa,CAAC,EACpC,WAAW,EACX,EAAE,EACF,MAAM,EACN,eAAe,EACf,UAAU,EACV,QAAQ,EACR,gBAAgB,EAChB,cAAc,EACd,WAAW,EACX,iBAAiB,EACjB,kBAAkB,EAClB,gBAAgB,EAChB,aAAa,EACb,WAAW,EACX,6BAA6B,EAC9B,EAAE,gBAAgB;0CAII,MAAM,iBAAiB,OAAO;;EAgDpD"}
+{"version":3,"file":"usePagination.d.ts","sourceRoot":"","sources":["../../../../../Core/Components/Virtualise/VariableHeightVirtualizer/usePagination.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEzD,OAAO,KAAK,EAAE,WAAW,EAAE,8BAA8B,EAAE,MAAM,6BAA6B,CAAC;AAG/F,UAAU,gBAAgB;IACxB,wCAAwC;IACxC,WAAW,EAAE,8BAA8B,CAAC,aAAa,CAAC,CAAC;IAC3D,sDAAsD;IACtD,EAAE,EAAE,MAAM,CAAC;IACX,gEAAgE;IAChE,MAAM,EAAE,MAAM,CAAC;IACf,iDAAiD;IACjD,eAAe,EAAE,MAAM,CAAC;IACxB,gDAAgD;IAChD,UAAU,EAAE,MAAM,CAAC;IACnB,8CAA8C;IAC9C,QAAQ,EAAE,MAAM,CAAC;IACjB,qDAAqD;IACrD,gBAAgB,EAAE,MAAM,CAAC;IACzB,kDAAkD;IAClD,cAAc,EAAE,OAAO,CAAC;IACxB,uDAAuD;IACvD,WAAW,EAAE,WAAW,CAAC;IACzB,gDAAgD;IAChD,iBAAiB,EAAE,MAAM,CAAC;IAC1B,sDAAsD;IACtD,kBAAkB,EAAE,SAAS,CAAC,cAAc,CAAC,CAAC;IAC9C,uDAAuD;IACvD,gBAAgB,EAAE,SAAS,CAAC,cAAc,CAAC,CAAC;IAC5C,kCAAkC;IAClC,aAAa,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IACnC,gCAAgC;IAChC,WAAW,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IACjC,yDAAyD;IACzD,6BAA6B,EAAE,gBAAgB,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;CAChE;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,OAAO,UAAU,aAAa,CAAC,EACpC,WAAW,EACX,EAAE,EACF,MAAM,EACN,eAAe,EACf,UAAU,EACV,QAAQ,EACR,gBAAgB,EAChB,cAAc,EACd,WAAW,EACX,iBAAiB,EACjB,kBAAkB,EAClB,gBAAgB,EAChB,aAAa,EACb,WAAW,EACX,6BAA6B,EAC9B,EAAE,gBAAgB;0CAII,MAAM,iBAAiB,OAAO;;EAgDpD"}

package/lib/Core/Components/Virtualise/VariableHeightVirtualizer/usePagination.js.map

@@ -1 +1 @@
-{"version":3,"file":"usePagination.js","sourceRoot":"","sources":["../../../../../Core/Components/Virtualise/VariableHeightVirtualizer/usePagination.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAI9C,OAAO,EAAE,YAAY,EAAE,+BAA+B,EAAE,MAAM,SAAS,CAAC;AAmCxE;;;;;;;;GAQG;AACH,MAAM,CAAC,OAAO,UAAU,aAAa,CAAC,EACpC,WAAW,EACX,EAAE,EACF,MAAM,EACN,eAAe,EACf,UAAU,EACV,QAAQ,EACR,gBAAgB,EAChB,cAAc,EACd,WAAW,EACX,iBAAiB,EACjB,kBAAkB,EAClB,gBAAgB,EAChB,aAAa,EACb,WAAW,EACX,6BAA6B,EACZ;IACjB,MAAM,CAAC,0BAA0B,EAAE,6BAA6B,CAAC,GAAG,QAAQ,CAAU,KAAK,CAAC,CAAC;IAE7F,MAAM,iBAAiB,GAAG,WAAW,CACnC,CAAC,gBAAwB,EAAE,YAAsB,EAAE,EAAE;QACnD,6BAA6B,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC;QAC9C,MAAM,EAAE,UAAU,EAAE,aAAa,EAAE,QAAQ,EAAE,WAAW,EAAE,GAAG,+BAA+B,CAAC;YAC3F,SAAS,EAAE,gBAAgB;YAC3B,YAAY,EAAE,kBAAkB;YAChC,gBAAgB;YAChB,cAAc,EAAE,gBAAgB;YAChC,WAAW;YACX,iBAAiB;YACjB,MAAM;YACN,aAAa,EAAE,eAAe;YAC9B,cAAc;SACf,CAAC,CAAC;QAEH,0BAA0B;QAC1B,IAAI,CAAC,YAAY,IAAI,QAAQ,GAAG,CAAC,IAAI,aAAa,IAAI,UAAU,IAAI,WAAW,IAAI,QAAQ,EAAE,CAAC;YAC5F,OAAO;QACT,CAAC;QAED,IAAI,gBAAgB,KAAK,CAAC,EAAE,CAAC;YAC3B,6BAA6B,CAAC,OAAO,GAAG,CAAC,CAAC;QAC5C,CAAC;aAAM,IAAI,gBAAgB,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;YACjD,MAAM,kBAAkB,GAAG,YAAY,CAAC,gBAAgB,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;YAC9E,6BAA6B,CAAC,OAAO,GAAG,kBAAkB,IAAI,CAAC,CAAC;QAClE,CAAC;QAED,aAAa,CAAC,aAAa,CAAC,CAAC;QAC7B,WAAW,CAAC,WAAW,CAAC,CAAC;QACzB,WAAW,CACT,EAAE,UAAU,EAAE,aAAa,EAAE,QAAQ,EAAE,WAAW,EAAE,EAAE,EAAE,EACxD,EAAE,gBAAgB,EAAE,IAAI,EAAE,CAC3B,CAAC;IACJ,CAAC,EACD;QACE,gBAAgB;QAChB,cAAc;QACd,MAAM;QACN,eAAe;QACf,UAAU;QACV,QAAQ;QACR,WAAW;QACX,EAAE;QACF,WAAW;QACX,iBAAiB;KAClB,CACF,CAAC;IAEF,OAAO,EAAE,iBAAiB,EAAE,0BAA0B,EAAE,CAAC;AAC3D,CAAC","sourcesContent":["import { useCallback, useState } from 'react';\nimport type { MutableRefObject, RefObject } from 'react';\n\nimport type { ItemsHeight, VariableHeightVirtualizerProps } from './VariableHeightVirtualizer';\nimport { getDataIndex, getVirtualizedPaginationIndices } from './utils';\n\ninterface PaginationParams {\n  /** Callback to fetch paginated data. */\n  apiCallback: VariableHeightVirtualizerProps['apiCallback'];\n  /** Unique identifier for the virtualizer instance. */\n  id: string;\n  /** Number of items to buffer before/after the visible range. */\n  buffer: number;\n  /** Maximum number of items to render at once. */\n  maxItemsToPaint: number;\n  /** Current start index of the visible items. */\n  startIndex: number;\n  /** Current end index of the visible items. */\n  endIndex: number;\n  /** Total number of items in the virtualized list. */\n  virtualizedCount: number;\n  /** Whether infinite scrolling mode is enabled. */\n  isInfiniteMode: boolean;\n  /** Mapping of item indices and their actual height. */\n  itemsHeight: ItemsHeight;\n  /** Default height for items if not measured. */\n  defaultItemHeight: number;\n  /** Ref to the parent scrollable container element. */\n  parentContainerRef: RefObject<HTMLElement>;\n  /** Ref to the container holding the rendered items. */\n  itemContainerRef: RefObject<HTMLElement>;\n  /** Setter for the start index. */\n  setStartIndex: (v: number) => void;\n  /** Setter for the end index. */\n  setEndIndex: (v: number) => void;\n  /** Ref to track the previous first item's data index. */\n  previousFirstItemDataIndexRef: MutableRefObject<number | null>;\n}\n\n/**\n * Calculates the indices of items to render based on the current scroll position,\n * buffer, and virtualization settings. It triggers data fetching via the provided `apiCallback`\n * when pagination boundaries change or a force refresh is requested.\n *\n * @returns An object containing:\n * - `triggerPagination`: Function to recalculate pagination indices and trigger data fetching.\n * - `isForceRefreshedPagination`: Boolean indicating if the last pagination was force-refreshed.\n */\nexport default function usePagination({\n  apiCallback,\n  id,\n  buffer,\n  maxItemsToPaint,\n  startIndex,\n  endIndex,\n  virtualizedCount,\n  isInfiniteMode,\n  itemsHeight,\n  defaultItemHeight,\n  parentContainerRef,\n  itemContainerRef,\n  setStartIndex,\n  setEndIndex,\n  previousFirstItemDataIndexRef\n}: PaginationParams) {\n  const [isForceRefreshedPagination, setIsForceRefreshedPagination] = useState<boolean>(false);\n\n  const triggerPagination = useCallback(\n    (currentScrollTop: number, forceRefresh?: boolean) => {\n      setIsForceRefreshedPagination(!!forceRefresh);\n      const { startIndex: newStartIndex, endIndex: newEndIndex } = getVirtualizedPaginationIndices({\n        scrollTop: currentScrollTop,\n        containerRef: parentContainerRef,\n        itemContainerRef,\n        totalItemCount: virtualizedCount,\n        itemsHeight,\n        defaultItemHeight,\n        buffer,\n        endIndexLimit: maxItemsToPaint,\n        isInfiniteMode\n      });\n\n      // Prevent redundant fetch\n      if (!forceRefresh && endIndex > 0 && newStartIndex >= startIndex && newEndIndex <= endIndex) {\n        return;\n      }\n\n      if (virtualizedCount === 0) {\n        previousFirstItemDataIndexRef.current = 0;\n      } else if (itemContainerRef.current?.children[0]) {\n        const firstItemDataIndex = getDataIndex(itemContainerRef.current.children[0]);\n        previousFirstItemDataIndexRef.current = firstItemDataIndex ?? 0;\n      }\n\n      setStartIndex(newStartIndex);\n      setEndIndex(newEndIndex);\n      apiCallback(\n        { startIndex: newStartIndex, endIndex: newEndIndex, id },\n        { takeLatestAction: true }\n      );\n    },\n    [\n      virtualizedCount,\n      isInfiniteMode,\n      buffer,\n      maxItemsToPaint,\n      startIndex,\n      endIndex,\n      apiCallback,\n      id,\n      itemsHeight,\n      defaultItemHeight\n    ]\n  );\n\n  return { triggerPagination, isForceRefreshedPagination };\n}\n"]}
+{"version":3,"file":"usePagination.js","sourceRoot":"","sources":["../../../../../Core/Components/Virtualise/VariableHeightVirtualizer/usePagination.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAI9C,OAAO,EAAE,YAAY,EAAE,+BAA+B,EAAE,MAAM,SAAS,CAAC;AAmCxE;;;;;;;;GAQG;AACH,MAAM,CAAC,OAAO,UAAU,aAAa,CAAC,EACpC,WAAW,EACX,EAAE,EACF,MAAM,EACN,eAAe,EACf,UAAU,EACV,QAAQ,EACR,gBAAgB,EAChB,cAAc,EACd,WAAW,EACX,iBAAiB,EACjB,kBAAkB,EAClB,gBAAgB,EAChB,aAAa,EACb,WAAW,EACX,6BAA6B,EACZ;IACjB,MAAM,CAAC,0BAA0B,EAAE,6BAA6B,CAAC,GAAG,QAAQ,CAAU,KAAK,CAAC,CAAC;IAE7F,MAAM,iBAAiB,GAAG,WAAW,CACnC,CAAC,gBAAwB,EAAE,YAAsB,EAAE,EAAE;QACnD,6BAA6B,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC;QAC9C,MAAM,EAAE,UAAU,EAAE,aAAa,EAAE,QAAQ,EAAE,WAAW,EAAE,GAAG,+BAA+B,CAAC;YAC3F,SAAS,EAAE,gBAAgB;YAC3B,YAAY,EAAE,kBAAkB;YAChC,gBAAgB;YAChB,cAAc,EAAE,gBAAgB;YAChC,WAAW;YACX,iBAAiB;YACjB,MAAM;YACN,aAAa,EAAE,eAAe;YAC9B,cAAc;SACf,CAAC,CAAC;QAEH,0BAA0B;QAC1B,IAAI,CAAC,YAAY,IAAI,QAAQ,GAAG,CAAC,IAAI,aAAa,IAAI,UAAU,IAAI,WAAW,IAAI,QAAQ,EAAE,CAAC;YAC5F,OAAO;QACT,CAAC;QAED,IAAI,gBAAgB,KAAK,CAAC,EAAE,CAAC;YAC3B,6BAA6B,CAAC,OAAO,GAAG,CAAC,CAAC;QAC5C,CAAC;aAAM,IAAI,gBAAgB,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;YACjD,MAAM,kBAAkB,GAAG,YAAY,CAAC,gBAAgB,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;YAC9E,6BAA6B,CAAC,OAAO,GAAG,kBAAkB,IAAI,CAAC,CAAC;QAClE,CAAC;QAED,aAAa,CAAC,aAAa,CAAC,CAAC;QAC7B,WAAW,CAAC,WAAW,CAAC,CAAC;QACzB,WAAW,CACT,EAAE,UAAU,EAAE,aAAa,EAAE,QAAQ,EAAE,WAAW,EAAE,EAAE,EAAE,EACxD,EAAE,gBAAgB,EAAE,IAAI,EAAE,CAC3B,CAAC;IACJ,CAAC,EACD;QACE,gBAAgB;QAChB,cAAc;QACd,MAAM;QACN,eAAe;QACf,UAAU;QACV,QAAQ;QACR,WAAW;QACX,EAAE;QACF,WAAW;QACX,iBAAiB;KAClB,CACF,CAAC;IAEF,OAAO,EAAE,iBAAiB,EAAE,0BAA0B,EAAE,CAAC;AAC3D,CAAC","sourcesContent":["import { useCallback, useState } from 'react';\nimport type { MutableRefObject, RefObject } from 'react';\n\nimport type { ItemsHeight, VariableHeightVirtualizerProps } from './VariableHeightVirtualizer';\nimport { getDataIndex, getVirtualizedPaginationIndices } from './utils';\n\ninterface PaginationParams {\n  /** Callback to fetch paginated data. */\n  apiCallback: VariableHeightVirtualizerProps['apiCallback'];\n  /** Unique identifier for the virtualizer instance. */\n  id: string;\n  /** Number of items to buffer before/after the visible range. */\n  buffer: number;\n  /** Maximum number of items to render at once. */\n  maxItemsToPaint: number;\n  /** Current start index of the visible items. */\n  startIndex: number;\n  /** Current end index of the visible items. */\n  endIndex: number;\n  /** Total number of items in the virtualized list. */\n  virtualizedCount: number;\n  /** Whether infinite scrolling mode is enabled. */\n  isInfiniteMode: boolean;\n  /** Mapping of item indices and their actual height. */\n  itemsHeight: ItemsHeight;\n  /** Default height for items if not measured. */\n  defaultItemHeight: number;\n  /** Ref to the parent scrollable container element. */\n  parentContainerRef: RefObject<HTMLDivElement>;\n  /** Ref to the container holding the rendered items. */\n  itemContainerRef: RefObject<HTMLDivElement>;\n  /** Setter for the start index. */\n  setStartIndex: (v: number) => void;\n  /** Setter for the end index. */\n  setEndIndex: (v: number) => void;\n  /** Ref to track the previous first item's data index. */\n  previousFirstItemDataIndexRef: MutableRefObject<number | null>;\n}\n\n/**\n * Calculates the indices of items to render based on the current scroll position,\n * buffer, and virtualization settings. It triggers data fetching via the provided `apiCallback`\n * when pagination boundaries change or a force refresh is requested.\n *\n * @returns An object containing:\n * - `triggerPagination`: Function to recalculate pagination indices and trigger data fetching.\n * - `isForceRefreshedPagination`: Boolean indicating if the last pagination was force-refreshed.\n */\nexport default function usePagination({\n  apiCallback,\n  id,\n  buffer,\n  maxItemsToPaint,\n  startIndex,\n  endIndex,\n  virtualizedCount,\n  isInfiniteMode,\n  itemsHeight,\n  defaultItemHeight,\n  parentContainerRef,\n  itemContainerRef,\n  setStartIndex,\n  setEndIndex,\n  previousFirstItemDataIndexRef\n}: PaginationParams) {\n  const [isForceRefreshedPagination, setIsForceRefreshedPagination] = useState<boolean>(false);\n\n  const triggerPagination = useCallback(\n    (currentScrollTop: number, forceRefresh?: boolean) => {\n      setIsForceRefreshedPagination(!!forceRefresh);\n      const { startIndex: newStartIndex, endIndex: newEndIndex } = getVirtualizedPaginationIndices({\n        scrollTop: currentScrollTop,\n        containerRef: parentContainerRef,\n        itemContainerRef,\n        totalItemCount: virtualizedCount,\n        itemsHeight,\n        defaultItemHeight,\n        buffer,\n        endIndexLimit: maxItemsToPaint,\n        isInfiniteMode\n      });\n\n      // Prevent redundant fetch\n      if (!forceRefresh && endIndex > 0 && newStartIndex >= startIndex && newEndIndex <= endIndex) {\n        return;\n      }\n\n      if (virtualizedCount === 0) {\n        previousFirstItemDataIndexRef.current = 0;\n      } else if (itemContainerRef.current?.children[0]) {\n        const firstItemDataIndex = getDataIndex(itemContainerRef.current.children[0]);\n        previousFirstItemDataIndexRef.current = firstItemDataIndex ?? 0;\n      }\n\n      setStartIndex(newStartIndex);\n      setEndIndex(newEndIndex);\n      apiCallback(\n        { startIndex: newStartIndex, endIndex: newEndIndex, id },\n        { takeLatestAction: true }\n      );\n    },\n    [\n      virtualizedCount,\n      isInfiniteMode,\n      buffer,\n      maxItemsToPaint,\n      startIndex,\n      endIndex,\n      apiCallback,\n      id,\n      itemsHeight,\n      defaultItemHeight\n    ]\n  );\n\n  return { triggerPagination, isForceRefreshedPagination };\n}\n"]}

package/lib/Core/Components/Virtualise/VariableHeightVirtualizer/utils.d.ts

@@ -4,9 +4,9 @@ interface GetVirtualizedPaginationIndicesParams {
     /** Current vertical scroll offset of the container. */
     scrollTop: number;
     /** Ref to the scrolling container element */
-    containerRef: RefObject<HTMLElement>;
+    containerRef: RefObject<HTMLDivElement>;
     /** Ref to the container holding the list items */
-    itemContainerRef: RefObject<HTMLElement>;
+    itemContainerRef: RefObject<HTMLDivElement>;
     /** Total number of items. */
     totalItemCount: number;
     /** Mapping of item indices and their actual height. */
@@ -64,7 +64,7 @@ export declare const getOffsetForIndex: (index: number, itemsHeight: ItemsHeight
  * @param renderHeader - Indicates whether a header is rendered at the top of the parent container.
  * @returns `true` if the view is not filled with all items, `false` otherwise.
  */
-export declare const isViewNotFilled: (totalItemCount: number, itemContainer: HTMLElement, parentContainer: HTMLElement, renderHeader: boolean) => boolean;
+export declare const isViewNotFilled: (totalItemCount: number, itemContainer: HTMLDivElement, parentContainer: HTMLDivElement, renderHeader: boolean) => boolean;
 /**
  * Retrieves the numeric data index from the `data-index` attribute of a given Element.
  *
@@ -81,7 +81,7 @@ export declare const getDataIndex: (element: Element) => number | null;
  * @param defaultItemHeight - The default height to use for items not present in `itemsHeight`.
  * @returns An object mapping item indices to their new heights for items whose heights have changed.
  */
-export declare function getChangedItemsHeight(itemContainer: HTMLElement, itemsHeight: ItemsHeight, defaultItemHeight: number): ItemsHeight;
+export declare function getChangedItemsHeight(itemContainer: HTMLDivElement, itemsHeight: ItemsHeight, defaultItemHeight: number): ItemsHeight;
 /**
  * Calculates the cumulative change in item heights between two sets of item height data,
  * for a range of items starting from `startIndex` up to (but not including) `previousFirstItemDataIndex`.
@@ -107,6 +107,6 @@ export declare const calculateCumulativeItemSizeChange: (startIndex: number, pre
  * @param defaultItemHeight - The default height to use for items without a specified height.
  * @returns The total height of all items within the container, rounded down to the nearest integer.
  */
-export declare const updateItemPositionStyles: (itemContainer: HTMLElement, itemsHeight: ItemsHeight, defaultItemHeight: number) => number;
+export declare const updateItemPositionStyles: (itemContainer: HTMLDivElement, itemsHeight: ItemsHeight, defaultItemHeight: number) => number;
 export {};
 //# sourceMappingURL=utils.d.ts.map

package/lib/Core/Components/Virtualise/VariableHeightVirtualizer/utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../../../Core/Components/Virtualise/VariableHeightVirtualizer/utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAIvC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAE/D,UAAU,qCAAqC;IAC7C,uDAAuD;IACvD,SAAS,EAAE,MAAM,CAAC;IAClB,6CAA6C;IAC7C,YAAY,EAAE,SAAS,CAAC,WAAW,CAAC,CAAC;IACrC,kDAAkD;IAClD,gBAAgB,EAAE,SAAS,CAAC,WAAW,CAAC,CAAC;IAEzC,6BAA6B;IAC7B,cAAc,EAAE,MAAM,CAAC;IACvB,uDAAuD;IACvD,WAAW,EAAE,WAAW,CAAC;IACzB,gDAAgD;IAChD,iBAAiB,EAAE,MAAM,CAAC;IAE1B,iGAAiG;IACjG,MAAM,EAAE,MAAM,CAAC;IACf,6CAA6C;IAC7C,aAAa,EAAE,MAAM,CAAC;IACtB,+FAA+F;IAC/F,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED;;;;GAIG;AACH,eAAO,MAAM,+BAA+B,GAC1C,OAAO,qCAAqC,KAC3C;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAgDxC,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,0BAA0B,GACrC,gBAAgB,MAAM,EACtB,aAAa,WAAW,EACxB,mBAAmB,MAAM,KACxB,MAOF,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,YAAY,GAAI,eAAe,MAAM,GAAG,MAAM,GAAG,IAAI,KAAG,MAGpE,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,iBAAiB,GAC5B,OAAO,MAAM,EACb,aAAa,WAAW,EACxB,mBAAmB,MAAM,KACxB,MAOF,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,eAAe,GAC1B,gBAAgB,MAAM,EACtB,eAAe,WAAW,EAC1B,iBAAiB,WAAW,EAC5B,cAAc,OAAO,KACpB,OA2BF,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,YAAY,GAAI,SAAS,OAAO,KAAG,MAAM,GAAG,IAKxD,CAAC;AAEF;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CACnC,aAAa,EAAE,WAAW,EAC1B,WAAW,EAAE,WAAW,EACxB,iBAAiB,EAAE,MAAM,GACxB,WAAW,CAkBb;AAED;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,iCAAiC,GAC5C,YAAY,MAAM,EAClB,4BAA4B,MAAM,GAAG,IAAI,EACzC,aAAa,WAAW,EACxB,qBAAqB,WAAW,EAChC,mBAAmB,MAAM,KACxB,MAiBF,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,wBAAwB,GACnC,eAAe,WAAW,EAC1B,aAAa,WAAW,EACxB,mBAAmB,MAAM,KACxB,MAwBF,CAAC"}
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../../../Core/Components/Virtualise/VariableHeightVirtualizer/utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAKvC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAE/D,UAAU,qCAAqC;IAC7C,uDAAuD;IACvD,SAAS,EAAE,MAAM,CAAC;IAClB,6CAA6C;IAC7C,YAAY,EAAE,SAAS,CAAC,cAAc,CAAC,CAAC;IACxC,kDAAkD;IAClD,gBAAgB,EAAE,SAAS,CAAC,cAAc,CAAC,CAAC;IAE5C,6BAA6B;IAC7B,cAAc,EAAE,MAAM,CAAC;IACvB,uDAAuD;IACvD,WAAW,EAAE,WAAW,CAAC;IACzB,gDAAgD;IAChD,iBAAiB,EAAE,MAAM,CAAC;IAE1B,iGAAiG;IACjG,MAAM,EAAE,MAAM,CAAC;IACf,6CAA6C;IAC7C,aAAa,EAAE,MAAM,CAAC;IACtB,+FAA+F;IAC/F,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED;;;;GAIG;AACH,eAAO,MAAM,+BAA+B,GAC1C,OAAO,qCAAqC,KAC3C;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAgDxC,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,0BAA0B,GACrC,gBAAgB,MAAM,EACtB,aAAa,WAAW,EACxB,mBAAmB,MAAM,KACxB,MAOF,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,YAAY,GAAI,eAAe,MAAM,GAAG,MAAM,GAAG,IAAI,KAAG,MAGpE,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,iBAAiB,GAC5B,OAAO,MAAM,EACb,aAAa,WAAW,EACxB,mBAAmB,MAAM,KACxB,MAOF,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,eAAe,GAC1B,gBAAgB,MAAM,EACtB,eAAe,cAAc,EAC7B,iBAAiB,cAAc,EAC/B,cAAc,OAAO,KACpB,OAyBF,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,YAAY,GAAI,SAAS,OAAO,KAAG,MAAM,GAAG,IAKxD,CAAC;AAEF;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CACnC,aAAa,EAAE,cAAc,EAC7B,WAAW,EAAE,WAAW,EACxB,iBAAiB,EAAE,MAAM,GACxB,WAAW,CAkBb;AAED;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,iCAAiC,GAC5C,YAAY,MAAM,EAClB,4BAA4B,MAAM,GAAG,IAAI,EACzC,aAAa,WAAW,EACxB,qBAAqB,WAAW,EAChC,mBAAmB,MAAM,KACxB,MAiBF,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,wBAAwB,GACnC,eAAe,cAAc,EAC7B,aAAa,WAAW,EACxB,mBAAmB,MAAM,KACxB,MAwBF,CAAC"}

package/lib/Core/Components/Virtualise/VariableHeightVirtualizer/utils.js

@@ -1,4 +1,5 @@
 import { getScrollbarWidth } from 'pega-repeating-structures-core';
+import { isInstance } from '@pega/cosmos-react-core';
 /**
  * Calculates the start and end indices for virtualized pagination in a variable-height list.
  *
@@ -93,12 +94,12 @@ export const isViewNotFilled = (totalItemCount, itemContainer, parentContainer,
     let headerHeight = 0;
     if (renderHeader && parentContainer.childElementCount > 1) {
         const firstChild = parentContainer.children[0];
-        if (firstChild instanceof HTMLElement) {
+        if (isInstance(firstChild, HTMLDivElement)) {
             headerHeight = firstChild.offsetHeight;
         }
     }
     const scrollbarWidth = getScrollbarWidth();
-    const items = Array.from(itemContainer.children).filter((el) => el instanceof HTMLElement);
+    const items = Array.from(itemContainer.children);
     if (!items.length && !totalItemCount)
         return false;
     if (!items.length && totalItemCount)
@@ -200,8 +201,8 @@ export const updateItemPositionStyles = (itemContainer, itemsHeight, defaultItem
     itemContainer.style.top = `${offset}px`;
     let itemContainerCurrentHeight = 0;
     let currentItemIndex = firstItemDataIndex;
-    Array.from(items).forEach((item) => {
-        if (!(item instanceof HTMLElement))
+    Array.from(items).forEach(item => {
+        if (!isInstance(item, HTMLDivElement))
             return;
         item.style.position = 'absolute';
         item.style.top = `${itemContainerCurrentHeight}px`;

package/lib/Core/Components/Virtualise/VariableHeightVirtualizer/utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../../../../Core/Components/Virtualise/VariableHeightVirtualizer/utils.ts"],"names":[],"mappings":"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","sourcesContent":["import type { RefObject } from 'react';\n\nimport { getScrollbarWidth } from 'pega-repeating-structures-core';\n\nimport type { ItemsHeight } from './VariableHeightVirtualizer';\n\ninterface GetVirtualizedPaginationIndicesParams {\n  /** Current vertical scroll offset of the container. */\n  scrollTop: number;\n  /** Ref to the scrolling container element */\n  containerRef: RefObject<HTMLElement>;\n  /** Ref to the container holding the list items */\n  itemContainerRef: RefObject<HTMLElement>;\n\n  /** Total number of items. */\n  totalItemCount: number;\n  /** Mapping of item indices and their actual height. */\n  itemsHeight: ItemsHeight;\n  /** Default height for items if not measured. */\n  defaultItemHeight: number;\n\n  /** Number of extra items to render above and below the visible viewport for smooth scrolling. */\n  buffer: number;\n  /** Maximum allowed end index (exclusive). */\n  endIndexLimit: number;\n  /** If true, allows indices to exceed totalCount for infinite scrolling by including buffer. */\n  isInfiniteMode?: boolean;\n}\n\n/**\n * Calculates the start and end indices for virtualized pagination in a variable-height list.\n *\n * @returns {{ startIndex: number, endIndex: number }} Object containing the calculated start and end indices for rendering (inclusive both indices).\n */\nexport const getVirtualizedPaginationIndices = (\n  param: GetVirtualizedPaginationIndicesParams\n): { startIndex: number; endIndex: number } => {\n  const {\n    totalItemCount,\n    buffer,\n    itemContainerRef,\n    scrollTop,\n    containerRef,\n    itemsHeight,\n    defaultItemHeight,\n    endIndexLimit,\n    isInfiniteMode\n  } = param;\n\n  const minimumItemsToFetchOnTop = buffer * 4;\n  if (totalItemCount === 0 || itemContainerRef.current?.childElementCount === 0) {\n    return { startIndex: 0, endIndex: minimumItemsToFetchOnTop };\n  }\n\n  const viewportHeight = containerRef.current?.clientHeight || 0;\n\n  // Find the first visible item index for the current scroll position\n  let aboveTheFoldItemsHeight = 0;\n  let visibleStartIndex = 0;\n  while (\n    visibleStartIndex < totalItemCount &&\n    aboveTheFoldItemsHeight + (itemsHeight[visibleStartIndex] ?? defaultItemHeight) < scrollTop\n  ) {\n    aboveTheFoldItemsHeight += itemsHeight[visibleStartIndex] ?? defaultItemHeight;\n    visibleStartIndex += 1;\n  }\n\n  // Find the last visible item index for the current scroll position\n  let inViewItemsHeight = 0;\n  let visibleEndIndex = visibleStartIndex;\n  while (visibleEndIndex < totalItemCount && inViewItemsHeight < viewportHeight) {\n    inViewItemsHeight += itemsHeight[visibleEndIndex] ?? defaultItemHeight;\n    visibleEndIndex += 1;\n  }\n\n  const startIndex = Math.max(0, visibleStartIndex - buffer);\n  let endIndex = Math.min(visibleEndIndex + buffer, endIndexLimit - 1);\n  if (isInfiniteMode) {\n    endIndex = Math.max(endIndex, minimumItemsToFetchOnTop);\n  } else {\n    // In cases where the count is very less due to filters, we would fetch more items to avoid unnecessary API calls if the count after the filter removed is more\n    endIndex = Math.max(Math.min(totalItemCount - 1, endIndex), minimumItemsToFetchOnTop);\n  }\n  return { startIndex, endIndex };\n};\n\n/**\n * Calculates the total buffer height for a list of items, using their individual heights if available,\n * or a default height otherwise.\n *\n * @param totalItemCount - The total number of items in the list.\n * @param itemsHeight - An object or array containing the heights of individual items, indexed by item position.\n * @param defaultItemHeight - The default height to use for items whose height is not specified in `itemsHeight`.\n * @returns The sum of all item heights, using the default height for any missing values.\n */\nexport const calculateTotalBufferHeight = (\n  totalItemCount: number,\n  itemsHeight: ItemsHeight,\n  defaultItemHeight: number\n): number => {\n  let totalBufferHeight = 0;\n  for (let i = 0; i < totalItemCount; i += 1) {\n    totalBufferHeight += itemsHeight[i] || defaultItemHeight;\n  }\n\n  return totalBufferHeight;\n};\n\n/**\n * Returns a CSS-compatible max-height value based on the input.\n *\n * @param viewMaxHeight - The maximum height value, which can be a number (pixels), a string (CSS value), or `null`.\n * @returns A string representing the CSS max-height value.\n */\nexport const getMaxHeight = (viewMaxHeight: number | string | null): string => {\n  if (!viewMaxHeight) return 'none';\n  return typeof viewMaxHeight === 'number' ? `${viewMaxHeight}px` : viewMaxHeight;\n};\n\n/**\n * Calculates the vertical offset for a given item index in a list with variable item heights.\n *\n * @param index - The index of the item for which to calculate the offset.\n * @param itemsHeight - Mapping of item indices and their actual height.\n * @param defaultItemHeight - The default height to use for items not present in the cache.\n * @returns The total offset (in pixels) from the top of the list to the specified index.\n */\nexport const getOffsetForIndex = (\n  index: number,\n  itemsHeight: ItemsHeight,\n  defaultItemHeight: number\n): number => {\n  let offset = 0;\n\n  for (let i = 0; i < index; i += 1) {\n    offset += itemsHeight[i] ?? defaultItemHeight;\n  }\n  return offset;\n};\n\n/**\n * Determines whether the viewable area of a virtualized list is not fully filled with rendered items.\n *\n * @param totalItemCount - The total number of items that should be rendered.\n * @param itemContainer - The HTML element containing the rendered items.\n * @param parentContainer - The parent HTML element that contains the items and possibly the header.\n * @param renderHeader - Indicates whether a header is rendered at the top of the parent container.\n * @returns `true` if the view is not filled with all items, `false` otherwise.\n */\nexport const isViewNotFilled = (\n  totalItemCount: number,\n  itemContainer: HTMLElement,\n  parentContainer: HTMLElement,\n  renderHeader: boolean\n): boolean => {\n  const parentContainerPosition = parentContainer.getBoundingClientRect();\n  let headerHeight = 0;\n  if (renderHeader && parentContainer.childElementCount > 1) {\n    const firstChild = parentContainer.children[0];\n    if (firstChild instanceof HTMLElement) {\n      headerHeight = firstChild.offsetHeight;\n    }\n  }\n\n  const scrollbarWidth = getScrollbarWidth();\n  const items = Array.from(itemContainer.children).filter(\n    (el): el is HTMLElement => el instanceof HTMLElement\n  );\n\n  if (!items.length && !totalItemCount) return false;\n  if (!items.length && totalItemCount) return true;\n\n  return (\n    !!totalItemCount &&\n    items.length !== totalItemCount &&\n    (Math.floor(items[items.length - 1].getBoundingClientRect().bottom) <\n      Math.floor(parentContainerPosition.bottom - scrollbarWidth) ||\n      Math.floor(items[0].getBoundingClientRect().top) >\n        Math.floor(parentContainerPosition.top + headerHeight) ||\n      items.length === 0)\n  );\n};\n\n/**\n * Retrieves the numeric data index from the `data-index` attribute of a given Element.\n *\n * @param element - The Element from which to extract the data index.\n * @returns The parsed integer value of the `data-index` attribute, or `null` if the attribute is not present.\n */\nexport const getDataIndex = (element: Element): number | null => {\n  const dataIndexStr = element?.getAttribute('data-index');\n  if (!dataIndexStr) return null;\n  const parsedDataIndex = parseInt(dataIndexStr, 10);\n  return Number.isNaN(parsedDataIndex) ? null : parsedDataIndex;\n};\n\n/**\n * Calculates and returns an object containing the heights of items whose heights have changed\n * compared to their previous values.\n *\n * @param itemContainer - The container HTMLElement whose child nodes represent items to measure.\n * @param itemsHeight - An object mapping item indices to their measured heights.\n * @param defaultItemHeight - The default height to use for items not present in `itemsHeight`.\n * @returns An object mapping item indices to their new heights for items whose heights have changed.\n */\nexport function getChangedItemsHeight(\n  itemContainer: HTMLElement,\n  itemsHeight: ItemsHeight,\n  defaultItemHeight: number\n): ItemsHeight {\n  if (!itemContainer) return {};\n\n  const newHeights: ItemsHeight = {};\n  const nodes = Array.from(itemContainer.children);\n\n  nodes.forEach(node => {\n    const itemDataIndex = getDataIndex(node);\n    if (itemDataIndex === null) return;\n\n    const measuredHeight = node.getBoundingClientRect().height;\n    const prevHeight = itemsHeight[itemDataIndex] ?? defaultItemHeight;\n    if (measuredHeight !== prevHeight) {\n      newHeights[itemDataIndex] = measuredHeight;\n    }\n  });\n\n  return newHeights;\n}\n\n/**\n * Calculates the cumulative change in item heights between two sets of item height data,\n * for a range of items starting from `startIndex` up to (but not including) `previousFirstItemDataIndex`.\n *\n * This function compares the current heights (`itemsHeight`) with the previous heights (`previousItemsHeight`)\n * for each item in the specified range, using `defaultItemHeight` as a fallback if a previous height is missing.\n * The result is the sum of the differences in height for all items in the range.\n *\n * @param startIndex - The index at which to start calculating the cumulative height change.\n * @param previousFirstItemDataIndex - The index up to which to calculate (exclusive). If `null` or less than or equal to 0, returns 0.\n * @param itemsHeight - An object mapping item indices to their measured heights.\n * @param previousItemsHeight - An object mapping item indices of previously rendered items to their heights.\n * @param defaultItemHeight - The default height to use if a previous height is not available.\n * @returns The cumulative change in item heights for the specified range, or 0 if the result is not finite.\n */\nexport const calculateCumulativeItemSizeChange = (\n  startIndex: number,\n  previousFirstItemDataIndex: number | null,\n  itemsHeight: ItemsHeight,\n  previousItemsHeight: ItemsHeight,\n  defaultItemHeight: number\n): number => {\n  if (previousFirstItemDataIndex === null || previousFirstItemDataIndex <= 0) {\n    return 0;\n  }\n\n  let delta = 0;\n\n  for (let i = startIndex; i < previousFirstItemDataIndex; i += 1) {\n    const actualHeight = itemsHeight[i];\n    const previousHeight = previousItemsHeight[i] ?? defaultItemHeight;\n\n    if (actualHeight !== null && actualHeight !== undefined) {\n      delta += actualHeight - previousHeight;\n    }\n  }\n\n  return Number.isFinite(delta) ? delta : 0;\n};\n\n/**\n * Updates the position styles of child items within a container element to enable virtualized rendering.\n * Sets the container's top offset and positions each child absolutely based on their calculated heights.\n *\n * @param itemContainer - The HTML element containing the list items to be positioned.\n * @param itemsHeight - An object mapping item indices to their measured heights.\n * @param defaultItemHeight - The default height to use for items without a specified height.\n * @returns The total height of all items within the container, rounded down to the nearest integer.\n */\nexport const updateItemPositionStyles = (\n  itemContainer: HTMLElement,\n  itemsHeight: ItemsHeight,\n  defaultItemHeight: number\n): number => {\n  const items = itemContainer.children;\n  if (!items?.length) {\n    return 0;\n  }\n\n  const firstItemDataIndex = getDataIndex(items[0]);\n  if (firstItemDataIndex === null) return 0;\n\n  const offset = getOffsetForIndex(firstItemDataIndex, itemsHeight, defaultItemHeight);\n  itemContainer.style.top = `${offset}px`;\n\n  let itemContainerCurrentHeight = 0;\n  let currentItemIndex = firstItemDataIndex;\n  Array.from(items).forEach((item: Element) => {\n    if (!(item instanceof HTMLElement)) return;\n\n    item.style.position = 'absolute';\n    item.style.top = `${itemContainerCurrentHeight}px`;\n    itemContainerCurrentHeight += itemsHeight[currentItemIndex] ?? defaultItemHeight;\n    currentItemIndex += 1;\n  });\n\n  return Math.floor(itemContainerCurrentHeight);\n};\n"]}
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../../../../Core/Components/Virtualise/VariableHeightVirtualizer/utils.ts"],"names":[],"mappings":"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","sourcesContent":["import type { RefObject } from 'react';\n\nimport { getScrollbarWidth } from 'pega-repeating-structures-core';\nimport { isInstance } from '@pega/cosmos-react-core';\n\nimport type { ItemsHeight } from './VariableHeightVirtualizer';\n\ninterface GetVirtualizedPaginationIndicesParams {\n  /** Current vertical scroll offset of the container. */\n  scrollTop: number;\n  /** Ref to the scrolling container element */\n  containerRef: RefObject<HTMLDivElement>;\n  /** Ref to the container holding the list items */\n  itemContainerRef: RefObject<HTMLDivElement>;\n\n  /** Total number of items. */\n  totalItemCount: number;\n  /** Mapping of item indices and their actual height. */\n  itemsHeight: ItemsHeight;\n  /** Default height for items if not measured. */\n  defaultItemHeight: number;\n\n  /** Number of extra items to render above and below the visible viewport for smooth scrolling. */\n  buffer: number;\n  /** Maximum allowed end index (exclusive). */\n  endIndexLimit: number;\n  /** If true, allows indices to exceed totalCount for infinite scrolling by including buffer. */\n  isInfiniteMode?: boolean;\n}\n\n/**\n * Calculates the start and end indices for virtualized pagination in a variable-height list.\n *\n * @returns {{ startIndex: number, endIndex: number }} Object containing the calculated start and end indices for rendering (inclusive both indices).\n */\nexport const getVirtualizedPaginationIndices = (\n  param: GetVirtualizedPaginationIndicesParams\n): { startIndex: number; endIndex: number } => {\n  const {\n    totalItemCount,\n    buffer,\n    itemContainerRef,\n    scrollTop,\n    containerRef,\n    itemsHeight,\n    defaultItemHeight,\n    endIndexLimit,\n    isInfiniteMode\n  } = param;\n\n  const minimumItemsToFetchOnTop = buffer * 4;\n  if (totalItemCount === 0 || itemContainerRef.current?.childElementCount === 0) {\n    return { startIndex: 0, endIndex: minimumItemsToFetchOnTop };\n  }\n\n  const viewportHeight = containerRef.current?.clientHeight || 0;\n\n  // Find the first visible item index for the current scroll position\n  let aboveTheFoldItemsHeight = 0;\n  let visibleStartIndex = 0;\n  while (\n    visibleStartIndex < totalItemCount &&\n    aboveTheFoldItemsHeight + (itemsHeight[visibleStartIndex] ?? defaultItemHeight) < scrollTop\n  ) {\n    aboveTheFoldItemsHeight += itemsHeight[visibleStartIndex] ?? defaultItemHeight;\n    visibleStartIndex += 1;\n  }\n\n  // Find the last visible item index for the current scroll position\n  let inViewItemsHeight = 0;\n  let visibleEndIndex = visibleStartIndex;\n  while (visibleEndIndex < totalItemCount && inViewItemsHeight < viewportHeight) {\n    inViewItemsHeight += itemsHeight[visibleEndIndex] ?? defaultItemHeight;\n    visibleEndIndex += 1;\n  }\n\n  const startIndex = Math.max(0, visibleStartIndex - buffer);\n  let endIndex = Math.min(visibleEndIndex + buffer, endIndexLimit - 1);\n  if (isInfiniteMode) {\n    endIndex = Math.max(endIndex, minimumItemsToFetchOnTop);\n  } else {\n    // In cases where the count is very less due to filters, we would fetch more items to avoid unnecessary API calls if the count after the filter removed is more\n    endIndex = Math.max(Math.min(totalItemCount - 1, endIndex), minimumItemsToFetchOnTop);\n  }\n  return { startIndex, endIndex };\n};\n\n/**\n * Calculates the total buffer height for a list of items, using their individual heights if available,\n * or a default height otherwise.\n *\n * @param totalItemCount - The total number of items in the list.\n * @param itemsHeight - An object or array containing the heights of individual items, indexed by item position.\n * @param defaultItemHeight - The default height to use for items whose height is not specified in `itemsHeight`.\n * @returns The sum of all item heights, using the default height for any missing values.\n */\nexport const calculateTotalBufferHeight = (\n  totalItemCount: number,\n  itemsHeight: ItemsHeight,\n  defaultItemHeight: number\n): number => {\n  let totalBufferHeight = 0;\n  for (let i = 0; i < totalItemCount; i += 1) {\n    totalBufferHeight += itemsHeight[i] || defaultItemHeight;\n  }\n\n  return totalBufferHeight;\n};\n\n/**\n * Returns a CSS-compatible max-height value based on the input.\n *\n * @param viewMaxHeight - The maximum height value, which can be a number (pixels), a string (CSS value), or `null`.\n * @returns A string representing the CSS max-height value.\n */\nexport const getMaxHeight = (viewMaxHeight: number | string | null): string => {\n  if (!viewMaxHeight) return 'none';\n  return typeof viewMaxHeight === 'number' ? `${viewMaxHeight}px` : viewMaxHeight;\n};\n\n/**\n * Calculates the vertical offset for a given item index in a list with variable item heights.\n *\n * @param index - The index of the item for which to calculate the offset.\n * @param itemsHeight - Mapping of item indices and their actual height.\n * @param defaultItemHeight - The default height to use for items not present in the cache.\n * @returns The total offset (in pixels) from the top of the list to the specified index.\n */\nexport const getOffsetForIndex = (\n  index: number,\n  itemsHeight: ItemsHeight,\n  defaultItemHeight: number\n): number => {\n  let offset = 0;\n\n  for (let i = 0; i < index; i += 1) {\n    offset += itemsHeight[i] ?? defaultItemHeight;\n  }\n  return offset;\n};\n\n/**\n * Determines whether the viewable area of a virtualized list is not fully filled with rendered items.\n *\n * @param totalItemCount - The total number of items that should be rendered.\n * @param itemContainer - The HTML element containing the rendered items.\n * @param parentContainer - The parent HTML element that contains the items and possibly the header.\n * @param renderHeader - Indicates whether a header is rendered at the top of the parent container.\n * @returns `true` if the view is not filled with all items, `false` otherwise.\n */\nexport const isViewNotFilled = (\n  totalItemCount: number,\n  itemContainer: HTMLDivElement,\n  parentContainer: HTMLDivElement,\n  renderHeader: boolean\n): boolean => {\n  const parentContainerPosition = parentContainer.getBoundingClientRect();\n  let headerHeight = 0;\n  if (renderHeader && parentContainer.childElementCount > 1) {\n    const firstChild = parentContainer.children[0];\n    if (isInstance(firstChild, HTMLDivElement)) {\n      headerHeight = firstChild.offsetHeight;\n    }\n  }\n\n  const scrollbarWidth = getScrollbarWidth();\n  const items = Array.from(itemContainer.children);\n\n  if (!items.length && !totalItemCount) return false;\n  if (!items.length && totalItemCount) return true;\n\n  return (\n    !!totalItemCount &&\n    items.length !== totalItemCount &&\n    (Math.floor(items[items.length - 1].getBoundingClientRect().bottom) <\n      Math.floor(parentContainerPosition.bottom - scrollbarWidth) ||\n      Math.floor(items[0].getBoundingClientRect().top) >\n        Math.floor(parentContainerPosition.top + headerHeight) ||\n      items.length === 0)\n  );\n};\n\n/**\n * Retrieves the numeric data index from the `data-index` attribute of a given Element.\n *\n * @param element - The Element from which to extract the data index.\n * @returns The parsed integer value of the `data-index` attribute, or `null` if the attribute is not present.\n */\nexport const getDataIndex = (element: Element): number | null => {\n  const dataIndexStr = element?.getAttribute('data-index');\n  if (!dataIndexStr) return null;\n  const parsedDataIndex = parseInt(dataIndexStr, 10);\n  return Number.isNaN(parsedDataIndex) ? null : parsedDataIndex;\n};\n\n/**\n * Calculates and returns an object containing the heights of items whose heights have changed\n * compared to their previous values.\n *\n * @param itemContainer - The container HTMLElement whose child nodes represent items to measure.\n * @param itemsHeight - An object mapping item indices to their measured heights.\n * @param defaultItemHeight - The default height to use for items not present in `itemsHeight`.\n * @returns An object mapping item indices to their new heights for items whose heights have changed.\n */\nexport function getChangedItemsHeight(\n  itemContainer: HTMLDivElement,\n  itemsHeight: ItemsHeight,\n  defaultItemHeight: number\n): ItemsHeight {\n  if (!itemContainer) return {};\n\n  const newHeights: ItemsHeight = {};\n  const nodes = Array.from(itemContainer.children);\n\n  nodes.forEach(node => {\n    const itemDataIndex = getDataIndex(node);\n    if (itemDataIndex === null) return;\n\n    const measuredHeight = node.getBoundingClientRect().height;\n    const prevHeight = itemsHeight[itemDataIndex] ?? defaultItemHeight;\n    if (measuredHeight !== prevHeight) {\n      newHeights[itemDataIndex] = measuredHeight;\n    }\n  });\n\n  return newHeights;\n}\n\n/**\n * Calculates the cumulative change in item heights between two sets of item height data,\n * for a range of items starting from `startIndex` up to (but not including) `previousFirstItemDataIndex`.\n *\n * This function compares the current heights (`itemsHeight`) with the previous heights (`previousItemsHeight`)\n * for each item in the specified range, using `defaultItemHeight` as a fallback if a previous height is missing.\n * The result is the sum of the differences in height for all items in the range.\n *\n * @param startIndex - The index at which to start calculating the cumulative height change.\n * @param previousFirstItemDataIndex - The index up to which to calculate (exclusive). If `null` or less than or equal to 0, returns 0.\n * @param itemsHeight - An object mapping item indices to their measured heights.\n * @param previousItemsHeight - An object mapping item indices of previously rendered items to their heights.\n * @param defaultItemHeight - The default height to use if a previous height is not available.\n * @returns The cumulative change in item heights for the specified range, or 0 if the result is not finite.\n */\nexport const calculateCumulativeItemSizeChange = (\n  startIndex: number,\n  previousFirstItemDataIndex: number | null,\n  itemsHeight: ItemsHeight,\n  previousItemsHeight: ItemsHeight,\n  defaultItemHeight: number\n): number => {\n  if (previousFirstItemDataIndex === null || previousFirstItemDataIndex <= 0) {\n    return 0;\n  }\n\n  let delta = 0;\n\n  for (let i = startIndex; i < previousFirstItemDataIndex; i += 1) {\n    const actualHeight = itemsHeight[i];\n    const previousHeight = previousItemsHeight[i] ?? defaultItemHeight;\n\n    if (actualHeight !== null && actualHeight !== undefined) {\n      delta += actualHeight - previousHeight;\n    }\n  }\n\n  return Number.isFinite(delta) ? delta : 0;\n};\n\n/**\n * Updates the position styles of child items within a container element to enable virtualized rendering.\n * Sets the container's top offset and positions each child absolutely based on their calculated heights.\n *\n * @param itemContainer - The HTML element containing the list items to be positioned.\n * @param itemsHeight - An object mapping item indices to their measured heights.\n * @param defaultItemHeight - The default height to use for items without a specified height.\n * @returns The total height of all items within the container, rounded down to the nearest integer.\n */\nexport const updateItemPositionStyles = (\n  itemContainer: HTMLDivElement,\n  itemsHeight: ItemsHeight,\n  defaultItemHeight: number\n): number => {\n  const items = itemContainer.children;\n  if (!items?.length) {\n    return 0;\n  }\n\n  const firstItemDataIndex = getDataIndex(items[0]);\n  if (firstItemDataIndex === null) return 0;\n\n  const offset = getOffsetForIndex(firstItemDataIndex, itemsHeight, defaultItemHeight);\n  itemContainer.style.top = `${offset}px`;\n\n  let itemContainerCurrentHeight = 0;\n  let currentItemIndex = firstItemDataIndex;\n  Array.from(items).forEach(item => {\n    if (!isInstance(item, HTMLDivElement)) return;\n\n    item.style.position = 'absolute';\n    item.style.top = `${itemContainerCurrentHeight}px`;\n    itemContainerCurrentHeight += itemsHeight[currentItemIndex] ?? defaultItemHeight;\n    currentItemIndex += 1;\n  });\n\n  return Math.floor(itemContainerCurrentHeight);\n};\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pega/lists-react",
-  "version": "9.0.0-build.9.8",
+  "version": "9.0.0-build.9.9",
   "description": "Repeating view structures such as Table, Gallery(Repeating layouts), Kanban etc.",
   "license": "SEE LICENSE IN LICENSE",
   "author": "Pegasystems",
@@ -14,9 +14,9 @@
     "build": "tsc -b tsconfig.build.json"
   },
   "dependencies": {
-    "@pega/cosmos-react-condition-builder": "9.0.0-build.9.8",
-    "@pega/cosmos-react-core": "9.0.0-build.9.8",
-    "@pega/cosmos-react-rte": "9.0.0-build.9.8",
+    "@pega/cosmos-react-condition-builder": "9.0.0-build.9.9",
+    "@pega/cosmos-react-core": "9.0.0-build.9.9",
+    "@pega/cosmos-react-rte": "9.0.0-build.9.9",
     "@types/lodash.get": "^4.4.9",
     "@types/react": "^17.0.62 || ^18.3.3",
     "@types/react-dom": "^17.0.20 || ^18.3.0",
@@ -24,8 +24,8 @@
     "dayjs": "^1.11.13",
     "fast-deep-equal": "^3.1.3",
     "lodash.get": "^4.4.2",
-    "pega-repeating-structures-core": "npm:@pega/lists-core@9.0.0-build.9.8",
-    "pega-ui-list-data-apis": "npm:@pega/lists-core-utils@9.0.0-build.9.8",
+    "pega-repeating-structures-core": "npm:@pega/lists-core@9.0.0-build.9.9",
+    "pega-ui-list-data-apis": "npm:@pega/lists-core-utils@9.0.0-build.9.9",
     "polished": "^4.1.0",
     "prop-types": "^15.8.1",
     "react": "^17.0.0 || ^18.0.0",
@@ -44,7 +44,7 @@
     "@testing-library/react": "^16.0.0",
     "@testing-library/user-event": "^14.6.1",
     "jest-axe": "^8.0.0",
-    "srs-utils": "9.0.0-build.9.8",
+    "srs-utils": "9.0.0-build.9.9",
     "typescript": "~5.8.3"
   }
 }