uilib-native 3.0.6 → 4.1.0

package/components/HighlighterOverlayView.web.tsx

@@ -0,0 +1,58 @@
+import React from 'react';
+import {Modal, ViewStyle} from 'react-native';
+
+type HighlightFrameType = {
+  x: number;
+  y: number;
+  width: number;
+  height: number;
+}
+
+type HighlightViewTagParams = {
+  padding: number | ViewStyle['padding'];
+  offset: Pick<HighlightFrameType, 'x' | 'y'>;
+}
+
+export type HighlighterOverlayViewProps = {
+  visible: boolean;
+  overlayColor?: string;
+  borderRadius?: number;
+  strokeColor?: string;
+  strokeWidth?: number;
+  onRequestClose?: () => void;
+  highlightFrame?: HighlightFrameType;
+  style?: ViewStyle;
+  highlightViewTag?: number | null;
+  children?: JSX.Element[] | JSX.Element;
+  highlightViewTagParams?: HighlightViewTagParams;
+  minimumRectSize?: Pick<HighlightFrameType, 'width' | 'height'>;
+  innerPadding?: number;
+  accessible?: boolean;
+  testID?: string;
+};
+
+
+const HighlighterOverlayView = (props: HighlighterOverlayViewProps) => {
+  const {
+    visible,
+    onRequestClose,
+    children
+  } = props;
+
+
+
+  return (
+    <Modal
+      visible={!!(visible)}
+      animationType={'fade'}
+      transparent
+      onRequestClose={() => onRequestClose?.()}
+    >
+
+      {children}
+    </Modal>
+  );
+};
+
+HighlighterOverlayView.displayName = 'IGNORE';
+export default HighlighterOverlayView;

package/components/Keyboard/KeyboardInput/CustomKeyboardView/index.web.tsx

@@ -0,0 +1,11 @@
+import 'react';
+
+console.log('keyboard is not supported on web');
+const CustomKeyboardView = () => {
+
+  return (
+    null
+  );
+};
+
+export default CustomKeyboardView;

package/components/Keyboard/KeyboardInput/KeyboardAccessoryView.tsx

@@ -9,31 +9,20 @@ import {
   BackHandler,
   LayoutChangeEvent
 } from 'react-native';
-import KeyboardTrackingView from '../KeyboardTracking/KeyboardTrackingView';
+import KeyboardTrackingView, {KeyboardTrackingViewProps} from '../KeyboardTracking/KeyboardTrackingView';
 import CustomKeyboardView from './CustomKeyboardView';
 import KeyboardUtils from './utils/KeyboardUtils';
 
 const IsIOS = Platform.OS === 'ios';
 const IsAndroid = Platform.OS === 'android';
 
-const IOS_SCROLL_BEHAVIORS = IsIOS
-  ? {
-    NONE: NativeModules.KeyboardTrackingViewTempManager?.KeyboardTrackingScrollBehaviorNone,
-    SCROLL_TO_BOTTOM_INVERTED_ONLY:
-        NativeModules.KeyboardTrackingViewTempManager?.KeyboardTrackingScrollBehaviorScrollToBottomInvertedOnly,
-    FIXED_OFFSET: NativeModules.KeyboardTrackingViewTempManager?.KeyboardTrackingScrollBehaviorFixedOffset
-  }
-  : {};
+type kbTrackingViewProps = Pick<KeyboardTrackingViewProps, 'scrollBehavior' | 'revealKeyboardInteractive' | 'manageScrollView' | 'requiresSameParentToManageScrollView' | 'allowHitsOutsideBounds' | 'addBottomView' | 'bottomViewColor' | 'useSafeArea' | 'usesBottomTabs'>;
 
-export type KeyboardAccessoryViewProps = {
+export type KeyboardAccessoryViewProps = kbTrackingViewProps & {
   /**
    * Content to be rendered above the keyboard
    */
   renderContent?: () => React.ReactElement;
-  /**
-   * A callback for when the height is changed
-   */
-  onHeightChanged?: (height: number) => void;
   /**
    * iOS only.
    * The reference to the actual text input (or the keyboard may not reset when instructed to, etc.).
@@ -48,10 +37,14 @@ export type KeyboardAccessoryViewProps = {
    * The props that will be sent to the KeyboardComponent
    */
   kbInitialProps?: any;
+  /**
+   * A callback for when the height is changed
+   */
+  onHeightChanged?: (height: number) => void;
   /**
    * Callback that will be called when an item on the keyboard has been pressed.
    */
-  onItemSelected?: () => void;
+  onItemSelected?: (component?: string, args?: any) => void;
   /**
    * Callback that will be called if KeyboardRegistry.requestShowKeyboard is called.
    */
@@ -60,85 +53,24 @@ export type KeyboardAccessoryViewProps = {
    * Callback that will be called once the keyboard has been closed
    */
   onKeyboardResigned?: () => void;
-  /**
-   * iOS only.
-   * The scrolling behavior, use KeyboardAccessoryView.iosScrollBehaviors.X where X is:
-   * NONE, SCROLL_TO_BOTTOM_INVERTED_ONLY or FIXED_OFFSET
-   *
-   * default: FIXED_OFFSET
-   */
-  iOSScrollBehavior?: number;
-  /**
-   * iOS only.
-   * Show the keyboard on a negative scroll
-   *
-   * default: false
-   */
-  revealKeyboardInteractive?: boolean;
-  /**
-   * iOS only.
-   * Set to false to turn off inset management and manage it yourself
-   *
-   * default: true
-   */
-  manageScrollView?: boolean;
-  /**
-   * iOS only.
-   * Set to true manageScrollView is set to true and still does not work,
-   * it means that the ScrollView found is the wrong one and you'll have
-   * to have the KeyboardAccessoryView and the ScrollView as siblings
-   * and set this to true
-   *
-   * default: false
-   */
-  requiresSameParentToManageScrollView?: boolean;
-  /**
-   * iOS only.
-   * Add a (white) SafeArea view beneath the KeyboardAccessoryView
-   *
-   * default: false
-   */
-  addBottomView?: boolean;
-  /**
-   * iOS only.
-   * Allow hitting sub-views that are placed beyond the view bounds
-   *
-   * default: false
-   */
-  allowHitsOutsideBounds?: boolean;
-
-  /**
-   * iOS only.
-   * Whether or not to handle SafeArea
-   * default: true
-   */
-  useSafeArea?: boolean;
-  /**
-   * iOS only.
-   * Whether or not to include bottom tab bat inset
-   * default: true
-   */
-  usesBottomTabs?: boolean;
-
   children?: React.ReactChild;
 };
 
 /**
  * @description: View that allows replacing the default keyboard with other components
- * @example: https://github.com/wix/react-native-ui-lib/blob/master/demo/src/screens/nativeComponentScreens/keyboardInput/KeyboardInputViewScreen.js
+ * @example: https://github.com/wix/react-native-ui-lib/blob/master/demo/src/screens/nativeComponentScreens/keyboardAccessory/KeyboardAccessoryViewScreen.js
  * @gif: https://github.com/wix/react-native-ui-lib/blob/master/demo/showcase/KeyboardAccessoryView/KeyboardAccessoryView.gif?raw=true
  */
 class KeyboardAccessoryView extends Component<KeyboardAccessoryViewProps> {
-
-  static iosScrollBehaviors = IOS_SCROLL_BEHAVIORS;
+  static scrollBehaviors = KeyboardTrackingView.scrollBehaviors;
 
   static defaultProps = {
-    iOSScrollBehavior: -1,
     revealKeyboardInteractive: false,
     manageScrollView: true,
     requiresSameParentToManageScrollView: false,
     addBottomView: false,
-    allowHitsOutsideBounds: false
+    allowHitsOutsideBounds: false,
+    scrollBehavior: KeyboardTrackingView.scrollBehaviors.FIXED_OFFSET
   };
 
   // TODO: fix
@@ -185,16 +117,6 @@ class KeyboardAccessoryView extends Component<KeyboardAccessoryViewProps> {
     return false;
   }
 
-  getIOSTrackingScrollBehavior() {
-    const {iOSScrollBehavior} = this.props;
-
-    let scrollBehavior = iOSScrollBehavior;
-    if (IsIOS && scrollBehavior === -1) {
-      scrollBehavior = KeyboardAccessoryView.iosScrollBehaviors.FIXED_OFFSET;
-    }
-    return scrollBehavior;
-  }
-
   async getNativeProps() {
     if (this.trackingViewRef) {
       return await this.trackingViewRef.getNativeProps();
@@ -248,44 +170,31 @@ class KeyboardAccessoryView extends Component<KeyboardAccessoryViewProps> {
 
   render() {
     const {
-      revealKeyboardInteractive,
-      manageScrollView,
-      requiresSameParentToManageScrollView,
-      addBottomView,
-      allowHitsOutsideBounds,
       renderContent,
       kbInputRef,
       kbComponent,
       onItemSelected,
       onRequestShowKeyboard,
-      useSafeArea,
-      usesBottomTabs
+      scrollBehavior,
+      ...others
     } = this.props;
 
     return (
       <KeyboardTrackingView
+        {...others}
+        scrollBehavior={scrollBehavior}
         ref={(r: any) => (this.trackingViewRef = r)}
         style={styles.trackingToolbarContainer}
-        // @ts-ignore
         onLayout={this.onContainerComponentHeightChanged}
-        scrollBehavior={this.getIOSTrackingScrollBehavior()}
-        revealKeyboardInteractive={revealKeyboardInteractive}
-        manageScrollView={manageScrollView}
-        requiresSameParentToManageScrollView={requiresSameParentToManageScrollView}
-        addBottomView={addBottomView}
-        allowHitsOutsideBounds={allowHitsOutsideBounds}
-        usesBottomTabs={usesBottomTabs}
       >
-        <>
-          {renderContent?.()}
-        </>
+        <>{renderContent?.()}</>
         <CustomKeyboardView
           inputRef={kbInputRef}
           component={kbComponent}
           initialProps={this.processInitialProps()}
           onItemSelected={onItemSelected}
           onRequestShowKeyboard={onRequestShowKeyboard}
-          useSafeArea={useSafeArea}
+          useSafeArea={others.useSafeArea}
         />
       </KeyboardTrackingView>
     );

package/components/Keyboard/KeyboardInput/KeyboardRegistry.ts

@@ -17,7 +17,7 @@ const getKeyboardsWithIDs = (keyboardIDs: string[]) => {
 
 /**
  * @description: used for registering keyboards and performing certain actions on the keyboards.
- * @example: https://github.com/wix/react-native-ui-lib/blob/master/demo/src/screens/nativeComponentScreens/keyboardInput/demoKeyboards.js
+ * @example: https://github.com/wix/react-native-ui-lib/blob/master/demo/src/screens/nativeComponentScreens/keyboardAccessory/demoKeyboards.js
  */
 export default class KeyboardRegistry {
   static displayName = 'KeyboardRegistry';
@@ -115,6 +115,7 @@ export default class KeyboardRegistry {
   };
 
   /**
+   * @deprecated
    * iOS only (experimental)
    * Call to make the keyboard full screen
    * componentID (string) - the ID of the keyboard.

package/components/Keyboard/KeyboardInput/keyboardAccessoryView.api.json

@@ -0,0 +1,58 @@
+{
+  "name": "KeyboardAccessoryView",
+  "category": "infra",
+  "description": "View that allows replacing the default keyboard with other components",
+  "example": "https://github.com/wix/react-native-ui-lib/blob/master/demo/src/screens/nativeComponentScreens/keyboardAccessory/KeyboardAccessoryViewScreen.js",
+  "images": [
+    "https://github.com/wix/react-native-ui-lib/blob/master/demo/showcase/KeyboardAccessoryView/KeyboardAccessoryView.gif?raw=true"
+  ],
+  "props": [
+    {
+      "name": "renderContent",
+      "type": "() => React.ReactElement",
+      "description": "Content to be rendered above the keyboard"
+    },
+    {
+      "name": "kbInputRef",
+      "type": "any",
+      "description": "The reference to the actual text input (or the keyboard may not reset when instructed to, etc.).",
+      "required": true,
+      "note": "iOS only"
+    },
+    {
+      "name": "kbComponent",
+      "type": "string",
+      "description": "The keyboard ID (the componentID sent to KeyboardRegistry)"
+    },
+    {"name": "kbInitialProps", "type": "any", "description": "The props that will be sent to the KeyboardComponent"},
+    {
+      "name": "onHeightChanged",
+      "type": "(height: number) => void",
+      "description": "A callback for when the height is changed"
+    },
+    {
+      "name": "onItemSelected",
+      "type": "() => void",
+      "description": "Callback that will be called when an item on the keyboard has been pressed."
+    },
+    {
+      "name": "onRequestShowKeyboard",
+      "type": "() => void",
+      "description": "Callback that will be called if KeyboardRegistry.requestShowKeyboard is called."
+    },
+    {
+      "name": "onKeyboardResigned",
+      "type": "() => void",
+      "description": "Callback that will be called once the keyboard has been closed"
+    }
+  ],
+  "snippet": [
+    "<KeyboardAccessoryView",
+    " renderContent={this.renderContent()}",
+    " kbInputRef={this.inputRef}",
+    " kbComponent={$1}",
+    " kbInitialProps={$2}",
+    " onHeightChanged={this.onHeightChanged()}",
+    " scrollBehavior={KeyboardAccessoryView.scrollBehaviors.NONE$3}",
+    "/>"
+  ]}

package/components/Keyboard/KeyboardInput/keyboardRegistry.api.json

@@ -0,0 +1,50 @@
+{
+  "name": "KeyboardRegistry",
+  "category": "infra",
+  "description": "used for registering keyboards and performing certain actions on the keyboards.",
+  "example": "https://github.com/wix/react-native-ui-lib/blob/master/demo/src/screens/nativeComponentScreens/keyboardAccessory/demoKeyboards.js",
+  "props": [
+    {
+      "name": "registerKeyboard",
+      "type": "static function",
+      "description": "Register a new keyboard.\ncomponentID (string) - the ID of the keyboard.\ngenerator (function) - a function for the creation of the keyboard.\nparams (object) - to be returned when using other methods (i.e. getKeyboards and getAllKeyboards)."
+    },
+    {
+      "name": "getKeyboard",
+      "type": "static function",
+      "description": "Get a specific keyboard\ncomponentID (string) - the ID of the keyboard."
+    },
+    {
+      "name": "getKeyboards",
+      "type": "static function",
+      "description": "Get keyboards by IDs\ncomponentIDs (string[]) - the ID of the keyboard."
+    },
+    {"name": "getAllKeyboards", "type": "static function", "description": "Get all keyboards"},
+    {
+      "name": "addListener",
+      "type": "static function",
+      "description": "Add a listener for a callback.\nglobalID (string) - ID that includes the componentID and the event name\n                     (i.e. if componentID='kb1' globalID='kb1.onItemSelected')\ncallback (function) - the callback to be called when the said event happens"
+    },
+    {
+      "name": "notifyListeners",
+      "type": "static function",
+      "description": "Notify that an event has occurred.\nglobalID (string) - ID that includes the componentID and the event name\n                    (i.e. if componentID='kb1' globalID='kb1.onItemSelected')\nargs (object) - data to be sent to the listener."
+    },
+    {
+      "name": "removeListeners",
+      "type": "static function",
+      "description": "Remove a listener for a callback.\nglobalID (string) - ID that includes the componentID and the event name\n                    (i.e. if componentID='kb1' globalID='kb1.onItemSelected')"
+    },
+    {
+      "name": "onItemSelected",
+      "type": "static function",
+      "description": "Default event to be used for when an item on the keyboard has been pressed.\ncomponentID (string) - the ID of the keyboard.\nargs (object) - data to be sent to the listener."
+    },
+    {
+      "name": "requestShowKeyboard",
+      "type": "static function",
+      "description": "Request to show the keyboard\ncomponentID (string) - the ID of the keyboard."
+    }
+  ],
+  "snippet": ["KeyboardRegistry.registerKeyboard('keyboardName$1', () => KeyboardComponent$2)"]
+}

package/components/Keyboard/KeyboardTracking/KeyboardTrackingView/index.tsx

@@ -1,49 +1,89 @@
 import React, {forwardRef} from 'react';
-import {Platform, ViewStyle, ViewProps} from 'react-native';
+import {Platform, NativeModules, ViewStyle, ViewProps} from 'react-native';
 import {default as KeyboardTrackingViewIOS} from './KeyboardTrackingView.ios';
 import {default as KeyboardTrackingViewAndroid} from './KeyboardTrackingView.android';
 
 const isAndroid = Platform.OS === 'android';
+const SCROLL_BEHAVIORS = {
+  NONE: NativeModules.KeyboardTrackingViewTempManager?.KeyboardTrackingScrollBehaviorNone,
+  SCROLL_TO_BOTTOM_INVERTED_ONLY: 
+    NativeModules.KeyboardTrackingViewTempManager?.KeyboardTrackingScrollBehaviorScrollToBottomInvertedOnly,
+  FIXED_OFFSET: NativeModules.KeyboardTrackingViewTempManager?.KeyboardTrackingScrollBehaviorFixedOffset
+};
 
 export type KeyboardTrackingViewProps = ViewProps & {
   /**
-     * Enables tracking of the keyboard when it's dismissed interactively (false by default).
-     * Why? When using an external keyboard (BT),
-     * you still get the keyboard events and the view just hovers when you focus the input.
-     * Also, if you're not using interactive style of dismissing the keyboard
-     * (or if you don't have an input inside this view) it doesn't make sense to track it anyway.
-     * (This is caused because of the usage of inputAccessory to be able to track the
-     * keyboard interactive change and it introduces this bug)
-     */
-   trackInteractive?: boolean;
-   /**
-    * Allow control safe area
-    */
-   useSafeArea?: boolean;
-   /**
-    * Whether or not to include bottom tab bar inset
-    */
-   usesBottomTabs?: boolean;
-
-   scrollToFocusedInput?: boolean;
-   scrollBehavior?: number;
-   revealKeyboardInteractive?: boolean;
-   manageScrollView?: boolean;
-   requiresSameParentToManageScrollView?: boolean;
-   addBottomView?: boolean;
-   allowHitsOutsideBounds?: boolean;
-
-   // Can't figure out what it's supposed to be
-   ref?: any;
-
-   children?: React.ReactChild | React.ReactChild[];
-
-   style?: ViewStyle;
-}
+   * Enables tracking of the keyboard when it's dismissed interactively (false by default).
+   * Why? When using an external keyboard (BT),
+   * you still get the keyboard events and the view just hovers when you focus the input.
+   * Also, if you're not using interactive style of dismissing the keyboard
+   * (or if you don't have an input inside this view) it doesn't make sense to track it anyway.
+   * (This is caused because of the usage of inputAccessory to be able to track the
+   * keyboard interactive change and it introduces this bug)
+   */
+  trackInteractive?: boolean;
+  /**
+   * iOS only.
+   * Show the keyboard on a negative scroll
+   * default: false
+   */
+  revealKeyboardInteractive?: boolean;
+  /**
+   * iOS only.
+   * Set to false to turn off inset management and manage it yourself
+   * default: true
+   */
+  manageScrollView?: boolean;
+  /**
+   * iOS only.
+   * Set to true manageScrollView is set to true and still does not work,
+   * it means that the ScrollView found is the wrong one and you'll have
+   * to have the KeyboardAccessoryView and the ScrollView as siblings
+   * and set this to true
+   *
+   * default: false
+   */
+  requiresSameParentToManageScrollView?: boolean;
+  /**
+   * iOS only.
+   * Allow hitting sub-views that are placed beyond the view bounds
+   *
+   * default: false
+   */
+  allowHitsOutsideBounds?: boolean;
+  scrollToFocusedInput?: boolean;
+  /**
+   * iOS only.
+   * The scrolling behavior (NONE | SCROLL_TO_BOTTOM_INVERTED_ONLY | FIXED_OFFSET)
+   */
+  scrollBehavior?: number;
+  /**
+   * iOS only.
+   * Add a SafeArea view beneath the KeyboardAccessoryView
+   * default: false
+   */
+  addBottomView?: boolean;
+  /**
+   * iOS only.
+   * The bottom view's color
+   * default: 'white'
+   */
+  bottomViewColor?: string;
+  /**
+   * Allow control safe area
+   */
+  useSafeArea?: boolean;
+  /**
+   * Whether or not to include bottom tab bar inset
+   */
+  usesBottomTabs?: boolean;
+  ref?: any;
+  style?: ViewStyle;
+  children?: React.ReactChild | React.ReactChild[];
+};
 
 const KeyboardTrackingView = forwardRef(({children, ...others}: KeyboardTrackingViewProps, ref: any) => {
   const KeyboardTrackingViewContainer = isAndroid ? KeyboardTrackingViewAndroid : KeyboardTrackingViewIOS;
-  
   return (
     <KeyboardTrackingViewContainer {...others} ref={ref}>
       {children}
@@ -51,4 +91,6 @@ const KeyboardTrackingView = forwardRef(({children, ...others}: KeyboardTracking
   );
 });
 
-export default KeyboardTrackingView;
+export default KeyboardTrackingView as (typeof KeyboardTrackingView & {scrollBehaviors: typeof SCROLL_BEHAVIORS});
+// @ts-expect-error
+KeyboardTrackingView.scrollBehaviors = SCROLL_BEHAVIORS;

package/components/Keyboard/KeyboardTracking/KeyboardTrackingView/index.web.tsx

@@ -0,0 +1,11 @@
+import 'react';
+
+console.log('KeyboardTrackingView not supported on web');
+const KeyboardTrackingView = () => {
+  return (null
+  );
+};
+
+export default KeyboardTrackingView;
+
+KeyboardTrackingView.scrollBehaviors = {};

package/components/Keyboard/KeyboardTracking/KeyboardTrackingView/keyboardTrackingView.api.json

@@ -0,0 +1,95 @@
+{
+  "name": "KeyboardTrackingView",
+  "category": "infra",
+  "description": "A UI component that enables 'keyboard tracking' for this view and it's sub-views.\nWould typically be used when you have a TextField or TextInput inside this view.",
+  "note": "This view is useful only for iOS.",
+  "example": "https://github.com/wix/react-native-ui-lib/blob/master/demo/src/screens/nativeComponentScreens/KeyboardTrackingViewScreen.js",
+  "images": [
+    "https://github.com/wix/react-native-ui-lib/blob/master/demo/showcase/KeyboardTrackingView/KeyboardTrackingView.gif?raw=true"
+  ],
+  "props": [
+    {
+      "name": "trackInteractive",
+      "type": "boolean",
+      "description": "Enables tracking of the keyboard when it's dismissed interactively (false by default).\nWhy? When using an external keyboard (BT),\nyou still get the keyboard events and the view just hovers when you focus the input.\nAlso, if you're not using interactive style of dismissing the keyboard\n(or if you don't have an input inside this view) it doesn't make sense to track it anyway.\n(This is caused because of the usage of inputAccessory to be able to track the keyboard interactive change and it introduces this bug)"
+    },
+    {
+      "name": "scrollToFocusedInput",
+      "type": "boolean",
+      "description": "Should the scrollView scroll to the focused input"
+    },
+    {
+      "name": "scrollBehavior",
+      "type": "number",
+      "description": "The scrolling behavior (use KeyboardTrackingView.scrollBehaviors.NONE | SCROLL_TO_BOTTOM_INVERTED_ONLY | FIXED_OFFSET)",
+      "note": "iOS only"
+    },
+    {
+      "name": "revealKeyboardInteractive",
+      "type": "boolean",
+      "description": "Show the keyboard on a negative scroll.",
+      "note": "iOS only",
+      "default": "false"
+    },
+    {
+      "name": "manageScrollView",
+      "type": "boolean",
+      "description": "Set to false to turn off inset management and manage it yourself.",
+      "note": "iOS only",
+      "default": "true"
+    },
+    {
+      "name": "requiresSameParentToManageScrollView",
+      "type": "boolean",
+      "description": "Set to true manageScrollView is set to true and still does not work,\nit means that the ScrollView found is the wrong one and you'll have\nto have the KeyboardAccessoryView and the ScrollView as siblings\nand set this to true.",
+      "note": "iOS only",
+      "default": "false"
+    },
+    {
+      "name": "allowHitsOutsideBounds",
+      "type": "boolean",
+      "description": "Allow hitting sub-views that are placed beyond the view bounds.",
+      "note": "iOS only",
+      "default": "false"
+    },
+    {
+      "name": "addBottomView",
+      "type": "boolean",
+      "description": "Add a view beneath the KeyboardAccessoryView.",
+      "note": "iOS only",
+      "default": "false"
+    },
+    {
+      "name": "bottomViewColor", 
+      "type": "string", 
+      "description": "The bottom view's color.",       
+      "note": "iOS only",
+      "default": "white"
+    },
+    {
+      "name": "useSafeArea",
+      "type": "boolean",
+      "description": "Whether or not to handle SafeArea.",
+      "note": "iOS only",
+      "default": "true"
+    },
+    {
+      "name": "usesBottomTabs",
+      "type": "boolean",
+      "description": "Whether or not to include bottom tab bar inset.",
+      "note": "iOS only",
+      "default": "false"
+    },
+    {"name": "ref", "type": "any", "description": ""},
+    {"name": "style", "type": "ViewStyle", "description": ""}
+  ],
+  "snippet": [
+    "<KeyboardTrackingView",
+    " style={$1}",
+    " trackInteractive",
+    " useSafeArea",
+    ">",
+    " $2",
+    "</KeyboardTrackingView>"
+  ]
+}

package/components/Keyboard/KeyboardTracking/keyboardAwareInsetsView.api.json

@@ -0,0 +1,14 @@
+{
+  "name": "KeyboardAwareInsetsView",
+  "category": "infra",
+  "description": "Used to add an inset when a keyboard is used and might hide part of the screen.",
+  "note": "This view is useful only for iOS.",
+  "extends": ["infra/KeyboardTrackingView"],
+  "example": "https://github.com/wix/react-native-ui-lib/blob/master/demo/src/screens/incubatorScreens/IncubatorTextFieldScreen.tsx",
+  "snippet": ["<ScrollView>",
+    "  <TextField/>",
+    "  <TextField/>",
+    "  <KeyboardAwareInsetsView/>",
+    "<ScrollView>"    
+  ]
+}

package/components/SafeArea/SafeAreaSpacerView.web.tsx

@@ -0,0 +1,14 @@
+import React from 'react';
+import {View, ViewStyle} from 'react-native';
+
+
+export type SafeAreaSpacerViewProps = {
+  style?: ViewStyle;
+};
+
+const SafeAreaSpacerView = ({style}: SafeAreaSpacerViewProps) => {
+  return (<View style={style}/>);
+};
+
+SafeAreaSpacerView.displayName = 'IGNORE';
+export default SafeAreaSpacerView;