react-native-nitro-list 0.1.1 → 0.1.3

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"}

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

@@ -1,3 +1,4 @@
-export { RecyclerList } from './RecyclerList';
-export type { RecyclerListProps } from './RecyclerList.types';
+export * from './native/NitroListView';
+export * from './specs/NitroList.nitro';
+export { default as NitroList } from './recycler/NitroList';
 //# 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":"AAEA,cAAc,wBAAwB,CAAC;AAEvC,cAAc,yBAAyB,CAAC;AAExC,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,sBAAsB,CAAC"}

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/NitroListView.d.ts

@@ -0,0 +1,20 @@
+import { type ViewProps } from 'react-native';
+/**
+ * Props for the NitroListView.
+ * * We extend ViewProps so that developers can use standard styles
+ * like 'flex: 1' or 'backgroundColor' on the list.
+ */
+export type NitroListViewProps = ViewProps & {
+    /**
+     * The total number of items to be displayed in the list.
+     * This is passed to the native side (Swift/Kotlin) for layout math.
+     */
+    itemCount: number;
+};
+/**
+ * The Native Component that maps to the physical view in Swift/Kotlin.
+ * * 'NitroListView' is the "Secret Handshake" name. It must match
+ * the name exported by your Native ViewManagers.
+ */
+export declare const NitroListView: import("react-native").HostComponent<NitroListViewProps>;
+//# sourceMappingURL=NitroListView.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"NitroListView.d.ts","sourceRoot":"","sources":["../../../../src/native/NitroListView.ts"],"names":[],"mappings":"AAAA,OAAO,EAA0B,KAAK,SAAS,EAAE,MAAM,cAAc,CAAA;AAErE;;;;GAIG;AACH,MAAM,MAAM,kBAAkB,GAAG,SAAS,GAAG;IAC3C;;;OAGG;IACH,SAAS,EAAE,MAAM,CAAA;CAClB,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,aAAa,0DACmC,CAAA"}

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

@@ -0,0 +1,11 @@
+import type { RecyclerCell } from '../types/recycler/RecyclerCell';
+import type { CellType } from '../types/CellType';
+export declare class CellPool<T extends RecyclerCell<any>> {
+    private readonly pools;
+    private readonly maxPerType;
+    hasType(type: CellType): boolean;
+    registerType(type: CellType, maxCount: number): void;
+    acquire(type: CellType): T | null;
+    release(cell: T): void;
+}
+//# 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,YAAY,EAAE,MAAM,gCAAgC,CAAA;AAClE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAA;AAEjD,qBAAa,QAAQ,CAAC,CAAC,SAAS,YAAY,CAAC,GAAG,CAAC;IAC/C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA2B;IACjD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAA8B;IAEzD,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,CAAC,GAAG,IAAI;IAMjC,OAAO,CAAC,IAAI,EAAE,CAAC,GAAG,IAAI;CASvB"}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"NitroList.d.ts","sourceRoot":"","sources":["../../../../src/recycler/NitroList.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAsC,MAAM,OAAO,CAAA;AAW1D,OAAO,KAAK,EAAgB,cAAc,EAAE,MAAM,mBAAmB,CAAA;AA0BrE,MAAM,CAAC,OAAO,UAAU,SAAS,CAAC,CAAC,EACjC,KAAK,EAAE,cAAc,CAAC,CAAC,CAAC,GACvB,KAAK,CAAC,YAAY,CA6QpB"}

package/lib/typescript/src/scroll/useScrollVelocity.d.ts

@@ -0,0 +1,2 @@
+export declare function createScrollVelocityTracker(): (offset: number) => number;
+//# sourceMappingURL=useScrollVelocity.d.ts.map

package/lib/typescript/src/scroll/useScrollVelocity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useScrollVelocity.d.ts","sourceRoot":"","sources":["../../../../src/scroll/useScrollVelocity.ts"],"names":[],"mappings":"AAAA,wBAAgB,2BAA2B,KAIb,QAAQ,MAAM,KAAG,MAAM,CAWpD"}

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

@@ -0,0 +1,26 @@
+import type { HybridObject } from 'react-native-nitro-modules';
+/**
+ * Represents the physical area an item occupies on the screen.
+ * Standard: 'Layout' suffix tells the user this is a data object, not a logic object.
+ */
+export interface ItemLayout {
+    readonly x: number;
+    readonly y: number;
+    readonly width: number;
+    readonly height: number;
+}
+/**
+ * The high-performance layout engine for NitroList.
+ * This interface will be used by Nitro to generate your Swift and Kotlin code.
+ */
+export interface NitroList extends HybridObject<{
+    ios: 'swift';
+    android: 'kotlin';
+}> {
+    /**
+     * Calculates exactly where every item should sit on the screen.
+     * Standard: Use descriptive parameter names so developers know what to provide.
+     */
+    computeLayout(containerWidth: number, itemHeights: readonly number[]): readonly ItemLayout[];
+}
+//# sourceMappingURL=NitroList.nitro.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"NitroList.nitro.d.ts","sourceRoot":"","sources":["../../../../src/specs/NitroList.nitro.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAA;AAE9D;;;GAGG;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;AAED;;;GAGG;AACH,MAAM,WAAW,SACf,SAAQ,YAAY,CAAC;IAAE,GAAG,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,QAAQ,CAAA;CAAE,CAAC;IAEzD;;;OAGG;IACH,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,2 @@
+export type CellKey = 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":"AACA,MAAM,MAAM,OAAO,GAAG,MAAM,CAAA"}

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

@@ -0,0 +1,22 @@
+/**
+ * Logical cell type.
+ *
+ * Used to group compatible cells for recycling.
+ *
+ * Cross-platform equivalent:
+ * - Android: viewType
+ * - iOS: reuseIdentifier
+ *
+ * NOTE:
+ * This is a branded type to prevent accidental mixing
+ * with keys, indexes, or other strings/numbers.
+ */
+export type CellType = string & {
+    readonly __cellTypeBrand: unique symbol;
+};
+/**
+ * Helper to create a CellType safely.
+ * Keeps ergonomics simple for users.
+ */
+export declare const createCellType: (value: string) => CellType;
+//# 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;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG;IAC9B,QAAQ,CAAC,eAAe,EAAE,OAAO,MAAM,CAAA;CACxC,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,cAAc,GACzB,OAAO,MAAM,KACZ,QAA6B,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/CellPool.d.ts

@@ -0,0 +1,16 @@
+import type { CellType } from "../CellType";
+import type { RecyclerCell } from "./RecyclerCell";
+/**
+ * Owns recycled physical cells.
+ * Enforces hard caps.
+ */
+export declare class CellPool<T extends RecyclerCell> {
+    private readonly pools;
+    private readonly maxPerType;
+    hasType(type: CellType): boolean;
+    registerType(type: CellType, maxCount: number): void;
+    acquire(type: CellType): T | null;
+    release(cell: T): void;
+    clear(): void;
+}
+//# sourceMappingURL=CellPool.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"CellPool.d.ts","sourceRoot":"","sources":["../../../../../src/types/recycler/CellPool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AAC3C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAGlD;;;GAGG;AACH,qBAAa,QAAQ,CAAC,CAAC,SAAS,YAAY;IAC1C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA2B;IACjD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAA8B;IAEzD,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,CAAC,GAAG,IAAI;IAMjC,OAAO,CAAC,IAAI,EAAE,CAAC,GAAG,IAAI;IAWtB,KAAK,IAAI,IAAI;CAKd"}

package/lib/typescript/src/types/recycler/NitroListProps.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 NitroList.
+ *
+ * Generic, data-driven, layout-deterministic API.
+ * This surface is intentionally minimal and stable.
+ */
+export interface NitroListProps<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=NitroListProps.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"NitroListProps.d.ts","sourceRoot":"","sources":["../../../../../src/types/recycler/NitroListProps.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,cAAc,CAAC,CAAC;IAC/B;;;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/RecyclerCell.d.ts

@@ -0,0 +1,12 @@
+import type { CellType } from '../CellType';
+import type { CellKey } from '../CellKey';
+/**
+ * Public contract for a physical recycler cell.
+ * Key type MUST be generic / opaque.
+ */
+export interface RecyclerCell<K = CellKey> {
+    readonly key: K;
+    readonly type: CellType;
+    index: number;
+}
+//# sourceMappingURL=RecyclerCell.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"RecyclerCell.d.ts","sourceRoot":"","sources":["../../../../../src/types/recycler/RecyclerCell.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AAC3C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAA;AAEzC;;;GAGG;AACH,MAAM,WAAW,YAAY,CAAC,CAAC,GAAG,OAAO;IACvC,QAAQ,CAAC,GAAG,EAAE,CAAC,CAAA;IACf,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAA;IACvB,KAAK,EAAE,MAAM,CAAA;CACd"}