@koordinates/xstate-tree 5.2.3 → 5.3.0

package/lib/routing/useIsRouteActive.js

@@ -2,22 +2,27 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.useIsRouteActive = void 0;
 const providers_1 = require("./providers");
-/**
- * @public
- * Accepts Routes and returns true if any route is currently active. False if not.
- *
- * If used outside of a RoutingContext, an error will be thrown.
- * @param routes - the routes to check
- * @returns true if any route is active, false if not
- * @throws if used outside of an xstate-tree root
- */
-function useIsRouteActive(...routes) {
+function useIsRouteActive(...args) {
     const activeRouteEvents = (0, providers_1.useActiveRouteEvents)();
     if (!activeRouteEvents) {
         throw new Error("useIsRouteActive must be used within a RoutingContext. Are you using it outside of an xstate-tree Root?");
     }
+    let routes;
+    let predicate;
+    if (args.length === 2 &&
+        Array.isArray(args[0]) &&
+        typeof args[1] === "function") {
+        routes = args[0];
+        predicate = args[1];
+    }
+    else {
+        routes = args;
+    }
     return activeRouteEvents.some((activeRouteEvent) => {
-        return routes.some((route) => activeRouteEvent.type === route.event);
+        const matches = routes.some((route) => activeRouteEvent.type === route.event);
+        if (!matches)
+            return false;
+        return predicate ? predicate(activeRouteEvent) : true;
     });
 }
 exports.useIsRouteActive = useIsRouteActive;

package/lib/xstate-tree.d.ts

@@ -218,6 +218,13 @@ declare type IsEmptyObject<Obj, ExcludeOptional extends boolean = false> = undef
 never
 ] ? true : false;
 
+/**
+ * @public
+ * Predicate invoked with the matching active route event to decide whether the
+ * route should be considered active.
+ */
+declare type IsRouteActivePredicate<TRoutes extends AnyRoute[]> = (event: RoutingEvent<TRoutes[number]>) => boolean;
+
 declare type IsUnknown<T> = unknown extends T ? true : false;
 
 /**
@@ -680,6 +687,20 @@ export declare function useActiveRouteEvents(): {
  */
 export declare function useIsRouteActive(...routes: AnyRoute[]): boolean;
 
+/**
+ * @public
+ * Accepts an array of Routes and a predicate. Returns true if any of the
+ * routes is currently active AND the predicate returns true when called with
+ * the matching active route event.
+ *
+ * If used outside of a RoutingContext, an error will be thrown.
+ * @param routes - the routes to check
+ * @param predicate - called with the matching active route event; return true to treat the route as active
+ * @returns true if any route is active and the predicate returns true, false otherwise
+ * @throws if used outside of an xstate-tree root
+ */
+export declare function useIsRouteActive<TRoutes extends AnyRoute[]>(routes: [...TRoutes], predicate: IsRouteActivePredicate<TRoutes>): boolean;
+
 /**
  * @public
  * Accepts a single Route and returns true if the route is currently active and marked as an index route.

package/package.json

@@ -2,7 +2,7 @@
   "name": "@koordinates/xstate-tree",
   "main": "lib/index.js",
   "types": "lib/xstate-tree.d.ts",
-  "version": "5.2.3",
+  "version": "5.3.0",
   "license": "MIT",
   "description": "Build UIs with Actors using xstate and React",
   "keywords": [