react-native-nitro-list 0.0.1 → 0.1.2

package/lib/commonjs/debug/useDebugOverlay.js

@@ -0,0 +1,15 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.useDebugOverlay = useDebugOverlay;
+var _react = require("react");
+function useDebugOverlay(enabled, visibleCount) {
+  (0, _react.useEffect)(() => {
+    if (__DEV__ && enabled) {
+      console.log(`[RecyclerList] visible items: ${visibleCount}`);
+    }
+  }, [enabled, visibleCount]);
+}
+//# sourceMappingURL=useDebugOverlay.js.map

package/lib/commonjs/debug/useDebugOverlay.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_react","require","useDebugOverlay","enabled","visibleCount","useEffect","__DEV__","console","log"],"sourceRoot":"../../../src","sources":["debug/useDebugOverlay.ts"],"mappings":";;;;;;AAAA,IAAAA,MAAA,GAAAC,OAAA;AAEO,SAASC,eAAeA,CAC7BC,OAAgB,EAChBC,YAAoB,EACd;EACN,IAAAC,gBAAS,EAAC,MAAM;IACd,IAAIC,OAAO,IAAIH,OAAO,EAAE;MACtBI,OAAO,CAACC,GAAG,CACT,iCAAiCJ,YAAY,EAC/C,CAAC;IACH;EACF,CAAC,EAAE,CAACD,OAAO,EAAEC,YAAY,CAAC,CAAC;AAC7B","ignoreList":[]}

package/lib/commonjs/getVisibleIndices.js

@@ -0,0 +1,38 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.getVisibleRange = getVisibleRange;
+/**
+ * Binary-search based windowing.
+ * Returns indices intersecting viewport ± buffer.
+ */
+function getVisibleRange(layouts, metrics, bufferPx) {
+  if (layouts.length === 0 || metrics.height <= 0) {
+    return [];
+  }
+  const startY = Math.max(0, metrics.offsetY - bufferPx);
+  const endY = metrics.offsetY + metrics.height + bufferPx;
+  let low = 0;
+  let high = layouts.length - 1;
+  let first = layouts.length;
+  while (low <= high) {
+    const mid = low + high >> 1;
+    const rect = layouts[mid];
+    if (rect.y + rect.height >= startY) {
+      first = mid;
+      high = mid - 1;
+    } else {
+      low = mid + 1;
+    }
+  }
+  const visible = [];
+  for (let i = first; i < layouts.length; i++) {
+    const rect = layouts[i];
+    if (rect.y > endY) break;
+    visible.push(i);
+  }
+  return visible;
+}
+//# sourceMappingURL=getVisibleIndices.js.map

package/lib/commonjs/getVisibleIndices.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["getVisibleRange","layouts","metrics","bufferPx","length","height","startY","Math","max","offsetY","endY","low","high","first","mid","rect","y","visible","i","push"],"sourceRoot":"../../src","sources":["getVisibleIndices.ts"],"mappings":";;;;;;AAKA;AACA;AACA;AACA;AACO,SAASA,eAAeA,CAC7BC,OAA8B,EAC9BC,OAAsB,EACtBC,QAAgB,EACG;EACnB,IACEF,OAAO,CAACG,MAAM,KAAK,CAAC,IACpBF,OAAO,CAACG,MAAM,IAAI,CAAC,EACnB;IACA,OAAO,EAAE;EACX;EAEA,MAAMC,MAAM,GAAGC,IAAI,CAACC,GAAG,CACrB,CAAC,EACDN,OAAO,CAACO,OAAO,GAAGN,QACpB,CAAC;EAED,MAAMO,IAAI,GACRR,OAAO,CAACO,OAAO,GAAGP,OAAO,CAACG,MAAM,GAAGF,QAAQ;EAE7C,IAAIQ,GAAG,GAAG,CAAC;EACX,IAAIC,IAAI,GAAGX,OAAO,CAACG,MAAM,GAAG,CAAC;EAC7B,IAAIS,KAAK,GAAGZ,OAAO,CAACG,MAAM;EAE1B,OAAOO,GAAG,IAAIC,IAAI,EAAE;IAClB,MAAME,GAAG,GAAIH,GAAG,GAAGC,IAAI,IAAK,CAAC;IAC7B,MAAMG,IAAI,GAAGd,OAAO,CAACa,GAAG,CAAE;IAE1B,IAAIC,IAAI,CAACC,CAAC,GAAGD,IAAI,CAACV,MAAM,IAAIC,MAAM,EAAE;MAClCO,KAAK,GAAGC,GAAG;MACXF,IAAI,GAAGE,GAAG,GAAG,CAAC;IAChB,CAAC,MAAM;MACLH,GAAG,GAAGG,GAAG,GAAG,CAAC;IACf;EACF;EAEA,MAAMG,OAAiB,GAAG,EAAE;EAE5B,KAAK,IAAIC,CAAC,GAAGL,KAAK,EAAEK,CAAC,GAAGjB,OAAO,CAACG,MAAM,EAAEc,CAAC,EAAE,EAAE;IAC3C,MAAMH,IAAI,GAAGd,OAAO,CAACiB,CAAC,CAAE;IACxB,IAAIH,IAAI,CAACC,CAAC,GAAGN,IAAI,EAAE;IACnBO,OAAO,CAACE,IAAI,CAACD,CAAC,CAAC;EACjB;EAEA,OAAOD,OAAO;AAChB","ignoreList":[]}

package/lib/commonjs/hooks/usePersistentCallback.js

@@ -0,0 +1,36 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.usePersistentCallback = usePersistentCallback;
+var _react = require("react");
+/**
+ * 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
+ */
+function usePersistentCallback(fn) {
+  /**
+   * Holds the latest implementation.
+   * Updating this does NOT trigger re-renders.
+   */
+  const fnRef = (0, _react.useRef)(fn);
+  fnRef.current = fn;
+
+  /**
+   * Stable wrapper that forwards calls
+   * to the latest implementation.
+   */
+  return (0, _react.useCallback)((...args) => fnRef.current(...args), []);
+}
+//# sourceMappingURL=usePersistentCallback.js.map

package/lib/commonjs/hooks/usePersistentCallback.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_react","require","usePersistentCallback","fn","fnRef","useRef","current","useCallback","args"],"sourceRoot":"../../../src","sources":["hooks/usePersistentCallback.ts"],"mappings":";;;;;;AAAA,IAAAA,MAAA,GAAAC,OAAA;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAASC,qBAAqBA,CAEnCC,EAAK,EAAK;EAEV;AACF;AACA;AACA;EACE,MAAMC,KAAK,GAAG,IAAAC,aAAM,EAACF,EAAE,CAAC;EACxBC,KAAK,CAACE,OAAO,GAAGH,EAAE;;EAElB;AACF;AACA;AACA;EACE,OAAO,IAAAI,kBAAW,EACf,CAAC,GAAGC,IAAa,KAChBJ,KAAK,CAACE,OAAO,CAAC,GAAGE,IAAI,CAAC,EACxB,EACF,CAAC;AACH","ignoreList":[]}

package/lib/commonjs/index.js

@@ -3,9 +3,11 @@
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-exports.NitroList = void 0;
-var _reactNativeNitroModules = require("react-native-nitro-modules");
-var _NitroListConfig = _interopRequireDefault(require("../nitrogen/generated/shared/json/NitroListConfig.json"));
-function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
-const NitroList = exports.NitroList = (0, _reactNativeNitroModules.getHostComponent)('NitroList', () => _NitroListConfig.default);
+Object.defineProperty(exports, "RecyclerList", {
+  enumerable: true,
+  get: function () {
+    return _RecyclerList.RecyclerList;
+  }
+});
+var _RecyclerList = require("./recycler/RecyclerList");
 //# sourceMappingURL=index.js.map

package/lib/commonjs/index.js.map

@@ -1 +1 @@
-{"version":3,"names":["_reactNativeNitroModules","require","_NitroListConfig","_interopRequireDefault","e","__esModule","default","NitroList","exports","getHostComponent","NitroListConfig"],"sourceRoot":"../../src","sources":["index.ts"],"mappings":";;;;;;AAAA,IAAAA,wBAAA,GAAAC,OAAA;AACA,IAAAC,gBAAA,GAAAC,sBAAA,CAAAF,OAAA;AAAoF,SAAAE,uBAAAC,CAAA,WAAAA,CAAA,IAAAA,CAAA,CAAAC,UAAA,GAAAD,CAAA,KAAAE,OAAA,EAAAF,CAAA;AAO7E,MAAMG,SAAS,GAAAC,OAAA,CAAAD,SAAA,GAAG,IAAAE,yCAAgB,EACvC,WAAW,EACX,MAAMC,wBACR,CAAC","ignoreList":[]}
+{"version":3,"names":["_RecyclerList","require"],"sourceRoot":"../../src","sources":["index.ts"],"mappings":";;;;;;;;;;;AAAA,IAAAA,aAAA,GAAAC,OAAA","ignoreList":[]}

package/lib/commonjs/layout/MutableLinearLayout.js

@@ -0,0 +1,104 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.MutableLinearLayout = void 0;
+var _layoutDefaults = require("./constants/layoutDefaults");
+/**
+ * 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)
+ */
+class MutableLinearLayout {
+  /** Absolute item layouts in index order */
+  layouts = [];
+
+  /** Total scrollable size along main axis */
+  contentSize = 0;
+  constructor(axis) {
+    this.isVertical = axis === 'vertical';
+  }
+
+  /**
+   * Computes layout synchronously from input.
+   *
+   * This method is intentionally parameter-object based
+   * to allow future extension without breaking API.
+   *
+   * Invariants:
+   * - Layouts are monotonic along main axis
+   * - No gaps except explicit spacing
+   * - Deterministic for identical inputs
+   */
+  compute(input) {
+    const {
+      crossAxisSize,
+      itemMainAxisSizes,
+      padding,
+      itemSpacing = _layoutDefaults.DEFAULT_ITEM_SPACING
+    } = input;
+    const itemCount = itemMainAxisSizes.length;
+    const layouts = new Array(itemCount);
+    let cursor = padding.start;
+    for (let i = 0; i < itemCount; i++) {
+      const mainAxisSize = itemMainAxisSizes[i];
+      layouts[i] = this.isVertical ? {
+        x: 0,
+        y: cursor,
+        width: crossAxisSize,
+        height: mainAxisSize
+      } : {
+        x: cursor,
+        y: 0,
+        width: mainAxisSize,
+        height: crossAxisSize
+      };
+      cursor += mainAxisSize;
+
+      // Space BETWEEN items, not after the last
+      if (i < itemCount - 1) {
+        cursor += itemSpacing;
+      }
+    }
+    this.layouts = layouts;
+    this.contentSize = cursor + padding.end;
+  }
+
+  /**
+   * Returns computed item layouts.
+   *
+   * Order is guaranteed monotonic along the main axis,
+   * which is required for binary-search-based windowing.
+   */
+  getLayouts() {
+    return this.layouts;
+  }
+
+  /**
+   * Returns total scrollable size along the main axis,
+   * including padding and inter-item spacing.
+   */
+  getContentSize() {
+    return this.contentSize;
+  }
+
+  /**
+   * Clears internal layout state.
+   * Call on severe invalidation or teardown.
+   */
+  reset() {
+    this.layouts = [];
+    this.contentSize = 0;
+  }
+}
+exports.MutableLinearLayout = MutableLinearLayout;
+//# sourceMappingURL=MutableLinearLayout.js.map

package/lib/commonjs/layout/MutableLinearLayout.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_layoutDefaults","require","MutableLinearLayout","layouts","contentSize","constructor","axis","isVertical","compute","input","crossAxisSize","itemMainAxisSizes","padding","itemSpacing","DEFAULT_ITEM_SPACING","itemCount","length","Array","cursor","start","i","mainAxisSize","x","y","width","height","end","getLayouts","getContentSize","reset","exports"],"sourceRoot":"../../../src","sources":["layout/MutableLinearLayout.ts"],"mappings":";;;;;;AAIA,IAAAA,eAAA,GAAAC,OAAA;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,MAAMC,mBAAmB,CAAC;EAG/B;EACQC,OAAO,GAAiB,EAAE;;EAElC;EACQC,WAAW,GAAG,CAAC;EAEvBC,WAAWA,CAACC,IAAU,EAAE;IACtB,IAAI,CAACC,UAAU,GAAGD,IAAI,KAAK,UAAU;EACvC;;EAEA;AACF;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;EACEE,OAAOA,CAACC,KAAwB,EAAQ;IACtC,MAAM;MACJC,aAAa;MACbC,iBAAiB;MACjBC,OAAO;MACPC,WAAW,GAAGC;IAChB,CAAC,GAAGL,KAAK;IAET,MAAMM,SAAS,GAAGJ,iBAAiB,CAACK,MAAM;IAC1C,MAAMb,OAAqB,GAAG,IAAIc,KAAK,CAACF,SAAS,CAAC;IAElD,IAAIG,MAAM,GAAGN,OAAO,CAACO,KAAK;IAE1B,KAAK,IAAIC,CAAC,GAAG,CAAC,EAAEA,CAAC,GAAGL,SAAS,EAAEK,CAAC,EAAE,EAAE;MAClC,MAAMC,YAAY,GAAGV,iBAAiB,CAACS,CAAC,CAAE;MAE1CjB,OAAO,CAACiB,CAAC,CAAC,GAAG,IAAI,CAACb,UAAU,GACxB;QACEe,CAAC,EAAE,CAAC;QACJC,CAAC,EAAEL,MAAM;QACTM,KAAK,EAAEd,aAAa;QACpBe,MAAM,EAAEJ;MACV,CAAC,GACD;QACEC,CAAC,EAAEJ,MAAM;QACTK,CAAC,EAAE,CAAC;QACJC,KAAK,EAAEH,YAAY;QACnBI,MAAM,EAAEf;MACV,CAAC;MAELQ,MAAM,IAAIG,YAAY;;MAEtB;MACA,IAAID,CAAC,GAAGL,SAAS,GAAG,CAAC,EAAE;QACrBG,MAAM,IAAIL,WAAW;MACvB;IACF;IAEA,IAAI,CAACV,OAAO,GAAGA,OAAO;IACtB,IAAI,CAACC,WAAW,GAAGc,MAAM,GAAGN,OAAO,CAACc,GAAG;EACzC;;EAEA;AACF;AACA;AACA;AACA;AACA;EACEC,UAAUA,CAAA,EAA0B;IAClC,OAAO,IAAI,CAACxB,OAAO;EACrB;;EAEA;AACF;AACA;AACA;EACEyB,cAAcA,CAAA,EAAW;IACvB,OAAO,IAAI,CAACxB,WAAW;EACzB;;EAEA;AACF;AACA;AACA;EACEyB,KAAKA,CAAA,EAAS;IACZ,IAAI,CAAC1B,OAAO,GAAG,EAAE;IACjB,IAAI,CAACC,WAAW,GAAG,CAAC;EACtB;AACF;AAAC0B,OAAA,CAAA5B,mBAAA,GAAAA,mBAAA","ignoreList":[]}

package/lib/commonjs/layout/constants/layoutDefaults.js

@@ -0,0 +1,19 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.DEFAULT_ITEM_SPACING = void 0;
+/**
+ * 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
+ */
+const DEFAULT_ITEM_SPACING = exports.DEFAULT_ITEM_SPACING = 12;
+//# sourceMappingURL=layoutDefaults.js.map

package/lib/commonjs/layout/constants/layoutDefaults.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["DEFAULT_ITEM_SPACING","exports"],"sourceRoot":"../../../../src","sources":["layout/constants/layoutDefaults.ts"],"mappings":";;;;;;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,MAAMA,oBAAoB,GAAAC,OAAA,CAAAD,oBAAA,GAAG,EAAE","ignoreList":[]}

package/lib/commonjs/layout/index.js

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

package/lib/commonjs/{specs/nitro-list.nitro.js.map → layout/index.js.map}

@@ -1 +1 @@
-{"version":3,"names":[],"sourceRoot":"../../../src","sources":["specs/nitro-list.nitro.ts"],"mappings":"","ignoreList":[]}
+{"version":3,"names":[],"sourceRoot":"../../../src","sources":["layout/index.ts"],"mappings":"","ignoreList":[]}

package/lib/commonjs/measurement/MeasureLayout.js

@@ -0,0 +1,20 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.measureLayout = measureLayout;
+/**
+ * Extracts stable layout measurements from RN onLayout event.
+ */
+function measureLayout(event) {
+  const {
+    width,
+    height
+  } = event.nativeEvent.layout;
+  return {
+    width,
+    height
+  };
+}
+//# sourceMappingURL=MeasureLayout.js.map

package/lib/commonjs/measurement/MeasureLayout.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["measureLayout","event","width","height","nativeEvent","layout"],"sourceRoot":"../../../src","sources":["measurement/MeasureLayout.ts"],"mappings":";;;;;;AAOA;AACA;AACA;AACO,SAASA,aAAaA,CAC3BC,KAAwB,EACR;EAChB,MAAM;IAAEC,KAAK;IAAEC;EAAO,CAAC,GAAGF,KAAK,CAACG,WAAW,CAACC,MAAM;EAElD,OAAO;IACLH,KAAK;IACLC;EACF,CAAC;AACH","ignoreList":[]}

package/lib/commonjs/measurement/useItemMeasurement.js

@@ -0,0 +1,28 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.useItemMeasurement = useItemMeasurement;
+var _react = require("react");
+/**
+ * Hook to measure a rendered item safely.
+ *
+ * Guarantees:
+ * - No duplicate height reports
+ * - No render loops
+ * - Stable callback identity
+ */
+function useItemMeasurement(index, onMeasured) {
+  const lastHeightRef = (0, _react.useRef)(null);
+  const onLayout = (0, _react.useCallback)(e => {
+    const height = e.nativeEvent.layout.height;
+
+    // Ignore identical measurements
+    if (lastHeightRef.current === height) return;
+    lastHeightRef.current = height;
+    onMeasured(index, height);
+  }, [index, onMeasured]);
+  return onLayout;
+}
+//# sourceMappingURL=useItemMeasurement.js.map

package/lib/commonjs/measurement/useItemMeasurement.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_react","require","useItemMeasurement","index","onMeasured","lastHeightRef","useRef","onLayout","useCallback","e","height","nativeEvent","layout","current"],"sourceRoot":"../../../src","sources":["measurement/useItemMeasurement.ts"],"mappings":";;;;;;AAAA,IAAAA,MAAA,GAAAC,OAAA;AAGA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAASC,kBAAkBA,CAChCC,KAAa,EACbC,UAAmD,EACnD;EACA,MAAMC,aAAa,GAAG,IAAAC,aAAM,EAAgB,IAAI,CAAC;EAEjD,MAAMC,QAAQ,GAAG,IAAAC,kBAAW,EACzBC,CAAoB,IAAK;IACxB,MAAMC,MAAM,GAAGD,CAAC,CAACE,WAAW,CAACC,MAAM,CAACF,MAAM;;IAE1C;IACA,IAAIL,aAAa,CAACQ,OAAO,KAAKH,MAAM,EAAE;IAEtCL,aAAa,CAACQ,OAAO,GAAGH,MAAM;IAC9BN,UAAU,CAACD,KAAK,EAAEO,MAAM,CAAC;EAC3B,CAAC,EACD,CAACP,KAAK,EAAEC,UAAU,CACpB,CAAC;EAED,OAAOG,QAAQ;AACjB","ignoreList":[]}

package/lib/commonjs/native/NitroLayoutEngine.js

@@ -0,0 +1,9 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.NitroLayoutEngine = void 0;
+var _reactNativeNitroModules = require("react-native-nitro-modules");
+const NitroLayoutEngine = exports.NitroLayoutEngine = _reactNativeNitroModules.NitroModules.createHybridObject('NitroLayoutEngine');
+//# sourceMappingURL=NitroLayoutEngine.js.map

package/lib/commonjs/native/NitroLayoutEngine.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_reactNativeNitroModules","require","NitroLayoutEngine","exports","NitroModules","createHybridObject"],"sourceRoot":"../../../src","sources":["native/NitroLayoutEngine.ts"],"mappings":";;;;;;AAAA,IAAAA,wBAAA,GAAAC,OAAA;AAGO,MAAMC,iBAAiB,GAAAC,OAAA,CAAAD,iBAAA,GAC5BE,qCAAY,CAACC,kBAAkB,CAC7B,mBACF,CAAC","ignoreList":[]}

package/lib/commonjs/{specs/nitro-list.nitro.js → native/NitroList.types.js}

@@ -3,4 +3,4 @@
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-//# sourceMappingURL=nitro-list.nitro.js.map
+//# sourceMappingURL=NitroList.types.js.map

package/lib/commonjs/native/NitroList.types.js.map

@@ -0,0 +1 @@
+{"version":3,"names":[],"sourceRoot":"../../../src","sources":["native/NitroList.types.ts"],"mappings":"","ignoreList":[]}

package/lib/commonjs/native/NitroRecyclerView.js

@@ -0,0 +1,9 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.NitroRecyclerView = void 0;
+var _reactNative = require("react-native");
+const NitroRecyclerView = exports.NitroRecyclerView = (0, _reactNative.requireNativeComponent)('NitroRecyclerView');
+//# sourceMappingURL=NitroRecyclerView.js.map

package/lib/commonjs/native/NitroRecyclerView.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_reactNative","require","NitroRecyclerView","exports","requireNativeComponent"],"sourceRoot":"../../../src","sources":["native/NitroRecyclerView.ts"],"mappings":";;;;;;AAAA,IAAAA,YAAA,GAAAC,OAAA;AAMO,MAAMC,iBAAiB,GAAAC,OAAA,CAAAD,iBAAA,GAC5B,IAAAE,mCAAsB,EAAyB,mBAAmB,CAAC","ignoreList":[]}

package/lib/commonjs/prefetch/PrefetchHelper.js

@@ -0,0 +1,39 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.PrefetchHelper = void 0;
+/**
+ * Callback invoked when new items should be prefetched.
+ */
+
+/**
+ * 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.
+ */
+class PrefetchHelper {
+  lastPrefetched = new Set();
+  runPrefetch(visibleIndices, itemCount, aheadCount, onPrefetch) {
+    if (visibleIndices.length === 0) return;
+    const lastVisible = visibleIndices[visibleIndices.length - 1];
+    const start = lastVisible + 1;
+    const end = Math.min(itemCount - 1, start + aheadCount);
+    const toPrefetch = [];
+    for (let i = start; i <= end; i++) {
+      if (!this.lastPrefetched.has(i)) {
+        this.lastPrefetched.add(i);
+        toPrefetch.push(i);
+      }
+    }
+    if (toPrefetch.length > 0) {
+      onPrefetch(toPrefetch);
+    }
+  }
+}
+exports.PrefetchHelper = PrefetchHelper;
+//# sourceMappingURL=PrefetchHelper.js.map

package/lib/commonjs/prefetch/PrefetchHelper.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["PrefetchHelper","lastPrefetched","Set","runPrefetch","visibleIndices","itemCount","aheadCount","onPrefetch","length","lastVisible","start","end","Math","min","toPrefetch","i","has","add","push","exports"],"sourceRoot":"../../../src","sources":["prefetch/PrefetchHelper.ts"],"mappings":";;;;;;AAAA;AACA;AACA;;AAGA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,MAAMA,cAAc,CAAC;EAClBC,cAAc,GAAG,IAAIC,GAAG,CAAS,CAAC;EAE1CC,WAAWA,CACTC,cAAiC,EACjCC,SAAiB,EACjBC,UAAkB,EAClBC,UAA4B,EAC5B;IACA,IAAIH,cAAc,CAACI,MAAM,KAAK,CAAC,EAAE;IAEjC,MAAMC,WAAW,GACfL,cAAc,CAACA,cAAc,CAACI,MAAM,GAAG,CAAC,CAAE;IAE5C,MAAME,KAAK,GAAGD,WAAW,GAAG,CAAC;IAC7B,MAAME,GAAG,GAAGC,IAAI,CAACC,GAAG,CAClBR,SAAS,GAAG,CAAC,EACbK,KAAK,GAAGJ,UACV,CAAC;IAED,MAAMQ,UAAoB,GAAG,EAAE;IAE/B,KAAK,IAAIC,CAAC,GAAGL,KAAK,EAAEK,CAAC,IAAIJ,GAAG,EAAEI,CAAC,EAAE,EAAE;MACjC,IAAI,CAAC,IAAI,CAACd,cAAc,CAACe,GAAG,CAACD,CAAC,CAAC,EAAE;QAC/B,IAAI,CAACd,cAAc,CAACgB,GAAG,CAACF,CAAC,CAAC;QAC1BD,UAAU,CAACI,IAAI,CAACH,CAAC,CAAC;MACpB;IACF;IAEA,IAAID,UAAU,CAACN,MAAM,GAAG,CAAC,EAAE;MACzBD,UAAU,CAACO,UAAU,CAAC;IACxB;EACF;AACF;AAACK,OAAA,CAAAnB,cAAA,GAAAA,cAAA","ignoreList":[]}

package/lib/commonjs/recycler/CellPool.js

@@ -0,0 +1,46 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.CellPool = void 0;
+class CellPool {
+  pools = new Map();
+  maxPerType = new Map();
+
+  /** ✅ NEW: check if a type is registered */
+  hasType(type) {
+    return this.pools.has(type);
+  }
+  registerType(type, maxCount) {
+    if (this.maxPerType.has(type)) return;
+    this.maxPerType.set(type, maxCount);
+    this.pools.set(type, []);
+  }
+  acquire(type) {
+    const bucket = this.pools.get(type);
+    if (!bucket || bucket.length === 0) return null;
+    return bucket.pop();
+  }
+  release(cell) {
+    const {
+      type
+    } = cell;
+    const bucket = this.pools.get(type);
+    const max = this.maxPerType.get(type);
+    if (!bucket || max === undefined) return;
+    cell.index = -1;
+    if (bucket.length >= max) return;
+    bucket.push(cell);
+  }
+  clear() {
+    for (const bucket of this.pools.values()) {
+      bucket.length = 0;
+    }
+  }
+  getPoolSize(type) {
+    return this.pools.get(type)?.length ?? 0;
+  }
+}
+exports.CellPool = CellPool;
+//# sourceMappingURL=CellPool.js.map

package/lib/commonjs/recycler/CellPool.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["CellPool","pools","Map","maxPerType","hasType","type","has","registerType","maxCount","set","acquire","bucket","get","length","pop","release","cell","max","undefined","index","push","clear","values","getPoolSize","exports"],"sourceRoot":"../../../src","sources":["recycler/CellPool.ts"],"mappings":";;;;;;AAGO,MAAMA,QAAQ,CAAC;EACHC,KAAK,GAAG,IAAIC,GAAG,CAAmC,CAAC;EACnDC,UAAU,GAAG,IAAID,GAAG,CAAmB,CAAC;;EAEzD;EACAE,OAAOA,CAACC,IAAc,EAAW;IAC/B,OAAO,IAAI,CAACJ,KAAK,CAACK,GAAG,CAACD,IAAI,CAAC;EAC7B;EAEAE,YAAYA,CAACF,IAAc,EAAEG,QAAgB,EAAQ;IACnD,IAAI,IAAI,CAACL,UAAU,CAACG,GAAG,CAACD,IAAI,CAAC,EAAE;IAC/B,IAAI,CAACF,UAAU,CAACM,GAAG,CAACJ,IAAI,EAAEG,QAAQ,CAAC;IACnC,IAAI,CAACP,KAAK,CAACQ,GAAG,CAACJ,IAAI,EAAE,EAAE,CAAC;EAC1B;EAEAK,OAAOA,CAACL,IAAc,EAA+B;IACnD,MAAMM,MAAM,GAAG,IAAI,CAACV,KAAK,CAACW,GAAG,CAACP,IAAI,CAAC;IACnC,IAAI,CAACM,MAAM,IAAIA,MAAM,CAACE,MAAM,KAAK,CAAC,EAAE,OAAO,IAAI;IAC/C,OAAOF,MAAM,CAACG,GAAG,CAAC,CAAC;EACrB;EAEAC,OAAOA,CAACC,IAA0B,EAAQ;IACxC,MAAM;MAAEX;IAAK,CAAC,GAAGW,IAAI;IACrB,MAAML,MAAM,GAAG,IAAI,CAACV,KAAK,CAACW,GAAG,CAACP,IAAI,CAAC;IACnC,MAAMY,GAAG,GAAG,IAAI,CAACd,UAAU,CAACS,GAAG,CAACP,IAAI,CAAC;IAErC,IAAI,CAACM,MAAM,IAAIM,GAAG,KAAKC,SAAS,EAAE;IAElCF,IAAI,CAACG,KAAK,GAAG,CAAC,CAAC;IAEf,IAAIR,MAAM,CAACE,MAAM,IAAII,GAAG,EAAE;IAC1BN,MAAM,CAACS,IAAI,CAACJ,IAAI,CAAC;EACnB;EAEAK,KAAKA,CAAA,EAAS;IACZ,KAAK,MAAMV,MAAM,IAAI,IAAI,CAACV,KAAK,CAACqB,MAAM,CAAC,CAAC,EAAE;MACxCX,MAAM,CAACE,MAAM,GAAG,CAAC;IACnB;EACF;EAEAU,WAAWA,CAAClB,IAAc,EAAU;IAClC,OAAO,IAAI,CAACJ,KAAK,CAACW,GAAG,CAACP,IAAI,CAAC,EAAEQ,MAAM,IAAI,CAAC;EAC1C;AACF;AAACW,OAAA,CAAAxB,QAAA,GAAAA,QAAA","ignoreList":[]}