react-native-nitro-list 0.0.1 → 0.1.1

package/nitrogen/generated/ios/swift/{HybridNitroListSpec_cxx.swift → HybridNitroLayoutEngineSpec_cxx.swift}

@@ -1,5 +1,5 @@
 ///
-/// HybridNitroListSpec_cxx.swift
+/// HybridNitroLayoutEngineSpec_cxx.swift
 /// 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 @@ import Foundation
 import NitroModules
 
 /**
- * A class implementation that bridges HybridNitroListSpec over to C++.
+ * A class implementation that bridges HybridNitroLayoutEngineSpec over to C++.
  * In C++, we cannot use Swift protocols - so we need to wrap it in a class to make it strongly defined.
  *
  * Also, some Swift types need to be bridged with special handling:
@@ -17,7 +17,7 @@ import NitroModules
  * - Other HybridObjects need to be wrapped/unwrapped from the Swift TCxx wrapper
  * - Throwing methods need to be wrapped with a Result<T, Error> type, as exceptions cannot be propagated to C++
  */
-open class HybridNitroListSpec_cxx {
+open class HybridNitroLayoutEngineSpec_cxx {
   /**
    * The Swift <> C++ bridge's namespace (`margelo::nitro::nitrolist::bridge::swift`)
    * from `NitroList-Swift-Cxx-Bridge.hpp`.
@@ -26,30 +26,30 @@ open class HybridNitroListSpec_cxx {
   public typealias bridge = margelo.nitro.nitrolist.bridge.swift
 
   /**
-   * Holds an instance of the `HybridNitroListSpec` Swift protocol.
+   * Holds an instance of the `HybridNitroLayoutEngineSpec` Swift protocol.
    */
-  private var __implementation: any HybridNitroListSpec
+  private var __implementation: any HybridNitroLayoutEngineSpec
 
   /**
    * Holds a weak pointer to the C++ class that wraps the Swift class.
    */
-  private var __cxxPart: bridge.std__weak_ptr_HybridNitroListSpec_
+  private var __cxxPart: bridge.std__weak_ptr_HybridNitroLayoutEngineSpec_
 
   /**
-   * Create a new `HybridNitroListSpec_cxx` that wraps the given `HybridNitroListSpec`.
+   * Create a new `HybridNitroLayoutEngineSpec_cxx` that wraps the given `HybridNitroLayoutEngineSpec`.
    * All properties and methods bridge to C++ types.
    */
-  public init(_ implementation: any HybridNitroListSpec) {
+  public init(_ implementation: any HybridNitroLayoutEngineSpec) {
     self.__implementation = implementation
     self.__cxxPart = .init()
     /* no base class */
   }
 
   /**
-   * Get the actual `HybridNitroListSpec` instance this class wraps.
+   * Get the actual `HybridNitroLayoutEngineSpec` instance this class wraps.
    */
   @inline(__always)
-  public func getHybridNitroListSpec() -> any HybridNitroListSpec {
+  public func getHybridNitroLayoutEngineSpec() -> any HybridNitroLayoutEngineSpec {
     return __implementation
   }
 
@@ -62,25 +62,25 @@ open class HybridNitroListSpec_cxx {
   }
 
   /**
-   * Casts an unsafe pointer to a `HybridNitroListSpec_cxx`.
-   * The pointer has to be a retained opaque `Unmanaged<HybridNitroListSpec_cxx>`.
+   * Casts an unsafe pointer to a `HybridNitroLayoutEngineSpec_cxx`.
+   * The pointer has to be a retained opaque `Unmanaged<HybridNitroLayoutEngineSpec_cxx>`.
    * This removes one strong reference from the object!
    */
-  public class func fromUnsafe(_ pointer: UnsafeMutableRawPointer) -> HybridNitroListSpec_cxx {
-    return Unmanaged<HybridNitroListSpec_cxx>.fromOpaque(pointer).takeRetainedValue()
+  public class func fromUnsafe(_ pointer: UnsafeMutableRawPointer) -> HybridNitroLayoutEngineSpec_cxx {
+    return Unmanaged<HybridNitroLayoutEngineSpec_cxx>.fromOpaque(pointer).takeRetainedValue()
   }
 
   /**
    * Gets (or creates) the C++ part of this Hybrid Object.
-   * The C++ part is a `std::shared_ptr<HybridNitroListSpec>`.
+   * The C++ part is a `std::shared_ptr<HybridNitroLayoutEngineSpec>`.
    */
-  public func getCxxPart() -> bridge.std__shared_ptr_HybridNitroListSpec_ {
+  public func getCxxPart() -> bridge.std__shared_ptr_HybridNitroLayoutEngineSpec_ {
     let cachedCxxPart = self.__cxxPart.lock()
     if Bool(fromCxx: cachedCxxPart) {
       return cachedCxxPart
     } else {
-      let newCxxPart = bridge.create_std__shared_ptr_HybridNitroListSpec_(self.toUnsafe())
-      __cxxPart = bridge.weakify_std__shared_ptr_HybridNitroListSpec_(newCxxPart)
+      let newCxxPart = bridge.create_std__shared_ptr_HybridNitroLayoutEngineSpec_(self.toUnsafe())
+      __cxxPart = bridge.weakify_std__shared_ptr_HybridNitroLayoutEngineSpec_(newCxxPart)
       return newCxxPart
     }
   }
@@ -114,27 +114,24 @@ open class HybridNitroListSpec_cxx {
   }
 
   // Properties
-  public final var isRed: Bool {
-    @inline(__always)
-    get {
-      return self.__implementation.isRed
-    }
-    @inline(__always)
-    set {
-      self.__implementation.isRed = newValue
-    }
-  }
+  
 
   // Methods
-  public final func getView() -> UnsafeMutableRawPointer {
-    return Unmanaged.passRetained(__implementation.view).toOpaque()
-  }
-  
-  public final func beforeUpdate() {
-    __implementation.beforeUpdate()
-  }
-  
-  public final func afterUpdate() {
-    __implementation.afterUpdate()
+  @inline(__always)
+  public final func computeLayout(containerWidth: Double, itemHeights: bridge.std__vector_double_) -> bridge.Result_std__vector_LayoutRectangle__ {
+    do {
+      let __result = try self.__implementation.computeLayout(containerWidth: containerWidth, itemHeights: itemHeights.map({ __item in __item }))
+      let __resultCpp = { () -> bridge.std__vector_LayoutRectangle_ in
+        var __vector = bridge.create_std__vector_LayoutRectangle_(__result.count)
+        for __item in __result {
+          __vector.push_back(__item)
+        }
+        return __vector
+      }()
+      return bridge.create_Result_std__vector_LayoutRectangle__(__resultCpp)
+    } catch (let __error) {
+      let __exceptionPtr = __error.toCpp()
+      return bridge.create_Result_std__vector_LayoutRectangle__(__exceptionPtr)
+    }
   }
 }

package/nitrogen/generated/ios/swift/LayoutRectangle.swift

@@ -0,0 +1,45 @@
+///
+/// LayoutRectangle.swift
+/// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+/// https://github.com/mrousavy/nitro
+/// Copyright © 2025 Marc Rousavy @ Margelo
+///
+
+import Foundation
+import NitroModules
+
+/**
+ * Represents an instance of `LayoutRectangle`, backed by a C++ struct.
+ */
+public typealias LayoutRectangle = margelo.nitro.nitrolist.LayoutRectangle
+
+public extension LayoutRectangle {
+  private typealias bridge = margelo.nitro.nitrolist.bridge.swift
+
+  /**
+   * Create a new instance of `LayoutRectangle`.
+   */
+  init(x: Double, y: Double, width: Double, height: Double) {
+    self.init(x, y, width, height)
+  }
+
+  @inline(__always)
+  var x: Double {
+    return self.__x
+  }
+  
+  @inline(__always)
+  var y: Double {
+    return self.__y
+  }
+  
+  @inline(__always)
+  var width: Double {
+    return self.__width
+  }
+  
+  @inline(__always)
+  var height: Double {
+    return self.__height
+  }
+}

package/nitrogen/generated/shared/c++/{HybridNitroListSpec.cpp → HybridNitroLayoutEngineSpec.cpp}

@@ -1,21 +1,20 @@
 ///
-/// HybridNitroListSpec.cpp
+/// HybridNitroLayoutEngineSpec.cpp
 /// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
 /// https://github.com/mrousavy/nitro
 /// Copyright © 2025 Marc Rousavy @ Margelo
 ///
 
-#include "HybridNitroListSpec.hpp"
+#include "HybridNitroLayoutEngineSpec.hpp"
 
 namespace margelo::nitro::nitrolist {
 
-  void HybridNitroListSpec::loadHybridMethods() {
+  void HybridNitroLayoutEngineSpec::loadHybridMethods() {
     // load base methods/properties
     HybridObject::loadHybridMethods();
     // load custom methods/properties
     registerHybrids(this, [](Prototype& prototype) {
-      prototype.registerHybridGetter("isRed", &HybridNitroListSpec::getIsRed);
-      prototype.registerHybridSetter("isRed", &HybridNitroListSpec::setIsRed);
+      prototype.registerHybridMethod("computeLayout", &HybridNitroLayoutEngineSpec::computeLayout);
     });
   }
 

package/nitrogen/generated/shared/c++/{HybridNitroListSpec.hpp → HybridNitroLayoutEngineSpec.hpp}

@@ -1,5 +1,5 @@
 ///
-/// HybridNitroListSpec.hpp
+/// HybridNitroLayoutEngineSpec.hpp
 /// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
 /// https://github.com/mrousavy/nitro
 /// Copyright © 2025 Marc Rousavy @ Margelo
@@ -13,43 +13,44 @@
 #error NitroModules cannot be found! Are you sure you installed NitroModules properly?
 #endif
 
+// Forward declaration of `LayoutRectangle` to properly resolve imports.
+namespace margelo::nitro::nitrolist { struct LayoutRectangle; }
 
-
-
+#include "LayoutRectangle.hpp"
+#include <vector>
 
 namespace margelo::nitro::nitrolist {
 
   using namespace margelo::nitro;
 
   /**
-   * An abstract base class for `NitroList`
-   * Inherit this class to create instances of `HybridNitroListSpec` in C++.
+   * An abstract base class for `NitroLayoutEngine`
+   * Inherit this class to create instances of `HybridNitroLayoutEngineSpec` in C++.
    * You must explicitly call `HybridObject`'s constructor yourself, because it is virtual.
    * @example
    * ```cpp
-   * class HybridNitroList: public HybridNitroListSpec {
+   * class HybridNitroLayoutEngine: public HybridNitroLayoutEngineSpec {
    * public:
-   *   HybridNitroList(...): HybridObject(TAG) { ... }
+   *   HybridNitroLayoutEngine(...): HybridObject(TAG) { ... }
    *   // ...
    * };
    * ```
    */
-  class HybridNitroListSpec: public virtual HybridObject {
+  class HybridNitroLayoutEngineSpec: public virtual HybridObject {
     public:
       // Constructor
-      explicit HybridNitroListSpec(): HybridObject(TAG) { }
+      explicit HybridNitroLayoutEngineSpec(): HybridObject(TAG) { }
 
       // Destructor
-      ~HybridNitroListSpec() override = default;
+      ~HybridNitroLayoutEngineSpec() override = default;
 
     public:
       // Properties
-      virtual bool getIsRed() = 0;
-      virtual void setIsRed(bool isRed) = 0;
+      
 
     public:
       // Methods
-      
+      virtual std::vector<LayoutRectangle> computeLayout(double containerWidth, const std::vector<double>& itemHeights) = 0;
 
     protected:
       // Hybrid Setup
@@ -57,7 +58,7 @@ namespace margelo::nitro::nitrolist {
 
     protected:
       // Tag for logging
-      static constexpr auto TAG = "NitroList";
+      static constexpr auto TAG = "NitroLayoutEngine";
   };
 
 } // namespace margelo::nitro::nitrolist

package/nitrogen/generated/shared/c++/LayoutRectangle.hpp

@@ -0,0 +1,95 @@
+///
+/// LayoutRectangle.hpp
+/// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+/// https://github.com/mrousavy/nitro
+/// Copyright © 2025 Marc Rousavy @ Margelo
+///
+
+#pragma once
+
+#if __has_include(<NitroModules/JSIConverter.hpp>)
+#include <NitroModules/JSIConverter.hpp>
+#else
+#error NitroModules cannot be found! Are you sure you installed NitroModules properly?
+#endif
+#if __has_include(<NitroModules/NitroDefines.hpp>)
+#include <NitroModules/NitroDefines.hpp>
+#else
+#error NitroModules cannot be found! Are you sure you installed NitroModules properly?
+#endif
+#if __has_include(<NitroModules/JSIHelpers.hpp>)
+#include <NitroModules/JSIHelpers.hpp>
+#else
+#error NitroModules cannot be found! Are you sure you installed NitroModules properly?
+#endif
+#if __has_include(<NitroModules/PropNameIDCache.hpp>)
+#include <NitroModules/PropNameIDCache.hpp>
+#else
+#error NitroModules cannot be found! Are you sure you installed NitroModules properly?
+#endif
+
+
+
+
+
+namespace margelo::nitro::nitrolist {
+
+  /**
+   * A struct which can be represented as a JavaScript object (LayoutRectangle).
+   */
+  struct LayoutRectangle final {
+  public:
+    double x     SWIFT_PRIVATE;
+    double y     SWIFT_PRIVATE;
+    double width     SWIFT_PRIVATE;
+    double height     SWIFT_PRIVATE;
+
+  public:
+    LayoutRectangle() = default;
+    explicit LayoutRectangle(double x, double y, double width, double height): x(x), y(y), width(width), height(height) {}
+
+  public:
+    friend bool operator==(const LayoutRectangle& lhs, const LayoutRectangle& rhs) = default;
+  };
+
+} // namespace margelo::nitro::nitrolist
+
+namespace margelo::nitro {
+
+  // C++ LayoutRectangle <> JS LayoutRectangle (object)
+  template <>
+  struct JSIConverter<margelo::nitro::nitrolist::LayoutRectangle> final {
+    static inline margelo::nitro::nitrolist::LayoutRectangle fromJSI(jsi::Runtime& runtime, const jsi::Value& arg) {
+      jsi::Object obj = arg.asObject(runtime);
+      return margelo::nitro::nitrolist::LayoutRectangle(
+        JSIConverter<double>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "x"))),
+        JSIConverter<double>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "y"))),
+        JSIConverter<double>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "width"))),
+        JSIConverter<double>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "height")))
+      );
+    }
+    static inline jsi::Value toJSI(jsi::Runtime& runtime, const margelo::nitro::nitrolist::LayoutRectangle& arg) {
+      jsi::Object obj(runtime);
+      obj.setProperty(runtime, PropNameIDCache::get(runtime, "x"), JSIConverter<double>::toJSI(runtime, arg.x));
+      obj.setProperty(runtime, PropNameIDCache::get(runtime, "y"), JSIConverter<double>::toJSI(runtime, arg.y));
+      obj.setProperty(runtime, PropNameIDCache::get(runtime, "width"), JSIConverter<double>::toJSI(runtime, arg.width));
+      obj.setProperty(runtime, PropNameIDCache::get(runtime, "height"), JSIConverter<double>::toJSI(runtime, arg.height));
+      return obj;
+    }
+    static inline bool canConvert(jsi::Runtime& runtime, const jsi::Value& value) {
+      if (!value.isObject()) {
+        return false;
+      }
+      jsi::Object obj = value.getObject(runtime);
+      if (!nitro::isPlainObject(runtime, obj)) {
+        return false;
+      }
+      if (!JSIConverter<double>::canConvert(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "x")))) return false;
+      if (!JSIConverter<double>::canConvert(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "y")))) return false;
+      if (!JSIConverter<double>::canConvert(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "width")))) return false;
+      if (!JSIConverter<double>::canConvert(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "height")))) return false;
+      return true;
+    }
+  };
+
+} // namespace margelo::nitro

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-native-nitro-list",
-  "version": "0.0.1",
+  "version": "0.1.1",
   "description": "react-native-nitro-list is a react native package built with Nitro",
   "main": "./lib/commonjs/index.js",
   "module": "./lib/module/index.js",
@@ -8,6 +8,9 @@
   "react-native": "src/index",
   "source": "src/index",
   "scripts": {
+    "publish:release": "./scripts/publish.sh",
+    "test": "npx jest --passWithNoTests",
+    "test:watch": "npx jest --watch",
     "typecheck": "tsc --noEmit",
     "clean": "git clean -dfX",
     "release": "semantic-release",
@@ -57,12 +60,14 @@
     "@semantic-release/git": "^10.0.1",
     "@types/jest": "^29.5.12",
     "@types/react": "19.2.0",
-    "nitrogen": "0.32.0",
+    "conventional-changelog-conventionalcommits": "^9.1.0",
+    "jest-environment-jsdom": "^30.2.0",
+    "nitrogen": "^0.32.0",
     "react": "19.2.0",
     "react-native": "0.83",
     "react-native-builder-bob": "^0.40.17",
     "react-native-nitro-modules": "0.32.0",
-    "conventional-changelog-conventionalcommits": "^9.1.0",
+    "react-test-renderer": "^19.2.0",
     "semantic-release": "^25.0.2",
     "typescript": "^5.8.3"
   },
@@ -118,5 +123,8 @@
         }
       ]
     ]
+  },
+  "dependencies": {
+    "nitro-modules": "^0.1.1"
   }
-}
+}

package/src/NitroList.ts

@@ -0,0 +1,8 @@
+import { requireNativeComponent } from 'react-native'
+
+export type NitroRecyclerViewProps = {
+  itemCount: number
+}
+
+export const NitroRecyclerView =
+  requireNativeComponent<NitroRecyclerViewProps>('NitroRecyclerView')

package/src/RecyclerList.internal.ts

@@ -0,0 +1,38 @@
+import type { LayoutRectangle } from './layout/LayoutRectangle'
+import type { ScrollMetrics } from './windowing/ScrollMetrics'
+import type { Cell } from './cell/Cell'
+
+import { useCellRenderer } from './hooks/useCellRenderer'
+
+/**
+ * INTERNAL hook.
+ * MUST ALWAYS CALL hooks in the same order.
+ */
+export function useRecyclerListInternal(
+  layouts: readonly LayoutRectangle[],
+  metrics: ScrollMetrics,
+  bufferPx: number,
+  getItemType: (index: number) => string
+): readonly Cell[] {
+
+  /**
+   * FlashList rule:
+   * Hooks are ALWAYS called.
+   * Inputs are guarded instead.
+   */
+  const safeLayouts =
+    metrics.height > 0 ? layouts : EMPTY_LAYOUTS
+
+  const safeBufferPx =
+    metrics.height > 0 ? bufferPx : 0
+
+  return useCellRenderer(
+    safeLayouts,
+    metrics,
+    safeBufferPx,
+    getItemType
+  )
+}
+
+/** Stable empty reference */
+const EMPTY_LAYOUTS: readonly LayoutRectangle[] = []