@onekeyfe/react-native-native-list 3.0.157-alpha.254 → 3.0.157-alpha.255

package/nitrogen/generated/ios/c++/views/HybridNativeListComponent.mm

@@ -35,6 +35,11 @@ using namespace margelo::nitro::nativelist::views;
 + (BOOL)shouldBeRecycled;
 @end
 
+@interface UIView (NativeListContainerSlots)
+- (void)mountContainerSlot:(UIView *)view atIndex:(NSInteger)index;
+- (void)unmountContainerSlot:(UIView *)view;
+@end
+
 @implementation HybridNativeListComponent {
   std::shared_ptr<HybridNativeListSpecSwift> _hybridView;
   BOOL _didDropView;
@@ -59,6 +64,15 @@ using namespace margelo::nitro::nativelist::views;
   return self;
 }
 
+// NativeList container slot mounting
+- (void)mountChildComponentView:(UIView<RCTComponentViewProtocol> *)child index:(NSInteger)index {
+  [self.contentView mountContainerSlot:child atIndex:index];
+}
+
+- (void)unmountChildComponentView:(UIView<RCTComponentViewProtocol> *)child index:(NSInteger)index {
+  [self.contentView unmountContainerSlot:child];
+}
+
 - (void) updateView {
   // 1. Get Swift part
   NativeListModule::HybridNativeListSpec_cxx& swiftPart = _hybridView->getSwiftPart();
@@ -104,6 +118,24 @@ using namespace margelo::nitro::nativelist::views;
           : !newViewProps.snapshotJson.hasSameValue(oldViewProps->snapshotJson)) {
       swiftPart.setSnapshotJson(newViewProps.snapshotJson.get());
     }
+    // containerSlotHeightsJson: string
+    if (oldViewProps == nullptr
+          ? newViewProps.containerSlotHeightsJson.isProvided()
+          : !newViewProps.containerSlotHeightsJson.hasSameValue(oldViewProps->containerSlotHeightsJson)) {
+      swiftPart.setContainerSlotHeightsJson(newViewProps.containerSlotHeightsJson.get());
+    }
+    // scrollPositionThresholdsJson: string
+    if (oldViewProps == nullptr
+          ? newViewProps.scrollPositionThresholdsJson.isProvided()
+          : !newViewProps.scrollPositionThresholdsJson.hasSameValue(oldViewProps->scrollPositionThresholdsJson)) {
+      swiftPart.setScrollPositionThresholdsJson(newViewProps.scrollPositionThresholdsJson.get());
+    }
+    // onScrollPositionThresholdChange: optional
+    if (oldViewProps == nullptr
+          ? newViewProps.onScrollPositionThresholdChange.isProvided()
+          : !newViewProps.onScrollPositionThresholdChange.hasSameValue(oldViewProps->onScrollPositionThresholdChange)) {
+      swiftPart.setOnScrollPositionThresholdChange(newViewProps.onScrollPositionThresholdChange.get());
+    }
     // keyboardDismissMode: enum
     if (oldViewProps == nullptr
           ? newViewProps.keyboardDismissMode.isProvided()

package/nitrogen/generated/ios/swift/Func_void_bool.swift

@@ -0,0 +1,46 @@
+///
+/// Func_void_bool.swift
+/// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+/// https://github.com/mrousavy/nitro
+/// Copyright © Marc Rousavy @ Margelo
+///
+
+import NitroModules
+
+/**
+ * Wraps a Swift `(_ isBeyondThreshold: Bool) -> Void` as a class.
+ * This class can be used from C++, e.g. to wrap the Swift closure as a `std::function`.
+ */
+public final class Func_void_bool {
+  public typealias bridge = margelo.nitro.nativelist.bridge.swift
+
+  private let closure: (_ isBeyondThreshold: Bool) -> Void
+
+  public init(_ closure: @escaping (_ isBeyondThreshold: Bool) -> Void) {
+    self.closure = closure
+  }
+
+  @inline(__always)
+  public func call(isBeyondThreshold: Bool) -> Void {
+    self.closure(isBeyondThreshold)
+  }
+
+  /**
+   * Casts this instance to a retained unsafe raw pointer.
+   * This acquires one additional strong reference on the object!
+   */
+  @inline(__always)
+  public func toUnsafe() -> UnsafeMutableRawPointer {
+    return Unmanaged.passRetained(self).toOpaque()
+  }
+
+  /**
+   * Casts an unsafe pointer to a `Func_void_bool`.
+   * The pointer has to be a retained opaque `Unmanaged<Func_void_bool>`.
+   * This removes one strong reference from the object!
+   */
+  @inline(__always)
+  public static func fromUnsafe(_ pointer: UnsafeMutableRawPointer) -> Func_void_bool {
+    return Unmanaged<Func_void_bool>.fromOpaque(pointer).takeRetainedValue()
+  }
+}

package/nitrogen/generated/ios/swift/HybridNativeListSpec.swift

@@ -11,6 +11,9 @@ import NitroModules
 public protocol HybridNativeListSpec_protocol: HybridObject, HybridView {
   // Properties
   var snapshotJson: String { get set }
+  var containerSlotHeightsJson: String { get set }
+  var scrollPositionThresholdsJson: String { get set }
+  var onScrollPositionThresholdChange: ((_ isBeyondThreshold: Bool) -> Void)? { get set }
   var keyboardDismissMode: NativeListKeyboardDismissMode { get set }
   var keyboardShouldPersistTaps: NativeListKeyboardShouldPersistTaps { get set }
   var onRowAction: ((_ payloadJson: String) -> Void)? { get set }

package/nitrogen/generated/ios/swift/HybridNativeListSpec_cxx.swift

@@ -132,6 +132,60 @@ open class HybridNativeListSpec_cxx {
     }
   }
   
+  public final var containerSlotHeightsJson: std.string {
+    @inline(__always)
+    get {
+      return std.string(self.__implementation.containerSlotHeightsJson)
+    }
+    @inline(__always)
+    set {
+      self.__implementation.containerSlotHeightsJson = String(newValue)
+    }
+  }
+  
+  public final var scrollPositionThresholdsJson: std.string {
+    @inline(__always)
+    get {
+      return std.string(self.__implementation.scrollPositionThresholdsJson)
+    }
+    @inline(__always)
+    set {
+      self.__implementation.scrollPositionThresholdsJson = String(newValue)
+    }
+  }
+  
+  public final var onScrollPositionThresholdChange: bridge.std__optional_std__function_void_bool____isBeyondThreshold______ {
+    @inline(__always)
+    get {
+      return { () -> bridge.std__optional_std__function_void_bool____isBeyondThreshold______ in
+        if let __unwrappedValue = self.__implementation.onScrollPositionThresholdChange {
+          return bridge.create_std__optional_std__function_void_bool____isBeyondThreshold______({ () -> bridge.Func_void_bool in
+            let __closureWrapper = Func_void_bool(__unwrappedValue)
+            return bridge.create_Func_void_bool(__closureWrapper.toUnsafe())
+          }())
+        } else {
+          return .init()
+        }
+      }()
+    }
+    @inline(__always)
+    set {
+      self.__implementation.onScrollPositionThresholdChange = { () -> ((_ isBeyondThreshold: Bool) -> Void)? in
+        if bridge.has_value_std__optional_std__function_void_bool____isBeyondThreshold______(newValue) {
+          let __unwrapped = bridge.get_std__optional_std__function_void_bool____isBeyondThreshold______(newValue)
+          return { () -> (Bool) -> Void in
+            let __wrappedFunction = bridge.wrap_Func_void_bool(__unwrapped)
+            return { (__isBeyondThreshold: Bool) -> Void in
+              __wrappedFunction.call(__isBeyondThreshold)
+            }
+          }()
+        } else {
+          return nil
+        }
+      }()
+    }
+  }
+  
   public final var keyboardDismissMode: Int32 {
     @inline(__always)
     get {

package/nitrogen/generated/shared/c++/HybridNativeListSpec.cpp

@@ -16,6 +16,12 @@ namespace margelo::nitro::nativelist {
     registerHybrids(this, [](Prototype& prototype) {
       prototype.registerHybridGetter("snapshotJson", &HybridNativeListSpec::getSnapshotJson);
       prototype.registerHybridSetter("snapshotJson", &HybridNativeListSpec::setSnapshotJson);
+      prototype.registerHybridGetter("containerSlotHeightsJson", &HybridNativeListSpec::getContainerSlotHeightsJson);
+      prototype.registerHybridSetter("containerSlotHeightsJson", &HybridNativeListSpec::setContainerSlotHeightsJson);
+      prototype.registerHybridGetter("scrollPositionThresholdsJson", &HybridNativeListSpec::getScrollPositionThresholdsJson);
+      prototype.registerHybridSetter("scrollPositionThresholdsJson", &HybridNativeListSpec::setScrollPositionThresholdsJson);
+      prototype.registerHybridGetter("onScrollPositionThresholdChange", &HybridNativeListSpec::getOnScrollPositionThresholdChange);
+      prototype.registerHybridSetter("onScrollPositionThresholdChange", &HybridNativeListSpec::setOnScrollPositionThresholdChange);
       prototype.registerHybridGetter("keyboardDismissMode", &HybridNativeListSpec::getKeyboardDismissMode);
       prototype.registerHybridSetter("keyboardDismissMode", &HybridNativeListSpec::setKeyboardDismissMode);
       prototype.registerHybridGetter("keyboardShouldPersistTaps", &HybridNativeListSpec::getKeyboardShouldPersistTaps);

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

@@ -21,10 +21,10 @@ namespace margelo::nitro::nativelist { enum class NativeListKeyboardShouldPersis
 namespace margelo::nitro::nativelist { enum class NativeListScrollAlignment; }
 
 #include <string>
-#include "NativeListKeyboardDismissMode.hpp"
-#include "NativeListKeyboardShouldPersistTaps.hpp"
 #include <functional>
 #include <optional>
+#include "NativeListKeyboardDismissMode.hpp"
+#include "NativeListKeyboardShouldPersistTaps.hpp"
 #include "NativeListScrollAlignment.hpp"
 
 namespace margelo::nitro::nativelist {
@@ -56,6 +56,12 @@ namespace margelo::nitro::nativelist {
       // Properties
       virtual std::string getSnapshotJson() = 0;
       virtual void setSnapshotJson(const std::string& snapshotJson) = 0;
+      virtual std::string getContainerSlotHeightsJson() = 0;
+      virtual void setContainerSlotHeightsJson(const std::string& containerSlotHeightsJson) = 0;
+      virtual std::string getScrollPositionThresholdsJson() = 0;
+      virtual void setScrollPositionThresholdsJson(const std::string& scrollPositionThresholdsJson) = 0;
+      virtual std::optional<std::function<void(bool /* isBeyondThreshold */)>> getOnScrollPositionThresholdChange() = 0;
+      virtual void setOnScrollPositionThresholdChange(const std::optional<std::function<void(bool /* isBeyondThreshold */)>>& onScrollPositionThresholdChange) = 0;
       virtual NativeListKeyboardDismissMode getKeyboardDismissMode() = 0;
       virtual void setKeyboardDismissMode(NativeListKeyboardDismissMode keyboardDismissMode) = 0;
       virtual NativeListKeyboardShouldPersistTaps getKeyboardShouldPersistTaps() = 0;

package/nitrogen/generated/shared/c++/views/HybridNativeListComponent.cpp

@@ -21,6 +21,9 @@ namespace margelo::nitro::nativelist::views {
                                                const react::RawProps& rawProps):
     react::ViewProps(context, sourceProps, rawProps, filterObjectKeys),
     snapshotJson(nitro::ReactProp<std::string>::fromRawValue("NativeList", "snapshotJson", rawProps, sourceProps.snapshotJson)),
+    containerSlotHeightsJson(nitro::ReactProp<std::string>::fromRawValue("NativeList", "containerSlotHeightsJson", rawProps, sourceProps.containerSlotHeightsJson)),
+    scrollPositionThresholdsJson(nitro::ReactProp<std::string>::fromRawValue("NativeList", "scrollPositionThresholdsJson", rawProps, sourceProps.scrollPositionThresholdsJson)),
+    onScrollPositionThresholdChange(nitro::ReactProp<std::optional<std::function<void(bool /* isBeyondThreshold */)>>>::fromRawValue("NativeList", "onScrollPositionThresholdChange", rawProps, sourceProps.onScrollPositionThresholdChange)),
     keyboardDismissMode(nitro::ReactProp<NativeListKeyboardDismissMode>::fromRawValue("NativeList", "keyboardDismissMode", rawProps, sourceProps.keyboardDismissMode)),
     keyboardShouldPersistTaps(nitro::ReactProp<NativeListKeyboardShouldPersistTaps>::fromRawValue("NativeList", "keyboardShouldPersistTaps", rawProps, sourceProps.keyboardShouldPersistTaps)),
     onRowAction(nitro::ReactProp<std::optional<std::function<void(const std::string& /* payloadJson */)>>>::fromRawValue("NativeList", "onRowAction", rawProps, sourceProps.onRowAction)),
@@ -34,6 +37,9 @@ namespace margelo::nitro::nativelist::views {
   bool HybridNativeListProps::filterObjectKeys(const std::string& propName) {
     switch (hashString(propName)) {
       case hashString("snapshotJson"): return true;
+      case hashString("containerSlotHeightsJson"): return true;
+      case hashString("scrollPositionThresholdsJson"): return true;
+      case hashString("onScrollPositionThresholdChange"): return true;
       case hashString("keyboardDismissMode"): return true;
       case hashString("keyboardShouldPersistTaps"): return true;
       case hashString("onRowAction"): return true;

package/nitrogen/generated/shared/c++/views/HybridNativeListComponent.hpp

@@ -18,10 +18,10 @@
 #include <string>
 
 #include <string>
-#include "NativeListKeyboardDismissMode.hpp"
-#include "NativeListKeyboardShouldPersistTaps.hpp"
 #include <functional>
 #include <optional>
+#include "NativeListKeyboardDismissMode.hpp"
+#include "NativeListKeyboardShouldPersistTaps.hpp"
 #include <memory>
 #include "HybridNativeListSpec.hpp"
 
@@ -46,6 +46,9 @@ namespace margelo::nitro::nativelist::views {
 
   public:
     nitro::ReactProp<std::string> snapshotJson;
+    nitro::ReactProp<std::string> containerSlotHeightsJson;
+    nitro::ReactProp<std::string> scrollPositionThresholdsJson;
+    nitro::ReactProp<std::optional<std::function<void(bool /* isBeyondThreshold */)>>> onScrollPositionThresholdChange;
     nitro::ReactProp<NativeListKeyboardDismissMode> keyboardDismissMode;
     nitro::ReactProp<NativeListKeyboardShouldPersistTaps> keyboardShouldPersistTaps;
     nitro::ReactProp<std::optional<std::function<void(const std::string& /* payloadJson */)>>> onRowAction;
@@ -59,6 +62,9 @@ namespace margelo::nitro::nativelist::views {
     [[nodiscard]]
     bool hasSameProps(const HybridNativeListProps& other) const noexcept {
       return snapshotJson.hasSameValue(other.snapshotJson) &&
+             containerSlotHeightsJson.hasSameValue(other.containerSlotHeightsJson) &&
+             scrollPositionThresholdsJson.hasSameValue(other.scrollPositionThresholdsJson) &&
+             onScrollPositionThresholdChange.hasSameValue(other.onScrollPositionThresholdChange) &&
              keyboardDismissMode.hasSameValue(other.keyboardDismissMode) &&
              keyboardShouldPersistTaps.hasSameValue(other.keyboardShouldPersistTaps) &&
              onRowAction.hasSameValue(other.onRowAction) &&
@@ -73,6 +79,9 @@ namespace margelo::nitro::nativelist::views {
     [[nodiscard]]
     bool hasAnyProvidedProps() const noexcept {
       return snapshotJson.isProvided() ||
+             containerSlotHeightsJson.isProvided() ||
+             scrollPositionThresholdsJson.isProvided() ||
+             onScrollPositionThresholdChange.isProvided() ||
              keyboardDismissMode.isProvided() ||
              keyboardShouldPersistTaps.isProvided() ||
              onRowAction.isProvided() ||

package/nitrogen/generated/shared/json/NativeListConfig.json

@@ -5,6 +5,9 @@
   "directEventTypes": {},
   "validAttributes": {
     "snapshotJson": true,
+    "containerSlotHeightsJson": true,
+    "scrollPositionThresholdsJson": true,
+    "onScrollPositionThresholdChange": true,
     "keyboardDismissMode": true,
     "keyboardShouldPersistTaps": true,
     "onRowAction": true,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@onekeyfe/react-native-native-list",
-  "version": "3.0.157-alpha.254",
+  "version": "3.0.157-alpha.255",
   "description": "Template-driven native RecyclerView and UICollectionView for React Native",
   "source": "./src/index.ts",
   "main": "./lib/module/index.js",
@@ -30,12 +30,13 @@
     "!android/build",
     "!android/app/build",
     "!**/__tests__",
-    "!**/*.map"
+    "!**/*.map",
+    "scripts"
   ],
   "scripts": {
     "clean": "del-cli lib",
     "prepare": "del-cli lib && bob build && cp -r nitrogen lib/nitrogen",
-    "nitrogen": "nitrogen",
+    "nitrogen": "nitrogen && node scripts/enable-container-slots.mjs",
     "typecheck": "tsc -b",
     "lint": "eslint \"**/*.{js,ts,tsx}\"",
     "test": "jest --runInBand",
@@ -83,8 +84,8 @@
     "typescript": "^5.9.2"
   },
   "peerDependencies": {
-    "@onekeyfe/react-native-image": "3.0.157-alpha.254",
-    "@onekeyfe/react-native-native-logger": "3.0.157-alpha.254",
+    "@onekeyfe/react-native-image": "3.0.157-alpha.255",
+    "@onekeyfe/react-native-native-logger": "3.0.157-alpha.255",
     "react": "*",
     "react-native": "*",
     "react-native-nitro-modules": "0.37.0"

package/scripts/enable-container-slots.mjs

@@ -0,0 +1,58 @@
+// Nitro 0.37 emits leaf view managers. Container slots need explicit Fabric
+// child ownership, reapplied deterministically after every nitrogen build.
+import { readFileSync, writeFileSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const root = join(dirname(fileURLToPath(import.meta.url)), '..');
+const android = join(root, 'nitrogen/generated/android/kotlin/com/margelo/nitro/nativelist/views/HybridNativeListManager.kt');
+const ios = join(root, 'nitrogen/generated/ios/c++/views/HybridNativeListComponent.mm');
+const marker = '// NativeList container slot mounting';
+let kotlin = readFileSync(android, 'utf8');
+if (!kotlin.includes(marker)) {
+  if (!kotlin.includes('SimpleViewManager<View>')) throw new Error('Unexpected Nitro Android manager shape');
+  kotlin = kotlin.replace('import android.view.View\n', 'import android.view.View\nimport android.view.ViewGroup\n');
+  kotlin = kotlin.replace('import com.facebook.react.uimanager.SimpleViewManager', 'import com.facebook.react.uimanager.ViewGroupManager');
+  kotlin = kotlin.replace('SimpleViewManager<View>()', 'ViewGroupManager<ViewGroup>()');
+  kotlin = kotlin.replaceAll('view: View', 'view: ViewGroup');
+  kotlin = kotlin.replace('): View {', '): ViewGroup {').replace('): View? {', '): ViewGroup? {');
+  kotlin = kotlin.replace('val view = hybridView.view', 'val view = hybridView.view as ViewGroup');
+  kotlin = kotlin.replace('return hybridView.view', 'return hybridView.view as ViewGroup');
+  kotlin = kotlin.replace('  override fun getName(): String {', `  ${marker}
+  override fun needsCustomLayoutForChildren(): Boolean = true
+  override fun addView(parent: ViewGroup, child: View, index: Int) {
+    (parent as NativeListView).mountContainerSlot(child, index)
+  }
+  override fun getChildCount(parent: ViewGroup): Int = (parent as NativeListView).containerSlotCount()
+  override fun getChildAt(parent: ViewGroup, index: Int): View = (parent as NativeListView).containerSlotAt(index)
+  override fun removeViewAt(parent: ViewGroup, index: Int) {
+    (parent as NativeListView).unmountContainerSlot(index)
+  }
+  override fun removeAllViews(parent: ViewGroup) {
+    while (getChildCount(parent) > 0) removeViewAt(parent, getChildCount(parent) - 1)
+  }
+
+  override fun getName(): String {`);
+  writeFileSync(android, kotlin);
+}
+let objc = readFileSync(ios, 'utf8');
+if (!objc.includes(marker)) {
+  if (!objc.includes('- (void) updateView {')) throw new Error('Unexpected Nitro iOS component shape');
+  objc = objc.replace('@implementation HybridNativeListComponent {', `@interface UIView (NativeListContainerSlots)
+- (void)mountContainerSlot:(UIView *)view atIndex:(NSInteger)index;
+- (void)unmountContainerSlot:(UIView *)view;
+@end
+
+@implementation HybridNativeListComponent {`);
+  objc = objc.replace('- (void) updateView {', `${marker}
+- (void)mountChildComponentView:(UIView<RCTComponentViewProtocol> *)child index:(NSInteger)index {
+  [self.contentView mountContainerSlot:child atIndex:index];
+}
+
+- (void)unmountChildComponentView:(UIView<RCTComponentViewProtocol> *)child index:(NSInteger)index {
+  [self.contentView unmountContainerSlot:child];
+}
+
+- (void) updateView {`);
+  writeFileSync(ios, objc);
+}

package/scripts/enable-container-slots.test.mjs

@@ -0,0 +1,58 @@
+import assert from 'node:assert/strict';
+import { execFileSync, spawnSync } from 'node:child_process';
+import { mkdtempSync, mkdirSync, readFileSync, rmSync, writeFileSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { dirname, join } from 'node:path';
+import { test } from 'node:test';
+import { fileURLToPath } from 'node:url';
+
+const script = readFileSync(join(dirname(fileURLToPath(import.meta.url)), 'enable-container-slots.mjs'), 'utf8');
+const androidPath = 'nitrogen/generated/android/kotlin/com/margelo/nitro/nativelist/views/HybridNativeListManager.kt';
+const iosPath = 'nitrogen/generated/ios/c++/views/HybridNativeListComponent.mm';
+
+function fixture(android, ios) {
+  const root = mkdtempSync(join(tmpdir(), 'native-list-slots-'));
+  for (const [relative, content] of [['scripts/enable-container-slots.mjs', script], [androidPath, android], [iosPath, ios]]) {
+    const path = join(root, relative);
+    mkdirSync(dirname(path), { recursive: true });
+    writeFileSync(path, content);
+  }
+  return root;
+}
+
+test('post-nitrogen child ownership transformation is idempotent', () => {
+  const root = fixture(`import android.view.View
+import com.facebook.react.uimanager.SimpleViewManager
+public class HybridNativeListManager: SimpleViewManager<View>() {
+  override fun getName(): String { return "NativeList" }
+  override fun createViewInstance(reactContext: ThemedReactContext): View {
+    val view = hybridView.view
+    return view
+  }
+}`, `@implementation HybridNativeListComponent {
+}
+- (void) updateView {
+}`);
+  try {
+    const path = join(root, 'scripts/enable-container-slots.mjs');
+    execFileSync(process.execPath, [path]);
+    const firstAndroid = readFileSync(join(root, androidPath), 'utf8');
+    const firstIOS = readFileSync(join(root, iosPath), 'utf8');
+    assert.match(firstAndroid, /ViewGroupManager<ViewGroup>/);
+    assert.match(firstAndroid, /unmountContainerSlot\(index\)/);
+    assert.match(firstIOS, /mountChildComponentView/);
+    assert.match(firstIOS, /unmountContainerSlot:child/);
+    execFileSync(process.execPath, [path]);
+    assert.equal(readFileSync(join(root, androidPath), 'utf8'), firstAndroid);
+    assert.equal(readFileSync(join(root, iosPath), 'utf8'), firstIOS);
+  } finally { rmSync(root, { recursive: true, force: true }); }
+});
+
+test('unexpected nitrogen output fails instead of silently losing child mounting', () => {
+  const root = fixture('unrecognized generator output', '- (void) updateView {');
+  try {
+    const result = spawnSync(process.execPath, [join(root, 'scripts/enable-container-slots.mjs')]);
+    assert.notEqual(result.status, 0);
+    assert.match(result.stderr.toString(), /Unexpected Nitro Android manager shape/);
+  } finally { rmSync(root, { recursive: true, force: true }); }
+});

package/src/NativeList.nitro.ts

@@ -11,6 +11,9 @@ import type {
  */
 export interface NativeListNativeProps extends HybridViewProps {
   snapshotJson: string;
+  containerSlotHeightsJson: string;
+  scrollPositionThresholdsJson: string;
+  onScrollPositionThresholdChange?: (isBeyondThreshold: boolean) => void;
   keyboardDismissMode: NativeListKeyboardDismissMode;
   keyboardShouldPersistTaps: NativeListKeyboardShouldPersistTaps;
   onRowAction?: (payloadJson: string) => void;

package/src/NativeList.tsx

@@ -4,6 +4,7 @@ import React, {
   useImperativeHandle,
   useMemo,
   useRef,
+  useState,
 } from 'react';
 import {
   OneKeyImageCache,
@@ -13,6 +14,7 @@ import {
   NativeAvatarPrefetchModel,
   NativeAvatarPrefetchQueue,
 } from './avatarPrefetch';
+import { View } from 'react-native';
 import { callback, getHostComponent } from 'react-native-nitro-modules';
 import type {
   NativeListMethods,
@@ -96,6 +98,10 @@ export const NativeList = forwardRef<NativeListRef, NativeListProps>(
   function NativeList(
     {
       snapshot,
+      listHeader,
+      listFooter,
+      listEmpty,
+      scrollPositionThresholds,
       webVirtualizationEnabled: _webVirtualizationEnabled,
       webSectionIndexContainerRef: _webSectionIndexContainerRef,
       keyboardDismissMode = 'none',
@@ -106,6 +112,7 @@ export const NativeList = forwardRef<NativeListRef, NativeListProps>(
       onReorder,
       onEndReached,
       onVisibleRangeChanged,
+      onScrollPositionThresholdChange,
       onRefresh,
       onScrollToIndexFailed,
       initialScrollIndex,
@@ -116,6 +123,21 @@ export const NativeList = forwardRef<NativeListRef, NativeListProps>(
     },
     forwardedRef
   ) {
+    const [slotHeights, setSlotHeights] = useState([0, 0, 0]);
+    const containerSlotHeightsJson = JSON.stringify(slotHeights);
+    const slotInset =
+      snapshot.layout.contentPaddingHorizontal ??
+      snapshot.layout.contentPadding ??
+      0;
+    if (
+      snapshot.layout.orientation === 'horizontal' &&
+      (listHeader || listEmpty || listFooter)
+    ) {
+      throw new Error(
+        'NativeList container slots require vertical orientation'
+      );
+    }
+    const slotContents = [listHeader, listEmpty, listFooter];
     const normalizedKeyboardShouldPersistTaps =
       keyboardShouldPersistTaps === true
         ? 'always'
@@ -130,6 +152,7 @@ export const NativeList = forwardRef<NativeListRef, NativeListProps>(
       onReorder,
       onEndReached,
       onVisibleRangeChanged,
+      onScrollPositionThresholdChange,
       onRefresh,
       onScrollToIndexFailed,
     });
@@ -140,9 +163,29 @@ export const NativeList = forwardRef<NativeListRef, NativeListProps>(
       onReorder,
       onEndReached,
       onVisibleRangeChanged,
+      onScrollPositionThresholdChange,
       onRefresh,
       onScrollToIndexFailed,
     };
+    const scrollPositionThresholdsJson = useMemo(() => {
+      if (
+        !scrollPositionThresholds ||
+        scrollPositionThresholds.enabled === false
+      )
+        return '';
+      const { start, end } = scrollPositionThresholds;
+      if (
+        !Number.isFinite(start) ||
+        !Number.isFinite(end) ||
+        start < 0 ||
+        end <= start
+      ) {
+        throw new Error(
+          'scrollPositionThresholds requires 0 <= start < end and finite values'
+        );
+      }
+      return JSON.stringify({ start, end });
+    }, [scrollPositionThresholds]);
     const snapshotJson = useMemo(() => serializeSnapshot(snapshot), [snapshot]);
     const snapshotRef = useRef(snapshot);
     const previousSnapshotJsonRef = useRef(snapshotJson);
@@ -391,8 +434,13 @@ export const NativeList = forwardRef<NativeListRef, NativeListProps>(
         }),
         onRowAction: callback((payloadJson: string) => {
           const payload = parsePayload<RowActionEvent>(payloadJson);
-          if (payload.actionKey === 'nativeList.refresh')
+          if (
+            payload.actionKey === 'nativeList.refresh' &&
+            payload.rowKey === undefined
+          ) {
             callbacksRef.current.onRefresh?.();
+            return;
+          }
           callbacksRef.current.onRowAction?.(payload);
         }),
         onActionAnchorInvalidated: callback((payloadJson: string) => {
@@ -427,6 +475,13 @@ export const NativeList = forwardRef<NativeListRef, NativeListProps>(
             parsePayload<EndReachedEvent>(payloadJson)
           );
         }),
+        onScrollPositionThresholdChange: callback(
+          (isBeyondThreshold: boolean) => {
+            callbacksRef.current.onScrollPositionThresholdChange?.({
+              isBeyondThreshold,
+            });
+          }
+        ),
         onVisibleRangeChanged: callback((payloadJson: string) => {
           const payload = parsePayload<VisibleRangeChangedEvent>(payloadJson);
           const previous = avatarRangeRef.current;
@@ -450,9 +505,36 @@ export const NativeList = forwardRef<NativeListRef, NativeListProps>(
         {...viewProps}
         {...nativeCallbacks}
         snapshotJson={snapshotJson}
+        containerSlotHeightsJson={containerSlotHeightsJson}
+        scrollPositionThresholdsJson={scrollPositionThresholdsJson}
         keyboardDismissMode={keyboardDismissMode}
         keyboardShouldPersistTaps={normalizedKeyboardShouldPersistTaps}
-      />
+      >
+        {slotContents.map((content, index) => (
+          <View
+            key={index}
+            collapsable={false}
+            style={{
+              position: 'absolute',
+              left: slotInset,
+              right: slotInset,
+              top: 0,
+            }}
+            onLayout={(event) => {
+              const height = Math.ceil(event.nativeEvent.layout.height);
+              setSlotHeights((previous) =>
+                previous[index] === height
+                  ? previous
+                  : previous.map((value, slot) =>
+                      slot === index ? height : value
+                    )
+              );
+            }}
+          >
+            {content}
+          </View>
+        ))}
+      </NativeListHost>
     );
   }
 );

package/src/NativeList.types.ts

@@ -1,4 +1,4 @@
-import type { RefObject } from 'react';
+import type { ReactNode, RefObject } from 'react';
 import type { View, ViewProps } from 'react-native';
 import type {
   ActionAnchorInvalidatedEvent,
@@ -119,6 +119,10 @@ export type NativeListRef = Readonly<{
 export type NativeListProps = Omit<ViewProps, 'children'> &
   Readonly<{
     snapshot: NativeListSnapshot;
+    /** Native-only, container-owned scroll content. Never rendered as a data row. */
+    listHeader?: ReactNode;
+    listFooter?: ReactNode;
+    listEmpty?: ReactNode;
     /** Web only. Defaults to true and is ignored by the native host. */
     webVirtualizationEnabled?: boolean;
     /** Web only. Hosts the section index inside this container. */
@@ -136,6 +140,15 @@ export type NativeListProps = Omit<ViewProps, 'children'> &
     onReorder?: (event: ReorderEvent) => void;
     onEndReached?: (event: EndReachedEvent) => void;
     onVisibleRangeChanged?: (event: VisibleRangeChangedEvent) => void;
+    /** Native only. Emits initial state and hysteresis transitions, not scroll frames. */
+    scrollPositionThresholds?: Readonly<{
+      start: number;
+      end: number;
+      enabled?: boolean;
+    }>;
+    onScrollPositionThresholdChange?: (
+      event: Readonly<{ isBeyondThreshold: boolean }>
+    ) => void;
     onRefresh?: () => void;
     onScrollToIndexFailed?: (info: ScrollToIndexFailedInfo) => void;
   }> &

package/src/NativeList.web.tsx

@@ -82,6 +82,11 @@ export const NativeList = forwardRef<NativeListRef, NativeListProps>(
   function NativeList(
     {
       snapshot,
+      listHeader: _listHeader,
+      listEmpty: _listEmpty,
+      listFooter: _listFooter,
+      scrollPositionThresholds: _scrollPositionThresholds,
+      onScrollPositionThresholdChange: _onScrollPositionThresholdChange,
       webVirtualizationEnabled = true,
       webSectionIndexContainerRef,
       keyboardDismissMode: _keyboardDismissMode,