react-native-nitro-list 0.0.1 → 0.1.1

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

@@ -0,0 +1,19 @@
+import type { Cell } from '../cell/Cell';
+import type { LayoutRectangle } from '../layout/LayoutRectangle';
+import type { ScrollMetrics } from '../windowing/ScrollMetrics';
+/**
+ * React bridge for CellRecycler.
+ * FlashList equivalent: useCellRenderer
+ *
+ * Responsibilities:
+ * - Translate scroll state → visible indices
+ * - Ask recycler for physical cells
+ * - Commit results with referential stability
+ *
+ * Responsibilities it does NOT have:
+ * ❌ Layout mutation
+ * ❌ Measurement
+ * ❌ Rendering
+ */
+export declare function useCellRenderer(layouts: readonly LayoutRectangle[], metrics: ScrollMetrics, bufferPx: number, getCellType: (index: number) => string): readonly Cell[];
+//# sourceMappingURL=useCellRenderer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useCellRenderer.d.ts","sourceRoot":"","sources":["../../../../src/hooks/useCellRenderer.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,cAAc,CAAA;AAGxC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAA;AAChE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAA;AAQ/D;;;;;;;;;;;;;GAaG;AACH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,SAAS,eAAe,EAAE,EACnC,OAAO,EAAE,aAAa,EACtB,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,GACrC,SAAS,IAAI,EAAE,CAqDjB"}

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

@@ -0,0 +1,2 @@
+export declare function useStableCallback<T extends (...args: never[]) => unknown>(fn: T): T;
+//# sourceMappingURL=useStableCallback.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useStableCallback.d.ts","sourceRoot":"","sources":["../../../../src/hooks/useStableCallback.ts"],"names":[],"mappings":"AAEA,wBAAgB,iBAAiB,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,KAAK,EAAE,KAAK,OAAO,EACvE,EAAE,EAAE,CAAC,GACJ,CAAC,CAQH"}

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

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

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

@@ -0,0 +1,15 @@
+import type { LayoutProvider } from './LayoutProvider';
+import type { LayoutRectangle } from './LayoutRectangle';
+/**
+ * Layout provider using estimated item heights.
+ * Used before real measurements are available.
+ */
+export declare class EstimatedLayoutProvider implements LayoutProvider {
+    private readonly itemCount;
+    private readonly itemHeight;
+    private readonly width;
+    constructor(itemCount: number, itemHeight: number, width: number);
+    getItemCount(): number;
+    getLayout(index: number): LayoutRectangle;
+}
+//# sourceMappingURL=EstimatedLayoutProvider.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"EstimatedLayoutProvider.d.ts","sourceRoot":"","sources":["../../../../src/layout/EstimatedLayoutProvider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AACtD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA;AAExD;;;GAGG;AACH,qBAAa,uBAAwB,YAAW,cAAc;IAC5D,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAQ;IAClC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAQ;IACnC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAQ;gBAG5B,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,MAAM;IAOf,YAAY,IAAI,MAAM;IAItB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,eAAe;CAQ1C"}

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

@@ -0,0 +1,10 @@
+import type { LayoutProvider } from './LayoutProvider';
+import type { LayoutRectangle } from './LayoutRectangle';
+/**
+ * Resolves layouts eagerly into a contiguous array.
+ * Pure, deterministic, and reusable.
+ *
+ * FlashList equivalent: internal layout resolver.
+ */
+export declare function computeLayouts(provider: LayoutProvider): readonly LayoutRectangle[];
+//# sourceMappingURL=LayoutEngine.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"LayoutEngine.d.ts","sourceRoot":"","sources":["../../../../src/layout/LayoutEngine.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AACtD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA;AAExD;;;;;GAKG;AACH,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,cAAc,GACvB,SAAS,eAAe,EAAE,CAS5B"}

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

@@ -0,0 +1,16 @@
+import type { LayoutRectangle } from './LayoutRectangle';
+/**
+ * Provides layout information for items.
+ * FlashList equivalent: LayoutProvider
+ */
+export interface LayoutProvider {
+    /**
+     * Total number of items
+     */
+    getItemCount(): number;
+    /**
+     * Layout rectangle for a given index
+     */
+    getLayout(index: number): LayoutRectangle;
+}
+//# sourceMappingURL=LayoutProvider.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"LayoutProvider.d.ts","sourceRoot":"","sources":["../../../../src/layout/LayoutProvider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA;AAExD;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B;;OAEG;IACH,YAAY,IAAI,MAAM,CAAA;IAEtB;;OAEG;IACH,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,eAAe,CAAA;CAC1C"}

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

@@ -0,0 +1,11 @@
+/**
+ * Immutable layout rectangle for a single item.
+ * Equivalent to FlashList's Layout.
+ */
+export interface LayoutRectangle {
+    readonly x: number;
+    readonly y: number;
+    readonly width: number;
+    readonly height: number;
+}
+//# sourceMappingURL=LayoutRectangle.d.ts.map

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

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

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

@@ -0,0 +1,22 @@
+import type { LayoutRectangle } from './LayoutRectangle';
+/**
+ * Mutable linear layout store.
+ * FlashList-style incremental relayout.
+ */
+export declare class MutableLinearLayout {
+    private readonly layouts;
+    private totalHeight;
+    constructor(initialHeights: readonly number[], width: number);
+    /**
+     * Read-only snapshot for consumers.
+     * Returned type is immutable.
+     */
+    getLayouts(): readonly LayoutRectangle[];
+    getContentHeight(): number;
+    /**
+     * Update height of one item and shift following items.
+     * Returns true if layout changed.
+     */
+    updateItemHeight(index: number, newHeight: number): boolean;
+}
+//# 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,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"}

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

@@ -0,0 +1,5 @@
+export type { LayoutRectangle } from './LayoutRectangle';
+export type { LayoutProvider } from './LayoutProvider';
+export { EstimatedLayoutProvider } from './EstimatedLayoutProvider';
+export { computeLayouts } from './LayoutEngine';
+//# 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,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"}

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 { LayoutRectangle } from '../layout/LayoutRectangle';
+/**
+ * JS runtime interface backed by Nitro (JSI).
+ * Must match native HybridNitroList exactly.
+ */
+export interface NitroList {
+    computeLayout(containerWidth: number, itemHeights: readonly number[]): readonly LayoutRectangle[];
+}
+//# 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,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"}

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/specs/nitro-layout-engine.nitro.d.ts

@@ -0,0 +1,14 @@
+import type { HybridObject } from 'react-native-nitro-modules';
+export interface LayoutRectangle {
+    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 LayoutRectangle[];
+}
+//# 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,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"}

package/lib/typescript/src/utils/arrayEqual.d.ts

@@ -0,0 +1,2 @@
+export declare function arrayEqual<T>(a: readonly T[], b: readonly T[]): boolean;
+//# sourceMappingURL=arrayEqual.d.ts.map

package/lib/typescript/src/utils/arrayEqual.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"arrayEqual.d.ts","sourceRoot":"","sources":["../../../../src/utils/arrayEqual.ts"],"names":[],"mappings":"AAAA,wBAAgB,UAAU,CAAC,CAAC,EAC1B,CAAC,EAAE,SAAS,CAAC,EAAE,EACf,CAAC,EAAE,SAAS,CAAC,EAAE,GACd,OAAO,CAST"}

package/lib/typescript/src/utils/assertNever.d.ts

@@ -0,0 +1,2 @@
+export declare function assertNever(x: never): never;
+//# sourceMappingURL=assertNever.d.ts.map

package/lib/typescript/src/utils/assertNever.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assertNever.d.ts","sourceRoot":"","sources":["../../../../src/utils/assertNever.ts"],"names":[],"mappings":"AAAA,wBAAgB,WAAW,CAAC,CAAC,EAAE,KAAK,GAAG,KAAK,CAE3C"}

package/lib/typescript/src/utils/clamp.d.ts

@@ -0,0 +1,2 @@
+export declare function clamp(value: number, min: number, max: number): number;
+//# sourceMappingURL=clamp.d.ts.map

package/lib/typescript/src/utils/clamp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clamp.d.ts","sourceRoot":"","sources":["../../../../src/utils/clamp.ts"],"names":[],"mappings":"AAAA,wBAAgB,KAAK,CACnB,KAAK,EAAE,MAAM,EACb,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,MAAM,GACV,MAAM,CAER"}

package/lib/typescript/src/utils/devAssert.d.ts

@@ -0,0 +1,2 @@
+export declare function devAssert(condition: boolean, message: string): void;
+//# sourceMappingURL=devAssert.d.ts.map

package/lib/typescript/src/utils/devAssert.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"devAssert.d.ts","sourceRoot":"","sources":["../../../../src/utils/devAssert.ts"],"names":[],"mappings":"AAAA,wBAAgB,SAAS,CACvB,SAAS,EAAE,OAAO,EAClB,OAAO,EAAE,MAAM,GACd,IAAI,CAIN"}

package/lib/typescript/src/utils/invariant.d.ts

@@ -0,0 +1,2 @@
+export declare function invariant(condition: unknown, message: string): asserts condition;
+//# sourceMappingURL=invariant.d.ts.map

package/lib/typescript/src/utils/invariant.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"invariant.d.ts","sourceRoot":"","sources":["../../../../src/utils/invariant.ts"],"names":[],"mappings":"AAAA,wBAAgB,SAAS,CACvB,SAAS,EAAE,OAAO,EAClB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,SAAS,CAInB"}

package/lib/typescript/src/utils/isDefined.d.ts

@@ -0,0 +1,2 @@
+export declare function isDefined<T>(value: T | undefined | null): value is T;
+//# sourceMappingURL=isDefined.d.ts.map

package/lib/typescript/src/utils/isDefined.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"isDefined.d.ts","sourceRoot":"","sources":["../../../../src/utils/isDefined.ts"],"names":[],"mappings":"AAAA,wBAAgB,SAAS,CAAC,CAAC,EACzB,KAAK,EAAE,CAAC,GAAG,SAAS,GAAG,IAAI,GAC1B,KAAK,IAAI,CAAC,CAEZ"}

package/lib/typescript/src/utils/isNumber.d.ts

@@ -0,0 +1,2 @@
+export declare function isNumber(value: unknown): value is number;
+//# sourceMappingURL=isNumber.d.ts.map

package/lib/typescript/src/utils/isNumber.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"isNumber.d.ts","sourceRoot":"","sources":["../../../../src/utils/isNumber.ts"],"names":[],"mappings":"AAAA,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAExD"}

package/lib/typescript/src/utils/noop.d.ts

@@ -0,0 +1,2 @@
+export declare function noop(): void;
+//# sourceMappingURL=noop.d.ts.map

package/lib/typescript/src/utils/noop.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"noop.d.ts","sourceRoot":"","sources":["../../../../src/utils/noop.ts"],"names":[],"mappings":"AAAA,wBAAgB,IAAI,IAAI,IAAI,CAE3B"}

package/lib/typescript/src/utils/shallowEqual.d.ts

@@ -0,0 +1,2 @@
+export declare function shallowEqual(a: unknown, b: unknown): boolean;
+//# sourceMappingURL=shallowEqual.d.ts.map

package/lib/typescript/src/utils/shallowEqual.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shallowEqual.d.ts","sourceRoot":"","sources":["../../../../src/utils/shallowEqual.ts"],"names":[],"mappings":"AAAA,wBAAgB,YAAY,CAC1B,CAAC,EAAE,OAAO,EACV,CAAC,EAAE,OAAO,GACT,OAAO,CA8BT"}

package/lib/typescript/src/utils/throttle.d.ts

@@ -0,0 +1,2 @@
+export declare function throttle<T extends (...args: never[]) => void>(fn: T, ms: number): T;
+//# sourceMappingURL=throttle.d.ts.map

package/lib/typescript/src/utils/throttle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"throttle.d.ts","sourceRoot":"","sources":["../../../../src/utils/throttle.ts"],"names":[],"mappings":"AAAA,wBAAgB,QAAQ,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,KAAK,EAAE,KAAK,IAAI,EAC3D,EAAE,EAAE,CAAC,EACL,EAAE,EAAE,MAAM,GACT,CAAC,CASH"}

package/lib/typescript/src/viewability/ViewabilityHelper.d.ts

@@ -0,0 +1,50 @@
+import type { LayoutRectangle } from '../layout/LayoutRectangle';
+import type { ScrollMetrics } from '../windowing/ScrollMetrics';
+/**
+ * Public token describing viewability state of an item.
+ * Mirrors FlashList's ViewToken concept.
+ */
+export type ViewToken = {
+    index: number;
+    isViewable: boolean;
+};
+/**
+ * Configuration for viewability calculations.
+ */
+export type ViewabilityConfig = {
+    /**
+     * Percentage (0–100) of item height that must be visible
+     * for the item to be considered "viewable".
+     */
+    itemVisiblePercentThreshold?: number;
+};
+/**
+ * ViewabilityHelper
+ *
+ * Pure observer:
+ * - Does NOT affect layout
+ * - Does NOT affect recycling
+ * - Computes visibility based on layout + scroll metrics
+ *
+ * This class is intentionally stateful (lastVisible)
+ * to compute "changed" items efficiently.
+ */
+export declare class ViewabilityHelper {
+    private readonly config;
+    /** Previously visible indices */
+    private lastVisible;
+    constructor(config?: ViewabilityConfig);
+    /**
+     * Computes which items are viewable and which changed
+     * since the last invocation.
+     *
+     * IMPORTANT:
+     * - This method should be called AFTER windowing,
+     *   not on the full dataset.
+     */
+    computeViewableItems(layouts: readonly LayoutRectangle[], metrics: ScrollMetrics): {
+        viewableItems: ViewToken[];
+        changed: ViewToken[];
+    };
+}
+//# sourceMappingURL=ViewabilityHelper.d.ts.map

package/lib/typescript/src/viewability/ViewabilityHelper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ViewabilityHelper.d.ts","sourceRoot":"","sources":["../../../../src/viewability/ViewabilityHelper.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAA;AAChE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAA;AAE/D;;;GAGG;AACH,MAAM,MAAM,SAAS,GAAG;IACtB,KAAK,EAAE,MAAM,CAAA;IACb,UAAU,EAAE,OAAO,CAAA;CACpB,CAAA;AAED;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC9B;;;OAGG;IACH,2BAA2B,CAAC,EAAE,MAAM,CAAA;CACrC,CAAA;AAED;;;;;;;;;;GAUG;AACH,qBAAa,iBAAiB;IAK1B,OAAO,CAAC,QAAQ,CAAC,MAAM;IAJzB,iCAAiC;IACjC,OAAO,CAAC,WAAW,CAAoB;gBAGpB,MAAM,GAAE,iBAAsB;IAGjD;;;;;;;OAOG;IACH,oBAAoB,CAClB,OAAO,EAAE,SAAS,eAAe,EAAE,EACnC,OAAO,EAAE,aAAa,GACrB;QACD,aAAa,EAAE,SAAS,EAAE,CAAA;QAC1B,OAAO,EAAE,SAAS,EAAE,CAAA;KACrB;CAyEF"}

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

@@ -0,0 +1,11 @@
+/**
+ * Immutable snapshot of scroll state.
+ * FlashList terminology.
+ */
+export interface ScrollMetrics {
+    /** Vertical scroll offset */
+    offsetY: number;
+    /** Viewport height */
+    height: number;
+}
+//# sourceMappingURL=ScrollMetrics.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ScrollMetrics.d.ts","sourceRoot":"","sources":["../../../../src/windowing/ScrollMetrics.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,6BAA6B;IAC7B,OAAO,EAAE,MAAM,CAAA;IAEf,sBAAsB;IACtB,MAAM,EAAE,MAAM,CAAA;CACf"}

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

@@ -0,0 +1,11 @@
+import type { LayoutRectangle } from '../layout/LayoutRectangle';
+import type { ScrollMetrics } from './ScrollMetrics';
+/**
+ * Computes the contiguous range of item indices
+ * intersecting the viewport expanded by bufferPx.
+ *
+ * PURE function. No allocations besides output.
+ * FlashList-style windowing.
+ */
+export declare function findVisibleIndexRange(layouts: readonly LayoutRectangle[], metrics: ScrollMetrics, bufferPx: number): readonly number[];
+//# sourceMappingURL=findVisibleIndexRange.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"findVisibleIndexRange.d.ts","sourceRoot":"","sources":["../../../../src/windowing/findVisibleIndexRange.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAA;AAChE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAEpD;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,SAAS,eAAe,EAAE,EACnC,OAAO,EAAE,aAAa,EACtB,QAAQ,EAAE,MAAM,GACf,SAAS,MAAM,EAAE,CA6CnB"}

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

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

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

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

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

@@ -0,0 +1,14 @@
+import type { LayoutChangeEvent, NativeScrollEvent, NativeSyntheticEvent } from 'react-native';
+import type { ScrollMetrics } from './ScrollMetrics';
+/**
+ * Scroll metrics hook.
+ * Provides stable scroll snapshot + handlers.
+ *
+ * FlashList equivalent: useScrollMetrics
+ */
+export declare function useScrollMetrics(): {
+    metrics: ScrollMetrics;
+    onScroll: (e: NativeSyntheticEvent<NativeScrollEvent>) => void;
+    onLayout: (e: LayoutChangeEvent) => void;
+};
+//# sourceMappingURL=useScrollMetrics.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useScrollMetrics.d.ts","sourceRoot":"","sources":["../../../../src/windowing/useScrollMetrics.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,iBAAiB,EACjB,iBAAiB,EACjB,oBAAoB,EACrB,MAAM,cAAc,CAAA;AACrB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAEpD;;;;;GAKG;AACH,wBAAgB,gBAAgB,IAAI;IAClC,OAAO,EAAE,aAAa,CAAA;IACtB,QAAQ,EAAE,CAAC,CAAC,EAAE,oBAAoB,CAAC,iBAAiB,CAAC,KAAK,IAAI,CAAA;IAC9D,QAAQ,EAAE,CAAC,CAAC,EAAE,iBAAiB,KAAK,IAAI,CAAA;CACzC,CAqCA"}

package/nitro.json

@@ -1,24 +1,31 @@
 {
   "$schema": "https://nitro.margelo.com/nitro.schema.json",
-  "cxxNamespace": [
-    "nitrolist"
-  ],
+
+  "cxxNamespace": ["nitrolist"],
+
   "ios": {
     "iosModuleName": "NitroList"
   },
+
   "android": {
-    "androidNamespace": [
-      "nitrolist"
-    ],
+    "androidNamespace": ["nitrolist"],
     "androidCxxLibName": "NitroList"
   },
+
   "autolinking": {
-    "NitroList": {
-      "swift": "HybridNitroList",
-      "kotlin": "HybridNitroList"
+    "views": {
+      "NitroListView": {
+        "swift": "HybridNitroList",
+        "kotlin": "HybridNitroList"
+      }
+    },
+    "objects": {
+      "NitroLayoutEngine": {
+        "swift": "HybridNitroLayoutEngine",
+        "kotlin": "HybridNitroLayoutEngine"
+      }
     }
   },
-  "ignorePaths": [
-    "**/node_modules"
-  ]
-}
+
+  "ignorePaths": ["**/node_modules"]
+}

package/nitrogen/generated/android/NitroList+autolinking.cmake

@@ -33,11 +33,9 @@ target_sources(
   # Autolinking Setup
   ../nitrogen/generated/android/NitroListOnLoad.cpp
   # Shared Nitrogen C++ sources
-  ../nitrogen/generated/shared/c++/HybridNitroListSpec.cpp
-  ../nitrogen/generated/shared/c++/views/HybridNitroListComponent.cpp
+  ../nitrogen/generated/shared/c++/HybridNitroLayoutEngineSpec.cpp
   # Android-specific Nitrogen C++ sources
-  ../nitrogen/generated/android/c++/JHybridNitroListSpec.cpp
-  ../nitrogen/generated/android/c++/views/JHybridNitroListStateUpdater.cpp
+  ../nitrogen/generated/android/c++/JHybridNitroLayoutEngineSpec.cpp
 )
 
 # From node_modules/react-native/ReactAndroid/cmake-utils/folly-flags.cmake

package/nitrogen/generated/android/NitroListOnLoad.cpp

@@ -15,9 +15,7 @@
 #include <fbjni/fbjni.h>
 #include <NitroModules/HybridObjectRegistry.hpp>
 
-#include "JHybridNitroListSpec.hpp"
-#include "views/JHybridNitroListStateUpdater.hpp"
-#include <NitroModules/DefaultConstructableObject.hpp>
+#include "JHybridNitroLayoutEngineSpec.hpp"
 
 namespace margelo::nitro::nitrolist {
 
@@ -28,18 +26,10 @@ int initialize(JavaVM* vm) {
 
   return facebook::jni::initialize(vm, [] {
     // Register native JNI methods
-    margelo::nitro::nitrolist::JHybridNitroListSpec::registerNatives();
-    margelo::nitro::nitrolist::views::JHybridNitroListStateUpdater::registerNatives();
+    margelo::nitro::nitrolist::JHybridNitroLayoutEngineSpec::registerNatives();
 
     // Register Nitro Hybrid Objects
-    HybridObjectRegistry::registerHybridObjectConstructor(
-      "NitroList",
-      []() -> std::shared_ptr<HybridObject> {
-        static DefaultConstructableObject<JHybridNitroListSpec::javaobject> object("com/nitrolist/HybridNitroList");
-        auto instance = object.create();
-        return instance->cthis()->shared();
-      }
-    );
+    
   });
 }