react-native-screens 5.0.0-alpha.2 → 5.0.0-alpha.4

package/android/src/main/java/com/swmansion/rnscreens/modals/formsheet/native/coordinator/FormSheetDimensionsCoordinator.kt

@@ -1,134 +0,0 @@
-package com.swmansion.rnscreens.modals.formsheet.native.coordinator
-
-import android.view.ViewGroup
-import android.widget.FrameLayout
-import androidx.core.view.ViewCompat
-import androidx.core.view.WindowInsetsCompat
-import androidx.core.view.doOnLayout
-import com.google.android.material.bottomsheet.BottomSheetDialog
-import com.swmansion.rnscreens.modals.formsheet.native.core.FormSheetContainer
-import com.swmansion.rnscreens.modals.formsheet.native.interfaces.FormSheetContentSizeChangeDelegate
-import com.swmansion.rnscreens.modals.formsheet.native.model.FormSheetDetents
-
-internal class FormSheetDimensionsCoordinator(
-    private val dialog: BottomSheetDialog,
-    private val container: FormSheetContainer,
-    private val bottomSheetView: FrameLayout?,
-    private val behaviorController: FormSheetBehaviorController?,
-) : FormSheetContentSizeChangeDelegate {
-    private var lastTopInset = 0
-    private var lastBottomInset = 0
-    private var currentDetents: FormSheetDetents? = null
-    private var currentInitialDetentIndex: Int = 0
-    private var shouldApplyInitialDetent: Boolean = false
-
-    private var currentContentHeight: Int = 0
-
-    internal fun setup() {
-        setupWindowInsetsListener()
-
-        bottomSheetView?.let { view ->
-            disableMaterialInsetsAnimationCallback(view)
-        }
-    }
-
-    private fun setupWindowInsetsListener() {
-        ViewCompat.setOnApplyWindowInsetsListener(container) { _, insets ->
-            lastTopInset = getTopInset(insets)
-            lastBottomInset = getBottomInset(insets)
-            updateNativeContainerHeight()
-            insets
-        }
-    }
-
-    /**
-     * BottomSheetBehavior registers an internal `WindowInsetsAnimationCallback` on the
-     * sheet view during its first `onLayoutChild`. That callback drives `translationY` to follow
-     * animated inset changes, what interferes with our slide-in custom animation.
-     *
-     * We manage insets ourselves by setting a fixed height for FormSheetContainer, so we can
-     * clear the Material's callback to remove the conflict entirely.
-     *
-     * This method must run after the first layout pass.
-     */
-    private fun disableMaterialInsetsAnimationCallback(view: FrameLayout) {
-        view.doOnLayout {
-            ViewCompat.setWindowInsetsAnimationCallback(it, null)
-        }
-    }
-
-    override fun onContentHeightChanged(newHeight: Int) {
-        if (currentContentHeight != newHeight) {
-            currentContentHeight = newHeight
-            updateNativeContainerHeight()
-        }
-    }
-
-    internal fun updateFormSheetDimensions(
-        detents: FormSheetDetents?,
-        initialDetentIndex: Int = 0,
-        applyInitialDetent: Boolean = false,
-    ) {
-        currentDetents = detents
-        currentInitialDetentIndex = initialDetentIndex
-        shouldApplyInitialDetent = applyInitialDetent
-        updateNativeContainerHeight()
-    }
-
-    /**
-     * For Yoga we require the container height to be "stable" to avoid updating content size in flight.
-     * If left as MATCH_PARENT, BottomSheetDialog dynamically applies insets as padding when sheet overflows
-     * status bar or display cutout. This causes Yoga to recalculate the layout, resulting in UI flickering
-     * during the drag gesture. By calculating and enforcing a static height that explicitly subtracts
-     * the system insets, we completely bypass these redundant layout passes.
-     */
-    private fun updateNativeContainerHeight() {
-        val dialogDecorHeight = dialog.window?.decorView?.height ?: 0
-
-        if (dialogDecorHeight <= 0) {
-            return
-        }
-
-        currentDetents?.let { detents ->
-            behaviorController?.updateSheetBehavior(
-                detents = detents,
-                sheetAvailableSpace = dialogDecorHeight,
-                contentHeightForFitToContents = currentContentHeight,
-                nativeContainerPaddingBottom = lastBottomInset,
-                initialDetentIndex = currentInitialDetentIndex,
-                applyInitialDetent = shouldApplyInitialDetent,
-            )
-            shouldApplyInitialDetent = false
-        }
-
-        val sheetContainerHeight =
-            currentDetents?.sheetContainerHeight(dialogDecorHeight, lastTopInset, lastBottomInset, currentContentHeight)
-                ?: (dialogDecorHeight - lastTopInset - lastBottomInset).coerceAtLeast(0)
-
-        val layoutParams =
-            container.layoutParams
-                ?: FrameLayout.LayoutParams(ViewGroup.LayoutParams.MATCH_PARENT, sheetContainerHeight)
-
-        if (layoutParams.width != ViewGroup.LayoutParams.MATCH_PARENT || layoutParams.height != sheetContainerHeight) {
-            layoutParams.width = ViewGroup.LayoutParams.MATCH_PARENT
-            layoutParams.height = sheetContainerHeight
-            container.layoutParams = layoutParams
-        }
-    }
-
-    private fun getTopInset(insetsCompat: WindowInsetsCompat): Int =
-        insetsCompat
-            .getInsets(
-                WindowInsetsCompat.Type.systemBars() or WindowInsetsCompat.Type.displayCutout(),
-            ).top
-
-    private fun getBottomInset(insetsCompat: WindowInsetsCompat): Int =
-        insetsCompat
-            .getInsets(
-                WindowInsetsCompat.Type.systemBars() or WindowInsetsCompat.Type.displayCutout(),
-            ).bottom
-
-    internal fun destroy() {
-        ViewCompat.setOnApplyWindowInsetsListener(container, null)
-    }
-}

package/android/src/main/java/com/swmansion/rnscreens/modals/formsheet/native/core/FormSheetDialogManager.kt

@@ -1,162 +0,0 @@
-package com.swmansion.rnscreens.modals.formsheet.native.core
-
-import android.content.Context
-import android.util.Log
-import android.view.ContextThemeWrapper
-import android.view.View
-import android.widget.FrameLayout
-import com.swmansion.rnscreens.modals.dimmingview.DimmingViewManager
-import com.swmansion.rnscreens.modals.formsheet.native.coordinator.FormSheetAppearanceCoordinator
-import com.swmansion.rnscreens.modals.formsheet.native.coordinator.FormSheetBehaviorController
-import com.swmansion.rnscreens.modals.formsheet.native.coordinator.FormSheetDimensionsCoordinator
-import com.swmansion.rnscreens.modals.formsheet.native.coordinator.FormSheetNativeDismissCoordinator
-import com.swmansion.rnscreens.modals.formsheet.native.interfaces.FormSheetContentSizeChangeDelegate
-import com.swmansion.rnscreens.modals.formsheet.native.interfaces.FormSheetDialogEventEmitter
-import com.swmansion.rnscreens.modals.formsheet.native.model.FormSheetConfig
-import com.swmansion.rnscreens.modals.formsheet.native.model.FormSheetDetents
-import com.swmansion.rnscreens.modals.formsheet.native.presentation.FormSheetPresentationManager
-import kotlin.properties.Delegates
-
-class FormSheetDialogManager(
-    context: Context,
-    private val contentView: View,
-) {
-    private var formSheetConfig = FormSheetConfig()
-
-    private val themedContext =
-        ContextThemeWrapper(
-            context,
-            com.google.android.material.R.style.Theme_Material3_DayNight_NoActionBar,
-        )
-
-    // Eagerly create the container so it's always ready for the provided content view
-    private val container = FormSheetContainer(themedContext, contentView)
-
-    // Eagerly create the dialog and attach the container
-    private val dialog =
-        FormSheetDialog(themedContext).apply {
-            setContentView(container)
-            setCanceledOnTouchOutside(false)
-        }
-
-    private val bottomSheetView = dialog.findViewById<FrameLayout>(com.google.android.material.R.id.design_bottom_sheet)
-
-    private val behaviorController =
-        bottomSheetView?.let {
-            FormSheetBehaviorController(it) { index -> eventEmitter?.emitOnDetentChanged(index) }
-        }
-
-    private val dimmingManager = DimmingViewManager(context, dialog)
-
-    private val appearanceCoordinator =
-        FormSheetAppearanceCoordinator(
-            bottomSheetView = bottomSheetView,
-        )
-
-    private val dimensionsCoordinator =
-        FormSheetDimensionsCoordinator(
-            dialog = dialog,
-            container = container,
-            bottomSheetView = bottomSheetView,
-            behaviorController = behaviorController,
-        )
-
-    private val presentationManager =
-        FormSheetPresentationManager(
-            dialog = dialog,
-            bottomSheetView = bottomSheetView,
-            dimmingManager = dimmingManager,
-            onNativeDismiss = { eventEmitter?.emitOnNativeDismissEvent() },
-        )
-
-    private val nativeDismissCoordinator =
-        FormSheetNativeDismissCoordinator(
-            dialog = dialog,
-            behaviorController = behaviorController,
-            dimmingManager = dimmingManager,
-            onDismissAllowed = { presentationManager.handleNativeDismiss() },
-            onDismissPrevented = { eventEmitter?.emitOnNativeDismissPreventedEvent() },
-        )
-
-    internal var eventEmitter: FormSheetDialogEventEmitter? by Delegates.observable(null) { _, _, newValue ->
-        presentationManager.appearanceEventEmitter = newValue
-    }
-
-    internal val contentSizeChangeDelegate: FormSheetContentSizeChangeDelegate
-        get() = dimensionsCoordinator
-
-    init {
-        presentationManager.setup()
-        nativeDismissCoordinator.setup()
-        appearanceCoordinator.setup()
-        dimensionsCoordinator.setup()
-        behaviorController?.setup()
-    }
-
-    internal fun applyConfig(newConfig: FormSheetConfig) {
-        val oldConfig = formSheetConfig
-        formSheetConfig = newConfig
-
-        val reopened = !oldConfig.isOpen && newConfig.isOpen
-
-        // ALWAYS refresh dimensions when reopening to ensure that BottomSheet
-        // state and layout are synchronized with native behavior.
-        val dimensionsChanged = oldConfig.detents != newConfig.detents
-        if (dimensionsChanged || reopened) {
-            dimensionsCoordinator.updateFormSheetDimensions(
-                resolveDetents(newConfig.detents),
-                newConfig.initialDetentIndex,
-                reopened,
-            )
-        }
-
-        if (oldConfig.prefersGrabberVisible != newConfig.prefersGrabberVisible) {
-            container.setGrabberVisible(newConfig.prefersGrabberVisible)
-        }
-
-        if (oldConfig.preferredCornerRadius != newConfig.preferredCornerRadius) {
-            appearanceCoordinator.updateCornerRadius(newConfig.preferredCornerRadius)
-        }
-
-        if (oldConfig.nativeContainerBackgroundColor != newConfig.nativeContainerBackgroundColor) {
-            appearanceCoordinator.updateBackgroundColor(newConfig.nativeContainerBackgroundColor)
-        }
-
-        if (oldConfig.shouldPreventNativeDismiss != newConfig.shouldPreventNativeDismiss) {
-            nativeDismissCoordinator.shouldPreventDismiss = newConfig.shouldPreventNativeDismiss
-        }
-
-        if (oldConfig.isOpen != newConfig.isOpen) {
-            presentationManager.updatePresentationState(newConfig.isOpen)
-        }
-    }
-
-    private fun resolveDetents(rawDetents: List<Double>): FormSheetDetents {
-        if (rawDetents.isEmpty()) {
-            return FormSheetDetents(listOf(LARGE_DETENT_FRACTION))
-        }
-
-        return try {
-            FormSheetDetents(rawDetents)
-        } catch (e: IllegalArgumentException) {
-            Log.e(
-                "[RNScreens]",
-                "Invalid FormSheet detents: $rawDetents. Falling back to large detent.",
-                e,
-            )
-            FormSheetDetents(listOf(LARGE_DETENT_FRACTION))
-        }
-    }
-
-    internal fun destroy() {
-        behaviorController?.destroy()
-        nativeDismissCoordinator.destroy()
-        presentationManager.destroy()
-        dimensionsCoordinator.destroy()
-        dialog.dismiss()
-    }
-
-    companion object {
-        private const val LARGE_DETENT_FRACTION = 1.0
-    }
-}

package/android/src/main/java/com/swmansion/rnscreens/modals/formsheet/native/model/FormSheetDetents.kt

@@ -1,106 +0,0 @@
-package com.swmansion.rnscreens.modals.formsheet.native.model
-
-internal class FormSheetDetents(
-    rawDetents: List<Double>,
-) {
-    private val detents: List<Double> = rawDetents.toList()
-
-    init {
-        require(detents.isNotEmpty()) { "[RNScreens] At least one detent must be provided." }
-        require(detents.size <= MAX_DETENTS) { "[RNScreens] Maximum of $MAX_DETENTS detents supported, got ${detents.size}." }
-
-        // Valid fitToContents configuration is a single detent with value -1.0.
-        // For any other configuration, we should validate provided detents array.
-        if (!isFitToContents) {
-            detents.forEach {
-                require(it in 0.0..1.0) {
-                    "[RNScreens] Detent values must be within 0.0 and 1.0, got $it."
-                }
-            }
-
-            require(detents == detents.distinct().sorted()) {
-                "[RNScreens] Detents must be sorted in strictly ascending order."
-            }
-        }
-    }
-
-    internal val isFitToContents: Boolean
-        get() = detents.size == 1 && detents[0] == FIT_TO_CONTENTS_DETENT_VALUE
-
-    internal val count: Int get() = detents.size
-
-    private fun heightFractionAt(index: Int): Double = detents[index]
-
-    private fun heightAt(
-        index: Int,
-        containerHeight: Int,
-    ): Int = (heightFractionAt(index) * containerHeight).toInt()
-
-    internal fun firstHeight(containerHeight: Int): Int = heightAt(0, containerHeight)
-
-    internal fun maxAllowedHeight(containerHeight: Int): Int = heightAt(count - 1, containerHeight)
-
-    internal fun maxAllowedHeightForFitToContents(
-        containerHeight: Int,
-        contentHeight: Int,
-        bottomInset: Int,
-    ): Int {
-        /*
-         * We add the `bottomInset` to the `contentHeight` so that the Material BottomSheet
-         * is laid out behind the system navigation bar. The sheet's container covers the insets,
-         * while the RN content is strictly constrained to `contentHeight`.
-         */
-        if (contentHeight <= 0) {
-            // Avoid collapsing the sheet before the React content has been laid out and measured.
-            return containerHeight
-        }
-        return (contentHeight + bottomInset).coerceAtMost(containerHeight)
-    }
-
-    internal fun halfExpandedRatio(): Float {
-        check(count == MAX_DETENTS) { "[RNScreens] Exactly $MAX_DETENTS detents are required for halfExpandedRatio." }
-        return (heightFractionAt(1) / heightFractionAt(2)).toFloat()
-    }
-
-    internal fun expandedOffsetFromTop(
-        containerHeight: Int,
-        topInset: Int = 0,
-    ): Int {
-        check(count == MAX_DETENTS) { "[RNScreens] Exactly $MAX_DETENTS detents are required for expandedOffsetFromTop." }
-        return ((1 - heightFractionAt(2)) * containerHeight).toInt() + topInset
-    }
-
-    // Distance from the top of the window to the top of the largest detent's surface.
-    private fun largestDetentTopOffset(containerHeight: Int): Int = containerHeight - maxAllowedHeight(containerHeight)
-
-    /**
-     * Material's BottomSheetDialog dynamically applies padding when its content overlaps
-     * system insets. To prevent recalculating the size, we pre-calculate a static height
-     * inside safe area bounds.
-     */
-    internal fun sheetContainerHeight(
-        containerHeight: Int,
-        topInset: Int,
-        bottomInset: Int,
-        contentHeight: Int = 0,
-    ): Int {
-        if (isFitToContents) {
-            // Until we have a measured content height, fall back to a safe-area height so Yoga can lay out.
-            if (contentHeight <= 0) {
-                return (containerHeight - topInset - bottomInset).coerceAtLeast(0)
-            }
-            return contentHeight.coerceAtMost(containerHeight)
-        }
-
-        // Bottom inset is always fully subtracted because the sheet is in its dedicated window and it's
-        // anchored to the bottom.
-        // Top inset is subtracted only by the amount the sheet actually overlaps it.
-        val topOverlap = (topInset - largestDetentTopOffset(containerHeight)).coerceAtLeast(0)
-        return (maxAllowedHeight(containerHeight) - topOverlap - bottomInset).coerceAtLeast(0)
-    }
-
-    companion object {
-        const val MAX_DETENTS = 3
-        const val FIT_TO_CONTENTS_DETENT_VALUE = -1.0
-    }
-}

package/android/src/main/java/com/swmansion/rnscreens/modals/formsheet/native/presentation/FormSheetPresentationManager.kt

@@ -1,198 +0,0 @@
-package com.swmansion.rnscreens.modals.formsheet.native.presentation
-
-import android.animation.Animator
-import android.animation.AnimatorListenerAdapter
-import android.view.View
-import com.google.android.material.bottomsheet.BottomSheetBehavior
-import com.swmansion.rnscreens.common.event.ViewAppearanceEventEmitter
-import com.swmansion.rnscreens.modals.dimmingview.DimmingViewManager
-import com.swmansion.rnscreens.modals.formsheet.native.core.FormSheetDialog
-
-internal class FormSheetPresentationManager(
-    private val dialog: FormSheetDialog,
-    private val bottomSheetView: View?,
-    private val dimmingManager: DimmingViewManager,
-    private val onNativeDismiss: () -> Unit,
-) {
-    internal var appearanceEventEmitter: ViewAppearanceEventEmitter? = null
-
-    private var state = FormSheetPresentationState.DISMISSED
-    private var targetIsOpen = false
-
-    private val animatorFactory = FormSheetAnimatorFactory(dimmingManager)
-    private var currentSheetAnimator: Animator? = null
-
-    internal fun setup() {
-        bottomSheetView?.let { view ->
-            dimmingManager.attachToBehavior(BottomSheetBehavior.from(view))
-        }
-    }
-
-    internal fun updatePresentationState(isOpen: Boolean) {
-        targetIsOpen = isOpen
-        resolvePresentationState()
-    }
-
-    private fun resolvePresentationState() {
-        if (targetIsOpen) {
-            presentIfNeeded()
-        } else {
-            dismissIfNeeded()
-        }
-    }
-
-    private fun presentIfNeeded() {
-        if (state != FormSheetPresentationState.DISMISSED) {
-            return
-        }
-
-        state = FormSheetPresentationState.PRESENTING
-        appearanceEventEmitter?.emitOnWillAppear()
-        dialog.setOnShowListener {
-            dialog.setOnShowListener(null)
-            dimmingManager.onDialogShow()
-            startEnterAnimation()
-        }
-        dialog.show()
-    }
-
-    private fun dismissIfNeeded() {
-        if (state != FormSheetPresentationState.PRESENTED) {
-            return
-        }
-
-        state = FormSheetPresentationState.DISMISSING
-        appearanceEventEmitter?.emitOnWillDisappear()
-
-        val isSheetHidden =
-            bottomSheetView?.let {
-                BottomSheetBehavior.from(it).state == BottomSheetBehavior.STATE_HIDDEN
-            } ?: true
-
-        if (isSheetHidden) {
-            performDismiss()
-            return
-        }
-
-        startExitAnimation()
-    }
-
-    private fun startEnterAnimation() {
-        if (bottomSheetView == null) {
-            onPresentationComplete()
-            return
-        }
-
-        val isInterrupting = currentSheetAnimator?.isRunning == true
-        currentSheetAnimator?.removeAllListeners()
-        currentSheetAnimator?.cancel()
-
-        dimmingManager.isTransitionAnimationRunning = true
-
-        currentSheetAnimator =
-            animatorFactory.createEnterAnimator(bottomSheetView, isInterrupting).apply {
-                addListener(
-                    object : AnimatorListenerAdapter() {
-                        override fun onAnimationEnd(animation: Animator) {
-                            dimmingManager.isTransitionAnimationRunning = false
-
-                            if (currentSheetAnimator == this@apply) currentSheetAnimator = null
-                            onPresentationComplete()
-                        }
-                    },
-                )
-                start()
-            }
-    }
-
-    private fun startExitAnimation() {
-        if (bottomSheetView == null) {
-            performDismiss()
-            return
-        }
-
-        val isInterrupting = currentSheetAnimator?.isRunning == true
-        currentSheetAnimator?.removeAllListeners()
-        currentSheetAnimator?.cancel()
-
-        dimmingManager.isTransitionAnimationRunning = true
-
-        currentSheetAnimator =
-            animatorFactory.createExitAnimator(bottomSheetView, isInterrupting).apply {
-                addListener(
-                    object : AnimatorListenerAdapter() {
-                        override fun onAnimationEnd(animation: Animator) {
-                            dimmingManager.isTransitionAnimationRunning = false
-
-                            if (currentSheetAnimator == this@apply) currentSheetAnimator = null
-                            syncBehaviorStateAfterExitAnimationComplete(bottomSheetView)
-                            performDismiss()
-                        }
-                    },
-                )
-                start()
-            }
-    }
-
-    private fun performDismiss() {
-        dialog.dismiss()
-        onDismissComplete()
-    }
-
-    private fun onPresentationComplete() {
-        if (state == FormSheetPresentationState.PRESENTING) {
-            state = FormSheetPresentationState.PRESENTED
-            appearanceEventEmitter?.emitOnDidAppear()
-            // ensure state hasn't updated during presentation
-            resolvePresentationState()
-        }
-    }
-
-    private fun onDismissComplete() {
-        if (state == FormSheetPresentationState.DISMISSING) {
-            state = FormSheetPresentationState.DISMISSED
-            appearanceEventEmitter?.emitOnDidDisappear()
-            // ensure state hasn't updated during dismissal
-            resolvePresentationState()
-        }
-    }
-
-    internal fun handleNativeDismiss() {
-        if (state == FormSheetPresentationState.DISMISSING || state == FormSheetPresentationState.DISMISSED) {
-            return
-        }
-
-        onNativeDismiss()
-        updatePresentationState(isOpen = false)
-    }
-
-    /**
-     * Synchronizes the BottomSheetBehavior state with our custom exit animation.
-     *
-     * Since our custom ExitAnimator uses `translationY` for visual movement, the physical
-     * `top` of the view remains at the top of the screen. If we just call `state = STATE_HIDDEN`,
-     * Material will attempt to align the layout and enter `STATE_SETTLING`, leaving the state
-     * machine corrupted for the next open.
-     *
-     * To fix this, we manually push the physical `top` to the bottom of the screen.
-     * This makes the behavior skip the animation and synchronously switch to `STATE_HIDDEN`,
-     * properly cleaning up its internal state on dismissal.
-     */
-    private fun syncBehaviorStateAfterExitAnimationComplete(view: View) {
-        val behavior = BottomSheetBehavior.from(view)
-        val parent = view.parent as? View
-        val targetTop = parent?.height ?: view.height
-
-        view.offsetTopAndBottom(targetTop - view.top)
-        behavior.state = BottomSheetBehavior.STATE_HIDDEN
-    }
-
-    internal fun destroy() {
-        currentSheetAnimator?.cancel()
-        currentSheetAnimator = null
-
-        dialog.setOnShowListener(null)
-
-        state = FormSheetPresentationState.DISMISSED
-    }
-}

package/android/src/main/java/com/swmansion/rnscreens/stack/header/toolbar/StackHeaderToolbarMenuSelectionController.kt

@@ -1,83 +0,0 @@
-package com.swmansion.rnscreens.stack.header.toolbar
-
-import android.util.Log
-import com.google.android.material.appbar.MaterialToolbar
-import com.swmansion.rnscreens.stack.header.toolbar.model.StackHeaderToolbarMenuGroupMetadata
-
-/**
- * Owns toolbar-menu selection state (id map + group metadata) and applies
- * group-item checked-state changes.
- */
-internal class StackHeaderToolbarMenuSelectionController {
-    internal var forwardIdMap: Map<String, Int> = emptyMap()
-        private set
-
-    private var groupMetadata: StackHeaderToolbarMenuGroupMetadata = StackHeaderToolbarMenuGroupMetadata.EMPTY
-
-    internal fun setMenuMaps(
-        forwardIdMap: Map<String, Int>,
-        groupMetadata: StackHeaderToolbarMenuGroupMetadata,
-    ) {
-        this.forwardIdMap = forwardIdMap
-        this.groupMetadata = groupMetadata
-    }
-
-    internal fun clear() {
-        forwardIdMap = emptyMap()
-        groupMetadata = StackHeaderToolbarMenuGroupMetadata.EMPTY
-    }
-
-    /**
-     * Mutates the checked state of [itemId] within its group and returns the id of the group
-     * whose selection changed, or `null` when nothing changed (the item is not in a group, an
-     * invalid attempt to uncheck a single-selection item, or the item was already in the
-     * target state). Does not emit — callers decide when to emit so that batched updates can
-     * coalesce into one event per group.
-     */
-    internal fun applyGroupItemStateChange(
-        toolbar: MaterialToolbar,
-        itemId: String,
-        explicitCheckedValue: Boolean? = null,
-    ): String? {
-        val groupId = groupMetadata.itemGroupMap[itemId] ?: return null
-        val singleSelection = groupMetadata.groupSingleSelection[groupId] ?: return null
-        val intId = forwardIdMap[itemId] ?: return null
-        val menuItem = toolbar.menu.findItem(intId) ?: return null
-
-        if (singleSelection && explicitCheckedValue == false) {
-            Log.w(
-                TAG,
-                "[RNScreens] Cannot uncheck item '$itemId' in single-selection group '$groupId'. " +
-                    "Check a different item instead.",
-            )
-            return null
-        }
-
-        val newChecked =
-            if (singleSelection) {
-                true
-            } else {
-                explicitCheckedValue ?: !menuItem.isChecked
-            }
-        if (menuItem.isChecked == newChecked) return null
-        menuItem.isChecked = newChecked
-
-        return groupId
-    }
-
-    internal fun collectSelectedIds(
-        toolbar: MaterialToolbar,
-        groupId: String,
-    ): List<String> =
-        groupMetadata
-            .groupMemberItems[groupId]
-            .orEmpty()
-            .filter { memberId ->
-                val intId = forwardIdMap[memberId] ?: return@filter false
-                toolbar.menu.findItem(intId)?.isChecked == true
-            }
-
-    companion object {
-        private const val TAG = "StackHeaderToolbarMenuSelectionController"
-    }
-}