react-native-nitro-list 0.1.1 → 0.1.2

package/lib/commonjs/viewability/ViewabilityHelper.js

@@ -1,121 +0,0 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.ViewabilityHelper = void 0;
-/**
- * Public token describing viewability state of an item.
- * Mirrors FlashList's ViewToken concept.
- */
-
-/**
- * Configuration for viewability calculations.
- */
-
-/**
- * ViewabilityHelper
- *
- * Pure observer:
- * - Does NOT affect layout
- * - Does NOT affect recycling
- * - Computes visibility based on layout + scroll metrics
- *
- * This class is intentionally stateful (lastVisible)
- * to compute "changed" items efficiently.
- */
-class ViewabilityHelper {
-  /** Previously visible indices */
-  lastVisible = new Set();
-  constructor(config = {}) {
-    this.config = config;
-  }
-
-  /**
-   * Computes which items are viewable and which changed
-   * since the last invocation.
-   *
-   * IMPORTANT:
-   * - This method should be called AFTER windowing,
-   *   not on the full dataset.
-   */
-  computeViewableItems(layouts, metrics) {
-    const visibleNow = new Set();
-    const viewableItems = [];
-    const changed = [];
-    const viewportTop = metrics.offsetY;
-    const viewportBottom = viewportTop + metrics.height;
-
-    // Normalize threshold into [0, 1]
-    const threshold = (this.config.itemVisiblePercentThreshold ?? 0) / 100;
-
-    /**
-     * NOTE:
-     * We intentionally iterate layouts sequentially,
-     * but EXIT EARLY when items are completely below viewport.
-     *
-     * This keeps complexity near O(visibleItems),
-     * not O(totalItems).
-     */
-    for (let i = 0; i < layouts.length; i++) {
-      const layout = layouts[i];
-
-      // If item is completely below viewport, stop
-      if (layout.y > viewportBottom) {
-        break;
-      }
-      const itemTop = layout.y;
-      const itemBottom = layout.y + layout.height;
-
-      // If item is completely above viewport, skip
-      if (itemBottom < viewportTop) {
-        continue;
-      }
-
-      // Compute visible intersection
-      const visibleTop = Math.max(itemTop, viewportTop);
-      const visibleBottom = Math.min(itemBottom, viewportBottom);
-      const visibleHeight = Math.max(0, visibleBottom - visibleTop);
-
-      // Guard against zero-height items
-      const itemHeight = layout.height > 0 ? layout.height : 1;
-      const visibleRatio = visibleHeight / itemHeight;
-      if (visibleRatio >= threshold) {
-        visibleNow.add(i);
-        viewableItems.push({
-          index: i,
-          isViewable: true
-        });
-
-        // Newly visible
-        if (!this.lastVisible.has(i)) {
-          changed.push({
-            index: i,
-            isViewable: true
-          });
-        }
-      }
-    }
-
-    /**
-     * Items that were visible before but not anymore
-     */
-    for (const index of this.lastVisible) {
-      if (!visibleNow.has(index)) {
-        changed.push({
-          index,
-          isViewable: false
-        });
-      }
-    }
-
-    // Update snapshot
-    this.lastVisible = visibleNow;
-    return {
-      viewableItems,
-      changed
-    };
-  }
-}
-exports.ViewabilityHelper = ViewabilityHelper;
-//# sourceMappingURL=ViewabilityHelper.js.map

package/lib/commonjs/viewability/ViewabilityHelper.js.map

@@ -1 +0,0 @@
-{"version":3,"names":["ViewabilityHelper","lastVisible","Set","constructor","config","computeViewableItems","layouts","metrics","visibleNow","viewableItems","changed","viewportTop","offsetY","viewportBottom","height","threshold","itemVisiblePercentThreshold","i","length","layout","y","itemTop","itemBottom","visibleTop","Math","max","visibleBottom","min","visibleHeight","itemHeight","visibleRatio","add","push","index","isViewable","has","exports"],"sourceRoot":"../../../src","sources":["viewability/ViewabilityHelper.ts"],"mappings":";;;;;;AAGA;AACA;AACA;AACA;;AAMA;AACA;AACA;;AASA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,MAAMA,iBAAiB,CAAC;EAC7B;EACQC,WAAW,GAAG,IAAIC,GAAG,CAAS,CAAC;EAEvCC,WAAWA,CACQC,MAAyB,GAAG,CAAC,CAAC,EAC/C;IAAA,KADiBA,MAAyB,GAAzBA,MAAyB;EACzC;;EAEH;AACF;AACA;AACA;AACA;AACA;AACA;AACA;EACEC,oBAAoBA,CAClBC,OAAmC,EACnCC,OAAsB,EAItB;IACA,MAAMC,UAAU,GAAG,IAAIN,GAAG,CAAS,CAAC;IACpC,MAAMO,aAA0B,GAAG,EAAE;IACrC,MAAMC,OAAoB,GAAG,EAAE;IAE/B,MAAMC,WAAW,GAAGJ,OAAO,CAACK,OAAO;IACnC,MAAMC,cAAc,GAAGF,WAAW,GAAGJ,OAAO,CAACO,MAAM;;IAEnD;IACA,MAAMC,SAAS,GACb,CAAC,IAAI,CAACX,MAAM,CAACY,2BAA2B,IAAI,CAAC,IAAI,GAAG;;IAEtD;AACJ;AACA;AACA;AACA;AACA;AACA;AACA;IACI,KAAK,IAAIC,CAAC,GAAG,CAAC,EAAEA,CAAC,GAAGX,OAAO,CAACY,MAAM,EAAED,CAAC,EAAE,EAAE;MACvC,MAAME,MAAM,GAAGb,OAAO,CAACW,CAAC,CAAE;;MAE1B;MACA,IAAIE,MAAM,CAACC,CAAC,GAAGP,cAAc,EAAE;QAC7B;MACF;MAEA,MAAMQ,OAAO,GAAGF,MAAM,CAACC,CAAC;MACxB,MAAME,UAAU,GAAGH,MAAM,CAACC,CAAC,GAAGD,MAAM,CAACL,MAAM;;MAE3C;MACA,IAAIQ,UAAU,GAAGX,WAAW,EAAE;QAC5B;MACF;;MAEA;MACA,MAAMY,UAAU,GAAGC,IAAI,CAACC,GAAG,CAACJ,OAAO,EAAEV,WAAW,CAAC;MACjD,MAAMe,aAAa,GAAGF,IAAI,CAACG,GAAG,CAACL,UAAU,EAAET,cAAc,CAAC;MAE1D,MAAMe,aAAa,GAAGJ,IAAI,CAACC,GAAG,CAAC,CAAC,EAAEC,aAAa,GAAGH,UAAU,CAAC;;MAE7D;MACA,MAAMM,UAAU,GACdV,MAAM,CAACL,MAAM,GAAG,CAAC,GAAGK,MAAM,CAACL,MAAM,GAAG,CAAC;MAEvC,MAAMgB,YAAY,GAAGF,aAAa,GAAGC,UAAU;MAE/C,IAAIC,YAAY,IAAIf,SAAS,EAAE;QAC7BP,UAAU,CAACuB,GAAG,CAACd,CAAC,CAAC;QACjBR,aAAa,CAACuB,IAAI,CAAC;UAAEC,KAAK,EAAEhB,CAAC;UAAEiB,UAAU,EAAE;QAAK,CAAC,CAAC;;QAElD;QACA,IAAI,CAAC,IAAI,CAACjC,WAAW,CAACkC,GAAG,CAAClB,CAAC,CAAC,EAAE;UAC5BP,OAAO,CAACsB,IAAI,CAAC;YAAEC,KAAK,EAAEhB,CAAC;YAAEiB,UAAU,EAAE;UAAK,CAAC,CAAC;QAC9C;MACF;IACF;;IAEA;AACJ;AACA;IACI,KAAK,MAAMD,KAAK,IAAI,IAAI,CAAChC,WAAW,EAAE;MACpC,IAAI,CAACO,UAAU,CAAC2B,GAAG,CAACF,KAAK,CAAC,EAAE;QAC1BvB,OAAO,CAACsB,IAAI,CAAC;UAAEC,KAAK;UAAEC,UAAU,EAAE;QAAM,CAAC,CAAC;MAC5C;IACF;;IAEA;IACA,IAAI,CAACjC,WAAW,GAAGO,UAAU;IAE7B,OAAO;MAAEC,aAAa;MAAEC;IAAQ,CAAC;EACnC;AACF;AAAC0B,OAAA,CAAApC,iBAAA,GAAAA,iBAAA","ignoreList":[]}

package/lib/commonjs/windowing/findVisibleIndexRange.js

@@ -1,48 +0,0 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.findVisibleIndexRange = findVisibleIndexRange;
-/**
- * Computes the contiguous range of item indices
- * intersecting the viewport expanded by bufferPx.
- *
- * PURE function. No allocations besides output.
- * FlashList-style windowing.
- */
-function findVisibleIndexRange(layouts, metrics, bufferPx) {
-  const count = layouts.length;
-
-  // 🔒 CRITICAL GUARDS (FlashList-style)
-  if (count === 0 || metrics.height <= 0 || bufferPx < 0) {
-    return [];
-  }
-  const windowStart = Math.max(0, metrics.offsetY - bufferPx);
-  const windowEnd = metrics.offsetY + metrics.height + bufferPx;
-
-  // Binary search for first intersecting item
-  let low = 0;
-  let high = count - 1;
-  let firstVisible = count;
-  while (low <= high) {
-    const mid = low + high >> 1;
-    const rect = layouts[mid];
-    if (rect.y + rect.height >= windowStart) {
-      firstVisible = mid;
-      high = mid - 1;
-    } else {
-      low = mid + 1;
-    }
-  }
-
-  // Linear scan forward
-  const visible = [];
-  for (let i = firstVisible; i < count; i++) {
-    const rect = layouts[i];
-    if (rect.y > windowEnd) break;
-    visible.push(i);
-  }
-  return visible;
-}
-//# sourceMappingURL=findVisibleIndexRange.js.map

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

@@ -1 +0,0 @@
-{"version":3,"names":["findVisibleIndexRange","layouts","metrics","bufferPx","count","length","height","windowStart","Math","max","offsetY","windowEnd","low","high","firstVisible","mid","rect","y","visible","i","push"],"sourceRoot":"../../../src","sources":["windowing/findVisibleIndexRange.ts"],"mappings":";;;;;;AAGA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAASA,qBAAqBA,CACnCC,OAAmC,EACnCC,OAAsB,EACtBC,QAAgB,EACG;EACnB,MAAMC,KAAK,GAAGH,OAAO,CAACI,MAAM;;EAE5B;EACA,IACED,KAAK,KAAK,CAAC,IACXF,OAAO,CAACI,MAAM,IAAI,CAAC,IACnBH,QAAQ,GAAG,CAAC,EACZ;IACA,OAAO,EAAE;EACX;EAEA,MAAMI,WAAW,GACfC,IAAI,CAACC,GAAG,CAAC,CAAC,EAAEP,OAAO,CAACQ,OAAO,GAAGP,QAAQ,CAAC;EAEzC,MAAMQ,SAAS,GACbT,OAAO,CAACQ,OAAO,GAAGR,OAAO,CAACI,MAAM,GAAGH,QAAQ;;EAE7C;EACA,IAAIS,GAAG,GAAG,CAAC;EACX,IAAIC,IAAI,GAAGT,KAAK,GAAG,CAAC;EACpB,IAAIU,YAAY,GAAGV,KAAK;EAExB,OAAOQ,GAAG,IAAIC,IAAI,EAAE;IAClB,MAAME,GAAG,GAAIH,GAAG,GAAGC,IAAI,IAAK,CAAC;IAC7B,MAAMG,IAAI,GAAGf,OAAO,CAACc,GAAG,CAAE;IAE1B,IAAIC,IAAI,CAACC,CAAC,GAAGD,IAAI,CAACV,MAAM,IAAIC,WAAW,EAAE;MACvCO,YAAY,GAAGC,GAAG;MAClBF,IAAI,GAAGE,GAAG,GAAG,CAAC;IAChB,CAAC,MAAM;MACLH,GAAG,GAAGG,GAAG,GAAG,CAAC;IACf;EACF;;EAEA;EACA,MAAMG,OAAiB,GAAG,EAAE;EAE5B,KAAK,IAAIC,CAAC,GAAGL,YAAY,EAAEK,CAAC,GAAGf,KAAK,EAAEe,CAAC,EAAE,EAAE;IACzC,MAAMH,IAAI,GAAGf,OAAO,CAACkB,CAAC,CAAE;IACxB,IAAIH,IAAI,CAACC,CAAC,GAAGN,SAAS,EAAE;IACxBO,OAAO,CAACE,IAAI,CAACD,CAAC,CAAC;EACjB;EAEA,OAAOD,OAAO;AAChB","ignoreList":[]}

package/lib/module/RecyclerList.internal.js

@@ -1,22 +0,0 @@
-"use strict";
-
-import { useCellRenderer } from './hooks/useCellRenderer';
-
-/**
- * INTERNAL hook.
- * MUST ALWAYS CALL hooks in the same order.
- */
-export function useRecyclerListInternal(layouts, metrics, bufferPx, getItemType) {
-  /**
-   * FlashList rule:
-   * Hooks are ALWAYS called.
-   * Inputs are guarded instead.
-   */
-  const safeLayouts = metrics.height > 0 ? layouts : EMPTY_LAYOUTS;
-  const safeBufferPx = metrics.height > 0 ? bufferPx : 0;
-  return useCellRenderer(safeLayouts, metrics, safeBufferPx, getItemType);
-}
-
-/** Stable empty reference */
-const EMPTY_LAYOUTS = [];
-//# sourceMappingURL=RecyclerList.internal.js.map

package/lib/module/RecyclerList.internal.js.map

@@ -1 +0,0 @@
-{"version":3,"names":["useCellRenderer","useRecyclerListInternal","layouts","metrics","bufferPx","getItemType","safeLayouts","height","EMPTY_LAYOUTS","safeBufferPx"],"sourceRoot":"../../src","sources":["RecyclerList.internal.ts"],"mappings":";;AAIA,SAASA,eAAe,QAAQ,yBAAyB;;AAEzD;AACA;AACA;AACA;AACA,OAAO,SAASC,uBAAuBA,CACrCC,OAAmC,EACnCC,OAAsB,EACtBC,QAAgB,EAChBC,WAAsC,EACrB;EAEjB;AACF;AACA;AACA;AACA;EACE,MAAMC,WAAW,GACfH,OAAO,CAACI,MAAM,GAAG,CAAC,GAAGL,OAAO,GAAGM,aAAa;EAE9C,MAAMC,YAAY,GAChBN,OAAO,CAACI,MAAM,GAAG,CAAC,GAAGH,QAAQ,GAAG,CAAC;EAEnC,OAAOJ,eAAe,CACpBM,WAAW,EACXH,OAAO,EACPM,YAAY,EACZJ,WACF,CAAC;AACH;;AAEA;AACA,MAAMG,aAAyC,GAAG,EAAE","ignoreList":[]}

package/lib/module/RecyclerList.js

@@ -1,166 +0,0 @@
-"use strict";
-
-import React, { useMemo, useRef, useEffect } from 'react';
-import { ScrollView, View, StyleSheet } from 'react-native';
-import { useRecyclerListInternal } from './RecyclerList.internal';
-import { useScrollMetrics } from './windowing';
-import { MutableLinearLayout } from './layout/MutableLinearLayout';
-import { ViewabilityHelper } from './viewability/ViewabilityHelper';
-import { PrefetchHelper } from './prefetch/PrefetchHelper';
-
-/**
- * Public API — mirrors FlashList behavior, not internals.
- */
-import { jsx as _jsx } from "react/jsx-runtime";
-/**
- * FlashList invariant:
- * Never allow viewport height = 0 to gate windowing.
- */
-const DEFAULT_VIEWPORT_HEIGHT = 800;
-export function RecyclerList(props) {
-  const {
-    containerWidth,
-    itemCount,
-    itemHeights,
-    estimatedItemHeight = 80,
-    renderBufferRatio = 1.3,
-    getItemType = () => 'default',
-    renderItem,
-    onPrefetch,
-    onViewableItemsChanged
-  } = props;
-
-  /**
-   * 🚨 DEV WARNINGS ONLY (never throw in render!)
-   */
-  if (__DEV__) {
-    if (!itemHeights && itemCount == null) {
-      console.error('RecyclerList requires either itemCount or itemHeights.');
-    }
-    if (itemHeights && itemCount != null) {
-      console.error('Provide only one of itemCount or itemHeights.');
-    }
-  }
-
-  /**
-   * STEP 1: Resolve item count safely (props only).
-   * Never depend on hooks for structural decisions.
-   */
-  const itemLength = itemHeights?.length ?? itemCount ?? 0;
-
-  /**
-   * STEP 2: Resolve initial heights (always defined).
-   */
-  const resolvedHeights = useMemo(() => {
-    if (itemHeights) return itemHeights;
-    return Array.from({
-      length: itemLength
-    }, () => estimatedItemHeight);
-  }, [itemHeights, itemLength, estimatedItemHeight]);
-
-  /**
-   * STEP 3: Mutable layout lifecycle.
-   * Recreate layout only when shape changes.
-   */
-  const layoutRef = useRef(null);
-  const lastLayoutKeyRef = useRef(null);
-  const layoutKey = `${containerWidth}-${itemLength}`;
-  if (!layoutRef.current || lastLayoutKeyRef.current !== layoutKey) {
-    layoutRef.current = new MutableLinearLayout(resolvedHeights, containerWidth);
-    lastLayoutKeyRef.current = layoutKey;
-  }
-
-  /**
-   * STEP 4: Read layout snapshot.
-   */
-  const layouts = layoutRef.current.getLayouts();
-  const contentHeight = layoutRef.current.getContentHeight();
-
-  /**
-   * STEP 5: Scroll metrics.
-   */
-  const {
-    metrics,
-    onScroll,
-    onLayout
-  } = useScrollMetrics();
-
-  /**
-   * STEP 6: Guard initial windowing.
-   */
-  const effectiveViewportHeight = metrics.height > 0 ? metrics.height : DEFAULT_VIEWPORT_HEIGHT;
-  const bufferPx = effectiveViewportHeight * renderBufferRatio;
-
-  /**
-   * STEP 7: Windowing + recycling.
-   */
-  const cells = useRecyclerListInternal(layouts, metrics, bufferPx, getItemType);
-
-  /**
-   * STEP 8: Phase-1 observers.
-   */
-  const viewabilityRef = useRef(new ViewabilityHelper({
-    itemVisiblePercentThreshold: 50
-  }));
-  const prefetchRef = useRef(new PrefetchHelper());
-  useEffect(() => {
-    prefetchRef.current = new PrefetchHelper();
-  }, [itemLength]);
-  useEffect(() => {
-    if (metrics.height === 0) return;
-    if (onViewableItemsChanged) {
-      const visibleLayouts = [];
-      for (const cell of cells) {
-        const layout = layouts[cell.index];
-        if (layout) visibleLayouts.push(layout);
-      }
-      const info = viewabilityRef.current.computeViewableItems(visibleLayouts, metrics);
-      onViewableItemsChanged(info);
-    }
-    if (onPrefetch && itemLength > 0) {
-      prefetchRef.current.runPrefetch(cells.map(c => c.index), itemLength, 5, onPrefetch);
-    }
-  }, [cells, metrics.offsetY, metrics.height, onViewableItemsChanged, onPrefetch, itemLength, layouts]);
-
-  /**
-   * STEP 9: Render absolutely positioned cells.
-   */
-  return /*#__PURE__*/_jsx(ScrollView, {
-    style: styles.container,
-    onLayout: onLayout,
-    onScroll: onScroll,
-    scrollEventThrottle: 16,
-    removeClippedSubviews: true,
-    children: /*#__PURE__*/_jsx(View, {
-      style: [styles.content, {
-        height: contentHeight
-      }],
-      children: cells.map(cell => {
-        const layout = layouts[cell.index];
-        if (!layout) return null;
-        return /*#__PURE__*/_jsx(View, {
-          style: [styles.cell, {
-            top: layout.y,
-            width: layout.width,
-            height: layout.height
-          }],
-          children: renderItem(cell.index)
-        }, cell.key);
-      })
-    })
-  });
-}
-const styles = StyleSheet.create({
-  container: {
-    flex: 1
-  },
-  content: {
-    position: 'relative',
-    width: '100%'
-  },
-  cell: {
-    position: 'absolute',
-    left: 0
-  }
-});
-//# sourceMappingURL=RecyclerList.js.map

package/lib/module/RecyclerList.js.map

@@ -1 +0,0 @@
-{"version":3,"names":["React","useMemo","useRef","useEffect","ScrollView","View","StyleSheet","useRecyclerListInternal","useScrollMetrics","MutableLinearLayout","ViewabilityHelper","PrefetchHelper","jsx","_jsx","DEFAULT_VIEWPORT_HEIGHT","RecyclerList","props","containerWidth","itemCount","itemHeights","estimatedItemHeight","renderBufferRatio","getItemType","renderItem","onPrefetch","onViewableItemsChanged","__DEV__","console","error","itemLength","length","resolvedHeights","Array","from","layoutRef","lastLayoutKeyRef","layoutKey","current","layouts","getLayouts","contentHeight","getContentHeight","metrics","onScroll","onLayout","effectiveViewportHeight","height","bufferPx","cells","viewabilityRef","itemVisiblePercentThreshold","prefetchRef","visibleLayouts","cell","layout","index","push","info","computeViewableItems","runPrefetch","map","c","offsetY","style","styles","container","scrollEventThrottle","removeClippedSubviews","children","content","top","y","width","key","create","flex","position","left"],"sourceRoot":"../../src","sources":["RecyclerList.tsx"],"mappings":"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","ignoreList":[]}

package/lib/module/RecyclerList.types.js

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

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

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

package/lib/module/cell/StableKey.js

@@ -1,6 +0,0 @@
-"use strict";
-
-export function getStableKey(slotKey, index) {
-  return `${slotKey}:${index}`;
-}
-//# sourceMappingURL=StableKey.js.map

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

@@ -1 +0,0 @@
-{"version":3,"names":["getStableKey","slotKey","index"],"sourceRoot":"../../../src","sources":["cell/StableKey.ts"],"mappings":";;AAAA,OAAO,SAASA,YAAYA,CAC1BC,OAAe,EACfC,KAAa,EACL;EACR,OAAO,GAAGD,OAAO,IAAIC,KAAK,EAAE;AAC9B","ignoreList":[]}

package/lib/module/hooks/useCellRenderer.js

@@ -1,58 +0,0 @@
-"use strict";
-
-import { useEffect, useMemo, useRef, useState } from 'react';
-import { CellRecycler } from '../cell/CellRecycler';
-import { findVisibleIndexRange } from '../windowing/findVisibleIndexRange';
-/**
- * 🔒 Stable empty references (module-level)
- * These MUST NOT be recreated per render.
- */
-const EMPTY_INDICES = [];
-
-/**
- * React bridge for CellRecycler.
- * FlashList equivalent: useCellRenderer
- *
- * Responsibilities:
- * - Translate scroll state → visible indices
- * - Ask recycler for physical cells
- * - Commit results with referential stability
- *
- * Responsibilities it does NOT have:
- * ❌ Layout mutation
- * ❌ Measurement
- * ❌ Rendering
- */
-export function useCellRenderer(layouts, metrics, bufferPx, getCellType) {
-  /**
-   * Recycler instance is stable across renders.
-   */
-  const recyclerRef = useRef(new CellRecycler());
-
-  /**
-   * Compute visible indices.
-   * PURE + TOTAL:
-   * - Never throws
-   * - Always returns the same reference when empty
-   */
-  const visibleIndices = useMemo(() => layouts.length === 0 ? EMPTY_INDICES : findVisibleIndexRange(layouts, metrics, bufferPx), [layouts, metrics.offsetY, metrics.height, bufferPx]);
-
-  /**
-   * Physical cells to render.
-   */
-  const [cells, setCells] = useState([]);
-
-  /**
-   * Reconcile visible indices → physical cells.
-   *
-   * FlashList invariant:
-   * - Only update state if identity truly changed
-   * - Prevents pointless re-renders
-   */
-  useEffect(() => {
-    const next = recyclerRef.current.reconcile(visibleIndices, getCellType);
-    setCells(prev => prev.length === next.length && prev.every((c, i) => c === next[i]) ? prev : next);
-  }, [visibleIndices, getCellType]);
-  return cells;
-}
-//# sourceMappingURL=useCellRenderer.js.map

package/lib/module/hooks/useCellRenderer.js.map

@@ -1 +0,0 @@
-{"version":3,"names":["useEffect","useMemo","useRef","useState","CellRecycler","findVisibleIndexRange","EMPTY_INDICES","useCellRenderer","layouts","metrics","bufferPx","getCellType","recyclerRef","visibleIndices","length","offsetY","height","cells","setCells","next","current","reconcile","prev","every","c","i"],"sourceRoot":"../../../src","sources":["hooks/useCellRenderer.ts"],"mappings":";;AAAA,SAASA,SAAS,EAAEC,OAAO,EAAEC,MAAM,EAAEC,QAAQ,QAAQ,OAAO;AAE5D,SAASC,YAAY,QAAQ,sBAAsB;AACnD,SAASC,qBAAqB,QAAQ,oCAAoC;AAI1E;AACA;AACA;AACA;AACA,MAAMC,aAAgC,GAAG,EAAE;;AAE3C;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,eAAeA,CAC7BC,OAAmC,EACnCC,OAAsB,EACtBC,QAAgB,EAChBC,WAAsC,EACrB;EACjB;AACF;AACA;EACE,MAAMC,WAAW,GAAGV,MAAM,CAAe,IAAIE,YAAY,CAAC,CAAC,CAAC;;EAE5D;AACF;AACA;AACA;AACA;AACA;EACE,MAAMS,cAAc,GAAGZ,OAAO,CAC5B,MACEO,OAAO,CAACM,MAAM,KAAK,CAAC,GAChBR,aAAa,GACbD,qBAAqB,CACnBG,OAAO,EACPC,OAAO,EACPC,QACF,CAAC,EACP,CAACF,OAAO,EAAEC,OAAO,CAACM,OAAO,EAAEN,OAAO,CAACO,MAAM,EAAEN,QAAQ,CACrD,CAAC;;EAED;AACF;AACA;EACE,MAAM,CAACO,KAAK,EAAEC,QAAQ,CAAC,GACrBf,QAAQ,CAAkB,EAAE,CAAC;;EAE/B;AACF;AACA;AACA;AACA;AACA;AACA;EACEH,SAAS,CAAC,MAAM;IACd,MAAMmB,IAAI,GACRP,WAAW,CAACQ,OAAO,CAACC,SAAS,CAC3BR,cAAc,EACdF,WACF,CAAC;IAEHO,QAAQ,CAACI,IAAI,IACXA,IAAI,CAACR,MAAM,KAAKK,IAAI,CAACL,MAAM,IAC3BQ,IAAI,CAACC,KAAK,CAAC,CAACC,CAAC,EAAEC,CAAC,KAAKD,CAAC,KAAKL,IAAI,CAACM,CAAC,CAAC,CAAC,GAC/BH,IAAI,GACJH,IACN,CAAC;EACH,CAAC,EAAE,CAACN,cAAc,EAAEF,WAAW,CAAC,CAAC;EAEjC,OAAOM,KAAK;AACd","ignoreList":[]}

package/lib/module/hooks/useStableCallback.js

@@ -1,9 +0,0 @@
-"use strict";
-
-import { useRef, useCallback } from 'react';
-export function useStableCallback(fn) {
-  const ref = useRef(fn);
-  ref.current = fn;
-  return useCallback((...args) => ref.current(...args), []);
-}
-//# sourceMappingURL=useStableCallback.js.map

package/lib/module/hooks/useStableCallback.js.map

@@ -1 +0,0 @@
-{"version":3,"names":["useRef","useCallback","useStableCallback","fn","ref","current","args"],"sourceRoot":"../../../src","sources":["hooks/useStableCallback.ts"],"mappings":";;AAAA,SAASA,MAAM,EAAEC,WAAW,QAAQ,OAAO;AAE3C,OAAO,SAASC,iBAAiBA,CAC/BC,EAAK,EACF;EACH,MAAMC,GAAG,GAAGJ,MAAM,CAACG,EAAE,CAAC;EACtBC,GAAG,CAACC,OAAO,GAAGF,EAAE;EAEhB,OAAOF,WAAW,CACf,CAAC,GAAGK,IAAa,KAAKF,GAAG,CAACC,OAAO,CAAC,GAAGC,IAAI,CAAC,EAC3C,EACF,CAAC;AACH","ignoreList":[]}

package/lib/module/layout/EstimatedLayoutProvider.js

@@ -1,25 +0,0 @@
-"use strict";
-
-/**
- * Layout provider using estimated item heights.
- * Used before real measurements are available.
- */
-export class EstimatedLayoutProvider {
-  constructor(itemCount, itemHeight, width) {
-    this.itemCount = itemCount;
-    this.itemHeight = itemHeight;
-    this.width = width;
-  }
-  getItemCount() {
-    return this.itemCount;
-  }
-  getLayout(index) {
-    return {
-      x: 0,
-      y: index * this.itemHeight,
-      width: this.width,
-      height: this.itemHeight
-    };
-  }
-}
-//# sourceMappingURL=EstimatedLayoutProvider.js.map

package/lib/module/layout/EstimatedLayoutProvider.js.map

@@ -1 +0,0 @@
-{"version":3,"names":["EstimatedLayoutProvider","constructor","itemCount","itemHeight","width","getItemCount","getLayout","index","x","y","height"],"sourceRoot":"../../../src","sources":["layout/EstimatedLayoutProvider.ts"],"mappings":";;AAGA;AACA;AACA;AACA;AACA,OAAO,MAAMA,uBAAuB,CAA2B;EAK7DC,WAAWA,CACTC,SAAiB,EACjBC,UAAkB,EAClBC,KAAa,EACb;IACA,IAAI,CAACF,SAAS,GAAGA,SAAS;IAC1B,IAAI,CAACC,UAAU,GAAGA,UAAU;IAC5B,IAAI,CAACC,KAAK,GAAGA,KAAK;EACpB;EAEAC,YAAYA,CAAA,EAAW;IACrB,OAAO,IAAI,CAACH,SAAS;EACvB;EAEAI,SAASA,CAACC,KAAa,EAAmB;IACxC,OAAO;MACLC,CAAC,EAAE,CAAC;MACJC,CAAC,EAAEF,KAAK,GAAG,IAAI,CAACJ,UAAU;MAC1BC,KAAK,EAAE,IAAI,CAACA,KAAK;MACjBM,MAAM,EAAE,IAAI,CAACP;IACf,CAAC;EACH;AACF","ignoreList":[]}

package/lib/module/layout/LayoutEngine.js

@@ -1,17 +0,0 @@
-"use strict";
-
-/**
- * Resolves layouts eagerly into a contiguous array.
- * Pure, deterministic, and reusable.
- *
- * FlashList equivalent: internal layout resolver.
- */
-export function computeLayouts(provider) {
-  const count = provider.getItemCount();
-  const layouts = new Array(count);
-  for (let i = 0; i < count; i++) {
-    layouts[i] = provider.getLayout(i);
-  }
-  return layouts;
-}
-//# sourceMappingURL=LayoutEngine.js.map

package/lib/module/layout/LayoutEngine.js.map

@@ -1 +0,0 @@
-{"version":3,"names":["computeLayouts","provider","count","getItemCount","layouts","Array","i","getLayout"],"sourceRoot":"../../../src","sources":["layout/LayoutEngine.ts"],"mappings":";;AAGA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASA,cAAcA,CAC5BC,QAAwB,EACI;EAC5B,MAAMC,KAAK,GAAGD,QAAQ,CAACE,YAAY,CAAC,CAAC;EACrC,MAAMC,OAA0B,GAAG,IAAIC,KAAK,CAACH,KAAK,CAAC;EAEnD,KAAK,IAAII,CAAC,GAAG,CAAC,EAAEA,CAAC,GAAGJ,KAAK,EAAEI,CAAC,EAAE,EAAE;IAC9BF,OAAO,CAACE,CAAC,CAAC,GAAGL,QAAQ,CAACM,SAAS,CAACD,CAAC,CAAC;EACpC;EAEA,OAAOF,OAAO;AAChB","ignoreList":[]}

package/lib/module/layout/LayoutProvider.js

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

package/lib/module/layout/LayoutRectangle.js

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

package/lib/module/viewability/ViewabilityHelper.js

@@ -1,116 +0,0 @@
-"use strict";
-
-/**
- * Public token describing viewability state of an item.
- * Mirrors FlashList's ViewToken concept.
- */
-
-/**
- * Configuration for viewability calculations.
- */
-
-/**
- * ViewabilityHelper
- *
- * Pure observer:
- * - Does NOT affect layout
- * - Does NOT affect recycling
- * - Computes visibility based on layout + scroll metrics
- *
- * This class is intentionally stateful (lastVisible)
- * to compute "changed" items efficiently.
- */
-export class ViewabilityHelper {
-  /** Previously visible indices */
-  lastVisible = new Set();
-  constructor(config = {}) {
-    this.config = config;
-  }
-
-  /**
-   * Computes which items are viewable and which changed
-   * since the last invocation.
-   *
-   * IMPORTANT:
-   * - This method should be called AFTER windowing,
-   *   not on the full dataset.
-   */
-  computeViewableItems(layouts, metrics) {
-    const visibleNow = new Set();
-    const viewableItems = [];
-    const changed = [];
-    const viewportTop = metrics.offsetY;
-    const viewportBottom = viewportTop + metrics.height;
-
-    // Normalize threshold into [0, 1]
-    const threshold = (this.config.itemVisiblePercentThreshold ?? 0) / 100;
-
-    /**
-     * NOTE:
-     * We intentionally iterate layouts sequentially,
-     * but EXIT EARLY when items are completely below viewport.
-     *
-     * This keeps complexity near O(visibleItems),
-     * not O(totalItems).
-     */
-    for (let i = 0; i < layouts.length; i++) {
-      const layout = layouts[i];
-
-      // If item is completely below viewport, stop
-      if (layout.y > viewportBottom) {
-        break;
-      }
-      const itemTop = layout.y;
-      const itemBottom = layout.y + layout.height;
-
-      // If item is completely above viewport, skip
-      if (itemBottom < viewportTop) {
-        continue;
-      }
-
-      // Compute visible intersection
-      const visibleTop = Math.max(itemTop, viewportTop);
-      const visibleBottom = Math.min(itemBottom, viewportBottom);
-      const visibleHeight = Math.max(0, visibleBottom - visibleTop);
-
-      // Guard against zero-height items
-      const itemHeight = layout.height > 0 ? layout.height : 1;
-      const visibleRatio = visibleHeight / itemHeight;
-      if (visibleRatio >= threshold) {
-        visibleNow.add(i);
-        viewableItems.push({
-          index: i,
-          isViewable: true
-        });
-
-        // Newly visible
-        if (!this.lastVisible.has(i)) {
-          changed.push({
-            index: i,
-            isViewable: true
-          });
-        }
-      }
-    }
-
-    /**
-     * Items that were visible before but not anymore
-     */
-    for (const index of this.lastVisible) {
-      if (!visibleNow.has(index)) {
-        changed.push({
-          index,
-          isViewable: false
-        });
-      }
-    }
-
-    // Update snapshot
-    this.lastVisible = visibleNow;
-    return {
-      viewableItems,
-      changed
-    };
-  }
-}
-//# sourceMappingURL=ViewabilityHelper.js.map