@real-router/react 0.24.0 → 0.25.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (123) hide show
  1. package/README.md +127 -7
  2. package/dist/cjs/Await-whr-pcvo.d.ts +41 -0
  3. package/dist/cjs/Await-whr-pcvo.d.ts.map +1 -0
  4. package/dist/cjs/HttpStatusProvider-Dh6cMr95.d.ts +143 -0
  5. package/dist/cjs/HttpStatusProvider-Dh6cMr95.d.ts.map +1 -0
  6. package/dist/cjs/Link-BspioC76.js +2 -0
  7. package/dist/cjs/Link-BspioC76.js.map +1 -0
  8. package/dist/cjs/RouterErrorBoundary-BlJmaoyr.d.ts +47 -0
  9. package/dist/cjs/RouterErrorBoundary-BlJmaoyr.d.ts.map +1 -0
  10. package/dist/cjs/{RouterProvider-Bj1_NbpA.d.ts → RouterProvider-DvC9mViF.d.ts} +2 -2
  11. package/dist/cjs/RouterProvider-DvC9mViF.d.ts.map +1 -0
  12. package/dist/cjs/RouterProvider-fJvMO5Tc.js +2 -0
  13. package/dist/cjs/RouterProvider-fJvMO5Tc.js.map +1 -0
  14. package/dist/cjs/createHttpStatusSink-D_6IiR5E.js +2 -0
  15. package/dist/cjs/createHttpStatusSink-D_6IiR5E.js.map +1 -0
  16. package/dist/cjs/index.d.ts +6 -281
  17. package/dist/cjs/index.js +1 -1
  18. package/dist/cjs/index.js.map +1 -1
  19. package/dist/cjs/index.react-server.d.ts +5 -0
  20. package/dist/cjs/index.react-server.js +0 -0
  21. package/dist/cjs/ink.d.ts +2 -1
  22. package/dist/cjs/ink.d.ts.map +1 -1
  23. package/dist/cjs/ink.js +1 -1
  24. package/dist/cjs/ink.js.map +1 -1
  25. package/dist/cjs/legacy.d.ts +3 -2
  26. package/dist/cjs/legacy.js +1 -1
  27. package/dist/cjs/legacy.ssr.d.ts +3 -0
  28. package/dist/cjs/legacy.ssr.js +1 -0
  29. package/dist/cjs/ssr.d.ts +4 -0
  30. package/dist/cjs/ssr.js +2 -0
  31. package/dist/cjs/ssr.js.map +1 -0
  32. package/dist/cjs/ssr.react-server.d.ts +3 -0
  33. package/dist/cjs/ssr.react-server.js +0 -0
  34. package/dist/cjs/useDeferred-DE5YUsfa.d.ts +24 -0
  35. package/dist/cjs/useDeferred-DE5YUsfa.d.ts.map +1 -0
  36. package/dist/cjs/useRoute-Dudo2K_0.js +2 -0
  37. package/dist/cjs/useRoute-Dudo2K_0.js.map +1 -0
  38. package/dist/cjs/useRouteEnter-gfy65W0D.d.ts +279 -0
  39. package/dist/cjs/useRouteEnter-gfy65W0D.d.ts.map +1 -0
  40. package/dist/cjs/useRouterTransition-BfayPs0h.d.ts +56 -0
  41. package/dist/cjs/useRouterTransition-BfayPs0h.d.ts.map +1 -0
  42. package/dist/esm/Await-qSmJ-ZuN.d.mts +41 -0
  43. package/dist/esm/Await-qSmJ-ZuN.d.mts.map +1 -0
  44. package/dist/esm/HttpStatusProvider-Cy9GSANm.d.mts +143 -0
  45. package/dist/esm/HttpStatusProvider-Cy9GSANm.d.mts.map +1 -0
  46. package/dist/esm/Link-BQol2GYb.mjs +2 -0
  47. package/dist/esm/Link-BQol2GYb.mjs.map +1 -0
  48. package/dist/esm/RouterErrorBoundary-C-MH_yrP.d.mts +47 -0
  49. package/dist/esm/RouterErrorBoundary-C-MH_yrP.d.mts.map +1 -0
  50. package/dist/esm/{RouterProvider-Dr3X_vbc.d.mts → RouterProvider-D_ZlPVAC.d.mts} +2 -2
  51. package/dist/esm/RouterProvider-D_ZlPVAC.d.mts.map +1 -0
  52. package/dist/esm/RouterProvider-a9y9bqji.mjs +2 -0
  53. package/dist/esm/RouterProvider-a9y9bqji.mjs.map +1 -0
  54. package/dist/esm/createHttpStatusSink-BXWVamHE.mjs +2 -0
  55. package/dist/esm/createHttpStatusSink-BXWVamHE.mjs.map +1 -0
  56. package/dist/esm/index.d.mts +6 -281
  57. package/dist/esm/index.mjs +1 -1
  58. package/dist/esm/index.mjs.map +1 -1
  59. package/dist/esm/index.react-server.d.mts +5 -0
  60. package/dist/esm/index.react-server.mjs +0 -0
  61. package/dist/esm/ink.d.mts +2 -1
  62. package/dist/esm/ink.d.mts.map +1 -1
  63. package/dist/esm/ink.mjs +1 -1
  64. package/dist/esm/ink.mjs.map +1 -1
  65. package/dist/esm/legacy.d.mts +3 -2
  66. package/dist/esm/legacy.mjs +1 -1
  67. package/dist/esm/legacy.ssr.d.mts +3 -0
  68. package/dist/esm/legacy.ssr.mjs +1 -0
  69. package/dist/esm/ssr.d.mts +4 -0
  70. package/dist/esm/ssr.mjs +2 -0
  71. package/dist/esm/ssr.mjs.map +1 -0
  72. package/dist/esm/ssr.react-server.d.mts +3 -0
  73. package/dist/esm/ssr.react-server.mjs +0 -0
  74. package/dist/esm/useDeferred-B5Qy7ttQ.d.mts +24 -0
  75. package/dist/esm/useDeferred-B5Qy7ttQ.d.mts.map +1 -0
  76. package/dist/esm/useRoute-Bta1jyl2.mjs +2 -0
  77. package/dist/esm/useRoute-Bta1jyl2.mjs.map +1 -0
  78. package/dist/esm/useRouteEnter-CxjYofFa.d.mts +279 -0
  79. package/dist/esm/useRouteEnter-CxjYofFa.d.mts.map +1 -0
  80. package/dist/esm/useRouterTransition-CI1P95ZQ.d.mts +56 -0
  81. package/dist/esm/useRouterTransition-CI1P95ZQ.d.mts.map +1 -0
  82. package/package.json +46 -4
  83. package/src/components/Await.tsx +46 -0
  84. package/src/components/ClientOnly.tsx +25 -0
  85. package/src/components/HttpStatusCode.tsx +66 -0
  86. package/src/components/HttpStatusProvider.tsx +26 -0
  87. package/src/components/InkLink.tsx +44 -22
  88. package/src/components/Link.tsx +32 -36
  89. package/src/components/RouterErrorBoundary.tsx +21 -6
  90. package/src/components/ServerOnly.tsx +26 -0
  91. package/src/components/Streamed.tsx +30 -0
  92. package/src/components/modern/RouteView/RouteView.tsx +9 -3
  93. package/src/components/modern/RouteView/helpers.tsx +26 -16
  94. package/src/constants.ts +7 -8
  95. package/src/context.ts +4 -2
  96. package/src/hooks/useDeferred.tsx +34 -0
  97. package/src/hooks/useIsActiveRoute.tsx +17 -9
  98. package/src/hooks/useNavigator.tsx +0 -2
  99. package/src/hooks/useRoute.tsx +10 -7
  100. package/src/hooks/useRouter.tsx +0 -2
  101. package/src/index.react-server.ts +33 -0
  102. package/src/index.ts +5 -0
  103. package/src/legacy.ssr.ts +35 -0
  104. package/src/legacy.ts +4 -0
  105. package/src/ssr.react-server.ts +21 -0
  106. package/src/ssr.ts +43 -0
  107. package/src/utils/createHttpStatusSink.ts +27 -0
  108. package/dist/cjs/Link-DYvAnJlk.js +0 -2
  109. package/dist/cjs/Link-DYvAnJlk.js.map +0 -1
  110. package/dist/cjs/RouterProvider-Bj1_NbpA.d.ts.map +0 -1
  111. package/dist/cjs/RouterProvider-CfBNR-k7.js +0 -2
  112. package/dist/cjs/RouterProvider-CfBNR-k7.js.map +0 -1
  113. package/dist/cjs/index.d.ts.map +0 -1
  114. package/dist/cjs/useRouterTransition-BYit_9Mt.d.ts +0 -92
  115. package/dist/cjs/useRouterTransition-BYit_9Mt.d.ts.map +0 -1
  116. package/dist/esm/Link-C7upxMc8.mjs +0 -2
  117. package/dist/esm/Link-C7upxMc8.mjs.map +0 -1
  118. package/dist/esm/RouterProvider-CS2ZoONm.mjs +0 -2
  119. package/dist/esm/RouterProvider-CS2ZoONm.mjs.map +0 -1
  120. package/dist/esm/RouterProvider-Dr3X_vbc.d.mts.map +0 -1
  121. package/dist/esm/index.d.mts.map +0 -1
  122. package/dist/esm/useRouterTransition-B65Wvngj.d.mts +0 -92
  123. package/dist/esm/useRouterTransition-B65Wvngj.d.mts.map +0 -1
@@ -1,92 +0,0 @@
1
- import { HTMLAttributes, JSX, MouseEventHandler, ReactNode } from "react";
2
- import { NavigationOptions, Navigator, Params, Router, RouterError, State } from "@real-router/core";
3
- import { RouteUtils } from "@real-router/route-utils";
4
- import { RouterTransitionSnapshot } from "@real-router/sources";
5
-
6
- //#region src/types.d.ts
7
- interface RouteState<P extends Params = Params> {
8
- route: State<P> | undefined;
9
- previousRoute?: State | undefined;
10
- }
11
- type RouteContext<P extends Params = Params> = {
12
- navigator: Navigator;
13
- } & RouteState<P>;
14
- interface LinkProps<P extends Params = Params> extends HTMLAttributes<HTMLAnchorElement> {
15
- routeName: string;
16
- routeParams?: P;
17
- routeOptions?: NavigationOptions;
18
- activeClassName?: string;
19
- activeStrict?: boolean;
20
- ignoreQueryParams?: boolean;
21
- /**
22
- * URL fragment (decoded form, no leading "#") (#532).
23
- * - omitted/`undefined` → preserve current fragment on same-route navigation
24
- * - `""` → clear fragment
25
- * - non-empty → set fragment
26
- *
27
- * Requires a URL plugin (browser-plugin or navigation-plugin) for full
28
- * round-trip; hash-plugin ignores the prop with a one-time dev warning.
29
- */
30
- hash?: string;
31
- target?: string;
32
- onClick?: MouseEventHandler<HTMLAnchorElement>;
33
- onMouseOver?: MouseEventHandler<HTMLAnchorElement>;
34
- }
35
- //#endregion
36
- //#region src/components/RouterErrorBoundary.d.ts
37
- interface RouterErrorBoundaryProps {
38
- readonly children: ReactNode;
39
- readonly fallback: (error: RouterError, resetError: () => void) => ReactNode;
40
- readonly onError?: (error: RouterError, toRoute: State | null, fromRoute: State | null) => void;
41
- }
42
- declare function RouterErrorBoundary({
43
- children,
44
- fallback,
45
- onError
46
- }: RouterErrorBoundaryProps): JSX.Element;
47
- //#endregion
48
- //#region src/hooks/useRouter.d.ts
49
- declare const useRouter: () => Router;
50
- //#endregion
51
- //#region src/hooks/useNavigator.d.ts
52
- declare const useNavigator: () => Navigator;
53
- //#endregion
54
- //#region src/hooks/useRouteUtils.d.ts
55
- /**
56
- * Returns a pre-computed {@link RouteUtils} instance for the current router.
57
- *
58
- * `getRouteUtils` is WeakMap-cached per `RouteTreeNode` inside
59
- * `@real-router/route-utils`, so the same router always returns the same
60
- * `RouteUtils` instance across renders — no local cache needed in the adapter.
61
- *
62
- * @returns RouteUtils instance with pre-computed chains and siblings
63
- *
64
- * @example
65
- * ```tsx
66
- * const utils = useRouteUtils();
67
- *
68
- * utils.getChain("users.profile");
69
- * // → ["users", "users.profile"]
70
- *
71
- * utils.getSiblings("users");
72
- * // → ["admin"]
73
- *
74
- * utils.isDescendantOf("users.profile", "users");
75
- * // → true
76
- * ```
77
- */
78
- declare const useRouteUtils: () => RouteUtils;
79
- //#endregion
80
- //#region src/hooks/useRoute.d.ts
81
- declare const useRoute: <P extends Params = Params>() => Omit<RouteContext<P>, "route"> & {
82
- route: State<P>;
83
- };
84
- //#endregion
85
- //#region src/hooks/useRouteNode.d.ts
86
- declare function useRouteNode(nodeName: string): RouteContext;
87
- //#endregion
88
- //#region src/hooks/useRouterTransition.d.ts
89
- declare function useRouterTransition(): RouterTransitionSnapshot;
90
- //#endregion
91
- export { useNavigator as a, RouterErrorBoundaryProps as c, useRouteUtils as i, LinkProps as l, useRouteNode as n, useRouter as o, useRoute as r, RouterErrorBoundary as s, useRouterTransition as t };
92
- //# sourceMappingURL=useRouterTransition-B65Wvngj.d.mts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"useRouterTransition-B65Wvngj.d.mts","names":[],"sources":["../../src/types.ts","../../src/components/RouterErrorBoundary.tsx","../../src/hooks/useRouter.tsx","../../src/hooks/useNavigator.tsx","../../src/hooks/useRouteUtils.tsx","../../src/hooks/useRoute.tsx","../../src/hooks/useRouteNode.tsx","../../src/hooks/useRouterTransition.tsx"],"mappings":";;;;;;UAQiB,UAAA,WAAqB,MAAA,GAAS,MAAA;EAC7C,KAAA,EAAO,KAAA,CAAM,CAAA;EACb,aAAA,GAAgB,KAAA;AAAA;AAAA,KAGN,YAAA,WAAuB,MAAA,GAAS,MAAA;EAC1C,SAAA,EAAW,SAAA;AAAA,IACT,UAAA,CAAW,CAAA;AAAA,UAEE,SAAA,WACL,MAAA,GAAS,MAAA,UACX,cAAA,CAAe,iBAAA;EACvB,SAAA;EACA,WAAA,GAAc,CAAA;EACd,YAAA,GAAe,iBAAA;EACf,eAAA;EACA,YAAA;EACA,iBAAA;EAjB0B;;;;;;;;;EA2B1B,IAAA;EACA,MAAA;EACA,OAAA,GAAU,iBAAA,CAAkB,iBAAA;EAC5B,WAAA,GAAc,iBAAA,CAAkB,iBAAA;AAAA;;;UC9BjB,wBAAA;EAAA,SACN,QAAA,EAAU,SAAA;EAAA,SACV,QAAA,GAAW,KAAA,EAAO,WAAA,EAAa,UAAA,iBAA2B,SAAA;EAAA,SAC1D,OAAA,IACP,KAAA,EAAO,WAAA,EACP,OAAA,EAAS,KAAA,SACT,SAAA,EAAW,KAAA;AAAA;AAAA,iBAIC,mBAAA,CAAA;EACd,QAAA;EACA,QAAA;EACA;AAAA,GACC,wBAAA,GAA2B,GAAA,CAAI,OAAA;;;cCdrB,SAAA,QAAgB,MAAA;;;cCAhB,YAAA,QAAmB,SAAA;;;;;;;;AHAhC;;;;;;;;;;;;;;;;;;cIsBa,aAAA,QAAoB,UAAA;;;cCrBpB,QAAA,aAAsB,MAAA,GAAS,MAAA,OAAW,IAAA,CACrD,YAAA,CAAiB,CAAA;EAEb,KAAA,EAAO,KAAA,CAAM,CAAA;AAAA;;;iBCJH,YAAA,CAAa,QAAA,WAAmB,YAAA;;;iBCDhC,mBAAA,CAAA,GAAuB,wBAAA"}