react-native-nitro-list 0.1.1 → 0.1.2

package/lib/commonjs/recycler/RecyclerList.js

@@ -0,0 +1,224 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.RecyclerList = RecyclerList;
+var _react = _interopRequireWildcard(require("react"));
+var _reactNative = require("react-native");
+var _MutableLinearLayout = require("../layout/MutableLinearLayout");
+var _windowing = require("../windowing");
+var _CellPool = require("./CellPool");
+var _jsxRuntime = require("react/jsx-runtime");
+function _interopRequireWildcard(e, t) { if ("function" == typeof WeakMap) var r = new WeakMap(), n = new WeakMap(); return (_interopRequireWildcard = function (e, t) { if (!t && e && e.__esModule) return e; var o, i, f = { __proto__: null, default: e }; if (null === e || "object" != typeof e && "function" != typeof e) return f; if (o = t ? n : r) { if (o.has(e)) return o.get(e); o.set(e, f); } for (const t in e) "default" !== t && {}.hasOwnProperty.call(e, t) && ((i = (o = Object.defineProperty) && Object.getOwnPropertyDescriptor(e, t)) && (i.get || i.set) ? o(f, t, i) : f[t] = e[t]); return f; })(e, t); }
+/* =========================================================
+ * Constants
+ * =======================================================*/const DEFAULT_VIEWPORT_SIZE = 800;
+const DEFAULT_ITEM_SIZE = 60;
+const SCROLL_EVENT_THROTTLE = 16;
+
+/* =========================================================
+ * RecyclerList
+ * =======================================================*/
+
+function RecyclerList(props) {
+  const {
+    scrollDirection = 'vertical',
+    containerCrossAxisSize,
+    data,
+    itemMainAxisSizes,
+    padding = {
+      start: 0,
+      end: 0
+    },
+    itemSpacing,
+    bufferRatio = 1.3,
+    getCellType,
+    renderItem
+  } = props;
+  const isVertical = scrollDirection === 'vertical';
+  const itemCount = data.length;
+
+  /* -------------------------------------------------------
+   * Controlled render
+   * -----------------------------------------------------*/
+
+  const [, forceRender] = (0, _react.useState)(0);
+
+  /* -------------------------------------------------------
+   * Layout engine
+   * -----------------------------------------------------*/
+
+  const layoutEngineRef = (0, _react.useRef)(null);
+  const layoutSignatureRef = (0, _react.useRef)('');
+  const layoutSignature = [scrollDirection, containerCrossAxisSize, itemCount, itemMainAxisSizes, padding.start, padding.end, itemSpacing ?? 'default'].join('|');
+  if (!layoutEngineRef.current || layoutSignatureRef.current !== layoutSignature) {
+    const engine = new _MutableLinearLayout.MutableLinearLayout(scrollDirection);
+    engine.compute({
+      crossAxisSize: containerCrossAxisSize,
+      itemMainAxisSizes,
+      padding,
+      itemSpacing
+    });
+    layoutEngineRef.current = engine;
+    layoutSignatureRef.current = layoutSignature;
+  }
+  const layouts = layoutEngineRef.current.getLayouts();
+  const contentSize = layoutEngineRef.current.getContentSize();
+
+  /* -------------------------------------------------------
+   * Scroll metrics
+   * -----------------------------------------------------*/
+
+  const scrollOffsetRef = (0, _react.useRef)(0);
+  const viewportSizeRef = (0, _react.useRef)(DEFAULT_VIEWPORT_SIZE);
+
+  /* -------------------------------------------------------
+   * Cell pool + physical cells
+   * -----------------------------------------------------*/
+
+  const cellPoolRef = (0, _react.useRef)(new _CellPool.CellPool());
+  const activeCellsRef = (0, _react.useRef)([]);
+  const nextCellKeyRef = (0, _react.useRef)(0);
+  const createCell = type => ({
+    key: nextCellKeyRef.current++,
+    index: -1,
+    type
+  });
+  const MAX_CELLS = Math.ceil(viewportSizeRef.current / DEFAULT_ITEM_SIZE * bufferRatio) + 2;
+
+  /* -------------------------------------------------------
+   * Visible cell coordinator
+   * -----------------------------------------------------*/
+
+  const updateVisibleCells = () => {
+    const offset = scrollOffsetRef.current;
+    const viewportSize = viewportSizeRef.current;
+    const buffer = viewportSize * bufferRatio;
+    const range = (0, _windowing.computeVisibleItemRange)({
+      layouts,
+      offset,
+      viewportSize,
+      buffer,
+      isVertical
+    });
+    if (!range) return;
+    const nextCells = [];
+    const used = new Set();
+    for (let index = range.startIndex; index <= range.endIndex; index++) {
+      const item = data[index];
+      if (item === undefined) continue;
+      const type = getCellType(item, index);
+
+      // Register type once, with hard cap
+      if (!cellPoolRef.current.hasType(type)) {
+        cellPoolRef.current.registerType(type, MAX_CELLS);
+        for (let i = 0; i < MAX_CELLS; i++) {
+          cellPoolRef.current.release(createCell(type));
+        }
+      }
+      let cell = cellPoolRef.current.acquire(type);
+      if (!cell) {
+        const reuseIndex = activeCellsRef.current.findIndex(c => c.type === type);
+        if (reuseIndex === -1) continue;
+        cell = activeCellsRef.current.splice(reuseIndex, 1)[0];
+      }
+      cell.index = index;
+      nextCells.push(cell);
+      used.add(cell);
+    }
+    for (const cell of activeCellsRef.current) {
+      if (!used.has(cell)) {
+        cellPoolRef.current.release(cell);
+      }
+    }
+    let changed = nextCells.length !== activeCellsRef.current.length;
+    if (!changed) {
+      for (let i = 0; i < nextCells.length; i++) {
+        if (nextCells[i] !== activeCellsRef.current[i]) {
+          changed = true;
+          break;
+        }
+      }
+    }
+    if (changed) {
+      activeCellsRef.current = nextCells;
+      forceRender(v => v + 1);
+    }
+  };
+
+  /* -------------------------------------------------------
+   * Scroll handlers
+   * -----------------------------------------------------*/
+
+  const frameScheduledRef = (0, _react.useRef)(false);
+  const onScroll = e => {
+    scrollOffsetRef.current = isVertical ? e.nativeEvent.contentOffset.y : e.nativeEvent.contentOffset.x;
+    if (frameScheduledRef.current) return;
+    frameScheduledRef.current = true;
+    requestAnimationFrame(() => {
+      frameScheduledRef.current = false;
+      updateVisibleCells();
+    });
+  };
+  const onLayout = e => {
+    viewportSizeRef.current = isVertical ? e.nativeEvent.layout.height : e.nativeEvent.layout.width;
+    updateVisibleCells();
+  };
+  (0, _react.useEffect)(() => {
+    updateVisibleCells();
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+  }, []);
+
+  /* -------------------------------------------------------
+   * Render
+   * -----------------------------------------------------*/
+
+  return /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.ScrollView, {
+    onScroll: onScroll,
+    onLayout: onLayout,
+    horizontal: !isVertical,
+    scrollEventThrottle: SCROLL_EVENT_THROTTLE,
+    removeClippedSubviews: true,
+    children: /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.View, {
+      style: isVertical ? {
+        height: contentSize
+      } : {
+        width: contentSize
+      },
+      children: activeCellsRef.current.map(cell => {
+        const index = cell.index;
+        const layout = layouts[index];
+        const item = data[index];
+        if (!layout || item === undefined) return null;
+        return /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.View, {
+          style: [styles.cell, isVertical ? {
+            top: layout.y,
+            height: layout.height,
+            width: layout.width
+          } : {
+            left: layout.x,
+            width: layout.width,
+            height: layout.height
+          }],
+          children: renderItem({
+            item,
+            index,
+            cell
+          })
+        }, cell.key);
+      })
+    })
+  });
+}
+
+/* =========================================================
+ * Styles
+ * =======================================================*/
+
+const styles = _reactNative.StyleSheet.create({
+  cell: {
+    position: 'absolute'
+  }
+});
+//# sourceMappingURL=RecyclerList.js.map

package/lib/commonjs/recycler/RecyclerList.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_react","_interopRequireWildcard","require","_reactNative","_MutableLinearLayout","_windowing","_CellPool","_jsxRuntime","e","t","WeakMap","r","n","__esModule","o","i","f","__proto__","default","has","get","set","hasOwnProperty","call","Object","defineProperty","getOwnPropertyDescriptor","DEFAULT_VIEWPORT_SIZE","DEFAULT_ITEM_SIZE","SCROLL_EVENT_THROTTLE","RecyclerList","props","scrollDirection","containerCrossAxisSize","data","itemMainAxisSizes","padding","start","end","itemSpacing","bufferRatio","getCellType","renderItem","isVertical","itemCount","length","forceRender","useState","layoutEngineRef","useRef","layoutSignatureRef","layoutSignature","join","current","engine","MutableLinearLayout","compute","crossAxisSize","layouts","getLayouts","contentSize","getContentSize","scrollOffsetRef","viewportSizeRef","cellPoolRef","CellPool","activeCellsRef","nextCellKeyRef","createCell","type","key","index","MAX_CELLS","Math","ceil","updateVisibleCells","offset","viewportSize","buffer","range","computeVisibleItemRange","nextCells","used","Set","startIndex","endIndex","item","undefined","hasType","registerType","release","cell","acquire","reuseIndex","findIndex","c","splice","push","add","changed","v","frameScheduledRef","onScroll","nativeEvent","contentOffset","y","x","requestAnimationFrame","onLayout","layout","height","width","useEffect","jsx","ScrollView","horizontal","scrollEventThrottle","removeClippedSubviews","children","View","style","map","styles","top","left","StyleSheet","create","position"],"sourceRoot":"../../../src","sources":["recycler/RecyclerList.tsx"],"mappings":"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","ignoreList":[]}

package/lib/commonjs/types/Axis.js

@@ -0,0 +1,2 @@
+"use strict";
+//# sourceMappingURL=Axis.js.map

package/lib/commonjs/{layout/LayoutProvider.js.map → types/Axis.js.map}

@@ -1 +1 @@
-{"version":3,"names":[],"sourceRoot":"../../../src","sources":["layout/LayoutProvider.ts"],"mappings":"","ignoreList":[]}
+{"version":3,"names":[],"sourceRoot":"../../../src","sources":["types/Axis.ts"],"mappings":"","ignoreList":[]}

package/lib/commonjs/types/CellKey.js

@@ -0,0 +1,2 @@
+"use strict";
+//# sourceMappingURL=CellKey.js.map

package/lib/{module/layout/LayoutProvider.js.map → commonjs/types/CellKey.js.map}

@@ -1 +1 @@
-{"version":3,"names":[],"sourceRoot":"../../../src","sources":["layout/LayoutProvider.ts"],"mappings":"","ignoreList":[]}
+{"version":3,"names":[],"sourceRoot":"../../../src","sources":["types/CellKey.ts"],"mappings":"","ignoreList":[]}

package/lib/commonjs/types/CellType.js

@@ -0,0 +1,2 @@
+"use strict";
+//# sourceMappingURL=CellType.js.map

package/lib/commonjs/{layout/LayoutRectangle.js.map → types/CellType.js.map}

@@ -1 +1 @@
-{"version":3,"names":[],"sourceRoot":"../../../src","sources":["layout/LayoutRectangle.ts"],"mappings":"","ignoreList":[]}
+{"version":3,"names":[],"sourceRoot":"../../../src","sources":["types/CellType.ts"],"mappings":"","ignoreList":[]}

package/lib/commonjs/types/VisibleRange.js

@@ -0,0 +1,2 @@
+"use strict";
+//# sourceMappingURL=VisibleRange.js.map

package/lib/{module/layout/LayoutRectangle.js.map → commonjs/types/VisibleRange.js.map}

@@ -1 +1 @@
-{"version":3,"names":[],"sourceRoot":"../../../src","sources":["layout/LayoutRectangle.ts"],"mappings":"","ignoreList":[]}
+{"version":3,"names":[],"sourceRoot":"../../../src","sources":["types/VisibleRange.ts"],"mappings":"","ignoreList":[]}

package/lib/commonjs/{RecyclerList.types.js → types/VisibleRangeInput.js}

@@ -3,4 +3,4 @@
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-//# sourceMappingURL=RecyclerList.types.js.map
+//# sourceMappingURL=VisibleRangeInput.js.map

package/lib/commonjs/types/VisibleRangeInput.js.map

@@ -0,0 +1 @@
+{"version":3,"names":[],"sourceRoot":"../../../src","sources":["types/VisibleRangeInput.ts"],"mappings":"","ignoreList":[]}

package/lib/commonjs/types/index.js

@@ -0,0 +1,13 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+Object.defineProperty(exports, "ZERO_MAIN_AXIS_PADDING", {
+  enumerable: true,
+  get: function () {
+    return _MainAxisPadding.ZERO_MAIN_AXIS_PADDING;
+  }
+});
+var _MainAxisPadding = require("./layout/MainAxisPadding");
+//# sourceMappingURL=index.js.map

package/lib/commonjs/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_MainAxisPadding","require"],"sourceRoot":"../../../src","sources":["types/index.ts"],"mappings":";;;;;;;;;;;AAKA,IAAAA,gBAAA,GAAAC,OAAA","ignoreList":[]}

package/lib/commonjs/types/layout/LayoutRect.js

@@ -0,0 +1,2 @@
+"use strict";
+//# sourceMappingURL=LayoutRect.js.map

package/lib/commonjs/types/layout/LayoutRect.js.map

@@ -0,0 +1 @@
+{"version":3,"names":[],"sourceRoot":"../../../../src","sources":["types/layout/LayoutRect.ts"],"mappings":"","ignoreList":[]}

package/lib/commonjs/types/layout/LinearLayoutInput.js

@@ -0,0 +1,6 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+//# sourceMappingURL=LinearLayoutInput.js.map

package/lib/commonjs/types/layout/LinearLayoutInput.js.map

@@ -0,0 +1 @@
+{"version":3,"names":[],"sourceRoot":"../../../../src","sources":["types/layout/LinearLayoutInput.ts"],"mappings":"","ignoreList":[]}

package/lib/commonjs/types/layout/MainAxisPadding.js

@@ -0,0 +1,26 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.ZERO_MAIN_AXIS_PADDING = void 0;
+/**
+ * Padding applied along the main scroll axis.
+ *
+ * This is a layout-level concept (not visual styling).
+ *
+ * - vertical   → top / bottom
+ * - horizontal → left / right
+ *
+ * Uses start/end to remain RTL-safe and platform-neutral.
+ */
+
+/**
+ * Shared zero-padding constant.
+ * Safe to reuse across layouts.
+ */
+const ZERO_MAIN_AXIS_PADDING = exports.ZERO_MAIN_AXIS_PADDING = {
+  start: 0,
+  end: 0
+};
+//# sourceMappingURL=MainAxisPadding.js.map

package/lib/commonjs/types/layout/MainAxisPadding.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["ZERO_MAIN_AXIS_PADDING","exports","start","end"],"sourceRoot":"../../../../src","sources":["types/layout/MainAxisPadding.ts"],"mappings":";;;;;;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAMA;AACA;AACA;AACA;AACO,MAAMA,sBAAuC,GAAAC,OAAA,CAAAD,sBAAA,GAAG;EACrDE,KAAK,EAAE,CAAC;EACRC,GAAG,EAAE;AACP,CAAC","ignoreList":[]}

package/lib/commonjs/types/layout/index.js

@@ -0,0 +1,2 @@
+"use strict";
+//# sourceMappingURL=index.js.map

package/lib/commonjs/types/layout/index.js.map

@@ -0,0 +1 @@
+{"version":3,"names":[],"sourceRoot":"../../../../src","sources":["types/layout/index.ts"],"mappings":"","ignoreList":[]}

package/lib/commonjs/types/recycler/RecyclerCellInstance.js

@@ -0,0 +1,6 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+//# sourceMappingURL=RecyclerCellInstance.js.map

package/lib/commonjs/types/recycler/RecyclerCellInstance.js.map

@@ -0,0 +1 @@
+{"version":3,"names":[],"sourceRoot":"../../../../src","sources":["types/recycler/RecyclerCellInstance.ts"],"mappings":"","ignoreList":[]}

package/lib/commonjs/types/recycler/RecyclerItemRenderer.js

@@ -0,0 +1,6 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+//# sourceMappingURL=RecyclerItemRenderer.js.map

package/lib/commonjs/types/recycler/RecyclerItemRenderer.js.map

@@ -0,0 +1 @@
+{"version":3,"names":[],"sourceRoot":"../../../../src","sources":["types/recycler/RecyclerItemRenderer.ts"],"mappings":"","ignoreList":[]}

package/lib/commonjs/types/recycler/RecyclerListProps.js

@@ -0,0 +1,6 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+//# sourceMappingURL=RecyclerListProps.js.map

package/lib/commonjs/types/recycler/RecyclerListProps.js.map

@@ -0,0 +1 @@
+{"version":3,"names":[],"sourceRoot":"../../../../src","sources":["types/recycler/RecyclerListProps.ts"],"mappings":"","ignoreList":[]}

package/lib/commonjs/types/recycler/index.js

@@ -0,0 +1,2 @@
+"use strict";
+//# sourceMappingURL=index.js.map

package/lib/commonjs/types/recycler/index.js.map

@@ -0,0 +1 @@
+{"version":3,"names":[],"sourceRoot":"../../../../src","sources":["types/recycler/index.ts"],"mappings":"","ignoreList":[]}

package/lib/commonjs/{layout/LayoutProvider.js → types/scroll/ScrollMetrics.js}

@@ -3,4 +3,4 @@
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-//# sourceMappingURL=LayoutProvider.js.map
+//# sourceMappingURL=ScrollMetrics.js.map

package/lib/commonjs/types/scroll/ScrollMetrics.js.map

@@ -0,0 +1 @@
+{"version":3,"names":[],"sourceRoot":"../../../../src","sources":["types/scroll/ScrollMetrics.ts"],"mappings":"","ignoreList":[]}

package/lib/commonjs/types/scroll/index.js

@@ -0,0 +1,2 @@
+"use strict";
+//# sourceMappingURL=index.js.map

package/lib/commonjs/types/scroll/index.js.map

@@ -0,0 +1 @@
+{"version":3,"names":[],"sourceRoot":"../../../../src","sources":["types/scroll/index.ts"],"mappings":"","ignoreList":[]}

package/lib/commonjs/windowing/computeVisibleItemRange.js

@@ -0,0 +1,71 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.computeVisibleItemRange = computeVisibleItemRange;
+/**
+ * Computes the visible item index range using binary search.
+ *
+ * Responsibilities:
+ * - Determine which items intersect the visible window
+ * - Stay independent of rendering and recycling
+ *
+ * Performance:
+ * - O(log n) to locate the first visible item
+ * - O(k) to expand to the last visible item (k = visible count)
+ */
+function computeVisibleItemRange(input) {
+  const {
+    layouts,
+    offset,
+    viewportSize,
+    buffer,
+    isVertical
+  } = input;
+  const itemCount = layouts.length;
+  if (itemCount === 0) return null;
+  const windowStart = Math.max(0, offset - buffer);
+  const windowEnd = offset + viewportSize + buffer;
+
+  // --------------------------------------------------
+  // Binary search:
+  // First item whose END >= windowStart
+  // --------------------------------------------------
+  let low = 0;
+  let high = itemCount - 1;
+  let firstVisibleIndex = itemCount;
+  while (low <= high) {
+    const mid = low + high >>> 1;
+    const rect = layouts[mid];
+    const start = isVertical ? rect.y : rect.x;
+    const size = isVertical ? rect.height : rect.width;
+    const end = start + size;
+    if (end >= windowStart) {
+      firstVisibleIndex = mid;
+      high = mid - 1;
+    } else {
+      low = mid + 1;
+    }
+  }
+  if (firstVisibleIndex === itemCount) {
+    return null;
+  }
+
+  // --------------------------------------------------
+  // Linear scan forward:
+  // Last item whose START <= windowEnd
+  // --------------------------------------------------
+  let lastVisibleIndex = firstVisibleIndex;
+  for (let i = firstVisibleIndex + 1; i < itemCount; i++) {
+    const rect = layouts[i];
+    const start = isVertical ? rect.y : rect.x;
+    if (start > windowEnd) break;
+    lastVisibleIndex = i;
+  }
+  return {
+    startIndex: firstVisibleIndex,
+    endIndex: lastVisibleIndex
+  };
+}
+//# sourceMappingURL=computeVisibleItemRange.js.map

package/lib/commonjs/windowing/computeVisibleItemRange.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["computeVisibleItemRange","input","layouts","offset","viewportSize","buffer","isVertical","itemCount","length","windowStart","Math","max","windowEnd","low","high","firstVisibleIndex","mid","rect","start","y","x","size","height","width","end","lastVisibleIndex","i","startIndex","endIndex"],"sourceRoot":"../../../src","sources":["windowing/computeVisibleItemRange.ts"],"mappings":";;;;;;AAGA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAASA,uBAAuBA,CACrCC,KAAwB,EACH;EACrB,MAAM;IACJC,OAAO;IACPC,MAAM;IACNC,YAAY;IACZC,MAAM;IACNC;EACF,CAAC,GAAGL,KAAK;EAET,MAAMM,SAAS,GAAGL,OAAO,CAACM,MAAM;EAChC,IAAID,SAAS,KAAK,CAAC,EAAE,OAAO,IAAI;EAEhC,MAAME,WAAW,GAAGC,IAAI,CAACC,GAAG,CAAC,CAAC,EAAER,MAAM,GAAGE,MAAM,CAAC;EAChD,MAAMO,SAAS,GAAGT,MAAM,GAAGC,YAAY,GAAGC,MAAM;;EAEhD;EACA;EACA;EACA;EACA,IAAIQ,GAAG,GAAG,CAAC;EACX,IAAIC,IAAI,GAAGP,SAAS,GAAG,CAAC;EACxB,IAAIQ,iBAAiB,GAAGR,SAAS;EAEjC,OAAOM,GAAG,IAAIC,IAAI,EAAE;IAClB,MAAME,GAAG,GAAIH,GAAG,GAAGC,IAAI,KAAM,CAAC;IAC9B,MAAMG,IAAI,GAAGf,OAAO,CAACc,GAAG,CAAE;IAE1B,MAAME,KAAK,GAAGZ,UAAU,GAAGW,IAAI,CAACE,CAAC,GAAGF,IAAI,CAACG,CAAC;IAC1C,MAAMC,IAAI,GAAGf,UAAU,GAAGW,IAAI,CAACK,MAAM,GAAGL,IAAI,CAACM,KAAK;IAClD,MAAMC,GAAG,GAAGN,KAAK,GAAGG,IAAI;IAExB,IAAIG,GAAG,IAAIf,WAAW,EAAE;MACtBM,iBAAiB,GAAGC,GAAG;MACvBF,IAAI,GAAGE,GAAG,GAAG,CAAC;IAChB,CAAC,MAAM;MACLH,GAAG,GAAGG,GAAG,GAAG,CAAC;IACf;EACF;EAEA,IAAID,iBAAiB,KAAKR,SAAS,EAAE;IACnC,OAAO,IAAI;EACb;;EAEA;EACA;EACA;EACA;EACA,IAAIkB,gBAAgB,GAAGV,iBAAiB;EAExC,KAAK,IAAIW,CAAC,GAAGX,iBAAiB,GAAG,CAAC,EAAEW,CAAC,GAAGnB,SAAS,EAAEmB,CAAC,EAAE,EAAE;IACtD,MAAMT,IAAI,GAAGf,OAAO,CAACwB,CAAC,CAAE;IACxB,MAAMR,KAAK,GAAGZ,UAAU,GAAGW,IAAI,CAACE,CAAC,GAAGF,IAAI,CAACG,CAAC;IAE1C,IAAIF,KAAK,GAAGN,SAAS,EAAE;IACvBa,gBAAgB,GAAGC,CAAC;EACtB;EAEA,OAAO;IACLC,UAAU,EAAEZ,iBAAiB;IAC7Ba,QAAQ,EAAEH;EACZ,CAAC;AACH","ignoreList":[]}

package/lib/commonjs/windowing/index.js

@@ -3,10 +3,10 @@
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-Object.defineProperty(exports, "findVisibleIndexRange", {
+Object.defineProperty(exports, "computeVisibleItemRange", {
   enumerable: true,
   get: function () {
-    return _findVisibleIndexRange.findVisibleIndexRange;
+    return _computeVisibleItemRange.computeVisibleItemRange;
   }
 });
 Object.defineProperty(exports, "useScrollMetrics", {
@@ -15,6 +15,6 @@ Object.defineProperty(exports, "useScrollMetrics", {
     return _useScrollMetrics.useScrollMetrics;
   }
 });
-var _findVisibleIndexRange = require("./findVisibleIndexRange");
 var _useScrollMetrics = require("./useScrollMetrics");
+var _computeVisibleItemRange = require("./computeVisibleItemRange");
 //# sourceMappingURL=index.js.map

package/lib/commonjs/windowing/index.js.map

@@ -1 +1 @@
-{"version":3,"names":["_findVisibleIndexRange","require","_useScrollMetrics"],"sourceRoot":"../../../src","sources":["windowing/index.ts"],"mappings":";;;;;;;;;;;;;;;;;AACA,IAAAA,sBAAA,GAAAC,OAAA;AACA,IAAAC,iBAAA,GAAAD,OAAA","ignoreList":[]}
+{"version":3,"names":["_useScrollMetrics","require","_computeVisibleItemRange"],"sourceRoot":"../../../src","sources":["windowing/index.ts"],"mappings":";;;;;;;;;;;;;;;;;AACA,IAAAA,iBAAA,GAAAC,OAAA;AACA,IAAAC,wBAAA,GAAAD,OAAA","ignoreList":[]}

package/lib/module/cell/CellKeyGenerator.js

@@ -0,0 +1,16 @@
+"use strict";
+
+/**
+ * Monotonic key generator for physical cell instances.
+ * Guarantees stable keys across the lifetime of the list.
+ */
+export class CellKeyGenerator {
+  nextId = 0;
+  next() {
+    return this.nextId++;
+  }
+  reset() {
+    this.nextId = 0;
+  }
+}
+//# sourceMappingURL=CellKeyGenerator.js.map

package/lib/module/cell/CellKeyGenerator.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["CellKeyGenerator","nextId","next","reset"],"sourceRoot":"../../../src","sources":["cell/CellKeyGenerator.ts"],"mappings":";;AAEA;AACA;AACA;AACA;AACA,OAAO,MAAMA,gBAAgB,CAAC;EACpBC,MAAM,GAAG,CAAC;EAElBC,IAAIA,CAAA,EAAY;IACd,OAAO,IAAI,CAACD,MAAM,EAAE;EACtB;EAEAE,KAAKA,CAAA,EAAS;IACZ,IAAI,CAACF,MAAM,GAAG,CAAC;EACjB;AACF","ignoreList":[]}