react-router-dom 6.26.2 → 7.4.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.
package/CHANGELOG.md DELETED
@@ -1,930 +0,0 @@
1
- # `react-router-dom`
2
-
3
- ## 6.26.2
4
-
5
- ### Patch Changes
6
-
7
- - Updated dependencies:
8
- - `@remix-run/router@1.19.2`
9
- - `react-router@6.26.2`
10
-
11
- ## 6.26.1
12
-
13
- ### Patch Changes
14
-
15
- - Rename `unstable_patchRoutesOnMiss` to `unstable_patchRoutesOnNavigation` to match new behavior ([#11888](https://github.com/remix-run/react-router/pull/11888))
16
- - Updated dependencies:
17
- - `@remix-run/router@1.19.1`
18
- - `react-router@6.26.1`
19
-
20
- ## 6.26.0
21
-
22
- ### Minor Changes
23
-
24
- - Add a new `replace(url, init?)` alternative to `redirect(url, init?)` that performs a `history.replaceState` instead of a `history.pushState` on client-side navigation redirects ([#11811](https://github.com/remix-run/react-router/pull/11811))
25
-
26
- ### Patch Changes
27
-
28
- - Fix initial hydration behavior when using `future.v7_partialHydration` along with `unstable_patchRoutesOnMiss` ([#11838](https://github.com/remix-run/react-router/pull/11838))
29
- - During initial hydration, `router.state.matches` will now include any partial matches so that we can render ancestor `HydrateFallback` components
30
- - Updated dependencies:
31
- - `@remix-run/router@1.19.0`
32
- - `react-router@6.26.0`
33
-
34
- ## 6.25.1
35
-
36
- ### Patch Changes
37
-
38
- - Memoize some `RouterProvider` internals to reduce unnecessary re-renders ([#11803](https://github.com/remix-run/react-router/pull/11803))
39
- - Updated dependencies:
40
- - `react-router@6.25.1`
41
-
42
- ## 6.25.0
43
-
44
- ### Minor Changes
45
-
46
- - Stabilize `future.unstable_skipActionErrorRevalidation` as `future.v7_skipActionErrorRevalidation` ([#11769](https://github.com/remix-run/react-router/pull/11769))
47
- - When this flag is enabled, actions will not automatically trigger a revalidation if they return/throw a `Response` with a `4xx`/`5xx` status code
48
- - You may still opt-into revalidation via `shouldRevalidate`
49
- - This also changes `shouldRevalidate`'s `unstable_actionStatus` parameter to `actionStatus`
50
-
51
- ### Patch Changes
52
-
53
- - Updated dependencies:
54
- - `react-router@6.25.0`
55
- - `@remix-run/router@1.18.0`
56
-
57
- ## 6.24.1
58
-
59
- ### Patch Changes
60
-
61
- - Remove `polyfill.io` reference from warning message because the domain was sold and has since been determined to serve malware ([#11741](https://github.com/remix-run/react-router/pull/11741))
62
- - See <https://sansec.io/research/polyfill-supply-chain-attack>
63
- - Export `NavLinkRenderProps` type for easier typing of custom `NavLink` callback ([#11553](https://github.com/remix-run/react-router/pull/11553))
64
- - Updated dependencies:
65
- - `@remix-run/router@1.17.1`
66
- - `react-router@6.24.1`
67
-
68
- ## 6.24.0
69
-
70
- ### Minor Changes
71
-
72
- - Add support for Lazy Route Discovery (a.k.a. Fog of War) ([#11626](https://github.com/remix-run/react-router/pull/11626))
73
- - RFC: <https://github.com/remix-run/react-router/discussions/11113>
74
- - `unstable_patchRoutesOnMiss` docs: <https://reactrouter.com/en/main/routers/create-browser-router>
75
-
76
- ### Patch Changes
77
-
78
- - Fix `fetcher.submit` types - remove incorrect `navigate`/`fetcherKey`/`unstable_viewTransition` options because they are only relevant for `useSubmit` ([#11631](https://github.com/remix-run/react-router/pull/11631))
79
- - Allow falsy `location.state` values passed to `<StaticRouter>` ([#11495](https://github.com/remix-run/react-router/pull/11495))
80
- - Updated dependencies:
81
- - `react-router@6.24.0`
82
- - `@remix-run/router@1.17.0`
83
-
84
- ## 6.23.1
85
-
86
- ### Patch Changes
87
-
88
- - Check for `document` existence when checking `startViewTransition` ([#11544](https://github.com/remix-run/react-router/pull/11544))
89
- - Change the `react-router-dom/server` import back to `react-router-dom` instead of `index.ts` ([#11514](https://github.com/remix-run/react-router/pull/11514))
90
- - Updated dependencies:
91
- - `@remix-run/router@1.16.1`
92
- - `react-router@6.23.1`
93
-
94
- ## 6.23.0
95
-
96
- ### Minor Changes
97
-
98
- - Add a new `unstable_dataStrategy` configuration option ([#11098](https://github.com/remix-run/react-router/pull/11098))
99
- - This option allows Data Router applications to take control over the approach for executing route loaders and actions
100
- - The default implementation is today's behavior, to fetch all loaders in parallel, but this option allows users to implement more advanced data flows including Remix single-fetch, middleware/context APIs, automatic loader caching, and more
101
-
102
- ### Patch Changes
103
-
104
- - Updated dependencies:
105
- - `@remix-run/router@1.16.0`
106
- - `react-router@6.23.0`
107
-
108
- ## 6.22.3
109
-
110
- ### Patch Changes
111
-
112
- - Updated dependencies:
113
- - `@remix-run/router@1.15.3`
114
- - `react-router@6.22.3`
115
-
116
- ## 6.22.2
117
-
118
- ### Patch Changes
119
-
120
- - Updated dependencies:
121
- - `@remix-run/router@1.15.2`
122
- - `react-router@6.22.2`
123
-
124
- ## 6.22.1
125
-
126
- ### Patch Changes
127
-
128
- - Updated dependencies:
129
- - `react-router@6.22.1`
130
- - `@remix-run/router@1.15.1`
131
-
132
- ## 6.22.0
133
-
134
- ### Minor Changes
135
-
136
- - Include a `window__reactRouterVersion` tag for CWV Report detection ([#11222](https://github.com/remix-run/react-router/pull/11222))
137
-
138
- ### Patch Changes
139
-
140
- - Updated dependencies:
141
- - `@remix-run/router@1.15.0`
142
- - `react-router@6.22.0`
143
-
144
- ## 6.21.3
145
-
146
- ### Patch Changes
147
-
148
- - Fix `NavLink` `isPending` when a `basename` is used ([#11195](https://github.com/remix-run/react-router/pull/11195))
149
- - Remove leftover `unstable_` prefix from `Blocker`/`BlockerFunction` types ([#11187](https://github.com/remix-run/react-router/pull/11187))
150
- - Updated dependencies:
151
- - `react-router@6.21.3`
152
-
153
- ## 6.21.2
154
-
155
- ### Patch Changes
156
-
157
- - Leverage `useId` for internal fetcher keys when available ([#11166](https://github.com/remix-run/react-router/pull/11166))
158
- - Updated dependencies:
159
- - `@remix-run/router@1.14.2`
160
- - `react-router@6.21.2`
161
-
162
- ## 6.21.1
163
-
164
- ### Patch Changes
165
-
166
- - Updated dependencies:
167
- - `react-router@6.21.1`
168
- - `@remix-run/router@1.14.1`
169
-
170
- ## 6.21.0
171
-
172
- ### Minor Changes
173
-
174
- - Add a new `future.v7_relativeSplatPath` flag to implement a breaking bug fix to relative routing when inside a splat route. ([#11087](https://github.com/remix-run/react-router/pull/11087))
175
-
176
- This fix was originally added in [#10983](https://github.com/remix-run/react-router/issues/10983) and was later reverted in [#11078](https://github.com/remix-run/react-router/pull/11078) because it was determined that a large number of existing applications were relying on the buggy behavior (see [#11052](https://github.com/remix-run/react-router/issues/11052))
177
-
178
- **The Bug**
179
- The buggy behavior is that without this flag, the default behavior when resolving relative paths is to _ignore_ any splat (`*`) portion of the current route path.
180
-
181
- **The Background**
182
- This decision was originally made thinking that it would make the concept of nested different sections of your apps in `<Routes>` easier if relative routing would _replace_ the current splat:
183
-
184
- ```jsx
185
- <BrowserRouter>
186
- <Routes>
187
- <Route path="/" element={<Home />} />
188
- <Route path="dashboard/*" element={<Dashboard />} />
189
- </Routes>
190
- </BrowserRouter>
191
- ```
192
-
193
- Any paths like `/dashboard`, `/dashboard/team`, `/dashboard/projects` will match the `Dashboard` route. The dashboard component itself can then render nested `<Routes>`:
194
-
195
- ```jsx
196
- function Dashboard() {
197
- return (
198
- <div>
199
- <h2>Dashboard</h2>
200
- <nav>
201
- <Link to="/">Dashboard Home</Link>
202
- <Link to="team">Team</Link>
203
- <Link to="projects">Projects</Link>
204
- </nav>
205
-
206
- <Routes>
207
- <Route path="/" element={<DashboardHome />} />
208
- <Route path="team" element={<DashboardTeam />} />
209
- <Route path="projects" element={<DashboardProjects />} />
210
- </Routes>
211
- </div>
212
- );
213
- }
214
- ```
215
-
216
- Now, all links and route paths are relative to the router above them. This makes code splitting and compartmentalizing your app really easy. You could render the `Dashboard` as its own independent app, or embed it into your large app without making any changes to it.
217
-
218
- **The Problem**
219
-
220
- The problem is that this concept of ignoring part of a path breaks a lot of other assumptions in React Router - namely that `"."` always means the current location pathname for that route. When we ignore the splat portion, we start getting invalid paths when using `"."`:
221
-
222
- ```jsx
223
- // If we are on URL /dashboard/team, and we want to link to /dashboard/team:
224
- function DashboardTeam() {
225
- // ❌ This is broken and results in <a href="/dashboard">
226
- return <Link to=".">A broken link to the Current URL</Link>;
227
-
228
- // ✅ This is fixed but super unintuitive since we're already at /dashboard/team!
229
- return <Link to="./team">A broken link to the Current URL</Link>;
230
- }
231
- ```
232
-
233
- We've also introduced an issue that we can no longer move our `DashboardTeam` component around our route hierarchy easily - since it behaves differently if we're underneath a non-splat route, such as `/dashboard/:widget`. Now, our `"."` links will, properly point to ourself _inclusive of the dynamic param value_ so behavior will break from it's corresponding usage in a `/dashboard/*` route.
234
-
235
- Even worse, consider a nested splat route configuration:
236
-
237
- ```jsx
238
- <BrowserRouter>
239
- <Routes>
240
- <Route path="dashboard">
241
- <Route path="*" element={<Dashboard />} />
242
- </Route>
243
- </Routes>
244
- </BrowserRouter>
245
- ```
246
-
247
- Now, a `<Link to=".">` and a `<Link to="..">` inside the `Dashboard` component go to the same place! That is definitely not correct!
248
-
249
- Another common issue arose in Data Routers (and Remix) where any `<Form>` should post to it's own route `action` if you the user doesn't specify a form action:
250
-
251
- ```jsx
252
- let router = createBrowserRouter({
253
- path: "/dashboard",
254
- children: [
255
- {
256
- path: "*",
257
- action: dashboardAction,
258
- Component() {
259
- // ❌ This form is broken! It throws a 405 error when it submits because
260
- // it tries to submit to /dashboard (without the splat value) and the parent
261
- // `/dashboard` route doesn't have an action
262
- return <Form method="post">...</Form>;
263
- },
264
- },
265
- ],
266
- });
267
- ```
268
-
269
- This is just a compounded issue from the above because the default location for a `Form` to submit to is itself (`"."`) - and if we ignore the splat portion, that now resolves to the parent route.
270
-
271
- **The Solution**
272
- If you are leveraging this behavior, it's recommended to enable the future flag, move your splat to it's own route, and leverage `../` for any links to "sibling" pages:
273
-
274
- ```jsx
275
- <BrowserRouter>
276
- <Routes>
277
- <Route path="dashboard">
278
- <Route index path="*" element={<Dashboard />} />
279
- </Route>
280
- </Routes>
281
- </BrowserRouter>
282
-
283
- function Dashboard() {
284
- return (
285
- <div>
286
- <h2>Dashboard</h2>
287
- <nav>
288
- <Link to="..">Dashboard Home</Link>
289
- <Link to="../team">Team</Link>
290
- <Link to="../projects">Projects</Link>
291
- </nav>
292
-
293
- <Routes>
294
- <Route path="/" element={<DashboardHome />} />
295
- <Route path="team" element={<DashboardTeam />} />
296
- <Route path="projects" element={<DashboardProjects />} />
297
- </Router>
298
- </div>
299
- );
300
- }
301
- ```
302
-
303
- This way, `.` means "the full current pathname for my route" in all cases (including static, dynamic, and splat routes) and `..` always means "my parents pathname".
304
-
305
- ### Patch Changes
306
-
307
- - Updated dependencies:
308
- - `@remix-run/router@1.14.0`
309
- - `react-router@6.21.0`
310
-
311
- ## 6.20.1
312
-
313
- ### Patch Changes
314
-
315
- - Revert the `useResolvedPath` fix for splat routes due to a large number of applications that were relying on the buggy behavior (see <https://github.com/remix-run/react-router/issues/11052#issuecomment-1836589329>). We plan to re-introduce this fix behind a future flag in the next minor version. ([#11078](https://github.com/remix-run/react-router/pull/11078))
316
- - Updated dependencies:
317
- - `react-router@6.20.1`
318
- - `@remix-run/router@1.13.1`
319
-
320
- ## 6.20.0
321
-
322
- ### Minor Changes
323
-
324
- - Export the `PathParam` type from the public API ([#10719](https://github.com/remix-run/react-router/pull/10719))
325
-
326
- ### Patch Changes
327
-
328
- - Updated dependencies:
329
- - `react-router@6.20.0`
330
- - `@remix-run/router@1.13.0`
331
-
332
- ## 6.19.0
333
-
334
- ### Minor Changes
335
-
336
- - Add `unstable_flushSync` option to `useNavigate`/`useSumbit`/`fetcher.load`/`fetcher.submit` to opt-out of `React.startTransition` and into `ReactDOM.flushSync` for state updates ([#11005](https://github.com/remix-run/react-router/pull/11005))
337
- - Allow `unstable_usePrompt` to accept a `BlockerFunction` in addition to a `boolean` ([#10991](https://github.com/remix-run/react-router/pull/10991))
338
-
339
- ### Patch Changes
340
-
341
- - Fix issue where a changing fetcher `key` in a `useFetcher` that remains mounted wasn't getting picked up ([#11009](https://github.com/remix-run/react-router/pull/11009))
342
- - Fix `useFormAction` which was incorrectly inheriting the `?index` query param from child route `action` submissions ([#11025](https://github.com/remix-run/react-router/pull/11025))
343
- - Fix `NavLink` `active` logic when `to` location has a trailing slash ([#10734](https://github.com/remix-run/react-router/pull/10734))
344
- - Updated dependencies:
345
- - `react-router@6.19.0`
346
- - `@remix-run/router@1.12.0`
347
-
348
- ## 6.18.0
349
-
350
- ### Minor Changes
351
-
352
- - Add support for manual fetcher key specification via `useFetcher({ key: string })` so you can access the same fetcher instance from different components in your application without prop-drilling ([RFC](https://github.com/remix-run/remix/discussions/7698)) ([#10960](https://github.com/remix-run/react-router/pull/10960))
353
-
354
- - Fetcher keys are now also exposed on the fetchers returned from `useFetchers` so that they can be looked up by `key`
355
-
356
- - Add `navigate`/`fetcherKey` params/props to `useSumbit`/`Form` to support kicking off a fetcher submission under the hood with an optionally user-specified `key` ([#10960](https://github.com/remix-run/react-router/pull/10960))
357
-
358
- - Invoking a fetcher in this way is ephemeral and stateless
359
- - If you need to access the state of one of these fetchers, you will need to leverage `useFetcher({ key })` to look it up elsewhere
360
-
361
- ### Patch Changes
362
-
363
- - Adds a fetcher context to `RouterProvider` that holds completed fetcher data, in preparation for the upcoming future flag that will change the fetcher persistence/cleanup behavior ([#10961](https://github.com/remix-run/react-router/pull/10961))
364
- - Fix the `future` prop on `BrowserRouter`, `HashRouter` and `MemoryRouter` so that it accepts a `Partial<FutureConfig>` instead of requiring all flags to be included. ([#10962](https://github.com/remix-run/react-router/pull/10962))
365
- - Updated dependencies:
366
- - `@remix-run/router@1.11.0`
367
- - `react-router@6.18.0`
368
-
369
- ## 6.17.0
370
-
371
- ### Minor Changes
372
-
373
- - Add experimental support for the [View Transitions API](https://developer.mozilla.org/en-US/docs/Web/API/ViewTransition) via `document.startViewTransition` to enable CSS animated transitions on SPA navigations in your application. ([#10916](https://github.com/remix-run/react-router/pull/10916))
374
-
375
- The simplest approach to enabling a View Transition in your React Router app is via the new `<Link unstable_viewTransition>` prop. This will cause the navigation DOM update to be wrapped in `document.startViewTransition` which will enable transitions for the DOM update. Without any additional CSS styles, you'll get a basic cross-fade animation for your page.
376
-
377
- If you need to apply more fine-grained styles for your animations, you can leverage the `unstable_useViewTransitionState` hook which will tell you when a transition is in progress and you can use that to apply classes or styles:
378
-
379
- ```jsx
380
- function ImageLink(to, src, alt) {
381
- let isTransitioning = unstable_useViewTransitionState(to);
382
- return (
383
- <Link to={to} unstable_viewTransition>
384
- <img
385
- src={src}
386
- alt={alt}
387
- style={{
388
- viewTransitionName: isTransitioning ? "image-expand" : "",
389
- }}
390
- />
391
- </Link>
392
- );
393
- }
394
- ```
395
-
396
- You can also use the `<NavLink unstable_viewTransition>` shorthand which will manage the hook usage for you and automatically add a `transitioning` class to the `<a>` during the transition:
397
-
398
- ```css
399
- a.transitioning img {
400
- view-transition-name: "image-expand";
401
- }
402
- ```
403
-
404
- ```jsx
405
- <NavLink to={to} unstable_viewTransition>
406
- <img src={src} alt={alt} />
407
- </NavLink>
408
- ```
409
-
410
- For an example usage of View Transitions with React Router, check out [our fork](https://github.com/brophdawg11/react-router-records) of the [Astro Records](https://github.com/Charca/astro-records) demo.
411
-
412
- For more information on using the View Transitions API, please refer to the [Smooth and simple transitions with the View Transitions API](https://developer.chrome.com/docs/web-platform/view-transitions/) guide from the Google Chrome team.
413
-
414
- Please note, that because the `ViewTransition` API is a DOM API, we now export a specific `RouterProvider` from `react-router-dom` with this functionality. If you are importing `RouterProvider` from `react-router`, then it will not support view transitions. ([#10928](https://github.com/remix-run/react-router/pull/10928)
415
-
416
- ### Patch Changes
417
-
418
- - Log a warning and fail gracefully in `ScrollRestoration` when `sessionStorage` is unavailable ([#10848](https://github.com/remix-run/react-router/pull/10848))
419
- - Updated dependencies:
420
- - `@remix-run/router@1.10.0`
421
- - `react-router@6.17.0`
422
-
423
- ## 6.16.0
424
-
425
- ### Minor Changes
426
-
427
- - Updated dependencies:
428
- - `@remix-run/router@1.9.0`
429
- - `react-router@6.16.0`
430
-
431
- ### Patch Changes
432
-
433
- - Properly encode rendered URIs in server rendering to avoid hydration errors ([#10769](https://github.com/remix-run/react-router/pull/10769))
434
-
435
- ## 6.15.0
436
-
437
- ### Minor Changes
438
-
439
- - Add's a new `redirectDocument()` function which allows users to specify that a redirect from a `loader`/`action` should trigger a document reload (via `window.location`) instead of attempting to navigate to the redirected location via React Router ([#10705](https://github.com/remix-run/react-router/pull/10705))
440
-
441
- ### Patch Changes
442
-
443
- - Fixes an edge-case affecting web extensions in Firefox that use `URLSearchParams` and the `useSearchParams` hook. ([#10620](https://github.com/remix-run/react-router/pull/10620))
444
- - Do not include hash in `useFormAction()` for unspecified actions since it cannot be determined on the server and causes hydration issues ([#10758](https://github.com/remix-run/react-router/pull/10758))
445
- - Reorder effects in `unstable_usePrompt` to avoid throwing an exception if the prompt is unblocked and a navigation is performed synchronously ([#10687](https://github.com/remix-run/react-router/pull/10687), [#10718](https://github.com/remix-run/react-router/pull/10718))
446
- - Updated dependencies:
447
- - `@remix-run/router@1.8.0`
448
- - `react-router@6.15.0`
449
-
450
- ## 6.14.2
451
-
452
- ### Patch Changes
453
-
454
- - Properly decode element id when emulating hash scrolling via `<ScrollRestoration>` ([#10682](https://github.com/remix-run/react-router/pull/10682))
455
- - Add missing `<Form state>` prop to populate `history.state` on submission navigations ([#10630](https://github.com/remix-run/react-router/pull/10630))
456
- - Support proper hydration of `Error` subclasses such as `ReferenceError`/`TypeError` ([#10633](https://github.com/remix-run/react-router/pull/10633))
457
- - Updated dependencies:
458
- - `@remix-run/router@1.7.2`
459
- - `react-router@6.14.2`
460
-
461
- ## 6.14.1
462
-
463
- ### Patch Changes
464
-
465
- - Updated dependencies:
466
- - `react-router@6.14.1`
467
- - `@remix-run/router@1.7.1`
468
-
469
- ## 6.14.0
470
-
471
- ### Minor Changes
472
-
473
- - Add support for `application/json` and `text/plain` encodings for `useSubmit`/`fetcher.submit`. To reflect these additional types, `useNavigation`/`useFetcher` now also contain `navigation.json`/`navigation.text` and `fetcher.json`/`fetcher.text` which include the json/text submission if applicable ([#10413](https://github.com/remix-run/react-router/pull/10413))
474
-
475
- ```jsx
476
- // The default behavior will still serialize as FormData
477
- function Component() {
478
- let navigation = useNavigation();
479
- let submit = useSubmit();
480
- submit({ key: "value" }, { method: "post" });
481
- // navigation.formEncType => "application/x-www-form-urlencoded"
482
- // navigation.formData => FormData instance
483
- }
484
-
485
- async function action({ request }) {
486
- // request.headers.get("Content-Type") => "application/x-www-form-urlencoded"
487
- // await request.formData() => FormData instance
488
- }
489
- ```
490
-
491
- ```js
492
- // Opt-into JSON encoding with `encType: "application/json"`
493
- function Component() {
494
- let navigation = useNavigation();
495
- let submit = useSubmit();
496
- submit({ key: "value" }, { method: "post", encType: "application/json" });
497
- // navigation.formEncType => "application/json"
498
- // navigation.json => { key: "value" }
499
- }
500
-
501
- async function action({ request }) {
502
- // request.headers.get("Content-Type") => "application/json"
503
- // await request.json() => { key: "value" }
504
- }
505
- ```
506
-
507
- ```js
508
- // Opt-into text encoding with `encType: "text/plain"`
509
- function Component() {
510
- let navigation = useNavigation();
511
- let submit = useSubmit();
512
- submit("Text submission", { method: "post", encType: "text/plain" });
513
- // navigation.formEncType => "text/plain"
514
- // navigation.text => "Text submission"
515
- }
516
-
517
- async function action({ request }) {
518
- // request.headers.get("Content-Type") => "text/plain"
519
- // await request.text() => "Text submission"
520
- }
521
- ```
522
-
523
- ### Patch Changes
524
-
525
- - When submitting a form from a `submitter` element, prefer the built-in `new FormData(form, submitter)` instead of the previous manual approach in modern browsers (those that support the new `submitter` parameter) ([#9865](https://github.com/remix-run/react-router/pull/9865), [#10627](https://github.com/remix-run/react-router/pull/10627))
526
- - For browsers that don't support it, we continue to just append the submit button's entry to the end, and we also add rudimentary support for `type="image"` buttons
527
- - If developers want full spec-compliant support for legacy browsers, they can use the `formdata-submitter-polyfill`
528
- - Call `window.history.pushState/replaceState` before updating React Router state (instead of after) so that `window.location` matches `useLocation` during synchronous React 17 rendering ([#10448](https://github.com/remix-run/react-router/pull/10448))
529
- - ⚠️ However, generally apps should not be relying on `window.location` and should always reference `useLocation` when possible, as `window.location` will not be in sync 100% of the time (due to `popstate` events, concurrent mode, etc.)
530
- - Fix `tsc --skipLibCheck:false` issues on React 17 ([#10622](https://github.com/remix-run/react-router/pull/10622))
531
- - Upgrade `typescript` to 5.1 ([#10581](https://github.com/remix-run/react-router/pull/10581))
532
- - Updated dependencies:
533
- - `react-router@6.14.0`
534
- - `@remix-run/router@1.7.0`
535
-
536
- ## 6.13.0
537
-
538
- ### Minor Changes
539
-
540
- - Move [`React.startTransition`](https://react.dev/reference/react/startTransition) usage behind a [future flag](https://reactrouter.com/en/main/guides/api-development-strategy) to avoid issues with existing incompatible `Suspense` usages. We recommend folks adopting this flag to be better compatible with React concurrent mode, but if you run into issues you can continue without the use of `startTransition` until v7. Issues usually boils down to creating net-new promises during the render cycle, so if you run into issues you should either lift your promise creation out of the render cycle or put it behind a `useMemo`. ([#10596](https://github.com/remix-run/react-router/pull/10596))
541
-
542
- Existing behavior will no longer include `React.startTransition`:
543
-
544
- ```jsx
545
- <BrowserRouter>
546
- <Routes>{/*...*/}</Routes>
547
- </BrowserRouter>
548
-
549
- <RouterProvider router={router} />
550
- ```
551
-
552
- If you wish to enable `React.startTransition`, pass the future flag to your component:
553
-
554
- ```jsx
555
- <BrowserRouter future={{ v7_startTransition: true }}>
556
- <Routes>{/*...*/}</Routes>
557
- </BrowserRouter>
558
-
559
- <RouterProvider router={router} future={{ v7_startTransition: true }}/>
560
- ```
561
-
562
- ### Patch Changes
563
-
564
- - Work around webpack/terser `React.startTransition` minification bug in production mode ([#10588](https://github.com/remix-run/react-router/pull/10588))
565
- - Updated dependencies:
566
- - `react-router@6.13.0`
567
-
568
- ## 6.12.1
569
-
570
- > \[!WARNING]
571
- > Please use version `6.13.0` or later instead of `6.12.1`. This version suffers from a `webpack`/`terser` minification issue resulting in invalid minified code in your resulting production bundles which can cause issues in your application. See [#10579](https://github.com/remix-run/react-router/issues/10579) for more details.
572
-
573
- ### Patch Changes
574
-
575
- - Adjust feature detection of `React.startTransition` to fix webpack + react 17 compilation error ([#10569](https://github.com/remix-run/react-router/pull/10569))
576
- - Updated dependencies:
577
- - `react-router@6.12.1`
578
-
579
- ## 6.12.0
580
-
581
- ### Minor Changes
582
-
583
- - Wrap internal router state updates with `React.startTransition` if it exists ([#10438](https://github.com/remix-run/react-router/pull/10438))
584
-
585
- ### Patch Changes
586
-
587
- - Re-throw `DOMException` (`DataCloneError`) when attempting to perform a `PUSH` navigation with non-serializable state. ([#10427](https://github.com/remix-run/react-router/pull/10427))
588
- - Updated dependencies:
589
- - `@remix-run/router@1.6.3`
590
- - `react-router@6.12.0`
591
-
592
- ## 6.11.2
593
-
594
- ### Patch Changes
595
-
596
- - Export `SetURLSearchParams` type ([#10444](https://github.com/remix-run/react-router/pull/10444))
597
- - Updated dependencies:
598
- - `react-router@6.11.2`
599
- - `@remix-run/router@1.6.2`
600
-
601
- ## 6.11.1
602
-
603
- ### Patch Changes
604
-
605
- - Updated dependencies:
606
- - `react-router@6.11.1`
607
- - `@remix-run/router@1.6.1`
608
-
609
- ## 6.11.0
610
-
611
- ### Minor Changes
612
-
613
- - Enable `basename` support in `useFetcher` ([#10336](https://github.com/remix-run/react-router/pull/10336))
614
- - If you were previously working around this issue by manually prepending the `basename` then you will need to remove the manually prepended `basename` from your `fetcher` calls (`fetcher.load('/basename/route') -> fetcher.load('/route')`)
615
-
616
- ### Patch Changes
617
-
618
- - Fix inadvertent re-renders when using `Component` instead of `element` on a route definition ([#10287](https://github.com/remix-run/react-router/pull/10287))
619
- - Fail gracefully on `<Link to="//">` and other invalid URL values ([#10367](https://github.com/remix-run/react-router/pull/10367))
620
- - Switched from `useSyncExternalStore` to `useState` for internal `@remix-run/router` router state syncing in `<RouterProvider>`. We found some [subtle bugs](https://codesandbox.io/s/use-sync-external-store-loop-9g7b81) where router state updates got propagated _before_ other normal `useState` updates, which could lead to footguns in `useEffect` calls. ([#10377](https://github.com/remix-run/react-router/pull/10377), [#10409](https://github.com/remix-run/react-router/pull/10409))
621
- - Add static prop to `StaticRouterProvider`'s internal `Router` component ([#10401](https://github.com/remix-run/react-router/pull/10401))
622
- - When using a `RouterProvider`, `useNavigate`/`useSubmit`/`fetcher.submit` are now stable across location changes, since we can handle relative routing via the `@remix-run/router` instance and get rid of our dependence on `useLocation()`. When using `BrowserRouter`, these hooks remain unstable across location changes because they still rely on `useLocation()`. ([#10336](https://github.com/remix-run/react-router/pull/10336))
623
- - Updated dependencies:
624
- - `react-router@6.11.0`
625
- - `@remix-run/router@1.6.0`
626
-
627
- ## 6.10.0
628
-
629
- ### Minor Changes
630
-
631
- - Added support for [**Future Flags**](https://reactrouter.com/en/main/guides/api-development-strategy) in React Router. The first flag being introduced is `future.v7_normalizeFormMethod` which will normalize the exposed `useNavigation()/useFetcher()` `formMethod` fields as uppercase HTTP methods to align with the `fetch()` behavior. ([#10207](https://github.com/remix-run/react-router/pull/10207))
632
-
633
- - When `future.v7_normalizeFormMethod === false` (default v6 behavior),
634
- - `useNavigation().formMethod` is lowercase
635
- - `useFetcher().formMethod` is lowercase
636
- - When `future.v7_normalizeFormMethod === true`:
637
- - `useNavigation().formMethod` is uppercase
638
- - `useFetcher().formMethod` is uppercase
639
-
640
- ### Patch Changes
641
-
642
- - Fix `createStaticHandler` to also check for `ErrorBoundary` on routes in addition to `errorElement` ([#10190](https://github.com/remix-run/react-router/pull/10190))
643
- - Updated dependencies:
644
- - `@remix-run/router@1.5.0`
645
- - `react-router@6.10.0`
646
-
647
- ## 6.9.0
648
-
649
- ### Minor Changes
650
-
651
- - React Router now supports an alternative way to define your route `element` and `errorElement` fields as React Components instead of React Elements. You can instead pass a React Component to the new `Component` and `ErrorBoundary` fields if you choose. There is no functional difference between the two, so use whichever approach you prefer 😀. You shouldn't be defining both, but if you do `Component`/`ErrorBoundary` will "win". ([#10045](https://github.com/remix-run/react-router/pull/10045))
652
-
653
- **Example JSON Syntax**
654
-
655
- ```jsx
656
- // Both of these work the same:
657
- const elementRoutes = [{
658
- path: '/',
659
- element: <Home />,
660
- errorElement: <HomeError />,
661
- }]
662
-
663
- const componentRoutes = [{
664
- path: '/',
665
- Component: Home,
666
- ErrorBoundary: HomeError,
667
- }]
668
-
669
- function Home() { ... }
670
- function HomeError() { ... }
671
- ```
672
-
673
- **Example JSX Syntax**
674
-
675
- ```jsx
676
- // Both of these work the same:
677
- const elementRoutes = createRoutesFromElements(
678
- <Route path='/' element={<Home />} errorElement={<HomeError /> } />
679
- );
680
-
681
- const componentRoutes = createRoutesFromElements(
682
- <Route path='/' Component={Home} ErrorBoundary={HomeError} />
683
- );
684
-
685
- function Home() { ... }
686
- function HomeError() { ... }
687
- ```
688
-
689
- - **Introducing Lazy Route Modules!** ([#10045](https://github.com/remix-run/react-router/pull/10045))
690
-
691
- In order to keep your application bundles small and support code-splitting of your routes, we've introduced a new `lazy()` route property. This is an async function that resolves the non-route-matching portions of your route definition (`loader`, `action`, `element`/`Component`, `errorElement`/`ErrorBoundary`, `shouldRevalidate`, `handle`).
692
-
693
- Lazy routes are resolved on initial load and during the `loading` or `submitting` phase of a navigation or fetcher call. You cannot lazily define route-matching properties (`path`, `index`, `children`) since we only execute your lazy route functions after we've matched known routes.
694
-
695
- Your `lazy` functions will typically return the result of a dynamic import.
696
-
697
- ```jsx
698
- // In this example, we assume most folks land on the homepage so we include that
699
- // in our critical-path bundle, but then we lazily load modules for /a and /b so
700
- // they don't load until the user navigates to those routes
701
- let routes = createRoutesFromElements(
702
- <Route path="/" element={<Layout />}>
703
- <Route index element={<Home />} />
704
- <Route path="a" lazy={() => import("./a")} />
705
- <Route path="b" lazy={() => import("./b")} />
706
- </Route>
707
- );
708
- ```
709
-
710
- Then in your lazy route modules, export the properties you want defined for the route:
711
-
712
- ```jsx
713
- export async function loader({ request }) {
714
- let data = await fetchData(request);
715
- return json(data);
716
- }
717
-
718
- // Export a `Component` directly instead of needing to create a React Element from it
719
- export function Component() {
720
- let data = useLoaderData();
721
-
722
- return (
723
- <>
724
- <h1>You made it!</h1>
725
- <p>{data}</p>
726
- </>
727
- );
728
- }
729
-
730
- // Export an `ErrorBoundary` directly instead of needing to create a React Element from it
731
- export function ErrorBoundary() {
732
- let error = useRouteError();
733
- return isRouteErrorResponse(error) ? (
734
- <h1>
735
- {error.status} {error.statusText}
736
- </h1>
737
- ) : (
738
- <h1>{error.message || error}</h1>
739
- );
740
- }
741
- ```
742
-
743
- An example of this in action can be found in the [`examples/lazy-loading-router-provider`](https://github.com/remix-run/react-router/tree/main/examples/lazy-loading-router-provider) directory of the repository.
744
-
745
- 🙌 Huge thanks to @rossipedia for the [Initial Proposal](https://github.com/remix-run/react-router/discussions/9826) and [POC Implementation](https://github.com/remix-run/react-router/pull/9830).
746
-
747
- - Updated dependencies:
748
- - `react-router@6.9.0`
749
- - `@remix-run/router@1.4.0`
750
-
751
- ## 6.8.2
752
-
753
- ### Patch Changes
754
-
755
- - Treat same-origin absolute URLs in `<Link to>` as external if they are outside of the router `basename` ([#10135](https://github.com/remix-run/react-router/pull/10135))
756
- - Fix `useBlocker` to return `IDLE_BLOCKER` during SSR ([#10046](https://github.com/remix-run/react-router/pull/10046))
757
- - Fix SSR of absolute `<Link to>` urls ([#10112](https://github.com/remix-run/react-router/pull/10112))
758
- - Properly escape HTML characters in `StaticRouterProvider` serialized hydration data ([#10068](https://github.com/remix-run/react-router/pull/10068))
759
- - Updated dependencies:
760
- - `@remix-run/router@1.3.3`
761
- - `react-router@6.8.2`
762
-
763
- ## 6.8.1
764
-
765
- ### Patch Changes
766
-
767
- - Improved absolute url detection in `Link` component (now also supports `mailto:` urls) ([#9994](https://github.com/remix-run/react-router/pull/9994))
768
- - Fix partial object (search or hash only) pathnames losing current path value ([#10029](https://github.com/remix-run/react-router/pull/10029))
769
- - Updated dependencies:
770
- - `react-router@6.8.1`
771
- - `@remix-run/router@1.3.2`
772
-
773
- ## 6.8.0
774
-
775
- ### Minor Changes
776
-
777
- - Support absolute URLs in `<Link to>`. If the URL is for the current origin, it will still do a client-side navigation. If the URL is for a different origin then it will do a fresh document request for the new origin. ([#9900](https://github.com/remix-run/react-router/pull/9900))
778
-
779
- ```tsx
780
- <Link to="https://neworigin.com/some/path"> {/* Document request */}
781
- <Link to="//neworigin.com/some/path"> {/* Document request */}
782
- <Link to="https://www.currentorigin.com/path"> {/* Client-side navigation */}
783
- ```
784
-
785
- ### Patch Changes
786
-
787
- - Fix bug with search params removal via `useSearchParams` ([#9969](https://github.com/remix-run/react-router/pull/9969))
788
- - Respect `preventScrollReset` on `<fetcher.Form>` ([#9963](https://github.com/remix-run/react-router/pull/9963))
789
- - Fix navigation for hash routers on manual URL changes ([#9980](https://github.com/remix-run/react-router/pull/9980))
790
- - Use `pagehide` instead of `beforeunload` for `<ScrollRestoration>`. This has better cross-browser support, specifically on Mobile Safari. ([#9945](https://github.com/remix-run/react-router/pull/9945))
791
- - Updated dependencies:
792
- - `@remix-run/router@1.3.1`
793
- - `react-router@6.8.0`
794
-
795
- ## 6.7.0
796
-
797
- ### Minor Changes
798
-
799
- - Add `unstable_useBlocker` hook for blocking navigations within the app's location origin ([#9709](https://github.com/remix-run/react-router/pull/9709))
800
- - Add `unstable_usePrompt` hook for blocking navigations within the app's location origin ([#9932](https://github.com/remix-run/react-router/pull/9932))
801
- - Add `preventScrollReset` prop to `<Form>` ([#9886](https://github.com/remix-run/react-router/pull/9886))
802
-
803
- ### Patch Changes
804
-
805
- - Added pass-through event listener options argument to `useBeforeUnload` ([#9709](https://github.com/remix-run/react-router/pull/9709))
806
- - Streamline jsdom bug workaround in tests ([#9824](https://github.com/remix-run/react-router/pull/9824))
807
- - Updated dependencies:
808
- - `@remix-run/router@1.3.0`
809
- - `react-router@6.7.0`
810
-
811
- ## 6.6.2
812
-
813
- ### Patch Changes
814
-
815
- - Ensure `useId` consistency during SSR ([#9805](https://github.com/remix-run/react-router/pull/9805))
816
- - Updated dependencies:
817
- - `react-router@6.6.2`
818
-
819
- ## 6.6.1
820
-
821
- ### Patch Changes
822
-
823
- - Updated dependencies:
824
- - `@remix-run/router@1.2.1`
825
- - `react-router@6.6.1`
826
-
827
- ## 6.6.0
828
-
829
- ### Minor Changes
830
-
831
- - Add `useBeforeUnload()` hook ([#9664](https://github.com/remix-run/react-router/pull/9664))
832
- - Remove `unstable_` prefix from `createStaticHandler`/`createStaticRouter`/`StaticRouterProvider` ([#9738](https://github.com/remix-run/react-router/pull/9738))
833
-
834
- ### Patch Changes
835
-
836
- - Proper hydration of `Error` objects from `StaticRouterProvider` ([#9664](https://github.com/remix-run/react-router/pull/9664))
837
- - Support uppercase `<Form method>` and `useSubmit` method values ([#9664](https://github.com/remix-run/react-router/pull/9664))
838
- - Skip initial scroll restoration for SSR apps with `hydrationData` ([#9664](https://github.com/remix-run/react-router/pull/9664))
839
- - Fix `<button formmethod>` form submission overriddes ([#9664](https://github.com/remix-run/react-router/pull/9664))
840
- - Updated dependencies:
841
- - `@remix-run/router@1.2.0`
842
- - `react-router@6.6.0`
843
-
844
- ## 6.5.0
845
-
846
- ### Patch Changes
847
-
848
- - Updated dependencies:
849
- - `react-router@6.5.0`
850
- - `@remix-run/router@1.1.0`
851
-
852
- ## 6.4.5
853
-
854
- ### Patch Changes
855
-
856
- - Updated dependencies:
857
- - `@remix-run/router@1.0.5`
858
- - `react-router@6.4.5`
859
-
860
- ## 6.4.4
861
-
862
- ### Patch Changes
863
-
864
- - Fix issues with encoded characters in `NavLink` and descendant `<Routes>` ([#9589](https://github.com/remix-run/react-router/pull/9589), [#9647](https://github.com/remix-run/react-router/pull/9647))
865
- - Properly serialize/deserialize `ErrorResponse` instances when using built-in hydration ([#9593](https://github.com/remix-run/react-router/pull/9593))
866
- - Support `basename` in static data routers ([#9591](https://github.com/remix-run/react-router/pull/9591))
867
- - Updated dependencies:
868
- - `@remix-run/router@1.0.4`
869
- - `react-router@6.4.4`
870
-
871
- ## 6.4.3
872
-
873
- ### Patch Changes
874
-
875
- - Fix hrefs generated for `createHashRouter` ([#9409](https://github.com/remix-run/react-router/pull/9409))
876
- - fix encoding/matching issues with special chars ([#9477](https://github.com/remix-run/react-router/pull/9477), [#9496](https://github.com/remix-run/react-router/pull/9496))
877
- - Properly support `index` routes with a `path` in `useResolvedPath` ([#9486](https://github.com/remix-run/react-router/pull/9486))
878
- - Respect `relative=path` prop on `NavLink` ([#9453](https://github.com/remix-run/react-router/pull/9453))
879
- - Fix `NavLink` behavior for root urls ([#9497](https://github.com/remix-run/react-router/pull/9497))
880
- - Updated dependencies:
881
- - `@remix-run/router@1.0.3`
882
- - `react-router@6.4.3`
883
-
884
- ## 6.4.2
885
-
886
- ### Patch Changes
887
-
888
- - Respect `basename` in `useFormAction` ([#9352](https://github.com/remix-run/react-router/pull/9352))
889
- - Enhance console error messages for invalid usage of data router hooks ([#9311](https://github.com/remix-run/react-router/pull/9311))
890
- - If an index route has children, it will result in a runtime error. We have strengthened our `RouteObject`/`RouteProps` types to surface the error in TypeScript. ([#9366](https://github.com/remix-run/react-router/pull/9366))
891
- - Updated dependencies:
892
- - `react-router@6.4.2`
893
- - `@remix-run/router@1.0.2`
894
-
895
- ## 6.4.1
896
-
897
- ### Patch Changes
898
-
899
- - Updated dependencies:
900
- - `react-router@6.4.1`
901
- - `@remix-run/router@1.0.1`
902
-
903
- ## 6.4.0
904
-
905
- Whoa this is a big one! `6.4.0` brings all the data loading and mutation APIs over from Remix. Here's a quick high level overview, but it's recommended you go check out the [docs](https://reactrouter.com), especially the [feature overview](https://reactrouter.com/start/overview) and the [tutorial](https://reactrouter.com/start/tutorial).
906
-
907
- **New APIs**
908
-
909
- - Create your router with `createMemoryRouter`/`createBrowserRouter`/`createHashRouter`
910
- - Render your router with `<RouterProvider>`
911
- - Load data with a Route `loader` and mutate with a Route `action`
912
- - Handle errors with Route `errorElement`
913
- - Submit data with the new `<Form>` component
914
- - Perform in-page data loads and mutations with `useFetcher()`
915
- - Defer non-critical data with `defer` and `Await`
916
- - Manage scroll position with `<ScrollRestoration>`
917
-
918
- **New Features**
919
-
920
- - Perform path-relative navigations with `<Link relative="path">` (#9160)
921
-
922
- **Bug Fixes**
923
-
924
- - Path resolution is now trailing slash agnostic (#8861)
925
- - `useLocation` returns the scoped location inside a `<Routes location>` component (#9094)
926
- - respect the `<Link replace>` prop if it is defined (#8779)
927
-
928
- **Updated Dependencies**
929
-
930
- - `react-router@6.4.0`