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

package/android/src/main/java/com/onekey/nativelist/NativeListView.kt

@@ -592,6 +592,8 @@ class NativeListView(
   }
 
   private fun updateRefreshIndicatorOffset(offset: Int) {
+    // Let an ancestor render above its shared header without guessing caller offsets.
+    refreshLayout.setTag(R.id.onekey_native_scroll_coordinator_refresh_inset, offset)
     if (refreshIndicatorOffsetPx == offset) return
     refreshIndicatorOffsetPx = offset
     val refreshing = refreshLayout.isRefreshing

package/android/src/main/res/values/native_scroll_coordinator_ids.xml

@@ -1,4 +1,5 @@
 <resources>
     <item name="onekey_native_scroll_coordinator_consumed_offsets" type="id" />
     <item name="onekey_native_scroll_coordinator_offset_listener" type="id" />
+    <item name="onekey_native_scroll_coordinator_refresh_inset" type="id" />
 </resources>

package/docs/SPEC.md

@@ -526,6 +526,20 @@ The container does not emit a second haptic for the release fallback. The fallba
 inactive unless pull-to-refresh is enabled; no product-specific threshold is
 hardcoded into the module.
 
+## Android refresh foreground geometry
+
+Status: implemented; NFT/History Home placement verified on Android on 2026-09-28.
+The refresh container publishes its actual coordinator-added indicator inset in
+physical pixels under the native View tag
+`onekey_native_scroll_coordinator_refresh_inset`. Zero means no added inset;
+the value MUST match the offset actually applied by the existing controller,
+including all ancestor padding contributions. A coordinating outer Pager can
+subtract this metadata once when drawing the native indicator above shared
+headers. This metadata does not change refresh trigger distance, callback,
+refreshing state, ordinary-list placement or row templates. It introduces no
+JavaScript API or dependency on Pager classes. The value follows changes to the
+applied inset and remains valid while that inset is retained across detach.
+
 ## Native rich activity presentation
 
 Status: Source implemented; native runtime acceptance pending. Optional `amounts`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@onekeyfe/react-native-native-list",
-  "version": "3.0.157-alpha.255",
+  "version": "3.0.157-alpha.258",
   "description": "Template-driven native RecyclerView and UICollectionView for React Native",
   "source": "./src/index.ts",
   "main": "./lib/module/index.js",