Add no-hashbang rule (#33)

Author: ota-meshi

docs/rules/README.md

@@ -4,6 +4,14 @@ 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 |    |
+|:--------|:------------|:--:|
+| [es-x/no-hashbang](./no-hashbang.md) | disallow Hashbang comments. |  |
+
 ## 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`

docs/rules/no-hashbang.md

@@ -0,0 +1,30 @@
+---
+title: "es-x/no-hashbang"
+description: "disallow Hashbang comments"
+---
+
+# es-x/no-hashbang
+> disallow Hashbang comments
+
+- ❗ <badge text="This rule has not been released yet." vertical="middle" type="error"> ***This rule has not been released yet.*** </badge>
+- ✅ The following configurations enable this rule: `plugin:es-x/no-new-in-esnext`
+
+This rule reports ES2023 Hashbang comment as errors.
+
+## 💡 Examples
+
+⛔ Examples of **incorrect** code for this rule:
+
+<eslint-playground type="bad">
+
+```js
+#!/usr/bin/env node
+/*eslint es-x/no-hashbang: error */
+```
+
+</eslint-playground>
+
+## 📚 References
+
+- [Rule source](https://github.com/ota-meshi/eslint-plugin-es-x/blob/master/lib/rules/no-hashbang.js)
+- [Test source](https://github.com/ota-meshi/eslint-plugin-es-x/blob/master/tests/lib/rules/no-hashbang.js)

lib/configs/no-new-in-esnext.js

@@ -4,4 +4,4 @@
  */
 "use strict"
 
-module.exports = { plugins: ["es-x"], rules: {} }
+module.exports = { plugins: ["es-x"], rules: { "es-x/no-hashbang": "error" } }

lib/index.js

@@ -103,6 +103,7 @@ module.exports = {
         "no-function-prototype-bind": require("./rules/no-function-prototype-bind"),
         "no-generators": require("./rules/no-generators"),
         "no-global-this": require("./rules/no-global-this"),
+        "no-hashbang": require("./rules/no-hashbang"),
         "no-import-meta": require("./rules/no-import-meta"),
         "no-initializers-in-for-in": require("./rules/no-initializers-in-for-in"),
         "no-json": require("./rules/no-json"),

lib/rules/no-hashbang.js

@@ -0,0 +1,31 @@
+"use strict"
+
+module.exports = {
+    meta: {
+        docs: {
+            description: "disallow Hashbang comments.",
+            category: "ES2023",
+            recommended: false,
+            url: "http://ota-meshi.github.io/eslint-plugin-es-x/rules/no-hashbang.html",
+        },
+        fixable: null,
+        messages: {
+            forbidden: "ES2023 Hashbang comments are forbidden.",
+        },
+        schema: [],
+        type: "problem",
+    },
+    create(context) {
+        return {
+            Program() {
+                const firstComment = context.getSourceCode().ast.comments[0]
+                if (firstComment && firstComment.type === "Shebang") {
+                    context.report({
+                        node: firstComment,
+                        messageId: "forbidden",
+                    })
+                }
+            },
+        }
+    },
+}

tests/lib/rules/no-hashbang.js

@@ -0,0 +1,40 @@
+"use strict"
+
+const RuleTester = require("../../tester")
+const rule = require("../../../lib/rules/no-hashbang.js")
+
+if (!RuleTester.isSupported(2023)) {
+    //eslint-disable-next-line no-console
+    console.log("Skip the tests of no-hashbang.")
+    return
+}
+
+new RuleTester().run("no-hashbang", rule, {
+    valid: [
+        "/* comment */",
+        "/** comment */",
+        "// comment",
+        `call() /** comment */
+        // comment
+        `,
+    ],
+    invalid: [
+        {
+            code: `#!/usr/bin/env node
+            // in the Script Goal
+            'use strict';
+            console.log(1);
+            `,
+            errors: ["ES2023 Hashbang comments are forbidden."],
+        },
+        {
+            code: `#!/usr/bin/env node
+            // in the Module Goal
+            export {};
+            console.log(1);
+            `,
+            parserOptions: { sourceType: "module" },
+            errors: ["ES2023 Hashbang comments are forbidden."],
+        },
+    ],
+})

tests/tester.js

@@ -11,6 +11,7 @@ const semver = require("semver")
 const eslintVersion = new Linter().version
 const ecmaVersion =
     /*eslint-disable prettier/prettier */
+    semver.gte(eslintVersion, "8.23.0") ? 2023 :
     semver.gte(eslintVersion, "8.0.0") ? 2022 :
     semver.gte(eslintVersion, "7.8.0") ? 2021 :
     semver.gte(eslintVersion, "6.2.0") ? 2020 :