react-native-nitro-list 0.1.2 → 0.1.3

package/lib/module/windowing/computeVisibleItemRange.js

@@ -1,15 +1,8 @@
 "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)
+ * Computes visible item range using binary search + forward scan.
+ * Type-safe and defensive against invalid indices.
  */
 export function computeVisibleItemRange(input) {
   const {
@@ -19,49 +12,46 @@ export function computeVisibleItemRange(input) {
     buffer,
     isVertical
   } = input;
-  const itemCount = layouts.length;
-  if (itemCount === 0) return null;
+  const count = layouts.length;
+  if (count === 0) return null;
   const windowStart = Math.max(0, offset - buffer);
   const windowEnd = offset + viewportSize + buffer;
 
-  // --------------------------------------------------
-  // Binary search:
-  // First item whose END >= windowStart
-  // --------------------------------------------------
+  // ------------------------------
+  // Binary search: first visible
+  // ------------------------------
   let low = 0;
-  let high = itemCount - 1;
-  let firstVisibleIndex = itemCount;
+  let high = count - 1;
+  let first = count;
   while (low <= high) {
     const mid = low + high >>> 1;
     const rect = layouts[mid];
+    if (!rect) break;
     const start = isVertical ? rect.y : rect.x;
     const size = isVertical ? rect.height : rect.width;
-    const end = start + size;
-    if (end >= windowStart) {
-      firstVisibleIndex = mid;
+    if (start + size >= windowStart) {
+      first = mid;
       high = mid - 1;
     } else {
       low = mid + 1;
     }
   }
-  if (firstVisibleIndex === itemCount) {
-    return null;
-  }
+  if (first === count) return null;
 
-  // --------------------------------------------------
-  // Linear scan forward:
-  // Last item whose START <= windowEnd
-  // --------------------------------------------------
-  let lastVisibleIndex = firstVisibleIndex;
-  for (let i = firstVisibleIndex + 1; i < itemCount; i++) {
+  // ------------------------------
+  // Linear scan: last visible
+  // ------------------------------
+  let last = first;
+  for (let i = first + 1; i < count; i++) {
     const rect = layouts[i];
+    if (!rect) break;
     const start = isVertical ? rect.y : rect.x;
     if (start > windowEnd) break;
-    lastVisibleIndex = i;
+    last = i;
   }
   return {
-    startIndex: firstVisibleIndex,
-    endIndex: lastVisibleIndex
+    startIndex: first,
+    endIndex: last
   };
 }
 //# sourceMappingURL=computeVisibleItemRange.js.map

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

@@ -1 +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":[]}
+{"version":3,"names":["computeVisibleItemRange","input","layouts","offset","viewportSize","buffer","isVertical","count","length","windowStart","Math","max","windowEnd","low","high","first","mid","rect","start","y","x","size","height","width","last","i","startIndex","endIndex"],"sourceRoot":"../../../src","sources":["windowing/computeVisibleItemRange.ts"],"mappings":";;AAgBA;AACA;AACA;AACA;AACA,OAAO,SAASA,uBAAuBA,CACrCC,KAAY,EACS;EACrB,MAAM;IACJC,OAAO;IACPC,MAAM;IACNC,YAAY;IACZC,MAAM;IACNC;EACF,CAAC,GAAGL,KAAK;EAET,MAAMM,KAAK,GAAGL,OAAO,CAACM,MAAM;EAC5B,IAAID,KAAK,KAAK,CAAC,EAAE,OAAO,IAAI;EAE5B,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,IAAIQ,GAAG,GAAG,CAAC;EACX,IAAIC,IAAI,GAAGP,KAAK,GAAG,CAAC;EACpB,IAAIQ,KAAK,GAAGR,KAAK;EAEjB,OAAOM,GAAG,IAAIC,IAAI,EAAE;IAClB,MAAME,GAAG,GAAIH,GAAG,GAAGC,IAAI,KAAM,CAAC;IAC9B,MAAMG,IAAI,GAAGf,OAAO,CAACc,GAAG,CAAC;IACzB,IAAI,CAACC,IAAI,EAAE;IAEX,MAAMC,KAAK,GAAGZ,UAAU,GAAGW,IAAI,CAACE,CAAC,GAAGF,IAAI,CAACG,CAAC;IAC1C,MAAMC,IAAI,GAAGf,UAAU,GAAGW,IAAI,CAACK,MAAM,GAAGL,IAAI,CAACM,KAAK;IAElD,IAAIL,KAAK,GAAGG,IAAI,IAAIZ,WAAW,EAAE;MAC/BM,KAAK,GAAGC,GAAG;MACXF,IAAI,GAAGE,GAAG,GAAG,CAAC;IAChB,CAAC,MAAM;MACLH,GAAG,GAAGG,GAAG,GAAG,CAAC;IACf;EACF;EAEA,IAAID,KAAK,KAAKR,KAAK,EAAE,OAAO,IAAI;;EAEhC;EACA;EACA;EACA,IAAIiB,IAAI,GAAGT,KAAK;EAEhB,KAAK,IAAIU,CAAC,GAAGV,KAAK,GAAG,CAAC,EAAEU,CAAC,GAAGlB,KAAK,EAAEkB,CAAC,EAAE,EAAE;IACtC,MAAMR,IAAI,GAAGf,OAAO,CAACuB,CAAC,CAAC;IACvB,IAAI,CAACR,IAAI,EAAE;IAEX,MAAMC,KAAK,GAAGZ,UAAU,GAAGW,IAAI,CAACE,CAAC,GAAGF,IAAI,CAACG,CAAC;IAC1C,IAAIF,KAAK,GAAGN,SAAS,EAAE;IAEvBY,IAAI,GAAGC,CAAC;EACV;EAEA,OAAO;IACLC,UAAU,EAAEX,KAAK;IACjBY,QAAQ,EAAEH;EACZ,CAAC;AACH","ignoreList":[]}

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

@@ -1,2 +1,4 @@
-export { RecyclerList } from './recycler/RecyclerList';
+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,yBAAyB,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/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

@@ -1,14 +1,11 @@
+import type { RecyclerCell } from '../types/recycler/RecyclerCell';
 import type { CellType } from '../types/CellType';
-import type { RecyclerCellInstance } from '../types/recycler';
-export declare class CellPool {
+export declare class CellPool<T extends RecyclerCell<any>> {
     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;
+    acquire(type: CellType): T | null;
+    release(cell: T): void;
 }
 //# sourceMappingURL=CellPool.d.ts.map

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

@@ -1 +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"}
+{"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/CellKey.d.ts

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

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

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

@@ -6,6 +6,17 @@
  * 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 type CellType = string | number;
+export declare const createCellType: (value: string) => CellType;
 //# sourceMappingURL=CellType.d.ts.map

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

@@ -1 +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"}
+{"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/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/{RecyclerListProps.d.ts → NitroListProps.d.ts}

@@ -3,12 +3,12 @@ import type { CellType } from '../CellType';
 import type { MainAxisPadding } from '../layout';
 import type { RecyclerItemRenderer } from './RecyclerItemRenderer';
 /**
- * Public props for RecyclerList.
+ * Public props for NitroList.
  *
  * Generic, data-driven, layout-deterministic API.
  * This surface is intentionally minimal and stable.
  */
-export interface RecyclerListProps<T> {
+export interface NitroListProps<T> {
     /**
      * Scroll direction.
      * Defaults to 'vertical'.
@@ -63,4 +63,4 @@ export interface RecyclerListProps<T> {
      */
     readonly renderItem: RecyclerItemRenderer<T>;
 }
-//# sourceMappingURL=RecyclerListProps.d.ts.map
+//# 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"}

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

@@ -1,8 +1,12 @@
 import type { ReactNode } from 'react';
-import type { RecyclerCellInstance } from './RecyclerCellInstance';
+import type { RecyclerCell } from './RecyclerCell';
+/**
+ * Public renderItem signature for RecyclerList.
+ * Renderers receive a stable physical cell contract.
+ */
 export type RecyclerItemRenderer<T> = (params: {
     item: T;
     index: number;
-    cell: RecyclerCellInstance;
+    cell: RecyclerCell;
 }) => ReactNode;
 //# sourceMappingURL=RecyclerItemRenderer.d.ts.map

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

@@ -1 +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"}
+{"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,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAElD;;;GAGG;AACH,MAAM,MAAM,oBAAoB,CAAC,CAAC,IAAI,CAAC,MAAM,EAAE;IAC7C,IAAI,EAAE,CAAC,CAAA;IACP,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,YAAY,CAAA;CACnB,KAAK,SAAS,CAAA"}

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

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

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

@@ -1 +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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/types/recycler/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AACtD,YAAY,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAA;AAClE,YAAY,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA"}

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

@@ -1,15 +1,19 @@
-import type { VisibleRange } from '../types/VisibleRange';
-import type { VisibleRangeInput } from '../types/VisibleRangeInput';
+import type { LayoutRect } from "../types/layout";
+export type VisibleRange = {
+    startIndex: number;
+    endIndex: number;
+};
+type Input = {
+    layouts: readonly LayoutRect[];
+    offset: number;
+    viewportSize: number;
+    buffer: number;
+    isVertical: boolean;
+};
 /**
- * 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)
+ * Computes visible item range using binary search + forward scan.
+ * Type-safe and defensive against invalid indices.
  */
-export declare function computeVisibleItemRange(input: VisibleRangeInput): VisibleRange | null;
+export declare function computeVisibleItemRange(input: Input): VisibleRange | null;
+export {};
 //# sourceMappingURL=computeVisibleItemRange.d.ts.map

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

@@ -1 +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"}
+{"version":3,"file":"computeVisibleItemRange.d.ts","sourceRoot":"","sources":["../../../../src/windowing/computeVisibleItemRange.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAGjD,MAAM,MAAM,YAAY,GAAG;IACzB,UAAU,EAAE,MAAM,CAAA;IAClB,QAAQ,EAAE,MAAM,CAAA;CACjB,CAAA;AAED,KAAK,KAAK,GAAG;IACX,OAAO,EAAE,SAAS,UAAU,EAAE,CAAA;IAC9B,MAAM,EAAE,MAAM,CAAA;IACd,YAAY,EAAE,MAAM,CAAA;IACpB,MAAM,EAAE,MAAM,CAAA;IACd,UAAU,EAAE,OAAO,CAAA;CACpB,CAAA;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,KAAK,GACX,YAAY,GAAG,IAAI,CA2DrB"}

package/nitro.json

@@ -14,18 +14,18 @@
 
   "autolinking": {
     "views": {
-      "NitroListView": {
+      "NitroList": {
         "swift": "HybridNitroList",
         "kotlin": "HybridNitroList"
       }
     },
     "objects": {
-      "NitroLayoutEngine": {
-        "swift": "HybridNitroLayoutEngine",
-        "kotlin": "HybridNitroLayoutEngine"
+      "LayoutEngine": {
+        "swift": "HybridLayoutEngine",
+        "kotlin": "HybridLayoutEngine"
       }
     }
   },
 
   "ignorePaths": ["**/node_modules"]
-}
+}

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

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

package/nitrogen/generated/android/NitroListOnLoad.cpp

@@ -15,7 +15,7 @@
 #include <fbjni/fbjni.h>
 #include <NitroModules/HybridObjectRegistry.hpp>
 
-#include "JHybridNitroLayoutEngineSpec.hpp"
+#include "JHybridNitroListSpec.hpp"
 
 namespace margelo::nitro::nitrolist {
 
@@ -26,7 +26,7 @@ int initialize(JavaVM* vm) {
 
   return facebook::jni::initialize(vm, [] {
     // Register native JNI methods
-    margelo::nitro::nitrolist::JHybridNitroLayoutEngineSpec::registerNatives();
+    margelo::nitro::nitrolist::JHybridNitroListSpec::registerNatives();
 
     // Register Nitro Hybrid Objects
     

package/nitrogen/generated/android/c++/{JHybridNitroLayoutEngineSpec.cpp → JHybridNitroListSpec.cpp}

@@ -1,42 +1,42 @@
 ///
-/// JHybridNitroLayoutEngineSpec.cpp
+/// JHybridNitroListSpec.cpp
 /// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
 /// https://github.com/mrousavy/nitro
 /// Copyright © 2025 Marc Rousavy @ Margelo
 ///
 
-#include "JHybridNitroLayoutEngineSpec.hpp"
+#include "JHybridNitroListSpec.hpp"
 
-// Forward declaration of `LayoutRect` to properly resolve imports.
-namespace margelo::nitro::nitrolist { struct LayoutRect; }
+// Forward declaration of `ItemLayout` to properly resolve imports.
+namespace margelo::nitro::nitrolist { struct ItemLayout; }
 
-#include "LayoutRect.hpp"
+#include "ItemLayout.hpp"
 #include <vector>
-#include "JLayoutRect.hpp"
+#include "JItemLayout.hpp"
 
 namespace margelo::nitro::nitrolist {
 
-  jni::local_ref<JHybridNitroLayoutEngineSpec::jhybriddata> JHybridNitroLayoutEngineSpec::initHybrid(jni::alias_ref<jhybridobject> jThis) {
+  jni::local_ref<JHybridNitroListSpec::jhybriddata> JHybridNitroListSpec::initHybrid(jni::alias_ref<jhybridobject> jThis) {
     return makeCxxInstance(jThis);
   }
 
-  void JHybridNitroLayoutEngineSpec::registerNatives() {
+  void JHybridNitroListSpec::registerNatives() {
     registerHybrid({
-      makeNativeMethod("initHybrid", JHybridNitroLayoutEngineSpec::initHybrid),
+      makeNativeMethod("initHybrid", JHybridNitroListSpec::initHybrid),
     });
   }
 
-  size_t JHybridNitroLayoutEngineSpec::getExternalMemorySize() noexcept {
+  size_t JHybridNitroListSpec::getExternalMemorySize() noexcept {
     static const auto method = javaClassStatic()->getMethod<jlong()>("getMemorySize");
     return method(_javaPart);
   }
 
-  void JHybridNitroLayoutEngineSpec::dispose() noexcept {
+  void JHybridNitroListSpec::dispose() noexcept {
     static const auto method = javaClassStatic()->getMethod<void()>("dispose");
     method(_javaPart);
   }
 
-  std::string JHybridNitroLayoutEngineSpec::toString() {
+  std::string JHybridNitroListSpec::toString() {
     static const auto method = javaClassStatic()->getMethod<jni::JString()>("toString");
     auto javaString = method(_javaPart);
     return javaString->toStdString();
@@ -46,8 +46,8 @@ namespace margelo::nitro::nitrolist {
   
 
   // Methods
-  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");
+  std::vector<ItemLayout> JHybridNitroListSpec::computeLayout(double containerWidth, const std::vector<double>& itemHeights) {
+    static const auto method = javaClassStatic()->getMethod<jni::local_ref<jni::JArrayClass<JItemLayout>>(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<LayoutRect> __vector;
+      std::vector<ItemLayout> __vector;
       __vector.reserve(__size);
       for (size_t __i = 0; __i < __size; __i++) {
         auto __element = __result->getElement(__i);

package/nitrogen/generated/android/c++/{JHybridNitroLayoutEngineSpec.hpp → JHybridNitroListSpec.hpp}

@@ -1,5 +1,5 @@
 ///
-/// HybridNitroLayoutEngineSpec.hpp
+/// HybridNitroListSpec.hpp
 /// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
 /// https://github.com/mrousavy/nitro
 /// Copyright © 2025 Marc Rousavy @ Margelo
@@ -9,7 +9,7 @@
 
 #include <NitroModules/JHybridObject.hpp>
 #include <fbjni/fbjni.h>
-#include "HybridNitroLayoutEngineSpec.hpp"
+#include "HybridNitroListSpec.hpp"
 
 
 
@@ -18,22 +18,22 @@ namespace margelo::nitro::nitrolist {
 
   using namespace facebook;
 
-  class JHybridNitroLayoutEngineSpec: public jni::HybridClass<JHybridNitroLayoutEngineSpec, JHybridObject>,
-                                      public virtual HybridNitroLayoutEngineSpec {
+  class JHybridNitroListSpec: public jni::HybridClass<JHybridNitroListSpec, JHybridObject>,
+                              public virtual HybridNitroListSpec {
   public:
-    static auto constexpr kJavaDescriptor = "Lcom/margelo/nitro/nitrolist/HybridNitroLayoutEngineSpec;";
+    static auto constexpr kJavaDescriptor = "Lcom/margelo/nitro/nitrolist/HybridNitroListSpec;";
     static jni::local_ref<jhybriddata> initHybrid(jni::alias_ref<jhybridobject> jThis);
     static void registerNatives();
 
   protected:
     // C++ constructor (called from Java via `initHybrid()`)
-    explicit JHybridNitroLayoutEngineSpec(jni::alias_ref<jhybridobject> jThis) :
-      HybridObject(HybridNitroLayoutEngineSpec::TAG),
+    explicit JHybridNitroListSpec(jni::alias_ref<jhybridobject> jThis) :
+      HybridObject(HybridNitroListSpec::TAG),
       HybridBase(jThis),
       _javaPart(jni::make_global(jThis)) {}
 
   public:
-    ~JHybridNitroLayoutEngineSpec() override {
+    ~JHybridNitroListSpec() override {
       // Hermes GC can destroy JS objects on a non-JNI Thread.
       jni::ThreadScope::WithClassLoader([&] { _javaPart.reset(); });
     }
@@ -44,7 +44,7 @@ namespace margelo::nitro::nitrolist {
     std::string toString() override;
 
   public:
-    inline const jni::global_ref<JHybridNitroLayoutEngineSpec::javaobject>& getJavaPart() const noexcept {
+    inline const jni::global_ref<JHybridNitroListSpec::javaobject>& getJavaPart() const noexcept {
       return _javaPart;
     }
 
@@ -54,12 +54,12 @@ namespace margelo::nitro::nitrolist {
 
   public:
     // Methods
-    std::vector<LayoutRect> computeLayout(double containerWidth, const std::vector<double>& itemHeights) override;
+    std::vector<ItemLayout> computeLayout(double containerWidth, const std::vector<double>& itemHeights) override;
 
   private:
     friend HybridBase;
     using HybridBase::HybridBase;
-    jni::global_ref<JHybridNitroLayoutEngineSpec::javaobject> _javaPart;
+    jni::global_ref<JHybridNitroListSpec::javaobject> _javaPart;
   };
 
 } // namespace margelo::nitro::nitrolist