@real-router/react 0.5.5 → 0.7.0

package/README.md

@@ -1,7 +1,7 @@
 # @real-router/react
 
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
-[![React](https://img.shields.io/badge/React-18+-61DAFB.svg)](https://reactjs.org/)
+[![React](https://img.shields.io/badge/React-19.2+-61DAFB.svg)](https://react.dev/)
 
 React integration for Real-Router — hooks, components, and context providers.
 
@@ -19,6 +19,25 @@ bun add @real-router/react @real-router/core @real-router/browser-plugin
 
 **Peer Dependencies:** `react` >= 18.0.0
 
+## Entry Points
+
+The package provides two entry points via subpath exports:
+
+| Import Path                 | React Version | Description                               |
+| --------------------------- | ------------- | ----------------------------------------- |
+| `@real-router/react`        | 19.2+         | Full API (default)                        |
+| `@real-router/react/legacy` | 18+           | Same API minus React 19.2-only components |
+
+```tsx
+// React 19.2+ (default) — full API
+import { RouterProvider, useRouteNode, Link } from "@real-router/react";
+
+// React 18+ — without React 19.2-only components
+import { RouterProvider, useRouteNode, Link } from "@real-router/react/legacy";
+```
+
+Both entry points share the same underlying code — `/legacy` is a re-export subset that excludes components requiring React 19.2+ APIs (e.g., `<Activity>`).
+
 ## Quick Start
 
 ```tsx
@@ -188,7 +207,7 @@ const Breadcrumbs = () => {
 
 #### `<Link routeName={string} routeParams={object} ...props>`
 
-Navigation link with automatic active state detection.\
+Navigation link with automatic active state detection. Re-renders only when its own active status changes.\
 `routeName: string` — target route name\
 `routeParams?: Params` — route parameters\
 `routeOptions?: { reload?, replace? }` — navigation options\
@@ -210,18 +229,18 @@ import { Link } from "@real-router/react";
 </Link>;
 ```
 
-#### `<ConnectedLink ...props>`
+---
 
-Same as `Link`, but re-renders on every route change.\
-Props: same as `Link`\
-[Wiki](https://github.com/greydragon888/real-router/wiki/ConnectedLink)
+## Migration from React 18
 
-#### `<BaseLink router={router} ...props>`
+If upgrading from an older version that targeted React 18:
+
+```diff
+- import { useRouteNode, Link } from '@real-router/react';
++ import { useRouteNode, Link } from '@real-router/react/legacy';
+```
 
-Low-level link component. Requires router instance as prop.\
-`router: Router` — router instance\
-Props: same as `Link`\
-[Wiki](https://github.com/greydragon888/real-router/wiki/BaseLink)
+One import path change. API is identical.
 
 ---
 
@@ -230,7 +249,7 @@ Props: same as `Link`\
 | API                                           | react-router5 | @real-router/react |
 | --------------------------------------------- | ------------- | ------------------ |
 | `RouterProvider`                              | ✓             | ✓                  |
-| `Link`, `ConnectedLink`, `BaseLink`           | ✓             | ✓                  |
+| `Link`                                        | ✓             | ✓                  |
 | `useRouter`, `useRoute`, `useRouteNode`       | ✓             | ✓                  |
 | `withRouter`, `withRoute`, `routeNode`        | ✓             | ❌ Use hooks       |
 | `Router`, `Route`, `RouteNode` (render props) | ✓             | ❌ Use hooks       |

package/dist/cjs/index.d.ts

@@ -1,7 +1,7 @@
-import { Router, Params, State, Navigator, NavigationOptions } from '@real-router/core';
+import { Params, NavigationOptions, Navigator, State, Router } from '@real-router/core';
 export { Navigator } from '@real-router/core';
 import * as react from 'react';
-import { MouseEvent, ReactNode, FC, HTMLAttributes, MouseEventHandler } from 'react';
+import { HTMLAttributes, MouseEventHandler, FC, ReactNode } from 'react';
 import { RouteUtils } from '@real-router/route-utils';
 
 interface RouteState<P extends Params = Params, MP extends Params = Params> {
@@ -11,39 +11,10 @@ interface RouteState<P extends Params = Params, MP extends Params = Params> {
 type RouteContext$1 = {
     navigator: Navigator;
 } & RouteState;
-interface BaseLinkProps$1 {
-    [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;
-}
-
-/**
- * Optimized BaseLink component with memoization and performance improvements
- */
-declare const BaseLink: FC<BaseLinkProps$1>;
-
-interface BaseLinkProps<P extends Params = Params, MP extends Params = Params> extends HTMLAttributes<HTMLAnchorElement> {
-    router: Router;
+interface LinkProps<P extends Params = Params> extends HTMLAttributes<HTMLAnchorElement> {
     routeName: string;
-    route?: State<P, MP> | undefined;
-    previousRoute?: State | undefined;
     routeParams?: P;
     routeOptions?: NavigationOptions;
-    className?: string;
     activeClassName?: string;
     activeStrict?: boolean;
     ignoreQueryParams?: boolean;
@@ -52,9 +23,7 @@ interface BaseLinkProps<P extends Params = Params, MP extends Params = Params> e
     onMouseOver?: MouseEventHandler<HTMLAnchorElement>;
 }
 
-declare const Link: FC<Omit<BaseLinkProps, "router">>;
-
-declare const ConnectedLink: FC<Omit<BaseLinkProps, "router" | "route" | "previousRoute">>;
+declare const Link: FC<LinkProps>;
 
 declare function useRouteNode(nodeName: string): RouteContext$1;
 
@@ -62,16 +31,6 @@ declare const useRoute: () => RouteContext$1;
 
 declare const useNavigator: () => Navigator;
 
-interface RouteProviderProps {
-    router: Router;
-    children: ReactNode;
-}
-declare const RouterProvider: FC<RouteProviderProps>;
-
-declare const RouteContext: react.Context<RouteContext$1 | null>;
-declare const RouterContext: react.Context<Router<object> | null>;
-declare const NavigatorContext: react.Context<Navigator | null>;
-
 declare const useRouter: () => Router;
 
 /**
@@ -98,4 +57,16 @@ declare const useRouter: () => Router;
  */
 declare const useRouteUtils: () => RouteUtils;
 
-export { BaseLink, type BaseLinkProps$1 as BaseLinkProps, ConnectedLink, Link, NavigatorContext, RouteContext, RouterContext, RouterProvider, useNavigator, useRoute, useRouteNode, useRouteUtils, useRouter };
+declare function useIsActiveRoute(routeName: string, params?: Params, strict?: boolean, ignoreQueryParams?: boolean): boolean;
+
+interface RouteProviderProps {
+    router: Router;
+    children: ReactNode;
+}
+declare const RouterProvider: FC<RouteProviderProps>;
+
+declare const RouteContext: react.Context<RouteContext$1 | null>;
+declare const RouterContext: react.Context<Router<object> | null>;
+declare const NavigatorContext: react.Context<Navigator | null>;
+
+export { Link, type LinkProps, NavigatorContext, RouteContext, RouterContext, RouterProvider, useIsActiveRoute, useNavigator, useRoute, useRouteNode, useRouteUtils, useRouter };

package/dist/cjs/index.js

@@ -1 +1 @@
-var e=require("react"),t=require("@real-router/sources"),r=require("react/jsx-runtime"),o=require("@real-router/core"),u=require("@real-router/route-utils"),s=Object.freeze({}),a=Object.freeze({}),i=e.createContext(null),n=e.createContext(null),c=e.createContext(null),l=()=>{const t=e.use(n);if(!t)throw new Error("useRouter must be used within a RouterProvider");return t};function m(t){const r=JSON.stringify(t);return e.useMemo(()=>t,[r])}var v=e.memo(({routeName:o,routeParams:u=s,routeOptions:i=a,className:n,activeClassName:c="active",activeStrict:v=!1,ignoreQueryParams:p=!0,onClick:g,target:x,router:d,children:h,...N})=>{const S=m(u),R=m(i),f=function(r,o,u=!1,s=!0){const a=l(),i=m(o),n=e.useMemo(()=>t.createActiveRouteSource(a,r,i,{strict:u,ignoreQueryParams:s}),[a,r,i,u,s]);return e.useSyncExternalStore(n.subscribe,n.getSnapshot,n.getSnapshot)}(o,S,v,p),y=e.useMemo(()=>"function"==typeof d.buildUrl?d.buildUrl(o,S):d.buildPath(o,S),[d,o,S]),b=e.useCallback(e=>{g&&(g(e),e.defaultPrevented)||function(e){return!(0!==e.button||e.metaKey||e.altKey||e.ctrlKey||e.shiftKey)}(e)&&"_blank"!==x&&(e.preventDefault(),d.navigate(o,S,R).catch(()=>{}))},[g,x,d,o,S,R]),C=e.useMemo(()=>f&&c?n?`${n} ${c}`.trim():c:n??void 0,[f,n,c]),{previousRoute:P,...O}=N;return r.jsx("a",{...O,href:y,className:C,onClick:b,"data-route":o,"data-active":f,children:h})},(e,t)=>e.router===t.router&&e.routeName===t.routeName&&JSON.stringify(e.routeParams)===JSON.stringify(t.routeParams)&&JSON.stringify(e.routeOptions)===JSON.stringify(t.routeOptions)&&e.className===t.className&&e.activeClassName===t.activeClassName&&e.activeStrict===t.activeStrict&&e.ignoreQueryParams===t.ignoreQueryParams&&e.onClick===t.onClick&&e.target===t.target&&e.children===t.children);v.displayName="BaseLink";var p=()=>{const t=e.use(i);if(!t)throw new Error("useRoute must be used within a RouteProvider");return t};exports.BaseLink=v,exports.ConnectedLink=e=>{const t=l(),{route:o}=p(),{routeOptions:u,...s}=e;return r.jsx(v,{router:t,route:o,...s})},exports.Link=e=>{const t=l(),{route:o,previousRoute:u,routeOptions:s,...a}=e;return r.jsx(v,{router:t,...a})},exports.NavigatorContext=c,exports.RouteContext=i,exports.RouterContext=n,exports.RouterProvider=({router:u,children:s})=>{const a=e.useMemo(()=>o.getNavigator(u),[u]),l=e.useMemo(()=>t.createRouteSource(u),[u]),{route:m,previousRoute:v}=e.useSyncExternalStore(l.subscribe,l.getSnapshot,l.getSnapshot),p=e.useMemo(()=>({navigator:a,route:m,previousRoute:v}),[a,m,v]);return r.jsx(n,{value:u,children:r.jsx(c,{value:a,children:r.jsx(i,{value:p,children:s})})})},exports.useNavigator=()=>{const t=e.use(c);if(!t)throw new Error("useNavigator must be used within a RouterProvider");return t},exports.useRoute=p,exports.useRouteNode=function(r){const u=l(),s=e.useMemo(()=>t.createRouteNodeSource(u,r),[u,r]),{route:a,previousRoute:i}=e.useSyncExternalStore(s.subscribe,s.getSnapshot,s.getSnapshot),n=e.useMemo(()=>o.getNavigator(u),[u]);return e.useMemo(()=>({navigator:n,route:a,previousRoute:i}),[n,a,i])},exports.useRouteUtils=()=>{const e=l();return u.getRouteUtils(o.getPluginApi(e).getTree())},exports.useRouter=l;//# sourceMappingURL=index.js.map
+var e=require("react"),t=require("@real-router/sources"),r=require("react/jsx-runtime"),o=require("@real-router/core"),u=require("@real-router/route-utils"),s=Object.freeze({}),a=Object.freeze({}),i=e.createContext(null),n=e.createContext(null),c=e.createContext(null),l=()=>{const t=e.use(n);if(!t)throw new Error("useRouter must be used within a RouterProvider");return t};function m(t){const r=JSON.stringify(t);return e.useMemo(()=>t,[r])}function v(r,o,u=!1,s=!0){const a=l(),i=m(o),n=e.useMemo(()=>t.createActiveRouteSource(a,r,i,{strict:u,ignoreQueryParams:s}),[a,r,i,u,s]);return e.useSyncExternalStore(n.subscribe,n.getSnapshot,n.getSnapshot)}var g=e.memo(({routeName:t,routeParams:o=s,routeOptions:u=a,className:i,activeClassName:n="active",activeStrict:c=!1,ignoreQueryParams:g=!0,onClick:p,target:x,children:d,...h})=>{const N=l(),S=m(o),f=m(u),R=v(t,S,c,g),y=e.useMemo(()=>"function"==typeof N.buildUrl?N.buildUrl(t,S):N.buildPath(t,S),[N,t,S]),b=e.useCallback(e=>{p&&(p(e),e.defaultPrevented)||function(e){return!(0!==e.button||e.metaKey||e.altKey||e.ctrlKey||e.shiftKey)}(e)&&"_blank"!==x&&(e.preventDefault(),N.navigate(t,S,f).catch(()=>{}))},[p,x,N,t,S,f]),C=e.useMemo(()=>R&&n?i?`${i} ${n}`.trim():n:i??void 0,[R,i,n]);return r.jsx("a",{...h,href:y,className:C,onClick:b,children:d})},function(e,t){return e.routeName===t.routeName&&e.className===t.className&&e.activeClassName===t.activeClassName&&e.activeStrict===t.activeStrict&&e.ignoreQueryParams===t.ignoreQueryParams&&e.onClick===t.onClick&&e.target===t.target&&e.style===t.style&&e.children===t.children&&JSON.stringify(e.routeParams)===JSON.stringify(t.routeParams)&&JSON.stringify(e.routeOptions)===JSON.stringify(t.routeOptions)});g.displayName="Link",exports.Link=g,exports.NavigatorContext=c,exports.RouteContext=i,exports.RouterContext=n,exports.RouterProvider=({router:u,children:s})=>{const a=e.useMemo(()=>o.getNavigator(u),[u]),l=e.useMemo(()=>t.createRouteSource(u),[u]),{route:m,previousRoute:v}=e.useSyncExternalStore(l.subscribe,l.getSnapshot,l.getSnapshot),g=e.useMemo(()=>({navigator:a,route:m,previousRoute:v}),[a,m,v]);return r.jsx(n,{value:u,children:r.jsx(c,{value:a,children:r.jsx(i,{value:g,children:s})})})},exports.useIsActiveRoute=v,exports.useNavigator=()=>{const t=e.use(c);if(!t)throw new Error("useNavigator must be used within a RouterProvider");return t},exports.useRoute=()=>{const t=e.use(i);if(!t)throw new Error("useRoute must be used within a RouteProvider");return t},exports.useRouteNode=function(r){const u=l(),s=e.useMemo(()=>t.createRouteNodeSource(u,r),[u,r]),{route:a,previousRoute:i}=e.useSyncExternalStore(s.subscribe,s.getSnapshot,s.getSnapshot),n=e.useMemo(()=>o.getNavigator(u),[u]);return e.useMemo(()=>({navigator:n,route:a,previousRoute:i}),[n,a,i])},exports.useRouteUtils=()=>{const e=l();return u.getRouteUtils(o.getPluginApi(e).getTree())},exports.useRouter=l;//# sourceMappingURL=index.js.map

package/dist/cjs/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/constants.ts","../../src/context.ts","../../src/hooks/useRouter.tsx","../../src/hooks/useStableValue.tsx","../../src/hooks/useIsActiveRoute.tsx","../../src/utils.ts","../../src/components/BaseLink.tsx","../../src/components/Link.tsx","../../src/hooks/useRoute.tsx","../../src/components/ConnectedLink.tsx","../../src/hooks/useRouteNode.tsx","../../src/hooks/useNavigator.tsx","../../src/RouterProvider.tsx","../../src/hooks/useRouteUtils.tsx"],"names":["createContext","use","useMemo","createActiveRouteSource","useSyncExternalStore","memo","useCallback","jsx","createRouteNodeSource","getNavigator","createRouteSource","getRouteUtils","getPluginApi"],"mappings":"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","file":"index.js","sourcesContent":["// packages/react/modules/constants.ts\n\n/**\n * Stable empty object for default params\n */\nexport const EMPTY_PARAMS = Object.freeze({});\n\n/**\n * Stable empty options object\n */\nexport const EMPTY_OPTIONS = Object.freeze({});\n","// packages/react/modules/context.ts\n\nimport { createContext } from \"react\";\n\nimport type { RouteContext as RouteContextType } from \"./types\";\nimport type { Router, Navigator } from \"@real-router/core\";\n\nexport const RouteContext = createContext<RouteContextType | null>(null);\n\nexport const RouterContext = createContext<Router | null>(null);\n\nexport const NavigatorContext = createContext<Navigator | null>(null);\n","// packages/react/modules/hooks/useRouter.tsx\n\nimport { use } from \"react\";\n\nimport { RouterContext } from \"../context\";\n\nimport type { Router } from \"@real-router/core\";\n\nexport const useRouter = (): Router => {\n  const router = use(RouterContext);\n\n  if (!router) {\n    throw new Error(\"useRouter must be used within a RouterProvider\");\n  }\n\n  return router;\n};\n","// packages/react/modules/hooks/useStableValue.tsx\n\nimport { useMemo } from \"react\";\n\n/**\n * Stabilizes a value reference based on deep equality (via JSON serialization).\n * Returns the same reference until the serialized value changes.\n *\n * Useful for object/array dependencies in hooks like useMemo, useCallback, useEffect\n * to prevent unnecessary re-renders when the value is structurally the same.\n *\n * @example\n * ```tsx\n * const stableParams = useStableValue(routeParams);\n * const href = useMemo(() => {\n *   return router.buildUrl(routeName, stableParams);\n * }, [router, routeName, stableParams]);\n * ```\n *\n * @param value - The value to stabilize\n * @returns A stable reference to the value\n */\nexport function useStableValue<T>(value: T): T {\n  const serialized = JSON.stringify(value);\n\n  // We intentionally use serialized in deps to detect deep changes\n  // eslint-disable-next-line react-hooks/exhaustive-deps\n  return useMemo(() => value, [serialized]);\n}\n","import { createActiveRouteSource } from \"@real-router/sources\";\nimport { useMemo, useSyncExternalStore } from \"react\";\n\nimport { useRouter } from \"./useRouter\";\nimport { useStableValue } from \"./useStableValue\";\n\nimport type { Params } from \"@real-router/core\";\n\nexport function useIsActiveRoute(\n  routeName: string,\n  params?: Params,\n  strict = false,\n  ignoreQueryParams = true,\n): boolean {\n  const router = useRouter();\n\n  // useStableValue: JSON.stringify memoization of params object.\n  // Without it, every render with a new params reference (e.g.,\n  // <Link routeParams={{ id: '123' }} />) would recreate the store.\n  const stableParams = useStableValue(params);\n\n  const store = useMemo(\n    () =>\n      createActiveRouteSource(router, routeName, stableParams, {\n        strict,\n        ignoreQueryParams,\n      }),\n    [router, routeName, stableParams, strict, ignoreQueryParams],\n  );\n\n  return useSyncExternalStore(\n    store.subscribe,\n    store.getSnapshot,\n    store.getSnapshot, // SSR: router returns same state on server and client\n  );\n}\n","import type { MouseEvent } from \"react\";\n\n/**\n * Check if navigation should be handled by router\n */\nexport function shouldNavigate(evt: MouseEvent): boolean {\n  return (\n    evt.button === 0 && // left click\n    !evt.metaKey &&\n    !evt.altKey &&\n    !evt.ctrlKey &&\n    !evt.shiftKey\n  );\n}\n","// packages/react/modules/components/BaseLink.tsx\n\nimport { memo, useCallback, useMemo } from \"react\";\n\nimport { EMPTY_PARAMS, EMPTY_OPTIONS } from \"../constants\";\nimport { useIsActiveRoute } from \"../hooks/useIsActiveRoute\";\nimport { useStableValue } from \"../hooks/useStableValue\";\nimport { shouldNavigate } from \"../utils\";\n\nimport type { BaseLinkProps } from \"../types\";\nimport type { FC, MouseEvent } from \"react\";\n\n/**\n * Optimized BaseLink component with memoization and performance improvements\n */\nexport const BaseLink: FC<BaseLinkProps> = memo(\n  ({\n    routeName,\n    routeParams = EMPTY_PARAMS,\n    routeOptions = EMPTY_OPTIONS,\n    className,\n    activeClassName = \"active\",\n    activeStrict = false,\n    ignoreQueryParams = true,\n    onClick,\n    target,\n    router,\n    children,\n    ...props\n  }) => {\n    // Stabilize object references to prevent unnecessary re-renders\n    const stableParams = useStableValue(routeParams);\n    const stableOptions = useStableValue(routeOptions);\n\n    // Use optimized hook for active state checking\n    const isActive = useIsActiveRoute(\n      routeName,\n      stableParams,\n      activeStrict,\n      ignoreQueryParams,\n    );\n\n    // Build URL with memoization\n    const href = useMemo(() => {\n      // Use buildUrl if available (browser plugin installed)\n      // Otherwise fall back to buildPath (e.g., in SSR or without browser plugin)\n      if (typeof router.buildUrl === \"function\") {\n        return router.buildUrl(routeName, stableParams);\n      }\n\n      return router.buildPath(routeName, stableParams);\n    }, [router, routeName, stableParams]);\n\n    // Optimized click handler\n    const handleClick = useCallback(\n      (evt: MouseEvent<HTMLAnchorElement>) => {\n        // Call custom onClick if provided\n        if (onClick) {\n          onClick(evt);\n          // Respect preventDefault from custom handler\n          if (evt.defaultPrevented) {\n            return;\n          }\n        }\n\n        // Check if we should handle navigation\n        if (!shouldNavigate(evt) || target === \"_blank\") {\n          return;\n        }\n\n        // Prevent default link behavior\n        evt.preventDefault();\n\n        // Perform navigation (fire-and-forget)\n        router.navigate(routeName, stableParams, stableOptions).catch(() => {});\n      },\n      [onClick, target, router, routeName, stableParams, stableOptions],\n    );\n\n    // Build className efficiently\n    const finalClassName = useMemo(() => {\n      if (isActive && activeClassName) {\n        return className\n          ? `${className} ${activeClassName}`.trim()\n          : activeClassName;\n      }\n\n      return className ?? undefined;\n    }, [isActive, className, activeClassName]);\n\n    // Filter out previousRoute from props\n    // eslint-disable-next-line @typescript-eslint/no-unused-vars\n    const { previousRoute, ...restProps } = props;\n\n    return (\n      <a\n        {...restProps}\n        href={href}\n        className={finalClassName}\n        onClick={handleClick}\n        data-route={routeName} // For event delegation if needed\n        data-active={isActive} // For CSS selectors if needed\n      >\n        {children}\n      </a>\n    );\n  },\n  (prevProps, nextProps) => {\n    // Custom comparison for better memoization\n    // Check if props that affect rendering have changed\n    return (\n      prevProps.router === nextProps.router &&\n      prevProps.routeName === nextProps.routeName &&\n      JSON.stringify(prevProps.routeParams) ===\n        JSON.stringify(nextProps.routeParams) &&\n      JSON.stringify(prevProps.routeOptions) ===\n        JSON.stringify(nextProps.routeOptions) &&\n      prevProps.className === nextProps.className &&\n      prevProps.activeClassName === nextProps.activeClassName &&\n      prevProps.activeStrict === nextProps.activeStrict &&\n      prevProps.ignoreQueryParams === nextProps.ignoreQueryParams &&\n      prevProps.onClick === nextProps.onClick &&\n      prevProps.target === nextProps.target &&\n      prevProps.children === nextProps.children\n    );\n  },\n);\n\nBaseLink.displayName = \"BaseLink\";\n","// packages/react/modules/components/Link.tsx\n\nimport { BaseLink } from \"./BaseLink\";\nimport { useRouter } from \"../hooks/useRouter\";\n\nimport type { BaseLinkProps } from \"./interfaces\";\nimport type { FC } from \"react\";\n\nexport const Link: FC<Omit<BaseLinkProps, \"router\">> = (props) => {\n  const router = useRouter();\n\n  // eslint-disable-next-line @typescript-eslint/no-unused-vars\n  const { route, previousRoute, routeOptions, ...linkProps } = props;\n\n  return <BaseLink router={router} {...linkProps} />;\n};\n","// packages/react/modules/hooks/useRoute.tsx\n\nimport { use } from \"react\";\n\nimport { RouteContext } from \"../context\";\n\nimport type { RouteContext as RouteContextType } from \"../types\";\n\nexport const useRoute = (): RouteContextType => {\n  const routeContext = use(RouteContext);\n\n  if (!routeContext) {\n    throw new Error(\"useRoute must be used within a RouteProvider\");\n  }\n\n  return routeContext;\n};\n","// packages/react/modules/components/ConnectedLink.tsx\n\nimport { BaseLink } from \"./BaseLink\";\nimport { useRoute } from \"../hooks/useRoute\";\nimport { useRouter } from \"../hooks/useRouter\";\n\nimport type { BaseLinkProps } from \"./interfaces\";\nimport type { FC } from \"react\";\n\nexport const ConnectedLink: FC<\n  Omit<BaseLinkProps, \"router\" | \"route\" | \"previousRoute\">\n> = (props) => {\n  const router = useRouter();\n  const { route } = useRoute();\n\n  // eslint-disable-next-line @typescript-eslint/no-unused-vars\n  const { routeOptions, ...linkProps } = props;\n\n  return <BaseLink router={router} route={route} {...linkProps} />;\n};\n","import { getNavigator } from \"@real-router/core\";\nimport { createRouteNodeSource } from \"@real-router/sources\";\nimport { useMemo, useSyncExternalStore } from \"react\";\n\nimport { useRouter } from \"./useRouter\";\n\nimport type { RouteContext } from \"../types\";\n\nexport function useRouteNode(nodeName: string): RouteContext {\n  const router = useRouter();\n\n  const store = useMemo(\n    () => createRouteNodeSource(router, nodeName),\n    [router, nodeName],\n  );\n\n  const { route, previousRoute } = useSyncExternalStore(\n    store.subscribe,\n    store.getSnapshot,\n    store.getSnapshot, // SSR: router returns same state on server and client\n  );\n\n  const navigator = useMemo(() => getNavigator(router), [router]);\n\n  return useMemo(\n    (): RouteContext => ({ navigator, route, previousRoute }),\n    [navigator, route, previousRoute],\n  );\n}\n","// packages/react/modules/hooks/useNavigator.tsx\n\nimport { use } from \"react\";\n\nimport { NavigatorContext } from \"../context\";\n\nimport type { Navigator } from \"@real-router/core\";\n\nexport const useNavigator = (): Navigator => {\n  const navigator = use(NavigatorContext);\n\n  if (!navigator) {\n    throw new Error(\"useNavigator must be used within a RouterProvider\");\n  }\n\n  return navigator;\n};\n","import { getNavigator } from \"@real-router/core\";\nimport { createRouteSource } from \"@real-router/sources\";\nimport { useMemo, useSyncExternalStore } from \"react\";\n\nimport { NavigatorContext, RouteContext, RouterContext } from \"./context\";\n\nimport type { Router } from \"@real-router/core\";\nimport type { FC, ReactNode } from \"react\";\n\nexport interface RouteProviderProps {\n  router: Router;\n  children: ReactNode;\n}\n\nexport const RouterProvider: FC<RouteProviderProps> = ({\n  router,\n  children,\n}) => {\n  const navigator = useMemo(() => getNavigator(router), [router]);\n\n  // useSyncExternalStore manages the router subscription lifecycle:\n  // subscribe connects to router on first listener, unsubscribes on last.\n  // This is Strict Mode safe — no useEffect cleanup needed.\n  const store = useMemo(() => createRouteSource(router), [router]);\n  const { route, previousRoute } = useSyncExternalStore(\n    store.subscribe,\n    store.getSnapshot,\n    store.getSnapshot, // SSR: router returns same state on server and client\n  );\n\n  const routeContextValue = useMemo(\n    () => ({ navigator, route, previousRoute }),\n    [navigator, route, previousRoute],\n  );\n\n  return (\n    <RouterContext value={router}>\n      <NavigatorContext value={navigator}>\n        <RouteContext value={routeContextValue}>{children}</RouteContext>\n      </NavigatorContext>\n    </RouterContext>\n  );\n};\n","// packages/react/modules/hooks/useRouteUtils.tsx\n\nimport { getPluginApi } from \"@real-router/core\";\nimport { getRouteUtils } from \"@real-router/route-utils\";\n\nimport { useRouter } from \"./useRouter\";\n\nimport type { RouteUtils } from \"@real-router/route-utils\";\n\n/**\n * Returns a pre-computed {@link RouteUtils} instance for the current router.\n *\n * Internally retrieves the route tree via `getPluginApi` and delegates\n * to `getRouteUtils`, which caches instances per tree reference (WeakMap).\n *\n * @returns RouteUtils instance with pre-computed chains and siblings\n *\n * @example\n * ```tsx\n * const utils = useRouteUtils();\n *\n * utils.getChain(\"users.profile\");\n * // → [\"users\", \"users.profile\"]\n *\n * utils.getSiblings(\"users\");\n * // → [\"admin\"]\n *\n * utils.isDescendantOf(\"users.profile\", \"users\");\n * // → true\n * ```\n */\nexport const useRouteUtils = (): RouteUtils => {\n  const router = useRouter();\n\n  return getRouteUtils(getPluginApi(router).getTree());\n};\n"]}
+{"version":3,"sources":["../../src/constants.ts","../../src/context.ts","../../src/hooks/useRouter.tsx","../../src/hooks/useStableValue.tsx","../../src/hooks/useIsActiveRoute.tsx","../../src/utils.ts","../../src/components/Link.tsx","../../src/hooks/useRouteNode.tsx","../../src/hooks/useRoute.tsx","../../src/hooks/useNavigator.tsx","../../src/hooks/useRouteUtils.tsx","../../src/RouterProvider.tsx"],"names":["createContext","use","useMemo","createActiveRouteSource","useSyncExternalStore","memo","useCallback","jsx","createRouteNodeSource","getNavigator","getRouteUtils","getPluginApi","createRouteSource"],"mappings":"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","file":"index.js","sourcesContent":["// packages/react/modules/constants.ts\n\n/**\n * Stable empty object for default params\n */\nexport const EMPTY_PARAMS = Object.freeze({});\n\n/**\n * Stable empty options object\n */\nexport const EMPTY_OPTIONS = Object.freeze({});\n","// packages/react/modules/context.ts\n\nimport { createContext } from \"react\";\n\nimport type { RouteContext as RouteContextType } from \"./types\";\nimport type { Router, Navigator } from \"@real-router/core\";\n\nexport const RouteContext = createContext<RouteContextType | null>(null);\n\nexport const RouterContext = createContext<Router | null>(null);\n\nexport const NavigatorContext = createContext<Navigator | null>(null);\n","// packages/react/modules/hooks/useRouter.tsx\n\nimport { use } from \"react\";\n\nimport { RouterContext } from \"../context\";\n\nimport type { Router } from \"@real-router/core\";\n\nexport const useRouter = (): Router => {\n  const router = use(RouterContext);\n\n  if (!router) {\n    throw new Error(\"useRouter must be used within a RouterProvider\");\n  }\n\n  return router;\n};\n","// packages/react/modules/hooks/useStableValue.tsx\n\nimport { useMemo } from \"react\";\n\n/**\n * Stabilizes a value reference based on deep equality (via JSON serialization).\n * Returns the same reference until the serialized value changes.\n *\n * Useful for object/array dependencies in hooks like useMemo, useCallback, useEffect\n * to prevent unnecessary re-renders when the value is structurally the same.\n *\n * @example\n * ```tsx\n * const stableParams = useStableValue(routeParams);\n * const href = useMemo(() => {\n *   return router.buildUrl(routeName, stableParams);\n * }, [router, routeName, stableParams]);\n * ```\n *\n * @param value - The value to stabilize\n * @returns A stable reference to the value\n */\nexport function useStableValue<T>(value: T): T {\n  const serialized = JSON.stringify(value);\n\n  // We intentionally use serialized in deps to detect deep changes\n  // eslint-disable-next-line react-hooks/exhaustive-deps\n  return useMemo(() => value, [serialized]);\n}\n","import { createActiveRouteSource } from \"@real-router/sources\";\nimport { useMemo, useSyncExternalStore } from \"react\";\n\nimport { useRouter } from \"./useRouter\";\nimport { useStableValue } from \"./useStableValue\";\n\nimport type { Params } from \"@real-router/core\";\n\nexport function useIsActiveRoute(\n  routeName: string,\n  params?: Params,\n  strict = false,\n  ignoreQueryParams = true,\n): boolean {\n  const router = useRouter();\n\n  // useStableValue: JSON.stringify memoization of params object.\n  // Without it, every render with a new params reference (e.g.,\n  // <Link routeParams={{ id: '123' }} />) would recreate the store.\n  const stableParams = useStableValue(params);\n\n  const store = useMemo(\n    () =>\n      createActiveRouteSource(router, routeName, stableParams, {\n        strict,\n        ignoreQueryParams,\n      }),\n    [router, routeName, stableParams, strict, ignoreQueryParams],\n  );\n\n  return useSyncExternalStore(\n    store.subscribe,\n    store.getSnapshot,\n    store.getSnapshot, // SSR: router returns same state on server and client\n  );\n}\n","import type { MouseEvent } from \"react\";\n\n/**\n * Check if navigation should be handled by router\n */\nexport function shouldNavigate(evt: MouseEvent): boolean {\n  return (\n    evt.button === 0 && // left click\n    !evt.metaKey &&\n    !evt.altKey &&\n    !evt.ctrlKey &&\n    !evt.shiftKey\n  );\n}\n","import { memo, useCallback, useMemo } from \"react\";\n\nimport { EMPTY_PARAMS, EMPTY_OPTIONS } from \"../constants\";\nimport { useIsActiveRoute } from \"../hooks/useIsActiveRoute\";\nimport { useRouter } from \"../hooks/useRouter\";\nimport { useStableValue } from \"../hooks/useStableValue\";\nimport { shouldNavigate } from \"../utils\";\n\nimport type { LinkProps } from \"../types\";\nimport type { FC, MouseEvent } from \"react\";\n\nfunction areLinkPropsEqual(\n  prev: Readonly<LinkProps>,\n  next: Readonly<LinkProps>,\n): boolean {\n  return (\n    prev.routeName === next.routeName &&\n    prev.className === next.className &&\n    prev.activeClassName === next.activeClassName &&\n    prev.activeStrict === next.activeStrict &&\n    prev.ignoreQueryParams === next.ignoreQueryParams &&\n    prev.onClick === next.onClick &&\n    prev.target === next.target &&\n    prev.style === next.style &&\n    prev.children === next.children &&\n    JSON.stringify(prev.routeParams) === JSON.stringify(next.routeParams) &&\n    JSON.stringify(prev.routeOptions) === JSON.stringify(next.routeOptions)\n  );\n}\n\nexport const Link: FC<LinkProps> = memo(\n  ({\n    routeName,\n    routeParams = EMPTY_PARAMS,\n    routeOptions = EMPTY_OPTIONS,\n    className,\n    activeClassName = \"active\",\n    activeStrict = false,\n    ignoreQueryParams = true,\n    onClick,\n    target,\n    children,\n    ...props\n  }) => {\n    const router = useRouter();\n\n    const stableParams = useStableValue(routeParams);\n    const stableOptions = useStableValue(routeOptions);\n\n    const isActive = useIsActiveRoute(\n      routeName,\n      stableParams,\n      activeStrict,\n      ignoreQueryParams,\n    );\n\n    const href = useMemo(() => {\n      if (typeof router.buildUrl === \"function\") {\n        return router.buildUrl(routeName, stableParams);\n      }\n\n      return router.buildPath(routeName, stableParams);\n    }, [router, routeName, stableParams]);\n\n    const handleClick = useCallback(\n      (evt: MouseEvent<HTMLAnchorElement>) => {\n        if (onClick) {\n          onClick(evt);\n\n          if (evt.defaultPrevented) {\n            return;\n          }\n        }\n\n        if (!shouldNavigate(evt) || target === \"_blank\") {\n          return;\n        }\n\n        evt.preventDefault();\n        router.navigate(routeName, stableParams, stableOptions).catch(() => {});\n      },\n      [onClick, target, router, routeName, stableParams, stableOptions],\n    );\n\n    const finalClassName = useMemo(() => {\n      if (isActive && activeClassName) {\n        return className\n          ? `${className} ${activeClassName}`.trim()\n          : activeClassName;\n      }\n\n      return className ?? undefined;\n    }, [isActive, className, activeClassName]);\n\n    return (\n      <a\n        {...props}\n        href={href}\n        className={finalClassName}\n        onClick={handleClick}\n      >\n        {children}\n      </a>\n    );\n  },\n  areLinkPropsEqual,\n);\n\nLink.displayName = \"Link\";\n","import { getNavigator } from \"@real-router/core\";\nimport { createRouteNodeSource } from \"@real-router/sources\";\nimport { useMemo, useSyncExternalStore } from \"react\";\n\nimport { useRouter } from \"./useRouter\";\n\nimport type { RouteContext } from \"../types\";\n\nexport function useRouteNode(nodeName: string): RouteContext {\n  const router = useRouter();\n\n  const store = useMemo(\n    () => createRouteNodeSource(router, nodeName),\n    [router, nodeName],\n  );\n\n  const { route, previousRoute } = useSyncExternalStore(\n    store.subscribe,\n    store.getSnapshot,\n    store.getSnapshot, // SSR: router returns same state on server and client\n  );\n\n  const navigator = useMemo(() => getNavigator(router), [router]);\n\n  return useMemo(\n    (): RouteContext => ({ navigator, route, previousRoute }),\n    [navigator, route, previousRoute],\n  );\n}\n","// packages/react/modules/hooks/useRoute.tsx\n\nimport { use } from \"react\";\n\nimport { RouteContext } from \"../context\";\n\nimport type { RouteContext as RouteContextType } from \"../types\";\n\nexport const useRoute = (): RouteContextType => {\n  const routeContext = use(RouteContext);\n\n  if (!routeContext) {\n    throw new Error(\"useRoute must be used within a RouteProvider\");\n  }\n\n  return routeContext;\n};\n","// packages/react/modules/hooks/useNavigator.tsx\n\nimport { use } from \"react\";\n\nimport { NavigatorContext } from \"../context\";\n\nimport type { Navigator } from \"@real-router/core\";\n\nexport const useNavigator = (): Navigator => {\n  const navigator = use(NavigatorContext);\n\n  if (!navigator) {\n    throw new Error(\"useNavigator must be used within a RouterProvider\");\n  }\n\n  return navigator;\n};\n","// packages/react/modules/hooks/useRouteUtils.tsx\n\nimport { getPluginApi } from \"@real-router/core\";\nimport { getRouteUtils } from \"@real-router/route-utils\";\n\nimport { useRouter } from \"./useRouter\";\n\nimport type { RouteUtils } from \"@real-router/route-utils\";\n\n/**\n * Returns a pre-computed {@link RouteUtils} instance for the current router.\n *\n * Internally retrieves the route tree via `getPluginApi` and delegates\n * to `getRouteUtils`, which caches instances per tree reference (WeakMap).\n *\n * @returns RouteUtils instance with pre-computed chains and siblings\n *\n * @example\n * ```tsx\n * const utils = useRouteUtils();\n *\n * utils.getChain(\"users.profile\");\n * // → [\"users\", \"users.profile\"]\n *\n * utils.getSiblings(\"users\");\n * // → [\"admin\"]\n *\n * utils.isDescendantOf(\"users.profile\", \"users\");\n * // → true\n * ```\n */\nexport const useRouteUtils = (): RouteUtils => {\n  const router = useRouter();\n\n  return getRouteUtils(getPluginApi(router).getTree());\n};\n","import { getNavigator } from \"@real-router/core\";\nimport { createRouteSource } from \"@real-router/sources\";\nimport { useMemo, useSyncExternalStore } from \"react\";\n\nimport { NavigatorContext, RouteContext, RouterContext } from \"./context\";\n\nimport type { Router } from \"@real-router/core\";\nimport type { FC, ReactNode } from \"react\";\n\nexport interface RouteProviderProps {\n  router: Router;\n  children: ReactNode;\n}\n\nexport const RouterProvider: FC<RouteProviderProps> = ({\n  router,\n  children,\n}) => {\n  const navigator = useMemo(() => getNavigator(router), [router]);\n\n  // useSyncExternalStore manages the router subscription lifecycle:\n  // subscribe connects to router on first listener, unsubscribes on last.\n  // This is Strict Mode safe — no useEffect cleanup needed.\n  const store = useMemo(() => createRouteSource(router), [router]);\n  const { route, previousRoute } = useSyncExternalStore(\n    store.subscribe,\n    store.getSnapshot,\n    store.getSnapshot, // SSR: router returns same state on server and client\n  );\n\n  const routeContextValue = useMemo(\n    () => ({ navigator, route, previousRoute }),\n    [navigator, route, previousRoute],\n  );\n\n  return (\n    <RouterContext value={router}>\n      <NavigatorContext value={navigator}>\n        <RouteContext value={routeContextValue}>{children}</RouteContext>\n      </NavigatorContext>\n    </RouterContext>\n  );\n};\n"]}

package/dist/cjs/legacy.d.ts

@@ -0,0 +1,4 @@
+export { Link, LinkProps, NavigatorContext, RouteContext, RouterContext, RouterProvider, useIsActiveRoute, useNavigator, useRoute, useRouteNode, useRouteUtils, useRouter } from './index.js';
+export { Navigator } from '@real-router/core';
+import 'react';
+import '@real-router/route-utils';

package/dist/cjs/legacy.js

@@ -0,0 +1 @@
+var e=require("react"),t=require("@real-router/sources"),r=require("react/jsx-runtime"),o=require("@real-router/core"),u=require("@real-router/route-utils"),s=Object.freeze({}),a=Object.freeze({}),i=e.createContext(null),n=e.createContext(null),c=e.createContext(null),l=()=>{const t=e.use(n);if(!t)throw new Error("useRouter must be used within a RouterProvider");return t};function m(t){const r=JSON.stringify(t);return e.useMemo(()=>t,[r])}function v(r,o,u=!1,s=!0){const a=l(),i=m(o),n=e.useMemo(()=>t.createActiveRouteSource(a,r,i,{strict:u,ignoreQueryParams:s}),[a,r,i,u,s]);return e.useSyncExternalStore(n.subscribe,n.getSnapshot,n.getSnapshot)}var g=e.memo(({routeName:t,routeParams:o=s,routeOptions:u=a,className:i,activeClassName:n="active",activeStrict:c=!1,ignoreQueryParams:g=!0,onClick:p,target:x,children:d,...h})=>{const N=l(),S=m(o),f=m(u),R=v(t,S,c,g),y=e.useMemo(()=>"function"==typeof N.buildUrl?N.buildUrl(t,S):N.buildPath(t,S),[N,t,S]),b=e.useCallback(e=>{p&&(p(e),e.defaultPrevented)||function(e){return!(0!==e.button||e.metaKey||e.altKey||e.ctrlKey||e.shiftKey)}(e)&&"_blank"!==x&&(e.preventDefault(),N.navigate(t,S,f).catch(()=>{}))},[p,x,N,t,S,f]),C=e.useMemo(()=>R&&n?i?`${i} ${n}`.trim():n:i??void 0,[R,i,n]);return r.jsx("a",{...h,href:y,className:C,onClick:b,children:d})},function(e,t){return e.routeName===t.routeName&&e.className===t.className&&e.activeClassName===t.activeClassName&&e.activeStrict===t.activeStrict&&e.ignoreQueryParams===t.ignoreQueryParams&&e.onClick===t.onClick&&e.target===t.target&&e.style===t.style&&e.children===t.children&&JSON.stringify(e.routeParams)===JSON.stringify(t.routeParams)&&JSON.stringify(e.routeOptions)===JSON.stringify(t.routeOptions)});g.displayName="Link",exports.Link=g,exports.NavigatorContext=c,exports.RouteContext=i,exports.RouterContext=n,exports.RouterProvider=({router:u,children:s})=>{const a=e.useMemo(()=>o.getNavigator(u),[u]),l=e.useMemo(()=>t.createRouteSource(u),[u]),{route:m,previousRoute:v}=e.useSyncExternalStore(l.subscribe,l.getSnapshot,l.getSnapshot),g=e.useMemo(()=>({navigator:a,route:m,previousRoute:v}),[a,m,v]);return r.jsx(n,{value:u,children:r.jsx(c,{value:a,children:r.jsx(i,{value:g,children:s})})})},exports.useIsActiveRoute=v,exports.useNavigator=()=>{const t=e.use(c);if(!t)throw new Error("useNavigator must be used within a RouterProvider");return t},exports.useRoute=()=>{const t=e.use(i);if(!t)throw new Error("useRoute must be used within a RouteProvider");return t},exports.useRouteNode=function(r){const u=l(),s=e.useMemo(()=>t.createRouteNodeSource(u,r),[u,r]),{route:a,previousRoute:i}=e.useSyncExternalStore(s.subscribe,s.getSnapshot,s.getSnapshot),n=e.useMemo(()=>o.getNavigator(u),[u]);return e.useMemo(()=>({navigator:n,route:a,previousRoute:i}),[n,a,i])},exports.useRouteUtils=()=>{const e=l();return u.getRouteUtils(o.getPluginApi(e).getTree())},exports.useRouter=l;//# sourceMappingURL=legacy.js.map

package/dist/cjs/legacy.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/constants.ts","../../src/context.ts","../../src/hooks/useRouter.tsx","../../src/hooks/useStableValue.tsx","../../src/hooks/useIsActiveRoute.tsx","../../src/utils.ts","../../src/components/Link.tsx","../../src/hooks/useRouteNode.tsx","../../src/hooks/useRoute.tsx","../../src/hooks/useNavigator.tsx","../../src/hooks/useRouteUtils.tsx","../../src/RouterProvider.tsx"],"names":["createContext","use","useMemo","createActiveRouteSource","useSyncExternalStore","memo","useCallback","jsx","createRouteNodeSource","getNavigator","getRouteUtils","getPluginApi","createRouteSource"],"mappings":"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","file":"legacy.js","sourcesContent":["// packages/react/modules/constants.ts\n\n/**\n * Stable empty object for default params\n */\nexport const EMPTY_PARAMS = Object.freeze({});\n\n/**\n * Stable empty options object\n */\nexport const EMPTY_OPTIONS = Object.freeze({});\n","// packages/react/modules/context.ts\n\nimport { createContext } from \"react\";\n\nimport type { RouteContext as RouteContextType } from \"./types\";\nimport type { Router, Navigator } from \"@real-router/core\";\n\nexport const RouteContext = createContext<RouteContextType | null>(null);\n\nexport const RouterContext = createContext<Router | null>(null);\n\nexport const NavigatorContext = createContext<Navigator | null>(null);\n","// packages/react/modules/hooks/useRouter.tsx\n\nimport { use } from \"react\";\n\nimport { RouterContext } from \"../context\";\n\nimport type { Router } from \"@real-router/core\";\n\nexport const useRouter = (): Router => {\n  const router = use(RouterContext);\n\n  if (!router) {\n    throw new Error(\"useRouter must be used within a RouterProvider\");\n  }\n\n  return router;\n};\n","// packages/react/modules/hooks/useStableValue.tsx\n\nimport { useMemo } from \"react\";\n\n/**\n * Stabilizes a value reference based on deep equality (via JSON serialization).\n * Returns the same reference until the serialized value changes.\n *\n * Useful for object/array dependencies in hooks like useMemo, useCallback, useEffect\n * to prevent unnecessary re-renders when the value is structurally the same.\n *\n * @example\n * ```tsx\n * const stableParams = useStableValue(routeParams);\n * const href = useMemo(() => {\n *   return router.buildUrl(routeName, stableParams);\n * }, [router, routeName, stableParams]);\n * ```\n *\n * @param value - The value to stabilize\n * @returns A stable reference to the value\n */\nexport function useStableValue<T>(value: T): T {\n  const serialized = JSON.stringify(value);\n\n  // We intentionally use serialized in deps to detect deep changes\n  // eslint-disable-next-line react-hooks/exhaustive-deps\n  return useMemo(() => value, [serialized]);\n}\n","import { createActiveRouteSource } from \"@real-router/sources\";\nimport { useMemo, useSyncExternalStore } from \"react\";\n\nimport { useRouter } from \"./useRouter\";\nimport { useStableValue } from \"./useStableValue\";\n\nimport type { Params } from \"@real-router/core\";\n\nexport function useIsActiveRoute(\n  routeName: string,\n  params?: Params,\n  strict = false,\n  ignoreQueryParams = true,\n): boolean {\n  const router = useRouter();\n\n  // useStableValue: JSON.stringify memoization of params object.\n  // Without it, every render with a new params reference (e.g.,\n  // <Link routeParams={{ id: '123' }} />) would recreate the store.\n  const stableParams = useStableValue(params);\n\n  const store = useMemo(\n    () =>\n      createActiveRouteSource(router, routeName, stableParams, {\n        strict,\n        ignoreQueryParams,\n      }),\n    [router, routeName, stableParams, strict, ignoreQueryParams],\n  );\n\n  return useSyncExternalStore(\n    store.subscribe,\n    store.getSnapshot,\n    store.getSnapshot, // SSR: router returns same state on server and client\n  );\n}\n","import type { MouseEvent } from \"react\";\n\n/**\n * Check if navigation should be handled by router\n */\nexport function shouldNavigate(evt: MouseEvent): boolean {\n  return (\n    evt.button === 0 && // left click\n    !evt.metaKey &&\n    !evt.altKey &&\n    !evt.ctrlKey &&\n    !evt.shiftKey\n  );\n}\n","import { memo, useCallback, useMemo } from \"react\";\n\nimport { EMPTY_PARAMS, EMPTY_OPTIONS } from \"../constants\";\nimport { useIsActiveRoute } from \"../hooks/useIsActiveRoute\";\nimport { useRouter } from \"../hooks/useRouter\";\nimport { useStableValue } from \"../hooks/useStableValue\";\nimport { shouldNavigate } from \"../utils\";\n\nimport type { LinkProps } from \"../types\";\nimport type { FC, MouseEvent } from \"react\";\n\nfunction areLinkPropsEqual(\n  prev: Readonly<LinkProps>,\n  next: Readonly<LinkProps>,\n): boolean {\n  return (\n    prev.routeName === next.routeName &&\n    prev.className === next.className &&\n    prev.activeClassName === next.activeClassName &&\n    prev.activeStrict === next.activeStrict &&\n    prev.ignoreQueryParams === next.ignoreQueryParams &&\n    prev.onClick === next.onClick &&\n    prev.target === next.target &&\n    prev.style === next.style &&\n    prev.children === next.children &&\n    JSON.stringify(prev.routeParams) === JSON.stringify(next.routeParams) &&\n    JSON.stringify(prev.routeOptions) === JSON.stringify(next.routeOptions)\n  );\n}\n\nexport const Link: FC<LinkProps> = memo(\n  ({\n    routeName,\n    routeParams = EMPTY_PARAMS,\n    routeOptions = EMPTY_OPTIONS,\n    className,\n    activeClassName = \"active\",\n    activeStrict = false,\n    ignoreQueryParams = true,\n    onClick,\n    target,\n    children,\n    ...props\n  }) => {\n    const router = useRouter();\n\n    const stableParams = useStableValue(routeParams);\n    const stableOptions = useStableValue(routeOptions);\n\n    const isActive = useIsActiveRoute(\n      routeName,\n      stableParams,\n      activeStrict,\n      ignoreQueryParams,\n    );\n\n    const href = useMemo(() => {\n      if (typeof router.buildUrl === \"function\") {\n        return router.buildUrl(routeName, stableParams);\n      }\n\n      return router.buildPath(routeName, stableParams);\n    }, [router, routeName, stableParams]);\n\n    const handleClick = useCallback(\n      (evt: MouseEvent<HTMLAnchorElement>) => {\n        if (onClick) {\n          onClick(evt);\n\n          if (evt.defaultPrevented) {\n            return;\n          }\n        }\n\n        if (!shouldNavigate(evt) || target === \"_blank\") {\n          return;\n        }\n\n        evt.preventDefault();\n        router.navigate(routeName, stableParams, stableOptions).catch(() => {});\n      },\n      [onClick, target, router, routeName, stableParams, stableOptions],\n    );\n\n    const finalClassName = useMemo(() => {\n      if (isActive && activeClassName) {\n        return className\n          ? `${className} ${activeClassName}`.trim()\n          : activeClassName;\n      }\n\n      return className ?? undefined;\n    }, [isActive, className, activeClassName]);\n\n    return (\n      <a\n        {...props}\n        href={href}\n        className={finalClassName}\n        onClick={handleClick}\n      >\n        {children}\n      </a>\n    );\n  },\n  areLinkPropsEqual,\n);\n\nLink.displayName = \"Link\";\n","import { getNavigator } from \"@real-router/core\";\nimport { createRouteNodeSource } from \"@real-router/sources\";\nimport { useMemo, useSyncExternalStore } from \"react\";\n\nimport { useRouter } from \"./useRouter\";\n\nimport type { RouteContext } from \"../types\";\n\nexport function useRouteNode(nodeName: string): RouteContext {\n  const router = useRouter();\n\n  const store = useMemo(\n    () => createRouteNodeSource(router, nodeName),\n    [router, nodeName],\n  );\n\n  const { route, previousRoute } = useSyncExternalStore(\n    store.subscribe,\n    store.getSnapshot,\n    store.getSnapshot, // SSR: router returns same state on server and client\n  );\n\n  const navigator = useMemo(() => getNavigator(router), [router]);\n\n  return useMemo(\n    (): RouteContext => ({ navigator, route, previousRoute }),\n    [navigator, route, previousRoute],\n  );\n}\n","// packages/react/modules/hooks/useRoute.tsx\n\nimport { use } from \"react\";\n\nimport { RouteContext } from \"../context\";\n\nimport type { RouteContext as RouteContextType } from \"../types\";\n\nexport const useRoute = (): RouteContextType => {\n  const routeContext = use(RouteContext);\n\n  if (!routeContext) {\n    throw new Error(\"useRoute must be used within a RouteProvider\");\n  }\n\n  return routeContext;\n};\n","// packages/react/modules/hooks/useNavigator.tsx\n\nimport { use } from \"react\";\n\nimport { NavigatorContext } from \"../context\";\n\nimport type { Navigator } from \"@real-router/core\";\n\nexport const useNavigator = (): Navigator => {\n  const navigator = use(NavigatorContext);\n\n  if (!navigator) {\n    throw new Error(\"useNavigator must be used within a RouterProvider\");\n  }\n\n  return navigator;\n};\n","// packages/react/modules/hooks/useRouteUtils.tsx\n\nimport { getPluginApi } from \"@real-router/core\";\nimport { getRouteUtils } from \"@real-router/route-utils\";\n\nimport { useRouter } from \"./useRouter\";\n\nimport type { RouteUtils } from \"@real-router/route-utils\";\n\n/**\n * Returns a pre-computed {@link RouteUtils} instance for the current router.\n *\n * Internally retrieves the route tree via `getPluginApi` and delegates\n * to `getRouteUtils`, which caches instances per tree reference (WeakMap).\n *\n * @returns RouteUtils instance with pre-computed chains and siblings\n *\n * @example\n * ```tsx\n * const utils = useRouteUtils();\n *\n * utils.getChain(\"users.profile\");\n * // → [\"users\", \"users.profile\"]\n *\n * utils.getSiblings(\"users\");\n * // → [\"admin\"]\n *\n * utils.isDescendantOf(\"users.profile\", \"users\");\n * // → true\n * ```\n */\nexport const useRouteUtils = (): RouteUtils => {\n  const router = useRouter();\n\n  return getRouteUtils(getPluginApi(router).getTree());\n};\n","import { getNavigator } from \"@real-router/core\";\nimport { createRouteSource } from \"@real-router/sources\";\nimport { useMemo, useSyncExternalStore } from \"react\";\n\nimport { NavigatorContext, RouteContext, RouterContext } from \"./context\";\n\nimport type { Router } from \"@real-router/core\";\nimport type { FC, ReactNode } from \"react\";\n\nexport interface RouteProviderProps {\n  router: Router;\n  children: ReactNode;\n}\n\nexport const RouterProvider: FC<RouteProviderProps> = ({\n  router,\n  children,\n}) => {\n  const navigator = useMemo(() => getNavigator(router), [router]);\n\n  // useSyncExternalStore manages the router subscription lifecycle:\n  // subscribe connects to router on first listener, unsubscribes on last.\n  // This is Strict Mode safe — no useEffect cleanup needed.\n  const store = useMemo(() => createRouteSource(router), [router]);\n  const { route, previousRoute } = useSyncExternalStore(\n    store.subscribe,\n    store.getSnapshot,\n    store.getSnapshot, // SSR: router returns same state on server and client\n  );\n\n  const routeContextValue = useMemo(\n    () => ({ navigator, route, previousRoute }),\n    [navigator, route, previousRoute],\n  );\n\n  return (\n    <RouterContext value={router}>\n      <NavigatorContext value={navigator}>\n        <RouteContext value={routeContextValue}>{children}</RouteContext>\n      </NavigatorContext>\n    </RouterContext>\n  );\n};\n"]}

package/dist/cjs/metafile-cjs.json

@@ -1 +1 @@
-{"inputs":{"../../node_modules/.pnpm/tsup@8.5.1_jiti@2.6.1_postcss@8.5.6_typescript@5.9.3/node_modules/tsup/assets/cjs_shims.js":{"bytes":569,"imports":[],"format":"esm"},"src/constants.ts":{"bytes":225,"imports":[{"path":"/home/runner/work/real-router/real-router/node_modules/.pnpm/tsup@8.5.1_jiti@2.6.1_postcss@8.5.6_typescript@5.9.3/node_modules/tsup/assets/cjs_shims.js","kind":"import-statement","external":true}],"format":"esm"},"src/context.ts":{"bytes":416,"imports":[{"path":"react","kind":"import-statement","external":true},{"path":"/home/runner/work/real-router/real-router/node_modules/.pnpm/tsup@8.5.1_jiti@2.6.1_postcss@8.5.6_typescript@5.9.3/node_modules/tsup/assets/cjs_shims.js","kind":"import-statement","external":true}],"format":"esm"},"src/hooks/useRouter.tsx":{"bytes":364,"imports":[{"path":"react","kind":"import-statement","external":true},{"path":"src/context.ts","kind":"import-statement","original":"../context"},{"path":"/home/runner/work/real-router/real-router/node_modules/.pnpm/tsup@8.5.1_jiti@2.6.1_postcss@8.5.6_typescript@5.9.3/node_modules/tsup/assets/cjs_shims.js","kind":"import-statement","external":true}],"format":"esm"},"src/hooks/useStableValue.tsx":{"bytes":976,"imports":[{"path":"react","kind":"import-statement","external":true},{"path":"/home/runner/work/real-router/real-router/node_modules/.pnpm/tsup@8.5.1_jiti@2.6.1_postcss@8.5.6_typescript@5.9.3/node_modules/tsup/assets/cjs_shims.js","kind":"import-statement","external":true}],"format":"esm"},"src/hooks/useIsActiveRoute.tsx":{"bytes":1060,"imports":[{"path":"@real-router/sources","kind":"import-statement","external":true},{"path":"react","kind":"import-statement","external":true},{"path":"src/hooks/useRouter.tsx","kind":"import-statement","original":"./useRouter"},{"path":"src/hooks/useStableValue.tsx","kind":"import-statement","original":"./useStableValue"},{"path":"/home/runner/work/real-router/real-router/node_modules/.pnpm/tsup@8.5.1_jiti@2.6.1_postcss@8.5.6_typescript@5.9.3/node_modules/tsup/assets/cjs_shims.js","kind":"import-statement","external":true}],"format":"esm"},"src/utils.ts":{"bytes":293,"imports":[{"path":"/home/runner/work/real-router/real-router/node_modules/.pnpm/tsup@8.5.1_jiti@2.6.1_postcss@8.5.6_typescript@5.9.3/node_modules/tsup/assets/cjs_shims.js","kind":"import-statement","external":true}],"format":"esm"},"src/components/BaseLink.tsx":{"bytes":4053,"imports":[{"path":"react","kind":"import-statement","external":true},{"path":"src/constants.ts","kind":"import-statement","original":"../constants"},{"path":"src/hooks/useIsActiveRoute.tsx","kind":"import-statement","original":"../hooks/useIsActiveRoute"},{"path":"src/hooks/useStableValue.tsx","kind":"import-statement","original":"../hooks/useStableValue"},{"path":"src/utils.ts","kind":"import-statement","original":"../utils"},{"path":"/home/runner/work/real-router/real-router/node_modules/.pnpm/tsup@8.5.1_jiti@2.6.1_postcss@8.5.6_typescript@5.9.3/node_modules/tsup/assets/cjs_shims.js","kind":"import-statement","external":true},{"path":"react/jsx-runtime","kind":"import-statement","external":true}],"format":"esm"},"src/components/Link.tsx":{"bytes":511,"imports":[{"path":"src/components/BaseLink.tsx","kind":"import-statement","original":"./BaseLink"},{"path":"src/hooks/useRouter.tsx","kind":"import-statement","original":"../hooks/useRouter"},{"path":"/home/runner/work/real-router/real-router/node_modules/.pnpm/tsup@8.5.1_jiti@2.6.1_postcss@8.5.6_typescript@5.9.3/node_modules/tsup/assets/cjs_shims.js","kind":"import-statement","external":true},{"path":"react/jsx-runtime","kind":"import-statement","external":true}],"format":"esm"},"src/hooks/useRoute.tsx":{"bytes":403,"imports":[{"path":"react","kind":"import-statement","external":true},{"path":"src/context.ts","kind":"import-statement","original":"../context"},{"path":"/home/runner/work/real-router/real-router/node_modules/.pnpm/tsup@8.5.1_jiti@2.6.1_postcss@8.5.6_typescript@5.9.3/node_modules/tsup/assets/cjs_shims.js","kind":"import-statement","external":true}],"format":"esm"},"src/components/ConnectedLink.tsx":{"bytes":631,"imports":[{"path":"src/components/BaseLink.tsx","kind":"import-statement","original":"./BaseLink"},{"path":"src/hooks/useRoute.tsx","kind":"import-statement","original":"../hooks/useRoute"},{"path":"src/hooks/useRouter.tsx","kind":"import-statement","original":"../hooks/useRouter"},{"path":"/home/runner/work/real-router/real-router/node_modules/.pnpm/tsup@8.5.1_jiti@2.6.1_postcss@8.5.6_typescript@5.9.3/node_modules/tsup/assets/cjs_shims.js","kind":"import-statement","external":true},{"path":"react/jsx-runtime","kind":"import-statement","external":true}],"format":"esm"},"src/hooks/useRouteNode.tsx":{"bytes":837,"imports":[{"path":"@real-router/core","kind":"import-statement","external":true},{"path":"@real-router/sources","kind":"import-statement","external":true},{"path":"react","kind":"import-statement","external":true},{"path":"src/hooks/useRouter.tsx","kind":"import-statement","original":"./useRouter"},{"path":"/home/runner/work/real-router/real-router/node_modules/.pnpm/tsup@8.5.1_jiti@2.6.1_postcss@8.5.6_typescript@5.9.3/node_modules/tsup/assets/cjs_shims.js","kind":"import-statement","external":true}],"format":"esm"},"src/hooks/useNavigator.tsx":{"bytes":394,"imports":[{"path":"react","kind":"import-statement","external":true},{"path":"src/context.ts","kind":"import-statement","original":"../context"},{"path":"/home/runner/work/real-router/real-router/node_modules/.pnpm/tsup@8.5.1_jiti@2.6.1_postcss@8.5.6_typescript@5.9.3/node_modules/tsup/assets/cjs_shims.js","kind":"import-statement","external":true}],"format":"esm"},"src/RouterProvider.tsx":{"bytes":1380,"imports":[{"path":"@real-router/core","kind":"import-statement","external":true},{"path":"@real-router/sources","kind":"import-statement","external":true},{"path":"react","kind":"import-statement","external":true},{"path":"src/context.ts","kind":"import-statement","original":"./context"},{"path":"/home/runner/work/real-router/real-router/node_modules/.pnpm/tsup@8.5.1_jiti@2.6.1_postcss@8.5.6_typescript@5.9.3/node_modules/tsup/assets/cjs_shims.js","kind":"import-statement","external":true},{"path":"react/jsx-runtime","kind":"import-statement","external":true}],"format":"esm"},"src/hooks/useRouteUtils.tsx":{"bytes":977,"imports":[{"path":"@real-router/core","kind":"import-statement","external":true},{"path":"@real-router/route-utils","kind":"import-statement","external":true},{"path":"src/hooks/useRouter.tsx","kind":"import-statement","original":"./useRouter"},{"path":"/home/runner/work/real-router/real-router/node_modules/.pnpm/tsup@8.5.1_jiti@2.6.1_postcss@8.5.6_typescript@5.9.3/node_modules/tsup/assets/cjs_shims.js","kind":"import-statement","external":true}],"format":"esm"},"src/index.ts":{"bytes":719,"imports":[{"path":"src/components/BaseLink.tsx","kind":"import-statement","original":"./components/BaseLink"},{"path":"src/components/Link.tsx","kind":"import-statement","original":"./components/Link"},{"path":"src/components/ConnectedLink.tsx","kind":"import-statement","original":"./components/ConnectedLink"},{"path":"src/hooks/useRouteNode.tsx","kind":"import-statement","original":"./hooks/useRouteNode"},{"path":"src/hooks/useRoute.tsx","kind":"import-statement","original":"./hooks/useRoute"},{"path":"src/hooks/useNavigator.tsx","kind":"import-statement","original":"./hooks/useNavigator"},{"path":"src/RouterProvider.tsx","kind":"import-statement","original":"./RouterProvider"},{"path":"src/context.ts","kind":"import-statement","original":"./context"},{"path":"src/hooks/useRouter.tsx","kind":"import-statement","original":"./hooks/useRouter"},{"path":"src/hooks/useRouteUtils.tsx","kind":"import-statement","original":"./hooks/useRouteUtils"},{"path":"/home/runner/work/real-router/real-router/node_modules/.pnpm/tsup@8.5.1_jiti@2.6.1_postcss@8.5.6_typescript@5.9.3/node_modules/tsup/assets/cjs_shims.js","kind":"import-statement","external":true}],"format":"esm"}},"outputs":{"dist/cjs/index.js.map":{"imports":[],"exports":[],"inputs":{},"bytes":18254},"dist/cjs/index.js":{"imports":[{"path":"react","kind":"import-statement","external":true},{"path":"@real-router/sources","kind":"import-statement","external":true},{"path":"react","kind":"import-statement","external":true},{"path":"react","kind":"import-statement","external":true},{"path":"react","kind":"import-statement","external":true},{"path":"react","kind":"import-statement","external":true},{"path":"react/jsx-runtime","kind":"import-statement","external":true},{"path":"react/jsx-runtime","kind":"import-statement","external":true},{"path":"react","kind":"import-statement","external":true},{"path":"react/jsx-runtime","kind":"import-statement","external":true},{"path":"@real-router/core","kind":"import-statement","external":true},{"path":"@real-router/sources","kind":"import-statement","external":true},{"path":"react","kind":"import-statement","external":true},{"path":"react","kind":"import-statement","external":true},{"path":"@real-router/core","kind":"import-statement","external":true},{"path":"@real-router/sources","kind":"import-statement","external":true},{"path":"react","kind":"import-statement","external":true},{"path":"react/jsx-runtime","kind":"import-statement","external":true},{"path":"@real-router/core","kind":"import-statement","external":true},{"path":"@real-router/route-utils","kind":"import-statement","external":true}],"exports":["BaseLink","ConnectedLink","Link","NavigatorContext","RouteContext","RouterContext","RouterProvider","useNavigator","useRoute","useRouteNode","useRouteUtils","useRouter"],"entryPoint":"src/index.ts","inputs":{"src/components/BaseLink.tsx":{"bytesInOutput":2607},"src/constants.ts":{"bytesInOutput":77},"src/hooks/useIsActiveRoute.tsx":{"bytesInOutput":671},"src/hooks/useRouter.tsx":{"bytesInOutput":202},"src/context.ts":{"bytesInOutput":164},"src/hooks/useStableValue.tsx":{"bytesInOutput":157},"src/utils.ts":{"bytesInOutput":140},"src/index.ts":{"bytesInOutput":0},"src/components/Link.tsx":{"bytesInOutput":243},"src/hooks/useRoute.tsx":{"bytesInOutput":225},"src/components/ConnectedLink.tsx":{"bytesInOutput":269},"src/hooks/useRouteNode.tsx":{"bytesInOutput":742},"src/hooks/useNavigator.tsx":{"bytesInOutput":229},"src/RouterProvider.tsx":{"bytesInOutput":1001},"src/hooks/useRouteUtils.tsx":{"bytesInOutput":225}},"bytes":7637}}}
+{"inputs":{"../../node_modules/.pnpm/tsup@8.5.1_jiti@2.6.1_postcss@8.5.6_typescript@5.9.3/node_modules/tsup/assets/cjs_shims.js":{"bytes":569,"imports":[],"format":"esm"},"src/constants.ts":{"bytes":225,"imports":[{"path":"/home/runner/work/real-router/real-router/node_modules/.pnpm/tsup@8.5.1_jiti@2.6.1_postcss@8.5.6_typescript@5.9.3/node_modules/tsup/assets/cjs_shims.js","kind":"import-statement","external":true}],"format":"esm"},"src/context.ts":{"bytes":416,"imports":[{"path":"react","kind":"import-statement","external":true},{"path":"/home/runner/work/real-router/real-router/node_modules/.pnpm/tsup@8.5.1_jiti@2.6.1_postcss@8.5.6_typescript@5.9.3/node_modules/tsup/assets/cjs_shims.js","kind":"import-statement","external":true}],"format":"esm"},"src/hooks/useRouter.tsx":{"bytes":364,"imports":[{"path":"react","kind":"import-statement","external":true},{"path":"src/context.ts","kind":"import-statement","original":"../context"},{"path":"/home/runner/work/real-router/real-router/node_modules/.pnpm/tsup@8.5.1_jiti@2.6.1_postcss@8.5.6_typescript@5.9.3/node_modules/tsup/assets/cjs_shims.js","kind":"import-statement","external":true}],"format":"esm"},"src/hooks/useStableValue.tsx":{"bytes":976,"imports":[{"path":"react","kind":"import-statement","external":true},{"path":"/home/runner/work/real-router/real-router/node_modules/.pnpm/tsup@8.5.1_jiti@2.6.1_postcss@8.5.6_typescript@5.9.3/node_modules/tsup/assets/cjs_shims.js","kind":"import-statement","external":true}],"format":"esm"},"src/hooks/useIsActiveRoute.tsx":{"bytes":1060,"imports":[{"path":"@real-router/sources","kind":"import-statement","external":true},{"path":"react","kind":"import-statement","external":true},{"path":"src/hooks/useRouter.tsx","kind":"import-statement","original":"./useRouter"},{"path":"src/hooks/useStableValue.tsx","kind":"import-statement","original":"./useStableValue"},{"path":"/home/runner/work/real-router/real-router/node_modules/.pnpm/tsup@8.5.1_jiti@2.6.1_postcss@8.5.6_typescript@5.9.3/node_modules/tsup/assets/cjs_shims.js","kind":"import-statement","external":true}],"format":"esm"},"src/utils.ts":{"bytes":293,"imports":[{"path":"/home/runner/work/real-router/real-router/node_modules/.pnpm/tsup@8.5.1_jiti@2.6.1_postcss@8.5.6_typescript@5.9.3/node_modules/tsup/assets/cjs_shims.js","kind":"import-statement","external":true}],"format":"esm"},"src/components/Link.tsx":{"bytes":2900,"imports":[{"path":"react","kind":"import-statement","external":true},{"path":"src/constants.ts","kind":"import-statement","original":"../constants"},{"path":"src/hooks/useIsActiveRoute.tsx","kind":"import-statement","original":"../hooks/useIsActiveRoute"},{"path":"src/hooks/useRouter.tsx","kind":"import-statement","original":"../hooks/useRouter"},{"path":"src/hooks/useStableValue.tsx","kind":"import-statement","original":"../hooks/useStableValue"},{"path":"src/utils.ts","kind":"import-statement","original":"../utils"},{"path":"/home/runner/work/real-router/real-router/node_modules/.pnpm/tsup@8.5.1_jiti@2.6.1_postcss@8.5.6_typescript@5.9.3/node_modules/tsup/assets/cjs_shims.js","kind":"import-statement","external":true},{"path":"react/jsx-runtime","kind":"import-statement","external":true}],"format":"esm"},"src/hooks/useRouteNode.tsx":{"bytes":837,"imports":[{"path":"@real-router/core","kind":"import-statement","external":true},{"path":"@real-router/sources","kind":"import-statement","external":true},{"path":"react","kind":"import-statement","external":true},{"path":"src/hooks/useRouter.tsx","kind":"import-statement","original":"./useRouter"},{"path":"/home/runner/work/real-router/real-router/node_modules/.pnpm/tsup@8.5.1_jiti@2.6.1_postcss@8.5.6_typescript@5.9.3/node_modules/tsup/assets/cjs_shims.js","kind":"import-statement","external":true}],"format":"esm"},"src/hooks/useRoute.tsx":{"bytes":403,"imports":[{"path":"react","kind":"import-statement","external":true},{"path":"src/context.ts","kind":"import-statement","original":"../context"},{"path":"/home/runner/work/real-router/real-router/node_modules/.pnpm/tsup@8.5.1_jiti@2.6.1_postcss@8.5.6_typescript@5.9.3/node_modules/tsup/assets/cjs_shims.js","kind":"import-statement","external":true}],"format":"esm"},"src/hooks/useNavigator.tsx":{"bytes":394,"imports":[{"path":"react","kind":"import-statement","external":true},{"path":"src/context.ts","kind":"import-statement","original":"../context"},{"path":"/home/runner/work/real-router/real-router/node_modules/.pnpm/tsup@8.5.1_jiti@2.6.1_postcss@8.5.6_typescript@5.9.3/node_modules/tsup/assets/cjs_shims.js","kind":"import-statement","external":true}],"format":"esm"},"src/hooks/useRouteUtils.tsx":{"bytes":977,"imports":[{"path":"@real-router/core","kind":"import-statement","external":true},{"path":"@real-router/route-utils","kind":"import-statement","external":true},{"path":"src/hooks/useRouter.tsx","kind":"import-statement","original":"./useRouter"},{"path":"/home/runner/work/real-router/real-router/node_modules/.pnpm/tsup@8.5.1_jiti@2.6.1_postcss@8.5.6_typescript@5.9.3/node_modules/tsup/assets/cjs_shims.js","kind":"import-statement","external":true}],"format":"esm"},"src/RouterProvider.tsx":{"bytes":1380,"imports":[{"path":"@real-router/core","kind":"import-statement","external":true},{"path":"@real-router/sources","kind":"import-statement","external":true},{"path":"react","kind":"import-statement","external":true},{"path":"src/context.ts","kind":"import-statement","original":"./context"},{"path":"/home/runner/work/real-router/real-router/node_modules/.pnpm/tsup@8.5.1_jiti@2.6.1_postcss@8.5.6_typescript@5.9.3/node_modules/tsup/assets/cjs_shims.js","kind":"import-statement","external":true},{"path":"react/jsx-runtime","kind":"import-statement","external":true}],"format":"esm"},"src/index.ts":{"bytes":666,"imports":[{"path":"src/components/Link.tsx","kind":"import-statement","original":"./components/Link"},{"path":"src/hooks/useRouteNode.tsx","kind":"import-statement","original":"./hooks/useRouteNode"},{"path":"src/hooks/useRoute.tsx","kind":"import-statement","original":"./hooks/useRoute"},{"path":"src/hooks/useNavigator.tsx","kind":"import-statement","original":"./hooks/useNavigator"},{"path":"src/hooks/useRouter.tsx","kind":"import-statement","original":"./hooks/useRouter"},{"path":"src/hooks/useRouteUtils.tsx","kind":"import-statement","original":"./hooks/useRouteUtils"},{"path":"src/hooks/useIsActiveRoute.tsx","kind":"import-statement","original":"./hooks/useIsActiveRoute"},{"path":"src/RouterProvider.tsx","kind":"import-statement","original":"./RouterProvider"},{"path":"src/context.ts","kind":"import-statement","original":"./context"},{"path":"/home/runner/work/real-router/real-router/node_modules/.pnpm/tsup@8.5.1_jiti@2.6.1_postcss@8.5.6_typescript@5.9.3/node_modules/tsup/assets/cjs_shims.js","kind":"import-statement","external":true}],"format":"esm"},"src/legacy.ts":{"bytes":666,"imports":[{"path":"src/components/Link.tsx","kind":"import-statement","original":"./components/Link"},{"path":"src/hooks/useRouteNode.tsx","kind":"import-statement","original":"./hooks/useRouteNode"},{"path":"src/hooks/useRoute.tsx","kind":"import-statement","original":"./hooks/useRoute"},{"path":"src/hooks/useNavigator.tsx","kind":"import-statement","original":"./hooks/useNavigator"},{"path":"src/hooks/useRouter.tsx","kind":"import-statement","original":"./hooks/useRouter"},{"path":"src/hooks/useRouteUtils.tsx","kind":"import-statement","original":"./hooks/useRouteUtils"},{"path":"src/hooks/useIsActiveRoute.tsx","kind":"import-statement","original":"./hooks/useIsActiveRoute"},{"path":"src/RouterProvider.tsx","kind":"import-statement","original":"./RouterProvider"},{"path":"src/context.ts","kind":"import-statement","original":"./context"},{"path":"/home/runner/work/real-router/real-router/node_modules/.pnpm/tsup@8.5.1_jiti@2.6.1_postcss@8.5.6_typescript@5.9.3/node_modules/tsup/assets/cjs_shims.js","kind":"import-statement","external":true}],"format":"esm"}},"outputs":{"dist/cjs/index.js.map":{"imports":[],"exports":[],"inputs":{},"bytes":15376},"dist/cjs/index.js":{"imports":[{"path":"react","kind":"import-statement","external":true},{"path":"@real-router/sources","kind":"import-statement","external":true},{"path":"react","kind":"import-statement","external":true},{"path":"react","kind":"import-statement","external":true},{"path":"react","kind":"import-statement","external":true},{"path":"react","kind":"import-statement","external":true},{"path":"react/jsx-runtime","kind":"import-statement","external":true},{"path":"@real-router/core","kind":"import-statement","external":true},{"path":"@real-router/sources","kind":"import-statement","external":true},{"path":"react","kind":"import-statement","external":true},{"path":"react","kind":"import-statement","external":true},{"path":"react","kind":"import-statement","external":true},{"path":"@real-router/core","kind":"import-statement","external":true},{"path":"@real-router/route-utils","kind":"import-statement","external":true},{"path":"@real-router/core","kind":"import-statement","external":true},{"path":"@real-router/sources","kind":"import-statement","external":true},{"path":"react","kind":"import-statement","external":true},{"path":"react/jsx-runtime","kind":"import-statement","external":true}],"exports":["Link","NavigatorContext","RouteContext","RouterContext","RouterProvider","useIsActiveRoute","useNavigator","useRoute","useRouteNode","useRouteUtils","useRouter"],"entryPoint":"src/index.ts","inputs":{"src/components/Link.tsx":{"bytesInOutput":2409},"src/constants.ts":{"bytesInOutput":77},"src/hooks/useIsActiveRoute.tsx":{"bytesInOutput":671},"src/hooks/useRouter.tsx":{"bytesInOutput":202},"src/context.ts":{"bytesInOutput":164},"src/hooks/useStableValue.tsx":{"bytesInOutput":157},"src/utils.ts":{"bytesInOutput":140},"src/index.ts":{"bytesInOutput":0},"src/hooks/useRouteNode.tsx":{"bytesInOutput":742},"src/hooks/useRoute.tsx":{"bytesInOutput":225},"src/hooks/useNavigator.tsx":{"bytesInOutput":229},"src/hooks/useRouteUtils.tsx":{"bytesInOutput":225},"src/RouterProvider.tsx":{"bytesInOutput":1001}},"bytes":6845},"dist/cjs/legacy.js.map":{"imports":[],"exports":[],"inputs":{},"bytes":15376},"dist/cjs/legacy.js":{"imports":[{"path":"react","kind":"import-statement","external":true},{"path":"@real-router/sources","kind":"import-statement","external":true},{"path":"react","kind":"import-statement","external":true},{"path":"react","kind":"import-statement","external":true},{"path":"react","kind":"import-statement","external":true},{"path":"react","kind":"import-statement","external":true},{"path":"react/jsx-runtime","kind":"import-statement","external":true},{"path":"@real-router/core","kind":"import-statement","external":true},{"path":"@real-router/sources","kind":"import-statement","external":true},{"path":"react","kind":"import-statement","external":true},{"path":"react","kind":"import-statement","external":true},{"path":"react","kind":"import-statement","external":true},{"path":"@real-router/core","kind":"import-statement","external":true},{"path":"@real-router/route-utils","kind":"import-statement","external":true},{"path":"@real-router/core","kind":"import-statement","external":true},{"path":"@real-router/sources","kind":"import-statement","external":true},{"path":"react","kind":"import-statement","external":true},{"path":"react/jsx-runtime","kind":"import-statement","external":true}],"exports":["Link","NavigatorContext","RouteContext","RouterContext","RouterProvider","useIsActiveRoute","useNavigator","useRoute","useRouteNode","useRouteUtils","useRouter"],"entryPoint":"src/legacy.ts","inputs":{"src/components/Link.tsx":{"bytesInOutput":2409},"src/constants.ts":{"bytesInOutput":77},"src/hooks/useIsActiveRoute.tsx":{"bytesInOutput":671},"src/hooks/useRouter.tsx":{"bytesInOutput":202},"src/context.ts":{"bytesInOutput":164},"src/hooks/useStableValue.tsx":{"bytesInOutput":157},"src/utils.ts":{"bytesInOutput":140},"src/legacy.ts":{"bytesInOutput":0},"src/hooks/useRouteNode.tsx":{"bytesInOutput":742},"src/hooks/useRoute.tsx":{"bytesInOutput":225},"src/hooks/useNavigator.tsx":{"bytesInOutput":229},"src/hooks/useRouteUtils.tsx":{"bytesInOutput":225},"src/RouterProvider.tsx":{"bytesInOutput":1001}},"bytes":6845}}}

package/dist/esm/chunk-GKE5JASO.mjs

@@ -0,0 +1 @@
+import{createContext as e,memo as r,useMemo as t,useCallback as o,use as i,useSyncExternalStore as n}from"react";import{createActiveRouteSource as a,createRouteNodeSource as u,createRouteSource as s}from"@real-router/sources";import{jsx as c}from"react/jsx-runtime";import{getNavigator as l,getPluginApi as m}from"@real-router/core";import{getRouteUtils as v}from"@real-router/route-utils";var f=e(null),h=e(null),g=e(null),p=()=>{const e=i(h);if(!e)throw new Error("useRouter must be used within a RouterProvider");return e};function d(e){const r=JSON.stringify(e);return t(()=>e,[r])}function y(e,r,o=!1,i=!0){const u=p(),s=d(r),c=t(()=>a(u,e,s,{strict:o,ignoreQueryParams:i}),[u,e,s,o,i]);return n(c.subscribe,c.getSnapshot,c.getSnapshot)}var N=Object.freeze({}),b=Object.freeze({}),S=r(({routeName:e,routeParams:r=N,routeOptions:i=b,className:n,activeClassName:a="active",activeStrict:u=!1,ignoreQueryParams:s=!0,onClick:l,target:m,children:v,...f})=>{const h=p(),g=d(r),S=d(i),P=y(e,g,u,s),O=t(()=>"function"==typeof h.buildUrl?h.buildUrl(e,g):h.buildPath(e,g),[h,e,g]),w=o(r=>{l&&(l(r),r.defaultPrevented)||function(e){return!(0!==e.button||e.metaKey||e.altKey||e.ctrlKey||e.shiftKey)}(r)&&"_blank"!==m&&(r.preventDefault(),h.navigate(e,g,S).catch(()=>{}))},[l,m,h,e,g,S]),R=t(()=>P&&a?n?`${n} ${a}`.trim():a:n??void 0,[P,n,a]);return c("a",{...f,href:O,className:R,onClick:w,children:v})},function(e,r){return e.routeName===r.routeName&&e.className===r.className&&e.activeClassName===r.activeClassName&&e.activeStrict===r.activeStrict&&e.ignoreQueryParams===r.ignoreQueryParams&&e.onClick===r.onClick&&e.target===r.target&&e.style===r.style&&e.children===r.children&&JSON.stringify(e.routeParams)===JSON.stringify(r.routeParams)&&JSON.stringify(e.routeOptions)===JSON.stringify(r.routeOptions)});function P(e){const r=p(),o=t(()=>u(r,e),[r,e]),{route:i,previousRoute:a}=n(o.subscribe,o.getSnapshot,o.getSnapshot),s=t(()=>l(r),[r]);return t(()=>({navigator:s,route:i,previousRoute:a}),[s,i,a])}S.displayName="Link";var O=()=>{const e=i(f);if(!e)throw new Error("useRoute must be used within a RouteProvider");return e},w=()=>{const e=i(g);if(!e)throw new Error("useNavigator must be used within a RouterProvider");return e},R=()=>{const e=p();return v(m(e).getTree())},C=({router:e,children:r})=>{const o=t(()=>l(e),[e]),i=t(()=>s(e),[e]),{route:a,previousRoute:u}=n(i.subscribe,i.getSnapshot,i.getSnapshot),m=t(()=>({navigator:o,route:a,previousRoute:u}),[o,a,u]);return c(h,{value:e,children:c(g,{value:o,children:c(f,{value:m,children:r})})})};export{S as Link,g as NavigatorContext,f as RouteContext,h as RouterContext,C as RouterProvider,y as useIsActiveRoute,w as useNavigator,O as useRoute,P as useRouteNode,R as useRouteUtils,p as useRouter};//# sourceMappingURL=chunk-GKE5JASO.mjs.map

package/dist/esm/chunk-GKE5JASO.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/context.ts","../../src/hooks/useRouter.tsx","../../src/hooks/useStableValue.tsx","../../src/hooks/useIsActiveRoute.tsx","../../src/constants.ts","../../src/utils.ts","../../src/components/Link.tsx","../../src/hooks/useRouteNode.tsx","../../src/hooks/useRoute.tsx","../../src/hooks/useNavigator.tsx","../../src/hooks/useRouteUtils.tsx","../../src/RouterProvider.tsx"],"names":["useMemo","useSyncExternalStore","use","getNavigator","jsx"],"mappings":"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","file":"chunk-GKE5JASO.mjs","sourcesContent":["// packages/react/modules/context.ts\n\nimport { createContext } from \"react\";\n\nimport type { RouteContext as RouteContextType } from \"./types\";\nimport type { Router, Navigator } from \"@real-router/core\";\n\nexport const RouteContext = createContext<RouteContextType | null>(null);\n\nexport const RouterContext = createContext<Router | null>(null);\n\nexport const NavigatorContext = createContext<Navigator | null>(null);\n","// packages/react/modules/hooks/useRouter.tsx\n\nimport { use } from \"react\";\n\nimport { RouterContext } from \"../context\";\n\nimport type { Router } from \"@real-router/core\";\n\nexport const useRouter = (): Router => {\n  const router = use(RouterContext);\n\n  if (!router) {\n    throw new Error(\"useRouter must be used within a RouterProvider\");\n  }\n\n  return router;\n};\n","// packages/react/modules/hooks/useStableValue.tsx\n\nimport { useMemo } from \"react\";\n\n/**\n * Stabilizes a value reference based on deep equality (via JSON serialization).\n * Returns the same reference until the serialized value changes.\n *\n * Useful for object/array dependencies in hooks like useMemo, useCallback, useEffect\n * to prevent unnecessary re-renders when the value is structurally the same.\n *\n * @example\n * ```tsx\n * const stableParams = useStableValue(routeParams);\n * const href = useMemo(() => {\n *   return router.buildUrl(routeName, stableParams);\n * }, [router, routeName, stableParams]);\n * ```\n *\n * @param value - The value to stabilize\n * @returns A stable reference to the value\n */\nexport function useStableValue<T>(value: T): T {\n  const serialized = JSON.stringify(value);\n\n  // We intentionally use serialized in deps to detect deep changes\n  // eslint-disable-next-line react-hooks/exhaustive-deps\n  return useMemo(() => value, [serialized]);\n}\n","import { createActiveRouteSource } from \"@real-router/sources\";\nimport { useMemo, useSyncExternalStore } from \"react\";\n\nimport { useRouter } from \"./useRouter\";\nimport { useStableValue } from \"./useStableValue\";\n\nimport type { Params } from \"@real-router/core\";\n\nexport function useIsActiveRoute(\n  routeName: string,\n  params?: Params,\n  strict = false,\n  ignoreQueryParams = true,\n): boolean {\n  const router = useRouter();\n\n  // useStableValue: JSON.stringify memoization of params object.\n  // Without it, every render with a new params reference (e.g.,\n  // <Link routeParams={{ id: '123' }} />) would recreate the store.\n  const stableParams = useStableValue(params);\n\n  const store = useMemo(\n    () =>\n      createActiveRouteSource(router, routeName, stableParams, {\n        strict,\n        ignoreQueryParams,\n      }),\n    [router, routeName, stableParams, strict, ignoreQueryParams],\n  );\n\n  return useSyncExternalStore(\n    store.subscribe,\n    store.getSnapshot,\n    store.getSnapshot, // SSR: router returns same state on server and client\n  );\n}\n","// packages/react/modules/constants.ts\n\n/**\n * Stable empty object for default params\n */\nexport const EMPTY_PARAMS = Object.freeze({});\n\n/**\n * Stable empty options object\n */\nexport const EMPTY_OPTIONS = Object.freeze({});\n","import type { MouseEvent } from \"react\";\n\n/**\n * Check if navigation should be handled by router\n */\nexport function shouldNavigate(evt: MouseEvent): boolean {\n  return (\n    evt.button === 0 && // left click\n    !evt.metaKey &&\n    !evt.altKey &&\n    !evt.ctrlKey &&\n    !evt.shiftKey\n  );\n}\n","import { memo, useCallback, useMemo } from \"react\";\n\nimport { EMPTY_PARAMS, EMPTY_OPTIONS } from \"../constants\";\nimport { useIsActiveRoute } from \"../hooks/useIsActiveRoute\";\nimport { useRouter } from \"../hooks/useRouter\";\nimport { useStableValue } from \"../hooks/useStableValue\";\nimport { shouldNavigate } from \"../utils\";\n\nimport type { LinkProps } from \"../types\";\nimport type { FC, MouseEvent } from \"react\";\n\nfunction areLinkPropsEqual(\n  prev: Readonly<LinkProps>,\n  next: Readonly<LinkProps>,\n): boolean {\n  return (\n    prev.routeName === next.routeName &&\n    prev.className === next.className &&\n    prev.activeClassName === next.activeClassName &&\n    prev.activeStrict === next.activeStrict &&\n    prev.ignoreQueryParams === next.ignoreQueryParams &&\n    prev.onClick === next.onClick &&\n    prev.target === next.target &&\n    prev.style === next.style &&\n    prev.children === next.children &&\n    JSON.stringify(prev.routeParams) === JSON.stringify(next.routeParams) &&\n    JSON.stringify(prev.routeOptions) === JSON.stringify(next.routeOptions)\n  );\n}\n\nexport const Link: FC<LinkProps> = memo(\n  ({\n    routeName,\n    routeParams = EMPTY_PARAMS,\n    routeOptions = EMPTY_OPTIONS,\n    className,\n    activeClassName = \"active\",\n    activeStrict = false,\n    ignoreQueryParams = true,\n    onClick,\n    target,\n    children,\n    ...props\n  }) => {\n    const router = useRouter();\n\n    const stableParams = useStableValue(routeParams);\n    const stableOptions = useStableValue(routeOptions);\n\n    const isActive = useIsActiveRoute(\n      routeName,\n      stableParams,\n      activeStrict,\n      ignoreQueryParams,\n    );\n\n    const href = useMemo(() => {\n      if (typeof router.buildUrl === \"function\") {\n        return router.buildUrl(routeName, stableParams);\n      }\n\n      return router.buildPath(routeName, stableParams);\n    }, [router, routeName, stableParams]);\n\n    const handleClick = useCallback(\n      (evt: MouseEvent<HTMLAnchorElement>) => {\n        if (onClick) {\n          onClick(evt);\n\n          if (evt.defaultPrevented) {\n            return;\n          }\n        }\n\n        if (!shouldNavigate(evt) || target === \"_blank\") {\n          return;\n        }\n\n        evt.preventDefault();\n        router.navigate(routeName, stableParams, stableOptions).catch(() => {});\n      },\n      [onClick, target, router, routeName, stableParams, stableOptions],\n    );\n\n    const finalClassName = useMemo(() => {\n      if (isActive && activeClassName) {\n        return className\n          ? `${className} ${activeClassName}`.trim()\n          : activeClassName;\n      }\n\n      return className ?? undefined;\n    }, [isActive, className, activeClassName]);\n\n    return (\n      <a\n        {...props}\n        href={href}\n        className={finalClassName}\n        onClick={handleClick}\n      >\n        {children}\n      </a>\n    );\n  },\n  areLinkPropsEqual,\n);\n\nLink.displayName = \"Link\";\n","import { getNavigator } from \"@real-router/core\";\nimport { createRouteNodeSource } from \"@real-router/sources\";\nimport { useMemo, useSyncExternalStore } from \"react\";\n\nimport { useRouter } from \"./useRouter\";\n\nimport type { RouteContext } from \"../types\";\n\nexport function useRouteNode(nodeName: string): RouteContext {\n  const router = useRouter();\n\n  const store = useMemo(\n    () => createRouteNodeSource(router, nodeName),\n    [router, nodeName],\n  );\n\n  const { route, previousRoute } = useSyncExternalStore(\n    store.subscribe,\n    store.getSnapshot,\n    store.getSnapshot, // SSR: router returns same state on server and client\n  );\n\n  const navigator = useMemo(() => getNavigator(router), [router]);\n\n  return useMemo(\n    (): RouteContext => ({ navigator, route, previousRoute }),\n    [navigator, route, previousRoute],\n  );\n}\n","// packages/react/modules/hooks/useRoute.tsx\n\nimport { use } from \"react\";\n\nimport { RouteContext } from \"../context\";\n\nimport type { RouteContext as RouteContextType } from \"../types\";\n\nexport const useRoute = (): RouteContextType => {\n  const routeContext = use(RouteContext);\n\n  if (!routeContext) {\n    throw new Error(\"useRoute must be used within a RouteProvider\");\n  }\n\n  return routeContext;\n};\n","// packages/react/modules/hooks/useNavigator.tsx\n\nimport { use } from \"react\";\n\nimport { NavigatorContext } from \"../context\";\n\nimport type { Navigator } from \"@real-router/core\";\n\nexport const useNavigator = (): Navigator => {\n  const navigator = use(NavigatorContext);\n\n  if (!navigator) {\n    throw new Error(\"useNavigator must be used within a RouterProvider\");\n  }\n\n  return navigator;\n};\n","// packages/react/modules/hooks/useRouteUtils.tsx\n\nimport { getPluginApi } from \"@real-router/core\";\nimport { getRouteUtils } from \"@real-router/route-utils\";\n\nimport { useRouter } from \"./useRouter\";\n\nimport type { RouteUtils } from \"@real-router/route-utils\";\n\n/**\n * Returns a pre-computed {@link RouteUtils} instance for the current router.\n *\n * Internally retrieves the route tree via `getPluginApi` and delegates\n * to `getRouteUtils`, which caches instances per tree reference (WeakMap).\n *\n * @returns RouteUtils instance with pre-computed chains and siblings\n *\n * @example\n * ```tsx\n * const utils = useRouteUtils();\n *\n * utils.getChain(\"users.profile\");\n * // → [\"users\", \"users.profile\"]\n *\n * utils.getSiblings(\"users\");\n * // → [\"admin\"]\n *\n * utils.isDescendantOf(\"users.profile\", \"users\");\n * // → true\n * ```\n */\nexport const useRouteUtils = (): RouteUtils => {\n  const router = useRouter();\n\n  return getRouteUtils(getPluginApi(router).getTree());\n};\n","import { getNavigator } from \"@real-router/core\";\nimport { createRouteSource } from \"@real-router/sources\";\nimport { useMemo, useSyncExternalStore } from \"react\";\n\nimport { NavigatorContext, RouteContext, RouterContext } from \"./context\";\n\nimport type { Router } from \"@real-router/core\";\nimport type { FC, ReactNode } from \"react\";\n\nexport interface RouteProviderProps {\n  router: Router;\n  children: ReactNode;\n}\n\nexport const RouterProvider: FC<RouteProviderProps> = ({\n  router,\n  children,\n}) => {\n  const navigator = useMemo(() => getNavigator(router), [router]);\n\n  // useSyncExternalStore manages the router subscription lifecycle:\n  // subscribe connects to router on first listener, unsubscribes on last.\n  // This is Strict Mode safe — no useEffect cleanup needed.\n  const store = useMemo(() => createRouteSource(router), [router]);\n  const { route, previousRoute } = useSyncExternalStore(\n    store.subscribe,\n    store.getSnapshot,\n    store.getSnapshot, // SSR: router returns same state on server and client\n  );\n\n  const routeContextValue = useMemo(\n    () => ({ navigator, route, previousRoute }),\n    [navigator, route, previousRoute],\n  );\n\n  return (\n    <RouterContext value={router}>\n      <NavigatorContext value={navigator}>\n        <RouteContext value={routeContextValue}>{children}</RouteContext>\n      </NavigatorContext>\n    </RouterContext>\n  );\n};\n"]}

package/dist/esm/index.d.mts

@@ -1,7 +1,7 @@
-import { Router, Params, State, Navigator, NavigationOptions } from '@real-router/core';
+import { Params, NavigationOptions, Navigator, State, Router } from '@real-router/core';
 export { Navigator } from '@real-router/core';
 import * as react from 'react';
-import { MouseEvent, ReactNode, FC, HTMLAttributes, MouseEventHandler } from 'react';
+import { HTMLAttributes, MouseEventHandler, FC, ReactNode } from 'react';
 import { RouteUtils } from '@real-router/route-utils';
 
 interface RouteState<P extends Params = Params, MP extends Params = Params> {
@@ -11,39 +11,10 @@ interface RouteState<P extends Params = Params, MP extends Params = Params> {
 type RouteContext$1 = {
     navigator: Navigator;
 } & RouteState;
-interface BaseLinkProps$1 {
-    [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;
-}
-
-/**
- * Optimized BaseLink component with memoization and performance improvements
- */
-declare const BaseLink: FC<BaseLinkProps$1>;
-
-interface BaseLinkProps<P extends Params = Params, MP extends Params = Params> extends HTMLAttributes<HTMLAnchorElement> {
-    router: Router;
+interface LinkProps<P extends Params = Params> extends HTMLAttributes<HTMLAnchorElement> {
     routeName: string;
-    route?: State<P, MP> | undefined;
-    previousRoute?: State | undefined;
     routeParams?: P;
     routeOptions?: NavigationOptions;
-    className?: string;
     activeClassName?: string;
     activeStrict?: boolean;
     ignoreQueryParams?: boolean;
@@ -52,9 +23,7 @@ interface BaseLinkProps<P extends Params = Params, MP extends Params = Params> e
     onMouseOver?: MouseEventHandler<HTMLAnchorElement>;
 }
 
-declare const Link: FC<Omit<BaseLinkProps, "router">>;
-
-declare const ConnectedLink: FC<Omit<BaseLinkProps, "router" | "route" | "previousRoute">>;
+declare const Link: FC<LinkProps>;
 
 declare function useRouteNode(nodeName: string): RouteContext$1;
 
@@ -62,16 +31,6 @@ declare const useRoute: () => RouteContext$1;
 
 declare const useNavigator: () => Navigator;
 
-interface RouteProviderProps {
-    router: Router;
-    children: ReactNode;
-}
-declare const RouterProvider: FC<RouteProviderProps>;
-
-declare const RouteContext: react.Context<RouteContext$1 | null>;
-declare const RouterContext: react.Context<Router<object> | null>;
-declare const NavigatorContext: react.Context<Navigator | null>;
-
 declare const useRouter: () => Router;
 
 /**
@@ -98,4 +57,16 @@ declare const useRouter: () => Router;
  */
 declare const useRouteUtils: () => RouteUtils;
 
-export { BaseLink, type BaseLinkProps$1 as BaseLinkProps, ConnectedLink, Link, NavigatorContext, RouteContext, RouterContext, RouterProvider, useNavigator, useRoute, useRouteNode, useRouteUtils, useRouter };
+declare function useIsActiveRoute(routeName: string, params?: Params, strict?: boolean, ignoreQueryParams?: boolean): boolean;
+
+interface RouteProviderProps {
+    router: Router;
+    children: ReactNode;
+}
+declare const RouterProvider: FC<RouteProviderProps>;
+
+declare const RouteContext: react.Context<RouteContext$1 | null>;
+declare const RouterContext: react.Context<Router<object> | null>;
+declare const NavigatorContext: react.Context<Navigator | null>;
+
+export { Link, type LinkProps, NavigatorContext, RouteContext, RouterContext, RouterProvider, useIsActiveRoute, useNavigator, useRoute, useRouteNode, useRouteUtils, useRouter };

package/dist/esm/index.mjs

@@ -1 +1 @@
-import{createContext as r,memo as e,useMemo as t,useCallback as o,useSyncExternalStore as u,use as i}from"react";import{createActiveRouteSource as a,createRouteNodeSource as n,createRouteSource as s}from"@real-router/sources";import{jsx as c}from"react/jsx-runtime";import{getNavigator as l,getPluginApi as m}from"@real-router/core";import{getRouteUtils as v}from"@real-router/route-utils";var p=Object.freeze({}),f=Object.freeze({}),h=r(null),d=r(null),g=r(null),N=()=>{const r=i(d);if(!r)throw new Error("useRouter must be used within a RouterProvider");return r};function b(r){const e=JSON.stringify(r);return t(()=>r,[e])}var y=e(({routeName:r,routeParams:e=p,routeOptions:i=f,className:n,activeClassName:s="active",activeStrict:l=!1,ignoreQueryParams:m=!0,onClick:v,target:h,router:d,children:g,...y})=>{const S=b(e),O=b(i),P=function(r,e,o=!1,i=!0){const n=N(),s=b(e),c=t(()=>a(n,r,s,{strict:o,ignoreQueryParams:i}),[n,r,s,o,i]);return u(c.subscribe,c.getSnapshot,c.getSnapshot)}(r,S,l,m),R=t(()=>"function"==typeof d.buildUrl?d.buildUrl(r,S):d.buildPath(r,S),[d,r,S]),w=o(e=>{v&&(v(e),e.defaultPrevented)||function(r){return!(0!==r.button||r.metaKey||r.altKey||r.ctrlKey||r.shiftKey)}(e)&&"_blank"!==h&&(e.preventDefault(),d.navigate(r,S,O).catch(()=>{}))},[v,h,d,r,S,O]),C=t(()=>P&&s?n?`${n} ${s}`.trim():s:n??void 0,[P,n,s]),{previousRoute:k,...J}=y;return c("a",{...J,href:R,className:C,onClick:w,"data-route":r,"data-active":P,children:g})},(r,e)=>r.router===e.router&&r.routeName===e.routeName&&JSON.stringify(r.routeParams)===JSON.stringify(e.routeParams)&&JSON.stringify(r.routeOptions)===JSON.stringify(e.routeOptions)&&r.className===e.className&&r.activeClassName===e.activeClassName&&r.activeStrict===e.activeStrict&&r.ignoreQueryParams===e.ignoreQueryParams&&r.onClick===e.onClick&&r.target===e.target&&r.children===e.children);y.displayName="BaseLink";var S=r=>{const e=N(),{route:t,previousRoute:o,routeOptions:u,...i}=r;return c(y,{router:e,...i})},O=()=>{const r=i(h);if(!r)throw new Error("useRoute must be used within a RouteProvider");return r},P=r=>{const e=N(),{route:t}=O(),{routeOptions:o,...u}=r;return c(y,{router:e,route:t,...u})};function R(r){const e=N(),o=t(()=>n(e,r),[e,r]),{route:i,previousRoute:a}=u(o.subscribe,o.getSnapshot,o.getSnapshot),s=t(()=>l(e),[e]);return t(()=>({navigator:s,route:i,previousRoute:a}),[s,i,a])}var w=()=>{const r=i(g);if(!r)throw new Error("useNavigator must be used within a RouterProvider");return r},C=({router:r,children:e})=>{const o=t(()=>l(r),[r]),i=t(()=>s(r),[r]),{route:a,previousRoute:n}=u(i.subscribe,i.getSnapshot,i.getSnapshot),m=t(()=>({navigator:o,route:a,previousRoute:n}),[o,a,n]);return c(d,{value:r,children:c(g,{value:o,children:c(h,{value:m,children:e})})})},k=()=>{const r=N();return v(m(r).getTree())};export{y as BaseLink,P as ConnectedLink,S as Link,g as NavigatorContext,h as RouteContext,d as RouterContext,C as RouterProvider,w as useNavigator,O as useRoute,R as useRouteNode,k as useRouteUtils,N as useRouter};//# sourceMappingURL=index.mjs.map
+export{Link,NavigatorContext,RouteContext,RouterContext,RouterProvider,useIsActiveRoute,useNavigator,useRoute,useRouteNode,useRouteUtils,useRouter}from"./chunk-GKE5JASO.mjs";//# sourceMappingURL=index.mjs.map

package/dist/esm/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/constants.ts","../../src/context.ts","../../src/hooks/useRouter.tsx","../../src/hooks/useStableValue.tsx","../../src/hooks/useIsActiveRoute.tsx","../../src/utils.ts","../../src/components/BaseLink.tsx","../../src/components/Link.tsx","../../src/hooks/useRoute.tsx","../../src/components/ConnectedLink.tsx","../../src/hooks/useRouteNode.tsx","../../src/hooks/useNavigator.tsx","../../src/RouterProvider.tsx","../../src/hooks/useRouteUtils.tsx"],"names":["useMemo","jsx","use","useSyncExternalStore","getNavigator"],"mappings":";;;AAKO,IAAM,YAAA,GAAe,MAAA,CAAO,MAAA,CAAO,EAAE,CAAA;AAKrC,IAAM,aAAA,GAAgB,MAAA,CAAO,MAAA,CAAO,EAAE,CAAA;ACHtC,IAAM,YAAA,GAAe,cAAuC,IAAI;AAEhE,IAAM,aAAA,GAAgB,cAA6B,IAAI;AAEvD,IAAM,gBAAA,GAAmB,cAAgC,IAAI;;;ACH7D,IAAM,YAAY,MAAc;AACrC,EAAA,MAAM,MAAA,GAAS,IAAI,aAAa,CAAA;AAEhC,EAAA,IAAI,CAAC,MAAA,EAAQ;AACX,IAAA,MAAM,IAAI,MAAM,gDAAgD,CAAA;AAAA,EAClE;AAEA,EAAA,OAAO,MAAA;AACT;ACMO,SAAS,eAAkB,KAAA,EAAa;AAC7C,EAAA,MAAM,UAAA,GAAa,IAAA,CAAK,SAAA,CAAU,KAAK,CAAA;AAIvC,EAAA,OAAO,OAAA,CAAQ,MAAM,KAAA,EAAO,CAAC,UAAU,CAAC,CAAA;AAC1C;;;ACpBO,SAAS,iBACd,SAAA,EACA,MAAA,EACA,MAAA,GAAS,KAAA,EACT,oBAAoB,IAAA,EACX;AACT,EAAA,MAAM,SAAS,SAAA,EAAU;AAKzB,EAAA,MAAM,YAAA,GAAe,eAAe,MAAM,CAAA;AAE1C,EAAA,MAAM,KAAA,GAAQA,OAAAA;AAAA,IACZ,MACE,uBAAA,CAAwB,MAAA,EAAQ,SAAA,EAAW,YAAA,EAAc;AAAA,MACvD,MAAA;AAAA,MACA;AAAA,KACD,CAAA;AAAA,IACH,CAAC,MAAA,EAAQ,SAAA,EAAW,YAAA,EAAc,QAAQ,iBAAiB;AAAA,GAC7D;AAEA,EAAA,OAAO,oBAAA;AAAA,IACL,KAAA,CAAM,SAAA;AAAA,IACN,KAAA,CAAM,WAAA;AAAA,IACN,KAAA,CAAM;AAAA;AAAA,GACR;AACF;;;AC9BO,SAAS,eAAe,GAAA,EAA0B;AACvD,EAAA,OACE,IAAI,MAAA,KAAW,CAAA;AAAA,EACf,CAAC,GAAA,CAAI,OAAA,IACL,CAAC,GAAA,CAAI,UACL,CAAC,GAAA,CAAI,OAAA,IACL,CAAC,GAAA,CAAI,QAAA;AAET;ACEO,IAAM,QAAA,GAA8B,IAAA;AAAA,EACzC,CAAC;AAAA,IACC,SAAA;AAAA,IACA,WAAA,GAAc,YAAA;AAAA,IACd,YAAA,GAAe,aAAA;AAAA,IACf,SAAA;AAAA,IACA,eAAA,GAAkB,QAAA;AAAA,IAClB,YAAA,GAAe,KAAA;AAAA,IACf,iBAAA,GAAoB,IAAA;AAAA,IACpB,OAAA;AAAA,IACA,MAAA;AAAA,IACA,MAAA;AAAA,IACA,QAAA;AAAA,IACA,GAAG;AAAA,GACL,KAAM;AAEJ,IAAA,MAAM,YAAA,GAAe,eAAe,WAAW,CAAA;AAC/C,IAAA,MAAM,aAAA,GAAgB,eAAe,YAAY,CAAA;AAGjD,IAAA,MAAM,QAAA,GAAW,gBAAA;AAAA,MACf,SAAA;AAAA,MACA,YAAA;AAAA,MACA,YAAA;AAAA,MACA;AAAA,KACF;AAGA,IAAA,MAAM,IAAA,GAAOA,QAAQ,MAAM;AAGzB,MAAA,IAAI,OAAO,MAAA,CAAO,QAAA,KAAa,UAAA,EAAY;AACzC,QAAA,OAAO,MAAA,CAAO,QAAA,CAAS,SAAA,EAAW,YAAY,CAAA;AAAA,MAChD;AAEA,MAAA,OAAO,MAAA,CAAO,SAAA,CAAU,SAAA,EAAW,YAAY,CAAA;AAAA,IACjD,CAAA,EAAG,CAAC,MAAA,EAAQ,SAAA,EAAW,YAAY,CAAC,CAAA;AAGpC,IAAA,MAAM,WAAA,GAAc,WAAA;AAAA,MAClB,CAAC,GAAA,KAAuC;AAEtC,QAAA,IAAI,OAAA,EAAS;AACX,UAAA,OAAA,CAAQ,GAAG,CAAA;AAEX,UAAA,IAAI,IAAI,gBAAA,EAAkB;AACxB,YAAA;AAAA,UACF;AAAA,QACF;AAGA,QAAA,IAAI,CAAC,cAAA,CAAe,GAAG,CAAA,IAAK,WAAW,QAAA,EAAU;AAC/C,UAAA;AAAA,QACF;AAGA,QAAA,GAAA,CAAI,cAAA,EAAe;AAGnB,QAAA,MAAA,CAAO,SAAS,SAAA,EAAW,YAAA,EAAc,aAAa,CAAA,CAAE,MAAM,MAAM;AAAA,QAAC,CAAC,CAAA;AAAA,MACxE,CAAA;AAAA,MACA,CAAC,OAAA,EAAS,MAAA,EAAQ,MAAA,EAAQ,SAAA,EAAW,cAAc,aAAa;AAAA,KAClE;AAGA,IAAA,MAAM,cAAA,GAAiBA,QAAQ,MAAM;AACnC,MAAA,IAAI,YAAY,eAAA,EAAiB;AAC/B,QAAA,OAAO,YACH,CAAA,EAAG,SAAS,IAAI,eAAe,CAAA,CAAA,CAAG,MAAK,GACvC,eAAA;AAAA,MACN;AAEA,MAAA,OAAO,SAAA,IAAa,MAAA;AAAA,IACtB,CAAA,EAAG,CAAC,QAAA,EAAU,SAAA,EAAW,eAAe,CAAC,CAAA;AAIzC,IAAA,MAAM,EAAE,aAAA,EAAe,GAAG,SAAA,EAAU,GAAI,KAAA;AAExC,IAAA,uBACE,GAAA;AAAA,MAAC,GAAA;AAAA,MAAA;AAAA,QACE,GAAG,SAAA;AAAA,QACJ,IAAA;AAAA,QACA,SAAA,EAAW,cAAA;AAAA,QACX,OAAA,EAAS,WAAA;AAAA,QACT,YAAA,EAAY,SAAA;AAAA,QACZ,aAAA,EAAa,QAAA;AAAA,QAEZ;AAAA;AAAA,KACH;AAAA,EAEJ,CAAA;AAAA,EACA,CAAC,WAAW,SAAA,KAAc;AAGxB,IAAA,OACE,SAAA,CAAU,MAAA,KAAW,SAAA,CAAU,MAAA,IAC/B,SAAA,CAAU,cAAc,SAAA,CAAU,SAAA,IAClC,IAAA,CAAK,SAAA,CAAU,SAAA,CAAU,WAAW,MAClC,IAAA,CAAK,SAAA,CAAU,SAAA,CAAU,WAAW,CAAA,IACtC,IAAA,CAAK,SAAA,CAAU,SAAA,CAAU,YAAY,CAAA,KACnC,IAAA,CAAK,SAAA,CAAU,SAAA,CAAU,YAAY,KACvC,SAAA,CAAU,SAAA,KAAc,SAAA,CAAU,SAAA,IAClC,SAAA,CAAU,eAAA,KAAoB,UAAU,eAAA,IACxC,SAAA,CAAU,YAAA,KAAiB,SAAA,CAAU,YAAA,IACrC,SAAA,CAAU,sBAAsB,SAAA,CAAU,iBAAA,IAC1C,SAAA,CAAU,OAAA,KAAY,SAAA,CAAU,OAAA,IAChC,SAAA,CAAU,MAAA,KAAW,SAAA,CAAU,MAAA,IAC/B,SAAA,CAAU,QAAA,KAAa,SAAA,CAAU,QAAA;AAAA,EAErC;AACF;AAEA,QAAA,CAAS,WAAA,GAAc,UAAA;ACxHhB,IAAM,IAAA,GAA0C,CAAC,KAAA,KAAU;AAChE,EAAA,MAAM,SAAS,SAAA,EAAU;AAGzB,EAAA,MAAM,EAAE,KAAA,EAAO,aAAA,EAAe,YAAA,EAAc,GAAG,WAAU,GAAI,KAAA;AAE7D,EAAA,uBAAOC,GAAAA,CAAC,QAAA,EAAA,EAAS,MAAA,EAAiB,GAAG,SAAA,EAAW,CAAA;AAClD;ACPO,IAAM,WAAW,MAAwB;AAC9C,EAAA,MAAM,YAAA,GAAeC,IAAI,YAAY,CAAA;AAErC,EAAA,IAAI,CAAC,YAAA,EAAc;AACjB,IAAA,MAAM,IAAI,MAAM,8CAA8C,CAAA;AAAA,EAChE;AAEA,EAAA,OAAO,YAAA;AACT;ACPO,IAAM,aAAA,GAET,CAAC,KAAA,KAAU;AACb,EAAA,MAAM,SAAS,SAAA,EAAU;AACzB,EAAA,MAAM,EAAE,KAAA,EAAM,GAAI,QAAA,EAAS;AAG3B,EAAA,MAAM,EAAE,YAAA,EAAc,GAAG,SAAA,EAAU,GAAI,KAAA;AAEvC,EAAA,uBAAOD,GAAAA,CAAC,QAAA,EAAA,EAAS,MAAA,EAAgB,KAAA,EAAe,GAAG,SAAA,EAAW,CAAA;AAChE;ACXO,SAAS,aAAa,QAAA,EAAgC;AAC3D,EAAA,MAAM,SAAS,SAAA,EAAU;AAEzB,EAAA,MAAM,KAAA,GAAQD,OAAAA;AAAA,IACZ,MAAM,qBAAA,CAAsB,MAAA,EAAQ,QAAQ,CAAA;AAAA,IAC5C,CAAC,QAAQ,QAAQ;AAAA,GACnB;AAEA,EAAA,MAAM,EAAE,KAAA,EAAO,aAAA,EAAc,GAAIG,oBAAAA;AAAA,IAC/B,KAAA,CAAM,SAAA;AAAA,IACN,KAAA,CAAM,WAAA;AAAA,IACN,KAAA,CAAM;AAAA;AAAA,GACR;AAEA,EAAA,MAAM,SAAA,GAAYH,QAAQ,MAAM,YAAA,CAAa,MAAM,CAAA,EAAG,CAAC,MAAM,CAAC,CAAA;AAE9D,EAAA,OAAOA,OAAAA;AAAA,IACL,OAAqB,EAAE,SAAA,EAAW,KAAA,EAAO,aAAA,EAAc,CAAA;AAAA,IACvD,CAAC,SAAA,EAAW,KAAA,EAAO,aAAa;AAAA,GAClC;AACF;ACpBO,IAAM,eAAe,MAAiB;AAC3C,EAAA,MAAM,SAAA,GAAYE,IAAI,gBAAgB,CAAA;AAEtC,EAAA,IAAI,CAAC,SAAA,EAAW;AACd,IAAA,MAAM,IAAI,MAAM,mDAAmD,CAAA;AAAA,EACrE;AAEA,EAAA,OAAO,SAAA;AACT;ACFO,IAAM,iBAAyC,CAAC;AAAA,EACrD,MAAA;AAAA,EACA;AACF,CAAA,KAAM;AACJ,EAAA,MAAM,SAAA,GAAYF,QAAQ,MAAMI,YAAAA,CAAa,MAAM,CAAA,EAAG,CAAC,MAAM,CAAC,CAAA;AAK9D,EAAA,MAAM,KAAA,GAAQJ,QAAQ,MAAM,iBAAA,CAAkB,MAAM,CAAA,EAAG,CAAC,MAAM,CAAC,CAAA;AAC/D,EAAA,MAAM,EAAE,KAAA,EAAO,aAAA,EAAc,GAAIG,oBAAAA;AAAA,IAC/B,KAAA,CAAM,SAAA;AAAA,IACN,KAAA,CAAM,WAAA;AAAA,IACN,KAAA,CAAM;AAAA;AAAA,GACR;AAEA,EAAA,MAAM,iBAAA,GAAoBH,OAAAA;AAAA,IACxB,OAAO,EAAE,SAAA,EAAW,KAAA,EAAO,aAAA,EAAc,CAAA;AAAA,IACzC,CAAC,SAAA,EAAW,KAAA,EAAO,aAAa;AAAA,GAClC;AAEA,EAAA,uBACEC,GAAAA,CAAC,aAAA,EAAA,EAAc,KAAA,EAAO,MAAA,EACpB,0BAAAA,GAAAA,CAAC,gBAAA,EAAA,EAAiB,KAAA,EAAO,SAAA,EACvB,0BAAAA,GAAAA,CAAC,YAAA,EAAA,EAAa,OAAO,iBAAA,EAAoB,QAAA,EAAS,GACpD,CAAA,EACF,CAAA;AAEJ;ACXO,IAAM,gBAAgB,MAAkB;AAC7C,EAAA,MAAM,SAAS,SAAA,EAAU;AAEzB,EAAA,OAAO,aAAA,CAAc,YAAA,CAAa,MAAM,CAAA,CAAE,SAAS,CAAA;AACrD","file":"index.mjs","sourcesContent":["// packages/react/modules/constants.ts\n\n/**\n * Stable empty object for default params\n */\nexport const EMPTY_PARAMS = Object.freeze({});\n\n/**\n * Stable empty options object\n */\nexport const EMPTY_OPTIONS = Object.freeze({});\n","// packages/react/modules/context.ts\n\nimport { createContext } from \"react\";\n\nimport type { RouteContext as RouteContextType } from \"./types\";\nimport type { Router, Navigator } from \"@real-router/core\";\n\nexport const RouteContext = createContext<RouteContextType | null>(null);\n\nexport const RouterContext = createContext<Router | null>(null);\n\nexport const NavigatorContext = createContext<Navigator | null>(null);\n","// packages/react/modules/hooks/useRouter.tsx\n\nimport { use } from \"react\";\n\nimport { RouterContext } from \"../context\";\n\nimport type { Router } from \"@real-router/core\";\n\nexport const useRouter = (): Router => {\n  const router = use(RouterContext);\n\n  if (!router) {\n    throw new Error(\"useRouter must be used within a RouterProvider\");\n  }\n\n  return router;\n};\n","// packages/react/modules/hooks/useStableValue.tsx\n\nimport { useMemo } from \"react\";\n\n/**\n * Stabilizes a value reference based on deep equality (via JSON serialization).\n * Returns the same reference until the serialized value changes.\n *\n * Useful for object/array dependencies in hooks like useMemo, useCallback, useEffect\n * to prevent unnecessary re-renders when the value is structurally the same.\n *\n * @example\n * ```tsx\n * const stableParams = useStableValue(routeParams);\n * const href = useMemo(() => {\n *   return router.buildUrl(routeName, stableParams);\n * }, [router, routeName, stableParams]);\n * ```\n *\n * @param value - The value to stabilize\n * @returns A stable reference to the value\n */\nexport function useStableValue<T>(value: T): T {\n  const serialized = JSON.stringify(value);\n\n  // We intentionally use serialized in deps to detect deep changes\n  // eslint-disable-next-line react-hooks/exhaustive-deps\n  return useMemo(() => value, [serialized]);\n}\n","import { createActiveRouteSource } from \"@real-router/sources\";\nimport { useMemo, useSyncExternalStore } from \"react\";\n\nimport { useRouter } from \"./useRouter\";\nimport { useStableValue } from \"./useStableValue\";\n\nimport type { Params } from \"@real-router/core\";\n\nexport function useIsActiveRoute(\n  routeName: string,\n  params?: Params,\n  strict = false,\n  ignoreQueryParams = true,\n): boolean {\n  const router = useRouter();\n\n  // useStableValue: JSON.stringify memoization of params object.\n  // Without it, every render with a new params reference (e.g.,\n  // <Link routeParams={{ id: '123' }} />) would recreate the store.\n  const stableParams = useStableValue(params);\n\n  const store = useMemo(\n    () =>\n      createActiveRouteSource(router, routeName, stableParams, {\n        strict,\n        ignoreQueryParams,\n      }),\n    [router, routeName, stableParams, strict, ignoreQueryParams],\n  );\n\n  return useSyncExternalStore(\n    store.subscribe,\n    store.getSnapshot,\n    store.getSnapshot, // SSR: router returns same state on server and client\n  );\n}\n","import type { MouseEvent } from \"react\";\n\n/**\n * Check if navigation should be handled by router\n */\nexport function shouldNavigate(evt: MouseEvent): boolean {\n  return (\n    evt.button === 0 && // left click\n    !evt.metaKey &&\n    !evt.altKey &&\n    !evt.ctrlKey &&\n    !evt.shiftKey\n  );\n}\n","// packages/react/modules/components/BaseLink.tsx\n\nimport { memo, useCallback, useMemo } from \"react\";\n\nimport { EMPTY_PARAMS, EMPTY_OPTIONS } from \"../constants\";\nimport { useIsActiveRoute } from \"../hooks/useIsActiveRoute\";\nimport { useStableValue } from \"../hooks/useStableValue\";\nimport { shouldNavigate } from \"../utils\";\n\nimport type { BaseLinkProps } from \"../types\";\nimport type { FC, MouseEvent } from \"react\";\n\n/**\n * Optimized BaseLink component with memoization and performance improvements\n */\nexport const BaseLink: FC<BaseLinkProps> = memo(\n  ({\n    routeName,\n    routeParams = EMPTY_PARAMS,\n    routeOptions = EMPTY_OPTIONS,\n    className,\n    activeClassName = \"active\",\n    activeStrict = false,\n    ignoreQueryParams = true,\n    onClick,\n    target,\n    router,\n    children,\n    ...props\n  }) => {\n    // Stabilize object references to prevent unnecessary re-renders\n    const stableParams = useStableValue(routeParams);\n    const stableOptions = useStableValue(routeOptions);\n\n    // Use optimized hook for active state checking\n    const isActive = useIsActiveRoute(\n      routeName,\n      stableParams,\n      activeStrict,\n      ignoreQueryParams,\n    );\n\n    // Build URL with memoization\n    const href = useMemo(() => {\n      // Use buildUrl if available (browser plugin installed)\n      // Otherwise fall back to buildPath (e.g., in SSR or without browser plugin)\n      if (typeof router.buildUrl === \"function\") {\n        return router.buildUrl(routeName, stableParams);\n      }\n\n      return router.buildPath(routeName, stableParams);\n    }, [router, routeName, stableParams]);\n\n    // Optimized click handler\n    const handleClick = useCallback(\n      (evt: MouseEvent<HTMLAnchorElement>) => {\n        // Call custom onClick if provided\n        if (onClick) {\n          onClick(evt);\n          // Respect preventDefault from custom handler\n          if (evt.defaultPrevented) {\n            return;\n          }\n        }\n\n        // Check if we should handle navigation\n        if (!shouldNavigate(evt) || target === \"_blank\") {\n          return;\n        }\n\n        // Prevent default link behavior\n        evt.preventDefault();\n\n        // Perform navigation (fire-and-forget)\n        router.navigate(routeName, stableParams, stableOptions).catch(() => {});\n      },\n      [onClick, target, router, routeName, stableParams, stableOptions],\n    );\n\n    // Build className efficiently\n    const finalClassName = useMemo(() => {\n      if (isActive && activeClassName) {\n        return className\n          ? `${className} ${activeClassName}`.trim()\n          : activeClassName;\n      }\n\n      return className ?? undefined;\n    }, [isActive, className, activeClassName]);\n\n    // Filter out previousRoute from props\n    // eslint-disable-next-line @typescript-eslint/no-unused-vars\n    const { previousRoute, ...restProps } = props;\n\n    return (\n      <a\n        {...restProps}\n        href={href}\n        className={finalClassName}\n        onClick={handleClick}\n        data-route={routeName} // For event delegation if needed\n        data-active={isActive} // For CSS selectors if needed\n      >\n        {children}\n      </a>\n    );\n  },\n  (prevProps, nextProps) => {\n    // Custom comparison for better memoization\n    // Check if props that affect rendering have changed\n    return (\n      prevProps.router === nextProps.router &&\n      prevProps.routeName === nextProps.routeName &&\n      JSON.stringify(prevProps.routeParams) ===\n        JSON.stringify(nextProps.routeParams) &&\n      JSON.stringify(prevProps.routeOptions) ===\n        JSON.stringify(nextProps.routeOptions) &&\n      prevProps.className === nextProps.className &&\n      prevProps.activeClassName === nextProps.activeClassName &&\n      prevProps.activeStrict === nextProps.activeStrict &&\n      prevProps.ignoreQueryParams === nextProps.ignoreQueryParams &&\n      prevProps.onClick === nextProps.onClick &&\n      prevProps.target === nextProps.target &&\n      prevProps.children === nextProps.children\n    );\n  },\n);\n\nBaseLink.displayName = \"BaseLink\";\n","// packages/react/modules/components/Link.tsx\n\nimport { BaseLink } from \"./BaseLink\";\nimport { useRouter } from \"../hooks/useRouter\";\n\nimport type { BaseLinkProps } from \"./interfaces\";\nimport type { FC } from \"react\";\n\nexport const Link: FC<Omit<BaseLinkProps, \"router\">> = (props) => {\n  const router = useRouter();\n\n  // eslint-disable-next-line @typescript-eslint/no-unused-vars\n  const { route, previousRoute, routeOptions, ...linkProps } = props;\n\n  return <BaseLink router={router} {...linkProps} />;\n};\n","// packages/react/modules/hooks/useRoute.tsx\n\nimport { use } from \"react\";\n\nimport { RouteContext } from \"../context\";\n\nimport type { RouteContext as RouteContextType } from \"../types\";\n\nexport const useRoute = (): RouteContextType => {\n  const routeContext = use(RouteContext);\n\n  if (!routeContext) {\n    throw new Error(\"useRoute must be used within a RouteProvider\");\n  }\n\n  return routeContext;\n};\n","// packages/react/modules/components/ConnectedLink.tsx\n\nimport { BaseLink } from \"./BaseLink\";\nimport { useRoute } from \"../hooks/useRoute\";\nimport { useRouter } from \"../hooks/useRouter\";\n\nimport type { BaseLinkProps } from \"./interfaces\";\nimport type { FC } from \"react\";\n\nexport const ConnectedLink: FC<\n  Omit<BaseLinkProps, \"router\" | \"route\" | \"previousRoute\">\n> = (props) => {\n  const router = useRouter();\n  const { route } = useRoute();\n\n  // eslint-disable-next-line @typescript-eslint/no-unused-vars\n  const { routeOptions, ...linkProps } = props;\n\n  return <BaseLink router={router} route={route} {...linkProps} />;\n};\n","import { getNavigator } from \"@real-router/core\";\nimport { createRouteNodeSource } from \"@real-router/sources\";\nimport { useMemo, useSyncExternalStore } from \"react\";\n\nimport { useRouter } from \"./useRouter\";\n\nimport type { RouteContext } from \"../types\";\n\nexport function useRouteNode(nodeName: string): RouteContext {\n  const router = useRouter();\n\n  const store = useMemo(\n    () => createRouteNodeSource(router, nodeName),\n    [router, nodeName],\n  );\n\n  const { route, previousRoute } = useSyncExternalStore(\n    store.subscribe,\n    store.getSnapshot,\n    store.getSnapshot, // SSR: router returns same state on server and client\n  );\n\n  const navigator = useMemo(() => getNavigator(router), [router]);\n\n  return useMemo(\n    (): RouteContext => ({ navigator, route, previousRoute }),\n    [navigator, route, previousRoute],\n  );\n}\n","// packages/react/modules/hooks/useNavigator.tsx\n\nimport { use } from \"react\";\n\nimport { NavigatorContext } from \"../context\";\n\nimport type { Navigator } from \"@real-router/core\";\n\nexport const useNavigator = (): Navigator => {\n  const navigator = use(NavigatorContext);\n\n  if (!navigator) {\n    throw new Error(\"useNavigator must be used within a RouterProvider\");\n  }\n\n  return navigator;\n};\n","import { getNavigator } from \"@real-router/core\";\nimport { createRouteSource } from \"@real-router/sources\";\nimport { useMemo, useSyncExternalStore } from \"react\";\n\nimport { NavigatorContext, RouteContext, RouterContext } from \"./context\";\n\nimport type { Router } from \"@real-router/core\";\nimport type { FC, ReactNode } from \"react\";\n\nexport interface RouteProviderProps {\n  router: Router;\n  children: ReactNode;\n}\n\nexport const RouterProvider: FC<RouteProviderProps> = ({\n  router,\n  children,\n}) => {\n  const navigator = useMemo(() => getNavigator(router), [router]);\n\n  // useSyncExternalStore manages the router subscription lifecycle:\n  // subscribe connects to router on first listener, unsubscribes on last.\n  // This is Strict Mode safe — no useEffect cleanup needed.\n  const store = useMemo(() => createRouteSource(router), [router]);\n  const { route, previousRoute } = useSyncExternalStore(\n    store.subscribe,\n    store.getSnapshot,\n    store.getSnapshot, // SSR: router returns same state on server and client\n  );\n\n  const routeContextValue = useMemo(\n    () => ({ navigator, route, previousRoute }),\n    [navigator, route, previousRoute],\n  );\n\n  return (\n    <RouterContext value={router}>\n      <NavigatorContext value={navigator}>\n        <RouteContext value={routeContextValue}>{children}</RouteContext>\n      </NavigatorContext>\n    </RouterContext>\n  );\n};\n","// packages/react/modules/hooks/useRouteUtils.tsx\n\nimport { getPluginApi } from \"@real-router/core\";\nimport { getRouteUtils } from \"@real-router/route-utils\";\n\nimport { useRouter } from \"./useRouter\";\n\nimport type { RouteUtils } from \"@real-router/route-utils\";\n\n/**\n * Returns a pre-computed {@link RouteUtils} instance for the current router.\n *\n * Internally retrieves the route tree via `getPluginApi` and delegates\n * to `getRouteUtils`, which caches instances per tree reference (WeakMap).\n *\n * @returns RouteUtils instance with pre-computed chains and siblings\n *\n * @example\n * ```tsx\n * const utils = useRouteUtils();\n *\n * utils.getChain(\"users.profile\");\n * // → [\"users\", \"users.profile\"]\n *\n * utils.getSiblings(\"users\");\n * // → [\"admin\"]\n *\n * utils.isDescendantOf(\"users.profile\", \"users\");\n * // → true\n * ```\n */\nexport const useRouteUtils = (): RouteUtils => {\n  const router = useRouter();\n\n  return getRouteUtils(getPluginApi(router).getTree());\n};\n"]}
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.mjs"}

package/dist/esm/legacy.d.mts

@@ -0,0 +1,4 @@
+export { Link, LinkProps, NavigatorContext, RouteContext, RouterContext, RouterProvider, useIsActiveRoute, useNavigator, useRoute, useRouteNode, useRouteUtils, useRouter } from './index.mjs';
+export { Navigator } from '@real-router/core';
+import 'react';
+import '@real-router/route-utils';

package/dist/esm/legacy.mjs

@@ -0,0 +1 @@
+export{Link,NavigatorContext,RouteContext,RouterContext,RouterProvider,useIsActiveRoute,useNavigator,useRoute,useRouteNode,useRouteUtils,useRouter}from"./chunk-GKE5JASO.mjs";//# sourceMappingURL=legacy.mjs.map

package/dist/esm/legacy.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"legacy.mjs"}

package/dist/esm/metafile-esm.json

@@ -1 +1 @@
-{"inputs":{"src/constants.ts":{"bytes":225,"imports":[],"format":"esm"},"src/context.ts":{"bytes":416,"imports":[{"path":"react","kind":"import-statement","external":true}],"format":"esm"},"src/hooks/useRouter.tsx":{"bytes":364,"imports":[{"path":"react","kind":"import-statement","external":true},{"path":"src/context.ts","kind":"import-statement","original":"../context"}],"format":"esm"},"src/hooks/useStableValue.tsx":{"bytes":976,"imports":[{"path":"react","kind":"import-statement","external":true}],"format":"esm"},"src/hooks/useIsActiveRoute.tsx":{"bytes":1060,"imports":[{"path":"@real-router/sources","kind":"import-statement","external":true},{"path":"react","kind":"import-statement","external":true},{"path":"src/hooks/useRouter.tsx","kind":"import-statement","original":"./useRouter"},{"path":"src/hooks/useStableValue.tsx","kind":"import-statement","original":"./useStableValue"}],"format":"esm"},"src/utils.ts":{"bytes":293,"imports":[],"format":"esm"},"src/components/BaseLink.tsx":{"bytes":4053,"imports":[{"path":"react","kind":"import-statement","external":true},{"path":"src/constants.ts","kind":"import-statement","original":"../constants"},{"path":"src/hooks/useIsActiveRoute.tsx","kind":"import-statement","original":"../hooks/useIsActiveRoute"},{"path":"src/hooks/useStableValue.tsx","kind":"import-statement","original":"../hooks/useStableValue"},{"path":"src/utils.ts","kind":"import-statement","original":"../utils"},{"path":"react/jsx-runtime","kind":"import-statement","external":true}],"format":"esm"},"src/components/Link.tsx":{"bytes":511,"imports":[{"path":"src/components/BaseLink.tsx","kind":"import-statement","original":"./BaseLink"},{"path":"src/hooks/useRouter.tsx","kind":"import-statement","original":"../hooks/useRouter"},{"path":"react/jsx-runtime","kind":"import-statement","external":true}],"format":"esm"},"src/hooks/useRoute.tsx":{"bytes":403,"imports":[{"path":"react","kind":"import-statement","external":true},{"path":"src/context.ts","kind":"import-statement","original":"../context"}],"format":"esm"},"src/components/ConnectedLink.tsx":{"bytes":631,"imports":[{"path":"src/components/BaseLink.tsx","kind":"import-statement","original":"./BaseLink"},{"path":"src/hooks/useRoute.tsx","kind":"import-statement","original":"../hooks/useRoute"},{"path":"src/hooks/useRouter.tsx","kind":"import-statement","original":"../hooks/useRouter"},{"path":"react/jsx-runtime","kind":"import-statement","external":true}],"format":"esm"},"src/hooks/useRouteNode.tsx":{"bytes":837,"imports":[{"path":"@real-router/core","kind":"import-statement","external":true},{"path":"@real-router/sources","kind":"import-statement","external":true},{"path":"react","kind":"import-statement","external":true},{"path":"src/hooks/useRouter.tsx","kind":"import-statement","original":"./useRouter"}],"format":"esm"},"src/hooks/useNavigator.tsx":{"bytes":394,"imports":[{"path":"react","kind":"import-statement","external":true},{"path":"src/context.ts","kind":"import-statement","original":"../context"}],"format":"esm"},"src/RouterProvider.tsx":{"bytes":1380,"imports":[{"path":"@real-router/core","kind":"import-statement","external":true},{"path":"@real-router/sources","kind":"import-statement","external":true},{"path":"react","kind":"import-statement","external":true},{"path":"src/context.ts","kind":"import-statement","original":"./context"},{"path":"react/jsx-runtime","kind":"import-statement","external":true}],"format":"esm"},"src/hooks/useRouteUtils.tsx":{"bytes":977,"imports":[{"path":"@real-router/core","kind":"import-statement","external":true},{"path":"@real-router/route-utils","kind":"import-statement","external":true},{"path":"src/hooks/useRouter.tsx","kind":"import-statement","original":"./useRouter"}],"format":"esm"},"src/index.ts":{"bytes":719,"imports":[{"path":"src/components/BaseLink.tsx","kind":"import-statement","original":"./components/BaseLink"},{"path":"src/components/Link.tsx","kind":"import-statement","original":"./components/Link"},{"path":"src/components/ConnectedLink.tsx","kind":"import-statement","original":"./components/ConnectedLink"},{"path":"src/hooks/useRouteNode.tsx","kind":"import-statement","original":"./hooks/useRouteNode"},{"path":"src/hooks/useRoute.tsx","kind":"import-statement","original":"./hooks/useRoute"},{"path":"src/hooks/useNavigator.tsx","kind":"import-statement","original":"./hooks/useNavigator"},{"path":"src/RouterProvider.tsx","kind":"import-statement","original":"./RouterProvider"},{"path":"src/context.ts","kind":"import-statement","original":"./context"},{"path":"src/hooks/useRouter.tsx","kind":"import-statement","original":"./hooks/useRouter"},{"path":"src/hooks/useRouteUtils.tsx","kind":"import-statement","original":"./hooks/useRouteUtils"}],"format":"esm"}},"outputs":{"dist/esm/index.mjs.map":{"imports":[],"exports":[],"inputs":{},"bytes":18254},"dist/esm/index.mjs":{"imports":[{"path":"react","kind":"import-statement","external":true},{"path":"@real-router/sources","kind":"import-statement","external":true},{"path":"react","kind":"import-statement","external":true},{"path":"react","kind":"import-statement","external":true},{"path":"react","kind":"import-statement","external":true},{"path":"react","kind":"import-statement","external":true},{"path":"react/jsx-runtime","kind":"import-statement","external":true},{"path":"react/jsx-runtime","kind":"import-statement","external":true},{"path":"react","kind":"import-statement","external":true},{"path":"react/jsx-runtime","kind":"import-statement","external":true},{"path":"@real-router/core","kind":"import-statement","external":true},{"path":"@real-router/sources","kind":"import-statement","external":true},{"path":"react","kind":"import-statement","external":true},{"path":"react","kind":"import-statement","external":true},{"path":"@real-router/core","kind":"import-statement","external":true},{"path":"@real-router/sources","kind":"import-statement","external":true},{"path":"react","kind":"import-statement","external":true},{"path":"react/jsx-runtime","kind":"import-statement","external":true},{"path":"@real-router/core","kind":"import-statement","external":true},{"path":"@real-router/route-utils","kind":"import-statement","external":true}],"exports":["BaseLink","ConnectedLink","Link","NavigatorContext","RouteContext","RouterContext","RouterProvider","useNavigator","useRoute","useRouteNode","useRouteUtils","useRouter"],"entryPoint":"src/index.ts","inputs":{"src/components/BaseLink.tsx":{"bytesInOutput":2607},"src/constants.ts":{"bytesInOutput":77},"src/hooks/useIsActiveRoute.tsx":{"bytesInOutput":671},"src/hooks/useRouter.tsx":{"bytesInOutput":202},"src/context.ts":{"bytesInOutput":164},"src/hooks/useStableValue.tsx":{"bytesInOutput":157},"src/utils.ts":{"bytesInOutput":140},"src/index.ts":{"bytesInOutput":0},"src/components/Link.tsx":{"bytesInOutput":243},"src/hooks/useRoute.tsx":{"bytesInOutput":225},"src/components/ConnectedLink.tsx":{"bytesInOutput":269},"src/hooks/useRouteNode.tsx":{"bytesInOutput":742},"src/hooks/useNavigator.tsx":{"bytesInOutput":229},"src/RouterProvider.tsx":{"bytesInOutput":1001},"src/hooks/useRouteUtils.tsx":{"bytesInOutput":225}},"bytes":7637}}}
+{"inputs":{"src/constants.ts":{"bytes":225,"imports":[],"format":"esm"},"src/context.ts":{"bytes":416,"imports":[{"path":"react","kind":"import-statement","external":true}],"format":"esm"},"src/hooks/useRouter.tsx":{"bytes":364,"imports":[{"path":"react","kind":"import-statement","external":true},{"path":"src/context.ts","kind":"import-statement","original":"../context"}],"format":"esm"},"src/hooks/useStableValue.tsx":{"bytes":976,"imports":[{"path":"react","kind":"import-statement","external":true}],"format":"esm"},"src/hooks/useIsActiveRoute.tsx":{"bytes":1060,"imports":[{"path":"@real-router/sources","kind":"import-statement","external":true},{"path":"react","kind":"import-statement","external":true},{"path":"src/hooks/useRouter.tsx","kind":"import-statement","original":"./useRouter"},{"path":"src/hooks/useStableValue.tsx","kind":"import-statement","original":"./useStableValue"}],"format":"esm"},"src/utils.ts":{"bytes":293,"imports":[],"format":"esm"},"src/components/Link.tsx":{"bytes":2900,"imports":[{"path":"react","kind":"import-statement","external":true},{"path":"src/constants.ts","kind":"import-statement","original":"../constants"},{"path":"src/hooks/useIsActiveRoute.tsx","kind":"import-statement","original":"../hooks/useIsActiveRoute"},{"path":"src/hooks/useRouter.tsx","kind":"import-statement","original":"../hooks/useRouter"},{"path":"src/hooks/useStableValue.tsx","kind":"import-statement","original":"../hooks/useStableValue"},{"path":"src/utils.ts","kind":"import-statement","original":"../utils"},{"path":"react/jsx-runtime","kind":"import-statement","external":true}],"format":"esm"},"src/hooks/useRouteNode.tsx":{"bytes":837,"imports":[{"path":"@real-router/core","kind":"import-statement","external":true},{"path":"@real-router/sources","kind":"import-statement","external":true},{"path":"react","kind":"import-statement","external":true},{"path":"src/hooks/useRouter.tsx","kind":"import-statement","original":"./useRouter"}],"format":"esm"},"src/hooks/useRoute.tsx":{"bytes":403,"imports":[{"path":"react","kind":"import-statement","external":true},{"path":"src/context.ts","kind":"import-statement","original":"../context"}],"format":"esm"},"src/hooks/useNavigator.tsx":{"bytes":394,"imports":[{"path":"react","kind":"import-statement","external":true},{"path":"src/context.ts","kind":"import-statement","original":"../context"}],"format":"esm"},"src/hooks/useRouteUtils.tsx":{"bytes":977,"imports":[{"path":"@real-router/core","kind":"import-statement","external":true},{"path":"@real-router/route-utils","kind":"import-statement","external":true},{"path":"src/hooks/useRouter.tsx","kind":"import-statement","original":"./useRouter"}],"format":"esm"},"src/RouterProvider.tsx":{"bytes":1380,"imports":[{"path":"@real-router/core","kind":"import-statement","external":true},{"path":"@real-router/sources","kind":"import-statement","external":true},{"path":"react","kind":"import-statement","external":true},{"path":"src/context.ts","kind":"import-statement","original":"./context"},{"path":"react/jsx-runtime","kind":"import-statement","external":true}],"format":"esm"},"src/index.ts":{"bytes":666,"imports":[{"path":"src/components/Link.tsx","kind":"import-statement","original":"./components/Link"},{"path":"src/hooks/useRouteNode.tsx","kind":"import-statement","original":"./hooks/useRouteNode"},{"path":"src/hooks/useRoute.tsx","kind":"import-statement","original":"./hooks/useRoute"},{"path":"src/hooks/useNavigator.tsx","kind":"import-statement","original":"./hooks/useNavigator"},{"path":"src/hooks/useRouter.tsx","kind":"import-statement","original":"./hooks/useRouter"},{"path":"src/hooks/useRouteUtils.tsx","kind":"import-statement","original":"./hooks/useRouteUtils"},{"path":"src/hooks/useIsActiveRoute.tsx","kind":"import-statement","original":"./hooks/useIsActiveRoute"},{"path":"src/RouterProvider.tsx","kind":"import-statement","original":"./RouterProvider"},{"path":"src/context.ts","kind":"import-statement","original":"./context"}],"format":"esm"},"src/legacy.ts":{"bytes":666,"imports":[{"path":"src/components/Link.tsx","kind":"import-statement","original":"./components/Link"},{"path":"src/hooks/useRouteNode.tsx","kind":"import-statement","original":"./hooks/useRouteNode"},{"path":"src/hooks/useRoute.tsx","kind":"import-statement","original":"./hooks/useRoute"},{"path":"src/hooks/useNavigator.tsx","kind":"import-statement","original":"./hooks/useNavigator"},{"path":"src/hooks/useRouter.tsx","kind":"import-statement","original":"./hooks/useRouter"},{"path":"src/hooks/useRouteUtils.tsx","kind":"import-statement","original":"./hooks/useRouteUtils"},{"path":"src/hooks/useIsActiveRoute.tsx","kind":"import-statement","original":"./hooks/useIsActiveRoute"},{"path":"src/RouterProvider.tsx","kind":"import-statement","original":"./RouterProvider"},{"path":"src/context.ts","kind":"import-statement","original":"./context"}],"format":"esm"}},"outputs":{"dist/esm/index.mjs.map":{"imports":[],"exports":[],"inputs":{},"bytes":93},"dist/esm/index.mjs":{"imports":[{"path":"dist/esm/chunk-GKE5JASO.mjs","kind":"import-statement"}],"exports":["Link","NavigatorContext","RouteContext","RouterContext","RouterProvider","useIsActiveRoute","useNavigator","useRoute","useRouteNode","useRouteUtils","useRouter"],"entryPoint":"src/index.ts","inputs":{"src/index.ts":{"bytesInOutput":0}},"bytes":396},"dist/esm/legacy.mjs.map":{"imports":[],"exports":[],"inputs":{},"bytes":93},"dist/esm/legacy.mjs":{"imports":[{"path":"dist/esm/chunk-GKE5JASO.mjs","kind":"import-statement"}],"exports":["Link","NavigatorContext","RouteContext","RouterContext","RouterProvider","useIsActiveRoute","useNavigator","useRoute","useRouteNode","useRouteUtils","useRouter"],"entryPoint":"src/legacy.ts","inputs":{"src/legacy.ts":{"bytesInOutput":0}},"bytes":396},"dist/esm/chunk-GKE5JASO.mjs.map":{"imports":[],"exports":[],"inputs":{},"bytes":15374},"dist/esm/chunk-GKE5JASO.mjs":{"imports":[{"path":"react","kind":"import-statement","external":true},{"path":"react","kind":"import-statement","external":true},{"path":"@real-router/sources","kind":"import-statement","external":true},{"path":"react","kind":"import-statement","external":true},{"path":"react","kind":"import-statement","external":true},{"path":"react","kind":"import-statement","external":true},{"path":"react/jsx-runtime","kind":"import-statement","external":true},{"path":"@real-router/core","kind":"import-statement","external":true},{"path":"@real-router/sources","kind":"import-statement","external":true},{"path":"react","kind":"import-statement","external":true},{"path":"react","kind":"import-statement","external":true},{"path":"react","kind":"import-statement","external":true},{"path":"@real-router/core","kind":"import-statement","external":true},{"path":"@real-router/route-utils","kind":"import-statement","external":true},{"path":"@real-router/core","kind":"import-statement","external":true},{"path":"@real-router/sources","kind":"import-statement","external":true},{"path":"react","kind":"import-statement","external":true},{"path":"react/jsx-runtime","kind":"import-statement","external":true}],"exports":["Link","NavigatorContext","RouteContext","RouterContext","RouterProvider","useIsActiveRoute","useNavigator","useRoute","useRouteNode","useRouteUtils","useRouter"],"inputs":{"src/context.ts":{"bytesInOutput":164},"src/hooks/useRouter.tsx":{"bytesInOutput":202},"src/hooks/useIsActiveRoute.tsx":{"bytesInOutput":671},"src/hooks/useStableValue.tsx":{"bytesInOutput":157},"src/components/Link.tsx":{"bytesInOutput":2409},"src/constants.ts":{"bytesInOutput":77},"src/utils.ts":{"bytesInOutput":140},"src/hooks/useRouteNode.tsx":{"bytesInOutput":742},"src/hooks/useRoute.tsx":{"bytesInOutput":225},"src/hooks/useNavigator.tsx":{"bytesInOutput":229},"src/hooks/useRouteUtils.tsx":{"bytesInOutput":225},"src/RouterProvider.tsx":{"bytesInOutput":1001}},"bytes":6818}}}

package/package.json

@@ -1,11 +1,18 @@
 {
   "name": "@real-router/react",
-  "version": "0.5.5",
+  "version": "0.7.0",
   "type": "commonjs",
   "description": "React integration for Real-Router",
   "main": "./dist/cjs/index.js",
   "module": "./dist/esm/index.mjs",
   "types": "./dist/esm/index.d.mts",
+  "typesVersions": {
+    "*": {
+      "legacy": [
+        "./dist/cjs/legacy.d.ts"
+      ]
+    }
+  },
   "exports": {
     ".": {
       "development": "./src/index.ts",
@@ -15,6 +22,15 @@
       },
       "import": "./dist/esm/index.mjs",
       "require": "./dist/cjs/index.js"
+    },
+    "./legacy": {
+      "development": "./src/legacy.ts",
+      "types": {
+        "import": "./dist/esm/legacy.d.mts",
+        "require": "./dist/cjs/legacy.d.ts"
+      },
+      "import": "./dist/esm/legacy.mjs",
+      "require": "./dist/cjs/legacy.js"
     }
   },
   "files": [
@@ -48,7 +64,7 @@
   "license": "MIT",
   "sideEffects": false,
   "dependencies": {
-    "@real-router/core": "^0.35.0",
+    "@real-router/core": "^0.35.1",
     "@real-router/route-utils": "^0.1.4",
     "@real-router/sources": "^0.1.4"
   },

package/src/components/Link.tsx

@@ -1,16 +1,109 @@
-// packages/react/modules/components/Link.tsx
+import { memo, useCallback, useMemo } from "react";
 
-import { BaseLink } from "./BaseLink";
+import { EMPTY_PARAMS, EMPTY_OPTIONS } from "../constants";
+import { useIsActiveRoute } from "../hooks/useIsActiveRoute";
 import { useRouter } from "../hooks/useRouter";
+import { useStableValue } from "../hooks/useStableValue";
+import { shouldNavigate } from "../utils";
 
-import type { BaseLinkProps } from "./interfaces";
-import type { FC } from "react";
+import type { LinkProps } from "../types";
+import type { FC, MouseEvent } from "react";
 
-export const Link: FC<Omit<BaseLinkProps, "router">> = (props) => {
-  const router = useRouter();
+function areLinkPropsEqual(
+  prev: Readonly<LinkProps>,
+  next: Readonly<LinkProps>,
+): boolean {
+  return (
+    prev.routeName === next.routeName &&
+    prev.className === next.className &&
+    prev.activeClassName === next.activeClassName &&
+    prev.activeStrict === next.activeStrict &&
+    prev.ignoreQueryParams === next.ignoreQueryParams &&
+    prev.onClick === next.onClick &&
+    prev.target === next.target &&
+    prev.style === next.style &&
+    prev.children === next.children &&
+    JSON.stringify(prev.routeParams) === JSON.stringify(next.routeParams) &&
+    JSON.stringify(prev.routeOptions) === JSON.stringify(next.routeOptions)
+  );
+}
 
-  // eslint-disable-next-line @typescript-eslint/no-unused-vars
-  const { route, previousRoute, routeOptions, ...linkProps } = props;
+export const Link: FC<LinkProps> = memo(
+  ({
+    routeName,
+    routeParams = EMPTY_PARAMS,
+    routeOptions = EMPTY_OPTIONS,
+    className,
+    activeClassName = "active",
+    activeStrict = false,
+    ignoreQueryParams = true,
+    onClick,
+    target,
+    children,
+    ...props
+  }) => {
+    const router = useRouter();
 
-  return <BaseLink router={router} {...linkProps} />;
-};
+    const stableParams = useStableValue(routeParams);
+    const stableOptions = useStableValue(routeOptions);
+
+    const isActive = useIsActiveRoute(
+      routeName,
+      stableParams,
+      activeStrict,
+      ignoreQueryParams,
+    );
+
+    const href = useMemo(() => {
+      if (typeof router.buildUrl === "function") {
+        return router.buildUrl(routeName, stableParams);
+      }
+
+      return router.buildPath(routeName, stableParams);
+    }, [router, routeName, stableParams]);
+
+    const handleClick = useCallback(
+      (evt: MouseEvent<HTMLAnchorElement>) => {
+        if (onClick) {
+          onClick(evt);
+
+          if (evt.defaultPrevented) {
+            return;
+          }
+        }
+
+        if (!shouldNavigate(evt) || target === "_blank") {
+          return;
+        }
+
+        evt.preventDefault();
+        router.navigate(routeName, stableParams, stableOptions).catch(() => {});
+      },
+      [onClick, target, router, routeName, stableParams, stableOptions],
+    );
+
+    const finalClassName = useMemo(() => {
+      if (isActive && activeClassName) {
+        return className
+          ? `${className} ${activeClassName}`.trim()
+          : activeClassName;
+      }
+
+      return className ?? undefined;
+    }, [isActive, className, activeClassName]);
+
+    return (
+      <a
+        {...props}
+        href={href}
+        className={finalClassName}
+        onClick={handleClick}
+      >
+        {children}
+      </a>
+    );
+  },
+  areLinkPropsEqual,
+);
+
+Link.displayName = "Link";

package/src/index.ts

@@ -1,14 +1,8 @@
-// packages/react/modules/index.ts
+// Main entry point — React 19.2+
 
 // 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";
 
@@ -16,14 +10,18 @@ export { useRoute } from "./hooks/useRoute";
 
 export { useNavigator } from "./hooks/useNavigator";
 
+export { useRouter } from "./hooks/useRouter";
+
+export { useRouteUtils } from "./hooks/useRouteUtils";
+
+export { useIsActiveRoute } from "./hooks/useIsActiveRoute";
+
 // Context
 export { RouterProvider } from "./RouterProvider";
 
 export { RouterContext, RouteContext, NavigatorContext } from "./context";
 
-export { useRouter } from "./hooks/useRouter";
-
-export { useRouteUtils } from "./hooks/useRouteUtils";
-
 // Types
+export type { LinkProps } from "./types";
+
 export type { Navigator } from "@real-router/core";

package/src/legacy.ts

@@ -0,0 +1,27 @@
+// Legacy entry point — React 18+
+
+// Components
+export { Link } from "./components/Link";
+
+// Hooks
+export { useRouteNode } from "./hooks/useRouteNode";
+
+export { useRoute } from "./hooks/useRoute";
+
+export { useNavigator } from "./hooks/useNavigator";
+
+export { useRouter } from "./hooks/useRouter";
+
+export { useRouteUtils } from "./hooks/useRouteUtils";
+
+export { useIsActiveRoute } from "./hooks/useIsActiveRoute";
+
+// Context
+export { RouterProvider } from "./RouterProvider";
+
+export { RouterContext, RouteContext, NavigatorContext } from "./context";
+
+// Types
+export type { LinkProps } from "./types";
+
+export type { Navigator } from "@real-router/core";

package/src/types.ts

@@ -1,7 +1,10 @@
-// packages/react/modules/types.ts
-
-import type { Params, Navigator, Router, State } from "@real-router/core";
-import type { MouseEvent, ReactNode } from "react";
+import type {
+  NavigationOptions,
+  Params,
+  Navigator,
+  State,
+} from "@real-router/core";
+import type { HTMLAttributes, MouseEventHandler } from "react";
 
 export interface RouteState<
   P extends Params = Params,
@@ -15,22 +18,16 @@ export type RouteContext = {
   navigator: Navigator;
 } & RouteState;
 
-export interface BaseLinkProps {
-  [key: string]: unknown;
-  router: Router;
+export interface LinkProps<
+  P extends Params = Params,
+> extends HTMLAttributes<HTMLAnchorElement> {
   routeName: string;
-  routeParams?: Params;
-  routeOptions?: {
-    [key: string]: unknown;
-    reload?: boolean;
-    replace?: boolean;
-  };
-  className?: string;
+  routeParams?: P;
+  routeOptions?: NavigationOptions;
   activeClassName?: string;
   activeStrict?: boolean;
   ignoreQueryParams?: boolean;
-  onClick?: (evt: MouseEvent<HTMLAnchorElement>) => void;
   target?: string;
-  children?: ReactNode;
-  previousRoute?: State;
+  onClick?: MouseEventHandler<HTMLAnchorElement>;
+  onMouseOver?: MouseEventHandler<HTMLAnchorElement>;
 }

package/src/components/BaseLink.tsx

@@ -1,129 +0,0 @@
-// packages/react/modules/components/BaseLink.tsx
-
-import { memo, useCallback, useMemo } from "react";
-
-import { EMPTY_PARAMS, EMPTY_OPTIONS } from "../constants";
-import { useIsActiveRoute } from "../hooks/useIsActiveRoute";
-import { useStableValue } from "../hooks/useStableValue";
-import { shouldNavigate } from "../utils";
-
-import type { BaseLinkProps } from "../types";
-import type { FC, MouseEvent } from "react";
-
-/**
- * Optimized BaseLink component with memoization and performance improvements
- */
-export const BaseLink: FC<BaseLinkProps> = memo(
-  ({
-    routeName,
-    routeParams = EMPTY_PARAMS,
-    routeOptions = EMPTY_OPTIONS,
-    className,
-    activeClassName = "active",
-    activeStrict = false,
-    ignoreQueryParams = true,
-    onClick,
-    target,
-    router,
-    children,
-    ...props
-  }) => {
-    // Stabilize object references to prevent unnecessary re-renders
-    const stableParams = useStableValue(routeParams);
-    const stableOptions = useStableValue(routeOptions);
-
-    // Use optimized hook for active state checking
-    const isActive = useIsActiveRoute(
-      routeName,
-      stableParams,
-      activeStrict,
-      ignoreQueryParams,
-    );
-
-    // Build URL with memoization
-    const href = useMemo(() => {
-      // Use buildUrl if available (browser plugin installed)
-      // Otherwise fall back to buildPath (e.g., in SSR or without browser plugin)
-      if (typeof router.buildUrl === "function") {
-        return router.buildUrl(routeName, stableParams);
-      }
-
-      return router.buildPath(routeName, stableParams);
-    }, [router, routeName, stableParams]);
-
-    // Optimized click handler
-    const handleClick = useCallback(
-      (evt: MouseEvent<HTMLAnchorElement>) => {
-        // Call custom onClick if provided
-        if (onClick) {
-          onClick(evt);
-          // Respect preventDefault from custom handler
-          if (evt.defaultPrevented) {
-            return;
-          }
-        }
-
-        // Check if we should handle navigation
-        if (!shouldNavigate(evt) || target === "_blank") {
-          return;
-        }
-
-        // Prevent default link behavior
-        evt.preventDefault();
-
-        // Perform navigation (fire-and-forget)
-        router.navigate(routeName, stableParams, stableOptions).catch(() => {});
-      },
-      [onClick, target, router, routeName, stableParams, stableOptions],
-    );
-
-    // Build className efficiently
-    const finalClassName = useMemo(() => {
-      if (isActive && activeClassName) {
-        return className
-          ? `${className} ${activeClassName}`.trim()
-          : activeClassName;
-      }
-
-      return className ?? undefined;
-    }, [isActive, className, activeClassName]);
-
-    // Filter out previousRoute from props
-    // eslint-disable-next-line @typescript-eslint/no-unused-vars
-    const { previousRoute, ...restProps } = props;
-
-    return (
-      <a
-        {...restProps}
-        href={href}
-        className={finalClassName}
-        onClick={handleClick}
-        data-route={routeName} // For event delegation if needed
-        data-active={isActive} // For CSS selectors if needed
-      >
-        {children}
-      </a>
-    );
-  },
-  (prevProps, nextProps) => {
-    // Custom comparison for better memoization
-    // Check if props that affect rendering have changed
-    return (
-      prevProps.router === nextProps.router &&
-      prevProps.routeName === nextProps.routeName &&
-      JSON.stringify(prevProps.routeParams) ===
-        JSON.stringify(nextProps.routeParams) &&
-      JSON.stringify(prevProps.routeOptions) ===
-        JSON.stringify(nextProps.routeOptions) &&
-      prevProps.className === nextProps.className &&
-      prevProps.activeClassName === nextProps.activeClassName &&
-      prevProps.activeStrict === nextProps.activeStrict &&
-      prevProps.ignoreQueryParams === nextProps.ignoreQueryParams &&
-      prevProps.onClick === nextProps.onClick &&
-      prevProps.target === nextProps.target &&
-      prevProps.children === nextProps.children
-    );
-  },
-);
-
-BaseLink.displayName = "BaseLink";

package/src/components/ConnectedLink.tsx

@@ -1,20 +0,0 @@
-// packages/react/modules/components/ConnectedLink.tsx
-
-import { BaseLink } from "./BaseLink";
-import { useRoute } from "../hooks/useRoute";
-import { useRouter } from "../hooks/useRouter";
-
-import type { BaseLinkProps } from "./interfaces";
-import type { FC } from "react";
-
-export const ConnectedLink: FC<
-  Omit<BaseLinkProps, "router" | "route" | "previousRoute">
-> = (props) => {
-  const router = useRouter();
-  const { route } = useRoute();
-
-  // eslint-disable-next-line @typescript-eslint/no-unused-vars
-  const { routeOptions, ...linkProps } = props;
-
-  return <BaseLink router={router} route={route} {...linkProps} />;
-};

package/src/components/interfaces.ts

@@ -1,28 +0,0 @@
-// packages/react/modules/components/interfaces.ts
-
-import type {
-  NavigationOptions,
-  Params,
-  Router,
-  State,
-} from "@real-router/core";
-import type { HTMLAttributes, MouseEventHandler } from "react";
-
-export interface BaseLinkProps<
-  P extends Params = Params,
-  MP extends Params = Params,
-> extends HTMLAttributes<HTMLAnchorElement> {
-  router: Router;
-  routeName: string;
-  route?: State<P, MP> | undefined;
-  previousRoute?: State | undefined;
-  routeParams?: P;
-  routeOptions?: NavigationOptions;
-  className?: string;
-  activeClassName?: string;
-  activeStrict?: boolean;
-  ignoreQueryParams?: boolean;
-  target?: string;
-  onClick?: MouseEventHandler<HTMLAnchorElement>;
-  onMouseOver?: MouseEventHandler<HTMLAnchorElement>;
-}