react-native-nitro-list 0.1.1 → 0.1.2

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

@@ -1,3 +1,2 @@
-export { RecyclerList } from './RecyclerList';
-export type { RecyclerListProps } from './RecyclerList.types';
+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,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAC7C,YAAY,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,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

@@ -1,22 +1,54 @@
-import type { LayoutRectangle } from './LayoutRectangle';
+import type { Axis } from '../types/Axis';
+import type { LinearLayoutInput } from '../types/layout';
+import type { LayoutRect } from '../types/layout/LayoutRect';
 /**
- * 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 declare class MutableLinearLayout {
-    private readonly layouts;
-    private totalHeight;
-    constructor(initialHeights: readonly number[], width: number);
+    private readonly isVertical;
+    /** Absolute item layouts in index order */
+    private layouts;
+    /** Total scrollable size along main axis */
+    private contentSize;
+    constructor(axis: Axis);
     /**
-     * Read-only snapshot for consumers.
-     * Returned type is immutable.
+     * 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
      */
-    getLayouts(): readonly LayoutRectangle[];
-    getContentHeight(): number;
+    compute(input: LinearLayoutInput): void;
     /**
-     * Update height of one item and shift following items.
-     * Returns true if layout changed.
+     * Returns computed item layouts.
+     *
+     * Order is guaranteed monotonic along the main axis,
+     * which is required for binary-search-based windowing.
      */
-    updateItemHeight(index: number, newHeight: number): boolean;
+    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

@@ -1 +1 @@
-{"version":3,"file":"MutableLinearLayout.d.ts","sourceRoot":"","sources":["../../../../src/layout/MutableLinearLayout.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA;AAaxD;;;GAGG;AACH,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA0B;IAClD,OAAO,CAAC,WAAW,CAAQ;gBAGzB,cAAc,EAAE,SAAS,MAAM,EAAE,EACjC,KAAK,EAAE,MAAM;IAkBf;;;OAGG;IACH,UAAU,IAAI,SAAS,eAAe,EAAE;IAIxC,gBAAgB,IAAI,MAAM;IAI1B;;;OAGG;IACH,gBAAgB,CACd,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,MAAM,GAChB,OAAO;CAkBX"}
+{"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

@@ -1,5 +1,2 @@
-export type { LayoutRectangle } from './LayoutRectangle';
-export type { LayoutProvider } from './LayoutProvider';
-export { EstimatedLayoutProvider } from './EstimatedLayoutProvider';
-export { computeLayouts } from './LayoutEngine';
+export type { MutableLinearLayout } from './MutableLinearLayout';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/layout/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA;AACxD,YAAY,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AACtD,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAA;AACnE,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAA"}
+{"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/native/NitroList.types.d.ts

@@ -1,9 +1,9 @@
-import type { LayoutRectangle } from '../layout/LayoutRectangle';
+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 LayoutRectangle[];
+    computeLayout(containerWidth: number, itemHeights: readonly number[]): readonly LayoutRect[];
 }
 //# sourceMappingURL=NitroList.types.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"NitroList.types.d.ts","sourceRoot":"","sources":["../../../../src/native/NitroList.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAA;AAEhE;;;GAGG;AACH,MAAM,WAAW,SAAS;IACxB,aAAa,CACX,cAAc,EAAE,MAAM,EACtB,WAAW,EAAE,SAAS,MAAM,EAAE,GAC7B,SAAS,eAAe,EAAE,CAAA;CAC9B"}
+{"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/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

@@ -1,5 +1,5 @@
 import type { HybridObject } from 'react-native-nitro-modules';
-export interface LayoutRectangle {
+export interface LayoutRect {
     readonly x: number;
     readonly y: number;
     readonly width: number;
@@ -9,6 +9,6 @@ export interface NitroLayoutEngine extends HybridObject<{
     ios: 'swift';
     android: 'kotlin';
 }> {
-    computeLayout(containerWidth: number, itemHeights: readonly number[]): readonly LayoutRectangle[];
+    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

@@ -1 +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,eAAe;IAC9B,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,eAAe,EAAE,CAAA;CAC9B"}
+{"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"}

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

@@ -0,0 +1,35 @@
+import type { LayoutRect } from './layout/LayoutRect';
+/**
+ * Input required to compute the visible item range.
+ *
+ * Pure contract:
+ * - No logic
+ * - No platform assumptions
+ * - Safe to share with native / tests
+ */
+export interface VisibleRangeInput {
+    /**
+     * Ordered, monotonic layouts along the main axis.
+     * Required for binary search correctness.
+     */
+    readonly layouts: readonly LayoutRect[];
+    /**
+     * Scroll offset along the main axis.
+     */
+    readonly offset: number;
+    /**
+     * Viewport size along the main axis.
+     */
+    readonly viewportSize: number;
+    /**
+     * Extra buffer before and after the viewport.
+     */
+    readonly buffer: number;
+    /**
+     * Axis selector.
+     * true  → vertical
+     * false → horizontal
+     */
+    readonly isVertical: boolean;
+}
+//# sourceMappingURL=VisibleRangeInput.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"VisibleRangeInput.d.ts","sourceRoot":"","sources":["../../../../src/types/VisibleRangeInput.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAA;AAErD;;;;;;;GAOG;AACH,MAAM,WAAW,iBAAiB;IAChC;;;OAGG;IACH,QAAQ,CAAC,OAAO,EAAE,SAAS,UAAU,EAAE,CAAA;IAEvC;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IAEvB;;OAEG;IACH,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IAE7B;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IAEvB;;;;OAIG;IACH,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAA;CAC7B"}

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

@@ -0,0 +1,8 @@
+export type { Axis } from './Axis';
+export type { MainAxisPadding, } from './layout/MainAxisPadding';
+export { ZERO_MAIN_AXIS_PADDING, } from './layout/MainAxisPadding';
+export type { LayoutRect } from './layout/LayoutRect';
+export type { VisibleRange } from './VisibleRange';
+export type { CellKey } from './CellKey';
+export type { CellType } from './CellType';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/types/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAA;AAElC,YAAY,EACV,eAAe,GAChB,MAAM,0BAA0B,CAAA;AACjC,OAAO,EACL,sBAAsB,GACvB,MAAM,0BAA0B,CAAA;AAEjC,YAAY,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAA;AACrD,YAAY,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAClD,YAAY,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AACxC,YAAY,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA"}

package/lib/typescript/src/types/layout/LayoutRect.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Absolute layout rectangle.
+ *
+ * Cross-platform equivalent of:
+ * - Flutter: Rect
+ * - Android: Rect
+ * - iOS: CGRect
+ */
+export interface LayoutRect {
+    readonly x: number;
+    readonly y: number;
+    readonly width: number;
+    readonly height: number;
+}
+//# sourceMappingURL=LayoutRect.d.ts.map

package/lib/typescript/src/types/layout/LayoutRect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LayoutRect.d.ts","sourceRoot":"","sources":["../../../../../src/types/layout/LayoutRect.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,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"}

package/lib/typescript/src/types/layout/LinearLayoutInput.d.ts

@@ -0,0 +1,10 @@
+import type { MainAxisPadding } from './MainAxisPadding';
+export interface LinearLayoutInput {
+    readonly crossAxisSize: number;
+    readonly itemMainAxisSizes: readonly number[];
+    /** Padding before/after content (main axis) */
+    readonly padding: MainAxisPadding;
+    /** Space BETWEEN items (main axis) */
+    readonly itemSpacing?: number;
+}
+//# sourceMappingURL=LinearLayoutInput.d.ts.map

package/lib/typescript/src/types/layout/LinearLayoutInput.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LinearLayoutInput.d.ts","sourceRoot":"","sources":["../../../../../src/types/layout/LinearLayoutInput.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA;AAExD,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAA;IAC9B,QAAQ,CAAC,iBAAiB,EAAE,SAAS,MAAM,EAAE,CAAA;IAE7C,+CAA+C;IAC/C,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAA;IAEjC,sCAAsC;IACtC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAC9B"}

package/lib/typescript/src/types/layout/MainAxisPadding.d.ts

@@ -0,0 +1,20 @@
+/**
+ * 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 declare const ZERO_MAIN_AXIS_PADDING: MainAxisPadding;
+//# sourceMappingURL=MainAxisPadding.d.ts.map

package/lib/typescript/src/types/layout/MainAxisPadding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MainAxisPadding.d.ts","sourceRoot":"","sources":["../../../../../src/types/layout/MainAxisPadding.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;CACrB;AAED;;;GAGG;AACH,eAAO,MAAM,sBAAsB,EAAE,eAGpC,CAAA"}

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

@@ -0,0 +1,4 @@
+export type { LayoutRect } from './LayoutRect';
+export type { LinearLayoutInput } from './LinearLayoutInput';
+export type { MainAxisPadding } from './MainAxisPadding';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/types/layout/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AAC9C,YAAY,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAA;AAC5D,YAAY,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA"}

package/lib/typescript/src/types/recycler/RecyclerCellInstance.d.ts

@@ -0,0 +1,37 @@
+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;
+}
+//# sourceMappingURL=RecyclerCellInstance.d.ts.map

package/lib/typescript/src/types/recycler/RecyclerCellInstance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RecyclerCellInstance.d.ts","sourceRoot":"","sources":["../../../../../src/types/recycler/RecyclerCellInstance.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAA;AACzC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AAG3C;;;;;;;;;;GAUG;AACH,MAAM,WAAW,oBAAoB;IACnC;;;;;OAKG;IACH,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAA;IAErB;;;;;OAKG;IACH,KAAK,EAAE,MAAM,CAAA;IAEb;;;;;OAKG;IACH,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAA;CACxB"}

package/lib/typescript/src/types/recycler/RecyclerItemRenderer.d.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;
+//# sourceMappingURL=RecyclerItemRenderer.d.ts.map

package/lib/typescript/src/types/recycler/RecyclerItemRenderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RecyclerItemRenderer.d.ts","sourceRoot":"","sources":["../../../../../src/types/recycler/RecyclerItemRenderer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AACtC,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAA;AAElE,MAAM,MAAM,oBAAoB,CAAC,CAAC,IAAI,CAAC,MAAM,EAAE;IAC7C,IAAI,EAAE,CAAC,CAAA;IACP,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,oBAAoB,CAAA;CAC3B,KAAK,SAAS,CAAA"}

package/lib/typescript/src/types/recycler/RecyclerListProps.d.ts

@@ -0,0 +1,66 @@
+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>;
+}
+//# sourceMappingURL=RecyclerListProps.d.ts.map

package/lib/typescript/src/types/recycler/RecyclerListProps.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RecyclerListProps.d.ts","sourceRoot":"","sources":["../../../../../src/types/recycler/RecyclerListProps.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,SAAS,CAAA;AACnC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AAC3C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,WAAW,CAAA;AAChD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAA;AAElE;;;;;GAKG;AACH,MAAM,WAAW,iBAAiB,CAAC,CAAC;IAClC;;;OAGG;IACH,QAAQ,CAAC,eAAe,CAAC,EAAE,IAAI,CAAA;IAE/B;;;;;;OAMG;IACH,QAAQ,CAAC,sBAAsB,EAAE,MAAM,CAAA;IAEvC;;;OAGG;IACH,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC,EAAE,CAAA;IAE3B;;;;;;OAMG;IACH,QAAQ,CAAC,iBAAiB,EAAE,SAAS,MAAM,EAAE,CAAA;IAE7C;;;;OAIG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,eAAe,CAAA;IAElC;;;;OAIG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;IAE7B;;;OAGG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;IAE7B;;;OAGG;IACH,QAAQ,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,KAAK,QAAQ,CAAA;IAE1D;;;OAGG;IACH,QAAQ,CAAC,UAAU,EAAE,oBAAoB,CAAC,CAAC,CAAC,CAAA;CAC7C"}

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

@@ -0,0 +1,4 @@
+export type { RecyclerListProps } from './RecyclerListProps';
+export type { RecyclerItemRenderer } from './RecyclerItemRenderer';
+export type { RecyclerCellInstance } from './RecyclerCellInstance';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/types/recycler/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAA;AAC5D,YAAY,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAA;AAClE,YAAY,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAA"}

package/lib/typescript/src/types/scroll/ScrollMetrics.d.ts

@@ -0,0 +1,15 @@
+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;
+}
+//# sourceMappingURL=ScrollMetrics.d.ts.map

package/lib/typescript/src/types/scroll/ScrollMetrics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ScrollMetrics.d.ts","sourceRoot":"","sources":["../../../../../src/types/scroll/ScrollMetrics.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,SAAS,CAAA;AAGnC;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC5B,kBAAkB;IAClB,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAA;IAEnB,iCAAiC;IACjC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IAEvB,wCAAwC;IACxC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;CAC9B"}

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

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

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

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

package/lib/typescript/src/windowing/computeVisibleItemRange.d.ts

@@ -0,0 +1,15 @@
+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 declare function computeVisibleItemRange(input: VisibleRangeInput): VisibleRange | null;
+//# sourceMappingURL=computeVisibleItemRange.d.ts.map

package/lib/typescript/src/windowing/computeVisibleItemRange.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"computeVisibleItemRange.d.ts","sourceRoot":"","sources":["../../../../src/windowing/computeVisibleItemRange.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAA;AACzD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAA;AAEnE;;;;;;;;;;GAUG;AACH,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,iBAAiB,GACvB,YAAY,GAAG,IAAI,CA6DrB"}

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

@@ -1,4 +1,4 @@
 export type { ScrollMetrics } from './ScrollMetrics';
-export { findVisibleIndexRange } from './findVisibleIndexRange';
 export { useScrollMetrics } from './useScrollMetrics';
+export { computeVisibleItemRange } from './computeVisibleItemRange';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/windowing/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AACpD,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAA;AAC/D,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/windowing/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AACpD,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AACrD,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAA"}

package/nitrogen/generated/android/c++/JHybridNitroLayoutEngineSpec.cpp

@@ -7,12 +7,12 @@
 
 #include "JHybridNitroLayoutEngineSpec.hpp"
 
-// Forward declaration of `LayoutRectangle` to properly resolve imports.
-namespace margelo::nitro::nitrolist { struct LayoutRectangle; }
+// Forward declaration of `LayoutRect` to properly resolve imports.
+namespace margelo::nitro::nitrolist { struct LayoutRect; }
 
-#include "LayoutRectangle.hpp"
+#include "LayoutRect.hpp"
 #include <vector>
-#include "JLayoutRectangle.hpp"
+#include "JLayoutRect.hpp"
 
 namespace margelo::nitro::nitrolist {
 
@@ -46,8 +46,8 @@ namespace margelo::nitro::nitrolist {
   
 
   // Methods
-  std::vector<LayoutRectangle> JHybridNitroLayoutEngineSpec::computeLayout(double containerWidth, const std::vector<double>& itemHeights) {
-    static const auto method = javaClassStatic()->getMethod<jni::local_ref<jni::JArrayClass<JLayoutRectangle>>(double /* containerWidth */, jni::alias_ref<jni::JArrayDouble> /* itemHeights */)>("computeLayout");
+  std::vector<LayoutRect> JHybridNitroLayoutEngineSpec::computeLayout(double containerWidth, const std::vector<double>& itemHeights) {
+    static const auto method = javaClassStatic()->getMethod<jni::local_ref<jni::JArrayClass<JLayoutRect>>(double /* containerWidth */, jni::alias_ref<jni::JArrayDouble> /* itemHeights */)>("computeLayout");
     auto __result = method(_javaPart, containerWidth, [&]() {
       size_t __size = itemHeights.size();
       jni::local_ref<jni::JArrayDouble> __array = jni::JArrayDouble::newArray(__size);
@@ -56,7 +56,7 @@ namespace margelo::nitro::nitrolist {
     }());
     return [&]() {
       size_t __size = __result->size();
-      std::vector<LayoutRectangle> __vector;
+      std::vector<LayoutRect> __vector;
       __vector.reserve(__size);
       for (size_t __i = 0; __i < __size; __i++) {
         auto __element = __result->getElement(__i);

package/nitrogen/generated/android/c++/JHybridNitroLayoutEngineSpec.hpp

@@ -54,7 +54,7 @@ namespace margelo::nitro::nitrolist {
 
   public:
     // Methods
-    std::vector<LayoutRectangle> computeLayout(double containerWidth, const std::vector<double>& itemHeights) override;
+    std::vector<LayoutRect> computeLayout(double containerWidth, const std::vector<double>& itemHeights) override;
 
   private:
     friend HybridBase;