@real-router/preact 0.13.0 → 0.15.0

package/dist/esm/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":["NOOP_INSTANCE","NOOP_INSTANCE"],"sources":["../../src/components/RouteView/components.tsx","../../src/components/RouteView/helpers.tsx","../../src/useSyncExternalStore.ts","../../src/hooks/useNavigator.tsx","../../src/hooks/useRouter.tsx","../../src/hooks/useRouteNode.tsx","../../src/components/RouteView/RouteView.tsx","../../src/constants.ts","../../../../shared/dom-utils/route-announcer.ts","../../../../shared/dom-utils/scroll-restore.ts","../../../../shared/dom-utils/view-transitions.ts","../../../../shared/dom-utils/link-utils.ts","../../src/hooks/useIsActiveRoute.tsx","../../src/components/Link.tsx","../../src/components/RouterErrorBoundary.tsx","../../src/hooks/useRouteUtils.tsx","../../src/hooks/useRouterTransition.tsx","../../src/hooks/useRouteExit.tsx","../../src/hooks/useRouteEnter.tsx","../../src/RouterProvider.tsx"],"sourcesContent":["import type { MatchProps, NotFoundProps, SelfProps } from \"./types\";\n\nexport function Match(_props: MatchProps): null {\n  return null;\n}\n\nMatch.displayName = \"RouteView.Match\";\n\nexport function Self(_props: SelfProps): null {\n  return null;\n}\n\nSelf.displayName = \"RouteView.Self\";\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 { Fragment, isValidElement, toChildArray } from \"preact\";\nimport { Suspense } from \"preact/compat\";\n\nimport { Match, NotFound, Self } from \"./components\";\n\nimport type { MatchProps, NotFoundProps, SelfProps } from \"./types\";\nimport type { VNode, ComponentChildren } from \"preact\";\n\ninterface FallbackSlots {\n  selfChildren: ComponentChildren;\n  selfFallback: ComponentChildren | undefined;\n  selfFound: boolean;\n  notFoundChildren: ComponentChildren;\n}\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: ComponentChildren,\n  result: VNode[],\n): void {\n  for (const child of toChildArray(children)) {\n    if (!isValidElement(child)) {\n      continue;\n    }\n\n    if (\n      child.type === Match ||\n      child.type === Self ||\n      child.type === NotFound\n    ) {\n      result.push(child);\n    } else {\n      collectElements(\n        (child.props as { readonly children: ComponentChildren }).children,\n        result,\n      );\n    }\n  }\n}\n\nfunction renderSlot(\n  slotChildren: ComponentChildren,\n  key: string,\n  fallback?: ComponentChildren,\n): VNode {\n  const content =\n    fallback === undefined ? (\n      slotChildren\n    ) : (\n      <Suspense fallback={fallback}>{slotChildren}</Suspense>\n    );\n\n  return <Fragment key={key}>{content}</Fragment>;\n}\n\nfunction isFallbackKind(child: VNode): boolean {\n  return child.type === NotFound || child.type === Self;\n}\n\nfunction assignFallbackSlot(child: VNode, slots: FallbackSlots): void {\n  if (child.type === NotFound) {\n    slots.notFoundChildren = (child.props as NotFoundProps).children;\n\n    return;\n  }\n\n  if (!slots.selfFound) {\n    slots.selfChildren = (child.props as SelfProps).children;\n    slots.selfFallback = (child.props as SelfProps).fallback;\n    slots.selfFound = true;\n  }\n}\n\nfunction processMatch(\n  child: VNode,\n  routeName: string,\n  nodeName: string,\n  alreadyActive: boolean,\n): VNode | null {\n  const {\n    segment,\n    exact = false,\n    fallback,\n    children,\n  } = child.props as MatchProps;\n  const fullSegmentName = nodeName ? `${nodeName}.${segment}` : segment;\n  const isActive =\n    !alreadyActive && isSegmentMatch(routeName, fullSegmentName, exact);\n\n  if (!isActive) {\n    return null;\n  }\n\n  return renderSlot(children, fullSegmentName, fallback);\n}\n\nfunction appendFallback(\n  rendered: VNode[],\n  routeName: string,\n  nodeName: string,\n  slots: FallbackSlots,\n): void {\n  if (slots.selfFound && routeName === nodeName) {\n    rendered.push(\n      renderSlot(slots.selfChildren, \"__route-view-self__\", slots.selfFallback),\n    );\n\n    return;\n  }\n\n  if (routeName === UNKNOWN_ROUTE && slots.notFoundChildren !== null) {\n    rendered.push(\n      <Fragment key=\"__route-view-not-found__\">\n        {slots.notFoundChildren}\n      </Fragment>,\n    );\n  }\n}\n\nexport function buildRenderList(\n  elements: VNode[],\n  routeName: string,\n  nodeName: string,\n): { rendered: VNode[]; activeMatchFound: boolean } {\n  const slots: FallbackSlots = {\n    selfChildren: null,\n    selfFallback: undefined,\n    selfFound: false,\n    notFoundChildren: null,\n  };\n  let activeMatchFound = false;\n  const rendered: VNode[] = [];\n\n  for (const child of elements) {\n    if (isFallbackKind(child)) {\n      assignFallbackSlot(child, slots);\n\n      continue;\n    }\n\n    const matchRendered = processMatch(\n      child,\n      routeName,\n      nodeName,\n      activeMatchFound,\n    );\n\n    if (matchRendered !== null) {\n      activeMatchFound = true;\n      rendered.push(matchRendered);\n    }\n  }\n\n  if (!activeMatchFound) {\n    appendFallback(rendered, routeName, nodeName, slots);\n  }\n\n  return { rendered, activeMatchFound };\n}\n","import { useEffect, useState } from \"preact/hooks\";\n\n/**\n * Polyfill for React's useSyncExternalStore.\n *\n * Preact does not provide a native useSyncExternalStore.\n * This implementation uses useState + useEffect to subscribe\n * to external stores.\n *\n * Race condition handling: the value may change between\n * `useState(getSnapshot)` (render) and `useEffect` (commit).\n * We synchronize by calling `setValue(getSnapshot())` before\n * subscribing in the effect.\n *\n * The updater uses `Object.is` to bail out when the snapshot\n * is referentially stable, preventing redundant re-renders.\n *\n * SSR semantics: `_getServerSnapshot` is intentionally ignored.\n * Preact's `preact-render-to-string` runs `useState(getSnapshot)`\n * on the server and does not commit effects, so the initial\n * render already uses `getSnapshot()`. Real-Router's `createRouteSource`\n * (and friends) return the same value on server and client given the\n * same `router` instance, so passing `getSnapshot` itself as the third\n * argument at every call site is the symmetric SSR contract; a separate\n * `getServerSnapshot` would diverge during hydration. Consumers that\n * truly need a different server value should branch in `getSnapshot`.\n *\n * Stable-reference contract: `subscribe` and `getSnapshot` are deps of\n * the subscription effect. If a consumer passes inline closures, every\n * render triggers `unsubscribe → subscribe` plus a fresh `sync()` pass\n * — a silent O(N) reconnect that the Preact polyfill cannot bail out\n * of (React's native impl uses an internal sub-store keyed by identity;\n * we cannot replicate that without losing the latest-snapshot guarantee).\n * All Real-Router hooks pass router-keyed cached factories from\n * `@real-router/sources`, which produce stable refs per `(router, args…)`\n * — keep that pattern for every external use.\n */\nexport function useSyncExternalStore<T>(\n  subscribe: (onStoreChange: () => void) => () => void,\n  getSnapshot: () => T,\n  _getServerSnapshot?: () => T,\n): T {\n  const [value, setValue] = useState(getSnapshot);\n\n  useEffect(() => {\n    const sync = (): void => {\n      setValue((prev) => {\n        const next = getSnapshot();\n\n        return Object.is(prev, next) ? prev : next;\n      });\n    };\n\n    sync();\n\n    return subscribe(sync);\n  }, [subscribe, getSnapshot]);\n\n  return value;\n}\n","import { createUseContextOrThrow, NavigatorContext } from \"../context\";\n\nimport type { Navigator } from \"@real-router/core\";\n\nexport const useNavigator: () => Navigator = createUseContextOrThrow(\n  NavigatorContext,\n  \"useNavigator\",\n);\n","import { createUseContextOrThrow, RouterContext } from \"../context\";\n\nimport type { Router } from \"@real-router/core\";\n\nexport const useRouter: () => Router = createUseContextOrThrow(\n  RouterContext,\n  \"useRouter\",\n);\n","import { createRouteNodeSource } from \"@real-router/sources\";\nimport { useMemo } from \"preact/hooks\";\n\nimport { useSyncExternalStore } from \"../useSyncExternalStore\";\nimport { useNavigator } from \"./useNavigator\";\nimport { useRouter } from \"./useRouter\";\n\nimport type { RouteContext } from \"../types\";\n\nexport function useRouteNode(nodeName: string): RouteContext {\n  const router = useRouter();\n  const navigator = useNavigator();\n\n  // `createRouteNodeSource` is the cached factory from `@real-router/sources`\n  // keyed on (router, nodeName) — identical args return identical refs across\n  // renders. No `useMemo` needed.\n  const store = createRouteNodeSource(router, nodeName);\n\n  const { route, previousRoute } = useSyncExternalStore(\n    store.subscribe,\n    store.getSnapshot,\n    store.getSnapshot,\n  );\n\n  // Public stable-ref contract (locked by `useRouteNode.test.tsx` \"should\n  // return stable reference when nothing changes\"): consecutive renders with\n  // identical (navigator, route, previousRoute) return the same RouteContext\n  // ref. Drop this `useMemo` and downstream consumers re-render on every\n  // parent re-render.\n  return useMemo(\n    (): RouteContext => ({ navigator, route, previousRoute }),\n    [navigator, route, previousRoute],\n  );\n}\n","import { useMemo } from \"preact/hooks\";\n\nimport { Match, NotFound, Self } from \"./components\";\nimport { buildRenderList, collectElements } from \"./helpers\";\nimport { useRouteNode } from \"../../hooks/useRouteNode\";\n\nimport type { RouteViewProps } from \"./types\";\nimport type { VNode } from \"preact\";\n\nfunction RouteViewRoot({\n  nodeName,\n  children,\n}: Readonly<RouteViewProps>): VNode | null {\n  const { route } = useRouteNode(nodeName);\n\n  // Cache the flattened Match/Self/NotFound list across renders with unchanged\n  // children. children only differs when the parent re-renders with a new\n  // node, so this memoises the steady-state traversal.\n  const elements = useMemo(() => {\n    const collected: VNode[] = [];\n\n    collectElements(children, collected);\n\n    return collected;\n  }, [children]);\n\n  const routeName = route?.name;\n\n  // buildRenderList is O(N) over Match/Self/NotFound children. Memo on\n  // (elements, routeName, nodeName) skips the re-walk on parent re-renders\n  // that don't change the active route; navigations always invalidate via\n  // routeName.\n  const rendered = useMemo(() => {\n    if (routeName === undefined) {\n      return [];\n    }\n\n    return buildRenderList(elements, routeName, nodeName).rendered;\n  }, [elements, routeName, nodeName]);\n\n  return rendered.length > 0 ? <>{rendered}</> : null;\n}\n\nRouteViewRoot.displayName = \"RouteView\";\n\nexport const RouteView = Object.assign(RouteViewRoot, {\n  Match,\n  Self,\n  NotFound,\n});\n\nexport type {\n  RouteViewProps,\n  MatchProps as RouteViewMatchProps,\n  SelfProps as RouteViewSelfProps,\n  NotFoundProps as RouteViewNotFoundProps,\n} from \"./types\";\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\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\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  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    // Single rAF so DOM is committed before we read anchors / write scroll.\n    // Guard against destroy() racing with the callback.\n    requestAnimationFrame(() => {\n      if (destroyed) {\n        return;\n      }\n\n      if (mode === \"top\" || !nav) {\n        scrollToHashOrTop(route);\n\n        return;\n      }\n\n      if (nav.navigationType === \"replace\") {\n        return;\n      }\n\n      if (\n        nav.direction === \"back\" ||\n        nav.navigationType === \"traverse\" ||\n        nav.navigationType === \"reload\"\n      ) {\n        const key = safeKeyOf(route);\n\n        writePos(key === null ? 0 : (loadStore()[key] ?? 0));\n\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 as Record<string, unknown>).sort(\n      (left: string, right: string) => 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 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 } from \"preact/hooks\";\n\nimport { useSyncExternalStore } from \"../useSyncExternalStore\";\nimport { useRouter } from \"./useRouter\";\n\nimport type { Params } from \"@real-router/core\";\nimport type { ActiveRouteSourceOptions } from \"@real-router/sources\";\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. Caching the opts object + memoising the source\n  // lookup avoids (a) re-allocating the literal on every render and (b)\n  // re-running canonicalJson(params) on the cache lookup path. The `hash`\n  // argument (#532) participates in the cache key — a tab Link pointing to\n  // `/settings#account` shares its source only with consumers using the\n  // same routeName + params + hash. exactOptionalPropertyTypes forbids\n  // `{ hash: undefined }` literally, so we conditionally include the key\n  // only when the caller passed a value.\n  const opts = useMemo<ActiveRouteSourceOptions>(\n    () =>\n      hash === undefined\n        ? { strict, ignoreQueryParams }\n        : { strict, ignoreQueryParams, hash },\n    [strict, ignoreQueryParams, hash],\n  );\n\n  const store = useMemo(\n    () => createActiveRouteSource(router, routeName, params, opts),\n    [router, routeName, params, opts],\n  );\n\n  return useSyncExternalStore(\n    store.subscribe,\n    store.getSnapshot,\n    store.getSnapshot,\n  );\n}\n","import { memo } from \"preact/compat\";\n\nimport { EMPTY_PARAMS, EMPTY_OPTIONS } from \"../constants\";\nimport {\n  shouldNavigate,\n  buildHref,\n  buildActiveClassName,\n  navigateWithHash,\n  shallowEqual,\n} from \"../dom-utils\";\nimport { useIsActiveRoute } from \"../hooks/useIsActiveRoute\";\nimport { useRouter } from \"../hooks/useRouter\";\n\nimport type { LinkProps } from \"../types\";\nimport type { FunctionComponent, TargetedMouseEvent } from \"preact\";\n\n/**\n * Custom comparator for `Link`'s `memo()` wrapper.\n *\n * **Maintenance contract:** every field in `LinkProps` MUST appear in either\n * the `===` chain (primitives + identity-checked references like `onClick` /\n * `children` / `style`) or in the `shallowEqual` arms (object-valued\n * `routeParams` / `routeOptions`). When adding a new prop to `LinkProps`,\n * extend this function in the same PR — `tests/functional/Link.test.tsx`\n * contains a regression-guard that fails the build if `LinkProps` gains a\n * field that is not compared here.\n *\n * **Intentional omissions:** `props` (the rest-spread of HTMLAnchorElement\n * attributes — `aria-label`, `data-*`, `target`-other-than-`_blank`-handling,\n * etc.) is NOT compared. A change to `aria-label` will NOT trigger a Link\n * re-render. This is by design: dynamic `aria-label` is rare; consumers who\n * truly need a reactive aria-label should call `<Link key={ariaLabel}>` to\n * force a remount.\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    prev.hash === next.hash &&\n    shallowEqual(prev.routeParams, next.routeParams) &&\n    shallowEqual(prev.routeOptions, next.routeOptions)\n  );\n}\n\nexport const Link: FunctionComponent<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    hash,\n    onClick,\n    target,\n    children,\n    ...props\n  }) => {\n    const router = useRouter();\n\n    // memo + areLinkPropsEqual guarantees that on bail-out the component does\n    // not render; on render, routeParams/routeOptions changed reference (true\n    // change caught by shallowEqual), so they're safe to use directly in hook\n    // deps without useStableValue.\n\n    // Hash-aware active (#532) — see useIsActiveRoute for the contract.\n    const isActive = useIsActiveRoute(\n      routeName,\n      routeParams,\n      activeStrict,\n      ignoreQueryParams,\n      hash,\n    );\n\n    // `buildHref` is a cheap synchronous call (route-tree lookup + string\n    // concat). Wrapping it in `useMemo` allocates a deps array on every\n    // render that does not bail out — and on bail-out the function body\n    // doesn't execute, so the cache never pays off. Same logic for\n    // `buildActiveClassName` and `handleClick` below.\n    const href = buildHref(\n      router,\n      routeName,\n      routeParams,\n      hash === undefined ? undefined : { hash },\n    );\n\n    const handleClick = (evt: TargetedMouseEvent<HTMLAnchorElement>): void => {\n      if (onClick) {\n        onClick(evt);\n\n        if (evt.defaultPrevented) {\n          return;\n        }\n      }\n\n      if (!shouldNavigate(evt) || target === \"_blank\") {\n        return;\n      }\n\n      evt.preventDefault();\n      navigateWithHash(\n        router,\n        routeName,\n        routeParams,\n        hash,\n        routeOptions,\n      ).catch(() => {});\n    };\n\n    const finalClassName = buildActiveClassName(\n      isActive,\n      activeClassName,\n      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 { createDismissableError } from \"@real-router/sources\";\nimport { Fragment } from \"preact\";\nimport { useEffect, useLayoutEffect, useRef } from \"preact/hooks\";\n\nimport { useRouter } from \"../hooks/useRouter\";\nimport { useSyncExternalStore } from \"../useSyncExternalStore\";\n\nimport type { RouterError, State } from \"@real-router/core\";\nimport type { ComponentChildren, VNode } from \"preact\";\n\nexport interface RouterErrorBoundaryProps {\n  readonly children: ComponentChildren;\n  readonly fallback: (\n    error: RouterError,\n    resetError: () => void,\n  ) => ComponentChildren;\n  readonly onError?: (\n    error: RouterError,\n    toRoute: State | null,\n    fromRoute: State | null,\n  ) => void;\n}\n\n/**\n * Declarative navigation-error boundary.\n *\n * **Not** a Preact `componentDidCatch`-style ErrorBoundary — this component\n * does NOT catch render-time exceptions from `children`. It is a compositional\n * component that subscribes to `createDismissableError` from\n * `@real-router/sources` and renders `fallback(error, resetError)` ALONGSIDE\n * `children` (wrapped in a `<Fragment>`) when the router emits a navigation\n * error (guard rejection, ROUTE_NOT_FOUND, etc.). The boundary auto-resets on\n * the next successful navigation; `resetError()` lets the consumer dismiss\n * the fallback imperatively.\n *\n * For real exception boundaries, wrap children in a Preact ErrorBoundary\n * (e.g. `preact-iso/ErrorBoundary` or a custom `componentDidCatch` class) —\n * the two can coexist.\n */\nexport function RouterErrorBoundary({\n  children,\n  fallback,\n  onError,\n}: RouterErrorBoundaryProps): VNode {\n  const router = useRouter();\n\n  // `createDismissableError` is the cached factory from `@real-router/sources`\n  // — keyed per-router, identity stable across renders. `useMemo` would wrap\n  // a call that already memoizes downstream.\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  useLayoutEffect(() => {\n    onErrorRef.current = onError;\n  });\n\n  // snapshot.version is the @real-router/sources dismissable-error invariant:\n  // it is the only field that monotonically advances on each new error episode\n  // (snapshot.error/toRoute/fromRoute are correlated reads within the same\n  // version frame), so depending on it covers all error fields by construction.\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    <Fragment>\n      {children}\n      {snapshot.error ? fallback(snapshot.error, snapshot.resetError) : null}\n    </Fragment>\n  );\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\nexport const useRouteUtils = (): RouteUtils => {\n  const router = useRouter();\n\n  return getRouteUtils(getPluginApi(router).getTree());\n};\n","import { getTransitionSource } from \"@real-router/sources\";\n\nimport { useSyncExternalStore } from \"../useSyncExternalStore\";\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 { useEffect, useLayoutEffect, useRef } from \"preact/hooks\";\n\nimport { useRouter } from \"./useRouter\";\n\nimport type { State } from \"@real-router/core\";\n\nexport interface RouteExitContext {\n  /** The route being left. */\n  route: State;\n  /** The route being navigated to. */\n  nextRoute: State;\n  /**\n   * AbortSignal that fires when this navigation is superseded by a later\n   * one (rapid clicks). Already filtered: when the handler runs,\n   * `signal.aborted` is guaranteed to be `false`. Use\n   * `signal.addEventListener(\"abort\", cleanup, { once: true })` for\n   * cleanup that must run on cancellation.\n   */\n  signal: AbortSignal;\n}\n\nexport interface UseRouteExitOptions {\n  /**\n   * Skip the handler when `route.name === nextRoute.name`\n   * (sort/filter/query-only navigations on the same route). Default:\n   * `true`.\n   */\n  skipSameRoute?: boolean;\n}\n\nexport type RouteExitHandler = (\n  context: RouteExitContext,\n) => void | Promise<void>;\n\n/**\n * Subscribe to the router's leave-window with the universal guards baked\n * in. Wraps `router.subscribeLeave` so consumers don't repeat the same\n * boilerplate every time:\n *\n *   - **Reentrant abort pre-check**: if `signal.aborted` is already `true`\n *     when the handler would run (rapid navigation superseded a slower\n *     one), the handler is skipped entirely. `signal.addEventListener(\n *     \"abort\", ...)` does not fire retroactively, so without this guard\n *     downstream cleanup would never trigger.\n *   - **Same-route skip**: by default, `route.name === nextRoute.name`\n *     short-circuits the handler — query-only navigations (sort, filter,\n *     pagination) skip the work. Opt out with `skipSameRoute: false`.\n *   - **Stable handler reference**: the handler can change identity on\n *     every render without causing resubscription — internal ref keeps\n *     the latest handler accessible to the long-lived subscription.\n *\n * Returns nothing — the subscription's lifecycle is bound to the\n * component's mount.\n *\n * If the handler returns a Promise, the router blocks on it. If the\n * Promise resolves, navigation proceeds. If it rejects, the router emits\n * `TRANSITION_CANCELLED` (existing core behavior, no change here).\n *\n * @example Animation\n * ```tsx\n * const ref = useRef<HTMLDivElement>(null);\n *\n * useRouteExit(async ({ signal }) => {\n *   const el = ref.current;\n *   if (!el) return;\n *   el.classList.add(\"fade-out\");\n *   const cleanup = () => el.classList.remove(\"fade-out\");\n *   signal.addEventListener(\"abort\", cleanup, { once: true });\n *   try {\n *     el.getBoundingClientRect();   // style flush\n *     await Promise.allSettled(el.getAnimations().map((a) => a.finished));\n *   } finally {\n *     cleanup();\n *   }\n * });\n * ```\n *\n * @example Auto-save form draft\n * ```tsx\n * useRouteExit(async ({ signal }) => {\n *   if (formState.dirty) await api.saveDraft(formState, { signal });\n * });\n * ```\n *\n * @example Cancel inflight requests\n * ```tsx\n * useRouteExit(() => {\n *   inflightController.abort();\n * });\n * ```\n *\n * @example Library-coordinated exit (motion / framer-motion)\n * ```tsx\n * const exitResolverRef = useRef<(() => void) | null>(null);\n *\n * useRouteExit(({ signal }) => {\n *   return new Promise<void>((resolve) => {\n *     exitResolverRef.current = resolve;\n *     signal.addEventListener(\"abort\", () => resolve(), { once: true });\n *   });\n * });\n *\n * const onExitComplete = () => exitResolverRef.current?.();\n * // pass onExitComplete to <AnimatePresence>\n * ```\n *\n * @example Reading rich transition metadata via `nextRoute.transition`\n * ```tsx\n * useRouteExit(({ route, nextRoute }) => {\n *   // nextRoute.transition: TransitionMeta — preview of the upcoming nav\n *   if (nextRoute.transition.segments.deactivated.includes(\"products\")) {\n *     // leaving the products subtree entirely — flush product-related caches\n *     productCache.clear();\n *   }\n *   if (nextRoute.transition.redirected) {\n *     // skip animation when navigation arrived via redirect\n *     return;\n *   }\n * });\n * ```\n */\nexport function useRouteExit(\n  handler: RouteExitHandler,\n  options?: UseRouteExitOptions,\n): void {\n  const router = useRouter();\n  const handlerRef = useRef(handler);\n  const skipSameRoute = options?.skipSameRoute ?? true;\n\n  // Keep the latest handler accessible to the subscription without\n  // resubscribing on every render — the subscription registers the\n  // wrapper once and dispatches to whatever ref points to.\n  // useLayoutEffect (synchronous, post-render, pre-paint) updates the\n  // ref before the browser can dispatch any router events that could\n  // observe a stale closure.\n  useLayoutEffect(() => {\n    handlerRef.current = handler;\n  });\n\n  useEffect(() => {\n    return router.subscribeLeave(({ route, nextRoute, signal }) => {\n      if (skipSameRoute && route.name === nextRoute.name) {\n        return;\n      }\n\n      // Reentrant abort: signal is already aborted when listener fires\n      // (e.g. a newer navigate superseded this one before subscribeLeave\n      // even ran). addEventListener(\"abort\", ...) does not fire\n      // retroactively, so we skip the handler entirely — any cleanup the\n      // handler would have wired via abort listener must not run because\n      // the corresponding `add` work never happened.\n      if (signal.aborted) {\n        return;\n      }\n\n      return handlerRef.current({ route, nextRoute, signal });\n    });\n  }, [router, skipSameRoute]);\n}\n","import { useEffect, useLayoutEffect, useRef } from \"preact/hooks\";\n\nimport { useRoute } from \"./useRoute\";\n\nimport type { State } from \"@real-router/core\";\n\nexport interface RouteEnterContext {\n  /** The route that was just activated. */\n  route: State;\n  /** The route that was active immediately before this navigation. */\n  previousRoute: State;\n}\n\nexport type RouteEnterHandler = (context: RouteEnterContext) => void;\n\nexport interface UseRouteEnterOptions {\n  /**\n   * Skip the handler when `route.name === previousRoute.name`\n   * (sort/filter/query-only navigations on the same route). Default:\n   * `true`. Symmetric with `useRouteExit`'s same-name option.\n   */\n  skipSameRoute?: boolean;\n}\n\n/**\n * Fire `handler` once when the component mounts as a result of a\n * navigation. Mirror of `useRouteExit` for the entry side.\n *\n * What this hook covers that ad-hoc `useEffect` + `useRoute()` doesn't:\n *\n *   - **Skip-initial**: handler is skipped when there is no\n *     `previousRoute` (i.e. first-load mount). Most consumers want to\n *     fire side effects only on real navigations, not on hydration.\n *   - **Same-route skip** (default): handler is skipped when\n *     `route.name === previousRoute.name`. Sort/filter/query-only\n *     navigations re-run the effect (because `route` reference changes\n *     in `useRoute`'s snapshot), but they are not \"entries\" in the\n *     animation / analytics sense — the component instance has stayed\n *     mounted throughout. Opt out with `skipSameRoute: false` when\n *     the handler legitimately needs to fire on every navigation\n *     (e.g. analytics tracking each query-param flip).\n *   - **Latest-handler ref**: the handler can change identity on every\n *     render without re-running the effect — the registered wrapper\n *     dispatches to whatever `handlerRef.current` points to.\n *   - **Mount-time `route` / `previousRoute` snapshot**: the handler\n *     receives the values that were live at the moment of mount, not\n *     the latest ones (which may have moved on if the user navigated\n *     again before the effect drained).\n *\n * Race-safety: `useRoute()` is wired through `useSyncExternalStore` from\n * `@real-router/sources` (Preact polyfill: useState + useEffect, same\n * post-commit semantics), so by the time the new component's effect\n * runs, the snapshot is the post-commit one. This is the reason we can\n * read mount-time context from `useRoute()` instead of subscribing to\n * `router.subscribe` directly (which fires before Preact schedules a\n * re-render — the well-known race in distributed components).\n *\n * Note: Preact does not expose a `StrictMode` equivalent, so the\n * `lastHandledRouteRef` guard exists primarily for defensive symmetry\n * with the React implementation. It is harmless in Preact.\n *\n * @example Direction-aware entry animation\n * ```tsx\n * useRouteEnter(({ route }) => {\n *   const direction = route.context.browser?.direction;\n *   ref.current?.classList.add(\n *     direction === \"back\" ? \"slide-from-left\" : \"slide-from-right\",\n *   );\n * });\n * ```\n *\n * @example Source-aware focus management\n * ```tsx\n * useRouteEnter(({ route }) => {\n *   if (route.context.browser?.source === \"navigate\") {\n *     headingRef.current?.focus();\n *   }\n * });\n * ```\n *\n * @example Analytics page-enter event (skip-initial built-in)\n * ```tsx\n * useRouteEnter(({ route, previousRoute }) => {\n *   analytics.track(\"page_enter\", {\n *     route: route.name,\n *     from: previousRoute.name,\n *   });\n * });\n * ```\n *\n * @example Reading rich transition metadata via `route.transition`\n * ```tsx\n * useRouteEnter(({ route }) => {\n *   // route.transition: TransitionMeta — populated by core for every state\n *   if (route.transition.redirected) {\n *     showToast(`Redirected from ${route.transition.from}`);\n *   }\n *   if (route.transition.segments.activated.includes(\"products\")) {\n *     // products subtree just became active (could be products or\n *     // products.detail). Useful for subtree-scoped side effects.\n *   }\n * });\n * ```\n */\nexport function useRouteEnter(\n  handler: RouteEnterHandler,\n  options?: UseRouteEnterOptions,\n): void {\n  const { route, previousRoute } = useRoute();\n  const handlerRef = useRef(handler);\n  const lastHandledRouteRef = useRef<State | null>(null);\n  const skipSameRoute = options?.skipSameRoute ?? true;\n\n  // Keep the latest handler reference accessible without re-running\n  // the effect. useLayoutEffect (synchronous, post-render, pre-paint)\n  // updates the ref before the effect can read it.\n  useLayoutEffect(() => {\n    handlerRef.current = handler;\n  });\n\n  useEffect(() => {\n    // Early-exit guards, top-down:\n    //\n    //   - **Skip-initial**: `state.transition.from` is undefined only\n    //     for the very first state committed by `router.start()`.\n    //   - **Skip-same-route**: query-only navigations have\n    //     `transition.from === route.name`. Opt-out via\n    //     `skipSameRoute: false`.\n    //   - **Defensive dedupe**: same `route` ref between effect\n    //     cleanup + re-run. Preact has no StrictMode, but we keep the\n    //     guard for parity with React; v8-ignored.\n    if (!route.transition.from) {\n      return;\n    }\n    if (skipSameRoute && route.transition.from === route.name) {\n      return;\n    }\n    /* v8 ignore start */\n    if (lastHandledRouteRef.current === route || !previousRoute) {\n      return;\n    }\n    /* v8 ignore stop */\n\n    lastHandledRouteRef.current = route;\n    handlerRef.current({ route, previousRoute });\n  }, [route, previousRoute, skipSameRoute]);\n}\n","import { getNavigator } from \"@real-router/core\";\nimport { createRouteSource } from \"@real-router/sources\";\nimport { useEffect, useMemo } from \"preact/hooks\";\n\nimport { NavigatorContext, RouteContext, RouterContext } from \"./context\";\nimport {\n  createRouteAnnouncer,\n  createScrollRestoration,\n  createViewTransitions,\n} from \"./dom-utils\";\nimport { useSyncExternalStore } from \"./useSyncExternalStore\";\n\nimport type { ScrollRestorationOptions } from \"./dom-utils\";\nimport type { Router } from \"@real-router/core\";\nimport type { FunctionComponent, ComponentChildren } from \"preact\";\n\nexport interface RouteProviderProps {\n  router: Router;\n  children: ComponentChildren;\n  announceNavigation?: boolean;\n  scrollRestoration?: ScrollRestorationOptions;\n  viewTransitions?: boolean;\n}\n\nexport const RouterProvider: FunctionComponent<RouteProviderProps> = ({\n  router,\n  children,\n  announceNavigation,\n  scrollRestoration,\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  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  // `getNavigator` is cached per-router in `@real-router/core` (WeakMap) —\n  // same router always returns the same Navigator ref. No `useMemo` needed.\n  const navigator = getNavigator(router);\n\n  // `createRouteSource` is NOT cached (per packages/sources/CLAUDE.md table).\n  // It must be stable across renders so `useSyncExternalStore`'s deps don't\n  // change identity and trigger an unsubscribe/resubscribe loop on every\n  // render. `useMemo([router])` gives one source per router-instance lifetime.\n  const store = useMemo(() => createRouteSource(router), [router]);\n\n  // useSyncExternalStore manages the router subscription lifecycle:\n  // subscribe connects to router on first listener, unsubscribes on last.\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  // Stable-ref against parent re-renders: when parent re-renders RouterProvider\n  // without a route change (e.g. consumer re-renders the root), navigator /\n  // route / previousRoute references stay identical (useSyncExternalStore +\n  // Object.is bail-out). Without `useMemo` the object literal is fresh every\n  // render, propagating spurious re-renders to every `useRoute()` consumer.\n  // The memo bails out whenever the three deps are referentially equal.\n  const routeContextValue = useMemo(\n    () => ({ navigator, route, previousRoute }),\n    [navigator, route, previousRoute],\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":"gtBAEA,SAAgB,EAAM,EAA0B,CAC9C,OAAO,KAGT,EAAM,YAAc,kBAEpB,SAAgB,EAAK,EAAyB,CAC5C,OAAO,KAGT,EAAK,YAAc,iBAEnB,SAAgB,EAAS,EAA6B,CACpD,OAAO,KAGT,EAAS,YAAc,qBCDvB,SAAS,EACP,EACA,EACA,EACS,CAST,OARI,IAAoB,GACf,GAGL,EACK,IAAc,EAGhB,EAAkB,EAAW,EAAgB,CAGtD,SAAgB,EACd,EACA,EACM,CACN,IAAK,IAAM,KAAS,EAAa,EAAS,CACnC,EAAe,EAAM,GAKxB,EAAM,OAAS,GACf,EAAM,OAAS,GACf,EAAM,OAAS,EAEf,EAAO,KAAK,EAAM,CAElB,EACG,EAAM,MAAmD,SAC1D,EACD,EAKP,SAAS,EACP,EACA,EACA,EACO,CAQP,OAAO,EAAC,EAAD,CAAA,SANL,IAAa,IAAA,GACX,EAEA,EAAC,EAAD,CAAoB,oBAAW,EAAwB,CAAA,CAGZ,CAAzB,EAAyB,CAGjD,SAAS,EAAe,EAAuB,CAC7C,OAAO,EAAM,OAAS,GAAY,EAAM,OAAS,EAGnD,SAAS,EAAmB,EAAc,EAA4B,CACpE,GAAI,EAAM,OAAS,EAAU,CAC3B,EAAM,iBAAoB,EAAM,MAAwB,SAExD,OAGF,AAGE,EAAM,aAFN,EAAM,aAAgB,EAAM,MAAoB,SAChD,EAAM,aAAgB,EAAM,MAAoB,SAC9B,IAItB,SAAS,GACP,EACA,EACA,EACA,EACc,CACd,GAAM,CACJ,UACA,QAAQ,GACR,WACA,YACE,EAAM,MACJ,EAAkB,EAAW,GAAG,EAAS,GAAG,IAAY,EAQ9D,MANE,CAAC,GAAiB,EAAe,EAAW,EAAiB,EAAM,CAM9D,EAAW,EAAU,EAAiB,EAAS,CAH7C,KAMX,SAAS,GACP,EACA,EACA,EACA,EACM,CACN,GAAI,EAAM,WAAa,IAAc,EAAU,CAC7C,EAAS,KACP,EAAW,EAAM,aAAc,sBAAuB,EAAM,aAAa,CAC1E,CAED,OAGE,IAAc,GAAiB,EAAM,mBAAqB,MAC5D,EAAS,KACP,EAAC,EAAD,CAAA,SACG,EAAM,iBACE,CAFG,2BAEH,CACZ,CAIL,SAAgB,GACd,EACA,EACA,EACkD,CAClD,IAAM,EAAuB,CAC3B,aAAc,KACd,aAAc,IAAA,GACd,UAAW,GACX,iBAAkB,KACnB,CACG,EAAmB,GACjB,EAAoB,EAAE,CAE5B,IAAK,IAAM,KAAS,EAAU,CAC5B,GAAI,EAAe,EAAM,CAAE,CACzB,EAAmB,EAAO,EAAM,CAEhC,SAGF,IAAM,EAAgB,GACpB,EACA,EACA,EACA,EACD,CAEG,IAAkB,OACpB,EAAmB,GACnB,EAAS,KAAK,EAAc,EAQhC,OAJK,GACH,GAAe,EAAU,EAAW,EAAU,EAAM,CAG/C,CAAE,WAAU,mBAAkB,CCzIvC,SAAgB,EACd,EACA,EACA,EACG,CACH,GAAM,CAAC,EAAO,GAAY,EAAS,EAAY,CAgB/C,OAdA,MAAgB,CACd,IAAM,MAAmB,CACvB,EAAU,GAAS,CACjB,IAAM,EAAO,GAAa,CAE1B,OAAO,OAAO,GAAG,EAAM,EAAK,CAAG,EAAO,GACtC,EAKJ,OAFA,GAAM,CAEC,EAAU,EAAK,EACrB,CAAC,EAAW,EAAY,CAAC,CAErB,ECtDT,MAAa,EAAgC,EAC3C,EACA,eACD,CCHY,EAA0B,EACrC,EACA,YACD,CCED,SAAgB,EAAa,EAAgC,CAC3D,IAAM,EAAS,GAAW,CACpB,EAAY,GAAc,CAK1B,EAAQ,GAAsB,EAAQ,EAAS,CAE/C,CAAE,QAAO,iBAAkB,EAC/B,EAAM,UACN,EAAM,YACN,EAAM,YACP,CAOD,OAAO,OACgB,CAAE,YAAW,QAAO,gBAAe,EACxD,CAAC,EAAW,EAAO,EAAc,CAClC,CCvBH,SAAS,EAAc,CACrB,WACA,YACyC,CACzC,GAAM,CAAE,SAAU,EAAa,EAAS,CAKlC,EAAW,MAAc,CAC7B,IAAM,EAAqB,EAAE,CAI7B,OAFA,EAAgB,EAAU,EAAU,CAE7B,GACN,CAAC,EAAS,CAAC,CAER,EAAY,GAAO,KAMnB,EAAW,MACX,IAAc,IAAA,GACT,EAAE,CAGJ,GAAgB,EAAU,EAAW,EAAS,CAAC,SACrD,CAAC,EAAU,EAAW,EAAS,CAAC,CAEnC,OAAO,EAAS,OAAS,EAAI,EAAA,EAAA,CAAA,SAAG,EAAY,CAAA,CAAG,KAGjD,EAAc,YAAc,YAE5B,MAAa,EAAY,OAAO,OAAO,EAAe,CACpD,QACA,OACA,WACD,CAAC,CC9CW,EAAe,OAAO,OAAO,EAAE,CAAC,CAKhC,EAAgB,OAAO,OAAO,EAAE,CAAC,CCJxC,EAAiB,6BAUjBA,EAAyC,OAAO,OAAO,CAC3D,YAAe,GAGhB,CAAC,CAEF,SAAgB,EACd,EACA,EACyB,CAUzB,GAAI,OAAO,SAAa,IACtB,OAAOA,EAGT,IAAM,EAAS,GAAS,QAAU,gBAC5B,EAAgB,GAAS,oBAE3B,EAAsB,GACtB,EAAU,GACV,EAAc,GACd,EAAoB,GACpB,EAA6B,KAC7B,EAEE,EAAY,GAAsB,CAElC,GAAc,EAAc,IAAiC,CACjE,EAAoB,EACpB,aAAa,EAAe,CAC5B,EAAU,YAAc,EACxB,EAAiB,eAAiB,CAChC,EAAU,YAAc,GACxB,EAAoB,IACnB,IAAY,CAEf,EAAY,EAAG,EAOX,EAAkB,eAAiB,CAGvC,GAFA,EAAU,GAEN,IAAgB,MAAQ,CAAC,EAAa,CACxC,IAAM,EAAO,EAEb,EAAc,KACd,EAAW,EAAM,SAAS,cAA2B,KAAK,CAAC,GAE5D,IAAmB,CAEhB,EAAc,EAAO,WAAW,CAAE,WAAY,CAClD,GAAI,EAAqB,CACvB,EAAsB,GAEtB,OAQF,0BAA4B,CAC1B,0BAA4B,CAC1B,GAAI,EACF,OAGF,IAAM,EAAK,SAAS,cAA2B,KAAK,CAC9C,EAAO,EAAY,EAAO,EAAQ,EAAe,EAAG,CAEtD,MAAC,GAAQ,IAAS,GAItB,IAAI,CAAC,EAAS,CAEZ,EAAc,EAEd,OAGF,EAAW,EAAM,EAAG,GACpB,EACF,EACF,CAEF,MAAO,CACL,SAAU,CACR,EAAc,GACd,GAAa,CACb,aAAa,EAAe,CAC5B,aAAa,EAAgB,CAC7B,GAAiB,EAEpB,CAGH,SAAS,GAAoC,CAC3C,IAAM,EAAW,SAAS,cAA2B,IAAI,EAAe,GAAG,CAE3E,GAAI,EACF,OAAO,EAGT,IAAM,EAAU,SAAS,cAAc,MAAM,CAuB7C,OArBA,EAAQ,aAAa,QAAS,mJAAgB,CAC9C,EAAQ,aAAa,YAAa,YAAY,CAC9C,EAAQ,aAAa,cAAe,OAAO,CAC3C,EAAQ,aAAa,EAAgB,GAAG,EActC,SAAS,MAA+B,SAAS,iBAAiB,QAClE,EACD,CAEM,EAGT,SAAS,GAAwB,CAC/B,SAAS,cAAc,IAAI,EAAe,GAAG,EAAE,QAAQ,CAGzD,SAAS,EACP,EACA,EACA,EACA,EACQ,CACR,GAAI,EACF,GAAI,CACF,IAAM,EAAa,EAAc,EAAM,CAWvC,GAAI,EACF,OAAO,QAEF,EAAO,CAId,QAAQ,MACN,+EACA,EACD,CAIL,IAAM,GAAU,GAAI,aAAe,IAAI,MAAM,CACvC,EAAY,EAAM,KAAK,WAAW,KAAsB,CAC1D,GACA,EAAM,KAIV,MAAO,GAAG,IAFR,GAAU,SAAS,OAAS,GAAa,WAAW,SAAS,WAKjE,SAAS,EAAY,EAA8B,CAC5C,IAIA,EAAG,aAAa,WAAW,EAC9B,EAAG,aAAa,WAAY,KAAK,CAGnC,EAAG,MAAM,CAAE,cAAe,GAAM,CAAC,ECnNnC,MAEMC,EAAyC,OAAO,OAAO,CAC3D,YAAe,GAGhB,CAAC,CAoCF,SAAgB,GACd,EACA,EACyB,CACzB,GAAW,WAAW,SAAW,OAC/B,OAAOA,EAGT,IAAM,EAAO,GAAS,MAAQ,UAQ9B,GAAI,IAAS,SACX,OAAOA,EAGT,IAAM,EAAgB,GAAS,iBAAmB,GAC5C,EAAe,GAAS,gBACxB,EAA2B,GAAS,UAAY,OAChD,EAAa,GAAS,YAAc,qBAKtC,EAEE,MAA0C,CAC9C,GAAI,IAAU,IAAA,GACZ,OAAO,EAGT,GAAI,CACF,IAAM,EAAM,eAAe,QAAQ,EAAW,CAE9C,EAAQ,EAAO,KAAK,MAAM,EAAI,CAA8B,EAAE,MACxD,CACN,EAAQ,EAAE,CAGZ,OAAO,GAGH,GAAU,EAAa,IAAsB,CACjD,GAAI,CACF,IAAM,EAAS,GAAW,CAO1B,GAAI,EAAO,KAAS,EAClB,OAGF,EAAO,GAAO,EACd,eAAe,QAAQ,EAAY,KAAK,UAAU,EAAO,CAAC,MACpD,IAKJ,EAAwB,QAAQ,kBAEtC,GAAI,CACF,QAAQ,kBAAoB,cACtB,EAOR,IAAM,MAAwB,CAC5B,IAAM,EAAU,KAAgB,CAEhC,OAAO,EAAU,EAAQ,UAAY,WAAW,SAG5C,EAAY,GAAsB,CACtC,IAAM,EAAU,KAAgB,CAE5B,EACF,EAAQ,SAAS,CAAE,MAAK,KAAM,EAAG,WAAU,CAAC,CAE5C,WAAW,SAAS,CAAE,MAAK,KAAM,EAAG,WAAU,CAAC,EAI7C,EAAqB,GAAuB,CAKhD,IAAM,EAAW,EAAM,SACnB,KAAK,KAET,GAAI,IAAY,IAAA,GAAW,CACzB,GAAI,GAAiB,EAAQ,OAAS,EAAG,CAEvC,IAAM,EAAU,SAAS,eAAe,EAAQ,CAEhD,GAAI,EAAS,CACX,EAAQ,eAAe,CAAE,WAAU,CAAC,CAEpC,QAIJ,EAAS,EAAE,CAEX,OAOF,IAAM,EAAO,WAAW,SAAS,KAEjC,GAAI,GAAiB,EAAK,OAAS,EAAG,CACpC,IAAI,EAEJ,GAAI,CACF,EAAK,mBAAmB,EAAK,MAAM,EAAE,CAAC,MAChC,CACN,EAAK,EAAK,MAAM,EAAE,CAIpB,IAAM,EAAU,SAAS,eAAe,EAAG,CAE3C,GAAI,EAAS,CACX,EAAQ,eAAe,CAAE,WAAU,CAAC,CAEpC,QAIJ,EAAS,EAAE,EAGT,EAAY,GACZ,EAAuB,GAUrB,EAAa,GAAgC,CACjD,GAAI,CACF,OAAO,GAAM,EAAM,MACb,CAQN,OAPK,IACH,EAAuB,GACvB,QAAQ,MACN,wCAAwC,EAAM,KAAK,+IACpD,EAGI,OAIL,EAAc,EAAO,WAAW,CAAE,QAAO,mBAAoB,CACjE,IAAM,EAAO,EAAM,QAChB,WAKH,GAAI,EAAe,CACjB,IAAM,EAAU,EAAU,EAAc,CAEpC,IAAY,MACd,EAAO,EAAS,GAAS,CAAC,CAM9B,0BAA4B,CACtB,MAIJ,IAAI,IAAS,OAAS,CAAC,EAAK,CAC1B,EAAkB,EAAM,CAExB,OAGE,KAAI,iBAAmB,UAI3B,IACE,EAAI,YAAc,QAClB,EAAI,iBAAmB,YACvB,EAAI,iBAAmB,SACvB,CACA,IAAM,EAAM,EAAU,EAAM,CAE5B,EAAS,IAAQ,KAAO,EAAK,GAAW,CAAC,IAAQ,EAAG,CAEpD,OAGF,EAAkB,EAAM,IACxB,EACF,CAEI,MAAyB,CAC7B,IAAM,EAAU,EAAO,UAAU,CAEjC,GAAI,EAAS,CACX,IAAM,EAAM,EAAU,EAAQ,CAE1B,IAAQ,MACV,EAAO,EAAK,GAAS,CAAC,GAO5B,OAFA,WAAW,iBAAiB,WAAY,EAAW,CAE5C,CACL,YAAe,CACT,MAMJ,CAFA,EAAY,GACZ,GAAa,CACb,WAAW,oBAAoB,WAAY,EAAW,CAEtD,GAAI,CACF,QAAQ,kBAAoB,OACtB,KAIX,CA0BH,MAAM,EAAY,IAAI,QAEtB,SAAgB,GAAM,EAAsB,CAC1C,IAAM,EAAS,EAAU,IAAI,EAAM,CAEnC,GAAI,IAAW,IAAA,GACb,OAAO,EAGT,IAAM,EAAM,GAAG,EAAM,KAAK,GAAG,GAAc,EAAM,OAAO,GAIxD,OAFA,EAAU,IAAI,EAAO,EAAI,CAElB,EAsCT,SAAgB,GAAc,EAAwB,CACpD,OAAO,KAAK,UAAU,EAAO,GAAkB,CAGjD,SAAS,GAAkB,EAAc,EAAuB,CAW9D,GAAI,OAAO,GAAQ,WACjB,MAAO,OAET,GAAI,OAAO,GAAQ,SACjB,MAAO,QAGT,GAAoB,OAAO,GAAQ,UAA/B,GAA2C,CAAC,MAAM,QAAQ,EAAI,CAAE,CAQlE,IAAM,EAAS,OAAO,OAAO,KAAK,CAE5B,EAAO,OAAO,KAAK,EAA+B,CAAC,MACtD,EAAc,IAAkB,EAAK,cAAc,EAAM,CAC3D,CAED,IAAK,IAAM,KAAO,EAChB,EAAO,GAAQ,EAAgC,GAGjD,OAAO,EAGT,OAAO,ECxZT,MAAM,GAAiC,OAAO,OAAO,CACnD,YAAe,GAGhB,CAAC,CAEF,SAAgB,GAAsB,EAAiC,CACrE,GACE,OAAO,SAAa,KACpB,OAAO,SAAS,qBAAwB,WAExC,OAAO,GAGT,IAAI,EAA+B,KAC/B,EAAoD,KAKpD,EAAe,GAEb,MAA8B,CAClC,KAAW,CACX,EAAU,MAGN,EAAW,EAAO,gBAAgB,CAAE,YAAa,CAKjD,MAAO,QAWX,MAPA,GAAe,GACf,GAAiB,CAMV,IAAI,QAAe,GAAiB,CAOzC,IAAM,EAAW,IAAI,QAAe,GAAY,CAC9C,EAAU,GACV,CAEF,EAAO,iBACL,YACM,CACA,IAYJ,GAAiB,CACjB,GAAW,kBAAkB,CAC7B,GAAc,GAEhB,CAAE,KAAM,GAAM,CACf,CAED,GAAI,CACF,EAAY,SAAS,yBAOnB,GAAc,CAEP,GACP,MACI,CAIN,GAAiB,CACjB,GAAc,GAEhB,EACF,CAEI,EAAa,EAAO,cAAgB,CACxC,IAAM,EAAW,EAEjB,EAAe,GACf,EAAU,KAEN,IAAa,KACf,EAAY,KAcZ,eAAiB,CACf,GAAU,CACV,EAAY,MACX,EAAE,EAEP,CAEF,MAAO,CACL,YAAe,CACb,GAAU,CACV,GAAY,CACZ,GAAW,kBAAkB,CAC7B,EAAY,KACZ,GAAiB,EAEpB,CCrIH,SAAgB,GAAe,EAA0B,CACvD,OACE,EAAI,SAAW,GACf,CAAC,EAAI,SACL,CAAC,EAAI,QACL,CAAC,EAAI,SACL,CAAC,EAAI,SAOT,MAAM,GAAuB,iBAmB7B,SAAS,GAAqB,EAAyB,CACrD,GAAI,GAAqB,KAAK,EAAQ,CACpC,GAAI,CAGF,OAAO,UAFW,mBAAmB,EAEX,CAAC,CAAC,WAAW,IAAK,MAAM,MAC5C,EAOV,OAAO,UAAU,EAAQ,CAAC,WAAW,IAAK,MAAM,CAsBlD,SAAgB,GACd,EACA,EACA,EACA,EACoB,CACpB,GAAI,CACF,IAAM,EAAU,GAAS,KACrB,EAEA,IAAY,IAAA,KACd,EAAW,EAAQ,WAAW,IAAI,CAAG,EAAQ,MAAM,EAAE,CAAG,GAG1D,IAAM,EAAW,EAAO,SAExB,GAAI,EAAU,CACZ,IAAM,EAAM,EACV,EACA,EACA,IAAa,IAAA,GAAY,IAAA,GAAY,CAAE,KAAM,EAAU,CACxD,CASD,GAAI,OAAO,GAAQ,UAAY,EAAI,OAAS,EAC1C,OAAO,EAIX,IAAM,EAAO,EAAO,UAAU,EAAW,EAAY,CAQrD,GAAI,OAAO,GAAS,UAAY,EAAK,SAAW,EAAG,CACjD,QAAQ,MACN,wBAAwB,EAAU,6EACnC,CAED,OAGF,OAAO,EAAW,GAAG,EAAK,GAAG,GAAqB,EAAS,GAAK,OAC1D,CACN,QAAQ,MACN,wBAAwB,EAAU,sEACnC,CAED,QA8BJ,SAAgB,GACd,EACA,EACA,EACA,EACA,EACgB,CAChB,IAAM,EAAmC,CAAE,GAAG,EAAc,CAExD,IAAS,IAAA,KACX,EAAK,KAAO,GAGd,IAAM,EAAU,EAAO,UAAU,CAEjC,GACE,GAAS,OAAS,GAClB,EAAa,EAAQ,OAAQ,EAAY,CACzC,CACA,IAAM,EACH,EAAQ,SAAqD,KAAK,MACnE,GAGE,KAFY,GAAQ,KAGtB,EAAK,MAAQ,GACb,EAAK,WAAa,IAItB,OAAO,EAAO,SAAS,EAAW,EAAa,EAAK,CAMtD,MAAM,GAAmB,KACnB,GAAmB,OAEzB,SAAS,EAAY,EAAqC,CAexD,OAdK,EAUA,GAAiB,KAAK,EAAM,CAI1B,EAAM,MAAM,GAAiB,EAAI,EAAE,CAHjC,CAAC,EAAM,CAVP,EAAE,CAgBb,SAAgB,GACd,EACA,EACA,EACoB,CACpB,GAAI,GAAY,EAAiB,CAC/B,IAAM,EAAe,EAAY,EAAgB,CAEjD,GAAI,EAAa,SAAW,EAC1B,OAAO,GAAiB,IAAA,GAE1B,GAAI,CAAC,EACH,OAAO,EAAa,KAAK,IAAI,CAG/B,IAAM,EAAa,EAAY,EAAc,CACvC,EAAO,IAAI,IAAI,EAAW,CAEhC,IAAK,IAAM,KAAS,EACb,EAAK,IAAI,EAAM,GAClB,EAAK,IAAI,EAAM,CACf,EAAW,KAAK,EAAM,EAI1B,OAAO,EAAW,KAAK,IAAI,CAG7B,OAAO,GAAiB,IAAA,GA0B1B,SAAgB,EACd,EACA,EACS,CACT,GAAI,OAAO,GAAG,EAAM,EAAK,CACvB,MAAO,GAET,GAAI,CAAC,GAAQ,CAAC,EACZ,MAAO,GAGT,IAAM,EAAW,OAAO,KAAK,EAAK,CAElC,GAAI,EAAS,SAAW,OAAO,KAAK,EAAK,CAAC,OACxC,MAAO,GAGT,IAAM,EAAa,EACb,EAAa,EAEnB,IAAK,IAAM,KAAO,EAIhB,GACE,CAAC,OAAO,UAAU,eAAe,KAAK,EAAM,EAAI,EAChD,CAAC,OAAO,GAAG,EAAW,GAAM,EAAW,GAAK,CAE5C,MAAO,GAIX,MAAO,GCvST,SAAgB,GACd,EACA,EACA,EAAS,GACT,EAAoB,GACpB,EACS,CACT,IAAM,EAAS,GAAW,CAWpB,EAAO,MAET,IAAS,IAAA,GACL,CAAE,SAAQ,oBAAmB,CAC7B,CAAE,SAAQ,oBAAmB,OAAM,CACzC,CAAC,EAAQ,EAAmB,EAAK,CAClC,CAEK,EAAQ,MACN,EAAwB,EAAQ,EAAW,EAAQ,EAAK,CAC9D,CAAC,EAAQ,EAAW,EAAQ,EAAK,CAClC,CAED,OAAO,EACL,EAAM,UACN,EAAM,YACN,EAAM,YACP,CCVH,SAAS,GACP,EACA,EACS,CACT,OACE,EAAK,YAAc,EAAK,WACxB,EAAK,YAAc,EAAK,WACxB,EAAK,kBAAoB,EAAK,iBAC9B,EAAK,eAAiB,EAAK,cAC3B,EAAK,oBAAsB,EAAK,mBAChC,EAAK,UAAY,EAAK,SACtB,EAAK,SAAW,EAAK,QACrB,EAAK,QAAU,EAAK,OACpB,EAAK,WAAa,EAAK,UACvB,EAAK,OAAS,EAAK,MACnB,EAAa,EAAK,YAAa,EAAK,YAAY,EAChD,EAAa,EAAK,aAAc,EAAK,aAAa,CAItD,MAAa,EAAqC,GAC/C,CACC,YACA,cAAc,EACd,eAAe,EACf,YACA,kBAAkB,SAClB,eAAe,GACf,oBAAoB,GACpB,OACA,UACA,SACA,WACA,GAAG,KACC,CACJ,IAAM,EAAS,GAAW,CAQpB,EAAW,GACf,EACA,EACA,EACA,EACA,EACD,CAOK,EAAO,GACX,EACA,EACA,EACA,IAAS,IAAA,GAAY,IAAA,GAAY,CAAE,OAAM,CAC1C,CAEK,EAAe,GAAqD,CACpE,IACF,EAAQ,EAAI,CAER,EAAI,mBAKN,CAAC,GAAe,EAAI,EAAI,IAAW,WAIvC,EAAI,gBAAgB,CACpB,GACE,EACA,EACA,EACA,EACA,EACD,CAAC,UAAY,GAAG,GAGb,EAAiB,GACrB,EACA,EACA,EACD,CAED,OACE,EAAC,IAAD,CACE,GAAI,EACE,OACN,UAAW,EACX,QAAS,EAER,WACC,CAAA,EAGR,GACD,CAED,EAAK,YAAc,OCrGnB,SAAgB,GAAoB,CAClC,WACA,WACA,WACkC,CAMlC,IAAM,EAAQ,GALC,GAK4B,CAAC,CACtC,EAAW,EACf,EAAM,UACN,EAAM,YACN,EAAM,YACP,CAEK,EAAa,EAAO,EAAQ,CAqBlC,OAnBA,MAAsB,CACpB,EAAW,QAAU,GACrB,CAMF,MAAgB,CACV,EAAS,OACX,EAAW,UACT,EAAS,MACT,EAAS,QACT,EAAS,UACV,EAGF,CAAC,EAAS,QAAQ,CAAC,CAGpB,EAAC,EAAD,CAAA,SAAA,CACG,EACA,EAAS,MAAQ,EAAS,EAAS,MAAO,EAAS,WAAW,CAAG,KACzD,CAAA,CAAA,CC1Ef,MAAa,OAGJ,EAAc,EAFN,GAEyB,CAAC,CAAC,SAAS,CAAC,CCHtD,SAAgB,IAAgD,CAE9D,IAAM,EAAQ,EADC,GACyB,CAAC,CAEzC,OAAO,EACL,EAAM,UACN,EAAM,YACN,EAAM,YACP,CC0GH,SAAgB,GACd,EACA,EACM,CACN,IAAM,EAAS,GAAW,CACpB,EAAa,EAAO,EAAQ,CAC5B,EAAgB,GAAS,eAAiB,GAQhD,MAAsB,CACpB,EAAW,QAAU,GACrB,CAEF,MACS,EAAO,gBAAgB,CAAE,QAAO,YAAW,YAAa,CACzD,QAAiB,EAAM,OAAS,EAAU,OAU1C,GAAO,QAIX,OAAO,EAAW,QAAQ,CAAE,QAAO,YAAW,SAAQ,CAAC,EACvD,CACD,CAAC,EAAQ,EAAc,CAAC,CCrD7B,SAAgB,GACd,EACA,EACM,CACN,GAAM,CAAE,QAAO,iBAAkB,GAAU,CACrC,EAAa,EAAO,EAAQ,CAC5B,EAAsB,EAAqB,KAAK,CAChD,EAAgB,GAAS,eAAiB,GAKhD,MAAsB,CACpB,EAAW,QAAU,GACrB,CAEF,MAAgB,CAWT,EAAM,WAAW,OAGlB,GAAiB,EAAM,WAAW,OAAS,EAAM,MAIjD,EAAoB,UAAY,GAAS,CAAC,IAK9C,EAAoB,QAAU,EAC9B,EAAW,QAAQ,CAAE,QAAO,gBAAe,CAAC,IAC3C,CAAC,EAAO,EAAe,EAAc,CAAC,CCzH3C,MAAa,IAAyD,CACpE,SACA,WACA,qBACA,oBACA,qBACI,CACJ,MAAgB,CACd,GAAI,CAAC,EACH,OAGF,IAAM,EAAY,EAAqB,EAAO,CAE9C,UAAa,CACX,EAAU,SAAS,GAEpB,CAAC,EAAoB,EAAO,CAAC,CAMhC,IAAM,EAAS,GAAmB,KAC5B,EAAW,GAAmB,gBAC9B,EAAa,GAAmB,SAChC,EAAe,GAAmB,WAClC,EAAY,IAAsB,IAAA,GAExC,MAAgB,CACd,GAAI,CAAC,EACH,OAGF,IAAM,EAAK,GAAwB,EAAQ,CACzC,KAAM,EACN,gBAAiB,EACjB,SAAU,EACV,WAAY,EAEZ,gBAAiB,EAAkB,gBACpC,CAAC,CAEF,UAAa,CACX,EAAG,SAAS,GAIb,CAAC,EAAQ,EAAW,EAAQ,EAAU,EAAY,EAAa,CAAC,CAEnE,MAAgB,CACd,GAAI,CAAC,EACH,OAGF,IAAM,EAAK,GAAsB,EAAO,CAExC,UAAa,CACX,EAAG,SAAS,GAEb,CAAC,EAAQ,EAAgB,CAAC,CAI7B,IAAM,EAAY,EAAa,EAAO,CAMhC,EAAQ,MAAc,EAAkB,EAAO,CAAE,CAAC,EAAO,CAAC,CAI1D,CAAE,QAAO,iBAAkB,EAC/B,EAAM,UACN,EAAM,YACN,EAAM,YACP,CAQK,EAAoB,OACjB,CAAE,YAAW,QAAO,gBAAe,EAC1C,CAAC,EAAW,EAAO,EAAc,CAClC,CAED,OACE,EAAC,EAAc,SAAf,CAAwB,MAAO,WAC7B,EAAC,EAAiB,SAAlB,CAA2B,MAAO,WAChC,EAAC,EAAa,SAAd,CAAuB,MAAO,EAC3B,WACqB,CAAA,CACE,CAAA,CACL,CAAA"}
+{"version":3,"file":"index.mjs","names":["NOOP_INSTANCE","NOOP_INSTANCE","NOOP_INSTANCE"],"sources":["../../src/components/RouteView/components.tsx","../../src/components/RouteView/helpers.tsx","../../src/useSyncExternalStore.ts","../../src/hooks/useNavigator.tsx","../../src/hooks/useRouter.tsx","../../src/hooks/useRouteNode.tsx","../../src/components/RouteView/RouteView.tsx","../../src/constants.ts","../../../../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/Link.tsx","../../src/components/RouterErrorBoundary.tsx","../../src/hooks/useRouteUtils.tsx","../../src/hooks/useRouterTransition.tsx","../../src/hooks/useRouteExit.tsx","../../src/hooks/useRouteEnter.tsx","../../src/RouterProvider.tsx"],"sourcesContent":["import type { MatchProps, NotFoundProps, SelfProps } from \"./types\";\n\nexport function Match(_props: MatchProps): null {\n  return null;\n}\n\nMatch.displayName = \"RouteView.Match\";\n\nexport function Self(_props: SelfProps): null {\n  return null;\n}\n\nSelf.displayName = \"RouteView.Self\";\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 { Fragment, isValidElement, toChildArray } from \"preact\";\nimport { Suspense } from \"preact/compat\";\n\nimport { Match, NotFound, Self } from \"./components\";\n\nimport type { MatchProps, NotFoundProps, SelfProps } from \"./types\";\nimport type { VNode, ComponentChildren } from \"preact\";\n\ninterface FallbackSlots {\n  selfChildren: ComponentChildren;\n  selfFallback: ComponentChildren | undefined;\n  selfFound: boolean;\n  notFoundChildren: ComponentChildren;\n}\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: ComponentChildren,\n  result: VNode[],\n): void {\n  for (const child of toChildArray(children)) {\n    if (!isValidElement(child)) {\n      continue;\n    }\n\n    if (\n      child.type === Match ||\n      child.type === Self ||\n      child.type === NotFound\n    ) {\n      result.push(child);\n    } else {\n      collectElements(\n        (child.props as { readonly children: ComponentChildren }).children,\n        result,\n      );\n    }\n  }\n}\n\nfunction renderSlot(\n  slotChildren: ComponentChildren,\n  key: string,\n  fallback?: ComponentChildren,\n): VNode {\n  const content =\n    fallback === undefined ? (\n      slotChildren\n    ) : (\n      <Suspense fallback={fallback}>{slotChildren}</Suspense>\n    );\n\n  return <Fragment key={key}>{content}</Fragment>;\n}\n\nfunction isFallbackKind(child: VNode): boolean {\n  return child.type === NotFound || child.type === Self;\n}\n\nfunction assignFallbackSlot(child: VNode, slots: FallbackSlots): void {\n  if (child.type === NotFound) {\n    slots.notFoundChildren = (child.props as NotFoundProps).children;\n\n    return;\n  }\n\n  if (!slots.selfFound) {\n    slots.selfChildren = (child.props as SelfProps).children;\n    slots.selfFallback = (child.props as SelfProps).fallback;\n    slots.selfFound = true;\n  }\n}\n\nfunction processMatch(\n  child: VNode,\n  routeName: string,\n  nodeName: string,\n  alreadyActive: boolean,\n): VNode | null {\n  const {\n    segment,\n    exact = false,\n    fallback,\n    children,\n  } = child.props as MatchProps;\n  const fullSegmentName = nodeName ? `${nodeName}.${segment}` : segment;\n  const isActive =\n    !alreadyActive && isSegmentMatch(routeName, fullSegmentName, exact);\n\n  if (!isActive) {\n    return null;\n  }\n\n  return renderSlot(children, fullSegmentName, fallback);\n}\n\nfunction appendFallback(\n  rendered: VNode[],\n  routeName: string,\n  nodeName: string,\n  slots: FallbackSlots,\n): void {\n  if (slots.selfFound && routeName === nodeName) {\n    rendered.push(\n      renderSlot(slots.selfChildren, \"__route-view-self__\", slots.selfFallback),\n    );\n\n    return;\n  }\n\n  if (routeName === UNKNOWN_ROUTE && slots.notFoundChildren !== null) {\n    rendered.push(\n      <Fragment key=\"__route-view-not-found__\">\n        {slots.notFoundChildren}\n      </Fragment>,\n    );\n  }\n}\n\nexport function buildRenderList(\n  elements: VNode[],\n  routeName: string,\n  nodeName: string,\n): { rendered: VNode[]; activeMatchFound: boolean } {\n  const slots: FallbackSlots = {\n    selfChildren: null,\n    selfFallback: undefined,\n    selfFound: false,\n    notFoundChildren: null,\n  };\n  let activeMatchFound = false;\n  const rendered: VNode[] = [];\n\n  for (const child of elements) {\n    if (isFallbackKind(child)) {\n      assignFallbackSlot(child, slots);\n\n      continue;\n    }\n\n    const matchRendered = processMatch(\n      child,\n      routeName,\n      nodeName,\n      activeMatchFound,\n    );\n\n    if (matchRendered !== null) {\n      activeMatchFound = true;\n      rendered.push(matchRendered);\n    }\n  }\n\n  if (!activeMatchFound) {\n    appendFallback(rendered, routeName, nodeName, slots);\n  }\n\n  return { rendered, activeMatchFound };\n}\n","import { useEffect, useState } from \"preact/hooks\";\n\n/**\n * Polyfill for React's useSyncExternalStore.\n *\n * Preact does not provide a native useSyncExternalStore.\n * This implementation uses useState + useEffect to subscribe\n * to external stores.\n *\n * Race condition handling: the value may change between\n * `useState(getSnapshot)` (render) and `useEffect` (commit).\n * We synchronize by calling `setValue(getSnapshot())` before\n * subscribing in the effect.\n *\n * The updater uses `Object.is` to bail out when the snapshot\n * is referentially stable, preventing redundant re-renders.\n *\n * SSR semantics: `_getServerSnapshot` is intentionally ignored.\n * Preact's `preact-render-to-string` runs `useState(getSnapshot)`\n * on the server and does not commit effects, so the initial\n * render already uses `getSnapshot()`. Real-Router's `createRouteSource`\n * (and friends) return the same value on server and client given the\n * same `router` instance, so passing `getSnapshot` itself as the third\n * argument at every call site is the symmetric SSR contract; a separate\n * `getServerSnapshot` would diverge during hydration. Consumers that\n * truly need a different server value should branch in `getSnapshot`.\n *\n * Stable-reference contract: `subscribe` and `getSnapshot` are deps of\n * the subscription effect. If a consumer passes inline closures, every\n * render triggers `unsubscribe → subscribe` plus a fresh `sync()` pass\n * — a silent O(N) reconnect that the Preact polyfill cannot bail out\n * of (React's native impl uses an internal sub-store keyed by identity;\n * we cannot replicate that without losing the latest-snapshot guarantee).\n * All Real-Router hooks pass router-keyed cached factories from\n * `@real-router/sources`, which produce stable refs per `(router, args…)`\n * — keep that pattern for every external use.\n */\nexport function useSyncExternalStore<T>(\n  subscribe: (onStoreChange: () => void) => () => void,\n  getSnapshot: () => T,\n  _getServerSnapshot?: () => T,\n): T {\n  const [value, setValue] = useState(getSnapshot);\n\n  useEffect(() => {\n    const sync = (): void => {\n      setValue((prev) => {\n        const next = getSnapshot();\n\n        return Object.is(prev, next) ? prev : next;\n      });\n    };\n\n    sync();\n\n    return subscribe(sync);\n  }, [subscribe, getSnapshot]);\n\n  return value;\n}\n","import { createUseContextOrThrow, NavigatorContext } from \"../context\";\n\nimport type { Navigator } from \"@real-router/core\";\n\nexport const useNavigator: () => Navigator = createUseContextOrThrow(\n  NavigatorContext,\n  \"useNavigator\",\n);\n","import { createUseContextOrThrow, RouterContext } from \"../context\";\n\nimport type { Router } from \"@real-router/core\";\n\nexport const useRouter: () => Router = createUseContextOrThrow(\n  RouterContext,\n  \"useRouter\",\n);\n","import { createRouteNodeSource } from \"@real-router/sources\";\nimport { useMemo } from \"preact/hooks\";\n\nimport { useSyncExternalStore } from \"../useSyncExternalStore\";\nimport { useNavigator } from \"./useNavigator\";\nimport { useRouter } from \"./useRouter\";\n\nimport type { RouteContext } from \"../types\";\n\nexport function useRouteNode(nodeName: string): RouteContext {\n  const router = useRouter();\n  const navigator = useNavigator();\n\n  // `createRouteNodeSource` is the cached factory from `@real-router/sources`\n  // keyed on (router, nodeName) — identical args return identical refs across\n  // renders. No `useMemo` needed.\n  const store = createRouteNodeSource(router, nodeName);\n\n  const { route, previousRoute } = useSyncExternalStore(\n    store.subscribe,\n    store.getSnapshot,\n    store.getSnapshot,\n  );\n\n  // Public stable-ref contract (locked by `useRouteNode.test.tsx` \"should\n  // return stable reference when nothing changes\"): consecutive renders with\n  // identical (navigator, route, previousRoute) return the same RouteContext\n  // ref. Drop this `useMemo` and downstream consumers re-render on every\n  // parent re-render.\n  return useMemo(\n    (): RouteContext => ({ navigator, route, previousRoute }),\n    [navigator, route, previousRoute],\n  );\n}\n","import { useMemo } from \"preact/hooks\";\n\nimport { Match, NotFound, Self } from \"./components\";\nimport { buildRenderList, collectElements } from \"./helpers\";\nimport { useRouteNode } from \"../../hooks/useRouteNode\";\n\nimport type { RouteViewProps } from \"./types\";\nimport type { VNode } from \"preact\";\n\nfunction RouteViewRoot({\n  nodeName,\n  children,\n}: Readonly<RouteViewProps>): VNode | null {\n  const { route } = useRouteNode(nodeName);\n\n  // Cache the flattened Match/Self/NotFound list across renders with unchanged\n  // children. children only differs when the parent re-renders with a new\n  // node, so this memoises the steady-state traversal.\n  const elements = useMemo(() => {\n    const collected: VNode[] = [];\n\n    collectElements(children, collected);\n\n    return collected;\n  }, [children]);\n\n  const routeName = route?.name;\n\n  // buildRenderList is O(N) over Match/Self/NotFound children. Memo on\n  // (elements, routeName, nodeName) skips the re-walk on parent re-renders\n  // that don't change the active route; navigations always invalidate via\n  // routeName.\n  const rendered = useMemo(() => {\n    if (routeName === undefined) {\n      return [];\n    }\n\n    return buildRenderList(elements, routeName, nodeName).rendered;\n  }, [elements, routeName, nodeName]);\n\n  return rendered.length > 0 ? <>{rendered}</> : null;\n}\n\nRouteViewRoot.displayName = \"RouteView\";\n\nexport const RouteView = Object.assign(RouteViewRoot, {\n  Match,\n  Self,\n  NotFound,\n});\n\nexport type {\n  RouteViewProps,\n  MatchProps as RouteViewMatchProps,\n  SelfProps as RouteViewSelfProps,\n  NotFoundProps as RouteViewNotFoundProps,\n} from \"./types\";\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\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 } from \"preact/hooks\";\n\nimport { useSyncExternalStore } from \"../useSyncExternalStore\";\nimport { useRouter } from \"./useRouter\";\n\nimport type { Params } from \"@real-router/core\";\nimport type { ActiveRouteSourceOptions } from \"@real-router/sources\";\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. Caching the opts object + memoising the source\n  // lookup avoids (a) re-allocating the literal on every render and (b)\n  // re-running canonicalJson(params) on the cache lookup path. The `hash`\n  // argument (#532) participates in the cache key — a tab Link pointing to\n  // `/settings#account` shares its source only with consumers using the\n  // same routeName + params + hash. exactOptionalPropertyTypes forbids\n  // `{ hash: undefined }` literally, so we conditionally include the key\n  // only when the caller passed a value.\n  const opts = useMemo<ActiveRouteSourceOptions>(\n    () =>\n      hash === undefined\n        ? { strict, ignoreQueryParams }\n        : { strict, ignoreQueryParams, hash },\n    [strict, ignoreQueryParams, hash],\n  );\n\n  const store = useMemo(\n    () => createActiveRouteSource(router, routeName, params, opts),\n    [router, routeName, params, opts],\n  );\n\n  return useSyncExternalStore(\n    store.subscribe,\n    store.getSnapshot,\n    store.getSnapshot,\n  );\n}\n","import { memo } from \"preact/compat\";\n\nimport { EMPTY_PARAMS, EMPTY_OPTIONS } from \"../constants\";\nimport {\n  shouldNavigate,\n  buildHref,\n  buildActiveClassName,\n  navigateWithHash,\n  shallowEqual,\n} from \"../dom-utils\";\nimport { useIsActiveRoute } from \"../hooks/useIsActiveRoute\";\nimport { useRouter } from \"../hooks/useRouter\";\n\nimport type { LinkProps } from \"../types\";\nimport type { FunctionComponent, TargetedMouseEvent } from \"preact\";\n\n/**\n * Custom comparator for `Link`'s `memo()` wrapper.\n *\n * **Maintenance contract:** every field in `LinkProps` MUST appear in either\n * the `===` chain (primitives + identity-checked references like `onClick` /\n * `children` / `style`) or in the `shallowEqual` arms (object-valued\n * `routeParams` / `routeOptions`). When adding a new prop to `LinkProps`,\n * extend this function in the same PR — `tests/functional/Link.test.tsx`\n * contains a regression-guard that fails the build if `LinkProps` gains a\n * field that is not compared here.\n *\n * **Intentional omissions:** `props` (the rest-spread of HTMLAnchorElement\n * attributes — `aria-label`, `data-*`, `target`-other-than-`_blank`-handling,\n * etc.) is NOT compared. A change to `aria-label` will NOT trigger a Link\n * re-render. This is by design: dynamic `aria-label` is rare; consumers who\n * truly need a reactive aria-label should call `<Link key={ariaLabel}>` to\n * force a remount.\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    prev.hash === next.hash &&\n    shallowEqual(prev.routeParams, next.routeParams) &&\n    shallowEqual(prev.routeOptions, next.routeOptions)\n  );\n}\n\nexport const Link: FunctionComponent<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    hash,\n    onClick,\n    target,\n    children,\n    ...props\n  }) => {\n    const router = useRouter();\n\n    // memo + areLinkPropsEqual guarantees that on bail-out the component does\n    // not render; on render, routeParams/routeOptions changed reference (true\n    // change caught by shallowEqual), so they're safe to use directly in hook\n    // deps without useStableValue.\n\n    // Hash-aware active (#532) — see useIsActiveRoute for the contract.\n    const isActive = useIsActiveRoute(\n      routeName,\n      routeParams,\n      activeStrict,\n      ignoreQueryParams,\n      hash,\n    );\n\n    // `buildHref` is a cheap synchronous call (route-tree lookup + string\n    // concat). Wrapping it in `useMemo` allocates a deps array on every\n    // render that does not bail out — and on bail-out the function body\n    // doesn't execute, so the cache never pays off. Same logic for\n    // `buildActiveClassName` and `handleClick` below.\n    const href = buildHref(\n      router,\n      routeName,\n      routeParams,\n      hash === undefined ? undefined : { hash },\n    );\n\n    const handleClick = (evt: TargetedMouseEvent<HTMLAnchorElement>): void => {\n      if (onClick) {\n        onClick(evt);\n\n        if (evt.defaultPrevented) {\n          return;\n        }\n      }\n\n      if (!shouldNavigate(evt) || target === \"_blank\") {\n        return;\n      }\n\n      evt.preventDefault();\n      navigateWithHash(\n        router,\n        routeName,\n        routeParams,\n        hash,\n        routeOptions,\n      ).catch(() => {});\n    };\n\n    const finalClassName = buildActiveClassName(\n      isActive,\n      activeClassName,\n      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 { createDismissableError } from \"@real-router/sources\";\nimport { Fragment } from \"preact\";\nimport { useEffect, useLayoutEffect, useRef } from \"preact/hooks\";\n\nimport { useRouter } from \"../hooks/useRouter\";\nimport { useSyncExternalStore } from \"../useSyncExternalStore\";\n\nimport type { RouterError, State } from \"@real-router/core\";\nimport type { ComponentChildren, VNode } from \"preact\";\n\nexport interface RouterErrorBoundaryProps {\n  readonly children: ComponentChildren;\n  readonly fallback: (\n    error: RouterError,\n    resetError: () => void,\n  ) => ComponentChildren;\n  readonly onError?: (\n    error: RouterError,\n    toRoute: State | null,\n    fromRoute: State | null,\n  ) => void;\n}\n\n/**\n * Declarative navigation-error boundary.\n *\n * **Not** a Preact `componentDidCatch`-style ErrorBoundary — this component\n * does NOT catch render-time exceptions from `children`. It is a compositional\n * component that subscribes to `createDismissableError` from\n * `@real-router/sources` and renders `fallback(error, resetError)` ALONGSIDE\n * `children` (wrapped in a `<Fragment>`) when the router emits a navigation\n * error (guard rejection, ROUTE_NOT_FOUND, etc.). The boundary auto-resets on\n * the next successful navigation; `resetError()` lets the consumer dismiss\n * the fallback imperatively.\n *\n * For real exception boundaries, wrap children in a Preact ErrorBoundary\n * (e.g. `preact-iso/ErrorBoundary` or a custom `componentDidCatch` class) —\n * the two can coexist.\n */\nexport function RouterErrorBoundary({\n  children,\n  fallback,\n  onError,\n}: RouterErrorBoundaryProps): VNode {\n  const router = useRouter();\n\n  // `createDismissableError` is the cached factory from `@real-router/sources`\n  // — keyed per-router, identity stable across renders. `useMemo` would wrap\n  // a call that already memoizes downstream.\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  useLayoutEffect(() => {\n    onErrorRef.current = onError;\n  });\n\n  // snapshot.version is the @real-router/sources dismissable-error invariant:\n  // it is the only field that monotonically advances on each new error episode\n  // (snapshot.error/toRoute/fromRoute are correlated reads within the same\n  // version frame), so depending on it covers all error fields by construction.\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    <Fragment>\n      {children}\n      {snapshot.error ? fallback(snapshot.error, snapshot.resetError) : null}\n    </Fragment>\n  );\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\nexport const useRouteUtils = (): RouteUtils => {\n  const router = useRouter();\n\n  return getRouteUtils(getPluginApi(router).getTree());\n};\n","import { getTransitionSource } from \"@real-router/sources\";\n\nimport { useSyncExternalStore } from \"../useSyncExternalStore\";\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 { useEffect, useLayoutEffect, useRef } from \"preact/hooks\";\n\nimport { useRouter } from \"./useRouter\";\n\nimport type { State } from \"@real-router/core\";\n\nexport interface RouteExitContext {\n  /** The route being left. */\n  route: State;\n  /** The route being navigated to. */\n  nextRoute: State;\n  /**\n   * AbortSignal that fires when this navigation is superseded by a later\n   * one (rapid clicks). Already filtered: when the handler runs,\n   * `signal.aborted` is guaranteed to be `false`. Use\n   * `signal.addEventListener(\"abort\", cleanup, { once: true })` for\n   * cleanup that must run on cancellation.\n   */\n  signal: AbortSignal;\n}\n\nexport interface UseRouteExitOptions {\n  /**\n   * Skip the handler when `route.name === nextRoute.name`\n   * (sort/filter/query-only navigations on the same route). Default:\n   * `true`.\n   */\n  skipSameRoute?: boolean;\n}\n\nexport type RouteExitHandler = (\n  context: RouteExitContext,\n) => void | Promise<void>;\n\n/**\n * Subscribe to the router's leave-window with the universal guards baked\n * in. Wraps `router.subscribeLeave` so consumers don't repeat the same\n * boilerplate every time:\n *\n *   - **Reentrant abort pre-check**: if `signal.aborted` is already `true`\n *     when the handler would run (rapid navigation superseded a slower\n *     one), the handler is skipped entirely. `signal.addEventListener(\n *     \"abort\", ...)` does not fire retroactively, so without this guard\n *     downstream cleanup would never trigger.\n *   - **Same-route skip**: by default, `route.name === nextRoute.name`\n *     short-circuits the handler — query-only navigations (sort, filter,\n *     pagination) skip the work. Opt out with `skipSameRoute: false`.\n *   - **Stable handler reference**: the handler can change identity on\n *     every render without causing resubscription — internal ref keeps\n *     the latest handler accessible to the long-lived subscription.\n *\n * Returns nothing — the subscription's lifecycle is bound to the\n * component's mount.\n *\n * If the handler returns a Promise, the router blocks on it. If the\n * Promise resolves, navigation proceeds. If it rejects, the router emits\n * `TRANSITION_CANCELLED` (existing core behavior, no change here).\n *\n * @example Animation\n * ```tsx\n * const ref = useRef<HTMLDivElement>(null);\n *\n * useRouteExit(async ({ signal }) => {\n *   const el = ref.current;\n *   if (!el) return;\n *   el.classList.add(\"fade-out\");\n *   const cleanup = () => el.classList.remove(\"fade-out\");\n *   signal.addEventListener(\"abort\", cleanup, { once: true });\n *   try {\n *     el.getBoundingClientRect();   // style flush\n *     await Promise.allSettled(el.getAnimations().map((a) => a.finished));\n *   } finally {\n *     cleanup();\n *   }\n * });\n * ```\n *\n * @example Auto-save form draft\n * ```tsx\n * useRouteExit(async ({ signal }) => {\n *   if (formState.dirty) await api.saveDraft(formState, { signal });\n * });\n * ```\n *\n * @example Cancel inflight requests\n * ```tsx\n * useRouteExit(() => {\n *   inflightController.abort();\n * });\n * ```\n *\n * @example Library-coordinated exit (motion / framer-motion)\n * ```tsx\n * const exitResolverRef = useRef<(() => void) | null>(null);\n *\n * useRouteExit(({ signal }) => {\n *   return new Promise<void>((resolve) => {\n *     exitResolverRef.current = resolve;\n *     signal.addEventListener(\"abort\", () => resolve(), { once: true });\n *   });\n * });\n *\n * const onExitComplete = () => exitResolverRef.current?.();\n * // pass onExitComplete to <AnimatePresence>\n * ```\n *\n * @example Reading rich transition metadata via `nextRoute.transition`\n * ```tsx\n * useRouteExit(({ route, nextRoute }) => {\n *   // nextRoute.transition: TransitionMeta — preview of the upcoming nav\n *   if (nextRoute.transition.segments.deactivated.includes(\"products\")) {\n *     // leaving the products subtree entirely — flush product-related caches\n *     productCache.clear();\n *   }\n *   if (nextRoute.transition.redirected) {\n *     // skip animation when navigation arrived via redirect\n *     return;\n *   }\n * });\n * ```\n */\nexport function useRouteExit(\n  handler: RouteExitHandler,\n  options?: UseRouteExitOptions,\n): void {\n  const router = useRouter();\n  const handlerRef = useRef(handler);\n  const skipSameRoute = options?.skipSameRoute ?? true;\n\n  // Keep the latest handler accessible to the subscription without\n  // resubscribing on every render — the subscription registers the\n  // wrapper once and dispatches to whatever ref points to.\n  // useLayoutEffect (synchronous, post-render, pre-paint) updates the\n  // ref before the browser can dispatch any router events that could\n  // observe a stale closure.\n  useLayoutEffect(() => {\n    handlerRef.current = handler;\n  });\n\n  useEffect(() => {\n    return router.subscribeLeave(({ route, nextRoute, signal }) => {\n      if (skipSameRoute && route.name === nextRoute.name) {\n        return;\n      }\n\n      // Reentrant abort: signal is already aborted when listener fires\n      // (e.g. a newer navigate superseded this one before subscribeLeave\n      // even ran). addEventListener(\"abort\", ...) does not fire\n      // retroactively, so we skip the handler entirely — any cleanup the\n      // handler would have wired via abort listener must not run because\n      // the corresponding `add` work never happened.\n      if (signal.aborted) {\n        return;\n      }\n\n      return handlerRef.current({ route, nextRoute, signal });\n    });\n  }, [router, skipSameRoute]);\n}\n","import { useEffect, useLayoutEffect, useRef } from \"preact/hooks\";\n\nimport { useRoute } from \"./useRoute\";\n\nimport type { State } from \"@real-router/core\";\n\nexport interface RouteEnterContext {\n  /** The route that was just activated. */\n  route: State;\n  /** The route that was active immediately before this navigation. */\n  previousRoute: State;\n}\n\nexport type RouteEnterHandler = (context: RouteEnterContext) => void;\n\nexport interface UseRouteEnterOptions {\n  /**\n   * Skip the handler when `route.name === previousRoute.name`\n   * (sort/filter/query-only navigations on the same route). Default:\n   * `true`. Symmetric with `useRouteExit`'s same-name option.\n   */\n  skipSameRoute?: boolean;\n}\n\n/**\n * Fire `handler` once when the component mounts as a result of a\n * navigation. Mirror of `useRouteExit` for the entry side.\n *\n * What this hook covers that ad-hoc `useEffect` + `useRoute()` doesn't:\n *\n *   - **Skip-initial**: handler is skipped when there is no\n *     `previousRoute` (i.e. first-load mount). Most consumers want to\n *     fire side effects only on real navigations, not on hydration.\n *   - **Same-route skip** (default): handler is skipped when\n *     `route.name === previousRoute.name`. Sort/filter/query-only\n *     navigations re-run the effect (because `route` reference changes\n *     in `useRoute`'s snapshot), but they are not \"entries\" in the\n *     animation / analytics sense — the component instance has stayed\n *     mounted throughout. Opt out with `skipSameRoute: false` when\n *     the handler legitimately needs to fire on every navigation\n *     (e.g. analytics tracking each query-param flip).\n *   - **Latest-handler ref**: the handler can change identity on every\n *     render without re-running the effect — the registered wrapper\n *     dispatches to whatever `handlerRef.current` points to.\n *   - **Mount-time `route` / `previousRoute` snapshot**: the handler\n *     receives the values that were live at the moment of mount, not\n *     the latest ones (which may have moved on if the user navigated\n *     again before the effect drained).\n *\n * Race-safety: `useRoute()` is wired through `useSyncExternalStore` from\n * `@real-router/sources` (Preact polyfill: useState + useEffect, same\n * post-commit semantics), so by the time the new component's effect\n * runs, the snapshot is the post-commit one. This is the reason we can\n * read mount-time context from `useRoute()` instead of subscribing to\n * `router.subscribe` directly (which fires before Preact schedules a\n * re-render — the well-known race in distributed components).\n *\n * Note: Preact does not expose a `StrictMode` equivalent, so the\n * `lastHandledRouteRef` guard exists primarily for defensive symmetry\n * with the React implementation. It is harmless in Preact.\n *\n * @example Direction-aware entry animation\n * ```tsx\n * useRouteEnter(({ route }) => {\n *   const direction = route.context.browser?.direction;\n *   ref.current?.classList.add(\n *     direction === \"back\" ? \"slide-from-left\" : \"slide-from-right\",\n *   );\n * });\n * ```\n *\n * @example Source-aware focus management\n * ```tsx\n * useRouteEnter(({ route }) => {\n *   if (route.context.browser?.source === \"navigate\") {\n *     headingRef.current?.focus();\n *   }\n * });\n * ```\n *\n * @example Analytics page-enter event (skip-initial built-in)\n * ```tsx\n * useRouteEnter(({ route, previousRoute }) => {\n *   analytics.track(\"page_enter\", {\n *     route: route.name,\n *     from: previousRoute.name,\n *   });\n * });\n * ```\n *\n * @example Reading rich transition metadata via `route.transition`\n * ```tsx\n * useRouteEnter(({ route }) => {\n *   // route.transition: TransitionMeta — populated by core for every state\n *   if (route.transition.redirected) {\n *     showToast(`Redirected from ${route.transition.from}`);\n *   }\n *   if (route.transition.segments.activated.includes(\"products\")) {\n *     // products subtree just became active (could be products or\n *     // products.detail). Useful for subtree-scoped side effects.\n *   }\n * });\n * ```\n */\nexport function useRouteEnter(\n  handler: RouteEnterHandler,\n  options?: UseRouteEnterOptions,\n): void {\n  const { route, previousRoute } = useRoute();\n  const handlerRef = useRef(handler);\n  const lastHandledRouteRef = useRef<State | null>(null);\n  const skipSameRoute = options?.skipSameRoute ?? true;\n\n  // Keep the latest handler reference accessible without re-running\n  // the effect. useLayoutEffect (synchronous, post-render, pre-paint)\n  // updates the ref before the effect can read it.\n  useLayoutEffect(() => {\n    handlerRef.current = handler;\n  });\n\n  useEffect(() => {\n    // Early-exit guards, top-down:\n    //\n    //   - **Skip-initial**: `state.transition.from` is undefined only\n    //     for the very first state committed by `router.start()`.\n    //   - **Skip-same-route**: query-only navigations have\n    //     `transition.from === route.name`. Opt-out via\n    //     `skipSameRoute: false`.\n    //   - **Defensive dedupe**: same `route` ref between effect\n    //     cleanup + re-run. Preact has no StrictMode, but we keep the\n    //     guard for parity with React; v8-ignored.\n    if (!route.transition.from) {\n      return;\n    }\n    if (skipSameRoute && route.transition.from === route.name) {\n      return;\n    }\n    /* v8 ignore start */\n    if (lastHandledRouteRef.current === route || !previousRoute) {\n      return;\n    }\n    /* v8 ignore stop */\n\n    lastHandledRouteRef.current = route;\n    handlerRef.current({ route, previousRoute });\n  }, [route, previousRoute, skipSameRoute]);\n}\n","import { getNavigator } from \"@real-router/core\";\nimport { createRouteSource } from \"@real-router/sources\";\nimport { useEffect, useMemo } from \"preact/hooks\";\n\nimport { NavigatorContext, RouteContext, RouterContext } from \"./context\";\nimport {\n  createRouteAnnouncer,\n  createScrollRestoration,\n  createScrollSpy,\n  createViewTransitions,\n} from \"./dom-utils\";\nimport { useSyncExternalStore } from \"./useSyncExternalStore\";\n\nimport type { ScrollRestorationOptions, ScrollSpyOptions } from \"./dom-utils\";\nimport type { Router } from \"@real-router/core\";\nimport type { FunctionComponent, ComponentChildren } from \"preact\";\n\nexport interface RouteProviderProps {\n  router: Router;\n  children: ComponentChildren;\n  announceNavigation?: boolean;\n  scrollRestoration?: ScrollRestorationOptions;\n  scrollSpy?: ScrollSpyOptions;\n  viewTransitions?: boolean;\n}\n\nexport const RouterProvider: FunctionComponent<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    // 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  // `getNavigator` is cached per-router in `@real-router/core` (WeakMap) —\n  // same router always returns the same Navigator ref. No `useMemo` needed.\n  const navigator = getNavigator(router);\n\n  // `createRouteSource` is NOT cached (per packages/sources/CLAUDE.md table).\n  // It must be stable across renders so `useSyncExternalStore`'s deps don't\n  // change identity and trigger an unsubscribe/resubscribe loop on every\n  // render. `useMemo([router])` gives one source per router-instance lifetime.\n  const store = useMemo(() => createRouteSource(router), [router]);\n\n  // useSyncExternalStore manages the router subscription lifecycle:\n  // subscribe connects to router on first listener, unsubscribes on last.\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  // Stable-ref against parent re-renders: when parent re-renders RouterProvider\n  // without a route change (e.g. consumer re-renders the root), navigator /\n  // route / previousRoute references stay identical (useSyncExternalStore +\n  // Object.is bail-out). Without `useMemo` the object literal is fresh every\n  // render, propagating spurious re-renders to every `useRoute()` consumer.\n  // The memo bails out whenever the three deps are referentially equal.\n  const routeContextValue = useMemo(\n    () => ({ navigator, route, previousRoute }),\n    [navigator, route, previousRoute],\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/ssr.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"ssr.d.mts","names":[],"sources":["../../src/components/ClientOnly.tsx","../../src/components/ServerOnly.tsx","../../src/components/Await.tsx","../../src/components/Streamed.tsx","../../src/components/HttpStatusCode.tsx","../../src/utils/createHttpStatusSink.ts","../../src/components/HttpStatusProvider.tsx","../../src/hooks/useDeferred.tsx"],"mappings":";;;UAIiB,eAAA;EAAA,SACN,QAAA,EAAU,iBAAA;EAAA,SACV,QAAA,GAAW,iBAAA;AAAA;AAAA,iBAGN,UAAA,CAAA;EACd,QAAA;EACA;AAAA,GACC,eAAA,GAAkB,iBAAA;;;UCRJ,eAAA;EAAA,SACN,QAAA,EAAU,iBAAA;EAAA,SACV,QAAA,GAAW,iBAAA;AAAA;AAAA,iBAGN,UAAA,CAAA;EACd,QAAA;EACA;AAAA,GACC,eAAA,GAAkB,iBAAA;;;UC6CJ,UAAA;;WAEN,IAAA;EFvDqB;;EAAA,SE0DrB,QAAA,GAAW,KAAA,EAAO,CAAA,KAAM,iBAAA;AAAA;;;;;;AFrDnC;;;;;;;;iBEqEgB,KAAA,aAAA,CAAA;EACd,IAAA;EACA;AAAA,GACC,UAAA,CAAW,CAAA,IAAK,iBAAA;;;UC7EF,aAAA;;WAEN,QAAA,EAAU,iBAAA;EAAA,SACV,QAAA,EAAU,iBAAA;AAAA;;;;;;;;AHErB;iBGSgB,QAAA,CAAA;EACd,QAAA;EACA;AAAA,GACC,aAAA,GAAgB,iBAAA;;;UCfF,mBAAA;;WAEN,IAAA;AAAA;;;;;;;;;AJCX;;;;;;;;;;;;;;;;;;;;ACLA;;;;;;;;;;AAKA;;;;;;;iBG+CgB,cAAA,CAAA;EACd;AAAA,GACC,mBAAA,GAAsB,iBAAA;;;;;;AJtDzB;;;;;;;;;;AAKA;;;;;;;UKWiB,cAAA;EACf,IAAA;AAAA;AAAA,iBAGc,oBAAA,CAAA,GAAwB,cAAA;;;UCjBvB,uBAAA;EAAA,SACN,IAAA,EAAM,cAAA;EAAA,SACN,QAAA,EAAU,iBAAA;AAAA;AAAA,iBAGL,kBAAA,CAAA;EACd,IAAA;EACA;AAAA,GACC,uBAAA,GAA0B,iBAAA;;;;;;ANX7B;;;;iBOcgB,WAAA,aAAA,CAAyB,GAAA,WAAc,OAAA,CAAQ,CAAA"}
+{"version":3,"file":"ssr.d.mts","names":[],"sources":["../../src/components/ClientOnly.tsx","../../src/components/ServerOnly.tsx","../../src/components/Await.tsx","../../src/components/Streamed.tsx","../../src/components/HttpStatusCode.tsx","../../src/utils/createHttpStatusSink.ts","../../src/components/HttpStatusProvider.tsx","../../src/hooks/useDeferred.tsx"],"mappings":";;;UAIiB,eAAA;EAAA,SACN,QAAA,EAAU,iBAAA;EAAA,SACV,QAAA,GAAW,iBAAiB;AAAA;AAAA,iBAGvB,UAAA,CAAA;EACd,QAAA;EACA;AAAA,GACC,eAAA,GAAkB,iBAAA;;;UCRJ,eAAA;EAAA,SACN,QAAA,EAAU,iBAAA;EAAA,SACV,QAAA,GAAW,iBAAiB;AAAA;AAAA,iBAGvB,UAAA,CAAA;EACd,QAAA;EACA;AAAA,GACC,eAAA,GAAkB,iBAAA;;;UC6CJ,UAAA;;WAEN,IAAA;EFvDqB;;EAAA,SE0DrB,QAAA,GAAW,KAAA,EAAO,CAAA,KAAM,iBAAiB;AAAA;;;;;AFxDb;AAGvC;;;;;;;;iBEqEgB,KAAA,aAAA,CAAA;EACd,IAAA;EACA;AAAA,GACC,UAAA,CAAW,CAAA,IAAK,iBAAA;;;UC7EF,aAAA;;WAEN,QAAA,EAAU,iBAAA;EAAA,SACV,QAAA,EAAU,iBAAiB;AAAA;;;;;;;AHDC;AAGvC;iBGSgB,QAAA,CAAA;EACd,QAAA;EACA;AAAA,GACC,aAAA,GAAgB,iBAAA;;;UCfF,mBAAA;;WAEN,IAAI;AAAA;;;;;;;;AJFwB;AAGvC;;;;;;;;;;;;;;;;AAGsC;;;;ACRtC;;;;;;;;;AAEuC;AAGvC;;;;;;;iBG+CgB,cAAA,CAAA;EACd;AAAA,GACC,mBAAA,GAAsB,iBAAA;;;;;;AJtDzB;;;;;;;;;AAEuC;AAGvC;;;;;;;UKWiB,cAAA;EACf,IAAI;AAAA;AAAA,iBAGU,oBAAA,CAAA,GAAwB,cAAc;;;UCjBrC,uBAAA;EAAA,SACN,IAAA,EAAM,cAAA;EAAA,SACN,QAAA,EAAU,iBAAiB;AAAA;AAAA,iBAGtB,kBAAA,CAAA;EACd,IAAA;EACA;AAAA,GACC,uBAAA,GAA0B,iBAAA;;;;;;ANX7B;;;;iBOcgB,WAAA,aAAA,CAAyB,GAAA,WAAc,OAAO,CAAC,CAAA"}