@real-router/react 0.27.1 → 0.27.3

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

@@ -1 +0,0 @@
-{"version":3,"file":"RouterProvider-DgHypQTJ.mjs","names":["NOOP_INSTANCE","NOOP_INSTANCE","NOOP_INSTANCE"],"sources":["../../src/hooks/useRouter.tsx","../../src/hooks/useRouteNode.tsx","../../../../shared/dom-utils/route-announcer.ts","../../../../shared/dom-utils/scroll-restore.ts","../../../../shared/dom-utils/scroll-spy.ts","../../../../shared/dom-utils/view-transitions.ts","../../../../shared/dom-utils/link-utils.ts","../../src/hooks/useIsActiveRoute.tsx","../../src/components/RouterErrorBoundary.tsx","../../src/hooks/useNavigator.tsx","../../src/hooks/useRouteUtils.tsx","../../src/hooks/useRouterTransition.tsx","../../src/RouterProvider.tsx"],"sourcesContent":["import { 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","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\nconst NOOP_INSTANCE: { destroy: () => void } = Object.freeze({\n  destroy: () => {\n    /* no-op */\n  },\n});\n\nexport function createRouteAnnouncer(\n  router: Router,\n  options?: RouteAnnouncerOptions,\n): { destroy: () => void } {\n  // Defensive SSR / non-browser guard: in SSR (Node.js) or non-DOM\n  // environments, `document` is undefined and the announcer cannot\n  // attach its aria-live region. Return a frozen NOOP_INSTANCE — same\n  // pattern as `createDirectionTracker`, `createScrollRestoration`, and\n  // `createViewTransitions`. Without this guard, `NavigationAnnouncer`\n  // component construction would throw `ReferenceError: document is not\n  // defined` under `@angular/ssr` rendering, tearing down the whole SSR\n  // bootstrap. Closes review-2026-05-10 §5.10 ⛔ \"NavigationAnnouncer\n  // SSR mode\" MED.\n  if (typeof document === \"undefined\") {\n    return NOOP_INSTANCE;\n  }\n\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  // Defensive SSR / pre-`<body>` guard: in some environments (early\n  // injection, deferred-body documents, certain SSR rehydration paths)\n  // `document.body` can be null when the announcer is constructed.\n  // `document.body.prepend(...)` would throw `TypeError: Cannot read\n  // properties of null`, tearing down the consumer's RouterProvider /\n  // NavigationAnnouncer mount. Fallback to `documentElement` keeps the\n  // announcer working for SR users; visual-hidden styling means there is\n  // no visible artifact regardless of mount point.\n  //\n  // TS dom lib types `document.body` as `HTMLElement` (non-null), but\n  // runtime can return null per spec. The `as` cast narrows the type to\n  // include null so the `??` short-circuit is type-safe.\n  ((document.body as HTMLElement | null) ?? document.documentElement).prepend(\n    element,\n  );\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    try {\n      const customText = getCustomText(route);\n\n      // Mini-sprint E.4 (audit-5 §4.2 #4) — empty-string fallback.\n      // A consumer pattern like\n      //   getAnnouncementText: (route) => myMap[route.name] ?? \"\"\n      // returns `\"\"` for routes outside the map. The subscribe loop\n      // then sees an empty text and silently no-announces — screen\n      // readers stay quiet without any signal to the developer. Treat\n      // a falsy custom result (`\"\"` / `null` / `undefined`) as\n      // \"consumer doesn't have a name for this route\" and fall through\n      // to the default resolution chain (h1 → title → route name).\n      if (customText) {\n        return customText;\n      }\n    } catch (error) {\n      // A throwing consumer callback inside the router's subscribe loop\n      // would tear down sibling listeners — log and fall through to the\n      // built-in resolution chain so the announcer keeps working.\n      console.error(\n        \"[real-router] getAnnouncementText threw; falling back to default resolution.\",\n        error,\n      );\n    }\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, State } from \"@real-router/core\";\n\nconst DEFAULT_STORAGE_KEY = \"real-router:scroll\";\n\n// Bounded retry budget for resolving a late-mounting scroll container on the\n// restore path. A per-route container (e.g. an `overflow:auto` div rendered\n// only on one route) can be committed to the DOM a few frames after the\n// navigation settles — heavier routes paint later than the subscribe's rAF.\n// ~10 frames (≈160ms at 60fps) comfortably covers a React commit of a large\n// route without being perceptible. See the doc-block on `restorePos`.\nconst RESTORE_RETRY_FRAMES = 10;\n\nconst NOOP_INSTANCE: { destroy: () => void } = Object.freeze({\n  destroy: () => {\n    /* no-op */\n  },\n});\n\nexport type ScrollRestorationMode = \"restore\" | \"top\" | \"native\";\n\nexport interface ScrollRestorationOptions {\n  mode?: ScrollRestorationMode | undefined;\n  anchorScrolling?: boolean | undefined;\n  scrollContainer?: (() => HTMLElement | null) | undefined;\n  /**\n   * Scroll behavior passed to `scrollTo({ behavior })` and\n   * `scrollIntoView({ behavior })`.\n   *\n   * - `\"auto\"` (default) — browser-defined, usually instant.\n   * - `\"instant\"` — explicit instant jump (no animation).\n   * - `\"smooth\"` — animated transition. Note: smooth restore on back/traverse\n   *   can feel disorienting if the user expects to land at the saved position\n   *   immediately. Recommended for `mode: \"top\"` or anchor scroll only.\n   *\n   * See [MDN](https://developer.mozilla.org/en-US/docs/Web/API/ScrollToOptions/behavior).\n   */\n  behavior?: ScrollBehavior | undefined;\n  /**\n   * sessionStorage key used to persist saved scroll positions. Default:\n   * `\"real-router:scroll\"`. Override only when multiple independent\n   * `RouterProvider` instances share the same document and you need to\n   * isolate their scroll stores (e.g. micro-frontends, embedded widgets,\n   * or testing). For a single app with one provider the default is fine.\n   */\n  storageKey?: string | undefined;\n}\n\ninterface NavigationContext {\n  direction?: \"forward\" | \"back\" | \"unknown\";\n  navigationType?: \"push\" | \"replace\" | \"traverse\" | \"reload\";\n}\n\nexport function createScrollRestoration(\n  router: Router,\n  options?: ScrollRestorationOptions,\n): { destroy: () => void } {\n  if (typeof globalThis.window === \"undefined\") {\n    return NOOP_INSTANCE;\n  }\n\n  const mode = options?.mode ?? \"restore\";\n\n  // mode \"native\" = utility does nothing. Don't flip history.scrollRestoration,\n  // don't subscribe, don't register pagehide — `history.scrollRestoration`\n  // stays at the browser default (\"auto\") so the browser handles scroll\n  // restore natively. (Note: this is the OPPOSITE of `history.scrollRestoration\n  // === \"manual\"` — utility's \"native\" leaves the DOM property at \"auto\" so\n  // the browser is in charge.)\n  if (mode === \"native\") {\n    return NOOP_INSTANCE;\n  }\n\n  const anchorEnabled = options?.anchorScrolling ?? true;\n  const getContainer = options?.scrollContainer;\n  const behavior: ScrollBehavior = options?.behavior ?? \"auto\";\n  const storageKey = options?.storageKey ?? DEFAULT_STORAGE_KEY;\n\n  // Write-through in-memory cache: parse sessionStorage once per provider\n  // mount, then mutate in-memory. Avoids a JSON.parse + JSON.stringify pair\n  // on every subscribeLeave / pagehide event.\n  let store: Record<string, number> | undefined;\n\n  const loadStore = (): Record<string, number> => {\n    if (store !== undefined) {\n      return store;\n    }\n\n    try {\n      const raw = sessionStorage.getItem(storageKey);\n\n      store = raw ? (JSON.parse(raw) as Record<string, number>) : {};\n    } catch {\n      store = {};\n    }\n\n    return store;\n  };\n\n  const putPos = (key: string, pos: number): void => {\n    try {\n      const cached = loadStore();\n\n      // Skip-same-value: when a route is left at the same scroll position it\n      // already holds in the cache (e.g. tab-switching without scrolling),\n      // both the in-memory write and the JSON.stringify + setItem pair are\n      // no-ops. Eliminates redundant serialization on the navigation hot\n      // path for the common \"click tabs without scrolling\" case.\n      if (cached[key] === pos) {\n        return;\n      }\n\n      cached[key] = pos;\n      sessionStorage.setItem(storageKey, JSON.stringify(cached));\n    } catch {\n      // Ignore quota / security errors.\n    }\n  };\n\n  const prevScrollRestoration = history.scrollRestoration;\n\n  try {\n    history.scrollRestoration = \"manual\";\n  } catch {\n    // Ignore — some embedded contexts may reject the assignment.\n  }\n\n  // Resolve the container lazily on every event so containers mounted AFTER\n  // the provider still get correct scroll handling. Falls back to window when\n  // the getter is absent or returns null (pre-mount).\n  const readPos = (): number => {\n    const element = getContainer?.();\n\n    return element ? element.scrollTop : globalThis.scrollY;\n  };\n\n  const writePos = (top: number): void => {\n    const element = getContainer?.();\n\n    if (element) {\n      element.scrollTo({ top, left: 0, behavior });\n    } else {\n      globalThis.scrollTo({ top, left: 0, behavior });\n    }\n  };\n\n  // Restore path (back / traverse / reload). Unlike `writePos`, this tolerates a\n  // scroll container that both MOUNTS and LAYS OUT a few frames AFTER the\n  // navigation settles.\n  //\n  // The capture-side `readPos` always runs against an already-mounted DOM (the\n  // route being left). On restore the target route — and its container — is\n  // still being committed by the view layer. The subscribe callback schedules a\n  // single rAF; for a heavy route (e.g. a long virtual list) the framework's\n  // commit can land AFTER that frame. Two distinct failures follow, each losing\n  // the saved position (Scenario 6 e2e, reproduced under CI's slower runner):\n  //\n  //   1. Container not mounted yet → `getContainer()` is `null`, the scroll\n  //      silently falls back to `window`, which on a container-only route has\n  //      nothing to scroll.\n  //   2. Container mounted but its content not laid out yet → `scrollHeight`\n  //      is still small, so a single `scrollTo({ top })` clamps short of the\n  //      saved position and never re-applies once layout grows.\n  //\n  // With no `scrollContainer` getter the target is always `window`, present\n  // from the first frame — restore in a single shot (unchanged behaviour). When\n  // a getter is configured we cannot tell \"this route legitimately uses window\"\n  // from \"the container is still mounting\", so re-apply the scroll on every\n  // frame for a bounded budget: window as a fallback while the container is\n  // absent (harmless clamp on container routes), the container itself once it\n  // appears. For instant restores we stop early the moment the position sticks;\n  // smooth restores animate asynchronously, so they run the full budget. The\n  // frame budget is the hard backstop against an unreachable target (saved\n  // position taller than the restored content).\n  const restorePos = (top: number): void => {\n    if (!getContainer) {\n      globalThis.scrollTo({ top, left: 0, behavior });\n\n      return;\n    }\n\n    let frames = 0;\n\n    const attempt = (): void => {\n      if (destroyed) {\n        return;\n      }\n\n      const element = getContainer();\n\n      if (element) {\n        element.scrollTo({ top, left: 0, behavior });\n\n        // Instant restore landed within rounding tolerance → done; no point\n        // re-applying. Smooth restore never matches synchronously, so let it\n        // ride the budget.\n        if (behavior !== \"smooth\" && Math.abs(element.scrollTop - top) <= 1) {\n          return;\n        }\n      } else {\n        globalThis.scrollTo({ top, left: 0, behavior });\n      }\n\n      if (frames >= RESTORE_RETRY_FRAMES) {\n        return;\n      }\n\n      frames += 1;\n      requestAnimationFrame(attempt);\n    };\n\n    attempt();\n  };\n\n  const scrollToHashOrTop = (route: State): void => {\n    // URL plugin path (#532): `state.context.url.hash` is the source of truth\n    // when one of the URL plugins (browser-plugin / navigation-plugin) is\n    // installed. The value is already DECODED — feeding it through\n    // `decodeURIComponent` again would throw on a bare `%`.\n    const ctxHash = (route.context as { url?: { hash?: string } } | undefined)\n      ?.url?.hash;\n\n    if (ctxHash !== undefined) {\n      if (anchorEnabled && ctxHash.length > 0) {\n        // eslint-disable-next-line unicorn/prefer-query-selector -- ids may contain CSS-unsafe chars\n        const element = document.getElementById(ctxHash);\n\n        if (element) {\n          element.scrollIntoView({ behavior });\n\n          return;\n        }\n      }\n\n      writePos(0);\n\n      return;\n    }\n\n    // Fallback path: no URL plugin, read the DOM. `location.hash` is\n    // percent-encoded; ids in the DOM are the raw string, so decode for the\n    // match. Fall back to the raw slice if the hash contains a malformed\n    // escape sequence (decodeURIComponent throws on those).\n    const hash = globalThis.location.hash;\n\n    if (anchorEnabled && hash.length > 1) {\n      let id: string;\n\n      try {\n        id = decodeURIComponent(hash.slice(1));\n      } catch {\n        id = hash.slice(1);\n      }\n\n      // eslint-disable-next-line unicorn/prefer-query-selector -- ids may contain CSS-unsafe chars\n      const element = document.getElementById(id);\n\n      if (element) {\n        element.scrollIntoView({ behavior });\n\n        return;\n      }\n    }\n\n    writePos(0);\n  };\n\n  let destroyed = false;\n  let unserializableWarned = false;\n\n  // `keyOf` defers to `canonicalJson` which calls `JSON.stringify`. Two\n  // realistic inputs blow up the serializer and would otherwise crash the\n  // subscribe callback (taking scroll-restore offline for the whole session):\n  //   - `BigInt` params → `TypeError: Do not know how to serialize a BigInt`\n  //   - cyclic params (reactive proxies, DOM-ref back-pointers) → stack\n  //     overflow.\n  // The defensive wrapper drops capture/restore for that specific navigation\n  // and warns once per provider — the rest of the cache stays usable.\n  const safeKeyOf = (state: State): string | null => {\n    try {\n      return keyOf(state);\n    } catch {\n      if (!unserializableWarned) {\n        unserializableWarned = true;\n        console.error(\n          `[real-router] scroll-restore: route \"${state.name}\" has params that cannot be canonicalized (e.g. BigInt or cyclic structure). Scroll position will not be captured or restored for this route.`,\n        );\n      }\n\n      return null;\n    }\n  };\n\n  const unsubscribe = router.subscribe(({ route, previousRoute }) => {\n    const nav = (route.context as { navigation?: NavigationContext })\n      .navigation;\n\n    // Browsers dispatch reload as the initial navigation after refresh, so\n    // previousRoute is undefined and capture is naturally skipped. The\n    // pre-refresh position was already persisted via pagehide.\n    if (previousRoute) {\n      const prevKey = safeKeyOf(previousRoute);\n\n      if (prevKey !== null) {\n        putPos(prevKey, readPos());\n      }\n    }\n\n    requestAnimationFrame(() => {\n      if (destroyed) {\n        return;\n      }\n\n      if (mode === \"top\") {\n        scrollToHashOrTop(route);\n\n        return;\n      }\n\n      // Restore branches (reload, back/traverse) MUST be evaluated before the\n      // replace-skip below. Since #657 lifted `replace` into TransitionMeta, a\n      // history TRAVERSAL (back/forward) under navigation-plugin carries\n      // `transition.replace === true` — a traversal reuses an existing history\n      // entry, which is replace-shaped at the history level. If the replace-skip\n      // ran first it would swallow every back/forward navigation and restore\n      // would never fire (the Scenario 6 e2e regression). Genuine in-place\n      // replaces (`router.navigate({ replace: true })`, navigateToNotFound) are\n      // not traversals and fall through to the skip below.\n      //\n      // Both arms of each check are required: `transition.reload` only fires for\n      // programmatic `router.navigate({reload:true})`. F5 under navigation-plugin\n      // primes `nav.navigationType === \"reload\"` via #531 getActivationType but\n      // leaves opts.reload undefined, so dropping the plugin arm would regress F5\n      // scroll-restore. Browser-plugin's F5 is not covered (no priming, out of\n      // scope).\n      if (route.transition.reload || nav?.navigationType === \"reload\") {\n        const key = safeKeyOf(route);\n\n        restorePos(key === null ? 0 : (loadStore()[key] ?? 0));\n\n        return;\n      }\n\n      if (nav?.direction === \"back\" || nav?.navigationType === \"traverse\") {\n        const key = safeKeyOf(route);\n\n        restorePos(key === null ? 0 : (loadStore()[key] ?? 0));\n\n        return;\n      }\n\n      // Genuine in-place replace (not a traversal) — leave scroll untouched.\n      if (route.transition.replace || nav?.navigationType === \"replace\") {\n        return;\n      }\n\n      scrollToHashOrTop(route);\n    });\n  });\n\n  const onPageHide = (): void => {\n    const current = router.getState();\n\n    if (current) {\n      const key = safeKeyOf(current);\n\n      if (key !== null) {\n        putPos(key, readPos());\n      }\n    }\n  };\n\n  globalThis.addEventListener(\"pagehide\", onPageHide);\n\n  return {\n    destroy: () => {\n      if (destroyed) {\n        return;\n      }\n\n      destroyed = true;\n      unsubscribe();\n      globalThis.removeEventListener(\"pagehide\", onPageHide);\n\n      try {\n        history.scrollRestoration = prevScrollRestoration;\n      } catch {\n        // Ignore.\n      }\n    },\n  };\n}\n\n/**\n * Internal cache-key builder for scroll-position storage.\n *\n * **Exported for testing only — not part of the public API** (intentionally\n * excluded from `index.ts` barrel). Adapter property tests import it via\n * the direct path to lock the `(name, canonicalJson(params))` key shape\n * as a regression guard (§8b H20 / audit-2026-05-16 #S3). A change to\n * key format would silently lose scroll positions across an upgrade —\n * the test set is the contract.\n *\n * ## Identity-based memoization (audit-2026-05-17 §8b #2)\n *\n * `State` objects emitted by core are frozen per-navigation: their\n * `name` / `params` are immutable for the lifetime of the snapshot, and\n * any change produces a new `State` reference. A `WeakMap<State, string>`\n * therefore safely caches the canonicalised key by identity — repeat\n * `keyOf(state)` calls on the same snapshot (typical on\n * back/forward/traverse where the same prior `State` is re-emitted)\n * skip the recursive `canonicalJson` pass entirely.\n *\n * The cache key is the `State` reference, so entries auto-release when\n * the snapshot is GC'd — no eviction needed.\n */\nconst KEY_CACHE = new WeakMap<State, string>();\n\nexport function keyOf(state: State): string {\n  const cached = KEY_CACHE.get(state);\n\n  if (cached !== undefined) {\n    return cached;\n  }\n\n  const key = `${state.name}:${canonicalJson(state.params)}`;\n\n  KEY_CACHE.set(state, key);\n\n  return key;\n}\n\n/**\n * Stable JSON serializer with sorted object keys.\n *\n * **Exported for testing only — not part of the public API** (intentionally\n * excluded from `index.ts` barrel). Adapter property tests import it via\n * the direct path to lock the key-order-insensitive property\n * (`canonicalJson({a:1,b:2}) === canonicalJson({b:2,a:1})`).\n *\n * ## Divergence from `@real-router/sources/canonicalJson` — by design\n *\n * Two independent implementations live in the monorepo:\n *\n * - **`shared/dom-utils/scroll-restore.canonicalJson`** (this file) — scroll\n *   cache key builder. Uses `localeCompare` and a plain-object accumulator;\n *   tolerates `__proto__`-keyed inputs only insofar as `JSON.stringify`'s\n *   replacer happens to sort them; relies on `JSON.stringify`'s native cycle\n *   detector. Designed to be cheap on the navigation hot path. The\n *   surrounding [[safeKeyOf]] wrapper catches the two crash inputs (`BigInt`,\n *   cyclic) and skips the offending capture/restore.\n *\n * - **`@real-router/sources/canonicalJson`** — sources cache key builder.\n *   Uses byte-order compare (`< / >`) for locale-independence, a\n *   `Object.create(null)` accumulator to prevent prototype pollution, and a\n *   bespoke path-based cycle detector (the native one cannot see the cloned\n *   graph). Throws eagerly on `Map`/`Set`/`RegExp`/cycles — the caller falls\n *   back to a non-cached source.\n *\n * **They are intentionally NOT interchangeable.** Aligning them would either\n * regress scroll-restore performance (byte-order + recursive clone is heavier\n * per call) or weaken the sources cache (locale dependence breaks\n * deterministic cache keys across machines). No cross-package equivalence\n * test exists or should be added; the relationship is \"different invariants,\n * different costs, different consumers.\" Audit-2 / audit-2026-05-17 §2\n * documents the choice.\n */\nexport function canonicalJson(value: unknown): string {\n  return JSON.stringify(value, canonicalReplacer);\n}\n\nfunction canonicalReplacer(_key: string, val: unknown): unknown {\n  // audit-2026-05-17 §5 MEDIUM (Sprint A.3) — function/Symbol marker.\n  // `JSON.stringify` silently drops function and symbol values from\n  // object output. Two routes that differ ONLY in a function/Symbol\n  // value would canonicalize to the same string → silent scroll-cache\n  // key collision (positions clobber each other). Replacing the value\n  // with a sentinel string breaks the collision while keeping the\n  // canonical form deterministic. The sentinels are intentionally\n  // ASCII-only and lexically distinct from valid JSON-stringified\n  // values; consumers will see `\"<fn>\"` / `\"<sym>\"` if they ever\n  // round-trip the cache key, signalling the substitution clearly.\n  if (typeof val === \"function\") {\n    return \"<fn>\";\n  }\n  if (typeof val === \"symbol\") {\n    return \"<sym>\";\n  }\n\n  if (val !== null && typeof val === \"object\" && !Array.isArray(val)) {\n    // Null-prototype accumulator: a plain `{}` would interpret\n    // `sorted[\"__proto__\"] = x` as a prototype assignment (silently dropped\n    // from JSON.stringify output AND a prototype-pollution vector). Mirrors\n    // the same guard in `@real-router/sources/canonicalJson`. The two\n    // implementations are still intentionally divergent (see the doc-block\n    // on [[canonicalJson]] above), but prototype-safety is non-negotiable\n    // on both. Lock-test: scrollRestoreKey.properties.ts Invariant 11.\n    const sorted = Object.create(null) as Record<string, unknown>;\n    // eslint-disable-next-line unicorn/no-array-sort -- ng-packagr uses pre-ES2023 lib; toSorted unavailable\n    const keys = Object.keys(val).sort((left: string, right: string) =>\n      left.localeCompare(right),\n    );\n\n    for (const key of keys) {\n      sorted[key] = (val as Record<string, unknown>)[key];\n    }\n\n    return sorted;\n  }\n\n  return val;\n}\n","import { getTransitionSource } from \"@real-router/sources\";\n\nimport type { NavigationOptions, Router } from \"@real-router/core\";\n\n/**\n * Router-coordinated scroll spy (#575).\n *\n * On `IntersectionObserver` notifications the utility picks the topmost\n * visible anchor inside the configured scroll container and emits a forced\n * same-route transition with `{ hash, replace: true, force: true, hashChange:\n * true }` through `router.navigate(...)`. The URL plugin\n * (`@real-router/browser-plugin` or `@real-router/navigation-plugin`) updates\n * `state.context.url.hash` so sibling hash-aware `<Link hash>` re-highlights\n * via the standard `createActiveRouteSource` pipeline.\n *\n * **Anti-flicker gates** (RFC §5.2):\n * 1. `getTransitionSource(router).getSnapshot().isTransitioning` — skip emits\n *    while a transition is in-flight (re-entrant lock).\n * 2. `coolingDown` — set on a user-driven hash transition (e.g. `<Link hash>`\n *    click + smooth `scrollIntoView`). Cleared on `scrollend` or after a\n *    500ms safety timeout. Spy's own emits are excluded via the synchronous\n *    `selfEmitting` flag — required so the spy doesn't rate-limit itself.\n *\n * **Self-healing** (RFC §7.3): if the initial URL contains a hash without a\n * matching `id` (e.g. `/page#nonexistent`), the first IO event emitted right\n * after observe()-ing picks the topmost real anchor and corrects the URL.\n *\n * **Hash-only transition pipeline cost** (RFC §5.3): for same-route same-\n * params hash-only navigations, `getTransitionPath` returns empty\n * `toDeactivate` / `toActivate` arrays, so `runGuards` is a no-op. The only\n * work is the URL plugin's `onTransitionSuccess` write and the\n * `getTransitionSource` flip — cheap.\n *\n * **Architecture**: decomposed into 4 private subsystem closure factories\n * (`createUrlPluginDetector`, `createCooldown`, `createDebouncer`,\n * `createObserverPair`). The main `createScrollSpy` wires them together\n * around the shared `silenced` / `destroyed` / `selfEmitting` flags and the\n * `flush()` emit logic. Each subsystem owns its state + cleanup; `destroy()`\n * delegates to each. See section banners below.\n *\n * @returns A `ScrollSpy` handle whose `destroy()` is idempotent.\n */\nexport interface ScrollSpyOptions {\n  /**\n   * CSS selector for anchor candidates. Empty string `\"\"` or `undefined`\n   * disables the spy (returns a NOOP handle). Common values:\n   * `\"[id]\"`, `\"[id]:is(h1,h2,h3)\"`, `\"section[id]\"`.\n   */\n  selector: string;\n\n  /**\n   * `IntersectionObserver` `rootMargin`. Default\n   * `\"-20% 0px -60% 0px\"` — an anchor is considered \"active\" once it crosses\n   * into the top 20 % of the viewport (or scroll container).\n   */\n  rootMargin?: string | undefined;\n\n  /**\n   * Lazy getter for the scrollable container. Resolved on every event.\n   * `null` (or missing getter) falls back to the window viewport\n   * (`root: null` on the `IntersectionObserver`).\n   */\n  scrollContainer?: (() => HTMLElement | null) | undefined;\n}\n\nexport interface ScrollSpy {\n  /** Tear down observer + listeners. Idempotent. */\n  destroy: () => void;\n}\n\nconst NOOP_INSTANCE: ScrollSpy = Object.freeze({\n  destroy: () => {\n    /* no-op */\n  },\n});\n\n// Hardcoded internals (RFC §5.1 — promote only with evidence).\nconst RAF_DEBOUNCE_MS = 150;\nconst MUTATION_DEBOUNCE_MS = 250;\nconst COOLDOWN_TIMEOUT_MS = 500;\nconst DEFAULT_ROOT_MARGIN = \"-20% 0px -60% 0px\";\n\n// Local extension type — browser-plugin / navigation-plugin augment\n// `NavigationOptions` with `hash` and `hashChange`, but `shared/dom-utils`\n// is plugin-agnostic and cannot rely on the augmentation. Mirrors the\n// `HashAwareNavigationOptions` pattern in `link-utils.ts`.\ntype HashAwareNavigationOptions = NavigationOptions & {\n  hash?: string;\n  hashChange?: boolean;\n};\n\ninterface UrlContextSlice {\n  hash?: string;\n  hashChanged?: boolean;\n}\n\nconst getUrlContext = (state: {\n  context?: unknown;\n}): UrlContextSlice | undefined =>\n  (state.context as { url?: UrlContextSlice } | undefined)?.url;\n\n// =============================================================================\n// Picker — pure, no state. RFC §5.2 selection rule.\n// =============================================================================\n\n// Pick the anchor closest to the active zone top in viewport coordinates.\n// `entry.rootBounds.top` already reflects `rootMargin` (per W3C IO spec\n// §3.3) — for `rootMargin: \"-20% 0px -60% 0px\"` it returns 20% of root\n// height, for `\"-50% 0px -50% 0px\"` it returns the center, etc. Distance\n// = boundingClientRect.top − zoneTop in viewport pixels: positive = anchor\n// below zone top (just entered), negative = anchor above zone top (body\n// crossing zone from above). We prefer smallest non-negative; fall back to\n// least-negative when no entry has crossed yet.\n// Falls back to zoneTop = 0 when rootBounds is null (cross-origin roots,\n// unit tests). Single pass — handles `Iterable` so flushes can pass\n// `Map.values()` directly without realising the array.\nconst pickTopmost = (\n  entries: Iterable<IntersectionObserverEntry>,\n): IntersectionObserverEntry | null => {\n  let bestPositive: IntersectionObserverEntry | null = null;\n  let bestPositiveDist = Number.POSITIVE_INFINITY;\n  let bestNegative: IntersectionObserverEntry | null = null;\n  let bestNegativeDist = Number.NEGATIVE_INFINITY;\n\n  for (const entry of entries) {\n    if (!entry.isIntersecting) {\n      continue;\n    }\n\n    const zoneTop = entry.rootBounds?.top ?? 0;\n    const distance = entry.boundingClientRect.top - zoneTop;\n\n    if (distance >= 0) {\n      if (distance < bestPositiveDist) {\n        bestPositive = entry;\n        bestPositiveDist = distance;\n      }\n    } else if (distance > bestNegativeDist) {\n      bestNegative = entry;\n      bestNegativeDist = distance;\n    }\n  }\n\n  return bestPositive ?? bestNegative;\n};\n\n// =============================================================================\n// Subsystem: URL plugin detector (RFC §5.5)\n// Calls `onMissing` if `state.context` is published but `url` key is missing\n// (i.e. no URL plugin installed). Either synchronous on start, or deferred\n// via a one-shot `router.subscribe` if the router has not started yet.\n// `silenced` flag itself lives in main scope — detector signals via callback\n// (per Oracle Q1 — `silenced` has multiple unrelated triggers; main scope\n// owns the kill switch).\n// =============================================================================\n\ninterface UrlPluginDetector {\n  destroy: () => void;\n}\n\nconst createUrlPluginDetector = (\n  router: Router,\n  onMissing: () => void,\n): UrlPluginDetector => {\n  let detectionUnsub: (() => void) | null = null;\n\n  const verify = (state: { context?: unknown }): void => {\n    const context = state.context as\n      | (Record<string, unknown> & { url?: unknown })\n      | undefined;\n\n    if (context && context.url === undefined) {\n      console.warn(\n        \"[real-router] scroll-spy: state.context.url is not claimed. \" +\n          \"Spy requires browser-plugin or navigation-plugin. Disabling.\",\n      );\n      onMissing();\n    }\n  };\n\n  const peekState = router.getState();\n\n  if (peekState) {\n    verify(peekState);\n  } else {\n    // Re-entry guard: `router.subscribe` MAY invoke the callback synchronously\n    // from inside `.subscribe(...)` before the function returns. In that case\n    // `detectionUnsub` is still `null` when the callback fires. Without this\n    // boolean, a hypothetical multi-fire would double-warn.\n    let detectionConsumed = false;\n\n    detectionUnsub = router.subscribe(({ route }) => {\n      if (detectionConsumed) {\n        return;\n      }\n\n      detectionConsumed = true;\n      verify(route);\n\n      detectionUnsub?.();\n      detectionUnsub = null;\n    });\n  }\n\n  return {\n    destroy(): void {\n      detectionUnsub?.();\n      detectionUnsub = null;\n    },\n  };\n};\n\n// =============================================================================\n// Subsystem: Cooldown gate (RFC §5.2 — anti-flicker for smooth scrollIntoView)\n// Set on user-driven `<Link hash>` click → smooth scroll. Cleared on\n// `scrollend` (Baseline 2026) or 500ms safety timeout (older Safari).\n// =============================================================================\n\ninterface Cooldown {\n  readonly active: boolean;\n  start: () => void;\n  destroy: () => void;\n}\n\nconst createCooldown = (getContainer: () => HTMLElement | null): Cooldown => {\n  let active = false;\n  let timeout: ReturnType<typeof setTimeout> | null = null;\n  let listenerContainer: HTMLElement | null = null;\n  let listener: (() => void) | null = null;\n\n  const clear = (): void => {\n    if (timeout !== null) {\n      clearTimeout(timeout);\n      timeout = null;\n    }\n\n    if (listener) {\n      const target: EventTarget = listenerContainer ?? globalThis;\n\n      target.removeEventListener(\"scrollend\", listener);\n    }\n\n    listener = null;\n    listenerContainer = null;\n    active = false;\n  };\n\n  return {\n    get active(): boolean {\n      return active;\n    },\n    start(): void {\n      // Reset rather than stack timers if cooldown is already active.\n      clear();\n\n      active = true;\n\n      const lift = (): void => {\n        clear();\n      };\n\n      listener = lift;\n      listenerContainer = getContainer();\n\n      const target: EventTarget = listenerContainer ?? globalThis;\n\n      target.addEventListener(\"scrollend\", lift, { once: true });\n\n      timeout = setTimeout(lift, COOLDOWN_TIMEOUT_MS);\n    },\n    destroy(): void {\n      clear();\n    },\n  };\n};\n\n// =============================================================================\n// Subsystem: rAF + trailing debounce (RFC §5.1)\n// Coalesces a burst of IO events into ≤ 1 callback per debounce window.\n// rAF reduces N setTimeout creations to 1 per animation frame; the trailing\n// 150ms setTimeout waits for the IO stream to quiesce.\n// =============================================================================\n\ninterface Debouncer {\n  schedule: () => void;\n  destroy: () => void;\n}\n\nconst createDebouncer = (\n  callback: () => void,\n  trailingMs: number,\n): Debouncer => {\n  let raf: number | null = null;\n  let timeout: ReturnType<typeof setTimeout> | null = null;\n\n  return {\n    schedule(): void {\n      if (raf !== null) {\n        return;\n      }\n\n      raf = requestAnimationFrame(() => {\n        raf = null;\n\n        if (timeout !== null) {\n          clearTimeout(timeout);\n        }\n\n        timeout = setTimeout(() => {\n          timeout = null;\n          callback();\n        }, trailingMs);\n      });\n    },\n    destroy(): void {\n      if (raf !== null) {\n        cancelAnimationFrame(raf);\n        raf = null;\n      }\n\n      if (timeout !== null) {\n        clearTimeout(timeout);\n        timeout = null;\n      }\n    },\n  };\n};\n\n// =============================================================================\n// Subsystem: Observer pair (IntersectionObserver + MutationObserver)\n// IO + MO genuinely form one subsystem — both write/read `observed` set and\n// `pending` map, and reconcile flow couples them. Per Oracle Q10, splitting\n// would force cross-subsystem references that re-introduce the wiring\n// problem we're trying to solve.\n//\n// Exposes `pending` directly (per Oracle Q4: hiding behind `consume()` adds\n// boilerplate without isolating the shared mutable state — observers write\n// from IO callbacks while main scope reads in `flush()`).\n// =============================================================================\n\ninterface ObserverPair {\n  readonly pending: Map<Element, IntersectionObserverEntry>;\n  destroy: () => void;\n}\n\nconst createObserverPair = (\n  selector: string,\n  rootMargin: string,\n  getContainer: () => HTMLElement | null,\n  onIntersection: () => void,\n  onInvalidSelector: () => void,\n  isStopped: () => boolean,\n): ObserverPair => {\n  const observed = new Set<Element>();\n  // Latest IO entry per target — accumulated across batches. IO delivers\n  // entries only for targets whose intersection state CHANGED (W3C IO\n  // §3.2.1), so a fast scroll that lands two callbacks inside the same\n  // debounce window must merge by target, not overwrite. Entries are\n  // dropped from the map when their target leaves the DOM (see `reconcile`)\n  // and on `destroy()`.\n  const pending = new Map<Element, IntersectionObserverEntry>();\n\n  let duplicateIdWarned = false;\n  let mutationTimer: ReturnType<typeof setTimeout> | null = null;\n\n  const handleIntersection: IntersectionObserverCallback = (entries) => {\n    // Defensive: IO callback may fire AFTER `destroy()` if a queued event\n    // was already scheduled by the browser before `disconnect()`. Cheap\n    // belt-and-suspenders.\n    if (isStopped()) {\n      return;\n    }\n\n    for (const entry of entries) {\n      pending.set(entry.target, entry);\n    }\n\n    onIntersection();\n  };\n\n  const io = new IntersectionObserver(handleIntersection, {\n    root: getContainer(),\n    rootMargin,\n    threshold: 0,\n  });\n\n  const observeMatches = (): void => {\n    const scope = getContainer() ?? document;\n    let candidates: NodeListOf<Element>;\n\n    try {\n      candidates = scope.querySelectorAll(selector);\n    } catch {\n      onInvalidSelector();\n\n      return;\n    }\n\n    const seenIds = new Set<string>();\n\n    for (const element of candidates) {\n      // Detect duplicate ids once (RFC §7.7). The DOM permits duplicate ids\n      // even though it is a markup bug; the spy keeps working but picks the\n      // first one deterministically via the topmost-visible rule.\n      const id = (element as HTMLElement).id;\n\n      if (id && !duplicateIdWarned) {\n        if (seenIds.has(id)) {\n          duplicateIdWarned = true;\n\n          console.warn(\n            `[real-router] scroll-spy: duplicate id \"${id}\" observed. ` +\n              \"Selection picks the topmost visible match deterministically.\",\n          );\n        }\n\n        seenIds.add(id);\n      }\n\n      if (observed.has(element)) {\n        continue;\n      }\n\n      io.observe(element);\n      observed.add(element);\n    }\n  };\n\n  const reconcile = (): void => {\n    // Drop observed elements that left the DOM. Avoids observer holding\n    // strong refs to detached nodes. Also drop their accumulated entry so\n    // stale \"was intersecting\" state for a removed node cannot be picked\n    // by `pickTopmost` after the node is gone.\n    for (const element of observed) {\n      if (!element.isConnected) {\n        io.unobserve(element);\n        observed.delete(element);\n        pending.delete(element);\n      }\n    }\n\n    observeMatches();\n  };\n\n  observeMatches();\n\n  // MutationObserver targets the scroll container (or document.body for\n  // window viewport). `childList: true, subtree: true` catches structural\n  // changes; `attributes: true, attributeFilter: [\"id\"]` catches anchor\n  // id renames (typical for client-rendered docs).\n  const mutationTarget = getContainer() ?? document.body;\n\n  const mo = new MutationObserver(() => {\n    if (mutationTimer !== null) {\n      clearTimeout(mutationTimer);\n    }\n\n    mutationTimer = setTimeout(() => {\n      mutationTimer = null;\n      reconcile();\n    }, MUTATION_DEBOUNCE_MS);\n  });\n\n  mo.observe(mutationTarget, {\n    childList: true,\n    subtree: true,\n    attributes: true,\n    attributeFilter: [\"id\"],\n  });\n\n  return {\n    pending,\n    destroy(): void {\n      io.disconnect();\n      mo.disconnect();\n\n      if (mutationTimer !== null) {\n        clearTimeout(mutationTimer);\n        mutationTimer = null;\n      }\n\n      observed.clear();\n      pending.clear();\n    },\n  };\n};\n\n// =============================================================================\n// Main: compositional wiring\n// =============================================================================\n\nexport function createScrollSpy(\n  router: Router,\n  options: ScrollSpyOptions,\n): ScrollSpy {\n  // SSR guard (RFC §7.5) — return early without warnings.\n  if (typeof document === \"undefined\") {\n    return NOOP_INSTANCE;\n  }\n\n  // Feature-detect IntersectionObserver — no polyfill ships (RFC §4).\n  if (typeof IntersectionObserver === \"undefined\") {\n    return NOOP_INSTANCE;\n  }\n\n  const { selector } = options;\n\n  // Empty selector → disabled. Documented opt-out for conditional enabling\n  // (RFC §5.4 `scrollSpy={{ selector: enable ? \"[id]\" : \"\" }}`).\n  if (!selector) {\n    return NOOP_INSTANCE;\n  }\n\n  const rootMargin = options.rootMargin ?? DEFAULT_ROOT_MARGIN;\n  const getContainer = options.scrollContainer;\n  const resolveContainer = (): HTMLElement | null => getContainer?.() ?? null;\n\n  // Shared lifecycle flags (Oracle Q1 — `silenced` has multiple unrelated\n  // triggers; Oracle Q3 — `selfEmitting` synchronously bracketed around\n  // `router.navigate()` cannot cleanly extract). Kept in main scope.\n  let destroyed = false;\n  let silenced = false;\n  let selfEmitting = false;\n\n  const isStopped = (): boolean => silenced || destroyed;\n\n  // Symmetric late-binding (Oracle Q2): declare `flush` as nullable, wire\n  // debouncer + observers, then assign the real implementation. Reads as\n  // intentional wiring rather than accidental closure capture ordering.\n  // The `flush?.()` call below safely no-ops if a callback somehow fires\n  // before assignment (impossible in practice — IO/debounce are async).\n  let flush: (() => void) | null = null;\n\n  const transitionSource = getTransitionSource(router);\n\n  const detector = createUrlPluginDetector(router, () => {\n    silenced = true;\n  });\n\n  const cooldown = createCooldown(resolveContainer);\n\n  const debouncer = createDebouncer(() => {\n    flush?.();\n  }, RAF_DEBOUNCE_MS);\n\n  const observers = createObserverPair(\n    selector,\n    rootMargin,\n    resolveContainer,\n    () => {\n      debouncer.schedule();\n    },\n    () => {\n      if (silenced) {\n        return;\n      }\n\n      silenced = true;\n\n      console.warn(\n        `[real-router] scroll-spy: invalid selector \"${selector}\". Disabling.`,\n      );\n    },\n    isStopped,\n  );\n\n  flush = (): void => {\n    if (destroyed || silenced) {\n      observers.pending.clear();\n\n      return;\n    }\n\n    // Gate-skipped flushes keep `pendingEntries` populated — the merged\n    // state is still the best-known snapshot, and the next non-gated flush\n    // consumes it. Clearing under a gate would re-introduce the overwrite\n    // bug for any anchor whose intersection state did not change during\n    // the gate window.\n    if (transitionSource.getSnapshot().isTransitioning) {\n      return;\n    }\n\n    if (cooldown.active) {\n      return;\n    }\n\n    if (observers.pending.size === 0) {\n      return;\n    }\n\n    // Successful flush consumes the merged snapshot. We clear so that the\n    // next debounce window starts fresh; an anchor that is still\n    // intersecting will only stay observable if IO emits another event for\n    // it (which it does whenever the anchor's intersection state actually\n    // changes). Skipping the clear here would leak state from one user-\n    // perceived \"scroll stop\" into the next.\n    const picked = pickTopmost(observers.pending.values());\n\n    observers.pending.clear();\n\n    if (!picked) {\n      // No anchor visible / above zone — preserve last hash (RFC §10 #5).\n      return;\n    }\n\n    const newHash = (picked.target as HTMLElement).id;\n\n    if (!newHash) {\n      return;\n    }\n\n    const state = router.getState();\n\n    if (!state) {\n      return;\n    }\n\n    const currentHash = getUrlContext(state)?.hash ?? \"\";\n\n    if (newHash === currentHash) {\n      return;\n    }\n\n    // Emit the same-route same-params hash-only transition. URL plugin\n    // writes `state.context.url.hash = newHash` + `hashChanged = true` in\n    // its `onTransitionSuccess` claim.\n    const opts: HashAwareNavigationOptions = {\n      hash: newHash,\n      replace: true,\n      force: true,\n      hashChange: true,\n    };\n\n    // Self-emit guard (RFC §5.2): set synchronously around our own\n    // `router.navigate()` so the `router.subscribe` callback skips the\n    // cooldown setup for spy-emitted transitions — otherwise spy would\n    // rate-limit itself to ≤ 2 emits/s, contradicting the ≤ 10/s benchmark\n    // target. Test coupling (Q8): preserve exact `.catch(noop).finally(reset)`\n    // chain — migrating to `try/finally` over `await router.navigate(...)`\n    // changes microtask schedule and breaks \"spy continues after rejection\".\n    selfEmitting = true;\n    router\n      .navigate(state.name, state.params, opts)\n      .catch(() => {\n        // Fire-and-forget — suppress expected rejections (concurrent\n        // navigate, router stopped, etc.) consistent with `<Link>` adapter\n        // patterns.\n      })\n      .finally(() => {\n        selfEmitting = false;\n      });\n  };\n\n  // Cooldown setup on user-driven hash transitions. Spy's own emits are\n  // distinguished via the synchronous `selfEmitting` flag (see `flush`).\n  const unsubscribeRouter = router.subscribe(({ route }) => {\n    if (selfEmitting) {\n      return;\n    }\n\n    if (getUrlContext(route)?.hashChanged) {\n      cooldown.start();\n    }\n  });\n\n  return {\n    destroy(): void {\n      if (destroyed) {\n        return;\n      }\n\n      destroyed = true;\n\n      // Unsubscribe FIRST to prevent late-arriving router transition\n      // callback from calling `cooldown.start()` on a half-destroyed\n      // instance. Without this ordering, a transition with `hashChanged:\n      // true` firing between subsystem teardown and `unsubscribeRouter()`\n      // would re-install a 500ms timer that survives `destroy()`. Verified\n      // via Oracle review (Q5/Q7).\n      unsubscribeRouter();\n\n      observers.destroy();\n      debouncer.destroy();\n      cooldown.destroy();\n      detector.destroy();\n    },\n  };\n}\n","import type { Router } from \"@real-router/core\";\n\nexport interface ViewTransitions {\n  destroy: () => void;\n}\n\nconst NOOP_INSTANCE: ViewTransitions = Object.freeze({\n  destroy: () => {\n    /* no-op */\n  },\n});\n\nexport function createViewTransitions(router: Router): ViewTransitions {\n  if (\n    typeof document === \"undefined\" ||\n    typeof document.startViewTransition !== \"function\"\n  ) {\n    return NOOP_INSTANCE;\n  }\n\n  let closeVT: (() => void) | null = null;\n  let currentVT: { skipTransition?: () => void } | null = null;\n  // Tracks whether TRANSITION_SUCCESS fired for the current leave. Used to\n  // distinguish \"benign cleanup abort\" (router's async path aborts its own\n  // controller in a finally block after successful navigation) from \"real\n  // cancellation\" (concurrent navigate, guard rejection, dispose).\n  let successFired = false;\n\n  const resolveAndClear = (): void => {\n    closeVT?.();\n    closeVT = null;\n  };\n\n  const offLeave = router.subscribeLeave(({ signal }) => {\n    // Reentrant abort: signal already aborted when we're called. Open no VT\n    // — router will fall through to TRANSITION_CANCELLED via isCurrentNav()\n    // after leave resolves. addEventListener(\"abort\", ...) does not re-fire\n    // for past events, so skipping startViewTransition is the safe path.\n    if (signal.aborted) {\n      return;\n    }\n\n    successFired = false;\n    resolveAndClear();\n\n    // Return a Promise so the router awaits until the browser invokes\n    // updateCallback. This ensures old DOM snapshot is captured BEFORE the\n    // router commits the new state — giving correct exit→state→entry\n    // ordering (vs fire-and-forget, where URL changes before VT captures).\n    return new Promise<void>((resolveLeave) => {\n      // Capture the resolver synchronously BEFORE startViewTransition() is\n      // called. The browser invokes updateCallback in a later task, but\n      // router.subscribe (TRANSITION_SUCCESS) can fire before that. If we\n      // captured `resolve` inside the callback, subscribe would see closeVT\n      // still null and skip resolving — the deferred would hang for 4s\n      // until the VT API aborts with TimeoutError.\n      const deferred = new Promise<void>((resolve) => {\n        closeVT = resolve;\n      });\n\n      signal.addEventListener(\n        \"abort\",\n        () => {\n          if (successFired) {\n            // Router's async path (#finishAsyncNavigation) aborts its own\n            // controller in a finally block AFTER completeTransition (and\n            // thus AFTER subscribe fired). This is cleanup, not\n            // cancellation — VT is progressing normally, do nothing.\n            return;\n          }\n\n          // Real cancellation (concurrent navigate, dispose). Resolve the\n          // deferred so updateCallback can complete, skip the VT so no\n          // stale animation leaks, and unblock the router if the abort\n          // fires before updateCallback was invoked.\n          resolveAndClear();\n          currentVT?.skipTransition?.();\n          resolveLeave();\n        },\n        { once: true },\n      );\n\n      try {\n        currentVT = document.startViewTransition(() => {\n          // Resolving here unblocks the router at the moment the browser\n          // enters updateCallback — by spec, old DOM snapshot is captured\n          // before this callback runs. Router now proceeds through\n          // activation guards and setState; the VT animation waits on\n          // `deferred`, which is resolved from router.subscribe after a\n          // task-queue tick (see NOTE on setTimeout below).\n          resolveLeave();\n\n          return deferred;\n        });\n      } catch {\n        // Defensive: spec says startViewTransition doesn't throw under\n        // normal conditions, but Chromium has had edge cases (detached\n        // document, extension interference). Clean up and unblock router.\n        resolveAndClear();\n        resolveLeave();\n      }\n    });\n  });\n\n  const offSuccess = router.subscribe(() => {\n    const resolver = closeVT;\n\n    successFired = true;\n    closeVT = null;\n\n    if (resolver === null) {\n      currentVT = null;\n    } else {\n      // CRITICAL: CANNOT use requestAnimationFrame here. When the router\n      // takes the async path (leave returned a Promise), subscribe fires\n      // AFTER the browser has already transitioned VT into the\n      // \"update-callback-called\" phase. In that phase Chromium sets\n      // rendering suppression to true, which ALSO blocks rAF callbacks.\n      // rAF would never fire → deferred never resolves → browser aborts\n      // vt.ready with TimeoutError after 4s (observed in Chromium).\n      //\n      // setTimeout runs on the task queue independent of the rendering\n      // pipeline, so it fires regardless of suppression. React's scheduler\n      // uses MessageChannel tasks, which are queued before our setTimeout,\n      // so the new DOM is committed by the time our callback runs.\n      setTimeout(() => {\n        resolver();\n        currentVT = null;\n      }, 0);\n    }\n  });\n\n  return {\n    destroy: () => {\n      offLeave();\n      offSuccess();\n      currentVT?.skipTransition?.();\n      currentVT = null;\n      resolveAndClear();\n    },\n  };\n}\n","import type {\n  NavigationOptions,\n  Params,\n  Router,\n  State,\n} 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\n// Matches a single percent-escape triple (`%` + two hex digits). Used as\n// the \"already-encoded\" probe in `encodeFragmentInline` below — see the\n// idempotency rationale there.\nconst PERCENT_ESCAPE_PROBE = /%[\\dA-Fa-f]{2}/;\n\n/**\n * RFC 3986 fragment encoding: preserve sub-delims (`&`, `=`, `?`, `:`),\n * encode space, `%`, control chars, non-ASCII via encodeURI; defensively\n * escape `#` (encodeURI does not). Mirrors `encodeHashFragment` in\n * `shared/browser-env/url-context.ts` — duplicated here because the\n * shared/dom-utils symlink graph does not reach shared/browser-env.\n *\n * **Idempotency for pre-encoded input (audit-2026-05-17 §5 MEDIUM E.1).**\n * The doc-comment on `<Link hash>` says the value is a \"decoded fragment\n * without leading #\". But realistic consumers copy hashes out of\n * `location.hash` (which is percent-encoded) and pass them back, so the\n * naive `encodeURI(\"%20\")` would double-encode into `\"%2520\"` and break\n * anchor lookup. We detect a percent-escape triple in the input and, if\n * present, decode + re-encode for idempotency. Malformed `%XX` (e.g.\n * `\"%2\"` or `\"%ZZ\"`) makes `decodeURIComponent` throw — in that case we\n * fall through to plain `encodeURI`, which never throws.\n */\nfunction encodeFragmentInline(decoded: string): string {\n  if (PERCENT_ESCAPE_PROBE.test(decoded)) {\n    try {\n      const roundtrip = decodeURIComponent(decoded);\n\n      return encodeURI(roundtrip).replaceAll(\"#\", \"%23\");\n    } catch {\n      // Malformed `%XX` — fall through to the plain encoding path.\n      // encodeURI does not throw on malformed escapes; it treats the\n      // `%` as a literal and percent-encodes it (`%2` → `%252`).\n    }\n  }\n\n  return encodeURI(decoded).replaceAll(\"#\", \"%23\");\n}\n\ntype BuildUrlFn = (\n  name: string,\n  params: Params,\n  options?: { hash?: string },\n) => string | undefined;\n\n/**\n * Builds an href for a `<Link>` element.\n *\n * - Prefers the URL plugin's `buildUrl` (browser-plugin, navigation-plugin,\n *   hash-plugin) when present.\n * - Falls back to `router.buildPath` for runtimes without a URL plugin\n *   (memory-plugin, console UIs, NativeScript). In that fallback the hash\n *   is appended manually so the rendered href is still correct.\n * - The optional 4th argument is an options object so the contract stays\n *   extensible. The `hash` option is a decoded fragment without leading \"#\";\n *   `<Link hash=\"#section\">` is accepted defensively (leading \"#\" stripped).\n *   Frozen API: previous 3-arg call sites continue to work unchanged.\n */\nexport function buildHref(\n  router: Router,\n  routeName: string,\n  routeParams: Params,\n  options?: { hash?: string },\n): string | undefined {\n  try {\n    const rawHash = options?.hash;\n    let normHash: string | undefined;\n\n    if (rawHash !== undefined) {\n      normHash = rawHash.startsWith(\"#\") ? rawHash.slice(1) : rawHash;\n    }\n\n    const buildUrl = router.buildUrl as BuildUrlFn | undefined;\n\n    if (buildUrl) {\n      const url = buildUrl(\n        routeName,\n        routeParams,\n        normHash === undefined ? undefined : { hash: normHash },\n      );\n\n      // Accept only non-empty strings. The BuildUrlFn type contract is\n      // `string | undefined`, but defensive against:\n      //   - `\"\"` (empty string) → would render `<a href=\"\">`, which resolves\n      //     to the current page URL → silent self-navigation on click.\n      //   - `null` (type-contract violation) → would render `<a href={null}>`,\n      //     stringified to `\"null\"` in some renderers.\n      // Either case falls through to the `router.buildPath` fallback below.\n      if (typeof url === \"string\" && url.length > 0) {\n        return url;\n      }\n    }\n\n    const path = router.buildPath(routeName, routeParams);\n\n    // Symmetric to the buildUrl guard above (#S1 audit, Invariant 12).\n    // `router.buildPath` is typed `string`, but defends against:\n    //   - `\"\"` (empty string) — would render `<a href=\"\">`, which resolves\n    //     to the current page URL → silent self-navigation on click.\n    //   - non-string type-contract violations from custom path-matchers.\n    // Both yield `undefined` (renderer drops the attribute) with a warning.\n    if (typeof path !== \"string\" || path.length === 0) {\n      console.error(\n        `[real-router] Route \"${routeName}\" yielded an empty path. The element will render without an href attribute.`,\n      );\n\n      return undefined;\n    }\n\n    return normHash ? `${path}#${encodeFragmentInline(normHash)}` : path;\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\n/**\n * `<Link>` click-handler navigation helper (#532).\n *\n * Wraps `router.navigate(name, params, opts)` with same-route different-hash\n * detection: when the consumer clicks a hash-bearing Link that targets the\n * current route with the same params but a different fragment, core's\n * SAME_STATES check would otherwise reject the navigation. The helper adds\n * `force: true` and `hashChange: true` automatically — subscribers can then\n * disambiguate via `state.context.url.hashChanged`.\n *\n * For pure programmatic same-route hash-only navigation, callers are\n * documented to pass `{ force: true }` themselves; the auto-bypass here is\n * a UX convenience for `<Link hash>` that all 6 framework adapters share.\n */\n/**\n * Local extended-options type. Adapters that depend only on `@real-router/core`\n * (without a URL plugin) do not see the `NavigationOptions` augmentation that\n * declares `hash` / `hashChange`. Casting to this widened type inside the\n * helper keeps shared/dom-utils self-contained — adapters do not need to\n * augment NavigationOptions themselves to consume `<Link hash>`.\n */\ntype HashAwareNavigationOptions = NavigationOptions & {\n  hash?: string;\n  hashChange?: boolean;\n};\n\nexport function navigateWithHash(\n  router: Router,\n  routeName: string,\n  routeParams: Params,\n  hash: string | undefined,\n  extraOptions?: NavigationOptions,\n): Promise<State> {\n  const opts: HashAwareNavigationOptions = { ...extraOptions };\n\n  if (hash !== undefined) {\n    opts.hash = hash;\n  }\n\n  const current = router.getState();\n\n  if (\n    current?.name === routeName &&\n    shallowEqual(current.params, routeParams)\n  ) {\n    const currentHash =\n      (current.context as { url?: { hash?: string } } | undefined)?.url?.hash ??\n      \"\";\n    const newHash = hash ?? currentHash;\n\n    if (currentHash !== newHash) {\n      opts.force = true;\n      opts.hashChange = true;\n    }\n  }\n\n  return router.navigate(routeName, routeParams, opts);\n}\n\n// Match-any-whitespace regex shared across calls. RegExp literals at\n// call-site recompile in some engines; lifting it avoids that microcost\n// for the slow-path branch.\nconst WHITESPACE_PROBE = /\\s/;\nconst WHITESPACE_SPLIT = /\\S+/g;\n\nfunction parseTokens(value: string | undefined): string[] {\n  if (!value) {\n    return [];\n  }\n\n  // Hot-path fast-path (audit-2026-05-17 §8b #1): >99% of active-class\n  // inputs at `<Link>` emit are single-token strings like `\"active\"` or\n  // `\"is-current\"` — no whitespace, no leading/trailing pad. Skip the\n  // regex match and Array result allocation: a literal `[value]` works\n  // because the slow-path `match(/\\S+/g)` would return exactly `[value]`\n  // for the same input. PBT lock: linkUtils.properties.ts Invariant 13.\n  if (!WHITESPACE_PROBE.test(value)) {\n    return [value];\n  }\n\n  return value.match(WHITESPACE_SPLIT) ?? [];\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\n/**\n * One-level structural equality using `Object.is` per key.\n *\n * **String-keyed properties only (Mini-sprint E.3 — audit-5 §4.2 #3).**\n * Implementation walks `Object.keys()` which by spec returns only\n * enumerable own STRING keys. Symbol-keyed properties — created via\n * `obj[Symbol(\"brand\")] = value` or `{ [Symbol(...)]: value }` — are\n * NOT compared. Two records that differ only in a Symbol-keyed value\n * will compare as equal.\n *\n * This is intentional: route params and Link options are documented as\n * string-keyed primitives (string | number | boolean) — Symbol-keyed\n * metadata (e.g. brand markers, private state) doesn't belong in a\n * cache-key comparison. Switching to `Reflect.ownKeys()` would extend\n * the contract to symbols at the cost of one extra allocation per call\n * (Reflect.ownKeys composes string-keys + symbol-keys arrays). If a\n * consumer relies on symbol-keyed metadata for navigation\n * disambiguation, they should encode it into a string key instead.\n *\n * Mirrors React's `shallowEqual` (packages/shared/shallowEqual.js) in\n * both the string-keys-only semantics and the `hasOwnProperty` guard\n * below.\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    // hasOwnProperty guard: without it, a key missing in `next` reads as\n    // `undefined` and falsely matches `prev[key] === undefined`. Same shape\n    // as React's shallowEqual (packages/shared/shallowEqual.js).\n    if (\n      !Object.prototype.hasOwnProperty.call(next, key) ||\n      !Object.is(prevRecord[key], nextRecord[key])\n    ) {\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\n  // Cross-realm safety (audit-2026-05-17 §5 HIGH #4):\n  // `instanceof HTMLAnchorElement` compares against the constructor from\n  // the CURRENT realm. An element created in a different window (iframe\n  // contentDocument, micro-frontend, embedded widget) fails the check\n  // even when it IS a real anchor — the helper would then inject\n  // role=\"link\" + tabindex=\"0\" on top of native anchor semantics,\n  // breaking screen reader output (\"link link\") and focus order.\n  //\n  // tagName is realm-agnostic and is uppercase for HTML-namespaced\n  // elements in any document. SVG `<a>` has lowercase tagName plus a\n  // different prototype (SVGAElement) — skipping it here is wrong by\n  // accident: SVG anchors don't have keyboard activation semantics the\n  // helper would add. But they also don't reach this helper in\n  // practice (router Link components emit HTML anchors). Lock the\n  // uppercase compare to keep the contract narrow.\n  const tag = element.tagName;\n\n  if (tag === \"A\" || tag === \"BUTTON\") {\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 { useMemo, 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  hash?: string,\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. The\n  // `hash` argument (#532) is part of the cache key when defined: a Link\n  // pointing to `/settings#account` shares its source only with other\n  // consumers using the same routeName + params + hash.\n  //\n  // The useMemo wrap skips `canonicalJson(params)` + cache lookup on every\n  // render when all primitive deps and the `params` reference are stable —\n  // the common case once memo()+shallowEqual has bailed out further up\n  // (or when the parent re-renders for a non-Link reason). For inline\n  // `params={{id:1}}` the dep changes per render and the lookup still\n  // runs, but that path was already the slow path before this memo.\n  // exactOptionalPropertyTypes forbids `{ hash: undefined }` literally, so\n  // we conditionally spread the key only when the caller passed a value.\n  const store = useMemo(\n    () =>\n      createActiveRouteSource(router, routeName, params, {\n        strict,\n        ignoreQueryParams,\n        ...(hash !== undefined && { hash }),\n      }),\n    [router, routeName, params, strict, ignoreQueryParams, hash],\n  );\n\n  return useSyncExternalStore(\n    store.subscribe,\n    store.getSnapshot,\n    store.getSnapshot,\n  );\n}\n","import { createDismissableError } from \"@real-router/sources\";\nimport {\n  useEffect,\n  useLayoutEffect,\n  useMemo,\n  useRef,\n  useSyncExternalStore,\n} from \"react\";\n\nimport { useRouter } from \"../hooks/useRouter\";\n\nimport type { RouterError, State } from \"@real-router/core\";\nimport type { ReactElement, ReactNode } 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): ReactElement {\n  const router = useRouter();\n  // Per-router cached in @real-router/sources — the WeakMap lookup is cheap,\n  // but useMemo avoids it entirely on stable-router re-renders (the common\n  // case for boundaries mounted in app shells).\n  const store = useMemo(() => createDismissableError(router), [router]);\n  const snapshot = useSyncExternalStore(\n    store.subscribe,\n    store.getSnapshot,\n    store.getSnapshot,\n  );\n\n  const onErrorRef = useRef(onError);\n\n  // \"Latest ref\" pattern shared with useRouteEnter/useRouteExit: sync the\n  // callback to the ref via useLayoutEffect (synchronous, post-render,\n  // pre-paint) so the snapshot effect below reads the freshest callback\n  // without listing `onError` as a dep — and StrictMode's double-effect\n  // pass writes the same value twice harmlessly.\n  useLayoutEffect(() => {\n    onErrorRef.current = onError;\n  });\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","import { 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","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 {\n  createRouteAnnouncer,\n  createScrollRestoration,\n  createScrollSpy,\n  createViewTransitions,\n} from \"./dom-utils\";\n\nimport type { ScrollRestorationOptions, ScrollSpyOptions } from \"./dom-utils\";\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  scrollRestoration?: ScrollRestorationOptions;\n  scrollSpy?: ScrollSpyOptions;\n  viewTransitions?: boolean;\n}\n\nexport const RouterProvider: FC<RouteProviderProps> = ({\n  router,\n  children,\n  announceNavigation,\n  scrollRestoration,\n  scrollSpy,\n  viewTransitions,\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  // Primitive deps so inline `{ mode: \"restore\" }` doesn't thrash on every\n  // render. scrollContainer is a getter invoked lazily on every event inside\n  // the utility — swapping its reference doesn't change the resolved element,\n  // so we intentionally omit it from deps to keep inline getters stable.\n  const srMode = scrollRestoration?.mode;\n  const srAnchor = scrollRestoration?.anchorScrolling;\n  const srBehavior = scrollRestoration?.behavior;\n  const srStorageKey = scrollRestoration?.storageKey;\n  const srEnabled = scrollRestoration !== undefined;\n\n  useEffect(() => {\n    if (!srEnabled) {\n      return;\n    }\n\n    const sr = createScrollRestoration(router, {\n      mode: srMode,\n      anchorScrolling: srAnchor,\n      behavior: srBehavior,\n      storageKey: srStorageKey,\n      // srEnabled check above guarantees scrollRestoration is defined.\n      scrollContainer: scrollRestoration.scrollContainer,\n    });\n\n    return () => {\n      sr.destroy();\n    };\n    // scrollRestoration (for scrollContainer) omitted — see comment above.\n    // eslint-disable-next-line @eslint-react/exhaustive-deps\n  }, [router, srEnabled, srMode, srAnchor, srBehavior, srStorageKey]);\n\n  const spySelector = scrollSpy?.selector;\n  const spyRootMargin = scrollSpy?.rootMargin;\n  const spyEnabled =\n    scrollSpy !== undefined && spySelector !== undefined && spySelector !== \"\";\n\n  useEffect(() => {\n    if (!spyEnabled) {\n      return;\n    }\n\n    const spy = createScrollSpy(router, {\n      selector: spySelector,\n      rootMargin: spyRootMargin,\n      scrollContainer: scrollSpy.scrollContainer,\n    });\n\n    return () => {\n      spy.destroy();\n    };\n    // scrollSpy (for scrollContainer) omitted — same rationale as\n    // scrollRestoration above: getter is invoked lazily inside the utility,\n    // identity changes don't affect resolution.\n    // eslint-disable-next-line @eslint-react/exhaustive-deps\n  }, [router, spyEnabled, spySelector, spyRootMargin]);\n\n  useEffect(() => {\n    if (!viewTransitions) {\n      return;\n    }\n\n    const vt = createViewTransitions(router);\n\n    return () => {\n      vt.destroy();\n    };\n  }, [router, viewTransitions]);\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/src/RouterProvider.tsx

@@ -1,148 +0,0 @@
-import { getNavigator } from "@real-router/core";
-import { createRouteSource } from "@real-router/sources";
-import { useEffect, useMemo, useSyncExternalStore } from "react";
-
-import { NavigatorContext, RouteContext, RouterContext } from "./context";
-import {
-  createRouteAnnouncer,
-  createScrollRestoration,
-  createScrollSpy,
-  createViewTransitions,
-} from "./dom-utils";
-
-import type { ScrollRestorationOptions, ScrollSpyOptions } from "./dom-utils";
-import type { Router } from "@real-router/core";
-import type { FC, ReactNode } from "react";
-
-export interface RouteProviderProps {
-  router: Router;
-  children: ReactNode;
-  announceNavigation?: boolean;
-  scrollRestoration?: ScrollRestorationOptions;
-  scrollSpy?: ScrollSpyOptions;
-  viewTransitions?: boolean;
-}
-
-export const RouterProvider: FC<RouteProviderProps> = ({
-  router,
-  children,
-  announceNavigation,
-  scrollRestoration,
-  scrollSpy,
-  viewTransitions,
-}) => {
-  useEffect(() => {
-    if (!announceNavigation) {
-      return;
-    }
-
-    const announcer = createRouteAnnouncer(router);
-
-    return () => {
-      announcer.destroy();
-    };
-  }, [announceNavigation, router]);
-
-  // Primitive deps so inline `{ mode: "restore" }` doesn't thrash on every
-  // render. scrollContainer is a getter invoked lazily on every event inside
-  // the utility — swapping its reference doesn't change the resolved element,
-  // so we intentionally omit it from deps to keep inline getters stable.
-  const srMode = scrollRestoration?.mode;
-  const srAnchor = scrollRestoration?.anchorScrolling;
-  const srBehavior = scrollRestoration?.behavior;
-  const srStorageKey = scrollRestoration?.storageKey;
-  const srEnabled = scrollRestoration !== undefined;
-
-  useEffect(() => {
-    if (!srEnabled) {
-      return;
-    }
-
-    const sr = createScrollRestoration(router, {
-      mode: srMode,
-      anchorScrolling: srAnchor,
-      behavior: srBehavior,
-      storageKey: srStorageKey,
-      // srEnabled check above guarantees scrollRestoration is defined.
-      scrollContainer: scrollRestoration.scrollContainer,
-    });
-
-    return () => {
-      sr.destroy();
-    };
-    // scrollRestoration (for scrollContainer) omitted — see comment above.
-    // eslint-disable-next-line @eslint-react/exhaustive-deps
-  }, [router, srEnabled, srMode, srAnchor, srBehavior, srStorageKey]);
-
-  const spySelector = scrollSpy?.selector;
-  const spyRootMargin = scrollSpy?.rootMargin;
-  const spyEnabled =
-    scrollSpy !== undefined && spySelector !== undefined && spySelector !== "";
-
-  useEffect(() => {
-    if (!spyEnabled) {
-      return;
-    }
-
-    const spy = createScrollSpy(router, {
-      selector: spySelector,
-      rootMargin: spyRootMargin,
-      scrollContainer: scrollSpy.scrollContainer,
-    });
-
-    return () => {
-      spy.destroy();
-    };
-    // scrollSpy (for scrollContainer) omitted — same rationale as
-    // scrollRestoration above: getter is invoked lazily inside the utility,
-    // identity changes don't affect resolution.
-    // eslint-disable-next-line @eslint-react/exhaustive-deps
-  }, [router, spyEnabled, spySelector, spyRootMargin]);
-
-  useEffect(() => {
-    if (!viewTransitions) {
-      return;
-    }
-
-    const vt = createViewTransitions(router);
-
-    return () => {
-      vt.destroy();
-    };
-  }, [router, viewTransitions]);
-
-  const navigator = useMemo(() => getNavigator(router), [router]);
-
-  // useSyncExternalStore manages the router subscription lifecycle:
-  // 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]);
-  // 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: snapshot.route,
-      previousRoute: snapshot.previousRoute,
-    }),
-    [navigator, snapshot],
-  );
-
-  return (
-    <RouterContext.Provider value={router}>
-      <NavigatorContext.Provider value={navigator}>
-        <RouteContext.Provider value={routeContextValue}>
-          {children}
-        </RouteContext.Provider>
-      </NavigatorContext.Provider>
-    </RouterContext.Provider>
-  );
-};

package/src/components/Await.tsx

@@ -1,46 +0,0 @@
-import { use } from "react";
-
-import { useDeferred } from "../hooks/useDeferred";
-
-import type { ReactNode } from "react";
-
-export interface AwaitProps<T> {
-  /** Deferred key declared in the loader's `defer({ deferred: { <name>: ... } })`. */
-  readonly name: string;
-  /** Render the resolved value. Suspends while pending; throws inside the
-   * nearest Error Boundary on rejection. */
-  readonly children: (value: T) => ReactNode;
-}
-
-/**
- * Ergonomic wrapper around `useDeferred(name)` + React 19's `use(promise)`.
- *
- * ```tsx
- * <Suspense fallback={<Spinner />}>
- *   <Await<Review[]> name="reviews">
- *     {(reviews) => <ReviewList items={reviews} />}
- *   </Await>
- * </Suspense>
- * ```
- *
- * Equivalent to:
- *
- * ```tsx
- * function Inner() {
- *   const reviews = use(useDeferred<Review[]>("reviews"));
- *   return <ReviewList items={reviews} />;
- * }
- * ```
- *
- * Pick `<Await>` for cross-adapter consistency with the SvelteKit
- * `{#await}` / Solid `<Await/>` shape; pick the inline `use(useDeferred(...))`
- * form if you prefer one fewer abstraction.
- */
-export function Await<T = unknown>({
-  name,
-  children,
-}: AwaitProps<T>): ReactNode {
-  const value = use(useDeferred<T>(name));
-
-  return children(value);
-}

package/src/components/ClientOnly.tsx

@@ -1,25 +0,0 @@
-import { useEffect, useState } from "react";
-
-import type { ReactNode } from "react";
-
-export interface ClientOnlyProps {
-  readonly children: ReactNode;
-  readonly fallback?: ReactNode;
-}
-
-export function ClientOnly({
-  children,
-  fallback = null,
-}: ClientOnlyProps): ReactNode {
-  const [mounted, setMounted] = useState(false);
-
-  useEffect(() => {
-    // SSR/hydration boundary: server emits the fallback branch, client matches
-    // it on first paint, then this effect flips state to swap in the children.
-    // The intentional re-render is what makes the markup match across renders.
-    // eslint-disable-next-line @eslint-react/set-state-in-effect -- intentional post-hydration swap
-    setMounted(true);
-  }, []);
-
-  return mounted ? children : fallback;
-}

package/src/components/HttpStatusCode.tsx

@@ -1,66 +0,0 @@
-import { useContext } from "react";
-
-import { HttpStatusContext } from "./HttpStatusProvider";
-
-import type { ReactNode } from "react";
-
-export interface HttpStatusCodeProps {
-  /** HTTP status to apply to the response. Common values: 404, 410, 451, 503. */
-  readonly code: number;
-}
-
-/**
- * Render-time HTTP status declaration. Mount inside a route component (typical
- * use case: a glob `*` route's NotFound page) when the status is decided by
- * the rendered tree rather than a loader.
- *
- * Writes `code` to the nearest `<HttpStatusProvider>`'s sink during render and
- * returns `null`. With no provider mounted (the standard client-side case)
- * the component is a silent no-op — same component tree hydrates without
- * touching the DOM or warning about mismatches.
- *
- * Loader-driven errors (`LoaderNotFound` → 404, `LoaderRedirect` → 30x) keep
- * working as before; this component covers render-time decisions only.
- *
- * Last write wins when several `<HttpStatusCode />` instances mount in the
- * same render pass — sink reflects the last component that ran.
- *
- * ```tsx
- * // entry-server.tsx
- * import { renderToString } from "react-dom/server";
- * import { createHttpStatusSink, HttpStatusProvider } from "@real-router/react/ssr";
- *
- * const sink = createHttpStatusSink();
- * const html = renderToString(
- *   <HttpStatusProvider sink={sink}>
- *     <RouterProvider router={router}>
- *       <App />
- *     </RouterProvider>
- *   </HttpStatusProvider>,
- * );
- * response.status(sink.code ?? 200).send(html);
- * ```
- *
- * **Streaming SSR (`renderToReadableStream`):** the response status MUST be
- * sent before the first body byte flushes. If `<HttpStatusCode />` is mounted
- * inside a late-resolving `<Suspense>` boundary, the sink write may happen
- * AFTER the headers are already on the wire — the override is then lost.
- * Either mount the component in the shell (above every `<Suspense>` that
- * could delay it) or `await stream.allReady` before reading `sink.code`
- * (which forfeits streaming benefits). For non-streaming SSR
- * (`renderToString`) there is no such ordering concern.
- *
- * **Valid `code` range:** Node's `res.end()` throws `Invalid status code` on
- * `NaN`, `0`, negative values, or values `> 999` — this surfaces as a 5xx /
- * dropped connection, not silent corruption. Pass a real HTTP status integer
- * (commonly 4xx/5xx; 100-999 is what Node accepts).
- */
-export function HttpStatusCode({ code }: HttpStatusCodeProps): ReactNode {
-  const sink = useContext(HttpStatusContext);
-
-  if (sink) {
-    sink.code = code;
-  }
-
-  return null;
-}

package/src/components/HttpStatusProvider.tsx

@@ -1,26 +0,0 @@
-import { createContext } from "react";
-
-import type { HttpStatusSink } from "../utils/createHttpStatusSink";
-import type { ReactNode } from "react";
-
-export const HttpStatusContext = createContext<HttpStatusSink | null>(null);
-
-export interface HttpStatusProviderProps {
-  readonly sink: HttpStatusSink;
-  readonly children: ReactNode;
-}
-
-export function HttpStatusProvider({
-  sink,
-  children,
-}: HttpStatusProviderProps): ReactNode {
-  // `<HttpStatusContext.Provider value>` (not the React 19 `<HttpStatusContext value>`
-  // shorthand) — same component file is exported via `/legacy/ssr` for React 18
-  // consumers, where the shorthand throws "Element type is invalid: expected
-  // a string but got: object".
-  return (
-    <HttpStatusContext.Provider value={sink}>
-      {children}
-    </HttpStatusContext.Provider>
-  );
-}