react-native-nitro-list 0.1.1 → 0.1.3

package/lib/commonjs/windowing/index.js

@@ -3,10 +3,10 @@
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-Object.defineProperty(exports, "findVisibleIndexRange", {
+Object.defineProperty(exports, "computeVisibleItemRange", {
   enumerable: true,
   get: function () {
-    return _findVisibleIndexRange.findVisibleIndexRange;
+    return _computeVisibleItemRange.computeVisibleItemRange;
   }
 });
 Object.defineProperty(exports, "useScrollMetrics", {
@@ -15,6 +15,6 @@ Object.defineProperty(exports, "useScrollMetrics", {
     return _useScrollMetrics.useScrollMetrics;
   }
 });
-var _findVisibleIndexRange = require("./findVisibleIndexRange");
 var _useScrollMetrics = require("./useScrollMetrics");
+var _computeVisibleItemRange = require("./computeVisibleItemRange");
 //# sourceMappingURL=index.js.map

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

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

@@ -1,57 +1,66 @@
 "use strict";
 
-const MAX_CELLS = 40;
+import { createCell } from './createCell';
 
 /**
- * Owns physical cell reuse.
- * Stateful, imperative, React-agnostic.
- *
- * FlashList equivalent: CellRecycler
+ * Manages physical cell reuse.
+ * Imperative and stateful by design.
+ * This is NOT React code.
  */
 export class CellRecycler {
-  activeCells = new Map();
-  reusableCellsByType = new Map();
-  orderedCells = [];
-  nextCellId = 0;
+  /**
+   * Active cells mapped by logical index.
+   */
+  indexToCell = new Map();
+
+  /**
+   * Pool of detached reusable cells.
+   */
+  recycledCells = [];
 
   /**
-   * Reconcile visible indices against existing cells.
-   * Returns a stable ordered snapshot.
+   * Reconcile a contiguous visible index range
+   * into a stable list of physical cells.
+   *
+   * HOT PATH:
+   * - No index arrays
+   * - Minimal allocations
+   * - Deterministic
    */
-  reconcile(visibleIndices, getCellType) {
-    const visibleSet = new Set(visibleIndices);
+  reconcileRange(startIndex, endIndex, resolveCellType) {
+    const nextActive = [];
 
-    // 1️⃣ Release cells no longer visible
-    for (const [index, cell] of this.activeCells) {
-      if (visibleSet.has(index)) continue;
-      this.activeCells.delete(index);
-      const orderedIndex = this.orderedCells.indexOf(cell);
-      if (orderedIndex !== -1) {
-        this.orderedCells.splice(orderedIndex, 1);
+    // 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 pool = this.reusableCellsByType.get(cell.type) ?? [];
-      if (pool.length < MAX_CELLS) pool.push(cell);
-      this.reusableCellsByType.set(cell.type, pool);
-    }
+      const type = resolveCellType(index);
 
-    // 2️⃣ Acquire cells for newly visible indices
-    for (const index of visibleIndices) {
-      if (this.activeCells.has(index)) continue;
-      const type = getCellType(index);
-      const pool = this.reusableCellsByType.get(type);
-      let cell = pool?.pop();
-      if (!cell) {
-        cell = {
-          key: `cell-${this.nextCellId++}`,
-          type,
-          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.activeCells.set(index, cell);
-      this.orderedCells.push(cell);
+      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 this.orderedCells;
+    return nextActive;
   }
 }
 //# sourceMappingURL=CellRecycler.js.map

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

@@ -1 +1 @@
-{"version":3,"names":["MAX_CELLS","CellRecycler","activeCells","Map","reusableCellsByType","orderedCells","nextCellId","reconcile","visibleIndices","getCellType","visibleSet","Set","index","cell","has","delete","orderedIndex","indexOf","splice","pool","get","type","length","push","set","pop","key"],"sourceRoot":"../../../src","sources":["cell/CellRecycler.ts"],"mappings":";;AAEA,MAAMA,SAAS,GAAG,EAAE;;AAEpB;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMC,YAAY,CAAC;EACPC,WAAW,GAAG,IAAIC,GAAG,CAAe,CAAC;EACrCC,mBAAmB,GAAG,IAAID,GAAG,CAAiB,CAAC;EAC/CE,YAAY,GAAW,EAAE;EAClCC,UAAU,GAAG,CAAC;;EAEtB;AACF;AACA;AACA;EACEC,SAASA,CACPC,cAAiC,EACjCC,WAAsC,EACrB;IACjB,MAAMC,UAAU,GAAG,IAAIC,GAAG,CAACH,cAAc,CAAC;;IAE1C;IACA,KAAK,MAAM,CAACI,KAAK,EAAEC,IAAI,CAAC,IAAI,IAAI,CAACX,WAAW,EAAE;MAC5C,IAAIQ,UAAU,CAACI,GAAG,CAACF,KAAK,CAAC,EAAE;MAE3B,IAAI,CAACV,WAAW,CAACa,MAAM,CAACH,KAAK,CAAC;MAE9B,MAAMI,YAAY,GAAG,IAAI,CAACX,YAAY,CAACY,OAAO,CAACJ,IAAI,CAAC;MACpD,IAAIG,YAAY,KAAK,CAAC,CAAC,EAAE;QACvB,IAAI,CAACX,YAAY,CAACa,MAAM,CAACF,YAAY,EAAE,CAAC,CAAC;MAC3C;MAEA,MAAMG,IAAI,GAAG,IAAI,CAACf,mBAAmB,CAACgB,GAAG,CAACP,IAAI,CAACQ,IAAI,CAAC,IAAI,EAAE;MAC1D,IAAIF,IAAI,CAACG,MAAM,GAAGtB,SAAS,EAAEmB,IAAI,CAACI,IAAI,CAACV,IAAI,CAAC;MAC5C,IAAI,CAACT,mBAAmB,CAACoB,GAAG,CAACX,IAAI,CAACQ,IAAI,EAAEF,IAAI,CAAC;IAC/C;;IAEA;IACA,KAAK,MAAMP,KAAK,IAAIJ,cAAc,EAAE;MAClC,IAAI,IAAI,CAACN,WAAW,CAACY,GAAG,CAACF,KAAK,CAAC,EAAE;MAEjC,MAAMS,IAAI,GAAGZ,WAAW,CAACG,KAAK,CAAC;MAC/B,MAAMO,IAAI,GAAG,IAAI,CAACf,mBAAmB,CAACgB,GAAG,CAACC,IAAI,CAAC;MAC/C,IAAIR,IAAI,GAAGM,IAAI,EAAEM,GAAG,CAAC,CAAC;MAEtB,IAAI,CAACZ,IAAI,EAAE;QACTA,IAAI,GAAG;UACLa,GAAG,EAAE,QAAQ,IAAI,CAACpB,UAAU,EAAE,EAAE;UAChCe,IAAI;UACJT;QACF,CAAC;MACH;MAEAC,IAAI,CAACD,KAAK,GAAGA,KAAK;MAClB,IAAI,CAACV,WAAW,CAACsB,GAAG,CAACZ,KAAK,EAAEC,IAAI,CAAC;MACjC,IAAI,CAACR,YAAY,CAACkB,IAAI,CAACV,IAAI,CAAC;IAC9B;IAEA,OAAO,IAAI,CAACR,YAAY;EAC1B;AACF","ignoreList":[]}
+{"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/getVisibleIndices.js.map

@@ -1 +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":";;AAGA;AACA;AACA;AACA;AACA,OAAO,SAASA,eAAeA,CAC7BC,OAAmC,EACnCC,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":[]}
+{"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,4 +1,8 @@
 "use strict";
 
-export { RecyclerList } from './RecyclerList';
+// Export the Native View
+export * from './native/NitroListView';
+// Export the JSI Specs
+export * from './specs/NitroList.nitro';
+export { default as NitroList } from './recycler/NitroList';
 //# sourceMappingURL=index.js.map

package/lib/module/index.js.map

@@ -1 +1 @@
-{"version":3,"names":["RecyclerList"],"sourceRoot":"../../src","sources":["index.ts"],"mappings":";;AAAA,SAASA,YAAY,QAAQ,gBAAgB","ignoreList":[]}
+{"version":3,"names":["default","NitroList"],"sourceRoot":"../../src","sources":["index.ts"],"mappings":";;AACA;AACA,cAAc,wBAAwB;AACtC;AACA,cAAc,yBAAyB;AAEvC,SAASA,OAAO,IAAIC,SAAS,QAAQ,sBAAsB","ignoreList":[]}

package/lib/module/layout/MutableLinearLayout.js

@@ -1,60 +1,100 @@
 "use strict";
 
-/**
- * INTERNAL mutable layout record.
- * This is intentionally mutable and never exposed publicly.
- */
+import { DEFAULT_ITEM_SPACING } from './constants/layoutDefaults';
 
 /**
- * Mutable linear layout store.
- * FlashList-style incremental relayout.
+ * 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 {
-  constructor(initialHeights, width) {
-    this.layouts = [];
-    let y = 0;
-    for (const height of initialHeights) {
-      this.layouts.push({
+  /** 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,
-        width,
-        height
-      });
-      y += height;
+        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.totalHeight = y;
+    this.layouts = layouts;
+    this.contentSize = cursor + padding.end;
   }
 
   /**
-   * Read-only snapshot for consumers.
-   * Returned type is immutable.
+   * Returns computed item layouts.
+   *
+   * Order is guaranteed monotonic along the main axis,
+   * which is required for binary-search-based windowing.
    */
   getLayouts() {
     return this.layouts;
   }
-  getContentHeight() {
-    return this.totalHeight;
+
+  /**
+   * Returns total scrollable size along the main axis,
+   * including padding and inter-item spacing.
+   */
+  getContentSize() {
+    return this.contentSize;
   }
 
   /**
-   * Update height of one item and shift following items.
-   * Returns true if layout changed.
+   * Clears internal layout state.
+   * Call on severe invalidation or teardown.
    */
-  updateItemHeight(index, newHeight) {
-    const layout = this.layouts[index];
-    if (!layout) return false;
-    const delta = newHeight - layout.height;
-    if (delta === 0) return false;
-
-    // Update this item
-    layout.height = newHeight;
-
-    // Shift all items after this index
-    for (let i = index + 1; i < this.layouts.length; i++) {
-      this.layouts[i].y += delta;
-    }
-    this.totalHeight += delta;
-    return true;
+  reset() {
+    this.layouts = [];
+    this.contentSize = 0;
   }
 }
 //# sourceMappingURL=MutableLinearLayout.js.map

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

@@ -1 +1 @@
-{"version":3,"names":["MutableLinearLayout","constructor","initialHeights","width","layouts","y","height","push","x","totalHeight","getLayouts","getContentHeight","updateItemHeight","index","newHeight","layout","delta","i","length"],"sourceRoot":"../../../src","sources":["layout/MutableLinearLayout.ts"],"mappings":";;AAEA;AACA;AACA;AACA;;AAQA;AACA;AACA;AACA;AACA,OAAO,MAAMA,mBAAmB,CAAC;EAI/BC,WAAWA,CACTC,cAAiC,EACjCC,KAAa,EACb;IACA,IAAI,CAACC,OAAO,GAAG,EAAE;IACjB,IAAIC,CAAC,GAAG,CAAC;IAET,KAAK,MAAMC,MAAM,IAAIJ,cAAc,EAAE;MACnC,IAAI,CAACE,OAAO,CAACG,IAAI,CAAC;QAChBC,CAAC,EAAE,CAAC;QACJH,CAAC;QACDF,KAAK;QACLG;MACF,CAAC,CAAC;MACFD,CAAC,IAAIC,MAAM;IACb;IAEA,IAAI,CAACG,WAAW,GAAGJ,CAAC;EACtB;;EAEA;AACF;AACA;AACA;EACEK,UAAUA,CAAA,EAA+B;IACvC,OAAO,IAAI,CAACN,OAAO;EACrB;EAEAO,gBAAgBA,CAAA,EAAW;IACzB,OAAO,IAAI,CAACF,WAAW;EACzB;;EAEA;AACF;AACA;AACA;EACEG,gBAAgBA,CACdC,KAAa,EACbC,SAAiB,EACR;IACT,MAAMC,MAAM,GAAG,IAAI,CAACX,OAAO,CAACS,KAAK,CAAC;IAClC,IAAI,CAACE,MAAM,EAAE,OAAO,KAAK;IAEzB,MAAMC,KAAK,GAAGF,SAAS,GAAGC,MAAM,CAACT,MAAM;IACvC,IAAIU,KAAK,KAAK,CAAC,EAAE,OAAO,KAAK;;IAE7B;IACAD,MAAM,CAACT,MAAM,GAAGQ,SAAS;;IAEzB;IACA,KAAK,IAAIG,CAAC,GAAGJ,KAAK,GAAG,CAAC,EAAEI,CAAC,GAAG,IAAI,CAACb,OAAO,CAACc,MAAM,EAAED,CAAC,EAAE,EAAE;MACpD,IAAI,CAACb,OAAO,CAACa,CAAC,CAAC,CAAEZ,CAAC,IAAIW,KAAK;IAC7B;IAEA,IAAI,CAACP,WAAW,IAAIO,KAAK;IACzB,OAAO,IAAI;EACb;AACF","ignoreList":[]}
+{"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":";;AAGA,SAASA,oBAAoB,QAAQ,4BAA4B;;AAGjE;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

@@ -1,5 +1,2 @@
 "use strict";
-
-export { EstimatedLayoutProvider } from './EstimatedLayoutProvider';
-export { computeLayouts } from './LayoutEngine';
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"names":["EstimatedLayoutProvider","computeLayouts"],"sourceRoot":"../../../src","sources":["layout/index.ts"],"mappings":";;AAEA,SAASA,uBAAuB,QAAQ,2BAA2B;AACnE,SAASC,cAAc,QAAQ,gBAAgB","ignoreList":[]}
+{"version":3,"names":[],"sourceRoot":"../../../src","sources":["layout/index.ts"],"mappings":"","ignoreList":[]}

package/lib/module/native/NitroListView.js

@@ -0,0 +1,17 @@
+"use strict";
+
+import { requireNativeComponent } from 'react-native';
+
+/**
+ * Props for the NitroListView.
+ * * We extend ViewProps so that developers can use standard styles 
+ * like 'flex: 1' or 'backgroundColor' on the list.
+ */
+
+/**
+ * The Native Component that maps to the physical view in Swift/Kotlin.
+ * * 'NitroListView' is the "Secret Handshake" name. It must match 
+ * the name exported by your Native ViewManagers.
+ */
+export const NitroListView = requireNativeComponent('NitroListView');
+//# sourceMappingURL=NitroListView.js.map

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

@@ -0,0 +1 @@
+{"version":3,"names":["requireNativeComponent","NitroListView"],"sourceRoot":"../../../src","sources":["native/NitroListView.ts"],"mappings":";;AAAA,SAASA,sBAAsB,QAAwB,cAAc;;AAErE;AACA;AACA;AACA;AACA;;AASA;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMC,aAAa,GACxBD,sBAAsB,CAAqB,eAAe,CAAC","ignoreList":[]}

package/lib/module/recycler/CellPool.js

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

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

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