react-native-screens 4.12.0 → 4.13.0

package/ios/gamma/stack/RNSStackScreenComponentEventEmitter.mm

@@ -0,0 +1,60 @@
+#import "RNSStackScreenComponentEventEmitter.h"
+
+#import <React/RCTConversions.h>
+#import <React/RCTLog.h>
+#import <react/renderer/components/rnscreens/EventEmitters.h>
+
+@implementation RNSStackScreenComponentEventEmitter {
+  std::shared_ptr<const react::RNSStackScreenEventEmitter> _reactEventEmitter;
+}
+
+- (BOOL)emitOnWillAppear
+{
+  if (_reactEventEmitter != nullptr) {
+    _reactEventEmitter->onWillAppear({});
+    return YES;
+  } else {
+    RCTLogWarn(@"[RNScreens] Skipped OnWillAppear event emission due to nullish emitter");
+    return NO;
+  }
+}
+
+- (BOOL)emitOnDidAppear
+{
+  if (_reactEventEmitter != nullptr) {
+    _reactEventEmitter->onDidAppear({});
+    return YES;
+  } else {
+    RCTLogWarn(@"[RNScreens] Skipped OnDidAppear event emission due to nullish emitter");
+    return NO;
+  }
+}
+
+- (BOOL)emitOnWillDisappear
+{
+  if (_reactEventEmitter != nullptr) {
+    _reactEventEmitter->onWillDisappear({});
+    return YES;
+  } else {
+    RCTLogWarn(@"[RNScreens] Skipped OnWillDisappear event emission due to nullish emitter");
+    return NO;
+  }
+}
+
+- (BOOL)emitOnDidDisappear
+{
+  if (_reactEventEmitter != nullptr) {
+    _reactEventEmitter->onDidDisappear({});
+    return YES;
+  } else {
+    RCTLogWarn(@"[RNScreens] Skipped OnDidDisappear event emission due to nullish emitter");
+    return NO;
+  }
+}
+
+- (void)updateEventEmitter:(const std::shared_ptr<const react::RNSStackScreenEventEmitter> &)emitter
+{
+  _reactEventEmitter = emitter;
+}
+
+@end

package/ios/gamma/stack/RNSStackScreenComponentView.h

@@ -0,0 +1,36 @@
+#import "RNSReactBaseView.h"
+#import "RNSStackScreenComponentEventEmitter.h"
+
+NS_ASSUME_NONNULL_BEGIN
+
+@class RNSStackScreenController;
+@class RNSScreenStackHostComponentView;
+
+typedef NS_ENUM(int, RNSScreenStackLifecycleState) {
+  RNSScreenStackLifecycleInitial = 0,
+  RNSScreenStackLifecycleDetached = 1,
+  RNSScreenStackLifecycleAttached = 2,
+};
+
+@interface RNSStackScreenComponentView : RNSReactBaseView
+
+@property (nonatomic, weak, readwrite, nullable) RNSScreenStackHostComponentView *stackHost;
+@property (nonatomic, strong, readonly, nonnull) RNSStackScreenController *controller;
+
+@property (nonatomic, strong, readonly, nullable) NSString *screenKey;
+@property (nonatomic, readonly) RNSScreenStackLifecycleState maxLifecycleState;
+
+@end
+
+#pragma mark - Events
+
+@interface RNSStackScreenComponentView ()
+
+/**
+ * Use returned object to emit appropriate React Events to Element Tree.
+ */
+- (nonnull RNSStackScreenComponentEventEmitter *)reactEventEmitter;
+
+@end
+
+NS_ASSUME_NONNULL_END

package/ios/gamma/stack/RNSStackScreenComponentView.mm

@@ -0,0 +1,124 @@
+#import "RNSStackScreenComponentView.h"
+#import <React/RCTConversions.h>
+#import <React/RCTMountingTransactionObserving.h>
+#import <react/renderer/components/rnscreens/ComponentDescriptors.h>
+#import <react/renderer/components/rnscreens/EventEmitters.h>
+#import <react/renderer/components/rnscreens/Props.h>
+#import <react/renderer/components/rnscreens/RCTComponentViewHelpers.h>
+
+#import "Swift-Bridging.h"
+
+namespace react = facebook::react;
+
+@interface RNSStackScreenComponentView () <RCTMountingTransactionObserving>
+@end
+
+#pragma mark - View implementation
+
+@implementation RNSStackScreenComponentView {
+  RNSStackScreenController *_Nonnull _controller;
+  RNSStackScreenComponentEventEmitter *_Nonnull _reactEventEmitter;
+
+  // Flags
+  BOOL _needsLifecycleStateUpdate;
+}
+
+- (instancetype)initWithFrame:(CGRect)frame
+{
+  if (self = [super initWithFrame:frame]) {
+    [self initState];
+  }
+
+  return self;
+}
+
+- (void)initState
+{
+  [self resetProps];
+  [self setupController];
+
+  _reactEventEmitter = [RNSStackScreenComponentEventEmitter new];
+
+  _needsLifecycleStateUpdate = NO;
+}
+
+- (void)resetProps
+{
+  static const auto defaultProps = std::make_shared<const react::RNSScreenStackProps>();
+  _props = defaultProps;
+
+  // container state
+  _screenKey = nil;
+  _maxLifecycleState = RNSScreenStackLifecycleInitial;
+}
+
+- (void)setupController
+{
+  _controller = [[RNSStackScreenController alloc] initWithComponentView:self];
+  _controller.view = self;
+}
+
+#pragma mark - Events
+
+- (nonnull RNSStackScreenComponentEventEmitter *)reactEventEmitter
+{
+  RCTAssert(_reactEventEmitter != nil, @"[RNScreens] Attempt to access uninitialized _reactEventEmitter");
+  return _reactEventEmitter;
+}
+
+#pragma mark - RCTViewComponentViewProtocol
+
+- (void)updateProps:(const facebook::react::Props::Shared &)props
+           oldProps:(const facebook::react::Props::Shared &)oldProps
+{
+  const auto &oldComponentProps = *std::static_pointer_cast<const react::RNSStackScreenProps>(_props);
+  const auto &newComponentProps = *std::static_pointer_cast<const react::RNSStackScreenProps>(props);
+
+  if (oldComponentProps.maxLifecycleState != newComponentProps.maxLifecycleState) {
+    _maxLifecycleState = static_cast<RNSScreenStackLifecycleState>(newComponentProps.maxLifecycleState);
+    _needsLifecycleStateUpdate = YES;
+  }
+
+  if (oldComponentProps.screenKey != newComponentProps.screenKey) {
+    RCTAssert(_screenKey == nil, @"[RNScreens] ScreenController cannot change its screenKey");
+    _screenKey = RCTNSStringFromStringNilIfEmpty(newComponentProps.screenKey);
+  }
+
+  [super updateProps:props oldProps:oldProps];
+}
+
+- (void)finalizeUpdates:(RNComponentViewUpdateMask)updateMask
+{
+  if (_needsLifecycleStateUpdate) {
+    _needsLifecycleStateUpdate = NO;
+    [_controller setNeedsLifecycleStateUpdate];
+  }
+
+  [super finalizeUpdates:updateMask];
+}
+
+- (void)updateEventEmitter:(const facebook::react::EventEmitter::Shared &)eventEmitter
+{
+  [super updateEventEmitter:eventEmitter];
+  [_reactEventEmitter
+      updateEventEmitter:std::static_pointer_cast<const react::RNSStackScreenEventEmitter>(eventEmitter)];
+}
+
++ (react::ComponentDescriptorProvider)componentDescriptorProvider
+{
+  return react::concreteComponentDescriptorProvider<react::RNSStackScreenComponentDescriptor>();
+}
+
++ (BOOL)shouldBeRecycled
+{
+  // There won't be tens of instances of this component usually & it's easier for now.
+  // We could consider enabling it someday though.
+  return NO;
+}
+
+@end
+
+Class<RCTComponentViewProtocol> RNSStackScreenCls(void)
+{
+  return RNSStackScreenComponentView.class;
+}

package/ios/gamma/stack/RNSStackScreenComponentViewManager.h

@@ -0,0 +1,11 @@
+#pragma once
+
+#import <React/RCTViewManager.h>
+
+NS_ASSUME_NONNULL_BEGIN
+
+@interface RNSStackScreenComponentViewManager : RCTViewManager
+
+@end
+
+NS_ASSUME_NONNULL_END

package/ios/gamma/stack/RNSStackScreenComponentViewManager.mm

@@ -0,0 +1,7 @@
+#import "RNSStackScreenComponentViewManager.h"
+
+@implementation RNSStackScreenComponentViewManager
+
+RCT_EXPORT_MODULE(RNSStackScreenViewManager)
+
+@end

package/ios/gamma/stack/RNSStackScreenController.swift

@@ -0,0 +1,56 @@
+import Foundation
+import UIKit
+
+@objc
+public class RNSStackScreenController: UIViewController {
+  let screenStackComponentView: RNSStackScreenComponentView
+  private var reactEventEmitter: RNSStackScreenComponentEventEmitter {
+    return screenStackComponentView.reactEventEmitter()
+  }
+
+  @objc public required init(componentView: RNSStackScreenComponentView) {
+    self.screenStackComponentView = componentView
+    super.init(nibName: nil, bundle: nil)
+  }
+
+  required init?(coder aDecoder: NSCoder) {
+    return nil
+  }
+
+  func findStackController() -> RNSStackController? {
+    if let navCtrl = self.navigationController {
+      return navCtrl as? RNSStackController
+    }
+
+    if let stackHost = self.screenStackComponentView.stackHost {
+      return stackHost.stackController
+    }
+
+    return nil
+  }
+
+  // MARK: Signals
+
+  @objc
+  public func setNeedsLifecycleStateUpdate() {
+    findStackController()?.setNeedsUpdateOfChildViewControllers()
+  }
+
+  // MARK: Events
+
+  public override func viewWillAppear(_ animated: Bool) {
+    reactEventEmitter.emitOnWillAppear()
+  }
+
+  public override func viewDidAppear(_ animated: Bool) {
+    reactEventEmitter.emitOnDidAppear()
+  }
+
+  public override func viewWillDisappear(_ animated: Bool) {
+    reactEventEmitter.emitOnWillDisappear()
+  }
+
+  public override func viewDidDisappear(_ animated: Bool) {
+    reactEventEmitter.emitOnDidDisappear()
+  }
+}

package/ios/utils/NSString+RNSUtility.h

@@ -0,0 +1,17 @@
+#import <Foundation/Foundation.h>
+
+NS_ASSUME_NONNULL_BEGIN
+
+@interface NSString (RNSUtility)
+
++ (BOOL)rnscreens_isBlankOrNull:(NSString *)string;
+
++ (nullable NSString *)rnscreens_stringOrNilIfBlank:(NSString *)string;
+
++ (BOOL)rnscreens_isEmptyOrNull:(NSString *)string;
+
++ (nullable NSString *)rnscreens_stringOrNilIfEmpty:(NSString *)string;
+
+@end
+
+NS_ASSUME_NONNULL_END

package/ios/utils/NSString+RNSUtility.mm

@@ -0,0 +1,37 @@
+#import "NSString+RNSUtility.h"
+
+@implementation NSString (RNSUtility)
+
++ (BOOL)rnscreens_isBlankOrNull:(NSString *)string
+{
+  if (string == nil) {
+    return YES;
+  }
+  return [[string stringByTrimmingCharactersInSet:[NSCharacterSet whitespaceAndNewlineCharacterSet]] length] == 0;
+}
+
++ (BOOL)rnscreens_isEmptyOrNull:(NSString *)string
+{
+  if (string == nil) {
+    return YES;
+  }
+  return [string length] == 0;
+}
+
++ (nullable NSString *)rnscreens_stringOrNilIfBlank:(NSString *)string
+{
+  if ([NSString rnscreens_isBlankOrNull:string]) {
+    return nil;
+  }
+  return string;
+}
+
++ (nullable NSString *)rnscreens_stringOrNilIfEmpty:(NSString *)string
+{
+  if ([NSString rnscreens_isEmptyOrNull:string]) {
+    return nil;
+  }
+  return string;
+}
+
+@end

package/lib/commonjs/components/BottomTabs.js

@@ -0,0 +1,54 @@
+"use strict";
+'use client';
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = void 0;
+var _react = _interopRequireDefault(require("react"));
+var _BottomTabsNativeComponent = _interopRequireDefault(require("../fabric/BottomTabsNativeComponent"));
+var _reactNative = require("react-native");
+var _flags = _interopRequireDefault(require("../flags"));
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
+function _extends() { return _extends = Object.assign ? Object.assign.bind() : function (n) { for (var e = 1; e < arguments.length; e++) { var t = arguments[e]; for (var r in t) ({}).hasOwnProperty.call(t, r) && (n[r] = t[r]); } return n; }, _extends.apply(null, arguments); }
+/**
+ * EXPERIMENTAL API, MIGHT CHANGE W/O ANY NOTICE
+ */
+function BottomTabs(props) {
+  console.info(`BottomTabs render`);
+  const {
+    onNativeFocusChange,
+    experimentalControlNavigationStateInJS = _flags.default.experiment.controlledBottomTabs,
+    ...filteredProps
+  } = props;
+  const componentNodeRef = _react.default.useRef(null);
+  const componentNodeHandle = _react.default.useRef(-1);
+  _react.default.useEffect(() => {
+    if (componentNodeRef.current != null) {
+      componentNodeHandle.current = (0, _reactNative.findNodeHandle)(componentNodeRef.current) ?? -1;
+    } else {
+      componentNodeHandle.current = -1;
+    }
+  }, []);
+  const onNativeFocusChangeCallback = _react.default.useCallback(event => {
+    console.log(`BottomTabs [${componentNodeHandle.current ?? -1}] onNativeFocusChange: ${JSON.stringify(event.nativeEvent)}`);
+    onNativeFocusChange?.(event);
+  }, [onNativeFocusChange]);
+  return /*#__PURE__*/_react.default.createElement(_BottomTabsNativeComponent.default, _extends({
+    style: styles.fillParent,
+    onNativeFocusChange: onNativeFocusChangeCallback,
+    controlNavigationStateInJS: experimentalControlNavigationStateInJS
+    // @ts-ignore suppress ref - debug only
+    ,
+    ref: componentNodeRef
+  }, filteredProps), filteredProps.children);
+}
+var _default = exports.default = BottomTabs;
+const styles = _reactNative.StyleSheet.create({
+  fillParent: {
+    flex: 1,
+    width: '100%',
+    height: '100%'
+  }
+});
+//# sourceMappingURL=BottomTabs.js.map

package/lib/commonjs/components/BottomTabs.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["Object","defineProperty","exports","value","default","_react","_interopRequireDefault","require","_BottomTabsNativeComponent","_reactNative","_flags","e","__esModule","_extends","assign","bind","n","arguments","length","t","r","hasOwnProperty","call","apply","BottomTabs","props","console","info","onNativeFocusChange","experimentalControlNavigationStateInJS","featureFlags","experiment","controlledBottomTabs","filteredProps","componentNodeRef","React","useRef","componentNodeHandle","useEffect","current","findNodeHandle","onNativeFocusChangeCallback","useCallback","event","log","JSON","stringify","nativeEvent","createElement","style","styles","fillParent","controlNavigationStateInJS","ref","children","_default","StyleSheet","create","flex","width","height"],"sourceRoot":"../../../src","sources":["components/BottomTabs.tsx"],"mappings":";AAAA,YAAY;;AAACA,MAAA,CAAAC,cAAA,CAAAC,OAAA;EAAAC,KAAA;AAAA;AAAAD,OAAA,CAAAE,OAAA;AAEb,IAAAC,MAAA,GAAAC,sBAAA,CAAAC,OAAA;AACA,IAAAC,0BAAA,GAAAF,sBAAA,CAAAC,OAAA;AAKA,IAAAE,YAAA,GAAAF,OAAA;AAQA,IAAAG,MAAA,GAAAJ,sBAAA,CAAAC,OAAA;AAAoC,SAAAD,uBAAAK,CAAA,WAAAA,CAAA,IAAAA,CAAA,CAAAC,UAAA,GAAAD,CAAA,KAAAP,OAAA,EAAAO,CAAA;AAAA,SAAAE,SAAA,WAAAA,QAAA,GAAAb,MAAA,CAAAc,MAAA,GAAAd,MAAA,CAAAc,MAAA,CAAAC,IAAA,eAAAC,CAAA,aAAAL,CAAA,MAAAA,CAAA,GAAAM,SAAA,CAAAC,MAAA,EAAAP,CAAA,UAAAQ,CAAA,GAAAF,SAAA,CAAAN,CAAA,YAAAS,CAAA,IAAAD,CAAA,OAAAE,cAAA,CAAAC,IAAA,CAAAH,CAAA,EAAAC,CAAA,MAAAJ,CAAA,CAAAI,CAAA,IAAAD,CAAA,CAAAC,CAAA,aAAAJ,CAAA,KAAAH,QAAA,CAAAU,KAAA,OAAAN,SAAA;AAuCpC;AACA;AACA;AACA,SAASO,UAAUA,CAACC,KAAsB,EAAE;EAC1CC,OAAO,CAACC,IAAI,CAAC,mBAAmB,CAAC;EAEjC,MAAM;IACJC,mBAAmB;IACnBC,sCAAsC,GAAGC,cAAY,CAACC,UAAU,CAC7DC,oBAAoB;IACvB,GAAGC;EACL,CAAC,GAAGR,KAAK;EAET,MAAMS,gBAAgB,GACpBC,cAAK,CAACC,MAAM,CAAkD,IAAI,CAAC;EACrE,MAAMC,mBAAmB,GAAGF,cAAK,CAACC,MAAM,CAAS,CAAC,CAAC,CAAC;EAEpDD,cAAK,CAACG,SAAS,CAAC,MAAM;IACpB,IAAIJ,gBAAgB,CAACK,OAAO,IAAI,IAAI,EAAE;MACpCF,mBAAmB,CAACE,OAAO,GACzB,IAAAC,2BAAc,EAACN,gBAAgB,CAACK,OAAO,CAAC,IAAI,CAAC,CAAC;IAClD,CAAC,MAAM;MACLF,mBAAmB,CAACE,OAAO,GAAG,CAAC,CAAC;IAClC;EACF,CAAC,EAAE,EAAE,CAAC;EAEN,MAAME,2BAA2B,GAAGN,cAAK,CAACO,WAAW,CAClDC,KAAmD,IAAK;IACvDjB,OAAO,CAACkB,GAAG,CACT,eACEP,mBAAmB,CAACE,OAAO,IAAI,CAAC,CAAC,0BACTM,IAAI,CAACC,SAAS,CAACH,KAAK,CAACI,WAAW,CAAC,EAC7D,CAAC;IACDnB,mBAAmB,GAAGe,KAAK,CAAC;EAC9B,CAAC,EACD,CAACf,mBAAmB,CACtB,CAAC;EAED,oBACEvB,MAAA,CAAAD,OAAA,CAAA4C,aAAA,CAACxC,0BAAA,CAAAJ,OAAyB,EAAAS,QAAA;IACxBoC,KAAK,EAAEC,MAAM,CAACC,UAAW;IACzBvB,mBAAmB,EAAEa,2BAA4B;IACjDW,0BAA0B,EAAEvB;IAC5B;IAAA;IACAwB,GAAG,EAAEnB;EAAiB,GAClBD,aAAa,GAChBA,aAAa,CAACqB,QACU,CAAC;AAEhC;AAAC,IAAAC,QAAA,GAAArD,OAAA,CAAAE,OAAA,GAEcoB,UAAU;AAEzB,MAAM0B,MAAM,GAAGM,uBAAU,CAACC,MAAM,CAAC;EAC/BN,UAAU,EAAE;IACVO,IAAI,EAAE,CAAC;IACPC,KAAK,EAAE,MAAM;IACbC,MAAM,EAAE;EACV;AACF,CAAC,CAAC","ignoreList":[]}

package/lib/commonjs/components/BottomTabsScreen.js

@@ -0,0 +1,149 @@
+"use strict";
+'use client';
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = void 0;
+var _react = _interopRequireDefault(require("react"));
+var _BottomTabsScreenNativeComponent = _interopRequireDefault(require("../fabric/BottomTabsScreenNativeComponent"));
+var _reactNative = require("react-native");
+var _reactFreeze = require("react-freeze");
+var _core = require("../core");
+var _flags = require("../flags");
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
+function _extends() { return _extends = Object.assign ? Object.assign.bind() : function (n) { for (var e = 1; e < arguments.length; e++) { var t = arguments[e]; for (var r in t) ({}).hasOwnProperty.call(t, r) && (n[r] = t[r]); } return n; }, _extends.apply(null, arguments); }
+// iOS-specific: SFSymbol usage
+
+// iOS-specific: image as a template usage
+
+// iOS-specific: SFSymbol, image as a template usage
+
+/**
+ * EXPERIMENTAL API, MIGHT CHANGE W/O ANY NOTICE
+ */
+function BottomTabsScreen(props) {
+  const componentNodeRef = _react.default.useRef(null);
+  const componentNodeHandle = _react.default.useRef(-1);
+  _react.default.useEffect(() => {
+    if (componentNodeRef.current != null) {
+      componentNodeHandle.current = (0, _reactNative.findNodeHandle)(componentNodeRef.current) ?? -1;
+    } else {
+      componentNodeHandle.current = -1;
+    }
+  }, []);
+  const [nativeViewIsVisible, setNativeViewIsVisible] = _react.default.useState(false);
+  const {
+    onWillAppear,
+    onDidAppear,
+    onWillDisappear,
+    onDidDisappear,
+    isFocused = false,
+    icon,
+    selectedIcon,
+    ...rest
+  } = props;
+  let shouldFreeze = (0, _core.freezeEnabled)();
+  if (_flags.featureFlags.experiment.controlledBottomTabs) {
+    // If the tabs are JS controlled, we want to freeze only when given view is not focused && it is not currently visible
+    shouldFreeze = shouldFreeze && !nativeViewIsVisible && !isFocused;
+  } else {
+    shouldFreeze = shouldFreeze && !nativeViewIsVisible;
+  }
+  const onWillAppearCallback = _react.default.useCallback(event => {
+    console.log(`TabsScreen [${componentNodeHandle.current}] onWillAppear received`);
+    setNativeViewIsVisible(true);
+    onWillAppear?.(event);
+  }, [onWillAppear]);
+  const onDidAppearCallback = _react.default.useCallback(event => {
+    console.log(`TabsScreen [${componentNodeHandle.current}] onDidAppear received`);
+    onDidAppear?.(event);
+  }, [onDidAppear]);
+  const onWillDisappearCallback = _react.default.useCallback(event => {
+    console.log(`TabsScreen [${componentNodeHandle.current}] onWillDisappear received`);
+    onWillDisappear?.(event);
+  }, [onWillDisappear]);
+  const onDidDisappearCallback = _react.default.useCallback(event => {
+    console.log(`TabsScreen [${componentNodeHandle.current}] onDidDisappear received`);
+    setNativeViewIsVisible(false);
+    onDidDisappear?.(event);
+  }, [onDidDisappear]);
+  console.info(`TabsScreen [${componentNodeHandle.current ?? -1}] render; tabKey: ${rest.tabKey} shouldFreeze: ${shouldFreeze}, isFocused: ${isFocused} nativeViewIsVisible: ${nativeViewIsVisible}`);
+  const iconProps = parseIconsToNativeProps(icon, selectedIcon);
+  return /*#__PURE__*/_react.default.createElement(_BottomTabsScreenNativeComponent.default, _extends({
+    collapsable: false,
+    style: styles.fillParent,
+    onWillAppear: onWillAppearCallback,
+    onDidAppear: onDidAppearCallback,
+    onWillDisappear: onWillDisappearCallback,
+    onDidDisappear: onDidDisappearCallback,
+    isFocused: isFocused
+  }, iconProps, {
+    // @ts-ignore - This is debug only anyway
+    ref: componentNodeRef
+  }, rest), /*#__PURE__*/_react.default.createElement(_reactFreeze.Freeze, {
+    freeze: shouldFreeze,
+    placeholder: rest.placeholder
+  }, rest.children));
+}
+function parseIconToNativeProps(icon) {
+  if (!icon) {
+    return {};
+  }
+  if ('sfSymbolName' in icon) {
+    // iOS-specific: SFSymbol usage
+    return {
+      iconType: 'sfSymbol',
+      iconSfSymbolName: icon.sfSymbolName
+    };
+  } else if ('imageSource' in icon) {
+    return {
+      iconType: 'image',
+      iconImageSource: icon.imageSource
+    };
+  } else if ('templateSource' in icon) {
+    // iOS-specifig: image as a template usage
+    return {
+      iconType: 'template',
+      iconImageSource: icon.templateSource
+    };
+  } else {
+    // iOS-specific: SFSymbol, image as a template usage
+    throw new Error('[RNScreens] Incorrect icon format. You must provide sfSymbolName, imageSource or templateSource.');
+  }
+}
+function parseIconsToNativeProps(icon, selectedIcon) {
+  const {
+    iconImageSource,
+    iconSfSymbolName,
+    iconType
+  } = parseIconToNativeProps(icon);
+  const {
+    iconImageSource: selectedIconImageSource,
+    iconSfSymbolName: selectedIconSfSymbolName,
+    iconType: selectedIconType
+  } = parseIconToNativeProps(selectedIcon);
+  if (iconType !== undefined && selectedIconType !== undefined && iconType !== selectedIconType) {
+    throw new Error('[RNScreens] icon and selectedIcon must be same type.');
+  } else if (iconType === undefined && selectedIconType !== undefined) {
+    // iOS-specific: UIKit requirement
+    throw new Error('[RNScreens] To use selectedIcon prop, the icon prop must also be provided.');
+  }
+  return {
+    iconType,
+    iconImageSource,
+    iconSfSymbolName,
+    selectedIconImageSource,
+    selectedIconSfSymbolName
+  };
+}
+var _default = exports.default = BottomTabsScreen;
+const styles = _reactNative.StyleSheet.create({
+  fillParent: {
+    position: 'absolute',
+    flex: 1,
+    width: '100%',
+    height: '100%'
+  }
+});
+//# sourceMappingURL=BottomTabsScreen.js.map

package/lib/commonjs/components/BottomTabsScreen.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["Object","defineProperty","exports","value","default","_react","_interopRequireDefault","require","_BottomTabsScreenNativeComponent","_reactNative","_reactFreeze","_core","_flags","e","__esModule","_extends","assign","bind","n","arguments","length","t","r","hasOwnProperty","call","apply","BottomTabsScreen","props","componentNodeRef","React","useRef","componentNodeHandle","useEffect","current","findNodeHandle","nativeViewIsVisible","setNativeViewIsVisible","useState","onWillAppear","onDidAppear","onWillDisappear","onDidDisappear","isFocused","icon","selectedIcon","rest","shouldFreeze","freezeEnabled","featureFlags","experiment","controlledBottomTabs","onWillAppearCallback","useCallback","event","console","log","onDidAppearCallback","onWillDisappearCallback","onDidDisappearCallback","info","tabKey","iconProps","parseIconsToNativeProps","createElement","collapsable","style","styles","fillParent","ref","Freeze","freeze","placeholder","children","parseIconToNativeProps","iconType","iconSfSymbolName","sfSymbolName","iconImageSource","imageSource","templateSource","Error","selectedIconImageSource","selectedIconSfSymbolName","selectedIconType","undefined","_default","StyleSheet","create","position","flex","width","height"],"sourceRoot":"../../../src","sources":["components/BottomTabsScreen.tsx"],"mappings":"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","ignoreList":[]}

package/lib/commonjs/components/gamma/ScreenStackHost.js

@@ -0,0 +1,27 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = void 0;
+var _react = _interopRequireDefault(require("react"));
+var _reactNative = require("react-native");
+var _ScreenStackHostNativeComponent = _interopRequireDefault(require("../../fabric/gamma/ScreenStackHostNativeComponent"));
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
+/**
+ * EXPERIMENTAL API, MIGHT CHANGE W/O ANY NOTICE
+ */
+function ScreenStackHost({
+  children
+}) {
+  return /*#__PURE__*/_react.default.createElement(_ScreenStackHostNativeComponent.default, {
+    style: styles.container
+  }, children);
+}
+const styles = _reactNative.StyleSheet.create({
+  container: {
+    flex: 1
+  }
+});
+var _default = exports.default = ScreenStackHost;
+//# sourceMappingURL=ScreenStackHost.js.map

package/lib/commonjs/components/gamma/ScreenStackHost.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_react","_interopRequireDefault","require","_reactNative","_ScreenStackHostNativeComponent","e","__esModule","default","ScreenStackHost","children","createElement","style","styles","container","StyleSheet","create","flex","_default","exports"],"sourceRoot":"../../../../src","sources":["components/gamma/ScreenStackHost.tsx"],"mappings":";;;;;;AAAA,IAAAA,MAAA,GAAAC,sBAAA,CAAAC,OAAA;AACA,IAAAC,YAAA,GAAAD,OAAA;AAGA,IAAAE,+BAAA,GAAAH,sBAAA,CAAAC,OAAA;AAA+F,SAAAD,uBAAAI,CAAA,WAAAA,CAAA,IAAAA,CAAA,CAAAC,UAAA,GAAAD,CAAA,KAAAE,OAAA,EAAAF,CAAA;AAU/F;AACA;AACA;AACA,SAASG,eAAeA,CAAC;EAAEC;AAA+B,CAAC,EAAE;EAC3D,oBACET,MAAA,CAAAO,OAAA,CAAAG,aAAA,CAACN,+BAAA,CAAAG,OAA8B;IAACI,KAAK,EAAEC,MAAM,CAACC;EAAU,GACrDJ,QAC6B,CAAC;AAErC;AAEA,MAAMG,MAAM,GAAGE,uBAAU,CAACC,MAAM,CAAC;EAC/BF,SAAS,EAAE;IACTG,IAAI,EAAE;EACR;AACF,CAAC,CAAC;AAAC,IAAAC,QAAA,GAAAC,OAAA,CAAAX,OAAA,GAEYC,eAAe","ignoreList":[]}

package/lib/commonjs/components/gamma/SplitViewHost.js

@@ -0,0 +1,57 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = void 0;
+var _react = _interopRequireDefault(require("react"));
+var _reactNative = require("react-native");
+var _SplitViewHostNativeComponent = _interopRequireDefault(require("../../fabric/gamma/SplitViewHostNativeComponent"));
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
+function _extends() { return _extends = Object.assign ? Object.assign.bind() : function (n) { for (var e = 1; e < arguments.length; e++) { var t = arguments[e]; for (var r in t) ({}).hasOwnProperty.call(t, r) && (n[r] = t[r]); } return n; }, _extends.apply(null, arguments); }
+// According to the UIKit documentation: https://developer.apple.com/documentation/uikit/uisplitviewcontroller/displaymode-swift.enum
+// Only specific pairs for displayMode - splitBehavior are valid and others may lead to unexpected results.
+// Therefore, we're adding check on the JS side to return a feedback to the client when that pairing isn't valid.
+// However, we're not blocking these props to be set on the native side, because it doesn't crash, just the result or transitions may not work as expected.
+const displayModeForSplitViewCompatibilityMap = {
+  tile: ['secondaryOnly', 'oneBesideSecondary', 'twoBesideSecondary'],
+  overlay: ['secondaryOnly', 'oneOverSecondary', 'twoOverSecondary'],
+  displace: ['secondaryOnly', 'oneBesideSecondary', 'twoDisplaceSecondary'],
+  automatic: [] // placeholder for satisfying types; we'll handle it specially in logic
+};
+const isValidDisplayModeForSplitBehavior = (displayMode, splitBehavior) => {
+  if (splitBehavior === 'automatic') {
+    // for automatic we cannot easily verify the compatibility, because it depends on the system preference for display mode, therefore we're assuming that 'automatic' has only valid combinations
+    return true;
+  }
+  return displayModeForSplitViewCompatibilityMap[splitBehavior].includes(displayMode);
+};
+
+/**
+ * EXPERIMENTAL API, MIGHT CHANGE W/O ANY NOTICE
+ */
+function SplitViewHost(props) {
+  const {
+    displayMode,
+    splitBehavior
+  } = props;
+  _react.default.useEffect(() => {
+    if (displayMode && splitBehavior) {
+      const isValid = isValidDisplayModeForSplitBehavior(displayMode, splitBehavior);
+      if (!isValid) {
+        const validDisplayModes = displayModeForSplitViewCompatibilityMap[splitBehavior];
+        console.warn(`Invalid display mode "${displayMode}" for split behavior "${splitBehavior}".` + `\nValid modes for "${splitBehavior}" are: ${validDisplayModes.join(', ')}.`);
+      }
+    }
+  }, [displayMode, splitBehavior]);
+  return /*#__PURE__*/_react.default.createElement(_SplitViewHostNativeComponent.default, _extends({}, props, {
+    style: styles.container
+  }), props.children);
+}
+const styles = _reactNative.StyleSheet.create({
+  container: {
+    flex: 1
+  }
+});
+var _default = exports.default = SplitViewHost;
+//# sourceMappingURL=SplitViewHost.js.map