react-native-nitro-list 0.0.1 → 0.1.1

package/lib/module/native/NitroRecyclerView.js

@@ -0,0 +1,5 @@
+"use strict";
+
+import { requireNativeComponent } from 'react-native';
+export const NitroRecyclerView = requireNativeComponent('NitroRecyclerView');
+//# sourceMappingURL=NitroRecyclerView.js.map

package/lib/module/native/NitroRecyclerView.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["requireNativeComponent","NitroRecyclerView"],"sourceRoot":"../../../src","sources":["native/NitroRecyclerView.ts"],"mappings":";;AAAA,SAASA,sBAAsB,QAAQ,cAAc;AAMrD,OAAO,MAAMC,iBAAiB,GAC5BD,sBAAsB,CAAyB,mBAAmB,CAAC","ignoreList":[]}

package/lib/module/prefetch/PrefetchHelper.js

@@ -0,0 +1,34 @@
+"use strict";
+
+/**
+ * Callback invoked when new items should be prefetched.
+ */
+
+/**
+ * PrefetchHelper
+ *
+ * Stateless with respect to layout.
+ * Only tracks what has already been prefetched to avoid duplication.
+ *
+ * Designed to be driven by *visible window*, not scroll events.
+ */
+export class PrefetchHelper {
+  lastPrefetched = new Set();
+  runPrefetch(visibleIndices, itemCount, aheadCount, onPrefetch) {
+    if (visibleIndices.length === 0) return;
+    const lastVisible = visibleIndices[visibleIndices.length - 1];
+    const start = lastVisible + 1;
+    const end = Math.min(itemCount - 1, start + aheadCount);
+    const toPrefetch = [];
+    for (let i = start; i <= end; i++) {
+      if (!this.lastPrefetched.has(i)) {
+        this.lastPrefetched.add(i);
+        toPrefetch.push(i);
+      }
+    }
+    if (toPrefetch.length > 0) {
+      onPrefetch(toPrefetch);
+    }
+  }
+}
+//# sourceMappingURL=PrefetchHelper.js.map

package/lib/module/prefetch/PrefetchHelper.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["PrefetchHelper","lastPrefetched","Set","runPrefetch","visibleIndices","itemCount","aheadCount","onPrefetch","length","lastVisible","start","end","Math","min","toPrefetch","i","has","add","push"],"sourceRoot":"../../../src","sources":["prefetch/PrefetchHelper.ts"],"mappings":";;AAAA;AACA;AACA;;AAGA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMA,cAAc,CAAC;EAClBC,cAAc,GAAG,IAAIC,GAAG,CAAS,CAAC;EAE1CC,WAAWA,CACTC,cAAiC,EACjCC,SAAiB,EACjBC,UAAkB,EAClBC,UAA4B,EAC5B;IACA,IAAIH,cAAc,CAACI,MAAM,KAAK,CAAC,EAAE;IAEjC,MAAMC,WAAW,GACfL,cAAc,CAACA,cAAc,CAACI,MAAM,GAAG,CAAC,CAAE;IAE5C,MAAME,KAAK,GAAGD,WAAW,GAAG,CAAC;IAC7B,MAAME,GAAG,GAAGC,IAAI,CAACC,GAAG,CAClBR,SAAS,GAAG,CAAC,EACbK,KAAK,GAAGJ,UACV,CAAC;IAED,MAAMQ,UAAoB,GAAG,EAAE;IAE/B,KAAK,IAAIC,CAAC,GAAGL,KAAK,EAAEK,CAAC,IAAIJ,GAAG,EAAEI,CAAC,EAAE,EAAE;MACjC,IAAI,CAAC,IAAI,CAACd,cAAc,CAACe,GAAG,CAACD,CAAC,CAAC,EAAE;QAC/B,IAAI,CAACd,cAAc,CAACgB,GAAG,CAACF,CAAC,CAAC;QAC1BD,UAAU,CAACI,IAAI,CAACH,CAAC,CAAC;MACpB;IACF;IAEA,IAAID,UAAU,CAACN,MAAM,GAAG,CAAC,EAAE;MACzBD,UAAU,CAACO,UAAU,CAAC;IACxB;EACF;AACF","ignoreList":[]}

package/lib/module/specs/nitro-layout-engine.nitro.js

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

package/lib/module/specs/nitro-layout-engine.nitro.js.map

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

package/lib/module/utils/arrayEqual.js

@@ -0,0 +1,11 @@
+"use strict";
+
+export function arrayEqual(a, b) {
+  if (a === b) return true;
+  if (a.length !== b.length) return false;
+  for (let i = 0; i < a.length; i++) {
+    if (!Object.is(a[i], b[i])) return false;
+  }
+  return true;
+}
+//# sourceMappingURL=arrayEqual.js.map

package/lib/module/utils/arrayEqual.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["arrayEqual","a","b","length","i","Object","is"],"sourceRoot":"../../../src","sources":["utils/arrayEqual.ts"],"mappings":";;AAAA,OAAO,SAASA,UAAUA,CACxBC,CAAe,EACfC,CAAe,EACN;EACT,IAAID,CAAC,KAAKC,CAAC,EAAE,OAAO,IAAI;EACxB,IAAID,CAAC,CAACE,MAAM,KAAKD,CAAC,CAACC,MAAM,EAAE,OAAO,KAAK;EAEvC,KAAK,IAAIC,CAAC,GAAG,CAAC,EAAEA,CAAC,GAAGH,CAAC,CAACE,MAAM,EAAEC,CAAC,EAAE,EAAE;IACjC,IAAI,CAACC,MAAM,CAACC,EAAE,CAACL,CAAC,CAACG,CAAC,CAAC,EAAEF,CAAC,CAACE,CAAC,CAAC,CAAC,EAAE,OAAO,KAAK;EAC1C;EAEA,OAAO,IAAI;AACb","ignoreList":[]}

package/lib/module/utils/assertNever.js

@@ -0,0 +1,6 @@
+"use strict";
+
+export function assertNever(x) {
+  throw new Error(`Unexpected value: ${String(x)}`);
+}
+//# sourceMappingURL=assertNever.js.map

package/lib/module/utils/assertNever.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["assertNever","x","Error","String"],"sourceRoot":"../../../src","sources":["utils/assertNever.ts"],"mappings":";;AAAA,OAAO,SAASA,WAAWA,CAACC,CAAQ,EAAS;EAC3C,MAAM,IAAIC,KAAK,CAAC,qBAAqBC,MAAM,CAACF,CAAC,CAAC,EAAE,CAAC;AACnD","ignoreList":[]}

package/lib/module/utils/clamp.js

@@ -0,0 +1,6 @@
+"use strict";
+
+export function clamp(value, min, max) {
+  return Math.min(Math.max(value, min), max);
+}
+//# sourceMappingURL=clamp.js.map

package/lib/module/utils/clamp.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["clamp","value","min","max","Math"],"sourceRoot":"../../../src","sources":["utils/clamp.ts"],"mappings":";;AAAA,OAAO,SAASA,KAAKA,CACnBC,KAAa,EACbC,GAAW,EACXC,GAAW,EACH;EACR,OAAOC,IAAI,CAACF,GAAG,CAACE,IAAI,CAACD,GAAG,CAACF,KAAK,EAAEC,GAAG,CAAC,EAAEC,GAAG,CAAC;AAC5C","ignoreList":[]}

package/lib/module/utils/devAssert.js

@@ -0,0 +1,8 @@
+"use strict";
+
+export function devAssert(condition, message) {
+  if (__DEV__ && !condition) {
+    throw new Error(`RecyclerList: ${message}`);
+  }
+}
+//# sourceMappingURL=devAssert.js.map

package/lib/module/utils/devAssert.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["devAssert","condition","message","__DEV__","Error"],"sourceRoot":"../../../src","sources":["utils/devAssert.ts"],"mappings":";;AAAA,OAAO,SAASA,SAASA,CACvBC,SAAkB,EAClBC,OAAe,EACT;EACN,IAAIC,OAAO,IAAI,CAACF,SAAS,EAAE;IACzB,MAAM,IAAIG,KAAK,CAAC,iBAAiBF,OAAO,EAAE,CAAC;EAC7C;AACF","ignoreList":[]}

package/lib/module/utils/invariant.js

@@ -0,0 +1,8 @@
+"use strict";
+
+export function invariant(condition, message) {
+  if (!condition) {
+    throw new Error(`Invariant failed: ${message}`);
+  }
+}
+//# sourceMappingURL=invariant.js.map

package/lib/module/utils/invariant.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["invariant","condition","message","Error"],"sourceRoot":"../../../src","sources":["utils/invariant.ts"],"mappings":";;AAAA,OAAO,SAASA,SAASA,CACvBC,SAAkB,EAClBC,OAAe,EACI;EACnB,IAAI,CAACD,SAAS,EAAE;IACd,MAAM,IAAIE,KAAK,CAAC,qBAAqBD,OAAO,EAAE,CAAC;EACjD;AACF","ignoreList":[]}

package/lib/module/utils/isDefined.js

@@ -0,0 +1,6 @@
+"use strict";
+
+export function isDefined(value) {
+  return value !== undefined && value !== null;
+}
+//# sourceMappingURL=isDefined.js.map

package/lib/module/utils/isDefined.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["isDefined","value","undefined"],"sourceRoot":"../../../src","sources":["utils/isDefined.ts"],"mappings":";;AAAA,OAAO,SAASA,SAASA,CACvBC,KAA2B,EACf;EACZ,OAAOA,KAAK,KAAKC,SAAS,IAAID,KAAK,KAAK,IAAI;AAC9C","ignoreList":[]}

package/lib/module/utils/isNumber.js

@@ -0,0 +1,6 @@
+"use strict";
+
+export function isNumber(value) {
+  return typeof value === 'number' && !Number.isNaN(value);
+}
+//# sourceMappingURL=isNumber.js.map

package/lib/module/utils/isNumber.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["isNumber","value","Number","isNaN"],"sourceRoot":"../../../src","sources":["utils/isNumber.ts"],"mappings":";;AAAA,OAAO,SAASA,QAAQA,CAACC,KAAc,EAAmB;EACxD,OAAO,OAAOA,KAAK,KAAK,QAAQ,IAAI,CAACC,MAAM,CAACC,KAAK,CAACF,KAAK,CAAC;AAC1D","ignoreList":[]}

package/lib/module/utils/noop.js

@@ -0,0 +1,6 @@
+"use strict";
+
+export function noop() {
+  // intentionally empty
+}
+//# sourceMappingURL=noop.js.map

package/lib/module/utils/noop.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["noop"],"sourceRoot":"../../../src","sources":["utils/noop.ts"],"mappings":";;AAAA,OAAO,SAASA,IAAIA,CAAA,EAAS;EAC3B;AAAA","ignoreList":[]}

package/lib/module/utils/shallowEqual.js

@@ -0,0 +1,18 @@
+"use strict";
+
+export function shallowEqual(a, b) {
+  if (Object.is(a, b)) return true;
+  if (typeof a !== 'object' || typeof b !== 'object' || a === null || b === null) {
+    return false;
+  }
+  const aKeys = Object.keys(a);
+  const bKeys = Object.keys(b);
+  if (aKeys.length !== bKeys.length) return false;
+  for (const key of aKeys) {
+    if (!(key in b) || !Object.is(a[key], b[key])) {
+      return false;
+    }
+  }
+  return true;
+}
+//# sourceMappingURL=shallowEqual.js.map

package/lib/module/utils/shallowEqual.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["shallowEqual","a","b","Object","is","aKeys","keys","bKeys","length","key"],"sourceRoot":"../../../src","sources":["utils/shallowEqual.ts"],"mappings":";;AAAA,OAAO,SAASA,YAAYA,CAC1BC,CAAU,EACVC,CAAU,EACD;EACT,IAAIC,MAAM,CAACC,EAAE,CAACH,CAAC,EAAEC,CAAC,CAAC,EAAE,OAAO,IAAI;EAEhC,IACE,OAAOD,CAAC,KAAK,QAAQ,IACrB,OAAOC,CAAC,KAAK,QAAQ,IACrBD,CAAC,KAAK,IAAI,IACVC,CAAC,KAAK,IAAI,EACV;IACA,OAAO,KAAK;EACd;EAEA,MAAMG,KAAK,GAAGF,MAAM,CAACG,IAAI,CAACL,CAAW,CAAC;EACtC,MAAMM,KAAK,GAAGJ,MAAM,CAACG,IAAI,CAACJ,CAAW,CAAC;EAEtC,IAAIG,KAAK,CAACG,MAAM,KAAKD,KAAK,CAACC,MAAM,EAAE,OAAO,KAAK;EAE/C,KAAK,MAAMC,GAAG,IAAIJ,KAAK,EAAE;IACvB,IACE,EAAEI,GAAG,IAAKP,CAAY,CAAC,IACvB,CAACC,MAAM,CAACC,EAAE,CACPH,CAAC,CAA6BQ,GAAG,CAAC,EAClCP,CAAC,CAA6BO,GAAG,CACpC,CAAC,EACD;MACA,OAAO,KAAK;IACd;EACF;EAEA,OAAO,IAAI;AACb","ignoreList":[]}

package/lib/module/utils/throttle.js

@@ -0,0 +1,13 @@
+"use strict";
+
+export function throttle(fn, ms) {
+  let last = 0;
+  return (...args) => {
+    const now = Date.now();
+    if (now - last > ms) {
+      last = now;
+      fn(...args);
+    }
+  };
+}
+//# sourceMappingURL=throttle.js.map

package/lib/module/utils/throttle.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["throttle","fn","ms","last","args","now","Date"],"sourceRoot":"../../../src","sources":["utils/throttle.ts"],"mappings":";;AAAA,OAAO,SAASA,QAAQA,CACtBC,EAAK,EACLC,EAAU,EACP;EACH,IAAIC,IAAI,GAAG,CAAC;EACZ,OAAQ,CAAC,GAAGC,IAAa,KAAK;IAC5B,MAAMC,GAAG,GAAGC,IAAI,CAACD,GAAG,CAAC,CAAC;IACtB,IAAIA,GAAG,GAAGF,IAAI,GAAGD,EAAE,EAAE;MACnBC,IAAI,GAAGE,GAAG;MACVJ,EAAE,CAAC,GAAGG,IAAI,CAAC;IACb;EACF,CAAC;AACH","ignoreList":[]}

package/lib/module/viewability/ViewabilityHelper.js

@@ -0,0 +1,116 @@
+"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

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

@@ -0,0 +1 @@
+{"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"],"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;AACA,OAAO,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","ignoreList":[]}

package/lib/module/windowing/ScrollMetrics.js

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

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

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

package/lib/module/windowing/findVisibleIndexRange.js

@@ -0,0 +1,44 @@
+"use strict";
+
+/**
+ * Computes the contiguous range of item indices
+ * intersecting the viewport expanded by bufferPx.
+ *
+ * PURE function. No allocations besides output.
+ * FlashList-style windowing.
+ */
+export 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/module/windowing/findVisibleIndexRange.js.map

@@ -0,0 +1 @@
+{"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;AACA,OAAO,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/windowing/index.js

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

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

@@ -0,0 +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":[]}

package/lib/module/windowing/useScrollMetrics.js

@@ -0,0 +1,35 @@
+"use strict";
+
+import { useCallback, useState } from 'react';
+/**
+ * Scroll metrics hook.
+ * Provides stable scroll snapshot + handlers.
+ *
+ * FlashList equivalent: useScrollMetrics
+ */
+export function useScrollMetrics() {
+  const [metrics, setMetrics] = useState({
+    offsetY: 0,
+    height: 0
+  });
+  const onScroll = useCallback(e => {
+    const offsetY = e.nativeEvent.contentOffset.y;
+    setMetrics(prev => prev.offsetY === offsetY ? prev : {
+      ...prev,
+      offsetY
+    });
+  }, []);
+  const onLayout = useCallback(e => {
+    const height = e.nativeEvent.layout.height;
+    setMetrics(prev => prev.height === height ? prev : {
+      ...prev,
+      height
+    });
+  }, []);
+  return {
+    metrics,
+    onScroll,
+    onLayout
+  };
+}
+//# sourceMappingURL=useScrollMetrics.js.map

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

@@ -0,0 +1 @@
+{"version":3,"names":["useCallback","useState","useScrollMetrics","metrics","setMetrics","offsetY","height","onScroll","e","nativeEvent","contentOffset","y","prev","onLayout","layout"],"sourceRoot":"../../../src","sources":["windowing/useScrollMetrics.ts"],"mappings":";;AAAA,SAASA,WAAW,EAAEC,QAAQ,QAAQ,OAAO;AAQ7C;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,gBAAgBA,CAAA,EAI9B;EACA,MAAM,CAACC,OAAO,EAAEC,UAAU,CAAC,GAAGH,QAAQ,CAAgB;IACpDI,OAAO,EAAE,CAAC;IACVC,MAAM,EAAE;EACV,CAAC,CAAC;EAEF,MAAMC,QAAQ,GAAGP,WAAW,CACzBQ,CAA0C,IAAK;IAC9C,MAAMH,OAAO,GAAGG,CAAC,CAACC,WAAW,CAACC,aAAa,CAACC,CAAC;IAE7CP,UAAU,CAACQ,IAAI,IACbA,IAAI,CAACP,OAAO,KAAKA,OAAO,GACpBO,IAAI,GACJ;MAAE,GAAGA,IAAI;MAAEP;IAAQ,CACzB,CAAC;EACH,CAAC,EACD,EACF,CAAC;EAED,MAAMQ,QAAQ,GAAGb,WAAW,CACzBQ,CAAoB,IAAK;IACxB,MAAMF,MAAM,GAAGE,CAAC,CAACC,WAAW,CAACK,MAAM,CAACR,MAAM;IAE1CF,UAAU,CAACQ,IAAI,IACbA,IAAI,CAACN,MAAM,KAAKA,MAAM,GAClBM,IAAI,GACJ;MAAE,GAAGA,IAAI;MAAEN;IAAO,CACxB,CAAC;EACH,CAAC,EACD,EACF,CAAC;EAED,OAAO;IACLH,OAAO;IACPI,QAAQ;IACRM;EACF,CAAC;AACH","ignoreList":[]}

package/lib/typescript/src/NitroList.d.ts

@@ -0,0 +1,5 @@
+export type NitroRecyclerViewProps = {
+    itemCount: number;
+};
+export declare const NitroRecyclerView: import("react-native").HostComponent<NitroRecyclerViewProps>;
+//# sourceMappingURL=NitroList.d.ts.map

package/lib/typescript/src/NitroList.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NitroList.d.ts","sourceRoot":"","sources":["../../../src/NitroList.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,sBAAsB,GAAG;IACnC,SAAS,EAAE,MAAM,CAAA;CAClB,CAAA;AAED,eAAO,MAAM,iBAAiB,8DACuC,CAAA"}

package/lib/typescript/src/RecyclerList.d.ts

@@ -0,0 +1,26 @@
+import React from 'react';
+/**
+ * Public API — mirrors FlashList behavior, not internals.
+ */
+export type RecyclerListProps = {
+    containerWidth: number;
+    itemCount?: number;
+    itemHeights?: readonly number[];
+    estimatedItemHeight?: number;
+    renderBufferRatio?: number;
+    getItemType?: (index: number) => string;
+    renderItem: (index: number) => React.ReactElement;
+    onPrefetch?: (indices: number[]) => void;
+    onViewableItemsChanged?: (info: {
+        viewableItems: {
+            index: number;
+            isViewable: boolean;
+        }[];
+        changed: {
+            index: number;
+            isViewable: boolean;
+        }[];
+    }) => void;
+};
+export declare function RecyclerList(props: RecyclerListProps): React.ReactElement;
+//# sourceMappingURL=RecyclerList.d.ts.map

package/lib/typescript/src/RecyclerList.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RecyclerList.d.ts","sourceRoot":"","sources":["../../../src/RecyclerList.tsx"],"names":[],"mappings":"AAAA,OAAO,KAIN,MAAM,OAAO,CAAA;AAgBd;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC9B,cAAc,EAAE,MAAM,CAAA;IACtB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,WAAW,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IAC/B,mBAAmB,CAAC,EAAE,MAAM,CAAA;IAC5B,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAA;IACvC,UAAU,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,KAAK,CAAC,YAAY,CAAA;IACjD,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,IAAI,CAAA;IACxC,sBAAsB,CAAC,EAAE,CAAC,IAAI,EAAE;QAC9B,aAAa,EAAE;YAAE,KAAK,EAAE,MAAM,CAAC;YAAC,UAAU,EAAE,OAAO,CAAA;SAAE,EAAE,CAAA;QACvD,OAAO,EAAE;YAAE,KAAK,EAAE,MAAM,CAAC;YAAC,UAAU,EAAE,OAAO,CAAA;SAAE,EAAE,CAAA;KAClD,KAAK,IAAI,CAAA;CACX,CAAA;AAQD,wBAAgB,YAAY,CAAC,KAAK,EAAE,iBAAiB,GAAG,KAAK,CAAC,YAAY,CAyMzE"}

package/lib/typescript/src/RecyclerList.internal.d.ts

@@ -0,0 +1,9 @@
+import type { LayoutRectangle } from './layout/LayoutRectangle';
+import type { ScrollMetrics } from './windowing/ScrollMetrics';
+import type { Cell } from './cell/Cell';
+/**
+ * INTERNAL hook.
+ * MUST ALWAYS CALL hooks in the same order.
+ */
+export declare function useRecyclerListInternal(layouts: readonly LayoutRectangle[], metrics: ScrollMetrics, bufferPx: number, getItemType: (index: number) => string): readonly Cell[];
+//# sourceMappingURL=RecyclerList.internal.d.ts.map

package/lib/typescript/src/RecyclerList.internal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RecyclerList.internal.d.ts","sourceRoot":"","sources":["../../../src/RecyclerList.internal.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAA;AAC/D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAA;AAC9D,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,aAAa,CAAA;AAIvC;;;GAGG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,SAAS,eAAe,EAAE,EACnC,OAAO,EAAE,aAAa,EACtB,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,GACrC,SAAS,IAAI,EAAE,CAmBjB"}

package/lib/typescript/src/RecyclerList.types.d.ts

@@ -0,0 +1,18 @@
+import type React from 'react';
+export type RecyclerListProps = {
+    /** Width of the list container (required) */
+    readonly containerWidth: number;
+    /** Total number of items (used with estimatedItemHeight) */
+    readonly itemCount?: number;
+    /** Explicit item heights (fast path, skips estimation) */
+    readonly itemHeights?: readonly number[];
+    /** Estimated item height when itemHeights not provided */
+    readonly estimatedItemHeight?: number;
+    /** Render buffer multiplier (FlashList-style, default ~1.3) */
+    readonly renderBufferRatio?: number;
+    /** Optional item type resolver for recycling */
+    readonly getItemType?: (index: number) => string;
+    /** Render function */
+    readonly renderItem: (index: number) => React.ReactElement;
+};
+//# sourceMappingURL=RecyclerList.types.d.ts.map

package/lib/typescript/src/RecyclerList.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RecyclerList.types.d.ts","sourceRoot":"","sources":["../../../src/RecyclerList.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAE9B,MAAM,MAAM,iBAAiB,GAAG;IAC9B,6CAA6C;IAC7C,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAA;IAE/B,4DAA4D;IAC5D,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;IAE3B,0DAA0D;IAC1D,QAAQ,CAAC,WAAW,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IAExC,0DAA0D;IAC1D,QAAQ,CAAC,mBAAmB,CAAC,EAAE,MAAM,CAAA;IAErC,+DAA+D;IAC/D,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAEnC,gDAAgD;IAChD,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAA;IAEhD,sBAAsB;IACtB,QAAQ,CAAC,UAAU,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,KAAK,CAAC,YAAY,CAAA;CAC3D,CAAA"}

package/lib/typescript/src/ReusableView.d.ts

@@ -0,0 +1,9 @@
+export type ReusableView = {
+    /** Stable identity for React */
+    readonly key: string;
+    /** Current data index bound to this slot */
+    index: number;
+    /** Optional type (header, row, etc — future) */
+    type?: string;
+};
+//# sourceMappingURL=ReusableView.d.ts.map

package/lib/typescript/src/ReusableView.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ReusableView.d.ts","sourceRoot":"","sources":["../../../src/ReusableView.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,YAAY,GAAG;IACzB,gCAAgC;IAChC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IAEpB,4CAA4C;IAC5C,KAAK,EAAE,MAAM,CAAA;IAEb,gDAAgD;IAChD,IAAI,CAAC,EAAE,MAAM,CAAA;CACd,CAAA"}

package/lib/typescript/src/__tests__/windowing/findVisibleIndexRange.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=findVisibleIndexRange.test.d.ts.map

package/lib/typescript/src/__tests__/windowing/findVisibleIndexRange.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"findVisibleIndexRange.test.d.ts","sourceRoot":"","sources":["../../../../../src/__tests__/windowing/findVisibleIndexRange.test.ts"],"names":[],"mappings":""}

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

@@ -0,0 +1,13 @@
+/**
+ * Physical reusable cell.
+ * Mirrors FlashList's Cell abstraction.
+ */
+export interface Cell {
+    /** Stable physical identity (never changes) */
+    readonly key: string;
+    /** Logical data index currently bound */
+    index: number;
+    /** Compatibility type (row, header, etc.) */
+    readonly type: string;
+}
+//# sourceMappingURL=Cell.d.ts.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,19 @@
+import type { Cell } from './Cell';
+/**
+ * Owns physical cell reuse.
+ * Stateful, imperative, React-agnostic.
+ *
+ * FlashList equivalent: CellRecycler
+ */
+export declare class CellRecycler {
+    private readonly activeCells;
+    private readonly reusableCellsByType;
+    private readonly orderedCells;
+    private nextCellId;
+    /**
+     * Reconcile visible indices against existing cells.
+     * Returns a stable ordered snapshot.
+     */
+    reconcile(visibleIndices: readonly number[], getCellType: (index: number) => string): readonly Cell[];
+}
+//# sourceMappingURL=CellRecycler.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"CellRecycler.d.ts","sourceRoot":"","sources":["../../../../src/cell/CellRecycler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAA;AAIlC;;;;;GAKG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA0B;IACtD,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAA4B;IAChE,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAa;IAC1C,OAAO,CAAC,UAAU,CAAI;IAEtB;;;OAGG;IACH,SAAS,CACP,cAAc,EAAE,SAAS,MAAM,EAAE,EACjC,WAAW,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,GACrC,SAAS,IAAI,EAAE;CA0CnB"}

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

@@ -0,0 +1,2 @@
+export declare function getStableKey(slotKey: string, index: number): string;
+//# sourceMappingURL=StableKey.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"StableKey.d.ts","sourceRoot":"","sources":["../../../../src/cell/StableKey.ts"],"names":[],"mappings":"AAAA,wBAAgB,YAAY,CAC1B,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,GACZ,MAAM,CAER"}

package/lib/typescript/src/debug/useDebugOverlay.d.ts

@@ -0,0 +1,2 @@
+export declare function useDebugOverlay(enabled: boolean, visibleCount: number): void;
+//# sourceMappingURL=useDebugOverlay.d.ts.map

package/lib/typescript/src/debug/useDebugOverlay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDebugOverlay.d.ts","sourceRoot":"","sources":["../../../../src/debug/useDebugOverlay.ts"],"names":[],"mappings":"AAEA,wBAAgB,eAAe,CAC7B,OAAO,EAAE,OAAO,EAChB,YAAY,EAAE,MAAM,GACnB,IAAI,CAQN"}

package/lib/typescript/src/getVisibleIndices.d.ts

@@ -0,0 +1,8 @@
+import type { LayoutRectangle } from './layout/LayoutRectangle';
+import type { ScrollMetrics } from './windowing/ScrollMetrics';
+/**
+ * Binary-search based windowing.
+ * Returns indices intersecting viewport ± buffer.
+ */
+export declare function getVisibleRange(layouts: readonly LayoutRectangle[], metrics: ScrollMetrics, bufferPx: number): readonly number[];
+//# sourceMappingURL=getVisibleIndices.d.ts.map

package/lib/typescript/src/getVisibleIndices.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getVisibleIndices.d.ts","sourceRoot":"","sources":["../../../src/getVisibleIndices.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAA;AAC/D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAA;AAE9D;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,SAAS,eAAe,EAAE,EACnC,OAAO,EAAE,aAAa,EACtB,QAAQ,EAAE,MAAM,GACf,SAAS,MAAM,EAAE,CAyCnB"}