refactor(tabs): replace isNativeAction with actionOrigin enum

kkafar · kkafar · commit 4615c7758775 · 2026-04-28T18:28:41.000+02:00
TabSelectedEvent previously carried a boolean `isNativeAction`,
collapsing two distinct origins of native-driven tab selections
(user tap, UIKit reshuffle on size-class transition) into the
same value. Replace it with `actionOrigin: 'user' | 'js' | 'implicit'`,
matching the origin set defined in RFC-1028.

iOS already distinguishes all three internally — the `implicit`
case is now exposed instead of being collapsed into `true`. Android
emits only `'user'` and `'js'`; no `'implicit'` code path exists
there today.

While here, consolidate the Obj-C origin model: the existing
`RNSTabsNavigationStateUpdateSource` enum is renamed to
`RNSTabsActionOrigin` (cases `User`, `ProgrammaticJs`, `Implicit`)
so we have a single representation across internal state transitions
and the event payload. The private method
`progressNavigationState:withSource:` becomes `…withOrigin:`.

No JS/RN consumers (incl. the react-navigation submodule) read the
old field today, so this is a contract change with no behavior
fallout.
diff --git a/android/src/main/java/com/swmansion/rnscreens/gamma/tabs/container/TabsActionOrigin.kt b/android/src/main/java/com/swmansion/rnscreens/gamma/tabs/container/TabsActionOrigin.kt
@@ -0,0 +1,25 @@
+package com.swmansion.rnscreens.gamma.tabs.container
+
+import com.swmansion.rnscreens.gamma.tabs.container.TabsActionOrigin.JS
+import com.swmansion.rnscreens.gamma.tabs.container.TabsActionOrigin.USER
+
+/**
+ * Origin (actor) that requested a tab transition. Mirrors the public `actionOrigin` event field.
+ *
+ * - [USER] — direct native UI interaction (tab bar tap).
+ * - [JS] — JS-initiated request delivered via the `navStateRequest` prop.
+ *
+ * The `implicit` origin defined on the public TS API is iOS-only at the moment;
+ * Android does not currently produce it.
+ */
+enum class TabsActionOrigin {
+    USER,
+    JS,
+    ;
+
+    override fun toString(): String =
+        when (this) {
+            USER -> "user"
+            JS -> "js"
+        }
+}
diff --git a/android/src/main/java/com/swmansion/rnscreens/gamma/tabs/container/TabsContainer.kt b/android/src/main/java/com/swmansion/rnscreens/gamma/tabs/container/TabsContainer.kt
@@ -377,7 +377,7 @@ internal class TabsContainer(
                 navState,
                 isRepeated = isRepeated,
                 hasTriggeredSpecialEffect = hasTriggeredSpecialEffect,
-                isNativeAction = !isInExternalOperationContext,
+                actionOrigin = if (isInExternalOperationContext) TabsActionOrigin.JS else TabsActionOrigin.USER,
             )
         }
 
diff --git a/android/src/main/java/com/swmansion/rnscreens/gamma/tabs/container/TabsContainerDelegate.kt b/android/src/main/java/com/swmansion/rnscreens/gamma/tabs/container/TabsContainerDelegate.kt
@@ -11,13 +11,13 @@ internal interface TabsContainerDelegate {
      * @param navState The new navigation state after the change.
      * @param isRepeated Whether the same tab that was already selected has been selected again.
      * @param hasTriggeredSpecialEffect Whether a special effect (e.g. scroll-to-top) was triggered.
-     * @param isNativeAction Whether the change was initiated by a native user action (tap).
+     * @param actionOrigin Origin (actor) that requested this transition.
      */
     fun onNavStateUpdate(
         navState: TabsNavState,
         isRepeated: Boolean,
         hasTriggeredSpecialEffect: Boolean,
-        isNativeAction: Boolean,
+        actionOrigin: TabsActionOrigin,
     )
 
     /**
diff --git a/android/src/main/java/com/swmansion/rnscreens/gamma/tabs/host/TabsHost.kt b/android/src/main/java/com/swmansion/rnscreens/gamma/tabs/host/TabsHost.kt
@@ -12,6 +12,7 @@ import com.facebook.react.uimanager.ThemedReactContext
 import com.facebook.react.uimanager.UIManagerHelper
 import com.swmansion.rnscreens.gamma.common.colorscheme.ColorScheme
 import com.swmansion.rnscreens.gamma.helpers.getFabricUIManagerNotNull
+import com.swmansion.rnscreens.gamma.tabs.container.TabsActionOrigin
 import com.swmansion.rnscreens.gamma.tabs.container.TabSelectOp
 import com.swmansion.rnscreens.gamma.tabs.container.TabsContainer
 import com.swmansion.rnscreens.gamma.tabs.container.TabsContainerDelegate
@@ -159,14 +160,14 @@ class TabsHost(
         navState: TabsNavState,
         isRepeated: Boolean,
         hasTriggeredSpecialEffect: Boolean,
-        isNativeAction: Boolean,
+        actionOrigin: TabsActionOrigin,
     ) {
         eventEmitter.emitOnTabSelectedEvent(
             navState.selectedKey,
             navState.provenance,
             isRepeated,
             hasTriggeredSpecialEffect,
-            isNativeAction,
+            actionOrigin,
         )
     }
 
diff --git a/android/src/main/java/com/swmansion/rnscreens/gamma/tabs/host/TabsHostEventEmitter.kt b/android/src/main/java/com/swmansion/rnscreens/gamma/tabs/host/TabsHostEventEmitter.kt
@@ -2,6 +2,7 @@ package com.swmansion.rnscreens.gamma.tabs.host
 
 import com.facebook.react.bridge.ReactContext
 import com.swmansion.rnscreens.gamma.common.event.BaseEventEmitter
+import com.swmansion.rnscreens.gamma.tabs.container.TabsActionOrigin
 import com.swmansion.rnscreens.gamma.tabs.container.TabsNavState
 import com.swmansion.rnscreens.gamma.tabs.container.TabsNavStateUpdateRejectionReason
 import com.swmansion.rnscreens.gamma.tabs.host.event.TabsHostTabSelectedEvent
@@ -20,7 +21,7 @@ internal class TabsHostEventEmitter(
         provenance: Int,
         isRepeated: Boolean,
         hasTriggeredSpecialEffect: Boolean,
-        isNativeAction: Boolean,
+        actionOrigin: TabsActionOrigin,
     ) {
         reactEventDispatcher.dispatchEvent(
             TabsHostTabSelectedEvent(
@@ -30,7 +31,7 @@ internal class TabsHostEventEmitter(
                 provenance,
                 isRepeated,
                 hasTriggeredSpecialEffect,
-                isNativeAction,
+                actionOrigin,
             ),
         )
     }
diff --git a/android/src/main/java/com/swmansion/rnscreens/gamma/tabs/host/event/TabsHostTabSelectedEvent.kt b/android/src/main/java/com/swmansion/rnscreens/gamma/tabs/host/event/TabsHostTabSelectedEvent.kt
@@ -4,6 +4,7 @@ import com.facebook.react.bridge.Arguments
 import com.facebook.react.bridge.WritableMap
 import com.facebook.react.uimanager.events.Event
 import com.swmansion.rnscreens.gamma.common.event.NamingAwareEventType
+import com.swmansion.rnscreens.gamma.tabs.container.TabsActionOrigin
 
 class TabsHostTabSelectedEvent(
     surfaceId: Int,
@@ -12,7 +13,7 @@ class TabsHostTabSelectedEvent(
     val provenance: Int,
     val isRepeated: Boolean,
     val hasTriggeredSpecialEffect: Boolean,
-    val isNativeAction: Boolean,
+    val actionOrigin: TabsActionOrigin,
 ) : Event<TabsHostTabSelectedEvent>(surfaceId, viewId),
     NamingAwareEventType {
     override fun getEventName() = EVENT_NAME
@@ -28,7 +29,7 @@ class TabsHostTabSelectedEvent(
             putInt(EK_PROVENANCE, provenance)
             putBoolean(EK_IS_REPEATED, isRepeated)
             putBoolean(EK_HAS_TRIGGERED_SPECIAL_EFFECT, hasTriggeredSpecialEffect)
-            putBoolean(EK_IS_NATIVE_ACTION, isNativeAction)
+            putString(EK_ACTION_ORIGIN, actionOrigin.toString())
         }
 
     companion object : NamingAwareEventType {
@@ -39,7 +40,7 @@ class TabsHostTabSelectedEvent(
         private const val EK_PROVENANCE = "provenance"
         private const val EK_IS_REPEATED = "isRepeated"
         private const val EK_HAS_TRIGGERED_SPECIAL_EFFECT = "hasTriggeredSpecialEffect"
-        private const val EK_IS_NATIVE_ACTION = "isNativeAction"
+        private const val EK_ACTION_ORIGIN = "actionOrigin"
 
         override fun getEventName() = EVENT_NAME
 
diff --git a/ios/conversion/RNSConversions-Tabs.mm b/ios/conversion/RNSConversions-Tabs.mm
@@ -233,6 +233,20 @@ UITabBarControllerMode UITabBarControllerModeFromRNSTabBarControllerMode(RNSTabB
   }
 }
 
+react::RNSTabsHostIOSEventEmitter::OnTabSelectedActionOrigin RNSOnTabSelectedActionOriginFromRNSTabsActionOrigin(
+    RNSTabsActionOrigin actionOrigin)
+{
+  using enum facebook::react::RNSTabsHostIOSEventEmitter::OnTabSelectedActionOrigin;
+  switch (actionOrigin) {
+    case RNSTabsActionOriginUser:
+      return User;
+    case RNSTabsActionOriginProgrammaticJs:
+      return Js;
+    case RNSTabsActionOriginImplicit:
+      return Implicit;
+  }
+}
+
 RNSTabsIconType RNSTabsIconTypeFromIcon(react::RNSTabsScreenIOSIconType iconType)
 {
   using enum facebook::react::RNSTabsScreenIOSIconType;
diff --git a/ios/conversion/RNSConversions.h b/ios/conversion/RNSConversions.h
@@ -63,6 +63,9 @@ react::RNSTabsHostIOSEventEmitter::OnTabSelectionRejectedRejectionReason
 RNSOnTabSelectionRejectedRejectionReasonFromRNSTabsNavigationStateRejectionReason(
     RNSTabsNavigationStateRejectionReason reason);
 
+react::RNSTabsHostIOSEventEmitter::OnTabSelectedActionOrigin RNSOnTabSelectedActionOriginFromRNSTabsActionOrigin(
+    RNSTabsActionOrigin actionOrigin);
+
 RNSTabsIconType RNSTabsIconTypeFromIcon(react::RNSTabsScreenIOSIconType iconType);
 
 RNSTabsScreenSystemItem RNSTabsScreenSystemItemFromReactRNSTabsScreenSystemItem(
diff --git a/ios/tabs/host/RNSTabBarController.mm b/ios/tabs/host/RNSTabBarController.mm
@@ -236,7 +236,7 @@ - (BOOL)updateSelectedViewControllerTo:(nullable UIViewController *)nextSelected
       ![NSString rnscreens_isBlankOrNull:screenKey],
       @"[RNScreens] The screenKey MUST NOT be null if the view controller is not null");
 
-  [self progressNavigationState:screenKey withSource:RNSTabsNavigationStateUpdateSourceExternal];
+  [self progressNavigationState:screenKey withOrigin:RNSTabsActionOriginProgrammaticJs];
 
   if (currSelectedViewController == nextSelectedViewController) {
     return YES;
@@ -254,8 +254,7 @@ - (BOOL)updateSelectedViewControllerTo:(nullable UIViewController *)nextSelected
  */
 - (void)updateNavigationStateOnModelUpdate
 {
-  [self progressNavigationState:[self screenKeyForSelectedViewController]
-                     withSource:RNSTabsNavigationStateUpdateSourceUser];
+  [self progressNavigationState:[self screenKeyForSelectedViewController] withOrigin:RNSTabsActionOriginUser];
 }
 
 - (void)userDidRepeatViewControllerSelection:(nonnull UIViewController *)viewController
@@ -277,7 +276,7 @@ - (void)userDidRepeatViewControllerSelection:(nonnull UIViewController *)viewCon
       [[RNSTabsNavigationStateUpdateContext alloc] initWithNavState:_navigationState
                                                          isRepeated:YES
                                           hasTriggeredSpecialEffect:repeatedSelectionHandledBySpecialEffect
-                                                     isNativeAction:YES];
+                                                       actionOrigin:RNSTabsActionOriginUser];
   [self.tabsHostComponentView tabBarController:self didUpdateStateTo:_navigationState withContext:updateContext];
 }
 
@@ -299,7 +298,7 @@ - (void)userDidSelectViewController:(nonnull UIViewController *)viewController
     auto *updateContext = [[RNSTabsNavigationStateUpdateContext alloc] initWithNavState:_navigationState
                                                                              isRepeated:NO
                                                               hasTriggeredSpecialEffect:NO
-                                                                         isNativeAction:YES];
+                                                                           actionOrigin:RNSTabsActionOriginUser];
     [self.tabsHostComponentView tabBarController:self didUpdateStateTo:_navigationState withContext:updateContext];
   }
 }
@@ -517,7 +516,7 @@ - (void)updateSelectedViewControllerInner
         [[RNSTabsNavigationStateUpdateContext alloc] initWithNavState:_navigationState
                                                            isRepeated:NO
                                             hasTriggeredSpecialEffect:NO
-                                                       isNativeAction:NO];
+                                                         actionOrigin:RNSTabsActionOriginProgrammaticJs];
     [self.tabsHostComponentView tabBarController:self didUpdateStateTo:_navigationState withContext:context];
   }
 }
@@ -574,8 +573,7 @@ - (nullable RNSTabsScreenViewController *)findChildViewControllerForKey:(nullabl
   return nil;
 }
 
-- (void)progressNavigationState:(nonnull NSString *)newSelectedScreenKey
-                     withSource:(RNSTabsNavigationStateUpdateSource)updateSource
+- (void)progressNavigationState:(nonnull NSString *)newSelectedScreenKey withOrigin:(RNSTabsActionOrigin)origin
 {
   RCTAssert(newSelectedScreenKey != nil, @"[RNScreens] newSelectedScreenKey MUST NOT be nil");
 
@@ -587,7 +585,7 @@ - (void)progressNavigationState:(nonnull NSString *)newSelectedScreenKey
   _navigationState = [RNSTabsNavigationState stateWithSelectedScreenKey:newSelectedScreenKey
                                                              provenance:_navigationState.provenance + 1];
 
-  if (updateSource != RNSTabsNavigationStateUpdateSourceExternal) {
+  if (origin != RNSTabsActionOriginProgrammaticJs) {
     _lastUINavigationState = [_navigationState cloneState];
   }
 }
@@ -666,12 +664,12 @@ - (void)reconcileNavigationStateWithUIKitState
       @"TabBarCtrl reconcileNavigationStateWithUIKitState: %@ -> %@",
       _navigationState.selectedScreenKey,
       selectedScreenKey);
-  [self progressNavigationState:selectedScreenKey withSource:RNSTabsNavigationStateUpdateSourceImplicit];
+  [self progressNavigationState:selectedScreenKey withOrigin:RNSTabsActionOriginImplicit];
 
   auto *context = [[RNSTabsNavigationStateUpdateContext alloc] initWithNavState:_navigationState
                                                                      isRepeated:NO
                                                       hasTriggeredSpecialEffect:NO
-                                                                 isNativeAction:YES];
+                                                                   actionOrigin:RNSTabsActionOriginImplicit];
   [self.tabsHostComponentView tabBarController:self didUpdateStateTo:_navigationState withContext:context];
 }
 
diff --git a/ios/tabs/host/RNSTabsHostComponentView.mm b/ios/tabs/host/RNSTabsHostComponentView.mm
@@ -609,7 +609,7 @@ - (void)tabBarController:(nonnull RNSTabBarController *)tabBarController
                                              .provenance = navState.provenance,
                                              .isRepeated = context.isRepeated,
                                              .hasTriggeredSpecialEffect = context.hasTriggeredSpecialEffect,
-                                             .isNativeAction = context.isNativeAction}];
+                                             .actionOrigin = context.actionOrigin}];
 }
 
 - (void)tabBarController:(nonnull RNSTabBarController *)tabBarController
diff --git a/ios/tabs/host/RNSTabsHostEventEmitter.h b/ios/tabs/host/RNSTabsHostEventEmitter.h
@@ -26,8 +26,8 @@ typedef struct {
   BOOL isRepeated;
   /** Whether a special effect (e.g. scroll-to-top) was triggered. */
   BOOL hasTriggeredSpecialEffect;
-  /** Whether the selection was initiated by a native user action (tap). */
-  BOOL isNativeAction;
+  /** Origin (actor) that requested this transition. */
+  RNSTabsActionOrigin actionOrigin;
 } OnTabSelectedPayload;
 
 /** Payload for the `onTabSelectionRejected` event emitted when a tab selection request is rejected. */
diff --git a/ios/tabs/host/RNSTabsHostEventEmitter.mm b/ios/tabs/host/RNSTabsHostEventEmitter.mm
@@ -37,12 +37,14 @@ - (void)updateEventEmitter:(const std::shared_ptr<const react::RNSTabsHostIOSEve
 - (BOOL)emitOnTabSelected:(OnTabSelectedPayload)payload
 {
   if (_reactEventEmitter != nullptr) {
+    auto convertedActionOrigin =
+        rnscreens::conversion::RNSOnTabSelectedActionOriginFromRNSTabsActionOrigin(payload.actionOrigin);
     _reactEventEmitter->onTabSelected(
         {.selectedScreenKey = RCTStringFromNSString(payload.selectedScreenKey),
          .provenance = payload.provenance,
          .isRepeated = static_cast<bool>(payload.isRepeated),
          .hasTriggeredSpecialEffect = static_cast<bool>(payload.hasTriggeredSpecialEffect),
-         .isNativeAction = static_cast<bool>(payload.isNativeAction)});
+         .actionOrigin = convertedActionOrigin});
     return YES;
   } else {
     RCTLogWarn(@"[RNScreens] Skipped OnTabSelected event emission due to nullish emitter");
diff --git a/ios/tabs/host/RNSTabsNavigationState.h b/ios/tabs/host/RNSTabsNavigationState.h
@@ -28,6 +28,21 @@ NS_ASSUME_NONNULL_BEGIN
 
 @end
 
+/**
+ * Origin (actor) that requested a tab transition. Mirrors the public `actionOrigin` event field.
+ *
+ * - [User] direct native UI interaction (tab bar tap, drag-and-drop).
+ * - [ProgrammaticJs] JS-initiated request delivered via the `navStateRequest` prop.
+ * - [Implicit] platform side effect not attributable to an explicit actor — UIKit changed the selection
+ *   as a side effect of another operation (e.g. More navigation controller disappearing during a
+ *   horizontal size class transition on iPad).
+ */
+typedef NS_ENUM(NSInteger, RNSTabsActionOrigin) {
+  RNSTabsActionOriginUser = 0,
+  RNSTabsActionOriginProgrammaticJs,
+  RNSTabsActionOriginImplicit,
+};
+
 /** Bundles a navigation state change together with metadata about the selection context. */
 @interface RNSTabsNavigationStateUpdateContext : NSObject
 
@@ -37,27 +52,16 @@ NS_ASSUME_NONNULL_BEGIN
 @property (nonatomic, readonly) BOOL isRepeated;
 /** Whether a special effect (e.g. scroll-to-top) was triggered by the selection. */
 @property (nonatomic, readonly) BOOL hasTriggeredSpecialEffect;
-/** Whether the selection was initiated by a native user action (tap) as opposed to a JS-driven update. */
-@property (nonatomic, readonly) BOOL isNativeAction;
+/** Origin (actor) that requested this transition. */
+@property (nonatomic, readonly) RNSTabsActionOrigin actionOrigin;
 
 - (instancetype)initWithNavState:(nonnull RNSTabsNavigationState *)navState
                       isRepeated:(BOOL)isRepeated
        hasTriggeredSpecialEffect:(BOOL)hasTriggeredSpecialEffect
-                  isNativeAction:(BOOL)isNativeAction;
+                    actionOrigin:(RNSTabsActionOrigin)actionOrigin;
 
 @end
 
-/** Source of a navigation state update. */
-typedef NS_ENUM(NSInteger, RNSTabsNavigationStateUpdateSource) {
-  /** Update initiated by a native user interaction (e.g. tab tap). */
-  RNSTabsNavigationStateUpdateSourceUser = 0,
-  /** Update initiated externally (e.g. from JS via props). */
-  RNSTabsNavigationStateUpdateSourceExternal,
-  /** Update detected implicitly — UIKit changed the selection as a side effect of another operation
-   *  (e.g. More navigation controller disappearing during a horizontal size class transition on iPad). */
-  RNSTabsNavigationStateUpdateSourceImplicit
-};
-
 /** Reason why a navigation state update was rejected by the container. */
 typedef NS_ENUM(NSInteger, RNSTabsNavigationStateRejectionReason) {
   /** The update's provenance is based on a stale state. */
diff --git a/ios/tabs/host/RNSTabsNavigationState.mm b/ios/tabs/host/RNSTabsNavigationState.mm
@@ -31,13 +31,13 @@ @implementation RNSTabsNavigationStateUpdateContext
 - (instancetype)initWithNavState:(nonnull RNSTabsNavigationState *)navState
                       isRepeated:(BOOL)isRepeated
        hasTriggeredSpecialEffect:(BOOL)hasTriggeredSpecialEffect
-                  isNativeAction:(BOOL)isNativeAction
+                    actionOrigin:(RNSTabsActionOrigin)actionOrigin
 {
   if (self = [super init]) {
     _navState = navState;
     _isRepeated = isRepeated;
     _hasTriggeredSpecialEffect = hasTriggeredSpecialEffect;
-    _isNativeAction = isNativeAction;
+    _actionOrigin = actionOrigin;
   }
   return self;
 }
diff --git a/src/components/tabs/host/TabsHost.types.ts b/src/components/tabs/host/TabsHost.types.ts
@@ -62,10 +62,16 @@ export type TabSelectedEvent = {
   /** Whether the selection triggered a special effect (e.g. scroll-to-top on repeated selection). */
   hasTriggeredSpecialEffect: boolean;
   /**
-   * False in case the event is a result of JS-driven update. True otherwise, e.g. in case of user action (tap)
-   * or implicit UIKit action (app resize, orientation change, etc.).
+   * @summary Origin (actor) that requested this tab transition.
+   *
+   * @description
+   * - `'user'` — direct native UI interaction (e.g. tab bar tap, iOS tab drag-and-drop).
+   * - `'js'` — JS-initiated request delivered via the `navStateRequest` prop.
+   * - `'implicit'` — platform side effect not attributable to an explicit actor
+   *   (e.g. UIKit reshuffling the selection during a horizontal size-class transition on iPad).
+   *   Currently only emitted on iOS.
    */
-  isNativeAction: boolean;
+  actionOrigin: 'user' | 'js' | 'implicit';
 };
 
 /**
diff --git a/src/fabric/tabs/TabsHostAndroidNativeComponent.ts b/src/fabric/tabs/TabsHostAndroidNativeComponent.ts
@@ -10,7 +10,7 @@ type TabSelectedEvent = {
   provenance: CT.Int32;
   isRepeated: boolean;
   hasTriggeredSpecialEffect: boolean;
-  isNativeAction: boolean;
+  actionOrigin: 'user' | 'js' | 'implicit';
 };
 
 type NavigationStateRequest = {
diff --git a/src/fabric/tabs/TabsHostIOSNativeComponent.ts b/src/fabric/tabs/TabsHostIOSNativeComponent.ts
@@ -10,7 +10,7 @@ type TabSelectedEvent = Readonly<{
   provenance: CT.Int32;
   isRepeated: boolean;
   hasTriggeredSpecialEffect: boolean;
-  isNativeAction: boolean;
+  actionOrigin: 'user' | 'js' | 'implicit';
 }>;
 
 type NavigationStateRequest = Readonly<{

Original file line number	Diff line number	Diff line change
`@@ -377,7 +377,7 @@ internal class TabsContainer(`
`377`	`377`	`navState,`
`378`	`378`	`isRepeated = isRepeated,`
`379`	`379`	`hasTriggeredSpecialEffect = hasTriggeredSpecialEffect,`
`380`		`- isNativeAction = !isInExternalOperationContext,`
	`380`	`+ actionOrigin = if (isInExternalOperationContext) TabsActionOrigin.JS else TabsActionOrigin.USER,`
`381`	`381`	`)`
`382`	`382`	`}`
`383`	`383`
Original file line number	Diff line number	Diff line change
`@@ -236,7 +236,7 @@ - (BOOL)updateSelectedViewControllerTo:(nullable UIViewController *)nextSelected`
`236`	`236`	`![NSString rnscreens_isBlankOrNull:screenKey],`
`237`	`237`	`@"[RNScreens] The screenKey MUST NOT be null if the view controller is not null");`
`238`	`238`
`239`		`- [self progressNavigationState:screenKey withSource:RNSTabsNavigationStateUpdateSourceExternal];`
	`239`	`+ [self progressNavigationState:screenKey withOrigin:RNSTabsActionOriginProgrammaticJs];`
`240`	`240`
`241`	`241`	`if (currSelectedViewController == nextSelectedViewController) {`
`242`	`242`	`return YES;`
`@@ -254,8 +254,7 @@ - (BOOL)updateSelectedViewControllerTo:(nullable UIViewController *)nextSelected`
`254`	`254`	`*/`
`255`	`255`	`- (void)updateNavigationStateOnModelUpdate`
`256`	`256`	`{`
`257`		`- [self progressNavigationState:[self screenKeyForSelectedViewController]`
`258`		`- withSource:RNSTabsNavigationStateUpdateSourceUser];`
	`257`	`+ [self progressNavigationState:[self screenKeyForSelectedViewController] withOrigin:RNSTabsActionOriginUser];`
`259`	`258`	`}`
`260`	`259`
`261`	`260`	`- (void)userDidRepeatViewControllerSelection:(nonnull UIViewController *)viewController`
`@@ -277,7 +276,7 @@ - (void)userDidRepeatViewControllerSelection:(nonnull UIViewController *)viewCon`
`277`	`276`	`[[RNSTabsNavigationStateUpdateContext alloc] initWithNavState:_navigationState`
`278`	`277`	`isRepeated:YES`
`279`	`278`	`hasTriggeredSpecialEffect:repeatedSelectionHandledBySpecialEffect`
`280`		`- isNativeAction:YES];`
	`279`	`+ actionOrigin:RNSTabsActionOriginUser];`
`281`	`280`	`[self.tabsHostComponentView tabBarController:self didUpdateStateTo:_navigationState withContext:updateContext];`
`282`	`281`	`}`
`283`	`282`
`@@ -299,7 +298,7 @@ - (void)userDidSelectViewController:(nonnull UIViewController *)viewController`
`299`	`298`	`auto *updateContext = [[RNSTabsNavigationStateUpdateContext alloc] initWithNavState:_navigationState`
`300`	`299`	`isRepeated:NO`
`301`	`300`	`hasTriggeredSpecialEffect:NO`
`302`		`- isNativeAction:YES];`
	`301`	`+ actionOrigin:RNSTabsActionOriginUser];`
`303`	`302`	`[self.tabsHostComponentView tabBarController:self didUpdateStateTo:_navigationState withContext:updateContext];`
`304`	`303`	`}`
`305`	`304`	`}`
`@@ -517,7 +516,7 @@ - (void)updateSelectedViewControllerInner`
`517`	`516`	`[[RNSTabsNavigationStateUpdateContext alloc] initWithNavState:_navigationState`
`518`	`517`	`isRepeated:NO`
`519`	`518`	`hasTriggeredSpecialEffect:NO`
`520`		`- isNativeAction:NO];`
	`519`	`+ actionOrigin:RNSTabsActionOriginProgrammaticJs];`
`521`	`520`	`[self.tabsHostComponentView tabBarController:self didUpdateStateTo:_navigationState withContext:context];`
`522`	`521`	`}`
`523`	`522`	`}`
`@@ -574,8 +573,7 @@ - (nullable RNSTabsScreenViewController *)findChildViewControllerForKey:(nullabl`
`574`	`573`	`return nil;`
`575`	`574`	`}`
`576`	`575`
`577`		`-- (void)progressNavigationState:(nonnull NSString *)newSelectedScreenKey`
`578`		`- withSource:(RNSTabsNavigationStateUpdateSource)updateSource`
	`576`	`+- (void)progressNavigationState:(nonnull NSString *)newSelectedScreenKey withOrigin:(RNSTabsActionOrigin)origin`
`579`	`577`	`{`
`580`	`578`	`RCTAssert(newSelectedScreenKey != nil, @"[RNScreens] newSelectedScreenKey MUST NOT be nil");`
`581`	`579`
`@@ -587,7 +585,7 @@ - (void)progressNavigationState:(nonnull NSString *)newSelectedScreenKey`
`587`	`585`	`_navigationState = [RNSTabsNavigationState stateWithSelectedScreenKey:newSelectedScreenKey`
`588`	`586`	`provenance:_navigationState.provenance + 1];`
`589`	`587`
`590`		`- if (updateSource != RNSTabsNavigationStateUpdateSourceExternal) {`
	`588`	`+ if (origin != RNSTabsActionOriginProgrammaticJs) {`
`591`	`589`	`_lastUINavigationState = [_navigationState cloneState];`
`592`	`590`	`}`
`593`	`591`	`}`
`@@ -666,12 +664,12 @@ - (void)reconcileNavigationStateWithUIKitState`
`666`	`664`	`@"TabBarCtrl reconcileNavigationStateWithUIKitState: %@ -> %@",`
`667`	`665`	`_navigationState.selectedScreenKey,`
`668`	`666`	`selectedScreenKey);`
`669`		`- [self progressNavigationState:selectedScreenKey withSource:RNSTabsNavigationStateUpdateSourceImplicit];`
	`667`	`+ [self progressNavigationState:selectedScreenKey withOrigin:RNSTabsActionOriginImplicit];`
`670`	`668`
`671`	`669`	`auto *context = [[RNSTabsNavigationStateUpdateContext alloc] initWithNavState:_navigationState`
`672`	`670`	`isRepeated:NO`
`673`	`671`	`hasTriggeredSpecialEffect:NO`
`674`		`- isNativeAction:YES];`
	`672`	`+ actionOrigin:RNSTabsActionOriginImplicit];`
`675`	`673`	`[self.tabsHostComponentView tabBarController:self didUpdateStateTo:_navigationState withContext:context];`
`676`	`674`	`}`
`677`	`675`
Original file line number	Diff line number	Diff line change
`@@ -609,7 +609,7 @@ - (void)tabBarController:(nonnull RNSTabBarController *)tabBarController`
`609`	`609`	`.provenance = navState.provenance,`
`610`	`610`	`.isRepeated = context.isRepeated,`
`611`	`611`	`.hasTriggeredSpecialEffect = context.hasTriggeredSpecialEffect,`
`612`		`- .isNativeAction = context.isNativeAction}];`
	`612`	`+ .actionOrigin = context.actionOrigin}];`
`613`	`613`	`}`
`614`	`614`
`615`	`615`	`- (void)tabBarController:(nonnull RNSTabBarController *)tabBarController`