feat: disable lines-around-comment for type definitions

- waiting on typescript-eslint/typescript-eslint#5327

stack/eslint-config/.eslintrc.js

@@ -5,5 +5,13 @@ module.exports = {
     "@rushstack/eslint-config/mixins/friendly-locals",
     "@rushstack/eslint-config/profile/web-app",
     "./profile/node.js"
+  ],
+  overrides: [
+    {
+      files: ["profile/*.js"],
+      rules: {
+        "lines-around-comment": "off"
+      }
+    }
   ]
 }

stack/eslint-config/overrides/index.js

@@ -3,5 +3,6 @@ module.exports = {
   barrels: require("./barrels"),
   javascript: require("./javascript"),
   markdown: require("./markdown"),
+  typeDefinitions: require("./type-definitions"),
   typescript: require("./typescript")
 }

stack/eslint-config/overrides/type-definitions.js

@@ -0,0 +1,6 @@
+module.exports = {
+  files: ["**/types/*.ts", "**/types.ts"],
+  rules: {
+    "lines-around-comment": "off"
+  }
+}

stack/eslint-config/profile/node.js

@@ -14,28 +14,33 @@ const {
   barrels,
   javascript,
   markdown,
+  typeDefinitions,
   typescript
 } = require("../overrides")
 
 const { when } = require("../utils")
 
 /**
- * Node Eslint Config
+ * NodeJS ESLint profile.
+ *
+ * @remarks
+ * This profile is intended for use within NodeJS applications.
+ * Rules may not be appropriate for browser applications.
  *
  * @public
  */
 module.exports = {
-  // Environment linter should expect.
+  /* Environment linter should expect. */
   env: {
     node: true
   },
-  // List of patterns to ignore.
+  /* List of patterns to ignore. */
   ignorePatterns,
-  // Default parser options for TypeScript.
+  /* Default parser options for TypeScript. */
   parserOptions,
-  // Third-party plugins to load.
+  /* Third-party plugins to load. */
   plugins,
-  // Main rules definitions across all included files.
+  /* Main rule definitions used across all matched files. */
   rules: {
     "@rushstack/no-new-null": "off",
     "@typescript-eslint/member-ordering": "error",
@@ -58,6 +63,13 @@ module.exports = {
     "simple-import-sort/imports": ["error", simpleImportSort],
     "tsdoc/syntax": "error"
   },
-  // Pattern specific overrides.
-  overrides: [anyInTypes, barrels, javascript, markdown, typescript]
+  /* Pattern specific overrides. */
+  overrides: [
+    anyInTypes,
+    barrels,
+    javascript,
+    markdown,
+    typeDefinitions,
+    typescript
+  ]
 }

stack/eslint-config/rules/lines-around-comment.js

@@ -1,7 +1,7 @@
 module.exports = {
   beforeBlockComment: true,
   afterBlockComment: false,
-  beforeLineComment: false,
+  beforeLineComment: true,
   afterLineComment: false,
   allowBlockStart: true,
   allowClassStart: true,