react-native-nitro-list 0.0.1 → 0.1.2

package/lib/module/utils/throttle.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["throttle","fn","ms","last","args","now","Date"],"sourceRoot":"../../../src","sources":["utils/throttle.ts"],"mappings":";;AAAA,OAAO,SAASA,QAAQA,CACtBC,EAAK,EACLC,EAAU,EACP;EACH,IAAIC,IAAI,GAAG,CAAC;EACZ,OAAQ,CAAC,GAAGC,IAAa,KAAK;IAC5B,MAAMC,GAAG,GAAGC,IAAI,CAACD,GAAG,CAAC,CAAC;IACtB,IAAIA,GAAG,GAAGF,IAAI,GAAGD,EAAE,EAAE;MACnBC,IAAI,GAAGE,GAAG;MACVJ,EAAE,CAAC,GAAGG,IAAI,CAAC;IACb;EACF,CAAC;AACH","ignoreList":[]}

package/lib/module/windowing/ScrollMetrics.js

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

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

@@ -0,0 +1 @@
+{"version":3,"names":[],"sourceRoot":"../../../src","sources":["windowing/ScrollMetrics.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

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

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

@@ -0,0 +1 @@
+{"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/module/windowing/useScrollMetrics.js

@@ -0,0 +1,35 @@
+"use strict";
+
+import { useCallback, useState } from 'react';
+/**
+ * Scroll metrics hook.
+ * Provides stable scroll snapshot + handlers.
+ *
+ * FlashList equivalent: useScrollMetrics
+ */
+export function useScrollMetrics() {
+  const [metrics, setMetrics] = useState({
+    offsetY: 0,
+    height: 0
+  });
+  const onScroll = useCallback(e => {
+    const offsetY = e.nativeEvent.contentOffset.y;
+    setMetrics(prev => prev.offsetY === offsetY ? prev : {
+      ...prev,
+      offsetY
+    });
+  }, []);
+  const onLayout = 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/module/windowing/useScrollMetrics.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["useCallback","useState","useScrollMetrics","metrics","setMetrics","offsetY","height","onScroll","e","nativeEvent","contentOffset","y","prev","onLayout","layout"],"sourceRoot":"../../../src","sources":["windowing/useScrollMetrics.ts"],"mappings":";;AAAA,SAASA,WAAW,EAAEC,QAAQ,QAAQ,OAAO;AAQ7C;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,gBAAgBA,CAAA,EAI9B;EACA,MAAM,CAACC,OAAO,EAAEC,UAAU,CAAC,GAAGH,QAAQ,CAAgB;IACpDI,OAAO,EAAE,CAAC;IACVC,MAAM,EAAE;EACV,CAAC,CAAC;EAEF,MAAMC,QAAQ,GAAGP,WAAW,CACzBQ,CAA0C,IAAK;IAC9C,MAAMH,OAAO,GAAGG,CAAC,CAACC,WAAW,CAACC,aAAa,CAACC,CAAC;IAE7CP,UAAU,CAACQ,IAAI,IACbA,IAAI,CAACP,OAAO,KAAKA,OAAO,GACpBO,IAAI,GACJ;MAAE,GAAGA,IAAI;MAAEP;IAAQ,CACzB,CAAC;EACH,CAAC,EACD,EACF,CAAC;EAED,MAAMQ,QAAQ,GAAGb,WAAW,CACzBQ,CAAoB,IAAK;IACxB,MAAMF,MAAM,GAAGE,CAAC,CAACC,WAAW,CAACK,MAAM,CAACR,MAAM;IAE1CF,UAAU,CAACQ,IAAI,IACbA,IAAI,CAACN,MAAM,KAAKA,MAAM,GAClBM,IAAI,GACJ;MAAE,GAAGA,IAAI;MAAEN;IAAO,CACxB,CAAC;EACH,CAAC,EACD,EACF,CAAC;EAED,OAAO;IACLH,OAAO;IACPI,QAAQ;IACRM;EACF,CAAC;AACH","ignoreList":[]}

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

@@ -0,0 +1,5 @@
+export type NitroRecyclerViewProps = {
+    itemCount: number;
+};
+export declare const NitroRecyclerView: import("react-native").HostComponent<NitroRecyclerViewProps>;
+//# sourceMappingURL=NitroList.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"NitroList.d.ts","sourceRoot":"","sources":["../../../src/NitroList.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,sBAAsB,GAAG;IACnC,SAAS,EAAE,MAAM,CAAA;CAClB,CAAA;AAED,eAAO,MAAM,iBAAiB,8DACuC,CAAA"}

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

@@ -0,0 +1,9 @@
+export type ReusableView = {
+    /** Stable identity for React */
+    readonly key: string;
+    /** Current data index bound to this slot */
+    index: number;
+    /** Optional type (header, row, etc — future) */
+    type?: string;
+};
+//# sourceMappingURL=ReusableView.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ReusableView.d.ts","sourceRoot":"","sources":["../../../src/ReusableView.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,YAAY,GAAG;IACzB,gCAAgC;IAChC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IAEpB,4CAA4C;IAC5C,KAAK,EAAE,MAAM,CAAA;IAEb,gDAAgD;IAChD,IAAI,CAAC,EAAE,MAAM,CAAA;CACd,CAAA"}

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

@@ -0,0 +1,22 @@
+/**
+ * Physical reusable cell.
+ * Represents a single mounted view instance.
+ */
+export interface Cell {
+    /**
+     * Stable physical identity.
+     * Used as React key. NEVER changes.
+     */
+    readonly key: string;
+    /**
+     * Logical data index currently bound.
+     * Changes as the cell is recycled.
+     */
+    index: number;
+    /**
+     * 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

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

@@ -0,0 +1,27 @@
+import type { Cell } from './Cell';
+/**
+ * Manages physical cell reuse.
+ * Imperative and stateful by design.
+ * This is NOT React code.
+ */
+export declare class CellRecycler {
+    /**
+     * Active cells mapped by logical index.
+     */
+    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

@@ -0,0 +1 @@
+{"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/debug/useDebugOverlay.d.ts

@@ -0,0 +1,2 @@
+export declare function useDebugOverlay(enabled: boolean, visibleCount: number): void;
+//# sourceMappingURL=useDebugOverlay.d.ts.map

package/lib/typescript/src/debug/useDebugOverlay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDebugOverlay.d.ts","sourceRoot":"","sources":["../../../../src/debug/useDebugOverlay.ts"],"names":[],"mappings":"AAEA,wBAAgB,eAAe,CAC7B,OAAO,EAAE,OAAO,EAChB,YAAY,EAAE,MAAM,GACnB,IAAI,CAQN"}

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

@@ -0,0 +1,8 @@
+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 LayoutRect[], metrics: ScrollMetrics, bufferPx: number): readonly number[];
+//# sourceMappingURL=getVisibleIndices.d.ts.map

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

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

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

@@ -1,5 +1,2 @@
-import { type HybridRef } from 'react-native-nitro-modules';
-import type { NitroListProps, NitroListMethods } from './specs/nitro-list.nitro';
-export declare const NitroList: import("react-native-nitro-modules").ReactNativeView<NitroListProps, NitroListMethods>;
-export type NitroListRef = HybridRef<NitroListProps, NitroListMethods>;
+export { RecyclerList } from './recycler/RecyclerList';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoB,KAAK,SAAS,EAAE,MAAM,4BAA4B,CAAA;AAE7E,OAAO,KAAK,EACV,cAAc,EACd,gBAAgB,EACjB,MAAM,0BAA0B,CAAA;AAGjC,eAAO,MAAM,SAAS,wFAGrB,CAAA;AAED,MAAM,MAAM,YAAY,GAAG,SAAS,CAAC,cAAc,EAAE,gBAAgB,CAAC,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAA"}

package/lib/typescript/src/layout/MutableLinearLayout.d.ts

@@ -0,0 +1,54 @@
+import type { Axis } from '../types/Axis';
+import type { LinearLayoutInput } from '../types/layout';
+import type { LayoutRect } from '../types/layout/LayoutRect';
+/**
+ * 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 declare class MutableLinearLayout {
+    private readonly isVertical;
+    /** Absolute item layouts in index order */
+    private layouts;
+    /** Total scrollable size along main axis */
+    private contentSize;
+    constructor(axis: Axis);
+    /**
+     * 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: LinearLayoutInput): void;
+    /**
+     * Returns computed item layouts.
+     *
+     * Order is guaranteed monotonic along the main axis,
+     * which is required for binary-search-based windowing.
+     */
+    getLayouts(): readonly LayoutRect[];
+    /**
+     * Returns total scrollable size along the main axis,
+     * including padding and inter-item spacing.
+     */
+    getContentSize(): number;
+    /**
+     * Clears internal layout state.
+     * Call on severe invalidation or teardown.
+     */
+    reset(): void;
+}
+//# sourceMappingURL=MutableLinearLayout.d.ts.map

package/lib/typescript/src/layout/MutableLinearLayout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MutableLinearLayout.d.ts","sourceRoot":"","sources":["../../../../src/layout/MutableLinearLayout.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,eAAe,CAAA;AACzC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAA;AACxD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAA;AAI5D;;;;;;;;;;;;GAYG;AACH,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IAEpC,2CAA2C;IAC3C,OAAO,CAAC,OAAO,CAAmB;IAElC,4CAA4C;IAC5C,OAAO,CAAC,WAAW,CAAI;gBAEX,IAAI,EAAE,IAAI;IAItB;;;;;;;;;;OAUG;IACH,OAAO,CAAC,KAAK,EAAE,iBAAiB,GAAG,IAAI;IA0CvC;;;;;OAKG;IACH,UAAU,IAAI,SAAS,UAAU,EAAE;IAInC;;;OAGG;IACH,cAAc,IAAI,MAAM;IAIxB;;;OAGG;IACH,KAAK,IAAI,IAAI;CAId"}

package/lib/typescript/src/layout/constants/layoutDefaults.d.ts

@@ -0,0 +1,13 @@
+/**
+ * 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 declare const DEFAULT_ITEM_SPACING = 12;
+//# sourceMappingURL=layoutDefaults.d.ts.map

package/lib/typescript/src/layout/constants/layoutDefaults.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"layoutDefaults.d.ts","sourceRoot":"","sources":["../../../../../src/layout/constants/layoutDefaults.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,eAAO,MAAM,oBAAoB,KAAK,CAAA"}

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

@@ -0,0 +1,2 @@
+export type { MutableLinearLayout } from './MutableLinearLayout';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/layout/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAA"}

package/lib/typescript/src/measurement/MeasureLayout.d.ts

@@ -0,0 +1,10 @@
+import type { LayoutChangeEvent } from 'react-native';
+export interface MeasuredLayout {
+    readonly width: number;
+    readonly height: number;
+}
+/**
+ * Extracts stable layout measurements from RN onLayout event.
+ */
+export declare function measureLayout(event: LayoutChangeEvent): MeasuredLayout;
+//# sourceMappingURL=MeasureLayout.d.ts.map

package/lib/typescript/src/measurement/MeasureLayout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MeasureLayout.d.ts","sourceRoot":"","sources":["../../../../src/measurement/MeasureLayout.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAA;AAErD,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CACxB;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC3B,KAAK,EAAE,iBAAiB,GACvB,cAAc,CAOhB"}

package/lib/typescript/src/measurement/useItemMeasurement.d.ts

@@ -0,0 +1,11 @@
+import type { LayoutChangeEvent } from 'react-native';
+/**
+ * Hook to measure a rendered item safely.
+ *
+ * Guarantees:
+ * - No duplicate height reports
+ * - No render loops
+ * - Stable callback identity
+ */
+export declare function useItemMeasurement(index: number, onMeasured: (index: number, height: number) => void): (e: LayoutChangeEvent) => void;
+//# sourceMappingURL=useItemMeasurement.d.ts.map

package/lib/typescript/src/measurement/useItemMeasurement.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useItemMeasurement.d.ts","sourceRoot":"","sources":["../../../../src/measurement/useItemMeasurement.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAA;AAErD;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI,OAK7C,iBAAiB,UAaxB"}

package/lib/typescript/src/native/NitroLayoutEngine.d.ts

@@ -0,0 +1,3 @@
+import type { NitroLayoutEngine as NitroLayoutEngineSpec } from '../specs/nitro-layout-engine.nitro';
+export declare const NitroLayoutEngine: NitroLayoutEngineSpec;
+//# sourceMappingURL=NitroLayoutEngine.d.ts.map

package/lib/typescript/src/native/NitroLayoutEngine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NitroLayoutEngine.d.ts","sourceRoot":"","sources":["../../../../src/native/NitroLayoutEngine.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,IAAI,qBAAqB,EAAE,MAAM,oCAAoC,CAAA;AAEpG,eAAO,MAAM,iBAAiB,uBAG3B,CAAA"}

package/lib/typescript/src/native/NitroList.types.d.ts

@@ -0,0 +1,9 @@
+import type { LayoutRect } from "../types/layout";
+/**
+ * JS runtime interface backed by Nitro (JSI).
+ * Must match native HybridNitroList exactly.
+ */
+export interface NitroList {
+    computeLayout(containerWidth: number, itemHeights: readonly number[]): readonly LayoutRect[];
+}
+//# sourceMappingURL=NitroList.types.d.ts.map

package/lib/typescript/src/native/NitroList.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NitroList.types.d.ts","sourceRoot":"","sources":["../../../../src/native/NitroList.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAGlD;;;GAGG;AACH,MAAM,WAAW,SAAS;IACxB,aAAa,CACX,cAAc,EAAE,MAAM,EACtB,WAAW,EAAE,SAAS,MAAM,EAAE,GAC7B,SAAS,UAAU,EAAE,CAAA;CACzB"}

package/lib/typescript/src/native/NitroRecyclerView.d.ts

@@ -0,0 +1,5 @@
+export type NitroRecyclerViewProps = {
+    itemCount: number;
+};
+export declare const NitroRecyclerView: import("react-native").HostComponent<NitroRecyclerViewProps>;
+//# sourceMappingURL=NitroRecyclerView.d.ts.map

package/lib/typescript/src/native/NitroRecyclerView.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NitroRecyclerView.d.ts","sourceRoot":"","sources":["../../../../src/native/NitroRecyclerView.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,sBAAsB,GAAG;IACnC,SAAS,EAAE,MAAM,CAAA;CAClB,CAAA;AAED,eAAO,MAAM,iBAAiB,8DACuC,CAAA"}

package/lib/typescript/src/prefetch/PrefetchHelper.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Callback invoked when new items should be prefetched.
+ */
+export type PrefetchCallback = (indices: number[]) => void;
+/**
+ * PrefetchHelper
+ *
+ * Stateless with respect to layout.
+ * Only tracks what has already been prefetched to avoid duplication.
+ *
+ * Designed to be driven by *visible window*, not scroll events.
+ */
+export declare class PrefetchHelper {
+    private lastPrefetched;
+    runPrefetch(visibleIndices: readonly number[], itemCount: number, aheadCount: number, onPrefetch: PrefetchCallback): void;
+}
+//# sourceMappingURL=PrefetchHelper.d.ts.map

package/lib/typescript/src/prefetch/PrefetchHelper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PrefetchHelper.d.ts","sourceRoot":"","sources":["../../../../src/prefetch/PrefetchHelper.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,IAAI,CAAA;AAE1D;;;;;;;GAOG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,cAAc,CAAoB;IAE1C,WAAW,CACT,cAAc,EAAE,SAAS,MAAM,EAAE,EACjC,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,gBAAgB;CA0B/B"}

package/lib/typescript/src/recycler/CellPool.d.ts

@@ -0,0 +1,14 @@
+import type { CellType } from '../types/CellType';
+import type { RecyclerCellInstance } from '../types/recycler';
+export declare class CellPool {
+    private readonly pools;
+    private readonly maxPerType;
+    /** ✅ NEW: check if a type is registered */
+    hasType(type: CellType): boolean;
+    registerType(type: CellType, maxCount: number): void;
+    acquire(type: CellType): RecyclerCellInstance | null;
+    release(cell: RecyclerCellInstance): void;
+    clear(): void;
+    getPoolSize(type: CellType): number;
+}
+//# sourceMappingURL=CellPool.d.ts.map

package/lib/typescript/src/recycler/CellPool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CellPool.d.ts","sourceRoot":"","sources":["../../../../src/recycler/CellPool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAA;AACjD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAA;AAE7D,qBAAa,QAAQ;IACnB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA8C;IACpE,OAAO,CAAC,QAAQ,CAAC,UAAU,CAA8B;IAEzD,2CAA2C;IAC3C,OAAO,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO;IAIhC,YAAY,CAAC,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI;IAMpD,OAAO,CAAC,IAAI,EAAE,QAAQ,GAAG,oBAAoB,GAAG,IAAI;IAMpD,OAAO,CAAC,IAAI,EAAE,oBAAoB,GAAG,IAAI;IAazC,KAAK,IAAI,IAAI;IAMb,WAAW,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM;CAGpC"}

package/lib/typescript/src/recycler/RecyclerList.d.ts

@@ -0,0 +1,4 @@
+import React from 'react';
+import type { RecyclerListProps } from '../types/recycler';
+export declare function RecyclerList<T>(props: RecyclerListProps<T>): React.ReactElement;
+//# sourceMappingURL=RecyclerList.d.ts.map

package/lib/typescript/src/recycler/RecyclerList.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RecyclerList.d.ts","sourceRoot":"","sources":["../../../../src/recycler/RecyclerList.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAsC,MAAM,OAAO,CAAA;AAU1D,OAAO,KAAK,EAEV,iBAAiB,EAClB,MAAM,mBAAmB,CAAA;AAmB1B,wBAAgB,YAAY,CAAC,CAAC,EAC5B,KAAK,EAAE,iBAAiB,CAAC,CAAC,CAAC,GAC1B,KAAK,CAAC,YAAY,CAmQpB"}

package/lib/typescript/src/specs/nitro-layout-engine.nitro.d.ts

@@ -0,0 +1,14 @@
+import type { HybridObject } from 'react-native-nitro-modules';
+export interface LayoutRect {
+    readonly x: number;
+    readonly y: number;
+    readonly width: number;
+    readonly height: number;
+}
+export interface NitroLayoutEngine extends HybridObject<{
+    ios: 'swift';
+    android: 'kotlin';
+}> {
+    computeLayout(containerWidth: number, itemHeights: readonly number[]): readonly LayoutRect[];
+}
+//# sourceMappingURL=nitro-layout-engine.nitro.d.ts.map

package/lib/typescript/src/specs/nitro-layout-engine.nitro.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nitro-layout-engine.nitro.d.ts","sourceRoot":"","sources":["../../../../src/specs/nitro-layout-engine.nitro.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAA;AAE9D,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAA;IAClB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAA;IAClB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CACxB;AAED,MAAM,WAAW,iBACf,SAAQ,YAAY,CAAC;IAAE,GAAG,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,QAAQ,CAAA;CAAE,CAAC;IAEzD,aAAa,CACX,cAAc,EAAE,MAAM,EACtB,WAAW,EAAE,SAAS,MAAM,EAAE,GAC7B,SAAS,UAAU,EAAE,CAAA;CACzB"}

package/lib/typescript/src/types/Axis.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Axis along which scrolling and layout occur.
+ *
+ * Matches Flutter's Axis:
+ * - vertical   → Y axis
+ * - horizontal → X axis
+ *
+ * This is NOT gesture direction.
+ */
+export type Axis = 'vertical' | 'horizontal';
+//# sourceMappingURL=Axis.d.ts.map

package/lib/typescript/src/types/Axis.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Axis.d.ts","sourceRoot":"","sources":["../../../../src/types/Axis.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,MAAM,MAAM,IAAI,GAAG,UAAU,GAAG,YAAY,CAAA"}

package/lib/typescript/src/types/CellKey.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Stable identifier for a cell.
+ *
+ * Cross-platform equivalent:
+ * - Flutter: Key
+ * - Android: stableId
+ * - iOS: reuseIdentifier (logical)
+ */
+export type CellKey = string | number;
+//# sourceMappingURL=CellKey.d.ts.map

package/lib/typescript/src/types/CellKey.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CellKey.d.ts","sourceRoot":"","sources":["../../../../src/types/CellKey.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,MAAM,OAAO,GAAG,MAAM,GAAG,MAAM,CAAA"}

package/lib/typescript/src/types/CellType.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Logical cell type.
+ *
+ * Used to group compatible cells for recycling.
+ *
+ * Cross-platform equivalent:
+ * - Android: viewType
+ * - iOS: reuseIdentifier
+ */
+export type CellType = string | number;
+//# sourceMappingURL=CellType.d.ts.map

package/lib/typescript/src/types/CellType.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CellType.d.ts","sourceRoot":"","sources":["../../../../src/types/CellType.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,MAAM,CAAA"}

package/lib/typescript/src/types/VisibleRange.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Visible item index range.
+ *
+ * Indices are inclusive.
+ */
+export interface VisibleRange {
+    readonly startIndex: number;
+    readonly endIndex: number;
+}
+//# sourceMappingURL=VisibleRange.d.ts.map

package/lib/typescript/src/types/VisibleRange.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"VisibleRange.d.ts","sourceRoot":"","sources":["../../../../src/types/VisibleRange.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;CAC1B"}