documentation update

Author: markdevocht

website/docs/api/api-events.mdx

@@ -211,27 +211,33 @@ screenPoppedListener.remove();
 | :-------------: | :-------------------------------- |
 | **componentId** | Id of the screen which was popped |
 
-## registerBottomTabSelectedListener
+## registerBottomTabPressedListener
 
-Invoked when BottomTab is selected by a user.
+Invoked when a bottom tab is pressed by the user, including when [`selectTabOnPress`](options-bottomTab.mdx#selecttabonpress) is `false` (the selected tab does not change).
 
 ```js
 // Subscribe
-const bottomTabEventListener = Navigation.events().registerBottomTabSelectedListener(({ selectedTabIndex, unselectedTabIndex }) => {
+const bottomTabEventListener = Navigation.events().registerBottomTabPressedListener(({ tabIndex }) => {
 
 });
 ...
 // Unsubscribe
 bottomTabEventListener.remove();
 ```
 
-## registerBottomTabLongPressedListener
+| Parameter   | Description                         |
+| :---------: | :---------------------------------- |
+| **tabIndex** | Index of the tab that was pressed |
+
+Works with [custom bottom tab items](../docs/customBottomTabs.mdx) on iOS and Android.
+
+## registerBottomTabSelectedListener
 
-Invoked when BottomTab is long pressed by a user.
+Invoked when BottomTab is selected by a user.
 
 ```js
 // Subscribe
-const bottomTabEventListener = Navigation.events().registerBottomTabLongPressedListener(({ selectedTabIndex }) => {
+const bottomTabEventListener = Navigation.events().registerBottomTabSelectedListener(({ selectedTabIndex, unselectedTabIndex }) => {
 
 });
 ...
@@ -244,6 +250,22 @@ bottomTabEventListener.remove();
 |  **selectedTabIndex**  | Index of the newly selected tab      |
 | **unselectedTabIndex** | Index of the previously selected tab |
 
+Works with [custom bottom tab items](../docs/customBottomTabs.mdx) on iOS and Android.
+
+## registerBottomTabLongPressedListener
+
+Invoked when BottomTab is long pressed by a user. **iOS only.** Not emitted for [custom bottom tab items](../docs/customBottomTabs.mdx) — long press is handled on the native tab bar, which is hidden when every tab uses `bottomTab.component`.
+
+```js
+// Subscribe
+const bottomTabEventListener = Navigation.events().registerBottomTabLongPressedListener(({ selectedTabIndex }) => {
+
+});
+...
+// Unsubscribe
+bottomTabEventListener.remove();
+```
+
 ## navigationButtonPressed event
 
 This event is emitted whenever a TopBar button is pressed by a user.

website/docs/api/options-bottomTab.mdx

@@ -37,6 +37,8 @@ bottomTab: {
 
 Native still owns selection, visibility, `drawBehind`, animations, and `dotIndicator`. Pair with [`bottomTabs.customRow`](options-bottomTabs.mdx#customrow) to style the floating row.
 
+Tab press and selection [events](events) match native bottom tabs; long press is not available on custom items. See [Custom bottom tabs — Events](../docs/customBottomTabs.mdx#events).
+
 ## `selectTabOnPress`
 
 | Type    | Required | Platform |

website/docs/docs/docs-customBottomTabs.mdx

@@ -119,6 +119,22 @@ Navigation.mergeOptions('BOTTOM_TABS_LAYOUT_ID', {
 });
 ```
 
+## Events
+
+Taps on custom tab items use the same native selection pipeline as the built-in tab bar. Use the standard [Navigation events](../api/events) listeners:
+
+| Listener | Custom row |
+| -------- | ---------- |
+| [`registerBottomTabPressedListener`](../api/events#registerbottomtabpressedlistener) | Yes — every tap (iOS and Android) |
+| [`registerBottomTabSelectedListener`](../api/events#registerbottomtabselectedlistener) | Yes — when the selected tab changes |
+| [`registerBottomTabLongPressedListener`](../api/events#registerbottomtablongpressedlistener) | **No** |
+
+[`bottomTab.selectTabOnPress`](api/options-bottomTab.mdx#selecttabonpress): when `false`, **pressed** still fires; **selected** does not until you change the tab programmatically (for example via `bottomTabs.currentTabIndex`).
+
+[`bottomTab.popToRoot`](api/options-bottomTab.mdx#poptoroot) and Android hardware-back tab history behave the same as with native tab items.
+
+`registerBottomTabLongPressedListener` is **iOS-only** and is wired to the native `UITabBar` long-press gesture. With custom tabs the native bar is hidden and touches go to the custom row, so this listener does not fire for custom tab items.
+
 ## Custom row (`bottomTabs.customRow`)
 
 When all tabs use custom components, RNN replaces the visible tab bar chrome with a **floating row** that hosts your React tab cells. Configure it with `bottomTabs.customRow` on the `bottomTabs` layout options.