eslint-plugin-primer-react 7.0.0-rc.fc15a49 → 7.0.0

package/CHANGELOG.md

@@ -14,8 +14,12 @@
 
 - [#258](https://github.com/primer/eslint-plugin-primer-react/pull/258) [`83f29f3`](https://github.com/primer/eslint-plugin-primer-react/commit/83f29f339999b9c21d95167bcc2680c1797cbab6) Thanks [@keithamus](https://github.com/keithamus)! - Add enforce-css-module-identifier-casing rule
 
+- [#325](https://github.com/primer/eslint-plugin-primer-react/pull/325) [`f689fcc`](https://github.com/primer/eslint-plugin-primer-react/commit/f689fcc0ca3e5a2c4b76aa04ebb620c7c5786fdf) Thanks [@TylerJDev](https://github.com/TylerJDev)! - Add `no-deprecated-experimental-components` rule
+
 ### Patch Changes
 
+- [#330](https://github.com/primer/eslint-plugin-primer-react/pull/330) [`1b70cf1`](https://github.com/primer/eslint-plugin-primer-react/commit/1b70cf108948d2c6818bbaddd69e5dfad5060e53) Thanks [@francinelucca](https://github.com/francinelucca)! - Add null check to enforce-css-module-identifier-casing.js. Corrects complex instances where ref.resolve is not available.
+
 - [#314](https://github.com/primer/eslint-plugin-primer-react/pull/314) [`63ef9fd`](https://github.com/primer/eslint-plugin-primer-react/commit/63ef9fdf02a9c4b80528644a96fd81e366bce187) Thanks [@khiga8](https://github.com/khiga8)! - fix: Link to should be allowed to have tooltip
 
 ## 6.1.6

package/README.md

@@ -40,3 +40,4 @@ ESLint rules for Primer React
 - [a11y-link-in-text-block](https://github.com/primer/eslint-plugin-primer-react/blob/main/docs/rules/a11y-link-in-text-block.md)
 - [a11y-remove-disable-tooltip](https://github.com/primer/eslint-plugin-primer-react/blob/main/docs/rules/a11y-remove-disable-tooltip.md)
 - [a11y-use-accessible-tooltip](https://github.com/primer/eslint-plugin-primer-react/blob/main/docs/rules/a11y-use-accessible-tooltip.md)
+- [no-deprecated-experimental-components](https://github.com/primer/eslint-plugin-primer-react/blob/main/docs/rules/no-deprecated-experimental-components.md)

package/docs/rules/no-deprecated-experimental-components.md

@@ -0,0 +1,29 @@
+# No deprecated experimental components
+
+## Rule Details
+
+This rule discourages the usage of specific imports from `@primer/react/experimental`.
+
+👎 Examples of **incorrect** code for this rule
+
+```jsx
+import {SelectPanel} from '@primer/react/experimental'
+
+function ExampleComponent() {
+  return <SelectPanel />
+}
+```
+
+👍 Examples of **correct** code for this rule:
+
+You can satisfy the rule by either converting to the non-experimental version:
+
+```jsx
+import {SelectPanel} from '@primer/react'
+
+function ExampleComponent() {
+  return <SelectPanel />
+}
+```
+
+Or by removing usage of the component.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "eslint-plugin-primer-react",
-  "version": "7.0.0-rc.fc15a49",
+  "version": "7.0.0",
   "description": "ESLint rules for Primer React",
   "main": "src/index.js",
   "scripts": {

package/src/configs/recommended.js

@@ -12,6 +12,7 @@ module.exports = {
   rules: {
     'primer-react/direct-slot-children': 'error',
     'primer-react/no-system-props': 'warn',
+    'primer-react/no-deprecated-experimental-components': 'warn',
     'primer-react/a11y-tooltip-interactive-trigger': 'error',
     'primer-react/new-color-css-vars': 'error',
     'primer-react/a11y-explicit-heading': 'error',

package/src/index.js

@@ -3,6 +3,7 @@ module.exports = {
     'direct-slot-children': require('./rules/direct-slot-children'),
     'no-deprecated-entrypoints': require('./rules/no-deprecated-entrypoints'),
     'no-system-props': require('./rules/no-system-props'),
+    'no-deprecated-experimental-components': require('./rules/no-deprecated-experimental-components'),
     'a11y-tooltip-interactive-trigger': require('./rules/a11y-tooltip-interactive-trigger'),
     'new-color-css-vars': require('./rules/new-color-css-vars'),
     'a11y-explicit-heading': require('./rules/a11y-explicit-heading'),

package/src/rules/__tests__/no-deprecated-experimental-components.test.js

@@ -0,0 +1,44 @@
+'use strict'
+
+const {RuleTester} = require('eslint')
+const rule = require('../no-deprecated-experimental-components')
+
+const ruleTester = new RuleTester({
+  parserOptions: {
+    ecmaVersion: 'latest',
+    sourceType: 'module',
+    ecmaFeatures: {
+      jsx: true,
+    },
+  },
+})
+
+ruleTester.run('no-deprecated-experimental-components', rule, {
+  valid: [
+    {
+      code: `import {SelectPanel} from '@primer/react'`,
+    },
+    {
+      code: `import {DataTable} from '@primer/react/experimental'`,
+    },
+    {
+      code: `import {DataTable, ActionBar} from '@primer/react/experimental'`,
+    },
+  ],
+  invalid: [
+    // Single experimental import
+    {
+      code: `import {SelectPanel} from '@primer/react/experimental'`,
+      errors: [
+        'SelectPanel is deprecated. Please import from the stable entrypoint (@primer/react) if available, or check https://primer.style/product/components/ for alternative components.',
+      ],
+    },
+    // Multiple experimental import
+    {
+      code: `import {SelectPanel, DataTable, ActionBar} from '@primer/react/experimental'`,
+      errors: [
+        'SelectPanel is deprecated. Please import from the stable entrypoint (@primer/react) if available, or check https://primer.style/product/components/ for alternative components.',
+      ],
+    },
+  ],
+})

package/src/rules/enforce-css-module-identifier-casing.js

@@ -57,7 +57,7 @@ module.exports = {
             const ref = context.sourceCode
               .getScope(node)
               .references.find(reference => reference.identifier.name === node.property.name)
-            const def = ref.resolved?.defs?.[0]
+            const def = ref?.resolved?.defs?.[0]
             if (def?.node?.init?.type === 'Literal') {
               if (!casingMatches(def.node.init.value || '', casing)) {
                 context.report({

package/src/rules/no-deprecated-experimental-components.js

@@ -0,0 +1,67 @@
+'use strict'
+
+const url = require('../url')
+
+const components = [
+  {
+    identifier: 'SelectPanel',
+    entrypoint: '@primer/react/experimental',
+  },
+]
+
+const entrypoints = new Map()
+
+for (const component of components) {
+  if (!entrypoints.has(component.entrypoint)) {
+    entrypoints.set(component.entrypoint, new Set())
+  }
+  entrypoints.get(component.entrypoint).add(component.identifier)
+}
+
+/**
+ * @type {import('eslint').Rule.RuleModule}
+ */
+module.exports = {
+  meta: {
+    type: 'problem',
+    docs: {
+      description: 'Use a stable component from the `@primer/react` entrypoint, or check the docs for alternatives',
+      recommended: true,
+      url: url(module),
+    },
+    fixable: true,
+    schema: [],
+  },
+  create(context) {
+    return {
+      ImportDeclaration(node) {
+        if (!entrypoints.has(node.source.value)) {
+          return
+        }
+
+        const entrypoint = entrypoints.get(node.source.value)
+
+        const experimental = node.specifiers.filter(specifier => {
+          return entrypoint.has(specifier.imported.name)
+        })
+
+        const components = experimental.map(specifier => specifier.imported.name)
+
+        if (experimental.length === 0) {
+          return
+        }
+
+        if (experimental.length > 0) {
+          const message = `${components.join(', ')} ${
+            components.length > 1 ? 'are' : 'is'
+          } deprecated. Please import from the stable entrypoint (@primer/react) if available, or check https://primer.style/product/components/ for alternative components.`
+
+          context.report({
+            node,
+            message,
+          })
+        }
+      },
+    }
+  },
+}