@real-router/vue 0.12.0 → 0.13.0

package/dist/cjs/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":["Fragment","UNKNOWN_ROUTE","Suspense","KeepAlive","Fragment","NOOP_INSTANCE","Fragment"],"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":"kOAKA,SAAS,GAAa,CACpB,OAAO,KAGT,MAAa,GAAA,EAAA,EAAA,iBAAwB,CACnC,KAAM,kBACN,MAAO,CACL,QAAS,CACP,KAAM,OACN,SAAU,GACX,CACD,MAAO,CACL,KAAM,QACN,QAAS,GACV,CACD,SAAU,CACR,KAAM,CAAC,OAAQ,SAAS,CACxB,QAAS,IAAA,GACV,CACD,UAAW,CACT,KAAM,QACN,QAAS,GACV,CACF,CACD,OAAQ,EACT,CAAC,CAiBW,GAXP,EAAA,EAAA,iBAA2B,CAC/B,KAAM,iBACN,MAAO,CACL,SAAU,CACR,KAAM,CAAC,OAAQ,SAAS,CACxB,QAAS,IAAA,GACV,CACF,CACD,OAAQ,EACT,CAAC,CAIW,GAAA,EAAA,EAAA,iBAA2B,CACtC,KAAM,qBACN,OAAQ,EACT,CAAC,CCpCF,SAAS,EACP,EACA,EACA,EACS,CAKT,OAJI,EACK,IAAc,GAGvB,EAAA,EAAA,mBAAyB,EAAW,EAAgB,CAGtD,SAAS,EAAkB,EAA4B,CACrD,GAAI,MAAM,QAAQ,EAAS,CAAE,CAC3B,IAAM,EAAkB,EAAE,CAE1B,IAAK,IAAM,KAAS,EACd,MAAM,QAAQ,EAAM,CACtB,EAAO,KAAK,GAAG,EAAkB,EAAM,CAAC,eACvB,EAAM,EACvB,EAAO,KAAK,EAAM,CAItB,OAAO,EAOT,OAJA,EAAA,EAAA,SAAY,EAAS,CACZ,CAAC,EAAS,CAGZ,EAAE,CAGX,SAAgB,EAAgB,EAAmB,EAAuB,CACxE,IAAM,EAAS,EAAkB,EAAS,CAE1C,IAAK,IAAM,KAAS,EAEhB,EAAM,OAAS,GACf,EAAM,OAAS,GACf,EAAM,OAAS,EAEf,EAAO,KAAK,EAAM,CACT,EAAM,OAASA,EAAAA,UACxB,EAAgB,EAAM,SAAU,EAAO,CAK7C,SAAS,EAAe,EAAc,EAA+B,CAkBnE,OAjBI,EAAM,OAAS,GACjB,EAAM,iBAAmB,EAAM,SAExB,IAGL,EAAM,OAAS,GACb,EAAM,YAAc,OACtB,EAAM,UAAY,EAGlB,EAAM,aAFQ,EAAM,OAEQ,UAGvB,IAGF,GAGT,SAAS,EACP,EACA,EACA,EAC+C,CAC/C,IAAM,EAAQ,EAAM,MAKd,EAAU,GAAO,SAAW,GAC5B,EAAQ,GAAO,OAAS,GAI9B,MAAO,CAAE,SAFQ,EAAe,EADR,EAAW,GAAG,EAAS,GAAG,IAAY,EACF,EAAM,CAE/C,SAAU,GAAO,SAAU,CAGhD,SAAS,EACP,EACA,EACA,EACA,EACA,EACc,CACd,GAAI,EAAM,YAAc,MAAQ,IAAc,EAG5C,OAFA,EAAS,KAAK,EAAM,UAAU,CAEvB,EAAM,aAGf,GAAI,IAAcC,EAAAA,eAAiB,EAAM,mBAAqB,KAAM,CAGlE,IAAM,EAFa,EAAS,OAAQ,GAAY,EAAQ,OAAS,EAAS,CAEhD,GAAG,GAAG,CAE5B,GACF,EAAS,KAAK,EAAO,EAO3B,SAAgB,EACd,EACA,EACA,EAKA,CACA,IAAM,EAAuB,CAC3B,UAAW,KACX,aAAc,IAAA,GACd,iBAAkB,KACnB,CACG,EAAmB,GACnB,EACE,EAAoB,EAAE,CAE5B,IAAK,IAAM,KAAS,EAAU,CAK5B,GAJI,EAAe,EAAO,EAAM,EAI5B,EACF,SAGF,IAAM,EAAS,EAAc,EAAO,EAAW,EAAS,CAEpD,EAAO,WACT,EAAmB,GACnB,EAAW,EAAO,SAClB,EAAS,KAAK,EAAM,EAQxB,OAJK,IACH,EAAW,EAAe,EAAU,EAAW,EAAU,EAAO,EAAS,EAGpE,CAAE,WAAU,mBAAkB,WAAU,CCtKjD,SAAgB,EAAoB,EAAwC,CAC1E,IAAM,GAAA,EAAA,EAAA,YAAiB,EAAO,aAAa,CAAC,CAQ5C,OAFA,EAAA,EAAA,gBAJc,EAAO,cAAgB,CACnC,EAAI,MAAQ,EAAO,aAAa,EAChC,CAEmB,CAEd,ECVT,MAAa,EAAkC,OAAO,YAAY,CAErD,EAAwC,OAAO,eAAe,CAE9D,EAA2C,OAAO,WAAW,CCF7D,MAA0B,CACrC,IAAM,GAAA,EAAA,EAAA,QAAgB,EAAU,CAEhC,GAAI,CAAC,EACH,MAAU,MAAM,iDAAiD,CAGnE,OAAO,GCJT,SAAgB,EAAa,EAAgC,CAC3D,IAAM,EAAS,GAAW,CAGpB,EAAW,GAAA,EAAA,EAAA,uBADoB,EAAQ,EAAS,CACb,CAYzC,MAAO,CACL,WAAA,EAAA,EAAA,cAV6B,EAAO,CAWpC,OAAA,EAAA,EAAA,cAL2B,EAAS,MAAM,MAAM,CAMhD,eAAA,EAAA,EAAA,cALmC,EAAS,MAAM,cAAc,CAMjE,CCZH,SAAS,EAAe,EAA8B,CAGpD,OAFc,EAAM,UAEN,WAAW,EAAI,KAG/B,SAAS,EACP,EACA,EACW,CACX,IAAM,EAAW,EAAM,IAAI,EAAQ,CAEnC,GAAI,EACF,OAAO,EAGT,IAAM,GAAA,EAAA,EAAA,UAAA,EAAA,EAAA,iBACY,CACd,KAAM,aAAa,IACnB,MAAM,EAAe,EAAY,CAC/B,UAAa,EAAW,MAAM,WAAW,EAE5C,CAAC,CACH,CAID,OAFA,EAAM,IAAI,EAAS,EAAQ,CAEpB,EAGT,SAAS,EAAiB,EAAgB,EAA0B,CAClE,GAAI,IAAa,IAAA,GACf,OAAO,EAGT,IAAM,EACJ,OAAO,GAAa,WAAc,GAA0B,CAAG,EAKjE,OAAA,EAAA,EAAA,GAF0BC,EAAAA,SAIxB,EAAE,CACF,CACE,YAAe,EACf,aAAgB,EACjB,CACF,CAGH,MAAM,IAAA,EAAA,EAAA,UAAA,EAAA,EAAA,iBACY,CACd,KAAM,wBACN,QAAS,CACP,OAAO,MAEV,CAAC,CACH,CAED,SAAS,GACP,EACA,EACA,EACO,CAEP,IAAM,EADc,EAAY,OACH,SAAW,gBAClC,EAAmB,EAAmB,EAAc,EAAQ,CAC5D,EAAc,EAAe,EAAY,EAAI,EAAE,CAMrD,OAAO,GAAA,EAAA,EAAA,GALoBC,EAAAA,UAAW,KAAM,CAC1C,aAAA,EAAA,EAAA,GACI,EAAkB,CAAE,IAAK,EAAS,CAAE,CAAE,YAAe,EAAa,CAAC,CACxE,CAAC,CAEwC,EAAS,CAUrD,SAAS,EAAmB,EAAyB,CACnD,OAAO,IAAU,IAAQ,IAAU,IAAM,IAAU,aAGrD,SAAS,GACP,EACA,EACA,EACc,CACd,IAAM,EAAa,EAAY,MAK/B,GAAI,EAAmB,GAAY,UAAU,EAAI,EAAY,OAAS,EAAO,CAE3E,IAAM,EAAU,GAAY,SAAW,gBAEjC,EAAmB,EAAmB,EAAc,EAAQ,CAC5D,EAAc,EAAe,EAAY,EAAI,EAAE,CAErD,OAAA,EAAA,EAAA,GAASC,EAAAA,SAAU,EAAA,EAAA,EAAA,GACfD,EAAAA,UAAW,KAAM,CACjB,aAAA,EAAA,EAAA,GACI,EAAkB,CAAE,IAAK,EAAS,CAAE,CAAE,YAAe,EAAa,CAAC,CACxE,CAAC,CACH,CAAC,CAGJ,IAAM,EAAU,EAAe,EAAY,CAQ3C,OALK,GAKL,EAAA,EAAA,GAASC,EAAAA,SAAU,EAAA,EAAA,EAAA,GACfD,EAAAA,UAAW,KAAM,CAAE,aAAA,EAAA,EAAA,GAAiB,GAA0B,CAAE,CAAC,CACnE,GAAA,EAAA,EAAA,GAAmBC,EAAAA,SAAU,EAAQ,CAAE,EAAS,CACjD,CAAC,CAPO,KAUX,MAAM,GAAA,EAAA,EAAA,iBAAqC,CACzC,KAAM,YACN,MAAO,CACL,SAAU,CACR,KAAM,OACN,SAAU,GACX,CACD,UAAW,CACT,KAAM,QACN,QAAS,GACV,CACF,CACD,MAAM,EAAO,CAAE,SAAS,CACtB,IAAM,EAAe,EAAa,EAAM,SAAS,CAC3C,EAAe,IAAI,IAKrB,EAA0B,KAC1B,EAAoB,GAExB,SAAS,EAAiB,EAAmB,EAA8B,CAkBzE,OAbI,IAAe,EACV,GAGT,EAAiB,EACjB,EAAoB,EAAS,KAC1B,GACC,EAAQ,OAAS,GACjB,EACG,EAAQ,OAA0C,UACpD,CACJ,CAEM,GAGT,UAA2B,CACzB,IAAM,EAAQ,EAAa,MAAM,MAEjC,GAAI,CAAC,EACH,OAAO,KAGT,IAAM,EAAa,EAAM,WAAW,CAC9B,EAAoB,EAAE,CAE5B,EAAgB,EAAY,EAAS,CAErC,GAAM,CAAE,WAAU,YAAa,EAC7B,EACA,EAAM,KACN,EAAM,SACP,CAED,GAAI,EAAS,SAAW,EACtB,OAAO,KAGT,IAAM,EAAc,EAAS,GAE7B,GAAI,EAAM,UACR,OAAO,GAAiB,EAAa,EAAc,EAAS,CAI9D,GACE,EAAY,OAAS,GACrB,EAAY,OAAS,GACrB,EAAY,OAAS,EAErB,OAAO,KAMT,GAFsB,EAAiB,EAAU,EAAW,CAG1D,OAAO,GAAqB,EAAa,EAAc,EAAS,CAGlE,IAAM,EAAU,EAAe,EAAY,CAM3C,OAJK,EAIE,GAAA,EAAA,EAAA,GAAmBA,EAAAA,SAAU,EAAQ,CAAE,EAAS,CAH9C,OAMd,CAAC,CAEW,EAAY,OAAO,OAAO,EAAoB,CACzD,QACA,OACA,WACD,CAAC,CCnPW,GAAe,OAAO,OAAO,EAAE,CAAC,CAKhC,GAAgB,OAAO,OAAO,EAAE,CAAC,CCJxC,EAAiB,6BAUvB,SAAgB,GACd,EACA,EACyB,CACzB,IAAM,EAAS,GAAS,QAAU,gBAC5B,EAAgB,GAAS,oBAE3B,EAAsB,GACtB,EAAU,GACV,EAAc,GACd,EAAoB,GACpB,EAA6B,KAC7B,EAEE,EAAY,IAAsB,CAElC,GAAc,EAAc,IAAiC,CACjE,EAAoB,EACpB,aAAa,EAAe,CAC5B,EAAU,YAAc,EACxB,EAAiB,eAAiB,CAChC,EAAU,YAAc,GACxB,EAAoB,IACnB,IAAY,CAEf,GAAY,EAAG,EAOX,EAAkB,eAAiB,CAGvC,GAFA,EAAU,GAEN,IAAgB,MAAQ,CAAC,EAAa,CACxC,IAAM,EAAO,EAEb,EAAc,KACd,EAAW,EAAM,SAAS,cAA2B,KAAK,CAAC,GAE5D,IAAmB,CAEhB,EAAc,EAAO,WAAW,CAAE,WAAY,CAClD,GAAI,EAAqB,CACvB,EAAsB,GAEtB,OAQF,0BAA4B,CAC1B,0BAA4B,CAC1B,GAAI,EACF,OAGF,IAAM,EAAK,SAAS,cAA2B,KAAK,CAC9C,EAAO,GAAY,EAAO,EAAQ,EAAe,EAAG,CAEtD,MAAC,GAAQ,IAAS,GAItB,IAAI,CAAC,EAAS,CAEZ,EAAc,EAEd,OAGF,EAAW,EAAM,EAAG,GACpB,EACF,EACF,CAEF,MAAO,CACL,SAAU,CACR,EAAc,GACd,GAAa,CACb,aAAa,EAAe,CAC5B,aAAa,EAAgB,CAC7B,IAAiB,EAEpB,CAGH,SAAS,IAAoC,CAC3C,IAAM,EAAW,SAAS,cAA2B,IAAI,EAAe,GAAG,CAE3E,GAAI,EACF,OAAO,EAGT,IAAM,EAAU,SAAS,cAAc,MAAM,CAS7C,OAPA,EAAQ,aAAa,QAAS,mJAAgB,CAC9C,EAAQ,aAAa,YAAa,YAAY,CAC9C,EAAQ,aAAa,cAAe,OAAO,CAC3C,EAAQ,aAAa,EAAgB,GAAG,CAExC,SAAS,KAAK,QAAQ,EAAQ,CAEvB,EAGT,SAAS,IAAwB,CAC/B,SAAS,cAAc,IAAI,EAAe,GAAG,EAAE,QAAQ,CAGzD,SAAS,GACP,EACA,EACA,EACA,EACQ,CACR,GAAI,EACF,OAAO,EAAc,EAAM,CAG7B,IAAM,GAAU,GAAI,aAAe,IAAI,MAAM,CACvC,EAAY,EAAM,KAAK,WAAW,KAAsB,CAC1D,GACA,EAAM,KAIV,MAAO,GAAG,IAFR,GAAU,SAAS,OAAS,GAAa,WAAW,SAAS,WAKjE,SAAS,GAAY,EAA8B,CAC5C,IAIA,EAAG,aAAa,WAAW,EAC9B,EAAG,aAAa,WAAY,KAAK,CAGnC,EAAG,MAAM,CAAE,cAAe,GAAM,CAAC,EC3JnC,MAEMC,EAAyC,OAAO,OAAO,CAC3D,YAAe,GAGhB,CAAC,CAoCF,SAAgB,GACd,EACA,EACyB,CACzB,GAAW,WAAW,SAAW,OAC/B,OAAOA,EAGT,IAAM,EAAO,GAAS,MAAQ,UAQ9B,GAAI,IAAS,SACX,OAAOA,EAGT,IAAM,EAAgB,GAAS,iBAAmB,GAC5C,EAAe,GAAS,gBACxB,EAA2B,GAAS,UAAY,OAChD,EAAa,GAAS,YAAc,qBAEpC,MAA0C,CAC9C,GAAI,CACF,IAAM,EAAM,eAAe,QAAQ,EAAW,CAE9C,OAAO,EAAO,KAAK,MAAM,EAAI,CAA8B,EAAE,MACvD,CACN,MAAO,EAAE,GAIP,GAAU,EAAa,IAAsB,CACjD,GAAI,CACF,IAAM,EAAQ,GAAW,CAEzB,EAAM,GAAO,EACb,eAAe,QAAQ,EAAY,KAAK,UAAU,EAAM,CAAC,MACnD,IAKJ,EAAwB,QAAQ,kBAEtC,GAAI,CACF,QAAQ,kBAAoB,cACtB,EAOR,IAAM,MAAwB,CAC5B,IAAM,EAAU,KAAgB,CAEhC,OAAO,EAAU,EAAQ,UAAY,WAAW,SAG5C,EAAY,GAAsB,CACtC,IAAM,EAAU,KAAgB,CAE5B,EACF,EAAQ,SAAS,CAAE,MAAK,KAAM,EAAG,WAAU,CAAC,CAE5C,WAAW,SAAS,CAAE,MAAK,KAAM,EAAG,WAAU,CAAC,EAI7C,EAAqB,GAAuB,CAKhD,IAAM,EAAW,EAAM,SACnB,KAAK,KAET,GAAI,IAAY,IAAA,GAAW,CACzB,GAAI,GAAiB,EAAQ,OAAS,EAAG,CAEvC,IAAM,EAAU,SAAS,eAAe,EAAQ,CAEhD,GAAI,EAAS,CACX,EAAQ,eAAe,CAAE,WAAU,CAAC,CAEpC,QAIJ,EAAS,EAAE,CAEX,OAOF,IAAM,EAAO,WAAW,SAAS,KAEjC,GAAI,GAAiB,EAAK,OAAS,EAAG,CACpC,IAAI,EAEJ,GAAI,CACF,EAAK,mBAAmB,EAAK,MAAM,EAAE,CAAC,MAChC,CACN,EAAK,EAAK,MAAM,EAAE,CAIpB,IAAM,EAAU,SAAS,eAAe,EAAG,CAE3C,GAAI,EAAS,CACX,EAAQ,eAAe,CAAE,WAAU,CAAC,CAEpC,QAIJ,EAAS,EAAE,EAGT,EAAY,GAEV,EAAc,EAAO,WAAW,CAAE,QAAO,mBAAoB,CACjE,IAAM,EAAO,EAAM,QAChB,WAKC,GACF,EAAO,EAAM,EAAc,CAAE,GAAS,CAAC,CAKzC,0BAA4B,CACtB,MAIJ,IAAI,IAAS,OAAS,CAAC,EAAK,CAC1B,EAAkB,EAAM,CAExB,OAGE,KAAI,iBAAmB,UAI3B,IACE,EAAI,YAAc,QAClB,EAAI,iBAAmB,YACvB,EAAI,iBAAmB,SACvB,CACA,EAAS,GAAW,CAAC,EAAM,EAAM,GAAK,EAAE,CAExC,OAGF,EAAkB,EAAM,IACxB,EACF,CAEI,MAAyB,CAC7B,IAAM,EAAU,EAAO,UAAU,CAE7B,GACF,EAAO,EAAM,EAAQ,CAAE,GAAS,CAAC,EAMrC,OAFA,WAAW,iBAAiB,WAAY,EAAW,CAE5C,CACL,YAAe,CACT,MAMJ,CAFA,EAAY,GACZ,GAAa,CACb,WAAW,oBAAoB,WAAY,EAAW,CAEtD,GAAI,CACF,QAAQ,kBAAoB,OACtB,KAIX,CAGH,SAAS,EAAM,EAAsB,CACnC,MAAO,GAAG,EAAM,KAAK,GAAG,EAAc,EAAM,OAAO,GAGrD,SAAS,EAAc,EAAwB,CAC7C,OAAO,KAAK,UAAU,EAAO,EAAkB,CAGjD,SAAS,EAAkB,EAAc,EAAuB,CAC9D,GAAoB,OAAO,GAAQ,UAA/B,GAA2C,CAAC,MAAM,QAAQ,EAAI,CAAE,CAClE,IAAM,EAAkC,EAAE,CAEpC,EAAO,OAAO,KAAK,EAA+B,CAAC,MACtD,EAAc,IAAkB,EAAK,cAAc,EAAM,CAC3D,CAED,IAAK,IAAM,KAAO,EAChB,EAAO,GAAQ,EAAgC,GAGjD,OAAO,EAGT,OAAO,ECpQT,MAAM,EAAiC,OAAO,OAAO,CACnD,YAAe,GAGhB,CAAC,CAEF,SAAgB,EAAsB,EAAiC,CACrE,GACE,OAAO,SAAa,KACpB,OAAO,SAAS,qBAAwB,WAExC,OAAO,EAGT,IAAI,EAA+B,KAC/B,EAAoD,KAKpD,EAAe,GAEb,MAA8B,CAClC,KAAW,CACX,EAAU,MAGN,EAAW,EAAO,gBAAgB,CAAE,YAAa,CAKjD,MAAO,QAWX,MAPA,GAAe,GACf,GAAiB,CAMV,IAAI,QAAe,GAAiB,CAOzC,IAAM,EAAW,IAAI,QAAe,GAAY,CAC9C,EAAU,GACV,CAEF,EAAO,iBACL,YACM,CACA,IAYJ,GAAiB,CACjB,GAAW,kBAAkB,CAC7B,GAAc,GAEhB,CAAE,KAAM,GAAM,CACf,CAED,GAAI,CACF,EAAY,SAAS,yBAOnB,GAAc,CAEP,GACP,MACI,CAIN,GAAiB,CACjB,GAAc,GAEhB,EACF,CAEI,EAAa,EAAO,cAAgB,CACxC,IAAM,EAAW,EAEjB,EAAe,GACf,EAAU,KAEN,IAAa,KACf,EAAY,KAcZ,eAAiB,CACf,GAAU,CACV,EAAY,MACX,EAAE,EAEP,CAEF,MAAO,CACL,YAAe,CACb,GAAU,CACV,GAAY,CACZ,GAAW,kBAAkB,CAC7B,EAAY,KACZ,GAAiB,EAEpB,CCrIH,SAAgB,EAAe,EAA0B,CACvD,OACE,EAAI,SAAW,GACf,CAAC,EAAI,SACL,CAAC,EAAI,QACL,CAAC,EAAI,SACL,CAAC,EAAI,SAWT,SAAS,EAAqB,EAAyB,CACrD,OAAO,UAAU,EAAQ,CAAC,WAAW,IAAK,MAAM,CAsBlD,SAAgB,EACd,EACA,EACA,EACA,EACoB,CACpB,GAAI,CACF,IAAM,EAAU,GAAS,KACrB,EAEA,IAAY,IAAA,KACd,EAAW,EAAQ,WAAW,IAAI,CAAG,EAAQ,MAAM,EAAE,CAAG,GAG1D,IAAM,EAAW,EAAO,SAExB,GAAI,EAAU,CACZ,IAAM,EAAM,EACV,EACA,EACA,IAAa,IAAA,GAAY,IAAA,GAAY,CAAE,KAAM,EAAU,CACxD,CAED,GAAI,IAAQ,IAAA,GACV,OAAO,EAIX,IAAM,EAAO,EAAO,UAAU,EAAW,EAAY,CAErD,OAAO,EAAW,GAAG,EAAK,GAAG,EAAqB,EAAS,GAAK,OAC1D,CACN,QAAQ,MACN,wBAAwB,EAAU,sEACnC,CAED,QA8BJ,SAAgB,EACd,EACA,EACA,EACA,EACA,EACgB,CAChB,IAAM,EAAmC,CAAE,GAAG,EAAc,CAExD,IAAS,IAAA,KACX,EAAK,KAAO,GAGd,IAAM,EAAU,EAAO,UAAU,CAEjC,GACE,GAAS,OAAS,GAClB,EAAa,EAAQ,OAAQ,EAAY,CACzC,CACA,IAAM,EACH,EAAQ,SAAqD,KAAK,MACnE,GAGE,KAFY,GAAQ,KAGtB,EAAK,MAAQ,GACb,EAAK,WAAa,IAItB,OAAO,EAAO,SAAS,EAAW,EAAa,EAAK,CAGtD,SAAS,EAAY,EAAqC,CACxD,OAAO,EAAS,EAAM,MAAM,OAAO,EAAI,EAAE,CAAI,EAAE,CAGjD,SAAgB,EACd,EACA,EACA,EACoB,CACpB,GAAI,GAAY,EAAiB,CAC/B,IAAM,EAAe,EAAY,EAAgB,CAEjD,GAAI,EAAa,SAAW,EAC1B,OAAO,GAAiB,IAAA,GAE1B,GAAI,CAAC,EACH,OAAO,EAAa,KAAK,IAAI,CAG/B,IAAM,EAAa,EAAY,EAAc,CACvC,EAAO,IAAI,IAAI,EAAW,CAEhC,IAAK,IAAM,KAAS,EACb,EAAK,IAAI,EAAM,GAClB,EAAK,IAAI,EAAM,CACf,EAAW,KAAK,EAAM,EAI1B,OAAO,EAAW,KAAK,IAAI,CAG7B,OAAO,GAAiB,IAAA,GAG1B,SAAgB,EACd,EACA,EACS,CACT,GAAI,OAAO,GAAG,EAAM,EAAK,CACvB,MAAO,GAET,GAAI,CAAC,GAAQ,CAAC,EACZ,MAAO,GAGT,IAAM,EAAW,OAAO,KAAK,EAAK,CAElC,GAAI,EAAS,SAAW,OAAO,KAAK,EAAK,CAAC,OACxC,MAAO,GAGT,IAAM,EAAa,EACb,EAAa,EAEnB,IAAK,IAAM,KAAO,EAChB,GAAI,CAAC,OAAO,GAAG,EAAW,GAAM,EAAW,GAAK,CAC9C,MAAO,GAIX,MAAO,GAGT,SAAgB,EAAc,EAA+C,CACtE,IAIH,aAAmB,mBACnB,aAAmB,oBAIhB,EAAQ,aAAa,OAAO,EAC/B,EAAQ,aAAa,OAAQ,OAAO,CAEjC,EAAQ,aAAa,WAAW,EACnC,EAAQ,aAAa,WAAY,IAAI,GC3MzC,SAAS,EAAwB,EAAgB,EAAuB,CACtE,GAAI,OAAO,GAAU,WAAY,CAC9B,EAAyB,EAAI,CAE9B,OAEF,GAAI,MAAM,QAAQ,EAAM,CAAE,CACxB,IAAM,EAAW,EAEjB,IAAK,IAAM,KAAM,EACf,GAAI,OAAO,GAAO,aAChB,EAAG,EAAI,CAEH,EAAI,kBACN,QAOV,MAAa,IAAA,EAAA,EAAA,iBAAuB,CAClC,KAAM,OAKN,aAAc,GACd,MAAO,CACL,UAAW,CACT,KAAM,OACN,SAAU,GACX,CACD,YAAa,CACX,KAAM,OACN,YAAe,GAChB,CACD,aAAc,CACZ,KAAM,OACN,YAAe,GAChB,CACD,MAAO,CACL,KAAM,OACN,QAAS,IAAA,GACV,CACD,gBAAiB,CACf,KAAM,OACN,QAAS,SACV,CACD,aAAc,CACZ,KAAM,QACN,QAAS,GACV,CACD,kBAAmB,CACjB,KAAM,QACN,QAAS,GACV,CACD,OAAQ,CACN,KAAM,OACN,QAAS,IAAA,GACV,CAOD,KAAM,CACJ,KAAM,OACN,QAAS,IAAA,GACV,CACF,CACD,MAAM,EAAO,CAAE,QAAO,SAAS,CAC7B,IAAM,EAAS,GAAW,CAEpB,GAAA,EAAA,EAAA,YAAsB,GAAM,EAMlC,EAAA,EAAA,WAEI,CACE,EAAM,UACN,EAAM,YACN,EAAM,aACN,EAAM,kBACN,EAAM,KACP,EAED,CAAC,EAAW,EAAa,EAAc,EAAmB,GAC1D,EACA,IACG,CAGH,IAAM,GAAA,EAAA,EAAA,yBACJ,EACA,EACA,EACA,IAAS,IAAA,GACL,CAAE,OAAQ,EAAc,oBAAmB,CAC3C,CAAE,OAAQ,EAAc,oBAAmB,OAAM,CACtD,CAED,EAAS,MAAQ,EAAO,aAAa,CAMrC,EAJc,EAAO,cAAgB,CACnC,EAAS,MAAQ,EAAO,aAAa,EACrC,CAEc,EAElB,CAAE,UAAW,GAAM,MAAO,OAAQ,CACnC,CAED,IAAM,GAAA,EAAA,EAAA,cACJ,EACE,EACA,EAAM,UACN,EAAM,YACN,EAAM,OAAS,IAAA,GAAY,IAAA,GAAY,CAAE,KAAM,EAAM,KAAM,CAC5D,CACF,CAEK,GAAA,EAAA,EAAA,cACJ,EAAqB,EAAS,MAAO,EAAM,gBAAiB,EAAM,MAAM,CACzE,CAEK,EAAe,GAAoB,CAKnC,EAAM,UAAY,IAAA,IAAa,EAAM,UAAY,OACnD,EAAwB,EAAM,QAAS,EAAI,CAEvC,EAAI,mBAKN,CAAC,EAAe,EAAI,EAAI,EAAM,SAAW,WAI7C,EAAI,gBAAgB,CACpB,EACE,EACA,EAAM,UACN,EAAM,YACN,EAAM,KACN,EAAM,aACP,CAAC,UAAY,GAAG,GAGnB,UAAa,CAMX,IAAM,EAA0C,EAAE,CAElD,IAAK,IAAM,KAAO,OAAO,KAAK,EAAM,CAC9B,IAAQ,YACV,EAAe,GAAQ,EAAkC,IAI7D,OAAA,EAAA,EAAA,GACE,IACA,CACE,GAAG,EACH,KAAM,EAAK,MACX,MAAO,EAAe,MACtB,OAAQ,EAAM,OACd,QAAS,EACV,CACD,EAAM,WAAW,CAClB,GAGN,CAAC,CCpMW,IAAA,EAAA,EAAA,iBAAsC,CACjD,KAAM,sBACN,MAAO,CACL,SAAU,CACR,KAAM,SAGN,SAAU,GACX,CACD,QAAS,CACP,KAAM,SAON,QAAS,IAAA,GACV,CACF,CACD,MAAM,EAAO,CAAE,SAAS,CAEtB,IAAM,EAAW,GAAA,EAAA,EAAA,wBADF,GAAW,CACsC,CAAC,CAgBjE,OAdA,EAAA,EAAA,WACQ,EAAS,MAAM,YACf,CACA,EAAS,MAAM,OACjB,EAAM,UACJ,EAAS,MAAM,MACf,EAAS,MAAM,QACf,EAAS,MAAM,UAChB,EAGL,CAAE,UAAW,GAAM,CACpB,KAEY,CACX,IAAM,EAAW,EAAM,WAAW,EAAI,EAAE,CAClC,EAAa,EAAS,MAAM,MAC9B,EAAM,SAAS,EAAS,MAAM,MAAO,EAAS,MAAM,WAAW,CAC/D,KAEJ,OAAA,EAAA,EAAA,GAASC,EAAAA,SAAU,KAAM,CAAC,GAAG,EAAU,EAAW,CAAC,GAGxD,CAAC,CCpCI,EAAwB,EAAE,CAShC,SAAgB,EAAoB,EAA4B,CAG9D,OAFA,EAAY,KAAK,EAAO,KAEX,CACX,IAAM,EAAM,EAAY,YAAY,EAAO,CAEvC,IAAQ,IACV,EAAY,OAAO,EAAK,EAAE,EAyBhC,SAAgB,GAA6B,CAC3C,IAAM,EAAM,EAAY,GAAG,GAAG,CAE9B,GAAI,CAAC,EACH,MAAU,MACR,4FACD,CAGH,OAAO,EAST,MAAM,EAAW,IAAI,QAQrB,SAAS,EAAe,EAA6C,CAgBnE,OAfI,GAAU,MACZ,QAAQ,MACN,8GACD,CAEM,IAEL,OAAQ,EAA6B,MAAS,SAQ3C,IAPL,QAAQ,MACN,uHACD,CAEM,IAMX,SAAS,GACP,EACA,EAC2B,CAC3B,MAAQ,IAAoB,CACrB,EAAe,EAAI,GAIxB,EAAI,gBAAgB,CACpB,EACG,SAAS,EAAM,KAAM,EAAM,QAAU,EAAE,CAAE,EAAM,SAAW,EAAE,CAAC,CAC7D,UAAY,GAAG,GAItB,SAAS,GACP,EACA,EACA,EAC8B,CAC9B,MAAQ,IAAuB,CACzB,EAAI,MAAQ,SAAW,EAAE,aAAmB,oBAC9C,EACG,SAAS,EAAM,KAAM,EAAM,QAAU,EAAE,CAAE,EAAM,SAAW,EAAE,CAAC,CAC7D,UAAY,GAAG,EAKxB,SAAS,EACP,EACA,EACA,EACM,CACN,IAAM,EAAQ,GAAmB,EAAQ,EAAM,CACzC,EAAU,GAAqB,EAAQ,EAAO,EAAQ,CAE5D,EAAQ,iBAAiB,QAAS,EAAM,CACxC,EAAQ,iBAAiB,UAAW,EAAQ,CAE5C,EAAS,IAAI,EAAS,CAAE,QAAO,UAAS,CAAC,CAG3C,SAAS,EAAe,EAA4B,CAClD,IAAM,EAAQ,EAAS,IAAI,EAAQ,CAE/B,IACF,EAAQ,oBAAoB,QAAS,EAAM,MAAM,CACjD,EAAQ,oBAAoB,UAAW,EAAM,QAAQ,CACrD,EAAS,OAAO,EAAQ,EAI5B,MAAa,GAAoD,CAC/D,QAAQ,EAAS,EAAS,CACxB,IAAM,EAAS,GAAoB,CAEnC,EAAc,EAAQ,CAEtB,EAAQ,MAAM,OAAS,UAElB,EAAe,EAAQ,MAAM,EAIlC,EAAe,EAAS,EAAQ,EAAQ,MAAM,EAGhD,QAAQ,EAAS,EAAS,CACxB,IAAM,EAAS,GAAoB,CAEnC,EAAe,EAAQ,CAElB,EAAe,EAAQ,MAAM,EAIlC,EAAe,EAAS,EAAQ,EAAQ,MAAM,EAGhD,cAAc,EAAS,CACrB,EAAe,EAAQ,EAE1B,CCxLY,MAAgC,CAC3C,IAAM,GAAA,EAAA,EAAA,QAAmB,EAAa,CAEtC,GAAI,CAAC,EACH,MAAU,MAAM,oDAAoD,CAGtE,OAAO,GCNI,QAGX,EAAA,EAAA,gBAAA,EAAA,EAAA,cAFe,GAAW,CAEe,CAAC,SAAS,CAAC,CCFzC,MAG6B,CACxC,IAAM,GAAA,EAAA,EAAA,QAAsB,EAAS,CAErC,GAAI,CAAC,EACH,MAAU,MAAM,gDAAgD,CAGlE,GAAI,CAAC,EAAa,MAAM,MACtB,MAAU,MACR,oIACD,CAGH,OAAO,GChBT,SAAgB,IAA4D,CAI1E,OAAO,GAAA,EAAA,EAAA,qBAHQ,GAAW,CACgB,CAEX,CCmFjC,SAAgB,GACd,EACA,EACM,CACN,IAAM,EAAS,GAAW,CACpB,EAAgB,GAAS,eAAiB,IAchD,EAAA,EAAA,gBAZY,EAAO,gBAAgB,CAAE,QAAO,YAAW,YAAa,CAC9D,QAAiB,EAAM,OAAS,EAAU,OAI1C,GAAO,QAIX,OAAO,EAAQ,CAAE,QAAO,YAAW,SAAQ,CAAC,EAC5C,CAEiB,CCrCrB,SAAgB,GACd,EACA,EACM,CACN,GAAM,CAAE,QAAO,iBAAkB,GAAU,CACrC,EAAgB,GAAS,eAAiB,GAC5C,EAAiC,MAErC,EAAA,EAAA,OAAM,EAAQ,GAAa,CACzB,IAAM,EAAO,EAAc,MAiBtB,EAAS,WAAW,OAIrB,GAAiB,EAAS,WAAW,OAAS,EAAS,MAIvD,IAAqB,GAAY,CAAC,IAKtC,EAAmB,EACnB,EAAQ,CAAE,MAAO,EAAU,cAAe,EAAM,CAAC,IACjD,CC7FJ,SAAgB,EAAoB,EAAgC,CAClE,IAAM,GAAA,EAAA,EAAA,cAAyB,EAAO,CAChC,GAAA,EAAA,EAAA,mBAA2B,EAAO,CAClC,EAAU,EAAO,aAAa,CAE9B,GAAA,EAAA,EAAA,YAAsC,EAAQ,MAAM,CACpD,GAAA,EAAA,EAAA,YAA8C,EAAQ,cAAc,CAS1E,MAAO,CAAE,YAAW,QAAO,gBAAe,YAPtB,EAAO,cAAgB,CACzC,IAAM,EAAW,EAAO,aAAa,CAErC,EAAM,MAAQ,EAAS,MACvB,EAAc,MAAQ,EAAS,eAC/B,CAEqD,CCjCzD,SAAgB,GAAmB,EAA4B,CAC7D,MAAO,CACL,QAAQ,EAAW,CACjB,IAAM,EAAmB,EAAoB,EAAO,CAE9C,CAAE,YAAW,QAAO,gBAAe,eACvC,EAAoB,EAAO,CAKzB,cAAe,GAChB,EAAsD,cAAgB,CACrE,GAAkB,CAClB,GAAa,EACb,CAGJ,EAAI,QAAQ,EAAW,EAAO,CAC9B,EAAI,QAAQ,EAAc,EAAU,CACpC,EAAI,QAAQ,EAAU,CAAE,YAAW,QAAO,gBAAe,CAAC,EAE7D,CCdH,MAAa,IAAA,EAAA,EAAA,iBAAiC,CAC5C,KAAM,iBACN,MAAO,CACL,OAAQ,CACN,KAAM,OACN,SAAU,GACX,CACD,mBAAoB,CAClB,KAAM,QACN,QAAS,GACV,CACD,kBAAmB,CACjB,KAAM,OACP,CACD,gBAAiB,CACf,KAAM,QACN,QAAS,GACV,CACF,CACD,MAAM,EAAO,CAAE,SAAS,EAItB,EAAA,EAAA,WACQ,CAAC,EAAM,OAAQ,EAAM,mBAAmB,EAC7C,CAAC,EAAQ,GAAU,EAAO,IAAc,CACvC,GAAI,CAAC,EACH,OAGF,IAAM,EAAY,GAAqB,EAAO,CAE9C,MAAgB,CACd,EAAU,SAAS,EACnB,EAEJ,CAAE,UAAW,GAAM,CACpB,EAMD,EAAA,EAAA,WAEI,CACE,EAAM,OACN,EAAM,oBAAsB,IAAA,GAC5B,EAAM,mBAAmB,KACzB,EAAM,mBAAmB,gBACzB,EAAM,mBAAmB,SACzB,EAAM,mBAAmB,WAC1B,EAED,CAAC,EAAQ,EAAS,EAAM,EAAiB,EAAU,GACnD,EACA,IACG,CACH,GAAI,CAAC,EACH,OAGF,IAAM,EAAK,GAAwB,EAAQ,CACzC,OACA,kBACA,WACA,aACA,gBAAiB,EAAM,mBAAmB,gBAC3C,CAAC,CAEF,MAAgB,CACd,EAAG,SAAS,EACZ,EAEJ,CAAE,UAAW,GAAM,CACpB,EAGD,EAAA,EAAA,WACQ,CAAC,EAAM,OAAQ,EAAM,gBAAgB,EAC1C,CAAC,EAAQ,GAAU,EAAO,IAAc,CACvC,GAAI,CAAC,EACH,OAGF,IAAM,EAAK,EAAsB,EAAO,CAExC,MAAgB,CACd,EAAG,SAAS,EACZ,EAEJ,CAAE,UAAW,GAAM,CACpB,CAKD,IAAM,EAAmB,EAAoB,EAAM,OAAO,CAEpD,CAAE,YAAW,QAAO,gBAAe,eACvC,EAAoB,EAAM,OAAO,CAWnC,OATA,EAAA,EAAA,oBAAqB,CACnB,GAAkB,CAClB,GAAa,EACb,EAEF,EAAA,EAAA,SAAQ,EAAW,EAAM,OAAO,EAChC,EAAA,EAAA,SAAQ,EAAc,EAAU,EAChC,EAAA,EAAA,SAAQ,EAAU,CAAE,YAAW,QAAO,gBAAe,CAAC,KAEzC,EAAM,WAAW,EAEjC,CAAC"}
+{"version":3,"file":"index.js","names":["Fragment","UNKNOWN_ROUTE","RouterKey","suspenseComponent","KeepAlive","Fragment","NOOP_INSTANCE","NOOP_INSTANCE","canonicalJson","Fragment","NavigatorKey","useRoute","RouterKey","NavigatorKey","RouteKey","RouterKey","NavigatorKey","RouteKey"],"sources":["../../src/components/RouteView/components.ts","../../src/components/RouteView/helpers.ts","../../src/useRefFromSource.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/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\nexport function 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\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.\nexport function isKeepAliveEnabled(value: unknown): boolean {\n  return value === true || value === \"\" || value === \"keep-alive\";\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   * True iff any `<Match>` child in the input has its `keepAlive` prop set\n   * to one of Vue's accepted boolean-shorthand forms. Surfaced as a\n   * side-channel from the single pipeline pass so the caller doesn't have\n   * to re-iterate `elements` after `buildRenderList` returns — closes a MED\n   * code-quality finding (audit §8.1).\n   */\n  hasPerMatchKA: boolean;\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  let hasPerMatchKA = false;\n  const rendered: VNode[] = [];\n\n  for (const child of elements) {\n    // Match-only side-channel: scan for the keepAlive shorthand in the same\n    // pass that already inspects every child. Short-circuits once a positive\n    // is found to avoid redundant prop reads in big slot trees.\n    if (!hasPerMatchKA && child.type === Match) {\n      const matchProps = child.props as { keepAlive?: unknown } | null;\n\n      if (isKeepAliveEnabled(matchProps?.keepAlive)) {\n        hasPerMatchKA = true;\n      }\n    }\n\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, hasPerMatchKA };\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 { 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 {\n  buildRenderList,\n  collectElements,\n  isKeepAliveEnabled,\n} 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\n// Lazy-initialised — only allocated when a per-Match keepAlive path needs to\n// keep the cache slot \"occupied\" with a no-render placeholder. Apps without\n// keepAlive never pay the markRaw + defineComponent allocation at import.\nlet emptyKeepAlivePlaceholderInstance: Component | null = null;\n\nfunction getEmptyKeepAlivePlaceholder(): Component {\n  emptyKeepAlivePlaceholderInstance ??= markRaw(\n    defineComponent({\n      name: \"KeepAlive-placeholder\",\n      render() {\n        return null;\n      },\n    }),\n  );\n\n  return emptyKeepAlivePlaceholderInstance;\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?: 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, {\n      default: () => h(getEmptyKeepAlivePlaceholder()),\n    }),\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 slotOutput = slots.default?.();\n      const elements: VNode[] = [];\n\n      collectElements(slotOutput, elements);\n\n      // `hasPerMatchKA` is a side-channel produced by the same pipeline pass\n      // that builds `rendered` — closes the audit §8.1 \"double iteration\"\n      // finding. The previous identity-cache on `slotOutput` is no longer\n      // needed: per-render cost is one O(n) walk instead of two.\n      const { rendered, fallback, hasPerMatchKA } = 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      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\nconst NOOP_INSTANCE: { destroy: () => void } = Object.freeze({\n  destroy: () => {\n    /* no-op */\n  },\n});\n\nexport function createRouteAnnouncer(\n  router: Router,\n  options?: RouteAnnouncerOptions,\n): { destroy: () => void } {\n  // Defensive SSR / non-browser guard: in SSR (Node.js) or non-DOM\n  // environments, `document` is undefined and the announcer cannot\n  // attach its aria-live region. Return a frozen NOOP_INSTANCE — same\n  // pattern as `createDirectionTracker`, `createScrollRestoration`, and\n  // `createViewTransitions`. Without this guard, `NavigationAnnouncer`\n  // component construction would throw `ReferenceError: document is not\n  // defined` under `@angular/ssr` rendering, tearing down the whole SSR\n  // bootstrap. Closes review-2026-05-10 §5.10 ⛔ \"NavigationAnnouncer\n  // SSR mode\" MED.\n  if (typeof document === \"undefined\") {\n    return NOOP_INSTANCE;\n  }\n\n  const prefix = options?.prefix ?? \"Navigated to \";\n  const getCustomText = options?.getAnnouncementText;\n\n  let isInitialNavigation = true;\n  let isReady = false;\n  let isDestroyed = false;\n  let lastAnnouncedText = \"\";\n  let pendingText: string | null = null;\n  let clearTimeoutId: ReturnType<typeof setTimeout> | undefined;\n\n  const announcer = getOrCreateAnnouncer();\n\n  const doAnnounce = (text: string, h1: HTMLElement | null): void => {\n    lastAnnouncedText = text;\n    clearTimeout(clearTimeoutId);\n    announcer.textContent = text;\n    clearTimeoutId = setTimeout(() => {\n      announcer.textContent = \"\";\n      lastAnnouncedText = \"\";\n    }, CLEAR_DELAY);\n\n    manageFocus(h1);\n  };\n\n  // Safari-ready delay: announcing before VoiceOver wires up the aria-live region\n  // causes the first announcement to be silently dropped. Wait SAFARI_READY_DELAY ms\n  // before marking the announcer \"ready\" — any navigation during that window is\n  // buffered in pendingText and flushed once the delay expires.\n  const safariTimeoutId = setTimeout(() => {\n    isReady = true;\n\n    if (pendingText !== null && !isDestroyed) {\n      const text = pendingText;\n\n      pendingText = null;\n      doAnnounce(text, document.querySelector<HTMLElement>(\"h1\"));\n    }\n  }, SAFARI_READY_DELAY);\n\n  const unsubscribe = router.subscribe(({ route }) => {\n    if (isInitialNavigation) {\n      isInitialNavigation = false;\n\n      return;\n    }\n\n    // Double rAF: waits for two paint frames so the incoming route's DOM\n    // (including the new <h1>) is fully rendered before resolveText reads it.\n    // Single rAF fires before the new route's template has been attached,\n    // which would cause resolveText to pick up the OLD h1 or fall back to\n    // document.title / route.name prematurely.\n    requestAnimationFrame(() => {\n      requestAnimationFrame(() => {\n        if (isDestroyed) {\n          return;\n        }\n\n        const h1 = document.querySelector<HTMLElement>(\"h1\");\n        const text = resolveText(route, prefix, getCustomText, h1);\n\n        if (!text || text === lastAnnouncedText) {\n          return;\n        }\n\n        if (!isReady) {\n          // Defer announcement until Safari-ready window elapses (see safariTimeoutId).\n          pendingText = text;\n\n          return;\n        }\n\n        doAnnounce(text, h1);\n      });\n    });\n  });\n\n  return {\n    destroy() {\n      isDestroyed = true;\n      unsubscribe();\n      clearTimeout(clearTimeoutId);\n      clearTimeout(safariTimeoutId);\n      removeAnnouncer();\n    },\n  };\n}\n\nfunction getOrCreateAnnouncer(): HTMLElement {\n  const existing = document.querySelector<HTMLElement>(`[${ANNOUNCER_ATTR}]`);\n\n  if (existing) {\n    return existing;\n  }\n\n  const element = document.createElement(\"div\");\n\n  element.setAttribute(\"style\", VISUALLY_HIDDEN);\n  element.setAttribute(\"aria-live\", \"assertive\");\n  element.setAttribute(\"aria-atomic\", \"true\");\n  element.setAttribute(ANNOUNCER_ATTR, \"\");\n\n  // Defensive SSR / pre-`<body>` guard: in some environments (early\n  // injection, deferred-body documents, certain SSR rehydration paths)\n  // `document.body` can be null when the announcer is constructed.\n  // `document.body.prepend(...)` would throw `TypeError: Cannot read\n  // properties of null`, tearing down the consumer's RouterProvider /\n  // NavigationAnnouncer mount. Fallback to `documentElement` keeps the\n  // announcer working for SR users; visual-hidden styling means there is\n  // no visible artifact regardless of mount point.\n  //\n  // TS dom lib types `document.body` as `HTMLElement` (non-null), but\n  // runtime can return null per spec. The `as` cast narrows the type to\n  // include null so the `??` short-circuit is type-safe.\n  ((document.body as HTMLElement | null) ?? document.documentElement).prepend(\n    element,\n  );\n\n  return element;\n}\n\nfunction removeAnnouncer(): void {\n  document.querySelector(`[${ANNOUNCER_ATTR}]`)?.remove();\n}\n\nfunction resolveText(\n  route: State,\n  prefix: string,\n  getCustomText: ((route: State) => string) | undefined,\n  h1: HTMLElement | null,\n): string {\n  if (getCustomText) {\n    try {\n      const customText = getCustomText(route);\n\n      // Mini-sprint E.4 (audit-5 §4.2 #4) — empty-string fallback.\n      // A consumer pattern like\n      //   getAnnouncementText: (route) => myMap[route.name] ?? \"\"\n      // returns `\"\"` for routes outside the map. The subscribe loop\n      // then sees an empty text and silently no-announces — screen\n      // readers stay quiet without any signal to the developer. Treat\n      // a falsy custom result (`\"\"` / `null` / `undefined`) as\n      // \"consumer doesn't have a name for this route\" and fall through\n      // to the default resolution chain (h1 → title → route name).\n      if (customText) {\n        return customText;\n      }\n    } catch (error) {\n      // A throwing consumer callback inside the router's subscribe loop\n      // would tear down sibling listeners — log and fall through to the\n      // built-in resolution chain so the announcer keeps working.\n      console.error(\n        \"[real-router] getAnnouncementText threw; falling back to default resolution.\",\n        error,\n      );\n    }\n  }\n\n  const h1Text = (h1?.textContent ?? \"\").trim();\n  const routeName = route.name.startsWith(INTERNAL_ROUTE_PREFIX)\n    ? \"\"\n    : route.name;\n  const rawText =\n    h1Text || document.title || routeName || globalThis.location.pathname;\n\n  return `${prefix}${rawText}`;\n}\n\nfunction manageFocus(h1: HTMLElement | null): void {\n  if (!h1) {\n    return;\n  }\n\n  if (!h1.hasAttribute(\"tabindex\")) {\n    h1.setAttribute(\"tabindex\", \"-1\");\n  }\n\n  h1.focus({ preventScroll: true });\n}\n","import type { Router, State } from \"@real-router/core\";\n\nconst DEFAULT_STORAGE_KEY = \"real-router:scroll\";\n\nconst NOOP_INSTANCE: { destroy: () => void } = Object.freeze({\n  destroy: () => {\n    /* no-op */\n  },\n});\n\nexport type ScrollRestorationMode = \"restore\" | \"top\" | \"native\";\n\nexport interface ScrollRestorationOptions {\n  mode?: ScrollRestorationMode | undefined;\n  anchorScrolling?: boolean | undefined;\n  scrollContainer?: (() => HTMLElement | null) | undefined;\n  /**\n   * Scroll behavior passed to `scrollTo({ behavior })` and\n   * `scrollIntoView({ behavior })`.\n   *\n   * - `\"auto\"` (default) — browser-defined, usually instant.\n   * - `\"instant\"` — explicit instant jump (no animation).\n   * - `\"smooth\"` — animated transition. Note: smooth restore on back/traverse\n   *   can feel disorienting if the user expects to land at the saved position\n   *   immediately. Recommended for `mode: \"top\"` or anchor scroll only.\n   *\n   * See [MDN](https://developer.mozilla.org/en-US/docs/Web/API/ScrollToOptions/behavior).\n   */\n  behavior?: ScrollBehavior | undefined;\n  /**\n   * sessionStorage key used to persist saved scroll positions. Default:\n   * `\"real-router:scroll\"`. Override only when multiple independent\n   * `RouterProvider` instances share the same document and you need to\n   * isolate their scroll stores (e.g. micro-frontends, embedded widgets,\n   * or testing). For a single app with one provider the default is fine.\n   */\n  storageKey?: string | undefined;\n}\n\ninterface NavigationContext {\n  direction?: \"forward\" | \"back\" | \"unknown\";\n  navigationType?: \"push\" | \"replace\" | \"traverse\" | \"reload\";\n}\n\nexport function createScrollRestoration(\n  router: Router,\n  options?: ScrollRestorationOptions,\n): { destroy: () => void } {\n  if (typeof globalThis.window === \"undefined\") {\n    return NOOP_INSTANCE;\n  }\n\n  const mode = options?.mode ?? \"restore\";\n\n  // mode \"native\" = utility does nothing. Don't flip history.scrollRestoration,\n  // don't subscribe, don't register pagehide — `history.scrollRestoration`\n  // stays at the browser default (\"auto\") so the browser handles scroll\n  // restore natively. (Note: this is the OPPOSITE of `history.scrollRestoration\n  // === \"manual\"` — utility's \"native\" leaves the DOM property at \"auto\" so\n  // the browser is in charge.)\n  if (mode === \"native\") {\n    return NOOP_INSTANCE;\n  }\n\n  const anchorEnabled = options?.anchorScrolling ?? true;\n  const getContainer = options?.scrollContainer;\n  const behavior: ScrollBehavior = options?.behavior ?? \"auto\";\n  const storageKey = options?.storageKey ?? DEFAULT_STORAGE_KEY;\n\n  // Write-through in-memory cache: parse sessionStorage once per provider\n  // mount, then mutate in-memory. Avoids a JSON.parse + JSON.stringify pair\n  // on every subscribeLeave / pagehide event.\n  let store: Record<string, number> | undefined;\n\n  const loadStore = (): Record<string, number> => {\n    if (store !== undefined) {\n      return store;\n    }\n\n    try {\n      const raw = sessionStorage.getItem(storageKey);\n\n      store = raw ? (JSON.parse(raw) as Record<string, number>) : {};\n    } catch {\n      store = {};\n    }\n\n    return store;\n  };\n\n  const putPos = (key: string, pos: number): void => {\n    try {\n      const cached = loadStore();\n\n      // Skip-same-value: when a route is left at the same scroll position it\n      // already holds in the cache (e.g. tab-switching without scrolling),\n      // both the in-memory write and the JSON.stringify + setItem pair are\n      // no-ops. Eliminates redundant serialization on the navigation hot\n      // path for the common \"click tabs without scrolling\" case.\n      if (cached[key] === pos) {\n        return;\n      }\n\n      cached[key] = pos;\n      sessionStorage.setItem(storageKey, JSON.stringify(cached));\n    } catch {\n      // Ignore quota / security errors.\n    }\n  };\n\n  const prevScrollRestoration = history.scrollRestoration;\n\n  try {\n    history.scrollRestoration = \"manual\";\n  } catch {\n    // Ignore — some embedded contexts may reject the assignment.\n  }\n\n  // Resolve the container lazily on every event so containers mounted AFTER\n  // the provider still get correct scroll handling. Falls back to window when\n  // the getter is absent or returns null (pre-mount).\n  const readPos = (): number => {\n    const element = getContainer?.();\n\n    return element ? element.scrollTop : globalThis.scrollY;\n  };\n\n  const writePos = (top: number): void => {\n    const element = getContainer?.();\n\n    if (element) {\n      element.scrollTo({ top, left: 0, behavior });\n    } else {\n      globalThis.scrollTo({ top, left: 0, behavior });\n    }\n  };\n\n  const scrollToHashOrTop = (route: State): void => {\n    // URL plugin path (#532): `state.context.url.hash` is the source of truth\n    // when one of the URL plugins (browser-plugin / navigation-plugin) is\n    // installed. The value is already DECODED — feeding it through\n    // `decodeURIComponent` again would throw on a bare `%`.\n    const ctxHash = (route.context as { url?: { hash?: string } } | undefined)\n      ?.url?.hash;\n\n    if (ctxHash !== undefined) {\n      if (anchorEnabled && ctxHash.length > 0) {\n        // eslint-disable-next-line unicorn/prefer-query-selector -- ids may contain CSS-unsafe chars\n        const element = document.getElementById(ctxHash);\n\n        if (element) {\n          element.scrollIntoView({ behavior });\n\n          return;\n        }\n      }\n\n      writePos(0);\n\n      return;\n    }\n\n    // Fallback path: no URL plugin, read the DOM. `location.hash` is\n    // percent-encoded; ids in the DOM are the raw string, so decode for the\n    // match. Fall back to the raw slice if the hash contains a malformed\n    // escape sequence (decodeURIComponent throws on those).\n    const hash = globalThis.location.hash;\n\n    if (anchorEnabled && hash.length > 1) {\n      let id: string;\n\n      try {\n        id = decodeURIComponent(hash.slice(1));\n      } catch {\n        id = hash.slice(1);\n      }\n\n      // eslint-disable-next-line unicorn/prefer-query-selector -- ids may contain CSS-unsafe chars\n      const element = document.getElementById(id);\n\n      if (element) {\n        element.scrollIntoView({ behavior });\n\n        return;\n      }\n    }\n\n    writePos(0);\n  };\n\n  let destroyed = false;\n  let unserializableWarned = false;\n\n  // `keyOf` defers to `canonicalJson` which calls `JSON.stringify`. Two\n  // realistic inputs blow up the serializer and would otherwise crash the\n  // subscribe callback (taking scroll-restore offline for the whole session):\n  //   - `BigInt` params → `TypeError: Do not know how to serialize a BigInt`\n  //   - cyclic params (reactive proxies, DOM-ref back-pointers) → stack\n  //     overflow.\n  // The defensive wrapper drops capture/restore for that specific navigation\n  // and warns once per provider — the rest of the cache stays usable.\n  const safeKeyOf = (state: State): string | null => {\n    try {\n      return keyOf(state);\n    } catch {\n      if (!unserializableWarned) {\n        unserializableWarned = true;\n        console.error(\n          `[real-router] scroll-restore: route \"${state.name}\" has params that cannot be canonicalized (e.g. BigInt or cyclic structure). Scroll position will not be captured or restored for this route.`,\n        );\n      }\n\n      return null;\n    }\n  };\n\n  const unsubscribe = router.subscribe(({ route, previousRoute }) => {\n    const nav = (route.context as { navigation?: NavigationContext })\n      .navigation;\n\n    // Browsers dispatch reload as the initial navigation after refresh, so\n    // previousRoute is undefined and capture is naturally skipped. The\n    // pre-refresh position was already persisted via pagehide.\n    if (previousRoute) {\n      const prevKey = safeKeyOf(previousRoute);\n\n      if (prevKey !== null) {\n        putPos(prevKey, readPos());\n      }\n    }\n\n    // Single rAF so DOM is committed before we read anchors / write scroll.\n    // Guard against destroy() racing with the callback.\n    requestAnimationFrame(() => {\n      if (destroyed) {\n        return;\n      }\n\n      if (mode === \"top\" || !nav) {\n        scrollToHashOrTop(route);\n\n        return;\n      }\n\n      if (nav.navigationType === \"replace\") {\n        return;\n      }\n\n      if (\n        nav.direction === \"back\" ||\n        nav.navigationType === \"traverse\" ||\n        nav.navigationType === \"reload\"\n      ) {\n        const key = safeKeyOf(route);\n\n        writePos(key === null ? 0 : (loadStore()[key] ?? 0));\n\n        return;\n      }\n\n      scrollToHashOrTop(route);\n    });\n  });\n\n  const onPageHide = (): void => {\n    const current = router.getState();\n\n    if (current) {\n      const key = safeKeyOf(current);\n\n      if (key !== null) {\n        putPos(key, readPos());\n      }\n    }\n  };\n\n  globalThis.addEventListener(\"pagehide\", onPageHide);\n\n  return {\n    destroy: () => {\n      if (destroyed) {\n        return;\n      }\n\n      destroyed = true;\n      unsubscribe();\n      globalThis.removeEventListener(\"pagehide\", onPageHide);\n\n      try {\n        history.scrollRestoration = prevScrollRestoration;\n      } catch {\n        // Ignore.\n      }\n    },\n  };\n}\n\n/**\n * Internal cache-key builder for scroll-position storage.\n *\n * **Exported for testing only — not part of the public API** (intentionally\n * excluded from `index.ts` barrel). Adapter property tests import it via\n * the direct path to lock the `(name, canonicalJson(params))` key shape\n * as a regression guard (§8b H20 / audit-2026-05-16 #S3). A change to\n * key format would silently lose scroll positions across an upgrade —\n * the test set is the contract.\n *\n * ## Identity-based memoization (audit-2026-05-17 §8b #2)\n *\n * `State` objects emitted by core are frozen per-navigation: their\n * `name` / `params` are immutable for the lifetime of the snapshot, and\n * any change produces a new `State` reference. A `WeakMap<State, string>`\n * therefore safely caches the canonicalised key by identity — repeat\n * `keyOf(state)` calls on the same snapshot (typical on\n * back/forward/traverse where the same prior `State` is re-emitted)\n * skip the recursive `canonicalJson` pass entirely.\n *\n * The cache key is the `State` reference, so entries auto-release when\n * the snapshot is GC'd — no eviction needed.\n */\nconst KEY_CACHE = new WeakMap<State, string>();\n\nexport function keyOf(state: State): string {\n  const cached = KEY_CACHE.get(state);\n\n  if (cached !== undefined) {\n    return cached;\n  }\n\n  const key = `${state.name}:${canonicalJson(state.params)}`;\n\n  KEY_CACHE.set(state, key);\n\n  return key;\n}\n\n/**\n * Stable JSON serializer with sorted object keys.\n *\n * **Exported for testing only — not part of the public API** (intentionally\n * excluded from `index.ts` barrel). Adapter property tests import it via\n * the direct path to lock the key-order-insensitive property\n * (`canonicalJson({a:1,b:2}) === canonicalJson({b:2,a:1})`).\n *\n * ## Divergence from `@real-router/sources/canonicalJson` — by design\n *\n * Two independent implementations live in the monorepo:\n *\n * - **`shared/dom-utils/scroll-restore.canonicalJson`** (this file) — scroll\n *   cache key builder. Uses `localeCompare` and a plain-object accumulator;\n *   tolerates `__proto__`-keyed inputs only insofar as `JSON.stringify`'s\n *   replacer happens to sort them; relies on `JSON.stringify`'s native cycle\n *   detector. Designed to be cheap on the navigation hot path. The\n *   surrounding [[safeKeyOf]] wrapper catches the two crash inputs (`BigInt`,\n *   cyclic) and skips the offending capture/restore.\n *\n * - **`@real-router/sources/canonicalJson`** — sources cache key builder.\n *   Uses byte-order compare (`< / >`) for locale-independence, a\n *   `Object.create(null)` accumulator to prevent prototype pollution, and a\n *   bespoke path-based cycle detector (the native one cannot see the cloned\n *   graph). Throws eagerly on `Map`/`Set`/`RegExp`/cycles — the caller falls\n *   back to a non-cached source.\n *\n * **They are intentionally NOT interchangeable.** Aligning them would either\n * regress scroll-restore performance (byte-order + recursive clone is heavier\n * per call) or weaken the sources cache (locale dependence breaks\n * deterministic cache keys across machines). No cross-package equivalence\n * test exists or should be added; the relationship is \"different invariants,\n * different costs, different consumers.\" Audit-2 / audit-2026-05-17 §2\n * documents the choice.\n */\nexport function canonicalJson(value: unknown): string {\n  return JSON.stringify(value, canonicalReplacer);\n}\n\nfunction canonicalReplacer(_key: string, val: unknown): unknown {\n  // audit-2026-05-17 §5 MEDIUM (Sprint A.3) — function/Symbol marker.\n  // `JSON.stringify` silently drops function and symbol values from\n  // object output. Two routes that differ ONLY in a function/Symbol\n  // value would canonicalize to the same string → silent scroll-cache\n  // key collision (positions clobber each other). Replacing the value\n  // with a sentinel string breaks the collision while keeping the\n  // canonical form deterministic. The sentinels are intentionally\n  // ASCII-only and lexically distinct from valid JSON-stringified\n  // values; consumers will see `\"<fn>\"` / `\"<sym>\"` if they ever\n  // round-trip the cache key, signalling the substitution clearly.\n  if (typeof val === \"function\") {\n    return \"<fn>\";\n  }\n  if (typeof val === \"symbol\") {\n    return \"<sym>\";\n  }\n\n  if (val !== null && typeof val === \"object\" && !Array.isArray(val)) {\n    // Null-prototype accumulator: a plain `{}` would interpret\n    // `sorted[\"__proto__\"] = x` as a prototype assignment (silently dropped\n    // from JSON.stringify output AND a prototype-pollution vector). Mirrors\n    // the same guard in `@real-router/sources/canonicalJson`. The two\n    // implementations are still intentionally divergent (see the doc-block\n    // on [[canonicalJson]] above), but prototype-safety is non-negotiable\n    // on both. Lock-test: scrollRestoreKey.properties.ts Invariant 11.\n    const sorted = Object.create(null) as Record<string, unknown>;\n    // eslint-disable-next-line unicorn/no-array-sort -- ng-packagr uses pre-ES2023 lib; toSorted unavailable\n    const keys = Object.keys(val as Record<string, unknown>).sort(\n      (left: string, right: string) => left.localeCompare(right),\n    );\n\n    for (const key of keys) {\n      sorted[key] = (val as Record<string, unknown>)[key];\n    }\n\n    return sorted;\n  }\n\n  return val;\n}\n","import type { Router } from \"@real-router/core\";\n\nexport interface ViewTransitions {\n  destroy: () => void;\n}\n\nconst NOOP_INSTANCE: ViewTransitions = Object.freeze({\n  destroy: () => {\n    /* no-op */\n  },\n});\n\nexport function createViewTransitions(router: Router): ViewTransitions {\n  if (\n    typeof document === \"undefined\" ||\n    typeof document.startViewTransition !== \"function\"\n  ) {\n    return NOOP_INSTANCE;\n  }\n\n  let closeVT: (() => void) | null = null;\n  let currentVT: { skipTransition?: () => void } | null = null;\n  // Tracks whether TRANSITION_SUCCESS fired for the current leave. Used to\n  // distinguish \"benign cleanup abort\" (router's async path aborts its own\n  // controller in a finally block after successful navigation) from \"real\n  // cancellation\" (concurrent navigate, guard rejection, dispose).\n  let successFired = false;\n\n  const resolveAndClear = (): void => {\n    closeVT?.();\n    closeVT = null;\n  };\n\n  const offLeave = router.subscribeLeave(({ signal }) => {\n    // Reentrant abort: signal already aborted when we're called. Open no VT\n    // — router will fall through to TRANSITION_CANCELLED via isCurrentNav()\n    // after leave resolves. addEventListener(\"abort\", ...) does not re-fire\n    // for past events, so skipping startViewTransition is the safe path.\n    if (signal.aborted) {\n      return;\n    }\n\n    successFired = false;\n    resolveAndClear();\n\n    // Return a Promise so the router awaits until the browser invokes\n    // updateCallback. This ensures old DOM snapshot is captured BEFORE the\n    // router commits the new state — giving correct exit→state→entry\n    // ordering (vs fire-and-forget, where URL changes before VT captures).\n    return new Promise<void>((resolveLeave) => {\n      // Capture the resolver synchronously BEFORE startViewTransition() is\n      // called. The browser invokes updateCallback in a later task, but\n      // router.subscribe (TRANSITION_SUCCESS) can fire before that. If we\n      // captured `resolve` inside the callback, subscribe would see closeVT\n      // still null and skip resolving — the deferred would hang for 4s\n      // until the VT API aborts with TimeoutError.\n      const deferred = new Promise<void>((resolve) => {\n        closeVT = resolve;\n      });\n\n      signal.addEventListener(\n        \"abort\",\n        () => {\n          if (successFired) {\n            // Router's async path (#finishAsyncNavigation) aborts its own\n            // controller in a finally block AFTER completeTransition (and\n            // thus AFTER subscribe fired). This is cleanup, not\n            // cancellation — VT is progressing normally, do nothing.\n            return;\n          }\n\n          // Real cancellation (concurrent navigate, dispose). Resolve the\n          // deferred so updateCallback can complete, skip the VT so no\n          // stale animation leaks, and unblock the router if the abort\n          // fires before updateCallback was invoked.\n          resolveAndClear();\n          currentVT?.skipTransition?.();\n          resolveLeave();\n        },\n        { once: true },\n      );\n\n      try {\n        currentVT = document.startViewTransition(() => {\n          // Resolving here unblocks the router at the moment the browser\n          // enters updateCallback — by spec, old DOM snapshot is captured\n          // before this callback runs. Router now proceeds through\n          // activation guards and setState; the VT animation waits on\n          // `deferred`, which is resolved from router.subscribe after a\n          // task-queue tick (see NOTE on setTimeout below).\n          resolveLeave();\n\n          return deferred;\n        });\n      } catch {\n        // Defensive: spec says startViewTransition doesn't throw under\n        // normal conditions, but Chromium has had edge cases (detached\n        // document, extension interference). Clean up and unblock router.\n        resolveAndClear();\n        resolveLeave();\n      }\n    });\n  });\n\n  const offSuccess = router.subscribe(() => {\n    const resolver = closeVT;\n\n    successFired = true;\n    closeVT = null;\n\n    if (resolver === null) {\n      currentVT = null;\n    } else {\n      // CRITICAL: CANNOT use requestAnimationFrame here. When the router\n      // takes the async path (leave returned a Promise), subscribe fires\n      // AFTER the browser has already transitioned VT into the\n      // \"update-callback-called\" phase. In that phase Chromium sets\n      // rendering suppression to true, which ALSO blocks rAF callbacks.\n      // rAF would never fire → deferred never resolves → browser aborts\n      // vt.ready with TimeoutError after 4s (observed in Chromium).\n      //\n      // setTimeout runs on the task queue independent of the rendering\n      // pipeline, so it fires regardless of suppression. React's scheduler\n      // uses MessageChannel tasks, which are queued before our setTimeout,\n      // so the new DOM is committed by the time our callback runs.\n      setTimeout(() => {\n        resolver();\n        currentVT = null;\n      }, 0);\n    }\n  });\n\n  return {\n    destroy: () => {\n      offLeave();\n      offSuccess();\n      currentVT?.skipTransition?.();\n      currentVT = null;\n      resolveAndClear();\n    },\n  };\n}\n","import type {\n  NavigationOptions,\n  Params,\n  Router,\n  State,\n} from \"@real-router/core\";\n\nexport function shouldNavigate(evt: MouseEvent): boolean {\n  return (\n    evt.button === 0 &&\n    !evt.metaKey &&\n    !evt.altKey &&\n    !evt.ctrlKey &&\n    !evt.shiftKey\n  );\n}\n\n// Matches a single percent-escape triple (`%` + two hex digits). Used as\n// the \"already-encoded\" probe in `encodeFragmentInline` below — see the\n// idempotency rationale there.\nconst PERCENT_ESCAPE_PROBE = /%[\\dA-Fa-f]{2}/;\n\n/**\n * RFC 3986 fragment encoding: preserve sub-delims (`&`, `=`, `?`, `:`),\n * encode space, `%`, control chars, non-ASCII via encodeURI; defensively\n * escape `#` (encodeURI does not). Mirrors `encodeHashFragment` in\n * `shared/browser-env/url-context.ts` — duplicated here because the\n * shared/dom-utils symlink graph does not reach shared/browser-env.\n *\n * **Idempotency for pre-encoded input (audit-2026-05-17 §5 MEDIUM E.1).**\n * The doc-comment on `<Link hash>` says the value is a \"decoded fragment\n * without leading #\". But realistic consumers copy hashes out of\n * `location.hash` (which is percent-encoded) and pass them back, so the\n * naive `encodeURI(\"%20\")` would double-encode into `\"%2520\"` and break\n * anchor lookup. We detect a percent-escape triple in the input and, if\n * present, decode + re-encode for idempotency. Malformed `%XX` (e.g.\n * `\"%2\"` or `\"%ZZ\"`) makes `decodeURIComponent` throw — in that case we\n * fall through to plain `encodeURI`, which never throws.\n */\nfunction encodeFragmentInline(decoded: string): string {\n  if (PERCENT_ESCAPE_PROBE.test(decoded)) {\n    try {\n      const roundtrip = decodeURIComponent(decoded);\n\n      return encodeURI(roundtrip).replaceAll(\"#\", \"%23\");\n    } catch {\n      // Malformed `%XX` — fall through to the plain encoding path.\n      // encodeURI does not throw on malformed escapes; it treats the\n      // `%` as a literal and percent-encodes it (`%2` → `%252`).\n    }\n  }\n\n  return encodeURI(decoded).replaceAll(\"#\", \"%23\");\n}\n\ntype BuildUrlFn = (\n  name: string,\n  params: Params,\n  options?: { hash?: string },\n) => string | undefined;\n\n/**\n * Builds an href for a `<Link>` element.\n *\n * - Prefers the URL plugin's `buildUrl` (browser-plugin, navigation-plugin,\n *   hash-plugin) when present.\n * - Falls back to `router.buildPath` for runtimes without a URL plugin\n *   (memory-plugin, console UIs, NativeScript). In that fallback the hash\n *   is appended manually so the rendered href is still correct.\n * - The optional 4th argument is an options object so the contract stays\n *   extensible. The `hash` option is a decoded fragment without leading \"#\";\n *   `<Link hash=\"#section\">` is accepted defensively (leading \"#\" stripped).\n *   Frozen API: previous 3-arg call sites continue to work unchanged.\n */\nexport function buildHref(\n  router: Router,\n  routeName: string,\n  routeParams: Params,\n  options?: { hash?: string },\n): string | undefined {\n  try {\n    const rawHash = options?.hash;\n    let normHash: string | undefined;\n\n    if (rawHash !== undefined) {\n      normHash = rawHash.startsWith(\"#\") ? rawHash.slice(1) : rawHash;\n    }\n\n    const buildUrl = router.buildUrl as BuildUrlFn | undefined;\n\n    if (buildUrl) {\n      const url = buildUrl(\n        routeName,\n        routeParams,\n        normHash === undefined ? undefined : { hash: normHash },\n      );\n\n      // Accept only non-empty strings. The BuildUrlFn type contract is\n      // `string | undefined`, but defensive against:\n      //   - `\"\"` (empty string) → would render `<a href=\"\">`, which resolves\n      //     to the current page URL → silent self-navigation on click.\n      //   - `null` (type-contract violation) → would render `<a href={null}>`,\n      //     stringified to `\"null\"` in some renderers.\n      // Either case falls through to the `router.buildPath` fallback below.\n      if (typeof url === \"string\" && url.length > 0) {\n        return url;\n      }\n    }\n\n    const path = router.buildPath(routeName, routeParams);\n\n    // Symmetric to the buildUrl guard above (#S1 audit, Invariant 12).\n    // `router.buildPath` is typed `string`, but defends against:\n    //   - `\"\"` (empty string) — would render `<a href=\"\">`, which resolves\n    //     to the current page URL → silent self-navigation on click.\n    //   - non-string type-contract violations from custom path-matchers.\n    // Both yield `undefined` (renderer drops the attribute) with a warning.\n    if (typeof path !== \"string\" || path.length === 0) {\n      console.error(\n        `[real-router] Route \"${routeName}\" yielded an empty path. The element will render without an href attribute.`,\n      );\n\n      return undefined;\n    }\n\n    return normHash ? `${path}#${encodeFragmentInline(normHash)}` : path;\n  } catch {\n    console.error(\n      `[real-router] Route \"${routeName}\" is not defined. The element will render without an href attribute.`,\n    );\n\n    return undefined;\n  }\n}\n\n/**\n * `<Link>` click-handler navigation helper (#532).\n *\n * Wraps `router.navigate(name, params, opts)` with same-route different-hash\n * detection: when the consumer clicks a hash-bearing Link that targets the\n * current route with the same params but a different fragment, core's\n * SAME_STATES check would otherwise reject the navigation. The helper adds\n * `force: true` and `hashChange: true` automatically — subscribers can then\n * disambiguate via `state.context.url.hashChanged`.\n *\n * For pure programmatic same-route hash-only navigation, callers are\n * documented to pass `{ force: true }` themselves; the auto-bypass here is\n * a UX convenience for `<Link hash>` that all 6 framework adapters share.\n */\n/**\n * Local extended-options type. Adapters that depend only on `@real-router/core`\n * (without a URL plugin) do not see the `NavigationOptions` augmentation that\n * declares `hash` / `hashChange`. Casting to this widened type inside the\n * helper keeps shared/dom-utils self-contained — adapters do not need to\n * augment NavigationOptions themselves to consume `<Link hash>`.\n */\ntype HashAwareNavigationOptions = NavigationOptions & {\n  hash?: string;\n  hashChange?: boolean;\n};\n\nexport function navigateWithHash(\n  router: Router,\n  routeName: string,\n  routeParams: Params,\n  hash: string | undefined,\n  extraOptions?: NavigationOptions,\n): Promise<State> {\n  const opts: HashAwareNavigationOptions = { ...extraOptions };\n\n  if (hash !== undefined) {\n    opts.hash = hash;\n  }\n\n  const current = router.getState();\n\n  if (\n    current?.name === routeName &&\n    shallowEqual(current.params, routeParams)\n  ) {\n    const currentHash =\n      (current.context as { url?: { hash?: string } } | undefined)?.url?.hash ??\n      \"\";\n    const newHash = hash ?? currentHash;\n\n    if (currentHash !== newHash) {\n      opts.force = true;\n      opts.hashChange = true;\n    }\n  }\n\n  return router.navigate(routeName, routeParams, opts);\n}\n\n// Match-any-whitespace regex shared across calls. RegExp literals at\n// call-site recompile in some engines; lifting it avoids that microcost\n// for the slow-path branch.\nconst WHITESPACE_PROBE = /\\s/;\nconst WHITESPACE_SPLIT = /\\S+/g;\n\nfunction parseTokens(value: string | undefined): string[] {\n  if (!value) {\n    return [];\n  }\n\n  // Hot-path fast-path (audit-2026-05-17 §8b #1): >99% of active-class\n  // inputs at `<Link>` emit are single-token strings like `\"active\"` or\n  // `\"is-current\"` — no whitespace, no leading/trailing pad. Skip the\n  // regex match and Array result allocation: a literal `[value]` works\n  // because the slow-path `match(/\\S+/g)` would return exactly `[value]`\n  // for the same input. PBT lock: linkUtils.properties.ts Invariant 13.\n  if (!WHITESPACE_PROBE.test(value)) {\n    return [value];\n  }\n\n  return value.match(WHITESPACE_SPLIT) ?? [];\n}\n\nexport function buildActiveClassName(\n  isActive: boolean,\n  activeClassName: string | undefined,\n  baseClassName: string | undefined,\n): string | undefined {\n  if (isActive && activeClassName) {\n    const activeTokens = parseTokens(activeClassName);\n\n    if (activeTokens.length === 0) {\n      return baseClassName ?? undefined;\n    }\n    if (!baseClassName) {\n      return activeTokens.join(\" \");\n    }\n\n    const baseTokens = parseTokens(baseClassName);\n    const seen = new Set(baseTokens);\n\n    for (const token of activeTokens) {\n      if (!seen.has(token)) {\n        seen.add(token);\n        baseTokens.push(token);\n      }\n    }\n\n    return baseTokens.join(\" \");\n  }\n\n  return baseClassName ?? undefined;\n}\n\n/**\n * One-level structural equality using `Object.is` per key.\n *\n * **String-keyed properties only (Mini-sprint E.3 — audit-5 §4.2 #3).**\n * Implementation walks `Object.keys()` which by spec returns only\n * enumerable own STRING keys. Symbol-keyed properties — created via\n * `obj[Symbol(\"brand\")] = value` or `{ [Symbol(...)]: value }` — are\n * NOT compared. Two records that differ only in a Symbol-keyed value\n * will compare as equal.\n *\n * This is intentional: route params and Link options are documented as\n * string-keyed primitives (string | number | boolean) — Symbol-keyed\n * metadata (e.g. brand markers, private state) doesn't belong in a\n * cache-key comparison. Switching to `Reflect.ownKeys()` would extend\n * the contract to symbols at the cost of one extra allocation per call\n * (Reflect.ownKeys composes string-keys + symbol-keys arrays). If a\n * consumer relies on symbol-keyed metadata for navigation\n * disambiguation, they should encode it into a string key instead.\n *\n * Mirrors React's `shallowEqual` (packages/shared/shallowEqual.js) in\n * both the string-keys-only semantics and the `hasOwnProperty` guard\n * below.\n */\nexport function shallowEqual(\n  prev: object | undefined,\n  next: object | undefined,\n): boolean {\n  if (Object.is(prev, next)) {\n    return true;\n  }\n  if (!prev || !next) {\n    return false;\n  }\n\n  const prevKeys = Object.keys(prev);\n\n  if (prevKeys.length !== Object.keys(next).length) {\n    return false;\n  }\n\n  const prevRecord = prev as Record<string, unknown>;\n  const nextRecord = next as Record<string, unknown>;\n\n  for (const key of prevKeys) {\n    // hasOwnProperty guard: without it, a key missing in `next` reads as\n    // `undefined` and falsely matches `prev[key] === undefined`. Same shape\n    // as React's shallowEqual (packages/shared/shallowEqual.js).\n    if (\n      !Object.prototype.hasOwnProperty.call(next, key) ||\n      !Object.is(prevRecord[key], nextRecord[key])\n    ) {\n      return false;\n    }\n  }\n\n  return true;\n}\n\nexport function applyLinkA11y(element: HTMLElement | null | undefined): void {\n  if (!element) {\n    return;\n  }\n\n  // Cross-realm safety (audit-2026-05-17 §5 HIGH #4):\n  // `instanceof HTMLAnchorElement` compares against the constructor from\n  // the CURRENT realm. An element created in a different window (iframe\n  // contentDocument, micro-frontend, embedded widget) fails the check\n  // even when it IS a real anchor — the helper would then inject\n  // role=\"link\" + tabindex=\"0\" on top of native anchor semantics,\n  // breaking screen reader output (\"link link\") and focus order.\n  //\n  // tagName is realm-agnostic and is uppercase for HTML-namespaced\n  // elements in any document. SVG `<a>` has lowercase tagName plus a\n  // different prototype (SVGAElement) — skipping it here is wrong by\n  // accident: SVG anchors don't have keyboard activation semantics the\n  // helper would add. But they also don't reach this helper in\n  // practice (router Link components emit HTML anchors). Lock the\n  // uppercase compare to keep the contract narrow.\n  const tag = element.tagName;\n\n  if (tag === \"A\" || tag === \"BUTTON\") {\n    return;\n  }\n  if (!element.hasAttribute(\"role\")) {\n    element.setAttribute(\"role\", \"link\");\n  }\n  if (!element.hasAttribute(\"tabindex\")) {\n    element.setAttribute(\"tabindex\", \"0\");\n  }\n}\n","import { canonicalJson, 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 *\n * The function-branch deliberately omits a `defaultPrevented` check: the\n * single call short-circuits naturally and control returns to the caller\n * (`handleClick`), which then re-reads `evt.defaultPrevented` on the same\n * MouseEvent. The array-branch needs the per-iteration check because the\n * caller cannot observe intermediate handlers — without it, later handlers\n * would still run after an earlier one called `preventDefault()`.\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 the\n    // structural identity of routeName/routeParams/strict/ignoreQueryParams/\n    // hash changes — not on every parent rerender that hands a fresh\n    // `routeParams` literal with the same shape.\n    //\n    // Hot-path note: inline `:routeParams=\"{ id: 1 }\"` in a parent template\n    // allocates a new object each render. Comparing by reference would\n    // tear down + recreate the ActiveRouteSource subscription on every\n    // unrelated parent state change. `canonicalJson(routeParams)` collapses\n    // structurally-equal objects to the same key-order-stable string, so the\n    // subscription persists across re-renders that don't change shape.\n    // (The source's own per-router cache uses the same canonical key under\n    // the hood — this watch dep just mirrors it at the consumer layer.)\n    watch(\n      () =>\n        [\n          props.routeName,\n          canonicalJson(props.routeParams),\n          props.activeStrict,\n          props.ignoreQueryParams,\n          props.hash,\n        ] as const,\n      (\n        [routeName, _paramsKey, activeStrict, ignoreQueryParams, hash],\n        _prev,\n        onCleanup,\n      ) => {\n        // Re-read the raw `routeParams` ref when constructing the source —\n        // canonicalJson was only used for change-detection above, the source\n        // factory still wants the live object.\n        const routeParams = props.routeParams;\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      //\n      // Spread + delete avoids the per-key copy loop on every render — one\n      // allocation + one property deletion instead of N iterations across\n      // data-*, aria-*, role, etc. Hot-path optimisation for Link-heavy pages.\n      const restAttributes = { ...attrs } as Record<string, unknown>;\n\n      delete restAttributes.onClick;\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. Not exported from the package entry; retained for\n * unit tests and rare standalone-directive setups (where v-link is mounted\n * outside any RouterProvider).\n *\n * @internal\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    // Hot-path guard: Vue invokes `updated` on every parent re-render even\n    // when the directive's binding value reference has not changed. Without\n    // this short-circuit, every parent rerender (which is the common case on\n    // Link-heavy pages — any unrelated state change triggers the parent's\n    // render fn) would detach + reattach the click/keydown listeners.\n    // Comparing references is enough: when consumers pass a stable\n    // `LinkDirectiveValue` object (the recommended pattern, since Vue's\n    // template compiler hoists `v-link=\"{ name: 'home' }\"` to a stable\n    // literal), this guard collapses the work to zero.\n    if (binding.value === binding.oldValue) {\n      return;\n    }\n\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 { 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\ninterface Disposable {\n  destroy: () => void;\n}\n\n/**\n * Watch a dependency tuple and (re)create a toggleable utility (announcer /\n * scroll-restorer / view-transitions). The factory returns `undefined` to\n * mean \"feature disabled\" — no utility is created and no cleanup is wired.\n * When a utility IS returned, its `destroy()` is registered via `onCleanup`,\n * so flipping any dep (incl. the feature flag) tears down the previous\n * instance before constructing the next.\n *\n * Extracted from three near-identical `watch(... { immediate: true })` blocks\n * (announceNavigation / scrollRestoration / viewTransitions) — DRY without\n * losing the per-utility dep tuple shape.\n */\nfunction watchToggleableUtility<D extends readonly unknown[]>(\n  deps: () => D,\n  factory: (current: D) => Disposable | undefined,\n): void {\n  watch(\n    deps,\n    (current, _prev, onCleanup) => {\n      const utility = factory(current);\n\n      if (utility) {\n        onCleanup(() => {\n          utility.destroy();\n        });\n      }\n    },\n    { immediate: true },\n  );\n}\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\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    watchToggleableUtility(\n      () => [props.router, props.announceNavigation] as const,\n      ([router, enabled]) =>\n        enabled ? createRouteAnnouncer(router) : undefined,\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    watchToggleableUtility(\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      ([router, enabled, mode, anchorScrolling, behavior, storageKey]) => {\n        if (!enabled) {\n          return;\n        }\n\n        return createScrollRestoration(router, {\n          mode,\n          anchorScrolling,\n          behavior,\n          storageKey,\n          scrollContainer: props.scrollRestoration?.scrollContainer,\n        });\n      },\n    );\n\n    // Reactive viewTransitions: toggling prop creates/destroys the utility.\n    watchToggleableUtility(\n      () => [props.router, props.viewTransitions] as const,\n      ([router, enabled]) =>\n        enabled ? createViewTransitions(router) : undefined,\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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"}