feat: MUI 4 to BUI migration - core component codemods (#112, #113, #114, #115, #116)

.changeset/mui-to-bui-core-components.md

@@ -0,0 +1,9 @@
+---
+'@backstage/migrate-mui-typography-to-text': minor
+'@backstage/migrate-mui-alert-to-bui-alert': minor
+'@backstage/migrate-mui-button-to-bui-button': minor
+'@backstage/migrate-mui-icon-button-to-button-icon': minor
+'@backstage/migrate-mui-tooltip-to-bui-tooltip': minor
+---
+
+Add core component codemods for the MUI 4 to BUI migration: Typography to Text, Alert, Button, IconButton to ButtonIcon, and Tooltip to TooltipTrigger.

README.md

@@ -42,14 +42,19 @@ Older versions are available in the [`codemods/`](./codemods) directory.
 
 ### misc
 
-| Codemod                                                                                        | Description                                                                                       |
-| ---------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------- |
-| [migrate-mui-bootstrap-to-bui](./codemods/misc/migrate-mui-bootstrap-to-bui)                   | MUI 4 to BUI: Bootstrap app dependencies and root CSS                                             |
-| [migrate-mui-icons-to-remix-icons](./codemods/misc/migrate-mui-icons-to-remix-icons)           | MUI 4 to BUI: Replace MUI icons with Remix icons                                                  |
-| [migrate-mui-layout-to-bui-layout](./codemods/misc/migrate-mui-layout-to-bui-layout)           | MUI 4 to BUI: Convert common MUI layout primitives to BUI layout                                  |
-| [migrate-mui-styles-to-bui-css-modules](./codemods/misc/migrate-mui-styles-to-bui-css-modules) | MUI 4 to BUI: Migrate makeStyles usage to BUI CSS modules                                         |
-| [mui4-to-bui-migration-recipe](./codemods/misc/mui4-to-bui-migration-recipe)                   | MUI 4 to BUI: Migration recipe that runs every MUI→BUI codemod from the registry in a safe order. |
-| [remove-mui-dependencies](./codemods/misc/remove-mui-dependencies)                             | MUI 4 to BUI: Remove unused @material-ui/\* dependencies from package.json                        |
+| Codemod                                                                                          | Description                                                                                                           |
+| ------------------------------------------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------- |
+| [migrate-mui-alert-to-bui-alert](./codemods/misc/migrate-mui-alert-to-bui-alert)                 | MUI 4 to BUI: Replace MUI Alert with BUI Alert                                                                        |
+| [migrate-mui-bootstrap-to-bui](./codemods/misc/migrate-mui-bootstrap-to-bui)                     | MUI 4 to BUI: Bootstrap app dependencies and root CSS                                                                 |
+| [migrate-mui-button-to-bui-button](./codemods/misc/migrate-mui-button-to-bui-button)             | MUI 4 to BUI: Replace MUI Button with BUI Button                                                                      |
+| [migrate-mui-icon-button-to-button-icon](./codemods/misc/migrate-mui-icon-button-to-button-icon) | MUI 4 to BUI: Replace IconButton with ButtonIcon. Package name omits -bui- because ButtonIcon is the BUI export name. |
+| [migrate-mui-icons-to-remix-icons](./codemods/misc/migrate-mui-icons-to-remix-icons)             | MUI 4 to BUI: Replace MUI icons with Remix icons                                                                      |
+| [migrate-mui-layout-to-bui-layout](./codemods/misc/migrate-mui-layout-to-bui-layout)             | MUI 4 to BUI: Convert common MUI layout primitives to BUI layout                                                      |
+| [migrate-mui-styles-to-bui-css-modules](./codemods/misc/migrate-mui-styles-to-bui-css-modules)   | MUI 4 to BUI: Migrate makeStyles usage to BUI CSS modules                                                             |
+| [migrate-mui-tooltip-to-bui-tooltip](./codemods/misc/migrate-mui-tooltip-to-bui-tooltip)         | MUI 4 to BUI: Replace Tooltip with TooltipTrigger                                                                     |
+| [migrate-mui-typography-to-text](./codemods/misc/migrate-mui-typography-to-text)                 | MUI 4 to BUI: Replace Typography with Text. Package name omits -bui- because Text is the BUI export name.             |
+| [mui4-to-bui-migration-recipe](./codemods/misc/mui4-to-bui-migration-recipe)                     | MUI 4 to BUI: Migration recipe that runs every MUI→BUI codemod from the registry in a safe order.                     |
+| [remove-mui-dependencies](./codemods/misc/remove-mui-dependencies)                               | MUI 4 to BUI: Remove unused @material-ui/\* dependencies from package.json                                            |
 
 <!-- CODEMODS_END -->
 

codemods/misc/migrate-mui-alert-to-bui-alert/CHANGELOG.md

@@ -0,0 +1,7 @@
+# @backstage/migrate-mui-alert-to-bui-alert
+
+## 0.1.0
+
+### Minor Changes
+
+- Initial release: migrate MUI `Alert` / `AlertTitle` to Backstage UI `Alert` (severity→status, title/description props) during the MUI 4 to BUI migration.

codemods/misc/migrate-mui-alert-to-bui-alert/codemod.yaml

@@ -0,0 +1,20 @@
+schema_version: '1.0'
+
+name: '@backstage/migrate-mui-alert-to-bui-alert'
+version: '0.1.0'
+description: 'MUI 4 to BUI: Replace MUI Alert with BUI Alert'
+author: 'Paul Schultz<pschultz@redhat.com>'
+license: 'Apache-2.0'
+repository: 'https://github.com/backstage/codemods'
+workflow: 'workflow.yaml'
+
+targets:
+  languages: ['tsx', 'ts']
+
+keywords: ['backstage', 'migration', 'mui', 'bui', 'alert']
+
+registry:
+  access: 'public'
+  visibility: 'public'
+
+capabilities: []

codemods/misc/migrate-mui-alert-to-bui-alert/package.json

@@ -0,0 +1,13 @@
+{
+  "name": "@backstage/migrate-mui-alert-to-bui-alert",
+  "version": "0.1.0",
+  "description": "MUI 4 to BUI: Replace MUI Alert with BUI Alert",
+  "type": "module",
+  "scripts": {
+    "test": "yarn exec codemod jssg test -l tsx ./scripts/codemod.ts ./tests && yarn exec codemod workflow validate -w workflow.yaml"
+  },
+  "devDependencies": {
+    "@codemod.com/jssg-types": "1.6.2",
+    "codemod": "1.12.3"
+  }
+}