react-native-nitro-list 0.1.1 → 0.1.2

package/src/types/layout/MainAxisPadding.ts

@@ -0,0 +1,23 @@
+/**
+ * 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.
+ */
+export interface MainAxisPadding {
+  readonly start: number
+  readonly end: number
+}
+
+/**
+ * Shared zero-padding constant.
+ * Safe to reuse across layouts.
+ */
+export const ZERO_MAIN_AXIS_PADDING: MainAxisPadding = {
+  start: 0,
+  end: 0,
+}

package/src/types/layout/index.ts

@@ -0,0 +1,3 @@
+export type { LayoutRect } from './LayoutRect'
+export type { LinearLayoutInput } from './LinearLayoutInput'
+export type { MainAxisPadding } from './MainAxisPadding'

package/src/types/recycler/RecyclerCellInstance.ts

@@ -0,0 +1,40 @@
+import type { CellKey } from "../CellKey"
+import type { CellType } from "../CellType"
+
+
+/**
+ * Physical reusable cell instance.
+ *
+ * Represents a single mounted view that can be rebound
+ * to different data items as scrolling occurs.
+ *
+ * Cross-platform equivalent:
+ * - Flutter: Element / RenderObject
+ * - Android: ViewHolder
+ * - iOS: UICollectionViewCell
+ */
+export interface RecyclerCellInstance {
+  /**
+   * Stable physical identity.
+   *
+   * Used as React key.
+   * MUST remain constant for the lifetime of the instance.
+   */
+  readonly key: CellKey
+
+  /**
+   * Logical data index currently bound to this instance.
+   *
+   * This value changes as the cell is recycled.
+   * - -1 may be used to indicate "unbound".
+   */
+  index: number
+
+  /**
+   * Logical compatibility type.
+   *
+   * Determines which instances can be reused together.
+   * Instances with different types MUST NOT be reused.
+   */
+  readonly type: CellType
+}

package/src/types/recycler/RecyclerItemRenderer.ts

@@ -0,0 +1,8 @@
+import type { ReactNode } from 'react'
+import type { RecyclerCellInstance } from './RecyclerCellInstance'
+
+export type RecyclerItemRenderer<T> = (params: {
+  item: T
+  index: number
+  cell: RecyclerCellInstance
+}) => ReactNode

package/src/types/recycler/RecyclerListProps.ts

@@ -0,0 +1,74 @@
+import type { Axis } from '../Axis'
+import type { CellType } from '../CellType'
+import type { MainAxisPadding } from '../layout'
+import type { RecyclerItemRenderer } from './RecyclerItemRenderer'
+
+/**
+ * Public props for RecyclerList.
+ *
+ * Generic, data-driven, layout-deterministic API.
+ * This surface is intentionally minimal and stable.
+ */
+export interface RecyclerListProps<T> {
+  /**
+   * Scroll direction.
+   * Defaults to 'vertical'.
+   */
+  readonly scrollDirection?: Axis
+
+  /**
+   * Cross-axis size.
+   * - vertical   → width
+   * - horizontal → height
+   *
+   * Required for deterministic layout.
+   */
+  readonly containerCrossAxisSize: number
+
+  /**
+   * Data source.
+   * Length is the single source of truth for item count.
+   */
+  readonly data: readonly T[]
+
+  /**
+   * Item sizes along the main axis.
+   * Must match data length.
+   *
+   * - vertical   → heights
+   * - horizontal → widths
+   */
+  readonly itemMainAxisSizes: readonly number[]
+
+  /**
+   * Padding before and after content along the main axis.
+   *
+   * Defaults are applied internally by the layout engine.
+   */
+  readonly padding?: MainAxisPadding
+
+  /**
+   * Space BETWEEN items along the main axis.
+   *
+   * Defaults are applied internally by the layout engine.
+   */
+  readonly itemSpacing?: number
+
+  /**
+   * Extra render buffer as a ratio of viewport size.
+   * Used for overscan / pre-rendering.
+   */
+  readonly bufferRatio?: number
+
+  /**
+   * Logical cell type resolver.
+   * Determines recycling compatibility.
+   */
+  readonly getCellType: (item: T, index: number) => CellType
+
+  /**
+   * Item renderer.
+   * Receives stable cell identity and data.
+   */
+  readonly renderItem: RecyclerItemRenderer<T>
+}

package/src/types/recycler/index.ts

@@ -0,0 +1,3 @@
+export type { RecyclerListProps } from './RecyclerListProps'
+export type { RecyclerItemRenderer } from './RecyclerItemRenderer' 
+export type { RecyclerCellInstance } from './RecyclerCellInstance'  

package/src/types/scroll/ScrollMetrics.ts

@@ -0,0 +1,18 @@
+import type { Axis } from "../Axis"
+
+
+/**
+ * Scroll state snapshot.
+ *
+ * Pure data — no platform or React coupling.
+ */
+export interface ScrollMetrics {
+  /** Scroll axis */
+  readonly axis: Axis
+
+  /** Offset along the main axis */
+  readonly offset: number
+
+  /** Viewport size along the main axis */
+  readonly viewportSize: number
+}

package/src/types/scroll/index.ts

@@ -0,0 +1 @@
+export type { ScrollMetrics } from './ScrollMetrics'

package/src/windowing/computeVisibleItemRange.ts

@@ -0,0 +1,78 @@
+import type { VisibleRange } from '../types/VisibleRange'
+import type { VisibleRangeInput } from '../types/VisibleRangeInput'
+
+/**
+ * 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: VisibleRangeInput
+): VisibleRange | null {
+  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,
+  }
+}

package/src/windowing/index.ts

@@ -1,3 +1,3 @@
 export type { ScrollMetrics } from './ScrollMetrics'
-export { findVisibleIndexRange } from './findVisibleIndexRange'
 export { useScrollMetrics } from './useScrollMetrics'
+export { computeVisibleItemRange } from './computeVisibleItemRange'

package/lib/commonjs/RecyclerList.internal.js

@@ -1,25 +0,0 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.useRecyclerListInternal = useRecyclerListInternal;
-var _useCellRenderer = require("./hooks/useCellRenderer");
-/**
- * INTERNAL hook.
- * MUST ALWAYS CALL hooks in the same order.
- */
-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 (0, _useCellRenderer.useCellRenderer)(safeLayouts, metrics, safeBufferPx, getItemType);
-}
-
-/** Stable empty reference */
-const EMPTY_LAYOUTS = [];
-//# sourceMappingURL=RecyclerList.internal.js.map

package/lib/commonjs/RecyclerList.internal.js.map

@@ -1 +0,0 @@
-{"version":3,"names":["_useCellRenderer","require","useRecyclerListInternal","layouts","metrics","bufferPx","getItemType","safeLayouts","height","EMPTY_LAYOUTS","safeBufferPx","useCellRenderer"],"sourceRoot":"../../src","sources":["RecyclerList.internal.ts"],"mappings":";;;;;;AAIA,IAAAA,gBAAA,GAAAC,OAAA;AAEA;AACA;AACA;AACA;AACO,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,OAAO,IAAAM,gCAAe,EACpBJ,WAAW,EACXH,OAAO,EACPM,YAAY,EACZJ,WACF,CAAC;AACH;;AAEA;AACA,MAAMG,aAAyC,GAAG,EAAE","ignoreList":[]}

package/lib/commonjs/RecyclerList.js

@@ -1,171 +0,0 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.RecyclerList = RecyclerList;
-var _react = _interopRequireWildcard(require("react"));
-var _reactNative = require("react-native");
-var _RecyclerList = require("./RecyclerList.internal");
-var _windowing = require("./windowing");
-var _MutableLinearLayout = require("./layout/MutableLinearLayout");
-var _ViewabilityHelper = require("./viewability/ViewabilityHelper");
-var _PrefetchHelper = require("./prefetch/PrefetchHelper");
-var _jsxRuntime = require("react/jsx-runtime");
-function _interopRequireWildcard(e, t) { if ("function" == typeof WeakMap) var r = new WeakMap(), n = new WeakMap(); return (_interopRequireWildcard = function (e, t) { if (!t && e && e.__esModule) return e; var o, i, f = { __proto__: null, default: e }; if (null === e || "object" != typeof e && "function" != typeof e) return f; if (o = t ? n : r) { if (o.has(e)) return o.get(e); o.set(e, f); } for (const t in e) "default" !== t && {}.hasOwnProperty.call(e, t) && ((i = (o = Object.defineProperty) && Object.getOwnPropertyDescriptor(e, t)) && (i.get || i.set) ? o(f, t, i) : f[t] = e[t]); return f; })(e, t); }
-/**
- * Public API — mirrors FlashList behavior, not internals.
- */
-
-/**
- * FlashList invariant:
- * Never allow viewport height = 0 to gate windowing.
- */
-const DEFAULT_VIEWPORT_HEIGHT = 800;
-function RecyclerList(props) {
-  const {
-    containerWidth,
-    itemCount,
-    itemHeights,
-    estimatedItemHeight = 80,
-    renderBufferRatio = 1.3,
-    getItemType = () => 'default',
-    renderItem,
-    onPrefetch,
-    onViewableItemsChanged
-  } = props;
-
-  /**
-   * 🚨 DEV WARNINGS ONLY (never throw in render!)
-   */
-  if (__DEV__) {
-    if (!itemHeights && itemCount == null) {
-      console.error('RecyclerList requires either itemCount or itemHeights.');
-    }
-    if (itemHeights && itemCount != null) {
-      console.error('Provide only one of itemCount or itemHeights.');
-    }
-  }
-
-  /**
-   * STEP 1: Resolve item count safely (props only).
-   * Never depend on hooks for structural decisions.
-   */
-  const itemLength = itemHeights?.length ?? itemCount ?? 0;
-
-  /**
-   * STEP 2: Resolve initial heights (always defined).
-   */
-  const resolvedHeights = (0, _react.useMemo)(() => {
-    if (itemHeights) return itemHeights;
-    return Array.from({
-      length: itemLength
-    }, () => estimatedItemHeight);
-  }, [itemHeights, itemLength, estimatedItemHeight]);
-
-  /**
-   * STEP 3: Mutable layout lifecycle.
-   * Recreate layout only when shape changes.
-   */
-  const layoutRef = (0, _react.useRef)(null);
-  const lastLayoutKeyRef = (0, _react.useRef)(null);
-  const layoutKey = `${containerWidth}-${itemLength}`;
-  if (!layoutRef.current || lastLayoutKeyRef.current !== layoutKey) {
-    layoutRef.current = new _MutableLinearLayout.MutableLinearLayout(resolvedHeights, containerWidth);
-    lastLayoutKeyRef.current = layoutKey;
-  }
-
-  /**
-   * STEP 4: Read layout snapshot.
-   */
-  const layouts = layoutRef.current.getLayouts();
-  const contentHeight = layoutRef.current.getContentHeight();
-
-  /**
-   * STEP 5: Scroll metrics.
-   */
-  const {
-    metrics,
-    onScroll,
-    onLayout
-  } = (0, _windowing.useScrollMetrics)();
-
-  /**
-   * STEP 6: Guard initial windowing.
-   */
-  const effectiveViewportHeight = metrics.height > 0 ? metrics.height : DEFAULT_VIEWPORT_HEIGHT;
-  const bufferPx = effectiveViewportHeight * renderBufferRatio;
-
-  /**
-   * STEP 7: Windowing + recycling.
-   */
-  const cells = (0, _RecyclerList.useRecyclerListInternal)(layouts, metrics, bufferPx, getItemType);
-
-  /**
-   * STEP 8: Phase-1 observers.
-   */
-  const viewabilityRef = (0, _react.useRef)(new _ViewabilityHelper.ViewabilityHelper({
-    itemVisiblePercentThreshold: 50
-  }));
-  const prefetchRef = (0, _react.useRef)(new _PrefetchHelper.PrefetchHelper());
-  (0, _react.useEffect)(() => {
-    prefetchRef.current = new _PrefetchHelper.PrefetchHelper();
-  }, [itemLength]);
-  (0, _react.useEffect)(() => {
-    if (metrics.height === 0) return;
-    if (onViewableItemsChanged) {
-      const visibleLayouts = [];
-      for (const cell of cells) {
-        const layout = layouts[cell.index];
-        if (layout) visibleLayouts.push(layout);
-      }
-      const info = viewabilityRef.current.computeViewableItems(visibleLayouts, metrics);
-      onViewableItemsChanged(info);
-    }
-    if (onPrefetch && itemLength > 0) {
-      prefetchRef.current.runPrefetch(cells.map(c => c.index), itemLength, 5, onPrefetch);
-    }
-  }, [cells, metrics.offsetY, metrics.height, onViewableItemsChanged, onPrefetch, itemLength, layouts]);
-
-  /**
-   * STEP 9: Render absolutely positioned cells.
-   */
-  return /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.ScrollView, {
-    style: styles.container,
-    onLayout: onLayout,
-    onScroll: onScroll,
-    scrollEventThrottle: 16,
-    removeClippedSubviews: true,
-    children: /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.View, {
-      style: [styles.content, {
-        height: contentHeight
-      }],
-      children: cells.map(cell => {
-        const layout = layouts[cell.index];
-        if (!layout) return null;
-        return /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.View, {
-          style: [styles.cell, {
-            top: layout.y,
-            width: layout.width,
-            height: layout.height
-          }],
-          children: renderItem(cell.index)
-        }, cell.key);
-      })
-    })
-  });
-}
-const styles = _reactNative.StyleSheet.create({
-  container: {
-    flex: 1
-  },
-  content: {
-    position: 'relative',
-    width: '100%'
-  },
-  cell: {
-    position: 'absolute',
-    left: 0
-  }
-});
-//# sourceMappingURL=RecyclerList.js.map

package/lib/commonjs/RecyclerList.js.map

@@ -1 +0,0 @@
-{"version":3,"names":["_react","_interopRequireWildcard","require","_reactNative","_RecyclerList","_windowing","_MutableLinearLayout","_ViewabilityHelper","_PrefetchHelper","_jsxRuntime","e","t","WeakMap","r","n","__esModule","o","i","f","__proto__","default","has","get","set","hasOwnProperty","call","Object","defineProperty","getOwnPropertyDescriptor","DEFAULT_VIEWPORT_HEIGHT","RecyclerList","props","containerWidth","itemCount","itemHeights","estimatedItemHeight","renderBufferRatio","getItemType","renderItem","onPrefetch","onViewableItemsChanged","__DEV__","console","error","itemLength","length","resolvedHeights","useMemo","Array","from","layoutRef","useRef","lastLayoutKeyRef","layoutKey","current","MutableLinearLayout","layouts","getLayouts","contentHeight","getContentHeight","metrics","onScroll","onLayout","useScrollMetrics","effectiveViewportHeight","height","bufferPx","cells","useRecyclerListInternal","viewabilityRef","ViewabilityHelper","itemVisiblePercentThreshold","prefetchRef","PrefetchHelper","useEffect","visibleLayouts","cell","layout","index","push","info","computeViewableItems","runPrefetch","map","c","offsetY","jsx","ScrollView","style","styles","container","scrollEventThrottle","removeClippedSubviews","children","View","content","top","y","width","key","StyleSheet","create","flex","position","left"],"sourceRoot":"../../src","sources":["RecyclerList.tsx"],"mappings":";;;;;;AAAA,IAAAA,MAAA,GAAAC,uBAAA,CAAAC,OAAA;AAKA,IAAAC,YAAA,GAAAD,OAAA;AASA,IAAAE,aAAA,GAAAF,OAAA;AACA,IAAAG,UAAA,GAAAH,OAAA;AACA,IAAAI,oBAAA,GAAAJ,OAAA;AACA,IAAAK,kBAAA,GAAAL,OAAA;AACA,IAAAM,eAAA,GAAAN,OAAA;AAA0D,IAAAO,WAAA,GAAAP,OAAA;AAAA,SAAAD,wBAAAS,CAAA,EAAAC,CAAA,6BAAAC,OAAA,MAAAC,CAAA,OAAAD,OAAA,IAAAE,CAAA,OAAAF,OAAA,YAAAX,uBAAA,YAAAA,CAAAS,CAAA,EAAAC,CAAA,SAAAA,CAAA,IAAAD,CAAA,IAAAA,CAAA,CAAAK,UAAA,SAAAL,CAAA,MAAAM,CAAA,EAAAC,CAAA,EAAAC,CAAA,KAAAC,SAAA,QAAAC,OAAA,EAAAV,CAAA,iBAAAA,CAAA,uBAAAA,CAAA,yBAAAA,CAAA,SAAAQ,CAAA,MAAAF,CAAA,GAAAL,CAAA,GAAAG,CAAA,GAAAD,CAAA,QAAAG,CAAA,CAAAK,GAAA,CAAAX,CAAA,UAAAM,CAAA,CAAAM,GAAA,CAAAZ,CAAA,GAAAM,CAAA,CAAAO,GAAA,CAAAb,CAAA,EAAAQ,CAAA,gBAAAP,CAAA,IAAAD,CAAA,gBAAAC,CAAA,OAAAa,cAAA,CAAAC,IAAA,CAAAf,CAAA,EAAAC,CAAA,OAAAM,CAAA,IAAAD,CAAA,GAAAU,MAAA,CAAAC,cAAA,KAAAD,MAAA,CAAAE,wBAAA,CAAAlB,CAAA,EAAAC,CAAA,OAAAM,CAAA,CAAAK,GAAA,IAAAL,CAAA,CAAAM,GAAA,IAAAP,CAAA,CAAAE,CAAA,EAAAP,CAAA,EAAAM,CAAA,IAAAC,CAAA,CAAAP,CAAA,IAAAD,CAAA,CAAAC,CAAA,WAAAO,CAAA,KAAAR,CAAA,EAAAC,CAAA;AAE1D;AACA;AACA;;AAgBA;AACA;AACA;AACA;AACA,MAAMkB,uBAAuB,GAAG,GAAG;AAE5B,SAASC,YAAYA,CAACC,KAAwB,EAAsB;EACzE,MAAM;IACJC,cAAc;IACdC,SAAS;IACTC,WAAW;IACXC,mBAAmB,GAAG,EAAE;IACxBC,iBAAiB,GAAG,GAAG;IACvBC,WAAW,GAAGA,CAAA,KAAM,SAAS;IAC7BC,UAAU;IACVC,UAAU;IACVC;EACF,CAAC,GAAGT,KAAK;;EAET;AACF;AACA;EACE,IAAIU,OAAO,EAAE;IACX,IAAI,CAACP,WAAW,IAAID,SAAS,IAAI,IAAI,EAAE;MACrCS,OAAO,CAACC,KAAK,CACX,wDACF,CAAC;IACH;IAEA,IAAIT,WAAW,IAAID,SAAS,IAAI,IAAI,EAAE;MACpCS,OAAO,CAACC,KAAK,CACX,+CACF,CAAC;IACH;EACF;;EAEA;AACF;AACA;AACA;EACE,MAAMC,UAAU,GACdV,WAAW,EAAEW,MAAM,IACnBZ,SAAS,IACT,CAAC;;EAEH;AACF;AACA;EACE,MAAMa,eAAe,GAAG,IAAAC,cAAO,EAAoB,MAAM;IACvD,IAAIb,WAAW,EAAE,OAAOA,WAAW;IAEnC,OAAOc,KAAK,CAACC,IAAI,CACf;MAAEJ,MAAM,EAAED;IAAW,CAAC,EACtB,MAAMT,mBACR,CAAC;EACH,CAAC,EAAE,CAACD,WAAW,EAAEU,UAAU,EAAET,mBAAmB,CAAC,CAAC;;EAElD;AACF;AACA;AACA;EACE,MAAMe,SAAS,GAAG,IAAAC,aAAM,EAA6B,IAAI,CAAC;EAC1D,MAAMC,gBAAgB,GAAG,IAAAD,aAAM,EAAgB,IAAI,CAAC;EAEpD,MAAME,SAAS,GAAG,GAAGrB,cAAc,IAAIY,UAAU,EAAE;EAEnD,IACE,CAACM,SAAS,CAACI,OAAO,IAClBF,gBAAgB,CAACE,OAAO,KAAKD,SAAS,EACtC;IACAH,SAAS,CAACI,OAAO,GAAG,IAAIC,wCAAmB,CACzCT,eAAe,EACfd,cACF,CAAC;IACDoB,gBAAgB,CAACE,OAAO,GAAGD,SAAS;EACtC;;EAEA;AACF;AACA;EACE,MAAMG,OAAmC,GACvCN,SAAS,CAACI,OAAO,CAACG,UAAU,CAAC,CAAC;EAEhC,MAAMC,aAAa,GACjBR,SAAS,CAACI,OAAO,CAACK,gBAAgB,CAAC,CAAC;;EAEtC;AACF;AACA;EACE,MAAM;IACJC,OAAO;IACPC,QAAQ;IACRC;EACF,CAAC,GAAG,IAAAC,2BAAgB,EAAC,CAAC;;EAEtB;AACF;AACA;EACE,MAAMC,uBAAuB,GAC3BJ,OAAO,CAACK,MAAM,GAAG,CAAC,GACdL,OAAO,CAACK,MAAM,GACdpC,uBAAuB;EAE7B,MAAMqC,QAAQ,GACZF,uBAAuB,GAAG5B,iBAAiB;;EAE7C;AACF;AACA;EACE,MAAM+B,KAAsB,GAC1B,IAAAC,qCAAuB,EACrBZ,OAAO,EACPI,OAAO,EACPM,QAAQ,EACR7B,WACF,CAAC;;EAEH;AACF;AACA;EACE,MAAMgC,cAAc,GAAG,IAAAlB,aAAM,EAC3B,IAAImB,oCAAiB,CAAC;IACpBC,2BAA2B,EAAE;EAC/B,CAAC,CACH,CAAC;EAED,MAAMC,WAAW,GAAG,IAAArB,aAAM,EACxB,IAAIsB,8BAAc,CAAC,CACrB,CAAC;EAED,IAAAC,gBAAS,EAAC,MAAM;IACdF,WAAW,CAAClB,OAAO,GAAG,IAAImB,8BAAc,CAAC,CAAC;EAC5C,CAAC,EAAE,CAAC7B,UAAU,CAAC,CAAC;EAEhB,IAAA8B,gBAAS,EAAC,MAAM;IACd,IAAId,OAAO,CAACK,MAAM,KAAK,CAAC,EAAE;IAE1B,IAAIzB,sBAAsB,EAAE;MAC1B,MAAMmC,cAAiC,GAAG,EAAE;MAE5C,KAAK,MAAMC,IAAI,IAAIT,KAAK,EAAE;QACxB,MAAMU,MAAM,GAAGrB,OAAO,CAACoB,IAAI,CAACE,KAAK,CAAC;QAClC,IAAID,MAAM,EAAEF,cAAc,CAACI,IAAI,CAACF,MAAM,CAAC;MACzC;MAEA,MAAMG,IAAI,GACRX,cAAc,CAACf,OAAO,CAAC2B,oBAAoB,CACzCN,cAAc,EACdf,OACF,CAAC;MAEHpB,sBAAsB,CAACwC,IAAI,CAAC;IAC9B;IAEA,IAAIzC,UAAU,IAAIK,UAAU,GAAG,CAAC,EAAE;MAChC4B,WAAW,CAAClB,OAAO,CAAC4B,WAAW,CAC7Bf,KAAK,CAACgB,GAAG,CAACC,CAAC,IAAIA,CAAC,CAACN,KAAK,CAAC,EACvBlC,UAAU,EACV,CAAC,EACDL,UACF,CAAC;IACH;EACF,CAAC,EAAE,CACD4B,KAAK,EACLP,OAAO,CAACyB,OAAO,EACfzB,OAAO,CAACK,MAAM,EACdzB,sBAAsB,EACtBD,UAAU,EACVK,UAAU,EACVY,OAAO,CACR,CAAC;;EAEF;AACF;AACA;EACE,oBACE,IAAA/C,WAAA,CAAA6E,GAAA,EAACnF,YAAA,CAAAoF,UAAU;IACTC,KAAK,EAAEC,MAAM,CAACC,SAAU;IACxB5B,QAAQ,EAAEA,QAAS;IACnBD,QAAQ,EAAEA,QAAS;IACnB8B,mBAAmB,EAAE,EAAG;IACxBC,qBAAqB;IAAAC,QAAA,eAErB,IAAApF,WAAA,CAAA6E,GAAA,EAACnF,YAAA,CAAA2F,IAAI;MAACN,KAAK,EAAE,CAACC,MAAM,CAACM,OAAO,EAAE;QAAE9B,MAAM,EAAEP;MAAc,CAAC,CAAE;MAAAmC,QAAA,EACtD1B,KAAK,CAACgB,GAAG,CAACP,IAAI,IAAI;QACjB,MAAMC,MAAM,GAAGrB,OAAO,CAACoB,IAAI,CAACE,KAAK,CAAC;QAClC,IAAI,CAACD,MAAM,EAAE,OAAO,IAAI;QAExB,oBACE,IAAApE,WAAA,CAAA6E,GAAA,EAACnF,YAAA,CAAA2F,IAAI;UAEHN,KAAK,EAAE,CACLC,MAAM,CAACb,IAAI,EACX;YACEoB,GAAG,EAAEnB,MAAM,CAACoB,CAAC;YACbC,KAAK,EAAErB,MAAM,CAACqB,KAAK;YACnBjC,MAAM,EAAEY,MAAM,CAACZ;UACjB,CAAC,CACD;UAAA4B,QAAA,EAEDvD,UAAU,CAACsC,IAAI,CAACE,KAAK;QAAC,GAVlBF,IAAI,CAACuB,GAWN,CAAC;MAEX,CAAC;IAAC,CACE;EAAC,CACG,CAAC;AAEjB;AAEA,MAAMV,MAAM,GAAGW,uBAAU,CAACC,MAAM,CAAC;EAC/BX,SAAS,EAAE;IAAEY,IAAI,EAAE;EAAE,CAAC;EACtBP,OAAO,EAAE;IAAEQ,QAAQ,EAAE,UAAU;IAAEL,KAAK,EAAE;EAAO,CAAC;EAChDtB,IAAI,EAAE;IAAE2B,QAAQ,EAAE,UAAU;IAAEC,IAAI,EAAE;EAAE;AACxC,CAAC,CAAC","ignoreList":[]}

package/lib/commonjs/RecyclerList.types.js.map

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

package/lib/commonjs/cell/StableKey.js

@@ -1,10 +0,0 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.getStableKey = getStableKey;
-function getStableKey(slotKey, index) {
-  return `${slotKey}:${index}`;
-}
-//# sourceMappingURL=StableKey.js.map

package/lib/commonjs/cell/StableKey.js.map

@@ -1 +0,0 @@
-{"version":3,"names":["getStableKey","slotKey","index"],"sourceRoot":"../../../src","sources":["cell/StableKey.ts"],"mappings":";;;;;;AAAO,SAASA,YAAYA,CAC1BC,OAAe,EACfC,KAAa,EACL;EACR,OAAO,GAAGD,OAAO,IAAIC,KAAK,EAAE;AAC9B","ignoreList":[]}

package/lib/commonjs/hooks/useCellRenderer.js

@@ -1,62 +0,0 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.useCellRenderer = useCellRenderer;
-var _react = require("react");
-var _CellRecycler = require("../cell/CellRecycler");
-var _findVisibleIndexRange = require("../windowing/findVisibleIndexRange");
-/**
- * 🔒 Stable empty references (module-level)
- * These MUST NOT be recreated per render.
- */
-const EMPTY_INDICES = [];
-
-/**
- * React bridge for CellRecycler.
- * FlashList equivalent: useCellRenderer
- *
- * Responsibilities:
- * - Translate scroll state → visible indices
- * - Ask recycler for physical cells
- * - Commit results with referential stability
- *
- * Responsibilities it does NOT have:
- * ❌ Layout mutation
- * ❌ Measurement
- * ❌ Rendering
- */
-function useCellRenderer(layouts, metrics, bufferPx, getCellType) {
-  /**
-   * Recycler instance is stable across renders.
-   */
-  const recyclerRef = (0, _react.useRef)(new _CellRecycler.CellRecycler());
-
-  /**
-   * Compute visible indices.
-   * PURE + TOTAL:
-   * - Never throws
-   * - Always returns the same reference when empty
-   */
-  const visibleIndices = (0, _react.useMemo)(() => layouts.length === 0 ? EMPTY_INDICES : (0, _findVisibleIndexRange.findVisibleIndexRange)(layouts, metrics, bufferPx), [layouts, metrics.offsetY, metrics.height, bufferPx]);
-
-  /**
-   * Physical cells to render.
-   */
-  const [cells, setCells] = (0, _react.useState)([]);
-
-  /**
-   * Reconcile visible indices → physical cells.
-   *
-   * FlashList invariant:
-   * - Only update state if identity truly changed
-   * - Prevents pointless re-renders
-   */
-  (0, _react.useEffect)(() => {
-    const next = recyclerRef.current.reconcile(visibleIndices, getCellType);
-    setCells(prev => prev.length === next.length && prev.every((c, i) => c === next[i]) ? prev : next);
-  }, [visibleIndices, getCellType]);
-  return cells;
-}
-//# sourceMappingURL=useCellRenderer.js.map

package/lib/commonjs/hooks/useCellRenderer.js.map

@@ -1 +0,0 @@
-{"version":3,"names":["_react","require","_CellRecycler","_findVisibleIndexRange","EMPTY_INDICES","useCellRenderer","layouts","metrics","bufferPx","getCellType","recyclerRef","useRef","CellRecycler","visibleIndices","useMemo","length","findVisibleIndexRange","offsetY","height","cells","setCells","useState","useEffect","next","current","reconcile","prev","every","c","i"],"sourceRoot":"../../../src","sources":["hooks/useCellRenderer.ts"],"mappings":";;;;;;AAAA,IAAAA,MAAA,GAAAC,OAAA;AAEA,IAAAC,aAAA,GAAAD,OAAA;AACA,IAAAE,sBAAA,GAAAF,OAAA;AAIA;AACA;AACA;AACA;AACA,MAAMG,aAAgC,GAAG,EAAE;;AAE3C;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAASC,eAAeA,CAC7BC,OAAmC,EACnCC,OAAsB,EACtBC,QAAgB,EAChBC,WAAsC,EACrB;EACjB;AACF;AACA;EACE,MAAMC,WAAW,GAAG,IAAAC,aAAM,EAAe,IAAIC,0BAAY,CAAC,CAAC,CAAC;;EAE5D;AACF;AACA;AACA;AACA;AACA;EACE,MAAMC,cAAc,GAAG,IAAAC,cAAO,EAC5B,MACER,OAAO,CAACS,MAAM,KAAK,CAAC,GAChBX,aAAa,GACb,IAAAY,4CAAqB,EACnBV,OAAO,EACPC,OAAO,EACPC,QACF,CAAC,EACP,CAACF,OAAO,EAAEC,OAAO,CAACU,OAAO,EAAEV,OAAO,CAACW,MAAM,EAAEV,QAAQ,CACrD,CAAC;;EAED;AACF;AACA;EACE,MAAM,CAACW,KAAK,EAAEC,QAAQ,CAAC,GACrB,IAAAC,eAAQ,EAAkB,EAAE,CAAC;;EAE/B;AACF;AACA;AACA;AACA;AACA;AACA;EACE,IAAAC,gBAAS,EAAC,MAAM;IACd,MAAMC,IAAI,GACRb,WAAW,CAACc,OAAO,CAACC,SAAS,CAC3BZ,cAAc,EACdJ,WACF,CAAC;IAEHW,QAAQ,CAACM,IAAI,IACXA,IAAI,CAACX,MAAM,KAAKQ,IAAI,CAACR,MAAM,IAC3BW,IAAI,CAACC,KAAK,CAAC,CAACC,CAAC,EAAEC,CAAC,KAAKD,CAAC,KAAKL,IAAI,CAACM,CAAC,CAAC,CAAC,GAC/BH,IAAI,GACJH,IACN,CAAC;EACH,CAAC,EAAE,CAACV,cAAc,EAAEJ,WAAW,CAAC,CAAC;EAEjC,OAAOU,KAAK;AACd","ignoreList":[]}

package/lib/commonjs/hooks/useStableCallback.js

@@ -1,13 +0,0 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.useStableCallback = useStableCallback;
-var _react = require("react");
-function useStableCallback(fn) {
-  const ref = (0, _react.useRef)(fn);
-  ref.current = fn;
-  return (0, _react.useCallback)((...args) => ref.current(...args), []);
-}
-//# sourceMappingURL=useStableCallback.js.map

package/lib/commonjs/hooks/useStableCallback.js.map

@@ -1 +0,0 @@
-{"version":3,"names":["_react","require","useStableCallback","fn","ref","useRef","current","useCallback","args"],"sourceRoot":"../../../src","sources":["hooks/useStableCallback.ts"],"mappings":";;;;;;AAAA,IAAAA,MAAA,GAAAC,OAAA;AAEO,SAASC,iBAAiBA,CAC/BC,EAAK,EACF;EACH,MAAMC,GAAG,GAAG,IAAAC,aAAM,EAACF,EAAE,CAAC;EACtBC,GAAG,CAACE,OAAO,GAAGH,EAAE;EAEhB,OAAO,IAAAI,kBAAW,EACf,CAAC,GAAGC,IAAa,KAAKJ,GAAG,CAACE,OAAO,CAAC,GAAGE,IAAI,CAAC,EAC3C,EACF,CAAC;AACH","ignoreList":[]}

package/lib/commonjs/layout/EstimatedLayoutProvider.js

@@ -1,30 +0,0 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.EstimatedLayoutProvider = void 0;
-/**
- * Layout provider using estimated item heights.
- * Used before real measurements are available.
- */
-class EstimatedLayoutProvider {
-  constructor(itemCount, itemHeight, width) {
-    this.itemCount = itemCount;
-    this.itemHeight = itemHeight;
-    this.width = width;
-  }
-  getItemCount() {
-    return this.itemCount;
-  }
-  getLayout(index) {
-    return {
-      x: 0,
-      y: index * this.itemHeight,
-      width: this.width,
-      height: this.itemHeight
-    };
-  }
-}
-exports.EstimatedLayoutProvider = EstimatedLayoutProvider;
-//# sourceMappingURL=EstimatedLayoutProvider.js.map

package/lib/commonjs/layout/EstimatedLayoutProvider.js.map

@@ -1 +0,0 @@
-{"version":3,"names":["EstimatedLayoutProvider","constructor","itemCount","itemHeight","width","getItemCount","getLayout","index","x","y","height","exports"],"sourceRoot":"../../../src","sources":["layout/EstimatedLayoutProvider.ts"],"mappings":";;;;;;AAGA;AACA;AACA;AACA;AACO,MAAMA,uBAAuB,CAA2B;EAK7DC,WAAWA,CACTC,SAAiB,EACjBC,UAAkB,EAClBC,KAAa,EACb;IACA,IAAI,CAACF,SAAS,GAAGA,SAAS;IAC1B,IAAI,CAACC,UAAU,GAAGA,UAAU;IAC5B,IAAI,CAACC,KAAK,GAAGA,KAAK;EACpB;EAEAC,YAAYA,CAAA,EAAW;IACrB,OAAO,IAAI,CAACH,SAAS;EACvB;EAEAI,SAASA,CAACC,KAAa,EAAmB;IACxC,OAAO;MACLC,CAAC,EAAE,CAAC;MACJC,CAAC,EAAEF,KAAK,GAAG,IAAI,CAACJ,UAAU;MAC1BC,KAAK,EAAE,IAAI,CAACA,KAAK;MACjBM,MAAM,EAAE,IAAI,CAACP;IACf,CAAC;EACH;AACF;AAACQ,OAAA,CAAAX,uBAAA,GAAAA,uBAAA","ignoreList":[]}

package/lib/commonjs/layout/LayoutEngine.js

@@ -1,21 +0,0 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.computeLayouts = computeLayouts;
-/**
- * Resolves layouts eagerly into a contiguous array.
- * Pure, deterministic, and reusable.
- *
- * FlashList equivalent: internal layout resolver.
- */
-function computeLayouts(provider) {
-  const count = provider.getItemCount();
-  const layouts = new Array(count);
-  for (let i = 0; i < count; i++) {
-    layouts[i] = provider.getLayout(i);
-  }
-  return layouts;
-}
-//# sourceMappingURL=LayoutEngine.js.map

package/lib/commonjs/layout/LayoutEngine.js.map

@@ -1 +0,0 @@
-{"version":3,"names":["computeLayouts","provider","count","getItemCount","layouts","Array","i","getLayout"],"sourceRoot":"../../../src","sources":["layout/LayoutEngine.ts"],"mappings":";;;;;;AAGA;AACA;AACA;AACA;AACA;AACA;AACO,SAASA,cAAcA,CAC5BC,QAAwB,EACI;EAC5B,MAAMC,KAAK,GAAGD,QAAQ,CAACE,YAAY,CAAC,CAAC;EACrC,MAAMC,OAA0B,GAAG,IAAIC,KAAK,CAACH,KAAK,CAAC;EAEnD,KAAK,IAAII,CAAC,GAAG,CAAC,EAAEA,CAAC,GAAGJ,KAAK,EAAEI,CAAC,EAAE,EAAE;IAC9BF,OAAO,CAACE,CAAC,CAAC,GAAGL,QAAQ,CAACM,SAAS,CAACD,CAAC,CAAC;EACpC;EAEA,OAAOF,OAAO;AAChB","ignoreList":[]}

package/lib/commonjs/layout/LayoutRectangle.js

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