ESLint changes preparing for Prettier (#2153)

Switch from StandardJS to ESLint using flat configuration.
Add Prettier and configuration.

Author: shadowspawn

.eslintrc.js

@@ -6,9 +6,9 @@ and can be deleted.
 
 Please submit pull requests against the develop branch.
 
-Follow the existing code style. Check the tests succeed, including lint.
+Follow the existing code style. Check the tests succeed, including format and lint.
   npm run test
-  npm run lint
+  npm run check
 
 Don't update the CHANGELOG or command version number. That gets done by maintainers when preparing the release.
 

.github/PULL_REQUEST_TEMPLATE.md

@@ -27,5 +27,6 @@ jobs:
       run: npm ci
     - name: npm test
       run: npm test
-    - name: npm run lint
-      run: npm run lint
+    - name: npm run check:lint
+      # switch to full check when have run prettier on all files
+      run: npm run check:lint

.github/workflows/tests.yml

@@ -0,0 +1,10 @@
+# exclude everything, and opt-in to types we want to format
+**.*
+# add the filetypes we want to format
+!**.js
+!**.mjs
+!**.cjs
+!**.ts
+!**.mts
+!**.cts
+!**.json

.prettierignore

@@ -0,0 +1,12 @@
+const config = {
+  // plugins: ['prettier-plugin-jsdoc'],
+  singleQuote: true,
+  overrides: [
+    {
+      files: ['tsconfig*.json'],
+      options: { parser: 'jsonc' },
+    },
+  ],
+};
+
+module.exports = config;

.prettierrc.js

@@ -14,10 +14,10 @@ or after six months otherwise.
 
 Pull Requests will be considered. Please submit pull requests against the develop branch.
 
-Follow the existing code style. Check the tests succeed, including lint.
+Follow the existing code style. Check the tests succeed, including format and lint.
 
 - `npm run test`
-- `npm run lint`
+- `npm run check`
 
 Don't update the CHANGELOG or command version number. That gets done by maintainers when preparing the release.
 

CONTRIBUTING.md

@@ -0,0 +1,75 @@
+const globals = require('globals');
+const esLintjs = require('@eslint/js');
+const jest = require('eslint-plugin-jest');
+const tseslint = require('typescript-eslint');
+const prettier = require('eslint-config-prettier');
+//const jsdoc = require('eslint-plugin-jsdoc');
+
+// Using tseslint config helper to customise its setup the tseslint way.
+const tsconfigTsFiles = ['**/*.{ts,mts}']; // match "include" in tsconfig.ts.json;
+const tsconfigJsFiles = ['*.{js,mjs}', 'lib/**/*.{js,mjs}']; // match "include" in tsconfig.js.json
+const tseslintConfigs = tseslint.config(
+  {
+    files: tsconfigJsFiles,
+    languageOptions: {
+      parserOptions: { project: './tsconfig.js.json' },
+    },
+    extends: [
+      ...tseslint.configs.recommended,
+    ],
+    rules: {
+      '@typescript-eslint/no-var-requires': 'off', // (tseslint does not autodetect commonjs context )
+    },
+  }, {
+    files: tsconfigTsFiles,
+    languageOptions: {
+      parserOptions: { project: './tsconfig.ts.json' },
+    },
+    extends: [
+      ...tseslint.configs.recommended,
+    ],
+  },
+);
+
+module.exports = [
+  esLintjs.configs.recommended,
+  // jsdoc.configs['flat/recommended'],
+  jest.configs['flat/recommended'],
+  ...tseslintConfigs,
+  prettier, // Do Prettier last so it can override previous configs.
+
+  // Customise rules.
+  {
+    files: ['**/*.{js,mjs,cjs}', '**/*.{ts,mts,cts}'],
+    rules: {
+      'no-else-return': ['error', { allowElseIf: false }],
+
+      // 'jsdoc/tag-lines': 'off',
+      // 'jsdoc/require-jsdoc': 'off',
+      // 'jsdoc/require-param-description': 'off',
+      // 'jsdoc/require-returns-description': 'off',
+    },
+    languageOptions: {
+      globals: {
+        ...globals.node,
+      },
+    },
+  },
+  {
+    files: ['**/*.test.{js,mjs,cjs}'],
+    rules: {
+      'no-unused-vars': 'off', // lots in tests, minimise churn for now
+    }
+  },
+  {
+    files: [...tsconfigTsFiles, ...tsconfigJsFiles],
+    rules: {
+      '@typescript-eslint/ban-ts-comment': ['error', {
+        'ts-expect-error': 'allow-with-description',
+        'ts-ignore': 'allow-with-description',
+        'ts-nocheck': true,
+        'ts-check': true,
+    }],
+    },
+  },
+];

eslint.config.js

@@ -7,7 +7,7 @@
 const commander = require('commander');
 const program = new commander.Command();
 
-function myParseInt(value, dummyPrevious) {
+function myParseInt(value) {
   // parseInt takes a string and a radix
   const parsedValue = parseInt(value, 10);
   if (isNaN(parsedValue)) {

examples/arguments-custom-processing.js

@@ -10,14 +10,14 @@ class CommandWithTrace extends commander.Command {
     cmd.option('-t, --trace', 'display extra information when run command');
     return cmd;
   }
-};
+}
 
 function inpectCommand(command) {
   // The option value is stored as property on command because we called .storeOptionsAsProperties()
   console.log(`Called '${command.name()}'`);
   console.log(`args: ${command.args}`);
   console.log('opts: %o', command.opts());
-};
+}
 
 const program = new CommandWithTrace('program')
   .option('-v, ---verbose')

examples/custom-command-class.js

@@ -7,7 +7,7 @@
 const commander = require('commander');
 const program = new commander.Command();
 
-function myParseInt(value, dummyPrevious) {
+function myParseInt(value) {
   // parseInt takes a string and a radix
   const parsedValue = parseInt(value, 10);
   if (isNaN(parsedValue)) {
@@ -24,7 +24,7 @@ function collect(value, previous) {
   return previous.concat([value]);
 }
 
-function commaSeparatedList(value, dummyPrevious) {
+function commaSeparatedList(value) {
   return value.split(',');
 }