@onekeyfe/react-native-pager-view 3.0.179-alpha.2026101501 → 3.0.179-alpha.2026101503

package/docs/SPEC.md

@@ -36,7 +36,9 @@ outer PagerView transition
 releases the current edge interaction before moving its shared headers and
 applying visible-page masks; completion or cancellation reattaches the actual
 settled owner. An inactive inner pager retains the external header inset while
-its edge interaction is released.
+its edge interaction is released. Without an outer PagerView, a standalone
+external-overlay pager owns its edge interaction directly; page-activity and
+transition gates apply only while an outer PagerView is registered.
 
 `topOverlayColorScheme` is optional (`"light" | "dark"`) and coordinates the
 fixed overlay's effective appearance with React theme commits. It does not

package/ios/RNCCollapsiblePagerViewComponentView.mm

@@ -2050,6 +2050,7 @@ static void RNCLogNativeTabScrollBoundary(NSString *owner,
   if (@available(iOS 26.0, *)) {
     if (_pendingTopOverlayAppearanceCommit) scrollView = nil;
     BOOL externalOwnerReady = _externalTopOverlayTag <= 0 ||
+      _externalOuterPager == nil ||
       (_externalOuterPageActive && !_externalOuterTransitioning);
     BOOL hasOverlay = _topScrollEdgeHard && self.hasFixedTopOverlay &&
       externalOwnerReady && self.window != nil;

package/ios/tests/RNCCollapsiblePagerHitTestTests.mm

@@ -1,10 +1,15 @@
 #import <XCTest/XCTest.h>
 
 #import "RNCCollapsiblePagerViewComponentView.h"
+#import "RNCPagerViewComponentView.h"
 #import <react/renderer/components/pagerview/Props.h>
 
 using namespace facebook::react;
 
+@interface RNCCollapsiblePagerViewComponentView (ScrollEdgeTesting)
+- (void)updateTopScrollEdgeForScrollView:(UIScrollView *)scrollView;
+@end
+
 @interface RNCCollapsiblePagerHitTestTests : XCTestCase
 @property (nonatomic, strong) UIView *root;
 @property (nonatomic, strong) UIButton *toolbar;
@@ -77,4 +82,48 @@ using namespace facebook::react;
   XCTAssertNil([self.pager hitTest:CGPointMake(20, 90) withEvent:nil]);
 }
 
+- (void)testExternalOverlayWithoutOuterPagerOwnsItsEdgeAndRegisteredOuterStillGates
+{
+  if (@available(iOS 26.0, *)) {
+    UIWindow *window = [[UIWindow alloc] initWithFrame:self.root.bounds];
+    [window addSubview:self.root];
+    UIScrollView *scrollView = [[UIScrollView alloc] initWithFrame:self.pager.bounds];
+    [self.pager addSubview:scrollView];
+    UIScrollEdgeEffectStyle *originalStyle = scrollView.topEdgeEffect.style;
+    [self.pager setValue:@YES forKey:@"topScrollEdgeHard"];
+    [self.pager setValue:@123 forKey:@"externalTopOverlayTag"];
+    [self.pager setValue:@64 forKey:@"externalTopOverlayHeight"];
+    [self.pager updateTopScrollEdgeForScrollView:scrollView];
+    XCTAssertEqual([self.pager valueForKey:@"topEdgeScrollView"], scrollView);
+    UIScrollEdgeElementContainerInteraction *interaction =
+      [self.pager valueForKey:@"topEdgeInteraction"];
+    XCTAssertEqual(interaction.scrollView, scrollView);
+    UIView *host = [self.pager valueForKey:@"topEdgeInteractionHost"];
+    XCTAssertTrue([host.interactions containsObject:interaction]);
+
+    RNCPagerViewComponentView *outer = [RNCPagerViewComponentView new];
+    [self.pager setValue:outer forKey:@"externalOuterPager"];
+    [self.pager setValue:@NO forKey:@"externalOuterPageActive"];
+    [self.pager updateTopScrollEdgeForScrollView:scrollView];
+    XCTAssertNil([self.pager valueForKey:@"topEdgeInteraction"]);
+    [self.pager setValue:@YES forKey:@"externalOuterPageActive"];
+    [self.pager updateTopScrollEdgeForScrollView:scrollView];
+    XCTAssertNotNil([self.pager valueForKey:@"topEdgeInteraction"]);
+    [self.pager setValue:@YES forKey:@"externalOuterTransitioning"];
+    [self.pager updateTopScrollEdgeForScrollView:scrollView];
+    XCTAssertNil([self.pager valueForKey:@"topEdgeInteraction"]);
+
+    [self.pager setValue:nil forKey:@"externalOuterPager"];
+    [self.pager updateTopScrollEdgeForScrollView:scrollView];
+    XCTAssertNotNil([self.pager valueForKey:@"topEdgeInteraction"]);
+    [self.pager removeFromSuperview];
+    XCTAssertNil([self.pager valueForKey:@"topEdgeInteraction"]);
+    XCTAssertNil([self.pager valueForKey:@"topEdgeScrollView"]);
+    XCTAssertEqual(scrollView.topEdgeEffect.style, originalStyle);
+    [self.root removeFromSuperview];
+  } else {
+    XCTSkip(@"Scroll-edge interactions require iOS 26 or newer");
+  }
+}
+
 @end

package/lib/module/CollapsiblePagerView.js

@@ -216,7 +216,7 @@ export class CollapsiblePagerView extends React.PureComponent {
       ...nativeProps
     } = this.props;
     const pages = this.pages();
-    const supportsTopScrollEdge = Platform.OS === "ios" && Number(Platform.Version) >= 26;
+    const supportsTopScrollEdge = Platform.OS === "ios" && parseInt(String(Platform.Version), 10) >= 26;
     const hardScrollEdge = supportsTopScrollEdge && topScrollEdgeEffect === "hard";
     const hasTopOverlay = hardScrollEdge && topOverlay != null;
     const pageKeys = pages.map(pageKey);

package/lib/module/NativeScroller.js

@@ -59,7 +59,7 @@ export const NativeScroller = /*#__PURE__*/React.forwardRef(function NativeScrol
     height: 0
   });
   const [topOverlayHeight, setTopOverlayHeight] = React.useState(0);
-  const hasTopOverlay = Platform.OS === "ios" && Number(Platform.Version) >= 26 && topScrollEdgeEffect === "hard" && topOverlay != null;
+  const hasTopOverlay = Platform.OS === "ios" && parseInt(String(Platform.Version), 10) >= 26 && topScrollEdgeEffect === "hard" && topOverlay != null;
   const [refreshEpoch, requestRefreshSync] = React.useReducer(value => value + 1, 0);
   const contentSizeRef = React.useRef(contentSize);
   const scrolledSinceGrant = React.useRef(false);

package/package.json

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

package/src/CollapsiblePagerView.tsx

@@ -492,7 +492,7 @@ export class CollapsiblePagerView extends React.PureComponent<
     } = this.props;
     const pages = this.pages();
     const supportsTopScrollEdge =
-      Platform.OS === "ios" && Number(Platform.Version) >= 26;
+      Platform.OS === "ios" && parseInt(String(Platform.Version), 10) >= 26;
     const hardScrollEdge = supportsTopScrollEdge && topScrollEdgeEffect === "hard";
     const hasTopOverlay = hardScrollEdge && topOverlay != null;
     const pageKeys = pages.map(pageKey);

package/src/NativeScroller.tsx

@@ -117,7 +117,7 @@ export const NativeScroller = React.forwardRef<
   const [contentSize, setContentSize] = React.useState({ width: 0, height: 0 });
   const [topOverlayHeight, setTopOverlayHeight] = React.useState(0);
   const hasTopOverlay =
-    Platform.OS === "ios" && Number(Platform.Version) >= 26 &&
+    Platform.OS === "ios" && parseInt(String(Platform.Version), 10) >= 26 &&
     topScrollEdgeEffect === "hard" && topOverlay != null;
   const [refreshEpoch, requestRefreshSync] = React.useReducer(
     (value: number) => value + 1,