Tanstack React Router: add useMatches function

kotlin-tanstack-react-router/src/jsMain/kotlin/tanstack/react/router/UseMatchesOptions.kt

@@ -0,0 +1,11 @@
+package tanstack.react.router
+
+import kotlinx.js.JsPlainObject
+import js.array.ReadonlyArray
+
+@JsPlainObject
+internal /* raw */
+external interface UseMatchesOptions<T> {
+    val select: Select<ReadonlyArray<RouteMatch>, T>?
+    val structuralSharing: Boolean?
+}

kotlin-tanstack-react-router/src/jsMain/kotlin/tanstack/react/router/useMatches.ext.kt

@@ -0,0 +1,17 @@
+package tanstack.react.router
+
+import js.array.ReadonlyArray
+
+fun useMatches(): ReadonlyArray<RouteMatch> =
+    useMatches(UseMatchesOptions())
+
+fun <T> useMatches(
+    select: Select<ReadonlyArray<RouteMatch>, T>,
+): T =
+    useMatches(UseMatchesOptions(select = select))
+
+fun <T> useMatches(
+    select: Select<ReadonlyArray<RouteMatch>, T>,
+    structuralSharing: Boolean,
+): T =
+    useMatches(UseMatchesOptions(select = select, structuralSharing = structuralSharing))

kotlin-tanstack-react-router/src/jsMain/kotlin/tanstack/react/router/useMatches.kt

@@ -0,0 +1,19 @@
+@file:JsModule("@tanstack/react-router")
+
+package tanstack.react.router
+
+/**
+ * The useMatches hook returns the router's complete presented array of RouteMatch objects regardless of its caller's position in the component tree. The array can include still-loading descendants or matches below a pending/error/not-found render boundary.
+ *
+ * Options:
+ * - `select`: If supplied, this function will be called with the route matches and the return value will be returned from useMatches. This value will also be used to determine if the hook should re-render its parent component using shallow equality checks.
+ * - `structuralSharing`: Configures whether structural sharing is enabled for the value returned by select.
+ *
+ * [API Docs](https://tanstack.com/router/latest/docs/framework/react/api/router/useMatchesHook)
+ *
+ * @return An array of RouteMatch objects (or selected value) for the matched route.
+ */
+internal /* raw */
+external fun <T> useMatches(
+    options: UseMatchesOptions<T>,
+): T