react-native-nitro-list 0.1.1 → 0.1.2

package/lib/module/recycler/RecyclerList.js

@@ -0,0 +1,221 @@
+"use strict";
+
+import React, { useRef, useEffect, useState } from 'react';
+import { ScrollView, View, StyleSheet } from 'react-native';
+import { MutableLinearLayout } from '../layout/MutableLinearLayout';
+import { computeVisibleItemRange } from '../windowing';
+import { CellPool } from './CellPool';
+
+/* =========================================================
+ * Constants
+ * =======================================================*/
+import { jsx as _jsx } from "react/jsx-runtime";
+const DEFAULT_VIEWPORT_SIZE = 800;
+const DEFAULT_ITEM_SIZE = 60;
+const SCROLL_EVENT_THROTTLE = 16;
+
+/* =========================================================
+ * RecyclerList
+ * =======================================================*/
+
+export function RecyclerList(props) {
+  const {
+    scrollDirection = 'vertical',
+    containerCrossAxisSize,
+    data,
+    itemMainAxisSizes,
+    padding = {
+      start: 0,
+      end: 0
+    },
+    itemSpacing,
+    bufferRatio = 1.3,
+    getCellType,
+    renderItem
+  } = props;
+  const isVertical = scrollDirection === 'vertical';
+  const itemCount = data.length;
+
+  /* -------------------------------------------------------
+   * Controlled render
+   * -----------------------------------------------------*/
+
+  const [, forceRender] = useState(0);
+
+  /* -------------------------------------------------------
+   * Layout engine
+   * -----------------------------------------------------*/
+
+  const layoutEngineRef = useRef(null);
+  const layoutSignatureRef = useRef('');
+  const layoutSignature = [scrollDirection, containerCrossAxisSize, itemCount, itemMainAxisSizes, padding.start, padding.end, itemSpacing ?? 'default'].join('|');
+  if (!layoutEngineRef.current || layoutSignatureRef.current !== layoutSignature) {
+    const engine = new MutableLinearLayout(scrollDirection);
+    engine.compute({
+      crossAxisSize: containerCrossAxisSize,
+      itemMainAxisSizes,
+      padding,
+      itemSpacing
+    });
+    layoutEngineRef.current = engine;
+    layoutSignatureRef.current = layoutSignature;
+  }
+  const layouts = layoutEngineRef.current.getLayouts();
+  const contentSize = layoutEngineRef.current.getContentSize();
+
+  /* -------------------------------------------------------
+   * Scroll metrics
+   * -----------------------------------------------------*/
+
+  const scrollOffsetRef = useRef(0);
+  const viewportSizeRef = useRef(DEFAULT_VIEWPORT_SIZE);
+
+  /* -------------------------------------------------------
+   * Cell pool + physical cells
+   * -----------------------------------------------------*/
+
+  const cellPoolRef = useRef(new CellPool());
+  const activeCellsRef = useRef([]);
+  const nextCellKeyRef = useRef(0);
+  const createCell = type => ({
+    key: nextCellKeyRef.current++,
+    index: -1,
+    type
+  });
+  const MAX_CELLS = Math.ceil(viewportSizeRef.current / DEFAULT_ITEM_SIZE * bufferRatio) + 2;
+
+  /* -------------------------------------------------------
+   * Visible cell coordinator
+   * -----------------------------------------------------*/
+
+  const updateVisibleCells = () => {
+    const offset = scrollOffsetRef.current;
+    const viewportSize = viewportSizeRef.current;
+    const buffer = viewportSize * bufferRatio;
+    const range = computeVisibleItemRange({
+      layouts,
+      offset,
+      viewportSize,
+      buffer,
+      isVertical
+    });
+    if (!range) return;
+    const nextCells = [];
+    const used = new Set();
+    for (let index = range.startIndex; index <= range.endIndex; index++) {
+      const item = data[index];
+      if (item === undefined) continue;
+      const type = getCellType(item, index);
+
+      // Register type once, with hard cap
+      if (!cellPoolRef.current.hasType(type)) {
+        cellPoolRef.current.registerType(type, MAX_CELLS);
+        for (let i = 0; i < MAX_CELLS; i++) {
+          cellPoolRef.current.release(createCell(type));
+        }
+      }
+      let cell = cellPoolRef.current.acquire(type);
+      if (!cell) {
+        const reuseIndex = activeCellsRef.current.findIndex(c => c.type === type);
+        if (reuseIndex === -1) continue;
+        cell = activeCellsRef.current.splice(reuseIndex, 1)[0];
+      }
+      cell.index = index;
+      nextCells.push(cell);
+      used.add(cell);
+    }
+    for (const cell of activeCellsRef.current) {
+      if (!used.has(cell)) {
+        cellPoolRef.current.release(cell);
+      }
+    }
+    let changed = nextCells.length !== activeCellsRef.current.length;
+    if (!changed) {
+      for (let i = 0; i < nextCells.length; i++) {
+        if (nextCells[i] !== activeCellsRef.current[i]) {
+          changed = true;
+          break;
+        }
+      }
+    }
+    if (changed) {
+      activeCellsRef.current = nextCells;
+      forceRender(v => v + 1);
+    }
+  };
+
+  /* -------------------------------------------------------
+   * Scroll handlers
+   * -----------------------------------------------------*/
+
+  const frameScheduledRef = useRef(false);
+  const onScroll = e => {
+    scrollOffsetRef.current = isVertical ? e.nativeEvent.contentOffset.y : e.nativeEvent.contentOffset.x;
+    if (frameScheduledRef.current) return;
+    frameScheduledRef.current = true;
+    requestAnimationFrame(() => {
+      frameScheduledRef.current = false;
+      updateVisibleCells();
+    });
+  };
+  const onLayout = e => {
+    viewportSizeRef.current = isVertical ? e.nativeEvent.layout.height : e.nativeEvent.layout.width;
+    updateVisibleCells();
+  };
+  useEffect(() => {
+    updateVisibleCells();
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+  }, []);
+
+  /* -------------------------------------------------------
+   * Render
+   * -----------------------------------------------------*/
+
+  return /*#__PURE__*/_jsx(ScrollView, {
+    onScroll: onScroll,
+    onLayout: onLayout,
+    horizontal: !isVertical,
+    scrollEventThrottle: SCROLL_EVENT_THROTTLE,
+    removeClippedSubviews: true,
+    children: /*#__PURE__*/_jsx(View, {
+      style: isVertical ? {
+        height: contentSize
+      } : {
+        width: contentSize
+      },
+      children: activeCellsRef.current.map(cell => {
+        const index = cell.index;
+        const layout = layouts[index];
+        const item = data[index];
+        if (!layout || item === undefined) return null;
+        return /*#__PURE__*/_jsx(View, {
+          style: [styles.cell, isVertical ? {
+            top: layout.y,
+            height: layout.height,
+            width: layout.width
+          } : {
+            left: layout.x,
+            width: layout.width,
+            height: layout.height
+          }],
+          children: renderItem({
+            item,
+            index,
+            cell
+          })
+        }, cell.key);
+      })
+    })
+  });
+}
+
+/* =========================================================
+ * Styles
+ * =======================================================*/
+
+const styles = StyleSheet.create({
+  cell: {
+    position: 'absolute'
+  }
+});
+//# sourceMappingURL=RecyclerList.js.map

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

@@ -0,0 +1 @@
+{"version":3,"names":["React","useRef","useEffect","useState","ScrollView","View","StyleSheet","MutableLinearLayout","computeVisibleItemRange","CellPool","jsx","_jsx","DEFAULT_VIEWPORT_SIZE","DEFAULT_ITEM_SIZE","SCROLL_EVENT_THROTTLE","RecyclerList","props","scrollDirection","containerCrossAxisSize","data","itemMainAxisSizes","padding","start","end","itemSpacing","bufferRatio","getCellType","renderItem","isVertical","itemCount","length","forceRender","layoutEngineRef","layoutSignatureRef","layoutSignature","join","current","engine","compute","crossAxisSize","layouts","getLayouts","contentSize","getContentSize","scrollOffsetRef","viewportSizeRef","cellPoolRef","activeCellsRef","nextCellKeyRef","createCell","type","key","index","MAX_CELLS","Math","ceil","updateVisibleCells","offset","viewportSize","buffer","range","nextCells","used","Set","startIndex","endIndex","item","undefined","hasType","registerType","i","release","cell","acquire","reuseIndex","findIndex","c","splice","push","add","has","changed","v","frameScheduledRef","onScroll","e","nativeEvent","contentOffset","y","x","requestAnimationFrame","onLayout","layout","height","width","horizontal","scrollEventThrottle","removeClippedSubviews","children","style","map","styles","top","left","create","position"],"sourceRoot":"../../../src","sources":["recycler/RecyclerList.tsx"],"mappings":"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","ignoreList":[]}

package/lib/module/types/Axis.js

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

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

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

package/lib/module/types/CellKey.js

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

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

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

package/lib/module/types/CellType.js

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

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

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

package/lib/module/types/VisibleRange.js

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

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

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

package/lib/module/types/VisibleRangeInput.js

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

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

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

package/lib/module/types/index.js

@@ -0,0 +1,4 @@
+"use strict";
+
+export { ZERO_MAIN_AXIS_PADDING } from './layout/MainAxisPadding';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"names":["ZERO_MAIN_AXIS_PADDING"],"sourceRoot":"../../../src","sources":["types/index.ts"],"mappings":";;AAKA,SACEA,sBAAsB,QACjB,0BAA0B","ignoreList":[]}

package/lib/module/types/layout/LayoutRect.js

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

package/lib/module/types/layout/LayoutRect.js.map

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

package/lib/module/types/layout/LinearLayoutInput.js

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

package/lib/module/types/layout/LinearLayoutInput.js.map

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

package/lib/module/types/layout/MainAxisPadding.js

@@ -0,0 +1,22 @@
+"use strict";
+
+/**
+ * Padding applied along the main scroll axis.
+ *
+ * This is a layout-level concept (not visual styling).
+ *
+ * - vertical   → top / bottom
+ * - horizontal → left / right
+ *
+ * Uses start/end to remain RTL-safe and platform-neutral.
+ */
+
+/**
+ * Shared zero-padding constant.
+ * Safe to reuse across layouts.
+ */
+export const ZERO_MAIN_AXIS_PADDING = {
+  start: 0,
+  end: 0
+};
+//# sourceMappingURL=MainAxisPadding.js.map

package/lib/module/types/layout/MainAxisPadding.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["ZERO_MAIN_AXIS_PADDING","start","end"],"sourceRoot":"../../../../src","sources":["types/layout/MainAxisPadding.ts"],"mappings":";;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAMA;AACA;AACA;AACA;AACA,OAAO,MAAMA,sBAAuC,GAAG;EACrDC,KAAK,EAAE,CAAC;EACRC,GAAG,EAAE;AACP,CAAC","ignoreList":[]}

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

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

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

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

package/lib/module/types/recycler/RecyclerCellInstance.js

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

package/lib/module/types/recycler/RecyclerCellInstance.js.map

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

package/lib/module/types/recycler/RecyclerItemRenderer.js

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

package/lib/module/types/recycler/RecyclerItemRenderer.js.map

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

package/lib/module/types/recycler/RecyclerListProps.js

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

package/lib/module/types/recycler/RecyclerListProps.js.map

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

package/lib/module/types/recycler/index.js

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

package/lib/module/types/recycler/index.js.map

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

package/lib/module/types/scroll/ScrollMetrics.js

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

package/lib/module/types/scroll/ScrollMetrics.js.map

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

package/lib/module/types/scroll/index.js

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

package/lib/module/types/scroll/index.js.map

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

package/lib/module/windowing/computeVisibleItemRange.js

@@ -0,0 +1,67 @@
+"use strict";
+
+/**
+ * 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)
+ */
+export 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/module/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;AACA,OAAO,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/module/windowing/index.js

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

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

@@ -1 +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":[]}
+{"version":3,"names":["useScrollMetrics","computeVisibleItemRange"],"sourceRoot":"../../../src","sources":["windowing/index.ts"],"mappings":";;AACA,SAASA,gBAAgB,QAAQ,oBAAoB;AACrD,SAASC,uBAAuB,QAAQ,2BAA2B","ignoreList":[]}

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

@@ -1,13 +1,22 @@
 /**
  * Physical reusable cell.
- * Mirrors FlashList's Cell abstraction.
+ * Represents a single mounted view instance.
  */
 export interface Cell {
-    /** Stable physical identity (never changes) */
+    /**
+     * Stable physical identity.
+     * Used as React key. NEVER changes.
+     */
     readonly key: string;
-    /** Logical data index currently bound */
+    /**
+     * Logical data index currently bound.
+     * Changes as the cell is recycled.
+     */
     index: number;
-    /** Compatibility type (row, header, etc.) */
+    /**
+     * Compatibility type (row, header, etc).
+     * Determines reuse eligibility.
+     */
     readonly type: string;
 }
 //# sourceMappingURL=Cell.d.ts.map

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

@@ -1 +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"}
+{"version":3,"file":"Cell.d.ts","sourceRoot":"","sources":["../../../../src/cell/Cell.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,IAAI;IACnB;;;OAGG;IACH,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IAEpB;;;OAGG;IACH,KAAK,EAAE,MAAM,CAAA;IAEb;;;OAGG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CACtB"}

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

@@ -0,0 +1,11 @@
+import type { CellKey } from '../types/CellKey';
+/**
+ * Monotonic key generator for physical cell instances.
+ * Guarantees stable keys across the lifetime of the list.
+ */
+export declare class CellKeyGenerator {
+    private nextId;
+    next(): CellKey;
+    reset(): void;
+}
+//# sourceMappingURL=CellKeyGenerator.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"CellKeyGenerator.d.ts","sourceRoot":"","sources":["../../../../src/cell/CellKeyGenerator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAA;AAE/C;;;GAGG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,MAAM,CAAI;IAElB,IAAI,IAAI,OAAO;IAIf,KAAK,IAAI,IAAI;CAGd"}

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

@@ -1,19 +1,27 @@
 import type { Cell } from './Cell';
 /**
- * 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 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.
+     * Active cells mapped by logical index.
      */
-    reconcile(visibleIndices: readonly number[], getCellType: (index: number) => string): readonly Cell[];
+    private readonly indexToCell;
+    /**
+     * Pool of detached reusable cells.
+     */
+    private readonly recycledCells;
+    /**
+     * Reconcile a contiguous visible index range
+     * into a stable list of physical cells.
+     *
+     * HOT PATH:
+     * - No index arrays
+     * - Minimal allocations
+     * - Deterministic
+     */
+    reconcileRange(startIndex: number, endIndex: number, resolveCellType: (index: number) => string): readonly Cell[];
 }
 //# sourceMappingURL=CellRecycler.d.ts.map

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

@@ -1 +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"}
+{"version":3,"file":"CellRecycler.d.ts","sourceRoot":"","sources":["../../../../src/cell/CellRecycler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAA;AAGlC;;;;GAIG;AACH,qBAAa,YAAY;IACvB;;OAEG;IACH,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA0B;IAEtD;;OAEG;IACH,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAa;IAE3C;;;;;;;;OAQG;IACH,cAAc,CACZ,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,eAAe,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,GACzC,SAAS,IAAI,EAAE;CA2CnB"}

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

@@ -0,0 +1,7 @@
+import type { Cell } from './Cell';
+/**
+ * Creates a new physical cell with a stable identity.
+ * The key is generated ONCE and never changes.
+ */
+export declare function createCell(type: string): Cell;
+//# sourceMappingURL=createCell.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"createCell.d.ts","sourceRoot":"","sources":["../../../../src/cell/createCell.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAA;AAIlC;;;GAGG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAM7C"}

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

@@ -0,0 +1,4 @@
+export type { Cell } from './Cell';
+export { CellRecycler } from './CellRecycler';
+export { createCell } from './createCell';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/cell/index.ts"],"names":[],"mappings":"AAEA,YAAY,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAA;AAClC,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAC7C,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA"}

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

@@ -1,8 +1,8 @@
-import type { LayoutRectangle } from './layout/LayoutRectangle';
+import type { LayoutRect } from './types/layout';
 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[];
+export declare function getVisibleRange(layouts: readonly LayoutRect[], metrics: ScrollMetrics, bufferPx: number): readonly number[];
 //# sourceMappingURL=getVisibleIndices.d.ts.map

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

@@ -1 +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"}
+{"version":3,"file":"getVisibleIndices.d.ts","sourceRoot":"","sources":["../../../src/getVisibleIndices.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAA;AAChD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAA;AAE9D;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,SAAS,UAAU,EAAE,EAC9B,OAAO,EAAE,aAAa,EACtB,QAAQ,EAAE,MAAM,GACf,SAAS,MAAM,EAAE,CAyCnB"}

package/lib/typescript/src/hooks/usePersistentCallback.d.ts

@@ -0,0 +1,16 @@
+/**
+ * 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 declare function usePersistentCallback<T extends (...args: never[]) => unknown>(fn: T): T;
+//# sourceMappingURL=usePersistentCallback.d.ts.map

package/lib/typescript/src/hooks/usePersistentCallback.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usePersistentCallback.d.ts","sourceRoot":"","sources":["../../../../src/hooks/usePersistentCallback.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;GAaG;AACH,wBAAgB,qBAAqB,CACnC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,KAAK,EAAE,KAAK,OAAO,EACvC,EAAE,EAAE,CAAC,GAAG,CAAC,CAkBV"}