@real-router/react 0.4.2 → 0.4.4

package/src/index.ts

@@ -0,0 +1,27 @@
+// packages/react/modules/index.ts
+
+// Components
+export { BaseLink } from "./components/BaseLink";
+
+export type { BaseLinkProps } from "./types";
+
+export { Link } from "./components/Link";
+
+export { ConnectedLink } from "./components/ConnectedLink";
+
+// Hooks
+export { useRouteNode } from "./hooks/useRouteNode";
+
+export { useRoute } from "./hooks/useRoute";
+
+export { useNavigator } from "./hooks/useNavigator";
+
+// Context
+export { RouterProvider } from "./RouterProvider";
+
+export { RouterContext, RouteContext, NavigatorContext } from "./context";
+
+export { useRouter } from "./hooks/useRouter";
+
+// Types
+export type { Navigator } from "@real-router/core";

package/src/types.ts

@@ -0,0 +1,36 @@
+// packages/react/modules/types.ts
+
+import type { Params, Navigator, Router, State } from "@real-router/core";
+import type { MouseEvent, ReactNode } from "react";
+
+export interface RouteState<
+  P extends Params = Params,
+  MP extends Params = Params,
+> {
+  route: State<P, MP> | undefined;
+  previousRoute?: State | undefined;
+}
+
+export type RouteContext = {
+  navigator: Navigator;
+} & RouteState;
+
+export interface BaseLinkProps {
+  [key: string]: unknown;
+  router: Router;
+  routeName: string;
+  routeParams?: Params;
+  routeOptions?: {
+    [key: string]: unknown;
+    reload?: boolean;
+    replace?: boolean;
+  };
+  className?: string;
+  activeClassName?: string;
+  activeStrict?: boolean;
+  ignoreQueryParams?: boolean;
+  onClick?: (evt: MouseEvent<HTMLAnchorElement>) => void;
+  target?: string;
+  children?: ReactNode;
+  previousRoute?: State;
+}

package/src/utils.ts

@@ -0,0 +1,71 @@
+// packages/react/modules/utils.ts
+
+import type { Params, Router, State } from "@real-router/core";
+import type { MouseEvent } from "react";
+
+/**
+ * Cache for shouldUpdateNode functions to avoid recreating them
+ */
+export const shouldUpdateCache = new WeakMap<
+  Router,
+  Map<string, (toState: State, fromState?: State) => boolean>
+>();
+
+/**
+ * Get cached shouldUpdateNode function for a router and nodeName
+ */
+export function getCachedShouldUpdate(
+  router: Router,
+  nodeName: string,
+): (toState: State, fromState?: State) => boolean {
+  let cache = shouldUpdateCache.get(router);
+
+  if (!cache) {
+    cache = new Map();
+    shouldUpdateCache.set(router, cache);
+  }
+
+  let fn = cache.get(nodeName);
+
+  if (!fn) {
+    fn = router.shouldUpdateNode(nodeName);
+
+    const originalFn = fn;
+
+    fn = (toState: State, fromState?: State) => originalFn(toState, fromState);
+
+    cache.set(nodeName, fn);
+  }
+
+  return fn;
+}
+
+/**
+ * Check if navigation should be handled by router
+ */
+export function shouldNavigate(evt: MouseEvent): boolean {
+  return (
+    evt.button === 0 && // left click
+    !evt.metaKey &&
+    !evt.altKey &&
+    !evt.ctrlKey &&
+    !evt.shiftKey
+  );
+}
+
+/**
+ * Create cache key for route active check
+ */
+export function createActiveCheckKey(
+  routeName: string,
+  routeParams: Params,
+  activeStrict: boolean,
+  ignoreQueryParams: boolean,
+): string {
+  return JSON.stringify({
+    routeName,
+    routeParams,
+    activeStrict,
+    ignoreQueryParams,
+  });
+}