@real-router/react 0.24.1 → 0.26.0

package/dist/cjs/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":["Children","Suspense","Activity","Fragment","UNKNOWN_ROUTE","useRouteNode","useRouter","useRoute"],"sources":["../../src/components/modern/RouteView/components.tsx","../../src/components/modern/RouteView/helpers.tsx","../../src/components/modern/RouteView/RouteView.tsx","../../src/hooks/useRouteExit.tsx","../../src/hooks/useRouteEnter.tsx"],"sourcesContent":["import type { MatchProps, NotFoundProps, SelfProps } from \"./types\";\n\nexport function Match(_props: MatchProps): null {\n  return null;\n}\n\nMatch.displayName = \"RouteView.Match\";\n\nexport function Self(_props: SelfProps): null {\n  return null;\n}\n\nSelf.displayName = \"RouteView.Self\";\n\nexport function NotFound(_props: NotFoundProps): null {\n  return null;\n}\n\nNotFound.displayName = \"RouteView.NotFound\";\n","import { UNKNOWN_ROUTE } from \"@real-router/core\";\nimport { startsWithSegment } from \"@real-router/route-utils\";\nimport { Activity, Children, Fragment, Suspense, isValidElement } from \"react\";\n\nimport { Match, NotFound, Self } from \"./components\";\n\nimport type { MatchProps, NotFoundProps, SelfProps } from \"./types\";\nimport type { ReactElement, ReactNode } from \"react\";\n\ninterface FallbackSlots {\n  selfChildren: ReactNode;\n  selfFallback: ReactNode | undefined;\n  selfFound: boolean;\n  notFoundChildren: ReactNode;\n}\n\nfunction isSegmentMatch(\n  routeName: string,\n  fullSegmentName: string,\n  exact: boolean,\n): boolean {\n  if (fullSegmentName === \"\") {\n    return false;\n  }\n\n  if (exact) {\n    return routeName === fullSegmentName;\n  }\n\n  return startsWithSegment(routeName, fullSegmentName);\n}\n\nexport function collectElements(\n  children: ReactNode,\n  result: ReactElement[],\n): void {\n  // eslint-disable-next-line @eslint-react/no-children-to-array\n  for (const child of Children.toArray(children)) {\n    if (!isValidElement(child)) {\n      continue;\n    }\n\n    if (\n      child.type === Match ||\n      child.type === Self ||\n      child.type === NotFound\n    ) {\n      result.push(child);\n    } else {\n      collectElements(\n        (child.props as { readonly children: ReactNode }).children,\n        result,\n      );\n    }\n  }\n}\n\nfunction renderSlotElement(\n  slotChildren: ReactNode,\n  key: string,\n  keepAlive: boolean,\n  mode: \"visible\" | \"hidden\",\n  fallback?: ReactNode,\n): ReactElement {\n  const content =\n    fallback === undefined ? (\n      slotChildren\n    ) : (\n      <Suspense fallback={fallback}>{slotChildren}</Suspense>\n    );\n\n  if (keepAlive) {\n    return (\n      <Activity mode={mode} key={key}>\n        {content}\n      </Activity>\n    );\n  }\n\n  return <Fragment key={key}>{content}</Fragment>;\n}\n\nfunction recordFallback(child: ReactElement, slots: FallbackSlots): boolean {\n  if (child.type === NotFound) {\n    slots.notFoundChildren = (child.props as NotFoundProps).children;\n\n    return true;\n  }\n\n  if (child.type === Self) {\n    // First-wins: subsequent <Self> elements are ignored, mirroring NotFound.\n    if (!slots.selfFound) {\n      slots.selfChildren = (child.props as SelfProps).children;\n      slots.selfFallback = (child.props as SelfProps).fallback;\n      slots.selfFound = true;\n    }\n\n    return true;\n  }\n\n  return false;\n}\n\nfunction processMatch(\n  child: ReactElement,\n  routeName: string,\n  nodeName: string,\n  hasBeenActivated: Set<string>,\n  alreadyActive: boolean,\n): { rendered: ReactElement | null; matched: boolean } {\n  const {\n    segment,\n    exact = false,\n    keepAlive = false,\n    fallback,\n  } = child.props as MatchProps;\n  const fullSegmentName = nodeName ? `${nodeName}.${segment}` : segment;\n  const isActive =\n    !alreadyActive && isSegmentMatch(routeName, fullSegmentName, exact);\n\n  if (isActive) {\n    hasBeenActivated.add(fullSegmentName);\n\n    return {\n      rendered: renderSlotElement(\n        (child.props as MatchProps).children,\n        fullSegmentName,\n        keepAlive,\n        \"visible\",\n        fallback,\n      ),\n      matched: true,\n    };\n  }\n\n  if (keepAlive && hasBeenActivated.has(fullSegmentName)) {\n    return {\n      rendered: renderSlotElement(\n        (child.props as MatchProps).children,\n        fullSegmentName,\n        keepAlive,\n        \"hidden\",\n        fallback,\n      ),\n      matched: false,\n    };\n  }\n\n  return { rendered: null, matched: false };\n}\n\nfunction appendFallback(\n  rendered: ReactElement[],\n  routeName: string,\n  nodeName: string,\n  slots: FallbackSlots,\n): void {\n  if (slots.selfFound && routeName === nodeName) {\n    rendered.push(\n      renderSlotElement(\n        slots.selfChildren,\n        \"__route-view-self__\",\n        false,\n        \"visible\",\n        slots.selfFallback,\n      ),\n    );\n\n    return;\n  }\n\n  if (routeName === UNKNOWN_ROUTE && slots.notFoundChildren !== null) {\n    rendered.push(\n      <Fragment key=\"__route-view-not-found__\">\n        {slots.notFoundChildren}\n      </Fragment>,\n    );\n  }\n}\n\nexport function buildRenderList(\n  elements: ReactElement[],\n  routeName: string,\n  nodeName: string,\n  hasBeenActivated: Set<string>,\n): { rendered: ReactElement[]; activeMatchFound: boolean } {\n  const slots: FallbackSlots = {\n    selfChildren: null,\n    selfFallback: undefined,\n    selfFound: false,\n    notFoundChildren: null,\n  };\n  let activeMatchFound = false;\n  const rendered: ReactElement[] = [];\n\n  for (const child of elements) {\n    if (recordFallback(child, slots)) {\n      continue;\n    }\n\n    const result = processMatch(\n      child,\n      routeName,\n      nodeName,\n      hasBeenActivated,\n      activeMatchFound,\n    );\n\n    if (result.matched) {\n      activeMatchFound = true;\n    }\n\n    if (result.rendered !== null) {\n      rendered.push(result.rendered);\n    }\n  }\n\n  if (!activeMatchFound) {\n    appendFallback(rendered, routeName, nodeName, slots);\n  }\n\n  return { rendered, activeMatchFound };\n}\n","import { useMemo, useRef } from \"react\";\n\nimport { Match, NotFound, Self } from \"./components\";\nimport { buildRenderList, collectElements } from \"./helpers\";\nimport { useRouteNode } from \"../../../hooks/useRouteNode\";\n\nimport type { RouteViewProps } from \"./types\";\nimport type { ReactElement } from \"react\";\n\nfunction RouteViewRoot({\n  nodeName,\n  children,\n}: Readonly<RouteViewProps>): ReactElement | null {\n  const { route } = useRouteNode(nodeName);\n  const hasBeenActivatedRef = useRef<Set<string> | null>(null);\n\n  // eslint-disable-next-line @eslint-react/refs -- lazy init: assign once when null to avoid `new Set()` allocation on every render\n  hasBeenActivatedRef.current ??= new Set();\n\n  // Skip the Children.toArray + collectElements traversal when children\n  // reference is unchanged. children only changes when the parent re-renders\n  // with a new ReactNode, so this caches the steady-state.\n  const elements = useMemo(() => {\n    const collected: ReactElement[] = [];\n\n    collectElements(children, collected);\n\n    return collected;\n  }, [children]);\n\n  if (!route) {\n    return null;\n  }\n\n  const { rendered } = buildRenderList(\n    elements,\n    route.name,\n    nodeName,\n    // eslint-disable-next-line @eslint-react/refs -- stable Set ref read for keepAlive tracking (never reassigned)\n    hasBeenActivatedRef.current,\n  );\n\n  if (rendered.length > 0) {\n    return <>{rendered}</>;\n  }\n\n  return null;\n}\n\nRouteViewRoot.displayName = \"RouteView\";\n\nexport const RouteView = Object.assign(RouteViewRoot, {\n  Match,\n  Self,\n  NotFound,\n});\n\nexport type {\n  RouteViewProps,\n  MatchProps as RouteViewMatchProps,\n  SelfProps as RouteViewSelfProps,\n  NotFoundProps as RouteViewNotFoundProps,\n} from \"./types\";\n","import { useEffect, useLayoutEffect, useRef } from \"react\";\n\nimport { useRouter } from \"./useRouter\";\n\nimport type { State } from \"@real-router/core\";\n\nexport interface RouteExitContext {\n  /** The route being left. */\n  route: State;\n  /** The route being navigated to. */\n  nextRoute: State;\n  /**\n   * AbortSignal that fires when this navigation is superseded by a later\n   * one (rapid clicks). Already filtered: when the handler runs,\n   * `signal.aborted` is guaranteed to be `false`. Use\n   * `signal.addEventListener(\"abort\", cleanup, { once: true })` for\n   * cleanup that must run on cancellation.\n   */\n  signal: AbortSignal;\n}\n\nexport interface UseRouteExitOptions {\n  /**\n   * Skip the handler when `route.name === nextRoute.name`\n   * (sort/filter/query-only navigations on the same route). Default:\n   * `true`.\n   */\n  skipSameRoute?: boolean;\n}\n\nexport type RouteExitHandler = (\n  context: RouteExitContext,\n) => void | Promise<void>;\n\n/**\n * Subscribe to the router's leave-window with the universal guards baked\n * in. Wraps `router.subscribeLeave` so consumers don't repeat the same\n * boilerplate every time:\n *\n *   - **Reentrant abort pre-check**: if `signal.aborted` is already `true`\n *     when the handler would run (rapid navigation superseded a slower\n *     one), the handler is skipped entirely. `signal.addEventListener(\n *     \"abort\", ...)` does not fire retroactively, so without this guard\n *     downstream cleanup would never trigger.\n *   - **Same-route skip**: by default, `route.name === nextRoute.name`\n *     short-circuits the handler — query-only navigations (sort, filter,\n *     pagination) skip the work. Opt out with `skipSameRoute: false`.\n *   - **Stable handler reference**: the handler can change identity on\n *     every render without causing resubscription — internal ref keeps\n *     the latest handler accessible to the long-lived subscription.\n *\n * Returns nothing — the subscription's lifecycle is bound to the\n * component's mount.\n *\n * If the handler returns a Promise, the router blocks on it. If the\n * Promise resolves, navigation proceeds. If it rejects, the router emits\n * `TRANSITION_CANCELLED` (existing core behavior, no change here).\n *\n * @example Animation\n * ```tsx\n * const ref = useRef<HTMLDivElement>(null);\n *\n * useRouteExit(async ({ signal }) => {\n *   const el = ref.current;\n *   if (!el) return;\n *   el.classList.add(\"fade-out\");\n *   const cleanup = () => el.classList.remove(\"fade-out\");\n *   signal.addEventListener(\"abort\", cleanup, { once: true });\n *   try {\n *     el.getBoundingClientRect();   // style flush\n *     await Promise.allSettled(el.getAnimations().map((a) => a.finished));\n *   } finally {\n *     cleanup();\n *   }\n * });\n * ```\n *\n * @example Auto-save form draft\n * ```tsx\n * useRouteExit(async ({ signal }) => {\n *   if (formState.dirty) await api.saveDraft(formState, { signal });\n * });\n * ```\n *\n * @example Cancel inflight requests\n * ```tsx\n * useRouteExit(() => {\n *   inflightController.abort();\n * });\n * ```\n *\n * @example Library-coordinated exit (motion / framer-motion)\n * ```tsx\n * const exitResolverRef = useRef<(() => void) | null>(null);\n *\n * useRouteExit(({ signal }) => {\n *   return new Promise<void>((resolve) => {\n *     exitResolverRef.current = resolve;\n *     signal.addEventListener(\"abort\", () => resolve(), { once: true });\n *   });\n * });\n *\n * const onExitComplete = () => exitResolverRef.current?.();\n * // pass onExitComplete to <AnimatePresence>\n * ```\n *\n * @example Reading rich transition metadata via `nextRoute.transition`\n * ```tsx\n * useRouteExit(({ route, nextRoute }) => {\n *   // nextRoute.transition: TransitionMeta — preview of the upcoming nav\n *   if (nextRoute.transition.segments.deactivated.includes(\"products\")) {\n *     // leaving the products subtree entirely — flush product-related caches\n *     productCache.clear();\n *   }\n *   if (nextRoute.transition.redirected) {\n *     // skip animation when navigation arrived via redirect\n *     return;\n *   }\n * });\n * ```\n */\nexport function useRouteExit(\n  handler: RouteExitHandler,\n  options?: UseRouteExitOptions,\n): void {\n  const router = useRouter();\n  const handlerRef = useRef(handler);\n  const skipSameRoute = options?.skipSameRoute ?? true;\n\n  // Keep the latest handler accessible to the subscription without\n  // resubscribing on every render — the subscription registers the\n  // wrapper once and dispatches to whatever ref points to.\n  // useLayoutEffect (synchronous, post-render, pre-paint) updates the\n  // ref before the browser can dispatch any router events that could\n  // observe a stale closure.\n  useLayoutEffect(() => {\n    handlerRef.current = handler;\n  });\n\n  useEffect(() => {\n    return router.subscribeLeave(({ route, nextRoute, signal }) => {\n      if (skipSameRoute && route.name === nextRoute.name) {\n        return;\n      }\n\n      // Reentrant abort: signal is already aborted when listener fires\n      // (e.g. a newer navigate superseded this one before subscribeLeave\n      // even ran). addEventListener(\"abort\", ...) does not fire\n      // retroactively, so we skip the handler entirely — any cleanup the\n      // handler would have wired via abort listener must not run because\n      // the corresponding `add` work never happened.\n      if (signal.aborted) {\n        return;\n      }\n\n      return handlerRef.current({ route, nextRoute, signal });\n    });\n  }, [router, skipSameRoute]);\n}\n","import { useEffect, useLayoutEffect, useRef } from \"react\";\n\nimport { useRoute } from \"./useRoute\";\n\nimport type { State } from \"@real-router/core\";\n\nexport interface RouteEnterContext {\n  /** The route that was just activated. */\n  route: State;\n  /** The route that was active immediately before this navigation. */\n  previousRoute: State;\n}\n\nexport type RouteEnterHandler = (context: RouteEnterContext) => void;\n\nexport interface UseRouteEnterOptions {\n  /**\n   * Skip the handler when `route.name === previousRoute.name`\n   * (sort/filter/query-only navigations on the same route). Default:\n   * `true`. Symmetric with `useRouteExit`'s same-name option.\n   */\n  skipSameRoute?: boolean;\n}\n\n/**\n * Fire `handler` once when the component mounts as a result of a\n * navigation. Mirror of `useRouteExit` for the entry side.\n *\n * What this hook covers that ad-hoc `useEffect` + `useRoute()` doesn't:\n *\n *   - **Skip-initial**: handler is skipped when there is no\n *     `previousRoute` (i.e. first-load mount). Most consumers want to\n *     fire side effects only on real navigations, not on hydration.\n *   - **Same-route skip** (default): handler is skipped when\n *     `route.name === previousRoute.name`. Sort/filter/query-only\n *     navigations re-run the effect (because `route` reference changes\n *     in `useRoute`'s snapshot), but they are not \"entries\" in the\n *     animation / analytics sense — the component instance has stayed\n *     mounted throughout. Opt out with `skipSameRoute: false` when\n *     the handler legitimately needs to fire on every navigation\n *     (e.g. analytics tracking each query-param flip).\n *   - **StrictMode double-mount immunity**: in dev, React's StrictMode\n *     runs every effect twice to surface bugs. Without a guard,\n *     analytics fire twice, animations restart, focus jumps. The hook\n *     tracks the last-handled `route` reference and short-circuits the\n *     second pass.\n *   - **Latest-handler ref**: the handler can change identity on every\n *     render without re-running the effect — the registered wrapper\n *     dispatches to whatever `handlerRef.current` points to.\n *   - **Mount-time `route` / `previousRoute` snapshot**: the handler\n *     receives the values that were live at the moment of mount, not\n *     the latest ones (which may have moved on if the user navigated\n *     again before the effect drained).\n *\n * Race-safety: `useRoute()` is wired through `useSyncExternalStore` from\n * `@real-router/sources`, so by the time the new component's effect\n * runs, the snapshot is the post-commit one. This is the reason we can\n * read mount-time context from `useRoute()` instead of subscribing to\n * `router.subscribe` directly (which fires before React schedules a\n * re-render — the well-known race in distributed components).\n *\n * @example Direction-aware entry animation\n * ```tsx\n * useRouteEnter(({ route }) => {\n *   const direction = route.context.browser?.direction;\n *   ref.current?.classList.add(\n *     direction === \"back\" ? \"slide-from-left\" : \"slide-from-right\",\n *   );\n * });\n * ```\n *\n * @example Source-aware focus management\n * ```tsx\n * useRouteEnter(({ route }) => {\n *   if (route.context.browser?.source === \"navigate\") {\n *     headingRef.current?.focus();\n *   }\n * });\n * ```\n *\n * @example Analytics page-enter event (skip-initial built-in)\n * ```tsx\n * useRouteEnter(({ route, previousRoute }) => {\n *   analytics.track(\"page_enter\", {\n *     route: route.name,\n *     from: previousRoute.name,\n *   });\n * });\n * ```\n *\n * @example Reading rich transition metadata via `route.transition`\n * ```tsx\n * useRouteEnter(({ route }) => {\n *   // route.transition: TransitionMeta — populated by core for every state\n *   if (route.transition.redirected) {\n *     showToast(`Redirected from ${route.transition.from}`);\n *   }\n *   if (route.transition.segments.activated.includes(\"products\")) {\n *     // products subtree just became active (could be products or\n *     // products.detail). Useful for subtree-scoped side effects.\n *   }\n * });\n * ```\n */\nexport function useRouteEnter(\n  handler: RouteEnterHandler,\n  options?: UseRouteEnterOptions,\n): void {\n  const { route, previousRoute } = useRoute();\n  const handlerRef = useRef(handler);\n  const lastHandledRouteRef = useRef<State | null>(null);\n  const skipSameRoute = options?.skipSameRoute ?? true;\n\n  // Keep the latest handler reference accessible without re-running\n  // the effect. useLayoutEffect (synchronous, post-render, pre-paint)\n  // updates the ref before the effect can read it.\n  useLayoutEffect(() => {\n    handlerRef.current = handler;\n  });\n\n  useEffect(() => {\n    // Early-exit guards, top-down:\n    //\n    //   - **Skip-initial**: `state.transition.from` is undefined only\n    //     for the very first state committed by `router.start()`.\n    //   - **Skip-same-route**: query-only navigations have\n    //     `transition.from === route.name`. Opt-out via\n    //     `skipSameRoute: false`.\n    //   - **StrictMode dedupe**: same `route` ref between effect\n    //     cleanup + re-run in dev's strict pass. Not testable from\n    //     vitest (`NODE_ENV === \"test\"` disables React's strict-mode\n    //     double-run), so v8-ignored.\n    if (!route.transition.from) {\n      return;\n    }\n    if (skipSameRoute && route.transition.from === route.name) {\n      return;\n    }\n    /* v8 ignore start */\n    if (lastHandledRouteRef.current === route || !previousRoute) {\n      return;\n    }\n    /* v8 ignore stop */\n\n    lastHandledRouteRef.current = route;\n    handlerRef.current({ route, previousRoute });\n  }, [route, previousRoute, skipSameRoute]);\n}\n"],"mappings":"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"}
+{"version":3,"file":"index.js","names":["Suspense","Activity","Fragment","UNKNOWN_ROUTE","useRouteNode","useRouter","useRoute"],"sources":["../../src/components/modern/RouteView/components.tsx","../../src/components/modern/RouteView/helpers.tsx","../../src/components/modern/RouteView/RouteView.tsx","../../src/hooks/useRouteExit.tsx","../../src/hooks/useRouteEnter.tsx"],"sourcesContent":["import type { MatchProps, NotFoundProps, SelfProps } from \"./types\";\n\nexport function Match(_props: MatchProps): null {\n  return null;\n}\n\nMatch.displayName = \"RouteView.Match\";\n\nexport function Self(_props: SelfProps): null {\n  return null;\n}\n\nSelf.displayName = \"RouteView.Self\";\n\nexport function NotFound(_props: NotFoundProps): null {\n  return null;\n}\n\nNotFound.displayName = \"RouteView.NotFound\";\n","import { UNKNOWN_ROUTE } from \"@real-router/core\";\nimport { startsWithSegment } from \"@real-router/route-utils\";\nimport { Activity, Children, Fragment, Suspense, isValidElement } from \"react\";\n\nimport { Match, NotFound, Self } from \"./components\";\n\nimport type { MatchProps, NotFoundProps, SelfProps } from \"./types\";\nimport type { ReactElement, ReactNode } from \"react\";\n\ninterface FallbackSlots {\n  selfChildren: ReactNode;\n  selfFallback: ReactNode | undefined;\n  selfFound: boolean;\n  notFoundChildren: ReactNode;\n}\n\n// Fixed keys used by appendFallback to distinguish the Self / NotFound\n// render slots from user-supplied <Match> children. Match render slots key\n// off `fullSegmentName` instead — these two are the only synthetic keys.\nconst SELF_KEY = \"__route-view-self__\";\nconst NOT_FOUND_KEY = \"__route-view-not-found__\";\n\nfunction isSegmentMatch(\n  routeName: string,\n  fullSegmentName: string,\n  exact: boolean,\n): boolean {\n  if (fullSegmentName === \"\") {\n    return false;\n  }\n\n  if (exact) {\n    return routeName === fullSegmentName;\n  }\n\n  return startsWithSegment(routeName, fullSegmentName);\n}\n\nexport function collectElements(\n  children: ReactNode,\n  result: ReactElement[],\n): void {\n  // Recurses into Fragment-like wrappers (anything that isn't Match / Self /\n  // NotFound) to flatten the slot tree. No explicit depth guard: typical\n  // RouteView shape is `<RouteView><Match/>...<NotFound/></RouteView>` —\n  // depth ≤ 3 in real apps. A pathological hand-written tree of N Fragments\n  // recurses N times; the call stack, not this function, is the bound.\n  //\n  // `Children.forEach` iterates without `Children.toArray`'s array allocation\n  // and per-child clone-with-synthetic-key step. We don't read child.key here\n  // (Match/Self/NotFound carry their own segment-derived keys further down),\n  // so the cheaper iterator is functionally equivalent.\n  // eslint-disable-next-line @eslint-react/no-children-for-each -- intentional: collectElements is a render-hot pipeline; toArray's array+key clone is wasteful here\n  Children.forEach(children, (child) => {\n    if (!isValidElement(child)) {\n      return;\n    }\n\n    if (\n      child.type === Match ||\n      child.type === Self ||\n      child.type === NotFound\n    ) {\n      result.push(child);\n    } else {\n      collectElements(\n        (child.props as { readonly children: ReactNode }).children,\n        result,\n      );\n    }\n  });\n}\n\nfunction renderSlotElement(\n  slotChildren: ReactNode,\n  key: string,\n  keepAlive: boolean,\n  mode: \"visible\" | \"hidden\",\n  fallback?: ReactNode,\n): ReactElement {\n  const content =\n    fallback === undefined ? (\n      slotChildren\n    ) : (\n      <Suspense fallback={fallback}>{slotChildren}</Suspense>\n    );\n\n  if (keepAlive) {\n    return (\n      <Activity mode={mode} key={key}>\n        {content}\n      </Activity>\n    );\n  }\n\n  return <Fragment key={key}>{content}</Fragment>;\n}\n\nfunction recordFallback(child: ReactElement, slots: FallbackSlots): boolean {\n  if (child.type === NotFound) {\n    slots.notFoundChildren = (child.props as NotFoundProps).children;\n\n    return true;\n  }\n\n  if (child.type === Self) {\n    // First-wins: subsequent <Self> elements are ignored, mirroring NotFound.\n    if (!slots.selfFound) {\n      slots.selfChildren = (child.props as SelfProps).children;\n      slots.selfFallback = (child.props as SelfProps).fallback;\n      slots.selfFound = true;\n    }\n\n    return true;\n  }\n\n  return false;\n}\n\nfunction processMatch(\n  child: ReactElement,\n  routeName: string,\n  nodeName: string,\n  hasBeenActivated: Set<string>,\n  alreadyActive: boolean,\n): { rendered: ReactElement | null; matched: boolean } {\n  const matchProps = child.props as MatchProps;\n  const { segment, exact = false, keepAlive = false, fallback } = matchProps;\n  const fullSegmentName = nodeName ? `${nodeName}.${segment}` : segment;\n  const isActive =\n    !alreadyActive && isSegmentMatch(routeName, fullSegmentName, exact);\n\n  if (isActive) {\n    hasBeenActivated.add(fullSegmentName);\n\n    return {\n      rendered: renderSlotElement(\n        matchProps.children,\n        fullSegmentName,\n        keepAlive,\n        \"visible\",\n        fallback,\n      ),\n      matched: true,\n    };\n  }\n\n  if (keepAlive && hasBeenActivated.has(fullSegmentName)) {\n    return {\n      rendered: renderSlotElement(\n        matchProps.children,\n        fullSegmentName,\n        keepAlive,\n        \"hidden\",\n        fallback,\n      ),\n      matched: false,\n    };\n  }\n\n  return { rendered: null, matched: false };\n}\n\nfunction appendFallback(\n  rendered: ReactElement[],\n  routeName: string,\n  nodeName: string,\n  slots: FallbackSlots,\n): void {\n  if (slots.selfFound && routeName === nodeName) {\n    rendered.push(\n      renderSlotElement(\n        slots.selfChildren,\n        SELF_KEY,\n        false,\n        \"visible\",\n        slots.selfFallback,\n      ),\n    );\n\n    return;\n  }\n\n  if (routeName === UNKNOWN_ROUTE && slots.notFoundChildren !== null) {\n    rendered.push(\n      <Fragment key={NOT_FOUND_KEY}>{slots.notFoundChildren}</Fragment>,\n    );\n  }\n}\n\nexport function buildRenderList(\n  elements: ReactElement[],\n  routeName: string,\n  nodeName: string,\n  hasBeenActivated: Set<string>,\n): { rendered: ReactElement[]; activeMatchFound: boolean } {\n  const slots: FallbackSlots = {\n    selfChildren: null,\n    selfFallback: undefined,\n    selfFound: false,\n    notFoundChildren: null,\n  };\n  let activeMatchFound = false;\n  const rendered: ReactElement[] = [];\n\n  for (const child of elements) {\n    if (recordFallback(child, slots)) {\n      continue;\n    }\n\n    const result = processMatch(\n      child,\n      routeName,\n      nodeName,\n      hasBeenActivated,\n      activeMatchFound,\n    );\n\n    if (result.matched) {\n      activeMatchFound = true;\n    }\n\n    if (result.rendered !== null) {\n      rendered.push(result.rendered);\n    }\n  }\n\n  if (!activeMatchFound) {\n    appendFallback(rendered, routeName, nodeName, slots);\n  }\n\n  return { rendered, activeMatchFound };\n}\n","import { useMemo, useRef } from \"react\";\n\nimport { Match, NotFound, Self } from \"./components\";\nimport { buildRenderList, collectElements } from \"./helpers\";\nimport { useRouteNode } from \"../../../hooks/useRouteNode\";\n\nimport type { RouteViewProps } from \"./types\";\nimport type { ReactElement } from \"react\";\n\nfunction RouteViewRoot({\n  nodeName,\n  children,\n}: Readonly<RouteViewProps>): ReactElement | null {\n  const { route } = useRouteNode(nodeName);\n  const hasBeenActivatedRef = useRef<Set<string> | null>(null);\n\n  // eslint-disable-next-line @eslint-react/refs -- lazy init: assign once when null to avoid `new Set()` allocation on every render\n  hasBeenActivatedRef.current ??= new Set();\n\n  // Skip the Children.forEach + collectElements traversal when the children\n  // reference is unchanged. The common SPA case is a stable JSX tree across\n  // re-renders, so the cache hits on every render except the first.\n  //\n  // Streaming SSR caveat: with `renderToReadableStream`, React may invoke\n  // RouteView multiple times across chunks with a fresh `children` reference\n  // each time. The useMemo misses on each new render and the traversal runs\n  // again — this is the expected SSR cost; the alternative would be build-\n  // time codegen of the static route tree, which is out of scope here.\n  const elements = useMemo(() => {\n    const collected: ReactElement[] = [];\n\n    collectElements(children, collected);\n\n    return collected;\n  }, [children]);\n\n  if (!route) {\n    return null;\n  }\n\n  const { rendered } = buildRenderList(\n    elements,\n    route.name,\n    nodeName,\n    // eslint-disable-next-line @eslint-react/refs -- stable Set ref read for keepAlive tracking (never reassigned)\n    hasBeenActivatedRef.current,\n  );\n\n  if (rendered.length > 0) {\n    return <>{rendered}</>;\n  }\n\n  return null;\n}\n\nRouteViewRoot.displayName = \"RouteView\";\n\nexport const RouteView = Object.assign(RouteViewRoot, {\n  Match,\n  Self,\n  NotFound,\n});\n\nexport type {\n  RouteViewProps,\n  MatchProps as RouteViewMatchProps,\n  SelfProps as RouteViewSelfProps,\n  NotFoundProps as RouteViewNotFoundProps,\n} from \"./types\";\n","import { useEffect, useLayoutEffect, useRef } from \"react\";\n\nimport { useRouter } from \"./useRouter\";\n\nimport type { State } from \"@real-router/core\";\n\nexport interface RouteExitContext {\n  /** The route being left. */\n  route: State;\n  /** The route being navigated to. */\n  nextRoute: State;\n  /**\n   * AbortSignal that fires when this navigation is superseded by a later\n   * one (rapid clicks). Already filtered: when the handler runs,\n   * `signal.aborted` is guaranteed to be `false`. Use\n   * `signal.addEventListener(\"abort\", cleanup, { once: true })` for\n   * cleanup that must run on cancellation.\n   */\n  signal: AbortSignal;\n}\n\nexport interface UseRouteExitOptions {\n  /**\n   * Skip the handler when `route.name === nextRoute.name`\n   * (sort/filter/query-only navigations on the same route). Default:\n   * `true`.\n   */\n  skipSameRoute?: boolean;\n}\n\nexport type RouteExitHandler = (\n  context: RouteExitContext,\n) => void | Promise<void>;\n\n/**\n * Subscribe to the router's leave-window with the universal guards baked\n * in. Wraps `router.subscribeLeave` so consumers don't repeat the same\n * boilerplate every time:\n *\n *   - **Reentrant abort pre-check**: if `signal.aborted` is already `true`\n *     when the handler would run (rapid navigation superseded a slower\n *     one), the handler is skipped entirely. `signal.addEventListener(\n *     \"abort\", ...)` does not fire retroactively, so without this guard\n *     downstream cleanup would never trigger.\n *   - **Same-route skip**: by default, `route.name === nextRoute.name`\n *     short-circuits the handler — query-only navigations (sort, filter,\n *     pagination) skip the work. Opt out with `skipSameRoute: false`.\n *   - **Stable handler reference**: the handler can change identity on\n *     every render without causing resubscription — internal ref keeps\n *     the latest handler accessible to the long-lived subscription.\n *\n * Returns nothing — the subscription's lifecycle is bound to the\n * component's mount.\n *\n * If the handler returns a Promise, the router blocks on it. If the\n * Promise resolves, navigation proceeds. If it rejects, the router emits\n * `TRANSITION_CANCELLED` (existing core behavior, no change here).\n *\n * @example Animation\n * ```tsx\n * const ref = useRef<HTMLDivElement>(null);\n *\n * useRouteExit(async ({ signal }) => {\n *   const el = ref.current;\n *   if (!el) return;\n *   el.classList.add(\"fade-out\");\n *   const cleanup = () => el.classList.remove(\"fade-out\");\n *   signal.addEventListener(\"abort\", cleanup, { once: true });\n *   try {\n *     el.getBoundingClientRect();   // style flush\n *     await Promise.allSettled(el.getAnimations().map((a) => a.finished));\n *   } finally {\n *     cleanup();\n *   }\n * });\n * ```\n *\n * @example Auto-save form draft\n * ```tsx\n * useRouteExit(async ({ signal }) => {\n *   if (formState.dirty) await api.saveDraft(formState, { signal });\n * });\n * ```\n *\n * @example Cancel inflight requests\n * ```tsx\n * useRouteExit(() => {\n *   inflightController.abort();\n * });\n * ```\n *\n * @example Library-coordinated exit (motion / framer-motion)\n * ```tsx\n * const exitResolverRef = useRef<(() => void) | null>(null);\n *\n * useRouteExit(({ signal }) => {\n *   return new Promise<void>((resolve) => {\n *     exitResolverRef.current = resolve;\n *     signal.addEventListener(\"abort\", () => resolve(), { once: true });\n *   });\n * });\n *\n * const onExitComplete = () => exitResolverRef.current?.();\n * // pass onExitComplete to <AnimatePresence>\n * ```\n *\n * @example Reading rich transition metadata via `nextRoute.transition`\n * ```tsx\n * useRouteExit(({ route, nextRoute }) => {\n *   // nextRoute.transition: TransitionMeta — preview of the upcoming nav\n *   if (nextRoute.transition.segments.deactivated.includes(\"products\")) {\n *     // leaving the products subtree entirely — flush product-related caches\n *     productCache.clear();\n *   }\n *   if (nextRoute.transition.redirected) {\n *     // skip animation when navigation arrived via redirect\n *     return;\n *   }\n * });\n * ```\n */\nexport function useRouteExit(\n  handler: RouteExitHandler,\n  options?: UseRouteExitOptions,\n): void {\n  const router = useRouter();\n  const handlerRef = useRef(handler);\n  const skipSameRoute = options?.skipSameRoute ?? true;\n\n  // Keep the latest handler accessible to the subscription without\n  // resubscribing on every render — the subscription registers the\n  // wrapper once and dispatches to whatever ref points to.\n  // useLayoutEffect (synchronous, post-render, pre-paint) updates the\n  // ref before the browser can dispatch any router events that could\n  // observe a stale closure.\n  useLayoutEffect(() => {\n    handlerRef.current = handler;\n  });\n\n  useEffect(() => {\n    return router.subscribeLeave(({ route, nextRoute, signal }) => {\n      if (skipSameRoute && route.name === nextRoute.name) {\n        return;\n      }\n\n      // Reentrant abort: signal is already aborted when listener fires\n      // (e.g. a newer navigate superseded this one before subscribeLeave\n      // even ran). addEventListener(\"abort\", ...) does not fire\n      // retroactively, so we skip the handler entirely — any cleanup the\n      // handler would have wired via abort listener must not run because\n      // the corresponding `add` work never happened.\n      if (signal.aborted) {\n        return;\n      }\n\n      return handlerRef.current({ route, nextRoute, signal });\n    });\n  }, [router, skipSameRoute]);\n}\n","import { useEffect, useLayoutEffect, useRef } from \"react\";\n\nimport { useRoute } from \"./useRoute\";\n\nimport type { State } from \"@real-router/core\";\n\nexport interface RouteEnterContext {\n  /** The route that was just activated. */\n  route: State;\n  /** The route that was active immediately before this navigation. */\n  previousRoute: State;\n}\n\nexport type RouteEnterHandler = (context: RouteEnterContext) => void;\n\nexport interface UseRouteEnterOptions {\n  /**\n   * Skip the handler when `route.name === previousRoute.name`\n   * (sort/filter/query-only navigations on the same route). Default:\n   * `true`. Symmetric with `useRouteExit`'s same-name option.\n   */\n  skipSameRoute?: boolean;\n}\n\n/**\n * Fire `handler` once when the component mounts as a result of a\n * navigation. Mirror of `useRouteExit` for the entry side.\n *\n * What this hook covers that ad-hoc `useEffect` + `useRoute()` doesn't:\n *\n *   - **Skip-initial**: handler is skipped when there is no\n *     `previousRoute` (i.e. first-load mount). Most consumers want to\n *     fire side effects only on real navigations, not on hydration.\n *   - **Same-route skip** (default): handler is skipped when\n *     `route.name === previousRoute.name`. Sort/filter/query-only\n *     navigations re-run the effect (because `route` reference changes\n *     in `useRoute`'s snapshot), but they are not \"entries\" in the\n *     animation / analytics sense — the component instance has stayed\n *     mounted throughout. Opt out with `skipSameRoute: false` when\n *     the handler legitimately needs to fire on every navigation\n *     (e.g. analytics tracking each query-param flip).\n *   - **StrictMode double-mount immunity**: in dev, React's StrictMode\n *     runs every effect twice to surface bugs. Without a guard,\n *     analytics fire twice, animations restart, focus jumps. The hook\n *     tracks the last-handled `route` reference and short-circuits the\n *     second pass.\n *   - **Latest-handler ref**: the handler can change identity on every\n *     render without re-running the effect — the registered wrapper\n *     dispatches to whatever `handlerRef.current` points to.\n *   - **Mount-time `route` / `previousRoute` snapshot**: the handler\n *     receives the values that were live at the moment of mount, not\n *     the latest ones (which may have moved on if the user navigated\n *     again before the effect drained).\n *\n * Race-safety: `useRoute()` is wired through `useSyncExternalStore` from\n * `@real-router/sources`, so by the time the new component's effect\n * runs, the snapshot is the post-commit one. This is the reason we can\n * read mount-time context from `useRoute()` instead of subscribing to\n * `router.subscribe` directly (which fires before React schedules a\n * re-render — the well-known race in distributed components).\n *\n * @example Direction-aware entry animation\n * ```tsx\n * useRouteEnter(({ route }) => {\n *   const direction = route.context.browser?.direction;\n *   ref.current?.classList.add(\n *     direction === \"back\" ? \"slide-from-left\" : \"slide-from-right\",\n *   );\n * });\n * ```\n *\n * @example Source-aware focus management\n * ```tsx\n * useRouteEnter(({ route }) => {\n *   if (route.context.browser?.source === \"navigate\") {\n *     headingRef.current?.focus();\n *   }\n * });\n * ```\n *\n * @example Analytics page-enter event (skip-initial built-in)\n * ```tsx\n * useRouteEnter(({ route, previousRoute }) => {\n *   analytics.track(\"page_enter\", {\n *     route: route.name,\n *     from: previousRoute.name,\n *   });\n * });\n * ```\n *\n * @example Reading rich transition metadata via `route.transition`\n * ```tsx\n * useRouteEnter(({ route }) => {\n *   // route.transition: TransitionMeta — populated by core for every state\n *   if (route.transition.redirected) {\n *     showToast(`Redirected from ${route.transition.from}`);\n *   }\n *   if (route.transition.segments.activated.includes(\"products\")) {\n *     // products subtree just became active (could be products or\n *     // products.detail). Useful for subtree-scoped side effects.\n *   }\n * });\n * ```\n */\nexport function useRouteEnter(\n  handler: RouteEnterHandler,\n  options?: UseRouteEnterOptions,\n): void {\n  const { route, previousRoute } = useRoute();\n  const handlerRef = useRef(handler);\n  const lastHandledRouteRef = useRef<State | null>(null);\n  const skipSameRoute = options?.skipSameRoute ?? true;\n\n  // Keep the latest handler reference accessible without re-running\n  // the effect. useLayoutEffect (synchronous, post-render, pre-paint)\n  // updates the ref before the effect can read it.\n  useLayoutEffect(() => {\n    handlerRef.current = handler;\n  });\n\n  useEffect(() => {\n    // Early-exit guards, top-down:\n    //\n    //   - **Skip-initial**: `state.transition.from` is undefined only\n    //     for the very first state committed by `router.start()`.\n    //   - **Skip-same-route**: query-only navigations have\n    //     `transition.from === route.name`. Opt-out via\n    //     `skipSameRoute: false`.\n    //   - **StrictMode dedupe**: same `route` ref between effect\n    //     cleanup + re-run in dev's strict pass. Not testable from\n    //     vitest (`NODE_ENV === \"test\"` disables React's strict-mode\n    //     double-run), so v8-ignored.\n    if (!route.transition.from) {\n      return;\n    }\n    if (skipSameRoute && route.transition.from === route.name) {\n      return;\n    }\n    /* v8 ignore start */\n    if (lastHandledRouteRef.current === route || !previousRoute) {\n      return;\n    }\n    /* v8 ignore stop */\n\n    lastHandledRouteRef.current = route;\n    handlerRef.current({ route, previousRoute });\n  }, [route, previousRoute, skipSameRoute]);\n}\n"],"mappings":"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"}

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

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

package/dist/cjs/ink.d.ts

@@ -1,4 +1,5 @@
-import { a as useNavigator, c as RouterErrorBoundaryProps, i as useRouteUtils, n as useRouteNode, o as useRouter, r as useRoute, s as RouterErrorBoundary, t as useRouterTransition } from "./useRouterTransition-BYit_9Mt.js";
+import { n as RouterErrorBoundaryProps, t as RouterErrorBoundary } from "./RouterErrorBoundary-BlJmaoyr.js";
+import { a as useNavigator, i as useRouteUtils, n as useRouteNode, o as useRouter, r as useRoute, t as useRouterTransition } from "./useRouterTransition-BfayPs0h.js";
 import { FC, ReactNode } from "react";
 import { NavigationOptions, Navigator, Params, Router } from "@real-router/core";
 import { RouterTransitionSnapshot } from "@real-router/sources";

package/dist/cjs/ink.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ink.d.ts","names":[],"sources":["../../src/ink-types.ts","../../src/components/InkLink.tsx","../../src/components/InkRouterProvider.tsx"],"mappings":";;;;;;UAGiB,YAAA,WAAuB,MAAA,GAAS,MAAA;EAC/C,SAAA;EACA,WAAA,GAAc,CAAA;EACd,YAAA,GAAe,iBAAA;EACf,YAAA;EACA,iBAAA;EACA,QAAA,GAAW,SAAA;EACX,KAAA;EACA,WAAA;EACA,UAAA;EACA,OAAA;EACA,aAAA;EACA,YAAA;EACA,EAAA;EACA,SAAA;EACA,QAAA;AAAA;AAAA,UAGe,sBAAA;EACf,MAAA,EAAQ,MAAA;EACR,QAAA,GAAW,SAAA;AAAA;;;cCmFA,OAAA,EAAS,EAAA,CAAG,YAAA;;;cCrGZ,iBAAA,EAAmB,EAAA,CAAG,sBAAA"}
+{"version":3,"file":"ink.d.ts","names":[],"sources":["../../src/ink-types.ts","../../src/components/InkLink.tsx","../../src/components/InkRouterProvider.tsx"],"mappings":";;;;;;;UAGiB,YAAA,WAAuB,MAAA,GAAS,MAAA;EAC/C,SAAA;EACA,WAAA,GAAc,CAAA;EACd,YAAA,GAAe,iBAAA;EACf,YAAA;EACA,iBAAA;EACA,QAAA,GAAW,SAAA;EACX,KAAA;EACA,WAAA;EACA,UAAA;EACA,OAAA;EACA,aAAA;EACA,YAAA;EACA,EAAA;EACA,SAAA;EACA,QAAA;AAAA;AAAA,UAGe,sBAAA;EACf,MAAA,EAAQ,MAAA;EACR,QAAA,GAAW,SAAS;AAAA;;;cCyGT,OAAA,EAAS,EAAE,CAAC,YAAA;;;cC3HZ,iBAAA,EAAmB,EAAE,CAAC,sBAAA"}

package/dist/cjs/ink.js

@@ -1,2 +1,2 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require(`./RouterProvider-CfBNR-k7.js`);let t=require(`react`),n=require(`react/jsx-runtime`),r=require(`ink`);function i(t,n){return t.routeName===n.routeName&&t.activeStrict===n.activeStrict&&t.ignoreQueryParams===n.ignoreQueryParams&&t.color===n.color&&t.activeColor===n.activeColor&&t.focusColor===n.focusColor&&t.inverse===n.inverse&&t.activeInverse===n.activeInverse&&t.focusInverse===n.focusInverse&&t.id===n.id&&t.autoFocus===n.autoFocus&&t.onSelect===n.onSelect&&t.children===n.children&&e.d(t.routeParams,n.routeParams)&&e.d(t.routeOptions,n.routeOptions)}const a=(0,t.memo)(({routeName:i,routeParams:a=e.m,routeOptions:o=e.p,activeStrict:s=!1,ignoreQueryParams:c=!0,color:l,activeColor:u,focusColor:d,inverse:f,activeInverse:p,focusInverse:m,id:h,autoFocus:g,onSelect:_,children:v})=>{let y=e.g(),{isFocused:b}=(0,r.useFocus)({...h!==void 0&&{id:h},...g!==void 0&&{autoFocus:g}}),x=e.s(i,a,s,c),S=(0,t.useCallback)(()=>{_?.(),y.navigate(i,a,o).catch(()=>{})},[_,y,i,a,o]);(0,r.useInput)((e,t)=>{t.return&&S()},{isActive:b});let C=l;b?C=d??u??l:x&&(C=u??l);let w=f;b?w=m??p??f:x&&(w=p??f);let T={};return C!==void 0&&(T.color=C),w!==void 0&&(T.inverse=w),(0,n.jsx)(r.Text,{...T,children:v})},i);a.displayName=`InkLink`;const o=({router:t,children:r})=>(0,n.jsx)(e.t,{router:t,children:r});exports.InkLink=a,exports.InkRouterProvider=o,exports.RouterErrorBoundary=e.o,exports.useNavigator=e.a,exports.useRoute=e.r,exports.useRouteNode=e.h,exports.useRouteUtils=e.i,exports.useRouter=e.g,exports.useRouterTransition=e.n;
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require(`./useRoute-Dudo2K_0.js`),t=require(`./RouterProvider-DGrUfyLj.js`);let n=require(`react`),r=require(`react/jsx-runtime`),i=require(`ink`);function a(e,t,n,r,i){return e?n??r??i:t?r??i:i}function o(e,n){return e.routeName===n.routeName&&e.activeStrict===n.activeStrict&&e.ignoreQueryParams===n.ignoreQueryParams&&e.color===n.color&&e.activeColor===n.activeColor&&e.focusColor===n.focusColor&&e.inverse===n.inverse&&e.activeInverse===n.activeInverse&&e.focusInverse===n.focusInverse&&e.id===n.id&&e.autoFocus===n.autoFocus&&e.onSelect===n.onSelect&&e.children===n.children&&t.u(e.routeParams,n.routeParams)&&t.u(e.routeOptions,n.routeOptions)}const s=(0,n.memo)(({routeName:n,routeParams:o=e.r,routeOptions:s=e.n,activeStrict:c=!1,ignoreQueryParams:l=!0,color:u,activeColor:d,focusColor:f,inverse:p,activeInverse:m,focusInverse:h,id:g,autoFocus:_,onSelect:v,children:y})=>{let b=t.p(),{isFocused:x}=(0,i.useFocus)({...g!==void 0&&{id:g},..._!==void 0&&{autoFocus:_}}),S=t.o(n,o,c,l);(0,i.useInput)((e,t)=>{t.return&&(v?.(),b.navigate(n,o,s).catch(()=>{}))},{isActive:x});let C=a(x,S,f,d,u),w=a(x,S,h,m,p),T={};return C!==void 0&&(T.color=C),w!==void 0&&(T.inverse=w),(0,r.jsx)(i.Text,{...T,children:y})},o);s.displayName=`InkLink`;const c=({router:e,children:n})=>(0,r.jsx)(t.t,{router:e,children:n});exports.InkLink=s,exports.InkRouterProvider=c,exports.RouterErrorBoundary=t.a,exports.useNavigator=t.i,exports.useRoute=e.t,exports.useRouteNode=t.f,exports.useRouteUtils=t.r,exports.useRouter=t.p,exports.useRouterTransition=t.n;
 //# sourceMappingURL=ink.js.map

package/dist/cjs/ink.js.map

@@ -1 +1 @@
-{"version":3,"file":"ink.js","names":["shallowEqual","EMPTY_PARAMS","EMPTY_OPTIONS","useRouter","useIsActiveRoute","Text","RouterProvider"],"sources":["../../src/components/InkLink.tsx","../../src/components/InkRouterProvider.tsx"],"sourcesContent":["import { Text, useFocus, useInput } from \"ink\";\nimport { memo, useCallback } from \"react\";\n\nimport { EMPTY_OPTIONS, EMPTY_PARAMS } from \"../constants\";\nimport { shallowEqual } from \"../dom-utils\";\nimport { useIsActiveRoute } from \"../hooks/useIsActiveRoute\";\nimport { useRouter } from \"../hooks/useRouter\";\n\nimport type { InkLinkProps } from \"../ink-types\";\nimport type { FC } from \"react\";\n\nfunction areInkLinkPropsEqual(\n  prev: Readonly<InkLinkProps>,\n  next: Readonly<InkLinkProps>,\n): boolean {\n  return (\n    prev.routeName === next.routeName &&\n    prev.activeStrict === next.activeStrict &&\n    prev.ignoreQueryParams === next.ignoreQueryParams &&\n    prev.color === next.color &&\n    prev.activeColor === next.activeColor &&\n    prev.focusColor === next.focusColor &&\n    prev.inverse === next.inverse &&\n    prev.activeInverse === next.activeInverse &&\n    prev.focusInverse === next.focusInverse &&\n    prev.id === next.id &&\n    prev.autoFocus === next.autoFocus &&\n    prev.onSelect === next.onSelect &&\n    prev.children === next.children &&\n    shallowEqual(prev.routeParams, next.routeParams) &&\n    shallowEqual(prev.routeOptions, next.routeOptions)\n  );\n}\n\nconst InkLinkImpl: FC<InkLinkProps> = ({\n  routeName,\n  routeParams = EMPTY_PARAMS,\n  routeOptions = EMPTY_OPTIONS,\n  activeStrict = false,\n  ignoreQueryParams = true,\n  color,\n  activeColor,\n  focusColor,\n  inverse,\n  activeInverse,\n  focusInverse,\n  id,\n  autoFocus,\n  onSelect,\n  children,\n}) => {\n  const router = useRouter();\n  const { isFocused } = useFocus({\n    ...(id !== undefined && { id }),\n    ...(autoFocus !== undefined && { autoFocus }),\n  });\n  const isRouteActive = useIsActiveRoute(\n    routeName,\n    routeParams,\n    activeStrict,\n    ignoreQueryParams,\n  );\n\n  const activate = useCallback(() => {\n    onSelect?.();\n    router.navigate(routeName, routeParams, routeOptions).catch(() => {});\n  }, [onSelect, router, routeName, routeParams, routeOptions]);\n\n  useInput(\n    (_input, key) => {\n      if (key.return) {\n        activate();\n      }\n    },\n    { isActive: isFocused },\n  );\n\n  let finalColor = color;\n\n  if (isFocused) {\n    finalColor = focusColor ?? activeColor ?? color;\n  } else if (isRouteActive) {\n    finalColor = activeColor ?? color;\n  }\n\n  let finalInverse = inverse;\n\n  if (isFocused) {\n    finalInverse = focusInverse ?? activeInverse ?? inverse;\n  } else if (isRouteActive) {\n    finalInverse = activeInverse ?? inverse;\n  }\n\n  const textProps: { color?: string; inverse?: boolean } = {};\n\n  if (finalColor !== undefined) {\n    textProps.color = finalColor;\n  }\n\n  if (finalInverse !== undefined) {\n    textProps.inverse = finalInverse;\n  }\n\n  return <Text {...textProps}>{children}</Text>;\n};\n\nexport const InkLink: FC<InkLinkProps> = memo(\n  InkLinkImpl,\n  areInkLinkPropsEqual,\n);\n\nInkLink.displayName = \"InkLink\";\n","import { RouterProvider } from \"../RouterProvider\";\n\nimport type { InkRouterProviderProps } from \"../ink-types\";\nimport type { FC } from \"react\";\n\nexport const InkRouterProvider: FC<InkRouterProviderProps> = ({\n  router,\n  children,\n}) => <RouterProvider router={router}>{children}</RouterProvider>;\n"],"mappings":"0LAWA,SAAS,EACP,EACA,EACS,CACT,OACE,EAAK,YAAc,EAAK,WACxB,EAAK,eAAiB,EAAK,cAC3B,EAAK,oBAAsB,EAAK,mBAChC,EAAK,QAAU,EAAK,OACpB,EAAK,cAAgB,EAAK,aAC1B,EAAK,aAAe,EAAK,YACzB,EAAK,UAAY,EAAK,SACtB,EAAK,gBAAkB,EAAK,eAC5B,EAAK,eAAiB,EAAK,cAC3B,EAAK,KAAO,EAAK,IACjB,EAAK,YAAc,EAAK,WACxB,EAAK,WAAa,EAAK,UACvB,EAAK,WAAa,EAAK,UACvBA,EAAAA,EAAa,EAAK,YAAa,EAAK,YAAY,EAChDA,EAAAA,EAAa,EAAK,aAAc,EAAK,aAAa,CA4EtD,MAAa,GAAA,EAAA,EAAA,OAxE0B,CACrC,YACA,cAAcC,EAAAA,EACd,eAAeC,EAAAA,EACf,eAAe,GACf,oBAAoB,GACpB,QACA,cACA,aACA,UACA,gBACA,eACA,KACA,YACA,WACA,cACI,CACJ,IAAM,EAASC,EAAAA,GAAW,CACpB,CAAE,cAAA,EAAA,EAAA,UAAuB,CAC7B,GAAI,IAAO,IAAA,IAAa,CAAE,KAAI,CAC9B,GAAI,IAAc,IAAA,IAAa,CAAE,YAAW,CAC7C,CAAC,CACI,EAAgBC,EAAAA,EACpB,EACA,EACA,EACA,EACD,CAEK,GAAA,EAAA,EAAA,iBAA6B,CACjC,KAAY,CACZ,EAAO,SAAS,EAAW,EAAa,EAAa,CAAC,UAAY,GAAG,EACpE,CAAC,EAAU,EAAQ,EAAW,EAAa,EAAa,CAAC,EAE5D,EAAA,EAAA,WACG,EAAQ,IAAQ,CACX,EAAI,QACN,GAAU,EAGd,CAAE,SAAU,EAAW,CACxB,CAED,IAAI,EAAa,EAEb,EACF,EAAa,GAAc,GAAe,EACjC,IACT,EAAa,GAAe,GAG9B,IAAI,EAAe,EAEf,EACF,EAAe,GAAgB,GAAiB,EACvC,IACT,EAAe,GAAiB,GAGlC,IAAM,EAAmD,EAAE,CAU3D,OARI,IAAe,IAAA,KACjB,EAAU,MAAQ,GAGhB,IAAiB,IAAA,KACnB,EAAU,QAAU,IAGf,EAAA,EAAA,KAACC,EAAAA,KAAD,CAAM,GAAI,EAAY,WAAgB,CAAA,EAK7C,EACD,CAED,EAAQ,YAAc,UC1GtB,MAAa,GAAiD,CAC5D,SACA,eACI,EAAA,EAAA,KAACC,EAAAA,EAAD,CAAwB,SAAS,WAA0B,CAAA"}
+{"version":3,"file":"ink.js","names":["shallowEqual","EMPTY_PARAMS","EMPTY_OPTIONS","useRouter","useIsActiveRoute","Text","RouterProvider"],"sources":["../../src/components/InkLink.tsx","../../src/components/InkRouterProvider.tsx"],"sourcesContent":["import { Text, useFocus, useInput } from \"ink\";\nimport { memo } from \"react\";\n\nimport { EMPTY_OPTIONS, EMPTY_PARAMS } from \"../constants\";\nimport { shallowEqual } from \"../dom-utils\";\nimport { useIsActiveRoute } from \"../hooks/useIsActiveRoute\";\nimport { useRouter } from \"../hooks/useRouter\";\n\nimport type { InkLinkProps } from \"../ink-types\";\nimport type { FC } from \"react\";\n\n/**\n * Pick the most specific value across focus / active / base priority.\n * Focus wins over active; active wins over base. Each layer falls through\n * to the next when its value is undefined, matching the original explicit\n * if/else cascade for both `color` and `inverse`.\n */\nfunction pickPriority<T>(\n  isFocused: boolean,\n  isRouteActive: boolean,\n  focusValue: T | undefined,\n  activeValue: T | undefined,\n  baseValue: T | undefined,\n): T | undefined {\n  if (isFocused) {\n    return focusValue ?? activeValue ?? baseValue;\n  }\n\n  if (isRouteActive) {\n    return activeValue ?? baseValue;\n  }\n\n  return baseValue;\n}\n\nfunction areInkLinkPropsEqual(\n  prev: Readonly<InkLinkProps>,\n  next: Readonly<InkLinkProps>,\n): boolean {\n  return (\n    prev.routeName === next.routeName &&\n    prev.activeStrict === next.activeStrict &&\n    prev.ignoreQueryParams === next.ignoreQueryParams &&\n    prev.color === next.color &&\n    prev.activeColor === next.activeColor &&\n    prev.focusColor === next.focusColor &&\n    prev.inverse === next.inverse &&\n    prev.activeInverse === next.activeInverse &&\n    prev.focusInverse === next.focusInverse &&\n    prev.id === next.id &&\n    prev.autoFocus === next.autoFocus &&\n    prev.onSelect === next.onSelect &&\n    prev.children === next.children &&\n    shallowEqual(prev.routeParams, next.routeParams) &&\n    shallowEqual(prev.routeOptions, next.routeOptions)\n  );\n}\n\nconst InkLinkImpl: FC<InkLinkProps> = ({\n  routeName,\n  routeParams = EMPTY_PARAMS,\n  routeOptions = EMPTY_OPTIONS,\n  activeStrict = false,\n  ignoreQueryParams = true,\n  color,\n  activeColor,\n  focusColor,\n  inverse,\n  activeInverse,\n  focusInverse,\n  id,\n  autoFocus,\n  onSelect,\n  children,\n}) => {\n  const router = useRouter();\n  const { isFocused } = useFocus({\n    ...(id !== undefined && { id }),\n    ...(autoFocus !== undefined && { autoFocus }),\n  });\n  const isRouteActive = useIsActiveRoute(\n    routeName,\n    routeParams,\n    activeStrict,\n    ignoreQueryParams,\n  );\n\n  // No useCallback: `useInput` consumes the handler via its own internal\n  // ref; a stable identity provides no cache-bail-out benefit here. Same\n  // reasoning as Link's handleClick.\n  useInput(\n    (_input, key) => {\n      if (key.return) {\n        onSelect?.();\n        router.navigate(routeName, routeParams, routeOptions).catch(() => {});\n      }\n    },\n    { isActive: isFocused },\n  );\n\n  const finalColor = pickPriority(\n    isFocused,\n    isRouteActive,\n    focusColor,\n    activeColor,\n    color,\n  );\n  const finalInverse = pickPriority(\n    isFocused,\n    isRouteActive,\n    focusInverse,\n    activeInverse,\n    inverse,\n  );\n\n  const textProps: { color?: string; inverse?: boolean } = {};\n\n  if (finalColor !== undefined) {\n    textProps.color = finalColor;\n  }\n\n  if (finalInverse !== undefined) {\n    textProps.inverse = finalInverse;\n  }\n\n  return <Text {...textProps}>{children}</Text>;\n};\n\nexport const InkLink: FC<InkLinkProps> = memo(\n  InkLinkImpl,\n  areInkLinkPropsEqual,\n);\n\nInkLink.displayName = \"InkLink\";\n","import { RouterProvider } from \"../RouterProvider\";\n\nimport type { InkRouterProviderProps } from \"../ink-types\";\nimport type { FC } from \"react\";\n\nexport const InkRouterProvider: FC<InkRouterProviderProps> = ({\n  router,\n  children,\n}) => <RouterProvider router={router}>{children}</RouterProvider>;\n"],"mappings":"8NAiBA,SAAS,EACP,EACA,EACA,EACA,EACA,EACe,CASf,OARI,EACK,GAAc,GAAe,EAGlC,EACK,GAAe,EAGjB,CACT,CAEA,SAAS,EACP,EACA,EACS,CACT,OACE,EAAK,YAAc,EAAK,WACxB,EAAK,eAAiB,EAAK,cAC3B,EAAK,oBAAsB,EAAK,mBAChC,EAAK,QAAU,EAAK,OACpB,EAAK,cAAgB,EAAK,aAC1B,EAAK,aAAe,EAAK,YACzB,EAAK,UAAY,EAAK,SACtB,EAAK,gBAAkB,EAAK,eAC5B,EAAK,eAAiB,EAAK,cAC3B,EAAK,KAAO,EAAK,IACjB,EAAK,YAAc,EAAK,WACxB,EAAK,WAAa,EAAK,UACvB,EAAK,WAAa,EAAK,UACvBA,EAAAA,EAAa,EAAK,YAAa,EAAK,WAAW,GAC/CA,EAAAA,EAAa,EAAK,aAAc,EAAK,YAAY,CAErD,CAwEA,MAAa,GAAA,EAAA,EAAA,OAtE0B,CACrC,YACA,cAAcC,EAAAA,EACd,eAAeC,EAAAA,EACf,eAAe,GACf,oBAAoB,GACpB,QACA,cACA,aACA,UACA,gBACA,eACA,KACA,YACA,WACA,cACI,CACJ,IAAM,EAASC,EAAAA,EAAU,EACnB,CAAE,cAAA,EAAA,EAAA,UAAuB,CAC7B,GAAI,IAAO,IAAA,IAAa,CAAE,IAAG,EAC7B,GAAI,IAAc,IAAA,IAAa,CAAE,WAAU,CAC7C,CAAC,EACK,EAAgBC,EAAAA,EACpB,EACA,EACA,EACA,CACF,GAKA,EAAA,EAAA,WACG,EAAQ,IAAQ,CACX,EAAI,SACN,IAAW,EACX,EAAO,SAAS,EAAW,EAAa,CAAY,EAAE,UAAY,CAAC,CAAC,EAExE,EACA,CAAE,SAAU,CAAU,CACxB,EAEA,IAAM,EAAa,EACjB,EACA,EACA,EACA,EACA,CACF,EACM,EAAe,EACnB,EACA,EACA,EACA,EACA,CACF,EAEM,EAAmD,CAAC,EAU1D,OARI,IAAe,IAAA,KACjB,EAAU,MAAQ,GAGhB,IAAiB,IAAA,KACnB,EAAU,QAAU,IAGf,EAAA,EAAA,KAACC,EAAAA,KAAD,CAAM,GAAI,EAAY,UAAe,CAAA,CAC9C,EAIE,CACF,EAEA,EAAQ,YAAc,UChItB,MAAa,GAAiD,CAC5D,SACA,eACI,EAAA,EAAA,KAACC,EAAAA,EAAD,CAAwB,SAAS,UAAyB,CAAA"}

package/dist/cjs/legacy.d.ts

@@ -1,5 +1,6 @@
-import { a as useNavigator, c as RouterErrorBoundaryProps, i as useRouteUtils, l as LinkProps, n as useRouteNode, o as useRouter, r as useRoute, s as RouterErrorBoundary, t as useRouterTransition } from "./useRouterTransition-BYit_9Mt.js";
-import { n as Link, t as RouterProvider } from "./RouterProvider-Bj1_NbpA.js";
+import { n as RouterErrorBoundaryProps, r as LinkProps, t as RouterErrorBoundary } from "./RouterErrorBoundary-BlJmaoyr.js";
+import { n as Link, t as RouterProvider } from "./RouterProvider-DvC9mViF.js";
+import { a as useNavigator, i as useRouteUtils, n as useRouteNode, o as useRouter, r as useRoute, t as useRouterTransition } from "./useRouterTransition-BfayPs0h.js";
 import { Navigator } from "@real-router/core";
 import { RouterTransitionSnapshot } from "@real-router/sources";
 export { Link, type LinkProps, type Navigator, RouterErrorBoundary, type RouterErrorBoundaryProps, RouterProvider, type RouterTransitionSnapshot, useNavigator, useRoute, useRouteNode, useRouteUtils, useRouter, useRouterTransition };

package/dist/cjs/legacy.js

@@ -1 +1 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require(`./RouterProvider-CfBNR-k7.js`),t=require(`./Link-DYvAnJlk.js`);exports.Link=t.t,exports.RouterErrorBoundary=e.o,exports.RouterProvider=e.t,exports.useNavigator=e.a,exports.useRoute=e.r,exports.useRouteNode=e.h,exports.useRouteUtils=e.i,exports.useRouter=e.g,exports.useRouterTransition=e.n;
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require(`./useRoute-Dudo2K_0.js`),t=require(`./RouterProvider-DGrUfyLj.js`),n=require(`./Link-tZAtICIG.js`);exports.Link=n.t,exports.RouterErrorBoundary=t.a,exports.RouterProvider=t.t,exports.useNavigator=t.i,exports.useRoute=e.t,exports.useRouteNode=t.f,exports.useRouteUtils=t.r,exports.useRouter=t.p,exports.useRouterTransition=t.n;

package/dist/cjs/legacy.ssr.d.ts

@@ -0,0 +1,3 @@
+import { a as HttpStatusCode, c as StreamedProps, d as ClientOnly, f as ClientOnlyProps, i as createHttpStatusSink, l as ServerOnly, n as HttpStatusProviderProps, o as HttpStatusCodeProps, r as HttpStatusSink, s as Streamed, t as HttpStatusProvider, u as ServerOnlyProps } from "./HttpStatusProvider-Dh6cMr95.js";
+import { t as useDeferred } from "./useDeferred-DE5YUsfa.js";
+export { ClientOnly, type ClientOnlyProps, HttpStatusCode, type HttpStatusCodeProps, HttpStatusProvider, type HttpStatusProviderProps, type HttpStatusSink, ServerOnly, type ServerOnlyProps, Streamed, type StreamedProps, createHttpStatusSink, useDeferred };

package/dist/cjs/legacy.ssr.js

@@ -0,0 +1 @@
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require(`./createHttpStatusSink-D_6IiR5E.js`);exports.ClientOnly=e.s,exports.HttpStatusCode=e.n,exports.HttpStatusProvider=e.r,exports.ServerOnly=e.o,exports.Streamed=e.i,exports.createHttpStatusSink=e.t,exports.useDeferred=e.a;

package/dist/cjs/ssr.d.ts

@@ -0,0 +1,4 @@
+import { a as HttpStatusCode, c as StreamedProps, d as ClientOnly, f as ClientOnlyProps, i as createHttpStatusSink, l as ServerOnly, n as HttpStatusProviderProps, o as HttpStatusCodeProps, r as HttpStatusSink, s as Streamed, t as HttpStatusProvider, u as ServerOnlyProps } from "./HttpStatusProvider-Dh6cMr95.js";
+import { t as useDeferred } from "./useDeferred-DE5YUsfa.js";
+import { n as AwaitProps, t as Await } from "./Await-whr-pcvo.js";
+export { Await, type AwaitProps, ClientOnly, type ClientOnlyProps, HttpStatusCode, type HttpStatusCodeProps, HttpStatusProvider, type HttpStatusProviderProps, type HttpStatusSink, ServerOnly, type ServerOnlyProps, Streamed, type StreamedProps, createHttpStatusSink, useDeferred };

package/dist/cjs/ssr.js

@@ -0,0 +1,2 @@
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require(`./createHttpStatusSink-D_6IiR5E.js`);let t=require(`react`);function n({name:n,children:r}){return r((0,t.use)(e.a(n)))}exports.Await=n,exports.ClientOnly=e.s,exports.HttpStatusCode=e.n,exports.HttpStatusProvider=e.r,exports.ServerOnly=e.o,exports.Streamed=e.i,exports.createHttpStatusSink=e.t,exports.useDeferred=e.a;
+//# sourceMappingURL=ssr.js.map

package/dist/cjs/ssr.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ssr.js","names":["useDeferred"],"sources":["../../src/components/Await.tsx"],"sourcesContent":["import { use } from \"react\";\n\nimport { useDeferred } from \"../hooks/useDeferred\";\n\nimport type { ReactNode } from \"react\";\n\nexport interface AwaitProps<T> {\n  /** Deferred key declared in the loader's `defer({ deferred: { <name>: ... } })`. */\n  readonly name: string;\n  /** Render the resolved value. Suspends while pending; throws inside the\n   * nearest Error Boundary on rejection. */\n  readonly children: (value: T) => ReactNode;\n}\n\n/**\n * Ergonomic wrapper around `useDeferred(name)` + React 19's `use(promise)`.\n *\n * ```tsx\n * <Suspense fallback={<Spinner />}>\n *   <Await<Review[]> name=\"reviews\">\n *     {(reviews) => <ReviewList items={reviews} />}\n *   </Await>\n * </Suspense>\n * ```\n *\n * Equivalent to:\n *\n * ```tsx\n * function Inner() {\n *   const reviews = use(useDeferred<Review[]>(\"reviews\"));\n *   return <ReviewList items={reviews} />;\n * }\n * ```\n *\n * Pick `<Await>` for cross-adapter consistency with the SvelteKit\n * `{#await}` / Solid `<Await/>` shape; pick the inline `use(useDeferred(...))`\n * form if you prefer one fewer abstraction.\n */\nexport function Await<T = unknown>({\n  name,\n  children,\n}: AwaitProps<T>): ReactNode {\n  const value = use(useDeferred<T>(name));\n\n  return children(value);\n}\n"],"mappings":"gJAsCA,SAAgB,EAAmB,CACjC,OACA,YAC2B,CAG3B,OAAO,GAAA,EAAA,EAAA,KAFWA,EAAAA,EAAe,CAAI,CAEjB,CAAC,CACvB"}

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

@@ -0,0 +1,3 @@
+import { c as StreamedProps, f as ClientOnlyProps, n as HttpStatusProviderProps, o as HttpStatusCodeProps, r as HttpStatusSink, u as ServerOnlyProps } from "./HttpStatusProvider-Dh6cMr95.js";
+import { n as AwaitProps } from "./Await-whr-pcvo.js";
+export type { AwaitProps, ClientOnlyProps, HttpStatusCodeProps, HttpStatusProviderProps, HttpStatusSink, ServerOnlyProps, StreamedProps };

package/dist/cjs/useDeferred-DE5YUsfa.d.ts

@@ -0,0 +1,24 @@
+//#region src/hooks/useDeferred.d.ts
+/**
+ * Read a deferred promise published by `defer({ deferred: { <key>: Promise } })`
+ * inside an SSR data loader.
+ *
+ * - **Server render**: returns the actual loader-returned promise. Combine
+ *   with `<Suspense>` + `use(promise)` for native streaming via React 19's
+ *   `renderToReadableStream`.
+ * - **Post-hydration**: returns a registry-backed promise; the inline
+ *   `<script>__rrDefer__("key", json)</script>` tags emitted by the server
+ *   stream resolve it. `use()` returns synchronously once the registry
+ *   settles.
+ * - **Unknown key**: returns a never-resolving promise — Suspense boundary
+ *   stays in fallback. This surfaces consumer/loader key drift as a visible
+ *   loading state instead of a silent runtime error.
+ *
+ * The hook subscribes to `RouteContext`, so it re-runs on every navigation.
+ * Promise reference identity is stable across renders within the same
+ * navigation — `use()` will not re-suspend on rerenders.
+ */
+declare function useDeferred<T = unknown>(key: string): Promise<T>;
+//#endregion
+export { useDeferred as t };
+//# sourceMappingURL=useDeferred-DE5YUsfa.d.ts.map

package/dist/cjs/useDeferred-DE5YUsfa.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDeferred-DE5YUsfa.d.ts","names":[],"sources":["../../src/hooks/useDeferred.tsx"],"mappings":";;AA0BA;;;;;;;;;AAAgE;;;;;;;;;iBAAhD,WAAA,aAAA,CAAyB,GAAA,WAAc,OAAO,CAAC,CAAA"}

package/dist/cjs/useRoute-Dudo2K_0.js

@@ -0,0 +1,2 @@
+let e=require(`react`);const t=(0,e.createContext)(null),n=(0,e.createContext)(null),r=(0,e.createContext)(null),i=Object.freeze({}),a=Object.freeze({}),o=new Promise(()=>{}),s=()=>{let n=(0,e.useContext)(t);if(!n)throw Error(`useRoute must be used within a RouterProvider`);if(!n.route)throw Error(`useRoute called with no active route. Did you forget to await router.start() before rendering, or is the router stopped/disposed?`);return n};Object.defineProperty(exports,`a`,{enumerable:!0,get:function(){return r}}),Object.defineProperty(exports,`i`,{enumerable:!0,get:function(){return o}}),Object.defineProperty(exports,`n`,{enumerable:!0,get:function(){return a}}),Object.defineProperty(exports,`o`,{enumerable:!0,get:function(){return t}}),Object.defineProperty(exports,`r`,{enumerable:!0,get:function(){return i}}),Object.defineProperty(exports,`s`,{enumerable:!0,get:function(){return n}}),Object.defineProperty(exports,`t`,{enumerable:!0,get:function(){return s}});
+//# sourceMappingURL=useRoute-Dudo2K_0.js.map

package/dist/cjs/useRoute-Dudo2K_0.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useRoute-Dudo2K_0.js","names":[],"sources":["../../src/context.ts","../../src/constants.ts","../../src/hooks/useRoute.tsx"],"sourcesContent":["import { createContext } from \"react\";\n\nimport type { RouteContext as RouteContextType } from \"./types\";\nimport type { Router, Navigator } from \"@real-router/core\";\n\n// All three contexts use the `<T | null>` shape with a `null` default. Hooks\n// (useRouter / useRoute / useNavigator) treat a `null` read as\n// \"RouterProvider missing\" and throw — this surfaces wiring mistakes loudly\n// instead of letting consumers chase an undefined router instance.\nexport const RouteContext = createContext<RouteContextType | null>(null);\n\nexport const RouterContext = createContext<Router | null>(null);\n\nexport const NavigatorContext = createContext<Navigator | null>(null);\n","export const EMPTY_PARAMS = Object.freeze({});\n\nexport const EMPTY_OPTIONS = Object.freeze({});\n\n// Singleton forever-pending promise — module-scope so `useDeferred(unknownKey)`\n// returns a stable reference across calls (Suspense boundary doesn't retry).\nexport const NEVER_PROMISE = new Promise<never>(() => {\n  // Intentionally never resolves — surfaces a forever-pending Suspense boundary\n  // when a key is requested that the loader never declared.\n});\n","import { useContext } from \"react\";\n\nimport { RouteContext } from \"../context\";\n\nimport type { RouteContext as RouteContextType } from \"../types\";\nimport type { Params, State } from \"@real-router/core\";\n\n/**\n * Return shape of `useRoute<P>()` — the context with `route` narrowed to\n * `State<P>` (non-nullable). Promoting the intersection to a named alias\n * keeps the function signature and the cast site in sync.\n */\ntype RouteHookResult<P extends Params = Params> = Omit<\n  RouteContextType<P>,\n  \"route\"\n> & { route: State<P> };\n\nexport const useRoute = <P extends Params = Params>(): RouteHookResult<P> => {\n  const routeContext = useContext(RouteContext);\n\n  if (!routeContext) {\n    throw new Error(\"useRoute must be used within a RouterProvider\");\n  }\n\n  if (!routeContext.route) {\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 RouteHookResult<P>;\n};\n"],"mappings":"uBASA,MAAa,GAAA,EAAA,EAAA,eAAsD,IAAI,EAE1D,GAAA,EAAA,EAAA,eAA6C,IAAI,EAEjD,GAAA,EAAA,EAAA,eAAmD,IAAI,ECbvD,EAAe,OAAO,OAAO,CAAC,CAAC,EAE/B,EAAgB,OAAO,OAAO,CAAC,CAAC,EAIhC,EAAgB,IAAI,YAAqB,CAGtD,CAAC,ECQY,MAAgE,CAC3E,IAAM,GAAA,EAAA,EAAA,YAA0B,CAAY,EAE5C,GAAI,CAAC,EACH,MAAU,MAAM,+CAA+C,EAGjE,GAAI,CAAC,EAAa,MAChB,MAAU,MACR,mIACF,EAGF,OAAO,CACT"}

package/dist/cjs/useRouteEnter-gfy65W0D.d.ts

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

package/dist/cjs/useRouteEnter-gfy65W0D.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useRouteEnter-gfy65W0D.d.ts","names":[],"sources":["../../src/components/modern/RouteView/types.ts","../../src/components/modern/RouteView/components.tsx","../../src/components/modern/RouteView/RouteView.tsx","../../src/hooks/useRouteExit.tsx","../../src/hooks/useRouteEnter.tsx"],"mappings":";;;;UAEiB,cAAA;;WAEN,QAAA;EAFM;EAAA,SAIN,QAAA,EAAU,SAAS;AAAA;AAAA,UAGb,UAAA;EALN;EAAA,SAOA,OAAA;EALU;EAAA,SAOV,KAAA;EAPmB;EAAA,SASnB,SAAA;EANgB;EAAA,SAQhB,QAAA,GAAW,SAAA;EAEQ;EAAA,SAAnB,QAAA,EAAU,SAAS;AAAA;AAAA,UAGb,SAAA;EALN;;;;;AAEmB;EAFnB,SAYA,QAAA,GAAW,SAAA;EAPI;EAAA,SASf,QAAA,EAAU,SAAS;AAAA;AAAA,UAGb,aAAA;EALK;EAAA,SAOX,QAAA,EAAU,SAAS;AAAA;;;iBClCd,KAAA,CAAM,MAAkB,EAAV,UAAU;AAAA,kBAAxB,KAAA;EAAA,IAAK,WAAA;AAAA;AAAA,iBAML,IAAA,CAAK,MAAiB,EAAT,SAAS;AAAA,kBAAtB,IAAA;EAAA,IAAI,WAAA;AAAA;AAAA,iBAMJ,QAAA,CAAS,MAAqB,EAAb,aAAa;AAAA,kBAA9B,QAAA;EAAA,IAAQ,WAAA;AAAA;;;iBCLf,aAAA,CAAA;EACP,QAAA;EACA;AAAA,GACC,QAAA,CAAS,cAAA,IAAkB,YAAA;AAAA,kBAHrB,aAAA;EAAA,IAAa,WAAA;AAAA;AAAA,cAgDT,SAAA,SAAS,aAAA;;;;;;;UCnDL,gBAAA;;EAEf,KAAA,EAAO,KAAA;EHNQ;EGQf,SAAA,EAAW,KAAA;;;;;;;AHJiB;EGY5B,MAAA,EAAQ,WAAA;AAAA;AAAA,UAGO,mBAAA;EHFa;;;;;EGQ5B,aAAa;AAAA;AAAA,KAGH,gBAAA,IACV,OAAA,EAAS,gBAAA,YACC,OAAO;;AHbW;AAG9B;;;;;;;;;AAS8B;AAG9B;;;;AAE8B;;;;AClC9B;;;;AAAwC;;;;;;AAMxC;;;;AAAsC;;;;;;AAMtC;;;;AAA8C;;;;;;;;;ACPJ;;;;;;;;;;;;;;;;;;AAKA;AAAA;;;;;AA6C1C;;;;;;;;;;iBCgEgB,YAAA,CACd,OAAA,EAAS,gBAAA,EACT,OAAA,GAAU,mBAAmB;;;UCrHd,iBAAA;;EAEf,KAAA,EAAO,KAAA;EJNQ;EIQf,aAAA,EAAe,KAAK;AAAA;AAAA,KAGV,iBAAA,IAAqB,OAA0B,EAAjB,iBAAiB;AAAA,UAE1C,oBAAA;EJTN;;;AAAmB;AAG9B;EIYE,aAAa;AAAA;;;;;;;;;;AJFe;AAG9B;;;;;;;;;AAS8B;AAG9B;;;;AAE8B;;;;AClC9B;;;;AAAwC;;;;;;AAMxC;;;;AAAsC;;;;;;AAMtC;;;;AAA8C;;;;;;;;;ACPJ;;;;;;;;;;;;;;;;;;AAKA;iBE4F1B,aAAA,CACd,OAAA,EAAS,iBAAA,EACT,OAAA,GAAU,oBAAoB"}

package/dist/cjs/useRouterTransition-BfayPs0h.d.ts

@@ -0,0 +1,56 @@
+import { i as RouteContext } from "./RouterErrorBoundary-BlJmaoyr.js";
+import { Navigator, Params, Router, State } from "@real-router/core";
+import { RouteUtils } from "@real-router/route-utils";
+import { RouterTransitionSnapshot } from "@real-router/sources";
+
+//#region src/hooks/useRouter.d.ts
+declare const useRouter: () => Router;
+//#endregion
+//#region src/hooks/useNavigator.d.ts
+declare const useNavigator: () => Navigator;
+//#endregion
+//#region src/hooks/useRouteUtils.d.ts
+/**
+ * Returns a pre-computed {@link RouteUtils} instance for the current router.
+ *
+ * `getRouteUtils` is WeakMap-cached per `RouteTreeNode` inside
+ * `@real-router/route-utils`, so the same router always returns the same
+ * `RouteUtils` instance across renders — no local cache needed in the adapter.
+ *
+ * @returns RouteUtils instance with pre-computed chains and siblings
+ *
+ * @example
+ * ```tsx
+ * const utils = useRouteUtils();
+ *
+ * utils.getChain("users.profile");
+ * // → ["users", "users.profile"]
+ *
+ * utils.getSiblings("users");
+ * // → ["admin"]
+ *
+ * utils.isDescendantOf("users.profile", "users");
+ * // → true
+ * ```
+ */
+declare const useRouteUtils: () => RouteUtils;
+//#endregion
+//#region src/hooks/useRoute.d.ts
+/**
+ * Return shape of `useRoute<P>()` — the context with `route` narrowed to
+ * `State<P>` (non-nullable). Promoting the intersection to a named alias
+ * keeps the function signature and the cast site in sync.
+ */
+type RouteHookResult<P extends Params = Params> = Omit<RouteContext<P>, "route"> & {
+  route: State<P>;
+};
+declare const useRoute: <P extends Params = Params>() => RouteHookResult<P>;
+//#endregion
+//#region src/hooks/useRouteNode.d.ts
+declare function useRouteNode(nodeName: string): RouteContext;
+//#endregion
+//#region src/hooks/useRouterTransition.d.ts
+declare function useRouterTransition(): RouterTransitionSnapshot;
+//#endregion
+export { useNavigator as a, useRouteUtils as i, useRouteNode as n, useRouter as o, useRoute as r, useRouterTransition as t };
+//# sourceMappingURL=useRouterTransition-BfayPs0h.d.ts.map