react-native-nitro-list 0.0.1 → 0.1.2

package/lib/commonjs/windowing/computeVisibleItemRange.js

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

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

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

package/lib/commonjs/windowing/index.js

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

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

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

package/lib/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/ReusableView.js

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

package/lib/module/ReusableView.js.map

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

package/lib/module/cell/Cell.js

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

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

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

package/lib/module/cell/CellKeyGenerator.js

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

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

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

package/lib/module/cell/CellRecycler.js

@@ -0,0 +1,66 @@
+"use strict";
+
+import { createCell } from './createCell';
+
+/**
+ * Manages physical cell reuse.
+ * Imperative and stateful by design.
+ * This is NOT React code.
+ */
+export class CellRecycler {
+  /**
+   * Active cells mapped by logical index.
+   */
+  indexToCell = new Map();
+
+  /**
+   * Pool of detached reusable cells.
+   */
+  recycledCells = [];
+
+  /**
+   * Reconcile a contiguous visible index range
+   * into a stable list of physical cells.
+   *
+   * HOT PATH:
+   * - No index arrays
+   * - Minimal allocations
+   * - Deterministic
+   */
+  reconcileRange(startIndex, endIndex, resolveCellType) {
+    const nextActive = [];
+
+    // Track which current indices are no longer visible
+    const unusedIndices = new Set(this.indexToCell.keys());
+    for (let index = startIndex; index <= endIndex; index++) {
+      unusedIndices.delete(index);
+      let cell = this.indexToCell.get(index);
+      if (cell) {
+        // Existing assignment — reuse
+        nextActive.push(cell);
+        continue;
+      }
+      const type = resolveCellType(index);
+
+      // Try to reuse a recycled cell of same type
+      const recycledIdx = this.recycledCells.findIndex(c => c.type === type);
+      if (recycledIdx !== -1) {
+        cell = this.recycledCells.splice(recycledIdx, 1)[0];
+      } else {
+        cell = createCell(type);
+      }
+      cell.index = index;
+      this.indexToCell.set(index, cell);
+      nextActive.push(cell);
+    }
+
+    // Recycle cells that left the visible window
+    for (const index of unusedIndices) {
+      const cell = this.indexToCell.get(index);
+      this.indexToCell.delete(index);
+      this.recycledCells.push(cell);
+    }
+    return nextActive;
+  }
+}
+//# sourceMappingURL=CellRecycler.js.map

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

@@ -0,0 +1 @@
+{"version":3,"names":["createCell","CellRecycler","indexToCell","Map","recycledCells","reconcileRange","startIndex","endIndex","resolveCellType","nextActive","unusedIndices","Set","keys","index","delete","cell","get","push","type","recycledIdx","findIndex","c","splice","set"],"sourceRoot":"../../../src","sources":["cell/CellRecycler.ts"],"mappings":";;AACA,SAASA,UAAU,QAAQ,cAAc;;AAEzC;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMC,YAAY,CAAC;EACxB;AACF;AACA;EACmBC,WAAW,GAAG,IAAIC,GAAG,CAAe,CAAC;;EAEtD;AACF;AACA;EACmBC,aAAa,GAAW,EAAE;;EAE3C;AACF;AACA;AACA;AACA;AACA;AACA;AACA;AACA;EACEC,cAAcA,CACZC,UAAkB,EAClBC,QAAgB,EAChBC,eAA0C,EACzB;IACjB,MAAMC,UAAkB,GAAG,EAAE;;IAE7B;IACA,MAAMC,aAAa,GAAG,IAAIC,GAAG,CAAC,IAAI,CAACT,WAAW,CAACU,IAAI,CAAC,CAAC,CAAC;IAEtD,KAAK,IAAIC,KAAK,GAAGP,UAAU,EAAEO,KAAK,IAAIN,QAAQ,EAAEM,KAAK,EAAE,EAAE;MACvDH,aAAa,CAACI,MAAM,CAACD,KAAK,CAAC;MAE3B,IAAIE,IAAI,GAAG,IAAI,CAACb,WAAW,CAACc,GAAG,CAACH,KAAK,CAAC;MACtC,IAAIE,IAAI,EAAE;QACR;QACAN,UAAU,CAACQ,IAAI,CAACF,IAAI,CAAC;QACrB;MACF;MAEA,MAAMG,IAAI,GAAGV,eAAe,CAACK,KAAK,CAAC;;MAEnC;MACA,MAAMM,WAAW,GAAG,IAAI,CAACf,aAAa,CAACgB,SAAS,CAC9CC,CAAC,IAAIA,CAAC,CAACH,IAAI,KAAKA,IAClB,CAAC;MAED,IAAIC,WAAW,KAAK,CAAC,CAAC,EAAE;QACtBJ,IAAI,GAAG,IAAI,CAACX,aAAa,CAACkB,MAAM,CAACH,WAAW,EAAE,CAAC,CAAC,CAAC,CAAC,CAAE;MACtD,CAAC,MAAM;QACLJ,IAAI,GAAGf,UAAU,CAACkB,IAAI,CAAC;MACzB;MAEAH,IAAI,CAACF,KAAK,GAAGA,KAAK;MAClB,IAAI,CAACX,WAAW,CAACqB,GAAG,CAACV,KAAK,EAAEE,IAAI,CAAC;MACjCN,UAAU,CAACQ,IAAI,CAACF,IAAI,CAAC;IACvB;;IAEA;IACA,KAAK,MAAMF,KAAK,IAAIH,aAAa,EAAE;MACjC,MAAMK,IAAI,GAAG,IAAI,CAACb,WAAW,CAACc,GAAG,CAACH,KAAK,CAAE;MACzC,IAAI,CAACX,WAAW,CAACY,MAAM,CAACD,KAAK,CAAC;MAC9B,IAAI,CAACT,aAAa,CAACa,IAAI,CAACF,IAAI,CAAC;IAC/B;IAEA,OAAON,UAAU;EACnB;AACF","ignoreList":[]}

package/lib/module/cell/createCell.js

@@ -0,0 +1,17 @@
+"use strict";
+
+let nextCellId = 0;
+
+/**
+ * Creates a new physical cell with a stable identity.
+ * The key is generated ONCE and never changes.
+ */
+export function createCell(type) {
+  return {
+    key: `cell-${nextCellId++}`,
+    // stable physical identity
+    type,
+    index: -1 // assigned by recycler
+  };
+}
+//# sourceMappingURL=createCell.js.map

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

@@ -0,0 +1 @@
+{"version":3,"names":["nextCellId","createCell","type","key","index"],"sourceRoot":"../../../src","sources":["cell/createCell.ts"],"mappings":";;AAEA,IAAIA,UAAU,GAAG,CAAC;;AAElB;AACA;AACA;AACA;AACA,OAAO,SAASC,UAAUA,CAACC,IAAY,EAAQ;EAC7C,OAAO;IACLC,GAAG,EAAE,QAAQH,UAAU,EAAE,EAAE;IAAE;IAC7BE,IAAI;IACJE,KAAK,EAAE,CAAC,CAAC,CAAmB;EAC9B,CAAC;AACH","ignoreList":[]}

package/lib/module/cell/index.js

@@ -0,0 +1,7 @@
+"use strict";
+
+// Public cell-layer exports
+
+export { CellRecycler } from './CellRecycler';
+export { createCell } from './createCell';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"names":["CellRecycler","createCell"],"sourceRoot":"../../../src","sources":["cell/index.ts"],"mappings":";;AAAA;;AAGA,SAASA,YAAY,QAAQ,gBAAgB;AAC7C,SAASC,UAAU,QAAQ,cAAc","ignoreList":[]}

package/lib/module/debug/useDebugOverlay.js

@@ -0,0 +1,11 @@
+"use strict";
+
+import { useEffect } from 'react';
+export function useDebugOverlay(enabled, visibleCount) {
+  useEffect(() => {
+    if (__DEV__ && enabled) {
+      console.log(`[RecyclerList] visible items: ${visibleCount}`);
+    }
+  }, [enabled, visibleCount]);
+}
+//# sourceMappingURL=useDebugOverlay.js.map

package/lib/module/debug/useDebugOverlay.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["useEffect","useDebugOverlay","enabled","visibleCount","__DEV__","console","log"],"sourceRoot":"../../../src","sources":["debug/useDebugOverlay.ts"],"mappings":";;AAAA,SAASA,SAAS,QAAQ,OAAO;AAEjC,OAAO,SAASC,eAAeA,CAC7BC,OAAgB,EAChBC,YAAoB,EACd;EACNH,SAAS,CAAC,MAAM;IACd,IAAII,OAAO,IAAIF,OAAO,EAAE;MACtBG,OAAO,CAACC,GAAG,CACT,iCAAiCH,YAAY,EAC/C,CAAC;IACH;EACF,CAAC,EAAE,CAACD,OAAO,EAAEC,YAAY,CAAC,CAAC;AAC7B","ignoreList":[]}

package/lib/module/getVisibleIndices.js

@@ -0,0 +1,34 @@
+"use strict";
+
+/**
+ * Binary-search based windowing.
+ * Returns indices intersecting viewport ± buffer.
+ */
+export function getVisibleRange(layouts, metrics, bufferPx) {
+  if (layouts.length === 0 || metrics.height <= 0) {
+    return [];
+  }
+  const startY = Math.max(0, metrics.offsetY - bufferPx);
+  const endY = metrics.offsetY + metrics.height + bufferPx;
+  let low = 0;
+  let high = layouts.length - 1;
+  let first = layouts.length;
+  while (low <= high) {
+    const mid = low + high >> 1;
+    const rect = layouts[mid];
+    if (rect.y + rect.height >= startY) {
+      first = mid;
+      high = mid - 1;
+    } else {
+      low = mid + 1;
+    }
+  }
+  const visible = [];
+  for (let i = first; i < layouts.length; i++) {
+    const rect = layouts[i];
+    if (rect.y > endY) break;
+    visible.push(i);
+  }
+  return visible;
+}
+//# sourceMappingURL=getVisibleIndices.js.map

package/lib/module/getVisibleIndices.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["getVisibleRange","layouts","metrics","bufferPx","length","height","startY","Math","max","offsetY","endY","low","high","first","mid","rect","y","visible","i","push"],"sourceRoot":"../../src","sources":["getVisibleIndices.ts"],"mappings":";;AAKA;AACA;AACA;AACA;AACA,OAAO,SAASA,eAAeA,CAC7BC,OAA8B,EAC9BC,OAAsB,EACtBC,QAAgB,EACG;EACnB,IACEF,OAAO,CAACG,MAAM,KAAK,CAAC,IACpBF,OAAO,CAACG,MAAM,IAAI,CAAC,EACnB;IACA,OAAO,EAAE;EACX;EAEA,MAAMC,MAAM,GAAGC,IAAI,CAACC,GAAG,CACrB,CAAC,EACDN,OAAO,CAACO,OAAO,GAAGN,QACpB,CAAC;EAED,MAAMO,IAAI,GACRR,OAAO,CAACO,OAAO,GAAGP,OAAO,CAACG,MAAM,GAAGF,QAAQ;EAE7C,IAAIQ,GAAG,GAAG,CAAC;EACX,IAAIC,IAAI,GAAGX,OAAO,CAACG,MAAM,GAAG,CAAC;EAC7B,IAAIS,KAAK,GAAGZ,OAAO,CAACG,MAAM;EAE1B,OAAOO,GAAG,IAAIC,IAAI,EAAE;IAClB,MAAME,GAAG,GAAIH,GAAG,GAAGC,IAAI,IAAK,CAAC;IAC7B,MAAMG,IAAI,GAAGd,OAAO,CAACa,GAAG,CAAE;IAE1B,IAAIC,IAAI,CAACC,CAAC,GAAGD,IAAI,CAACV,MAAM,IAAIC,MAAM,EAAE;MAClCO,KAAK,GAAGC,GAAG;MACXF,IAAI,GAAGE,GAAG,GAAG,CAAC;IAChB,CAAC,MAAM;MACLH,GAAG,GAAGG,GAAG,GAAG,CAAC;IACf;EACF;EAEA,MAAMG,OAAiB,GAAG,EAAE;EAE5B,KAAK,IAAIC,CAAC,GAAGL,KAAK,EAAEK,CAAC,GAAGjB,OAAO,CAACG,MAAM,EAAEc,CAAC,EAAE,EAAE;IAC3C,MAAMH,IAAI,GAAGd,OAAO,CAACiB,CAAC,CAAE;IACxB,IAAIH,IAAI,CAACC,CAAC,GAAGN,IAAI,EAAE;IACnBO,OAAO,CAACE,IAAI,CAACD,CAAC,CAAC;EACjB;EAEA,OAAOD,OAAO;AAChB","ignoreList":[]}

package/lib/module/hooks/usePersistentCallback.js

@@ -0,0 +1,33 @@
+"use strict";
+
+import { useRef, useCallback } from 'react';
+
+/**
+ * Returns a function whose identity is stable across renders,
+ * but always invokes the latest provided implementation.
+ *
+ * Invariants:
+ * - Function reference NEVER changes
+ * - Logic is ALWAYS up to date
+ *
+ * This is critical for long-lived systems such as:
+ * - Recyclers
+ * - Effects
+ * - Native bridges
+ * - Event pipelines
+ */
+export function usePersistentCallback(fn) {
+  /**
+   * Holds the latest implementation.
+   * Updating this does NOT trigger re-renders.
+   */
+  const fnRef = useRef(fn);
+  fnRef.current = fn;
+
+  /**
+   * Stable wrapper that forwards calls
+   * to the latest implementation.
+   */
+  return useCallback((...args) => fnRef.current(...args), []);
+}
+//# sourceMappingURL=usePersistentCallback.js.map

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

@@ -0,0 +1 @@
+{"version":3,"names":["useRef","useCallback","usePersistentCallback","fn","fnRef","current","args"],"sourceRoot":"../../../src","sources":["hooks/usePersistentCallback.ts"],"mappings":";;AAAA,SAASA,MAAM,EAAEC,WAAW,QAAQ,OAAO;;AAE3C;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,qBAAqBA,CAEnCC,EAAK,EAAK;EAEV;AACF;AACA;AACA;EACE,MAAMC,KAAK,GAAGJ,MAAM,CAACG,EAAE,CAAC;EACxBC,KAAK,CAACC,OAAO,GAAGF,EAAE;;EAElB;AACF;AACA;AACA;EACE,OAAOF,WAAW,CACf,CAAC,GAAGK,IAAa,KAChBF,KAAK,CAACC,OAAO,CAAC,GAAGC,IAAI,CAAC,EACxB,EACF,CAAC;AACH","ignoreList":[]}

package/lib/module/index.js

@@ -1,6 +1,4 @@
 "use strict";
 
-import { getHostComponent } from 'react-native-nitro-modules';
-import NitroListConfig from '../nitrogen/generated/shared/json/NitroListConfig.json';
-export const NitroList = getHostComponent('NitroList', () => NitroListConfig);
+export { RecyclerList } from './recycler/RecyclerList';
 //# sourceMappingURL=index.js.map

package/lib/module/index.js.map

@@ -1 +1 @@
-{"version":3,"names":["getHostComponent","NitroListConfig","NitroList"],"sourceRoot":"../../src","sources":["index.ts"],"mappings":";;AAAA,SAASA,gBAAgB,QAAwB,4BAA4B;AAC7E,OAAOC,eAAe,MAAM,wDAAwD;AAOpF,OAAO,MAAMC,SAAS,GAAGF,gBAAgB,CACvC,WAAW,EACX,MAAMC,eACR,CAAC","ignoreList":[]}
+{"version":3,"names":["RecyclerList"],"sourceRoot":"../../src","sources":["index.ts"],"mappings":";;AAAA,SAASA,YAAY,QAAQ,yBAAyB","ignoreList":[]}

package/lib/module/layout/MutableLinearLayout.js

@@ -0,0 +1,100 @@
+"use strict";
+
+import { DEFAULT_ITEM_SPACING } from './constants/layoutDefaults';
+
+/**
+ * Mutable, deterministic linear layout engine.
+ *
+ * Responsibilities:
+ * - Compute absolute item geometry
+ * - Own layout truth (no React, no scroll state)
+ * - Guarantee monotonic ordering along the main axis
+ *
+ * Cross-platform equivalents:
+ * - Flutter: RenderSliver / SliverList
+ * - Android: LinearLayoutManager
+ * - iOS: UICollectionViewFlowLayout (linear)
+ */
+export class MutableLinearLayout {
+  /** Absolute item layouts in index order */
+  layouts = [];
+
+  /** Total scrollable size along main axis */
+  contentSize = 0;
+  constructor(axis) {
+    this.isVertical = axis === 'vertical';
+  }
+
+  /**
+   * Computes layout synchronously from input.
+   *
+   * This method is intentionally parameter-object based
+   * to allow future extension without breaking API.
+   *
+   * Invariants:
+   * - Layouts are monotonic along main axis
+   * - No gaps except explicit spacing
+   * - Deterministic for identical inputs
+   */
+  compute(input) {
+    const {
+      crossAxisSize,
+      itemMainAxisSizes,
+      padding,
+      itemSpacing = DEFAULT_ITEM_SPACING
+    } = input;
+    const itemCount = itemMainAxisSizes.length;
+    const layouts = new Array(itemCount);
+    let cursor = padding.start;
+    for (let i = 0; i < itemCount; i++) {
+      const mainAxisSize = itemMainAxisSizes[i];
+      layouts[i] = this.isVertical ? {
+        x: 0,
+        y: cursor,
+        width: crossAxisSize,
+        height: mainAxisSize
+      } : {
+        x: cursor,
+        y: 0,
+        width: mainAxisSize,
+        height: crossAxisSize
+      };
+      cursor += mainAxisSize;
+
+      // Space BETWEEN items, not after the last
+      if (i < itemCount - 1) {
+        cursor += itemSpacing;
+      }
+    }
+    this.layouts = layouts;
+    this.contentSize = cursor + padding.end;
+  }
+
+  /**
+   * Returns computed item layouts.
+   *
+   * Order is guaranteed monotonic along the main axis,
+   * which is required for binary-search-based windowing.
+   */
+  getLayouts() {
+    return this.layouts;
+  }
+
+  /**
+   * Returns total scrollable size along the main axis,
+   * including padding and inter-item spacing.
+   */
+  getContentSize() {
+    return this.contentSize;
+  }
+
+  /**
+   * Clears internal layout state.
+   * Call on severe invalidation or teardown.
+   */
+  reset() {
+    this.layouts = [];
+    this.contentSize = 0;
+  }
+}
+//# sourceMappingURL=MutableLinearLayout.js.map

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

@@ -0,0 +1 @@
+{"version":3,"names":["DEFAULT_ITEM_SPACING","MutableLinearLayout","layouts","contentSize","constructor","axis","isVertical","compute","input","crossAxisSize","itemMainAxisSizes","padding","itemSpacing","itemCount","length","Array","cursor","start","i","mainAxisSize","x","y","width","height","end","getLayouts","getContentSize","reset"],"sourceRoot":"../../../src","sources":["layout/MutableLinearLayout.ts"],"mappings":";;AAIA,SAASA,oBAAoB,QAAQ,4BAA4B;;AAEjE;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMC,mBAAmB,CAAC;EAG/B;EACQC,OAAO,GAAiB,EAAE;;EAElC;EACQC,WAAW,GAAG,CAAC;EAEvBC,WAAWA,CAACC,IAAU,EAAE;IACtB,IAAI,CAACC,UAAU,GAAGD,IAAI,KAAK,UAAU;EACvC;;EAEA;AACF;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;EACEE,OAAOA,CAACC,KAAwB,EAAQ;IACtC,MAAM;MACJC,aAAa;MACbC,iBAAiB;MACjBC,OAAO;MACPC,WAAW,GAAGZ;IAChB,CAAC,GAAGQ,KAAK;IAET,MAAMK,SAAS,GAAGH,iBAAiB,CAACI,MAAM;IAC1C,MAAMZ,OAAqB,GAAG,IAAIa,KAAK,CAACF,SAAS,CAAC;IAElD,IAAIG,MAAM,GAAGL,OAAO,CAACM,KAAK;IAE1B,KAAK,IAAIC,CAAC,GAAG,CAAC,EAAEA,CAAC,GAAGL,SAAS,EAAEK,CAAC,EAAE,EAAE;MAClC,MAAMC,YAAY,GAAGT,iBAAiB,CAACQ,CAAC,CAAE;MAE1ChB,OAAO,CAACgB,CAAC,CAAC,GAAG,IAAI,CAACZ,UAAU,GACxB;QACEc,CAAC,EAAE,CAAC;QACJC,CAAC,EAAEL,MAAM;QACTM,KAAK,EAAEb,aAAa;QACpBc,MAAM,EAAEJ;MACV,CAAC,GACD;QACEC,CAAC,EAAEJ,MAAM;QACTK,CAAC,EAAE,CAAC;QACJC,KAAK,EAAEH,YAAY;QACnBI,MAAM,EAAEd;MACV,CAAC;MAELO,MAAM,IAAIG,YAAY;;MAEtB;MACA,IAAID,CAAC,GAAGL,SAAS,GAAG,CAAC,EAAE;QACrBG,MAAM,IAAIJ,WAAW;MACvB;IACF;IAEA,IAAI,CAACV,OAAO,GAAGA,OAAO;IACtB,IAAI,CAACC,WAAW,GAAGa,MAAM,GAAGL,OAAO,CAACa,GAAG;EACzC;;EAEA;AACF;AACA;AACA;AACA;AACA;EACEC,UAAUA,CAAA,EAA0B;IAClC,OAAO,IAAI,CAACvB,OAAO;EACrB;;EAEA;AACF;AACA;AACA;EACEwB,cAAcA,CAAA,EAAW;IACvB,OAAO,IAAI,CAACvB,WAAW;EACzB;;EAEA;AACF;AACA;AACA;EACEwB,KAAKA,CAAA,EAAS;IACZ,IAAI,CAACzB,OAAO,GAAG,EAAE;IACjB,IAAI,CAACC,WAAW,GAAG,CAAC;EACtB;AACF","ignoreList":[]}

package/lib/module/layout/constants/layoutDefaults.js

@@ -0,0 +1,15 @@
+"use strict";
+
+/**
+ * Default spacing between items along the main axis.
+ *
+ * This value is used by layout engines when no explicit
+ * itemSpacing is provided.
+ *
+ * Mirrors:
+ * - Android RecyclerView ItemDecoration (typical 8–16dp)
+ * - iOS UICollectionViewFlowLayout minimumLineSpacing
+ * - Flutter SliverList spacing conventions
+ */
+export const DEFAULT_ITEM_SPACING = 12;
+//# sourceMappingURL=layoutDefaults.js.map

package/lib/module/layout/constants/layoutDefaults.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["DEFAULT_ITEM_SPACING"],"sourceRoot":"../../../../src","sources":["layout/constants/layoutDefaults.ts"],"mappings":";;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMA,oBAAoB,GAAG,EAAE","ignoreList":[]}

package/lib/module/layout/index.js

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

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

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

package/lib/module/measurement/MeasureLayout.js

@@ -0,0 +1,16 @@
+"use strict";
+
+/**
+ * Extracts stable layout measurements from RN onLayout event.
+ */
+export function measureLayout(event) {
+  const {
+    width,
+    height
+  } = event.nativeEvent.layout;
+  return {
+    width,
+    height
+  };
+}
+//# sourceMappingURL=MeasureLayout.js.map

package/lib/module/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;AACA,OAAO,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/module/measurement/useItemMeasurement.js

@@ -0,0 +1,24 @@
+"use strict";
+
+import { useCallback, useRef } from 'react';
+/**
+ * Hook to measure a rendered item safely.
+ *
+ * Guarantees:
+ * - No duplicate height reports
+ * - No render loops
+ * - Stable callback identity
+ */
+export function useItemMeasurement(index, onMeasured) {
+  const lastHeightRef = useRef(null);
+  const onLayout = 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/module/measurement/useItemMeasurement.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["useCallback","useRef","useItemMeasurement","index","onMeasured","lastHeightRef","onLayout","e","height","nativeEvent","layout","current"],"sourceRoot":"../../../src","sources":["measurement/useItemMeasurement.ts"],"mappings":";;AAAA,SAASA,WAAW,EAAEC,MAAM,QAAQ,OAAO;AAG3C;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,kBAAkBA,CAChCC,KAAa,EACbC,UAAmD,EACnD;EACA,MAAMC,aAAa,GAAGJ,MAAM,CAAgB,IAAI,CAAC;EAEjD,MAAMK,QAAQ,GAAGN,WAAW,CACzBO,CAAoB,IAAK;IACxB,MAAMC,MAAM,GAAGD,CAAC,CAACE,WAAW,CAACC,MAAM,CAACF,MAAM;;IAE1C;IACA,IAAIH,aAAa,CAACM,OAAO,KAAKH,MAAM,EAAE;IAEtCH,aAAa,CAACM,OAAO,GAAGH,MAAM;IAC9BJ,UAAU,CAACD,KAAK,EAAEK,MAAM,CAAC;EAC3B,CAAC,EACD,CAACL,KAAK,EAAEC,UAAU,CACpB,CAAC;EAED,OAAOE,QAAQ;AACjB","ignoreList":[]}

package/lib/module/native/NitroLayoutEngine.js

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

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

@@ -0,0 +1 @@
+{"version":3,"names":["NitroModules","NitroLayoutEngine","createHybridObject"],"sourceRoot":"../../../src","sources":["native/NitroLayoutEngine.ts"],"mappings":";;AAAA,SAASA,YAAY,QAAQ,4BAA4B;AAGzD,OAAO,MAAMC,iBAAiB,GAC5BD,YAAY,CAACE,kBAAkB,CAC7B,mBACF,CAAC","ignoreList":[]}

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

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

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

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

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":[]}