28 KiB
@refinedev/react-router-v6
4.6.0
Minor Changes
-
#6159
ad401d52957bf831e47707e86cb1e2f8b8c20f4bThanks @alicanerdurmaz! - feat:<DocumentTitleHandler/>should populatedresource.meta.labelfield if it's not provided on the Refine's resource definition. From now on, users be able to use theresource.meta.labelfield to customize document title more easily.import { BrowserRouter, DocumentTitleHandler, } from "@refinedev/react-router-v6"; import { Refine } from "@refinedev/core"; const App = () => { return ( <BrowserRouter> <Refine /* ... */ > {/* ... */} <DocumentTitleHandler handler={({ action, params, resource }) => { const id = params?.id ?? ""; const actionPrefixMatcher = { create: "Create new ", clone: `#${id} Clone ${resource?.meta?.label}`, edit: `#${id} Edit ${resource?.meta?.label}`, show: `#${id} Show ${resource?.meta?.label}`, list: `${resource?.meta?.label}`, }; const suffix = " | <Company Name>"; const title = actionPrefixMatcher[action || "list"] + suffix; return title; }} /> </Refine> </BrowserRouter> ); };
4.5.11
Patch Changes
-
6bd14228760d3e1e205ea9248e427f9afa2ec046Thanks @BatuhanW! - chore: addedtypequalifier to imports used as type only.- import { A } from "./example.ts"; + import type { A } from "./example.ts";
4.5.10
Patch Changes
-
#5945
90930b381d8d369c63bc59beedf69c391875166dThanks @aliemir! - chore: addedtypequalifier to imports used as type only.- import { A } from "./example.ts"; + import type { A } from "./example.ts";
4.5.9
Patch Changes
-
#5928
db9756e7908Thanks @aliemir! - fix: type errors on typescript <5Due to the changes in #5881, typescript users below version 5 are facing type errors. This PR fixes the type errors by updating the file extensions required by the
d.mtsdeclaration files to provide a compatible declarations for both typescript 4 and 5 users.
4.5.8
Patch Changes
-
#5850
c2ef59bf82fThanks @aliemir! - fix: replace imports ofqswith default importsUpdated
qsimports and usage to prevent issues with ESM builds and to ensure correctly importing the module. -
#5881
ba719f6ea26Thanks @aliemir! - fix: declaration files in node10, node16 and nodenext module resolutions
4.5.7
Patch Changes
-
#5765
0c197d82393Thanks @aliemir! - refactor: package bundles and package.json configuration for exportsPreviously, Refine packages had exported ESM and CJS bundles with same
.jsextension and same types for both with.d.tsextensions. This was causing issues with bundlers and compilers to pick up the wrong files for the wrong environment. Now we're outputting ESM bundles with.mjsextension and CJS bundles with.cjsextension. Also types are now exported with both.d.mtsand.d.ctsextensions.In older versions ESM and CJS outputs of some packages were using wrong imports/requires to dependencies causing errors in some environments. This will be fixed since now we're also enforcing the module type with extensions.
Above mentioned changes also supported with changes in
package.jsonfiles of the packages to support the new extensions and types. All Refine packages now includeexportsfields in their configuration to make sure the correct bundle is picked up by the bundlers and compilers. -
#5754
56ed144a0f5Thanks @alicanerdurmaz! - chore: TypeScript upgraded to v5.x.x. #5752
4.5.6
Patch Changes
- #5695
79865affa1cThanks @BatuhanW! - chore: apply biome format and fix lint errors.
4.5.5
Patch Changes
- #5425
190af9fce2Thanks @aliemir! - Updated@refinedev/corepeer dependencies to latest (^4.46.1)
4.5.4
Patch Changes
- #5000
847124858e0Thanks @dzcpy! - fix: addedtypespath to export inpackage.json
4.5.3
Patch Changes
- #5000
847124858e0Thanks @dzcpy! - fix: addedtypespath to export inpackage.json
4.5.2
Patch Changes
-
#5022
80513a4e42fThanks @BatuhanW! - chore: update README.md- fix grammar errors.
- make all README.md files consistent.
- add code example code snippets.
4.5.1
Patch Changes
-
#5022
80513a4e42fThanks @BatuhanW! - chore: update README.md- fix grammar errors.
- make all README.md files consistent.
- add code example code snippets.
4.5.0
Minor Changes
- #4741
026ccf34356Thanks @aliemir! - AddedsideEffects: falsetopackage.jsonto help bundlers tree-shake unused code.
4.4.0
Minor Changes
- #4741
026ccf34356Thanks @aliemir! - AddedsideEffects: falsetopackage.jsonto help bundlers tree-shake unused code.
4.3.2
Patch Changes
- #4406
ad1856f741fThanks @aliemir! - Fix the issue ofmatchPathwhen the resource action is defined as a function or an object. Switched to using matched route string instead of using the route value from theresourcedefinition.
4.3.1
Patch Changes
- #4406
ad1856f741fThanks @aliemir! - Fix the issue ofmatchPathwhen the resource action is defined as a function or an object. Switched to using matched route string instead of using the route value from theresourcedefinition.
4.3.0
Minor Changes
-
#4313
28fe67047a0Thanks @abdellah711! - feat: dynamic window titleThis feature enables users to generate document titles for each page. To activate it, users need to include the
DocumentTitleHandlercomponent within the<Refine>component. By default, theDocumentTitleHandlerwill generate titles using thegenerateDefaultDocumentTitleexported from@refinedev/core.The
DocumentTitleHandlercomponent accepts an optional prop calledhandler, which is a callback function. This function is triggered whenever thepathnamechanges and receives an object with the following parameters:{ resource, // 'posts' action, // 'create' params, // {id: 1} pathname, // '/posts/create' autoGeneratedTitle; // 'Create new Post | refine' }The
handlercallback should return the new title based on the provided parameters. To update the title in a child component, the user can use theuseDocumentTitlehook. It accepts either a string representing the new title or an object with the propertyi18nKeyif the app supports multiple languages.useDocumentTitle({ i18nKey: "documentTitle.default" });
4.2.0
Minor Changes
-
#4313
28fe67047a0Thanks @abdellah711! - feat: dynamic window titleThis feature enables users to generate document titles for each page. To activate it, users need to include the
DocumentTitleHandlercomponent within the<Refine>component. By default, theDocumentTitleHandlerwill generate titles using thegenerateDefaultDocumentTitleexported from@refinedev/core.The
DocumentTitleHandlercomponent accepts an optional prop calledhandler, which is a callback function. This function is triggered whenever thepathnamechanges and receives an object with the following parameters:{ resource, // 'posts' action, // 'create' params, // {id: 1} pathname, // '/posts/create' autoGeneratedTitle; // 'Create new Post | refine' }The
handlercallback should return the new title based on the provided parameters. To update the title in a child component, the user can use theuseDocumentTitlehook. It accepts either a string representing the new title or an object with the propertyi18nKeyif the app supports multiple languages.useDocumentTitle({ i18nKey: "documentTitle.default" });
4.1.0
Minor Changes
-
Thanks @aliemir, @alicanerdurmaz, @batuhanW, @salihozdemir, @yildirayunlu, @recepkutuk! We're releasing a new way to connect your router to refine.
The legacy
routerProviderand its exports are now deprecated but accessible at@refinedev/react-router-v6/legacypath.The new
routerBindingsare smaller and more flexible than the previos one.New
routerBindingsexportNew
routerBindingscontains following properties;go: Which returns a function to handle the navigation inreact-router-v6. It accepts a config object and navigates to the given path. UsesuseNavigatehook under the hood.back: Which returns a function to handle the navigation inreact-router-v6. It navigates back to the previous page. UsesuseNavigatehook under the hood.parse: Which returns a function to parse the given path and returns theresource,id,actionand additionalparams. UsesuseParamsanduseLocationhooks andqspackage under the hood.Link: A component that acceptstoprop and renders a link to the given path. UsesLinkcomponent fromreact-router-domunder the hood.
Complemetary Components
-
RefineRoutes- A component that renders the routes for the resources when the actions are defined as components. This can be used to achieve the legacy behavior ofrouterProviderprop.RefineRoutescomponent accepts a render function as a child and passed aJSX.Elementarray containingRoutecomponents for the resource routes. You can wrap it to aRoutescomponent and let it handle the route creation process for you. Additionally, If you want to add custom routes, you can place them inside theRoutescomponent or you can place an anotherRoutescomponent. Both apporaches are now valid and accepted by refine. -
NavigateToResource- A component that navigates to the firstlistaction of theresourcesarray of<Refine>. Optionally, you can pass aresourceprop to navigate tolistaction of the resource. This can be placed at theindexroute of your app to redirect to the first resource. -
UnsavedChangesNotifier- This component handles the prompt when the user tries to leave the page with unsaved changes. It can be placed under theRefinecomponent.
Exported values from
react-router-domIn earlier versions, we've re-exported the
react-router-dompackage. This was a bad practice and we've removed it in this version. If you're usingreact-router-domin your project, you should install it as a dependency and import the values from it. -
Thanks @aliemir, @alicanerdurmaz, @batuhanW, @salihozdemir, @yildirayunlu, @recepkutuk! Moving to the
@refinedevscope 🎉🎉Moved to the
@refinedevscope and updated our packages to use the new scope. From now on, all packages will be published under the@refinedevscope with their new names.Now, we're also removing the
refineprefix from all packages. So, the@pankod/refine-corepackage is now@refinedev/core,@pankod/refine-antdis now@refinedev/antd, and so on.
Patch Changes
3.40.0
Minor Changes
- #3822
0baa99ba787Thanks @BatuhanW! - - refine v4 release announcement added to "postinstall". - refine v4 is released 🎉 The new version is 100% backward compatible. You can upgrade to v4 with a single command! See the migration guide here: https://refine.dev/docs/migration-guide/3x-to-4x
3.39.0
Minor Changes
- #3822
0baa99ba787Thanks @BatuhanW! - - refine v4 release announcement added to "postinstall". - refine v4 is released 🎉 The new version is 100% backward compatible. You can upgrade to v4 with a single command! See the migration guide here: https://refine.dev/docs/migration-guide/3x-to-4x
3.38.0
Minor Changes
- #3144
c0aea17837cThanks @omeraplak! - Added react-router-dom's exports
3.37.0
Minor Changes
- #3144
c0aea17837cThanks @omeraplak! - Added react-router-dom's exports
3.36.6
Patch Changes
- #3126
ccaf8bde357Thanks @thaihuynhxyz! - fix: react extract incorrect resource from encoded pathname
3.36.5
Patch Changes
- #3126
ccaf8bde357Thanks @thaihuynhxyz! - fix: react extract incorrect resource from encoded pathname
3.36.4
Patch Changes
- #3039
54eee2911a2Thanks @alonp99! - Fixed TypeScript type ofuseParamshook
3.36.3
Patch Changes
- #3039
54eee2911a2Thanks @alonp99! - Fixed TypeScript type ofuseParamshook
3.36.2
Patch Changes
- Add missing
BrowserRouterComponentexport to@pankod/refine-react-router-v6package.
3.36.1
Patch Changes
- #2780
0417b7bf64Thanks @aliemir! - Add missingBrowserRouterComponentexport to@pankod/refine-react-router-v6package.
3.36.0
Minor Changes
- Added ability to manage the initial route of refine by binding
initialRoutevariable toRouterComponentcomponent.
3.35.0
Minor Changes
- Added ability to manage the initial route of refine by binding
initialRoutevariable toRouterComponentcomponent.
3.34.0
Minor Changes
- #2486
ee4d0d112aThanks @aliemir! - Added ability to manage the initial route of refine by bindinginitialRoutevariable toRouterComponentcomponent.
3.33.2
Patch Changes
- Fixed version of react-router to
6.3.0
3.33.1
Patch Changes
- #2501
4095a578d4Thanks @omeraplak! - Fixed version of react-router to6.3.0
3.33.0
Minor Changes
- Update type declaration generation with
tscinstead oftsupfor better navigation throughout projects source code.
3.32.0
Minor Changes
- #2440
0150dcd070Thanks @aliemir! - Update type declaration generation withtscinstead oftsupfor better navigation throughout projects source code.
3.31.3
Patch Changes
- Fixed default login page is
<LoginPage>.
-
🎉 Added
AuthPagecomponent to therefineapp. This page is used to login, register, forgot password and update password. Login page is default page and oldLoginPagecomponent is deprecated.New Auth Hooks
📌 Added
useRegisterhook. This hook is used to register new user.useRegisterfalls into register function ofAuthProvider.📌 Added
useForgotPasswordhook. This hook is used to forgot password.useForgotPasswordfalls intoforgotPasswordfunction ofAuthProvider.📌 Added
useUpdatePasswordhook. This hook is used to update password.useUpdatePasswordfalls intoupdatePasswordfunction ofAuthProvider.- <LoginPage> + <AuthPage>New
AuthPageprops:interface IAuthPageProps extends IAuthCommonProps { type?: "login" | "register" | "forgotPassword" | "updatePassword"; } interface IAuthCommonProps { submitButton?: React.ReactNode; registerLink?: React.ReactNode; loginLink?: React.ReactNode; forgotPasswordLink?: React.ReactNode; updatePasswordLink?: React.ReactNode; backLink?: React.ReactNode; providers?: IProvider[]; } interface IProvider { name: string; icon?: React.ReactNode; label?: string; }
3.31.2
Patch Changes
- #2415
f7c98f0ef9Thanks @biskuvit! - Fixed default login page is<LoginPage>.
3.31.1
Patch Changes
-
#2299
a02cb9e8efThanks @biskuvit! - 🎉 AddedAuthPageto therefineapp. This page is used to login, register, forgot password and update password. Login page is default page and oldLoginPagecomponent is deprecated.New Auth Hooks
📌 Added
useRegisterhook. This hook is used to register new user.useRegisterfalls into register function ofAuthProvider.📌 Added
useForgotPasswordhook. This hook is used to forgot password.useForgotPasswordfalls intoforgotPasswordfunction ofAuthProvider.📌 Added
useUpdatePasswordhook. This hook is used to update password.useUpdatePasswordfalls intoupdatePasswordfunction ofAuthProvider.- <LoginPage> + <AuthPage>New
AuthPageprops:interface IAuthPageProps extends IAuthCommonProps { type?: "login" | "register" | "forgotPassword" | "updatePassword"; } interface IAuthCommonProps { registerLink?: React.ReactNode; loginLink?: React.ReactNode; forgotPasswordLink?: React.ReactNode; updatePasswordLink?: React.ReactNode; backLink?: React.ReactNode; providers?: IProvider[]; } interface IProvider { name: string; icon?: React.ReactNode; label?: string; }Add
AuthPageas a default page to Routers📌 Added
AuthPageto therefine-nextjs-router. Default page isAuthPage.📌 Added
AuthPageto therefine-react-location. Default page isAuthPage.📌 Added
AuthPageto therefine-react-router-v6. Default page isAuthPage.📌 Added
AuthPageto therefine-remix-router. Default page isAuthPage.
3.31.0
Minor Changes
- Add React@18 support 🚀
3.30.0
Minor Changes
- #1718
b38620d842Thanks @omeraplak! - Add React@18 support 🚀
3.29.0
Minor Changes
-
Pass the full
resourceto theaccessControlProvidercan method. This will enable Attribute Based Access Control (ABAC), for example granting permissions based on the value of a field in the resource object.const App: React.FC = () => { <Refine // other providers and props accessControlProvider={{ can: async ({ resource, action, params }) => { if (resource === "posts" && action === "edit") { return Promise.resolve({ can: false, reason: "Unauthorized", }); } // or you can access directly *resource object // const resourceName = params?.resource?.name; // const anyUsefulOption = params?.resource?.options?.yourUsefulOption; // if (resourceName === "posts" && anyUsefulOption === true && action === "edit") { // return Promise.resolve({ // can: false, // reason: "Unauthorized", // }); // } return Promise.resolve({ can: true }); }, }} />; };
3.28.0
Minor Changes
-
e78b181b12Thanks @omeraplak! - Pass the fullresourceto theaccessControlProvidercan method. This will enable Attribute Based Access Control (ABAC), for example granting permissions based on the value of a field in the resource object.const App: React.FC = () => { <Refine // other providers and props accessControlProvider={{ can: async ({ resource, action, params }) => { if (resource === "posts" && action === "edit") { return Promise.resolve({ can: false, reason: "Unauthorized", }); } // or you can access directly *resource object // const resourceName = params?.resource?.name; // const anyUsefulOption = params?.resource?.options?.yourUsefulOption; // if (resourceName === "posts" && anyUsefulOption === true && action === "edit") { // return Promise.resolve({ // can: false, // reason: "Unauthorized", // }); // } return Promise.resolve({ can: true }); }, }} />; };
3.27.0
Minor Changes
-
All of the refine packages have dependencies on the
@pankod/refine-corepackage. So far we have managed these dependencies withpeerDependencies+dependenciesbut this causes issues like #2183. (having more than one @pankod/refine-core version in node_modules and creating different instances)Managing as
peerDependencies+devDependenciesseems like the best way for now to avoid such issues.
Patch Changes
- Fix adding the current path to the
toparameter when redirecting to the login page afterlogout- #2211
3.26.0
Minor Changes
-
#2217
b4aae00f77Thanks @omeraplak! - All of the refine packages have dependencies on the@pankod/refine-corepackage. So far we have managed these dependencies withpeerDependencies+dependenciesbut this causes issues like #2183. (having more than one @pankod/refine-core version in node_modules and creating different instances)Managing as
peerDependencies+devDependenciesseems like the best way for now to avoid such issues.
3.25.3
Patch Changes
- #2214
91db05caf7Thanks @omeraplak! - Fix adding the current path to thetoparameter when redirecting to the login page afterlogout- #2211
3.25.2
Patch Changes
- Fixed a bug that caused
<ErrorComponent/>to does not appear in the404state
3.25.1
Patch Changes
- #1918
b8a4093fdaThanks @biskuvit! - Fixed a bug that caused<ErrorComponent/>to does not appear in the404state
3.22.2
Patch Changes
- Updated dependencies [
2deb19babf]:- @pankod/refine-core@3.23.2