@tempots/ui 10.0.0 → 10.1.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tempots/ui",
-  "version": "10.0.0",
+  "version": "10.1.0",
   "type": "module",
   "main": "./index.cjs",
   "module": "./index.js",

package/renderables/router/location.d.ts

@@ -1,7 +1,27 @@
-import { Provider, Signal } from '@tempots/dom';
+import { Provider, Signal, Value } from '@tempots/dom';
 import { LocationData } from './location-data';
 import { NavigationOptions } from './navigation-options';
 export type { NavigationOptions } from './navigation-options';
+/**
+ * Options that control how `LocationHandle.match` and `matchSignal` interpret URL parts.
+ *
+ * @public
+ */
+export type LocationMatchOptions = {
+    /**
+     * Whether the search parameters should participate in the match. Defaults to `true`.
+     */
+    includeSearch?: boolean;
+    /**
+     * Whether the hash fragment should participate in the match. Defaults to `true`.
+     */
+    includeHash?: boolean;
+    /**
+     * Keys that should be ignored when comparing search parameters.
+     */
+    ignoreSearchParams?: string[];
+};
+export declare const evaluateLocationMatch: (location: LocationData, matcher: string | RegExp | ((location: LocationData) => boolean), options: LocationMatchOptions | undefined) => boolean;
 /**
  * A read/write navigation handle exposed by the Location provider.
  *
@@ -88,6 +108,14 @@ export type LocationHandle = {
      * Runs mutations against a draft copy and commits once after the callback finishes.
      */
     run: (mutate: (draft: LocationDraft) => void, options?: NavigationOptions) => void;
+    /**
+     * Evaluates whether the current location matches the provided matcher, honouring match options.
+     */
+    match: (matcher: string | RegExp | ((location: LocationData) => boolean), options?: LocationMatchOptions) => boolean;
+    /**
+     * Returns a reactive signal that mirrors the result of `match`.
+     */
+    matchSignal: (matcher: Value<string | RegExp | ((location: LocationData) => boolean)>, options?: LocationMatchOptions) => Signal<boolean>;
 };
 /**
  * Draft object provided inside `LocationHandle.run` for staged updates.