react-native-screens 4.19.0-nightly-20251023-492dd95bd → 4.19.0-nightly-20251025-ea2a0334f

package/src/fabric/ScreenNativeComponent.ts

@@ -119,6 +119,7 @@ export interface NativeProps extends ViewProps {
   leftScrollEdgeEffect?: WithDefault<ScrollEdgeEffect, 'automatic'>;
   rightScrollEdgeEffect?: WithDefault<ScrollEdgeEffect, 'automatic'>;
   topScrollEdgeEffect?: WithDefault<ScrollEdgeEffect, 'automatic'>;
+  synchronousShadowStateUpdatesEnabled?: WithDefault<boolean, false>;
 }
 
 export default codegenNativeComponent<NativeProps>('RNSScreen', {

package/src/fabric/ScreenStackHeaderConfigNativeComponent.ts

@@ -81,6 +81,7 @@ export interface NativeProps extends ViewProps {
   headerRightBarButtonItems?: UnsafeMixed[];
   onPressHeaderBarButtonItem?: DirectEventHandler<OnPressHeaderBarButtonItemEvent>;
   onPressHeaderBarButtonMenuItem?: DirectEventHandler<OnPressHeaderBarButtonMenuItemEvent>;
+  synchronousShadowStateUpdatesEnabled?: WithDefault<boolean, false>;
 }
 
 export default codegenNativeComponent<NativeProps>(

package/src/fabric/ScreenStackHeaderSubviewNativeComponent.ts

@@ -16,6 +16,7 @@ export type HeaderSubviewTypes =
 export interface NativeProps extends ViewProps {
   type?: WithDefault<HeaderSubviewTypes, 'left'>;
   hidesSharedBackground?: boolean;
+  synchronousShadowStateUpdatesEnabled?: WithDefault<boolean, false>;
 }
 
 export default codegenNativeComponent<NativeProps>(

package/src/flags.ts

@@ -1,4 +1,7 @@
 const RNS_CONTROLLED_BOTTOM_TABS_DEFAULT = true;
+const RNS_SYNCHRONOUS_SCREEN_STATE_UPDATES_DEFAULT = false;
+const RNS_SYNCHRONOUS_HEADER_CONFIG_STATE_UPDATES_DEFAULT = false;
+const RNS_SYNCHRONOUS_HEADER_SUBVIEW_STATE_UPDATES_DEFAULT = false;
 
 // TODO: Migrate freeze here
 
@@ -33,10 +36,59 @@ export const compatibilityFlags = {
 const _featureFlags = {
   experiment: {
     controlledBottomTabs: RNS_CONTROLLED_BOTTOM_TABS_DEFAULT,
+    synchronousScreenUpdatesEnabled:
+      RNS_SYNCHRONOUS_SCREEN_STATE_UPDATES_DEFAULT,
+    synchronousHeaderConfigUpdatesEnabled:
+      RNS_SYNCHRONOUS_HEADER_CONFIG_STATE_UPDATES_DEFAULT,
+    synchronousHeaderSubviewUpdatesEnabled:
+      RNS_SYNCHRONOUS_HEADER_SUBVIEW_STATE_UPDATES_DEFAULT,
   },
   stable: {},
 };
 
+type EXPERIMENTAL_FF = keyof typeof _featureFlags.experiment;
+
+const createExperimentalFeatureFlagAccessor = <T extends EXPERIMENTAL_FF>(
+  key: T,
+  defaultValue: (typeof _featureFlags.experiment)[T],
+) => {
+  return {
+    get() {
+      return _featureFlags.experiment[key];
+    },
+    set(value: (typeof _featureFlags.experiment)[T]) {
+      if (
+        value !== _featureFlags.experiment[key] &&
+        _featureFlags.experiment[key] !== defaultValue
+      ) {
+        console.error(
+          `[RNScreens] ${key} feature flag modified for a second time; this might lead to unexpected effects`,
+        );
+      }
+      _featureFlags.experiment[key] = value;
+    },
+  };
+};
+
+const controlledBottomTabsAccessor = createExperimentalFeatureFlagAccessor(
+  'controlledBottomTabs',
+  RNS_CONTROLLED_BOTTOM_TABS_DEFAULT,
+);
+const synchronousScreenUpdatesAccessor = createExperimentalFeatureFlagAccessor(
+  'synchronousScreenUpdatesEnabled',
+  RNS_SYNCHRONOUS_SCREEN_STATE_UPDATES_DEFAULT,
+);
+const synchronousHeaderConfigUpdatesAccessor =
+  createExperimentalFeatureFlagAccessor(
+    'synchronousHeaderConfigUpdatesEnabled',
+    RNS_SYNCHRONOUS_HEADER_CONFIG_STATE_UPDATES_DEFAULT,
+  );
+const synchronousHeaderSubviewUpdatesAccessor =
+  createExperimentalFeatureFlagAccessor(
+    'synchronousHeaderSubviewUpdatesEnabled',
+    RNS_SYNCHRONOUS_HEADER_SUBVIEW_STATE_UPDATES_DEFAULT,
+  );
+
 /**
  * Exposes configurable global behaviour of the library.
  *
@@ -48,19 +100,28 @@ export const featureFlags = {
    */
   experiment: {
     get controlledBottomTabs() {
-      return _featureFlags.experiment.controlledBottomTabs;
+      return controlledBottomTabsAccessor.get();
     },
     set controlledBottomTabs(value: boolean) {
-      if (
-        value !== _featureFlags.experiment.controlledBottomTabs &&
-        _featureFlags.experiment.controlledBottomTabs !==
-          RNS_CONTROLLED_BOTTOM_TABS_DEFAULT
-      ) {
-        console.error(
-          `[RNScreens] controlledBottomTabs feature flag modified for a second time; this might lead to unexpected effects`,
-        );
-      }
-      _featureFlags.experiment.controlledBottomTabs = value;
+      controlledBottomTabsAccessor.set(value);
+    },
+    get synchronousScreenUpdatesEnabled() {
+      return synchronousScreenUpdatesAccessor.get();
+    },
+    set synchronousScreenUpdatesEnabled(value: boolean) {
+      synchronousScreenUpdatesAccessor.set(value);
+    },
+    get synchronousHeaderConfigUpdatesEnabled() {
+      return synchronousHeaderConfigUpdatesAccessor.get();
+    },
+    set synchronousHeaderConfigUpdatesEnabled(value: boolean) {
+      synchronousHeaderConfigUpdatesAccessor.set(value);
+    },
+    get synchronousHeaderSubviewUpdatesEnabled() {
+      return synchronousHeaderSubviewUpdatesAccessor.get();
+    },
+    set synchronousHeaderSubviewUpdatesEnabled(value: boolean) {
+      synchronousHeaderSubviewUpdatesAccessor.set(value);
     },
   },
   /**