react-native-nitro-list 0.0.1 → 0.1.1

package/lib/commonjs/measurement/MeasureLayout.js

@@ -0,0 +1,20 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.measureLayout = measureLayout;
+/**
+ * Extracts stable layout measurements from RN onLayout event.
+ */
+function measureLayout(event) {
+  const {
+    width,
+    height
+  } = event.nativeEvent.layout;
+  return {
+    width,
+    height
+  };
+}
+//# sourceMappingURL=MeasureLayout.js.map

package/lib/commonjs/measurement/MeasureLayout.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["measureLayout","event","width","height","nativeEvent","layout"],"sourceRoot":"../../../src","sources":["measurement/MeasureLayout.ts"],"mappings":";;;;;;AAOA;AACA;AACA;AACO,SAASA,aAAaA,CAC3BC,KAAwB,EACR;EAChB,MAAM;IAAEC,KAAK;IAAEC;EAAO,CAAC,GAAGF,KAAK,CAACG,WAAW,CAACC,MAAM;EAElD,OAAO;IACLH,KAAK;IACLC;EACF,CAAC;AACH","ignoreList":[]}

package/lib/commonjs/measurement/useItemMeasurement.js

@@ -0,0 +1,28 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.useItemMeasurement = useItemMeasurement;
+var _react = require("react");
+/**
+ * Hook to measure a rendered item safely.
+ *
+ * Guarantees:
+ * - No duplicate height reports
+ * - No render loops
+ * - Stable callback identity
+ */
+function useItemMeasurement(index, onMeasured) {
+  const lastHeightRef = (0, _react.useRef)(null);
+  const onLayout = (0, _react.useCallback)(e => {
+    const height = e.nativeEvent.layout.height;
+
+    // Ignore identical measurements
+    if (lastHeightRef.current === height) return;
+    lastHeightRef.current = height;
+    onMeasured(index, height);
+  }, [index, onMeasured]);
+  return onLayout;
+}
+//# sourceMappingURL=useItemMeasurement.js.map

package/lib/commonjs/measurement/useItemMeasurement.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_react","require","useItemMeasurement","index","onMeasured","lastHeightRef","useRef","onLayout","useCallback","e","height","nativeEvent","layout","current"],"sourceRoot":"../../../src","sources":["measurement/useItemMeasurement.ts"],"mappings":";;;;;;AAAA,IAAAA,MAAA,GAAAC,OAAA;AAGA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAASC,kBAAkBA,CAChCC,KAAa,EACbC,UAAmD,EACnD;EACA,MAAMC,aAAa,GAAG,IAAAC,aAAM,EAAgB,IAAI,CAAC;EAEjD,MAAMC,QAAQ,GAAG,IAAAC,kBAAW,EACzBC,CAAoB,IAAK;IACxB,MAAMC,MAAM,GAAGD,CAAC,CAACE,WAAW,CAACC,MAAM,CAACF,MAAM;;IAE1C;IACA,IAAIL,aAAa,CAACQ,OAAO,KAAKH,MAAM,EAAE;IAEtCL,aAAa,CAACQ,OAAO,GAAGH,MAAM;IAC9BN,UAAU,CAACD,KAAK,EAAEO,MAAM,CAAC;EAC3B,CAAC,EACD,CAACP,KAAK,EAAEC,UAAU,CACpB,CAAC;EAED,OAAOG,QAAQ;AACjB","ignoreList":[]}

package/lib/commonjs/native/NitroLayoutEngine.js

@@ -0,0 +1,9 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.NitroLayoutEngine = void 0;
+var _reactNativeNitroModules = require("react-native-nitro-modules");
+const NitroLayoutEngine = exports.NitroLayoutEngine = _reactNativeNitroModules.NitroModules.createHybridObject('NitroLayoutEngine');
+//# sourceMappingURL=NitroLayoutEngine.js.map

package/lib/commonjs/native/NitroLayoutEngine.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_reactNativeNitroModules","require","NitroLayoutEngine","exports","NitroModules","createHybridObject"],"sourceRoot":"../../../src","sources":["native/NitroLayoutEngine.ts"],"mappings":";;;;;;AAAA,IAAAA,wBAAA,GAAAC,OAAA;AAGO,MAAMC,iBAAiB,GAAAC,OAAA,CAAAD,iBAAA,GAC5BE,qCAAY,CAACC,kBAAkB,CAC7B,mBACF,CAAC","ignoreList":[]}

package/lib/commonjs/native/NitroList.types.js

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

package/lib/commonjs/native/NitroList.types.js.map

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

package/lib/commonjs/native/NitroRecyclerView.js

@@ -0,0 +1,9 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.NitroRecyclerView = void 0;
+var _reactNative = require("react-native");
+const NitroRecyclerView = exports.NitroRecyclerView = (0, _reactNative.requireNativeComponent)('NitroRecyclerView');
+//# sourceMappingURL=NitroRecyclerView.js.map

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

@@ -0,0 +1 @@
+{"version":3,"names":["_reactNative","require","NitroRecyclerView","exports","requireNativeComponent"],"sourceRoot":"../../../src","sources":["native/NitroRecyclerView.ts"],"mappings":";;;;;;AAAA,IAAAA,YAAA,GAAAC,OAAA;AAMO,MAAMC,iBAAiB,GAAAC,OAAA,CAAAD,iBAAA,GAC5B,IAAAE,mCAAsB,EAAyB,mBAAmB,CAAC","ignoreList":[]}

package/lib/commonjs/prefetch/PrefetchHelper.js

@@ -0,0 +1,39 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.PrefetchHelper = void 0;
+/**
+ * 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.
+ */
+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);
+    }
+  }
+}
+exports.PrefetchHelper = PrefetchHelper;
+//# sourceMappingURL=PrefetchHelper.js.map

package/lib/commonjs/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","exports"],"sourceRoot":"../../../src","sources":["prefetch/PrefetchHelper.ts"],"mappings":";;;;;;AAAA;AACA;AACA;;AAGA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,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;AAACK,OAAA,CAAAnB,cAAA,GAAAA,cAAA","ignoreList":[]}

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

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

package/lib/commonjs/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/commonjs/utils/arrayEqual.js

@@ -0,0 +1,15 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.arrayEqual = arrayEqual;
+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/commonjs/utils/arrayEqual.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["arrayEqual","a","b","length","i","Object","is"],"sourceRoot":"../../../src","sources":["utils/arrayEqual.ts"],"mappings":";;;;;;AAAO,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/commonjs/utils/assertNever.js

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

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

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

package/lib/commonjs/utils/clamp.js

@@ -0,0 +1,10 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.clamp = clamp;
+function clamp(value, min, max) {
+  return Math.min(Math.max(value, min), max);
+}
+//# sourceMappingURL=clamp.js.map

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

@@ -0,0 +1 @@
+{"version":3,"names":["clamp","value","min","max","Math"],"sourceRoot":"../../../src","sources":["utils/clamp.ts"],"mappings":";;;;;;AAAO,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/commonjs/utils/devAssert.js

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

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

@@ -0,0 +1 @@
+{"version":3,"names":["devAssert","condition","message","__DEV__","Error"],"sourceRoot":"../../../src","sources":["utils/devAssert.ts"],"mappings":";;;;;;AAAO,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/commonjs/utils/invariant.js

@@ -0,0 +1,12 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.invariant = invariant;
+function invariant(condition, message) {
+  if (!condition) {
+    throw new Error(`Invariant failed: ${message}`);
+  }
+}
+//# sourceMappingURL=invariant.js.map

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

@@ -0,0 +1 @@
+{"version":3,"names":["invariant","condition","message","Error"],"sourceRoot":"../../../src","sources":["utils/invariant.ts"],"mappings":";;;;;;AAAO,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/commonjs/utils/isDefined.js

@@ -0,0 +1,10 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.isDefined = isDefined;
+function isDefined(value) {
+  return value !== undefined && value !== null;
+}
+//# sourceMappingURL=isDefined.js.map

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

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

package/lib/commonjs/utils/isNumber.js

@@ -0,0 +1,10 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.isNumber = isNumber;
+function isNumber(value) {
+  return typeof value === 'number' && !Number.isNaN(value);
+}
+//# sourceMappingURL=isNumber.js.map

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

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

package/lib/commonjs/utils/noop.js

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

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

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

package/lib/commonjs/utils/shallowEqual.js

@@ -0,0 +1,22 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.shallowEqual = shallowEqual;
+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/commonjs/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":";;;;;;AAAO,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/commonjs/utils/throttle.js

@@ -0,0 +1,17 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.throttle = throttle;
+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/commonjs/utils/throttle.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["throttle","fn","ms","last","args","now","Date"],"sourceRoot":"../../../src","sources":["utils/throttle.ts"],"mappings":";;;;;;AAAO,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/commonjs/viewability/ViewabilityHelper.js

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

@@ -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","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/ScrollMetrics.js

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

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

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

package/lib/commonjs/windowing/findVisibleIndexRange.js

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

@@ -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;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/commonjs/windowing/index.js

@@ -0,0 +1,20 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+Object.defineProperty(exports, "findVisibleIndexRange", {
+  enumerable: true,
+  get: function () {
+    return _findVisibleIndexRange.findVisibleIndexRange;
+  }
+});
+Object.defineProperty(exports, "useScrollMetrics", {
+  enumerable: true,
+  get: function () {
+    return _useScrollMetrics.useScrollMetrics;
+  }
+});
+var _findVisibleIndexRange = require("./findVisibleIndexRange");
+var _useScrollMetrics = require("./useScrollMetrics");
+//# sourceMappingURL=index.js.map

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

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

package/lib/commonjs/windowing/useScrollMetrics.js

@@ -0,0 +1,39 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.useScrollMetrics = useScrollMetrics;
+var _react = require("react");
+/**
+ * Scroll metrics hook.
+ * Provides stable scroll snapshot + handlers.
+ *
+ * FlashList equivalent: useScrollMetrics
+ */
+function useScrollMetrics() {
+  const [metrics, setMetrics] = (0, _react.useState)({
+    offsetY: 0,
+    height: 0
+  });
+  const onScroll = (0, _react.useCallback)(e => {
+    const offsetY = e.nativeEvent.contentOffset.y;
+    setMetrics(prev => prev.offsetY === offsetY ? prev : {
+      ...prev,
+      offsetY
+    });
+  }, []);
+  const onLayout = (0, _react.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/commonjs/windowing/useScrollMetrics.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_react","require","useScrollMetrics","metrics","setMetrics","useState","offsetY","height","onScroll","useCallback","e","nativeEvent","contentOffset","y","prev","onLayout","layout"],"sourceRoot":"../../../src","sources":["windowing/useScrollMetrics.ts"],"mappings":";;;;;;AAAA,IAAAA,MAAA,GAAAC,OAAA;AAQA;AACA;AACA;AACA;AACA;AACA;AACO,SAASC,gBAAgBA,CAAA,EAI9B;EACA,MAAM,CAACC,OAAO,EAAEC,UAAU,CAAC,GAAG,IAAAC,eAAQ,EAAgB;IACpDC,OAAO,EAAE,CAAC;IACVC,MAAM,EAAE;EACV,CAAC,CAAC;EAEF,MAAMC,QAAQ,GAAG,IAAAC,kBAAW,EACzBC,CAA0C,IAAK;IAC9C,MAAMJ,OAAO,GAAGI,CAAC,CAACC,WAAW,CAACC,aAAa,CAACC,CAAC;IAE7CT,UAAU,CAACU,IAAI,IACbA,IAAI,CAACR,OAAO,KAAKA,OAAO,GACpBQ,IAAI,GACJ;MAAE,GAAGA,IAAI;MAAER;IAAQ,CACzB,CAAC;EACH,CAAC,EACD,EACF,CAAC;EAED,MAAMS,QAAQ,GAAG,IAAAN,kBAAW,EACzBC,CAAoB,IAAK;IACxB,MAAMH,MAAM,GAAGG,CAAC,CAACC,WAAW,CAACK,MAAM,CAACT,MAAM;IAE1CH,UAAU,CAACU,IAAI,IACbA,IAAI,CAACP,MAAM,KAAKA,MAAM,GAClBO,IAAI,GACJ;MAAE,GAAGA,IAAI;MAAEP;IAAO,CACxB,CAAC;EACH,CAAC,EACD,EACF,CAAC;EAED,OAAO;IACLJ,OAAO;IACPK,QAAQ;IACRO;EACF,CAAC;AACH","ignoreList":[]}

package/lib/module/NitroList.js

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

package/lib/module/NitroList.js.map

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

package/lib/module/RecyclerList.internal.js

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

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