@real-router/vue 0.10.1 → 0.12.0

package/dist/esm/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":["NOOP_INSTANCE"],"sources":["../../src/components/RouteView/components.ts","../../src/components/RouteView/helpers.ts","../../src/useRefFromSource.ts","../../src/context.ts","../../src/composables/useRouter.ts","../../src/composables/useRouteNode.ts","../../src/components/RouteView/RouteView.ts","../../src/constants.ts","../../../../shared/dom-utils/route-announcer.ts","../../../../shared/dom-utils/scroll-restore.ts","../../../../shared/dom-utils/view-transitions.ts","../../../../shared/dom-utils/link-utils.ts","../../src/components/Link.ts","../../src/components/RouterErrorBoundary.ts","../../src/directives/vLink.ts","../../src/composables/useNavigator.ts","../../src/composables/useRouteUtils.ts","../../src/composables/useRoute.ts","../../src/composables/useRouterTransition.ts","../../src/composables/useRouteExit.ts","../../src/composables/useRouteEnter.ts","../../src/setupRouteProvision.ts","../../src/createRouterPlugin.ts","../../src/RouterProvider.ts"],"sourcesContent":["import { defineComponent } from \"vue\";\n\nimport type { SelfProps } from \"./types\";\nimport type { FunctionalComponent, PropType, VNode } from \"vue\";\n\nfunction renderNull() {\n  return null;\n}\n\nexport const Match = defineComponent({\n  name: \"RouteView.Match\",\n  props: {\n    segment: {\n      type: String as PropType<string>,\n      required: true,\n    },\n    exact: {\n      type: Boolean,\n      default: false,\n    },\n    fallback: {\n      type: [Object, Function] as PropType<VNode | (() => VNode)>,\n      default: undefined,\n    },\n    keepAlive: {\n      type: Boolean,\n      default: false,\n    },\n  },\n  render: renderNull,\n});\n\n// Type Self via FunctionalComponent<SelfProps> so the SelfProps interface\n// is anchored to the component contract — knip otherwise flags SelfProps\n// as unused even though it's re-exported as RouteViewSelfProps for\n// consumers wrapping Self in custom HOCs.\nconst SelfImpl = defineComponent({\n  name: \"RouteView.Self\",\n  props: {\n    fallback: {\n      type: [Object, Function] as PropType<VNode | (() => VNode)>,\n      default: undefined,\n    },\n  },\n  render: renderNull,\n});\n\nexport const Self = SelfImpl as unknown as FunctionalComponent<SelfProps>;\n\nexport const NotFound = defineComponent({\n  name: \"RouteView.NotFound\",\n  render: renderNull,\n});\n","import { UNKNOWN_ROUTE } from \"@real-router/core\";\nimport { startsWithSegment } from \"@real-router/route-utils\";\nimport { Fragment, isVNode } from \"vue\";\n\nimport { Match, NotFound, Self } from \"./components\";\n\nimport type { VNode } from \"vue\";\n\ntype FallbackType = VNode | (() => VNode) | undefined;\n\ninterface FallbackSlots {\n  selfVNode: VNode | null;\n  selfFallback: FallbackType;\n  notFoundChildren: unknown;\n}\n\nfunction isSegmentMatch(\n  routeName: string,\n  fullSegmentName: string,\n  exact: boolean,\n): boolean {\n  if (exact) {\n    return routeName === fullSegmentName;\n  }\n\n  return startsWithSegment(routeName, fullSegmentName);\n}\n\nfunction normalizeChildren(children: unknown): VNode[] {\n  if (Array.isArray(children)) {\n    const result: VNode[] = [];\n\n    for (const child of children) {\n      if (Array.isArray(child)) {\n        result.push(...normalizeChildren(child));\n      } else if (isVNode(child)) {\n        result.push(child);\n      }\n    }\n\n    return result;\n  }\n\n  if (isVNode(children)) {\n    return [children];\n  }\n\n  return [];\n}\n\nexport function collectElements(children: unknown, result: VNode[]): void {\n  const vnodes = normalizeChildren(children);\n\n  for (const child of vnodes) {\n    if (\n      child.type === Match ||\n      child.type === Self ||\n      child.type === NotFound\n    ) {\n      result.push(child);\n    } else if (child.type === Fragment) {\n      collectElements(child.children, result);\n    }\n  }\n}\n\nfunction recordFallback(child: VNode, slots: FallbackSlots): boolean {\n  if (child.type === NotFound) {\n    slots.notFoundChildren = child.children;\n\n    return true;\n  }\n\n  if (child.type === Self) {\n    if (slots.selfVNode === null) {\n      slots.selfVNode = child;\n      const props = child.props as { fallback?: FallbackType } | null;\n\n      slots.selfFallback = props?.fallback;\n    }\n\n    return true;\n  }\n\n  return false;\n}\n\nfunction evaluateMatch(\n  child: VNode,\n  routeName: string,\n  nodeName: string,\n): { isActive: boolean; fallback: FallbackType } {\n  const props = child.props as {\n    segment: string;\n    exact?: boolean;\n    fallback?: FallbackType;\n  } | null;\n  const segment = props?.segment ?? \"\";\n  const exact = props?.exact ?? false;\n  const fullSegmentName = nodeName ? `${nodeName}.${segment}` : segment;\n  const isActive = isSegmentMatch(routeName, fullSegmentName, exact);\n\n  return { isActive, fallback: props?.fallback };\n}\n\nfunction appendFallback(\n  rendered: VNode[],\n  routeName: string,\n  nodeName: string,\n  slots: FallbackSlots,\n  elements: VNode[],\n): FallbackType {\n  if (slots.selfVNode !== null && routeName === nodeName) {\n    rendered.push(slots.selfVNode);\n\n    return slots.selfFallback;\n  }\n\n  if (routeName === UNKNOWN_ROUTE && slots.notFoundChildren !== null) {\n    const nfElements = elements.filter((element) => element.type === NotFound);\n    /* v8 ignore next 3 */\n    const lastNf = nfElements.at(-1);\n\n    if (lastNf) {\n      rendered.push(lastNf);\n    }\n  }\n\n  return undefined;\n}\n\nexport function buildRenderList(\n  elements: VNode[],\n  routeName: string,\n  nodeName: string,\n): {\n  rendered: VNode[];\n  activeMatchFound: boolean;\n  fallback?: FallbackType;\n} {\n  const slots: FallbackSlots = {\n    selfVNode: null,\n    selfFallback: undefined,\n    notFoundChildren: null,\n  };\n  let activeMatchFound = false;\n  let fallback: FallbackType = undefined;\n  const rendered: VNode[] = [];\n\n  for (const child of elements) {\n    if (recordFallback(child, slots)) {\n      continue;\n    }\n\n    if (activeMatchFound) {\n      continue;\n    }\n\n    const result = evaluateMatch(child, routeName, nodeName);\n\n    if (result.isActive) {\n      activeMatchFound = true;\n      fallback = result.fallback;\n      rendered.push(child);\n    }\n  }\n\n  if (!activeMatchFound) {\n    fallback = appendFallback(rendered, routeName, nodeName, slots, elements);\n  }\n\n  return { rendered, activeMatchFound, fallback };\n}\n","import { shallowRef, onScopeDispose } from \"vue\";\n\nimport type { RouterSource } from \"@real-router/sources\";\nimport type { ShallowRef } from \"vue\";\n\nexport function useRefFromSource<T>(source: RouterSource<T>): ShallowRef<T> {\n  const ref = shallowRef(source.getSnapshot());\n\n  const unsub = source.subscribe(() => {\n    ref.value = source.getSnapshot();\n  });\n\n  onScopeDispose(unsub);\n\n  return ref;\n}\n","import type { RouteContext as RouteContextType } from \"./types\";\nimport type { Router, Navigator } from \"@real-router/core\";\nimport type { InjectionKey } from \"vue\";\n\nexport const RouterKey: InjectionKey<Router> = Symbol(\"RouterKey\");\n\nexport const NavigatorKey: InjectionKey<Navigator> = Symbol(\"NavigatorKey\");\n\nexport const RouteKey: InjectionKey<RouteContextType> = Symbol(\"RouteKey\");\n","import { inject } from \"vue\";\n\nimport { RouterKey } from \"../context\";\n\nimport type { Router } from \"@real-router/core\";\n\nexport const useRouter = (): Router => {\n  const router = inject(RouterKey);\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 { computed } from \"vue\";\n\nimport { useRefFromSource } from \"../useRefFromSource\";\nimport { useRouter } from \"./useRouter\";\n\nimport type { RouteContext } from \"../types\";\n\nexport function useRouteNode(nodeName: string): RouteContext {\n  const router = useRouter();\n\n  const source = createRouteNodeSource(router, nodeName);\n  const snapshot = useRefFromSource(source);\n\n  // getNavigator is WeakMap-cached in core; no useMemo equivalent needed.\n  const navigator = getNavigator(router);\n\n  // Derive route/previousRoute via computed instead of mirroring with a sync\n  // watch into two extra shallowRefs. computed shares snapshot's identity so\n  // when the underlying source emits the same reference (idempotent or\n  // out-of-node nav), consumers don't see a new ref.\n  const route = computed(() => snapshot.value.route);\n  const previousRoute = computed(() => snapshot.value.previousRoute);\n\n  return {\n    navigator,\n    route,\n    previousRoute,\n  };\n}\n","import {\n  Fragment,\n  defineComponent,\n  h,\n  KeepAlive,\n  markRaw,\n  Suspense,\n} from \"vue\";\n\nimport { Match, NotFound, Self } from \"./components\";\nimport { buildRenderList, collectElements } from \"./helpers\";\nimport { useRouteNode } from \"../../composables/useRouteNode\";\n\nimport type { Component, VNode } from \"vue\";\n\ntype SlotChildren = Record<string, (() => VNode[]) | undefined> | null;\n\nfunction getSlotContent(vnode: VNode): VNode[] | null {\n  const slots = vnode.children as SlotChildren;\n\n  return slots?.default?.() ?? null;\n}\n\nfunction getOrCreateWrapper(\n  cache: Map<string, Component>,\n  segment: string,\n): Component {\n  const existing = cache.get(segment);\n\n  if (existing) {\n    return existing;\n  }\n\n  const wrapper = markRaw(\n    defineComponent({\n      name: `KeepAlive-${segment}`,\n      setup(_wrapperProps, wrapperCtx) {\n        return () => wrapperCtx.slots.default?.();\n      },\n    }),\n  );\n\n  cache.set(segment, wrapper);\n\n  return wrapper;\n}\n\nfunction wrapWithSuspense(content: VNode, fallback: unknown): VNode {\n  if (fallback === undefined) {\n    return content;\n  }\n\n  const fallbackContent =\n    typeof fallback === \"function\" ? (fallback as () => VNode)() : fallback;\n\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any, @typescript-eslint/no-unsafe-assignment\n  const suspenseComponent = Suspense as any;\n\n  return h(\n    suspenseComponent,\n    {},\n    {\n      default: () => content,\n      fallback: () => fallbackContent,\n    },\n  );\n}\n\nconst emptyKeepAlivePlaceholder = markRaw(\n  defineComponent({\n    name: \"KeepAlive-placeholder\",\n    render() {\n      return null;\n    },\n  }),\n);\n\nfunction renderWithRootKA(\n  activeChild: VNode,\n  wrapperCache: Map<string, Component>,\n  fallback: unknown,\n): VNode {\n  const activeProps = activeChild.props as { segment?: string } | null;\n  const segment = activeProps?.segment ?? \"__not-found__\";\n  const WrapperComponent = getOrCreateWrapper(wrapperCache, segment);\n  const slotContent = getSlotContent(activeChild) ?? [];\n  const keepAliveContent = h(KeepAlive, null, {\n    default: () =>\n      h(WrapperComponent, { key: segment }, { default: () => slotContent }),\n  });\n\n  return wrapWithSuspense(keepAliveContent, fallback);\n}\n\n// Vue compiles boolean-shorthand template attributes (`<Match keepAlive>`) to\n// an empty string instead of `true`, and converts them to `true` only when the\n// receiving component's prop is declared with `type: Boolean`. `Match` is a\n// marker component (`render: null`) — its props are inspected on the VNode\n// without ever going through Vue's prop-casting pipeline, so the raw `\"\"` (or\n// the hyphenated attribute name) reaches us here. Accept the same trio Vue's\n// runtime does.\nfunction isKeepAliveEnabled(value: unknown): boolean {\n  return value === true || value === \"\" || value === \"keep-alive\";\n}\n\nfunction renderWithPerMatchKA(\n  activeChild: VNode,\n  wrapperCache: Map<string, Component>,\n  fallback: unknown,\n): VNode | null {\n  const matchProps = activeChild.props as {\n    segment?: string;\n    keepAlive?: unknown;\n  } | null;\n\n  if (isKeepAliveEnabled(matchProps?.keepAlive) && activeChild.type === Match) {\n    /* v8 ignore start */\n    const segment = matchProps?.segment ?? \"__not-found__\";\n    /* v8 ignore stop */\n    const WrapperComponent = getOrCreateWrapper(wrapperCache, segment);\n    const slotContent = getSlotContent(activeChild) ?? [];\n\n    return h(Fragment, [\n      h(KeepAlive, null, {\n        default: () =>\n          h(WrapperComponent, { key: segment }, { default: () => slotContent }),\n      }),\n    ]);\n  }\n\n  const content = getSlotContent(activeChild);\n\n  /* v8 ignore start */\n  if (!content) {\n    return null;\n  }\n  /* v8 ignore stop */\n\n  return h(Fragment, [\n    h(KeepAlive, null, { default: () => h(emptyKeepAlivePlaceholder) }),\n    wrapWithSuspense(h(Fragment, content), fallback),\n  ]);\n}\n\nconst RouteViewComponent = defineComponent({\n  name: \"RouteView\",\n  props: {\n    nodeName: {\n      type: String,\n      required: true,\n    },\n    keepAlive: {\n      type: Boolean,\n      default: false,\n    },\n  },\n  setup(props, { slots }) {\n    const routeContext = useRouteNode(props.nodeName);\n    const wrapperCache = new Map<string, Component>();\n\n    // Cache per-Match `keepAlive` detection by slot output identity. Slot\n    // contents change reference only when the parent re-renders with new\n    // children, so steady-state navigations skip the O(n) `.some(...)` scan.\n    let lastSlotOutput: unknown = null;\n    let lastHasPerMatchKA = false;\n\n    function detectPerMatchKA(elements: VNode[], slotOutput: unknown): boolean {\n      /* v8 ignore next 3 -- @preserve: Vue's compiled slot wrapper allocates a\n         new array per render call in JSDOM tests; identity-cache hits in\n         production where parent compiled templates share slot output, but\n         is unobservable through TestBed-style assertions. */\n      if (slotOutput === lastSlotOutput) {\n        return lastHasPerMatchKA;\n      }\n\n      lastSlotOutput = slotOutput;\n      lastHasPerMatchKA = elements.some(\n        (element) =>\n          element.type === Match &&\n          isKeepAliveEnabled(\n            (element.props as { keepAlive?: unknown } | null)?.keepAlive,\n          ),\n      );\n\n      return lastHasPerMatchKA;\n    }\n\n    return (): VNode | null => {\n      const route = routeContext.route.value;\n\n      if (!route) {\n        return null;\n      }\n\n      const slotOutput = slots.default?.();\n      const elements: VNode[] = [];\n\n      collectElements(slotOutput, elements);\n\n      const { rendered, fallback } = buildRenderList(\n        elements,\n        route.name,\n        props.nodeName,\n      );\n\n      if (rendered.length === 0) {\n        return null;\n      }\n\n      const activeChild = rendered[0];\n\n      if (props.keepAlive) {\n        return renderWithRootKA(activeChild, wrapperCache, fallback);\n      }\n\n      /* v8 ignore start */\n      if (\n        activeChild.type !== Match &&\n        activeChild.type !== Self &&\n        activeChild.type !== NotFound\n      ) {\n        return null;\n      }\n      /* v8 ignore stop */\n\n      const hasPerMatchKA = detectPerMatchKA(elements, slotOutput);\n\n      if (hasPerMatchKA) {\n        return renderWithPerMatchKA(activeChild, wrapperCache, fallback);\n      }\n\n      const content = getSlotContent(activeChild);\n\n      if (!content) {\n        return null;\n      }\n\n      return wrapWithSuspense(h(Fragment, content), fallback);\n    };\n  },\n});\n\nexport const RouteView = Object.assign(RouteViewComponent, {\n  Match,\n  Self,\n  NotFound,\n});\n\nexport type {\n  RouteViewProps,\n  MatchProps as RouteViewMatchProps,\n  SelfProps as RouteViewSelfProps,\n  NotFoundProps as RouteViewNotFoundProps,\n} from \"./types\";\n","/**\n * Stable empty object for default params\n */\nexport const EMPTY_PARAMS = Object.freeze({});\n\n/**\n * Stable empty options object\n */\nexport const EMPTY_OPTIONS = Object.freeze({});\n","import type { Router, State } from \"@real-router/core\";\n\nconst CLEAR_DELAY = 7000;\nconst SAFARI_READY_DELAY = 100;\nconst ANNOUNCER_ATTR = \"data-real-router-announcer\";\nconst INTERNAL_ROUTE_PREFIX = \"@@\";\nconst VISUALLY_HIDDEN =\n  \"position:absolute;width:1px;height:1px;padding:0;margin:-1px;overflow:hidden;clip:rect(0,0,0,0);clip-path:inset(50%);white-space:nowrap;border:0\";\n\nexport interface RouteAnnouncerOptions {\n  prefix?: string;\n  getAnnouncementText?: (route: State) => string;\n}\n\nexport function createRouteAnnouncer(\n  router: Router,\n  options?: RouteAnnouncerOptions,\n): { destroy: () => void } {\n  const prefix = options?.prefix ?? \"Navigated to \";\n  const getCustomText = options?.getAnnouncementText;\n\n  let isInitialNavigation = true;\n  let isReady = false;\n  let isDestroyed = false;\n  let lastAnnouncedText = \"\";\n  let pendingText: string | null = null;\n  let clearTimeoutId: ReturnType<typeof setTimeout> | undefined;\n\n  const announcer = getOrCreateAnnouncer();\n\n  const doAnnounce = (text: string, h1: HTMLElement | null): void => {\n    lastAnnouncedText = text;\n    clearTimeout(clearTimeoutId);\n    announcer.textContent = text;\n    clearTimeoutId = setTimeout(() => {\n      announcer.textContent = \"\";\n      lastAnnouncedText = \"\";\n    }, CLEAR_DELAY);\n\n    manageFocus(h1);\n  };\n\n  // Safari-ready delay: announcing before VoiceOver wires up the aria-live region\n  // causes the first announcement to be silently dropped. Wait SAFARI_READY_DELAY ms\n  // before marking the announcer \"ready\" — any navigation during that window is\n  // buffered in pendingText and flushed once the delay expires.\n  const safariTimeoutId = setTimeout(() => {\n    isReady = true;\n\n    if (pendingText !== null && !isDestroyed) {\n      const text = pendingText;\n\n      pendingText = null;\n      doAnnounce(text, document.querySelector<HTMLElement>(\"h1\"));\n    }\n  }, SAFARI_READY_DELAY);\n\n  const unsubscribe = router.subscribe(({ route }) => {\n    if (isInitialNavigation) {\n      isInitialNavigation = false;\n\n      return;\n    }\n\n    // Double rAF: waits for two paint frames so the incoming route's DOM\n    // (including the new <h1>) is fully rendered before resolveText reads it.\n    // Single rAF fires before the new route's template has been attached,\n    // which would cause resolveText to pick up the OLD h1 or fall back to\n    // document.title / route.name prematurely.\n    requestAnimationFrame(() => {\n      requestAnimationFrame(() => {\n        if (isDestroyed) {\n          return;\n        }\n\n        const h1 = document.querySelector<HTMLElement>(\"h1\");\n        const text = resolveText(route, prefix, getCustomText, h1);\n\n        if (!text || text === lastAnnouncedText) {\n          return;\n        }\n\n        if (!isReady) {\n          // Defer announcement until Safari-ready window elapses (see safariTimeoutId).\n          pendingText = text;\n\n          return;\n        }\n\n        doAnnounce(text, h1);\n      });\n    });\n  });\n\n  return {\n    destroy() {\n      isDestroyed = true;\n      unsubscribe();\n      clearTimeout(clearTimeoutId);\n      clearTimeout(safariTimeoutId);\n      removeAnnouncer();\n    },\n  };\n}\n\nfunction getOrCreateAnnouncer(): HTMLElement {\n  const existing = document.querySelector<HTMLElement>(`[${ANNOUNCER_ATTR}]`);\n\n  if (existing) {\n    return existing;\n  }\n\n  const element = document.createElement(\"div\");\n\n  element.setAttribute(\"style\", VISUALLY_HIDDEN);\n  element.setAttribute(\"aria-live\", \"assertive\");\n  element.setAttribute(\"aria-atomic\", \"true\");\n  element.setAttribute(ANNOUNCER_ATTR, \"\");\n\n  document.body.prepend(element);\n\n  return element;\n}\n\nfunction removeAnnouncer(): void {\n  document.querySelector(`[${ANNOUNCER_ATTR}]`)?.remove();\n}\n\nfunction resolveText(\n  route: State,\n  prefix: string,\n  getCustomText: ((route: State) => string) | undefined,\n  h1: HTMLElement | null,\n): string {\n  if (getCustomText) {\n    return getCustomText(route);\n  }\n\n  const h1Text = (h1?.textContent ?? \"\").trim();\n  const routeName = route.name.startsWith(INTERNAL_ROUTE_PREFIX)\n    ? \"\"\n    : route.name;\n  const rawText =\n    h1Text || document.title || routeName || globalThis.location.pathname;\n\n  return `${prefix}${rawText}`;\n}\n\nfunction manageFocus(h1: HTMLElement | null): void {\n  if (!h1) {\n    return;\n  }\n\n  if (!h1.hasAttribute(\"tabindex\")) {\n    h1.setAttribute(\"tabindex\", \"-1\");\n  }\n\n  h1.focus({ preventScroll: true });\n}\n","import type { Router, State } from \"@real-router/core\";\n\nconst 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\" | \"manual\";\n\nexport interface ScrollRestorationOptions {\n  mode?: ScrollRestorationMode | undefined;\n  anchorScrolling?: boolean | undefined;\n  scrollContainer?: (() => HTMLElement | null) | 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 \"manual\" = utility does nothing. Don't flip history.scrollRestoration,\n  // don't subscribe, don't register pagehide — leave the browser's native\n  // auto-restore intact for the app to override if it wants to.\n  if (mode === \"manual\") {\n    return NOOP_INSTANCE;\n  }\n\n  const anchorEnabled = options?.anchorScrolling ?? true;\n  const getContainer = options?.scrollContainer;\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.scrollTop = top;\n    } else {\n      globalThis.scrollTo(0, top);\n    }\n  };\n\n  const scrollToHashOrTop = (): void => {\n    const hash = globalThis.location.hash;\n\n    if (anchorEnabled && hash.length > 1) {\n      // location.hash is percent-encoded; ids in the DOM are the raw string.\n      // Decode for the match. Fall back to the raw slice if the hash contains\n      // a malformed escape sequence (decodeURIComponent throws on those).\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();\n\n        return;\n      }\n    }\n\n    writePos(0);\n  };\n\n  let destroyed = false;\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      putPos(keyOf(previousRoute), readPos());\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();\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        writePos(loadStore()[keyOf(route)] ?? 0);\n\n        return;\n      }\n\n      scrollToHashOrTop();\n    });\n  });\n\n  const onPageHide = (): void => {\n    const current = router.getState();\n\n    if (current) {\n      putPos(keyOf(current), readPos());\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\nfunction keyOf(state: State): string {\n  return `${state.name}:${canonicalJson(state.params)}`;\n}\n\nfunction loadStore(): Record<string, number> {\n  try {\n    const raw = sessionStorage.getItem(STORAGE_KEY);\n\n    return raw ? (JSON.parse(raw) as Record<string, number>) : {};\n  } catch {\n    return {};\n  }\n}\n\nfunction putPos(key: string, pos: number): void {\n  try {\n    const store = loadStore();\n\n    store[key] = pos;\n    sessionStorage.setItem(STORAGE_KEY, JSON.stringify(store));\n  } catch {\n    // Ignore quota / security errors.\n  }\n}\n\nfunction canonicalJson(value: unknown): string {\n  return JSON.stringify(value, canonicalReplacer);\n}\n\nfunction canonicalReplacer(_key: string, val: unknown): unknown {\n  if (val !== null && typeof val === \"object\" && !Array.isArray(val)) {\n    const sorted: 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 { Router, Params } from \"@real-router/core\";\n\nexport function shouldNavigate(evt: MouseEvent): boolean {\n  return (\n    evt.button === 0 &&\n    !evt.metaKey &&\n    !evt.altKey &&\n    !evt.ctrlKey &&\n    !evt.shiftKey\n  );\n}\n\ntype BuildUrlFn = (name: string, params: Params) => string | undefined;\n\nexport function buildHref(\n  router: Router,\n  routeName: string,\n  routeParams: Params,\n): string | undefined {\n  try {\n    const buildUrl = router.buildUrl as BuildUrlFn | undefined;\n\n    if (buildUrl) {\n      const url = buildUrl(routeName, routeParams);\n\n      if (url !== undefined) {\n        return url;\n      }\n    }\n\n    return router.buildPath(routeName, routeParams);\n  } catch {\n    console.error(\n      `[real-router] Route \"${routeName}\" is not defined. The element will render without an href attribute.`,\n    );\n\n    return undefined;\n  }\n}\n\nfunction parseTokens(value: string | undefined): string[] {\n  return value ? (value.match(/\\S+/g) ?? []) : [];\n}\n\nexport function buildActiveClassName(\n  isActive: boolean,\n  activeClassName: string | undefined,\n  baseClassName: string | undefined,\n): string | undefined {\n  if (isActive && activeClassName) {\n    const activeTokens = parseTokens(activeClassName);\n\n    if (activeTokens.length === 0) {\n      return baseClassName ?? undefined;\n    }\n    if (!baseClassName) {\n      return activeTokens.join(\" \");\n    }\n\n    const baseTokens = parseTokens(baseClassName);\n    const seen = new Set(baseTokens);\n\n    for (const token of activeTokens) {\n      if (!seen.has(token)) {\n        seen.add(token);\n        baseTokens.push(token);\n      }\n    }\n\n    return baseTokens.join(\" \");\n  }\n\n  return baseClassName ?? undefined;\n}\n\nexport function shallowEqual(\n  prev: object | undefined,\n  next: object | undefined,\n): boolean {\n  if (Object.is(prev, next)) {\n    return true;\n  }\n  if (!prev || !next) {\n    return false;\n  }\n\n  const prevKeys = Object.keys(prev);\n\n  if (prevKeys.length !== Object.keys(next).length) {\n    return false;\n  }\n\n  const prevRecord = prev as Record<string, unknown>;\n  const nextRecord = next as Record<string, unknown>;\n\n  for (const key of prevKeys) {\n    if (!Object.is(prevRecord[key], nextRecord[key])) {\n      return false;\n    }\n  }\n\n  return true;\n}\n\nexport function applyLinkA11y(element: HTMLElement | null | undefined): void {\n  if (!element) {\n    return;\n  }\n  if (\n    element instanceof HTMLAnchorElement ||\n    element instanceof HTMLButtonElement\n  ) {\n    return;\n  }\n  if (!element.hasAttribute(\"role\")) {\n    element.setAttribute(\"role\", \"link\");\n  }\n  if (!element.hasAttribute(\"tabindex\")) {\n    element.setAttribute(\"tabindex\", \"0\");\n  }\n}\n","import { createActiveRouteSource } from \"@real-router/sources\";\nimport { defineComponent, h, computed, shallowRef, watch } from \"vue\";\n\nimport { useRouter } from \"../composables/useRouter\";\nimport { EMPTY_PARAMS, EMPTY_OPTIONS } from \"../constants\";\nimport { shouldNavigate, buildHref, buildActiveClassName } from \"../dom-utils\";\n\nimport type { Params, NavigationOptions } from \"@real-router/core\";\nimport type { PropType } from \"vue\";\n\ntype OnClickHandler = (evt: MouseEvent) => void;\n\n/**\n * Vue's compiled template binds multiple `@click` handlers as an array.\n * Single render-function `onClick` is a function. Both must be invoked.\n */\nfunction invokeAttributesOnClick(value: unknown, evt: MouseEvent): void {\n  if (typeof value === \"function\") {\n    (value as OnClickHandler)(evt);\n\n    return;\n  }\n  if (Array.isArray(value)) {\n    const handlers = value as OnClickHandler[];\n\n    for (const fn of handlers) {\n      if (typeof fn === \"function\") {\n        fn(evt);\n\n        if (evt.defaultPrevented) {\n          return;\n        }\n      }\n    }\n  }\n}\n\nexport const Link = defineComponent({\n  name: \"Link\",\n  // Disable Vue's automatic attribute fallthrough. Without this, attrs.onClick\n  // (function OR array) is auto-attached as a native click listener AND our\n  // explicit onClick fires too — user handlers are double-invoked. We invoke\n  // attrs.onClick manually inside handleClick to preserve preventDefault.\n  inheritAttrs: false,\n  props: {\n    routeName: {\n      type: String,\n      required: true,\n    },\n    routeParams: {\n      type: Object as PropType<Params>,\n      default: () => EMPTY_PARAMS,\n    },\n    routeOptions: {\n      type: Object as PropType<NavigationOptions>,\n      default: () => EMPTY_OPTIONS,\n    },\n    class: {\n      type: String,\n      default: undefined,\n    },\n    activeClassName: {\n      type: String,\n      default: \"active\",\n    },\n    activeStrict: {\n      type: Boolean,\n      default: false,\n    },\n    ignoreQueryParams: {\n      type: Boolean,\n      default: true,\n    },\n    target: {\n      type: String,\n      default: undefined,\n    },\n  },\n  setup(props, { slots, attrs }) {\n    const router = useRouter();\n\n    const isActive = shallowRef(false);\n\n    // watch with an explicit dep getter recreates the source ONLY when\n    // routeName/routeParams/strict/ignoreQueryParams change — not on every\n    // reactive read inside the source factory (the watchEffect alternative\n    // would also re-subscribe whenever isActive itself changed).\n    watch(\n      () =>\n        [\n          props.routeName,\n          props.routeParams,\n          props.activeStrict,\n          props.ignoreQueryParams,\n        ] as const,\n      (\n        [routeName, routeParams, activeStrict, ignoreQueryParams],\n        _prev,\n        onCleanup,\n      ) => {\n        const source = createActiveRouteSource(router, routeName, routeParams, {\n          strict: activeStrict,\n          ignoreQueryParams,\n        });\n\n        isActive.value = source.getSnapshot();\n\n        const unsub = source.subscribe(() => {\n          isActive.value = source.getSnapshot();\n        });\n\n        onCleanup(unsub);\n      },\n      { immediate: true, flush: \"sync\" },\n    );\n\n    const href = computed(() =>\n      buildHref(router, props.routeName, props.routeParams),\n    );\n\n    const finalClassName = computed(() =>\n      buildActiveClassName(isActive.value, props.activeClassName, props.class),\n    );\n\n    const handleClick = (evt: MouseEvent) => {\n      // Vue allows attrs.onClick to be a function or an array of functions\n      // (compiled templates with multiple @click bindings produce arrays).\n      // Both must be invoked; treating arrays as \"no handler\" silently drops\n      // user code.\n      if (attrs.onClick !== undefined && attrs.onClick !== null) {\n        invokeAttributesOnClick(attrs.onClick, evt);\n\n        if (evt.defaultPrevented) {\n          return;\n        }\n      }\n\n      if (!shouldNavigate(evt) || props.target === \"_blank\") {\n        return;\n      }\n\n      evt.preventDefault();\n      router\n        .navigate(props.routeName, props.routeParams, props.routeOptions)\n        .catch(() => {});\n    };\n\n    return () => {\n      // Build forwarded attrs without `onClick`. Vue's runtime auto-attaches\n      // attrs.onClick (function OR array) as a native DOM listener, which would\n      // double-invoke user handlers when combined with our explicit `onClick`.\n      // We invoke the original attrs.onClick manually inside handleClick so the\n      // preventDefault contract is preserved.\n      const restAttributes: Record<string, unknown> = {};\n\n      for (const key of Object.keys(attrs)) {\n        if (key !== \"onClick\") {\n          restAttributes[key] = (attrs as Record<string, unknown>)[key];\n        }\n      }\n\n      return h(\n        \"a\",\n        {\n          ...restAttributes,\n          href: href.value,\n          class: finalClassName.value,\n          target: props.target,\n          onClick: handleClick,\n        },\n        slots.default?.(),\n      );\n    };\n  },\n});\n","import { createDismissableError } from \"@real-router/sources\";\nimport { defineComponent, h, watch, Fragment } from \"vue\";\n\nimport { useRouter } from \"../composables/useRouter\";\nimport { useRefFromSource } from \"../useRefFromSource\";\n\nimport type { RouterError, State } from \"@real-router/core\";\nimport type { VNode, PropType } from \"vue\";\n\nexport const RouterErrorBoundary = defineComponent({\n  name: \"RouterErrorBoundary\",\n  props: {\n    fallback: {\n      type: Function as PropType<\n        (error: RouterError, resetError: () => void) => VNode\n      >,\n      required: true,\n    },\n    onError: {\n      type: Function as PropType<\n        (\n          error: RouterError,\n          toRoute: State | null,\n          fromRoute: State | null,\n        ) => void\n      >,\n      default: undefined,\n    },\n  },\n  setup(props, { slots }) {\n    const router = useRouter();\n    const snapshot = useRefFromSource(createDismissableError(router));\n\n    watch(\n      () => snapshot.value.version,\n      () => {\n        if (snapshot.value.error) {\n          props.onError?.(\n            snapshot.value.error,\n            snapshot.value.toRoute,\n            snapshot.value.fromRoute,\n          );\n        }\n      },\n      { immediate: true },\n    );\n\n    return () => {\n      const children = slots.default?.() ?? [];\n      const errorVNode = snapshot.value.error\n        ? props.fallback(snapshot.value.error, snapshot.value.resetError)\n        : null;\n\n      return h(Fragment, null, [...children, errorVNode]);\n    };\n  },\n});\n\nexport type RouterErrorBoundaryProps = InstanceType<\n  typeof RouterErrorBoundary\n>[\"$props\"];\n","import { shouldNavigate, applyLinkA11y } from \"../dom-utils\";\n\nimport type { Router, NavigationOptions, Params } from \"@real-router/core\";\nimport type { Directive } from \"vue\";\n\nexport interface LinkDirectiveValue {\n  name: string;\n  params?: Params;\n  options?: NavigationOptions;\n}\n\n/**\n * Router stack for nested RouterProviders. The active router is the top of\n * the stack. RouterProvider pushes its router on mount and pops it on unmount,\n * which preserves the parent context when an inner provider tears down.\n *\n * Without the stack, an unmounted child provider would leave the directive\n * pointing at a disposed router, and v-link in the still-mounted parent would\n * navigate via the wrong (or torn-down) instance.\n */\nconst routerStack: Router[] = [];\n\n/**\n * Pushes a router onto the active stack. Returns a release function that\n * removes that exact router from the stack regardless of position — safe\n * across out-of-order provider unmount sequences.\n *\n * @internal Used by RouterProvider during setup/teardown.\n */\nexport function pushDirectiveRouter(router: Router): () => void {\n  routerStack.push(router);\n\n  return () => {\n    const idx = routerStack.lastIndexOf(router);\n\n    if (idx !== -1) {\n      routerStack.splice(idx, 1);\n    }\n  };\n}\n\n/**\n * Backwards-compatible alias. Replaces the active router unconditionally and\n * does NOT participate in the stack — use {@link pushDirectiveRouter} from\n * provider code instead. Kept for tests and direct callers.\n */\nexport function setDirectiveRouter(router: Router | null): void {\n  if (router === null) {\n    routerStack.length = 0;\n\n    return;\n  }\n  if (routerStack.length === 0) {\n    routerStack.push(router);\n\n    return;\n  }\n\n  routerStack[routerStack.length - 1] = router;\n}\n\nexport function getDirectiveRouter(): Router {\n  const top = routerStack.at(-1);\n\n  if (!top) {\n    throw new Error(\n      \"v-link directive requires a RouterProvider ancestor. Make sure RouterProvider is mounted.\",\n    );\n  }\n\n  return top;\n}\n\ninterface Handlers {\n  click: (evt: MouseEvent) => void;\n  keydown: (evt: KeyboardEvent) => void;\n}\n\n// Single WeakMap halves per-element bookkeeping vs two parallel maps.\nconst handlers = new WeakMap<HTMLElement, Handlers>();\n\n/**\n * Validates a directive binding value before attaching handlers.\n * Returns false (and warns once per call) when the value is missing or\n * has no `name` — silently doing nothing is preferable to a runtime crash\n * inside a click handler.\n */\nfunction isValidBinding(value: unknown): value is LinkDirectiveValue {\n  if (value === null || value === undefined) {\n    console.error(\n      \"[real-router] v-link directive received null/undefined value. The element will not be wired for navigation.\",\n    );\n\n    return false;\n  }\n  if (typeof (value as { name?: unknown }).name !== \"string\") {\n    console.error(\n      \"[real-router] v-link directive value is missing a string `name` field. The element will not be wired for navigation.\",\n    );\n\n    return false;\n  }\n\n  return true;\n}\n\nfunction createClickHandler(\n  router: Router,\n  value: LinkDirectiveValue,\n): (evt: MouseEvent) => void {\n  return (evt: MouseEvent) => {\n    if (!shouldNavigate(evt)) {\n      return;\n    }\n\n    evt.preventDefault();\n    router\n      .navigate(value.name, value.params ?? {}, value.options ?? {})\n      .catch(() => {});\n  };\n}\n\nfunction createKeydownHandler(\n  router: Router,\n  value: LinkDirectiveValue,\n  element: HTMLElement,\n): (evt: KeyboardEvent) => void {\n  return (evt: KeyboardEvent) => {\n    if (evt.key === \"Enter\" && !(element instanceof HTMLButtonElement)) {\n      router\n        .navigate(value.name, value.params ?? {}, value.options ?? {})\n        .catch(() => {});\n    }\n  };\n}\n\nfunction attachHandlers(\n  element: HTMLElement,\n  router: Router,\n  value: LinkDirectiveValue,\n): void {\n  const click = createClickHandler(router, value);\n  const keydown = createKeydownHandler(router, value, element);\n\n  element.addEventListener(\"click\", click);\n  element.addEventListener(\"keydown\", keydown);\n\n  handlers.set(element, { click, keydown });\n}\n\nfunction detachHandlers(element: HTMLElement): void {\n  const entry = handlers.get(element);\n\n  if (entry) {\n    element.removeEventListener(\"click\", entry.click);\n    element.removeEventListener(\"keydown\", entry.keydown);\n    handlers.delete(element);\n  }\n}\n\nexport const vLink: Directive<HTMLElement, LinkDirectiveValue> = {\n  mounted(element, binding) {\n    const router = getDirectiveRouter();\n\n    applyLinkA11y(element);\n\n    element.style.cursor = \"pointer\";\n\n    if (!isValidBinding(binding.value)) {\n      return;\n    }\n\n    attachHandlers(element, router, binding.value);\n  },\n\n  updated(element, binding) {\n    const router = getDirectiveRouter();\n\n    detachHandlers(element);\n\n    if (!isValidBinding(binding.value)) {\n      return;\n    }\n\n    attachHandlers(element, router, binding.value);\n  },\n\n  beforeUnmount(element) {\n    detachHandlers(element);\n  },\n};\n","import { inject } from \"vue\";\n\nimport { NavigatorKey } from \"../context\";\n\nimport type { Navigator } from \"@real-router/core\";\n\nexport const useNavigator = (): Navigator => {\n  const navigator = inject(NavigatorKey);\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\nexport const useRouteUtils = (): RouteUtils => {\n  const router = useRouter();\n\n  return getRouteUtils(getPluginApi(router).getTree());\n};\n","import { inject } from \"vue\";\n\nimport { RouteKey } from \"../context\";\n\nimport type { RouteContext } from \"../types\";\nimport type { Params, State } from \"@real-router/core\";\nimport type { Ref } from \"vue\";\n\nexport const useRoute = <P extends Params = Params>(): Omit<\n  RouteContext<P>,\n  \"route\"\n> & { route: Readonly<Ref<State<P>>> } => {\n  const routeContext = inject(RouteKey);\n\n  if (!routeContext) {\n    throw new Error(\"useRoute must be used within a RouterProvider\");\n  }\n\n  if (!routeContext.route.value) {\n    throw new Error(\n      \"useRoute called with no active route. Did you forget to await router.start() before rendering, or is the router stopped/disposed?\",\n    );\n  }\n\n  return routeContext as Omit<RouteContext<P>, \"route\"> & {\n    route: Readonly<Ref<State<P>>>;\n  };\n};\n","import { getTransitionSource } from \"@real-router/sources\";\n\nimport { useRefFromSource } from \"../useRefFromSource\";\nimport { useRouter } from \"./useRouter\";\n\nimport type { RouterTransitionSnapshot } from \"@real-router/sources\";\nimport type { ShallowRef } from \"vue\";\n\nexport function useRouterTransition(): ShallowRef<RouterTransitionSnapshot> {\n  const router = useRouter();\n  const source = getTransitionSource(router);\n\n  return useRefFromSource(source);\n}\n","import { onScopeDispose } from \"vue\";\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.\n *   - **Same-route skip**: by default, `route.name === nextRoute.name`\n *     short-circuits the handler — query-only navigations skip the work.\n *     Opt out with `skipSameRoute: false`.\n *\n * Cleanup is bound to the component's effect scope via `onScopeDispose`.\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`.\n *\n * **Handler reactivity (Vue):** Vue composables run **once** during\n * `setup()`; `handler` is captured in closure at the call site. To vary\n * behavior over time, read refs/computeds inside the handler body — do\n * not rely on swapping the handler reference.\n *\n * @example Animation\n * ```ts\n * const ref = useTemplateRef<HTMLDivElement>(\"box\");\n *\n * useRouteExit(async ({ signal }) => {\n *   const el = ref.value;\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();\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 * ```ts\n * useRouteExit(async ({ signal }) => {\n *   if (formState.value.dirty) {\n *     await api.saveDraft(formState.value, { signal });\n *   }\n * });\n * ```\n *\n * @example Reading rich transition metadata via `nextRoute.transition`\n * ```ts\n * useRouteExit(({ route, nextRoute }) => {\n *   if (nextRoute.transition.segments.deactivated.includes(\"products\")) {\n *     productCache.clear();\n *   }\n *   if (nextRoute.transition.redirected) return;\n * });\n * ```\n */\nexport function useRouteExit(\n  handler: RouteExitHandler,\n  options?: UseRouteExitOptions,\n): void {\n  const router = useRouter();\n  const skipSameRoute = options?.skipSameRoute ?? true;\n\n  const off = router.subscribeLeave(({ route, nextRoute, signal }) => {\n    if (skipSameRoute && route.name === nextRoute.name) {\n      return;\n    }\n\n    if (signal.aborted) {\n      return;\n    }\n\n    return handler({ route, nextRoute, signal });\n  });\n\n  onScopeDispose(off);\n}\n","import { watch } from \"vue\";\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 composable covers that an ad-hoc `watch` + `useRoute()`\n * doesn't:\n *\n *   - **Skip-initial**: `watch` (with default `immediate: false`) plus the\n *     explicit `route.transition.from` guard ensures the handler doesn't\n *     fire on the very first state committed by `router.start()`.\n *   - **Same-route skip** (default): handler is skipped when\n *     `route.transition.from === route.name`. Sort/filter/query-only\n *     navigations re-trigger the watcher, but they are not \"entries\" in\n *     the animation / analytics sense. Opt out with\n *     `skipSameRoute: false`.\n *   - **Mount-time `route` / `previousRoute` snapshot**: handler receives\n *     the values that were live at the moment of the new state, not the\n *     latest ones (which may have moved on if the user navigated again\n *     before the watcher drained).\n *\n * **Handler reactivity (Vue):** Vue composables run **once** during\n * `setup()`; `handler` is captured in closure at the call site. To vary\n * behavior over time, read refs/computeds inside the handler body.\n *\n * @example Direction-aware entry animation\n * ```ts\n * useRouteEnter(({ route }) => {\n *   const direction = route.context.browser?.direction;\n *   ref.value?.classList.add(\n *     direction === \"back\" ? \"slide-from-left\" : \"slide-from-right\",\n *   );\n * });\n * ```\n *\n * @example Analytics page-enter event (skip-initial built-in)\n * ```ts\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 * ```ts\n * useRouteEnter(({ route }) => {\n *   if (route.transition.redirected) {\n *     showToast(`Redirected from ${route.transition.from}`);\n *   }\n * });\n * ```\n */\nexport function useRouteEnter(\n  handler: RouteEnterHandler,\n  options?: UseRouteEnterOptions,\n): void {\n  const { route, previousRoute } = useRoute();\n  const skipSameRoute = options?.skipSameRoute ?? true;\n  let lastHandledRoute: State | null = null;\n\n  watch(route, (newRoute) => {\n    const prev = previousRoute.value;\n\n    // Early-exit guards, top-down:\n    //\n    //   - **Skip-initial**: `!transition.from` catches the first commit\n    //     from `router.start()`. Vue's `watch` (default `immediate: false`)\n    //     does not fire on the initial state — kept for parity with\n    //     React/Preact and v8-ignored.\n    //   - **Skip-same-route**: query-only navigations have\n    //     `transition.from === route.name`. Opt-out via\n    //     `skipSameRoute: false`.\n    //   - **Defensive dedupe + missing `previousRoute`**: same `route`\n    //     ref between watcher activations is unexpected on Vue (driven\n    //     off ref identity); `!prev` is unreachable once\n    //     `transition.from` is set (core populates them together). Both\n    //     kept for parity with React; v8-ignored.\n    /* v8 ignore start */\n    if (!newRoute.transition.from) {\n      return;\n    }\n    /* v8 ignore stop */\n    if (skipSameRoute && newRoute.transition.from === newRoute.name) {\n      return;\n    }\n    /* v8 ignore start */\n    if (lastHandledRoute === newRoute || !prev) {\n      return;\n    }\n    /* v8 ignore stop */\n\n    lastHandledRoute = newRoute;\n    handler({ route: newRoute, previousRoute: prev });\n  });\n}\n","// packages/vue/src/setupRouteProvision.ts\n\nimport { getNavigator } from \"@real-router/core\";\nimport { createRouteSource } from \"@real-router/sources\";\nimport { shallowRef } from \"vue\";\n\nimport type { Router, Navigator, State } from \"@real-router/core\";\nimport type { ShallowRef } from \"vue\";\n\n/**\n * Shared setup for `RouterProvider` (component-scoped) and\n * `createRouterPlugin` (app-scoped). Builds the reactive route refs +\n * subscription bookkeeping in one place; callers wire the result into their\n * provide/inject mechanism and own teardown lifecycle.\n *\n * @internal\n */\nexport interface RouteProvision {\n  navigator: Navigator;\n  route: ShallowRef<State | undefined>;\n  previousRoute: ShallowRef<State | undefined>;\n  /** Call when the owning scope tears down to release the router subscription. */\n  unsubscribe: () => void;\n}\n\nexport function setupRouteProvision(router: Router): RouteProvision {\n  const navigator = getNavigator(router);\n  const source = createRouteSource(router);\n  const initial = source.getSnapshot();\n\n  const route = shallowRef<State | undefined>(initial.route);\n  const previousRoute = shallowRef<State | undefined>(initial.previousRoute);\n\n  const unsubscribe = source.subscribe(() => {\n    const snapshot = source.getSnapshot();\n\n    route.value = snapshot.route;\n    previousRoute.value = snapshot.previousRoute;\n  });\n\n  return { navigator, route, previousRoute, unsubscribe };\n}\n","import { NavigatorKey, RouteKey, RouterKey } from \"./context\";\nimport { pushDirectiveRouter } from \"./directives/vLink\";\nimport { setupRouteProvision } from \"./setupRouteProvision\";\n\nimport type { Router } from \"@real-router/core\";\nimport type { App, Plugin } from \"vue\";\n\nexport function createRouterPlugin(router: Router): Plugin<[]> {\n  return {\n    install(app): void {\n      const releaseDirective = pushDirectiveRouter(router);\n\n      const { navigator, route, previousRoute, unsubscribe } =\n        setupRouteProvision(router);\n\n      // Vue 3.5+ exposes app.onUnmount for plugin cleanup.\n      // On older versions (3.3–3.4), the subscription is cleaned up\n      // when the router is garbage-collected (same as vue-router).\n      if (\"onUnmount\" in app) {\n        (app as App & { onUnmount: (fn: () => void) => void }).onUnmount(() => {\n          releaseDirective();\n          unsubscribe();\n        });\n      }\n\n      app.provide(RouterKey, router);\n      app.provide(NavigatorKey, navigator);\n      app.provide(RouteKey, { navigator, route, previousRoute });\n    },\n  };\n}\n","import { defineComponent, onScopeDispose, provide, watch } from \"vue\";\n\nimport { NavigatorKey, RouteKey, RouterKey } from \"./context\";\nimport { pushDirectiveRouter } from \"./directives/vLink\";\nimport {\n  createRouteAnnouncer,\n  createScrollRestoration,\n  createViewTransitions,\n} from \"./dom-utils\";\nimport { setupRouteProvision } from \"./setupRouteProvision\";\n\nimport type { ScrollRestorationOptions } from \"./dom-utils\";\nimport type { Router } from \"@real-router/core\";\nimport type { PropType } from \"vue\";\n\nexport const RouterProvider = defineComponent({\n  name: \"RouterProvider\",\n  props: {\n    router: {\n      type: Object as PropType<Router>,\n      required: true,\n    },\n    announceNavigation: {\n      type: Boolean,\n      default: false,\n    },\n    scrollRestoration: {\n      type: Object as PropType<ScrollRestorationOptions>,\n    },\n    viewTransitions: {\n      type: Boolean,\n      default: false,\n    },\n  },\n  setup(props, { slots }) {\n    // Reactive announceNavigation: setting prop true/false at runtime now\n    // creates/destroys the announcer accordingly. Prior implementation read\n    // the prop only inside onMounted, so toggling it post-mount silently no-op'd.\n    watch(\n      () => [props.router, props.announceNavigation] as const,\n      ([router, enabled], _prev, onCleanup) => {\n        if (!enabled) {\n          return;\n        }\n\n        const announcer = createRouteAnnouncer(router);\n\n        onCleanup(() => {\n          announcer.destroy();\n        });\n      },\n      { immediate: true },\n    );\n\n    // Watch by primitives so inline `{ mode: \"restore\" }` doesn't thrash.\n    // scrollContainer is a getter invoked lazily on every event inside the\n    // utility — swapping its reference doesn't change the resolved element,\n    // so we intentionally omit it from watched sources.\n    watch(\n      () =>\n        [\n          props.router,\n          props.scrollRestoration !== undefined,\n          props.scrollRestoration?.mode,\n          props.scrollRestoration?.anchorScrolling,\n        ] as const,\n      ([router, enabled, mode, anchorScrolling], _prev, onCleanup) => {\n        if (!enabled) {\n          return;\n        }\n\n        const sr = createScrollRestoration(router, {\n          mode,\n          anchorScrolling,\n          scrollContainer: props.scrollRestoration?.scrollContainer,\n        });\n\n        onCleanup(() => {\n          sr.destroy();\n        });\n      },\n      { immediate: true },\n    );\n\n    // Reactive viewTransitions: toggling prop creates/destroys the utility.\n    watch(\n      () => [props.router, props.viewTransitions] as const,\n      ([router, enabled], _prev, onCleanup) => {\n        if (!enabled) {\n          return;\n        }\n\n        const vt = createViewTransitions(router);\n\n        onCleanup(() => {\n          vt.destroy();\n        });\n      },\n      { immediate: true },\n    );\n\n    // Push this provider's router on the v-link directive stack so nested\n    // RouterProviders behave like nested DI scopes (LIFO). Release on unmount\n    // restores the outer router for any v-link still mounted in the parent.\n    const releaseDirective = pushDirectiveRouter(props.router);\n\n    const { navigator, route, previousRoute, unsubscribe } =\n      setupRouteProvision(props.router);\n\n    onScopeDispose(() => {\n      releaseDirective();\n      unsubscribe();\n    });\n\n    provide(RouterKey, props.router);\n    provide(NavigatorKey, navigator);\n    provide(RouteKey, { navigator, route, previousRoute });\n\n    return () => slots.default?.();\n  },\n});\n"],"mappings":"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"}
+{"version":3,"file":"index.mjs","names":["NOOP_INSTANCE"],"sources":["../../src/components/RouteView/components.ts","../../src/components/RouteView/helpers.ts","../../src/useRefFromSource.ts","../../src/context.ts","../../src/composables/useRouter.ts","../../src/composables/useRouteNode.ts","../../src/components/RouteView/RouteView.ts","../../src/constants.ts","../../../../shared/dom-utils/route-announcer.ts","../../../../shared/dom-utils/scroll-restore.ts","../../../../shared/dom-utils/view-transitions.ts","../../../../shared/dom-utils/link-utils.ts","../../src/components/Link.ts","../../src/components/RouterErrorBoundary.ts","../../src/directives/vLink.ts","../../src/composables/useNavigator.ts","../../src/composables/useRouteUtils.ts","../../src/composables/useRoute.ts","../../src/composables/useRouterTransition.ts","../../src/composables/useRouteExit.ts","../../src/composables/useRouteEnter.ts","../../src/setupRouteProvision.ts","../../src/createRouterPlugin.ts","../../src/RouterProvider.ts"],"sourcesContent":["import { defineComponent } from \"vue\";\n\nimport type { SelfProps } from \"./types\";\nimport type { FunctionalComponent, PropType, VNode } from \"vue\";\n\nfunction renderNull() {\n  return null;\n}\n\nexport const Match = defineComponent({\n  name: \"RouteView.Match\",\n  props: {\n    segment: {\n      type: String as PropType<string>,\n      required: true,\n    },\n    exact: {\n      type: Boolean,\n      default: false,\n    },\n    fallback: {\n      type: [Object, Function] as PropType<VNode | (() => VNode)>,\n      default: undefined,\n    },\n    keepAlive: {\n      type: Boolean,\n      default: false,\n    },\n  },\n  render: renderNull,\n});\n\n// Type Self via FunctionalComponent<SelfProps> so the SelfProps interface\n// is anchored to the component contract — knip otherwise flags SelfProps\n// as unused even though it's re-exported as RouteViewSelfProps for\n// consumers wrapping Self in custom HOCs.\nconst SelfImpl = defineComponent({\n  name: \"RouteView.Self\",\n  props: {\n    fallback: {\n      type: [Object, Function] as PropType<VNode | (() => VNode)>,\n      default: undefined,\n    },\n  },\n  render: renderNull,\n});\n\nexport const Self = SelfImpl as unknown as FunctionalComponent<SelfProps>;\n\nexport const NotFound = defineComponent({\n  name: \"RouteView.NotFound\",\n  render: renderNull,\n});\n","import { UNKNOWN_ROUTE } from \"@real-router/core\";\nimport { startsWithSegment } from \"@real-router/route-utils\";\nimport { Fragment, isVNode } from \"vue\";\n\nimport { Match, NotFound, Self } from \"./components\";\n\nimport type { VNode } from \"vue\";\n\ntype FallbackType = VNode | (() => VNode) | undefined;\n\ninterface FallbackSlots {\n  selfVNode: VNode | null;\n  selfFallback: FallbackType;\n  notFoundChildren: unknown;\n}\n\nfunction isSegmentMatch(\n  routeName: string,\n  fullSegmentName: string,\n  exact: boolean,\n): boolean {\n  if (exact) {\n    return routeName === fullSegmentName;\n  }\n\n  return startsWithSegment(routeName, fullSegmentName);\n}\n\nfunction normalizeChildren(children: unknown): VNode[] {\n  if (Array.isArray(children)) {\n    const result: VNode[] = [];\n\n    for (const child of children) {\n      if (Array.isArray(child)) {\n        result.push(...normalizeChildren(child));\n      } else if (isVNode(child)) {\n        result.push(child);\n      }\n    }\n\n    return result;\n  }\n\n  if (isVNode(children)) {\n    return [children];\n  }\n\n  return [];\n}\n\nexport function collectElements(children: unknown, result: VNode[]): void {\n  const vnodes = normalizeChildren(children);\n\n  for (const child of vnodes) {\n    if (\n      child.type === Match ||\n      child.type === Self ||\n      child.type === NotFound\n    ) {\n      result.push(child);\n    } else if (child.type === Fragment) {\n      collectElements(child.children, result);\n    }\n  }\n}\n\nfunction recordFallback(child: VNode, slots: FallbackSlots): boolean {\n  if (child.type === NotFound) {\n    slots.notFoundChildren = child.children;\n\n    return true;\n  }\n\n  if (child.type === Self) {\n    if (slots.selfVNode === null) {\n      slots.selfVNode = child;\n      const props = child.props as { fallback?: FallbackType } | null;\n\n      slots.selfFallback = props?.fallback;\n    }\n\n    return true;\n  }\n\n  return false;\n}\n\nfunction evaluateMatch(\n  child: VNode,\n  routeName: string,\n  nodeName: string,\n): { isActive: boolean; fallback: FallbackType } {\n  const props = child.props as {\n    segment: string;\n    exact?: boolean;\n    fallback?: FallbackType;\n  } | null;\n  const segment = props?.segment ?? \"\";\n  const exact = props?.exact ?? false;\n  const fullSegmentName = nodeName ? `${nodeName}.${segment}` : segment;\n  const isActive = isSegmentMatch(routeName, fullSegmentName, exact);\n\n  return { isActive, fallback: props?.fallback };\n}\n\nfunction appendFallback(\n  rendered: VNode[],\n  routeName: string,\n  nodeName: string,\n  slots: FallbackSlots,\n  elements: VNode[],\n): FallbackType {\n  if (slots.selfVNode !== null && routeName === nodeName) {\n    rendered.push(slots.selfVNode);\n\n    return slots.selfFallback;\n  }\n\n  if (routeName === UNKNOWN_ROUTE && slots.notFoundChildren !== null) {\n    const nfElements = elements.filter((element) => element.type === NotFound);\n    /* v8 ignore next 3 */\n    const lastNf = nfElements.at(-1);\n\n    if (lastNf) {\n      rendered.push(lastNf);\n    }\n  }\n\n  return undefined;\n}\n\nexport function buildRenderList(\n  elements: VNode[],\n  routeName: string,\n  nodeName: string,\n): {\n  rendered: VNode[];\n  activeMatchFound: boolean;\n  fallback?: FallbackType;\n} {\n  const slots: FallbackSlots = {\n    selfVNode: null,\n    selfFallback: undefined,\n    notFoundChildren: null,\n  };\n  let activeMatchFound = false;\n  let fallback: FallbackType = undefined;\n  const rendered: VNode[] = [];\n\n  for (const child of elements) {\n    if (recordFallback(child, slots)) {\n      continue;\n    }\n\n    if (activeMatchFound) {\n      continue;\n    }\n\n    const result = evaluateMatch(child, routeName, nodeName);\n\n    if (result.isActive) {\n      activeMatchFound = true;\n      fallback = result.fallback;\n      rendered.push(child);\n    }\n  }\n\n  if (!activeMatchFound) {\n    fallback = appendFallback(rendered, routeName, nodeName, slots, elements);\n  }\n\n  return { rendered, activeMatchFound, fallback };\n}\n","import { shallowRef, onScopeDispose } from \"vue\";\n\nimport type { RouterSource } from \"@real-router/sources\";\nimport type { ShallowRef } from \"vue\";\n\nexport function useRefFromSource<T>(source: RouterSource<T>): ShallowRef<T> {\n  const ref = shallowRef(source.getSnapshot());\n\n  const unsub = source.subscribe(() => {\n    ref.value = source.getSnapshot();\n  });\n\n  onScopeDispose(unsub);\n\n  return ref;\n}\n","import type { RouteContext as RouteContextType } from \"./types\";\nimport type { Router, Navigator } from \"@real-router/core\";\nimport type { InjectionKey } from \"vue\";\n\nexport const RouterKey: InjectionKey<Router> = Symbol(\"RouterKey\");\n\nexport const NavigatorKey: InjectionKey<Navigator> = Symbol(\"NavigatorKey\");\n\nexport const RouteKey: InjectionKey<RouteContextType> = Symbol(\"RouteKey\");\n","import { inject } from \"vue\";\n\nimport { RouterKey } from \"../context\";\n\nimport type { Router } from \"@real-router/core\";\n\nexport const useRouter = (): Router => {\n  const router = inject(RouterKey);\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 { computed } from \"vue\";\n\nimport { useRefFromSource } from \"../useRefFromSource\";\nimport { useRouter } from \"./useRouter\";\n\nimport type { RouteContext } from \"../types\";\n\nexport function useRouteNode(nodeName: string): RouteContext {\n  const router = useRouter();\n\n  const source = createRouteNodeSource(router, nodeName);\n  const snapshot = useRefFromSource(source);\n\n  // getNavigator is WeakMap-cached in core; no useMemo equivalent needed.\n  const navigator = getNavigator(router);\n\n  // Derive route/previousRoute via computed instead of mirroring with a sync\n  // watch into two extra shallowRefs. computed shares snapshot's identity so\n  // when the underlying source emits the same reference (idempotent or\n  // out-of-node nav), consumers don't see a new ref.\n  const route = computed(() => snapshot.value.route);\n  const previousRoute = computed(() => snapshot.value.previousRoute);\n\n  return {\n    navigator,\n    route,\n    previousRoute,\n  };\n}\n","import {\n  Fragment,\n  defineComponent,\n  h,\n  KeepAlive,\n  markRaw,\n  Suspense,\n} from \"vue\";\n\nimport { Match, NotFound, Self } from \"./components\";\nimport { buildRenderList, collectElements } from \"./helpers\";\nimport { useRouteNode } from \"../../composables/useRouteNode\";\n\nimport type { Component, VNode } from \"vue\";\n\ntype SlotChildren = Record<string, (() => VNode[]) | undefined> | null;\n\nfunction getSlotContent(vnode: VNode): VNode[] | null {\n  const slots = vnode.children as SlotChildren;\n\n  return slots?.default?.() ?? null;\n}\n\nfunction getOrCreateWrapper(\n  cache: Map<string, Component>,\n  segment: string,\n): Component {\n  const existing = cache.get(segment);\n\n  if (existing) {\n    return existing;\n  }\n\n  const wrapper = markRaw(\n    defineComponent({\n      name: `KeepAlive-${segment}`,\n      setup(_wrapperProps, wrapperCtx) {\n        return () => wrapperCtx.slots.default?.();\n      },\n    }),\n  );\n\n  cache.set(segment, wrapper);\n\n  return wrapper;\n}\n\nfunction wrapWithSuspense(content: VNode, fallback: unknown): VNode {\n  if (fallback === undefined) {\n    return content;\n  }\n\n  const fallbackContent =\n    typeof fallback === \"function\" ? (fallback as () => VNode)() : fallback;\n\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any, @typescript-eslint/no-unsafe-assignment\n  const suspenseComponent = Suspense as any;\n\n  return h(\n    suspenseComponent,\n    {},\n    {\n      default: () => content,\n      fallback: () => fallbackContent,\n    },\n  );\n}\n\nconst emptyKeepAlivePlaceholder = markRaw(\n  defineComponent({\n    name: \"KeepAlive-placeholder\",\n    render() {\n      return null;\n    },\n  }),\n);\n\nfunction renderWithRootKA(\n  activeChild: VNode,\n  wrapperCache: Map<string, Component>,\n  fallback: unknown,\n): VNode {\n  const activeProps = activeChild.props as { segment?: string } | null;\n  const segment = activeProps?.segment ?? \"__not-found__\";\n  const WrapperComponent = getOrCreateWrapper(wrapperCache, segment);\n  const slotContent = getSlotContent(activeChild) ?? [];\n  const keepAliveContent = h(KeepAlive, null, {\n    default: () =>\n      h(WrapperComponent, { key: segment }, { default: () => slotContent }),\n  });\n\n  return wrapWithSuspense(keepAliveContent, fallback);\n}\n\n// Vue compiles boolean-shorthand template attributes (`<Match keepAlive>`) to\n// an empty string instead of `true`, and converts them to `true` only when the\n// receiving component's prop is declared with `type: Boolean`. `Match` is a\n// marker component (`render: null`) — its props are inspected on the VNode\n// without ever going through Vue's prop-casting pipeline, so the raw `\"\"` (or\n// the hyphenated attribute name) reaches us here. Accept the same trio Vue's\n// runtime does.\nfunction isKeepAliveEnabled(value: unknown): boolean {\n  return value === true || value === \"\" || value === \"keep-alive\";\n}\n\nfunction renderWithPerMatchKA(\n  activeChild: VNode,\n  wrapperCache: Map<string, Component>,\n  fallback: unknown,\n): VNode | null {\n  const matchProps = activeChild.props as {\n    segment?: string;\n    keepAlive?: unknown;\n  } | null;\n\n  if (isKeepAliveEnabled(matchProps?.keepAlive) && activeChild.type === Match) {\n    /* v8 ignore start */\n    const segment = matchProps?.segment ?? \"__not-found__\";\n    /* v8 ignore stop */\n    const WrapperComponent = getOrCreateWrapper(wrapperCache, segment);\n    const slotContent = getSlotContent(activeChild) ?? [];\n\n    return h(Fragment, [\n      h(KeepAlive, null, {\n        default: () =>\n          h(WrapperComponent, { key: segment }, { default: () => slotContent }),\n      }),\n    ]);\n  }\n\n  const content = getSlotContent(activeChild);\n\n  /* v8 ignore start */\n  if (!content) {\n    return null;\n  }\n  /* v8 ignore stop */\n\n  return h(Fragment, [\n    h(KeepAlive, null, { default: () => h(emptyKeepAlivePlaceholder) }),\n    wrapWithSuspense(h(Fragment, content), fallback),\n  ]);\n}\n\nconst RouteViewComponent = defineComponent({\n  name: \"RouteView\",\n  props: {\n    nodeName: {\n      type: String,\n      required: true,\n    },\n    keepAlive: {\n      type: Boolean,\n      default: false,\n    },\n  },\n  setup(props, { slots }) {\n    const routeContext = useRouteNode(props.nodeName);\n    const wrapperCache = new Map<string, Component>();\n\n    // Cache per-Match `keepAlive` detection by slot output identity. Slot\n    // contents change reference only when the parent re-renders with new\n    // children, so steady-state navigations skip the O(n) `.some(...)` scan.\n    let lastSlotOutput: unknown = null;\n    let lastHasPerMatchKA = false;\n\n    function detectPerMatchKA(elements: VNode[], slotOutput: unknown): boolean {\n      /* v8 ignore next 3 -- @preserve: Vue's compiled slot wrapper allocates a\n         new array per render call in JSDOM tests; identity-cache hits in\n         production where parent compiled templates share slot output, but\n         is unobservable through TestBed-style assertions. */\n      if (slotOutput === lastSlotOutput) {\n        return lastHasPerMatchKA;\n      }\n\n      lastSlotOutput = slotOutput;\n      lastHasPerMatchKA = elements.some(\n        (element) =>\n          element.type === Match &&\n          isKeepAliveEnabled(\n            (element.props as { keepAlive?: unknown } | null)?.keepAlive,\n          ),\n      );\n\n      return lastHasPerMatchKA;\n    }\n\n    return (): VNode | null => {\n      const route = routeContext.route.value;\n\n      if (!route) {\n        return null;\n      }\n\n      const slotOutput = slots.default?.();\n      const elements: VNode[] = [];\n\n      collectElements(slotOutput, elements);\n\n      const { rendered, fallback } = buildRenderList(\n        elements,\n        route.name,\n        props.nodeName,\n      );\n\n      if (rendered.length === 0) {\n        return null;\n      }\n\n      const activeChild = rendered[0];\n\n      if (props.keepAlive) {\n        return renderWithRootKA(activeChild, wrapperCache, fallback);\n      }\n\n      /* v8 ignore start */\n      if (\n        activeChild.type !== Match &&\n        activeChild.type !== Self &&\n        activeChild.type !== NotFound\n      ) {\n        return null;\n      }\n      /* v8 ignore stop */\n\n      const hasPerMatchKA = detectPerMatchKA(elements, slotOutput);\n\n      if (hasPerMatchKA) {\n        return renderWithPerMatchKA(activeChild, wrapperCache, fallback);\n      }\n\n      const content = getSlotContent(activeChild);\n\n      if (!content) {\n        return null;\n      }\n\n      return wrapWithSuspense(h(Fragment, content), fallback);\n    };\n  },\n});\n\nexport const RouteView = Object.assign(RouteViewComponent, {\n  Match,\n  Self,\n  NotFound,\n});\n\nexport type {\n  RouteViewProps,\n  MatchProps as RouteViewMatchProps,\n  SelfProps as RouteViewSelfProps,\n  NotFoundProps as RouteViewNotFoundProps,\n} from \"./types\";\n","/**\n * Stable empty object for default params\n */\nexport const EMPTY_PARAMS = Object.freeze({});\n\n/**\n * Stable empty options object\n */\nexport const EMPTY_OPTIONS = Object.freeze({});\n","import type { Router, State } from \"@real-router/core\";\n\nconst CLEAR_DELAY = 7000;\nconst SAFARI_READY_DELAY = 100;\nconst ANNOUNCER_ATTR = \"data-real-router-announcer\";\nconst INTERNAL_ROUTE_PREFIX = \"@@\";\nconst VISUALLY_HIDDEN =\n  \"position:absolute;width:1px;height:1px;padding:0;margin:-1px;overflow:hidden;clip:rect(0,0,0,0);clip-path:inset(50%);white-space:nowrap;border:0\";\n\nexport interface RouteAnnouncerOptions {\n  prefix?: string;\n  getAnnouncementText?: (route: State) => string;\n}\n\nexport function createRouteAnnouncer(\n  router: Router,\n  options?: RouteAnnouncerOptions,\n): { destroy: () => void } {\n  const prefix = options?.prefix ?? \"Navigated to \";\n  const getCustomText = options?.getAnnouncementText;\n\n  let isInitialNavigation = true;\n  let isReady = false;\n  let isDestroyed = false;\n  let lastAnnouncedText = \"\";\n  let pendingText: string | null = null;\n  let clearTimeoutId: ReturnType<typeof setTimeout> | undefined;\n\n  const announcer = getOrCreateAnnouncer();\n\n  const doAnnounce = (text: string, h1: HTMLElement | null): void => {\n    lastAnnouncedText = text;\n    clearTimeout(clearTimeoutId);\n    announcer.textContent = text;\n    clearTimeoutId = setTimeout(() => {\n      announcer.textContent = \"\";\n      lastAnnouncedText = \"\";\n    }, CLEAR_DELAY);\n\n    manageFocus(h1);\n  };\n\n  // Safari-ready delay: announcing before VoiceOver wires up the aria-live region\n  // causes the first announcement to be silently dropped. Wait SAFARI_READY_DELAY ms\n  // before marking the announcer \"ready\" — any navigation during that window is\n  // buffered in pendingText and flushed once the delay expires.\n  const safariTimeoutId = setTimeout(() => {\n    isReady = true;\n\n    if (pendingText !== null && !isDestroyed) {\n      const text = pendingText;\n\n      pendingText = null;\n      doAnnounce(text, document.querySelector<HTMLElement>(\"h1\"));\n    }\n  }, SAFARI_READY_DELAY);\n\n  const unsubscribe = router.subscribe(({ route }) => {\n    if (isInitialNavigation) {\n      isInitialNavigation = false;\n\n      return;\n    }\n\n    // Double rAF: waits for two paint frames so the incoming route's DOM\n    // (including the new <h1>) is fully rendered before resolveText reads it.\n    // Single rAF fires before the new route's template has been attached,\n    // which would cause resolveText to pick up the OLD h1 or fall back to\n    // document.title / route.name prematurely.\n    requestAnimationFrame(() => {\n      requestAnimationFrame(() => {\n        if (isDestroyed) {\n          return;\n        }\n\n        const h1 = document.querySelector<HTMLElement>(\"h1\");\n        const text = resolveText(route, prefix, getCustomText, h1);\n\n        if (!text || text === lastAnnouncedText) {\n          return;\n        }\n\n        if (!isReady) {\n          // Defer announcement until Safari-ready window elapses (see safariTimeoutId).\n          pendingText = text;\n\n          return;\n        }\n\n        doAnnounce(text, h1);\n      });\n    });\n  });\n\n  return {\n    destroy() {\n      isDestroyed = true;\n      unsubscribe();\n      clearTimeout(clearTimeoutId);\n      clearTimeout(safariTimeoutId);\n      removeAnnouncer();\n    },\n  };\n}\n\nfunction getOrCreateAnnouncer(): HTMLElement {\n  const existing = document.querySelector<HTMLElement>(`[${ANNOUNCER_ATTR}]`);\n\n  if (existing) {\n    return existing;\n  }\n\n  const element = document.createElement(\"div\");\n\n  element.setAttribute(\"style\", VISUALLY_HIDDEN);\n  element.setAttribute(\"aria-live\", \"assertive\");\n  element.setAttribute(\"aria-atomic\", \"true\");\n  element.setAttribute(ANNOUNCER_ATTR, \"\");\n\n  document.body.prepend(element);\n\n  return element;\n}\n\nfunction removeAnnouncer(): void {\n  document.querySelector(`[${ANNOUNCER_ATTR}]`)?.remove();\n}\n\nfunction resolveText(\n  route: State,\n  prefix: string,\n  getCustomText: ((route: State) => string) | undefined,\n  h1: HTMLElement | null,\n): string {\n  if (getCustomText) {\n    return getCustomText(route);\n  }\n\n  const h1Text = (h1?.textContent ?? \"\").trim();\n  const routeName = route.name.startsWith(INTERNAL_ROUTE_PREFIX)\n    ? \"\"\n    : route.name;\n  const rawText =\n    h1Text || document.title || routeName || globalThis.location.pathname;\n\n  return `${prefix}${rawText}`;\n}\n\nfunction manageFocus(h1: HTMLElement | null): void {\n  if (!h1) {\n    return;\n  }\n\n  if (!h1.hasAttribute(\"tabindex\")) {\n    h1.setAttribute(\"tabindex\", \"-1\");\n  }\n\n  h1.focus({ preventScroll: true });\n}\n","import type { Router, 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  const loadStore = (): Record<string, number> => {\n    try {\n      const raw = sessionStorage.getItem(storageKey);\n\n      return raw ? (JSON.parse(raw) as Record<string, number>) : {};\n    } catch {\n      return {};\n    }\n  };\n\n  const putPos = (key: string, pos: number): void => {\n    try {\n      const store = loadStore();\n\n      store[key] = pos;\n      sessionStorage.setItem(storageKey, JSON.stringify(store));\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\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      putPos(keyOf(previousRoute), readPos());\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        writePos(loadStore()[keyOf(route)] ?? 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      putPos(keyOf(current), readPos());\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\nfunction keyOf(state: State): string {\n  return `${state.name}:${canonicalJson(state.params)}`;\n}\n\nfunction canonicalJson(value: unknown): string {\n  return JSON.stringify(value, canonicalReplacer);\n}\n\nfunction canonicalReplacer(_key: string, val: unknown): unknown {\n  if (val !== null && typeof val === \"object\" && !Array.isArray(val)) {\n    const sorted: 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/**\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 */\nfunction encodeFragmentInline(decoded: string): string {\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      if (url !== undefined) {\n        return url;\n      }\n    }\n\n    const path = router.buildPath(routeName, routeParams);\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\nfunction parseTokens(value: string | undefined): string[] {\n  return value ? (value.match(/\\S+/g) ?? []) : [];\n}\n\nexport function buildActiveClassName(\n  isActive: boolean,\n  activeClassName: string | undefined,\n  baseClassName: string | undefined,\n): string | undefined {\n  if (isActive && activeClassName) {\n    const activeTokens = parseTokens(activeClassName);\n\n    if (activeTokens.length === 0) {\n      return baseClassName ?? undefined;\n    }\n    if (!baseClassName) {\n      return activeTokens.join(\" \");\n    }\n\n    const baseTokens = parseTokens(baseClassName);\n    const seen = new Set(baseTokens);\n\n    for (const token of activeTokens) {\n      if (!seen.has(token)) {\n        seen.add(token);\n        baseTokens.push(token);\n      }\n    }\n\n    return baseTokens.join(\" \");\n  }\n\n  return baseClassName ?? undefined;\n}\n\nexport function shallowEqual(\n  prev: object | undefined,\n  next: object | undefined,\n): boolean {\n  if (Object.is(prev, next)) {\n    return true;\n  }\n  if (!prev || !next) {\n    return false;\n  }\n\n  const prevKeys = Object.keys(prev);\n\n  if (prevKeys.length !== Object.keys(next).length) {\n    return false;\n  }\n\n  const prevRecord = prev as Record<string, unknown>;\n  const nextRecord = next as Record<string, unknown>;\n\n  for (const key of prevKeys) {\n    if (!Object.is(prevRecord[key], nextRecord[key])) {\n      return false;\n    }\n  }\n\n  return true;\n}\n\nexport function applyLinkA11y(element: HTMLElement | null | undefined): void {\n  if (!element) {\n    return;\n  }\n  if (\n    element instanceof HTMLAnchorElement ||\n    element instanceof HTMLButtonElement\n  ) {\n    return;\n  }\n  if (!element.hasAttribute(\"role\")) {\n    element.setAttribute(\"role\", \"link\");\n  }\n  if (!element.hasAttribute(\"tabindex\")) {\n    element.setAttribute(\"tabindex\", \"0\");\n  }\n}\n","import { createActiveRouteSource } from \"@real-router/sources\";\nimport { defineComponent, h, computed, shallowRef, watch } from \"vue\";\n\nimport { useRouter } from \"../composables/useRouter\";\nimport { EMPTY_PARAMS, EMPTY_OPTIONS } from \"../constants\";\nimport {\n  shouldNavigate,\n  buildHref,\n  buildActiveClassName,\n  navigateWithHash,\n} from \"../dom-utils\";\n\nimport type { Params, NavigationOptions } from \"@real-router/core\";\nimport type { PropType } from \"vue\";\n\ntype OnClickHandler = (evt: MouseEvent) => void;\n\n/**\n * Vue's compiled template binds multiple `@click` handlers as an array.\n * Single render-function `onClick` is a function. Both must be invoked.\n */\nfunction invokeAttributesOnClick(value: unknown, evt: MouseEvent): void {\n  if (typeof value === \"function\") {\n    (value as OnClickHandler)(evt);\n\n    return;\n  }\n  if (Array.isArray(value)) {\n    const handlers = value as OnClickHandler[];\n\n    for (const fn of handlers) {\n      if (typeof fn === \"function\") {\n        fn(evt);\n\n        if (evt.defaultPrevented) {\n          return;\n        }\n      }\n    }\n  }\n}\n\nexport const Link = defineComponent({\n  name: \"Link\",\n  // Disable Vue's automatic attribute fallthrough. Without this, attrs.onClick\n  // (function OR array) is auto-attached as a native click listener AND our\n  // explicit onClick fires too — user handlers are double-invoked. We invoke\n  // attrs.onClick manually inside handleClick to preserve preventDefault.\n  inheritAttrs: false,\n  props: {\n    routeName: {\n      type: String,\n      required: true,\n    },\n    routeParams: {\n      type: Object as PropType<Params>,\n      default: () => EMPTY_PARAMS,\n    },\n    routeOptions: {\n      type: Object as PropType<NavigationOptions>,\n      default: () => EMPTY_OPTIONS,\n    },\n    class: {\n      type: String,\n      default: undefined,\n    },\n    activeClassName: {\n      type: String,\n      default: \"active\",\n    },\n    activeStrict: {\n      type: Boolean,\n      default: false,\n    },\n    ignoreQueryParams: {\n      type: Boolean,\n      default: true,\n    },\n    target: {\n      type: String,\n      default: undefined,\n    },\n    /**\n     * URL fragment (decoded form, no leading \"#\") (#532).\n     * - omitted/`undefined` → preserve current fragment on same-route navigation\n     * - `\"\"` → clear fragment\n     * - non-empty → set fragment\n     */\n    hash: {\n      type: String,\n      default: undefined,\n    },\n  },\n  setup(props, { slots, attrs }) {\n    const router = useRouter();\n\n    const isActive = shallowRef(false);\n\n    // watch with an explicit dep getter recreates the source ONLY when\n    // routeName/routeParams/strict/ignoreQueryParams change — not on every\n    // reactive read inside the source factory (the watchEffect alternative\n    // would also re-subscribe whenever isActive itself changed).\n    watch(\n      () =>\n        [\n          props.routeName,\n          props.routeParams,\n          props.activeStrict,\n          props.ignoreQueryParams,\n          props.hash,\n        ] as const,\n      (\n        [routeName, routeParams, activeStrict, ignoreQueryParams, hash],\n        _prev,\n        onCleanup,\n      ) => {\n        // Hash-aware active (#532): pass hash through so tab links with the\n        // same routeName but different `hash` props don't all light up.\n        const source = createActiveRouteSource(\n          router,\n          routeName,\n          routeParams,\n          hash === undefined\n            ? { strict: activeStrict, ignoreQueryParams }\n            : { strict: activeStrict, ignoreQueryParams, hash },\n        );\n\n        isActive.value = source.getSnapshot();\n\n        const unsub = source.subscribe(() => {\n          isActive.value = source.getSnapshot();\n        });\n\n        onCleanup(unsub);\n      },\n      { immediate: true, flush: \"sync\" },\n    );\n\n    const href = computed(() =>\n      buildHref(\n        router,\n        props.routeName,\n        props.routeParams,\n        props.hash === undefined ? undefined : { hash: props.hash },\n      ),\n    );\n\n    const finalClassName = computed(() =>\n      buildActiveClassName(isActive.value, props.activeClassName, props.class),\n    );\n\n    const handleClick = (evt: MouseEvent) => {\n      // Vue allows attrs.onClick to be a function or an array of functions\n      // (compiled templates with multiple @click bindings produce arrays).\n      // Both must be invoked; treating arrays as \"no handler\" silently drops\n      // user code.\n      if (attrs.onClick !== undefined && attrs.onClick !== null) {\n        invokeAttributesOnClick(attrs.onClick, evt);\n\n        if (evt.defaultPrevented) {\n          return;\n        }\n      }\n\n      if (!shouldNavigate(evt) || props.target === \"_blank\") {\n        return;\n      }\n\n      evt.preventDefault();\n      navigateWithHash(\n        router,\n        props.routeName,\n        props.routeParams,\n        props.hash,\n        props.routeOptions,\n      ).catch(() => {});\n    };\n\n    return () => {\n      // Build forwarded attrs without `onClick`. Vue's runtime auto-attaches\n      // attrs.onClick (function OR array) as a native DOM listener, which would\n      // double-invoke user handlers when combined with our explicit `onClick`.\n      // We invoke the original attrs.onClick manually inside handleClick so the\n      // preventDefault contract is preserved.\n      const restAttributes: Record<string, unknown> = {};\n\n      for (const key of Object.keys(attrs)) {\n        if (key !== \"onClick\") {\n          restAttributes[key] = (attrs as Record<string, unknown>)[key];\n        }\n      }\n\n      return h(\n        \"a\",\n        {\n          ...restAttributes,\n          href: href.value,\n          class: finalClassName.value,\n          target: props.target,\n          onClick: handleClick,\n        },\n        slots.default?.(),\n      );\n    };\n  },\n});\n","import { createDismissableError } from \"@real-router/sources\";\nimport { defineComponent, h, watch, Fragment } from \"vue\";\n\nimport { useRouter } from \"../composables/useRouter\";\nimport { useRefFromSource } from \"../useRefFromSource\";\n\nimport type { RouterError, State } from \"@real-router/core\";\nimport type { VNode, PropType } from \"vue\";\n\nexport const RouterErrorBoundary = defineComponent({\n  name: \"RouterErrorBoundary\",\n  props: {\n    fallback: {\n      type: Function as PropType<\n        (error: RouterError, resetError: () => void) => VNode\n      >,\n      required: true,\n    },\n    onError: {\n      type: Function as PropType<\n        (\n          error: RouterError,\n          toRoute: State | null,\n          fromRoute: State | null,\n        ) => void\n      >,\n      default: undefined,\n    },\n  },\n  setup(props, { slots }) {\n    const router = useRouter();\n    const snapshot = useRefFromSource(createDismissableError(router));\n\n    watch(\n      () => snapshot.value.version,\n      () => {\n        if (snapshot.value.error) {\n          props.onError?.(\n            snapshot.value.error,\n            snapshot.value.toRoute,\n            snapshot.value.fromRoute,\n          );\n        }\n      },\n      { immediate: true },\n    );\n\n    return () => {\n      const children = slots.default?.() ?? [];\n      const errorVNode = snapshot.value.error\n        ? props.fallback(snapshot.value.error, snapshot.value.resetError)\n        : null;\n\n      return h(Fragment, null, [...children, errorVNode]);\n    };\n  },\n});\n\nexport type RouterErrorBoundaryProps = InstanceType<\n  typeof RouterErrorBoundary\n>[\"$props\"];\n","import { shouldNavigate, applyLinkA11y } from \"../dom-utils\";\n\nimport type { Router, NavigationOptions, Params } from \"@real-router/core\";\nimport type { Directive } from \"vue\";\n\nexport interface LinkDirectiveValue {\n  name: string;\n  params?: Params;\n  options?: NavigationOptions;\n}\n\n/**\n * Router stack for nested RouterProviders. The active router is the top of\n * the stack. RouterProvider pushes its router on mount and pops it on unmount,\n * which preserves the parent context when an inner provider tears down.\n *\n * Without the stack, an unmounted child provider would leave the directive\n * pointing at a disposed router, and v-link in the still-mounted parent would\n * navigate via the wrong (or torn-down) instance.\n */\nconst routerStack: Router[] = [];\n\n/**\n * Pushes a router onto the active stack. Returns a release function that\n * removes that exact router from the stack regardless of position — safe\n * across out-of-order provider unmount sequences.\n *\n * @internal Used by RouterProvider during setup/teardown.\n */\nexport function pushDirectiveRouter(router: Router): () => void {\n  routerStack.push(router);\n\n  return () => {\n    const idx = routerStack.lastIndexOf(router);\n\n    if (idx !== -1) {\n      routerStack.splice(idx, 1);\n    }\n  };\n}\n\n/**\n * Backwards-compatible alias. Replaces the active router unconditionally and\n * does NOT participate in the stack — use {@link pushDirectiveRouter} from\n * provider code instead. Kept for tests and direct callers.\n */\nexport function setDirectiveRouter(router: Router | null): void {\n  if (router === null) {\n    routerStack.length = 0;\n\n    return;\n  }\n  if (routerStack.length === 0) {\n    routerStack.push(router);\n\n    return;\n  }\n\n  routerStack[routerStack.length - 1] = router;\n}\n\nexport function getDirectiveRouter(): Router {\n  const top = routerStack.at(-1);\n\n  if (!top) {\n    throw new Error(\n      \"v-link directive requires a RouterProvider ancestor. Make sure RouterProvider is mounted.\",\n    );\n  }\n\n  return top;\n}\n\ninterface Handlers {\n  click: (evt: MouseEvent) => void;\n  keydown: (evt: KeyboardEvent) => void;\n}\n\n// Single WeakMap halves per-element bookkeeping vs two parallel maps.\nconst handlers = new WeakMap<HTMLElement, Handlers>();\n\n/**\n * Validates a directive binding value before attaching handlers.\n * Returns false (and warns once per call) when the value is missing or\n * has no `name` — silently doing nothing is preferable to a runtime crash\n * inside a click handler.\n */\nfunction isValidBinding(value: unknown): value is LinkDirectiveValue {\n  if (value === null || value === undefined) {\n    console.error(\n      \"[real-router] v-link directive received null/undefined value. The element will not be wired for navigation.\",\n    );\n\n    return false;\n  }\n  if (typeof (value as { name?: unknown }).name !== \"string\") {\n    console.error(\n      \"[real-router] v-link directive value is missing a string `name` field. The element will not be wired for navigation.\",\n    );\n\n    return false;\n  }\n\n  return true;\n}\n\nfunction createClickHandler(\n  router: Router,\n  value: LinkDirectiveValue,\n): (evt: MouseEvent) => void {\n  return (evt: MouseEvent) => {\n    if (!shouldNavigate(evt)) {\n      return;\n    }\n\n    evt.preventDefault();\n    router\n      .navigate(value.name, value.params ?? {}, value.options ?? {})\n      .catch(() => {});\n  };\n}\n\nfunction createKeydownHandler(\n  router: Router,\n  value: LinkDirectiveValue,\n  element: HTMLElement,\n): (evt: KeyboardEvent) => void {\n  return (evt: KeyboardEvent) => {\n    if (evt.key === \"Enter\" && !(element instanceof HTMLButtonElement)) {\n      router\n        .navigate(value.name, value.params ?? {}, value.options ?? {})\n        .catch(() => {});\n    }\n  };\n}\n\nfunction attachHandlers(\n  element: HTMLElement,\n  router: Router,\n  value: LinkDirectiveValue,\n): void {\n  const click = createClickHandler(router, value);\n  const keydown = createKeydownHandler(router, value, element);\n\n  element.addEventListener(\"click\", click);\n  element.addEventListener(\"keydown\", keydown);\n\n  handlers.set(element, { click, keydown });\n}\n\nfunction detachHandlers(element: HTMLElement): void {\n  const entry = handlers.get(element);\n\n  if (entry) {\n    element.removeEventListener(\"click\", entry.click);\n    element.removeEventListener(\"keydown\", entry.keydown);\n    handlers.delete(element);\n  }\n}\n\nexport const vLink: Directive<HTMLElement, LinkDirectiveValue> = {\n  mounted(element, binding) {\n    const router = getDirectiveRouter();\n\n    applyLinkA11y(element);\n\n    element.style.cursor = \"pointer\";\n\n    if (!isValidBinding(binding.value)) {\n      return;\n    }\n\n    attachHandlers(element, router, binding.value);\n  },\n\n  updated(element, binding) {\n    const router = getDirectiveRouter();\n\n    detachHandlers(element);\n\n    if (!isValidBinding(binding.value)) {\n      return;\n    }\n\n    attachHandlers(element, router, binding.value);\n  },\n\n  beforeUnmount(element) {\n    detachHandlers(element);\n  },\n};\n","import { inject } from \"vue\";\n\nimport { NavigatorKey } from \"../context\";\n\nimport type { Navigator } from \"@real-router/core\";\n\nexport const useNavigator = (): Navigator => {\n  const navigator = inject(NavigatorKey);\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\nexport const useRouteUtils = (): RouteUtils => {\n  const router = useRouter();\n\n  return getRouteUtils(getPluginApi(router).getTree());\n};\n","import { inject } from \"vue\";\n\nimport { RouteKey } from \"../context\";\n\nimport type { RouteContext } from \"../types\";\nimport type { Params, State } from \"@real-router/core\";\nimport type { Ref } from \"vue\";\n\nexport const useRoute = <P extends Params = Params>(): Omit<\n  RouteContext<P>,\n  \"route\"\n> & { route: Readonly<Ref<State<P>>> } => {\n  const routeContext = inject(RouteKey);\n\n  if (!routeContext) {\n    throw new Error(\"useRoute must be used within a RouterProvider\");\n  }\n\n  if (!routeContext.route.value) {\n    throw new Error(\n      \"useRoute called with no active route. Did you forget to await router.start() before rendering, or is the router stopped/disposed?\",\n    );\n  }\n\n  return routeContext as Omit<RouteContext<P>, \"route\"> & {\n    route: Readonly<Ref<State<P>>>;\n  };\n};\n","import { getTransitionSource } from \"@real-router/sources\";\n\nimport { useRefFromSource } from \"../useRefFromSource\";\nimport { useRouter } from \"./useRouter\";\n\nimport type { RouterTransitionSnapshot } from \"@real-router/sources\";\nimport type { ShallowRef } from \"vue\";\n\nexport function useRouterTransition(): ShallowRef<RouterTransitionSnapshot> {\n  const router = useRouter();\n  const source = getTransitionSource(router);\n\n  return useRefFromSource(source);\n}\n","import { onScopeDispose } from \"vue\";\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.\n *   - **Same-route skip**: by default, `route.name === nextRoute.name`\n *     short-circuits the handler — query-only navigations skip the work.\n *     Opt out with `skipSameRoute: false`.\n *\n * Cleanup is bound to the component's effect scope via `onScopeDispose`.\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`.\n *\n * **Handler reactivity (Vue):** Vue composables run **once** during\n * `setup()`; `handler` is captured in closure at the call site. To vary\n * behavior over time, read refs/computeds inside the handler body — do\n * not rely on swapping the handler reference.\n *\n * @example Animation\n * ```ts\n * const ref = useTemplateRef<HTMLDivElement>(\"box\");\n *\n * useRouteExit(async ({ signal }) => {\n *   const el = ref.value;\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();\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 * ```ts\n * useRouteExit(async ({ signal }) => {\n *   if (formState.value.dirty) {\n *     await api.saveDraft(formState.value, { signal });\n *   }\n * });\n * ```\n *\n * @example Reading rich transition metadata via `nextRoute.transition`\n * ```ts\n * useRouteExit(({ route, nextRoute }) => {\n *   if (nextRoute.transition.segments.deactivated.includes(\"products\")) {\n *     productCache.clear();\n *   }\n *   if (nextRoute.transition.redirected) return;\n * });\n * ```\n */\nexport function useRouteExit(\n  handler: RouteExitHandler,\n  options?: UseRouteExitOptions,\n): void {\n  const router = useRouter();\n  const skipSameRoute = options?.skipSameRoute ?? true;\n\n  const off = router.subscribeLeave(({ route, nextRoute, signal }) => {\n    if (skipSameRoute && route.name === nextRoute.name) {\n      return;\n    }\n\n    if (signal.aborted) {\n      return;\n    }\n\n    return handler({ route, nextRoute, signal });\n  });\n\n  onScopeDispose(off);\n}\n","import { watch } from \"vue\";\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 composable covers that an ad-hoc `watch` + `useRoute()`\n * doesn't:\n *\n *   - **Skip-initial**: `watch` (with default `immediate: false`) plus the\n *     explicit `route.transition.from` guard ensures the handler doesn't\n *     fire on the very first state committed by `router.start()`.\n *   - **Same-route skip** (default): handler is skipped when\n *     `route.transition.from === route.name`. Sort/filter/query-only\n *     navigations re-trigger the watcher, but they are not \"entries\" in\n *     the animation / analytics sense. Opt out with\n *     `skipSameRoute: false`.\n *   - **Mount-time `route` / `previousRoute` snapshot**: handler receives\n *     the values that were live at the moment of the new state, not the\n *     latest ones (which may have moved on if the user navigated again\n *     before the watcher drained).\n *\n * **Handler reactivity (Vue):** Vue composables run **once** during\n * `setup()`; `handler` is captured in closure at the call site. To vary\n * behavior over time, read refs/computeds inside the handler body.\n *\n * @example Direction-aware entry animation\n * ```ts\n * useRouteEnter(({ route }) => {\n *   const direction = route.context.browser?.direction;\n *   ref.value?.classList.add(\n *     direction === \"back\" ? \"slide-from-left\" : \"slide-from-right\",\n *   );\n * });\n * ```\n *\n * @example Analytics page-enter event (skip-initial built-in)\n * ```ts\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 * ```ts\n * useRouteEnter(({ route }) => {\n *   if (route.transition.redirected) {\n *     showToast(`Redirected from ${route.transition.from}`);\n *   }\n * });\n * ```\n */\nexport function useRouteEnter(\n  handler: RouteEnterHandler,\n  options?: UseRouteEnterOptions,\n): void {\n  const { route, previousRoute } = useRoute();\n  const skipSameRoute = options?.skipSameRoute ?? true;\n  let lastHandledRoute: State | null = null;\n\n  watch(route, (newRoute) => {\n    const prev = previousRoute.value;\n\n    // Early-exit guards, top-down:\n    //\n    //   - **Skip-initial**: `!transition.from` catches the first commit\n    //     from `router.start()`. Vue's `watch` (default `immediate: false`)\n    //     does not fire on the initial state — kept for parity with\n    //     React/Preact and v8-ignored.\n    //   - **Skip-same-route**: query-only navigations have\n    //     `transition.from === route.name`. Opt-out via\n    //     `skipSameRoute: false`.\n    //   - **Defensive dedupe + missing `previousRoute`**: same `route`\n    //     ref between watcher activations is unexpected on Vue (driven\n    //     off ref identity); `!prev` is unreachable once\n    //     `transition.from` is set (core populates them together). Both\n    //     kept for parity with React; v8-ignored.\n    /* v8 ignore start */\n    if (!newRoute.transition.from) {\n      return;\n    }\n    /* v8 ignore stop */\n    if (skipSameRoute && newRoute.transition.from === newRoute.name) {\n      return;\n    }\n    /* v8 ignore start */\n    if (lastHandledRoute === newRoute || !prev) {\n      return;\n    }\n    /* v8 ignore stop */\n\n    lastHandledRoute = newRoute;\n    handler({ route: newRoute, previousRoute: prev });\n  });\n}\n","// packages/vue/src/setupRouteProvision.ts\n\nimport { getNavigator } from \"@real-router/core\";\nimport { createRouteSource } from \"@real-router/sources\";\nimport { shallowRef } from \"vue\";\n\nimport type { Router, Navigator, State } from \"@real-router/core\";\nimport type { ShallowRef } from \"vue\";\n\n/**\n * Shared setup for `RouterProvider` (component-scoped) and\n * `createRouterPlugin` (app-scoped). Builds the reactive route refs +\n * subscription bookkeeping in one place; callers wire the result into their\n * provide/inject mechanism and own teardown lifecycle.\n *\n * @internal\n */\nexport interface RouteProvision {\n  navigator: Navigator;\n  route: ShallowRef<State | undefined>;\n  previousRoute: ShallowRef<State | undefined>;\n  /** Call when the owning scope tears down to release the router subscription. */\n  unsubscribe: () => void;\n}\n\nexport function setupRouteProvision(router: Router): RouteProvision {\n  const navigator = getNavigator(router);\n  const source = createRouteSource(router);\n  const initial = source.getSnapshot();\n\n  const route = shallowRef<State | undefined>(initial.route);\n  const previousRoute = shallowRef<State | undefined>(initial.previousRoute);\n\n  const unsubscribe = source.subscribe(() => {\n    const snapshot = source.getSnapshot();\n\n    route.value = snapshot.route;\n    previousRoute.value = snapshot.previousRoute;\n  });\n\n  return { navigator, route, previousRoute, unsubscribe };\n}\n","import { NavigatorKey, RouteKey, RouterKey } from \"./context\";\nimport { pushDirectiveRouter } from \"./directives/vLink\";\nimport { setupRouteProvision } from \"./setupRouteProvision\";\n\nimport type { Router } from \"@real-router/core\";\nimport type { App, Plugin } from \"vue\";\n\nexport function createRouterPlugin(router: Router): Plugin<[]> {\n  return {\n    install(app): void {\n      const releaseDirective = pushDirectiveRouter(router);\n\n      const { navigator, route, previousRoute, unsubscribe } =\n        setupRouteProvision(router);\n\n      // Vue 3.5+ exposes app.onUnmount for plugin cleanup.\n      // On older versions (3.3–3.4), the subscription is cleaned up\n      // when the router is garbage-collected (same as vue-router).\n      if (\"onUnmount\" in app) {\n        (app as App & { onUnmount: (fn: () => void) => void }).onUnmount(() => {\n          releaseDirective();\n          unsubscribe();\n        });\n      }\n\n      app.provide(RouterKey, router);\n      app.provide(NavigatorKey, navigator);\n      app.provide(RouteKey, { navigator, route, previousRoute });\n    },\n  };\n}\n","import { defineComponent, onScopeDispose, provide, watch } from \"vue\";\n\nimport { NavigatorKey, RouteKey, RouterKey } from \"./context\";\nimport { pushDirectiveRouter } from \"./directives/vLink\";\nimport {\n  createRouteAnnouncer,\n  createScrollRestoration,\n  createViewTransitions,\n} from \"./dom-utils\";\nimport { setupRouteProvision } from \"./setupRouteProvision\";\n\nimport type { ScrollRestorationOptions } from \"./dom-utils\";\nimport type { Router } from \"@real-router/core\";\nimport type { PropType } from \"vue\";\n\nexport const RouterProvider = defineComponent({\n  name: \"RouterProvider\",\n  props: {\n    router: {\n      type: Object as PropType<Router>,\n      required: true,\n    },\n    announceNavigation: {\n      type: Boolean,\n      default: false,\n    },\n    scrollRestoration: {\n      type: Object as PropType<ScrollRestorationOptions>,\n    },\n    viewTransitions: {\n      type: Boolean,\n      default: false,\n    },\n  },\n  setup(props, { slots }) {\n    // Reactive announceNavigation: setting prop true/false at runtime now\n    // creates/destroys the announcer accordingly. Prior implementation read\n    // the prop only inside onMounted, so toggling it post-mount silently no-op'd.\n    watch(\n      () => [props.router, props.announceNavigation] as const,\n      ([router, enabled], _prev, onCleanup) => {\n        if (!enabled) {\n          return;\n        }\n\n        const announcer = createRouteAnnouncer(router);\n\n        onCleanup(() => {\n          announcer.destroy();\n        });\n      },\n      { immediate: true },\n    );\n\n    // Watch by primitives so inline `{ mode: \"restore\" }` doesn't thrash.\n    // scrollContainer is a getter invoked lazily on every event inside the\n    // utility — swapping its reference doesn't change the resolved element,\n    // so we intentionally omit it from watched sources.\n    watch(\n      () =>\n        [\n          props.router,\n          props.scrollRestoration !== undefined,\n          props.scrollRestoration?.mode,\n          props.scrollRestoration?.anchorScrolling,\n          props.scrollRestoration?.behavior,\n          props.scrollRestoration?.storageKey,\n        ] as const,\n      (\n        [router, enabled, mode, anchorScrolling, behavior, storageKey],\n        _prev,\n        onCleanup,\n      ) => {\n        if (!enabled) {\n          return;\n        }\n\n        const sr = createScrollRestoration(router, {\n          mode,\n          anchorScrolling,\n          behavior,\n          storageKey,\n          scrollContainer: props.scrollRestoration?.scrollContainer,\n        });\n\n        onCleanup(() => {\n          sr.destroy();\n        });\n      },\n      { immediate: true },\n    );\n\n    // Reactive viewTransitions: toggling prop creates/destroys the utility.\n    watch(\n      () => [props.router, props.viewTransitions] as const,\n      ([router, enabled], _prev, onCleanup) => {\n        if (!enabled) {\n          return;\n        }\n\n        const vt = createViewTransitions(router);\n\n        onCleanup(() => {\n          vt.destroy();\n        });\n      },\n      { immediate: true },\n    );\n\n    // Push this provider's router on the v-link directive stack so nested\n    // RouterProviders behave like nested DI scopes (LIFO). Release on unmount\n    // restores the outer router for any v-link still mounted in the parent.\n    const releaseDirective = pushDirectiveRouter(props.router);\n\n    const { navigator, route, previousRoute, unsubscribe } =\n      setupRouteProvision(props.router);\n\n    onScopeDispose(() => {\n      releaseDirective();\n      unsubscribe();\n    });\n\n    provide(RouterKey, props.router);\n    provide(NavigatorKey, navigator);\n    provide(RouteKey, { navigator, route, previousRoute });\n\n    return () => slots.default?.();\n  },\n});\n"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@real-router/vue",
-  "version": "0.10.1",
+  "version": "0.12.0",
   "type": "commonjs",
   "description": "Vue 3 integration for Real-Router",
   "main": "./dist/cjs/index.js",
@@ -52,13 +52,13 @@
   "dependencies": {
     "@real-router/core": "^0.51.0",
     "@real-router/route-utils": "^0.2.2",
-    "@real-router/sources": "^0.7.3"
+    "@real-router/sources": "^0.8.0"
   },
   "devDependencies": {
     "@testing-library/jest-dom": "6.9.1",
     "@vue/test-utils": "2.4.6",
     "vue": "3.5.13",
-    "@real-router/browser-plugin": "^0.16.1"
+    "@real-router/browser-plugin": "^0.17.0"
   },
   "peerDependencies": {
     "vue": ">=3.3.0"

package/src/RouterProvider.ts

@@ -63,8 +63,14 @@ export const RouterProvider = defineComponent({
           props.scrollRestoration !== undefined,
           props.scrollRestoration?.mode,
           props.scrollRestoration?.anchorScrolling,
+          props.scrollRestoration?.behavior,
+          props.scrollRestoration?.storageKey,
         ] as const,
-      ([router, enabled, mode, anchorScrolling], _prev, onCleanup) => {
+      (
+        [router, enabled, mode, anchorScrolling, behavior, storageKey],
+        _prev,
+        onCleanup,
+      ) => {
         if (!enabled) {
           return;
         }
@@ -72,6 +78,8 @@ export const RouterProvider = defineComponent({
         const sr = createScrollRestoration(router, {
           mode,
           anchorScrolling,
+          behavior,
+          storageKey,
           scrollContainer: props.scrollRestoration?.scrollContainer,
         });
 

package/src/components/Link.ts

@@ -3,7 +3,12 @@ import { defineComponent, h, computed, shallowRef, watch } from "vue";
 
 import { useRouter } from "../composables/useRouter";
 import { EMPTY_PARAMS, EMPTY_OPTIONS } from "../constants";
-import { shouldNavigate, buildHref, buildActiveClassName } from "../dom-utils";
+import {
+  shouldNavigate,
+  buildHref,
+  buildActiveClassName,
+  navigateWithHash,
+} from "../dom-utils";
 
 import type { Params, NavigationOptions } from "@real-router/core";
 import type { PropType } from "vue";
@@ -75,6 +80,16 @@ export const Link = defineComponent({
       type: String,
       default: undefined,
     },
+    /**
+     * URL fragment (decoded form, no leading "#") (#532).
+     * - omitted/`undefined` → preserve current fragment on same-route navigation
+     * - `""` → clear fragment
+     * - non-empty → set fragment
+     */
+    hash: {
+      type: String,
+      default: undefined,
+    },
   },
   setup(props, { slots, attrs }) {
     const router = useRouter();
@@ -92,16 +107,23 @@ export const Link = defineComponent({
           props.routeParams,
           props.activeStrict,
           props.ignoreQueryParams,
+          props.hash,
         ] as const,
       (
-        [routeName, routeParams, activeStrict, ignoreQueryParams],
+        [routeName, routeParams, activeStrict, ignoreQueryParams, hash],
         _prev,
         onCleanup,
       ) => {
-        const source = createActiveRouteSource(router, routeName, routeParams, {
-          strict: activeStrict,
-          ignoreQueryParams,
-        });
+        // Hash-aware active (#532): pass hash through so tab links with the
+        // same routeName but different `hash` props don't all light up.
+        const source = createActiveRouteSource(
+          router,
+          routeName,
+          routeParams,
+          hash === undefined
+            ? { strict: activeStrict, ignoreQueryParams }
+            : { strict: activeStrict, ignoreQueryParams, hash },
+        );
 
         isActive.value = source.getSnapshot();
 
@@ -115,7 +137,12 @@ export const Link = defineComponent({
     );
 
     const href = computed(() =>
-      buildHref(router, props.routeName, props.routeParams),
+      buildHref(
+        router,
+        props.routeName,
+        props.routeParams,
+        props.hash === undefined ? undefined : { hash: props.hash },
+      ),
     );
 
     const finalClassName = computed(() =>
@@ -140,9 +167,13 @@ export const Link = defineComponent({
       }
 
       evt.preventDefault();
-      router
-        .navigate(props.routeName, props.routeParams, props.routeOptions)
-        .catch(() => {});
+      navigateWithHash(
+        router,
+        props.routeName,
+        props.routeParams,
+        props.hash,
+        props.routeOptions,
+      ).catch(() => {});
     };
 
     return () => {

package/src/composables/useIsActiveRoute.ts

@@ -11,13 +11,21 @@ export function useIsActiveRoute(
   params?: Params,
   strict = false,
   ignoreQueryParams = true,
+  hash?: string,
 ): ShallowRef<boolean> {
   const router = useRouter();
 
-  const source = createActiveRouteSource(router, routeName, params, {
-    strict,
-    ignoreQueryParams,
-  });
+  // The `hash` argument (#532) participates in the cache key when defined.
+  // exactOptionalPropertyTypes forbids `{ hash: undefined }` literally — we
+  // conditionally include the key only when a value is provided.
+  const source = createActiveRouteSource(
+    router,
+    routeName,
+    params,
+    hash === undefined
+      ? { strict, ignoreQueryParams }
+      : { strict, ignoreQueryParams, hash },
+  );
 
   return useRefFromSource(source);
 }