Deprecate prefer-exponentiation-operator rule

docs/rules/prefer-exponentiation-operator.md

@@ -1,5 +1,7 @@
 # Prefer the exponentiation operator over `Math.pow()`
 
+**This rule have been deprecated, please use [`prefer-exponentiation-operator`](https://eslint.org/docs/rules/prefer-exponentiation-operator) instead.**
+
 Enforces the use of the [exponentiation operator](http://2ality.com/2016/02/exponentiation-operator.html) over [`Math.pow()`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Math/pow).
 
 This rule is fixable.

readme.md

@@ -64,7 +64,6 @@ Configure it in `package.json`.
 			"unicorn/prefer-add-event-listener": "error",
 			"unicorn/prefer-dataset": "error",
 			"unicorn/prefer-event-key": "error",
-			"unicorn/prefer-exponentiation-operator": "error",
 			"unicorn/prefer-flat-map": "error",
 			"unicorn/prefer-includes": "error",
 			"unicorn/prefer-modern-dom-apis": "error",
@@ -118,7 +117,6 @@ Configure it in `package.json`.
 - [prefer-add-event-listener](docs/rules/prefer-add-event-listener.md) - Prefer `.addEventListener()` and `.removeEventListener()` over `on`-functions. *(partly fixable)*
 - [prefer-dataset](docs/rules/prefer-dataset.md) - Prefer using `.dataset` on DOM elements over `.setAttribute(…)`. *(fixable)*
 - [prefer-event-key](docs/rules/prefer-event-key.md) - Prefer `KeyboardEvent#key` over `KeyboardEvent#keyCode`. *(partly fixable)*
-- [prefer-exponentiation-operator](docs/rules/prefer-exponentiation-operator.md) - Prefer the exponentiation operator over `Math.pow()` *(fixable)*
 - [prefer-flat-map](docs/rules/prefer-flat-map.md) - Prefer `.flatMap(…)` over `.map(…).flat()`. *(fixable)*
 - [prefer-includes](docs/rules/prefer-includes.md) - Prefer `.includes()` over `.indexOf()` when checking for existence or non-existence. *(fixable)*
 - [prefer-modern-dom-apis](docs/rules/prefer-modern-dom-apis.md) - Prefer `.before()` over `.insertBefore()`, `.replaceWith()` over `.replaceChild()`, prefer one of `.before()`, `.after()`, `.append()` or `.prepend()` over `insertAdjacentText()` and `insertAdjacentElement()`. *(fixable)*
@@ -137,6 +135,11 @@ Configure it in `package.json`.
 - [regex-shorthand](docs/rules/regex-shorthand.md) - Enforce the use of regex shorthands to improve readability. *(fixable)*
 - [throw-new-error](docs/rules/throw-new-error.md) - Require `new` when throwing an error. *(fixable)*
 
+## Deprecated Rules
+
+|Deprecated rule|Replaced by|Rule Details|
+|:--|:--|:--|
+|[unicorn/prefer-exponentiation-operator](docs/rules/prefer-exponentiation-operator.md)|[prefer-exponentiation-operator](https://eslint.org/docs/rules/prefer-exponentiation-operator)|Prefer the exponentiation operator over `Math.pow()`|
 
 ## Recommended config
 

rules/prefer-exponentiation-operator.js

@@ -58,5 +58,9 @@ module.exports = {
 			url: getDocumentationUrl(__filename)
 		},
 		fixable: 'code'
-	}
+	},
+	deprecated: true,
+	replacedBy: [
+		'prefer-exponentiation-operator'
+	]
 };

test/package.js

@@ -15,6 +15,10 @@ const ignoredRules = [
 	'no-nested-ternary'
 ];
 
+const deprecatedRules = [
+	'prefer-exponentiation-operator'
+];
+
 const testSorted = (t, actualOrder, sourceName) => {
 	actualOrder = actualOrder.filter(x => !ignoredRules.includes(x));
 	const sortedOrder = actualOrder.slice(0).sort();
@@ -77,14 +81,17 @@ test('Every rule is defined in readme.md usage and list of rules in alphabetical
 		}
 	} while (match);
 
-	for (const file of ruleFiles) {
-		const name = path.basename(file, '.js');
+	const availableRules = ruleFiles
+		.map(file => path.basename(file, '.js'))
+		.filter(name => !deprecatedRules.includes(name));
+
+	for (const name of availableRules) {
 		t.truthy(usageRules[`unicorn/${name}`], `'${name}' is not described in the readme.md ## Usage`);
 		t.truthy(rules.includes(name), `'${name}' is not described in the readme.md ## Rules`);
 	}
 
-	t.is(Object.keys(usageRules).length - ignoredRules.length, ruleFiles.length, 'There are more rules in readme.md ## Usage than rule files.');
-	t.is(Object.keys(rules).length, ruleFiles.length, 'There are more rules in readme.md ## Rules than rule files.');
+	t.is(Object.keys(usageRules).length - ignoredRules.length, availableRules.length, 'There are more rules in readme.md ## Usage than rule files.');
+	t.is(Object.keys(rules).length, availableRules.length, 'There are more rules in readme.md ## Rules than rule files.');
 
 	testSorted(t, Object.keys(usageRules), 'readme.md ## Usage rules');
 	testSorted(t, rules, 'readme.md ## Rules');

test/prefer-exponentiation-operator.js

@@ -10,6 +10,11 @@ const ruleTester = avaRuleTester(test, {
 
 const message = 'Prefer the exponentiation operator over `Math.pow()`.';
 
+test('deprecated', t => {
+	t.true(rule.deprecated);
+	t.deepEqual(rule.replacedBy, ['prefer-exponentiation-operator']);
+});
+
 ruleTester.run('prefer-exponentiation-operator', rule, {
 	valid: [
 		'a ** b;',