@clerk/upgrade 0.2.1 → 0.4.0

package/dist/versions/core-2/common/new-localization-keys.md

@@ -0,0 +1,115 @@
+---
+title: 'New localization keys added'
+matcher: "<ClerkProvider[\\s\\S]*?localization=[\\s\\S]*?>"
+matcherFlags: 'm'
+category: 'localization'
+warning: true
+---
+
+As part of the redesign of Clerk's components, a number of new localization keys have been added and can be seen along with their default english values in the code block below. If you do not supply translated values for these keys in your custom localization, they will fall back to the default english values specified below.
+
+```js
+const newValues = {
+  formButtonPrimary__verify: 'Verify',
+  formFieldInputPlaceholder__confirmDeletionUserAccount: 'Delete account',
+  organizationProfile: {
+    invitePage: {
+      selectDropdown__role: 'Select role',
+    },
+    navbar: {
+      description: 'Manage your organization.',
+      general: 'General',
+      members: 'Members',
+      title: 'Organization',
+    },
+    profilePage: {
+      domainSection: {
+        menuAction__manage: 'Manage',
+        menuAction__remove: 'Delete',
+        menuAction__verify: 'Verify',
+      },
+    },
+    start: {
+      headerTitle__general: 'General',
+      profileSection: {
+        primaryButton: 'Update profile',
+        title: 'Organization Profile',
+        uploadAction__title: 'Logo',
+      },
+    },
+    verifiedDomainPage: {
+      title: 'Update {{domain}}',
+    },
+  },
+  signIn: {
+    accountSwitcher: {
+      action__addAccount: 'Add account',
+      action__signOutAll: 'Sign out of all accounts',
+      subtitle: 'Select the account with which you wish to continue.',
+      title: 'Choose an account',
+    },
+    alternativeMethods: {
+      actionText: 'Don’t have any of these?',
+      subtitle: 'Facing issues? You can use any of these methods to sign in.',
+    },
+    forgotPassword: {
+      subtitle_email: 'First, enter the code sent to your email ID',
+      subtitle_phone: 'First, enter the code sent to your phone',
+      title: 'Reset password',
+    },
+  },
+  unstable__errors: {
+    form_param_format_invalid__phone_number: 'Phone number must be in a valid international format',
+  },
+  userProfile: {
+    emailAddressPage: {
+      verifyTitle: 'Verify email address',
+    },
+    formButtonPrimary__add: 'Add',
+    formButtonPrimary__remove: 'Remove',
+    formButtonPrimary__save: 'Save',
+    mfaPhoneCodePage: {
+      backButton: 'Use existing number',
+      successMessage1:
+        'When signing in, you will need to enter a verification code sent to this phone number as an additional step.',
+      successMessage2:
+        'Save these backup codes and store them somewhere safe. If you lose access to your authentication device, you can use backup codes to sign in.',
+      successTitle: 'SMS code verification enabled',
+    },
+    navbar: {
+      account: 'Profile',
+      description: 'Manage your account info.',
+      security: 'Security',
+      title: 'Account',
+    },
+    passwordPage: {
+      checkboxInfoText__signOutOfOtherSessions:
+        'It is recommended to sign out of all other devices which may have used your old password.',
+      successMessage__set: 'Your password has been set.',
+      successMessage__signOutOfOtherSessions: 'All other devices have been signed out.',
+      successMessage__update: 'Your password has been updated.',
+      title__set: 'Set password',
+      title__update: 'Update password',
+    },
+    phoneNumberPage: {
+      verifySubtitle: 'Enter the verification code sent to {{identifier}}',
+      verifyTitle: 'Verify phone number',
+    },
+    start: {
+      passwordSection: {
+        primaryButton__updatePassword: 'Update password',
+      },
+      profileSection: {
+        primaryButton: 'Update profile',
+      },
+      usernameSection: {
+        primaryButton__updateUsername: 'Update username',
+      },
+    },
+    usernamePage: {
+      title__set: 'Set username',
+      title__update: 'Update username',
+    },
+  },
+};
+```

package/dist/versions/{v5/js → core-2/common}/organization-getdomains-arguments-change.md

@@ -1,6 +1,7 @@
 ---
 title: '`Organization.getDomains` arguments changed'
 matcher: "\\.getDomains\\("
+category: 'pagination-args'
 ---
 
 There have been a couple changes to the pagination arguments that can be passed into this function - `limit` has been renamed to `pageSize`, and `offset` has been renamed to `initialPage`. This will help to make it more clear and simple to reason about pagination control. Example of how changes might look below:

package/dist/versions/{v5/js → core-2/common}/organization-getinvitations-arguments-changed.md

@@ -1,6 +1,7 @@
 ---
 title: '`Organization.getInvitations` arguments changed'
 matcher: "\\.getInvitations\\("
+category: 'pagination-args'
 ---
 
 There have been a couple changes to the pagination arguments that can be passed into this function - `limit` has been renamed to `pageSize`, and `offset` has been renamed to `initialPage`. This will help to make it more clear and simple to reason about pagination control. Example of how changes might look below:

package/dist/versions/{v5/js → core-2/common}/organization-getmembershiprequests-arguments-changed.md

@@ -1,6 +1,7 @@
 ---
 title: '`Organization.getMembershipRequests` arguments changed'
 matcher: "\\.getMembershipRequests\\("
+category: 'pagination-args'
 ---
 
 There have been a couple changes to the pagination arguments that can be passed into this function - `limit` has been renamed to `pageSize`, and `offset` has been renamed to `initialPage`. This will help to make it more clear and simple to reason about pagination control. Example of how changes might look below:

package/dist/versions/{v5 → core-2}/common/organization-getmemberships-arguments-changed.md

@@ -1,6 +1,7 @@
 ---
 title: '`Organization.getMemberships` arguments changed'
 matcher: "\\.getMemberships\\("
+category: 'pagination-args'
 ---
 
 There have been a couple changes to the pagination arguments that can be passed into this function - `limit` has been renamed to `pageSize`, and `offset` has been renamed to `initialPage`. This will help to make it more clear and simple to reason about pagination control. Example of how changes might look below:

package/dist/versions/{v5 → core-2}/common/organization-getroles-arguments-changed.md

@@ -1,6 +1,7 @@
 ---
 title: '`Organization.getRoles` arguments changed'
 matcher: "\\.getRoles\\("
+category: 'pagination-args'
 ---
 
 There have been a couple changes to the pagination arguments that can be passed into this function - `limit` has been renamed to `pageSize`, and `offset` has been renamed to `initialPage`. This will help to make it more clear and simple to reason about pagination control. Example of how changes might look below:

package/dist/versions/{v5/js → core-2/common}/organization-logourl.md

@@ -1,6 +1,7 @@
 ---
 title: '`Organization.logoUrl` -> `Organization.imageUrl`'
 matcher: "\\.logoUrl"
+category: 'image-url'
 replaceWithString: '.imageUrl'
 ---
 

package/dist/versions/{v5/backend → core-2/common}/organizationmembershippublicuserdata-profileimageurl.md

@@ -1,6 +1,7 @@
 ---
 title: '`OrganizationMembershipPublicUserData.profileImageUrl` -> `.imageUrl`'
 matcher: "\\.profileImageUrl"
+category: 'image-url'
 ---
 
 The `profileImageUrl` property of any `OrganizationMembershipPublicUserData` object has been changed to `imageUrl`.

package/dist/versions/{v5 → core-2}/common/organizationprofile-settings.md

@@ -2,6 +2,7 @@
 title: '`Settings` -> `General` tab in `OrganizationProfile`'
 matcher: '<OrganizationProfile'
 warning: true
+category: 'appearance'
 image: true
 ---
 

package/dist/versions/{v5 → core-2}/common/organizationswitcherpopoveractionbuttontext-removed.md

@@ -2,6 +2,7 @@
 title: '`organizationSwitcherPopoverActionButtonText` customization id removed'
 image: true
 matcherFlags: 'm'
+category: 'appearance'
 matcher:
   - "\\.cl-organizationSwitcherPopoverActionButtonText"
   - "\\.cl-organizationSwitcherPopoverActionButtonText__manageOrganization"

package/dist/versions/{v5 → core-2}/common/remove-identitypreview-avatar.md

@@ -2,6 +2,7 @@
 title: 'Identity preview avatar customization ids removed'
 image: true
 matcherFlags: 'm'
+category: 'appearance'
 matcher:
   - "\\.cl-identityPreviewAvatarBox"
   - "\\.cl-identityPreviewAvatarImage"

package/dist/versions/{v5 → core-2}/common/remove-socialbuttonsblockbuttonarrow.md

@@ -2,6 +2,7 @@
 title: '`socialButtonsBlockButtonArrow` customization id removed'
 image: true
 matcherFlags: 'm'
+category: 'appearance'
 matcher:
   - "\\.cl-socialButtonsBlockButtonArrow"
   - "elements:\\s+{[\\s\\S]*?socialButtonsBlockButtonArrow:[\\s\\S]*?}"

package/dist/versions/core-2/common/removed-localization-keys.md

@@ -0,0 +1,191 @@
+---
+title: 'Removed localization keys'
+matcherFlags: 'm'
+category: 'localization'
+matcher:
+  - 'formFieldLabel__emailAddress_phoneNumber:'
+  - 'formFieldLabel__phoneNumber_username:'
+  - 'formFieldLabel__emailAddress_phoneNumber_username:'
+  - 'formFieldInputPlaceholder__emailAddress_phoneNumber:'
+  - 'formFieldInputPlaceholder__phoneNumber_username:'
+  - 'formFieldInputPlaceholder__emailAddress_phoneNumber_username:'
+  - "signIn:\\s+{[\\s\\S]*?forgotPassword:\\s+{[\\s\\S]*?title_email:"
+  - "signIn:\\s+{[\\s\\S]*?forgotPassword:\\s+{[\\s\\S]*?title_phone:"
+  - "signIn:\\s+{[\\s\\S]*?forgotPassword:\\s+{[\\s\\S]*?formSubtitle_email:"
+  - "signIn:\\s+{[\\s\\S]*?forgotPassword:\\s+{[\\s\\S]*?formSubtitle_phone:"
+  - "signIn:\\s+{[\\s\\S]*?emailCode:\\s+{[\\s\\S]*?formSubtitle:"
+  - "signIn:\\s+{[\\s\\S]*?phoneCode:\\s+{[\\s\\S]*?formSubtitle:"
+  - "signIn:\\s+{[\\s\\S]*?phoneCodeMfa:\\s+{[\\s\\S]*?formSubtitle:"
+  - "signIn:\\s+{[\\s\\S]*?totpMfa:\\s+{[\\s\\S]*?formSubtitle:"
+  - "signIn:\\s+{[\\s\\S]*?backupCodeMfa:\\s+{[\\s\\S]*?formTitle:"
+  - "signIn:\\s+{[\\s\\S]*?backupCodeMfa:\\s+{[\\s\\S]*?formSubtitle:"
+  - "userProfile:\\s+{[\\s\\S]*?start:\\s+{[\\s\\S]*?headerSubtitle__account:"
+  - "userProfile:\\s+{[\\s\\S]*?start:\\s+{[\\s\\S]*?headerSubtitle__security:"
+  - "userProfile:\\s+{[\\s\\S]*?start:\\s+{[\\s\\S]*?usernameSection:\\s+{[\\s\\S]*?primaryButton__changeUsername:"
+  - "userProfile:\\s+{[\\s\\S]*?start:\\s+{[\\s\\S]*?emailAddressesSection:\\s+{[\\s\\S]*?detailsTitle__primary:"
+  - "userProfile:\\s+{[\\s\\S]*?start:\\s+{[\\s\\S]*?emailAddressesSection:\\s+{[\\s\\S]*?detailsSubtitle__primary:"
+  - "userProfile:\\s+{[\\s\\S]*?start:\\s+{[\\s\\S]*?emailAddressesSection:\\s+{[\\s\\S]*?detailsTitle__nonPrimary:"
+  - "userProfile:\\s+{[\\s\\S]*?start:\\s+{[\\s\\S]*?emailAddressesSection:\\s+{[\\s\\S]*?detailsSubtitle__nonPrimary:"
+  - "userProfile:\\s+{[\\s\\S]*?start:\\s+{[\\s\\S]*?emailAddressesSection:\\s+{[\\s\\S]*?detailsTitle__unverified:"
+  - "userProfile:\\s+{[\\s\\S]*?start:\\s+{[\\s\\S]*?emailAddressesSection:\\s+{[\\s\\S]*?detailsSubtitle__unverified:"
+  - "userProfile:\\s+{[\\s\\S]*?start:\\s+{[\\s\\S]*?emailAddressesSection:\\s+{[\\s\\S]*?destructiveActionTitle:"
+  - "userProfile:\\s+{[\\s\\S]*?start:\\s+{[\\s\\S]*?emailAddressesSection:\\s+{[\\s\\S]*?destructiveActionSubtitle:"
+  - "userProfile:\\s+{[\\s\\S]*?start:\\s+{[\\s\\S]*?phoneNumbersSection:\\s+{[\\s\\S]*?detailsTitle__primary:"
+  - "userProfile:\\s+{[\\s\\S]*?start:\\s+{[\\s\\S]*?phoneNumbersSection:\\s+{[\\s\\S]*?detailsSubtitle__primary:"
+  - "userProfile:\\s+{[\\s\\S]*?start:\\s+{[\\s\\S]*?phoneNumbersSection:\\s+{[\\s\\S]*?detailsTitle__nonPrimary:"
+  - "userProfile:\\s+{[\\s\\S]*?start:\\s+{[\\s\\S]*?phoneNumbersSection:\\s+{[\\s\\S]*?detailsSubtitle__nonPrimary:"
+  - "userProfile:\\s+{[\\s\\S]*?start:\\s+{[\\s\\S]*?phoneNumbersSection:\\s+{[\\s\\S]*?detailsTitle__unverified:"
+  - "userProfile:\\s+{[\\s\\S]*?start:\\s+{[\\s\\S]*?phoneNumbersSection:\\s+{[\\s\\S]*?detailsSubtitle__unverified:"
+  - "userProfile:\\s+{[\\s\\S]*?start:\\s+{[\\s\\S]*?phoneNumbersSection:\\s+{[\\s\\S]*?destructiveActionTitle:"
+  - "userProfile:\\s+{[\\s\\S]*?start:\\s+{[\\s\\S]*?phoneNumbersSection:\\s+{[\\s\\S]*?destructiveActionSubtitle:"
+  - "userProfile:\\s+{[\\s\\S]*?start:\\s+{[\\s\\S]*?connectedAccountsSection:\\s+{[\\s\\S]*?title__conectionFailed:"
+  - "userProfile:\\s+{[\\s\\S]*?start:\\s+{[\\s\\S]*?connectedAccountsSection:\\s+{[\\s\\S]*?title__connectionFailed:"
+  - "userProfile:\\s+{[\\s\\S]*?start:\\s+{[\\s\\S]*?connectedAccountsSection:\\s+{[\\s\\S]*?title__reauthorize:"
+  - "userProfile:\\s+{[\\s\\S]*?start:\\s+{[\\s\\S]*?connectedAccountsSection:\\s+{[\\s\\S]*?actionLabel__conectionFailed:"
+  - "userProfile:\\s+{[\\s\\S]*?start:\\s+{[\\s\\S]*?connectedAccountsSection:\\s+{[\\s\\S]*?destructiveActionSubtitle:"
+  - "userProfile:\\s+{[\\s\\S]*?start:\\s+{[\\s\\S]*?connectedAccountsSection:\\s+{[\\s\\S]*?destructiveActionAccordionSubtitle:"
+  - "userProfile:\\s+{[\\s\\S]*?start:\\s+{[\\s\\S]*?passwordSection:\\s+{[\\s\\S]*?primaryButton__changePassword:"
+  - "userProfile:\\s+{[\\s\\S]*?start:\\s+{[\\s\\S]*?mfaSection:\\s+{[\\s\\S]*?phoneCode:\\s+{[\\s\\S]*?destructiveActionTitle:"
+  - "userProfile:\\s+{[\\s\\S]*?start:\\s+{[\\s\\S]*?mfaSection:\\s+{[\\s\\S]*?phoneCode:\\s+{[\\s\\S]*?destructiveActionSubtitle:"
+  - "userProfile:\\s+{[\\s\\S]*?start:\\s+{[\\s\\S]*?mfaSection:\\s+{[\\s\\S]*?phoneCode:\\s+{[\\s\\S]*?title__default:"
+  - "userProfile:\\s+{[\\s\\S]*?start:\\s+{[\\s\\S]*?mfaSection:\\s+{[\\s\\S]*?phoneCode:\\s+{[\\s\\S]*?title__setDefault:"
+  - "userProfile:\\s+{[\\s\\S]*?start:\\s+{[\\s\\S]*?mfaSection:\\s+{[\\s\\S]*?phoneCode:\\s+{[\\s\\S]*?subtitle__default:"
+  - "userProfile:\\s+{[\\s\\S]*?start:\\s+{[\\s\\S]*?mfaSection:\\s+{[\\s\\S]*?phoneCode:\\s+{[\\s\\S]*?subtitle__setDefault:"
+  - "userProfile:\\s+{[\\s\\S]*?start:\\s+{[\\s\\S]*?mfaSection:\\s+{[\\s\\S]*?totp:\\s+{[\\s\\S]*?title:"
+  - "userProfile:\\s+{[\\s\\S]*?start:\\s+{[\\s\\S]*?mfaSection:\\s+{[\\s\\S]*?totp:\\s+{[\\s\\S]*?subtitle:"
+  - "userProfile:\\s+{[\\s\\S]*?start:\\s+{[\\s\\S]*?mfaSection:\\s+{[\\s\\S]*?totp:\\s+{[\\s\\S]*?destructiveActionSubtitle:"
+  - "userProfile:\\s+{[\\s\\S]*?start:\\s+{[\\s\\S]*?mfaSection:\\s+{[\\s\\S]*?totp:\\s+{[\\s\\S]*?destructiveActionLabel:"
+  - "userProfile:\\s+{[\\s\\S]*?start:\\s+{[\\s\\S]*?activeDevicesSection:\\s+{[\\s\\S]*?primaryButton:"
+  - "userProfile:\\s+{[\\s\\S]*?start:\\s+{[\\s\\S]*?activeDevicesSection:\\s+{[\\s\\S]*?detailsTitle:"
+  - "userProfile:\\s+{[\\s\\S]*?start:\\s+{[\\s\\S]*?activeDevicesSection:\\s+{[\\s\\S]*?detailsSubtitle:"
+  - "userProfile:\\s+{[\\s\\S]*?start:\\s+{[\\s\\S]*?activeDevicesSection:\\s+{[\\s\\S]*?destructiveActionTitle:"
+  - "userProfile:\\s+{[\\s\\S]*?start:\\s+{[\\s\\S]*?activeDevicesSection:\\s+{[\\s\\S]*?destructiveActionSubtitle:"
+  - "userProfile:\\s+{[\\s\\S]*?start:\\s+{[\\s\\S]*?web3WalletsSection:\\s+{[\\s\\S]*?destructiveActionTitle:"
+  - "userProfile:\\s+{[\\s\\S]*?start:\\s+{[\\s\\S]*?web3WalletsSection:\\s+{[\\s\\S]*?destructiveActionSubtitle:"
+  - "userProfile:\\s+{[\\s\\S]*?start:\\s+{[\\s\\S]*?dangerSection:\\s+{[\\s\\S]*?deleteAccountTitle:"
+  - "userProfile:\\s+{[\\s\\S]*?start:\\s+{[\\s\\S]*?dangerSection:\\s+{[\\s\\S]*?deleteAccountDescription:"
+  - "userProfile:\\s+{[\\s\\S]*?profilePage:\\s+{[\\s\\S]*?fileDropAreaTitle:"
+  - "userProfile:\\s+{[\\s\\S]*?profilePage:\\s+{[\\s\\S]*?fileDropAreaAction:"
+  - "userProfile:\\s+{[\\s\\S]*?usernamePage:\\s+{[\\s\\S]*?title:"
+  - "userProfile:\\s+{[\\s\\S]*?phoneNumberPage:\\s+{[\\s\\S]*?infoText__secondary:"
+  - "userProfile:\\s+{[\\s\\S]*?passwordPage:\\s+{[\\s\\S]*?title:"
+  - "userProfile:\\s+{[\\s\\S]*?passwordPage:\\s+{[\\s\\S]*?changePasswordTitle:"
+  - "userProfile:\\s+{[\\s\\S]*?passwordPage:\\s+{[\\s\\S]*?successMessage:"
+  - "userProfile:\\s+{[\\s\\S]*?passwordPage:\\s+{[\\s\\S]*?changePasswordSuccessMessage:"
+  - "userProfile:\\s+{[\\s\\S]*?passwordPage:\\s+{[\\s\\S]*?sessionsSignedOutSuccessMessage:"
+  - "userProfile:\\s+{[\\s\\S]*?mfaPhoneCodePage:\\s+{[\\s\\S]*?successMessage:"
+  - "organizationProfile:\\s+{[\\s\\S]*?start:\\s+{[\\s\\S]*?headerTitle__settings:"
+  - "organizationProfile:\\s+{[\\s\\S]*?start:\\s+{[\\s\\S]*?headerSubtitle__members:"
+  - "organizationProfile:\\s+{[\\s\\S]*?start:\\s+{[\\s\\S]*?headerSubtitle__settings:"
+  - "organizationProfile:\\s+{[\\s\\S]*?profilePage:\\s+{[\\s\\S]*?subtitle:"
+  - "organizationProfile:\\s+{[\\s\\S]*?profilePage:\\s+{[\\s\\S]*?domainSection:\\s+{[\\s\\S]*?unverifiedDomain_menuAction__verify:"
+  - "organizationProfile:\\s+{[\\s\\S]*?profilePage:\\s+{[\\s\\S]*?domainSection:\\s+{[\\s\\S]*?unverifiedDomain_menuAction__remove:"
+  - "organizationProfile:\\s+{[\\s\\S]*?verifiedDomainPage:\\s+{[\\s\\S]*?enrollmentTab:\\s+{[\\s\\S]*?formButton__save:"
+  - "organizationProfile:\\s+{[\\s\\S]*?membersPage:\\s+{[\\s\\S]*?start:\\s+{[\\s\\S]*?headerTitle__active:"
+  - "organizationProfile:\\s+{[\\s\\S]*?membersPage:\\s+{[\\s\\S]*?start:\\s+{[\\s\\S]*?headerTitle__invited:"
+  - "organizationProfile:\\s+{[\\s\\S]*?membersPage:\\s+{[\\s\\S]*?invitationsTab:\\s+{[\\s\\S]*?manualInvitations:\\s+{[\\s\\S]*?headerTitle:"
+  - "organizationProfile:\\s+{[\\s\\S]*?membersPage:\\s+{[\\s\\S]*?invitationsTab:\\s+{[\\s\\S]*?manualInvitations:\\s+{[\\s\\S]*?headerSubtitle:"
+  - "organizationProfile:\\s+{[\\s\\S]*?membersPage:\\s+{[\\s\\S]*?requestsTab:\\s+{[\\s\\S]*?requests:\\s+{[\\s\\S]*?headerTitle:"
+  - "organizationProfile:\\s+{[\\s\\S]*?membersPage:\\s+{[\\s\\S]*?requestsTab:\\s+{[\\s\\S]*?requests:\\s+{[\\s\\S]*?headerSubtitle:"
+  - "createOrganization:\\s+{[\\s\\S]*?subtitle:"
+---
+
+As part of the redesign of Clerk's components, a number of localization keys have been removed as they were no longer present in the new designs. You should remove any of these keys that are present in your localization object as they are no longer needed.
+
+```js
+const deletedKeys = [
+  'formFieldLabel__emailAddress_phoneNumber',
+  'formFieldLabel__phoneNumber_username',
+  'formFieldLabel__emailAddress_phoneNumber_username',
+  'formFieldInputPlaceholder__emailAddress_phoneNumber',
+  'formFieldInputPlaceholder__phoneNumber_username',
+  'formFieldInputPlaceholder__emailAddress_phoneNumber_username',
+  'signIn.forgotPassword.title_email',
+  'signIn.forgotPassword.title_phone',
+  'signIn.forgotPassword.formSubtitle_email',
+  'signIn.forgotPassword.formSubtitle_phone',
+  'signIn.emailCode.formSubtitle',
+  'signIn.phoneCode.formSubtitle',
+  'signIn.phoneCodeMfa.formSubtitle',
+  'signIn.totpMfa.formSubtitle',
+  'signIn.backupCodeMfa.formTitle',
+  'signIn.backupCodeMfa.formSubtitle',
+  'userProfile.start.headerSubtitle__account',
+  'userProfile.start.headerSubtitle__security',
+  'userProfile.start.usernameSection.primaryButton__changeUsername',
+  'userProfile.start.emailAddressesSection.detailsTitle__primary',
+  'userProfile.start.emailAddressesSection.detailsSubtitle__primary',
+  'userProfile.start.emailAddressesSection.detailsTitle__nonPrimary',
+  'userProfile.start.emailAddressesSection.detailsSubtitle__nonPrimary',
+  'userProfile.start.emailAddressesSection.detailsTitle__unverified',
+  'userProfile.start.emailAddressesSection.detailsSubtitle__unverified',
+  'userProfile.start.emailAddressesSection.destructiveActionTitle',
+  'userProfile.start.emailAddressesSection.destructiveActionSubtitle',
+  'userProfile.start.phoneNumbersSection.detailsTitle__primary',
+  'userProfile.start.phoneNumbersSection.detailsSubtitle__primary',
+  'userProfile.start.phoneNumbersSection.detailsTitle__nonPrimary',
+  'userProfile.start.phoneNumbersSection.detailsSubtitle__nonPrimary',
+  'userProfile.start.phoneNumbersSection.detailsTitle__unverified',
+  'userProfile.start.phoneNumbersSection.detailsSubtitle__unverified',
+  'userProfile.start.phoneNumbersSection.destructiveActionTitle',
+  'userProfile.start.phoneNumbersSection.destructiveActionSubtitle',
+  'userProfile.start.connectedAccountsSection.title__conectionFailed',
+  'userProfile.start.connectedAccountsSection.title__connectionFailed',
+  'userProfile.start.connectedAccountsSection.title__reauthorize',
+  'userProfile.start.connectedAccountsSection.actionLabel__conectionFailed',
+  'userProfile.start.connectedAccountsSection.destructiveActionSubtitle',
+  'userProfile.start.connectedAccountsSection.destructiveActionAccordionSubtitle',
+  'userProfile.start.passwordSection.primaryButton__changePassword',
+  'userProfile.start.mfaSection.phoneCode.destructiveActionTitle',
+  'userProfile.start.mfaSection.phoneCode.destructiveActionSubtitle',
+  'userProfile.start.mfaSection.phoneCode.title__default',
+  'userProfile.start.mfaSection.phoneCode.title__setDefault',
+  'userProfile.start.mfaSection.phoneCode.subtitle__default',
+  'userProfile.start.mfaSection.phoneCode.subtitle__setDefault',
+  'userProfile.start.mfaSection.totp.title',
+  'userProfile.start.mfaSection.totp.subtitle',
+  'userProfile.start.mfaSection.totp.destructiveActionSubtitle',
+  'userProfile.start.mfaSection.totp.destructiveActionLabel',
+  'userProfile.start.activeDevicesSection.primaryButton',
+  'userProfile.start.activeDevicesSection.detailsTitle',
+  'userProfile.start.activeDevicesSection.detailsSubtitle',
+  'userProfile.start.activeDevicesSection.destructiveActionTitle',
+  'userProfile.start.activeDevicesSection.destructiveActionSubtitle',
+  'userProfile.start.web3WalletsSection.destructiveActionTitle',
+  'userProfile.start.web3WalletsSection.destructiveActionSubtitle',
+  'userProfile.start.dangerSection.deleteAccountTitle',
+  'userProfile.start.dangerSection.deleteAccountDescription',
+  'userProfile.profilePage.fileDropAreaTitle',
+  'userProfile.profilePage.fileDropAreaAction',
+  'userProfile.usernamePage.title',
+  'userProfile.phoneNumberPage.infoText__secondary',
+  'userProfile.passwordPage.title',
+  'userProfile.passwordPage.changePasswordTitle',
+  'userProfile.passwordPage.successMessage',
+  'userProfile.passwordPage.changePasswordSuccessMessage',
+  'userProfile.passwordPage.sessionsSignedOutSuccessMessage',
+  'userProfile.mfaPhoneCodePage.successMessage',
+  'organizationProfile.start.headerTitle__settings',
+  'organizationProfile.start.headerSubtitle__members',
+  'organizationProfile.start.headerSubtitle__settings',
+  'organizationProfile.profilePage.subtitle',
+  'organizationProfile.profilePage.domainSection.unverifiedDomain_menuAction__verify',
+  'organizationProfile.profilePage.domainSection.unverifiedDomain_menuAction__remove',
+  'organizationProfile.verifiedDomainPage.enrollmentTab.formButton__save',
+  'organizationProfile.membersPage.start.headerTitle__active',
+  'organizationProfile.membersPage.start.headerTitle__invited',
+  'organizationProfile.membersPage.invitationsTab.manualInvitations.headerTitle',
+  'organizationProfile.membersPage.invitationsTab.manualInvitations.headerSubtitle',
+  'organizationProfile.membersPage.requestsTab.requests.headerTitle',
+  'organizationProfile.membersPage.requestsTab.requests.headerSubtitle',
+  'createOrganization.subtitle',
+];
+```
+
+If you'd like to automate this, you can use the [lodash omit function](https://lodash.com/docs/#omit) as such:
+
+```js
+import { omit } from 'lodash-es';
+
+const localization = omit(yourOldOject, deletedKeys);
+```

package/dist/versions/{v5 → core-2}/common/useorganization-invitationlist.md

@@ -9,15 +9,15 @@ The `invitationList` param to the `useOrganizations` hook has been replaced by `
 ```js
 // before
 const { invitationList } = useOrganization({
-	invitationList: { limit: 10, offset: 1 },
+  invitationList: { limit: 10, offset: 1 },
 });
 
 // after
 const { invitations } = useOrganization({
-	invitations: {
-		initialPage: 1,
-		pageSize: 10,
-	},
+  invitations: {
+    initialPage: 1,
+    pageSize: 10,
+  },
 });
 
 // you can also simply return all invitations

package/dist/versions/{v5 → core-2}/common/useorganization-membershiplist.md

@@ -9,15 +9,15 @@ The `membershipList` param from the `useOrganization` hook has been removed. Ins
 ```js
 // before
 const { membershipList } = useOrganization({
-	membershipList: { limit: 10, offset: 1 },
+  membershipList: { limit: 10, offset: 1 },
 });
 
 // after
 const { memberships } = useOrganization({
-	memberships: {
-		initialPage: 1,
-		pageSize: 10,
-	},
+  memberships: {
+    initialPage: 1,
+    pageSize: 10,
+  },
 });
 
 // you can also simply return all memberships

package/dist/versions/{v5/common/user-getorganizationinvitations-arguments-chanaged.md → core-2/common/user-getorganizationinvitations-arguments-changed.md}

@@ -1,6 +1,7 @@
 ---
 title: '`User.getOrganizationInvitations` arguments changed'
 matcher: "\\.getOrganizationInvitations\\("
+category: 'pagination-args'
 ---
 
 There have been a couple changes to the pagination arguments that can be passed into this function - `limit` has been renamed to `pageSize`, and `offset` has been renamed to `initialPage`. This will help to make it more clear and simple to reason about pagination control. Example of how changes might look below:

package/dist/versions/{v5/common/user-getorganizationmemberships-arguments-chanaged.md → core-2/common/user-getorganizationmemberships-arguments-changed.md}

@@ -1,6 +1,7 @@
 ---
 title: '`User.getOrganizationMemberships` arguments changed'
 matcher: "\\.getOrganizationMemberships\\("
+category: 'pagination-args'
 ---
 
 There have been a couple changes to the pagination arguments that can be passed into this function - `limit` has been renamed to `pageSize`, and `offset` has been renamed to `initialPage`. This will help to make it more clear and simple to reason about pagination control. Example of how changes might look below:

package/dist/versions/{v5/common/user-getorganizationsuggestions-arguments-chanaged.md → core-2/common/user-getorganizationsuggestions-arguments-changed.md}

@@ -1,6 +1,7 @@
 ---
 title: '`User.getOrganizationSuggestions` arguments changed'
 matcher: "\\.getOrganizationSuggestions\\("
+category: 'pagination-args'
 ---
 
 There have been a couple changes to the pagination arguments that can be passed into this function - `limit` has been renamed to `pageSize`, and `offset` has been renamed to `initialPage`. This will help to make it more clear and simple to reason about pagination control. Example of how changes might look below:

package/dist/versions/{v5/backend → core-2/common}/user-profileimageurl.md

@@ -1,6 +1,7 @@
 ---
 title: '`User.profileImageUrl` -> `.imageUrl`'
 matcher: "\\.profileImageUrl"
+category: 'image-url'
 ---
 
 The `profileImageUrl` property of any `User` object has been changed to `imageUrl`.

package/dist/versions/{v5/js → core-2/common}/user-update-password.md

@@ -1,19 +1,18 @@
 ---
 title: "`User.update({ password: 'x' })` -> `User.updatePassword('x')`"
 matcher: "\\.update\\([\\s\\S]*?password:[\\s\\S]*?\\)"
+category: 'deprecation-removal'
 matcherFlags: 'm'
 ---
 
 If you are updating a user's password via the [`User.update` method](https://clerk.com/docs/references/javascript/user/user#update), it must be changed to [`User.updatePassword`](https://clerk.com/docs/references/javascript/user/password-management#update-password) instead. This method will require the current password as well as the desired new password. We made this update to improve the security of password changes. Example below:
 
-```js
-// before
-user.update({ password: 'foo' });
+```diff
+- user.update({ password: 'foo' });
 
-// after
-user.updatePassword({
-	currentPassword: 'bar',
-	newPassword: 'foo',
-	signOutOfOtherSessions: true,
-});
++ user.updatePassword({
++   currentPassword: 'bar',
++   newPassword: 'foo',
++   signOutOfOtherSessions: true,
++ });
 ```

package/dist/versions/{v5 → core-2}/common/userbuttonpopoveractionbuttontext-removed.md

@@ -1,6 +1,7 @@
 ---
 title: '`userButtonPopoverActionButtonText` customization id removed'
 image: true
+category: 'appearance'
 matcher:
   - "\\.cl-userButtonPopoverActionButtonText"
   - "\\.cl-userButtonPopoverActionButtonText__signOut"

package/dist/versions/core-2/common/userbuttontrigger-userbuttonbox-invert.md

@@ -0,0 +1,13 @@
+---
+title: '`userButtonBox` is now a child of `userButtonTrigger`'
+warning: true
+category: 'appearance'
+matcher:
+  - "\\.cl-userButtonTrigger"
+  - "\\.cl-userButtonBox"
+  - "elements:\\s+{[\\s\\S]*?userButtonTrigger:[\\s\\S]*?}"
+  - "elements:\\s+{[\\s\\S]*?userButtonBox:[\\s\\S]*?}"
+matcherFlags: 'm'
+---
+
+The parent-child relationship of the two elements `userButtonTrigger` and `userButtonBox` has been swapped. Previously, `userButtonTrigger` was nested inside of `userButtonBox`, and now `userButtonBox` is nested inside of `userButtonTrigger`. This change resolves [some usability issues](https://github.com/clerk/javascript/issues/1625) in `<UserButton />`. If you are applying style customization to either of these elements, your customizations may need to be adjusted.

package/dist/versions/{v5 → core-2}/common/userprofile-security.md

@@ -1,6 +1,7 @@
 ---
 title: 'Within `<UserProfile />`, Account and Security Pages Separated'
 matcher: '(?:<UserProfile|<UserButton)'
+category: 'appearance'
 warning: true
 image: true
 ---

package/dist/versions/{v5 → core-2}/common/withclerk-hof-removed.md

@@ -1,6 +1,7 @@
 ---
 title: '`withClerk` function removed'
 matcher: "import\\s+{[\\s\\S]*?withClerk[\\s\\S]*?from\\s+['\"]@clerk\\/(?:nextjs|clerk-react)[\\s\\S]*?['\"]"
+category: 'hof-removal'
 matcherFlags: 'm'
 ---
 
@@ -8,22 +9,22 @@ The `withClerk` higher order function has been removed. If you would still like
 
 ```js
 function withClerk(Component, displayName) {
-	displayName = displayName || Component.displayName || Component.name || 'Component';
-	Component.displayName = displayName;
-	const HOC = props => {
-		const clerk = useIsomorphicClerkContext();
+  displayName = displayName || Component.displayName || Component.name || 'Component';
+  Component.displayName = displayName;
+  const HOC = props => {
+    const clerk = useIsomorphicClerkContext();
 
-		if (!clerk.loaded) return null;
+    if (!clerk.loaded) return null;
 
-		return (
-			<Component
-				{...props}
-				clerk={clerk}
-			/>
-		);
-	};
+    return (
+      <Component
+        {...props}
+        clerk={clerk}
+      />
+    );
+  };
 
-	HOC.displayName = `withClerk(${displayName})`;
-	return HOC;
+  HOC.displayName = `withClerk(${displayName})`;
+  return HOC;
 }
 ```

package/dist/versions/{v5 → core-2}/common/withclerk-removed.md

@@ -1,6 +1,7 @@
 ---
 title: '`WithClerk` component removed'
 matcher: "import\\s+{[\\s\\S]*?WithClerk[\\s\\S]*?from\\s+['\"]@clerk\\/(?:nextjs|clerk-react)[\\s\\S]*?['\"]"
+category: 'hof-removal'
 matcherFlags: 'm'
 ---