@apexnative/navigation 1.0.0-alpha.5 → 1.0.0-alpha.7

package/ApexNavigation.podspec

@@ -2,7 +2,8 @@
 # ApexNavigation): the Objective-C++ core and modules under ios/, with the public headers of ios/Public/ApexNavigation
 # (<ApexNavigation/ApexNavigation.h>, <ApexNavigation/ANNAppDelegate.h>, <ApexNavigation/ANNSceneDelegate.h>). Other
 # headers stay private to the pod and are imported by bare name. The C++ of the Fabric components ANNSlot and
-# ANNSafeAreaView is header-only, under ios/cpp, next to the code React Native's codegen makes from src/.
+# ANNSafeAreaView is under ios/cpp, next to the code React Native's codegen makes from src/: headers, and one source
+# file with the store of the slots' measured heights.
 require "json"
 
 package = JSON.parse(File.read(File.join(__dir__, "package.json")))

package/CHANGELOG.md

@@ -1,5 +1,37 @@
 # Changelog
 
+## [1.0.0-alpha.7](https://github.com/apexnative/navigation/compare/v1.0.0-alpha.6...v1.0.0-alpha.7) (2026-10-29)
+
+
+### Features
+
+* own android sheet and bar row, ios transitions in core animation, fast refresh of screens ([#56](https://github.com/apexnative/navigation/issues/56)) ([3113b42](https://github.com/apexnative/navigation/commit/3113b42a466f59490faaca181178a7840dab2826))
+
+## [1.0.0-alpha.6](https://github.com/apexnative/navigation/compare/v1.0.0-alpha.5...v1.0.0-alpha.6) (2026-10-25)
+
+
+### ⚠ BREAKING CHANGES
+
+* leave the bottom edge of a screen free by default ([#49](https://github.com/apexnative/navigation/issues/49))
+
+### Features
+
+* a sheet's back preview on android, lighter tabs and top bar, the compatibility mode on ios 27 ([#46](https://github.com/apexnative/navigation/issues/46)) ([24d333d](https://github.com/apexnative/navigation/commit/24d333dd43fc5e056786f22dc8d7f1a0ff82a1ad))
+* leave the bottom edge of a screen free by default ([#49](https://github.com/apexnative/navigation/issues/49)) ([b6bb165](https://github.com/apexnative/navigation/commit/b6bb165152114fb2886bd3c4ee55560c418f0cbe))
+* **tabs:** choose whether a tab switch animates with bottomTabs.switchAnimation ([#52](https://github.com/apexnative/navigation/issues/52)) ([c6185b6](https://github.com/apexnative/navigation/commit/c6185b6b42574cff671def1ebdf8aa4f5e4be681))
+
+
+### Bug Fixes
+
+* an explicit top edge stays free under a large title ([#53](https://github.com/apexnative/navigation/issues/53)) ([188a89e](https://github.com/apexnative/navigation/commit/188a89e8d160c071f91cc010ed43ccc0683e12b3))
+* shared elements fly turned and scaled views the same way on ios and android ([#50](https://github.com/apexnative/navigation/issues/50)) ([bf63ab6](https://github.com/apexnative/navigation/commit/bf63ab624d33ff9295af297ce6506206b1bfa0e6))
+* the custom tab row moves with its tabs on android, and tab cells get selected and badge ([#51](https://github.com/apexnative/navigation/issues/51)) ([fd8f41d](https://github.com/apexnative/navigation/commit/fd8f41d2efd108741672220c54253a86704929a5))
+
+
+### Performance Improvements
+
+* **ios:** render a preview's screen when a press on its view starts ([#48](https://github.com/apexnative/navigation/issues/48)) ([4a57d1a](https://github.com/apexnative/navigation/commit/4a57d1aee1df7690dbde4c7d08dca2a70773d1f5))
+
 ## [1.0.0-alpha.5](https://github.com/apexnative/navigation/compare/v1.0.0-alpha.4...v1.0.0-alpha.5) (2026-10-23)
 
 

package/README.md

@@ -97,7 +97,7 @@ navigation.push('Details', { props: { title: 'Order 42' } });
   each other: tabs of stacks, a stack in a modal, tabs in a side menu.
 - **Screen UI as options:** the top bar, bar buttons, search, the toolbar and the floating action button, the status
   bar and the system bars.
-- **No safe area code:** every screen keeps its content clear of the bars, the cutout and the home indicator by itself.
+- **No safe area code:** every screen keeps its top and sides clear of the bars and the cutout by itself; the bottom is free, and a list adds `useSafeAreaInsets().bottom`.
 - **Native screens:** SwiftUI, UIKit and Compose screens are pushed, presented and put in tabs the same way as React
   screens.
 - **One React tree when you want it:** each screen is its own React root by default; with `appProvider` all screens

package/android/CLAUDE.md

@@ -22,8 +22,9 @@ top-level folder. Main thread only, unless a line says otherwise.
   `Variant`, `ThemeColour`); `parsers/` reads them tolerantly from React Native data.
 - `react/`: the way in and out: `NavigationTurboModule`, `CommandRunner`, `CommandAnswer`, `ErrorTexts`,
   `OptionsCommands`, `PendingCalls` (a task behind the calls JavaScript made), `ReloadCoordinator`, `ReactGateway`,
-  `ReactView` (a React root), the stores (`ScreenInsets`, `ScreenRegions`, `ArrangementStates`, `Hinge`, `StartInfo`),
-  `LaunchLink`, `ScrollEvents`.
+  `ReactView` (a React root), `ContentHeights` (content measured without a height limit, through JNI), the stores
+  (`ScreenEnvironment`: a screen's insets, padding, regions and pair state; `Hinge`, `StartInfo`), `ScreenRegions`
+  (measures a screen's regions), `LaunchLink`, `ScrollEvents`.
 - `react/events/`: `AppearanceDispatcher`, `ScreenAppearance`, `EventEmitter`, `EventContract` (made by
   `scripts/contract.mjs`), `NavigationState`, `ComponentType`.
 - `viewcontrollers/viewcontroller/`: `ViewController` (the base of every node), `Presenter`, `IReactView` (what a
@@ -44,7 +45,7 @@ top-level folder. Main thread only, unless a line says otherwise.
 - `viewcontrollers/sidemenu/`: `SideMenuController`, `SideMenuMotion`, `SideMenuPresenter`, `SideMenuRules`.
 - `viewcontrollers/splitview/`, `arrangement/`: the split view and the pair (modules, plus the core's
   `SplitViewPresenter`).
-- `viewcontrollers/modal/`, `overlay/`: `ModalCoordinator`, `ModalRecord`, `ModalViews`, `ModalSheet`;
+- `viewcontrollers/modal/`, `overlay/`: `ModalCoordinator`, `ModalRecord`, `ModalViews`, `ModalSheet`, `SheetBack`;
   `OverlayCoordinator`, `OverlayRecord`, `OverlayViews`, `OverlayTouches`.
 - `views/`: Android views and animators, no rules: `component/`, `externalcomponent/`, `stack/` (`StackLayout`,
   `topbar/`, `fab/`), `bottomtabs/`, `sidemenu/`, `animations/` (curves, `SideAnimator`, `AnimationRules`), `element/`
@@ -58,7 +59,8 @@ top-level folder. Main thread only, unless a line says otherwise.
   `DevelopmentLog`).
 - `android/src/main/jni/`: `CMakeLists.txt` builds the codegen target with the C++ of `ios/cpp` (the slot's and the
   safe area view's shadow nodes); `ApexNavigationSpec.h` replaces the generated header so autolinking sees their
-  descriptors.
+  descriptors; `ANNContentHeights.cpp` measures React content without a height limit for `react/ContentHeights.kt`
+  (a sheet's `'content'` detent).
 - `android/src/main/res/`: theme `Theme.ApexNavigation` (and `values-night`), `attrs.xml` (splash attributes),
   `ids.xml`, `dimens*.xml`, text colors, icons.
 - `android/src/test/java/…`: unit tests, one package per main package; fakes beside them (`Fakes.kt`,
@@ -78,16 +80,21 @@ top-level folder. Main thread only, unless a line says otherwise.
   `StackViews.kt`, `StackTransitions.kt`, `PreparedPushes.kt`; `views/stack/StackLayout.kt`, `ScreenEdge.kt` (the edge
   a moving screen extends); back: `NavigationActivity.kt`, `viewcontrollers/navigator/BackCallbackState.kt`; the
   preview of a pop during the back gesture (Android 14+): `StackController.BackGesture`, `BackPreview.kt`,
-  `stackPoppedByBack` of the layouts.
-- Stack FAB: `viewcontrollers/stack/fab/FabPresenter.kt`, `FabPlan.kt`, `FabPlacement.kt`; `views/stack/fab/`.
+  `stackPoppedByBack` of the layouts; of a sheet's dismissal: `viewcontrollers/modal/SheetBack.kt`,
+  `ModalCoordinator.backTargetSheet`, `ModalSheet.BackPreview`.
+- Stack FAB: `viewcontrollers/stack/fab/FabPresenter.kt`, `FabPlan.kt`, `FabPlacement.kt`, `FabMotion.kt` (how it goes
+  with a transition); `views/stack/fab/` (`FabCopy`: the picture of a FAB that leaves).
 - Top bar (title, buttons, menus, large title): `viewcontrollers/stack/topbar/TopBarPresenter.kt`, `TopBarRoom.kt`,
   `TopBarVisibility.kt`, `BarComponents.kt`, `ButtonPlaces.kt`, `LargeTitleCollapse.kt`, `BarRowTransition.kt`;
-  `views/stack/topbar/TopBar.kt`, `TitleBar.kt`, `titlebar/ButtonBar.kt`, `titlebar/ButtonMenus.kt`.
+  `views/stack/topbar/TopBar.kt`, `TitleBar.kt`, `titlebar/ButtonRow.kt` (the views of a side: back, buttons,
+  magnifier, "⋮"), `titlebar/ButtonBar.kt` (the buttons from the options, "⋮"'s popup), `titlebar/BarButtonView.kt`,
+  `titlebar/BarMenu.kt` (the bar's menus: a `ListPopupWindow` with the theme's popup style and the options' colors),
+  `titlebar/ButtonMenus.kt` (menu options to its items).
 - Search: `viewcontrollers/stack/search/StackSearchPresenter.kt`, `ScreenSearch.kt`, `SearchPanel.kt`;
   `views/stack/topbar/search/`.
 - Tabs: `viewcontrollers/bottomtabs/BottomTabsController.kt`, `BottomTabsPresenter.kt`, `TabSelection.kt`,
   `TabItems.kt`, `TabsRoom.kt`; `views/bottomtabs/`; `customrow/BottomTabsCustomRowOptions.kt`,
-  `viewcontrollers/bottomtabs/CustomTabRowPlacer.kt`.
+  `viewcontrollers/bottomtabs/CustomTabRowGeometry.kt`.
 - Modals and sheets: `viewcontrollers/modal/ModalCoordinator.kt`, `ModalRecord.kt`, `ModalViews.kt`, `ModalSheet.kt`,
   `ModalAnimations.kt`; `options/SheetOptions.kt`.
 - Overlays: `viewcontrollers/overlay/OverlayCoordinator.kt`, `OverlayViews.kt`, `OverlayTouches.kt`.
@@ -96,12 +103,13 @@ top-level folder. Main thread only, unless a line says otherwise.
 - Split view: `viewcontrollers/splitview/SplitViewController.kt`, `SplitViewLayout.kt`, `SplitPanes.kt`,
   `SplitViewPresenter.kt`; `StackCommands.showInColumn`.
 - Pair (arrangement): `viewcontrollers/arrangement/ArrangementController.kt`, `ArrangementPlanner.kt`,
-  `ArrangementLayout.kt`, `ArrangementDefinition.kt`; `react/ArrangementStates.kt`.
+  `ArrangementLayout.kt`, `ArrangementDefinition.kt`; the pair's state in `react/ScreenEnvironment.kt`.
 - Preview, key commands: iOS only. The options are parsed and merged (`options/PreviewOptions.kt`,
   `options/KeyCommandOptions.kt`) and not applied; `dismissPreview` does nothing.
 - Animations and transitions: `views/animations/` (`AnimationRules`, `Curves`, `SideAnimator`, `ValueInterpolation`,
-  `FadeThrough`, `SystemTransition`); `views/element/` (`ElementTransitions`, `TransitionLayer`, `TargetsWait`,
-  `animators/`); `options/StackAnimationOptions.kt`, `ViewAnimationOptions.kt`.
+  `FadeThrough`, `SystemTransition`, `AnimationLayer`: the hardware layer of a fade); `views/element/`
+  (`ElementTransitions`, `TransitionLayer`, `TargetsWait`, `animators/`); `options/StackAnimationOptions.kt`,
+  `ViewAnimationOptions.kt`.
 - System bars: `system/SystemUiOwner.kt`, `SystemUiLayers.kt`, `SystemUiRules.kt`, `SystemUiWindow.kt`,
   `AppDirection.kt`; `viewcontrollers/parent/ContainerBackground.kt`.
 - Events and state: `react/events/AppearanceDispatcher.kt`, `ScreenAppearance.kt`, `EventEmitter.kt`,
@@ -111,21 +119,21 @@ top-level folder. Main thread only, unless a line says otherwise.
 - Error texts and answers: `react/ErrorTexts.kt` and `react/CommandContract.kt`, made by `scripts/contract.mjs` from
   `src/interfaces/contract/errors.json` and `commands.json`.
 - Links: `react/LaunchLink.kt`, `NavigationActivity.kt` (`onNewIntent`); `react/StartInfo.kt`.
-- Hinge and regions: `react/Hinge.kt`, `react/ScreenRegions.kt`, `react/ScreenInsets.kt`, `utils/WindowFolds.kt`.
+- Hinge and regions: `react/Hinge.kt`, `react/ScreenRegions.kt`, `react/ScreenEnvironment.kt`, `utils/WindowFolds.kt`.
 - Native screens: `nativescreen/NativeScreenContext.kt`, `NativeScreenCalls.kt`, `NativeScreenCreator.kt`;
   `viewcontrollers/externalcomponent/`.
 - Slots: `slots/SlotHost.kt`, `SlotView.kt`, `SlotScreenView.kt`, `SlotContainers.kt` (containers and slot views by
   slot id: a change goes straight to the views of its id, `SlotViews.kt`), `SlotViewManager.kt`.
 - Safe area: `safearea/SafeAreaView.kt`, `SafeAreaViewManager.kt`; `viewcontrollers/component/ScreenReadiness.kt`;
-  `react/ScreenInsets.kt`.
+  `react/ScreenEnvironment.kt`.
 - The C++ of `ANNSlot`, `ANNSafeAreaView`: `android/src/main/jni/CMakeLists.txt`, `ApexNavigationSpec.h`; sources in
   `ios/cpp/`.
 
 ## Threads
 
 - **JS thread.** The sync getters `getScreenInsets`, `getScreenRegions`, `getArrangementState`, `getHinge`,
-  `getStartInfo` read stores (`ConcurrentHashMap` in `ScreenInsets`, `ScreenRegions`, `ArrangementStates`; `@Volatile`
-  in `Hinge`). They never touch a node.
+  `getStartInfo` read stores (one `ConcurrentHashMap` of immutable records in `ScreenEnvironment`; `@Volatile` in
+  `Hinge`). They never touch a node.
 - **Module thread.** The `check` of every command with a promise: `LayoutReader` and, through it, `OptionsReader` (also
   for `setDefaultOptions`, `mergeOptions` and the options of `dismissModal`, in the runner's `prepare` step);
   `ReadableJson` for native-screen props. The registry of native screens is read under its lock. Images are not loaded
@@ -156,9 +164,9 @@ top-level folder. Main thread only, unless a line says otherwise.
 - Native code never touches React Native's views (their children, their layout): Fabric owns and recycles them. Move
   content through `SlotContainers` and `SlotView`, and find views by `nativeID` only through React Native's own search
   or its tag (`ReactR.id.view_tag_native_id`); a transition's elements in one walk per screen (`TransitionViews`).
-- Each step of a transition's element (its move into the layer, its animator, a flight's start and frames in
-  `MoveAnimator`) runs in `elementStep`: an exception skips that element only. A new step of an element goes there
-  too, or one bad element takes the whole transition down.
+- Each step of a transition's element (its start, its animator, a flight's start and frames in `MoveAnimator`) runs
+  in `elementStep`, and the layer draws each copy on its own: an exception skips that element only. A new step of an
+  element goes there too, or one bad element takes the whole transition down.
 - Every change of a stack's children goes through its `StackQueue`; a direct change of `shown` or of the container
   skips the table that decides interrupts and answers.
 - Every event of an appearance goes through `AppearanceDispatcher`. A container with its own loop of
@@ -198,8 +206,11 @@ top-level folder. Main thread only, unless a line says otherwise.
 - The bar measures to its children: a picture laid into it for a transition that is taller than the bar the incoming
   screen gives holds the bar at that height to the end (the row's picture of a pop from a large title). What doesn't
   stay in the bar rides with the leaving screen (`TopBarPresenter.pictureUnderRow`).
-- A `Toolbar` centers its navigation button and its menu in `min(minimumHeight, height)` (`buttonGravity` is top):
-  the row's toolbars take the row's height as their minimum (`TitleBar`); 0 pins the buttons to the row's top.
+- The bar's buttons are plain views of the row (`ButtonRow`), not a toolbar's menu: a button keeps its view while its id
+  stays, and its `testID` is set when it is bound. They copy a Material 3 toolbar's look through the theme's
+  attributes (`actionButtonStyle`, `actionMenuTextAppearance`, `actionOverflowButtonStyle`,
+  `toolbarNavigationButtonStyle`) and its `maxButtonHeight` of 56 dp; the count of places is AppCompat's
+  (`ButtonPlaces.maxActionButtons`).
 - A screen's overlay is clipped to the screen, and a screen without a large title is laid out under the bar (its `top`
   is the bar's height): a picture of the bar in its overlay doesn't show. The bar's picture in a transition of the
   stack's own is drawn by the stack's view with the screen's transform (`StackLayout.barTravels`).

package/android/CORE.md

@@ -10,7 +10,7 @@ otherwise.
 ```
 JS ─ ANNTurboModule (codegen NativeANNTurboModuleSpec)
  │      sync getters answer on the JS thread from stores the main thread fills
- │      (ScreenInsets, ScreenRegions, ArrangementStates, Hinge, StartInfo)
+ │      (ScreenEnvironment, Hinge, StartInfo)
  ▼ module thread
 react/NavigationTurboModule      one override per method
  │  layout/LayoutReader ► options/OptionsReader     the whole layout read and checked, its options read
@@ -188,7 +188,7 @@ Each rule has one owner. Change the owner, not a caller; if a new feature needs
 - **Room for the bars.** A screen's room at the top and bottom is `ScreenFrame` with `ScreenSafeArea` and the
   `ParentController` room hooks (`getTopInset`, `keepsStatusBarRoomOf`, …). A screen in a pair forwards its room to
   the pair (`ScreenFrame.applyRoom`), and the pair's `getTopInset` uses the screens' rule (`ScreenFrame.topRoomOf`)
-  with the options it shows with. A view's place in the window for the safe area (the React root, the stack's header
+  with the options it shows with. The bottom edge is not padded by default (only `'bottom'` in the edges pads it); `roomPadding` still shrinks the view for an opaque navigation bar and the keyboard. A view's place in the window for the safe area (the React root, the stack's header
   bottom in `headerBottomOf`, the tabs' top in `tabsTopOf`) is `RestPlace`: from layout, without translations, a sheet
   at rest.
 - **A container's own move.** A container that moves children in or out of the window without a command (the split
@@ -207,11 +207,12 @@ Modules are the feature classes that plug into the core through its contract (th
   custom row (`BottomTabsCustomRowOptions`).
 - **Views and helpers:** tabs bar (`BottomTabs`, `BottomTabItem`, `BottomTabsCollapseBehavior`, `scrollToTop`), slots
   (`SlotHost`, `SlotView`, `SlotContainers`), safe area (`SafeAreaView`), native screens (`nativescreen/`), splash
-  (`splash/`), animations (`FadeThrough`, `SystemTransition`, `TransitionTargets`, three element animators), utils
-  (`MaterialTheme`, `NavigationLog`, `awaitBarComponents`, `whenDrawn`).
-- **Stores and singletons:** regions (`Hinge`, `ScreenInsets`, `ScreenRegions`, `WindowFolds`), pair state
-  (`ArrangementStates`), links (`LaunchLink`, `StartInfo`), events (`NavigationState`), commands
-  (`BackCallbackState`), stack (`PreparedFrame`).
+  (`splash/`), animations (`FadeThrough`, `SystemTransition`, `TransitionTargets`, the copies of shared elements:
+  `TextMorph`, `ViewMorph`, `ImageMorph`), utils (`MaterialTheme`, `NavigationLog`, `awaitBarComponents`,
+  `whenDrawn`).
+- **Stores and singletons:** a screen's environment (`ScreenEnvironment`: its insets and padding, its regions as
+  `ScreenRegions` measures them, its pair state), the window (`Hinge`, `WindowFolds`), links (`LaunchLink`,
+  `StartInfo`), events (`NavigationState`), commands (`BackCallbackState`), stack (`PreparedFrame`).
 
 How they plug in:
 
@@ -235,5 +236,8 @@ How they plug in:
 - **Core code in a module's folder:** `viewcontrollers/splitview/SplitViewPresenter.kt`, `slots/SlotScreenView.kt`,
   and in `views/animations/` and `views/element/` everything except the files named above.
 - **Stores** are written on the main thread by the core and read from any thread; they are cleared with their nodes and on
-  reload. Their events, and the search's, go through the emitter of the JavaScript the screen was made for
+  reload. A screen's environment is one immutable record per id in `ScreenEnvironment` (insets for JavaScript, padding,
+  regions, pair state), replaced at once; the screen's node clears it with one `remove` when it is destroyed, unless a
+  later node has its id; the padding listeners of its safe area views stay until the views stop. Their events, and
+  the search's, go through the emitter of the JavaScript the screen was made for
   (`EventEmitter.of(node.jsGeneration)`); the hinge keeps the `EventEmitter.current()` of the call that turned it on.

package/android/consumer-rules.pro

@@ -1,2 +1,8 @@
 # The native screens `npx apex-navigation codegen` lists in the app: the navigation finds the list by its name.
 -keep class dev.apexnative.navigation.generated.ApexNavigationGeneratedScreens { *; }
+
+# The library's C++ measures a React root's content through the surface's handler, which it reads by this getter's
+# name (`android/src/main/jni/ANNContentHeights.cpp`).
+-keepclassmembers class com.facebook.react.runtime.ReactSurfaceImpl {
+    com.facebook.react.fabric.SurfaceHandlerBinding getSurfaceHandler();
+}

package/android/src/main/java/dev/apexnative/navigation/NavigationActivity.kt

@@ -35,6 +35,7 @@ import dev.apexnative.navigation.splash.SplashTheme
 import dev.apexnative.navigation.splash.SplashView
 import dev.apexnative.navigation.system.SystemUiWindow
 import dev.apexnative.navigation.utils.MaterialTheme
+import dev.apexnative.navigation.viewcontrollers.modal.SheetBack
 import dev.apexnative.navigation.viewcontrollers.navigator.BackCallbackCheck
 import dev.apexnative.navigation.viewcontrollers.navigator.BackCallbackState
 import dev.apexnative.navigation.viewcontrollers.navigator.Navigator
@@ -72,23 +73,33 @@ open class NavigationActivity : AppCompatActivity(), DefaultHardwareBackBtnHandl
     // Enabled while back has something to do in the app (BackCallbackState); otherwise the system does its own back.
     // From Android 14, where the app hears the progress of the back gesture, a gesture that would pop a stack with the
     // default transition previews the pop as the system previews back between activities (`StackController
-    // .BackGesture`); JavaScript's listeners hear back first, so with them there is no preview.
+    // .BackGesture`), and one that would dismiss a sheet previews its hide as Material's sheets do (`SheetBack`), its
+    // release closing it as a drag down does; JavaScript's listeners hear back first, so with them there is no preview.
     private val backCallback = object : OnBackPressedCallback(false) {
         override fun handleOnBackStarted(backEvent: BackEventCompat) {
             backGesture = null
-            navigator?.let { backCheck?.atBack(it) }
+            sheetGesture = null
+            val navigator = navigator ?: return
+            backCheck?.atBack(navigator)
             if (Build.VERSION.SDK_INT < Build.VERSION_CODES.UPSIDE_DOWN_CAKE || BackCallbackState.hasJsListeners) return
-            val stack = navigator?.stackPoppedByBack() ?: return
-            backGesture = stack.startBackGesture(backEvent.swipeEdge == BackEventCompat.EDGE_LEFT, backEvent.touchY)
+            val stack = navigator.stackPoppedByBack()
+            if (stack != null) {
+                backGesture = stack.startBackGesture(backEvent.swipeEdge == BackEventCompat.EDGE_LEFT, backEvent.touchY)
+                return
+            }
+            sheetGesture = navigator.sheetDismissedByBack()?.startBackPreview(backEvent)
         }
 
         override fun handleOnBackProgressed(backEvent: BackEventCompat) {
             backGesture?.progress(backEvent.progress, backEvent.touchY)
+            sheetGesture?.progress(backEvent)
         }
 
         override fun handleOnBackCancelled() {
             backGesture?.cancel()
             backGesture = null
+            sheetGesture?.cancel()
+            sheetGesture = null
             navigator?.let(BackCallbackState::update)
         }
 
@@ -96,13 +107,33 @@ open class NavigationActivity : AppCompatActivity(), DefaultHardwareBackBtnHandl
             navigator?.let { backCheck?.atBack(it) }
             val gesture = backGesture
             backGesture = null
-            if (gesture?.commit() == true) BackCallbackState.update() else passBack()
+            val sheet = sheetGesture
+            sheetGesture = null
+            when {
+                gesture?.commit() == true -> BackCallbackState.update()
+                sheet != null && commitSheet(sheet) -> BackCallbackState.update()
+                else -> passBack()
+            }
         }
     }
 
     // The back gesture that previews a pop now; none.
     private var backGesture: StackController.BackGesture? = null
 
+    // The back gesture that previews a sheet's hide now; none.
+    private var sheetGesture: SheetBack.Gesture? = null
+
+    // A sheet's preview released: the sheet goes as the user's drag down closes it, and back doesn't go on (no
+    // `passBack`, which would dismiss it a second time). A command that changed what back does since the gesture
+    // started (a push in the sheet, a modal over it, a hold) leaves it to the usual back, the sheet back in place.
+    private fun commitSheet(gesture: SheetBack.Gesture): Boolean {
+        if (navigator?.sheetDismissedByBack() !== gesture.sheet) {
+            gesture.cancel()
+            return false
+        }
+        return gesture.commit()
+    }
+
     // Debug builds only: the check that what back does never changes without its trigger (BackCallbackState), sampled
     // before frames and at back events. It only logs; release builds have neither the check nor the listener.
     private val backCheck = if (BuildConfig.DEBUG) BackCallbackCheck() else null

package/android/src/main/java/dev/apexnative/navigation/options/BottomTabOptions.kt

@@ -105,7 +105,7 @@ class BottomTabOptions {
     @JvmField var textColor: ThemeColour = NullThemeColour()
     @JvmField var selectedIconColor: ThemeColour = NullThemeColour()
     @JvmField var selectedTextColor: ThemeColour = NullThemeColour()
-    @JvmField var font = FontOptions()
+    @ReadFromParent @JvmField var font = FontOptions()
     @JvmField var fontSize: Fraction = NullFraction()
     @JvmField var selectedFontSize: Fraction = NullFraction()
     @JvmField var iconInsets = IconInsetsOptions()

package/android/src/main/java/dev/apexnative/navigation/options/BottomTabsOptions.kt

@@ -95,6 +95,7 @@ class BottomTabsAccessoryOptions {
 class BottomTabsOptions {
     @JvmField var visible: Bool = NullBool()
     @JvmField var animate: Bool = NullBool()
+    @JvmField var switchAnimation: Text = NullText()
     /** Selects a tab once; a whole number, truncated where it is read. */
     @JvmField var currentTabIndex: Fraction = NullFraction()
     /** Selects a tab once. */
@@ -124,18 +125,19 @@ class BottomTabsOptions {
     @JvmField var minimizeBehavior: Text = NullText()
     @JvmField var bottomAccessory = BottomTabsAccessoryOptions()
 
-    fun hasValue(): Boolean = visible.hasValue() || animate.hasValue() || currentTabIndex.hasValue() ||
-        currentTabId.hasValue() || testID.hasValue() || accessibilityLabel.hasValue() || moreTestID.hasValue() ||
-        drawBehind.hasValue() || backgroundColor.hasValue() || tabsAttachMode.hasValue() || barStyle.hasValue() ||
-        layoutStyle.hasValue() || cornerRadius.hasValue() || bottomMargin.hasValue() || translucent.hasValue() ||
-        hideShadow.hasValue() || titleDisplayMode.hasValue() || elevation.hasValue() || hideOnScroll.hasValue() ||
-        borderColor.hasValue() || borderWidth.hasValue() || shadow.hasValue() || customRow.hasValue() ||
-        sidebar.hasValue() || sidebarLayout.hasValue() || customizationId.hasValue() || minimizeBehavior.hasValue() ||
-        bottomAccessory.hasValue()
+    fun hasValue(): Boolean = visible.hasValue() || animate.hasValue() || switchAnimation.hasValue() ||
+        currentTabIndex.hasValue() || currentTabId.hasValue() || testID.hasValue() || accessibilityLabel.hasValue() ||
+        moreTestID.hasValue() || drawBehind.hasValue() || backgroundColor.hasValue() || tabsAttachMode.hasValue() ||
+        barStyle.hasValue() || layoutStyle.hasValue() || cornerRadius.hasValue() || bottomMargin.hasValue() ||
+        translucent.hasValue() || hideShadow.hasValue() || titleDisplayMode.hasValue() || elevation.hasValue() ||
+        hideOnScroll.hasValue() || borderColor.hasValue() || borderWidth.hasValue() || shadow.hasValue() ||
+        customRow.hasValue() || sidebar.hasValue() || sidebarLayout.hasValue() || customizationId.hasValue() ||
+        minimizeBehavior.hasValue() || bottomAccessory.hasValue()
 
     fun mergeWith(other: BottomTabsOptions) {
         if (other.visible.hasValue()) visible = other.visible
         if (other.animate.hasValue()) animate = other.animate
+        if (other.switchAnimation.hasValue()) switchAnimation = other.switchAnimation
         if (other.currentTabIndex.hasValue()) currentTabIndex = other.currentTabIndex
         if (other.currentTabId.hasValue()) currentTabId = other.currentTabId
         if (other.testID.hasValue()) testID = other.testID
@@ -167,6 +169,7 @@ class BottomTabsOptions {
     fun mergeWithDefault(defaults: BottomTabsOptions) {
         if (!visible.hasValue()) visible = defaults.visible
         if (!animate.hasValue()) animate = defaults.animate
+        if (!switchAnimation.hasValue()) switchAnimation = defaults.switchAnimation
         if (!currentTabIndex.hasValue()) currentTabIndex = defaults.currentTabIndex
         if (!currentTabId.hasValue()) currentTabId = defaults.currentTabId
         if (!testID.hasValue()) testID = defaults.testID
@@ -198,6 +201,7 @@ class BottomTabsOptions {
     fun copy() = BottomTabsOptions().also { it.mergeWith(this) }
 
     companion object {
+        private val SWITCH_ANIMATIONS = setOf("platform", "none")
         private val TABS_ATTACH_MODES = setOf("together", "afterInitialTab", "onSwitchToTab")
         private val BAR_STYLES = setOf("default", "black")
         private val LAYOUT_STYLES = setOf("stretch", "compact")
@@ -212,6 +216,7 @@ class BottomTabsOptions {
             if (map == null) return options
             options.visible = BoolParser.parse(map, "visible")
             options.animate = BoolParser.parse(map, "animate")
+            options.switchAnimation = TextParser.parse(map, "switchAnimation", SWITCH_ANIMATIONS)
             options.currentTabIndex = FractionParser.parse(map, "currentTabIndex")
             options.currentTabId = TextParser.parse(map, "currentTabId")
             options.testID = TextParser.parse(map, "testID")

package/android/src/main/java/dev/apexnative/navigation/options/ButtonOptions.kt

@@ -31,7 +31,7 @@ class ButtonOptions(@JvmField var id: Text = NullText()) {
     @JvmField var systemItem: Text = NullText()
     @JvmField var text: Text = NullText()
     @JvmField var accessibilityLabel: Text = NullText()
-    @JvmField var font = FontOptions()
+    @ReadFromParent @JvmField var font = FontOptions()
     @JvmField var fontSize: Fraction = NullFraction()
     @JvmField var enabled: Bool = NullBool()
     @JvmField var disableIconTint: Bool = NullBool()

package/android/src/main/java/dev/apexnative/navigation/options/LargeTitleOptions.kt

@@ -22,7 +22,7 @@ class LargeTitleOptions {
     @JvmField var collapseOnScroll: Bool = NullBool()
     @JvmField var fontSize: Fraction = NullFraction()
     @JvmField var color: ThemeColour = NullThemeColour()
-    @JvmField var font = FontOptions()
+    @ReadFromParent @JvmField var font = FontOptions()
 
     /**
      * When the large title shows: [ALWAYS], [NEVER] or [AUTOMATIC], as on the screen below. `displayMode` over

package/android/src/main/java/dev/apexnative/navigation/options/LayoutAnimation.kt

@@ -9,7 +9,7 @@ import com.facebook.react.bridge.ReadableMap
  * first).
  */
 open class LayoutAnimation(
-    @JvmField var sharedElements: SharedElements = SharedElements(),
+    @OptionKey("sharedElementTransitions") @JvmField var sharedElements: SharedElements = SharedElements(),
     @JvmField var elementTransitions: ElementTransitions = ElementTransitions(),
 ) {
     open fun hasValue(): Boolean = sharedElements.hasValue() || elementTransitions.hasValue()

package/android/src/main/java/dev/apexnative/navigation/options/OptionKey.kt

@@ -0,0 +1,18 @@
+package dev.apexnative.navigation.options
+
+/**
+ * The JSON key of an option field whose name is not that key (`topBar.backButton` is `TopBarButtons.back`), for the
+ * paths of [OptionPaths]; also the flag that tells a value is given, which goes with it. A field without it answers to
+ * its own name.
+ */
+@Target(AnnotationTarget.FIELD)
+@Retention(AnnotationRetention.RUNTIME)
+annotation class OptionKey(val name: String)
+
+/**
+ * A group the reader takes from the object of the group that holds it, not from a key of its own (the font of a text,
+ * the top bar's buttons): for the paths of [OptionPaths] its fields answer to the keys of that object.
+ */
+@Target(AnnotationTarget.FIELD)
+@Retention(AnnotationRetention.RUNTIME)
+annotation class ReadFromParent

package/android/src/main/java/dev/apexnative/navigation/options/OptionPaths.kt

@@ -0,0 +1,91 @@
+package dev.apexnative.navigation.options
+
+import dev.apexnative.navigation.options.params.Param
+import dev.apexnative.navigation.options.params.ThemeColour
+import java.lang.reflect.Field
+import java.lang.reflect.Modifier
+import java.util.concurrent.ConcurrentHashMap
+
+/**
+ * The options at a JSON key path, the keys of the options joined with dots (`topBar.subtitle`, `bottomTab.badge`), as
+ * the readers parse them: `clearOptions` takes them out of a node's own options. Generic over the whole tree, by
+ * reflection on the fields of the groups: a field answers to the key of its name, or of its [OptionKey]; a group the
+ * reader takes from the object of its parent ([ReadFromParent]: the font of a text, the top bar's buttons) answers with
+ * its fields to the keys of that object. A group is a class with a `mergeWith` of its own class; anything else (a
+ * value, a color, a list, a button menu) ends a path.
+ */
+internal object OptionPaths {
+    /**
+     * What a path names: the fields of [group] that answer to its last key, [members] (one, or a value and the flag
+     * that tells it is given, as `modal.sheet.largestUndimmedDetent`).
+     */
+    class Place(val group: Any, val members: List<Field>) {
+        /** The value at the path, of the first field. */
+        val value: Any? get() = members.first().get(group)
+    }
+
+    // The fields of each class walked, its superclasses' first.
+    private val fieldsOfType = ConcurrentHashMap<Class<*>, List<Field>>()
+
+    /**
+     * Takes the value at [path] out of [options], which it changes in place: the field gets the value a freshly made
+     * group has for it (unset; a group, an empty one). Whether the path names a field; an empty or unknown path, or
+     * one that goes on inside a value (a side of a color), changes nothing.
+     */
+    fun clear(options: Options, path: String): Boolean {
+        val place = find(options, path) ?: return false
+        val fresh = newGroup(place.group.javaClass) ?: return false
+        place.members.forEach { it.set(place.group, it.get(fresh)) }
+        return true
+    }
+
+    /** The fields [path] names in [options]; none for an empty or unknown path or one inside a value. */
+    fun find(options: Options, path: String): Place? {
+        val keys = path.split('.')
+        if (keys.any(String::isEmpty)) return null
+        var group: Any = options
+        for (key in keys.dropLast(1)) {
+            group = fieldOf(group, key)?.value?.takeIf(::isGroup) ?: return null
+        }
+        return fieldOf(group, keys.last())?.takeIf { newGroup(it.group.javaClass) != null }
+    }
+
+    // The fields of [group] that answer to [key]: its own, else those of a group read from the same object.
+    private fun fieldOf(group: Any, key: String): Place? {
+        val fields = fieldsOf(group.javaClass)
+        fields.filter { !it.isAnnotationPresent(ReadFromParent::class.java) && keyOf(it) == key }
+            .takeIf { it.isNotEmpty() }
+            ?.let { return Place(group, it) }
+        for (field in fields) {
+            if (!field.isAnnotationPresent(ReadFromParent::class.java)) continue
+            val inner = field.get(group)?.takeIf(::isGroup) ?: continue
+            fieldOf(inner, key)?.let { return it }
+        }
+        return null
+    }
+
+    private fun keyOf(field: Field): String = field.getAnnotation(OptionKey::class.java)?.name ?: field.name
+
+    private fun fieldsOf(type: Class<*>): List<Field> = fieldsOfType.getOrPut(type) {
+        generateSequence(type) { it.superclass }
+            .takeWhile { it != Any::class.java }
+            .toList()
+            .asReversed()
+            .flatMap { it.declaredFields.asList() }
+            .filter { !Modifier.isStatic(it.modifiers) && !it.isSynthetic }
+            .onEach { it.isAccessible = true }
+    }
+
+    private fun isGroup(value: Any): Boolean {
+        if (value is Param<*> || value is ThemeColour) return false
+        val type = value.javaClass
+        return type.declaredMethods.any { it.name == "mergeWith" && it.parameterTypes.contentEquals(arrayOf(type)) }
+    }
+
+    // A group as its class makes it, every field unset; none for a class without a constructor of no arguments.
+    private fun newGroup(type: Class<*>): Any? = try {
+        type.getDeclaredConstructor().newInstance()
+    } catch (_: ReflectiveOperationException) {
+        null
+    }
+}

package/android/src/main/java/dev/apexnative/navigation/options/SheetOptions.kt

@@ -12,25 +12,28 @@ import dev.apexnative.navigation.options.parsers.FractionParser
 import dev.apexnative.navigation.options.parsers.TextParser
 
 /**
- * A height a sheet stops at: about half the screen, the full height, or a height in dp. `content` stops at half the
- * screen on Android: the Material sheet has no height of its content.
+ * A height a sheet stops at: about half the screen, the full height, the height of the screen's content, or a height in
+ * dp.
  */
 sealed class SheetDetent {
     object Medium : SheetDetent()
     object Large : SheetDetent()
+    object Content : SheetDetent()
     data class Height(val dp: Double) : SheetDetent()
 
     /** The detent as the app names it, in `sheetDetentChanged`. */
     fun toValue(): Any = when (this) {
         Medium -> "medium"
         Large -> "large"
+        Content -> "content"
         is Height -> dp
     }
 
     companion object {
         fun parse(value: Any?): SheetDetent? = when (value) {
-            "medium", "content" -> Medium
+            "medium" -> Medium
             "large" -> Large
+            "content" -> Content
             // A number is a height only when it is finite and positive.
             is Number -> value.toDouble().takeIf { it.isFinite() && it > 0 }?.let { Height(it) }
             else -> null
@@ -47,7 +50,7 @@ class SheetOptions {
     @JvmField var selectedDetent: SheetDetent? = null
     @JvmField var largestUndimmedDetent: SheetDetent? = null
     /** The options give `largestUndimmedDetent`, `null` included. */
-    @JvmField var hasLargestUndimmedDetent = false
+    @OptionKey("largestUndimmedDetent") @JvmField var hasLargestUndimmedDetent = false
     @JvmField var grabber: Bool = NullBool()
     @JvmField var expandsOnScroll: Bool = NullBool()
     @JvmField var cornerRadius: Fraction = NullFraction()

package/android/src/main/java/dev/apexnative/navigation/options/TitleOptions.kt

@@ -22,7 +22,7 @@ class TitleOptions {
     @JvmField var text: Text = NullText()
     @JvmField var fontSize: Fraction = NullFraction()
     @JvmField var color: ThemeColour = NullThemeColour()
-    @JvmField var font = FontOptions()
+    @ReadFromParent @JvmField var font = FontOptions()
     @JvmField var component = TitleComponentOptions()
     /** Shared between copies, as its module wants. */
     @JvmField var menu: ButtonMenuOptions? = null
@@ -98,7 +98,7 @@ class SubtitleOptions {
     @JvmField var text: Text = NullText()
     @JvmField var fontSize: Fraction = NullFraction()
     @JvmField var color: ThemeColour = NullThemeColour()
-    @JvmField var font = FontOptions()
+    @ReadFromParent @JvmField var font = FontOptions()
     @JvmField var alignment: Text = NullText()
 
     fun hasValue(): Boolean =

package/android/src/main/java/dev/apexnative/navigation/options/TopBarAppearanceOptions.kt

@@ -109,7 +109,7 @@ class TopBarBackgroundOptions {
  */
 class ScrollEdgeAppearanceTitleOptions {
     @JvmField var color: ThemeColour = NullThemeColour()
-    @JvmField var font = FontOptions()
+    @ReadFromParent @JvmField var font = FontOptions()
     @JvmField var fontSize: Fraction = NullFraction()
 
     fun hasValue(): Boolean = color.hasValue() || font.hasValue() || fontSize.hasValue()