feat(router): add afterEach hook to RouterHooks for post-navigation handling

index.d.ts

@@ -626,6 +626,7 @@ declare module '@lightningjs/blits' {
   export interface RouterHooks {
     init?: () => Promise<> | void;
     beforeEach?: (to: Route, from: Route) => string | Route | Promise<string | Route> | void;
+    afterEach?: (to: Route, toComponent: ComponentBase, from: Route, fromComponent: ComponentBase) => string | Route | Promise<string | Route> | void;
     error?: (err: string) => string | Route | Promise<string | Route> | void;
   }
 
@@ -749,6 +750,7 @@ declare module '@lightningjs/blits' {
 
   export interface RouteHooks {
     before?: (to: Route, from: Route) => string | Route | Promise<string | Route>;
+    after?: (to: Route, toComponent: ComponentBase, from: Route, fromComponent: ComponentBase) => string | Route | Promise<string | Route>;
   }
 
   export type Route = {

src/router/router.js

@@ -335,6 +335,7 @@ export const navigate = async function () {
           return
         }
       }
+
       // add the previous route (technically still the current route at this point)
       // into the history stack when inHistory is true and we're not navigating back
       if (
@@ -500,6 +501,45 @@ export const navigate = async function () {
           await setOrAnimate(holder, route.transition.in, shouldAnimate)
         }
       }
+
+      if (this.parent[symbols.routerHooks]) {
+        const hooks = this.parent[symbols.routerHooks]
+        if (hooks.afterEach) {
+          try {
+            // Get the previous view before it's removed
+            const previousView =
+              !reuse && previousRoute && children.length > 1 ? children[children.length - 2] : null
+
+            await hooks.afterEach.call(
+              this.parent,
+              route, // to
+              view, // toComponent
+              previousRoute, // from
+              previousView // fromComponent
+            )
+          } catch (error) {
+            Log.error('Error in "AfterEach" Hook', error)
+          }
+        }
+      }
+
+      if (route.hooks.after) {
+        try {
+          // Get the previous view before it's removed
+          const previousView =
+            !reuse && previousRoute && children.length > 1 ? children[children.length - 2] : null
+
+          await route.hooks.after.call(
+            this.parent,
+            route, // to
+            view, // toComponent
+            previousRoute, // from
+            previousView // fromComponent
+          )
+        } catch (error) {
+          Log.error('Error or Rejected Promise in "After" Hook', error)
+        }
+      }
     } else {
       Log.error(`Route ${route.hash} not found`)
       const routerHooks = this.parent[symbols.routerHooks]