@onekeyfe/react-native-pager-view 3.0.159 → 3.0.161

package/docs/SPEC.md

@@ -329,18 +329,22 @@ retained-page switching, clipping and nested-owner cleanup. Programmatic UIKit
 unit tests do not substitute for real pull-gesture visibility acceptance.
 
 When a smooth shared header is attached to the active iOS scroll view, UIKit's
-temporary refresh top inset MUST NOT add a second downward displacement to that
-header. The pager uses its own applied top inset as the baseline and cancels only
-the refresh-added visual displacement. The scroll view's inset and offset, the
-refresh indicator, and refresh callback ownership remain unchanged. Removing the
-refresh inset or control reapplies the header position immediately, even without
-a scroll-offset event. Caller inset changes update the pager baseline before the
-header position is reapplied. Detaching the header restores its normal
-transform. This applies to RN NativeScroller and NativeList pages; non-smooth
-and detached headers keep their existing positioning. The 2026-09-30 Home Spot
-simulator checkpoint covers
-an active refresh with repeated vertical swipes and subsequent inset removal;
-other Home pages and physical-device acceptance remain open.
+temporary refresh top inset MUST keep the header and content aligned. Both are
+children of that scroll view and move together with its content offset; the
+pager MUST NOT apply a separate refresh translation to the header. The scroll
+view's inset and offset, the refresh indicator, and refresh callback ownership
+remain unchanged. Removing the refresh inset or control preserves this alignment
+even without a scroll-offset event. Caller inset changes update the pager
+baseline. The sticky tab row MUST pin against the baseline top inset; the
+refresh control's temporary inset MUST NOT move it below the content, including
+rapid direction reversals while the spinner is active. Detaching the header
+restores its normal transform. This applies to RN NativeScroller and NativeList
+pages; non-smooth and detached headers keep
+their existing positioning. The 2026-09-30 Home Spot simulator checkpoint covers
+shared header/content alignment and inset removal. A separate source-identical
+local package build verified the sticky row during active-refresh vertical
+reversals; published-package, other Home pages and physical-device acceptance
+remain open.
 
 ## iOS shared-header hit testing
 

package/ios/RNCCollapsiblePagerViewComponentView.mm

@@ -3042,16 +3042,15 @@ static void RNCLogNativeTabScrollBoundary(NSString *owner,
   BOOL attachedToList = _nativeSmoothHeaderScrollEnabled &&
     _sharedHeaderScrollView != nil && !_sharedHeadersLiftedForPagerTransition;
   if (attachedToList) {
-    // UIRefreshControl temporarily adds a top inset while refreshing. The
-    // shared header lives in that scroll view, so exclude only that inset from
-    // its visual position while keeping the list's pull and indicator intact.
-    NSNumber *pagerTopInset = [_appliedTopInsets objectForKey:_sharedHeaderScrollView];
-    CGFloat refreshInset = _sharedHeaderScrollView.refreshControl != nil && pagerTopInset != nil
-      ? MAX(0, _sharedHeaderScrollView.contentInset.top - pagerTopInset.doubleValue)
-      : 0;
-    _sharedHeaderHostView.transform = CGAffineTransformMakeTranslation(0, -refreshInset);
+    // The header and content share this scroll view. UIKit's refresh inset
+    // moves both together, so translating the header would separate them.
+    _sharedHeaderHostView.transform = CGAffineTransformIdentity;
     _headerView.transform = CGAffineTransformIdentity;
-    CGFloat pinnedTranslation = MAX(0, _currentLogicalOffset - _headerHeight);
+    UIScrollView *scrollView = _sharedHeaderScrollView;
+    NSNumber *appliedTop = [_appliedTopInsets objectForKey:scrollView];
+    CGFloat refreshInset = scrollView.refreshControl != nil && appliedTop != nil
+      ? MAX(0, scrollView.contentInset.top - appliedTop.doubleValue) : 0;
+    CGFloat pinnedTranslation = MAX(0, _currentLogicalOffset - _headerHeight - refreshInset);
     CGAffineTransform stickyTransform = CGAffineTransformMakeTranslation(0, pinnedTranslation);
     _stickyHeaderView.transform = stickyTransform;
     _nativeTabBarView.transform = stickyTransform;

package/ios/tests/RNCCollapsiblePagerRefreshControlTests.mm

@@ -185,27 +185,36 @@
   scroll.refreshControl = [UIRefreshControl new];
   scroll.contentSize = CGSizeMake(320, 2000);
   scroll.contentInset = UIEdgeInsetsMake(232, 0, 0, 0);
+  UIView *content = [[UIView alloc] initWithFrame:CGRectMake(0, 0, 320, 2000)];
+  [scroll addSubview:content];
   UIViewController *page = [UIViewController new];
   [page.view addSubview:scroll];
   NSMutableArray<UIViewController *> *pages = [pager valueForKey:@"pageControllers"];
   [pages addObject:page];
   [pager attachScrollObserverForCurrentPage];
   UIView *headerHost = [pager valueForKey:@"sharedHeaderHostView"];
+  UIView *stickyHeader = [pager valueForKey:@"stickyHeaderView"];
   XCTAssertEqual(headerHost.superview, scroll);
   XCTAssertEqualWithAccuracy(scroll.contentInset.top, 340, 0.001);
   XCTAssertEqualWithAccuracy(headerHost.transform.ty, 0, 0.001);
 
   scroll.contentOffset = CGPointMake(0, 500);
+  CGFloat baselineStickyTranslation = stickyHeader.transform.ty;
   CGPoint offset = scroll.contentOffset;
   scroll.contentInset = UIEdgeInsetsMake(400, 0, 0, 0);
   XCTAssertTrue(CGPointEqualToPoint(scroll.contentOffset, offset));
-  XCTAssertEqualWithAccuracy(headerHost.transform.ty, -60, 0.001);
+  XCTAssertEqualWithAccuracy(headerHost.transform.ty, 0, 0.001);
+  XCTAssertEqualWithAccuracy(stickyHeader.transform.ty, baselineStickyTranslation, 0.001);
+  XCTAssertEqualWithAccuracy(CGRectGetMaxY(headerHost.frame), CGRectGetMinY(content.frame), 0.001);
 
   scroll.contentInset = UIEdgeInsetsMake(340, 0, 0, 0);
   XCTAssertEqualWithAccuracy(headerHost.transform.ty, 0, 0.001);
+  XCTAssertEqualWithAccuracy(stickyHeader.transform.ty, baselineStickyTranslation, 0.001);
 
   scroll.contentInset = UIEdgeInsetsMake(400, 0, 0, 0);
-  XCTAssertEqualWithAccuracy(headerHost.transform.ty, -60, 0.001);
+  XCTAssertEqualWithAccuracy(headerHost.transform.ty, 0, 0.001);
+  XCTAssertEqualWithAccuracy(stickyHeader.transform.ty, baselineStickyTranslation, 0.001);
+  XCTAssertEqualWithAccuracy(CGRectGetMaxY(headerHost.frame), CGRectGetMinY(content.frame), 0.001);
   scroll.refreshControl = nil;
   XCTAssertEqualWithAccuracy(headerHost.transform.ty, 0, 0.001);
   [pager prepareForRecycle];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@onekeyfe/react-native-pager-view",
-  "version": "3.0.159",
+  "version": "3.0.161",
   "description": "React Native wrapper for Android and iOS ViewPager",
   "source": "./src/index.tsx",
   "main": "./lib/module/index.js",
@@ -69,7 +69,7 @@
     "typescript": "^5.9.2"
   },
   "peerDependencies": {
-    "@onekeyfe/react-native-native-logger": "3.0.159",
+    "@onekeyfe/react-native-native-logger": "3.0.161",
     "react": "*",
     "react-native": "*"
   },