expo-navigation-bar 4.2.0 → 4.2.1

package/build/NavigationBar.js

@@ -1,20 +1,210 @@
-import { Platform } from 'react-native';
-import { isEdgeToEdge } from 'react-native-is-edge-to-edge';
-import ExpoNavigationBar from './ExpoNavigationBar';
-// This line only imports the type information for TypeScript type checking.
-// It doesn't import the actual module in the compiled JavaScript code. The actual
-// module is imported conditionally with require() below, in order to avoid
-// importing the module if edge-to-edge is not enabled (which could throw if
-// it's not linked).
-let SystemBars = null;
-if (isEdgeToEdge() && Platform.OS === 'android') {
-    SystemBars = require('react-native-edge-to-edge').SystemBars;
-    if (!SystemBars) {
-        throw new Error('Edge-to-edge has been enabled with `react-native-edge-to-edge`, but `SystemBars` failed to resolve. Make sure your project is configured correctly.');
-    }
-}
-const canRunEdgeToEdgeMethods = SystemBars !== null;
-// MARK: react-native-edge-to-edge based APIs
+import { UnavailabilityError } from 'expo-modules-core';
+import { useEffect, useState } from 'react';
+/**
+ * Observe changes to the system navigation bar.
+ * Due to platform constraints, this callback will also be triggered when the status bar visibility changes.
+ *
+ * @example
+ * ```ts
+ * NavigationBar.addVisibilityListener(({ visibility }) => {
+ *   // ...
+ * });
+ * ```
+ */
+export function addVisibilityListener(listener) {
+    throw new UnavailabilityError('NavigationBar', 'addVisibilityListener');
+}
+/**
+ * Changes the navigation bar's background color.
+ *
+ * > This method is supported only when edge-to-edge is disabled. Using it in edge-to-edge app may lead to unexpected behavior.
+ *
+ * @example
+ * ```ts
+ * NavigationBar.setBackgroundColorAsync("white");
+ * ```
+ * @param color Any valid [CSS 3 (SVG) color](http://www.w3.org/TR/css3-color/#svg-color).
+ */
+export async function setBackgroundColorAsync(color) {
+    console.warn('`setBackgroundColorAsync` is only available on Android');
+}
+/**
+ * Gets the navigation bar's background color.
+ *
+ * > This method is supported only when edge-to-edge is disabled. Using it in edge-to-edge app may lead to unexpected behavior.
+ *
+ * @example
+ * ```ts
+ * const color = await NavigationBar.getBackgroundColorAsync();
+ * ```
+ * @returns Current navigation bar color in hex format. Returns `#00000000` (transparent) on unsupported platforms (iOS, web).
+ *
+ */
+export async function getBackgroundColorAsync() {
+    console.warn('`getBackgroundColorAsync` is only available on Android');
+    return `#00000000`;
+}
+/**
+ * Changes the navigation bar's border color.
+ *
+ * > This method is supported only when edge-to-edge is disabled. Using it in edge-to-edge app may lead to unexpected behavior.
+ *
+ * @example
+ * ```ts
+ * NavigationBar.setBorderColorAsync("red");
+ * ```
+ * @param color Any valid [CSS 3 (SVG) color](http://www.w3.org/TR/css3-color/#svg-color).
+ */
+export async function setBorderColorAsync(color) {
+    console.warn('`setBorderColorAsync` is only available on Android');
+}
+/**
+ * Gets the navigation bar's top border color, also known as the "divider color".
+ *
+ * > This method is supported only when edge-to-edge is disabled. Using it in edge-to-edge app may lead to unexpected behavior.
+ *
+ * @example
+ * ```ts
+ * const color = await NavigationBar.getBorderColorAsync();
+ * ```
+ * @returns Navigation bar top border color in hex format. Returns `#00000000` (transparent) on unsupported platforms (iOS, web).
+ */
+export async function getBorderColorAsync() {
+    console.warn('`getBorderColorAsync` is only available on Android');
+    return `#00000000`;
+}
+/**
+ * Set the navigation bar's visibility.
+ *
+ * @example
+ * ```ts
+ * NavigationBar.setVisibilityAsync("hidden");
+ * ```
+ * @param visibility Based on CSS visibility property.
+ * @platform android
+ */
+export async function setVisibilityAsync(visibility) {
+    console.warn('`setVisibilityAsync` is only available on Android');
+}
+/**
+ * Get the navigation bar's visibility.
+ *
+ *
+ * @example
+ * ```ts
+ * const visibility = await NavigationBar.getVisibilityAsync("hidden");
+ * ```
+ * @returns Navigation bar's current visibility status. Returns `hidden` on unsupported platforms (iOS, web).
+ */
+export async function getVisibilityAsync() {
+    console.warn('`getVisibilityAsync` is only available on Android');
+    return 'hidden';
+}
+/**
+ * Changes the navigation bar's button colors between white (`light`) and a dark gray color (`dark`).
+ *
+ * > This method is supported only when edge-to-edge is disabled. Using it in edge-to-edge app may lead to unexpected behavior.
+ *
+ * @example
+ * ```ts
+ * NavigationBar.setButtonStyleAsync("light");
+ * ```
+ * @param style Dictates the color of the foreground element color.
+ */
+export async function setButtonStyleAsync(style) {
+    console.warn('`setButtonStyleAsync` is only available on Android');
+}
+/**
+ * Gets the navigation bar's button color styles.
+ *
+ * > This method is supported only when edge-to-edge is disabled. Using it in edge-to-edge app may lead to unexpected behavior.
+ *
+ * @example
+ * ```ts
+ * const style = await NavigationBar.getButtonStyleAsync();
+ * ```
+ * @returns Navigation bar foreground element color settings. Returns `light` on unsupported platforms (iOS, web).
+ */
+export async function getButtonStyleAsync() {
+    console.warn('`getButtonStyleAsync` is only available on Android');
+    return 'light';
+}
+/**
+ * Sets positioning method used for the navigation bar (and status bar).
+ * Setting position `absolute` will float the navigation bar above the content,
+ * whereas position `relative` will shrink the screen to inline the navigation bar.
+ *
+ * When drawing behind the status and navigation bars, ensure the safe area insets are adjusted accordingly.
+ *
+ * > This method is supported only when edge-to-edge is disabled. Using it in edge-to-edge app may lead to unexpected behavior.
+ *
+ * @example
+ * ```ts
+ * // enables edge-to-edge mode
+ * await NavigationBar.setPositionAsync('absolute')
+ * // transparent backgrounds to see through
+ * await NavigationBar.setBackgroundColorAsync('#ffffff00')
+ * ```
+ * @param position Based on CSS position property.
+ */
+export async function setPositionAsync(position) {
+    console.warn('`setPositionAsync` is only available on Android');
+}
+/**
+ * Whether the navigation and status bars float above the app (absolute) or sit inline with it (relative).
+ * This value can be incorrect if `androidNavigationBar.visible` is used instead of the config plugin `position` property.
+ *
+ * This method is unstable because the position can be set via another native module and get out of sync.
+ * Alternatively, you can get the position by measuring the insets returned by `react-native-safe-area-context`.
+ *
+ * > This method is supported only when edge-to-edge is disabled. Using it in edge-to-edge app may lead to unexpected behavior.
+ *
+ * @example
+ * ```ts
+ * await NavigationBar.unstable_getPositionAsync()
+ * ```
+ * @returns Navigation bar positional rendering mode. Returns `relative` on unsupported platforms (iOS, web).
+ */
+export async function unstable_getPositionAsync() {
+    console.warn('`unstable_getPositionAsync` is only available on Android');
+    return 'relative';
+}
+/**
+ * Sets the behavior of the status bar and navigation bar when they are hidden and the user wants to reveal them.
+ *
+ * For example, if the navigation bar is hidden (`setVisibilityAsync(false)`) and the behavior
+ * is `'overlay-swipe'`, the user can swipe from the bottom of the screen to temporarily reveal the navigation bar.
+ *
+ * - `'overlay-swipe'`: Temporarily reveals the System UI after a swipe gesture (bottom or top) without insetting your App's content.
+ * - `'inset-swipe'`: Reveals the System UI after a swipe gesture (bottom or top) and insets your App's content (Safe Area). The System UI is visible until you explicitly hide it again.
+ * - `'inset-touch'`: Reveals the System UI after a touch anywhere on the screen and insets your App's content (Safe Area). The System UI is visible until you explicitly hide it again.
+ *
+ * > This method is supported only when edge-to-edge is disabled. Using it in edge-to-edge app may lead to unexpected behavior.
+ *
+ * @example
+ * ```ts
+ * await NavigationBar.setBehaviorAsync('overlay-swipe')
+ * ```
+ * @param behavior Dictates the interaction behavior of the navigation bar.
+ */
+export async function setBehaviorAsync(behavior) {
+    console.warn('`setBehaviorAsync` is only available on Android');
+}
+/**
+ * Gets the behavior of the status and navigation bars when the user swipes or touches the screen.
+ *
+ * > This method is supported only when edge-to-edge is disabled. Using it in edge-to-edge app may lead to unexpected behavior.
+ *
+ * @example
+ * ```ts
+ * await NavigationBar.getBehaviorAsync()
+ * ```
+ * @returns Navigation bar interaction behavior. Returns `inset-touch` on unsupported platforms (iOS, web).
+ */
+export async function getBehaviorAsync() {
+    console.warn('`getBehaviorAsync` is only available on Android');
+    return 'inset-touch';
+}
 /**
  * Sets the style of the navigation bar.
  * > This will have an effect when the following conditions are met:
@@ -27,37 +217,26 @@ const canRunEdgeToEdgeMethods = SystemBars !== null;
  * @platform android
  */
 export function setStyle(style) {
-    if (!canRunEdgeToEdgeMethods && Platform.OS === 'android') {
-        throw new Error('`setStyle` is only supported on Android when edge-to-edge is enabled. Enable edge-to-edge or use the `setButtonStyle` function instead.');
-    }
-    if (Platform.OS !== 'android') {
-        console.warn('`setStyle` method is only available on Android');
-        return;
-    }
-    SystemBars?.setStyle({ navigationBar: style });
+    console.warn('`setStyle` method is only available on Android');
 }
 /**
- * Set the navigation bar's visibility.
+ * React hook that statefully updates with the visibility of the system navigation bar.
  *
  * @example
  * ```ts
- * NavigationBar.setVisibilityAsync("hidden");
+ * function App() {
+ *   const visibility = NavigationBar.useVisibility()
+ *   // React Component...
+ * }
  * ```
- * @param visibility Based on CSS visibility property.
- * @platform android
+ * @returns Visibility of the navigation bar, `null` during async initialization.
  */
-export async function setVisibilityAsync(visibility) {
-    if (Platform.OS !== 'android') {
-        console.warn('`setVisibilityAsync` is only available on Android');
-        return;
-    }
-    if (canRunEdgeToEdgeMethods) {
-        // We know the SystemBars module is available, but typescript doesn't interpret it, so we have to use optional.
-        return SystemBars?.setHidden({ navigationBar: visibility === 'hidden' });
-    }
-    return await ExpoNavigationBar.setVisibilityAsync(visibility);
-}
-// MARK: existing expo-navigation-bar APIs
-export * from './NativeNavigationBarWrapper';
+export function useVisibility() {
+    const [visibility, setVisible] = useState(null);
+    useEffect(() => {
+        setVisible('hidden');
+    }, []);
+    return visibility;
+}
 export * from './NavigationBar.types';
 //# sourceMappingURL=NavigationBar.js.map

package/build/NavigationBar.js.map

@@ -1 +1 @@
-{"version":3,"file":"NavigationBar.js","sourceRoot":"","sources":["../src/NavigationBar.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AACxC,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAE5D,OAAO,iBAAiB,MAAM,qBAAqB,CAAC;AAGpD,4EAA4E;AAC5E,kFAAkF;AAClF,2EAA2E;AAC3E,4EAA4E;AAC5E,oBAAoB;AACpB,IAAI,UAAU,GAAiE,IAAI,CAAC;AAEpF,IAAI,YAAY,EAAE,IAAI,QAAQ,CAAC,EAAE,KAAK,SAAS,EAAE,CAAC;IAChD,UAAU,GAAG,OAAO,CAAC,2BAA2B,CAAC,CAAC,UAAU,CAAC;IAC7D,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,MAAM,IAAI,KAAK,CACb,qJAAqJ,CACtJ,CAAC;IACJ,CAAC;AACH,CAAC;AACD,MAAM,uBAAuB,GAAG,UAAU,KAAK,IAAI,CAAC;AAEpD,6CAA6C;AAC7C;;;;;;;;;;GAUG;AACH,MAAM,UAAU,QAAQ,CAAC,KAAyB;IAChD,IAAI,CAAC,uBAAuB,IAAI,QAAQ,CAAC,EAAE,KAAK,SAAS,EAAE,CAAC;QAC1D,MAAM,IAAI,KAAK,CACb,yIAAyI,CAC1I,CAAC;IACJ,CAAC;IACD,IAAI,QAAQ,CAAC,EAAE,KAAK,SAAS,EAAE,CAAC;QAC9B,OAAO,CAAC,IAAI,CAAC,gDAAgD,CAAC,CAAC;QAC/D,OAAO;IACT,CAAC;IACD,UAAU,EAAE,QAAQ,CAAC,EAAE,aAAa,EAAE,KAAK,EAAE,CAAC,CAAC;AACjD,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,UAAmC;IAC1E,IAAI,QAAQ,CAAC,EAAE,KAAK,SAAS,EAAE,CAAC;QAC9B,OAAO,CAAC,IAAI,CAAC,mDAAmD,CAAC,CAAC;QAClE,OAAO;IACT,CAAC;IAED,IAAI,uBAAuB,EAAE,CAAC;QAC5B,+GAA+G;QAC/G,OAAO,UAAU,EAAE,SAAS,CAAC,EAAE,aAAa,EAAE,UAAU,KAAK,QAAQ,EAAE,CAAC,CAAC;IAC3E,CAAC;IAED,OAAO,MAAM,iBAAiB,CAAC,kBAAkB,CAAC,UAAU,CAAC,CAAC;AAChE,CAAC;AAED,0CAA0C;AAE1C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,uBAAuB,CAAC","sourcesContent":["import { Platform } from 'react-native';\nimport { isEdgeToEdge } from 'react-native-is-edge-to-edge';\n\nimport ExpoNavigationBar from './ExpoNavigationBar';\nimport { NavigationBarStyle, NavigationBarVisibility } from './NavigationBar.types';\n\n// This line only imports the type information for TypeScript type checking.\n// It doesn't import the actual module in the compiled JavaScript code. The actual\n// module is imported conditionally with require() below, in order to avoid\n// importing the module if edge-to-edge is not enabled (which could throw if\n// it's not linked).\nlet SystemBars: typeof import('react-native-edge-to-edge').SystemBars | null = null;\n\nif (isEdgeToEdge() && Platform.OS === 'android') {\n  SystemBars = require('react-native-edge-to-edge').SystemBars;\n  if (!SystemBars) {\n    throw new Error(\n      'Edge-to-edge has been enabled with `react-native-edge-to-edge`, but `SystemBars` failed to resolve. Make sure your project is configured correctly.'\n    );\n  }\n}\nconst canRunEdgeToEdgeMethods = SystemBars !== null;\n\n// MARK: react-native-edge-to-edge based APIs\n/**\n * Sets the style of the navigation bar.\n * > This will have an effect when the following conditions are met:\n * > - Edge-to-edge is enabled\n * > - The `enforceNavigationBarContrast` option of the `react-native-edge-to-edge` plugin is set to `false`.\n * > - The device is using the three-button navigation bar.\n *\n * > Due to a bug in the Android 15 emulator this function may have no effect. Try a physical device or an emulator with a different version of Android.\n *\n * @platform android\n */\nexport function setStyle(style: NavigationBarStyle) {\n  if (!canRunEdgeToEdgeMethods && Platform.OS === 'android') {\n    throw new Error(\n      '`setStyle` is only supported on Android when edge-to-edge is enabled. Enable edge-to-edge or use the `setButtonStyle` function instead.'\n    );\n  }\n  if (Platform.OS !== 'android') {\n    console.warn('`setStyle` method is only available on Android');\n    return;\n  }\n  SystemBars?.setStyle({ navigationBar: style });\n}\n\n/**\n * Set the navigation bar's visibility.\n *\n * @example\n * ```ts\n * NavigationBar.setVisibilityAsync(\"hidden\");\n * ```\n * @param visibility Based on CSS visibility property.\n * @platform android\n */\nexport async function setVisibilityAsync(visibility: NavigationBarVisibility) {\n  if (Platform.OS !== 'android') {\n    console.warn('`setVisibilityAsync` is only available on Android');\n    return;\n  }\n\n  if (canRunEdgeToEdgeMethods) {\n    // We know the SystemBars module is available, but typescript doesn't interpret it, so we have to use optional.\n    return SystemBars?.setHidden({ navigationBar: visibility === 'hidden' });\n  }\n\n  return await ExpoNavigationBar.setVisibilityAsync(visibility);\n}\n\n// MARK: existing expo-navigation-bar APIs\n\nexport * from './NativeNavigationBarWrapper';\nexport * from './NavigationBar.types';\n"]}
+{"version":3,"file":"NavigationBar.js","sourceRoot":"","sources":["../src/NavigationBar.ts"],"names":[],"mappings":"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","sourcesContent":["import { type EventSubscription, UnavailabilityError } from 'expo-modules-core';\nimport { useEffect, useState } from 'react';\n\nimport type {\n  NavigationBarBehavior,\n  NavigationBarButtonStyle,\n  NavigationBarPosition,\n  NavigationBarStyle,\n  NavigationBarVisibility,\n  NavigationBarVisibilityEvent,\n} from './NavigationBar.types';\n\n/**\n * Observe changes to the system navigation bar.\n * Due to platform constraints, this callback will also be triggered when the status bar visibility changes.\n *\n * @example\n * ```ts\n * NavigationBar.addVisibilityListener(({ visibility }) => {\n *   // ...\n * });\n * ```\n */\nexport function addVisibilityListener(\n  listener: (event: NavigationBarVisibilityEvent) => void\n): EventSubscription {\n  throw new UnavailabilityError('NavigationBar', 'addVisibilityListener');\n}\n\n/**\n * Changes the navigation bar's background color.\n *\n * > This method is supported only when edge-to-edge is disabled. Using it in edge-to-edge app may lead to unexpected behavior.\n *\n * @example\n * ```ts\n * NavigationBar.setBackgroundColorAsync(\"white\");\n * ```\n * @param color Any valid [CSS 3 (SVG) color](http://www.w3.org/TR/css3-color/#svg-color).\n */\nexport async function setBackgroundColorAsync(color: string): Promise<void> {\n  console.warn('`setBackgroundColorAsync` is only available on Android');\n}\n\n/**\n * Gets the navigation bar's background color.\n *\n * > This method is supported only when edge-to-edge is disabled. Using it in edge-to-edge app may lead to unexpected behavior.\n *\n * @example\n * ```ts\n * const color = await NavigationBar.getBackgroundColorAsync();\n * ```\n * @returns Current navigation bar color in hex format. Returns `#00000000` (transparent) on unsupported platforms (iOS, web).\n *\n */\nexport async function getBackgroundColorAsync(): Promise<string> {\n  console.warn('`getBackgroundColorAsync` is only available on Android');\n  return `#00000000`;\n}\n\n/**\n * Changes the navigation bar's border color.\n *\n * > This method is supported only when edge-to-edge is disabled. Using it in edge-to-edge app may lead to unexpected behavior.\n *\n * @example\n * ```ts\n * NavigationBar.setBorderColorAsync(\"red\");\n * ```\n * @param color Any valid [CSS 3 (SVG) color](http://www.w3.org/TR/css3-color/#svg-color).\n */\nexport async function setBorderColorAsync(color: string): Promise<void> {\n  console.warn('`setBorderColorAsync` is only available on Android');\n}\n\n/**\n * Gets the navigation bar's top border color, also known as the \"divider color\".\n *\n * > This method is supported only when edge-to-edge is disabled. Using it in edge-to-edge app may lead to unexpected behavior.\n *\n * @example\n * ```ts\n * const color = await NavigationBar.getBorderColorAsync();\n * ```\n * @returns Navigation bar top border color in hex format. Returns `#00000000` (transparent) on unsupported platforms (iOS, web).\n */\nexport async function getBorderColorAsync(): Promise<string> {\n  console.warn('`getBorderColorAsync` is only available on Android');\n  return `#00000000`;\n}\n\n/**\n * Set the navigation bar's visibility.\n *\n * @example\n * ```ts\n * NavigationBar.setVisibilityAsync(\"hidden\");\n * ```\n * @param visibility Based on CSS visibility property.\n * @platform android\n */\nexport async function setVisibilityAsync(visibility: NavigationBarVisibility): Promise<void> {\n  console.warn('`setVisibilityAsync` is only available on Android');\n}\n\n/**\n * Get the navigation bar's visibility.\n *\n *\n * @example\n * ```ts\n * const visibility = await NavigationBar.getVisibilityAsync(\"hidden\");\n * ```\n * @returns Navigation bar's current visibility status. Returns `hidden` on unsupported platforms (iOS, web).\n */\nexport async function getVisibilityAsync(): Promise<NavigationBarVisibility> {\n  console.warn('`getVisibilityAsync` is only available on Android');\n  return 'hidden';\n}\n\n/**\n * Changes the navigation bar's button colors between white (`light`) and a dark gray color (`dark`).\n *\n * > This method is supported only when edge-to-edge is disabled. Using it in edge-to-edge app may lead to unexpected behavior.\n *\n * @example\n * ```ts\n * NavigationBar.setButtonStyleAsync(\"light\");\n * ```\n * @param style Dictates the color of the foreground element color.\n */\nexport async function setButtonStyleAsync(style: NavigationBarButtonStyle): Promise<void> {\n  console.warn('`setButtonStyleAsync` is only available on Android');\n}\n\n/**\n * Gets the navigation bar's button color styles.\n *\n * > This method is supported only when edge-to-edge is disabled. Using it in edge-to-edge app may lead to unexpected behavior.\n *\n * @example\n * ```ts\n * const style = await NavigationBar.getButtonStyleAsync();\n * ```\n * @returns Navigation bar foreground element color settings. Returns `light` on unsupported platforms (iOS, web).\n */\nexport async function getButtonStyleAsync(): Promise<NavigationBarButtonStyle> {\n  console.warn('`getButtonStyleAsync` is only available on Android');\n  return 'light';\n}\n\n/**\n * Sets positioning method used for the navigation bar (and status bar).\n * Setting position `absolute` will float the navigation bar above the content,\n * whereas position `relative` will shrink the screen to inline the navigation bar.\n *\n * When drawing behind the status and navigation bars, ensure the safe area insets are adjusted accordingly.\n *\n * > This method is supported only when edge-to-edge is disabled. Using it in edge-to-edge app may lead to unexpected behavior.\n *\n * @example\n * ```ts\n * // enables edge-to-edge mode\n * await NavigationBar.setPositionAsync('absolute')\n * // transparent backgrounds to see through\n * await NavigationBar.setBackgroundColorAsync('#ffffff00')\n * ```\n * @param position Based on CSS position property.\n */\nexport async function setPositionAsync(position: NavigationBarPosition): Promise<void> {\n  console.warn('`setPositionAsync` is only available on Android');\n}\n\n/**\n * Whether the navigation and status bars float above the app (absolute) or sit inline with it (relative).\n * This value can be incorrect if `androidNavigationBar.visible` is used instead of the config plugin `position` property.\n *\n * This method is unstable because the position can be set via another native module and get out of sync.\n * Alternatively, you can get the position by measuring the insets returned by `react-native-safe-area-context`.\n *\n * > This method is supported only when edge-to-edge is disabled. Using it in edge-to-edge app may lead to unexpected behavior.\n *\n * @example\n * ```ts\n * await NavigationBar.unstable_getPositionAsync()\n * ```\n * @returns Navigation bar positional rendering mode. Returns `relative` on unsupported platforms (iOS, web).\n */\nexport async function unstable_getPositionAsync(): Promise<NavigationBarPosition> {\n  console.warn('`unstable_getPositionAsync` is only available on Android');\n  return 'relative';\n}\n\n/**\n * Sets the behavior of the status bar and navigation bar when they are hidden and the user wants to reveal them.\n *\n * For example, if the navigation bar is hidden (`setVisibilityAsync(false)`) and the behavior\n * is `'overlay-swipe'`, the user can swipe from the bottom of the screen to temporarily reveal the navigation bar.\n *\n * - `'overlay-swipe'`: Temporarily reveals the System UI after a swipe gesture (bottom or top) without insetting your App's content.\n * - `'inset-swipe'`: Reveals the System UI after a swipe gesture (bottom or top) and insets your App's content (Safe Area). The System UI is visible until you explicitly hide it again.\n * - `'inset-touch'`: Reveals the System UI after a touch anywhere on the screen and insets your App's content (Safe Area). The System UI is visible until you explicitly hide it again.\n *\n * > This method is supported only when edge-to-edge is disabled. Using it in edge-to-edge app may lead to unexpected behavior.\n *\n * @example\n * ```ts\n * await NavigationBar.setBehaviorAsync('overlay-swipe')\n * ```\n * @param behavior Dictates the interaction behavior of the navigation bar.\n */\nexport async function setBehaviorAsync(behavior: NavigationBarBehavior): Promise<void> {\n  console.warn('`setBehaviorAsync` is only available on Android');\n}\n\n/**\n * Gets the behavior of the status and navigation bars when the user swipes or touches the screen.\n *\n * > This method is supported only when edge-to-edge is disabled. Using it in edge-to-edge app may lead to unexpected behavior.\n *\n * @example\n * ```ts\n * await NavigationBar.getBehaviorAsync()\n * ```\n * @returns Navigation bar interaction behavior. Returns `inset-touch` on unsupported platforms (iOS, web).\n */\nexport async function getBehaviorAsync(): Promise<NavigationBarBehavior> {\n  console.warn('`getBehaviorAsync` is only available on Android');\n  return 'inset-touch';\n}\n\n/**\n * Sets the style of the navigation bar.\n * > This will have an effect when the following conditions are met:\n * > - Edge-to-edge is enabled\n * > - The `enforceNavigationBarContrast` option of the `react-native-edge-to-edge` plugin is set to `false`.\n * > - The device is using the three-button navigation bar.\n *\n * > Due to a bug in the Android 15 emulator this function may have no effect. Try a physical device or an emulator with a different version of Android.\n *\n * @platform android\n */\nexport function setStyle(style: NavigationBarStyle) {\n  console.warn('`setStyle` method is only available on Android');\n}\n\n/**\n * React hook that statefully updates with the visibility of the system navigation bar.\n *\n * @example\n * ```ts\n * function App() {\n *   const visibility = NavigationBar.useVisibility()\n *   // React Component...\n * }\n * ```\n * @returns Visibility of the navigation bar, `null` during async initialization.\n */\nexport function useVisibility(): NavigationBarVisibility | null {\n  const [visibility, setVisible] = useState<NavigationBarVisibility | null>(null);\n\n  useEffect(() => {\n    setVisible('hidden');\n  }, []);\n\n  return visibility;\n}\n\nexport * from './NavigationBar.types';\n"]}

package/expo-module.config.json

@@ -5,7 +5,7 @@
     "publication": {
       "groupId": "host.exp.exponent",
       "artifactId": "expo.modules.navigationbar",
-      "version": "4.2.0",
+      "version": "4.2.1",
       "repository": "local-maven-repo"
     }
   }

package/local-maven-repo/host/exp/exponent/expo.modules.navigationbar/{4.2.0/expo.modules.navigationbar-4.2.0.module → 4.2.1/expo.modules.navigationbar-4.2.1.module}

@@ -3,7 +3,7 @@
   "component": {
     "group": "host.exp.exponent",
     "module": "expo.modules.navigationbar",
-    "version": "4.2.0",
+    "version": "4.2.1",
     "attributes": {
       "org.gradle.status": "release"
     }
@@ -24,8 +24,8 @@
       },
       "files": [
         {
-          "name": "expo.modules.navigationbar-4.2.0.aar",
-          "url": "expo.modules.navigationbar-4.2.0.aar",
+          "name": "expo.modules.navigationbar-4.2.1.aar",
+          "url": "expo.modules.navigationbar-4.2.1.aar",
           "size": 50116,
           "sha512": "9002413b7a09b940dda0ec41995b6fb09841f18ac5c64a81a149aa123d438487f1f5aaa072a0de7d54ad1e77712968d76502d4e745ea759defa83bce5edaecad",
           "sha256": "efc2da7015bb42d104de63aaafe098e547b290c00892881177100cff34bb1654",
@@ -67,8 +67,8 @@
       ],
       "files": [
         {
-          "name": "expo.modules.navigationbar-4.2.0.aar",
-          "url": "expo.modules.navigationbar-4.2.0.aar",
+          "name": "expo.modules.navigationbar-4.2.1.aar",
+          "url": "expo.modules.navigationbar-4.2.1.aar",
           "size": 50116,
           "sha512": "9002413b7a09b940dda0ec41995b6fb09841f18ac5c64a81a149aa123d438487f1f5aaa072a0de7d54ad1e77712968d76502d4e745ea759defa83bce5edaecad",
           "sha256": "efc2da7015bb42d104de63aaafe098e547b290c00892881177100cff34bb1654",
@@ -87,8 +87,8 @@
       },
       "files": [
         {
-          "name": "expo.modules.navigationbar-4.2.0-sources.jar",
-          "url": "expo.modules.navigationbar-4.2.0-sources.jar",
+          "name": "expo.modules.navigationbar-4.2.1-sources.jar",
+          "url": "expo.modules.navigationbar-4.2.1-sources.jar",
           "size": 5746,
           "sha512": "b062a1e85ccee489c49a264c5809226a0215ba7b7232895127f45002b605e6d5beb5739a3fee2c3b88420721949d17adfbd9dc15aaadebecd940958c871a8e28",
           "sha256": "c396cf58026bd79f443df5992bd12db17586c7e3702f1ace4c3e3e65a066cf14",

package/local-maven-repo/host/exp/exponent/expo.modules.navigationbar/4.2.1/expo.modules.navigationbar-4.2.1.module.md5

@@ -0,0 +1 @@
+eed6a5bfd357277ece058cb3ce576447

package/local-maven-repo/host/exp/exponent/expo.modules.navigationbar/4.2.1/expo.modules.navigationbar-4.2.1.module.sha1

@@ -0,0 +1 @@
+c06798b841a6ceac6728b0a9441f8fc7636dd3ef

package/local-maven-repo/host/exp/exponent/expo.modules.navigationbar/4.2.1/expo.modules.navigationbar-4.2.1.module.sha256

@@ -0,0 +1 @@
+bf1f763ef624de00a3c875f650a2497a1ef9b56970e3d470537291f732dbc546

package/local-maven-repo/host/exp/exponent/expo.modules.navigationbar/4.2.1/expo.modules.navigationbar-4.2.1.module.sha512

@@ -0,0 +1 @@
+51a901f47174f6dee6959261a8d393cfde601f7346f41cca12507d876eb294325c5be68496037154920ca3c3660357f50b32007c6c9c9803614e1b20307f4d67

package/local-maven-repo/host/exp/exponent/expo.modules.navigationbar/{4.2.0/expo.modules.navigationbar-4.2.0.pom → 4.2.1/expo.modules.navigationbar-4.2.1.pom}

@@ -9,7 +9,7 @@
   <modelVersion>4.0.0</modelVersion>
   <groupId>host.exp.exponent</groupId>
   <artifactId>expo.modules.navigationbar</artifactId>
-  <version>4.2.0</version>
+  <version>4.2.1</version>
   <packaging>aar</packaging>
   <name>expo.modules.navigationbar</name>
   <url>https://github.com/expo/expo</url>

package/local-maven-repo/host/exp/exponent/expo.modules.navigationbar/4.2.1/expo.modules.navigationbar-4.2.1.pom.md5

@@ -0,0 +1 @@
+7f0dac9356606d974b4b0b7d6f28c1d0

package/local-maven-repo/host/exp/exponent/expo.modules.navigationbar/4.2.1/expo.modules.navigationbar-4.2.1.pom.sha1

@@ -0,0 +1 @@
+aaf5245a9e30ae8165a1214a213f83bc6211ed80

package/local-maven-repo/host/exp/exponent/expo.modules.navigationbar/4.2.1/expo.modules.navigationbar-4.2.1.pom.sha256

@@ -0,0 +1 @@
+ca4384ee86f9155bed4877ce573a59e0e017c189ff4b01cff00b44609acb03a8

package/local-maven-repo/host/exp/exponent/expo.modules.navigationbar/4.2.1/expo.modules.navigationbar-4.2.1.pom.sha512

@@ -0,0 +1 @@
+04d996912145852212dd89fb5ee887319f5eeb11b225802b1453a2bcf6cc3dc6d2f15f9b26e7ec9a877fc642aa8eca1073613f83d16442848d9f9585a968a89e

package/local-maven-repo/host/exp/exponent/expo.modules.navigationbar/maven-metadata.xml

@@ -3,11 +3,11 @@
   <groupId>host.exp.exponent</groupId>
   <artifactId>expo.modules.navigationbar</artifactId>
   <versioning>
-    <latest>4.2.0</latest>
-    <release>4.2.0</release>
+    <latest>4.2.1</latest>
+    <release>4.2.1</release>
     <versions>
-      <version>4.2.0</version>
+      <version>4.2.1</version>
     </versions>
-    <lastUpdated>20250421213308</lastUpdated>
+    <lastUpdated>20250423205254</lastUpdated>
   </versioning>
 </metadata>

package/local-maven-repo/host/exp/exponent/expo.modules.navigationbar/maven-metadata.xml.md5

@@ -1 +1 @@
-bc75226166051fca81a20cd4b391104e
+12360f2d457f6ef79fcd102876cac4ec

package/local-maven-repo/host/exp/exponent/expo.modules.navigationbar/maven-metadata.xml.sha1

@@ -1 +1 @@
-f242d6e566913c9883f105e05bdd02e2b77e6470
+070056f57fd70a70b5261cd957a2f852452f72ef

package/local-maven-repo/host/exp/exponent/expo.modules.navigationbar/maven-metadata.xml.sha256

@@ -1 +1 @@
-874b736a29798298d102061509bde4e1c93542da819d31aaffc75889046c24b5
+20f0857ad758ee4a148f016a424bd8fac6ca5bcbe5d67d2d8d1b3d193bd49f47

package/local-maven-repo/host/exp/exponent/expo.modules.navigationbar/maven-metadata.xml.sha512

@@ -1 +1 @@
-0ec26a66fe23714b30881fa9064e18b252ebbdf6880ec84d5f53939bd960b0cdb38b0526c7ba52855fad1a0a0bdc60bb97b5ee8542faa85e24288fb111619113
+c2fee668e593c3e5bff744c8e865efe7478b203c671012df837c3d8b37314fdd5f83419cd18c0340670e3f2878f6e55cdfe3afb855fbfa56e48f0df68f9cdc9e

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "expo-navigation-bar",
-  "version": "4.2.0",
+  "version": "4.2.1",
   "description": "Modify and observe the native navigation bar on Android devices.",
   "main": "build/NavigationBar.js",
   "types": "build/NavigationBar.d.ts",
@@ -41,12 +41,12 @@
   },
   "devDependencies": {
     "@types/debug": "^4.1.7",
-    "expo-module-scripts": "^4.1.2"
+    "expo-module-scripts": "^4.1.4"
   },
   "peerDependencies": {
     "expo": "*",
     "react": "*",
     "react-native": "*"
   },
-  "gitHead": "f1394f21ff2719a9a3037d7511db170704e5c492"
+  "gitHead": "dd4ea2ac865a2b0c1f4ea3fc5879d90679099862"
 }

package/src/ExpoNavigationBar.ts

@@ -1 +1,35 @@
-export default {} as any;
+import type { EventSubscription } from 'expo-modules-core';
+import type { processColor } from 'react-native';
+
+import type {
+  NavigationBarBehavior,
+  NavigationBarButtonStyle,
+  NavigationBarPosition,
+  NavigationBarVisibility,
+  NavigationBarVisibilityEvent,
+} from './NavigationBar.types';
+
+export default {} as {
+  addListener: (
+    event: 'ExpoNavigationBar.didChange',
+    listener: (event: NavigationBarVisibilityEvent) => void
+  ) => EventSubscription;
+
+  setBackgroundColorAsync: (color: ReturnType<typeof processColor>) => Promise<void>;
+  getBackgroundColorAsync: () => Promise<string>;
+
+  setBehaviorAsync: (behavior: NavigationBarBehavior) => Promise<void>;
+  getBehaviorAsync: () => Promise<NavigationBarBehavior>;
+
+  setBorderColorAsync: (color: ReturnType<typeof processColor>) => Promise<void>;
+  getBorderColorAsync: () => Promise<string>;
+
+  setButtonStyleAsync: (style: NavigationBarButtonStyle) => Promise<void>;
+  getButtonStyleAsync: () => Promise<NavigationBarButtonStyle>;
+
+  setPositionAsync: (position: NavigationBarPosition) => Promise<void>;
+  unstable_getPositionAsync: () => Promise<NavigationBarPosition>;
+
+  setVisibilityAsync: (visibility: NavigationBarVisibility) => Promise<void>;
+  getVisibilityAsync: () => Promise<NavigationBarVisibility>;
+};