Create @shopify/polaris-migrator package

Author: sam-b-rose

.changeset/loud-camels-accept.md

@@ -0,0 +1,5 @@
+---
+'@shopify/polaris-migrator': patch
+---
+
+Initial release

.eslintrc.js

@@ -87,6 +87,21 @@ module.exports = {
         '@shopify/jsx-no-hardcoded-content': 'off',
       },
     },
+    {
+      files: ['polaris-migrator/src/**/*.{ts,tsx}'],
+      rules: {
+        'import/no-default-export': 'off',
+      },
+    },
+    {
+      files: ['polaris-migrator/src/**/tests/*.{ts,tsx}'],
+      rules: {
+        'import/no-default-export': 'off',
+        'import/no-extraneous-dependencies': 'off',
+        '@shopify/jsx-no-hardcoded-content': 'off',
+        '@typescript-eslint/ban-ts-comment': 'off',
+      },
+    },
     {
       files: ['polaris-react/src/**/*.{ts,tsx}'],
       extends: ['plugin:@shopify/typescript-type-checking'],

.stylelintrc.js

@@ -16,6 +16,12 @@ module.exports = {
         './stylelint-polaris/configs/internal',
       ],
     },
+    {
+      files: ['polaris-migrator/**/tests/*.{css,scss}'],
+      rules: {
+        'declaration-property-value-disallowed-list': 'off',
+      },
+    },
   ],
   ignoreFiles: [
     '**/.next/**/*.{css,scss}',

babel.config.js

@@ -7,6 +7,7 @@ module.exports = {
     '.',
     // Note: The following projects use rootMode: 'upward' to inherit
     // and merge with this root level config.
+    './polaris-migrator',
     './polaris-tokens',
     './polaris-icons',
     './polaris-react',

package.json

@@ -11,6 +11,7 @@
       "polaris-for-figma",
       "polaris-for-vscode",
       "polaris-icons",
+      "polaris-migrator",
       "polaris-react",
       "stylelint-polaris",
       "polaris.shopify.com"
@@ -36,7 +37,7 @@
     "changeset": "changeset",
     "preversion-packages": "turbo run preversion",
     "version-packages": "yarn preversion-packages && changeset version",
-    "release": "turbo run build --filter=polaris.shopify.com^... && changeset publish",
+    "release": "turbo run build --filter='!polaris.shopify.com' && changeset publish",
     "preversion": "echo \"Error: use @changsets/cli to version packages\" && exit 1"
   },
   "devDependencies": {

polaris-migrator/README.md

@@ -0,0 +1,20 @@
+# [Polaris Migrator](https://polaris.shopify.com/docs/advanced-features)
+
+[![npm version](https://img.shields.io/npm/v/@shopify/polaris-migrator.svg?style=flat)](https://www.npmjs.com/package/@shopify/polaris-migrator)
+
+Codemod transformations to help upgrade your Polaris codebase.
+
+## Usage
+
+```sh
+npx @shopify/polaris-migrator <transform> <path>
+```
+
+- `transform` - name of transform, see available transforms below.
+- `path` - files or directory to transform
+- `--dry` Do a dry-run, no code will be edited
+- `--print` Prints the changed output for comparison
+
+## Documentation
+
+Visit [polaris.shopify.com/docs/advanced-features/migrations](https://polaris.shopify.com/docs/advanced-features/migrations) to view available migrations.

polaris-migrator/bin/migrator-cli.js

@@ -0,0 +1,5 @@
+#!/usr/bin/env node
+
+const {run} = require('./../dist');
+
+run();

polaris-migrator/jest.config.js

@@ -0,0 +1,8 @@
+module.exports = {
+  transform: {
+    '\\.(js|tsx?)$': [
+      'babel-jest',
+      {targets: 'current node', envName: 'test', rootMode: 'upward'},
+    ],
+  },
+};

polaris-migrator/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "@shopify/polaris-migrator",
+  "version": "0.0.0",
+  "description": "Codemod transformations to help upgrade your Polaris codebase",
+  "license": "SEE LICENSE IN LICENSE.md",
+  "author": "Shopify <[email protected]>",
+  "homepage": "https://polaris.shopify.com",
+  "repository": "https://github.com/Shopify/polaris",
+  "bugs": {
+    "url": "https://github.com/Shopify/polaris/issues"
+  },
+  "publishConfig": {
+    "access": "public",
+    "@shopify:registry": "https://registry.npmjs.org"
+  },
+  "main": "dist/index.js",
+  "bin": "bin/migrator-cli.js",
+  "files": [
+    "bin",
+    "dist"
+  ],
+  "scripts": {
+    "build": "rollup -c",
+    "dev": "rollup -c -w",
+    "start": "./bin/migrator-cli.js",
+    "lint": "TIMING=1 eslint --cache .",
+    "test": "jest",
+    "clean": "rm -rf .turbo node_modules dist *.tsbuildinfo"
+  },
+  "dependencies": {
+    "chalk": "^4.1.0",
+    "globby": "11.0.1",
+    "is-git-clean": "^1.1.0",
+    "jscodeshift": "^0.13.1",
+    "meow": "^9.0.0",
+    "postcss": "^8.4.14",
+    "postcss-scss": "^4.0.4",
+    "postcss-value-parser": "^4.2.0"
+  },
+  "devDependencies": {
+    "@types/is-git-clean": "^1.1.0",
+    "@types/jscodeshift": "^0.11.5",
+    "prettier": "^2.7.1"
+  }
+}

polaris-migrator/rollup.config.mjs

@@ -0,0 +1,51 @@
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import * as url from 'node:url';
+
+import {babel} from '@rollup/plugin-babel';
+import {nodeResolve} from '@rollup/plugin-node-resolve';
+import commonjs from '@rollup/plugin-commonjs';
+import json from '@rollup/plugin-json';
+import globby from 'globby';
+
+const __dirname = path.dirname(url.fileURLToPath(import.meta.url));
+const pkg = JSON.parse(fs.readFileSync(path.join(__dirname, 'package.json')));
+
+const extensions = ['.js', '.jsx', '.ts', '.tsx'];
+
+const migrationPaths = globby.sync('./src/migrations/*!(tests)/*.ts');
+
+/** @type {import('rollup').RollupOptions} */
+export default {
+  input: ['src/index.ts', ...migrationPaths],
+  output: [
+    {
+      format: /** @type {const} */ ('cjs'),
+      entryFileNames: '[name][assetExtname].js',
+      dir: path.dirname(pkg.main),
+      preserveModules: true,
+      exports: 'auto',
+    },
+  ],
+  plugins: [
+    // Allows node_modules resolution
+    nodeResolve({extensions, preferBuiltins: true}),
+    // Allow bundling cjs modules. Rollup doesn't understand cjs
+    commonjs(),
+    // Compile TypeScript/JavaScript files
+    babel({
+      extensions,
+      rootMode: 'upward',
+      include: ['src/**/*'],
+      babelHelpers: 'bundled',
+      envName: 'production',
+      targets: 'node 14.13',
+    }),
+    json({compact: true}),
+  ],
+  external: [
+    ...Object.keys(pkg.dependencies ?? {}),
+    ...Object.keys(pkg.peerDependencies ?? {}),
+    'jscodeshift/src/Runner',
+  ],
+};