diff --git a/.changeset/gorgeous-frogs-cover.md b/.changeset/gorgeous-frogs-cover.md
new file mode 100644
index 00000000..adef2f07
--- /dev/null
+++ b/.changeset/gorgeous-frogs-cover.md
@@ -0,0 +1,5 @@
+---
+"eslint-plugin-primer-react": major
+---
+
+Update a11y-use-next-tooltip to be a11y-use-accessible-tooltip and make the changes accordingly
diff --git a/README.md b/README.md
index eb90a910..03a4c86b 100644
--- a/README.md
+++ b/README.md
@@ -39,4 +39,4 @@ ESLint rules for Primer React
- [a11y-explicit-heading](https://github.com/primer/eslint-plugin-primer-react/blob/main/docs/rules/a11y-explicit-heading.md)
- [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-next-tooltip](https://github.com/primer/eslint-plugin-primer-react/blob/main/docs/rules/a11y-use-next-tooltip.md)
+- [a11y-use-accessible-tooltip](https://github.com/primer/eslint-plugin-primer-react/blob/main/docs/rules/a11y-use-accessible-tooltip.md)
diff --git a/docs/rules/a11y-use-accessible-tooltip.md b/docs/rules/a11y-use-accessible-tooltip.md
new file mode 100644
index 00000000..55311775
--- /dev/null
+++ b/docs/rules/a11y-use-accessible-tooltip.md
@@ -0,0 +1,47 @@
+# Recommends to use the new accessible tooltip instead of the deprecated one.
+
+## Rule details
+
+This rule suggests switching to the new accessible tooltip from @primer/react instead of the deprecated version. Deprecated props like wrap, noDelay, and align should also be removed.
+
+Note that the new tooltip is intended for interactive elements only, such as buttons and links, whereas the deprecated tooltip could be applied to any element, though it lacks screen reader accessibility. As a result, the autofix for this rule will only work if the deprecated tooltip is on an interactive element. If it is applied to a non-interactive element, please consult your design team for [an alternative approach](https://primer.style/guides/accessibility/tooltip-alternatives).
+
+👎 Examples of **incorrect** code for this rule:
+
+```jsx
+import {Tooltip} from '@primer/react/deprecated'
+
+const App = () => (
+
+
+
+)
+```
+
+👍 Examples of **correct** code for this rule:
+
+```jsx
+import {Tooltip} from '@primer/react'
+
+const App = () => (
+
+
+
+)
+```
+
+## Icon buttons and tooltips
+
+Even though the below code is perfectly valid, since icon buttons now come with tooltips by default, it is not required to explicitly use the Tooltip component on icon buttons.
+
+```jsx
+import {IconButton, Tooltip} from '@primer/react'
+
+function ExampleComponent() {
+ return (
+
+
+
+ )
+}
+```
diff --git a/docs/rules/a11y-use-next-tooltip.md b/docs/rules/a11y-use-next-tooltip.md
deleted file mode 100644
index 18659934..00000000
--- a/docs/rules/a11y-use-next-tooltip.md
+++ /dev/null
@@ -1,33 +0,0 @@
-# Recommends to use the `next` tooltip instead of the current stable one.
-
-## Rule details
-
-This rule recommends using the tooltip that is imported from `@primer/react/next` instead of the main entrypoint. The components that are exported from `@primer/react/next` are recommended over the main entrypoint ones because `next` components are reviewed and remediated for accessibility issues.
-👎 Examples of **incorrect** code for this rule:
-
-```tsx
-import {Tooltip} from '@primer/react'
-```
-
-👍 Examples of **correct** code for this rule:
-
-```tsx
-import {Tooltip} from '@primer/react/next'
-```
-
-## Icon buttons and tooltips
-
-Even though the below code is perfectly valid, since icon buttons now come with tooltips by default, it is not required to explicitly use the Tooltip component on icon buttons.
-
-```jsx
-import {IconButton} from '@primer/react'
-import {Tooltip} from '@primer/react/next'
-
-function ExampleComponent() {
- return (
-
-
-
- )
-}
-```
diff --git a/src/configs/recommended.js b/src/configs/recommended.js
index 8d79314e..2b247df4 100644
--- a/src/configs/recommended.js
+++ b/src/configs/recommended.js
@@ -17,7 +17,7 @@ module.exports = {
'primer-react/a11y-explicit-heading': 'error',
'primer-react/no-deprecated-props': 'warn',
'primer-react/a11y-remove-disable-tooltip': 'error',
- 'primer-react/a11y-use-next-tooltip': 'error',
+ 'primer-react/a11y-use-accessible-tooltip': 'error',
'primer-react/no-unnecessary-components': 'error',
'primer-react/prefer-action-list-item-onselect': 'error',
'primer-react/enforce-css-module-identifier-casing': 'error',
diff --git a/src/index.js b/src/index.js
index 606e15c7..2acf7c88 100644
--- a/src/index.js
+++ b/src/index.js
@@ -9,7 +9,7 @@ module.exports = {
'no-deprecated-props': require('./rules/no-deprecated-props'),
'a11y-link-in-text-block': require('./rules/a11y-link-in-text-block'),
'a11y-remove-disable-tooltip': require('./rules/a11y-remove-disable-tooltip'),
- 'a11y-use-next-tooltip': require('./rules/a11y-use-next-tooltip'),
+ 'a11y-use-accessible-tooltip': require('./rules/a11y-use-accessible-tooltip'),
'use-deprecated-from-deprecated': require('./rules/use-deprecated-from-deprecated'),
'no-wildcard-imports': require('./rules/no-wildcard-imports'),
'no-unnecessary-components': require('./rules/no-unnecessary-components'),
diff --git a/src/rules/__tests__/a11y-use-accessible-tooltip.test.js b/src/rules/__tests__/a11y-use-accessible-tooltip.test.js
new file mode 100644
index 00000000..bc99ebb3
--- /dev/null
+++ b/src/rules/__tests__/a11y-use-accessible-tooltip.test.js
@@ -0,0 +1,59 @@
+const rule = require('../a11y-use-accessible-tooltip')
+const {RuleTester} = require('eslint')
+
+const ruleTester = new RuleTester({
+ parserOptions: {
+ ecmaVersion: 'latest',
+ sourceType: 'module',
+ ecmaFeatures: {
+ jsx: true,
+ },
+ },
+})
+
+ruleTester.run('a11y-use-accessible-tooltip', rule, {
+ valid: [`import {Tooltip} from '@primer/react';`],
+ invalid: [
+ // Single import from deprecated
+ {
+ code: `import {Tooltip} from '@primer/react/deprecated';`,
+ errors: [{messageId: 'useAccessibleTooltip'}],
+ output: `import {Tooltip} from '@primer/react';`,
+ },
+ // Multiple imports from deprecated
+ {
+ code: `import {Tooltip, Button} from '@primer/react/deprecated';`,
+ errors: [{messageId: 'useAccessibleTooltip'}],
+ output: `import {Button} from '@primer/react/deprecated';\nimport {Tooltip} from '@primer/react';`,
+ },
+ // Multiple imports from deprecated
+ {
+ code: `import {Button, Tooltip, Stack} from '@primer/react/deprecated';`,
+ errors: [{messageId: 'useAccessibleTooltip'}],
+ output: `import {Button, Stack} from '@primer/react/deprecated';\nimport {Tooltip} from '@primer/react';`,
+ },
+ // Single import from deprecated with an existing import from @primer/react
+ {
+ code: `import {Tooltip} from '@primer/react/deprecated';import {ActionList, ActionMenu} from '@primer/react';`,
+ errors: [{messageId: 'useAccessibleTooltip', line: 1}],
+ output: `import {ActionList, ActionMenu, Tooltip} from '@primer/react';`,
+ },
+ // Multiple imports from deprecated with an existing import from @primer/react
+ {
+ code: `import {Dialog, Tooltip} from '@primer/react/deprecated';import {ActionList, ActionMenu} from '@primer/react';`,
+ errors: [{messageId: 'useAccessibleTooltip', line: 1}],
+ output: `import {Dialog} from '@primer/react/deprecated';import {ActionList, ActionMenu, Tooltip} from '@primer/react';`,
+ },
+ {
+ code: `import {ActionList, ActionMenu, Tooltip, Button} from '@primer/react/deprecated';\n`,
+ errors: [
+ {messageId: 'useAccessibleTooltip', line: 1},
+ {messageId: 'useTextProp', line: 2},
+ {messageId: 'noDelayRemoved', line: 2},
+ {messageId: 'wrapRemoved', line: 2},
+ {messageId: 'alignRemoved', line: 2},
+ ],
+ output: `import {ActionList, ActionMenu, Button} from '@primer/react/deprecated';\nimport {Tooltip} from '@primer/react';\n`,
+ },
+ ],
+})
diff --git a/src/rules/__tests__/a11y-use-next-tooltip.test.js b/src/rules/__tests__/a11y-use-next-tooltip.test.js
deleted file mode 100644
index 64115c7c..00000000
--- a/src/rules/__tests__/a11y-use-next-tooltip.test.js
+++ /dev/null
@@ -1,61 +0,0 @@
-const rule = require('../a11y-use-next-tooltip')
-const {RuleTester} = require('eslint')
-
-const ruleTester = new RuleTester({
- parserOptions: {
- ecmaVersion: 'latest',
- sourceType: 'module',
- ecmaFeatures: {
- jsx: true,
- },
- },
-})
-
-ruleTester.run('a11y-use-next-tooltip', rule, {
- valid: [
- `import {Tooltip} from '@primer/react/next';`,
- `import {UnderlineNav, Button} from '@primer/react';
- import {Tooltip} from '@primer/react/next';`,
- `import {UnderlineNav, Button} from '@primer/react';
- import {Tooltip, SelectPanel} from '@primer/react/next';`,
- ],
- invalid: [
- {
- code: `import {Tooltip} from '@primer/react';`,
- errors: [{messageId: 'useNextTooltip'}],
- output: `import {Tooltip} from '@primer/react/next';`,
- },
- {
- code: `import {Tooltip, Button} from '@primer/react';\n`,
- errors: [{messageId: 'useNextTooltip'}, {messageId: 'useTextProp'}],
- output: `import {Button} from '@primer/react';\nimport {Tooltip} from '@primer/react/next';\n`,
- },
- {
- code: `import {ActionList, ActionMenu, Tooltip, Button} from '@primer/react';\n`,
- errors: [
- {messageId: 'useNextTooltip', line: 1},
- {messageId: 'useTextProp', line: 2},
- ],
- output: `import {ActionList, ActionMenu, Button} from '@primer/react';\nimport {Tooltip} from '@primer/react/next';\n`,
- },
- {
- code: `import {ActionList, ActionMenu, Button, Tooltip} from '@primer/react';\n`,
- errors: [
- {messageId: 'useNextTooltip', line: 1},
- {messageId: 'useTextProp', line: 2},
- ],
- output: `import {ActionList, ActionMenu, Button} from '@primer/react';\nimport {Tooltip} from '@primer/react/next';\n`,
- },
- {
- code: `import {ActionList, ActionMenu, Tooltip, Button} from '@primer/react';\n`,
- errors: [
- {messageId: 'useNextTooltip', line: 1},
- {messageId: 'useTextProp', line: 2},
- {messageId: 'noDelayRemoved', line: 2},
- {messageId: 'wrapRemoved', line: 2},
- {messageId: 'alignRemoved', line: 2},
- ],
- output: `import {ActionList, ActionMenu, Button} from '@primer/react';\nimport {Tooltip} from '@primer/react/next';\n`,
- },
- ],
-})
diff --git a/src/rules/a11y-use-accessible-tooltip.js b/src/rules/a11y-use-accessible-tooltip.js
new file mode 100644
index 00000000..5e0129fc
--- /dev/null
+++ b/src/rules/a11y-use-accessible-tooltip.js
@@ -0,0 +1,148 @@
+'use strict'
+const url = require('../url')
+const {getJSXOpeningElementAttribute} = require('../utils/get-jsx-opening-element-attribute')
+const {getJSXOpeningElementName} = require('../utils/get-jsx-opening-element-name')
+
+module.exports = {
+ meta: {
+ type: 'suggestion',
+ docs: {
+ description: 'recommends the use of @primer/react Tooltip component',
+ category: 'Best Practices',
+ recommended: true,
+ url: url(module),
+ },
+ fixable: true,
+ schema: [],
+ messages: {
+ useAccessibleTooltip: 'Please use @primer/react Tooltip component that has accessibility improvements',
+ useTextProp: 'Please use the text prop instead of aria-label',
+ noDelayRemoved: 'noDelay prop is removed. Tooltip now has no delay by default',
+ wrapRemoved: 'wrap prop is removed. Tooltip now wraps by default',
+ alignRemoved: 'align prop is removed. Please use the direction prop instead.',
+ },
+ },
+ create(context) {
+ return {
+ ImportDeclaration(node) {
+ if (node.source.value !== '@primer/react/deprecated') {
+ return
+ }
+ const hasTooltip = node.specifiers.some(
+ specifier => specifier.imported && specifier.imported.name === 'Tooltip',
+ )
+
+ if (!hasTooltip) {
+ return
+ }
+
+ const hasOtherImports = node.specifiers.length > 1
+
+ const sourceCode = context.getSourceCode()
+ // Checking to see if there is an existing root (@primer/react) import
+ // Assuming there is one root import per file
+ const rootImport = sourceCode.ast.body.find(statement => {
+ return statement.type === 'ImportDeclaration' && statement.source.value === '@primer/react'
+ })
+
+ const tooltipSpecifier = node.specifiers.find(
+ specifier => specifier.imported && specifier.imported.name === 'Tooltip',
+ )
+
+ const hasRootImport = rootImport !== undefined
+
+ context.report({
+ node,
+ messageId: 'useAccessibleTooltip',
+ fix(fixer) {
+ const fixes = []
+ if (!hasOtherImports) {
+ // If Tooltip is the only import and no existing @primer/react import, replace the whole import statement
+ if (!hasRootImport) fixes.push(fixer.replaceText(node.source, `'@primer/react'`))
+ if (hasRootImport) {
+ // remove the entire import statement
+ fixes.push(fixer.remove(node))
+ // find the last specifier in the existing @primer/react import and insert Tooltip after that
+ const lastSpecifier = rootImport.specifiers[rootImport.specifiers.length - 1]
+ fixes.push(fixer.insertTextAfter(lastSpecifier, `, Tooltip`))
+ }
+ } else {
+ // There are other imports from the deprecated bundle but no existing @primer/react import, so remove the Tooltip import and add a new import statement with the correct path.
+ const previousToken = sourceCode.getTokenBefore(tooltipSpecifier)
+ const nextToken = sourceCode.getTokenAfter(tooltipSpecifier)
+ const hasTrailingComma = nextToken && nextToken.value === ','
+ const hasLeadingComma = previousToken && previousToken.value === ','
+
+ let rangeToRemove
+
+ if (hasTrailingComma) {
+ rangeToRemove = [tooltipSpecifier.range[0], nextToken.range[1] + 1]
+ } else if (hasLeadingComma) {
+ rangeToRemove = [previousToken.range[0], tooltipSpecifier.range[1]]
+ } else {
+ rangeToRemove = [tooltipSpecifier.range[0], tooltipSpecifier.range[1]]
+ }
+ // Remove Tooltip from the import statement
+ fixes.push(fixer.removeRange(rangeToRemove))
+
+ if (!hasRootImport) {
+ fixes.push(fixer.insertTextAfter(node, `\nimport {Tooltip} from '@primer/react';`))
+ } else {
+ // find the last specifier in the existing @primer/react import and insert Tooltip after that
+ const lastSpecifier = rootImport.specifiers[rootImport.specifiers.length - 1]
+ fixes.push(fixer.insertTextAfter(lastSpecifier, `, Tooltip`))
+ }
+ }
+ return fixes
+ },
+ })
+ },
+ JSXOpeningElement(node) {
+ const openingElName = getJSXOpeningElementName(node)
+ if (openingElName !== 'Tooltip') {
+ return
+ }
+ const ariaLabel = getJSXOpeningElementAttribute(node, 'aria-label')
+ if (ariaLabel !== undefined) {
+ context.report({
+ node,
+ messageId: 'useTextProp',
+ fix(fixer) {
+ return fixer.replaceText(ariaLabel.name, 'text')
+ },
+ })
+ }
+ const noDelay = getJSXOpeningElementAttribute(node, 'noDelay')
+ if (noDelay !== undefined) {
+ context.report({
+ node,
+ messageId: 'noDelayRemoved',
+ fix(fixer) {
+ return fixer.remove(noDelay)
+ },
+ })
+ }
+ const wrap = getJSXOpeningElementAttribute(node, 'wrap')
+ if (wrap !== undefined) {
+ context.report({
+ node,
+ messageId: 'wrapRemoved',
+ fix(fixer) {
+ return fixer.remove(wrap)
+ },
+ })
+ }
+ const align = getJSXOpeningElementAttribute(node, 'align')
+ if (align !== undefined) {
+ context.report({
+ node,
+ messageId: 'alignRemoved',
+ fix(fixer) {
+ return fixer.remove(align)
+ },
+ })
+ }
+ },
+ }
+ },
+}
diff --git a/src/rules/a11y-use-next-tooltip.js b/src/rules/a11y-use-next-tooltip.js
deleted file mode 100644
index ab1a6e3c..00000000
--- a/src/rules/a11y-use-next-tooltip.js
+++ /dev/null
@@ -1,128 +0,0 @@
-'use strict'
-const url = require('../url')
-const {getJSXOpeningElementAttribute} = require('../utils/get-jsx-opening-element-attribute')
-const {getJSXOpeningElementName} = require('../utils/get-jsx-opening-element-name')
-
-module.exports = {
- meta: {
- type: 'suggestion',
- docs: {
- description: 'recommends the use of @primer/react/next Tooltip component',
- category: 'Best Practices',
- recommended: true,
- url: url(module),
- },
- fixable: true,
- schema: [],
- messages: {
- useNextTooltip: 'Please use @primer/react/next Tooltip component that has accessibility improvements',
- useTextProp: 'Please use the text prop instead of aria-label',
- noDelayRemoved: 'noDelay prop is removed. Tooltip now has no delay by default',
- wrapRemoved: 'wrap prop is removed. Tooltip now wraps by default',
- alignRemoved: 'align prop is removed. Please use the direction prop instead.',
- },
- },
- create(context) {
- return {
- ImportDeclaration(node) {
- if (node.source.value !== '@primer/react') {
- return
- }
- const hasTooltip = node.specifiers.some(
- specifier => specifier.imported && specifier.imported.name === 'Tooltip',
- )
-
- const hasOtherImports = node.specifiers.length > 1
- if (!hasTooltip) {
- return
- }
- context.report({
- node,
- messageId: 'useNextTooltip',
- fix(fixer) {
- // If Tooltip is the only import, replace the whole import statement
- if (!hasOtherImports) {
- return fixer.replaceText(node.source, `'@primer/react/next'`)
- } else {
- // Otherwise, remove Tooltip from the import statement and add a new import statement with the correct path
- const tooltipSpecifier = node.specifiers.find(
- specifier => specifier.imported && specifier.imported.name === 'Tooltip',
- )
-
- const tokensToRemove = [' ', ',']
- const tooltipIsFirstImport = tooltipSpecifier === node.specifiers[0]
- const tooltipIsLastImport = tooltipSpecifier === node.specifiers[node.specifiers.length - 1]
- const tooltipIsNotFirstOrLastImport = !tooltipIsFirstImport && !tooltipIsLastImport
-
- const sourceCode = context.getSourceCode()
- const canRemoveBefore = tooltipIsNotFirstOrLastImport
- ? false
- : tokensToRemove.includes(sourceCode.getTokenBefore(tooltipSpecifier).value)
- const canRemoveAfter = tokensToRemove.includes(sourceCode.getTokenAfter(tooltipSpecifier).value)
- const start = canRemoveBefore
- ? sourceCode.getTokenBefore(tooltipSpecifier).range[0]
- : tooltipSpecifier.range[0]
- const end = canRemoveAfter
- ? sourceCode.getTokenAfter(tooltipSpecifier).range[1] + 1
- : tooltipSpecifier.range[1]
- return [
- // remove tooltip specifier and the space and comma after it
- fixer.removeRange([start, end]),
- fixer.insertTextAfterRange(
- [node.range[1], node.range[1]],
- `\nimport {Tooltip} from '@primer/react/next';`,
- ),
- ]
- }
- },
- })
- },
- JSXOpeningElement(node) {
- const openingElName = getJSXOpeningElementName(node)
- if (openingElName !== 'Tooltip') {
- return
- }
- const ariaLabel = getJSXOpeningElementAttribute(node, 'aria-label')
- if (ariaLabel !== undefined) {
- context.report({
- node,
- messageId: 'useTextProp',
- fix(fixer) {
- return fixer.replaceText(ariaLabel.name, 'text')
- },
- })
- }
- const noDelay = getJSXOpeningElementAttribute(node, 'noDelay')
- if (noDelay !== undefined) {
- context.report({
- node,
- messageId: 'noDelayRemoved',
- fix(fixer) {
- return fixer.remove(noDelay)
- },
- })
- }
- const wrap = getJSXOpeningElementAttribute(node, 'wrap')
- if (wrap !== undefined) {
- context.report({
- node,
- messageId: 'wrapRemoved',
- fix(fixer) {
- return fixer.remove(wrap)
- },
- })
- }
- const align = getJSXOpeningElementAttribute(node, 'align')
- if (align !== undefined) {
- context.report({
- node,
- messageId: 'alignRemoved',
- fix(fixer) {
- return fixer.remove(align)
- },
- })
- }
- },
- }
- },
-}