react-native-nitro-list 0.1.1 → 0.1.3

package/lib/module/recycler/NitroList.js

@@ -0,0 +1,220 @@
+"use strict";
+
+import React, { useRef, useEffect, useState } from 'react';
+import { ScrollView, View, StyleSheet } from 'react-native';
+import { MutableLinearLayout } from '../layout/MutableLinearLayout';
+import { computeVisibleItemRange } from '../windowing';
+import { CellPool } from './CellPool';
+
+/* ========================================================= */
+import { jsx as _jsx } from "react/jsx-runtime";
+const DEFAULT_VIEWPORT_SIZE = 800;
+const DEFAULT_ITEM_SIZE = 60;
+const SCROLL_EVENT_THROTTLE = 16;
+
+/* ========================================================= */
+/* Internal (mutable) cell                                  */
+/* ========================================================= */
+
+/* ========================================================= */
+/* NitroList                                             */
+/* ========================================================= */
+
+export default function NitroList(props) {
+  const {
+    data,
+    renderItem,
+    getCellType,
+    scrollDirection = 'vertical',
+    bufferRatio = 1.3,
+    containerCrossAxisSize,
+    itemMainAxisSizes,
+    padding = {
+      start: 0,
+      end: 0
+    },
+    itemSpacing
+  } = props;
+  const isVertical = scrollDirection === 'vertical';
+  const [, forceRender] = useState(0);
+  const DEBUG = true;
+
+  /* ======================================================= */
+  /* Layout engine (recomputed when signature changes)       */
+  /* ======================================================= */
+
+  const layoutEngineRef = useRef(null);
+  const layoutSignatureRef = useRef('');
+  const layoutSignature = [scrollDirection, containerCrossAxisSize, data.length, itemMainAxisSizes, padding.start, padding.end, itemSpacing ?? 'none'].join('|');
+  if (layoutEngineRef.current === null || layoutSignatureRef.current !== layoutSignature) {
+    const engine = new 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 = useRef(0);
+  const viewportSizeRef = useRef(DEFAULT_VIEWPORT_SIZE);
+
+  /* ======================================================= */
+  /* Cell pool                                               */
+  /* ======================================================= */
+
+  const cellPoolRef = useRef(new CellPool());
+  const activeCellsRef = useRef([]);
+  const nextKeyRef = useRef(0);
+  const createCell = type => ({
+    key: nextKeyRef.current++,
+    type,
+    index: -1,
+    active: false
+  });
+
+  /* ======================================================= */
+  /* Visible window coordination                             */
+  /* ======================================================= */
+
+  const updateVisibleCells = () => {
+    const range = computeVisibleItemRange({
+      layouts,
+      offset: scrollOffsetRef.current,
+      viewportSize: viewportSizeRef.current,
+      buffer: viewportSizeRef.current * bufferRatio,
+      isVertical
+    });
+    if (range === null) return;
+    if (DEBUG) {
+      console.log('[NitroList] range:', range.startIndex, range.endIndex);
+    }
+    const active = activeCellsRef.current;
+
+    // 1. Mark all inactive
+    for (const cell of active) {
+      cell.active = false;
+    }
+    let writeIndex = 0;
+
+    // 2. Activate visible range
+    for (let index = range.startIndex; index <= range.endIndex; index++) {
+      const item = data[index];
+      if (item === undefined) continue;
+      const type = getCellType(item, index);
+
+      // Seed pool once per type
+      if (!cellPoolRef.current.hasType(type)) {
+        const maxCells = Math.ceil(viewportSizeRef.current / DEFAULT_ITEM_SIZE * bufferRatio) + 2;
+        cellPoolRef.current.registerType(type, maxCells);
+        for (let i = 0; i < maxCells; i++) {
+          cellPoolRef.current.release(createCell(type));
+        }
+      }
+      let cell = cellPoolRef.current.acquire(type);
+      if (cell === null) {
+        const reusable = active.find(c => !c.active && c.type === type);
+        cell = reusable ?? createCell(type);
+      }
+      cell.index = index;
+      cell.active = true;
+      active[writeIndex++] = cell;
+    }
+
+    // 3. Recycle unused cells
+    for (let i = writeIndex; i < active.length; i++) {
+      const cell = active[i];
+      if (cell === undefined) continue;
+      cell.index = -1;
+      cell.active = false;
+      cellPoolRef.current.release(cell);
+    }
+
+    // 4. Compact once
+    if (active.length !== writeIndex) {
+      active.length = writeIndex;
+      forceRender(v => v + 1);
+    }
+  };
+
+  /* ======================================================= */
+  /* Handlers                                                */
+  /* ======================================================= */
+
+  const onScroll = e => {
+    scrollOffsetRef.current = isVertical ? e.nativeEvent.contentOffset.y : e.nativeEvent.contentOffset.x;
+    updateVisibleCells();
+  };
+  const onLayout = e => {
+    viewportSizeRef.current = isVertical ? e.nativeEvent.layout.height : e.nativeEvent.layout.width;
+    updateVisibleCells();
+  };
+  useEffect(() => {
+    updateVisibleCells();
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+  }, []);
+  if (DEBUG) {
+    console.log('[NitroList] layouts:', layouts.length);
+    console.log('[NitroList] contentSize:', contentSize);
+    console.log('[NitroList] data.length:', data.length);
+  }
+
+  /* ======================================================= */
+  /* Render                                                  */
+  /* ======================================================= */
+
+  return /*#__PURE__*/_jsx(ScrollView, {
+    onScroll: onScroll,
+    onLayout: onLayout,
+    horizontal: !isVertical,
+    scrollEventThrottle: SCROLL_EVENT_THROTTLE,
+    removeClippedSubviews: true,
+    children: /*#__PURE__*/_jsx(View, {
+      style: isVertical ? {
+        height: contentSize
+      } : {
+        width: contentSize
+      },
+      children: activeCellsRef.current.map(cell => {
+        const layout = layouts[cell.index];
+        const item = data[cell.index];
+        if (layout === undefined || item === undefined) {
+          return null;
+        }
+        return /*#__PURE__*/_jsx(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.index,
+            cell
+          })
+        }, cell.key);
+      })
+    })
+  });
+}
+
+/* ========================================================= */
+
+const styles = StyleSheet.create({
+  cell: {
+    position: 'absolute'
+  }
+});
+//# sourceMappingURL=NitroList.js.map

package/lib/module/recycler/NitroList.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["React","useRef","useEffect","useState","ScrollView","View","StyleSheet","MutableLinearLayout","computeVisibleItemRange","CellPool","jsx","_jsx","DEFAULT_VIEWPORT_SIZE","DEFAULT_ITEM_SIZE","SCROLL_EVENT_THROTTLE","NitroList","props","data","renderItem","getCellType","scrollDirection","bufferRatio","containerCrossAxisSize","itemMainAxisSizes","padding","start","end","itemSpacing","isVertical","forceRender","DEBUG","layoutEngineRef","layoutSignatureRef","layoutSignature","length","join","current","engine","compute","crossAxisSize","layouts","getLayouts","contentSize","getContentSize","scrollOffsetRef","viewportSizeRef","cellPoolRef","activeCellsRef","nextKeyRef","createCell","type","key","index","active","updateVisibleCells","range","offset","viewportSize","buffer","console","log","startIndex","endIndex","cell","writeIndex","item","undefined","hasType","maxCells","Math","ceil","registerType","i","release","acquire","reusable","find","c","v","onScroll","e","nativeEvent","contentOffset","y","x","onLayout","layout","height","width","horizontal","scrollEventThrottle","removeClippedSubviews","children","style","map","styles","top","left","create","position"],"sourceRoot":"../../../src","sources":["recycler/NitroList.tsx"],"mappings":"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","ignoreList":[]}

package/lib/module/scroll/useScrollVelocity.js

@@ -0,0 +1,16 @@
+"use strict";
+
+export function createScrollVelocityTracker() {
+  let lastOffset = 0;
+  let lastTime = Date.now();
+  return function getVelocity(offset) {
+    const now = Date.now();
+    const dt = now - lastTime;
+    const dy = Math.abs(offset - lastOffset);
+    lastOffset = offset;
+    lastTime = now;
+    if (dt === 0) return 0;
+    return dy / dt; // px per ms
+  };
+}
+//# sourceMappingURL=useScrollVelocity.js.map

package/lib/module/scroll/useScrollVelocity.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["createScrollVelocityTracker","lastOffset","lastTime","Date","now","getVelocity","offset","dt","dy","Math","abs"],"sourceRoot":"../../../src","sources":["scroll/useScrollVelocity.ts"],"mappings":";;AAAA,OAAO,SAASA,2BAA2BA,CAAA,EAAG;EAC5C,IAAIC,UAAU,GAAG,CAAC;EAClB,IAAIC,QAAQ,GAAGC,IAAI,CAACC,GAAG,CAAC,CAAC;EAEzB,OAAO,SAASC,WAAWA,CAACC,MAAc,EAAU;IAClD,MAAMF,GAAG,GAAGD,IAAI,CAACC,GAAG,CAAC,CAAC;IACtB,MAAMG,EAAE,GAAGH,GAAG,GAAGF,QAAQ;IACzB,MAAMM,EAAE,GAAGC,IAAI,CAACC,GAAG,CAACJ,MAAM,GAAGL,UAAU,CAAC;IAExCA,UAAU,GAAGK,MAAM;IACnBJ,QAAQ,GAAGE,GAAG;IAEd,IAAIG,EAAE,KAAK,CAAC,EAAE,OAAO,CAAC;IACtB,OAAOC,EAAE,GAAGD,EAAE,EAAC;EACjB,CAAC;AACH","ignoreList":[]}

package/lib/module/specs/NitroList.nitro.js

@@ -0,0 +1,4 @@
+"use strict";
+
+export {};
+//# sourceMappingURL=NitroList.nitro.js.map

package/lib/module/specs/NitroList.nitro.js.map

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

package/lib/module/types/Axis.js

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

package/lib/module/types/Axis.js.map

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

package/lib/module/types/CellKey.js

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

package/lib/module/types/CellKey.js.map

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

package/lib/module/types/CellType.js

@@ -0,0 +1,22 @@
+"use strict";
+
+/**
+ * Logical cell type.
+ *
+ * Used to group compatible cells for recycling.
+ *
+ * Cross-platform equivalent:
+ * - Android: viewType
+ * - iOS: reuseIdentifier
+ *
+ * NOTE:
+ * This is a branded type to prevent accidental mixing
+ * with keys, indexes, or other strings/numbers.
+ */
+
+/**
+ * Helper to create a CellType safely.
+ * Keeps ergonomics simple for users.
+ */
+export const createCellType = value => value;
+//# sourceMappingURL=CellType.js.map

package/lib/module/types/CellType.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["createCellType","value"],"sourceRoot":"../../../src","sources":["types/CellType.ts"],"mappings":";;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAKA;AACA;AACA;AACA;AACA,OAAO,MAAMA,cAAc,GACzBC,KAAa,IACAA,KAAiB","ignoreList":[]}

package/lib/module/types/VisibleRange.js

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

package/lib/module/types/VisibleRange.js.map

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

package/lib/module/types/VisibleRangeInput.js

@@ -0,0 +1,4 @@
+"use strict";
+
+export {};
+//# sourceMappingURL=VisibleRangeInput.js.map

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

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

package/lib/module/types/index.js

@@ -0,0 +1,4 @@
+"use strict";
+
+export { ZERO_MAIN_AXIS_PADDING } from './layout/MainAxisPadding';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"names":["ZERO_MAIN_AXIS_PADDING"],"sourceRoot":"../../../src","sources":["types/index.ts"],"mappings":";;AAKA,SACEA,sBAAsB,QACjB,0BAA0B","ignoreList":[]}

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

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

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

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

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

@@ -0,0 +1,4 @@
+"use strict";
+
+export {};
+//# sourceMappingURL=LinearLayoutInput.js.map

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

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

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

@@ -0,0 +1,22 @@
+"use strict";
+
+/**
+ * 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.
+ */
+export const ZERO_MAIN_AXIS_PADDING = {
+  start: 0,
+  end: 0
+};
+//# sourceMappingURL=MainAxisPadding.js.map

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

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

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

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

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

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

package/lib/module/types/recycler/CellPool.js

@@ -0,0 +1,37 @@
+"use strict";
+
+/**
+ * Owns recycled physical cells.
+ * Enforces hard caps.
+ */
+export class CellPool {
+  pools = new Map();
+  maxPerType = new Map();
+  hasType(type) {
+    return this.pools.has(type);
+  }
+  registerType(type, maxCount) {
+    if (this.pools.has(type)) return;
+    this.pools.set(type, []);
+    this.maxPerType.set(type, maxCount);
+  }
+  acquire(type) {
+    const bucket = this.pools.get(type);
+    if (!bucket || bucket.length === 0) return null;
+    return bucket.pop() ?? null;
+  }
+  release(cell) {
+    const bucket = this.pools.get(cell.type);
+    const max = this.maxPerType.get(cell.type);
+    if (!bucket || max === undefined) return;
+    cell.index = -1;
+    if (bucket.length >= max) return;
+    bucket.push(cell);
+  }
+  clear() {
+    for (const bucket of this.pools.values()) {
+      bucket.length = 0;
+    }
+  }
+}
+//# sourceMappingURL=CellPool.js.map

package/lib/module/types/recycler/CellPool.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["CellPool","pools","Map","maxPerType","hasType","type","has","registerType","maxCount","set","acquire","bucket","get","length","pop","release","cell","max","undefined","index","push","clear","values"],"sourceRoot":"../../../../src","sources":["types/recycler/CellPool.ts"],"mappings":";;AAIA;AACA;AACA;AACA;AACA,OAAO,MAAMA,QAAQ,CAAyB;EAC3BC,KAAK,GAAG,IAAIC,GAAG,CAAgB,CAAC;EAChCC,UAAU,GAAG,IAAID,GAAG,CAAmB,CAAC;EAEzDE,OAAOA,CAACC,IAAc,EAAW;IAC/B,OAAO,IAAI,CAACJ,KAAK,CAACK,GAAG,CAACD,IAAI,CAAC;EAC7B;EAEAE,YAAYA,CAACF,IAAc,EAAEG,QAAgB,EAAQ;IACnD,IAAI,IAAI,CAACP,KAAK,CAACK,GAAG,CAACD,IAAI,CAAC,EAAE;IAC1B,IAAI,CAACJ,KAAK,CAACQ,GAAG,CAACJ,IAAI,EAAE,EAAE,CAAC;IACxB,IAAI,CAACF,UAAU,CAACM,GAAG,CAACJ,IAAI,EAAEG,QAAQ,CAAC;EACrC;EAEAE,OAAOA,CAACL,IAAc,EAAY;IAChC,MAAMM,MAAM,GAAG,IAAI,CAACV,KAAK,CAACW,GAAG,CAACP,IAAI,CAAC;IACnC,IAAI,CAACM,MAAM,IAAIA,MAAM,CAACE,MAAM,KAAK,CAAC,EAAE,OAAO,IAAI;IAC/C,OAAOF,MAAM,CAACG,GAAG,CAAC,CAAC,IAAI,IAAI;EAC7B;EAEAC,OAAOA,CAACC,IAAO,EAAQ;IACrB,MAAML,MAAM,GAAG,IAAI,CAACV,KAAK,CAACW,GAAG,CAACI,IAAI,CAACX,IAAI,CAAC;IACxC,MAAMY,GAAG,GAAG,IAAI,CAACd,UAAU,CAACS,GAAG,CAACI,IAAI,CAACX,IAAI,CAAC;IAC1C,IAAI,CAACM,MAAM,IAAIM,GAAG,KAAKC,SAAS,EAAE;IAElCF,IAAI,CAACG,KAAK,GAAG,CAAC,CAAC;IACf,IAAIR,MAAM,CAACE,MAAM,IAAII,GAAG,EAAE;IAE1BN,MAAM,CAACS,IAAI,CAACJ,IAAI,CAAC;EACnB;EAEAK,KAAKA,CAAA,EAAS;IACZ,KAAK,MAAMV,MAAM,IAAI,IAAI,CAACV,KAAK,CAACqB,MAAM,CAAC,CAAC,EAAE;MACxCX,MAAM,CAACE,MAAM,GAAG,CAAC;IACnB;EACF;AACF","ignoreList":[]}

package/lib/module/types/recycler/NitroListProps.js

@@ -0,0 +1,4 @@
+"use strict";
+
+export {};
+//# sourceMappingURL=NitroListProps.js.map

package/lib/module/types/recycler/NitroListProps.js.map

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

package/lib/module/types/recycler/RecyclerCell.js

@@ -0,0 +1,4 @@
+"use strict";
+
+export {};
+//# sourceMappingURL=RecyclerCell.js.map

package/lib/module/types/recycler/RecyclerCell.js.map

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

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

@@ -0,0 +1,4 @@
+"use strict";
+
+export {};
+//# sourceMappingURL=RecyclerItemRenderer.js.map

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

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

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

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

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

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

package/lib/module/types/scroll/ScrollMetrics.js

@@ -0,0 +1,4 @@
+"use strict";
+
+export {};
+//# sourceMappingURL=ScrollMetrics.js.map

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

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

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

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

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

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

package/lib/module/windowing/computeVisibleItemRange.js

@@ -0,0 +1,57 @@
+"use strict";
+
+/**
+ * Computes visible item range using binary search + forward scan.
+ * Type-safe and defensive against invalid indices.
+ */
+export function computeVisibleItemRange(input) {
+  const {
+    layouts,
+    offset,
+    viewportSize,
+    buffer,
+    isVertical
+  } = input;
+  const count = layouts.length;
+  if (count === 0) return null;
+  const windowStart = Math.max(0, offset - buffer);
+  const windowEnd = offset + viewportSize + buffer;
+
+  // ------------------------------
+  // Binary search: first visible
+  // ------------------------------
+  let low = 0;
+  let high = count - 1;
+  let first = count;
+  while (low <= high) {
+    const mid = low + high >>> 1;
+    const rect = layouts[mid];
+    if (!rect) break;
+    const start = isVertical ? rect.y : rect.x;
+    const size = isVertical ? rect.height : rect.width;
+    if (start + size >= windowStart) {
+      first = mid;
+      high = mid - 1;
+    } else {
+      low = mid + 1;
+    }
+  }
+  if (first === count) return null;
+
+  // ------------------------------
+  // Linear scan: last visible
+  // ------------------------------
+  let last = first;
+  for (let i = first + 1; i < count; i++) {
+    const rect = layouts[i];
+    if (!rect) break;
+    const start = isVertical ? rect.y : rect.x;
+    if (start > windowEnd) break;
+    last = i;
+  }
+  return {
+    startIndex: first,
+    endIndex: last
+  };
+}
+//# sourceMappingURL=computeVisibleItemRange.js.map

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

@@ -0,0 +1 @@
+{"version":3,"names":["computeVisibleItemRange","input","layouts","offset","viewportSize","buffer","isVertical","count","length","windowStart","Math","max","windowEnd","low","high","first","mid","rect","start","y","x","size","height","width","last","i","startIndex","endIndex"],"sourceRoot":"../../../src","sources":["windowing/computeVisibleItemRange.ts"],"mappings":";;AAgBA;AACA;AACA;AACA;AACA,OAAO,SAASA,uBAAuBA,CACrCC,KAAY,EACS;EACrB,MAAM;IACJC,OAAO;IACPC,MAAM;IACNC,YAAY;IACZC,MAAM;IACNC;EACF,CAAC,GAAGL,KAAK;EAET,MAAMM,KAAK,GAAGL,OAAO,CAACM,MAAM;EAC5B,IAAID,KAAK,KAAK,CAAC,EAAE,OAAO,IAAI;EAE5B,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,IAAIQ,GAAG,GAAG,CAAC;EACX,IAAIC,IAAI,GAAGP,KAAK,GAAG,CAAC;EACpB,IAAIQ,KAAK,GAAGR,KAAK;EAEjB,OAAOM,GAAG,IAAIC,IAAI,EAAE;IAClB,MAAME,GAAG,GAAIH,GAAG,GAAGC,IAAI,KAAM,CAAC;IAC9B,MAAMG,IAAI,GAAGf,OAAO,CAACc,GAAG,CAAC;IACzB,IAAI,CAACC,IAAI,EAAE;IAEX,MAAMC,KAAK,GAAGZ,UAAU,GAAGW,IAAI,CAACE,CAAC,GAAGF,IAAI,CAACG,CAAC;IAC1C,MAAMC,IAAI,GAAGf,UAAU,GAAGW,IAAI,CAACK,MAAM,GAAGL,IAAI,CAACM,KAAK;IAElD,IAAIL,KAAK,GAAGG,IAAI,IAAIZ,WAAW,EAAE;MAC/BM,KAAK,GAAGC,GAAG;MACXF,IAAI,GAAGE,GAAG,GAAG,CAAC;IAChB,CAAC,MAAM;MACLH,GAAG,GAAGG,GAAG,GAAG,CAAC;IACf;EACF;EAEA,IAAID,KAAK,KAAKR,KAAK,EAAE,OAAO,IAAI;;EAEhC;EACA;EACA;EACA,IAAIiB,IAAI,GAAGT,KAAK;EAEhB,KAAK,IAAIU,CAAC,GAAGV,KAAK,GAAG,CAAC,EAAEU,CAAC,GAAGlB,KAAK,EAAEkB,CAAC,EAAE,EAAE;IACtC,MAAMR,IAAI,GAAGf,OAAO,CAACuB,CAAC,CAAC;IACvB,IAAI,CAACR,IAAI,EAAE;IAEX,MAAMC,KAAK,GAAGZ,UAAU,GAAGW,IAAI,CAACE,CAAC,GAAGF,IAAI,CAACG,CAAC;IAC1C,IAAIF,KAAK,GAAGN,SAAS,EAAE;IAEvBY,IAAI,GAAGC,CAAC;EACV;EAEA,OAAO;IACLC,UAAU,EAAEX,KAAK;IACjBY,QAAQ,EAAEH;EACZ,CAAC;AACH","ignoreList":[]}

package/lib/module/windowing/index.js

@@ -1,5 +1,5 @@
 "use strict";
 
-export { findVisibleIndexRange } from './findVisibleIndexRange';
 export { useScrollMetrics } from './useScrollMetrics';
+export { computeVisibleItemRange } from './computeVisibleItemRange';
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"names":["findVisibleIndexRange","useScrollMetrics"],"sourceRoot":"../../../src","sources":["windowing/index.ts"],"mappings":";;AACA,SAASA,qBAAqB,QAAQ,yBAAyB;AAC/D,SAASC,gBAAgB,QAAQ,oBAAoB","ignoreList":[]}
+{"version":3,"names":["useScrollMetrics","computeVisibleItemRange"],"sourceRoot":"../../../src","sources":["windowing/index.ts"],"mappings":";;AACA,SAASA,gBAAgB,QAAQ,oBAAoB;AACrD,SAASC,uBAAuB,QAAQ,2BAA2B","ignoreList":[]}

package/lib/typescript/src/cell/Cell.d.ts

@@ -1,13 +1,22 @@
 /**
  * Physical reusable cell.
- * Mirrors FlashList's Cell abstraction.
+ * Represents a single mounted view instance.
  */
 export interface Cell {
-    /** Stable physical identity (never changes) */
+    /**
+     * Stable physical identity.
+     * Used as React key. NEVER changes.
+     */
     readonly key: string;
-    /** Logical data index currently bound */
+    /**
+     * Logical data index currently bound.
+     * Changes as the cell is recycled.
+     */
     index: number;
-    /** Compatibility type (row, header, etc.) */
+    /**
+     * Compatibility type (row, header, etc).
+     * Determines reuse eligibility.
+     */
     readonly type: string;
 }
 //# sourceMappingURL=Cell.d.ts.map

package/lib/typescript/src/cell/Cell.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Cell.d.ts","sourceRoot":"","sources":["../../../../src/cell/Cell.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,IAAI;IACnB,+CAA+C;IAC/C,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IAEpB,yCAAyC;IACzC,KAAK,EAAE,MAAM,CAAA;IAEb,6CAA6C;IAC7C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CACtB"}
+{"version":3,"file":"Cell.d.ts","sourceRoot":"","sources":["../../../../src/cell/Cell.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,IAAI;IACnB;;;OAGG;IACH,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IAEpB;;;OAGG;IACH,KAAK,EAAE,MAAM,CAAA;IAEb;;;OAGG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CACtB"}

package/lib/typescript/src/cell/CellKeyGenerator.d.ts

@@ -0,0 +1,11 @@
+import type { CellKey } from '../types/CellKey';
+/**
+ * Monotonic key generator for physical cell instances.
+ * Guarantees stable keys across the lifetime of the list.
+ */
+export declare class CellKeyGenerator {
+    private nextId;
+    next(): CellKey;
+    reset(): void;
+}
+//# sourceMappingURL=CellKeyGenerator.d.ts.map

package/lib/typescript/src/cell/CellKeyGenerator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CellKeyGenerator.d.ts","sourceRoot":"","sources":["../../../../src/cell/CellKeyGenerator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAA;AAE/C;;;GAGG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,MAAM,CAAI;IAElB,IAAI,IAAI,OAAO;IAIf,KAAK,IAAI,IAAI;CAGd"}