Add rules for Annex B (#22)

* Add rules for legacy

* Add no-escape-unescape

* Add no-string-prototype-substr rule

* Add no-string-create-html-methods rule

* Add no-string-prototype-trimleft-trimright rule

* Support for suggest

* Add no-date-prototype-getyear-setyear rule

* Add no-date-prototype-togmtstring

* Add no-regexp-prototype-compile

* Add no-labelled-function-declarations

* Add no-function-declarations-in-if-statement-clauses-without-block

* Support autofix

* Add no-shadow-catch-param

* Add no-initializers-in-for-in

* fix test

* fix tests

* fix test

* fix test

* update test for eslint v4

Author: ota-meshi

docs/.vuepress/components/eslint-playground.vue

@@ -31,6 +31,10 @@ export default {
                 return value === "bad" || value === "good"
             },
         },
+        sourceType: {
+            type: String,
+            default: undefined,
+        },
     },
 
     data() {
@@ -73,7 +77,7 @@ export default {
                 rules: {},
                 parserOptions: {
                     ecmaVersion: 2022,
-                    sourceType: "module",
+                    sourceType: this.sourceType || "module",
                 },
                 settings: {
                     "es-x": { aggressive: true },

docs/.vuepress/config.js

@@ -29,16 +29,16 @@ module.exports = {
         sidebar: [
             "/",
             "/rules/",
-            ...Object.keys(categories)
+            ...Object.values(categories)
+                .filter((menu) => menu.rules.length)
                 .map((category) => ({
-                    title: category,
+                    title: category.title,
                     collapsable: false,
-                    children: categories[category].rules.map(({ ruleId }) => [
+                    children: category.rules.map(({ ruleId }) => [
                         `/rules/${ruleId}`,
                         `es-x/${ruleId}`,
                     ]),
-                }))
-                .filter((menu) => menu.children.length),
+                })),
         ],
     },
 }

docs/rules/README.md

@@ -4,14 +4,6 @@ This plugin provides the following rules.
 
 - 🔧 mark means that the `--fix` option on the [command line](https://eslint.org/docs/user-guide/command-line-interface#fixing-problems) can automatically fix some of the problems reported by the rule.
 
-## ES2023
-
-There is a config that enables the rules in this category: `plugin:es-x/no-new-in-esnext`
-
-| Rule ID | Description |    |
-|:--------|:------------|:--:|
-|  | Now there are no rules. |  |
-
 ## ES2022
 
 There are multiple configs that enable all rules in this category: `plugin:es-x/no-new-in-es2022`, `plugin:es-x/restrict-to-es3`, `plugin:es-x/restrict-to-es5`, `plugin:es-x/restrict-to-es2015`, `plugin:es-x/restrict-to-es2016`, `plugin:es-x/restrict-to-es2017`, `plugin:es-x/restrict-to-es2018`, `plugin:es-x/restrict-to-es2019`, `plugin:es-x/restrict-to-es2020`, and `plugin:es-x/restrict-to-es2021`
@@ -231,3 +223,22 @@ There are multiple configs that enable all rules in this category: `plugin:es-x/
 | [es-x/no-string-prototype-trim](./no-string-prototype-trim.md) | disallow the `String.prototype.trim` method. |  |
 | [es-x/no-trailing-commas](./no-trailing-commas.md) | disallow trailing commas in array/object literals. |  |
 
+## Legacy
+
+Rules in this category disallow the syntax contained in [Annex B](https://tc39.es/ecma262/multipage/additional-ecmascript-features-for-web-browsers.html) or Legacy.  
+The rules are not included in any preset.
+
+| Rule ID | Description |    |
+|:--------|:------------|:--:|
+| [es-x/no-date-prototype-getyear-setyear](./no-date-prototype-getyear-setyear.md) | disallow the `Date.prototype.{getYear,setYear}` methods. |  |
+| [es-x/no-date-prototype-togmtstring](./no-date-prototype-togmtstring.md) | disallow the `Date.prototype.toGMTString` method. | 🔧 |
+| [es-x/no-escape-unescape](./no-escape-unescape.md) | disallow `escape` and `unescape`. |  |
+| [es-x/no-function-declarations-in-if-statement-clauses-without-block](./no-function-declarations-in-if-statement-clauses-without-block.md) | disallow function declarations in if statement clauses without using blocks. | 🔧 |
+| [es-x/no-initializers-in-for-in](./no-initializers-in-for-in.md) | disallow initializers in for-in heads. |  |
+| [es-x/no-labelled-function-declarations](./no-labelled-function-declarations.md) | disallow labelled function declarations. |  |
+| [es-x/no-regexp-prototype-compile](./no-regexp-prototype-compile.md) | disallow the `RegExp.prototype.compile` method. |  |
+| [es-x/no-shadow-catch-param](./no-shadow-catch-param.md) | disallow identifiers from shadowing catch parameter names. |  |
+| [es-x/no-string-create-html-methods](./no-string-create-html-methods.md) | disallow HTML creation methods of string instances. |  |
+| [es-x/no-string-prototype-substr](./no-string-prototype-substr.md) | disallow the `String.prototype.substr` method. |  |
+| [es-x/no-string-prototype-trimleft-trimright](./no-string-prototype-trimleft-trimright.md) | disallow the `String.prototype.{trimLeft,trimRight}` methods. | 🔧 |
+

docs/rules/no-date-prototype-getyear-setyear.md

@@ -0,0 +1,34 @@
+# es-x/no-date-prototype-getyear-setyear
+> disallow the `Date.prototype.{getYear,setYear}` methods
+
+This rule reports Annex B feature `Date.prototype.{getYear,setYear}` methods as errors.
+
+This rule is silent by default because it's hard to know types. You need to configure [the aggressive mode](../#the-aggressive-mode) or TypeScript in order to enable this rule.
+
+## 💡 Examples
+
+⛔ Examples of **incorrect** code for this rule:
+
+<eslint-playground type="bad" code="/*eslint es-x/no-date-prototype-getyear-setyear: [error, { aggressive: true }] */
+foo.getYear()
+foo.setYear(99)
+" />
+
+## 🔧 Options
+
+This rule has an option.
+
+```yml
+rules:
+  es-x/no-date-prototype-getyear-setyear: [error, { aggressive: false }]
+```
+
+### aggressive: boolean
+
+Configure the aggressive mode for only this rule.
+This is prior to the `settings['es-x'].aggressive` setting.
+
+## 📚 References
+
+- [Rule source](https://github.com/ota-meshi/eslint-plugin-es-x/blob/master/lib/rules/no-date-prototype-getyear-setyear.js)
+- [Test source](https://github.com/ota-meshi/eslint-plugin-es-x/blob/master/tests/lib/rules/no-date-prototype-getyear-setyear.js)

docs/rules/no-date-prototype-togmtstring.md

@@ -0,0 +1,35 @@
+# es-x/no-date-prototype-togmtstring
+> disallow the `Date.prototype.toGMTString` method
+
+- 🔧 The `--fix` option on the [command line](https://eslint.org/docs/user-guide/command-line-interface#fixing-problems) can automatically fix some of the problems reported by this rule.
+
+This rule reports Annex B feature `Date.prototype.toGMTString` method as errors.
+
+This rule is silent by default because it's hard to know types. You need to configure [the aggressive mode](../#the-aggressive-mode) or TypeScript in order to enable this rule.
+
+## 💡 Examples
+
+⛔ Examples of **incorrect** code for this rule:
+
+<eslint-playground type="bad" code="/*eslint es-x/no-date-prototype-togmtstring: [error, { aggressive: true }] */
+foo.toGMTString()
+" />
+
+## 🔧 Options
+
+This rule has an option.
+
+```yml
+rules:
+  es-x/no-date-prototype-togmtstring: [error, { aggressive: false }]
+```
+
+### aggressive: boolean
+
+Configure the aggressive mode for only this rule.
+This is prior to the `settings['es-x'].aggressive` setting.
+
+## 📚 References
+
+- [Rule source](https://github.com/ota-meshi/eslint-plugin-es-x/blob/master/lib/rules/no-date-prototype-togmtstring.js)
+- [Test source](https://github.com/ota-meshi/eslint-plugin-es-x/blob/master/tests/lib/rules/no-date-prototype-togmtstring.js)

docs/rules/no-escape-unescape.md

@@ -0,0 +1,18 @@
+# es-x/no-escape-unescape
+> disallow `escape` and `unescape`
+
+This rule reports Annex B feature `escape` and `unescape` as errors.
+
+## Examples
+
+⛔ Examples of **incorrect** code for this rule:
+
+<eslint-playground type="bad" code="/*eslint es-x/no-escape-unescape: error */
+escape('%&')
+unescape('%25%26')
+" />
+
+## 📚 References
+
+- [Rule source](https://github.com/ota-meshi/eslint-plugin-es-x/blob/master/lib/rules/no-escape-unescape.js)
+- [Test source](https://github.com/ota-meshi/eslint-plugin-es-x/blob/master/tests/lib/rules/no-escape-unescape.js)

docs/rules/no-function-declarations-in-if-statement-clauses-without-block.md

@@ -0,0 +1,22 @@
+# es-x/no-function-declarations-in-if-statement-clauses-without-block
+> disallow function declarations in if statement clauses without using blocks
+
+- 🔧 The `--fix` option on the [command line](https://eslint.org/docs/user-guide/command-line-interface#fixing-problems) can automatically fix some of the problems reported by this rule.
+
+This rule reports Annex B feature [the function declarations in if statement clauses without using blocks](https://tc39.es/ecma262/multipage/additional-ecmascript-features-for-web-browsers.html#sec-functiondeclarations-in-ifstatement-statement-clauses) as errors.
+
+## Examples
+
+⛔ Examples of **incorrect** code for this rule:
+
+<eslint-playground type="bad" source-type="script" code="/*eslint es-x/no-function-declarations-in-if-statement-clauses-without-block: error */
+if (a)
+  function f1() {}
+else
+  function f2() {}
+" />
+
+## 📚 References
+
+- [Rule source](https://github.com/ota-meshi/eslint-plugin-es-x/blob/master/lib/rules/no-function-declarations-in-if-statement-clauses-without-block.js)
+- [Test source](https://github.com/ota-meshi/eslint-plugin-es-x/blob/master/tests/lib/rules/no-function-declarations-in-if-statement-clauses-without-block.js)

docs/rules/no-initializers-in-for-in.md

@@ -0,0 +1,19 @@
+# es-x/no-initializers-in-for-in
+> disallow initializers in for-in heads
+
+This rule reports initializers in for-in statement heads as errors.
+
+See [Annex B - Initializers in ForIn Statement Heads](https://tc39.es/ecma262/multipage/additional-ecmascript-features-for-web-browsers.html#sec-initializers-in-forin-statement-heads).
+
+## Examples
+
+⛔ Examples of **incorrect** code for this rule:
+
+<eslint-playground type="bad" source-type="script" code="/*eslint es-x/no-initializers-in-for-in: error */
+for (var x = 42 in obj) { /**/ }
+" />
+
+## 📚 References
+
+- [Rule source](https://github.com/ota-meshi/eslint-plugin-es-x/blob/master/lib/rules/no-initializers-in-for-in.js)
+- [Test source](https://github.com/ota-meshi/eslint-plugin-es-x/blob/master/tests/lib/rules/no-initializers-in-for-in.js)

docs/rules/no-labelled-function-declarations.md

@@ -0,0 +1,17 @@
+# es-x/no-labelled-function-declarations
+> disallow labelled function declarations
+
+This rule reports Annex B feature [the labelled function declarations](https://tc39.es/ecma262/multipage/additional-ecmascript-features-for-web-browsers.html#sec-labelled-function-declarations) as errors.
+
+## Examples
+
+⛔ Examples of **incorrect** code for this rule:
+
+<eslint-playground type="bad" source-type="script" code="/*eslint es-x/no-labelled-function-declarations: error */
+label: function f() {}
+" />
+
+## 📚 References
+
+- [Rule source](https://github.com/ota-meshi/eslint-plugin-es-x/blob/master/lib/rules/no-labelled-function-declarations.js)
+- [Test source](https://github.com/ota-meshi/eslint-plugin-es-x/blob/master/tests/lib/rules/no-labelled-function-declarations.js)

docs/rules/no-regexp-prototype-compile.md

@@ -0,0 +1,33 @@
+# es-x/no-regexp-prototype-compile
+> disallow the `RegExp.prototype.compile` method
+
+This rule reports Annex B feature `RegExp.prototype.compile` method as errors.
+
+This rule is silent by default because it's hard to know types. You need to configure [the aggressive mode](../#the-aggressive-mode) or TypeScript in order to enable this rule.
+
+## 💡 Examples
+
+⛔ Examples of **incorrect** code for this rule:
+
+<eslint-playground type="bad" code="/*eslint es-x/no-regexp-prototype-compile: [error, { aggressive: true }] */
+foo.compile()
+" />
+
+## 🔧 Options
+
+This rule has an option.
+
+```yml
+rules:
+  es-x/no-regexp-prototype-compile: [error, { aggressive: false }]
+```
+
+### aggressive: boolean
+
+Configure the aggressive mode for only this rule.
+This is prior to the `settings['es-x'].aggressive` setting.
+
+## 📚 References
+
+- [Rule source](https://github.com/ota-meshi/eslint-plugin-es-x/blob/master/lib/rules/no-regexp-prototype-compile.js)
+- [Test source](https://github.com/ota-meshi/eslint-plugin-es-x/blob/master/tests/lib/rules/no-regexp-prototype-compile.js)