@real-router/react 0.15.1 → 0.16.1

package/README.md

@@ -13,7 +13,7 @@
 npm install @real-router/react @real-router/core @real-router/browser-plugin
 ```
 
-**Peer dependency:** `react` >= 18.0.0
+**Peer dependency:** main entry requires `react` >= 19.2.0 (uses `<Activity>`); `@real-router/react/legacy` works with `react` >= 18.0.0.
 
 ## Entry Points
 
@@ -51,10 +51,10 @@ function App() {
         <Link routeName="users">Users</Link>
       </nav>
       <RouteView nodeName="">
-        <RouteView.Match routeName="home">
+        <RouteView.Match segment="home">
           <HomePage />
         </RouteView.Match>
-        <RouteView.Match routeName="users">
+        <RouteView.Match segment="users">
           <UsersPage />
         </RouteView.Match>
         <RouteView.NotFound>
@@ -68,14 +68,14 @@ function App() {
 
 ## Hooks
 
-| Hook                    | Returns                                   | Re-renders                              |
-| ----------------------- | ----------------------------------------- | --------------------------------------- |
-| `useRouter()`           | `Router`                                  | Never                                   |
-| `useNavigator()`        | `Navigator`                               | Never (stable ref, safe to destructure) |
-| `useRoute()`            | `{ router, route, previousRoute }`        | Every navigation                        |
-| `useRouteNode(name)`    | `{ router, route, previousRoute }`        | Only when node activates/deactivates    |
-| `useRouteUtils()`       | `RouteUtils`                              | Never                                   |
-| `useRouterTransition()` | `{ isTransitioning, toRoute, fromRoute }` | On transition start/end                 |
+| Hook                    | Returns                                                    | Re-renders                              |
+| ----------------------- | ---------------------------------------------------------- | --------------------------------------- |
+| `useRouter()`           | `Router`                                                   | Never                                   |
+| `useNavigator()`        | `Navigator`                                                | Never (stable ref, safe to destructure) |
+| `useRoute()`            | `{ navigator, route, previousRoute }`                      | Every navigation                        |
+| `useRouteNode(name)`    | `{ navigator, route, previousRoute }`                      | Only when node activates/deactivates    |
+| `useRouteUtils()`       | `RouteUtils`                                               | Never                                   |
+| `useRouterTransition()` | `{ isTransitioning, isLeaveApproved, toRoute, fromRoute }` | On transition start/end                 |
 
 ```tsx
 // useRouteNode — re-renders only when "users.*" changes
@@ -149,6 +149,7 @@ Declarative route matching with optional `keepAlive` — preserves component sta
 | Prop        | Type        | Description                                                                 |
 | ----------- | ----------- | --------------------------------------------------------------------------- |
 | `segment`   | `string`    | Route segment to match                                                      |
+| `exact`     | `boolean`   | Exact match only — no descendants. Defaults to `false`.                     |
 | `keepAlive` | `boolean`   | Preserve state via React `<Activity>` (React 19.2+)                         |
 | `fallback`  | `ReactNode` | Shown while children suspend. Wraps children in `<Suspense>` when provided. |
 

package/dist/cjs/RouterProvider-DQ0bWmlq.js

@@ -0,0 +1,2 @@
+let e=require(`react`),t=require(`@real-router/core`),n=require(`@real-router/route-utils`),r=require(`react/jsx-runtime`),i=require(`@real-router/sources`),a=require(`@real-router/core/api`);const o=(0,e.createContext)(null),s=(0,e.createContext)(null),c=(0,e.createContext)(null),l=()=>{let t=(0,e.useContext)(s);if(!t)throw Error(`useRouter must be used within a RouterProvider`);return t};function u(n){let r=l(),a=(0,e.useMemo)(()=>(0,i.createRouteNodeSource)(r,n),[r,n]),o=(0,e.useSyncExternalStore)(a.subscribe,a.getSnapshot,a.getSnapshot),s=(0,t.getNavigator)(r);return(0,e.useMemo)(()=>({navigator:s,route:o.route,previousRoute:o.previousRoute}),[s,o])}const d=Object.freeze({}),f=Object.freeze({}),p=`data-real-router-announcer`;function m(e,t){let n=t?.prefix??`Navigated to `,r=t?.getAnnouncementText,i=!0,a=!1,o=!1,s=``,c=null,l,u=h(),d=(e,t)=>{s=e,clearTimeout(l),u.textContent=e,l=setTimeout(()=>{u.textContent=``,s=``},7e3),v(t)},f=setTimeout(()=>{if(a=!0,c!==null&&!o){let e=c;c=null,d(e,document.querySelector(`h1`))}},100),p=e.subscribe(({route:e})=>{if(i){i=!1;return}requestAnimationFrame(()=>{requestAnimationFrame(()=>{if(o)return;let t=document.querySelector(`h1`),i=_(e,n,r,t);if(!(!i||i===s)){if(!a){c=i;return}d(i,t)}})})});return{destroy(){o=!0,p(),clearTimeout(l),clearTimeout(f),g()}}}function h(){let e=document.querySelector(`[${p}]`);if(e)return e;let t=document.createElement(`div`);return t.setAttribute(`style`,`position:absolute;width:1px;height:1px;padding:0;margin:-1px;overflow:hidden;clip:rect(0,0,0,0);clip-path:inset(50%);white-space:nowrap;border:0`),t.setAttribute(`aria-live`,`assertive`),t.setAttribute(`aria-atomic`,`true`),t.setAttribute(p,``),document.body.prepend(t),t}function g(){document.querySelector(`[${p}]`)?.remove()}function _(e,t,n,r){if(n)return n(e);let i=r?.textContent.trim()??``,a=e.name.startsWith(`@@`)?``:e.name;return`${t}${i||document.title||a||globalThis.location.pathname}`}function v(e){e&&(e.hasAttribute(`tabindex`)||e.setAttribute(`tabindex`,`-1`),e.focus({preventScroll:!0}))}function y(e){return e.button===0&&!e.metaKey&&!e.altKey&&!e.ctrlKey&&!e.shiftKey}function b(e,t,n){try{let r=e.buildUrl;if(r){let e=r(t,n);if(e!==void 0)return e}return e.buildPath(t,n)}catch{console.error(`[real-router] Route "${t}" is not defined. The element will render without an href attribute.`);return}}function x(e){return e?e.match(/\S+/g)??[]:[]}function S(e,t,n){if(e&&t){let e=x(t);if(e.length===0)return n??void 0;if(!n)return e.join(` `);let r=x(n),i=new Set(r);for(let t of e)i.has(t)||(i.add(t),r.push(t));return r.join(` `)}return n??void 0}function C(e,t){if(Object.is(e,t))return!0;if(!e||!t)return!1;let n=Object.keys(e);if(n.length!==Object.keys(t).length)return!1;let r=e,i=t;for(let e of n)if(!Object.is(r[e],i[e]))return!1;return!0}function w(t,n,r=!1,a=!0){let o=(0,i.createActiveRouteSource)(l(),t,n,{strict:r,ignoreQueryParams:a});return(0,e.useSyncExternalStore)(o.subscribe,o.getSnapshot,o.getSnapshot)}function T(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&&C(e.routeParams,t.routeParams)&&C(e.routeOptions,t.routeOptions)}const E=(0,e.memo)(({routeName:t,routeParams:n=d,routeOptions:i=f,className:a,activeClassName:o=`active`,activeStrict:s=!1,ignoreQueryParams:c=!0,onClick:u,target:p,children:m,...h})=>{let g=l(),_=w(t,n,s,c),v=(0,e.useMemo)(()=>b(g,t,n),[g,t,n]),x=(0,e.useCallback)(e=>{u&&(u(e),e.defaultPrevented)||!y(e.nativeEvent)||p===`_blank`||(e.preventDefault(),g.navigate(t,n,i).catch(()=>{}))},[u,p,g,t,n,i]),C=S(_,o,a);return(0,r.jsx)(`a`,{...h,href:v,className:C,onClick:x,children:m})},T);E.displayName=`Link`;function D({children:t,fallback:n,onError:a}){let o=(0,i.createDismissableError)(l()),s=(0,e.useSyncExternalStore)(o.subscribe,o.getSnapshot,o.getSnapshot),c=(0,e.useRef)(a);return c.current=a,(0,e.useEffect)(()=>{s.error&&c.current?.(s.error,s.toRoute,s.fromRoute)},[s.version]),(0,r.jsxs)(r.Fragment,{children:[t,s.error?n(s.error,s.resetError):null]})}const O=()=>{let t=(0,e.useContext)(c);if(!t)throw Error(`useNavigator must be used within a RouterProvider`);return t},k=()=>(0,n.getRouteUtils)((0,a.getPluginApi)(l()).getTree()),A=()=>{let t=(0,e.useContext)(o);if(!t)throw Error(`useRoute must be used within a RouteProvider`);return t};function j(){let t=(0,i.getTransitionSource)(l());return(0,e.useSyncExternalStore)(t.subscribe,t.getSnapshot,t.getSnapshot)}const M=({router:n,children:a,announceNavigation:l})=>{(0,e.useEffect)(()=>{if(!l)return;let e=m(n);return()=>{e.destroy()}},[l,n]);let u=(0,e.useMemo)(()=>(0,t.getNavigator)(n),[n]),d=(0,e.useMemo)(()=>(0,i.createRouteSource)(n),[n]),f=(0,e.useSyncExternalStore)(d.subscribe,d.getSnapshot,d.getSnapshot),p=(0,e.useMemo)(()=>({navigator:u,route:f.route,previousRoute:f.previousRoute}),[u,f]);return(0,r.jsx)(s.Provider,{value:n,children:(0,r.jsx)(c.Provider,{value:u,children:(0,r.jsx)(o.Provider,{value:p,children:a})})})};Object.defineProperty(exports,`a`,{enumerable:!0,get:function(){return O}}),Object.defineProperty(exports,`c`,{enumerable:!0,get:function(){return u}}),Object.defineProperty(exports,`i`,{enumerable:!0,get:function(){return k}}),Object.defineProperty(exports,`l`,{enumerable:!0,get:function(){return l}}),Object.defineProperty(exports,`n`,{enumerable:!0,get:function(){return j}}),Object.defineProperty(exports,`o`,{enumerable:!0,get:function(){return D}}),Object.defineProperty(exports,`r`,{enumerable:!0,get:function(){return A}}),Object.defineProperty(exports,`s`,{enumerable:!0,get:function(){return E}}),Object.defineProperty(exports,`t`,{enumerable:!0,get:function(){return M}});
+//# sourceMappingURL=RouterProvider-DQ0bWmlq.js.map

package/dist/cjs/RouterProvider-DQ0bWmlq.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RouterProvider-DQ0bWmlq.js","names":[],"sources":["../../src/context.ts","../../src/hooks/useRouter.tsx","../../src/hooks/useRouteNode.tsx","../../src/constants.ts","../../../../shared/dom-utils/route-announcer.ts","../../../../shared/dom-utils/link-utils.ts","../../src/hooks/useIsActiveRoute.tsx","../../src/components/Link.tsx","../../src/components/RouterErrorBoundary.tsx","../../src/hooks/useNavigator.tsx","../../src/hooks/useRouteUtils.tsx","../../src/hooks/useRoute.tsx","../../src/hooks/useRouterTransition.tsx","../../src/RouterProvider.tsx"],"sourcesContent":["// packages/react/src/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/src/hooks/useRouter.tsx\n\nimport { useContext } from \"react\";\n\nimport { RouterContext } from \"../context\";\n\nimport type { Router } from \"@real-router/core\";\n\nexport const useRouter = (): Router => {\n  const router = useContext(RouterContext);\n\n  if (!router) {\n    throw new Error(\"useRouter must be used within a RouterProvider\");\n  }\n\n  return router;\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  // Use snapshot reference directly. createRouteNodeSource via stabilizeState\n  // returns the SAME snapshot when the node-relevant state did not change,\n  // so memoization on `[navigator, snapshot]` preserves identity for consumers.\n  const snapshot = useSyncExternalStore(\n    store.subscribe,\n    store.getSnapshot,\n    store.getSnapshot, // SSR: router returns same state on server and client\n  );\n\n  // getNavigator is WeakMap-cached in core; additional useMemo is redundant.\n  const navigator = getNavigator(router);\n\n  return useMemo(\n    (): RouteContext => ({\n      navigator,\n      route: snapshot.route,\n      previousRoute: snapshot.previousRoute,\n    }),\n    [navigator, snapshot],\n  );\n}\n","// packages/react/src/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 { Router, State } from \"@real-router/core\";\n\nconst CLEAR_DELAY = 7000;\nconst SAFARI_READY_DELAY = 100;\nconst ANNOUNCER_ATTR = \"data-real-router-announcer\";\nconst INTERNAL_ROUTE_PREFIX = \"@@\";\nconst VISUALLY_HIDDEN =\n  \"position:absolute;width:1px;height:1px;padding:0;margin:-1px;overflow:hidden;clip:rect(0,0,0,0);clip-path:inset(50%);white-space:nowrap;border:0\";\n\nexport interface RouteAnnouncerOptions {\n  prefix?: string;\n  getAnnouncementText?: (route: State) => string;\n}\n\nexport function createRouteAnnouncer(\n  router: Router,\n  options?: RouteAnnouncerOptions,\n): { destroy: () => void } {\n  const prefix = options?.prefix ?? \"Navigated to \";\n  const getCustomText = options?.getAnnouncementText;\n\n  let isInitialNavigation = true;\n  let isReady = false;\n  let isDestroyed = false;\n  let lastAnnouncedText = \"\";\n  let pendingText: string | null = null;\n  let clearTimeoutId: ReturnType<typeof setTimeout> | undefined;\n\n  const announcer = getOrCreateAnnouncer();\n\n  const doAnnounce = (text: string, h1: HTMLElement | null): void => {\n    lastAnnouncedText = text;\n    clearTimeout(clearTimeoutId);\n    announcer.textContent = text;\n    clearTimeoutId = setTimeout(() => {\n      announcer.textContent = \"\";\n      lastAnnouncedText = \"\";\n    }, CLEAR_DELAY);\n\n    manageFocus(h1);\n  };\n\n  // Safari-ready delay: announcing before VoiceOver wires up the aria-live region\n  // causes the first announcement to be silently dropped. Wait SAFARI_READY_DELAY ms\n  // before marking the announcer \"ready\" — any navigation during that window is\n  // buffered in pendingText and flushed once the delay expires.\n  const safariTimeoutId = setTimeout(() => {\n    isReady = true;\n\n    if (pendingText !== null && !isDestroyed) {\n      const text = pendingText;\n\n      pendingText = null;\n      doAnnounce(text, document.querySelector<HTMLElement>(\"h1\"));\n    }\n  }, SAFARI_READY_DELAY);\n\n  const unsubscribe = router.subscribe(({ route }) => {\n    if (isInitialNavigation) {\n      isInitialNavigation = false;\n\n      return;\n    }\n\n    // Double rAF: waits for two paint frames so the incoming route's DOM\n    // (including the new <h1>) is fully rendered before resolveText reads it.\n    // Single rAF fires before the new route's template has been attached,\n    // which would cause resolveText to pick up the OLD h1 or fall back to\n    // document.title / route.name prematurely.\n    requestAnimationFrame(() => {\n      requestAnimationFrame(() => {\n        if (isDestroyed) {\n          return;\n        }\n\n        const h1 = document.querySelector<HTMLElement>(\"h1\");\n        const text = resolveText(route, prefix, getCustomText, h1);\n\n        if (!text || text === lastAnnouncedText) {\n          return;\n        }\n\n        if (!isReady) {\n          // Defer announcement until Safari-ready window elapses (see safariTimeoutId).\n          pendingText = text;\n\n          return;\n        }\n\n        doAnnounce(text, h1);\n      });\n    });\n  });\n\n  return {\n    destroy() {\n      isDestroyed = true;\n      unsubscribe();\n      clearTimeout(clearTimeoutId);\n      clearTimeout(safariTimeoutId);\n      removeAnnouncer();\n    },\n  };\n}\n\nfunction getOrCreateAnnouncer(): HTMLElement {\n  const existing = document.querySelector<HTMLElement>(`[${ANNOUNCER_ATTR}]`);\n\n  if (existing) {\n    return existing;\n  }\n\n  const element = document.createElement(\"div\");\n\n  element.setAttribute(\"style\", VISUALLY_HIDDEN);\n  element.setAttribute(\"aria-live\", \"assertive\");\n  element.setAttribute(\"aria-atomic\", \"true\");\n  element.setAttribute(ANNOUNCER_ATTR, \"\");\n\n  document.body.prepend(element);\n\n  return element;\n}\n\nfunction removeAnnouncer(): void {\n  document.querySelector(`[${ANNOUNCER_ATTR}]`)?.remove();\n}\n\nfunction resolveText(\n  route: State,\n  prefix: string,\n  getCustomText: ((route: State) => string) | undefined,\n  h1: HTMLElement | null,\n): string {\n  if (getCustomText) {\n    return getCustomText(route);\n  }\n\n  const h1Text = h1?.textContent.trim() ?? \"\";\n  const routeName = route.name.startsWith(INTERNAL_ROUTE_PREFIX)\n    ? \"\"\n    : route.name;\n  const rawText =\n    h1Text || document.title || routeName || globalThis.location.pathname;\n\n  return `${prefix}${rawText}`;\n}\n\nfunction manageFocus(h1: HTMLElement | null): void {\n  if (!h1) {\n    return;\n  }\n\n  if (!h1.hasAttribute(\"tabindex\")) {\n    h1.setAttribute(\"tabindex\", \"-1\");\n  }\n\n  h1.focus({ preventScroll: true });\n}\n","import type { Router, Params } from \"@real-router/core\";\n\nexport function shouldNavigate(evt: MouseEvent): boolean {\n  return (\n    evt.button === 0 &&\n    !evt.metaKey &&\n    !evt.altKey &&\n    !evt.ctrlKey &&\n    !evt.shiftKey\n  );\n}\n\ntype BuildUrlFn = (name: string, params: Params) => string | undefined;\n\nexport function buildHref(\n  router: Router,\n  routeName: string,\n  routeParams: Params,\n): string | undefined {\n  try {\n    const buildUrl = router.buildUrl as BuildUrlFn | undefined;\n\n    if (buildUrl) {\n      const url = buildUrl(routeName, routeParams);\n\n      if (url !== undefined) {\n        return url;\n      }\n    }\n\n    return router.buildPath(routeName, routeParams);\n  } catch {\n    console.error(\n      `[real-router] Route \"${routeName}\" is not defined. The element will render without an href attribute.`,\n    );\n\n    return undefined;\n  }\n}\n\nfunction parseTokens(value: string | undefined): string[] {\n  return value ? (value.match(/\\S+/g) ?? []) : [];\n}\n\nexport function buildActiveClassName(\n  isActive: boolean,\n  activeClassName: string | undefined,\n  baseClassName: string | undefined,\n): string | undefined {\n  if (isActive && activeClassName) {\n    const activeTokens = parseTokens(activeClassName);\n\n    if (activeTokens.length === 0) {\n      return baseClassName ?? undefined;\n    }\n    if (!baseClassName) {\n      return activeTokens.join(\" \");\n    }\n\n    const baseTokens = parseTokens(baseClassName);\n    const seen = new Set(baseTokens);\n\n    for (const token of activeTokens) {\n      if (!seen.has(token)) {\n        seen.add(token);\n        baseTokens.push(token);\n      }\n    }\n\n    return baseTokens.join(\" \");\n  }\n\n  return baseClassName ?? undefined;\n}\n\nexport function shallowEqual(\n  prev: object | undefined,\n  next: object | undefined,\n): boolean {\n  if (Object.is(prev, next)) {\n    return true;\n  }\n  if (!prev || !next) {\n    return false;\n  }\n\n  const prevKeys = Object.keys(prev);\n\n  if (prevKeys.length !== Object.keys(next).length) {\n    return false;\n  }\n\n  const prevRecord = prev as Record<string, unknown>;\n  const nextRecord = next as Record<string, unknown>;\n\n  for (const key of prevKeys) {\n    if (!Object.is(prevRecord[key], nextRecord[key])) {\n      return false;\n    }\n  }\n\n  return true;\n}\n\nexport function applyLinkA11y(element: HTMLElement | null | undefined): void {\n  if (!element) {\n    return;\n  }\n  if (\n    element instanceof HTMLAnchorElement ||\n    element instanceof HTMLButtonElement\n  ) {\n    return;\n  }\n  if (!element.hasAttribute(\"role\")) {\n    element.setAttribute(\"role\", \"link\");\n  }\n  if (!element.hasAttribute(\"tabindex\")) {\n    element.setAttribute(\"tabindex\", \"0\");\n  }\n}\n","import { createActiveRouteSource } from \"@real-router/sources\";\nimport { useSyncExternalStore } from \"react\";\n\nimport { useRouter } from \"./useRouter\";\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  // createActiveRouteSource is per-router + canonical-args cached in\n  // @real-router/sources, so passing params by reference is safe — equivalent\n  // param shapes hit the same cache entry regardless of key order.\n  const store = createActiveRouteSource(router, routeName, params, {\n    strict,\n    ignoreQueryParams,\n  });\n\n  return useSyncExternalStore(\n    store.subscribe,\n    store.getSnapshot,\n    store.getSnapshot,\n  );\n}\n","import { memo, useCallback, useMemo } from \"react\";\n\nimport { EMPTY_PARAMS, EMPTY_OPTIONS } from \"../constants\";\nimport {\n  shouldNavigate,\n  buildHref,\n  buildActiveClassName,\n  shallowEqual,\n} from \"../dom-utils/index.js\";\nimport { useIsActiveRoute } from \"../hooks/useIsActiveRoute\";\nimport { useRouter } from \"../hooks/useRouter\";\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    shallowEqual(prev.routeParams, next.routeParams) &&\n    shallowEqual(prev.routeOptions, next.routeOptions)\n  );\n}\n\nconst LinkImpl: FC<LinkProps> = ({\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  // memo + areLinkPropsEqual guarantees that on bail-out the component does\n  // not render; on render, routeParams/routeOptions either changed reference\n  // (true change) or comparator failed (e.g., BigInt fallback to identity),\n  // so they're safe to use directly in hook deps.\n\n  const router = useRouter();\n\n  const isActive = useIsActiveRoute(\n    routeName,\n    routeParams,\n    activeStrict,\n    ignoreQueryParams,\n  );\n\n  const href = useMemo(\n    () => buildHref(router, routeName, routeParams),\n    [router, routeName, routeParams],\n  );\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.nativeEvent) || target === \"_blank\") {\n        return;\n      }\n\n      evt.preventDefault();\n      router.navigate(routeName, routeParams, routeOptions).catch(() => {});\n    },\n    [onClick, target, router, routeName, routeParams, routeOptions],\n  );\n\n  const finalClassName = buildActiveClassName(\n    isActive,\n    activeClassName,\n    className,\n  );\n\n  return (\n    <a {...props} href={href} className={finalClassName} onClick={handleClick}>\n      {children}\n    </a>\n  );\n};\n\nexport const Link: FC<LinkProps> = memo(LinkImpl, areLinkPropsEqual);\n\nLink.displayName = \"Link\";\n","import { createDismissableError } from \"@real-router/sources\";\nimport { useEffect, useRef, useSyncExternalStore } from \"react\";\n\nimport { useRouter } from \"../hooks/useRouter\";\n\nimport type { RouterError, State } from \"@real-router/core\";\nimport type { ReactNode, JSX } from \"react\";\n\nexport interface RouterErrorBoundaryProps {\n  readonly children: ReactNode;\n  readonly fallback: (error: RouterError, resetError: () => void) => ReactNode;\n  readonly onError?: (\n    error: RouterError,\n    toRoute: State | null,\n    fromRoute: State | null,\n  ) => void;\n}\n\nexport function RouterErrorBoundary({\n  children,\n  fallback,\n  onError,\n}: RouterErrorBoundaryProps): JSX.Element {\n  const router = useRouter();\n  const store = createDismissableError(router);\n  const snapshot = useSyncExternalStore(\n    store.subscribe,\n    store.getSnapshot,\n    store.getSnapshot,\n  );\n\n  const onErrorRef = useRef(onError);\n\n  // eslint-disable-next-line @eslint-react/refs -- \"latest ref\" pattern: sync callback to ref to avoid effect re-runs\n  onErrorRef.current = onError;\n\n  useEffect(() => {\n    if (snapshot.error) {\n      onErrorRef.current?.(\n        snapshot.error,\n        snapshot.toRoute,\n        snapshot.fromRoute,\n      );\n    }\n    // eslint-disable-next-line @eslint-react/exhaustive-deps -- onError tracked via ref, snapshot fields accessed inside callback\n  }, [snapshot.version]);\n\n  return (\n    <>\n      {children}\n      {snapshot.error ? fallback(snapshot.error, snapshot.resetError) : null}\n    </>\n  );\n}\n","// packages/react/src/hooks/useNavigator.tsx\n\nimport { useContext } from \"react\";\n\nimport { NavigatorContext } from \"../context\";\n\nimport type { Navigator } from \"@real-router/core\";\n\nexport const useNavigator = (): Navigator => {\n  const navigator = useContext(NavigatorContext);\n\n  if (!navigator) {\n    throw new Error(\"useNavigator must be used within a RouterProvider\");\n  }\n\n  return navigator;\n};\n","import { getPluginApi } from \"@real-router/core/api\";\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 * `getRouteUtils` is WeakMap-cached per `RouteTreeNode` inside\n * `@real-router/route-utils`, so the same router always returns the same\n * `RouteUtils` instance across renders — no local cache needed in the adapter.\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","// packages/react/src/hooks/useRoute.tsx\n\nimport { useContext } from \"react\";\n\nimport { RouteContext } from \"../context\";\n\nimport type { RouteContext as RouteContextType } from \"../types\";\n\nexport const useRoute = (): RouteContextType => {\n  const routeContext = useContext(RouteContext);\n\n  if (!routeContext) {\n    throw new Error(\"useRoute must be used within a RouteProvider\");\n  }\n\n  return routeContext;\n};\n","import { getTransitionSource } from \"@real-router/sources\";\nimport { useSyncExternalStore } from \"react\";\n\nimport { useRouter } from \"./useRouter\";\n\nimport type { RouterTransitionSnapshot } from \"@real-router/sources\";\n\nexport function useRouterTransition(): RouterTransitionSnapshot {\n  const router = useRouter();\n  const store = getTransitionSource(router);\n\n  return useSyncExternalStore(\n    store.subscribe,\n    store.getSnapshot,\n    store.getSnapshot,\n  );\n}\n","import { getNavigator } from \"@real-router/core\";\nimport { createRouteSource } from \"@real-router/sources\";\nimport { useEffect, useMemo, useSyncExternalStore } from \"react\";\n\nimport { NavigatorContext, RouteContext, RouterContext } from \"./context\";\nimport { createRouteAnnouncer } from \"./dom-utils/index.js\";\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  announceNavigation?: boolean;\n}\n\nexport const RouterProvider: FC<RouteProviderProps> = ({\n  router,\n  children,\n  announceNavigation,\n}) => {\n  useEffect(() => {\n    if (!announceNavigation) {\n      return;\n    }\n\n    const announcer = createRouteAnnouncer(router);\n\n    return () => {\n      announcer.destroy();\n    };\n  }, [announceNavigation, router]);\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  // Use snapshot reference directly. createRouteSource via stabilizeState\n  // returns the SAME snapshot reference when route.path is unchanged, so\n  // useMemo below sees stable deps for idempotent navigations and\n  // RouteContext consumers do not re-render.\n  const snapshot = 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    () => ({\n      navigator,\n      route: snapshot.route,\n      previousRoute: snapshot.previousRoute,\n    }),\n    [navigator, snapshot],\n  );\n\n  return (\n    <RouterContext.Provider value={router}>\n      <NavigatorContext.Provider value={navigator}>\n        <RouteContext.Provider value={routeContextValue}>\n          {children}\n        </RouteContext.Provider>\n      </NavigatorContext.Provider>\n    </RouterContext.Provider>\n  );\n};\n"],"mappings":"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"}

package/dist/cjs/{RouterProvider-GwajvaK9.d.ts → RouterProvider-Ddv8Rs1U.d.ts}

@@ -48,8 +48,9 @@ declare const useNavigator: () => Navigator;
 /**
  * Returns a pre-computed {@link RouteUtils} instance for the current router.
  *
- * Internally retrieves the route tree via `getPluginApi` and delegates
- * to `getRouteUtils`, which caches instances per tree reference (WeakMap).
+ * `getRouteUtils` is WeakMap-cached per `RouteTreeNode` inside
+ * `@real-router/route-utils`, so the same router always returns the same
+ * `RouteUtils` instance across renders — no local cache needed in the adapter.
  *
  * @returns RouteUtils instance with pre-computed chains and siblings
  *
@@ -87,4 +88,4 @@ interface RouteProviderProps {
 declare const RouterProvider: FC<RouteProviderProps>;
 //#endregion
 export { useRouteUtils as a, RouterErrorBoundary as c, LinkProps as d, useRoute as i, RouterErrorBoundaryProps as l, useRouterTransition as n, useNavigator as o, useRouteNode as r, useRouter as s, RouterProvider as t, Link as u };
-//# sourceMappingURL=RouterProvider-GwajvaK9.d.ts.map
+//# sourceMappingURL=RouterProvider-Ddv8Rs1U.d.ts.map

package/dist/cjs/{RouterProvider-GwajvaK9.d.ts.map → RouterProvider-Ddv8Rs1U.d.ts.map}

@@ -1 +1 @@
-{"version":3,"file":"RouterProvider-GwajvaK9.d.ts","names":[],"sources":["../../src/types.ts","../../src/components/Link.tsx","../../src/components/RouterErrorBoundary.tsx","../../src/hooks/useRouter.tsx","../../src/hooks/useNavigator.tsx","../../src/hooks/useRouteUtils.tsx","../../src/hooks/useRoute.tsx","../../src/hooks/useRouteNode.tsx","../../src/hooks/useRouterTransition.tsx","../../src/RouterProvider.tsx"],"mappings":";;;;;;UAQiB,UAAA,WAAqB,MAAA,GAAS,MAAA;EAC7C,KAAA,EAAO,KAAA,CAAM,CAAA;EACb,aAAA,GAAgB,KAAA;AAAA;AAAA,KAGN,YAAA;EACV,SAAA,EAAW,SAAA;AAAA,IACT,UAAA;AAAA,UAEa,SAAA,WACL,MAAA,GAAS,MAAA,UACX,cAAA,CAAe,iBAAA;EACvB,SAAA;EACA,WAAA,GAAc,CAAA;EACd,YAAA,GAAe,iBAAA;EACf,eAAA;EACA,YAAA;EACA,iBAAA;EACA,MAAA;EACA,OAAA,GAAU,iBAAA,CAAkB,iBAAA;EAC5B,WAAA,GAAc,iBAAA,CAAkB,iBAAA;AAAA;;;cCMrB,IAAA,EAAM,EAAA,CAAG,SAAA;;;UC3BL,wBAAA;EAAA,SACN,QAAA,EAAU,SAAA;EAAA,SACV,QAAA,GAAW,KAAA,EAAO,WAAA,EAAa,UAAA,iBAA2B,SAAA;EAAA,SAC1D,OAAA,IACP,KAAA,EAAO,WAAA,EACP,OAAA,EAAS,KAAA,SACT,SAAA,EAAW,KAAA;AAAA;AAAA,iBAIC,mBAAA,CAAA;EACd,QAAA;EACA,QAAA;EACA;AAAA,GACC,wBAAA,GAA2B,GAAA,CAAI,OAAA;;;cCbrB,SAAA,QAAgB,MAAA;;;cCAhB,YAAA,QAAmB,SAAA;;;;;;;;AJAhC;;;;;;;;;;;;;;;;;cKuBa,aAAA,QAAoB,UAAA;;;cCvBpB,QAAA,QAAe,YAAA;;;iBCAZ,YAAA,CAAa,QAAA,WAAmB,YAAA;;;iBCDhC,mBAAA,CAAA,GAAuB,wBAAA;;;UCGtB,kBAAA;EACf,MAAA,EAAQ,MAAA;EACR,QAAA,EAAU,SAAA;EACV,kBAAA;AAAA;AAAA,cAGW,cAAA,EAAgB,EAAA,CAAG,kBAAA"}
+{"version":3,"file":"RouterProvider-Ddv8Rs1U.d.ts","names":[],"sources":["../../src/types.ts","../../src/components/Link.tsx","../../src/components/RouterErrorBoundary.tsx","../../src/hooks/useRouter.tsx","../../src/hooks/useNavigator.tsx","../../src/hooks/useRouteUtils.tsx","../../src/hooks/useRoute.tsx","../../src/hooks/useRouteNode.tsx","../../src/hooks/useRouterTransition.tsx","../../src/RouterProvider.tsx"],"mappings":";;;;;;UAQiB,UAAA,WAAqB,MAAA,GAAS,MAAA;EAC7C,KAAA,EAAO,KAAA,CAAM,CAAA;EACb,aAAA,GAAgB,KAAA;AAAA;AAAA,KAGN,YAAA;EACV,SAAA,EAAW,SAAA;AAAA,IACT,UAAA;AAAA,UAEa,SAAA,WACL,MAAA,GAAS,MAAA,UACX,cAAA,CAAe,iBAAA;EACvB,SAAA;EACA,WAAA,GAAc,CAAA;EACd,YAAA,GAAe,iBAAA;EACf,eAAA;EACA,YAAA;EACA,iBAAA;EACA,MAAA;EACA,OAAA,GAAU,iBAAA,CAAkB,iBAAA;EAC5B,WAAA,GAAc,iBAAA,CAAkB,iBAAA;AAAA;;;cCuErB,IAAA,EAAM,EAAA,CAAG,SAAA;;;UC3FL,wBAAA;EAAA,SACN,QAAA,EAAU,SAAA;EAAA,SACV,QAAA,GAAW,KAAA,EAAO,WAAA,EAAa,UAAA,iBAA2B,SAAA;EAAA,SAC1D,OAAA,IACP,KAAA,EAAO,WAAA,EACP,OAAA,EAAS,KAAA,SACT,SAAA,EAAW,KAAA;AAAA;AAAA,iBAIC,mBAAA,CAAA;EACd,QAAA;EACA,QAAA;EACA;AAAA,GACC,wBAAA,GAA2B,GAAA,CAAI,OAAA;;;cCdrB,SAAA,QAAgB,MAAA;;;cCAhB,YAAA,QAAmB,SAAA;;;;;;;;AJAhC;;;;;;;;;;;;;;;;;;cKsBa,aAAA,QAAoB,UAAA;;;cCtBpB,QAAA,QAAe,YAAA;;;iBCAZ,YAAA,CAAa,QAAA,WAAmB,YAAA;;;iBCDhC,mBAAA,CAAA,GAAuB,wBAAA;;;UCGtB,kBAAA;EACf,MAAA,EAAQ,MAAA;EACR,QAAA,EAAU,SAAA;EACV,kBAAA;AAAA;AAAA,cAGW,cAAA,EAAgB,EAAA,CAAG,kBAAA"}

package/dist/cjs/index.d.ts

@@ -1,4 +1,4 @@
-import { a as useRouteUtils, c as RouterErrorBoundary, d as LinkProps, i as useRoute, l as RouterErrorBoundaryProps, n as useRouterTransition, o as useNavigator, r as useRouteNode, s as useRouter, t as RouterProvider, u as Link } from "./RouterProvider-GwajvaK9.js";
+import { a as useRouteUtils, c as RouterErrorBoundary, d as LinkProps, i as useRoute, l as RouterErrorBoundaryProps, n as useRouterTransition, o as useNavigator, r as useRouteNode, s as useRouter, t as RouterProvider, u as Link } from "./RouterProvider-Ddv8Rs1U.js";
 import { ReactElement, ReactNode } from "react";
 import { Navigator } from "@real-router/core";
 import { RouterTransitionSnapshot } from "@real-router/sources";

package/dist/cjs/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","names":[],"sources":["../../src/components/modern/RouteView/types.ts","../../src/components/modern/RouteView/components.tsx","../../src/components/modern/RouteView/RouteView.tsx"],"mappings":";;;;;;UAEiB,cAAA;;WAEN,QAAA;;WAEA,QAAA,EAAU,SAAA;AAAA;AAAA,UAGJ,UAAA;;WAEN,OAAA;EAPA;EAAA,SASA,KAAA;EAPU;EAAA,SASV,SAAA;EATmB;EAAA,SAWnB,QAAA,GAAW,SAAA;EARK;EAAA,SAUhB,QAAA,EAAU,SAAA;AAAA;AAAA,UAGJ,aAAA;EATN;EAAA,SAWA,QAAA,EAAU,SAAA;AAAA;;;iBCtBL,KAAA,CAAM,MAAA,EAAQ,UAAA;AAAA,kBAAd,KAAA;EAAA,IAAK,WAAA;AAAA;AAAA,iBAML,QAAA,CAAS,MAAA,EAAQ,aAAA;AAAA,kBAAjB,QAAA;EAAA,IAAQ,WAAA;AAAA;;;iBCCf,aAAA,CAAA;EACP,QAAA;EACA;AAAA,GACC,QAAA,CAAS,cAAA,IAAkB,YAAA;AAAA,kBAHrB,aAAA;EAAA,IAAa,WAAA;AAAA;AAAA,cAgCT,SAAA,SAAS,aAAA"}
+{"version":3,"file":"index.d.ts","names":[],"sources":["../../src/components/modern/RouteView/types.ts","../../src/components/modern/RouteView/components.tsx","../../src/components/modern/RouteView/RouteView.tsx"],"mappings":";;;;;;UAEiB,cAAA;;WAEN,QAAA;;WAEA,QAAA,EAAU,SAAA;AAAA;AAAA,UAGJ,UAAA;;WAEN,OAAA;EAPA;EAAA,SASA,KAAA;EAPU;EAAA,SASV,SAAA;EATmB;EAAA,SAWnB,QAAA,GAAW,SAAA;EARK;EAAA,SAUhB,QAAA,EAAU,SAAA;AAAA;AAAA,UAGJ,aAAA;EATN;EAAA,SAWA,QAAA,EAAU,SAAA;AAAA;;;iBCtBL,KAAA,CAAM,MAAA,EAAQ,UAAA;AAAA,kBAAd,KAAA;EAAA,IAAK,WAAA;AAAA;AAAA,iBAML,QAAA,CAAS,MAAA,EAAQ,aAAA;AAAA,kBAAjB,QAAA;EAAA,IAAQ,WAAA;AAAA;;;iBCCf,aAAA,CAAA;EACP,QAAA;EACA;AAAA,GACC,QAAA,CAAS,cAAA,IAAkB,YAAA;AAAA,kBAHrB,aAAA;EAAA,IAAa,WAAA;AAAA;AAAA,cA0CT,SAAA,SAAS,aAAA"}

package/dist/cjs/index.js

@@ -1,2 +1,2 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require(`./RouterProvider-jqJCKUhp.js`);let t=require(`react`),n=require(`@real-router/core`),r=require(`@real-router/route-utils`),i=require(`react/jsx-runtime`);function a(e){return null}a.displayName=`RouteView.Match`;function o(e){return null}o.displayName=`RouteView.NotFound`;function s(e,t,n){return n?e===t:(0,r.startsWithSegment)(e,t)}function c(e,n){for(let r of t.Children.toArray(e))(0,t.isValidElement)(r)&&(r.type===a||r.type===o?n.push(r):c(r.props.children,n))}function l(e,n,r,a,o){let s=o===void 0?e:(0,i.jsx)(t.Suspense,{fallback:o,children:e});return r?(0,i.jsx)(t.Activity,{mode:a,children:s},n):(0,i.jsx)(t.Fragment,{children:s},n)}function u(e,r,a,c){let u=null,d=!1,f=[];for(let t of e){if(t.type===o){u=t.props.children;continue}let{segment:e,exact:n=!1,keepAlive:i=!1,fallback:p}=t.props,m=a?`${a}.${e}`:e;!d&&s(r,m,n)?(d=!0,c.add(m),f.push(l(t.props.children,m,i,`visible`,p))):i&&c.has(m)&&f.push(l(t.props.children,m,i,`hidden`,p))}return!d&&r===n.UNKNOWN_ROUTE&&u!==null&&f.push((0,i.jsx)(t.Fragment,{children:u},`__route-view-not-found__`)),{rendered:f,activeMatchFound:d}}function d({nodeName:n,children:r}){let{route:a}=e.c(n),o=(0,t.useRef)(new Set);if(!a)return null;let s=[];c(r,s);let{rendered:l}=u(s,a.name,n,o.current);return l.length>0?(0,i.jsx)(i.Fragment,{children:l}):null}d.displayName=`RouteView`;const f=Object.assign(d,{Match:a,NotFound:o});exports.Link=e.s,exports.RouteView=f,exports.RouterErrorBoundary=e.o,exports.RouterProvider=e.t,exports.useNavigator=e.a,exports.useRoute=e.r,exports.useRouteNode=e.c,exports.useRouteUtils=e.i,exports.useRouter=e.l,exports.useRouterTransition=e.n;
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require(`./RouterProvider-DQ0bWmlq.js`);let t=require(`react`),n=require(`@real-router/core`),r=require(`@real-router/route-utils`),i=require(`react/jsx-runtime`);function a(e){return null}a.displayName=`RouteView.Match`;function o(e){return null}o.displayName=`RouteView.NotFound`;function s(e,t,n){return t===``?!1:n?e===t:(0,r.startsWithSegment)(e,t)}function c(e,n){for(let r of t.Children.toArray(e))(0,t.isValidElement)(r)&&(r.type===a||r.type===o?n.push(r):c(r.props.children,n))}function l(e,n,r,a,o){let s=o===void 0?e:(0,i.jsx)(t.Suspense,{fallback:o,children:e});return r?(0,i.jsx)(t.Activity,{mode:a,children:s},n):(0,i.jsx)(t.Fragment,{children:s},n)}function u(e,r,a,c){let u=null,d=!1,f=[];for(let t of e){if(t.type===o){u=t.props.children;continue}let{segment:e,exact:n=!1,keepAlive:i=!1,fallback:p}=t.props,m=a?`${a}.${e}`:e;!d&&s(r,m,n)?(d=!0,c.add(m),f.push(l(t.props.children,m,i,`visible`,p))):i&&c.has(m)&&f.push(l(t.props.children,m,i,`hidden`,p))}return!d&&r===n.UNKNOWN_ROUTE&&u!==null&&f.push((0,i.jsx)(t.Fragment,{children:u},`__route-view-not-found__`)),{rendered:f,activeMatchFound:d}}function d({nodeName:n,children:r}){let{route:a}=e.c(n),o=(0,t.useRef)(null);o.current??=new Set;let s=(0,t.useMemo)(()=>{let e=[];return c(r,e),e},[r]);if(!a)return null;let{rendered:l}=u(s,a.name,n,o.current);return l.length>0?(0,i.jsx)(i.Fragment,{children:l}):null}d.displayName=`RouteView`;const f=Object.assign(d,{Match:a,NotFound:o});exports.Link=e.s,exports.RouteView=f,exports.RouterErrorBoundary=e.o,exports.RouterProvider=e.t,exports.useNavigator=e.a,exports.useRoute=e.r,exports.useRouteNode=e.c,exports.useRouteUtils=e.i,exports.useRouter=e.l,exports.useRouterTransition=e.n;
 //# sourceMappingURL=index.js.map

package/dist/cjs/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":["Children","Suspense","Activity","Fragment","UNKNOWN_ROUTE","useRouteNode"],"sources":["../../src/components/modern/RouteView/components.tsx","../../src/components/modern/RouteView/helpers.tsx","../../src/components/modern/RouteView/RouteView.tsx"],"sourcesContent":["import type { MatchProps, NotFoundProps } from \"./types\";\n\nexport function Match(_props: MatchProps): null {\n  return null;\n}\n\nMatch.displayName = \"RouteView.Match\";\n\nexport function NotFound(_props: NotFoundProps): null {\n  return null;\n}\n\nNotFound.displayName = \"RouteView.NotFound\";\n","import { UNKNOWN_ROUTE } from \"@real-router/core\";\nimport { startsWithSegment } from \"@real-router/route-utils\";\nimport { Activity, Children, Fragment, Suspense, isValidElement } from \"react\";\n\nimport { Match, NotFound } from \"./components\";\n\nimport type { MatchProps, NotFoundProps } from \"./types\";\nimport type { ReactElement, ReactNode } from \"react\";\n\nfunction isSegmentMatch(\n  routeName: string,\n  fullSegmentName: string,\n  exact: boolean,\n): boolean {\n  if (exact) {\n    return routeName === fullSegmentName;\n  }\n\n  return startsWithSegment(routeName, fullSegmentName);\n}\n\nexport function collectElements(\n  children: ReactNode,\n  result: ReactElement[],\n): void {\n  // eslint-disable-next-line @eslint-react/no-children-to-array\n  for (const child of Children.toArray(children)) {\n    if (!isValidElement(child)) {\n      continue;\n    }\n\n    if (child.type === Match || child.type === NotFound) {\n      result.push(child);\n    } else {\n      collectElements(\n        (child.props as { readonly children: ReactNode }).children,\n        result,\n      );\n    }\n  }\n}\n\nfunction renderMatchElement(\n  matchChildren: ReactNode,\n  fullSegmentName: string,\n  keepAlive: boolean,\n  mode: \"visible\" | \"hidden\",\n  fallback?: ReactNode,\n): ReactElement {\n  const content =\n    fallback === undefined ? (\n      matchChildren\n    ) : (\n      <Suspense fallback={fallback}>{matchChildren}</Suspense>\n    );\n\n  if (keepAlive) {\n    return (\n      <Activity mode={mode} key={fullSegmentName}>\n        {content}\n      </Activity>\n    );\n  }\n\n  return <Fragment key={fullSegmentName}>{content}</Fragment>;\n}\n\nexport function buildRenderList(\n  elements: ReactElement[],\n  routeName: string,\n  nodeName: string,\n  hasBeenActivated: Set<string>,\n): { rendered: ReactElement[]; activeMatchFound: boolean } {\n  let notFoundChildren: ReactNode = null;\n  let activeMatchFound = false;\n  const rendered: ReactElement[] = [];\n\n  for (const child of elements) {\n    if (child.type === NotFound) {\n      notFoundChildren = (child.props as NotFoundProps).children;\n      continue;\n    }\n\n    const {\n      segment,\n      exact = false,\n      keepAlive = false,\n      fallback,\n    } = child.props as MatchProps;\n    const fullSegmentName = nodeName ? `${nodeName}.${segment}` : segment;\n    const isActive =\n      !activeMatchFound && isSegmentMatch(routeName, fullSegmentName, exact);\n\n    if (isActive) {\n      activeMatchFound = true;\n      hasBeenActivated.add(fullSegmentName);\n      rendered.push(\n        renderMatchElement(\n          (child.props as MatchProps).children,\n          fullSegmentName,\n          keepAlive,\n          \"visible\",\n          fallback,\n        ),\n      );\n    } else if (keepAlive && hasBeenActivated.has(fullSegmentName)) {\n      rendered.push(\n        renderMatchElement(\n          (child.props as MatchProps).children,\n          fullSegmentName,\n          keepAlive,\n          \"hidden\",\n          fallback,\n        ),\n      );\n    }\n  }\n\n  if (\n    !activeMatchFound &&\n    routeName === UNKNOWN_ROUTE &&\n    notFoundChildren !== null\n  ) {\n    rendered.push(\n      <Fragment key=\"__route-view-not-found__\">{notFoundChildren}</Fragment>,\n    );\n  }\n\n  return { rendered, activeMatchFound };\n}\n","import { useRef } from \"react\";\n\nimport { Match, NotFound } from \"./components\";\nimport { buildRenderList, collectElements } from \"./helpers\";\nimport { useRouteNode } from \"../../../hooks/useRouteNode\";\n\nimport type { RouteViewProps } from \"./types\";\nimport type { ReactElement } from \"react\";\n\nfunction RouteViewRoot({\n  nodeName,\n  children,\n}: Readonly<RouteViewProps>): ReactElement | null {\n  const { route } = useRouteNode(nodeName);\n  const hasBeenActivatedRef = useRef<Set<string>>(new Set());\n\n  if (!route) {\n    return null;\n  }\n\n  const elements: ReactElement[] = [];\n\n  collectElements(children, elements);\n\n  const { rendered } = buildRenderList(\n    elements,\n    route.name,\n    nodeName,\n    // eslint-disable-next-line @eslint-react/refs -- stable Set ref read for keepAlive tracking (never reassigned)\n    hasBeenActivatedRef.current,\n  );\n\n  if (rendered.length > 0) {\n    return <>{rendered}</>;\n  }\n\n  return null;\n}\n\nRouteViewRoot.displayName = \"RouteView\";\n\nexport const RouteView = Object.assign(RouteViewRoot, { Match, NotFound });\n\nexport type {\n  RouteViewProps,\n  MatchProps as RouteViewMatchProps,\n  NotFoundProps as RouteViewNotFoundProps,\n} from \"./types\";\n"],"mappings":"8OAEA,SAAgB,EAAM,EAA0B,CAC9C,OAAO,KAGT,EAAM,YAAc,kBAEpB,SAAgB,EAAS,EAA6B,CACpD,OAAO,KAGT,EAAS,YAAc,qBCHvB,SAAS,EACP,EACA,EACA,EACS,CAKT,OAJI,EACK,IAAc,GAGvB,EAAA,EAAA,mBAAyB,EAAW,EAAgB,CAGtD,SAAgB,EACd,EACA,EACM,CAEN,IAAK,IAAM,KAASA,EAAAA,SAAS,QAAQ,EAAS,EACxC,EAAA,EAAA,gBAAgB,EAAM,GAItB,EAAM,OAAS,GAAS,EAAM,OAAS,EACzC,EAAO,KAAK,EAAM,CAElB,EACG,EAAM,MAA2C,SAClD,EACD,EAKP,SAAS,EACP,EACA,EACA,EACA,EACA,EACc,CACd,IAAM,EACJ,IAAa,IAAA,GACX,GAEA,EAAA,EAAA,KAACC,EAAAA,SAAD,CAAoB,oBAAW,EAAyB,CAAA,CAW5D,OARI,GAEA,EAAA,EAAA,KAACC,EAAAA,SAAD,CAAgB,gBACb,EACQ,CAFgB,EAEhB,EAIR,EAAA,EAAA,KAACC,EAAAA,SAAD,CAAA,SAAiC,EAAmB,CAArC,EAAqC,CAG7D,SAAgB,EACd,EACA,EACA,EACA,EACyD,CACzD,IAAI,EAA8B,KAC9B,EAAmB,GACjB,EAA2B,EAAE,CAEnC,IAAK,IAAM,KAAS,EAAU,CAC5B,GAAI,EAAM,OAAS,EAAU,CAC3B,EAAoB,EAAM,MAAwB,SAClD,SAGF,GAAM,CACJ,UACA,QAAQ,GACR,YAAY,GACZ,YACE,EAAM,MACJ,EAAkB,EAAW,GAAG,EAAS,GAAG,IAAY,EAE5D,CAAC,GAAoB,EAAe,EAAW,EAAiB,EAAM,EAGtE,EAAmB,GACnB,EAAiB,IAAI,EAAgB,CACrC,EAAS,KACP,EACG,EAAM,MAAqB,SAC5B,EACA,EACA,UACA,EACD,CACF,EACQ,GAAa,EAAiB,IAAI,EAAgB,EAC3D,EAAS,KACP,EACG,EAAM,MAAqB,SAC5B,EACA,EACA,SACA,EACD,CACF,CAcL,MATE,CAAC,GACD,IAAcC,EAAAA,eACd,IAAqB,MAErB,EAAS,MACP,EAAA,EAAA,KAACD,EAAAA,SAAD,CAAA,SAA0C,EAA4B,CAAxD,2BAAwD,CACvE,CAGI,CAAE,WAAU,mBAAkB,CCvHvC,SAAS,EAAc,CACrB,WACA,YACgD,CAChD,GAAM,CAAE,SAAUE,EAAAA,EAAa,EAAS,CAClC,GAAA,EAAA,EAAA,QAA0C,IAAI,IAAM,CAE1D,GAAI,CAAC,EACH,OAAO,KAGT,IAAM,EAA2B,EAAE,CAEnC,EAAgB,EAAU,EAAS,CAEnC,GAAM,CAAE,YAAa,EACnB,EACA,EAAM,KACN,EAEA,EAAoB,QACrB,CAMD,OAJI,EAAS,OAAS,GACb,EAAA,EAAA,KAAA,EAAA,SAAA,CAAA,SAAG,EAAY,CAAA,CAGjB,KAGT,EAAc,YAAc,YAE5B,MAAa,EAAY,OAAO,OAAO,EAAe,CAAE,QAAO,WAAU,CAAC"}
+{"version":3,"file":"index.js","names":["Children","Suspense","Activity","Fragment","UNKNOWN_ROUTE","useRouteNode"],"sources":["../../src/components/modern/RouteView/components.tsx","../../src/components/modern/RouteView/helpers.tsx","../../src/components/modern/RouteView/RouteView.tsx"],"sourcesContent":["import type { MatchProps, NotFoundProps } from \"./types\";\n\nexport function Match(_props: MatchProps): null {\n  return null;\n}\n\nMatch.displayName = \"RouteView.Match\";\n\nexport function NotFound(_props: NotFoundProps): null {\n  return null;\n}\n\nNotFound.displayName = \"RouteView.NotFound\";\n","import { UNKNOWN_ROUTE } from \"@real-router/core\";\nimport { startsWithSegment } from \"@real-router/route-utils\";\nimport { Activity, Children, Fragment, Suspense, isValidElement } from \"react\";\n\nimport { Match, NotFound } from \"./components\";\n\nimport type { MatchProps, NotFoundProps } from \"./types\";\nimport type { ReactElement, ReactNode } from \"react\";\n\nfunction isSegmentMatch(\n  routeName: string,\n  fullSegmentName: string,\n  exact: boolean,\n): boolean {\n  if (fullSegmentName === \"\") {\n    return false;\n  }\n\n  if (exact) {\n    return routeName === fullSegmentName;\n  }\n\n  return startsWithSegment(routeName, fullSegmentName);\n}\n\nexport function collectElements(\n  children: ReactNode,\n  result: ReactElement[],\n): void {\n  // eslint-disable-next-line @eslint-react/no-children-to-array\n  for (const child of Children.toArray(children)) {\n    if (!isValidElement(child)) {\n      continue;\n    }\n\n    if (child.type === Match || child.type === NotFound) {\n      result.push(child);\n    } else {\n      collectElements(\n        (child.props as { readonly children: ReactNode }).children,\n        result,\n      );\n    }\n  }\n}\n\nfunction renderMatchElement(\n  matchChildren: ReactNode,\n  fullSegmentName: string,\n  keepAlive: boolean,\n  mode: \"visible\" | \"hidden\",\n  fallback?: ReactNode,\n): ReactElement {\n  const content =\n    fallback === undefined ? (\n      matchChildren\n    ) : (\n      <Suspense fallback={fallback}>{matchChildren}</Suspense>\n    );\n\n  if (keepAlive) {\n    return (\n      <Activity mode={mode} key={fullSegmentName}>\n        {content}\n      </Activity>\n    );\n  }\n\n  return <Fragment key={fullSegmentName}>{content}</Fragment>;\n}\n\nexport function buildRenderList(\n  elements: ReactElement[],\n  routeName: string,\n  nodeName: string,\n  hasBeenActivated: Set<string>,\n): { rendered: ReactElement[]; activeMatchFound: boolean } {\n  let notFoundChildren: ReactNode = null;\n  let activeMatchFound = false;\n  const rendered: ReactElement[] = [];\n\n  for (const child of elements) {\n    if (child.type === NotFound) {\n      notFoundChildren = (child.props as NotFoundProps).children;\n      continue;\n    }\n\n    const {\n      segment,\n      exact = false,\n      keepAlive = false,\n      fallback,\n    } = child.props as MatchProps;\n    const fullSegmentName = nodeName ? `${nodeName}.${segment}` : segment;\n    const isActive =\n      !activeMatchFound && isSegmentMatch(routeName, fullSegmentName, exact);\n\n    if (isActive) {\n      activeMatchFound = true;\n      hasBeenActivated.add(fullSegmentName);\n      rendered.push(\n        renderMatchElement(\n          (child.props as MatchProps).children,\n          fullSegmentName,\n          keepAlive,\n          \"visible\",\n          fallback,\n        ),\n      );\n    } else if (keepAlive && hasBeenActivated.has(fullSegmentName)) {\n      rendered.push(\n        renderMatchElement(\n          (child.props as MatchProps).children,\n          fullSegmentName,\n          keepAlive,\n          \"hidden\",\n          fallback,\n        ),\n      );\n    }\n  }\n\n  if (\n    !activeMatchFound &&\n    routeName === UNKNOWN_ROUTE &&\n    notFoundChildren !== null\n  ) {\n    rendered.push(\n      <Fragment key=\"__route-view-not-found__\">{notFoundChildren}</Fragment>,\n    );\n  }\n\n  return { rendered, activeMatchFound };\n}\n","import { useMemo, useRef } from \"react\";\n\nimport { Match, NotFound } from \"./components\";\nimport { buildRenderList, collectElements } from \"./helpers\";\nimport { useRouteNode } from \"../../../hooks/useRouteNode\";\n\nimport type { RouteViewProps } from \"./types\";\nimport type { ReactElement } from \"react\";\n\nfunction RouteViewRoot({\n  nodeName,\n  children,\n}: Readonly<RouteViewProps>): ReactElement | null {\n  const { route } = useRouteNode(nodeName);\n  const hasBeenActivatedRef = useRef<Set<string> | null>(null);\n\n  // eslint-disable-next-line @eslint-react/refs -- lazy init: assign once when null to avoid `new Set()` allocation on every render\n  hasBeenActivatedRef.current ??= new Set();\n\n  // Skip the Children.toArray + collectElements traversal when children\n  // reference is unchanged. children only changes when the parent re-renders\n  // with a new ReactNode, so this caches the steady-state.\n  const elements = useMemo(() => {\n    const collected: ReactElement[] = [];\n\n    collectElements(children, collected);\n\n    return collected;\n  }, [children]);\n\n  if (!route) {\n    return null;\n  }\n\n  const { rendered } = buildRenderList(\n    elements,\n    route.name,\n    nodeName,\n    // eslint-disable-next-line @eslint-react/refs -- stable Set ref read for keepAlive tracking (never reassigned)\n    hasBeenActivatedRef.current,\n  );\n\n  if (rendered.length > 0) {\n    return <>{rendered}</>;\n  }\n\n  return null;\n}\n\nRouteViewRoot.displayName = \"RouteView\";\n\nexport const RouteView = Object.assign(RouteViewRoot, { Match, NotFound });\n\nexport type {\n  RouteViewProps,\n  MatchProps as RouteViewMatchProps,\n  NotFoundProps as RouteViewNotFoundProps,\n} from \"./types\";\n"],"mappings":"8OAEA,SAAgB,EAAM,EAA0B,CAC9C,OAAO,KAGT,EAAM,YAAc,kBAEpB,SAAgB,EAAS,EAA6B,CACpD,OAAO,KAGT,EAAS,YAAc,qBCHvB,SAAS,EACP,EACA,EACA,EACS,CAST,OARI,IAAoB,GACf,GAGL,EACK,IAAc,GAGvB,EAAA,EAAA,mBAAyB,EAAW,EAAgB,CAGtD,SAAgB,EACd,EACA,EACM,CAEN,IAAK,IAAM,KAASA,EAAAA,SAAS,QAAQ,EAAS,EACxC,EAAA,EAAA,gBAAgB,EAAM,GAItB,EAAM,OAAS,GAAS,EAAM,OAAS,EACzC,EAAO,KAAK,EAAM,CAElB,EACG,EAAM,MAA2C,SAClD,EACD,EAKP,SAAS,EACP,EACA,EACA,EACA,EACA,EACc,CACd,IAAM,EACJ,IAAa,IAAA,GACX,GAEA,EAAA,EAAA,KAACC,EAAAA,SAAD,CAAoB,oBAAW,EAAyB,CAAA,CAW5D,OARI,GAEA,EAAA,EAAA,KAACC,EAAAA,SAAD,CAAgB,gBACb,EACQ,CAFgB,EAEhB,EAIR,EAAA,EAAA,KAACC,EAAAA,SAAD,CAAA,SAAiC,EAAmB,CAArC,EAAqC,CAG7D,SAAgB,EACd,EACA,EACA,EACA,EACyD,CACzD,IAAI,EAA8B,KAC9B,EAAmB,GACjB,EAA2B,EAAE,CAEnC,IAAK,IAAM,KAAS,EAAU,CAC5B,GAAI,EAAM,OAAS,EAAU,CAC3B,EAAoB,EAAM,MAAwB,SAClD,SAGF,GAAM,CACJ,UACA,QAAQ,GACR,YAAY,GACZ,YACE,EAAM,MACJ,EAAkB,EAAW,GAAG,EAAS,GAAG,IAAY,EAE5D,CAAC,GAAoB,EAAe,EAAW,EAAiB,EAAM,EAGtE,EAAmB,GACnB,EAAiB,IAAI,EAAgB,CACrC,EAAS,KACP,EACG,EAAM,MAAqB,SAC5B,EACA,EACA,UACA,EACD,CACF,EACQ,GAAa,EAAiB,IAAI,EAAgB,EAC3D,EAAS,KACP,EACG,EAAM,MAAqB,SAC5B,EACA,EACA,SACA,EACD,CACF,CAcL,MATE,CAAC,GACD,IAAcC,EAAAA,eACd,IAAqB,MAErB,EAAS,MACP,EAAA,EAAA,KAACD,EAAAA,SAAD,CAAA,SAA0C,EAA4B,CAAxD,2BAAwD,CACvE,CAGI,CAAE,WAAU,mBAAkB,CC3HvC,SAAS,EAAc,CACrB,WACA,YACgD,CAChD,GAAM,CAAE,SAAUE,EAAAA,EAAa,EAAS,CAClC,GAAA,EAAA,EAAA,QAAiD,KAAK,CAG5D,EAAoB,UAAY,IAAI,IAKpC,IAAM,GAAA,EAAA,EAAA,aAAyB,CAC7B,IAAM,EAA4B,EAAE,CAIpC,OAFA,EAAgB,EAAU,EAAU,CAE7B,GACN,CAAC,EAAS,CAAC,CAEd,GAAI,CAAC,EACH,OAAO,KAGT,GAAM,CAAE,YAAa,EACnB,EACA,EAAM,KACN,EAEA,EAAoB,QACrB,CAMD,OAJI,EAAS,OAAS,GACb,EAAA,EAAA,KAAA,EAAA,SAAA,CAAA,SAAG,EAAY,CAAA,CAGjB,KAGT,EAAc,YAAc,YAE5B,MAAa,EAAY,OAAO,OAAO,EAAe,CAAE,QAAO,WAAU,CAAC"}

package/dist/cjs/legacy.d.ts

@@ -1,4 +1,4 @@
-import { a as useRouteUtils, c as RouterErrorBoundary, d as LinkProps, i as useRoute, l as RouterErrorBoundaryProps, n as useRouterTransition, o as useNavigator, r as useRouteNode, s as useRouter, t as RouterProvider, u as Link } from "./RouterProvider-GwajvaK9.js";
+import { a as useRouteUtils, c as RouterErrorBoundary, d as LinkProps, i as useRoute, l as RouterErrorBoundaryProps, n as useRouterTransition, o as useNavigator, r as useRouteNode, s as useRouter, t as RouterProvider, u as Link } from "./RouterProvider-Ddv8Rs1U.js";
 import { Navigator } from "@real-router/core";
 import { RouterTransitionSnapshot } from "@real-router/sources";
 export { Link, type LinkProps, type Navigator, RouterErrorBoundary, type RouterErrorBoundaryProps, RouterProvider, type RouterTransitionSnapshot, useNavigator, useRoute, useRouteNode, useRouteUtils, useRouter, useRouterTransition };

package/dist/cjs/legacy.js

@@ -1 +1 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require(`./RouterProvider-jqJCKUhp.js`);exports.Link=e.s,exports.RouterErrorBoundary=e.o,exports.RouterProvider=e.t,exports.useNavigator=e.a,exports.useRoute=e.r,exports.useRouteNode=e.c,exports.useRouteUtils=e.i,exports.useRouter=e.l,exports.useRouterTransition=e.n;
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require(`./RouterProvider-DQ0bWmlq.js`);exports.Link=e.s,exports.RouterErrorBoundary=e.o,exports.RouterProvider=e.t,exports.useNavigator=e.a,exports.useRoute=e.r,exports.useRouteNode=e.c,exports.useRouteUtils=e.i,exports.useRouter=e.l,exports.useRouterTransition=e.n;

package/dist/esm/{RouterProvider-BuGQIoZ-.d.mts → RouterProvider-B2KCZfL_.d.mts}

@@ -48,8 +48,9 @@ declare const useNavigator: () => Navigator;
 /**
  * Returns a pre-computed {@link RouteUtils} instance for the current router.
  *
- * Internally retrieves the route tree via `getPluginApi` and delegates
- * to `getRouteUtils`, which caches instances per tree reference (WeakMap).
+ * `getRouteUtils` is WeakMap-cached per `RouteTreeNode` inside
+ * `@real-router/route-utils`, so the same router always returns the same
+ * `RouteUtils` instance across renders — no local cache needed in the adapter.
  *
  * @returns RouteUtils instance with pre-computed chains and siblings
  *
@@ -87,4 +88,4 @@ interface RouteProviderProps {
 declare const RouterProvider: FC<RouteProviderProps>;
 //#endregion
 export { useRouteUtils as a, RouterErrorBoundary as c, LinkProps as d, useRoute as i, RouterErrorBoundaryProps as l, useRouterTransition as n, useNavigator as o, useRouteNode as r, useRouter as s, RouterProvider as t, Link as u };
-//# sourceMappingURL=RouterProvider-BuGQIoZ-.d.mts.map
+//# sourceMappingURL=RouterProvider-B2KCZfL_.d.mts.map

package/dist/esm/{RouterProvider-BuGQIoZ-.d.mts.map → RouterProvider-B2KCZfL_.d.mts.map}

@@ -1 +1 @@
-{"version":3,"file":"RouterProvider-BuGQIoZ-.d.mts","names":[],"sources":["../../src/types.ts","../../src/components/Link.tsx","../../src/components/RouterErrorBoundary.tsx","../../src/hooks/useRouter.tsx","../../src/hooks/useNavigator.tsx","../../src/hooks/useRouteUtils.tsx","../../src/hooks/useRoute.tsx","../../src/hooks/useRouteNode.tsx","../../src/hooks/useRouterTransition.tsx","../../src/RouterProvider.tsx"],"mappings":";;;;;;UAQiB,UAAA,WAAqB,MAAA,GAAS,MAAA;EAC7C,KAAA,EAAO,KAAA,CAAM,CAAA;EACb,aAAA,GAAgB,KAAA;AAAA;AAAA,KAGN,YAAA;EACV,SAAA,EAAW,SAAA;AAAA,IACT,UAAA;AAAA,UAEa,SAAA,WACL,MAAA,GAAS,MAAA,UACX,cAAA,CAAe,iBAAA;EACvB,SAAA;EACA,WAAA,GAAc,CAAA;EACd,YAAA,GAAe,iBAAA;EACf,eAAA;EACA,YAAA;EACA,iBAAA;EACA,MAAA;EACA,OAAA,GAAU,iBAAA,CAAkB,iBAAA;EAC5B,WAAA,GAAc,iBAAA,CAAkB,iBAAA;AAAA;;;cCMrB,IAAA,EAAM,EAAA,CAAG,SAAA;;;UC3BL,wBAAA;EAAA,SACN,QAAA,EAAU,SAAA;EAAA,SACV,QAAA,GAAW,KAAA,EAAO,WAAA,EAAa,UAAA,iBAA2B,SAAA;EAAA,SAC1D,OAAA,IACP,KAAA,EAAO,WAAA,EACP,OAAA,EAAS,KAAA,SACT,SAAA,EAAW,KAAA;AAAA;AAAA,iBAIC,mBAAA,CAAA;EACd,QAAA;EACA,QAAA;EACA;AAAA,GACC,wBAAA,GAA2B,GAAA,CAAI,OAAA;;;cCbrB,SAAA,QAAgB,MAAA;;;cCAhB,YAAA,QAAmB,SAAA;;;;;;;;AJAhC;;;;;;;;;;;;;;;;;cKuBa,aAAA,QAAoB,UAAA;;;cCvBpB,QAAA,QAAe,YAAA;;;iBCAZ,YAAA,CAAa,QAAA,WAAmB,YAAA;;;iBCDhC,mBAAA,CAAA,GAAuB,wBAAA;;;UCGtB,kBAAA;EACf,MAAA,EAAQ,MAAA;EACR,QAAA,EAAU,SAAA;EACV,kBAAA;AAAA;AAAA,cAGW,cAAA,EAAgB,EAAA,CAAG,kBAAA"}
+{"version":3,"file":"RouterProvider-B2KCZfL_.d.mts","names":[],"sources":["../../src/types.ts","../../src/components/Link.tsx","../../src/components/RouterErrorBoundary.tsx","../../src/hooks/useRouter.tsx","../../src/hooks/useNavigator.tsx","../../src/hooks/useRouteUtils.tsx","../../src/hooks/useRoute.tsx","../../src/hooks/useRouteNode.tsx","../../src/hooks/useRouterTransition.tsx","../../src/RouterProvider.tsx"],"mappings":";;;;;;UAQiB,UAAA,WAAqB,MAAA,GAAS,MAAA;EAC7C,KAAA,EAAO,KAAA,CAAM,CAAA;EACb,aAAA,GAAgB,KAAA;AAAA;AAAA,KAGN,YAAA;EACV,SAAA,EAAW,SAAA;AAAA,IACT,UAAA;AAAA,UAEa,SAAA,WACL,MAAA,GAAS,MAAA,UACX,cAAA,CAAe,iBAAA;EACvB,SAAA;EACA,WAAA,GAAc,CAAA;EACd,YAAA,GAAe,iBAAA;EACf,eAAA;EACA,YAAA;EACA,iBAAA;EACA,MAAA;EACA,OAAA,GAAU,iBAAA,CAAkB,iBAAA;EAC5B,WAAA,GAAc,iBAAA,CAAkB,iBAAA;AAAA;;;cCuErB,IAAA,EAAM,EAAA,CAAG,SAAA;;;UC3FL,wBAAA;EAAA,SACN,QAAA,EAAU,SAAA;EAAA,SACV,QAAA,GAAW,KAAA,EAAO,WAAA,EAAa,UAAA,iBAA2B,SAAA;EAAA,SAC1D,OAAA,IACP,KAAA,EAAO,WAAA,EACP,OAAA,EAAS,KAAA,SACT,SAAA,EAAW,KAAA;AAAA;AAAA,iBAIC,mBAAA,CAAA;EACd,QAAA;EACA,QAAA;EACA;AAAA,GACC,wBAAA,GAA2B,GAAA,CAAI,OAAA;;;cCdrB,SAAA,QAAgB,MAAA;;;cCAhB,YAAA,QAAmB,SAAA;;;;;;;;AJAhC;;;;;;;;;;;;;;;;;;cKsBa,aAAA,QAAoB,UAAA;;;cCtBpB,QAAA,QAAe,YAAA;;;iBCAZ,YAAA,CAAa,QAAA,WAAmB,YAAA;;;iBCDhC,mBAAA,CAAA,GAAuB,wBAAA;;;UCGtB,kBAAA;EACf,MAAA,EAAQ,MAAA;EACR,QAAA,EAAU,SAAA;EACV,kBAAA;AAAA;AAAA,cAGW,cAAA,EAAgB,EAAA,CAAG,kBAAA"}

package/dist/esm/RouterProvider-DqCTMwvh.mjs

@@ -0,0 +1,2 @@
+import{createContext as e,memo as t,useCallback as n,useContext as r,useEffect as i,useMemo as a,useRef as o,useSyncExternalStore as s}from"react";import{getNavigator as c}from"@real-router/core";import{getRouteUtils as l}from"@real-router/route-utils";import{Fragment as u,jsx as d,jsxs as f}from"react/jsx-runtime";import{createActiveRouteSource as p,createDismissableError as m,createRouteNodeSource as h,createRouteSource as g,getTransitionSource as _}from"@real-router/sources";import{getPluginApi as v}from"@real-router/core/api";const y=e(null),b=e(null),x=e(null),S=()=>{let e=r(b);if(!e)throw Error(`useRouter must be used within a RouterProvider`);return e};function C(e){let t=S(),n=a(()=>h(t,e),[t,e]),r=s(n.subscribe,n.getSnapshot,n.getSnapshot),i=c(t);return a(()=>({navigator:i,route:r.route,previousRoute:r.previousRoute}),[i,r])}const w=Object.freeze({}),T=Object.freeze({}),E=`data-real-router-announcer`;function D(e,t){let n=t?.prefix??`Navigated to `,r=t?.getAnnouncementText,i=!0,a=!1,o=!1,s=``,c=null,l,u=O(),d=(e,t)=>{s=e,clearTimeout(l),u.textContent=e,l=setTimeout(()=>{u.textContent=``,s=``},7e3),j(t)},f=setTimeout(()=>{if(a=!0,c!==null&&!o){let e=c;c=null,d(e,document.querySelector(`h1`))}},100),p=e.subscribe(({route:e})=>{if(i){i=!1;return}requestAnimationFrame(()=>{requestAnimationFrame(()=>{if(o)return;let t=document.querySelector(`h1`),i=A(e,n,r,t);if(!(!i||i===s)){if(!a){c=i;return}d(i,t)}})})});return{destroy(){o=!0,p(),clearTimeout(l),clearTimeout(f),k()}}}function O(){let e=document.querySelector(`[${E}]`);if(e)return e;let t=document.createElement(`div`);return t.setAttribute(`style`,`position:absolute;width:1px;height:1px;padding:0;margin:-1px;overflow:hidden;clip:rect(0,0,0,0);clip-path:inset(50%);white-space:nowrap;border:0`),t.setAttribute(`aria-live`,`assertive`),t.setAttribute(`aria-atomic`,`true`),t.setAttribute(E,``),document.body.prepend(t),t}function k(){document.querySelector(`[${E}]`)?.remove()}function A(e,t,n,r){if(n)return n(e);let i=r?.textContent.trim()??``,a=e.name.startsWith(`@@`)?``:e.name;return`${t}${i||document.title||a||globalThis.location.pathname}`}function j(e){e&&(e.hasAttribute(`tabindex`)||e.setAttribute(`tabindex`,`-1`),e.focus({preventScroll:!0}))}function M(e){return e.button===0&&!e.metaKey&&!e.altKey&&!e.ctrlKey&&!e.shiftKey}function N(e,t,n){try{let r=e.buildUrl;if(r){let e=r(t,n);if(e!==void 0)return e}return e.buildPath(t,n)}catch{console.error(`[real-router] Route "${t}" is not defined. The element will render without an href attribute.`);return}}function P(e){return e?e.match(/\S+/g)??[]:[]}function F(e,t,n){if(e&&t){let e=P(t);if(e.length===0)return n??void 0;if(!n)return e.join(` `);let r=P(n),i=new Set(r);for(let t of e)i.has(t)||(i.add(t),r.push(t));return r.join(` `)}return n??void 0}function I(e,t){if(Object.is(e,t))return!0;if(!e||!t)return!1;let n=Object.keys(e);if(n.length!==Object.keys(t).length)return!1;let r=e,i=t;for(let e of n)if(!Object.is(r[e],i[e]))return!1;return!0}function L(e,t,n=!1,r=!0){let i=p(S(),e,t,{strict:n,ignoreQueryParams:r});return s(i.subscribe,i.getSnapshot,i.getSnapshot)}function R(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&&I(e.routeParams,t.routeParams)&&I(e.routeOptions,t.routeOptions)}const z=t(({routeName:e,routeParams:t=w,routeOptions:r=T,className:i,activeClassName:o=`active`,activeStrict:s=!1,ignoreQueryParams:c=!0,onClick:l,target:u,children:f,...p})=>{let m=S(),h=L(e,t,s,c),g=a(()=>N(m,e,t),[m,e,t]),_=n(n=>{l&&(l(n),n.defaultPrevented)||!M(n.nativeEvent)||u===`_blank`||(n.preventDefault(),m.navigate(e,t,r).catch(()=>{}))},[l,u,m,e,t,r]),v=F(h,o,i);return d(`a`,{...p,href:g,className:v,onClick:_,children:f})},R);z.displayName=`Link`;function B({children:e,fallback:t,onError:n}){let r=m(S()),a=s(r.subscribe,r.getSnapshot,r.getSnapshot),c=o(n);return c.current=n,i(()=>{a.error&&c.current?.(a.error,a.toRoute,a.fromRoute)},[a.version]),f(u,{children:[e,a.error?t(a.error,a.resetError):null]})}const V=()=>{let e=r(x);if(!e)throw Error(`useNavigator must be used within a RouterProvider`);return e},H=()=>l(v(S()).getTree()),U=()=>{let e=r(y);if(!e)throw Error(`useRoute must be used within a RouteProvider`);return e};function W(){let e=_(S());return s(e.subscribe,e.getSnapshot,e.getSnapshot)}const G=({router:e,children:t,announceNavigation:n})=>{i(()=>{if(!n)return;let t=D(e);return()=>{t.destroy()}},[n,e]);let r=a(()=>c(e),[e]),o=a(()=>g(e),[e]),l=s(o.subscribe,o.getSnapshot,o.getSnapshot),u=a(()=>({navigator:r,route:l.route,previousRoute:l.previousRoute}),[r,l]);return d(b.Provider,{value:e,children:d(x.Provider,{value:r,children:d(y.Provider,{value:u,children:t})})})};export{V as a,C as c,H as i,S as l,W as n,B as o,U as r,z as s,G as t};
+//# sourceMappingURL=RouterProvider-DqCTMwvh.mjs.map

package/dist/esm/RouterProvider-DqCTMwvh.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"RouterProvider-DqCTMwvh.mjs","names":[],"sources":["../../src/context.ts","../../src/hooks/useRouter.tsx","../../src/hooks/useRouteNode.tsx","../../src/constants.ts","../../../../shared/dom-utils/route-announcer.ts","../../../../shared/dom-utils/link-utils.ts","../../src/hooks/useIsActiveRoute.tsx","../../src/components/Link.tsx","../../src/components/RouterErrorBoundary.tsx","../../src/hooks/useNavigator.tsx","../../src/hooks/useRouteUtils.tsx","../../src/hooks/useRoute.tsx","../../src/hooks/useRouterTransition.tsx","../../src/RouterProvider.tsx"],"sourcesContent":["// packages/react/src/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/src/hooks/useRouter.tsx\n\nimport { useContext } from \"react\";\n\nimport { RouterContext } from \"../context\";\n\nimport type { Router } from \"@real-router/core\";\n\nexport const useRouter = (): Router => {\n  const router = useContext(RouterContext);\n\n  if (!router) {\n    throw new Error(\"useRouter must be used within a RouterProvider\");\n  }\n\n  return router;\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  // Use snapshot reference directly. createRouteNodeSource via stabilizeState\n  // returns the SAME snapshot when the node-relevant state did not change,\n  // so memoization on `[navigator, snapshot]` preserves identity for consumers.\n  const snapshot = useSyncExternalStore(\n    store.subscribe,\n    store.getSnapshot,\n    store.getSnapshot, // SSR: router returns same state on server and client\n  );\n\n  // getNavigator is WeakMap-cached in core; additional useMemo is redundant.\n  const navigator = getNavigator(router);\n\n  return useMemo(\n    (): RouteContext => ({\n      navigator,\n      route: snapshot.route,\n      previousRoute: snapshot.previousRoute,\n    }),\n    [navigator, snapshot],\n  );\n}\n","// packages/react/src/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 { Router, State } from \"@real-router/core\";\n\nconst CLEAR_DELAY = 7000;\nconst SAFARI_READY_DELAY = 100;\nconst ANNOUNCER_ATTR = \"data-real-router-announcer\";\nconst INTERNAL_ROUTE_PREFIX = \"@@\";\nconst VISUALLY_HIDDEN =\n  \"position:absolute;width:1px;height:1px;padding:0;margin:-1px;overflow:hidden;clip:rect(0,0,0,0);clip-path:inset(50%);white-space:nowrap;border:0\";\n\nexport interface RouteAnnouncerOptions {\n  prefix?: string;\n  getAnnouncementText?: (route: State) => string;\n}\n\nexport function createRouteAnnouncer(\n  router: Router,\n  options?: RouteAnnouncerOptions,\n): { destroy: () => void } {\n  const prefix = options?.prefix ?? \"Navigated to \";\n  const getCustomText = options?.getAnnouncementText;\n\n  let isInitialNavigation = true;\n  let isReady = false;\n  let isDestroyed = false;\n  let lastAnnouncedText = \"\";\n  let pendingText: string | null = null;\n  let clearTimeoutId: ReturnType<typeof setTimeout> | undefined;\n\n  const announcer = getOrCreateAnnouncer();\n\n  const doAnnounce = (text: string, h1: HTMLElement | null): void => {\n    lastAnnouncedText = text;\n    clearTimeout(clearTimeoutId);\n    announcer.textContent = text;\n    clearTimeoutId = setTimeout(() => {\n      announcer.textContent = \"\";\n      lastAnnouncedText = \"\";\n    }, CLEAR_DELAY);\n\n    manageFocus(h1);\n  };\n\n  // Safari-ready delay: announcing before VoiceOver wires up the aria-live region\n  // causes the first announcement to be silently dropped. Wait SAFARI_READY_DELAY ms\n  // before marking the announcer \"ready\" — any navigation during that window is\n  // buffered in pendingText and flushed once the delay expires.\n  const safariTimeoutId = setTimeout(() => {\n    isReady = true;\n\n    if (pendingText !== null && !isDestroyed) {\n      const text = pendingText;\n\n      pendingText = null;\n      doAnnounce(text, document.querySelector<HTMLElement>(\"h1\"));\n    }\n  }, SAFARI_READY_DELAY);\n\n  const unsubscribe = router.subscribe(({ route }) => {\n    if (isInitialNavigation) {\n      isInitialNavigation = false;\n\n      return;\n    }\n\n    // Double rAF: waits for two paint frames so the incoming route's DOM\n    // (including the new <h1>) is fully rendered before resolveText reads it.\n    // Single rAF fires before the new route's template has been attached,\n    // which would cause resolveText to pick up the OLD h1 or fall back to\n    // document.title / route.name prematurely.\n    requestAnimationFrame(() => {\n      requestAnimationFrame(() => {\n        if (isDestroyed) {\n          return;\n        }\n\n        const h1 = document.querySelector<HTMLElement>(\"h1\");\n        const text = resolveText(route, prefix, getCustomText, h1);\n\n        if (!text || text === lastAnnouncedText) {\n          return;\n        }\n\n        if (!isReady) {\n          // Defer announcement until Safari-ready window elapses (see safariTimeoutId).\n          pendingText = text;\n\n          return;\n        }\n\n        doAnnounce(text, h1);\n      });\n    });\n  });\n\n  return {\n    destroy() {\n      isDestroyed = true;\n      unsubscribe();\n      clearTimeout(clearTimeoutId);\n      clearTimeout(safariTimeoutId);\n      removeAnnouncer();\n    },\n  };\n}\n\nfunction getOrCreateAnnouncer(): HTMLElement {\n  const existing = document.querySelector<HTMLElement>(`[${ANNOUNCER_ATTR}]`);\n\n  if (existing) {\n    return existing;\n  }\n\n  const element = document.createElement(\"div\");\n\n  element.setAttribute(\"style\", VISUALLY_HIDDEN);\n  element.setAttribute(\"aria-live\", \"assertive\");\n  element.setAttribute(\"aria-atomic\", \"true\");\n  element.setAttribute(ANNOUNCER_ATTR, \"\");\n\n  document.body.prepend(element);\n\n  return element;\n}\n\nfunction removeAnnouncer(): void {\n  document.querySelector(`[${ANNOUNCER_ATTR}]`)?.remove();\n}\n\nfunction resolveText(\n  route: State,\n  prefix: string,\n  getCustomText: ((route: State) => string) | undefined,\n  h1: HTMLElement | null,\n): string {\n  if (getCustomText) {\n    return getCustomText(route);\n  }\n\n  const h1Text = h1?.textContent.trim() ?? \"\";\n  const routeName = route.name.startsWith(INTERNAL_ROUTE_PREFIX)\n    ? \"\"\n    : route.name;\n  const rawText =\n    h1Text || document.title || routeName || globalThis.location.pathname;\n\n  return `${prefix}${rawText}`;\n}\n\nfunction manageFocus(h1: HTMLElement | null): void {\n  if (!h1) {\n    return;\n  }\n\n  if (!h1.hasAttribute(\"tabindex\")) {\n    h1.setAttribute(\"tabindex\", \"-1\");\n  }\n\n  h1.focus({ preventScroll: true });\n}\n","import type { Router, Params } from \"@real-router/core\";\n\nexport function shouldNavigate(evt: MouseEvent): boolean {\n  return (\n    evt.button === 0 &&\n    !evt.metaKey &&\n    !evt.altKey &&\n    !evt.ctrlKey &&\n    !evt.shiftKey\n  );\n}\n\ntype BuildUrlFn = (name: string, params: Params) => string | undefined;\n\nexport function buildHref(\n  router: Router,\n  routeName: string,\n  routeParams: Params,\n): string | undefined {\n  try {\n    const buildUrl = router.buildUrl as BuildUrlFn | undefined;\n\n    if (buildUrl) {\n      const url = buildUrl(routeName, routeParams);\n\n      if (url !== undefined) {\n        return url;\n      }\n    }\n\n    return router.buildPath(routeName, routeParams);\n  } catch {\n    console.error(\n      `[real-router] Route \"${routeName}\" is not defined. The element will render without an href attribute.`,\n    );\n\n    return undefined;\n  }\n}\n\nfunction parseTokens(value: string | undefined): string[] {\n  return value ? (value.match(/\\S+/g) ?? []) : [];\n}\n\nexport function buildActiveClassName(\n  isActive: boolean,\n  activeClassName: string | undefined,\n  baseClassName: string | undefined,\n): string | undefined {\n  if (isActive && activeClassName) {\n    const activeTokens = parseTokens(activeClassName);\n\n    if (activeTokens.length === 0) {\n      return baseClassName ?? undefined;\n    }\n    if (!baseClassName) {\n      return activeTokens.join(\" \");\n    }\n\n    const baseTokens = parseTokens(baseClassName);\n    const seen = new Set(baseTokens);\n\n    for (const token of activeTokens) {\n      if (!seen.has(token)) {\n        seen.add(token);\n        baseTokens.push(token);\n      }\n    }\n\n    return baseTokens.join(\" \");\n  }\n\n  return baseClassName ?? undefined;\n}\n\nexport function shallowEqual(\n  prev: object | undefined,\n  next: object | undefined,\n): boolean {\n  if (Object.is(prev, next)) {\n    return true;\n  }\n  if (!prev || !next) {\n    return false;\n  }\n\n  const prevKeys = Object.keys(prev);\n\n  if (prevKeys.length !== Object.keys(next).length) {\n    return false;\n  }\n\n  const prevRecord = prev as Record<string, unknown>;\n  const nextRecord = next as Record<string, unknown>;\n\n  for (const key of prevKeys) {\n    if (!Object.is(prevRecord[key], nextRecord[key])) {\n      return false;\n    }\n  }\n\n  return true;\n}\n\nexport function applyLinkA11y(element: HTMLElement | null | undefined): void {\n  if (!element) {\n    return;\n  }\n  if (\n    element instanceof HTMLAnchorElement ||\n    element instanceof HTMLButtonElement\n  ) {\n    return;\n  }\n  if (!element.hasAttribute(\"role\")) {\n    element.setAttribute(\"role\", \"link\");\n  }\n  if (!element.hasAttribute(\"tabindex\")) {\n    element.setAttribute(\"tabindex\", \"0\");\n  }\n}\n","import { createActiveRouteSource } from \"@real-router/sources\";\nimport { useSyncExternalStore } from \"react\";\n\nimport { useRouter } from \"./useRouter\";\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  // createActiveRouteSource is per-router + canonical-args cached in\n  // @real-router/sources, so passing params by reference is safe — equivalent\n  // param shapes hit the same cache entry regardless of key order.\n  const store = createActiveRouteSource(router, routeName, params, {\n    strict,\n    ignoreQueryParams,\n  });\n\n  return useSyncExternalStore(\n    store.subscribe,\n    store.getSnapshot,\n    store.getSnapshot,\n  );\n}\n","import { memo, useCallback, useMemo } from \"react\";\n\nimport { EMPTY_PARAMS, EMPTY_OPTIONS } from \"../constants\";\nimport {\n  shouldNavigate,\n  buildHref,\n  buildActiveClassName,\n  shallowEqual,\n} from \"../dom-utils/index.js\";\nimport { useIsActiveRoute } from \"../hooks/useIsActiveRoute\";\nimport { useRouter } from \"../hooks/useRouter\";\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    shallowEqual(prev.routeParams, next.routeParams) &&\n    shallowEqual(prev.routeOptions, next.routeOptions)\n  );\n}\n\nconst LinkImpl: FC<LinkProps> = ({\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  // memo + areLinkPropsEqual guarantees that on bail-out the component does\n  // not render; on render, routeParams/routeOptions either changed reference\n  // (true change) or comparator failed (e.g., BigInt fallback to identity),\n  // so they're safe to use directly in hook deps.\n\n  const router = useRouter();\n\n  const isActive = useIsActiveRoute(\n    routeName,\n    routeParams,\n    activeStrict,\n    ignoreQueryParams,\n  );\n\n  const href = useMemo(\n    () => buildHref(router, routeName, routeParams),\n    [router, routeName, routeParams],\n  );\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.nativeEvent) || target === \"_blank\") {\n        return;\n      }\n\n      evt.preventDefault();\n      router.navigate(routeName, routeParams, routeOptions).catch(() => {});\n    },\n    [onClick, target, router, routeName, routeParams, routeOptions],\n  );\n\n  const finalClassName = buildActiveClassName(\n    isActive,\n    activeClassName,\n    className,\n  );\n\n  return (\n    <a {...props} href={href} className={finalClassName} onClick={handleClick}>\n      {children}\n    </a>\n  );\n};\n\nexport const Link: FC<LinkProps> = memo(LinkImpl, areLinkPropsEqual);\n\nLink.displayName = \"Link\";\n","import { createDismissableError } from \"@real-router/sources\";\nimport { useEffect, useRef, useSyncExternalStore } from \"react\";\n\nimport { useRouter } from \"../hooks/useRouter\";\n\nimport type { RouterError, State } from \"@real-router/core\";\nimport type { ReactNode, JSX } from \"react\";\n\nexport interface RouterErrorBoundaryProps {\n  readonly children: ReactNode;\n  readonly fallback: (error: RouterError, resetError: () => void) => ReactNode;\n  readonly onError?: (\n    error: RouterError,\n    toRoute: State | null,\n    fromRoute: State | null,\n  ) => void;\n}\n\nexport function RouterErrorBoundary({\n  children,\n  fallback,\n  onError,\n}: RouterErrorBoundaryProps): JSX.Element {\n  const router = useRouter();\n  const store = createDismissableError(router);\n  const snapshot = useSyncExternalStore(\n    store.subscribe,\n    store.getSnapshot,\n    store.getSnapshot,\n  );\n\n  const onErrorRef = useRef(onError);\n\n  // eslint-disable-next-line @eslint-react/refs -- \"latest ref\" pattern: sync callback to ref to avoid effect re-runs\n  onErrorRef.current = onError;\n\n  useEffect(() => {\n    if (snapshot.error) {\n      onErrorRef.current?.(\n        snapshot.error,\n        snapshot.toRoute,\n        snapshot.fromRoute,\n      );\n    }\n    // eslint-disable-next-line @eslint-react/exhaustive-deps -- onError tracked via ref, snapshot fields accessed inside callback\n  }, [snapshot.version]);\n\n  return (\n    <>\n      {children}\n      {snapshot.error ? fallback(snapshot.error, snapshot.resetError) : null}\n    </>\n  );\n}\n","// packages/react/src/hooks/useNavigator.tsx\n\nimport { useContext } from \"react\";\n\nimport { NavigatorContext } from \"../context\";\n\nimport type { Navigator } from \"@real-router/core\";\n\nexport const useNavigator = (): Navigator => {\n  const navigator = useContext(NavigatorContext);\n\n  if (!navigator) {\n    throw new Error(\"useNavigator must be used within a RouterProvider\");\n  }\n\n  return navigator;\n};\n","import { getPluginApi } from \"@real-router/core/api\";\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 * `getRouteUtils` is WeakMap-cached per `RouteTreeNode` inside\n * `@real-router/route-utils`, so the same router always returns the same\n * `RouteUtils` instance across renders — no local cache needed in the adapter.\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","// packages/react/src/hooks/useRoute.tsx\n\nimport { useContext } from \"react\";\n\nimport { RouteContext } from \"../context\";\n\nimport type { RouteContext as RouteContextType } from \"../types\";\n\nexport const useRoute = (): RouteContextType => {\n  const routeContext = useContext(RouteContext);\n\n  if (!routeContext) {\n    throw new Error(\"useRoute must be used within a RouteProvider\");\n  }\n\n  return routeContext;\n};\n","import { getTransitionSource } from \"@real-router/sources\";\nimport { useSyncExternalStore } from \"react\";\n\nimport { useRouter } from \"./useRouter\";\n\nimport type { RouterTransitionSnapshot } from \"@real-router/sources\";\n\nexport function useRouterTransition(): RouterTransitionSnapshot {\n  const router = useRouter();\n  const store = getTransitionSource(router);\n\n  return useSyncExternalStore(\n    store.subscribe,\n    store.getSnapshot,\n    store.getSnapshot,\n  );\n}\n","import { getNavigator } from \"@real-router/core\";\nimport { createRouteSource } from \"@real-router/sources\";\nimport { useEffect, useMemo, useSyncExternalStore } from \"react\";\n\nimport { NavigatorContext, RouteContext, RouterContext } from \"./context\";\nimport { createRouteAnnouncer } from \"./dom-utils/index.js\";\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  announceNavigation?: boolean;\n}\n\nexport const RouterProvider: FC<RouteProviderProps> = ({\n  router,\n  children,\n  announceNavigation,\n}) => {\n  useEffect(() => {\n    if (!announceNavigation) {\n      return;\n    }\n\n    const announcer = createRouteAnnouncer(router);\n\n    return () => {\n      announcer.destroy();\n    };\n  }, [announceNavigation, router]);\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  // Use snapshot reference directly. createRouteSource via stabilizeState\n  // returns the SAME snapshot reference when route.path is unchanged, so\n  // useMemo below sees stable deps for idempotent navigations and\n  // RouteContext consumers do not re-render.\n  const snapshot = 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    () => ({\n      navigator,\n      route: snapshot.route,\n      previousRoute: snapshot.previousRoute,\n    }),\n    [navigator, snapshot],\n  );\n\n  return (\n    <RouterContext.Provider value={router}>\n      <NavigatorContext.Provider value={navigator}>\n        <RouteContext.Provider value={routeContextValue}>\n          {children}\n        </RouteContext.Provider>\n      </NavigatorContext.Provider>\n    </RouterContext.Provider>\n  );\n};\n"],"mappings":"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"}

package/dist/esm/index.d.mts

@@ -1,4 +1,4 @@
-import { a as useRouteUtils, c as RouterErrorBoundary, d as LinkProps, i as useRoute, l as RouterErrorBoundaryProps, n as useRouterTransition, o as useNavigator, r as useRouteNode, s as useRouter, t as RouterProvider, u as Link } from "./RouterProvider-BuGQIoZ-.mjs";
+import { a as useRouteUtils, c as RouterErrorBoundary, d as LinkProps, i as useRoute, l as RouterErrorBoundaryProps, n as useRouterTransition, o as useNavigator, r as useRouteNode, s as useRouter, t as RouterProvider, u as Link } from "./RouterProvider-B2KCZfL_.mjs";
 import { ReactElement, ReactNode } from "react";
 import { Navigator } from "@real-router/core";
 import { RouterTransitionSnapshot } from "@real-router/sources";

package/dist/esm/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../../src/components/modern/RouteView/types.ts","../../src/components/modern/RouteView/components.tsx","../../src/components/modern/RouteView/RouteView.tsx"],"mappings":";;;;;;UAEiB,cAAA;;WAEN,QAAA;;WAEA,QAAA,EAAU,SAAA;AAAA;AAAA,UAGJ,UAAA;;WAEN,OAAA;EAPA;EAAA,SASA,KAAA;EAPU;EAAA,SASV,SAAA;EATmB;EAAA,SAWnB,QAAA,GAAW,SAAA;EARK;EAAA,SAUhB,QAAA,EAAU,SAAA;AAAA;AAAA,UAGJ,aAAA;EATN;EAAA,SAWA,QAAA,EAAU,SAAA;AAAA;;;iBCtBL,KAAA,CAAM,MAAA,EAAQ,UAAA;AAAA,kBAAd,KAAA;EAAA,IAAK,WAAA;AAAA;AAAA,iBAML,QAAA,CAAS,MAAA,EAAQ,aAAA;AAAA,kBAAjB,QAAA;EAAA,IAAQ,WAAA;AAAA;;;iBCCf,aAAA,CAAA;EACP,QAAA;EACA;AAAA,GACC,QAAA,CAAS,cAAA,IAAkB,YAAA;AAAA,kBAHrB,aAAA;EAAA,IAAa,WAAA;AAAA;AAAA,cAgCT,SAAA,SAAS,aAAA"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../../src/components/modern/RouteView/types.ts","../../src/components/modern/RouteView/components.tsx","../../src/components/modern/RouteView/RouteView.tsx"],"mappings":";;;;;;UAEiB,cAAA;;WAEN,QAAA;;WAEA,QAAA,EAAU,SAAA;AAAA;AAAA,UAGJ,UAAA;;WAEN,OAAA;EAPA;EAAA,SASA,KAAA;EAPU;EAAA,SASV,SAAA;EATmB;EAAA,SAWnB,QAAA,GAAW,SAAA;EARK;EAAA,SAUhB,QAAA,EAAU,SAAA;AAAA;AAAA,UAGJ,aAAA;EATN;EAAA,SAWA,QAAA,EAAU,SAAA;AAAA;;;iBCtBL,KAAA,CAAM,MAAA,EAAQ,UAAA;AAAA,kBAAd,KAAA;EAAA,IAAK,WAAA;AAAA;AAAA,iBAML,QAAA,CAAS,MAAA,EAAQ,aAAA;AAAA,kBAAjB,QAAA;EAAA,IAAQ,WAAA;AAAA;;;iBCCf,aAAA,CAAA;EACP,QAAA;EACA;AAAA,GACC,QAAA,CAAS,cAAA,IAAkB,YAAA;AAAA,kBAHrB,aAAA;EAAA,IAAa,WAAA;AAAA;AAAA,cA0CT,SAAA,SAAS,aAAA"}

package/dist/esm/index.mjs

@@ -1,2 +1,2 @@
-import{a as e,c as t,i as n,l as r,n as i,o as a,r as o,s,t as c}from"./RouterProvider-DrAGH6K9.mjs";import{Activity as l,Children as u,Fragment as d,Suspense as f,isValidElement as p,useRef as m}from"react";import{UNKNOWN_ROUTE as h}from"@real-router/core";import{startsWithSegment as g}from"@real-router/route-utils";import{Fragment as _,jsx as v}from"react/jsx-runtime";function y(e){return null}y.displayName=`RouteView.Match`;function b(e){return null}b.displayName=`RouteView.NotFound`;function x(e,t,n){return n?e===t:g(e,t)}function S(e,t){for(let n of u.toArray(e))p(n)&&(n.type===y||n.type===b?t.push(n):S(n.props.children,t))}function C(e,t,n,r,i){let a=i===void 0?e:v(f,{fallback:i,children:e});return n?v(l,{mode:r,children:a},t):v(d,{children:a},t)}function w(e,t,n,r){let i=null,a=!1,o=[];for(let s of e){if(s.type===b){i=s.props.children;continue}let{segment:e,exact:c=!1,keepAlive:l=!1,fallback:u}=s.props,d=n?`${n}.${e}`:e;!a&&x(t,d,c)?(a=!0,r.add(d),o.push(C(s.props.children,d,l,`visible`,u))):l&&r.has(d)&&o.push(C(s.props.children,d,l,`hidden`,u))}return!a&&t===h&&i!==null&&o.push(v(d,{children:i},`__route-view-not-found__`)),{rendered:o,activeMatchFound:a}}function T({nodeName:e,children:n}){let{route:r}=t(e),i=m(new Set);if(!r)return null;let a=[];S(n,a);let{rendered:o}=w(a,r.name,e,i.current);return o.length>0?v(_,{children:o}):null}T.displayName=`RouteView`;const E=Object.assign(T,{Match:y,NotFound:b});export{s as Link,E as RouteView,a as RouterErrorBoundary,c as RouterProvider,e as useNavigator,o as useRoute,t as useRouteNode,n as useRouteUtils,r as useRouter,i as useRouterTransition};
+import{a as e,c as t,i as n,l as r,n as i,o as a,r as o,s,t as c}from"./RouterProvider-DqCTMwvh.mjs";import{Activity as l,Children as u,Fragment as d,Suspense as f,isValidElement as p,useMemo as m,useRef as h}from"react";import{UNKNOWN_ROUTE as g}from"@real-router/core";import{startsWithSegment as _}from"@real-router/route-utils";import{Fragment as v,jsx as y}from"react/jsx-runtime";function b(e){return null}b.displayName=`RouteView.Match`;function x(e){return null}x.displayName=`RouteView.NotFound`;function S(e,t,n){return t===``?!1:n?e===t:_(e,t)}function C(e,t){for(let n of u.toArray(e))p(n)&&(n.type===b||n.type===x?t.push(n):C(n.props.children,t))}function w(e,t,n,r,i){let a=i===void 0?e:y(f,{fallback:i,children:e});return n?y(l,{mode:r,children:a},t):y(d,{children:a},t)}function T(e,t,n,r){let i=null,a=!1,o=[];for(let s of e){if(s.type===x){i=s.props.children;continue}let{segment:e,exact:c=!1,keepAlive:l=!1,fallback:u}=s.props,d=n?`${n}.${e}`:e;!a&&S(t,d,c)?(a=!0,r.add(d),o.push(w(s.props.children,d,l,`visible`,u))):l&&r.has(d)&&o.push(w(s.props.children,d,l,`hidden`,u))}return!a&&t===g&&i!==null&&o.push(y(d,{children:i},`__route-view-not-found__`)),{rendered:o,activeMatchFound:a}}function E({nodeName:e,children:n}){let{route:r}=t(e),i=h(null);i.current??=new Set;let a=m(()=>{let e=[];return C(n,e),e},[n]);if(!r)return null;let{rendered:o}=T(a,r.name,e,i.current);return o.length>0?y(v,{children:o}):null}E.displayName=`RouteView`;const D=Object.assign(E,{Match:b,NotFound:x});export{s as Link,D as RouteView,a as RouterErrorBoundary,c as RouterProvider,e as useNavigator,o as useRoute,t as useRouteNode,n as useRouteUtils,r as useRouter,i as useRouterTransition};
 //# sourceMappingURL=index.mjs.map

package/dist/esm/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":[],"sources":["../../src/components/modern/RouteView/components.tsx","../../src/components/modern/RouteView/helpers.tsx","../../src/components/modern/RouteView/RouteView.tsx"],"sourcesContent":["import type { MatchProps, NotFoundProps } from \"./types\";\n\nexport function Match(_props: MatchProps): null {\n  return null;\n}\n\nMatch.displayName = \"RouteView.Match\";\n\nexport function NotFound(_props: NotFoundProps): null {\n  return null;\n}\n\nNotFound.displayName = \"RouteView.NotFound\";\n","import { UNKNOWN_ROUTE } from \"@real-router/core\";\nimport { startsWithSegment } from \"@real-router/route-utils\";\nimport { Activity, Children, Fragment, Suspense, isValidElement } from \"react\";\n\nimport { Match, NotFound } from \"./components\";\n\nimport type { MatchProps, NotFoundProps } from \"./types\";\nimport type { ReactElement, ReactNode } from \"react\";\n\nfunction isSegmentMatch(\n  routeName: string,\n  fullSegmentName: string,\n  exact: boolean,\n): boolean {\n  if (exact) {\n    return routeName === fullSegmentName;\n  }\n\n  return startsWithSegment(routeName, fullSegmentName);\n}\n\nexport function collectElements(\n  children: ReactNode,\n  result: ReactElement[],\n): void {\n  // eslint-disable-next-line @eslint-react/no-children-to-array\n  for (const child of Children.toArray(children)) {\n    if (!isValidElement(child)) {\n      continue;\n    }\n\n    if (child.type === Match || child.type === NotFound) {\n      result.push(child);\n    } else {\n      collectElements(\n        (child.props as { readonly children: ReactNode }).children,\n        result,\n      );\n    }\n  }\n}\n\nfunction renderMatchElement(\n  matchChildren: ReactNode,\n  fullSegmentName: string,\n  keepAlive: boolean,\n  mode: \"visible\" | \"hidden\",\n  fallback?: ReactNode,\n): ReactElement {\n  const content =\n    fallback === undefined ? (\n      matchChildren\n    ) : (\n      <Suspense fallback={fallback}>{matchChildren}</Suspense>\n    );\n\n  if (keepAlive) {\n    return (\n      <Activity mode={mode} key={fullSegmentName}>\n        {content}\n      </Activity>\n    );\n  }\n\n  return <Fragment key={fullSegmentName}>{content}</Fragment>;\n}\n\nexport function buildRenderList(\n  elements: ReactElement[],\n  routeName: string,\n  nodeName: string,\n  hasBeenActivated: Set<string>,\n): { rendered: ReactElement[]; activeMatchFound: boolean } {\n  let notFoundChildren: ReactNode = null;\n  let activeMatchFound = false;\n  const rendered: ReactElement[] = [];\n\n  for (const child of elements) {\n    if (child.type === NotFound) {\n      notFoundChildren = (child.props as NotFoundProps).children;\n      continue;\n    }\n\n    const {\n      segment,\n      exact = false,\n      keepAlive = false,\n      fallback,\n    } = child.props as MatchProps;\n    const fullSegmentName = nodeName ? `${nodeName}.${segment}` : segment;\n    const isActive =\n      !activeMatchFound && isSegmentMatch(routeName, fullSegmentName, exact);\n\n    if (isActive) {\n      activeMatchFound = true;\n      hasBeenActivated.add(fullSegmentName);\n      rendered.push(\n        renderMatchElement(\n          (child.props as MatchProps).children,\n          fullSegmentName,\n          keepAlive,\n          \"visible\",\n          fallback,\n        ),\n      );\n    } else if (keepAlive && hasBeenActivated.has(fullSegmentName)) {\n      rendered.push(\n        renderMatchElement(\n          (child.props as MatchProps).children,\n          fullSegmentName,\n          keepAlive,\n          \"hidden\",\n          fallback,\n        ),\n      );\n    }\n  }\n\n  if (\n    !activeMatchFound &&\n    routeName === UNKNOWN_ROUTE &&\n    notFoundChildren !== null\n  ) {\n    rendered.push(\n      <Fragment key=\"__route-view-not-found__\">{notFoundChildren}</Fragment>,\n    );\n  }\n\n  return { rendered, activeMatchFound };\n}\n","import { useRef } from \"react\";\n\nimport { Match, NotFound } from \"./components\";\nimport { buildRenderList, collectElements } from \"./helpers\";\nimport { useRouteNode } from \"../../../hooks/useRouteNode\";\n\nimport type { RouteViewProps } from \"./types\";\nimport type { ReactElement } from \"react\";\n\nfunction RouteViewRoot({\n  nodeName,\n  children,\n}: Readonly<RouteViewProps>): ReactElement | null {\n  const { route } = useRouteNode(nodeName);\n  const hasBeenActivatedRef = useRef<Set<string>>(new Set());\n\n  if (!route) {\n    return null;\n  }\n\n  const elements: ReactElement[] = [];\n\n  collectElements(children, elements);\n\n  const { rendered } = buildRenderList(\n    elements,\n    route.name,\n    nodeName,\n    // eslint-disable-next-line @eslint-react/refs -- stable Set ref read for keepAlive tracking (never reassigned)\n    hasBeenActivatedRef.current,\n  );\n\n  if (rendered.length > 0) {\n    return <>{rendered}</>;\n  }\n\n  return null;\n}\n\nRouteViewRoot.displayName = \"RouteView\";\n\nexport const RouteView = Object.assign(RouteViewRoot, { Match, NotFound });\n\nexport type {\n  RouteViewProps,\n  MatchProps as RouteViewMatchProps,\n  NotFoundProps as RouteViewNotFoundProps,\n} from \"./types\";\n"],"mappings":"qXAEA,SAAgB,EAAM,EAA0B,CAC9C,OAAO,KAGT,EAAM,YAAc,kBAEpB,SAAgB,EAAS,EAA6B,CACpD,OAAO,KAGT,EAAS,YAAc,qBCHvB,SAAS,EACP,EACA,EACA,EACS,CAKT,OAJI,EACK,IAAc,EAGhB,EAAkB,EAAW,EAAgB,CAGtD,SAAgB,EACd,EACA,EACM,CAEN,IAAK,IAAM,KAAS,EAAS,QAAQ,EAAS,CACvC,EAAe,EAAM,GAItB,EAAM,OAAS,GAAS,EAAM,OAAS,EACzC,EAAO,KAAK,EAAM,CAElB,EACG,EAAM,MAA2C,SAClD,EACD,EAKP,SAAS,EACP,EACA,EACA,EACA,EACA,EACc,CACd,IAAM,EACJ,IAAa,IAAA,GACX,EAEA,EAAC,EAAD,CAAoB,oBAAW,EAAyB,CAAA,CAW5D,OARI,EAEA,EAAC,EAAD,CAAgB,gBACb,EACQ,CAFgB,EAEhB,CAIR,EAAC,EAAD,CAAA,SAAiC,EAAmB,CAArC,EAAqC,CAG7D,SAAgB,EACd,EACA,EACA,EACA,EACyD,CACzD,IAAI,EAA8B,KAC9B,EAAmB,GACjB,EAA2B,EAAE,CAEnC,IAAK,IAAM,KAAS,EAAU,CAC5B,GAAI,EAAM,OAAS,EAAU,CAC3B,EAAoB,EAAM,MAAwB,SAClD,SAGF,GAAM,CACJ,UACA,QAAQ,GACR,YAAY,GACZ,YACE,EAAM,MACJ,EAAkB,EAAW,GAAG,EAAS,GAAG,IAAY,EAE5D,CAAC,GAAoB,EAAe,EAAW,EAAiB,EAAM,EAGtE,EAAmB,GACnB,EAAiB,IAAI,EAAgB,CACrC,EAAS,KACP,EACG,EAAM,MAAqB,SAC5B,EACA,EACA,UACA,EACD,CACF,EACQ,GAAa,EAAiB,IAAI,EAAgB,EAC3D,EAAS,KACP,EACG,EAAM,MAAqB,SAC5B,EACA,EACA,SACA,EACD,CACF,CAcL,MATE,CAAC,GACD,IAAc,GACd,IAAqB,MAErB,EAAS,KACP,EAAC,EAAD,CAAA,SAA0C,EAA4B,CAAxD,2BAAwD,CACvE,CAGI,CAAE,WAAU,mBAAkB,CCvHvC,SAAS,EAAc,CACrB,WACA,YACgD,CAChD,GAAM,CAAE,SAAU,EAAa,EAAS,CAClC,EAAsB,EAAoB,IAAI,IAAM,CAE1D,GAAI,CAAC,EACH,OAAO,KAGT,IAAM,EAA2B,EAAE,CAEnC,EAAgB,EAAU,EAAS,CAEnC,GAAM,CAAE,YAAa,EACnB,EACA,EAAM,KACN,EAEA,EAAoB,QACrB,CAMD,OAJI,EAAS,OAAS,EACb,EAAA,EAAA,CAAA,SAAG,EAAY,CAAA,CAGjB,KAGT,EAAc,YAAc,YAE5B,MAAa,EAAY,OAAO,OAAO,EAAe,CAAE,QAAO,WAAU,CAAC"}
+{"version":3,"file":"index.mjs","names":[],"sources":["../../src/components/modern/RouteView/components.tsx","../../src/components/modern/RouteView/helpers.tsx","../../src/components/modern/RouteView/RouteView.tsx"],"sourcesContent":["import type { MatchProps, NotFoundProps } from \"./types\";\n\nexport function Match(_props: MatchProps): null {\n  return null;\n}\n\nMatch.displayName = \"RouteView.Match\";\n\nexport function NotFound(_props: NotFoundProps): null {\n  return null;\n}\n\nNotFound.displayName = \"RouteView.NotFound\";\n","import { UNKNOWN_ROUTE } from \"@real-router/core\";\nimport { startsWithSegment } from \"@real-router/route-utils\";\nimport { Activity, Children, Fragment, Suspense, isValidElement } from \"react\";\n\nimport { Match, NotFound } from \"./components\";\n\nimport type { MatchProps, NotFoundProps } from \"./types\";\nimport type { ReactElement, ReactNode } from \"react\";\n\nfunction isSegmentMatch(\n  routeName: string,\n  fullSegmentName: string,\n  exact: boolean,\n): boolean {\n  if (fullSegmentName === \"\") {\n    return false;\n  }\n\n  if (exact) {\n    return routeName === fullSegmentName;\n  }\n\n  return startsWithSegment(routeName, fullSegmentName);\n}\n\nexport function collectElements(\n  children: ReactNode,\n  result: ReactElement[],\n): void {\n  // eslint-disable-next-line @eslint-react/no-children-to-array\n  for (const child of Children.toArray(children)) {\n    if (!isValidElement(child)) {\n      continue;\n    }\n\n    if (child.type === Match || child.type === NotFound) {\n      result.push(child);\n    } else {\n      collectElements(\n        (child.props as { readonly children: ReactNode }).children,\n        result,\n      );\n    }\n  }\n}\n\nfunction renderMatchElement(\n  matchChildren: ReactNode,\n  fullSegmentName: string,\n  keepAlive: boolean,\n  mode: \"visible\" | \"hidden\",\n  fallback?: ReactNode,\n): ReactElement {\n  const content =\n    fallback === undefined ? (\n      matchChildren\n    ) : (\n      <Suspense fallback={fallback}>{matchChildren}</Suspense>\n    );\n\n  if (keepAlive) {\n    return (\n      <Activity mode={mode} key={fullSegmentName}>\n        {content}\n      </Activity>\n    );\n  }\n\n  return <Fragment key={fullSegmentName}>{content}</Fragment>;\n}\n\nexport function buildRenderList(\n  elements: ReactElement[],\n  routeName: string,\n  nodeName: string,\n  hasBeenActivated: Set<string>,\n): { rendered: ReactElement[]; activeMatchFound: boolean } {\n  let notFoundChildren: ReactNode = null;\n  let activeMatchFound = false;\n  const rendered: ReactElement[] = [];\n\n  for (const child of elements) {\n    if (child.type === NotFound) {\n      notFoundChildren = (child.props as NotFoundProps).children;\n      continue;\n    }\n\n    const {\n      segment,\n      exact = false,\n      keepAlive = false,\n      fallback,\n    } = child.props as MatchProps;\n    const fullSegmentName = nodeName ? `${nodeName}.${segment}` : segment;\n    const isActive =\n      !activeMatchFound && isSegmentMatch(routeName, fullSegmentName, exact);\n\n    if (isActive) {\n      activeMatchFound = true;\n      hasBeenActivated.add(fullSegmentName);\n      rendered.push(\n        renderMatchElement(\n          (child.props as MatchProps).children,\n          fullSegmentName,\n          keepAlive,\n          \"visible\",\n          fallback,\n        ),\n      );\n    } else if (keepAlive && hasBeenActivated.has(fullSegmentName)) {\n      rendered.push(\n        renderMatchElement(\n          (child.props as MatchProps).children,\n          fullSegmentName,\n          keepAlive,\n          \"hidden\",\n          fallback,\n        ),\n      );\n    }\n  }\n\n  if (\n    !activeMatchFound &&\n    routeName === UNKNOWN_ROUTE &&\n    notFoundChildren !== null\n  ) {\n    rendered.push(\n      <Fragment key=\"__route-view-not-found__\">{notFoundChildren}</Fragment>,\n    );\n  }\n\n  return { rendered, activeMatchFound };\n}\n","import { useMemo, useRef } from \"react\";\n\nimport { Match, NotFound } from \"./components\";\nimport { buildRenderList, collectElements } from \"./helpers\";\nimport { useRouteNode } from \"../../../hooks/useRouteNode\";\n\nimport type { RouteViewProps } from \"./types\";\nimport type { ReactElement } from \"react\";\n\nfunction RouteViewRoot({\n  nodeName,\n  children,\n}: Readonly<RouteViewProps>): ReactElement | null {\n  const { route } = useRouteNode(nodeName);\n  const hasBeenActivatedRef = useRef<Set<string> | null>(null);\n\n  // eslint-disable-next-line @eslint-react/refs -- lazy init: assign once when null to avoid `new Set()` allocation on every render\n  hasBeenActivatedRef.current ??= new Set();\n\n  // Skip the Children.toArray + collectElements traversal when children\n  // reference is unchanged. children only changes when the parent re-renders\n  // with a new ReactNode, so this caches the steady-state.\n  const elements = useMemo(() => {\n    const collected: ReactElement[] = [];\n\n    collectElements(children, collected);\n\n    return collected;\n  }, [children]);\n\n  if (!route) {\n    return null;\n  }\n\n  const { rendered } = buildRenderList(\n    elements,\n    route.name,\n    nodeName,\n    // eslint-disable-next-line @eslint-react/refs -- stable Set ref read for keepAlive tracking (never reassigned)\n    hasBeenActivatedRef.current,\n  );\n\n  if (rendered.length > 0) {\n    return <>{rendered}</>;\n  }\n\n  return null;\n}\n\nRouteViewRoot.displayName = \"RouteView\";\n\nexport const RouteView = Object.assign(RouteViewRoot, { Match, NotFound });\n\nexport type {\n  RouteViewProps,\n  MatchProps as RouteViewMatchProps,\n  NotFoundProps as RouteViewNotFoundProps,\n} from \"./types\";\n"],"mappings":"kYAEA,SAAgB,EAAM,EAA0B,CAC9C,OAAO,KAGT,EAAM,YAAc,kBAEpB,SAAgB,EAAS,EAA6B,CACpD,OAAO,KAGT,EAAS,YAAc,qBCHvB,SAAS,EACP,EACA,EACA,EACS,CAST,OARI,IAAoB,GACf,GAGL,EACK,IAAc,EAGhB,EAAkB,EAAW,EAAgB,CAGtD,SAAgB,EACd,EACA,EACM,CAEN,IAAK,IAAM,KAAS,EAAS,QAAQ,EAAS,CACvC,EAAe,EAAM,GAItB,EAAM,OAAS,GAAS,EAAM,OAAS,EACzC,EAAO,KAAK,EAAM,CAElB,EACG,EAAM,MAA2C,SAClD,EACD,EAKP,SAAS,EACP,EACA,EACA,EACA,EACA,EACc,CACd,IAAM,EACJ,IAAa,IAAA,GACX,EAEA,EAAC,EAAD,CAAoB,oBAAW,EAAyB,CAAA,CAW5D,OARI,EAEA,EAAC,EAAD,CAAgB,gBACb,EACQ,CAFgB,EAEhB,CAIR,EAAC,EAAD,CAAA,SAAiC,EAAmB,CAArC,EAAqC,CAG7D,SAAgB,EACd,EACA,EACA,EACA,EACyD,CACzD,IAAI,EAA8B,KAC9B,EAAmB,GACjB,EAA2B,EAAE,CAEnC,IAAK,IAAM,KAAS,EAAU,CAC5B,GAAI,EAAM,OAAS,EAAU,CAC3B,EAAoB,EAAM,MAAwB,SAClD,SAGF,GAAM,CACJ,UACA,QAAQ,GACR,YAAY,GACZ,YACE,EAAM,MACJ,EAAkB,EAAW,GAAG,EAAS,GAAG,IAAY,EAE5D,CAAC,GAAoB,EAAe,EAAW,EAAiB,EAAM,EAGtE,EAAmB,GACnB,EAAiB,IAAI,EAAgB,CACrC,EAAS,KACP,EACG,EAAM,MAAqB,SAC5B,EACA,EACA,UACA,EACD,CACF,EACQ,GAAa,EAAiB,IAAI,EAAgB,EAC3D,EAAS,KACP,EACG,EAAM,MAAqB,SAC5B,EACA,EACA,SACA,EACD,CACF,CAcL,MATE,CAAC,GACD,IAAc,GACd,IAAqB,MAErB,EAAS,KACP,EAAC,EAAD,CAAA,SAA0C,EAA4B,CAAxD,2BAAwD,CACvE,CAGI,CAAE,WAAU,mBAAkB,CC3HvC,SAAS,EAAc,CACrB,WACA,YACgD,CAChD,GAAM,CAAE,SAAU,EAAa,EAAS,CAClC,EAAsB,EAA2B,KAAK,CAG5D,EAAoB,UAAY,IAAI,IAKpC,IAAM,EAAW,MAAc,CAC7B,IAAM,EAA4B,EAAE,CAIpC,OAFA,EAAgB,EAAU,EAAU,CAE7B,GACN,CAAC,EAAS,CAAC,CAEd,GAAI,CAAC,EACH,OAAO,KAGT,GAAM,CAAE,YAAa,EACnB,EACA,EAAM,KACN,EAEA,EAAoB,QACrB,CAMD,OAJI,EAAS,OAAS,EACb,EAAA,EAAA,CAAA,SAAG,EAAY,CAAA,CAGjB,KAGT,EAAc,YAAc,YAE5B,MAAa,EAAY,OAAO,OAAO,EAAe,CAAE,QAAO,WAAU,CAAC"}

package/dist/esm/legacy.d.mts

@@ -1,4 +1,4 @@
-import { a as useRouteUtils, c as RouterErrorBoundary, d as LinkProps, i as useRoute, l as RouterErrorBoundaryProps, n as useRouterTransition, o as useNavigator, r as useRouteNode, s as useRouter, t as RouterProvider, u as Link } from "./RouterProvider-BuGQIoZ-.mjs";
+import { a as useRouteUtils, c as RouterErrorBoundary, d as LinkProps, i as useRoute, l as RouterErrorBoundaryProps, n as useRouterTransition, o as useNavigator, r as useRouteNode, s as useRouter, t as RouterProvider, u as Link } from "./RouterProvider-B2KCZfL_.mjs";
 import { Navigator } from "@real-router/core";
 import { RouterTransitionSnapshot } from "@real-router/sources";
 export { Link, type LinkProps, type Navigator, RouterErrorBoundary, type RouterErrorBoundaryProps, RouterProvider, type RouterTransitionSnapshot, useNavigator, useRoute, useRouteNode, useRouteUtils, useRouter, useRouterTransition };

package/dist/esm/legacy.mjs

@@ -1 +1 @@
-import{a as e,c as t,i as n,l as r,n as i,o as a,r as o,s,t as c}from"./RouterProvider-DrAGH6K9.mjs";export{s as Link,a as RouterErrorBoundary,c as RouterProvider,e as useNavigator,o as useRoute,t as useRouteNode,n as useRouteUtils,r as useRouter,i as useRouterTransition};
+import{a as e,c as t,i as n,l as r,n as i,o as a,r as o,s,t as c}from"./RouterProvider-DqCTMwvh.mjs";export{s as Link,a as RouterErrorBoundary,c as RouterProvider,e as useNavigator,o as useRoute,t as useRouteNode,n as useRouteUtils,r as useRouter,i as useRouterTransition};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@real-router/react",
-  "version": "0.15.1",
+  "version": "0.16.1",
   "type": "commonjs",
   "description": "React integration for Real-Router",
   "main": "./dist/cjs/index.js",
@@ -66,7 +66,7 @@
   "dependencies": {
     "@real-router/core": "^0.48.0",
     "@real-router/route-utils": "^0.2.1",
-    "@real-router/sources": "^0.5.1"
+    "@real-router/sources": "^0.6.0"
   },
   "devDependencies": {
     "@testing-library/dom": "10.4.1",
@@ -74,7 +74,7 @@
     "@testing-library/react": "16.3.2",
     "@testing-library/user-event": "14.6.1",
     "vitest-react-profiler": "1.12.0",
-    "@real-router/browser-plugin": "^0.12.1"
+    "@real-router/browser-plugin": "^0.13.0"
   },
   "peerDependencies": {
     "@types/react": ">=18.0.0",
@@ -83,13 +83,13 @@
     "react-dom": ">=18.0.0"
   },
   "scripts": {
-    "build": "tsdown --config-loader unrun",
     "test": "vitest",
     "test:properties": "vitest run --config vitest.config.properties.mts",
     "test:stress": "vitest run --config vitest.config.stress.mts",
     "type-check": "tsc --noEmit",
     "lint": "eslint --cache --ext .ts,.tsx src/ tests/ --fix --max-warnings 0",
     "lint:package": "publint",
-    "lint:types": "attw --pack ."
+    "lint:types": "attw --pack .",
+    "bundle": "tsdown --config-loader unrun"
   }
 }

package/src/RouterProvider.tsx

@@ -37,22 +37,32 @@ export const RouterProvider: FC<RouteProviderProps> = ({
   // subscribe connects to router on first listener, unsubscribes on last.
   // This is Strict Mode safe — no useEffect cleanup needed.
   const store = useMemo(() => createRouteSource(router), [router]);
-  const { route, previousRoute } = useSyncExternalStore(
+  // Use snapshot reference directly. createRouteSource via stabilizeState
+  // returns the SAME snapshot reference when route.path is unchanged, so
+  // useMemo below sees stable deps for idempotent navigations and
+  // RouteContext consumers do not re-render.
+  const snapshot = useSyncExternalStore(
     store.subscribe,
     store.getSnapshot,
     store.getSnapshot, // SSR: router returns same state on server and client
   );
 
   const routeContextValue = useMemo(
-    () => ({ navigator, route, previousRoute }),
-    [navigator, route, previousRoute],
+    () => ({
+      navigator,
+      route: snapshot.route,
+      previousRoute: snapshot.previousRoute,
+    }),
+    [navigator, snapshot],
   );
 
   return (
-    <RouterContext value={router}>
-      <NavigatorContext value={navigator}>
-        <RouteContext value={routeContextValue}>{children}</RouteContext>
-      </NavigatorContext>
-    </RouterContext>
+    <RouterContext.Provider value={router}>
+      <NavigatorContext.Provider value={navigator}>
+        <RouteContext.Provider value={routeContextValue}>
+          {children}
+        </RouteContext.Provider>
+      </NavigatorContext.Provider>
+    </RouterContext.Provider>
   );
 };

package/src/components/Link.tsx

@@ -5,10 +5,10 @@ import {
   shouldNavigate,
   buildHref,
   buildActiveClassName,
+  shallowEqual,
 } from "../dom-utils/index.js";
 import { useIsActiveRoute } from "../hooks/useIsActiveRoute";
 import { useRouter } from "../hooks/useRouter";
-import { useStableValue } from "../hooks/useStableValue";
 
 import type { LinkProps } from "../types";
 import type { FC, MouseEvent } from "react";
@@ -27,79 +27,76 @@ function areLinkPropsEqual(
     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)
+    shallowEqual(prev.routeParams, next.routeParams) &&
+    shallowEqual(prev.routeOptions, next.routeOptions)
   );
 }
 
-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();
+const LinkImpl: FC<LinkProps> = ({
+  routeName,
+  routeParams = EMPTY_PARAMS,
+  routeOptions = EMPTY_OPTIONS,
+  className,
+  activeClassName = "active",
+  activeStrict = false,
+  ignoreQueryParams = true,
+  onClick,
+  target,
+  children,
+  ...props
+}) => {
+  // memo + areLinkPropsEqual guarantees that on bail-out the component does
+  // not render; on render, routeParams/routeOptions either changed reference
+  // (true change) or comparator failed (e.g., BigInt fallback to identity),
+  // so they're safe to use directly in hook deps.
 
-    const stableParams = useStableValue(routeParams);
-    const stableOptions = useStableValue(routeOptions);
+  const router = useRouter();
 
-    const isActive = useIsActiveRoute(
-      routeName,
-      stableParams,
-      activeStrict,
-      ignoreQueryParams,
-    );
-
-    const href = useMemo(
-      () => buildHref(router, routeName, stableParams),
-      [router, routeName, stableParams],
-    );
+  const isActive = useIsActiveRoute(
+    routeName,
+    routeParams,
+    activeStrict,
+    ignoreQueryParams,
+  );
 
-    const handleClick = useCallback(
-      (evt: MouseEvent<HTMLAnchorElement>) => {
-        if (onClick) {
-          onClick(evt);
+  const href = useMemo(
+    () => buildHref(router, routeName, routeParams),
+    [router, routeName, routeParams],
+  );
 
-          if (evt.defaultPrevented) {
-            return;
-          }
-        }
+  const handleClick = useCallback(
+    (evt: MouseEvent<HTMLAnchorElement>) => {
+      if (onClick) {
+        onClick(evt);
 
-        if (!shouldNavigate(evt.nativeEvent) || target === "_blank") {
+        if (evt.defaultPrevented) {
           return;
         }
+      }
 
-        evt.preventDefault();
-        router.navigate(routeName, stableParams, stableOptions).catch(() => {});
-      },
-      [onClick, target, router, routeName, stableParams, stableOptions],
-    );
+      if (!shouldNavigate(evt.nativeEvent) || target === "_blank") {
+        return;
+      }
 
-    const finalClassName = useMemo(
-      () => buildActiveClassName(isActive, activeClassName, className),
-      [isActive, activeClassName, className],
-    );
+      evt.preventDefault();
+      router.navigate(routeName, routeParams, routeOptions).catch(() => {});
+    },
+    [onClick, target, router, routeName, routeParams, routeOptions],
+  );
+
+  const finalClassName = buildActiveClassName(
+    isActive,
+    activeClassName,
+    className,
+  );
+
+  return (
+    <a {...props} href={href} className={finalClassName} onClick={handleClick}>
+      {children}
+    </a>
+  );
+};
 
-    return (
-      <a
-        {...props}
-        href={href}
-        className={finalClassName}
-        onClick={handleClick}
-      >
-        {children}
-      </a>
-    );
-  },
-  areLinkPropsEqual,
-);
+export const Link: FC<LinkProps> = memo(LinkImpl, areLinkPropsEqual);
 
 Link.displayName = "Link";

package/src/components/RouterErrorBoundary.tsx

@@ -1,6 +1,7 @@
-import { useCallback, useEffect, useRef, useState } from "react";
+import { createDismissableError } from "@real-router/sources";
+import { useEffect, useRef, useSyncExternalStore } from "react";
 
-import { useRouterError } from "../hooks/useRouterError";
+import { useRouter } from "../hooks/useRouter";
 
 import type { RouterError, State } from "@real-router/core";
 import type { ReactNode, JSX } from "react";
@@ -20,8 +21,13 @@ export function RouterErrorBoundary({
   fallback,
   onError,
 }: RouterErrorBoundaryProps): JSX.Element {
-  const snapshot = useRouterError();
-  const [dismissedVersion, setDismissedVersion] = useState(-1);
+  const router = useRouter();
+  const store = createDismissableError(router);
+  const snapshot = useSyncExternalStore(
+    store.subscribe,
+    store.getSnapshot,
+    store.getSnapshot,
+  );
 
   const onErrorRef = useRef(onError);
 
@@ -39,17 +45,10 @@ export function RouterErrorBoundary({
     // eslint-disable-next-line @eslint-react/exhaustive-deps -- onError tracked via ref, snapshot fields accessed inside callback
   }, [snapshot.version]);
 
-  const visibleError =
-    snapshot.version > dismissedVersion ? snapshot.error : null;
-
-  const resetError = useCallback(() => {
-    setDismissedVersion(snapshot.version);
-  }, [snapshot.version]);
-
   return (
     <>
       {children}
-      {visibleError ? fallback(visibleError, resetError) : null}
+      {snapshot.error ? fallback(snapshot.error, snapshot.resetError) : null}
     </>
   );
 }

package/src/components/modern/RouteView/RouteView.tsx

@@ -1,4 +1,4 @@
-import { useRef } from "react";
+import { useMemo, useRef } from "react";
 
 import { Match, NotFound } from "./components";
 import { buildRenderList, collectElements } from "./helpers";
@@ -12,16 +12,26 @@ function RouteViewRoot({
   children,
 }: Readonly<RouteViewProps>): ReactElement | null {
   const { route } = useRouteNode(nodeName);
-  const hasBeenActivatedRef = useRef<Set<string>>(new Set());
+  const hasBeenActivatedRef = useRef<Set<string> | null>(null);
+
+  // eslint-disable-next-line @eslint-react/refs -- lazy init: assign once when null to avoid `new Set()` allocation on every render
+  hasBeenActivatedRef.current ??= new Set();
+
+  // Skip the Children.toArray + collectElements traversal when children
+  // reference is unchanged. children only changes when the parent re-renders
+  // with a new ReactNode, so this caches the steady-state.
+  const elements = useMemo(() => {
+    const collected: ReactElement[] = [];
+
+    collectElements(children, collected);
+
+    return collected;
+  }, [children]);
 
   if (!route) {
     return null;
   }
 
-  const elements: ReactElement[] = [];
-
-  collectElements(children, elements);
-
   const { rendered } = buildRenderList(
     elements,
     route.name,

package/src/components/modern/RouteView/helpers.tsx

@@ -12,6 +12,10 @@ function isSegmentMatch(
   fullSegmentName: string,
   exact: boolean,
 ): boolean {
+  if (fullSegmentName === "") {
+    return false;
+  }
+
   if (exact) {
     return routeName === fullSegmentName;
   }

package/src/constants.ts

@@ -1,4 +1,4 @@
-// packages/react/modules/constants.ts
+// packages/react/src/constants.ts
 
 /**
  * Stable empty object for default params

package/src/context.ts

@@ -1,4 +1,4 @@
-// packages/react/modules/context.ts
+// packages/react/src/context.ts
 
 import { createContext } from "react";
 

package/src/hooks/useIsActiveRoute.tsx

@@ -1,8 +1,7 @@
 import { createActiveRouteSource } from "@real-router/sources";
-import { useMemo, useSyncExternalStore } from "react";
+import { useSyncExternalStore } from "react";
 
 import { useRouter } from "./useRouter";
-import { useStableValue } from "./useStableValue";
 
 import type { Params } from "@real-router/core";
 
@@ -14,23 +13,17 @@ export function useIsActiveRoute(
 ): boolean {
   const router = useRouter();
 
-  // useStableValue: JSON.stringify memoization of params object.
-  // Without it, every render with a new params reference (e.g.,
-  // <Link routeParams={{ id: '123' }} />) would recreate the store.
-  const stableParams = useStableValue(params);
-
-  const store = useMemo(
-    () =>
-      createActiveRouteSource(router, routeName, stableParams, {
-        strict,
-        ignoreQueryParams,
-      }),
-    [router, routeName, stableParams, strict, ignoreQueryParams],
-  );
+  // createActiveRouteSource is per-router + canonical-args cached in
+  // @real-router/sources, so passing params by reference is safe — equivalent
+  // param shapes hit the same cache entry regardless of key order.
+  const store = createActiveRouteSource(router, routeName, params, {
+    strict,
+    ignoreQueryParams,
+  });
 
   return useSyncExternalStore(
     store.subscribe,
     store.getSnapshot,
-    store.getSnapshot, // SSR: router returns same state on server and client
+    store.getSnapshot,
   );
 }

package/src/hooks/useNavigator.tsx

@@ -1,4 +1,4 @@
-// packages/react/modules/hooks/useNavigator.tsx
+// packages/react/src/hooks/useNavigator.tsx
 
 import { useContext } from "react";
 

package/src/hooks/useRoute.tsx

@@ -1,4 +1,4 @@
-// packages/react/modules/hooks/useRoute.tsx
+// packages/react/src/hooks/useRoute.tsx
 
 import { useContext } from "react";
 

package/src/hooks/useRouteNode.tsx

@@ -14,16 +14,24 @@ export function useRouteNode(nodeName: string): RouteContext {
     [router, nodeName],
   );
 
-  const { route, previousRoute } = useSyncExternalStore(
+  // Use snapshot reference directly. createRouteNodeSource via stabilizeState
+  // returns the SAME snapshot when the node-relevant state did not change,
+  // so memoization on `[navigator, snapshot]` preserves identity for consumers.
+  const snapshot = useSyncExternalStore(
     store.subscribe,
     store.getSnapshot,
     store.getSnapshot, // SSR: router returns same state on server and client
   );
 
-  const navigator = useMemo(() => getNavigator(router), [router]);
+  // getNavigator is WeakMap-cached in core; additional useMemo is redundant.
+  const navigator = getNavigator(router);
 
   return useMemo(
-    (): RouteContext => ({ navigator, route, previousRoute }),
-    [navigator, route, previousRoute],
+    (): RouteContext => ({
+      navigator,
+      route: snapshot.route,
+      previousRoute: snapshot.previousRoute,
+    }),
+    [navigator, snapshot],
   );
 }

package/src/hooks/useRouteUtils.tsx

@@ -1,5 +1,3 @@
-// packages/react/modules/hooks/useRouteUtils.tsx
-
 import { getPluginApi } from "@real-router/core/api";
 import { getRouteUtils } from "@real-router/route-utils";
 
@@ -10,8 +8,9 @@ import type { RouteUtils } from "@real-router/route-utils";
 /**
  * Returns a pre-computed {@link RouteUtils} instance for the current router.
  *
- * Internally retrieves the route tree via `getPluginApi` and delegates
- * to `getRouteUtils`, which caches instances per tree reference (WeakMap).
+ * `getRouteUtils` is WeakMap-cached per `RouteTreeNode` inside
+ * `@real-router/route-utils`, so the same router always returns the same
+ * `RouteUtils` instance across renders — no local cache needed in the adapter.
  *
  * @returns RouteUtils instance with pre-computed chains and siblings
  *

package/src/hooks/useRouter.tsx

@@ -1,4 +1,4 @@
-// packages/react/modules/hooks/useRouter.tsx
+// packages/react/src/hooks/useRouter.tsx
 
 import { useContext } from "react";
 

package/src/hooks/useRouterTransition.tsx

@@ -1,5 +1,5 @@
-import { createTransitionSource } from "@real-router/sources";
-import { useMemo, useSyncExternalStore } from "react";
+import { getTransitionSource } from "@real-router/sources";
+import { useSyncExternalStore } from "react";
 
 import { useRouter } from "./useRouter";
 
@@ -7,8 +7,7 @@ import type { RouterTransitionSnapshot } from "@real-router/sources";
 
 export function useRouterTransition(): RouterTransitionSnapshot {
   const router = useRouter();
-
-  const store = useMemo(() => createTransitionSource(router), [router]);
+  const store = getTransitionSource(router);
 
   return useSyncExternalStore(
     store.subscribe,

package/dist/cjs/RouterProvider-jqJCKUhp.js

@@ -1,2 +0,0 @@
-let e=require(`react`),t=require(`@real-router/core`),n=require(`@real-router/route-utils`),r=require(`react/jsx-runtime`),i=require(`@real-router/sources`),a=require(`@real-router/core/api`);const o=(0,e.createContext)(null),s=(0,e.createContext)(null),c=(0,e.createContext)(null),l=()=>{let t=(0,e.useContext)(s);if(!t)throw Error(`useRouter must be used within a RouterProvider`);return t};function u(n){let r=l(),a=(0,e.useMemo)(()=>(0,i.createRouteNodeSource)(r,n),[r,n]),{route:o,previousRoute:s}=(0,e.useSyncExternalStore)(a.subscribe,a.getSnapshot,a.getSnapshot),c=(0,e.useMemo)(()=>(0,t.getNavigator)(r),[r]);return(0,e.useMemo)(()=>({navigator:c,route:o,previousRoute:s}),[c,o,s])}const d=Object.freeze({}),f=Object.freeze({}),p=`data-real-router-announcer`;function m(e,t){let n=t?.prefix??`Navigated to `,r=t?.getAnnouncementText,i=!0,a=!1,o=!1,s=``,c,l=h(),u=setTimeout(()=>{a=!0},100),d=e.subscribe(({route:e})=>{if(i){i=!1;return}requestAnimationFrame(()=>{requestAnimationFrame(()=>{if(o)return;let t=_(e,n,r);t&&t!==s&&a&&(s=t,clearTimeout(c),l.textContent=t,c=setTimeout(()=>{l.textContent=``,s=``},7e3),v())})})});return{destroy(){o=!0,d(),clearTimeout(c),clearTimeout(u),g()}}}function h(){let e=document.querySelector(`[${p}]`);if(e)return e;let t=document.createElement(`div`);return t.setAttribute(`style`,`position:absolute;width:1px;height:1px;padding:0;margin:-1px;overflow:hidden;clip:rect(0,0,0,0);clip-path:inset(50%);white-space:nowrap;border:0`),t.setAttribute(`aria-live`,`assertive`),t.setAttribute(`aria-atomic`,`true`),t.setAttribute(p,``),document.body.prepend(t),t}function g(){document.querySelector(`[${p}]`)?.remove()}function _(e,t,n){if(n)return n(e);let r=document.querySelector(`h1`)?.textContent.trim()??``,i=e.name.startsWith(`@@`)?``:e.name;return`${t}${r||document.title||i||globalThis.location.pathname}`}function v(){let e=document.querySelector(`h1`);e&&(e.hasAttribute(`tabindex`)||e.setAttribute(`tabindex`,`-1`),e.focus({preventScroll:!0}))}function y(e){return e.button===0&&!e.metaKey&&!e.altKey&&!e.ctrlKey&&!e.shiftKey}function b(e,t,n){try{let r=e.buildUrl;return r?r(t,n):e.buildPath(t,n)}catch{console.error(`[real-router] Route "${t}" is not defined. The element will render without an href attribute.`);return}}function x(e,t,n){return e&&t?n?`${n} ${t}`.trim():t:n??void 0}function S(t){return(0,e.useMemo)(()=>t,[JSON.stringify(t)])}function C(t,n,r=!1,a=!0){let o=l(),s=S(n),c=(0,e.useMemo)(()=>(0,i.createActiveRouteSource)(o,t,s,{strict:r,ignoreQueryParams:a}),[o,t,s,r,a]);return(0,e.useSyncExternalStore)(c.subscribe,c.getSnapshot,c.getSnapshot)}function w(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)}const T=(0,e.memo)(({routeName:t,routeParams:n=d,routeOptions:i=f,className:a,activeClassName:o=`active`,activeStrict:s=!1,ignoreQueryParams:c=!0,onClick:u,target:p,children:m,...h})=>{let g=l(),_=S(n),v=S(i),w=C(t,_,s,c),T=(0,e.useMemo)(()=>b(g,t,_),[g,t,_]),E=(0,e.useCallback)(e=>{u&&(u(e),e.defaultPrevented)||!y(e.nativeEvent)||p===`_blank`||(e.preventDefault(),g.navigate(t,_,v).catch(()=>{}))},[u,p,g,t,_,v]),D=(0,e.useMemo)(()=>x(w,o,a),[w,o,a]);return(0,r.jsx)(`a`,{...h,href:T,className:D,onClick:E,children:m})},w);T.displayName=`Link`;const E=new WeakMap;function D(){let t=l(),n=(0,e.useMemo)(()=>{let e=E.get(t);return e||(e=(0,i.createErrorSource)(t),E.set(t,e)),e},[t]);return(0,e.useSyncExternalStore)(n.subscribe,n.getSnapshot,n.getSnapshot)}function O({children:t,fallback:n,onError:i}){let a=D(),[o,s]=(0,e.useState)(-1),c=(0,e.useRef)(i);c.current=i,(0,e.useEffect)(()=>{a.error&&c.current?.(a.error,a.toRoute,a.fromRoute)},[a.version]);let l=a.version>o?a.error:null,u=(0,e.useCallback)(()=>{s(a.version)},[a.version]);return(0,r.jsxs)(r.Fragment,{children:[t,l?n(l,u):null]})}const k=()=>{let t=(0,e.useContext)(c);if(!t)throw Error(`useNavigator must be used within a RouterProvider`);return t},A=()=>(0,n.getRouteUtils)((0,a.getPluginApi)(l()).getTree()),j=()=>{let t=(0,e.useContext)(o);if(!t)throw Error(`useRoute must be used within a RouteProvider`);return t};function M(){let t=l(),n=(0,e.useMemo)(()=>(0,i.createTransitionSource)(t),[t]);return(0,e.useSyncExternalStore)(n.subscribe,n.getSnapshot,n.getSnapshot)}const N=({router:n,children:a,announceNavigation:l})=>{(0,e.useEffect)(()=>{if(!l)return;let e=m(n);return()=>{e.destroy()}},[l,n]);let u=(0,e.useMemo)(()=>(0,t.getNavigator)(n),[n]),d=(0,e.useMemo)(()=>(0,i.createRouteSource)(n),[n]),{route:f,previousRoute:p}=(0,e.useSyncExternalStore)(d.subscribe,d.getSnapshot,d.getSnapshot);return(0,r.jsx)(s,{value:n,children:(0,r.jsx)(c,{value:u,children:(0,r.jsx)(o,{value:(0,e.useMemo)(()=>({navigator:u,route:f,previousRoute:p}),[u,f,p]),children:a})})})};Object.defineProperty(exports,`a`,{enumerable:!0,get:function(){return k}}),Object.defineProperty(exports,`c`,{enumerable:!0,get:function(){return u}}),Object.defineProperty(exports,`i`,{enumerable:!0,get:function(){return A}}),Object.defineProperty(exports,`l`,{enumerable:!0,get:function(){return l}}),Object.defineProperty(exports,`n`,{enumerable:!0,get:function(){return M}}),Object.defineProperty(exports,`o`,{enumerable:!0,get:function(){return O}}),Object.defineProperty(exports,`r`,{enumerable:!0,get:function(){return j}}),Object.defineProperty(exports,`s`,{enumerable:!0,get:function(){return T}}),Object.defineProperty(exports,`t`,{enumerable:!0,get:function(){return N}});
-//# sourceMappingURL=RouterProvider-jqJCKUhp.js.map

package/dist/cjs/RouterProvider-jqJCKUhp.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"RouterProvider-jqJCKUhp.js","names":[],"sources":["../../src/context.ts","../../src/hooks/useRouter.tsx","../../src/hooks/useRouteNode.tsx","../../src/constants.ts","../../../../shared/dom-utils/route-announcer.ts","../../../../shared/dom-utils/link-utils.ts","../../src/hooks/useStableValue.tsx","../../src/hooks/useIsActiveRoute.tsx","../../src/components/Link.tsx","../../src/hooks/useRouterError.tsx","../../src/components/RouterErrorBoundary.tsx","../../src/hooks/useNavigator.tsx","../../src/hooks/useRouteUtils.tsx","../../src/hooks/useRoute.tsx","../../src/hooks/useRouterTransition.tsx","../../src/RouterProvider.tsx"],"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 { useContext } from \"react\";\n\nimport { RouterContext } from \"../context\";\n\nimport type { Router } from \"@real-router/core\";\n\nexport const useRouter = (): Router => {\n  const router = useContext(RouterContext);\n\n  if (!router) {\n    throw new Error(\"useRouter must be used within a RouterProvider\");\n  }\n\n  return router;\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/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 { Router, State } from \"@real-router/core\";\n\nconst CLEAR_DELAY = 7000;\nconst SAFARI_READY_DELAY = 100;\nconst ANNOUNCER_ATTR = \"data-real-router-announcer\";\nconst INTERNAL_ROUTE_PREFIX = \"@@\";\nconst VISUALLY_HIDDEN =\n  \"position:absolute;width:1px;height:1px;padding:0;margin:-1px;overflow:hidden;clip:rect(0,0,0,0);clip-path:inset(50%);white-space:nowrap;border:0\";\n\nexport interface RouteAnnouncerOptions {\n  prefix?: string;\n  getAnnouncementText?: (route: State) => string;\n}\n\nexport function createRouteAnnouncer(\n  router: Router,\n  options?: RouteAnnouncerOptions,\n): { destroy: () => void } {\n  const prefix = options?.prefix ?? \"Navigated to \";\n  const getCustomText = options?.getAnnouncementText;\n\n  let isInitialNavigation = true;\n  let isReady = false;\n  let isDestroyed = false;\n  let lastAnnouncedText = \"\";\n  let clearTimeoutId: ReturnType<typeof setTimeout> | undefined;\n\n  const announcer = getOrCreateAnnouncer();\n\n  const safariTimeoutId = setTimeout(() => {\n    isReady = true;\n  }, SAFARI_READY_DELAY);\n\n  const unsubscribe = router.subscribe(({ route }) => {\n    if (isInitialNavigation) {\n      isInitialNavigation = false;\n\n      return;\n    }\n\n    requestAnimationFrame(() => {\n      requestAnimationFrame(() => {\n        if (isDestroyed) {\n          return;\n        }\n\n        const text = resolveText(route, prefix, getCustomText);\n\n        if (text && text !== lastAnnouncedText && isReady) {\n          lastAnnouncedText = text;\n          clearTimeout(clearTimeoutId);\n          announcer.textContent = text;\n          clearTimeoutId = setTimeout(() => {\n            announcer.textContent = \"\";\n            lastAnnouncedText = \"\";\n          }, CLEAR_DELAY);\n\n          manageFocus();\n        }\n      });\n    });\n  });\n\n  return {\n    destroy() {\n      isDestroyed = true;\n      unsubscribe();\n      clearTimeout(clearTimeoutId);\n      clearTimeout(safariTimeoutId);\n      removeAnnouncer();\n    },\n  };\n}\n\nfunction getOrCreateAnnouncer(): HTMLElement {\n  const existing = document.querySelector<HTMLElement>(`[${ANNOUNCER_ATTR}]`);\n\n  if (existing) {\n    return existing;\n  }\n\n  const element = document.createElement(\"div\");\n\n  element.setAttribute(\"style\", VISUALLY_HIDDEN);\n  element.setAttribute(\"aria-live\", \"assertive\");\n  element.setAttribute(\"aria-atomic\", \"true\");\n  element.setAttribute(ANNOUNCER_ATTR, \"\");\n\n  document.body.prepend(element);\n\n  return element;\n}\n\nfunction removeAnnouncer(): void {\n  document.querySelector(`[${ANNOUNCER_ATTR}]`)?.remove();\n}\n\nfunction resolveText(\n  route: State,\n  prefix: string,\n  getCustomText?: (route: State) => string,\n): string {\n  if (getCustomText) {\n    return getCustomText(route);\n  }\n\n  const h1 = document.querySelector<HTMLElement>(\"h1\");\n  const h1Text = h1?.textContent.trim() ?? \"\";\n  const routeName = route.name.startsWith(INTERNAL_ROUTE_PREFIX)\n    ? \"\"\n    : route.name;\n  const rawText =\n    h1Text || document.title || routeName || globalThis.location.pathname;\n\n  return `${prefix}${rawText}`;\n}\n\nfunction manageFocus(): void {\n  const h1 = document.querySelector<HTMLElement>(\"h1\");\n\n  if (!h1) {\n    return;\n  }\n\n  if (!h1.hasAttribute(\"tabindex\")) {\n    h1.setAttribute(\"tabindex\", \"-1\");\n  }\n\n  h1.focus({ preventScroll: true });\n}\n","import type { Router, Params } from \"@real-router/core\";\n\nexport function shouldNavigate(evt: MouseEvent): boolean {\n  return (\n    evt.button === 0 &&\n    !evt.metaKey &&\n    !evt.altKey &&\n    !evt.ctrlKey &&\n    !evt.shiftKey\n  );\n}\n\ntype BuildUrlFn = (name: string, params: Params) => string;\n\nexport function buildHref(\n  router: Router,\n  routeName: string,\n  routeParams: Params,\n): string | undefined {\n  try {\n    const buildUrl = router.buildUrl as BuildUrlFn | undefined;\n\n    if (buildUrl) {\n      return buildUrl(routeName, routeParams);\n    }\n\n    return router.buildPath(routeName, routeParams);\n  } catch {\n    console.error(\n      `[real-router] Route \"${routeName}\" is not defined. The element will render without an href attribute.`,\n    );\n\n    return undefined;\n  }\n}\n\nexport function buildActiveClassName(\n  isActive: boolean,\n  activeClassName: string | undefined,\n  baseClassName: string | undefined,\n): string | undefined {\n  if (isActive && activeClassName) {\n    return baseClassName\n      ? `${baseClassName} ${activeClassName}`.trim()\n      : activeClassName;\n  }\n\n  return baseClassName ?? undefined;\n}\n\nexport function applyLinkA11y(element: HTMLElement): void {\n  if (\n    element instanceof HTMLAnchorElement ||\n    element instanceof HTMLButtonElement\n  ) {\n    return;\n  }\n  if (!element.getAttribute(\"role\")) {\n    element.setAttribute(\"role\", \"link\");\n  }\n  if (!element.getAttribute(\"tabindex\")) {\n    element.setAttribute(\"tabindex\", \"0\");\n  }\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 @eslint-react/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 { memo, useCallback, useMemo } from \"react\";\n\nimport { EMPTY_PARAMS, EMPTY_OPTIONS } from \"../constants\";\nimport {\n  shouldNavigate,\n  buildHref,\n  buildActiveClassName,\n} from \"../dom-utils/index.js\";\nimport { useIsActiveRoute } from \"../hooks/useIsActiveRoute\";\nimport { useRouter } from \"../hooks/useRouter\";\nimport { useStableValue } from \"../hooks/useStableValue\";\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      () => buildHref(router, routeName, stableParams),\n      [router, routeName, stableParams],\n    );\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.nativeEvent) || 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      () => buildActiveClassName(isActive, activeClassName, className),\n      [isActive, activeClassName, className],\n    );\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 { createErrorSource } from \"@real-router/sources\";\nimport { useMemo, useSyncExternalStore } from \"react\";\n\nimport { useRouter } from \"./useRouter\";\n\nimport type { Router } from \"@real-router/core\";\nimport type { RouterErrorSnapshot, RouterSource } from \"@real-router/sources\";\n\nconst cache = new WeakMap<Router, RouterSource<RouterErrorSnapshot>>();\n\nexport function useRouterError(): RouterErrorSnapshot {\n  const router = useRouter();\n  const store = useMemo(() => {\n    let source = cache.get(router);\n\n    if (!source) {\n      source = createErrorSource(router);\n      cache.set(router, source);\n    }\n\n    return source;\n  }, [router]);\n\n  return useSyncExternalStore(\n    store.subscribe,\n    store.getSnapshot,\n    store.getSnapshot,\n  );\n}\n","import { useCallback, useEffect, useRef, useState } from \"react\";\n\nimport { useRouterError } from \"../hooks/useRouterError\";\n\nimport type { RouterError, State } from \"@real-router/core\";\nimport type { ReactNode, JSX } from \"react\";\n\nexport interface RouterErrorBoundaryProps {\n  readonly children: ReactNode;\n  readonly fallback: (error: RouterError, resetError: () => void) => ReactNode;\n  readonly onError?: (\n    error: RouterError,\n    toRoute: State | null,\n    fromRoute: State | null,\n  ) => void;\n}\n\nexport function RouterErrorBoundary({\n  children,\n  fallback,\n  onError,\n}: RouterErrorBoundaryProps): JSX.Element {\n  const snapshot = useRouterError();\n  const [dismissedVersion, setDismissedVersion] = useState(-1);\n\n  const onErrorRef = useRef(onError);\n\n  // eslint-disable-next-line @eslint-react/refs -- \"latest ref\" pattern: sync callback to ref to avoid effect re-runs\n  onErrorRef.current = onError;\n\n  useEffect(() => {\n    if (snapshot.error) {\n      onErrorRef.current?.(\n        snapshot.error,\n        snapshot.toRoute,\n        snapshot.fromRoute,\n      );\n    }\n    // eslint-disable-next-line @eslint-react/exhaustive-deps -- onError tracked via ref, snapshot fields accessed inside callback\n  }, [snapshot.version]);\n\n  const visibleError =\n    snapshot.version > dismissedVersion ? snapshot.error : null;\n\n  const resetError = useCallback(() => {\n    setDismissedVersion(snapshot.version);\n  }, [snapshot.version]);\n\n  return (\n    <>\n      {children}\n      {visibleError ? fallback(visibleError, resetError) : null}\n    </>\n  );\n}\n","// packages/react/modules/hooks/useNavigator.tsx\n\nimport { useContext } from \"react\";\n\nimport { NavigatorContext } from \"../context\";\n\nimport type { Navigator } from \"@real-router/core\";\n\nexport const useNavigator = (): Navigator => {\n  const navigator = useContext(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/api\";\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","// packages/react/modules/hooks/useRoute.tsx\n\nimport { useContext } from \"react\";\n\nimport { RouteContext } from \"../context\";\n\nimport type { RouteContext as RouteContextType } from \"../types\";\n\nexport const useRoute = (): RouteContextType => {\n  const routeContext = useContext(RouteContext);\n\n  if (!routeContext) {\n    throw new Error(\"useRoute must be used within a RouteProvider\");\n  }\n\n  return routeContext;\n};\n","import { createTransitionSource } from \"@real-router/sources\";\nimport { useMemo, useSyncExternalStore } from \"react\";\n\nimport { useRouter } from \"./useRouter\";\n\nimport type { RouterTransitionSnapshot } from \"@real-router/sources\";\n\nexport function useRouterTransition(): RouterTransitionSnapshot {\n  const router = useRouter();\n\n  const store = useMemo(() => createTransitionSource(router), [router]);\n\n  return useSyncExternalStore(\n    store.subscribe,\n    store.getSnapshot,\n    store.getSnapshot,\n  );\n}\n","import { getNavigator } from \"@real-router/core\";\nimport { createRouteSource } from \"@real-router/sources\";\nimport { useEffect, useMemo, useSyncExternalStore } from \"react\";\n\nimport { NavigatorContext, RouteContext, RouterContext } from \"./context\";\nimport { createRouteAnnouncer } from \"./dom-utils/index.js\";\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  announceNavigation?: boolean;\n}\n\nexport const RouterProvider: FC<RouteProviderProps> = ({\n  router,\n  children,\n  announceNavigation,\n}) => {\n  useEffect(() => {\n    if (!announceNavigation) {\n      return;\n    }\n\n    const announcer = createRouteAnnouncer(router);\n\n    return () => {\n      announcer.destroy();\n    };\n  }, [announceNavigation, router]);\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"],"mappings":"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"}

package/dist/esm/RouterProvider-DrAGH6K9.mjs

@@ -1,2 +0,0 @@
-import{createContext as e,memo as t,useCallback as n,useContext as r,useEffect as i,useMemo as a,useRef as o,useState as s,useSyncExternalStore as c}from"react";import{getNavigator as l}from"@real-router/core";import{getRouteUtils as u}from"@real-router/route-utils";import{Fragment as d,jsx as f,jsxs as p}from"react/jsx-runtime";import{createActiveRouteSource as m,createErrorSource as h,createRouteNodeSource as g,createRouteSource as _,createTransitionSource as v}from"@real-router/sources";import{getPluginApi as y}from"@real-router/core/api";const b=e(null),x=e(null),S=e(null),C=()=>{let e=r(x);if(!e)throw Error(`useRouter must be used within a RouterProvider`);return e};function w(e){let t=C(),n=a(()=>g(t,e),[t,e]),{route:r,previousRoute:i}=c(n.subscribe,n.getSnapshot,n.getSnapshot),o=a(()=>l(t),[t]);return a(()=>({navigator:o,route:r,previousRoute:i}),[o,r,i])}const T=Object.freeze({}),E=Object.freeze({}),D=`data-real-router-announcer`;function O(e,t){let n=t?.prefix??`Navigated to `,r=t?.getAnnouncementText,i=!0,a=!1,o=!1,s=``,c,l=k(),u=setTimeout(()=>{a=!0},100),d=e.subscribe(({route:e})=>{if(i){i=!1;return}requestAnimationFrame(()=>{requestAnimationFrame(()=>{if(o)return;let t=j(e,n,r);t&&t!==s&&a&&(s=t,clearTimeout(c),l.textContent=t,c=setTimeout(()=>{l.textContent=``,s=``},7e3),M())})})});return{destroy(){o=!0,d(),clearTimeout(c),clearTimeout(u),A()}}}function k(){let e=document.querySelector(`[${D}]`);if(e)return e;let t=document.createElement(`div`);return t.setAttribute(`style`,`position:absolute;width:1px;height:1px;padding:0;margin:-1px;overflow:hidden;clip:rect(0,0,0,0);clip-path:inset(50%);white-space:nowrap;border:0`),t.setAttribute(`aria-live`,`assertive`),t.setAttribute(`aria-atomic`,`true`),t.setAttribute(D,``),document.body.prepend(t),t}function A(){document.querySelector(`[${D}]`)?.remove()}function j(e,t,n){if(n)return n(e);let r=document.querySelector(`h1`)?.textContent.trim()??``,i=e.name.startsWith(`@@`)?``:e.name;return`${t}${r||document.title||i||globalThis.location.pathname}`}function M(){let e=document.querySelector(`h1`);e&&(e.hasAttribute(`tabindex`)||e.setAttribute(`tabindex`,`-1`),e.focus({preventScroll:!0}))}function N(e){return e.button===0&&!e.metaKey&&!e.altKey&&!e.ctrlKey&&!e.shiftKey}function P(e,t,n){try{let r=e.buildUrl;return r?r(t,n):e.buildPath(t,n)}catch{console.error(`[real-router] Route "${t}" is not defined. The element will render without an href attribute.`);return}}function F(e,t,n){return e&&t?n?`${n} ${t}`.trim():t:n??void 0}function I(e){return a(()=>e,[JSON.stringify(e)])}function L(e,t,n=!1,r=!0){let i=C(),o=I(t),s=a(()=>m(i,e,o,{strict:n,ignoreQueryParams:r}),[i,e,o,n,r]);return c(s.subscribe,s.getSnapshot,s.getSnapshot)}function R(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)}const z=t(({routeName:e,routeParams:t=T,routeOptions:r=E,className:i,activeClassName:o=`active`,activeStrict:s=!1,ignoreQueryParams:c=!0,onClick:l,target:u,children:d,...p})=>{let m=C(),h=I(t),g=I(r),_=L(e,h,s,c),v=a(()=>P(m,e,h),[m,e,h]),y=n(t=>{l&&(l(t),t.defaultPrevented)||!N(t.nativeEvent)||u===`_blank`||(t.preventDefault(),m.navigate(e,h,g).catch(()=>{}))},[l,u,m,e,h,g]),b=a(()=>F(_,o,i),[_,o,i]);return f(`a`,{...p,href:v,className:b,onClick:y,children:d})},R);z.displayName=`Link`;const B=new WeakMap;function V(){let e=C(),t=a(()=>{let t=B.get(e);return t||(t=h(e),B.set(e,t)),t},[e]);return c(t.subscribe,t.getSnapshot,t.getSnapshot)}function H({children:e,fallback:t,onError:r}){let a=V(),[c,l]=s(-1),u=o(r);u.current=r,i(()=>{a.error&&u.current?.(a.error,a.toRoute,a.fromRoute)},[a.version]);let f=a.version>c?a.error:null,m=n(()=>{l(a.version)},[a.version]);return p(d,{children:[e,f?t(f,m):null]})}const U=()=>{let e=r(S);if(!e)throw Error(`useNavigator must be used within a RouterProvider`);return e},W=()=>u(y(C()).getTree()),G=()=>{let e=r(b);if(!e)throw Error(`useRoute must be used within a RouteProvider`);return e};function K(){let e=C(),t=a(()=>v(e),[e]);return c(t.subscribe,t.getSnapshot,t.getSnapshot)}const q=({router:e,children:t,announceNavigation:n})=>{i(()=>{if(!n)return;let t=O(e);return()=>{t.destroy()}},[n,e]);let r=a(()=>l(e),[e]),o=a(()=>_(e),[e]),{route:s,previousRoute:u}=c(o.subscribe,o.getSnapshot,o.getSnapshot);return f(x,{value:e,children:f(S,{value:r,children:f(b,{value:a(()=>({navigator:r,route:s,previousRoute:u}),[r,s,u]),children:t})})})};export{U as a,w as c,W as i,C as l,K as n,H as o,G as r,z as s,q as t};
-//# sourceMappingURL=RouterProvider-DrAGH6K9.mjs.map

package/dist/esm/RouterProvider-DrAGH6K9.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"RouterProvider-DrAGH6K9.mjs","names":[],"sources":["../../src/context.ts","../../src/hooks/useRouter.tsx","../../src/hooks/useRouteNode.tsx","../../src/constants.ts","../../../../shared/dom-utils/route-announcer.ts","../../../../shared/dom-utils/link-utils.ts","../../src/hooks/useStableValue.tsx","../../src/hooks/useIsActiveRoute.tsx","../../src/components/Link.tsx","../../src/hooks/useRouterError.tsx","../../src/components/RouterErrorBoundary.tsx","../../src/hooks/useNavigator.tsx","../../src/hooks/useRouteUtils.tsx","../../src/hooks/useRoute.tsx","../../src/hooks/useRouterTransition.tsx","../../src/RouterProvider.tsx"],"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 { useContext } from \"react\";\n\nimport { RouterContext } from \"../context\";\n\nimport type { Router } from \"@real-router/core\";\n\nexport const useRouter = (): Router => {\n  const router = useContext(RouterContext);\n\n  if (!router) {\n    throw new Error(\"useRouter must be used within a RouterProvider\");\n  }\n\n  return router;\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/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 { Router, State } from \"@real-router/core\";\n\nconst CLEAR_DELAY = 7000;\nconst SAFARI_READY_DELAY = 100;\nconst ANNOUNCER_ATTR = \"data-real-router-announcer\";\nconst INTERNAL_ROUTE_PREFIX = \"@@\";\nconst VISUALLY_HIDDEN =\n  \"position:absolute;width:1px;height:1px;padding:0;margin:-1px;overflow:hidden;clip:rect(0,0,0,0);clip-path:inset(50%);white-space:nowrap;border:0\";\n\nexport interface RouteAnnouncerOptions {\n  prefix?: string;\n  getAnnouncementText?: (route: State) => string;\n}\n\nexport function createRouteAnnouncer(\n  router: Router,\n  options?: RouteAnnouncerOptions,\n): { destroy: () => void } {\n  const prefix = options?.prefix ?? \"Navigated to \";\n  const getCustomText = options?.getAnnouncementText;\n\n  let isInitialNavigation = true;\n  let isReady = false;\n  let isDestroyed = false;\n  let lastAnnouncedText = \"\";\n  let clearTimeoutId: ReturnType<typeof setTimeout> | undefined;\n\n  const announcer = getOrCreateAnnouncer();\n\n  const safariTimeoutId = setTimeout(() => {\n    isReady = true;\n  }, SAFARI_READY_DELAY);\n\n  const unsubscribe = router.subscribe(({ route }) => {\n    if (isInitialNavigation) {\n      isInitialNavigation = false;\n\n      return;\n    }\n\n    requestAnimationFrame(() => {\n      requestAnimationFrame(() => {\n        if (isDestroyed) {\n          return;\n        }\n\n        const text = resolveText(route, prefix, getCustomText);\n\n        if (text && text !== lastAnnouncedText && isReady) {\n          lastAnnouncedText = text;\n          clearTimeout(clearTimeoutId);\n          announcer.textContent = text;\n          clearTimeoutId = setTimeout(() => {\n            announcer.textContent = \"\";\n            lastAnnouncedText = \"\";\n          }, CLEAR_DELAY);\n\n          manageFocus();\n        }\n      });\n    });\n  });\n\n  return {\n    destroy() {\n      isDestroyed = true;\n      unsubscribe();\n      clearTimeout(clearTimeoutId);\n      clearTimeout(safariTimeoutId);\n      removeAnnouncer();\n    },\n  };\n}\n\nfunction getOrCreateAnnouncer(): HTMLElement {\n  const existing = document.querySelector<HTMLElement>(`[${ANNOUNCER_ATTR}]`);\n\n  if (existing) {\n    return existing;\n  }\n\n  const element = document.createElement(\"div\");\n\n  element.setAttribute(\"style\", VISUALLY_HIDDEN);\n  element.setAttribute(\"aria-live\", \"assertive\");\n  element.setAttribute(\"aria-atomic\", \"true\");\n  element.setAttribute(ANNOUNCER_ATTR, \"\");\n\n  document.body.prepend(element);\n\n  return element;\n}\n\nfunction removeAnnouncer(): void {\n  document.querySelector(`[${ANNOUNCER_ATTR}]`)?.remove();\n}\n\nfunction resolveText(\n  route: State,\n  prefix: string,\n  getCustomText?: (route: State) => string,\n): string {\n  if (getCustomText) {\n    return getCustomText(route);\n  }\n\n  const h1 = document.querySelector<HTMLElement>(\"h1\");\n  const h1Text = h1?.textContent.trim() ?? \"\";\n  const routeName = route.name.startsWith(INTERNAL_ROUTE_PREFIX)\n    ? \"\"\n    : route.name;\n  const rawText =\n    h1Text || document.title || routeName || globalThis.location.pathname;\n\n  return `${prefix}${rawText}`;\n}\n\nfunction manageFocus(): void {\n  const h1 = document.querySelector<HTMLElement>(\"h1\");\n\n  if (!h1) {\n    return;\n  }\n\n  if (!h1.hasAttribute(\"tabindex\")) {\n    h1.setAttribute(\"tabindex\", \"-1\");\n  }\n\n  h1.focus({ preventScroll: true });\n}\n","import type { Router, Params } from \"@real-router/core\";\n\nexport function shouldNavigate(evt: MouseEvent): boolean {\n  return (\n    evt.button === 0 &&\n    !evt.metaKey &&\n    !evt.altKey &&\n    !evt.ctrlKey &&\n    !evt.shiftKey\n  );\n}\n\ntype BuildUrlFn = (name: string, params: Params) => string;\n\nexport function buildHref(\n  router: Router,\n  routeName: string,\n  routeParams: Params,\n): string | undefined {\n  try {\n    const buildUrl = router.buildUrl as BuildUrlFn | undefined;\n\n    if (buildUrl) {\n      return buildUrl(routeName, routeParams);\n    }\n\n    return router.buildPath(routeName, routeParams);\n  } catch {\n    console.error(\n      `[real-router] Route \"${routeName}\" is not defined. The element will render without an href attribute.`,\n    );\n\n    return undefined;\n  }\n}\n\nexport function buildActiveClassName(\n  isActive: boolean,\n  activeClassName: string | undefined,\n  baseClassName: string | undefined,\n): string | undefined {\n  if (isActive && activeClassName) {\n    return baseClassName\n      ? `${baseClassName} ${activeClassName}`.trim()\n      : activeClassName;\n  }\n\n  return baseClassName ?? undefined;\n}\n\nexport function applyLinkA11y(element: HTMLElement): void {\n  if (\n    element instanceof HTMLAnchorElement ||\n    element instanceof HTMLButtonElement\n  ) {\n    return;\n  }\n  if (!element.getAttribute(\"role\")) {\n    element.setAttribute(\"role\", \"link\");\n  }\n  if (!element.getAttribute(\"tabindex\")) {\n    element.setAttribute(\"tabindex\", \"0\");\n  }\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 @eslint-react/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 { memo, useCallback, useMemo } from \"react\";\n\nimport { EMPTY_PARAMS, EMPTY_OPTIONS } from \"../constants\";\nimport {\n  shouldNavigate,\n  buildHref,\n  buildActiveClassName,\n} from \"../dom-utils/index.js\";\nimport { useIsActiveRoute } from \"../hooks/useIsActiveRoute\";\nimport { useRouter } from \"../hooks/useRouter\";\nimport { useStableValue } from \"../hooks/useStableValue\";\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      () => buildHref(router, routeName, stableParams),\n      [router, routeName, stableParams],\n    );\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.nativeEvent) || 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      () => buildActiveClassName(isActive, activeClassName, className),\n      [isActive, activeClassName, className],\n    );\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 { createErrorSource } from \"@real-router/sources\";\nimport { useMemo, useSyncExternalStore } from \"react\";\n\nimport { useRouter } from \"./useRouter\";\n\nimport type { Router } from \"@real-router/core\";\nimport type { RouterErrorSnapshot, RouterSource } from \"@real-router/sources\";\n\nconst cache = new WeakMap<Router, RouterSource<RouterErrorSnapshot>>();\n\nexport function useRouterError(): RouterErrorSnapshot {\n  const router = useRouter();\n  const store = useMemo(() => {\n    let source = cache.get(router);\n\n    if (!source) {\n      source = createErrorSource(router);\n      cache.set(router, source);\n    }\n\n    return source;\n  }, [router]);\n\n  return useSyncExternalStore(\n    store.subscribe,\n    store.getSnapshot,\n    store.getSnapshot,\n  );\n}\n","import { useCallback, useEffect, useRef, useState } from \"react\";\n\nimport { useRouterError } from \"../hooks/useRouterError\";\n\nimport type { RouterError, State } from \"@real-router/core\";\nimport type { ReactNode, JSX } from \"react\";\n\nexport interface RouterErrorBoundaryProps {\n  readonly children: ReactNode;\n  readonly fallback: (error: RouterError, resetError: () => void) => ReactNode;\n  readonly onError?: (\n    error: RouterError,\n    toRoute: State | null,\n    fromRoute: State | null,\n  ) => void;\n}\n\nexport function RouterErrorBoundary({\n  children,\n  fallback,\n  onError,\n}: RouterErrorBoundaryProps): JSX.Element {\n  const snapshot = useRouterError();\n  const [dismissedVersion, setDismissedVersion] = useState(-1);\n\n  const onErrorRef = useRef(onError);\n\n  // eslint-disable-next-line @eslint-react/refs -- \"latest ref\" pattern: sync callback to ref to avoid effect re-runs\n  onErrorRef.current = onError;\n\n  useEffect(() => {\n    if (snapshot.error) {\n      onErrorRef.current?.(\n        snapshot.error,\n        snapshot.toRoute,\n        snapshot.fromRoute,\n      );\n    }\n    // eslint-disable-next-line @eslint-react/exhaustive-deps -- onError tracked via ref, snapshot fields accessed inside callback\n  }, [snapshot.version]);\n\n  const visibleError =\n    snapshot.version > dismissedVersion ? snapshot.error : null;\n\n  const resetError = useCallback(() => {\n    setDismissedVersion(snapshot.version);\n  }, [snapshot.version]);\n\n  return (\n    <>\n      {children}\n      {visibleError ? fallback(visibleError, resetError) : null}\n    </>\n  );\n}\n","// packages/react/modules/hooks/useNavigator.tsx\n\nimport { useContext } from \"react\";\n\nimport { NavigatorContext } from \"../context\";\n\nimport type { Navigator } from \"@real-router/core\";\n\nexport const useNavigator = (): Navigator => {\n  const navigator = useContext(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/api\";\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","// packages/react/modules/hooks/useRoute.tsx\n\nimport { useContext } from \"react\";\n\nimport { RouteContext } from \"../context\";\n\nimport type { RouteContext as RouteContextType } from \"../types\";\n\nexport const useRoute = (): RouteContextType => {\n  const routeContext = useContext(RouteContext);\n\n  if (!routeContext) {\n    throw new Error(\"useRoute must be used within a RouteProvider\");\n  }\n\n  return routeContext;\n};\n","import { createTransitionSource } from \"@real-router/sources\";\nimport { useMemo, useSyncExternalStore } from \"react\";\n\nimport { useRouter } from \"./useRouter\";\n\nimport type { RouterTransitionSnapshot } from \"@real-router/sources\";\n\nexport function useRouterTransition(): RouterTransitionSnapshot {\n  const router = useRouter();\n\n  const store = useMemo(() => createTransitionSource(router), [router]);\n\n  return useSyncExternalStore(\n    store.subscribe,\n    store.getSnapshot,\n    store.getSnapshot,\n  );\n}\n","import { getNavigator } from \"@real-router/core\";\nimport { createRouteSource } from \"@real-router/sources\";\nimport { useEffect, useMemo, useSyncExternalStore } from \"react\";\n\nimport { NavigatorContext, RouteContext, RouterContext } from \"./context\";\nimport { createRouteAnnouncer } from \"./dom-utils/index.js\";\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  announceNavigation?: boolean;\n}\n\nexport const RouterProvider: FC<RouteProviderProps> = ({\n  router,\n  children,\n  announceNavigation,\n}) => {\n  useEffect(() => {\n    if (!announceNavigation) {\n      return;\n    }\n\n    const announcer = createRouteAnnouncer(router);\n\n    return () => {\n      announcer.destroy();\n    };\n  }, [announceNavigation, router]);\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"],"mappings":"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"}

package/src/hooks/useRouterError.tsx

@@ -1,29 +0,0 @@
-import { createErrorSource } from "@real-router/sources";
-import { useMemo, useSyncExternalStore } from "react";
-
-import { useRouter } from "./useRouter";
-
-import type { Router } from "@real-router/core";
-import type { RouterErrorSnapshot, RouterSource } from "@real-router/sources";
-
-const cache = new WeakMap<Router, RouterSource<RouterErrorSnapshot>>();
-
-export function useRouterError(): RouterErrorSnapshot {
-  const router = useRouter();
-  const store = useMemo(() => {
-    let source = cache.get(router);
-
-    if (!source) {
-      source = createErrorSource(router);
-      cache.set(router, source);
-    }
-
-    return source;
-  }, [router]);
-
-  return useSyncExternalStore(
-    store.subscribe,
-    store.getSnapshot,
-    store.getSnapshot,
-  );
-}

package/src/hooks/useStableValue.tsx

@@ -1,29 +0,0 @@
-// packages/react/modules/hooks/useStableValue.tsx
-
-import { useMemo } from "react";
-
-/**
- * Stabilizes a value reference based on deep equality (via JSON serialization).
- * Returns the same reference until the serialized value changes.
- *
- * Useful for object/array dependencies in hooks like useMemo, useCallback, useEffect
- * to prevent unnecessary re-renders when the value is structurally the same.
- *
- * @example
- * ```tsx
- * const stableParams = useStableValue(routeParams);
- * const href = useMemo(() => {
- *   return router.buildUrl(routeName, stableParams);
- * }, [router, routeName, stableParams]);
- * ```
- *
- * @param value - The value to stabilize
- * @returns A stable reference to the value
- */
-export function useStableValue<T>(value: T): T {
-  const serialized = JSON.stringify(value);
-
-  // We intentionally use serialized in deps to detect deep changes
-  // eslint-disable-next-line @eslint-react/exhaustive-deps
-  return useMemo(() => value, [serialized]);
-}