Allow a Coordinator to be requested to finish

Float.Core/UX/Coordinator.cs

@@ -26,6 +26,11 @@ public abstract class Coordinator : ICoordinator
         /// </summary>
         Page managedPage;
 
+        /// <summary>
+        /// The event args that are pending a finish.
+        /// </summary>
+        EventArgs waitingToFinishEventArgs;
+
         /// <summary>
         /// Occurs when this coordinator is started.
         /// </summary>
@@ -93,6 +98,35 @@ public virtual void Start()
             isStarted = true;
         }
 
+        /// <inheritdoc/>
+        public Task<bool> RequestFinish(EventArgs args)
+        {
+            return Task.FromResult(HandleFinishRequested(this, args));
+        }
+
+        /// <summary>
+        /// Handles when a finish is requested.
+        /// </summary>
+        /// <param name="coordinator">The coordinator that has requested this coordinator to finish.</param>
+        /// <param name="eventArgs">The event args.</param>
+        /// <returns>A value indicating whether this finished.</returns>
+        public virtual bool HandleFinishRequested(ICoordinator coordinator, EventArgs eventArgs)
+        {
+            if (this == coordinator)
+            {
+                if (managedPage == null)
+                {
+                    Finish(eventArgs);
+                    return true;
+                }
+
+                waitingToFinishEventArgs = eventArgs;
+                NavigationContext.Reset(false);
+            }
+
+            return false;
+        }
+
         /// <summary>
         /// Returning a page here will allow the coordinator to automatically
         /// manage itself based on the state of the UI.

Float.Core/UX/CoordinatorParent.cs

@@ -1,5 +1,6 @@
 using System;
 using System.Collections.Generic;
+using System.Threading.Tasks;
 using Float.Core.Extensions;
 
 namespace Float.Core.UX
@@ -15,6 +16,11 @@ public abstract class CoordinatorParent : Coordinator, ICoordinatorParent
         /// </summary>
         readonly List<ICoordinator> childCoordinators = new ();
 
+        /// <summary>
+        /// The event args that have been used as we are waiting to finish all the children before closing the parent.
+        /// </summary>
+        EventArgs waitingToFinishEventArgs = null;
+
         /// <summary>
         /// Gets a value indicating whether this <see cref="CoordinatorParent"/> has children.
         /// </summary>
@@ -117,6 +123,33 @@ public override string ToString()
             return $"[{GetType()}, Children: {string.Join(",", childCoordinators)}]";
         }
 
+        /// <summary>
+        /// Handles the finish request.
+        /// </summary>
+        /// <param name="coordinator">The calling coordinator.</param>
+        /// <param name="eventArgs">The event args.</param>
+        /// <returns>A value indicating whether this finished.</returns>
+        public override bool HandleFinishRequested(ICoordinator coordinator, EventArgs eventArgs)
+        {
+            var didFinish = true;
+
+            waitingToFinishEventArgs = eventArgs;
+
+            foreach (var eachChild in ChildCoordinators)
+            {
+                if (eachChild is Coordinator childCoordinator)
+                {
+                    var finished = childCoordinator.HandleFinishRequested(childCoordinator, eventArgs);
+                    if (!finished)
+                    {
+                        didFinish = false;
+                    }
+                }
+            }
+
+            return didFinish;
+        }
+
         /// <inheritdoc />
         protected override void Finish(EventArgs args)
         {
@@ -149,6 +182,12 @@ protected virtual void HandleChildFinish(object sender, EventArgs args)
             {
                 RemoveChild(child);
             }
+
+            if (!HasChildren && waitingToFinishEventArgs != null)
+            {
+                Finish(waitingToFinishEventArgs);
+                waitingToFinishEventArgs = null;
+            }
         }
     }
 }

Float.Core/UX/ICoordinator.cs

@@ -1,4 +1,5 @@
 using System;
+using System.Threading.Tasks;
 
 namespace Float.Core.UX
 {
@@ -23,5 +24,12 @@ public interface ICoordinator
         /// </summary>
         /// <param name="navigationContext">The navigation context for this coordinator.</param>
         void Start(INavigationContext navigationContext);
+
+        /// <summary>
+        /// Requests that a coordinator will finish.
+        /// </summary>
+        /// <param name="eventArgs">The event args.</param>
+        /// <returns>A task, with a boolean indicating whether this did finish.</returns>
+        Task<bool> RequestFinish(EventArgs eventArgs);
     }
 }

Float.Core/UX/ICoordinatorParent.cs

@@ -1,3 +1,6 @@
+using System;
+using System.Threading.Tasks;
+
 namespace Float.Core.UX
 {
     /// <summary>