@real-router/react 0.24.0 → 0.25.0

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

@@ -0,0 +1 @@
+{"version":3,"file":"RouterProvider-fJvMO5Tc.js","names":["RouterContext","NOOP_INSTANCE","NOOP_INSTANCE","NavigatorContext","RouterContext","NavigatorContext","RouteContext"],"sources":["../../src/hooks/useRouter.tsx","../../src/hooks/useRouteNode.tsx","../../../../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/RouterErrorBoundary.tsx","../../src/hooks/useNavigator.tsx","../../src/hooks/useRouteUtils.tsx","../../src/hooks/useRouterTransition.tsx","../../src/RouterProvider.tsx"],"sourcesContent":["import { useContext } from \"react\";\n\nimport { RouterContext } from \"../context\";\n\nimport type { Router } from \"@real-router/core\";\n\nexport const useRouter = (): Router => {\n  const router = useContext(RouterContext);\n\n  if (!router) {\n    throw new Error(\"useRouter must be used within a RouterProvider\");\n  }\n\n  return router;\n};\n","import { getNavigator } from \"@real-router/core\";\nimport { createRouteNodeSource } from \"@real-router/sources\";\nimport { useMemo, useSyncExternalStore } from \"react\";\n\nimport { useRouter } from \"./useRouter\";\n\nimport type { RouteContext } from \"../types\";\n\nexport function useRouteNode(nodeName: string): RouteContext {\n  const router = useRouter();\n\n  const store = useMemo(\n    () => createRouteNodeSource(router, nodeName),\n    [router, nodeName],\n  );\n\n  // Use snapshot reference directly. createRouteNodeSource via stabilizeState\n  // returns the SAME snapshot when the node-relevant state did not change,\n  // so memoization on `[navigator, snapshot]` preserves identity for consumers.\n  const snapshot = useSyncExternalStore(\n    store.subscribe,\n    store.getSnapshot,\n    store.getSnapshot, // SSR: router returns same state on server and client\n  );\n\n  // getNavigator is WeakMap-cached in core; additional useMemo is redundant.\n  const navigator = getNavigator(router);\n\n  return useMemo(\n    (): RouteContext => ({\n      navigator,\n      route: snapshot.route,\n      previousRoute: snapshot.previousRoute,\n    }),\n    [navigator, snapshot],\n  );\n}\n","import type { Router, State } from \"@real-router/core\";\n\nconst CLEAR_DELAY = 7000;\nconst SAFARI_READY_DELAY = 100;\nconst ANNOUNCER_ATTR = \"data-real-router-announcer\";\nconst INTERNAL_ROUTE_PREFIX = \"@@\";\nconst VISUALLY_HIDDEN =\n  \"position:absolute;width:1px;height:1px;padding:0;margin:-1px;overflow:hidden;clip:rect(0,0,0,0);clip-path:inset(50%);white-space:nowrap;border:0\";\n\nexport interface RouteAnnouncerOptions {\n  prefix?: string;\n  getAnnouncementText?: (route: State) => string;\n}\n\nconst NOOP_INSTANCE: { destroy: () => void } = Object.freeze({\n  destroy: () => {\n    /* no-op */\n  },\n});\n\nexport function createRouteAnnouncer(\n  router: Router,\n  options?: RouteAnnouncerOptions,\n): { destroy: () => void } {\n  // Defensive SSR / non-browser guard: in SSR (Node.js) or non-DOM\n  // environments, `document` is undefined and the announcer cannot\n  // attach its aria-live region. Return a frozen NOOP_INSTANCE — same\n  // pattern as `createDirectionTracker`, `createScrollRestoration`, and\n  // `createViewTransitions`. Without this guard, `NavigationAnnouncer`\n  // component construction would throw `ReferenceError: document is not\n  // defined` under `@angular/ssr` rendering, tearing down the whole SSR\n  // bootstrap. Closes review-2026-05-10 §5.10 ⛔ \"NavigationAnnouncer\n  // SSR mode\" MED.\n  if (typeof document === \"undefined\") {\n    return NOOP_INSTANCE;\n  }\n\n  const prefix = options?.prefix ?? \"Navigated to \";\n  const getCustomText = options?.getAnnouncementText;\n\n  let isInitialNavigation = true;\n  let isReady = false;\n  let isDestroyed = false;\n  let lastAnnouncedText = \"\";\n  let pendingText: string | null = null;\n  let clearTimeoutId: ReturnType<typeof setTimeout> | undefined;\n\n  const announcer = getOrCreateAnnouncer();\n\n  const doAnnounce = (text: string, h1: HTMLElement | null): void => {\n    lastAnnouncedText = text;\n    clearTimeout(clearTimeoutId);\n    announcer.textContent = text;\n    clearTimeoutId = setTimeout(() => {\n      announcer.textContent = \"\";\n      lastAnnouncedText = \"\";\n    }, CLEAR_DELAY);\n\n    manageFocus(h1);\n  };\n\n  // Safari-ready delay: announcing before VoiceOver wires up the aria-live region\n  // causes the first announcement to be silently dropped. Wait SAFARI_READY_DELAY ms\n  // before marking the announcer \"ready\" — any navigation during that window is\n  // buffered in pendingText and flushed once the delay expires.\n  const safariTimeoutId = setTimeout(() => {\n    isReady = true;\n\n    if (pendingText !== null && !isDestroyed) {\n      const text = pendingText;\n\n      pendingText = null;\n      doAnnounce(text, document.querySelector<HTMLElement>(\"h1\"));\n    }\n  }, SAFARI_READY_DELAY);\n\n  const unsubscribe = router.subscribe(({ route }) => {\n    if (isInitialNavigation) {\n      isInitialNavigation = false;\n\n      return;\n    }\n\n    // Double rAF: waits for two paint frames so the incoming route's DOM\n    // (including the new <h1>) is fully rendered before resolveText reads it.\n    // Single rAF fires before the new route's template has been attached,\n    // which would cause resolveText to pick up the OLD h1 or fall back to\n    // document.title / route.name prematurely.\n    requestAnimationFrame(() => {\n      requestAnimationFrame(() => {\n        if (isDestroyed) {\n          return;\n        }\n\n        const h1 = document.querySelector<HTMLElement>(\"h1\");\n        const text = resolveText(route, prefix, getCustomText, h1);\n\n        if (!text || text === lastAnnouncedText) {\n          return;\n        }\n\n        if (!isReady) {\n          // Defer announcement until Safari-ready window elapses (see safariTimeoutId).\n          pendingText = text;\n\n          return;\n        }\n\n        doAnnounce(text, h1);\n      });\n    });\n  });\n\n  return {\n    destroy() {\n      isDestroyed = true;\n      unsubscribe();\n      clearTimeout(clearTimeoutId);\n      clearTimeout(safariTimeoutId);\n      removeAnnouncer();\n    },\n  };\n}\n\nfunction getOrCreateAnnouncer(): HTMLElement {\n  const existing = document.querySelector<HTMLElement>(`[${ANNOUNCER_ATTR}]`);\n\n  if (existing) {\n    return existing;\n  }\n\n  const element = document.createElement(\"div\");\n\n  element.setAttribute(\"style\", VISUALLY_HIDDEN);\n  element.setAttribute(\"aria-live\", \"assertive\");\n  element.setAttribute(\"aria-atomic\", \"true\");\n  element.setAttribute(ANNOUNCER_ATTR, \"\");\n\n  // Defensive SSR / pre-`<body>` guard: in some environments (early\n  // injection, deferred-body documents, certain SSR rehydration paths)\n  // `document.body` can be null when the announcer is constructed.\n  // `document.body.prepend(...)` would throw `TypeError: Cannot read\n  // properties of null`, tearing down the consumer's RouterProvider /\n  // NavigationAnnouncer mount. Fallback to `documentElement` keeps the\n  // announcer working for SR users; visual-hidden styling means there is\n  // no visible artifact regardless of mount point.\n  //\n  // TS dom lib types `document.body` as `HTMLElement` (non-null), but\n  // runtime can return null per spec. The `as` cast narrows the type to\n  // include null so the `??` short-circuit is type-safe.\n  ((document.body as HTMLElement | null) ?? document.documentElement).prepend(\n    element,\n  );\n\n  return element;\n}\n\nfunction removeAnnouncer(): void {\n  document.querySelector(`[${ANNOUNCER_ATTR}]`)?.remove();\n}\n\nfunction resolveText(\n  route: State,\n  prefix: string,\n  getCustomText: ((route: State) => string) | undefined,\n  h1: HTMLElement | null,\n): string {\n  if (getCustomText) {\n    try {\n      const customText = getCustomText(route);\n\n      // Mini-sprint E.4 (audit-5 §4.2 #4) — empty-string fallback.\n      // A consumer pattern like\n      //   getAnnouncementText: (route) => myMap[route.name] ?? \"\"\n      // returns `\"\"` for routes outside the map. The subscribe loop\n      // then sees an empty text and silently no-announces — screen\n      // readers stay quiet without any signal to the developer. Treat\n      // a falsy custom result (`\"\"` / `null` / `undefined`) as\n      // \"consumer doesn't have a name for this route\" and fall through\n      // to the default resolution chain (h1 → title → route name).\n      if (customText) {\n        return customText;\n      }\n    } catch (error) {\n      // A throwing consumer callback inside the router's subscribe loop\n      // would tear down sibling listeners — log and fall through to the\n      // built-in resolution chain so the announcer keeps working.\n      console.error(\n        \"[real-router] getAnnouncementText threw; falling back to default resolution.\",\n        error,\n      );\n    }\n  }\n\n  const h1Text = (h1?.textContent ?? \"\").trim();\n  const routeName = route.name.startsWith(INTERNAL_ROUTE_PREFIX)\n    ? \"\"\n    : route.name;\n  const rawText =\n    h1Text || document.title || routeName || globalThis.location.pathname;\n\n  return `${prefix}${rawText}`;\n}\n\nfunction manageFocus(h1: HTMLElement | null): void {\n  if (!h1) {\n    return;\n  }\n\n  if (!h1.hasAttribute(\"tabindex\")) {\n    h1.setAttribute(\"tabindex\", \"-1\");\n  }\n\n  h1.focus({ preventScroll: true });\n}\n","import type { Router, State } from \"@real-router/core\";\n\nconst DEFAULT_STORAGE_KEY = \"real-router:scroll\";\n\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, useSyncExternalStore } from \"react\";\n\nimport { useRouter } from \"./useRouter\";\n\nimport type { Params } from \"@real-router/core\";\n\nexport function useIsActiveRoute(\n  routeName: string,\n  params?: Params,\n  strict = false,\n  ignoreQueryParams = true,\n  hash?: string,\n): boolean {\n  const router = useRouter();\n\n  // createActiveRouteSource is per-router + canonical-args cached in\n  // @real-router/sources, so passing params by reference is safe — equivalent\n  // param shapes hit the same cache entry regardless of key order. The\n  // `hash` argument (#532) is part of the cache key when defined: a Link\n  // pointing to `/settings#account` shares its source only with other\n  // consumers using the same routeName + params + hash.\n  //\n  // The useMemo wrap skips `canonicalJson(params)` + cache lookup on every\n  // render when all primitive deps and the `params` reference are stable —\n  // the common case once memo()+shallowEqual has bailed out further up\n  // (or when the parent re-renders for a non-Link reason). For inline\n  // `params={{id:1}}` the dep changes per render and the lookup still\n  // runs, but that path was already the slow path before this memo.\n  // exactOptionalPropertyTypes forbids `{ hash: undefined }` literally, so\n  // we conditionally spread the key only when the caller passed a value.\n  const store = useMemo(\n    () =>\n      createActiveRouteSource(router, routeName, params, {\n        strict,\n        ignoreQueryParams,\n        ...(hash !== undefined && { hash }),\n      }),\n    [router, routeName, params, strict, ignoreQueryParams, hash],\n  );\n\n  return useSyncExternalStore(\n    store.subscribe,\n    store.getSnapshot,\n    store.getSnapshot,\n  );\n}\n","import { createDismissableError } from \"@real-router/sources\";\nimport {\n  useEffect,\n  useLayoutEffect,\n  useMemo,\n  useRef,\n  useSyncExternalStore,\n} from \"react\";\n\nimport { useRouter } from \"../hooks/useRouter\";\n\nimport type { RouterError, State } from \"@real-router/core\";\nimport type { ReactElement, ReactNode } from \"react\";\n\nexport interface RouterErrorBoundaryProps {\n  readonly children: ReactNode;\n  readonly fallback: (error: RouterError, resetError: () => void) => ReactNode;\n  readonly onError?: (\n    error: RouterError,\n    toRoute: State | null,\n    fromRoute: State | null,\n  ) => void;\n}\n\nexport function RouterErrorBoundary({\n  children,\n  fallback,\n  onError,\n}: RouterErrorBoundaryProps): ReactElement {\n  const router = useRouter();\n  // Per-router cached in @real-router/sources — the WeakMap lookup is cheap,\n  // but useMemo avoids it entirely on stable-router re-renders (the common\n  // case for boundaries mounted in app shells).\n  const store = useMemo(() => createDismissableError(router), [router]);\n  const snapshot = useSyncExternalStore(\n    store.subscribe,\n    store.getSnapshot,\n    store.getSnapshot,\n  );\n\n  const onErrorRef = useRef(onError);\n\n  // \"Latest ref\" pattern shared with useRouteEnter/useRouteExit: sync the\n  // callback to the ref via useLayoutEffect (synchronous, post-render,\n  // pre-paint) so the snapshot effect below reads the freshest callback\n  // without listing `onError` as a dep — and StrictMode's double-effect\n  // pass writes the same value twice harmlessly.\n  useLayoutEffect(() => {\n    onErrorRef.current = onError;\n  });\n\n  useEffect(() => {\n    if (snapshot.error) {\n      onErrorRef.current?.(\n        snapshot.error,\n        snapshot.toRoute,\n        snapshot.fromRoute,\n      );\n    }\n    // eslint-disable-next-line @eslint-react/exhaustive-deps -- onError tracked via ref, snapshot fields accessed inside callback\n  }, [snapshot.version]);\n\n  return (\n    <>\n      {children}\n      {snapshot.error ? fallback(snapshot.error, snapshot.resetError) : null}\n    </>\n  );\n}\n","import { useContext } from \"react\";\n\nimport { NavigatorContext } from \"../context\";\n\nimport type { Navigator } from \"@real-router/core\";\n\nexport const useNavigator = (): Navigator => {\n  const navigator = useContext(NavigatorContext);\n\n  if (!navigator) {\n    throw new Error(\"useNavigator must be used within a RouterProvider\");\n  }\n\n  return navigator;\n};\n","import { getPluginApi } from \"@real-router/core/api\";\nimport { getRouteUtils } from \"@real-router/route-utils\";\n\nimport { useRouter } from \"./useRouter\";\n\nimport type { RouteUtils } from \"@real-router/route-utils\";\n\n/**\n * Returns a pre-computed {@link RouteUtils} instance for the current router.\n *\n * `getRouteUtils` is WeakMap-cached per `RouteTreeNode` inside\n * `@real-router/route-utils`, so the same router always returns the same\n * `RouteUtils` instance across renders — no local cache needed in the adapter.\n *\n * @returns RouteUtils instance with pre-computed chains and siblings\n *\n * @example\n * ```tsx\n * const utils = useRouteUtils();\n *\n * utils.getChain(\"users.profile\");\n * // → [\"users\", \"users.profile\"]\n *\n * utils.getSiblings(\"users\");\n * // → [\"admin\"]\n *\n * utils.isDescendantOf(\"users.profile\", \"users\");\n * // → true\n * ```\n */\nexport const useRouteUtils = (): RouteUtils => {\n  const router = useRouter();\n\n  return getRouteUtils(getPluginApi(router).getTree());\n};\n","import { getTransitionSource } from \"@real-router/sources\";\nimport { useSyncExternalStore } from \"react\";\n\nimport { useRouter } from \"./useRouter\";\n\nimport type { RouterTransitionSnapshot } from \"@real-router/sources\";\n\nexport function useRouterTransition(): RouterTransitionSnapshot {\n  const router = useRouter();\n  const store = getTransitionSource(router);\n\n  return useSyncExternalStore(\n    store.subscribe,\n    store.getSnapshot,\n    store.getSnapshot,\n  );\n}\n","import { getNavigator } from \"@real-router/core\";\nimport { createRouteSource } from \"@real-router/sources\";\nimport { useEffect, useMemo, useSyncExternalStore } from \"react\";\n\nimport { NavigatorContext, RouteContext, RouterContext } from \"./context\";\nimport {\n  createRouteAnnouncer,\n  createScrollRestoration,\n  createViewTransitions,\n} from \"./dom-utils\";\n\nimport type { ScrollRestorationOptions } from \"./dom-utils\";\nimport type { Router } from \"@real-router/core\";\nimport type { FC, ReactNode } from \"react\";\n\nexport interface RouteProviderProps {\n  router: Router;\n  children: ReactNode;\n  announceNavigation?: boolean;\n  scrollRestoration?: ScrollRestorationOptions;\n  viewTransitions?: boolean;\n}\n\nexport const RouterProvider: FC<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  const navigator = useMemo(() => getNavigator(router), [router]);\n\n  // useSyncExternalStore manages the router subscription lifecycle:\n  // subscribe connects to router on first listener, unsubscribes on last.\n  // This is Strict Mode safe — no useEffect cleanup needed.\n  const store = useMemo(() => createRouteSource(router), [router]);\n  // Use snapshot reference directly. createRouteSource via stabilizeState\n  // returns the SAME snapshot reference when route.path is unchanged, so\n  // useMemo below sees stable deps for idempotent navigations and\n  // RouteContext consumers do not re-render.\n  const snapshot = useSyncExternalStore(\n    store.subscribe,\n    store.getSnapshot,\n    store.getSnapshot, // SSR: router returns same state on server and client\n  );\n\n  const routeContextValue = useMemo(\n    () => ({\n      navigator,\n      route: snapshot.route,\n      previousRoute: snapshot.previousRoute,\n    }),\n    [navigator, snapshot],\n  );\n\n  return (\n    <RouterContext.Provider value={router}>\n      <NavigatorContext.Provider value={navigator}>\n        <RouteContext.Provider value={routeContextValue}>\n          {children}\n        </RouteContext.Provider>\n      </NavigatorContext.Provider>\n    </RouterContext.Provider>\n  );\n};\n"],"mappings":"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"}

package/dist/cjs/createHttpStatusSink-D_6IiR5E.js

@@ -0,0 +1,2 @@
+const e=require(`./useRoute-Dudo2K_0.js`);let t=require(`react`),n=require(`react/jsx-runtime`);function r({children:e,fallback:n=null}){let[r,i]=(0,t.useState)(!1);return(0,t.useEffect)(()=>{i(!0)},[]),r?e:n}function i({children:e,fallback:n=null}){let[r,i]=(0,t.useState)(!1);return(0,t.useEffect)(()=>{i(!0)},[]),r?n:e}function a(t){let{route:n}=e.t();return n.context.ssrDataDeferred?.[t]??e.i}function o({fallback:e,children:r}){return(0,n.jsx)(t.Suspense,{fallback:e,children:r})}const s=(0,t.createContext)(null);function c({sink:e,children:t}){return(0,n.jsx)(s.Provider,{value:e,children:t})}function l({code:e}){let n=(0,t.useContext)(s);return n&&(n.code=e),null}function u(){return{code:void 0}}Object.defineProperty(exports,`a`,{enumerable:!0,get:function(){return a}}),Object.defineProperty(exports,`i`,{enumerable:!0,get:function(){return o}}),Object.defineProperty(exports,`n`,{enumerable:!0,get:function(){return l}}),Object.defineProperty(exports,`o`,{enumerable:!0,get:function(){return i}}),Object.defineProperty(exports,`r`,{enumerable:!0,get:function(){return c}}),Object.defineProperty(exports,`s`,{enumerable:!0,get:function(){return r}}),Object.defineProperty(exports,`t`,{enumerable:!0,get:function(){return u}});
+//# sourceMappingURL=createHttpStatusSink-D_6IiR5E.js.map

package/dist/cjs/createHttpStatusSink-D_6IiR5E.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createHttpStatusSink-D_6IiR5E.js","names":["useRoute","NEVER_PROMISE","Suspense"],"sources":["../../src/components/ClientOnly.tsx","../../src/components/ServerOnly.tsx","../../src/hooks/useDeferred.tsx","../../src/components/Streamed.tsx","../../src/components/HttpStatusProvider.tsx","../../src/components/HttpStatusCode.tsx","../../src/utils/createHttpStatusSink.ts"],"sourcesContent":["import { useEffect, useState } from \"react\";\n\nimport type { ReactNode } from \"react\";\n\nexport interface ClientOnlyProps {\n  readonly children: ReactNode;\n  readonly fallback?: ReactNode;\n}\n\nexport function ClientOnly({\n  children,\n  fallback = null,\n}: ClientOnlyProps): ReactNode {\n  const [mounted, setMounted] = useState(false);\n\n  useEffect(() => {\n    // SSR/hydration boundary: server emits the fallback branch, client matches\n    // it on first paint, then this effect flips state to swap in the children.\n    // The intentional re-render is what makes the markup match across renders.\n    // eslint-disable-next-line @eslint-react/set-state-in-effect -- intentional post-hydration swap\n    setMounted(true);\n  }, []);\n\n  return mounted ? children : fallback;\n}\n","import { useEffect, useState } from \"react\";\n\nimport type { ReactNode } from \"react\";\n\nexport interface ServerOnlyProps {\n  readonly children: ReactNode;\n  readonly fallback?: ReactNode;\n}\n\nexport function ServerOnly({\n  children,\n  fallback = null,\n}: ServerOnlyProps): ReactNode {\n  const [mounted, setMounted] = useState(false);\n\n  useEffect(() => {\n    // SSR/hydration boundary: server emits the children branch, client matches\n    // it on first paint, then this effect flips state to swap in the fallback\n    // (or hide entirely). The intentional re-render keeps markup consistent\n    // across renders.\n    // eslint-disable-next-line @eslint-react/set-state-in-effect -- intentional post-hydration swap\n    setMounted(true);\n  }, []);\n\n  return mounted ? fallback : children;\n}\n","import { NEVER_PROMISE } from \"../constants\";\nimport { useRoute } from \"./useRoute\";\n\ninterface DeferredContext {\n  ssrDataDeferred?: Record<string, Promise<unknown>>;\n}\n\n/**\n * Read a deferred promise published by `defer({ deferred: { <key>: Promise } })`\n * inside an SSR data loader.\n *\n * - **Server render**: returns the actual loader-returned promise. Combine\n *   with `<Suspense>` + `use(promise)` for native streaming via React 19's\n *   `renderToReadableStream`.\n * - **Post-hydration**: returns a registry-backed promise; the inline\n *   `<script>__rrDefer__(\"key\", json)</script>` tags emitted by the server\n *   stream resolve it. `use()` returns synchronously once the registry\n *   settles.\n * - **Unknown key**: returns a never-resolving promise — Suspense boundary\n *   stays in fallback. This surfaces consumer/loader key drift as a visible\n *   loading state instead of a silent runtime error.\n *\n * The hook subscribes to `RouteContext`, so it re-runs on every navigation.\n * Promise reference identity is stable across renders within the same\n * navigation — `use()` will not re-suspend on rerenders.\n */\nexport function useDeferred<T = unknown>(key: string): Promise<T> {\n  const { route } = useRoute();\n  const context = route.context as DeferredContext;\n  const deferred = context.ssrDataDeferred;\n  const promise = deferred?.[key];\n\n  return (promise ?? NEVER_PROMISE) as Promise<T>;\n}\n","import { Suspense } from \"react\";\n\nimport type { ReactNode } from \"react\";\n\nexport interface StreamedProps {\n  /** Shown while any descendant `use(promise)` / `<Await>` is pending. */\n  readonly fallback: ReactNode;\n  readonly children: ReactNode;\n}\n\n/**\n * Cross-adapter alias for `<Suspense fallback={…}>`. Pairs with `<Await>`\n * for symmetry with `<Streamed>` boundaries in the SvelteKit / Solid\n * deferred-data conventions.\n *\n * ```tsx\n * <Streamed fallback={<Spinner />}>\n *   <Await<Review[]> name=\"reviews\">\n *     {(reviews) => <ReviewList items={reviews} />}\n *   </Await>\n * </Streamed>\n * ```\n *\n * The component is a thin wrapper around React's native `<Suspense>` — no\n * additional behaviour. Use plain `<Suspense>` directly if you don't need\n * the cross-framework naming alignment.\n */\nexport function Streamed({ fallback, children }: StreamedProps): ReactNode {\n  return <Suspense fallback={fallback}>{children}</Suspense>;\n}\n","import { createContext } from \"react\";\n\nimport type { HttpStatusSink } from \"../utils/createHttpStatusSink\";\nimport type { ReactNode } from \"react\";\n\nexport const HttpStatusContext = createContext<HttpStatusSink | null>(null);\n\nexport interface HttpStatusProviderProps {\n  readonly sink: HttpStatusSink;\n  readonly children: ReactNode;\n}\n\nexport function HttpStatusProvider({\n  sink,\n  children,\n}: HttpStatusProviderProps): ReactNode {\n  // `<HttpStatusContext.Provider value>` (not the React 19 `<HttpStatusContext value>`\n  // shorthand) — same component file is exported via `/legacy/ssr` for React 18\n  // consumers, where the shorthand throws \"Element type is invalid: expected\n  // a string but got: object\".\n  return (\n    <HttpStatusContext.Provider value={sink}>\n      {children}\n    </HttpStatusContext.Provider>\n  );\n}\n","import { useContext } from \"react\";\n\nimport { HttpStatusContext } from \"./HttpStatusProvider\";\n\nimport type { ReactNode } from \"react\";\n\nexport interface HttpStatusCodeProps {\n  /** HTTP status to apply to the response. Common values: 404, 410, 451, 503. */\n  readonly code: number;\n}\n\n/**\n * Render-time HTTP status declaration. Mount inside a route component (typical\n * use case: a glob `*` route's NotFound page) when the status is decided by\n * the rendered tree rather than a loader.\n *\n * Writes `code` to the nearest `<HttpStatusProvider>`'s sink during render and\n * returns `null`. With no provider mounted (the standard client-side case)\n * the component is a silent no-op — same component tree hydrates without\n * touching the DOM or warning about mismatches.\n *\n * Loader-driven errors (`LoaderNotFound` → 404, `LoaderRedirect` → 30x) keep\n * working as before; this component covers render-time decisions only.\n *\n * Last write wins when several `<HttpStatusCode />` instances mount in the\n * same render pass — sink reflects the last component that ran.\n *\n * ```tsx\n * // entry-server.tsx\n * import { renderToString } from \"react-dom/server\";\n * import { createHttpStatusSink, HttpStatusProvider } from \"@real-router/react/ssr\";\n *\n * const sink = createHttpStatusSink();\n * const html = renderToString(\n *   <HttpStatusProvider sink={sink}>\n *     <RouterProvider router={router}>\n *       <App />\n *     </RouterProvider>\n *   </HttpStatusProvider>,\n * );\n * response.status(sink.code ?? 200).send(html);\n * ```\n *\n * **Streaming SSR (`renderToReadableStream`):** the response status MUST be\n * sent before the first body byte flushes. If `<HttpStatusCode />` is mounted\n * inside a late-resolving `<Suspense>` boundary, the sink write may happen\n * AFTER the headers are already on the wire — the override is then lost.\n * Either mount the component in the shell (above every `<Suspense>` that\n * could delay it) or `await stream.allReady` before reading `sink.code`\n * (which forfeits streaming benefits). For non-streaming SSR\n * (`renderToString`) there is no such ordering concern.\n *\n * **Valid `code` range:** Node's `res.end()` throws `Invalid status code` on\n * `NaN`, `0`, negative values, or values `> 999` — this surfaces as a 5xx /\n * dropped connection, not silent corruption. Pass a real HTTP status integer\n * (commonly 4xx/5xx; 100-999 is what Node accepts).\n */\nexport function HttpStatusCode({ code }: HttpStatusCodeProps): ReactNode {\n  const sink = useContext(HttpStatusContext);\n\n  if (sink) {\n    sink.code = code;\n  }\n\n  return null;\n}\n","/**\n * Render-scoped HTTP status sink. Created per request on the server, passed to\n * `<HttpStatusProvider sink={...}>`, and read after `renderToString` /\n * `renderToReadableStream` to apply the value to the HTTP response.\n *\n * Last write wins: if the rendered tree mounts more than one\n * `<HttpStatusCode />`, the value reflects the last component that ran during\n * the render pass.\n *\n * No-op on the client — `<HttpStatusCode />` reads the optional context and\n * skips the write when no provider is mounted, so the same component tree can\n * be hydrated without changing behaviour.\n *\n * Constraints:\n * - **Per-request only.** Don't share a sink across requests; the rendered\n *   tree mutates `code` in place. Module-level singletons leak status\n *   between concurrent requests.\n * - **Don't `Object.freeze` the sink.** The component writes to `.code`;\n *   freezing makes the assignment throw under ESM strict mode.\n */\nexport interface HttpStatusSink {\n  code: number | undefined;\n}\n\nexport function createHttpStatusSink(): HttpStatusSink {\n  return { code: undefined };\n}\n"],"mappings":"gGASA,SAAgB,EAAW,CACzB,WACA,WAAW,MACkB,CAC7B,GAAM,CAAC,EAAS,IAAA,EAAA,EAAA,UAAuB,GAAM,CAU7C,OARA,EAAA,EAAA,eAAgB,CAKd,EAAW,GAAK,EACf,EAAE,CAAC,CAEC,EAAU,EAAW,ECd9B,SAAgB,EAAW,CACzB,WACA,WAAW,MACkB,CAC7B,GAAM,CAAC,EAAS,IAAA,EAAA,EAAA,UAAuB,GAAM,CAW7C,OATA,EAAA,EAAA,eAAgB,CAMd,EAAW,GAAK,EACf,EAAE,CAAC,CAEC,EAAU,EAAW,ECE9B,SAAgB,EAAyB,EAAyB,CAChE,GAAM,CAAE,SAAUA,EAAAA,GAAU,CAK5B,OAJgB,EAAM,QACG,kBACE,IAERC,EAAAA,ECLrB,SAAgB,EAAS,CAAE,WAAU,YAAsC,CACzE,OAAO,EAAA,EAAA,KAACC,EAAAA,SAAD,CAAoB,WAAW,WAAoB,CAAA,CCvB5D,MAAa,GAAA,EAAA,EAAA,eAAyD,KAAK,CAO3E,SAAgB,EAAmB,CACjC,OACA,YACqC,CAKrC,OACE,EAAA,EAAA,KAAC,EAAkB,SAAnB,CAA4B,MAAO,EAChC,WAC0B,CAAA,CCkCjC,SAAgB,EAAe,CAAE,QAAwC,CACvE,IAAM,GAAA,EAAA,EAAA,YAAkB,EAAkB,CAM1C,OAJI,IACF,EAAK,KAAO,GAGP,KCxCT,SAAgB,GAAuC,CACrD,MAAO,CAAE,KAAM,IAAA,GAAW"}

package/dist/cjs/index.d.ts

@@ -1,282 +1,7 @@
-import { a as useNavigator, c as RouterErrorBoundaryProps, i as useRouteUtils, l as LinkProps, n as useRouteNode, o as useRouter, r as useRoute, s as RouterErrorBoundary, t as useRouterTransition } from "./useRouterTransition-BYit_9Mt.js";
-import { n as Link, t as RouterProvider } from "./RouterProvider-Bj1_NbpA.js";
-import { ReactElement, ReactNode } from "react";
-import { Navigator, State } from "@real-router/core";
+import { a as RouteExitContext, c as useRouteExit, d as NotFoundProps, f as RouteViewProps, i as useRouteEnter, l as RouteView, n as RouteEnterHandler, o as RouteExitHandler, p as SelfProps, r as UseRouteEnterOptions, s as UseRouteExitOptions, t as RouteEnterContext, u as MatchProps } from "./useRouteEnter-gfy65W0D.js";
+import { n as RouterErrorBoundaryProps, r as LinkProps, t as RouterErrorBoundary } from "./RouterErrorBoundary-BlJmaoyr.js";
+import { n as Link, t as RouterProvider } from "./RouterProvider-DvC9mViF.js";
+import { a as useNavigator, i as useRouteUtils, n as useRouteNode, o as useRouter, r as useRoute, t as useRouterTransition } from "./useRouterTransition-BfayPs0h.js";
+import { Navigator } from "@real-router/core";
 import { RouterTransitionSnapshot } from "@real-router/sources";
-
-//#region src/components/modern/RouteView/types.d.ts
-interface RouteViewProps {
-  /** Route tree node name to subscribe to. "" for root. */
-  readonly nodeName: string;
-  /** <RouteView.Match>, <RouteView.Self>, and <RouteView.NotFound> elements. */
-  readonly children: ReactNode;
-}
-interface MatchProps {
-  /** Route segment to match against. */
-  readonly segment: string;
-  /** Exact match only (no descendants). Defaults to false. */
-  readonly exact?: boolean;
-  /** Preserve component state when deactivated (React Activity). Defaults to false. */
-  readonly keepAlive?: boolean;
-  /** Fallback content to show while children are suspended. */
-  readonly fallback?: ReactNode;
-  /** Content to render when matched. */
-  readonly children: ReactNode;
-}
-interface SelfProps {
-  /**
-   * Fallback content to show while children are suspended.
-   *
-   * Symmetric with `<RouteView.Match fallback>` — wraps children in
-   * `<Suspense>` when defined.
-   */
-  readonly fallback?: ReactNode;
-  /** Content to render when the active route name equals the parent RouteView's nodeName. */
-  readonly children: ReactNode;
-}
-interface NotFoundProps {
-  /** Content to render on UNKNOWN_ROUTE. */
-  readonly children: ReactNode;
-}
-//#endregion
-//#region src/components/modern/RouteView/components.d.ts
-declare function Match(_props: MatchProps): null;
-declare namespace Match {
-  var displayName: string;
-}
-declare function Self(_props: SelfProps): null;
-declare namespace Self {
-  var displayName: string;
-}
-declare function NotFound(_props: NotFoundProps): null;
-declare namespace NotFound {
-  var displayName: string;
-}
-//#endregion
-//#region src/components/modern/RouteView/RouteView.d.ts
-declare function RouteViewRoot({
-  nodeName,
-  children
-}: Readonly<RouteViewProps>): ReactElement | null;
-declare namespace RouteViewRoot {
-  var displayName: string;
-}
-declare const RouteView: typeof RouteViewRoot & {
-  Match: typeof Match;
-  Self: typeof Self;
-  NotFound: typeof NotFound;
-};
-//#endregion
-//#region src/hooks/useRouteExit.d.ts
-interface RouteExitContext {
-  /** The route being left. */
-  route: State;
-  /** The route being navigated to. */
-  nextRoute: State;
-  /**
-   * AbortSignal that fires when this navigation is superseded by a later
-   * one (rapid clicks). Already filtered: when the handler runs,
-   * `signal.aborted` is guaranteed to be `false`. Use
-   * `signal.addEventListener("abort", cleanup, { once: true })` for
-   * cleanup that must run on cancellation.
-   */
-  signal: AbortSignal;
-}
-interface UseRouteExitOptions {
-  /**
-   * Skip the handler when `route.name === nextRoute.name`
-   * (sort/filter/query-only navigations on the same route). Default:
-   * `true`.
-   */
-  skipSameRoute?: boolean;
-}
-type RouteExitHandler = (context: RouteExitContext) => void | Promise<void>;
-/**
- * Subscribe to the router's leave-window with the universal guards baked
- * in. Wraps `router.subscribeLeave` so consumers don't repeat the same
- * boilerplate every time:
- *
- *   - **Reentrant abort pre-check**: if `signal.aborted` is already `true`
- *     when the handler would run (rapid navigation superseded a slower
- *     one), the handler is skipped entirely. `signal.addEventListener(
- *     "abort", ...)` does not fire retroactively, so without this guard
- *     downstream cleanup would never trigger.
- *   - **Same-route skip**: by default, `route.name === nextRoute.name`
- *     short-circuits the handler — query-only navigations (sort, filter,
- *     pagination) skip the work. Opt out with `skipSameRoute: false`.
- *   - **Stable handler reference**: the handler can change identity on
- *     every render without causing resubscription — internal ref keeps
- *     the latest handler accessible to the long-lived subscription.
- *
- * Returns nothing — the subscription's lifecycle is bound to the
- * component's mount.
- *
- * If the handler returns a Promise, the router blocks on it. If the
- * Promise resolves, navigation proceeds. If it rejects, the router emits
- * `TRANSITION_CANCELLED` (existing core behavior, no change here).
- *
- * @example Animation
- * ```tsx
- * const ref = useRef<HTMLDivElement>(null);
- *
- * useRouteExit(async ({ signal }) => {
- *   const el = ref.current;
- *   if (!el) return;
- *   el.classList.add("fade-out");
- *   const cleanup = () => el.classList.remove("fade-out");
- *   signal.addEventListener("abort", cleanup, { once: true });
- *   try {
- *     el.getBoundingClientRect();   // style flush
- *     await Promise.allSettled(el.getAnimations().map((a) => a.finished));
- *   } finally {
- *     cleanup();
- *   }
- * });
- * ```
- *
- * @example Auto-save form draft
- * ```tsx
- * useRouteExit(async ({ signal }) => {
- *   if (formState.dirty) await api.saveDraft(formState, { signal });
- * });
- * ```
- *
- * @example Cancel inflight requests
- * ```tsx
- * useRouteExit(() => {
- *   inflightController.abort();
- * });
- * ```
- *
- * @example Library-coordinated exit (motion / framer-motion)
- * ```tsx
- * const exitResolverRef = useRef<(() => void) | null>(null);
- *
- * useRouteExit(({ signal }) => {
- *   return new Promise<void>((resolve) => {
- *     exitResolverRef.current = resolve;
- *     signal.addEventListener("abort", () => resolve(), { once: true });
- *   });
- * });
- *
- * const onExitComplete = () => exitResolverRef.current?.();
- * // pass onExitComplete to <AnimatePresence>
- * ```
- *
- * @example Reading rich transition metadata via `nextRoute.transition`
- * ```tsx
- * useRouteExit(({ route, nextRoute }) => {
- *   // nextRoute.transition: TransitionMeta — preview of the upcoming nav
- *   if (nextRoute.transition.segments.deactivated.includes("products")) {
- *     // leaving the products subtree entirely — flush product-related caches
- *     productCache.clear();
- *   }
- *   if (nextRoute.transition.redirected) {
- *     // skip animation when navigation arrived via redirect
- *     return;
- *   }
- * });
- * ```
- */
-declare function useRouteExit(handler: RouteExitHandler, options?: UseRouteExitOptions): void;
-//#endregion
-//#region src/hooks/useRouteEnter.d.ts
-interface RouteEnterContext {
-  /** The route that was just activated. */
-  route: State;
-  /** The route that was active immediately before this navigation. */
-  previousRoute: State;
-}
-type RouteEnterHandler = (context: RouteEnterContext) => void;
-interface UseRouteEnterOptions {
-  /**
-   * Skip the handler when `route.name === previousRoute.name`
-   * (sort/filter/query-only navigations on the same route). Default:
-   * `true`. Symmetric with `useRouteExit`'s same-name option.
-   */
-  skipSameRoute?: boolean;
-}
-/**
- * Fire `handler` once when the component mounts as a result of a
- * navigation. Mirror of `useRouteExit` for the entry side.
- *
- * What this hook covers that ad-hoc `useEffect` + `useRoute()` doesn't:
- *
- *   - **Skip-initial**: handler is skipped when there is no
- *     `previousRoute` (i.e. first-load mount). Most consumers want to
- *     fire side effects only on real navigations, not on hydration.
- *   - **Same-route skip** (default): handler is skipped when
- *     `route.name === previousRoute.name`. Sort/filter/query-only
- *     navigations re-run the effect (because `route` reference changes
- *     in `useRoute`'s snapshot), but they are not "entries" in the
- *     animation / analytics sense — the component instance has stayed
- *     mounted throughout. Opt out with `skipSameRoute: false` when
- *     the handler legitimately needs to fire on every navigation
- *     (e.g. analytics tracking each query-param flip).
- *   - **StrictMode double-mount immunity**: in dev, React's StrictMode
- *     runs every effect twice to surface bugs. Without a guard,
- *     analytics fire twice, animations restart, focus jumps. The hook
- *     tracks the last-handled `route` reference and short-circuits the
- *     second pass.
- *   - **Latest-handler ref**: the handler can change identity on every
- *     render without re-running the effect — the registered wrapper
- *     dispatches to whatever `handlerRef.current` points to.
- *   - **Mount-time `route` / `previousRoute` snapshot**: the handler
- *     receives the values that were live at the moment of mount, not
- *     the latest ones (which may have moved on if the user navigated
- *     again before the effect drained).
- *
- * Race-safety: `useRoute()` is wired through `useSyncExternalStore` from
- * `@real-router/sources`, so by the time the new component's effect
- * runs, the snapshot is the post-commit one. This is the reason we can
- * read mount-time context from `useRoute()` instead of subscribing to
- * `router.subscribe` directly (which fires before React schedules a
- * re-render — the well-known race in distributed components).
- *
- * @example Direction-aware entry animation
- * ```tsx
- * useRouteEnter(({ route }) => {
- *   const direction = route.context.browser?.direction;
- *   ref.current?.classList.add(
- *     direction === "back" ? "slide-from-left" : "slide-from-right",
- *   );
- * });
- * ```
- *
- * @example Source-aware focus management
- * ```tsx
- * useRouteEnter(({ route }) => {
- *   if (route.context.browser?.source === "navigate") {
- *     headingRef.current?.focus();
- *   }
- * });
- * ```
- *
- * @example Analytics page-enter event (skip-initial built-in)
- * ```tsx
- * useRouteEnter(({ route, previousRoute }) => {
- *   analytics.track("page_enter", {
- *     route: route.name,
- *     from: previousRoute.name,
- *   });
- * });
- * ```
- *
- * @example Reading rich transition metadata via `route.transition`
- * ```tsx
- * useRouteEnter(({ route }) => {
- *   // route.transition: TransitionMeta — populated by core for every state
- *   if (route.transition.redirected) {
- *     showToast(`Redirected from ${route.transition.from}`);
- *   }
- *   if (route.transition.segments.activated.includes("products")) {
- *     // products subtree just became active (could be products or
- *     // products.detail). Useful for subtree-scoped side effects.
- *   }
- * });
- * ```
- */
-declare function useRouteEnter(handler: RouteEnterHandler, options?: UseRouteEnterOptions): void;
-//#endregion
-export { Link, type LinkProps, type Navigator, type RouteEnterContext, type RouteEnterHandler, type RouteExitContext, type RouteExitHandler, RouteView, type MatchProps as RouteViewMatchProps, type NotFoundProps as RouteViewNotFoundProps, type RouteViewProps, type SelfProps as RouteViewSelfProps, RouterErrorBoundary, type RouterErrorBoundaryProps, RouterProvider, type RouterTransitionSnapshot, type UseRouteEnterOptions, type UseRouteExitOptions, useNavigator, useRoute, useRouteEnter, useRouteExit, useRouteNode, useRouteUtils, useRouter, useRouterTransition };
-//# sourceMappingURL=index.d.ts.map
+export { Link, type LinkProps, type Navigator, type RouteEnterContext, type RouteEnterHandler, type RouteExitContext, type RouteExitHandler, RouteView, type MatchProps as RouteViewMatchProps, type NotFoundProps as RouteViewNotFoundProps, type RouteViewProps, type SelfProps as RouteViewSelfProps, RouterErrorBoundary, type RouterErrorBoundaryProps, RouterProvider, type RouterTransitionSnapshot, type UseRouteEnterOptions, type UseRouteExitOptions, useNavigator, useRoute, useRouteEnter, useRouteExit, useRouteNode, useRouteUtils, useRouter, useRouterTransition };

package/dist/cjs/index.js

@@ -1,2 +1,2 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require(`./RouterProvider-CfBNR-k7.js`),t=require(`./Link-DYvAnJlk.js`);let n=require(`react`),r=require(`@real-router/core`),i=require(`@real-router/route-utils`),a=require(`react/jsx-runtime`);function o(e){return null}o.displayName=`RouteView.Match`;function s(e){return null}s.displayName=`RouteView.Self`;function c(e){return null}c.displayName=`RouteView.NotFound`;function l(e,t,n){return t===``?!1:n?e===t:(0,i.startsWithSegment)(e,t)}function u(e,t){for(let r of n.Children.toArray(e))(0,n.isValidElement)(r)&&(r.type===o||r.type===s||r.type===c?t.push(r):u(r.props.children,t))}function d(e,t,r,i,o){let s=o===void 0?e:(0,a.jsx)(n.Suspense,{fallback:o,children:e});return r?(0,a.jsx)(n.Activity,{mode:i,children:s},t):(0,a.jsx)(n.Fragment,{children:s},t)}function f(e,t){return e.type===c?(t.notFoundChildren=e.props.children,!0):e.type===s?(t.selfFound||=(t.selfChildren=e.props.children,t.selfFallback=e.props.fallback,!0),!0):!1}function p(e,t,n,r,i){let{segment:a,exact:o=!1,keepAlive:s=!1,fallback:c}=e.props,u=n?`${n}.${a}`:a;return!i&&l(t,u,o)?(r.add(u),{rendered:d(e.props.children,u,s,`visible`,c),matched:!0}):s&&r.has(u)?{rendered:d(e.props.children,u,s,`hidden`,c),matched:!1}:{rendered:null,matched:!1}}function m(e,t,i,o){if(o.selfFound&&t===i){e.push(d(o.selfChildren,`__route-view-self__`,!1,`visible`,o.selfFallback));return}t===r.UNKNOWN_ROUTE&&o.notFoundChildren!==null&&e.push((0,a.jsx)(n.Fragment,{children:o.notFoundChildren},`__route-view-not-found__`))}function h(e,t,n,r){let i={selfChildren:null,selfFallback:void 0,selfFound:!1,notFoundChildren:null},a=!1,o=[];for(let s of e){if(f(s,i))continue;let e=p(s,t,n,r,a);e.matched&&(a=!0),e.rendered!==null&&o.push(e.rendered)}return a||m(o,t,n,i),{rendered:o,activeMatchFound:a}}function g({nodeName:t,children:r}){let{route:i}=e.h(t),o=(0,n.useRef)(null);o.current??=new Set;let s=(0,n.useMemo)(()=>{let e=[];return u(r,e),e},[r]);if(!i)return null;let{rendered:c}=h(s,i.name,t,o.current);return c.length>0?(0,a.jsx)(a.Fragment,{children:c}):null}g.displayName=`RouteView`;const _=Object.assign(g,{Match:o,Self:s,NotFound:c});function v(t,r){let i=e.g(),a=(0,n.useRef)(t),o=r?.skipSameRoute??!0;(0,n.useLayoutEffect)(()=>{a.current=t}),(0,n.useEffect)(()=>i.subscribeLeave(({route:e,nextRoute:t,signal:n})=>{if(!(o&&e.name===t.name)&&!n.aborted)return a.current({route:e,nextRoute:t,signal:n})}),[i,o])}function y(t,r){let{route:i,previousRoute:a}=e.r(),o=(0,n.useRef)(t),s=(0,n.useRef)(null),c=r?.skipSameRoute??!0;(0,n.useLayoutEffect)(()=>{o.current=t}),(0,n.useEffect)(()=>{i.transition.from&&(c&&i.transition.from===i.name||s.current===i||!a||(s.current=i,o.current({route:i,previousRoute:a})))},[i,a,c])}exports.Link=t.t,exports.RouteView=_,exports.RouterErrorBoundary=e.o,exports.RouterProvider=e.t,exports.useNavigator=e.a,exports.useRoute=e.r,exports.useRouteEnter=y,exports.useRouteExit=v,exports.useRouteNode=e.h,exports.useRouteUtils=e.i,exports.useRouter=e.g,exports.useRouterTransition=e.n;
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require(`./useRoute-Dudo2K_0.js`),t=require(`./RouterProvider-fJvMO5Tc.js`),n=require(`./Link-BspioC76.js`);let r=require(`react`),i=require(`@real-router/core`),a=require(`@real-router/route-utils`),o=require(`react/jsx-runtime`);function s(e){return null}s.displayName=`RouteView.Match`;function c(e){return null}c.displayName=`RouteView.Self`;function l(e){return null}l.displayName=`RouteView.NotFound`;function u(e,t,n){return t===``?!1:n?e===t:(0,a.startsWithSegment)(e,t)}function d(e,t){r.Children.forEach(e,e=>{(0,r.isValidElement)(e)&&(e.type===s||e.type===c||e.type===l?t.push(e):d(e.props.children,t))})}function f(e,t,n,i,a){let s=a===void 0?e:(0,o.jsx)(r.Suspense,{fallback:a,children:e});return n?(0,o.jsx)(r.Activity,{mode:i,children:s},t):(0,o.jsx)(r.Fragment,{children:s},t)}function p(e,t){return e.type===l?(t.notFoundChildren=e.props.children,!0):e.type===c?(t.selfFound||=(t.selfChildren=e.props.children,t.selfFallback=e.props.fallback,!0),!0):!1}function m(e,t,n,r,i){let a=e.props,{segment:o,exact:s=!1,keepAlive:c=!1,fallback:l}=a,d=n?`${n}.${o}`:o;return!i&&u(t,d,s)?(r.add(d),{rendered:f(a.children,d,c,`visible`,l),matched:!0}):c&&r.has(d)?{rendered:f(a.children,d,c,`hidden`,l),matched:!1}:{rendered:null,matched:!1}}function h(e,t,n,a){if(a.selfFound&&t===n){e.push(f(a.selfChildren,`__route-view-self__`,!1,`visible`,a.selfFallback));return}t===i.UNKNOWN_ROUTE&&a.notFoundChildren!==null&&e.push((0,o.jsx)(r.Fragment,{children:a.notFoundChildren},`__route-view-not-found__`))}function g(e,t,n,r){let i={selfChildren:null,selfFallback:void 0,selfFound:!1,notFoundChildren:null},a=!1,o=[];for(let s of e){if(p(s,i))continue;let e=m(s,t,n,r,a);e.matched&&(a=!0),e.rendered!==null&&o.push(e.rendered)}return a||h(o,t,n,i),{rendered:o,activeMatchFound:a}}function _({nodeName:e,children:n}){let{route:i}=t.f(e),a=(0,r.useRef)(null);a.current??=new Set;let s=(0,r.useMemo)(()=>{let e=[];return d(n,e),e},[n]);if(!i)return null;let{rendered:c}=g(s,i.name,e,a.current);return c.length>0?(0,o.jsx)(o.Fragment,{children:c}):null}_.displayName=`RouteView`;const v=Object.assign(_,{Match:s,Self:c,NotFound:l});function y(e,n){let i=t.p(),a=(0,r.useRef)(e),o=n?.skipSameRoute??!0;(0,r.useLayoutEffect)(()=>{a.current=e}),(0,r.useEffect)(()=>i.subscribeLeave(({route:e,nextRoute:t,signal:n})=>{if(!(o&&e.name===t.name)&&!n.aborted)return a.current({route:e,nextRoute:t,signal:n})}),[i,o])}function b(t,n){let{route:i,previousRoute:a}=e.t(),o=(0,r.useRef)(t),s=(0,r.useRef)(null),c=n?.skipSameRoute??!0;(0,r.useLayoutEffect)(()=>{o.current=t}),(0,r.useEffect)(()=>{i.transition.from&&(c&&i.transition.from===i.name||s.current===i||!a||(s.current=i,o.current({route:i,previousRoute:a})))},[i,a,c])}exports.Link=n.t,exports.RouteView=v,exports.RouterErrorBoundary=t.a,exports.RouterProvider=t.t,exports.useNavigator=t.i,exports.useRoute=e.t,exports.useRouteEnter=b,exports.useRouteExit=y,exports.useRouteNode=t.f,exports.useRouteUtils=t.r,exports.useRouter=t.p,exports.useRouterTransition=t.n;
 //# sourceMappingURL=index.js.map

package/dist/cjs/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":["Children","Suspense","Activity","Fragment","UNKNOWN_ROUTE","useRouteNode","useRouter","useRoute"],"sources":["../../src/components/modern/RouteView/components.tsx","../../src/components/modern/RouteView/helpers.tsx","../../src/components/modern/RouteView/RouteView.tsx","../../src/hooks/useRouteExit.tsx","../../src/hooks/useRouteEnter.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 { Activity, Children, Fragment, Suspense, isValidElement } from \"react\";\n\nimport { Match, NotFound, Self } from \"./components\";\n\nimport type { MatchProps, NotFoundProps, SelfProps } from \"./types\";\nimport type { ReactElement, ReactNode } from \"react\";\n\ninterface FallbackSlots {\n  selfChildren: ReactNode;\n  selfFallback: ReactNode | undefined;\n  selfFound: boolean;\n  notFoundChildren: ReactNode;\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: ReactNode,\n  result: ReactElement[],\n): void {\n  // eslint-disable-next-line @eslint-react/no-children-to-array\n  for (const child of Children.toArray(children)) {\n    if (!isValidElement(child)) {\n      continue;\n    }\n\n    if (\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: ReactNode }).children,\n        result,\n      );\n    }\n  }\n}\n\nfunction renderSlotElement(\n  slotChildren: ReactNode,\n  key: string,\n  keepAlive: boolean,\n  mode: \"visible\" | \"hidden\",\n  fallback?: ReactNode,\n): ReactElement {\n  const content =\n    fallback === undefined ? (\n      slotChildren\n    ) : (\n      <Suspense fallback={fallback}>{slotChildren}</Suspense>\n    );\n\n  if (keepAlive) {\n    return (\n      <Activity mode={mode} key={key}>\n        {content}\n      </Activity>\n    );\n  }\n\n  return <Fragment key={key}>{content}</Fragment>;\n}\n\nfunction recordFallback(child: ReactElement, slots: FallbackSlots): boolean {\n  if (child.type === NotFound) {\n    slots.notFoundChildren = (child.props as NotFoundProps).children;\n\n    return true;\n  }\n\n  if (child.type === Self) {\n    // First-wins: subsequent <Self> elements are ignored, mirroring NotFound.\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    return true;\n  }\n\n  return false;\n}\n\nfunction processMatch(\n  child: ReactElement,\n  routeName: string,\n  nodeName: string,\n  hasBeenActivated: Set<string>,\n  alreadyActive: boolean,\n): { rendered: ReactElement | null; matched: boolean } {\n  const {\n    segment,\n    exact = false,\n    keepAlive = false,\n    fallback,\n  } = child.props as MatchProps;\n  const fullSegmentName = nodeName ? `${nodeName}.${segment}` : segment;\n  const isActive =\n    !alreadyActive && isSegmentMatch(routeName, fullSegmentName, exact);\n\n  if (isActive) {\n    hasBeenActivated.add(fullSegmentName);\n\n    return {\n      rendered: renderSlotElement(\n        (child.props as MatchProps).children,\n        fullSegmentName,\n        keepAlive,\n        \"visible\",\n        fallback,\n      ),\n      matched: true,\n    };\n  }\n\n  if (keepAlive && hasBeenActivated.has(fullSegmentName)) {\n    return {\n      rendered: renderSlotElement(\n        (child.props as MatchProps).children,\n        fullSegmentName,\n        keepAlive,\n        \"hidden\",\n        fallback,\n      ),\n      matched: false,\n    };\n  }\n\n  return { rendered: null, matched: false };\n}\n\nfunction appendFallback(\n  rendered: ReactElement[],\n  routeName: string,\n  nodeName: string,\n  slots: FallbackSlots,\n): void {\n  if (slots.selfFound && routeName === nodeName) {\n    rendered.push(\n      renderSlotElement(\n        slots.selfChildren,\n        \"__route-view-self__\",\n        false,\n        \"visible\",\n        slots.selfFallback,\n      ),\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: ReactElement[],\n  routeName: string,\n  nodeName: string,\n  hasBeenActivated: Set<string>,\n): { rendered: ReactElement[]; 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: ReactElement[] = [];\n\n  for (const child of elements) {\n    if (recordFallback(child, slots)) {\n      continue;\n    }\n\n    const result = processMatch(\n      child,\n      routeName,\n      nodeName,\n      hasBeenActivated,\n      activeMatchFound,\n    );\n\n    if (result.matched) {\n      activeMatchFound = true;\n    }\n\n    if (result.rendered !== null) {\n      rendered.push(result.rendered);\n    }\n  }\n\n  if (!activeMatchFound) {\n    appendFallback(rendered, routeName, nodeName, slots);\n  }\n\n  return { rendered, activeMatchFound };\n}\n","import { useMemo, useRef } from \"react\";\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 { ReactElement } from \"react\";\n\nfunction RouteViewRoot({\n  nodeName,\n  children,\n}: Readonly<RouteViewProps>): ReactElement | null {\n  const { route } = useRouteNode(nodeName);\n  const hasBeenActivatedRef = useRef<Set<string> | null>(null);\n\n  // eslint-disable-next-line @eslint-react/refs -- lazy init: assign once when null to avoid `new Set()` allocation on every render\n  hasBeenActivatedRef.current ??= new Set();\n\n  // Skip the Children.toArray + collectElements traversal when children\n  // reference is unchanged. children only changes when the parent re-renders\n  // with a new ReactNode, so this caches the steady-state.\n  const elements = useMemo(() => {\n    const collected: ReactElement[] = [];\n\n    collectElements(children, collected);\n\n    return collected;\n  }, [children]);\n\n  if (!route) {\n    return null;\n  }\n\n  const { rendered } = buildRenderList(\n    elements,\n    route.name,\n    nodeName,\n    // eslint-disable-next-line @eslint-react/refs -- stable Set ref read for keepAlive tracking (never reassigned)\n    hasBeenActivatedRef.current,\n  );\n\n  if (rendered.length > 0) {\n    return <>{rendered}</>;\n  }\n\n  return null;\n}\n\nRouteViewRoot.displayName = \"RouteView\";\n\nexport const RouteView = Object.assign(RouteViewRoot, {\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","import { useEffect, useLayoutEffect, useRef } from \"react\";\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 \"react\";\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 *   - **StrictMode double-mount immunity**: in dev, React's StrictMode\n *     runs every effect twice to surface bugs. Without a guard,\n *     analytics fire twice, animations restart, focus jumps. The hook\n *     tracks the last-handled `route` reference and short-circuits the\n *     second pass.\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`, 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 React schedules a\n * re-render — the well-known race in distributed components).\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    //   - **StrictMode dedupe**: same `route` ref between effect\n    //     cleanup + re-run in dev's strict pass. Not testable from\n    //     vitest (`NODE_ENV === \"test\"` disables React's strict-mode\n    //     double-run), so 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"],"mappings":"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"}
+{"version":3,"file":"index.js","names":["Suspense","Activity","Fragment","UNKNOWN_ROUTE","useRouteNode","useRouter","useRoute"],"sources":["../../src/components/modern/RouteView/components.tsx","../../src/components/modern/RouteView/helpers.tsx","../../src/components/modern/RouteView/RouteView.tsx","../../src/hooks/useRouteExit.tsx","../../src/hooks/useRouteEnter.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 { Activity, Children, Fragment, Suspense, isValidElement } from \"react\";\n\nimport { Match, NotFound, Self } from \"./components\";\n\nimport type { MatchProps, NotFoundProps, SelfProps } from \"./types\";\nimport type { ReactElement, ReactNode } from \"react\";\n\ninterface FallbackSlots {\n  selfChildren: ReactNode;\n  selfFallback: ReactNode | undefined;\n  selfFound: boolean;\n  notFoundChildren: ReactNode;\n}\n\n// Fixed keys used by appendFallback to distinguish the Self / NotFound\n// render slots from user-supplied <Match> children. Match render slots key\n// off `fullSegmentName` instead — these two are the only synthetic keys.\nconst SELF_KEY = \"__route-view-self__\";\nconst NOT_FOUND_KEY = \"__route-view-not-found__\";\n\nfunction isSegmentMatch(\n  routeName: string,\n  fullSegmentName: string,\n  exact: boolean,\n): boolean {\n  if (fullSegmentName === \"\") {\n    return false;\n  }\n\n  if (exact) {\n    return routeName === fullSegmentName;\n  }\n\n  return startsWithSegment(routeName, fullSegmentName);\n}\n\nexport function collectElements(\n  children: ReactNode,\n  result: ReactElement[],\n): void {\n  // Recurses into Fragment-like wrappers (anything that isn't Match / Self /\n  // NotFound) to flatten the slot tree. No explicit depth guard: typical\n  // RouteView shape is `<RouteView><Match/>...<NotFound/></RouteView>` —\n  // depth ≤ 3 in real apps. A pathological hand-written tree of N Fragments\n  // recurses N times; the call stack, not this function, is the bound.\n  //\n  // `Children.forEach` iterates without `Children.toArray`'s array allocation\n  // and per-child clone-with-synthetic-key step. We don't read child.key here\n  // (Match/Self/NotFound carry their own segment-derived keys further down),\n  // so the cheaper iterator is functionally equivalent.\n  // eslint-disable-next-line @eslint-react/no-children-for-each -- intentional: collectElements is a render-hot pipeline; toArray's array+key clone is wasteful here\n  Children.forEach(children, (child) => {\n    if (!isValidElement(child)) {\n      return;\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: ReactNode }).children,\n        result,\n      );\n    }\n  });\n}\n\nfunction renderSlotElement(\n  slotChildren: ReactNode,\n  key: string,\n  keepAlive: boolean,\n  mode: \"visible\" | \"hidden\",\n  fallback?: ReactNode,\n): ReactElement {\n  const content =\n    fallback === undefined ? (\n      slotChildren\n    ) : (\n      <Suspense fallback={fallback}>{slotChildren}</Suspense>\n    );\n\n  if (keepAlive) {\n    return (\n      <Activity mode={mode} key={key}>\n        {content}\n      </Activity>\n    );\n  }\n\n  return <Fragment key={key}>{content}</Fragment>;\n}\n\nfunction recordFallback(child: ReactElement, slots: FallbackSlots): boolean {\n  if (child.type === NotFound) {\n    slots.notFoundChildren = (child.props as NotFoundProps).children;\n\n    return true;\n  }\n\n  if (child.type === Self) {\n    // First-wins: subsequent <Self> elements are ignored, mirroring NotFound.\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    return true;\n  }\n\n  return false;\n}\n\nfunction processMatch(\n  child: ReactElement,\n  routeName: string,\n  nodeName: string,\n  hasBeenActivated: Set<string>,\n  alreadyActive: boolean,\n): { rendered: ReactElement | null; matched: boolean } {\n  const matchProps = child.props as MatchProps;\n  const { segment, exact = false, keepAlive = false, fallback } = matchProps;\n  const fullSegmentName = nodeName ? `${nodeName}.${segment}` : segment;\n  const isActive =\n    !alreadyActive && isSegmentMatch(routeName, fullSegmentName, exact);\n\n  if (isActive) {\n    hasBeenActivated.add(fullSegmentName);\n\n    return {\n      rendered: renderSlotElement(\n        matchProps.children,\n        fullSegmentName,\n        keepAlive,\n        \"visible\",\n        fallback,\n      ),\n      matched: true,\n    };\n  }\n\n  if (keepAlive && hasBeenActivated.has(fullSegmentName)) {\n    return {\n      rendered: renderSlotElement(\n        matchProps.children,\n        fullSegmentName,\n        keepAlive,\n        \"hidden\",\n        fallback,\n      ),\n      matched: false,\n    };\n  }\n\n  return { rendered: null, matched: false };\n}\n\nfunction appendFallback(\n  rendered: ReactElement[],\n  routeName: string,\n  nodeName: string,\n  slots: FallbackSlots,\n): void {\n  if (slots.selfFound && routeName === nodeName) {\n    rendered.push(\n      renderSlotElement(\n        slots.selfChildren,\n        SELF_KEY,\n        false,\n        \"visible\",\n        slots.selfFallback,\n      ),\n    );\n\n    return;\n  }\n\n  if (routeName === UNKNOWN_ROUTE && slots.notFoundChildren !== null) {\n    rendered.push(\n      <Fragment key={NOT_FOUND_KEY}>{slots.notFoundChildren}</Fragment>,\n    );\n  }\n}\n\nexport function buildRenderList(\n  elements: ReactElement[],\n  routeName: string,\n  nodeName: string,\n  hasBeenActivated: Set<string>,\n): { rendered: ReactElement[]; 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: ReactElement[] = [];\n\n  for (const child of elements) {\n    if (recordFallback(child, slots)) {\n      continue;\n    }\n\n    const result = processMatch(\n      child,\n      routeName,\n      nodeName,\n      hasBeenActivated,\n      activeMatchFound,\n    );\n\n    if (result.matched) {\n      activeMatchFound = true;\n    }\n\n    if (result.rendered !== null) {\n      rendered.push(result.rendered);\n    }\n  }\n\n  if (!activeMatchFound) {\n    appendFallback(rendered, routeName, nodeName, slots);\n  }\n\n  return { rendered, activeMatchFound };\n}\n","import { useMemo, useRef } from \"react\";\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 { ReactElement } from \"react\";\n\nfunction RouteViewRoot({\n  nodeName,\n  children,\n}: Readonly<RouteViewProps>): ReactElement | null {\n  const { route } = useRouteNode(nodeName);\n  const hasBeenActivatedRef = useRef<Set<string> | null>(null);\n\n  // eslint-disable-next-line @eslint-react/refs -- lazy init: assign once when null to avoid `new Set()` allocation on every render\n  hasBeenActivatedRef.current ??= new Set();\n\n  // Skip the Children.forEach + collectElements traversal when the children\n  // reference is unchanged. The common SPA case is a stable JSX tree across\n  // re-renders, so the cache hits on every render except the first.\n  //\n  // Streaming SSR caveat: with `renderToReadableStream`, React may invoke\n  // RouteView multiple times across chunks with a fresh `children` reference\n  // each time. The useMemo misses on each new render and the traversal runs\n  // again — this is the expected SSR cost; the alternative would be build-\n  // time codegen of the static route tree, which is out of scope here.\n  const elements = useMemo(() => {\n    const collected: ReactElement[] = [];\n\n    collectElements(children, collected);\n\n    return collected;\n  }, [children]);\n\n  if (!route) {\n    return null;\n  }\n\n  const { rendered } = buildRenderList(\n    elements,\n    route.name,\n    nodeName,\n    // eslint-disable-next-line @eslint-react/refs -- stable Set ref read for keepAlive tracking (never reassigned)\n    hasBeenActivatedRef.current,\n  );\n\n  if (rendered.length > 0) {\n    return <>{rendered}</>;\n  }\n\n  return null;\n}\n\nRouteViewRoot.displayName = \"RouteView\";\n\nexport const RouteView = Object.assign(RouteViewRoot, {\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","import { useEffect, useLayoutEffect, useRef } from \"react\";\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 \"react\";\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 *   - **StrictMode double-mount immunity**: in dev, React's StrictMode\n *     runs every effect twice to surface bugs. Without a guard,\n *     analytics fire twice, animations restart, focus jumps. The hook\n *     tracks the last-handled `route` reference and short-circuits the\n *     second pass.\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`, 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 React schedules a\n * re-render — the well-known race in distributed components).\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    //   - **StrictMode dedupe**: same `route` ref between effect\n    //     cleanup + re-run in dev's strict pass. Not testable from\n    //     vitest (`NODE_ENV === \"test\"` disables React's strict-mode\n    //     double-run), so 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"],"mappings":"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"}

package/dist/cjs/index.react-server.d.ts

@@ -0,0 +1,5 @@
+import { a as RouteExitContext, d as NotFoundProps, f as RouteViewProps, n as RouteEnterHandler, o as RouteExitHandler, p as SelfProps, r as UseRouteEnterOptions, s as UseRouteExitOptions, t as RouteEnterContext, u as MatchProps } from "./useRouteEnter-gfy65W0D.js";
+import { n as RouterErrorBoundaryProps, r as LinkProps } from "./RouterErrorBoundary-BlJmaoyr.js";
+import { Navigator } from "@real-router/core";
+import { RouterTransitionSnapshot } from "@real-router/sources";
+export { type LinkProps, type Navigator, type RouteEnterContext, type RouteEnterHandler, type RouteExitContext, type RouteExitHandler, type MatchProps as RouteViewMatchProps, type NotFoundProps as RouteViewNotFoundProps, type RouteViewProps, type SelfProps as RouteViewSelfProps, type RouterErrorBoundaryProps, type RouterTransitionSnapshot, type UseRouteEnterOptions, type UseRouteExitOptions };