@real-router/vue 0.4.1 → 0.5.1

package/dist/esm/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":[],"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/composables/useIsActiveRoute.ts","../../src/constants.ts","../../../../shared/dom-utils/route-announcer.ts","../../../../shared/dom-utils/link-utils.ts","../../src/components/Link.ts","../../src/composables/useRouterError.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/createRouterPlugin.ts","../../src/RouterProvider.ts"],"sourcesContent":["import { defineComponent } from \"vue\";\n\nimport type { 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\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 } from \"./components\";\n\nimport type { VNode } from \"vue\";\n\ntype FallbackType = VNode | (() => VNode) | undefined;\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 (child.type === Match || child.type === NotFound) {\n      result.push(child);\n    } else if (child.type === Fragment) {\n      collectElements(child.children, result);\n    }\n  }\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  let notFoundChildren: unknown = null;\n  let activeMatchFound = false;\n  let fallback: FallbackType = undefined;\n  const rendered: VNode[] = [];\n\n  for (const child of elements) {\n    if (child.type === NotFound) {\n      notFoundChildren = child.children;\n      continue;\n    }\n\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 =\n      !activeMatchFound && isSegmentMatch(routeName, fullSegmentName, exact);\n\n    if (isActive) {\n      activeMatchFound = true;\n      fallback = props?.fallback;\n      rendered.push(child);\n    }\n  }\n\n  if (\n    !activeMatchFound &&\n    routeName === UNKNOWN_ROUTE &&\n    notFoundChildren !== null\n  ) {\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 { 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 { shallowRef, watch } from \"vue\";\n\nimport { useRefFromSource } from \"../useRefFromSource\";\nimport { useRouter } from \"./useRouter\";\n\nimport type { RouteContext } from \"../types\";\nimport type { State } from \"@real-router/core\";\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  const navigator = getNavigator(router);\n\n  const route = shallowRef<State | undefined>(snapshot.value.route);\n  const previousRoute = shallowRef<State | undefined>(\n    snapshot.value.previousRoute,\n  );\n\n  watch(\n    snapshot,\n    (newSnapshot) => {\n      route.value = newSnapshot.route;\n      previousRoute.value = newSnapshot.previousRoute;\n    },\n    { flush: \"sync\" },\n  );\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 } 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\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?: boolean;\n  } | null;\n\n  if (matchProps?.keepAlive === true && 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    return (): VNode | null => {\n      const route = routeContext.route.value;\n\n      if (!route) {\n        return null;\n      }\n\n      const elements: VNode[] = [];\n\n      collectElements(slots.default?.(), 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 (activeChild.type !== Match && activeChild.type !== NotFound) {\n        return null;\n      }\n      /* v8 ignore stop */\n\n      const hasPerMatchKA = elements.some(\n        (element) =>\n          element.type === Match &&\n          (element.props as { keepAlive?: boolean } | null)?.keepAlive === true,\n      );\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, { Match, NotFound });\n\nexport type {\n  RouteViewProps,\n  MatchProps as RouteViewMatchProps,\n  NotFoundProps as RouteViewNotFoundProps,\n} from \"./types\";\n","import { createActiveRouteSource } from \"@real-router/sources\";\n\nimport { useRefFromSource } from \"../useRefFromSource\";\nimport { useRouter } from \"./useRouter\";\n\nimport type { Params } from \"@real-router/core\";\nimport type { ShallowRef } from \"vue\";\n\nexport function useIsActiveRoute(\n  routeName: string,\n  params?: Params,\n  strict = false,\n  ignoreQueryParams = true,\n): ShallowRef<boolean> {\n  const router = useRouter();\n\n  const source = createActiveRouteSource(router, routeName, params, {\n    strict,\n    ignoreQueryParams,\n  });\n\n  return useRefFromSource(source);\n}\n","/**\n * Stable empty object for default params\n */\nexport const EMPTY_PARAMS = Object.freeze({});\n\n/**\n * Stable empty options object\n */\nexport const EMPTY_OPTIONS = Object.freeze({});\n","import type { Router, State } from \"@real-router/core\";\n\nconst CLEAR_DELAY = 7000;\nconst SAFARI_READY_DELAY = 100;\nconst ANNOUNCER_ATTR = \"data-real-router-announcer\";\nconst INTERNAL_ROUTE_PREFIX = \"@@\";\nconst VISUALLY_HIDDEN =\n  \"position:absolute;width:1px;height:1px;padding:0;margin:-1px;overflow:hidden;clip:rect(0,0,0,0);clip-path:inset(50%);white-space:nowrap;border:0\";\n\nexport interface RouteAnnouncerOptions {\n  prefix?: string;\n  getAnnouncementText?: (route: State) => string;\n}\n\nexport function createRouteAnnouncer(\n  router: Router,\n  options?: RouteAnnouncerOptions,\n): { destroy: () => void } {\n  const prefix = options?.prefix ?? \"Navigated to \";\n  const getCustomText = options?.getAnnouncementText;\n\n  let isInitialNavigation = true;\n  let isReady = false;\n  let isDestroyed = false;\n  let lastAnnouncedText = \"\";\n  let clearTimeoutId: ReturnType<typeof setTimeout> | undefined;\n\n  const announcer = getOrCreateAnnouncer();\n\n  const safariTimeoutId = setTimeout(() => {\n    isReady = true;\n  }, SAFARI_READY_DELAY);\n\n  const unsubscribe = router.subscribe(({ route }) => {\n    if (isInitialNavigation) {\n      isInitialNavigation = false;\n\n      return;\n    }\n\n    requestAnimationFrame(() => {\n      requestAnimationFrame(() => {\n        if (isDestroyed) {\n          return;\n        }\n\n        const text = resolveText(route, prefix, getCustomText);\n\n        if (text && text !== lastAnnouncedText && isReady) {\n          lastAnnouncedText = text;\n          clearTimeout(clearTimeoutId);\n          announcer.textContent = text;\n          clearTimeoutId = setTimeout(() => {\n            announcer.textContent = \"\";\n            lastAnnouncedText = \"\";\n          }, CLEAR_DELAY);\n\n          manageFocus();\n        }\n      });\n    });\n  });\n\n  return {\n    destroy() {\n      isDestroyed = true;\n      unsubscribe();\n      clearTimeout(clearTimeoutId);\n      clearTimeout(safariTimeoutId);\n      removeAnnouncer();\n    },\n  };\n}\n\nfunction getOrCreateAnnouncer(): HTMLElement {\n  const existing = document.querySelector<HTMLElement>(`[${ANNOUNCER_ATTR}]`);\n\n  if (existing) {\n    return existing;\n  }\n\n  const element = document.createElement(\"div\");\n\n  element.setAttribute(\"style\", VISUALLY_HIDDEN);\n  element.setAttribute(\"aria-live\", \"assertive\");\n  element.setAttribute(\"aria-atomic\", \"true\");\n  element.setAttribute(ANNOUNCER_ATTR, \"\");\n\n  document.body.prepend(element);\n\n  return element;\n}\n\nfunction removeAnnouncer(): void {\n  document.querySelector(`[${ANNOUNCER_ATTR}]`)?.remove();\n}\n\nfunction resolveText(\n  route: State,\n  prefix: string,\n  getCustomText?: (route: State) => string,\n): string {\n  if (getCustomText) {\n    return getCustomText(route);\n  }\n\n  const h1 = document.querySelector<HTMLElement>(\"h1\");\n  const h1Text = h1?.textContent.trim() ?? \"\";\n  const routeName = route.name.startsWith(INTERNAL_ROUTE_PREFIX)\n    ? \"\"\n    : route.name;\n  const rawText =\n    h1Text || document.title || routeName || globalThis.location.pathname;\n\n  return `${prefix}${rawText}`;\n}\n\nfunction manageFocus(): void {\n  const h1 = document.querySelector<HTMLElement>(\"h1\");\n\n  if (!h1) {\n    return;\n  }\n\n  if (!h1.hasAttribute(\"tabindex\")) {\n    h1.setAttribute(\"tabindex\", \"-1\");\n  }\n\n  h1.focus({ preventScroll: true });\n}\n","import type { Router, Params } from \"@real-router/core\";\n\nexport function shouldNavigate(evt: MouseEvent): boolean {\n  return (\n    evt.button === 0 &&\n    !evt.metaKey &&\n    !evt.altKey &&\n    !evt.ctrlKey &&\n    !evt.shiftKey\n  );\n}\n\ntype BuildUrlFn = (name: string, params: Params) => string;\n\nexport function buildHref(\n  router: Router,\n  routeName: string,\n  routeParams: Params,\n): string | undefined {\n  try {\n    const buildUrl = router.buildUrl as BuildUrlFn | undefined;\n\n    if (buildUrl) {\n      return buildUrl(routeName, routeParams);\n    }\n\n    return router.buildPath(routeName, routeParams);\n  } catch {\n    console.error(\n      `[real-router] Route \"${routeName}\" is not defined. The element will render without an href attribute.`,\n    );\n\n    return undefined;\n  }\n}\n\nexport function buildActiveClassName(\n  isActive: boolean,\n  activeClassName: string | undefined,\n  baseClassName: string | undefined,\n): string | undefined {\n  if (isActive && activeClassName) {\n    return baseClassName\n      ? `${baseClassName} ${activeClassName}`.trim()\n      : activeClassName;\n  }\n\n  return baseClassName ?? undefined;\n}\n\nexport function applyLinkA11y(element: HTMLElement): void {\n  if (\n    element instanceof HTMLAnchorElement ||\n    element instanceof HTMLButtonElement\n  ) {\n    return;\n  }\n  if (!element.getAttribute(\"role\")) {\n    element.setAttribute(\"role\", \"link\");\n  }\n  if (!element.getAttribute(\"tabindex\")) {\n    element.setAttribute(\"tabindex\", \"0\");\n  }\n}\n","import { defineComponent, h, computed } from \"vue\";\n\nimport { useIsActiveRoute } from \"../composables/useIsActiveRoute\";\nimport { useRouter } from \"../composables/useRouter\";\nimport { EMPTY_PARAMS, EMPTY_OPTIONS } from \"../constants\";\nimport {\n  shouldNavigate,\n  buildHref,\n  buildActiveClassName,\n} from \"../dom-utils/index.js\";\n\nimport type { Params, NavigationOptions } from \"@real-router/core\";\nimport type { PropType } from \"vue\";\n\nexport const Link = defineComponent({\n  name: \"Link\",\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 = useIsActiveRoute(\n      props.routeName,\n      props.routeParams,\n      props.activeStrict,\n      props.ignoreQueryParams,\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      if (attrs.onClick && typeof attrs.onClick === \"function\") {\n        (attrs.onClick as (evt: MouseEvent) => void)(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      h(\n        \"a\",\n        {\n          ...attrs,\n          href: href.value,\n          class: finalClassName.value,\n          target: props.target,\n          onClick: handleClick,\n        },\n        slots.default?.(),\n      );\n  },\n});\n","import { createErrorSource } from \"@real-router/sources\";\n\nimport { useRefFromSource } from \"../useRefFromSource\";\nimport { useRouter } from \"./useRouter\";\n\nimport type { Router } from \"@real-router/core\";\nimport type { RouterErrorSnapshot, RouterSource } from \"@real-router/sources\";\nimport type { ShallowRef } from \"vue\";\n\nconst cache = new WeakMap<Router, RouterSource<RouterErrorSnapshot>>();\n\nexport function useRouterError(): ShallowRef<RouterErrorSnapshot> {\n  const router = useRouter();\n\n  let source = cache.get(router);\n\n  if (!source) {\n    source = createErrorSource(router);\n    cache.set(router, source);\n  }\n\n  return useRefFromSource(source);\n}\n","import { defineComponent, h, ref, watch, computed, Fragment } from \"vue\";\n\nimport { useRouterError } from \"../composables/useRouterError\";\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 snapshot = useRouterError();\n    const dismissedVersion = ref(-1);\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    const visibleError = computed(() =>\n      snapshot.value.version > dismissedVersion.value\n        ? snapshot.value.error\n        : null,\n    );\n\n    const resetError = () => {\n      dismissedVersion.value = snapshot.value.version;\n    };\n\n    return () => {\n      const children = slots.default?.() ?? [];\n      const errorVNode = visibleError.value\n        ? props.fallback(visibleError.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/index.js\";\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\nlet _router: Router | null = null;\n\nexport function setDirectiveRouter(router: Router): void {\n  _router = router;\n}\n\nexport function getDirectiveRouter(): Router {\n  if (!_router) {\n    /* v8 ignore next 3 -- @preserve Defensive: router always initialized by RouterProvider */\n    throw new Error(\n      \"v-link directive requires a RouterProvider ancestor. Make sure RouterProvider is mounted.\",\n    );\n  }\n\n  return _router;\n}\n\nconst clickHandlers = new WeakMap<HTMLElement, (evt: MouseEvent) => void>();\nconst keydownHandlers = new WeakMap<\n  HTMLElement,\n  (evt: KeyboardEvent) => void\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 handleClick = createClickHandler(router, value);\n  const handleKeyDown = createKeydownHandler(router, value, element);\n\n  element.addEventListener(\"click\", handleClick);\n  element.addEventListener(\"keydown\", handleKeyDown);\n\n  clickHandlers.set(element, handleClick);\n  keydownHandlers.set(element, handleKeyDown);\n}\n\nfunction detachHandlers(element: HTMLElement): void {\n  const clickHandler = clickHandlers.get(element);\n  const keydownHandler = keydownHandlers.get(element);\n\n  if (clickHandler) {\n    element.removeEventListener(\"click\", clickHandler);\n  }\n  if (keydownHandler) {\n    element.removeEventListener(\"keydown\", keydownHandler);\n  }\n\n  clickHandlers.delete(element);\n  keydownHandlers.delete(element);\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    attachHandlers(element, router, binding.value);\n  },\n\n  updated(element, binding) {\n    const router = getDirectiveRouter();\n\n    detachHandlers(element);\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\";\n\nexport const useRoute = (): RouteContext => {\n  const routeContext = inject(RouteKey);\n\n  if (!routeContext) {\n    throw new Error(\"useRoute must be used within a RouterProvider\");\n  }\n\n  return routeContext;\n};\n","import { createTransitionSource } 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\n  const source = createTransitionSource(router);\n\n  return useRefFromSource(source);\n}\n","import { getNavigator } from \"@real-router/core\";\nimport { createRouteSource } from \"@real-router/sources\";\nimport { shallowRef } from \"vue\";\n\nimport { NavigatorKey, RouteKey, RouterKey } from \"./context\";\nimport { setDirectiveRouter } from \"./directives/vLink\";\n\nimport type { Router } from \"@real-router/core\";\nimport type { Plugin } from \"vue\";\n\nexport function createRouterPlugin(router: Router): Plugin<[]> {\n  return {\n    install(app): void {\n      const navigator = getNavigator(router);\n\n      setDirectiveRouter(router);\n\n      const source = createRouteSource(router);\n      const initialSnapshot = source.getSnapshot();\n\n      const route = shallowRef(initialSnapshot.route);\n      const previousRoute = shallowRef(initialSnapshot.previousRoute);\n\n      source.subscribe(() => {\n        const snapshot = source.getSnapshot();\n\n        route.value = snapshot.route;\n        previousRoute.value = snapshot.previousRoute;\n      });\n\n      app.provide(RouterKey, router);\n      app.provide(NavigatorKey, navigator);\n      app.provide(RouteKey, { navigator, route, previousRoute });\n    },\n  };\n}\n","import { getNavigator } from \"@real-router/core\";\nimport { createRouteSource } from \"@real-router/sources\";\nimport {\n  defineComponent,\n  onMounted,\n  onUnmounted,\n  provide,\n  shallowRef,\n  onScopeDispose,\n} from \"vue\";\n\nimport { NavigatorKey, RouteKey, RouterKey } from \"./context\";\nimport { setDirectiveRouter } from \"./directives/vLink\";\nimport { createRouteAnnouncer } from \"./dom-utils/index.js\";\n\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  },\n  setup(props, { slots }) {\n    onMounted(() => {\n      if (!props.announceNavigation) {\n        return;\n      }\n\n      const announcer = createRouteAnnouncer(props.router);\n\n      onUnmounted(() => {\n        announcer.destroy();\n      });\n    });\n\n    const navigator = getNavigator(props.router);\n\n    setDirectiveRouter(props.router);\n\n    const source = createRouteSource(props.router);\n    const initialSnapshot = source.getSnapshot();\n\n    const route = shallowRef(initialSnapshot.route);\n    const previousRoute = shallowRef(initialSnapshot.previousRoute);\n\n    const unsub = source.subscribe(() => {\n      const snapshot = source.getSnapshot();\n\n      route.value = snapshot.route;\n      previousRoute.value = snapshot.previousRoute;\n    });\n\n    onScopeDispose(unsub);\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":[],"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/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/setupRouteProvision.ts","../../src/createRouterPlugin.ts","../../src/RouterProvider.ts"],"sourcesContent":["import { defineComponent } from \"vue\";\n\nimport type { 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\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 } from \"./components\";\n\nimport type { VNode } from \"vue\";\n\ntype FallbackType = VNode | (() => VNode) | undefined;\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 (child.type === Match || child.type === NotFound) {\n      result.push(child);\n    } else if (child.type === Fragment) {\n      collectElements(child.children, result);\n    }\n  }\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  let notFoundChildren: unknown = null;\n  let activeMatchFound = false;\n  let fallback: FallbackType = undefined;\n  const rendered: VNode[] = [];\n\n  for (const child of elements) {\n    if (child.type === NotFound) {\n      notFoundChildren = child.children;\n      continue;\n    }\n\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 =\n      !activeMatchFound && isSegmentMatch(routeName, fullSegmentName, exact);\n\n    if (isActive) {\n      activeMatchFound = true;\n      fallback = props?.fallback;\n      rendered.push(child);\n    }\n  }\n\n  if (\n    !activeMatchFound &&\n    routeName === UNKNOWN_ROUTE &&\n    notFoundChildren !== null\n  ) {\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 { 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 } 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\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?: boolean;\n  } | null;\n\n  if (matchProps?.keepAlive === true && 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          (element.props as { keepAlive?: boolean } | null)?.keepAlive === true,\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 (activeChild.type !== Match && activeChild.type !== NotFound) {\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, { Match, NotFound });\n\nexport type {\n  RouteViewProps,\n  MatchProps as RouteViewMatchProps,\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, 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 {\n  shouldNavigate,\n  buildHref,\n  buildActiveClassName,\n} from \"../dom-utils/index.js\";\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/index.js\";\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\";\n\nexport const useRoute = (): RouteContext => {\n  const routeContext = inject(RouteKey);\n\n  if (!routeContext) {\n    throw new Error(\"useRoute must be used within a RouterProvider\");\n  }\n\n  return routeContext;\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","// 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 { createRouteAnnouncer } from \"./dom-utils/index.js\";\nimport { setupRouteProvision } from \"./setupRouteProvision\";\n\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  },\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    // 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.4.1",
+  "version": "0.5.1",
   "type": "commonjs",
   "description": "Vue 3 integration for Real-Router",
   "main": "./dist/cjs/index.js",
@@ -52,25 +52,25 @@
   "dependencies": {
     "@real-router/core": "^0.48.0",
     "@real-router/route-utils": "^0.2.1",
-    "@real-router/sources": "^0.5.1"
+    "@real-router/sources": "^0.6.0"
   },
   "devDependencies": {
     "@testing-library/jest-dom": "6.9.1",
     "@vue/test-utils": "2.4.6",
     "vue": "3.5.13",
-    "@real-router/browser-plugin": "^0.12.1"
+    "@real-router/browser-plugin": "^0.13.0"
   },
   "peerDependencies": {
     "vue": ">=3.3.0"
   },
   "scripts": {
-    "build": "tsdown --config-loader unrun",
     "test": "vitest",
     "test:properties": "vitest run --config vitest.config.properties.mts",
     "test:stress": "vitest run --config vitest.config.stress.mts",
     "type-check": "tsc --noEmit",
     "lint": "eslint --cache src/ tests/ --fix --max-warnings 0",
     "lint:package": "publint",
-    "lint:types": "attw --pack ."
+    "lint:types": "attw --pack .",
+    "bundle": "tsdown --config-loader unrun"
   }
 }

package/src/RouterProvider.ts

@@ -1,17 +1,9 @@
-import { getNavigator } from "@real-router/core";
-import { createRouteSource } from "@real-router/sources";
-import {
-  defineComponent,
-  onMounted,
-  onUnmounted,
-  provide,
-  shallowRef,
-  onScopeDispose,
-} from "vue";
+import { defineComponent, onScopeDispose, provide, watch } from "vue";
 
 import { NavigatorKey, RouteKey, RouterKey } from "./context";
-import { setDirectiveRouter } from "./directives/vLink";
+import { pushDirectiveRouter } from "./directives/vLink";
 import { createRouteAnnouncer } from "./dom-utils/index.js";
+import { setupRouteProvision } from "./setupRouteProvision";
 
 import type { Router } from "@real-router/core";
 import type { PropType } from "vue";
@@ -29,37 +21,38 @@ export const RouterProvider = defineComponent({
     },
   },
   setup(props, { slots }) {
-    onMounted(() => {
-      if (!props.announceNavigation) {
-        return;
-      }
-
-      const announcer = createRouteAnnouncer(props.router);
-
-      onUnmounted(() => {
-        announcer.destroy();
-      });
-    });
-
-    const navigator = getNavigator(props.router);
-
-    setDirectiveRouter(props.router);
-
-    const source = createRouteSource(props.router);
-    const initialSnapshot = source.getSnapshot();
-
-    const route = shallowRef(initialSnapshot.route);
-    const previousRoute = shallowRef(initialSnapshot.previousRoute);
-
-    const unsub = source.subscribe(() => {
-      const snapshot = source.getSnapshot();
-
-      route.value = snapshot.route;
-      previousRoute.value = snapshot.previousRoute;
+    // Reactive announceNavigation: setting prop true/false at runtime now
+    // creates/destroys the announcer accordingly. Prior implementation read
+    // the prop only inside onMounted, so toggling it post-mount silently no-op'd.
+    watch(
+      () => [props.router, props.announceNavigation] as const,
+      ([router, enabled], _prev, onCleanup) => {
+        if (!enabled) {
+          return;
+        }
+
+        const announcer = createRouteAnnouncer(router);
+
+        onCleanup(() => {
+          announcer.destroy();
+        });
+      },
+      { immediate: true },
+    );
+
+    // Push this provider's router on the v-link directive stack so nested
+    // RouterProviders behave like nested DI scopes (LIFO). Release on unmount
+    // restores the outer router for any v-link still mounted in the parent.
+    const releaseDirective = pushDirectiveRouter(props.router);
+
+    const { navigator, route, previousRoute, unsubscribe } =
+      setupRouteProvision(props.router);
+
+    onScopeDispose(() => {
+      releaseDirective();
+      unsubscribe();
     });
 
-    onScopeDispose(unsub);
-
     provide(RouterKey, props.router);
     provide(NavigatorKey, navigator);
     provide(RouteKey, { navigator, route, previousRoute });

package/src/components/Link.ts

@@ -1,6 +1,6 @@
-import { defineComponent, h, computed } from "vue";
+import { createActiveRouteSource } from "@real-router/sources";
+import { defineComponent, h, computed, shallowRef, watch } from "vue";
 
-import { useIsActiveRoute } from "../composables/useIsActiveRoute";
 import { useRouter } from "../composables/useRouter";
 import { EMPTY_PARAMS, EMPTY_OPTIONS } from "../constants";
 import {
@@ -12,8 +12,40 @@ import {
 import type { Params, NavigationOptions } from "@real-router/core";
 import type { PropType } from "vue";
 
+type OnClickHandler = (evt: MouseEvent) => void;
+
+/**
+ * Vue's compiled template binds multiple `@click` handlers as an array.
+ * Single render-function `onClick` is a function. Both must be invoked.
+ */
+function invokeAttributesOnClick(value: unknown, evt: MouseEvent): void {
+  if (typeof value === "function") {
+    (value as OnClickHandler)(evt);
+
+    return;
+  }
+  if (Array.isArray(value)) {
+    const handlers = value as OnClickHandler[];
+
+    for (const fn of handlers) {
+      if (typeof fn === "function") {
+        fn(evt);
+
+        if (evt.defaultPrevented) {
+          return;
+        }
+      }
+    }
+  }
+}
+
 export const Link = defineComponent({
   name: "Link",
+  // Disable Vue's automatic attribute fallthrough. Without this, attrs.onClick
+  // (function OR array) is auto-attached as a native click listener AND our
+  // explicit onClick fires too — user handlers are double-invoked. We invoke
+  // attrs.onClick manually inside handleClick to preserve preventDefault.
+  inheritAttrs: false,
   props: {
     routeName: {
       type: String,
@@ -51,11 +83,39 @@ export const Link = defineComponent({
   setup(props, { slots, attrs }) {
     const router = useRouter();
 
-    const isActive = useIsActiveRoute(
-      props.routeName,
-      props.routeParams,
-      props.activeStrict,
-      props.ignoreQueryParams,
+    const isActive = shallowRef(false);
+
+    // watch with an explicit dep getter recreates the source ONLY when
+    // routeName/routeParams/strict/ignoreQueryParams change — not on every
+    // reactive read inside the source factory (the watchEffect alternative
+    // would also re-subscribe whenever isActive itself changed).
+    watch(
+      () =>
+        [
+          props.routeName,
+          props.routeParams,
+          props.activeStrict,
+          props.ignoreQueryParams,
+        ] as const,
+      (
+        [routeName, routeParams, activeStrict, ignoreQueryParams],
+        _prev,
+        onCleanup,
+      ) => {
+        const source = createActiveRouteSource(router, routeName, routeParams, {
+          strict: activeStrict,
+          ignoreQueryParams,
+        });
+
+        isActive.value = source.getSnapshot();
+
+        const unsub = source.subscribe(() => {
+          isActive.value = source.getSnapshot();
+        });
+
+        onCleanup(unsub);
+      },
+      { immediate: true, flush: "sync" },
     );
 
     const href = computed(() =>
@@ -67,8 +127,12 @@ export const Link = defineComponent({
     );
 
     const handleClick = (evt: MouseEvent) => {
-      if (attrs.onClick && typeof attrs.onClick === "function") {
-        (attrs.onClick as (evt: MouseEvent) => void)(evt);
+      // Vue allows attrs.onClick to be a function or an array of functions
+      // (compiled templates with multiple @click bindings produce arrays).
+      // Both must be invoked; treating arrays as "no handler" silently drops
+      // user code.
+      if (attrs.onClick !== undefined && attrs.onClick !== null) {
+        invokeAttributesOnClick(attrs.onClick, evt);
 
         if (evt.defaultPrevented) {
           return;
@@ -85,11 +149,24 @@ export const Link = defineComponent({
         .catch(() => {});
     };
 
-    return () =>
-      h(
+    return () => {
+      // Build forwarded attrs without `onClick`. Vue's runtime auto-attaches
+      // attrs.onClick (function OR array) as a native DOM listener, which would
+      // double-invoke user handlers when combined with our explicit `onClick`.
+      // We invoke the original attrs.onClick manually inside handleClick so the
+      // preventDefault contract is preserved.
+      const restAttributes: Record<string, unknown> = {};
+
+      for (const key of Object.keys(attrs)) {
+        if (key !== "onClick") {
+          restAttributes[key] = (attrs as Record<string, unknown>)[key];
+        }
+      }
+
+      return h(
         "a",
         {
-          ...attrs,
+          ...restAttributes,
           href: href.value,
           class: finalClassName.value,
           target: props.target,
@@ -97,5 +174,6 @@ export const Link = defineComponent({
         },
         slots.default?.(),
       );
+    };
   },
 });

package/src/components/RouteView/RouteView.ts

@@ -147,6 +147,31 @@ const RouteViewComponent = defineComponent({
     const routeContext = useRouteNode(props.nodeName);
     const wrapperCache = new Map<string, Component>();
 
+    // Cache per-Match `keepAlive` detection by slot output identity. Slot
+    // contents change reference only when the parent re-renders with new
+    // children, so steady-state navigations skip the O(n) `.some(...)` scan.
+    let lastSlotOutput: unknown = null;
+    let lastHasPerMatchKA = false;
+
+    function detectPerMatchKA(elements: VNode[], slotOutput: unknown): boolean {
+      /* v8 ignore next 3 -- @preserve: Vue's compiled slot wrapper allocates a
+         new array per render call in JSDOM tests; identity-cache hits in
+         production where parent compiled templates share slot output, but
+         is unobservable through TestBed-style assertions. */
+      if (slotOutput === lastSlotOutput) {
+        return lastHasPerMatchKA;
+      }
+
+      lastSlotOutput = slotOutput;
+      lastHasPerMatchKA = elements.some(
+        (element) =>
+          element.type === Match &&
+          (element.props as { keepAlive?: boolean } | null)?.keepAlive === true,
+      );
+
+      return lastHasPerMatchKA;
+    }
+
     return (): VNode | null => {
       const route = routeContext.route.value;
 
@@ -154,9 +179,10 @@ const RouteViewComponent = defineComponent({
         return null;
       }
 
+      const slotOutput = slots.default?.();
       const elements: VNode[] = [];
 
-      collectElements(slots.default?.(), elements);
+      collectElements(slotOutput, elements);
 
       const { rendered, fallback } = buildRenderList(
         elements,
@@ -180,11 +206,7 @@ const RouteViewComponent = defineComponent({
       }
       /* v8 ignore stop */
 
-      const hasPerMatchKA = elements.some(
-        (element) =>
-          element.type === Match &&
-          (element.props as { keepAlive?: boolean } | null)?.keepAlive === true,
-      );
+      const hasPerMatchKA = detectPerMatchKA(elements, slotOutput);
 
       if (hasPerMatchKA) {
         return renderWithPerMatchKA(activeChild, wrapperCache, fallback);

package/src/components/RouterErrorBoundary.ts

@@ -1,6 +1,8 @@
-import { defineComponent, h, ref, watch, computed, Fragment } from "vue";
+import { createDismissableError } from "@real-router/sources";
+import { defineComponent, h, watch, Fragment } from "vue";
 
-import { useRouterError } from "../composables/useRouterError";
+import { useRouter } from "../composables/useRouter";
+import { useRefFromSource } from "../useRefFromSource";
 
 import type { RouterError, State } from "@real-router/core";
 import type { VNode, PropType } from "vue";
@@ -26,8 +28,8 @@ export const RouterErrorBoundary = defineComponent({
     },
   },
   setup(props, { slots }) {
-    const snapshot = useRouterError();
-    const dismissedVersion = ref(-1);
+    const router = useRouter();
+    const snapshot = useRefFromSource(createDismissableError(router));
 
     watch(
       () => snapshot.value.version,
@@ -43,20 +45,10 @@ export const RouterErrorBoundary = defineComponent({
       { immediate: true },
     );
 
-    const visibleError = computed(() =>
-      snapshot.value.version > dismissedVersion.value
-        ? snapshot.value.error
-        : null,
-    );
-
-    const resetError = () => {
-      dismissedVersion.value = snapshot.value.version;
-    };
-
     return () => {
       const children = slots.default?.() ?? [];
-      const errorVNode = visibleError.value
-        ? props.fallback(visibleError.value, resetError)
+      const errorVNode = snapshot.value.error
+        ? props.fallback(snapshot.value.error, snapshot.value.resetError)
         : null;
 
       return h(Fragment, null, [...children, errorVNode]);

package/src/composables/useRouteNode.ts

@@ -1,12 +1,11 @@
 import { getNavigator } from "@real-router/core";
 import { createRouteNodeSource } from "@real-router/sources";
-import { shallowRef, watch } from "vue";
+import { computed } from "vue";
 
 import { useRefFromSource } from "../useRefFromSource";
 import { useRouter } from "./useRouter";
 
 import type { RouteContext } from "../types";
-import type { State } from "@real-router/core";
 
 export function useRouteNode(nodeName: string): RouteContext {
   const router = useRouter();
@@ -14,21 +13,15 @@ export function useRouteNode(nodeName: string): RouteContext {
   const source = createRouteNodeSource(router, nodeName);
   const snapshot = useRefFromSource(source);
 
+  // getNavigator is WeakMap-cached in core; no useMemo equivalent needed.
   const navigator = getNavigator(router);
 
-  const route = shallowRef<State | undefined>(snapshot.value.route);
-  const previousRoute = shallowRef<State | undefined>(
-    snapshot.value.previousRoute,
-  );
-
-  watch(
-    snapshot,
-    (newSnapshot) => {
-      route.value = newSnapshot.route;
-      previousRoute.value = newSnapshot.previousRoute;
-    },
-    { flush: "sync" },
-  );
+  // Derive route/previousRoute via computed instead of mirroring with a sync
+  // watch into two extra shallowRefs. computed shares snapshot's identity so
+  // when the underlying source emits the same reference (idempotent or
+  // out-of-node nav), consumers don't see a new ref.
+  const route = computed(() => snapshot.value.route);
+  const previousRoute = computed(() => snapshot.value.previousRoute);
 
   return {
     navigator,