Updates to work with ESLint 9

.github/dependabot.yml

@@ -0,0 +1,12 @@
+version: 2
+updates:
+- package-ecosystem: npm
+  directory: "/"
+  schedule:
+    interval: weekly
+  open-pull-requests-limit: 10
+  versioning-strategy: increase-if-necessary
+- package-ecosystem: github-actions
+  directory: "/"
+  schedule:
+    interval: weekly

.github/workflows/test.yml

@@ -15,6 +15,6 @@ jobs:
       - uses: actions/checkout@v2
       - uses: actions/setup-node@v2
         with:
-          node-version: '16'
+          node-version: '22'
       - run: npm ci
       - run: npm test

eslint.config.js

@@ -0,0 +1,3 @@
+import react from './react.js';
+
+export default [...react];

examples/base/eslint.config.js

@@ -0,0 +1,3 @@
+import base from '../../index.js';
+
+export default [...base];

examples/base/main.js

@@ -1,10 +1,14 @@
-import name from './dep.js';
+import {readFile} from 'fs/promises';
 import {dirname, join} from 'path';
 import {fileURLToPath} from 'url';
-import {readFile} from 'fs/promises';
+import name from './dep.js';
 
 const __dirname = dirname(fileURLToPath(import.meta.url));
 
+/**
+ * @param {Array<string>} paths A list of paths.
+ * @return {Promise<Array<string>>} A promise for the content of the files.
+ */
 function main(paths) {
   const promises = paths.map(async (name) => {
     const data = await readFile(name);

examples/react/Message.js → examples/react/Message.jsx

@@ -1,6 +1,15 @@
-import React from 'react';
 import {string} from 'prop-types';
+import React from 'react';
+
+/**
+ * @typedef {object} MessageProps
+ * @property {string} name The name.
+ */
 
+/**
+ * @param {MessageProps} props The props.
+ * @return {React.JSX.Element} The element.
+ */
 function Message({name}) {
   return <div>Hello, {name}!</div>;
 }

examples/react/component.jsx

@@ -0,0 +1,6 @@
+import React from 'react';
+import {createRoot} from 'react-dom/client';
+import Message from './Message.jsx';
+
+const root = createRoot(document.getElementById('root'));
+root.render(<Message name="John" />);

examples/react/eslint.config.js

@@ -0,0 +1,3 @@
+import react from '../../react.js';
+
+export default [...react];

index.js

@@ -0,0 +1,146 @@
+import importPlugin from 'eslint-plugin-import';
+import jsdoc from 'eslint-plugin-jsdoc';
+import eslintPluginPrettierRecommended from 'eslint-plugin-prettier/recommended';
+import globals from 'globals';
+
+export default [
+  importPlugin.flatConfigs.recommended,
+  jsdoc.configs['flat/recommended'],
+  eslintPluginPrettierRecommended,
+  {
+    languageOptions: {
+      globals: {
+        ...globals.node,
+        ...globals.browser,
+      },
+
+      ecmaVersion: 'latest',
+      sourceType: 'module',
+    },
+
+    settings: {
+      jsdoc: {
+        mode: 'typescript',
+        preferredTypes: {
+          '[]': 'Array<>',
+          '.<>': '<>',
+        },
+        tagNamePreference: {
+          returns: 'return',
+          file: 'fileoverview',
+          constant: 'const',
+          augments: 'extends',
+        },
+      },
+    },
+
+    rules: {
+      'block-scoped-var': 'error',
+      'curly': 'error',
+      'default-case': 'error',
+      'import/no-unresolved': [
+        'error',
+        {
+          commonjs: true,
+        },
+      ],
+      'import/order': [
+        'error',
+        {
+          named: true,
+          alphabetize: {
+            order: 'asc',
+          },
+        },
+      ],
+      'import/no-duplicates': 'error',
+      'import/named': 'error',
+      'import/default': 'error',
+      'import/extensions': [
+        'error',
+        'always',
+        {
+          ignorePackages: true,
+        },
+      ],
+      'jsdoc/check-access': 'error',
+      'jsdoc/check-alignment': 'error',
+      'jsdoc/check-param-names': 'error',
+      'jsdoc/check-property-names': 'error',
+      'jsdoc/check-syntax': 'error',
+      'jsdoc/check-tag-names': [
+        'error',
+        {
+          definedTags: ['api', 'observable'],
+        },
+      ],
+      'jsdoc/check-types': 'error',
+      'jsdoc/empty-tags': 'error',
+      'jsdoc/implements-on-classes': 'error',
+      'jsdoc/no-bad-blocks': 'error',
+      'jsdoc/require-hyphen-before-param-description': ['error', 'never'],
+      'jsdoc/require-param': 'error',
+      'jsdoc/require-param-description': 'error',
+      'jsdoc/require-param-name': 'error',
+      'jsdoc/require-param-type': 'error',
+      'jsdoc/require-property': 'error',
+      'jsdoc/require-property-description': 'error',
+      'jsdoc/require-property-name': 'error',
+      'jsdoc/require-property-type': 'error',
+      'jsdoc/require-returns': 'error',
+      'jsdoc/require-returns-check': 'error',
+      'jsdoc/require-returns-description': 'error',
+      'jsdoc/require-returns-type': 'error',
+      'no-cond-assign': 'error',
+      'no-console': 'error',
+      'no-const-assign': 'error',
+      'no-control-regex': 'error',
+      'no-debugger': 'error',
+      'no-delete-var': 'error',
+      'no-dupe-args': 'error',
+      'no-dupe-class-members': 'error',
+      'no-dupe-keys': 'error',
+      'no-duplicate-case': 'error',
+      'no-empty': 'error',
+      'no-empty-character-class': 'error',
+      'no-eq-null': 'error',
+      'no-ex-assign': 'error',
+      'no-extra-boolean-cast': 'error',
+      'no-fallthrough': 'error',
+      'no-func-assign': 'error',
+      'no-inner-declarations': ['error', 'functions'],
+      'no-invalid-regexp': 'error',
+      'no-irregular-whitespace': 'error',
+      'no-multi-assign': 'error',
+      'no-negated-in-lhs': 'error',
+      'no-obj-calls': 'error',
+      'no-octal': 'error',
+      'no-redeclare': 'error',
+      'no-regex-spaces': 'error',
+      'no-sparse-arrays': 'error',
+      'no-this-before-super': 'error',
+      'no-undef': 'error',
+      'no-unreachable': 'error',
+      'no-unused-vars': [
+        'error',
+        {
+          vars: 'all',
+          args: 'none',
+        },
+      ],
+      'no-use-before-define': ['error', 'nofunc'],
+      'no-var': 'error',
+      'prefer-const': 'error',
+      'prettier/prettier': [
+        'error',
+        {
+          singleQuote: true,
+          bracketSpacing: false,
+          quoteProps: 'preserve',
+        },
+      ],
+      'use-isnan': 'error',
+      'valid-typeof': 'error',
+    },
+  },
+];