@apexnative/navigation 1.0.0-alpha.4 → 1.0.0-alpha.6

package/android/src/main/java/dev/apexnative/navigation/react/events/StateHold.kt

@@ -1,62 +0,0 @@
-package dev.apexnative.navigation.react.events
-
-/**
- * The navigation state's posted update and its hold. [setNeedsUpdate] posts one update ([post]), coalesced: the asks of
- * one pass of the main loop make one, which runs [update] in a later pass. While a `setRoot` shows the modals and the
- * overlays of its layout the updates are held: an ask, or a posted update that runs while held (asked before the hold
- * was taken), only marks one as wanted, and the last release posts it. Released right before the answer, that update
- * finds nothing new: the state before the answer is sent at once, never held, and an identical state is never sent
- * twice. Every [hold] has one [release]; a release without a hold does nothing, so the count never goes below zero. An
- * update keeps the JavaScript it was asked for ([generation]): one asked by a JavaScript that went before it runs is
- * dropped; a newer ask of the new JavaScript still goes. Main thread only.
- */
-internal class StateHold(
-    private val post: (() -> Unit) -> Unit,
-    private val generation: () -> Int = { 0 },
-    private val update: () -> Unit,
-) {
-    /** The holds not released yet. */
-    var count = 0
-        private set
-
-    // An update was asked while held.
-    private var wanted = false
-    // An update is posted and hasn't run yet.
-    private var scheduled = false
-    // The JavaScript the last ask was for.
-    private var askedIn = 0
-
-    /** Asks for one update in a later pass of the main loop; while held, once the last hold is released. */
-    fun setNeedsUpdate() {
-        askedIn = generation()
-        if (count > 0) wanted = true else schedule()
-    }
-
-    /** The updates asked from now on, and those posted that run from now on, wait for as many [release]s. */
-    fun hold() {
-        count++
-    }
-
-    /** One hold ends; with the last, the update asked while held is posted now. */
-    fun release() {
-        if (count == 0) return
-        count--
-        if (count > 0 || !wanted) return
-        wanted = false
-        schedule()
-    }
-
-    private fun schedule() {
-        if (scheduled) return
-        scheduled = true
-        post {
-            scheduled = false
-            // A hold taken since it was posted: the update waits for the release. The JavaScript it was asked for
-            // went: nothing goes to the new one, which hears its first state after its own changes.
-            when {
-                count > 0 -> wanted = true
-                askedIn == generation() -> update()
-            }
-        }
-    }
-}

package/android/src/main/java/dev/apexnative/navigation/viewcontrollers/bottomtabs/CustomTabRowPlacer.kt

@@ -1,223 +0,0 @@
-package dev.apexnative.navigation.viewcontrollers.bottomtabs
-
-import android.app.Activity
-import android.app.Application
-import android.os.Bundle
-import android.view.View
-import android.view.ViewGroup
-import android.view.ViewTreeObserver
-import androidx.core.view.ViewCompat
-import androidx.core.view.WindowInsetsCompat
-import dev.apexnative.navigation.NavigationActivity
-import dev.apexnative.navigation.utils.UiUtils
-import dev.apexnative.navigation.viewcontrollers.modal.ModalContainer
-import dev.apexnative.navigation.views.bottomtabs.BottomTabsLayout
-import dev.apexnative.navigation.views.bottomtabs.CustomTabRow
-import java.util.WeakHashMap
-
-/**
- * Puts the custom rows of the tabs in their place, as it works now: an observer of every activity of the process that
- * touches only the navigation's activities; on each layout pass of such a window it finds the tabs with a row through
- * the view tree, and puts each row in the window's content right above the layer holding its tabs (after the rows
- * already there) — tabs in a modal: in the modal's own view, right above its root's view (or its sheet), so the row
- * moves with the modal and newer modals cover it —, over the bar as [CustomTabRowGeometry] says — applied only when it
- * changed, so UI tests reach idle. A row whose tabs left the window leaves it too, and comes back to its place as they
- * do. Before each frame the row takes its tabs' alpha (a root that waits under the old one is transparent) and the
- * motion of the bar's container, and stays out of accessibility and touches while they wait. Main thread only.
- */
-internal object CustomTabRowPlacer : Application.ActivityLifecycleCallbacks {
-    private var registered = false
-    // The listeners of each observed activity's window.
-    private val observed = WeakHashMap<Activity, Listeners>()
-    // The rows placed at the last layout pass of each activity, with their tabs.
-    private val rows = WeakHashMap<CustomTabRow, BottomTabsLayout>()
-
-    private class Listeners(
-        val observer: ViewTreeObserver,
-        val layout: ViewTreeObserver.OnGlobalLayoutListener,
-        val draw: ViewTreeObserver.OnPreDrawListener,
-    )
-
-    /** [activity] has tabs with a row: its window is observed from now on, and the process's later activities. */
-    fun track(activity: Activity) {
-        if (!registered) {
-            registered = true
-            activity.application?.registerActivityLifecycleCallbacks(this)
-        }
-        observe(activity)
-    }
-
-    /** The tabs of [row] go: the row leaves the window. */
-    fun forget(row: CustomTabRow) {
-        rows.remove(row)
-        (row.parent as? ViewGroup)?.removeView(row)
-    }
-
-    override fun onActivityResumed(activity: Activity) = observe(activity)
-
-    override fun onActivityDestroyed(activity: Activity) {
-        val listeners = observed.remove(activity) ?: return
-        if (!listeners.observer.isAlive) return
-        listeners.observer.removeOnGlobalLayoutListener(listeners.layout)
-        listeners.observer.removeOnPreDrawListener(listeners.draw)
-    }
-
-    override fun onActivityCreated(activity: Activity, savedInstanceState: Bundle?) = Unit
-
-    override fun onActivityStarted(activity: Activity) = Unit
-
-    override fun onActivityPaused(activity: Activity) = Unit
-
-    override fun onActivityStopped(activity: Activity) = Unit
-
-    override fun onActivitySaveInstanceState(activity: Activity, outState: Bundle) = Unit
-
-    // Only the navigation's activities: another activity's views are never looked for.
-    private fun observe(activity: Activity) {
-        if (activity !is NavigationActivity || observed.containsKey(activity)) return
-        val decor = activity.window?.decorView ?: return
-        val observer = decor.viewTreeObserver
-        val layout = ViewTreeObserver.OnGlobalLayoutListener { place(activity) }
-        val draw = ViewTreeObserver.OnPreDrawListener {
-            follow(activity)
-            true
-        }
-        observer.addOnGlobalLayoutListener(layout)
-        observer.addOnPreDrawListener(draw)
-        observed[activity] = Listeners(observer, layout, draw)
-    }
-
-    private fun contentOf(activity: Activity): ViewGroup? =
-        activity.window?.decorView?.findViewById(android.R.id.content)
-
-    // Each layout pass: the tabs with a row in the content, and the rows in their places.
-    private fun place(activity: NavigationActivity) {
-        val content = contentOf(activity) ?: return
-        val found = ArrayList<BottomTabsLayout>()
-        collect(content, found)
-        val placed = found.mapNotNull { tabs -> tabs.row?.also { place(activity, content, tabs, it) } }.toSet()
-        // A row whose tabs left the window leaves it too.
-        rows.entries.filter { (row, tabs) -> row !in placed && tabs.context === activity }.forEach { (row, _) ->
-            (row.parent as? ViewGroup)?.removeView(row)
-        }
-    }
-
-    private fun collect(view: View, found: MutableList<BottomTabsLayout>) {
-        if (view is CustomTabRow) return
-        if (view is BottomTabsLayout && view.row != null) found += view
-        if (view is ViewGroup) for (index in 0 until view.childCount) collect(view.getChildAt(index), found)
-    }
-
-    private fun place(activity: NavigationActivity, content: ViewGroup, tabs: BottomTabsLayout, row: CustomTabRow) {
-        rows[row] = tabs
-        val (host, layer) = placeIn(content, tabs) ?: return
-        if (row.parent !== host) {
-            (row.parent as? ViewGroup)?.removeView(row)
-            // Margins of the host's own kind: the host converts them (a frame or a coordinator layout).
-            host.addView(row, indexAbove(host, layer, row), ViewGroup.MarginLayoutParams(0, 0))
-            row.place = null
-        } else if (host.indexOfChild(row) != indexAbove(host, layer, row)) {
-            val params = row.layoutParams
-            host.removeView(row)
-            host.addView(row, indexAbove(host, layer, row), params)
-        }
-        row.showWith(tabs.bar)
-        if (tabs.bar.visibility == View.GONE || tabs.bar.width == 0) return
-        val place = placeOf(activity, host, tabs, row)
-        if (!CustomTabRowGeometry.needsPlacing(row.place, place)) return
-        row.place = place
-        val params = row.layoutParams as? ViewGroup.MarginLayoutParams ?: return
-        params.width = place.right - place.left
-        params.height = place.bottom - place.top
-        params.leftMargin = place.left
-        params.topMargin = place.top
-        row.layoutParams = params
-    }
-
-    // Over the bar: its edges less the margins, its bottom, the height of the content and the margin below it, in the
-    // coordinates of the row's [host].
-    private fun placeOf(
-        activity: Activity,
-        host: ViewGroup,
-        tabs: BottomTabsLayout,
-        row: CustomTabRow,
-    ): CustomTabRowGeometry.Place {
-        val bar = IntArray(2).also(tabs.bar::getLocationInWindow)
-        val origin = IntArray(2).also(host::getLocationInWindow)
-        val options = row.options
-        val margin = UiUtils.dpToPixels(
-            activity,
-            options.horizontalMargin.get(CustomTabRowGeometry.HORIZONTAL_MARGIN_DP.toDouble()),
-        )
-        val height = options.height.get(null)?.let { UiUtils.dpToPixels(activity, it) }
-        val extra = UiUtils.dpToPixels(activity, CustomTabRowGeometry.EXTRA_HEIGHT_DP.toDouble())
-        // Where the bar rests: its container's motion (a ride, a slide, the hide on scroll) the row takes before each
-        // frame as its own translation.
-        val left = bar[0] - origin[0] - tabs.container.translationX.toInt()
-        val top = bar[1] - origin[1] - tabs.container.translationY.toInt()
-        // Never over the navigation bar's buttons: the bar is above them, and so is the row.
-        val navigationBar = if ((activity as? NavigationActivity)?.isEdgeToEdge == true) navigationBarOf(host) else 0
-        return CustomTabRowGeometry.place(
-            barLeft = left,
-            barRight = left + tabs.bar.width,
-            barBottom = minOf(top + tabs.bar.height, host.height - navigationBar),
-            margin = margin,
-            content = CustomTabRowGeometry.content(tabs.bar.height, height, extra),
-            bottomMargin = UiUtils.dpToPixels(activity, options.bottomMargin.get(0.0)),
-        )
-    }
-
-    // The navigation bar at the bottom of the window, through the compat insets on every version.
-    private fun navigationBarOf(view: View): Int =
-        ViewCompat.getRootWindowInsets(view)?.getInsets(WindowInsetsCompat.Type.navigationBars())?.bottom ?: 0
-
-    // Where the row of [tabs] goes, and the child there it goes right above: tabs in a modal, the modal's own view and
-    // the view in it that holds them (its root's, or its sheet's container); else the content and the layer of the
-    // root or of the overlays. A sheet's drag moves it without a layout: the row doesn't follow a drag.
-    private fun placeIn(content: ViewGroup, tabs: View): Pair<ViewGroup, View>? {
-        var current: View = tabs
-        while (true) {
-            val parent = current.parent as? ViewGroup ?: return null
-            if (parent is ModalContainer || parent === content) return parent to current
-            current = parent
-        }
-    }
-
-    // Right above [layer], after the rows already there.
-    private fun indexAbove(host: ViewGroup, layer: View, row: CustomTabRow): Int {
-        var index = host.indexOfChild(layer) + 1
-        while (index < host.childCount) {
-            val child = host.getChildAt(index)
-            if (child !is CustomTabRow || child === row) break
-            index++
-        }
-        return index
-    }
-
-    // Before each frame: the row takes the alpha of its tabs up to the view it is in and the container's translation,
-    // and leaves accessibility while they wait to show.
-    private fun follow(activity: Activity) {
-        val content = contentOf(activity) ?: return
-        for ((row, tabs) in rows) {
-            val host = row.parent as? View ?: continue
-            if (host !== content && host !is ModalContainer) continue
-            var alpha = tabs.container.alpha
-            var current: View? = tabs
-            while (current != null && current !== host) {
-                alpha *= current.alpha
-                current = current.parent as? View
-            }
-            if (row.alpha != alpha) row.alpha = alpha
-            // The row goes with the bar's container: a ride, a slide, the hide on scroll.
-            val container = tabs.container
-            if (row.translationX != container.translationX) row.translationX = container.translationX
-            if (row.translationY != container.translationY) row.translationY = container.translationY
-            val mode = if (row.hiddenFromAccessibility()) {
-                View.IMPORTANT_FOR_ACCESSIBILITY_NO_HIDE_DESCENDANTS
-            } else {
-                View.IMPORTANT_FOR_ACCESSIBILITY_AUTO
-            }
-            if (row.importantForAccessibility != mode) row.importantForAccessibility = mode
-        }
-    }
-}

package/ios/Layouts/Screen/ANNScreenInsets.h

@@ -1,30 +0,0 @@
-#import "ANNEventEmitter.h"
-#import <UIKit/UIKit.h>
-
-NS_ASSUME_NONNULL_BEGIN
-
-/// Posted on the main queue when the padding of a screen's safe area view changed; the object is the screen id.
-extern NSNotificationName const ANNScreenSafeAreaPaddingDidChangeNotification;
-
-/// The safe area of each screen: how much of its content the bars and the system cover on each side. The padding is
-/// the part of it the screen's safe area view keeps its content out of: the insets on the edges the screen's options
-/// give. JavaScript gets the rest, what still covers the content (0 on a padded edge): it reads it from its own thread
-/// for a screen's first render, and gets every change as `ANN.ScreenInsetsChanged`. Main queue, but the reads.
-@interface ANNScreenInsets : NSObject
-
-/// Keeps the screen's insets and padding, and tells when they changed.
-+ (void)setInsets:(UIEdgeInsets)insets
-          padding:(UIEdgeInsets)padding
-      forScreenId:(NSString *)screenId
-     eventEmitter:(ANNEventEmitter *)eventEmitter;
-/// The padding of the screen's safe area view; none before the screen was laid out. Main queue.
-+ (UIEdgeInsets)paddingForScreenId:(NSString *)screenId;
-/// `{ top, right, bottom, left }`, or nil before the screen was laid out. Any thread.
-+ (nullable NSDictionary<NSString *, NSNumber *> *)insetsForScreenId:(NSString *)screenId;
-+ (void)removeScreenId:(NSString *)screenId;
-/// Forgets every screen: after a reload the new JavaScript counts its ids anew. Main queue.
-+ (void)removeAll;
-
-@end
-
-NS_ASSUME_NONNULL_END

package/ios/Layouts/Screen/ANNScreenInsets.mm

@@ -1,70 +0,0 @@
-#import "ANNScreenInsets.h"
-#import "ANNEventContract.h"
-
-NSNotificationName const ANNScreenSafeAreaPaddingDidChangeNotification = @"ANNScreenSafeAreaPaddingDidChange";
-
-static NSMutableDictionary<NSString *, NSDictionary<NSString *, NSNumber *> *> *ANNScreenInsetsById;
-// Main queue only.
-static NSMutableDictionary<NSString *, NSValue *> *ANNScreenPaddingById;
-
-@implementation ANNScreenInsets
-
-+ (void)initialize {
-    if (self == ANNScreenInsets.class) {
-        ANNScreenInsetsById = [NSMutableDictionary new];
-        ANNScreenPaddingById = [NSMutableDictionary new];
-    }
-}
-
-+ (void)setInsets:(UIEdgeInsets)insets
-          padding:(UIEdgeInsets)padding
-      forScreenId:(NSString *)screenId
-     eventEmitter:(ANNEventEmitter *)eventEmitter {
-    NSValue *paddingValue = [NSValue valueWithUIEdgeInsets:padding];
-    if (![ANNScreenPaddingById[screenId] isEqualToValue:paddingValue]) {
-        ANNScreenPaddingById[screenId] = paddingValue;
-        [NSNotificationCenter.defaultCenter postNotificationName:ANNScreenSafeAreaPaddingDidChangeNotification
-                                                          object:screenId];
-    }
-    // JavaScript gets what still covers the content: the edges the safe area view keeps it off are 0.
-    const auto &keys = ANNEventContract.ScreenInsetsChanged;
-    NSDictionary<NSString *, NSNumber *> *value = @{
-        keys.top : @(MAX(insets.top - padding.top, 0)),
-        keys.right : @(MAX(insets.right - padding.right, 0)),
-        keys.bottom : @(MAX(insets.bottom - padding.bottom, 0)),
-        keys.left : @(MAX(insets.left - padding.left, 0)),
-    };
-    @synchronized(ANNScreenInsetsById) {
-        if ([ANNScreenInsetsById[screenId] isEqualToDictionary:value]) {
-            return;
-        }
-        ANNScreenInsetsById[screenId] = value;
-    }
-    [eventEmitter sendScreenInsetsChanged:screenId insets:value];
-}
-
-+ (NSDictionary<NSString *, NSNumber *> *)insetsForScreenId:(NSString *)screenId {
-    @synchronized(ANNScreenInsetsById) {
-        return ANNScreenInsetsById[screenId];
-    }
-}
-
-+ (UIEdgeInsets)paddingForScreenId:(NSString *)screenId {
-    return ANNScreenPaddingById[screenId].UIEdgeInsetsValue;
-}
-
-+ (void)removeScreenId:(NSString *)screenId {
-    [ANNScreenPaddingById removeObjectForKey:screenId];
-    @synchronized(ANNScreenInsetsById) {
-        [ANNScreenInsetsById removeObjectForKey:screenId];
-    }
-}
-
-+ (void)removeAll {
-    [ANNScreenPaddingById removeAllObjects];
-    @synchronized(ANNScreenInsetsById) {
-        [ANNScreenInsetsById removeAllObjects];
-    }
-}
-
-@end