eslint-config-cityssm 32.3.2 → 33.0.0

package/README.md

@@ -17,28 +17,26 @@ npm install --save-dev eslint-config-cityssm
 
 ## Simple Usage
 
-In the project's `eslint.config.js` file,
-it's as easy as one line.
+For web applications, export the default export.
 
 ```javascript
 export { default } from 'eslint-config-cityssm'
 ```
 
-For web applications, export `configWebApp` instead.
+For simpler packages, export the `packageConfig`.
 
 ```javascript
-export { configWebApp as default } from 'eslint-config-cityssm'
+export { default } from 'eslint-config-cityssm/packageConfig'
 ```
 
 ## Advanced Usage (TypeScript)
 
 ```typescript
-import {
+import default as configWebApp {
   type ConfigObject,
-  configWebApp,
-  cspellWords,
   defineConfig
 } from 'eslint-config-cityssm'
+import { cspellWords } from 'eslint-config-cityssm/exports'
 
 export const config: ConfigObject[] = defineConfig(configWebApp, {
   files: ['**/*.ts'],

package/eslint.config.d.ts

@@ -1,10 +1,8 @@
 import type { ConfigObject } from '@eslint/core';
+/**
+ * ESLint Configuration for Web Applications
+ */
 export declare const config: ConfigObject[];
-export declare const configWebApp: ConfigObject[];
-export { default as cspellFlagWords } from './lists/cspell.flagWords.js';
-export { default as cspellWords } from './lists/cspell.words.js';
-export { httpStatusCodes as noMagicNumbersHttpStatusCodes, default as noMagicNumbersIgnore } from './lists/noMagicNumbers.ignore.js';
-export { default as writeGoodCommentsWhitelist } from './lists/writeGoodComments.whitelist.js';
+export default config;
 export type { ConfigObject } from '@eslint/core';
 export { defineConfig } from 'eslint/config';
-export default config;

package/eslint.config.js

@@ -1,228 +1,16 @@
 // eslint-disable-next-line @eslint-community/eslint-comments/disable-enable-pair
-/* eslint-disable @cspell/spellchecker, @typescript-eslint/no-unsafe-assignment, @typescript-eslint/no-unsafe-member-access */
-import eslintCspellRecommended from '@cspell/eslint-plugin/recommended';
-import eslintPluginEslintComments from '@eslint-community/eslint-plugin-eslint-comments/configs';
+/* eslint-disable @typescript-eslint/no-unsafe-assignment */
 import eslintCss from '@eslint/css';
-import eslintJs from '@eslint/js';
-import eslintJson from '@eslint/json';
-import eslintMarkdown from '@eslint/markdown';
 import eslintHtml from '@html-eslint/eslint-plugin';
 import htmlParser from '@html-eslint/parser';
-import eslintConfigLove from 'eslint-config-love';
-import eslintPluginJsdoc from 'eslint-plugin-jsdoc';
-import eslintPluginNoSecrets from 'eslint-plugin-no-secrets';
 import eslintPluginNoUnsanitized from 'eslint-plugin-no-unsanitized';
-import eslintPluginPackageJson from 'eslint-plugin-package-json';
-import eslintPluginPerfectionist from 'eslint-plugin-perfectionist';
-import * as eslintPluginRegexp from 'eslint-plugin-regexp';
-import eslintPluginSecurity from 'eslint-plugin-security';
-import eslintPluginSonarJs from 'eslint-plugin-sonarjs';
-import eslintPluginUnicorn from 'eslint-plugin-unicorn';
-// import * as eslintPluginWoke from 'eslint-plugin-woke'
-import * as eslintPluginWriteGoodComments from 'eslint-plugin-write-good-comments';
 import { defineConfig } from 'eslint/config';
-import tseslint from 'typescript-eslint';
-import cspellFlagWords from './lists/cspell.flagWords.js';
-import cspellWords from './lists/cspell.words.js';
+import packageConfig from './eslint.packageConfig.js';
 import noMagicNumbers, { httpStatusCodes } from './lists/noMagicNumbers.ignore.js';
-import writeGoodCommentsWhitelist from './lists/writeGoodComments.whitelist.js';
-export const config = defineConfig({
-    linterOptions: {
-        reportUnusedDisableDirectives: 'error',
-        reportUnusedInlineConfigs: 'error'
-    }
-}, eslintPluginPackageJson.configs.recommended, {
-    extends: [
-        tseslint.configs.recommendedTypeChecked,
-        tseslint.configs.stylisticTypeChecked,
-        eslintJs.configs.recommended,
-        eslintCspellRecommended,
-        eslintPluginEslintComments.recommended,
-        eslintPluginJsdoc.configs['flat/recommended-typescript'],
-        eslintPluginPerfectionist.configs['recommended-natural'],
-        eslintPluginRegexp.configs['flat/recommended'],
-        eslintPluginSecurity.configs.recommended,
-        eslintPluginSonarJs.configs.recommended,
-        eslintPluginUnicorn.configs.recommended,
-        eslintConfigLove
-    ],
-    files: ['**/*.ts', '**/*.js'],
-    ignores: ['**/*.d.ts'],
-    languageOptions: {
-        parserOptions: {
-            ecmaFeatures: { modules: true },
-            ecmaVersion: 2022,
-            project: true,
-            sourceType: 'module'
-        }
-    },
-    plugins: {
-        'no-secrets': eslintPluginNoSecrets,
-        // sonarjs: eslintPluginSonarJs,
-        // unicorn: eslintPluginUnicorn,
-        // woke: eslintPluginWoke,
-        'write-good-comments': eslintPluginWriteGoodComments
-    },
-    rules: {
-        '@cspell/spellchecker': [
-            'warn',
-            {
-                cspell: {
-                    flagWords: cspellFlagWords,
-                    language: 'en-CA,en-US,en-GB',
-                    words: cspellWords
-                }
-            }
-        ],
-        '@typescript-eslint/init-declarations': 'warn',
-        '@typescript-eslint/no-magic-numbers': [
-            'warn',
-            {
-                ignore: noMagicNumbers
-            }
-        ],
-        '@typescript-eslint/no-misused-promises': 'warn',
-        '@typescript-eslint/no-non-null-assertion': 'warn',
-        '@typescript-eslint/no-unnecessary-type-assertion': 'off',
-        '@typescript-eslint/no-unsafe-argument': 'warn',
-        '@typescript-eslint/no-unsafe-assignment': 'warn',
-        '@typescript-eslint/no-unsafe-call': 'warn',
-        '@typescript-eslint/no-unsafe-member-access': 'warn',
-        '@typescript-eslint/no-unsafe-type-assertion': 'warn',
-        '@typescript-eslint/non-nullable-type-assertion-style': 'off',
-        '@typescript-eslint/prefer-destructuring': 'off',
-        '@typescript-eslint/restrict-plus-operands': 'warn',
-        '@typescript-eslint/space-before-function-paren': 'off',
-        '@typescript-eslint/strict-boolean-expressions': 'warn',
-        complexity: [
-            'warn',
-            {
-                max: 20
-            }
-        ],
-        'eslint-comments/require-description': 'off',
-        'jsdoc/require-jsdoc': ['warn', { publicOnly: true }],
-        'n/no-missing-import': 'off',
-        'no-extra-semi': 'off',
-        'no-param-reassign': ['error', { props: false }],
-        'no-redeclare': 'off',
-        'no-secrets/no-secrets': 'error',
-        'no-undef': 'off',
-        // checked by "@typescript-eslint/no-unused-vars"
-        'no-unused-vars': 'off',
-        'perfectionist/sort-imports': [
-            'error',
-            {
-                groups: [
-                    'builtin',
-                    ['external', 'internal-type', 'internal', 'type'],
-                    ['parent-type', 'parent'],
-                    ['sibling-type', 'sibling'],
-                    'unknown'
-                ],
-                partitionByNewLine: false
-            }
-        ],
-        'perfectionist/sort-interfaces': 'warn',
-        'perfectionist/sort-modules': 'warn',
-        'perfectionist/sort-named-exports': [
-            'error',
-            {
-                groupKind: 'types-first'
-            }
-        ],
-        'perfectionist/sort-named-imports': [
-            'error',
-            {
-                groupKind: 'types-first'
-            }
-        ],
-        'perfectionist/sort-object-types': 'warn',
-        'perfectionist/sort-objects': 'warn',
-        'perfectionist/sort-union-types': [
-            'error',
-            {
-                groups: ['unknown', 'nullish']
-            }
-        ],
-        // checked by "no-useless-escape"
-        'regexp/no-useless-escape': 'off',
-        // checked by "complexity"
-        'sonarjs/cognitive-complexity': 'off',
-        'sonarjs/different-types-comparison': 'off',
-        // checked by "regexp/no-dupe-characters-character-class"
-        'sonarjs/duplicates-in-character-class': 'off',
-        'sonarjs/no-duplicate-string': 'warn',
-        // checked by "@typescript-eslint/no-misused-promises"
-        'sonarjs/no-misused-promises': 'off',
-        // checked by "@typescript-eslint/no-redundant-type-constituents"
-        'sonarjs/no-redundant-type-constituents': 'off',
-        'sonarjs/unnecessary-character-escapes': 'off',
-        'unicorn/consistent-function-scoping': 'warn',
-        'unicorn/empty-brace-spaces': 'off',
-        'unicorn/filename-case': [
-            'error',
-            {
-                case: 'camelCase',
-                ignore: ['DB', 'URL']
-            }
-        ],
-        'unicorn/prevent-abbreviations': [
-            'error',
-            {
-                replacements: {
-                    def: {
-                        definition: true
-                    },
-                    ele: {
-                        element: true
-                    },
-                    eles: {
-                        elements: true
-                    },
-                    fns: {
-                        functions: true
-                    },
-                    res: {
-                        result: false
-                    },
-                    temp: {
-                        temporary: false
-                    }
-                }
-            }
-        ],
-        // 'woke/all': 'error',
-        'write-good-comments/write-good-comments': [
-            'warn',
-            {
-                passive: false,
-                whitelist: writeGoodCommentsWhitelist
-            }
-        ]
-    },
-    settings: {
-        perfectionist: {
-            partitionByNewLine: true
-        }
-    }
-}, {
-    extends: [eslintJson.configs.recommended],
-    files: ['**/*.json'],
-    ignores: ['**/package.json', '**/package-lock.json'],
-    language: 'json/json',
-    plugins: {
-        json: eslintJson
-    }
-}, {
-    extends: [eslintMarkdown.configs.recommended],
-    files: ['**/*.md'],
-    language: 'markdown/gfm',
-    plugins: {
-        markdown: eslintMarkdown
-    }
-});
-export const configWebApp = defineConfig(config, {
+/**
+ * ESLint Configuration for Web Applications
+ */
+export const config = defineConfig(packageConfig, {
     files: ['**/*.ts', '**/*.js'],
     ignores: ['**/*.d.ts'],
     plugins: {
@@ -274,8 +62,8 @@ export const configWebApp = defineConfig(config, {
         parserOptions: {
             templateEngineSyntax: {
                 '<%': '%>',
-                '<%=': '%>',
-                '<%-': '%>'
+                '<%-': '%>',
+                '<%=': '%>'
             }
         }
     },
@@ -333,12 +121,9 @@ export const configWebApp = defineConfig(config, {
                     { pattern: 'on.*' }
                 ]
             }
-        ]
+        ],
+        'html/use-baseline': 'warn'
     }
 });
-export { default as cspellFlagWords } from './lists/cspell.flagWords.js';
-export { default as cspellWords } from './lists/cspell.words.js';
-export { httpStatusCodes as noMagicNumbersHttpStatusCodes, default as noMagicNumbersIgnore } from './lists/noMagicNumbers.ignore.js';
-export { default as writeGoodCommentsWhitelist } from './lists/writeGoodComments.whitelist.js';
-export { defineConfig } from 'eslint/config';
 export default config;
+export { defineConfig } from 'eslint/config';

package/eslint.config.ts

@@ -1,270 +1,23 @@
 // eslint-disable-next-line @eslint-community/eslint-comments/disable-enable-pair
-/* eslint-disable @cspell/spellchecker, @typescript-eslint/no-unsafe-assignment, @typescript-eslint/no-unsafe-member-access */
+/* eslint-disable @typescript-eslint/no-unsafe-assignment */
 
-import eslintCspellRecommended from '@cspell/eslint-plugin/recommended'
-import eslintPluginEslintComments from '@eslint-community/eslint-plugin-eslint-comments/configs'
 import type { ConfigObject } from '@eslint/core'
 import eslintCss from '@eslint/css'
-import eslintJs from '@eslint/js'
-import eslintJson from '@eslint/json'
-import eslintMarkdown from '@eslint/markdown'
 import eslintHtml from '@html-eslint/eslint-plugin'
 import htmlParser from '@html-eslint/parser'
-import eslintConfigLove from 'eslint-config-love'
-import eslintPluginJsdoc from 'eslint-plugin-jsdoc'
-import eslintPluginNoSecrets from 'eslint-plugin-no-secrets'
 import eslintPluginNoUnsanitized from 'eslint-plugin-no-unsanitized'
-import eslintPluginPackageJson from 'eslint-plugin-package-json'
-import eslintPluginPerfectionist from 'eslint-plugin-perfectionist'
-import * as eslintPluginRegexp from 'eslint-plugin-regexp'
-import eslintPluginSecurity from 'eslint-plugin-security'
-import eslintPluginSonarJs from 'eslint-plugin-sonarjs'
-import eslintPluginUnicorn from 'eslint-plugin-unicorn'
-// import * as eslintPluginWoke from 'eslint-plugin-woke'
-import * as eslintPluginWriteGoodComments from 'eslint-plugin-write-good-comments'
 import { defineConfig } from 'eslint/config'
-import tseslint from 'typescript-eslint'
 
-import cspellFlagWords from './lists/cspell.flagWords.js'
-import cspellWords from './lists/cspell.words.js'
+import packageConfig from './eslint.packageConfig.js'
 import noMagicNumbers, {
   httpStatusCodes
 } from './lists/noMagicNumbers.ignore.js'
-import writeGoodCommentsWhitelist from './lists/writeGoodComments.whitelist.js'
 
+/**
+ * ESLint Configuration for Web Applications
+ */
 export const config: ConfigObject[] = defineConfig(
-  {
-    linterOptions: {
-      reportUnusedDisableDirectives: 'error',
-      reportUnusedInlineConfigs: 'error'
-    }
-  },
-  eslintPluginPackageJson.configs.recommended,
-  {
-    extends: [
-      tseslint.configs.recommendedTypeChecked,
-      tseslint.configs.stylisticTypeChecked,
-
-      eslintJs.configs.recommended,
-
-      eslintCspellRecommended,
-      eslintPluginEslintComments.recommended,
-      eslintPluginJsdoc.configs['flat/recommended-typescript'],
-      eslintPluginPerfectionist.configs['recommended-natural'],
-      eslintPluginRegexp.configs['flat/recommended'],
-      eslintPluginSecurity.configs.recommended,
-      eslintPluginSonarJs.configs.recommended,
-      eslintPluginUnicorn.configs.recommended,
-      eslintConfigLove
-    ],
-    files: ['**/*.ts', '**/*.js'],
-    ignores: ['**/*.d.ts'],
-    languageOptions: {
-      parserOptions: {
-        ecmaFeatures: { modules: true },
-        ecmaVersion: 2022,
-        project: true,
-        sourceType: 'module'
-      }
-    },
-
-    plugins: {
-      'no-secrets': eslintPluginNoSecrets,
-      // sonarjs: eslintPluginSonarJs,
-      // unicorn: eslintPluginUnicorn,
-      // woke: eslintPluginWoke,
-      'write-good-comments': eslintPluginWriteGoodComments
-    },
-
-    rules: {
-      '@cspell/spellchecker': [
-        'warn',
-        {
-          cspell: {
-            flagWords: cspellFlagWords,
-            language: 'en-CA,en-US,en-GB',
-            words: cspellWords
-          }
-        }
-      ],
-
-      '@typescript-eslint/init-declarations': 'warn',
-      '@typescript-eslint/no-magic-numbers': [
-        'warn',
-        {
-          ignore: noMagicNumbers
-        }
-      ],
-      '@typescript-eslint/no-misused-promises': 'warn',
-      '@typescript-eslint/no-non-null-assertion': 'warn',
-      '@typescript-eslint/no-unnecessary-type-assertion': 'off',
-
-      '@typescript-eslint/no-unsafe-argument': 'warn',
-      '@typescript-eslint/no-unsafe-assignment': 'warn',
-      '@typescript-eslint/no-unsafe-call': 'warn',
-      '@typescript-eslint/no-unsafe-member-access': 'warn',
-      '@typescript-eslint/no-unsafe-type-assertion': 'warn',
-
-      '@typescript-eslint/non-nullable-type-assertion-style': 'off',
-      '@typescript-eslint/prefer-destructuring': 'off',
-      '@typescript-eslint/restrict-plus-operands': 'warn',
-      '@typescript-eslint/space-before-function-paren': 'off',
-      '@typescript-eslint/strict-boolean-expressions': 'warn',
-
-      complexity: [
-        'warn',
-        {
-          max: 20
-        }
-      ],
-
-      'eslint-comments/require-description': 'off',
-
-      'jsdoc/require-jsdoc': ['warn', { publicOnly: true }],
-
-      'n/no-missing-import': 'off',
-
-      'no-extra-semi': 'off',
-
-      'no-param-reassign': ['error', { props: false }],
-
-      'no-redeclare': 'off',
-      'no-secrets/no-secrets': 'error',
-      'no-undef': 'off',
-
-      // checked by "@typescript-eslint/no-unused-vars"
-      'no-unused-vars': 'off',
-
-      'perfectionist/sort-imports': [
-        'error',
-        {
-          groups: [
-            'builtin',
-            ['external', 'internal-type', 'internal', 'type'],
-            ['parent-type', 'parent'],
-            ['sibling-type', 'sibling'],
-            'unknown'
-          ],
-          partitionByNewLine: false
-        }
-      ],
-      'perfectionist/sort-interfaces': 'warn',
-      'perfectionist/sort-modules': 'warn',
-      'perfectionist/sort-named-exports': [
-        'error',
-        {
-          groupKind: 'types-first'
-        }
-      ],
-      'perfectionist/sort-named-imports': [
-        'error',
-        {
-          groupKind: 'types-first'
-        }
-      ],
-      'perfectionist/sort-object-types': 'warn',
-      'perfectionist/sort-objects': 'warn',
-
-      'perfectionist/sort-union-types': [
-        'error',
-        {
-          groups: ['unknown', 'nullish']
-        }
-      ],
-
-      // checked by "no-useless-escape"
-      'regexp/no-useless-escape': 'off',
-
-      // checked by "complexity"
-      'sonarjs/cognitive-complexity': 'off',
-
-      'sonarjs/different-types-comparison': 'off',
-
-      // checked by "regexp/no-dupe-characters-character-class"
-      'sonarjs/duplicates-in-character-class': 'off',
-
-      'sonarjs/no-duplicate-string': 'warn',
-
-      // checked by "@typescript-eslint/no-misused-promises"
-      'sonarjs/no-misused-promises': 'off',
-
-      // checked by "@typescript-eslint/no-redundant-type-constituents"
-      'sonarjs/no-redundant-type-constituents': 'off',
-
-      'sonarjs/unnecessary-character-escapes': 'off',
-
-      'unicorn/consistent-function-scoping': 'warn',
-      'unicorn/empty-brace-spaces': 'off',
-      'unicorn/filename-case': [
-        'error',
-        {
-          case: 'camelCase',
-          ignore: ['DB', 'URL']
-        }
-      ],
-      'unicorn/prevent-abbreviations': [
-        'error',
-        {
-          replacements: {
-            def: {
-              definition: true
-            },
-            ele: {
-              element: true
-            },
-            eles: {
-              elements: true
-            },
-            fns: {
-              functions: true
-            },
-            res: {
-              result: false
-            },
-            temp: {
-              temporary: false
-            }
-          }
-        }
-      ],
-
-      // 'woke/all': 'error',
-
-      'write-good-comments/write-good-comments': [
-        'warn',
-        {
-          passive: false,
-          whitelist: writeGoodCommentsWhitelist
-        }
-      ]
-    },
-    settings: {
-      perfectionist: {
-        partitionByNewLine: true
-      }
-    }
-  },
-  {
-    extends: [eslintJson.configs.recommended],
-    files: ['**/*.json'],
-    ignores: ['**/package.json', '**/package-lock.json'],
-    language: 'json/json',
-    plugins: {
-      json: eslintJson
-    }
-  },
-  {
-    extends: [eslintMarkdown.configs.recommended],
-    files: ['**/*.md'],
-    language: 'markdown/gfm',
-    plugins: {
-      markdown: eslintMarkdown
-    }
-  }
-)
-
-export const configWebApp: ConfigObject[] = defineConfig(
-  config,
+  packageConfig,
   {
     files: ['**/*.ts', '**/*.js'],
     ignores: ['**/*.d.ts'],
@@ -325,8 +78,8 @@ export const configWebApp: ConfigObject[] = defineConfig(
       parserOptions: {
         templateEngineSyntax: {
           '<%': '%>',
-          '<%=': '%>',
-          '<%-': '%>'
+          '<%-': '%>',
+          '<%=': '%>'
         }
       }
     },
@@ -389,22 +142,13 @@ export const configWebApp: ConfigObject[] = defineConfig(
             { pattern: 'on.*' }
           ]
         }
-      ]
+      ],
+      'html/use-baseline': 'warn'
     }
   }
 )
 
-export { default as cspellFlagWords } from './lists/cspell.flagWords.js'
-export { default as cspellWords } from './lists/cspell.words.js'
-
-export {
-  httpStatusCodes as noMagicNumbersHttpStatusCodes,
-  default as noMagicNumbersIgnore
-} from './lists/noMagicNumbers.ignore.js'
-
-export { default as writeGoodCommentsWhitelist } from './lists/writeGoodComments.whitelist.js'
+export default config
 
 export type { ConfigObject } from '@eslint/core'
 export { defineConfig } from 'eslint/config'
-
-export default config

package/eslint.packageConfig.d.ts

@@ -0,0 +1,8 @@
+import type { ConfigObject } from '@eslint/core';
+/**
+ * ESLint Configuration for General TypeScript/JavaScript Projects
+ */
+export declare const config: ConfigObject[];
+export default config;
+export type { ConfigObject } from '@eslint/core';
+export { defineConfig } from 'eslint/config';

package/eslint.packageConfig.js

@@ -0,0 +1,222 @@
+import eslintCspellRecommended from '@cspell/eslint-plugin/recommended';
+import eslintPluginEslintComments from '@eslint-community/eslint-plugin-eslint-comments/configs';
+import eslintJs from '@eslint/js';
+import eslintJson from '@eslint/json';
+import eslintMarkdown from '@eslint/markdown';
+import eslintConfigLove from 'eslint-config-love';
+import eslintPluginJsdoc from 'eslint-plugin-jsdoc';
+import eslintPluginNoSecrets from 'eslint-plugin-no-secrets';
+import eslintPluginPackageJson from 'eslint-plugin-package-json';
+import eslintPluginPerfectionist from 'eslint-plugin-perfectionist';
+import * as eslintPluginRegexp from 'eslint-plugin-regexp';
+import eslintPluginSecurity from 'eslint-plugin-security';
+import eslintPluginSonarJs from 'eslint-plugin-sonarjs';
+import eslintPluginUnicorn from 'eslint-plugin-unicorn';
+import * as eslintPluginWriteGoodComments from 'eslint-plugin-write-good-comments';
+import { defineConfig } from 'eslint/config';
+import tseslint from 'typescript-eslint';
+import cspellFlagWords from './lists/cspell.flagWords.js';
+import cspellWords from './lists/cspell.words.js';
+import noMagicNumbers from './lists/noMagicNumbers.ignore.js';
+import writeGoodCommentsAllowlist from './lists/writeGoodComments.allowlist.js';
+/**
+ * ESLint Configuration for General TypeScript/JavaScript Projects
+ */
+export const config = defineConfig({
+    linterOptions: {
+        reportUnusedDisableDirectives: 'error',
+        reportUnusedInlineConfigs: 'error'
+    }
+}, eslintPluginPackageJson.configs.recommended, {
+    extends: [
+        tseslint.configs.recommendedTypeChecked,
+        tseslint.configs.stylisticTypeChecked,
+        eslintJs.configs.recommended,
+        eslintCspellRecommended,
+        eslintPluginEslintComments.recommended,
+        eslintPluginJsdoc.configs['flat/recommended-typescript'],
+        eslintPluginPerfectionist.configs['recommended-natural'],
+        eslintPluginRegexp.configs['flat/recommended'],
+        eslintPluginSecurity.configs.recommended,
+        eslintPluginSonarJs.configs.recommended,
+        eslintPluginUnicorn.configs.recommended,
+        eslintConfigLove
+    ],
+    files: ['**/*.ts', '**/*.js'],
+    ignores: ['**/*.d.ts'],
+    languageOptions: {
+        parserOptions: {
+            ecmaFeatures: { modules: true },
+            ecmaVersion: 2022,
+            project: true,
+            sourceType: 'module'
+        }
+    },
+    plugins: {
+        'no-secrets': eslintPluginNoSecrets,
+        // sonarjs: eslintPluginSonarJs,
+        // unicorn: eslintPluginUnicorn,
+        // woke: eslintPluginWoke,
+        'write-good-comments': eslintPluginWriteGoodComments
+    },
+    rules: {
+        '@cspell/spellchecker': [
+            'warn',
+            {
+                cspell: {
+                    flagWords: cspellFlagWords,
+                    language: 'en-CA,en-US,en-GB',
+                    words: cspellWords
+                }
+            }
+        ],
+        '@typescript-eslint/init-declarations': 'warn',
+        '@typescript-eslint/no-magic-numbers': [
+            'warn',
+            {
+                ignore: noMagicNumbers
+            }
+        ],
+        '@typescript-eslint/no-misused-promises': 'warn',
+        '@typescript-eslint/no-non-null-assertion': 'warn',
+        '@typescript-eslint/no-unnecessary-type-assertion': 'off',
+        '@typescript-eslint/no-unsafe-argument': 'warn',
+        '@typescript-eslint/no-unsafe-assignment': 'warn',
+        '@typescript-eslint/no-unsafe-call': 'warn',
+        '@typescript-eslint/no-unsafe-member-access': 'warn',
+        '@typescript-eslint/no-unsafe-type-assertion': 'warn',
+        '@typescript-eslint/non-nullable-type-assertion-style': 'off',
+        '@typescript-eslint/prefer-destructuring': 'off',
+        '@typescript-eslint/restrict-plus-operands': 'warn',
+        '@typescript-eslint/space-before-function-paren': 'off',
+        '@typescript-eslint/strict-boolean-expressions': 'warn',
+        complexity: [
+            'warn',
+            {
+                max: 20
+            }
+        ],
+        'eslint-comments/require-description': 'off',
+        'jsdoc/require-jsdoc': ['warn', { publicOnly: true }],
+        'n/no-missing-import': 'off',
+        'no-extra-semi': 'off',
+        'no-param-reassign': ['error', { props: false }],
+        'no-redeclare': 'off',
+        'no-secrets/no-secrets': 'error',
+        'no-undef': 'off',
+        // checked by "@typescript-eslint/no-unused-vars"
+        'no-unused-vars': 'off',
+        'perfectionist/sort-imports': [
+            'error',
+            {
+                groups: [
+                    'builtin',
+                    ['external', 'internal-type', 'internal', 'type'],
+                    ['parent-type', 'parent'],
+                    ['sibling-type', 'sibling'],
+                    'unknown'
+                ],
+                partitionByNewLine: false
+            }
+        ],
+        'perfectionist/sort-interfaces': 'warn',
+        'perfectionist/sort-modules': 'warn',
+        'perfectionist/sort-named-exports': [
+            'error',
+            {
+                groupKind: 'types-first'
+            }
+        ],
+        'perfectionist/sort-named-imports': [
+            'error',
+            {
+                groupKind: 'types-first'
+            }
+        ],
+        'perfectionist/sort-object-types': 'warn',
+        'perfectionist/sort-objects': 'warn',
+        'perfectionist/sort-union-types': [
+            'error',
+            {
+                groups: ['unknown', 'nullish']
+            }
+        ],
+        // checked by "no-useless-escape"
+        'regexp/no-useless-escape': 'off',
+        // checked by "complexity"
+        'sonarjs/cognitive-complexity': 'off',
+        'sonarjs/different-types-comparison': 'off',
+        // checked by "regexp/no-dupe-characters-character-class"
+        'sonarjs/duplicates-in-character-class': 'off',
+        'sonarjs/no-duplicate-string': 'warn',
+        // checked by "@typescript-eslint/no-misused-promises"
+        'sonarjs/no-misused-promises': 'off',
+        // checked by "@typescript-eslint/no-redundant-type-constituents"
+        'sonarjs/no-redundant-type-constituents': 'off',
+        'sonarjs/unnecessary-character-escapes': 'off',
+        'unicorn/consistent-function-scoping': 'warn',
+        'unicorn/empty-brace-spaces': 'off',
+        'unicorn/filename-case': [
+            'error',
+            {
+                case: 'camelCase',
+                ignore: ['DB', 'URL']
+            }
+        ],
+        'unicorn/prevent-abbreviations': [
+            'error',
+            {
+                replacements: {
+                    def: {
+                        definition: true
+                    },
+                    ele: {
+                        element: true
+                    },
+                    eles: {
+                        elements: true
+                    },
+                    fns: {
+                        functions: true
+                    },
+                    res: {
+                        result: false
+                    },
+                    temp: {
+                        temporary: false
+                    }
+                }
+            }
+        ],
+        // 'woke/all': 'error',
+        'write-good-comments/write-good-comments': [
+            'warn',
+            {
+                passive: false,
+                whitelist: writeGoodCommentsAllowlist
+            }
+        ]
+    },
+    settings: {
+        perfectionist: {
+            partitionByNewLine: true
+        }
+    }
+}, {
+    extends: [eslintJson.configs.recommended],
+    files: ['**/*.json'],
+    ignores: ['**/package.json', '**/package-lock.json'],
+    language: 'json/json',
+    plugins: {
+        json: eslintJson
+    }
+}, {
+    extends: [eslintMarkdown.configs.recommended],
+    files: ['**/*.md'],
+    language: 'markdown/gfm',
+    plugins: {
+        markdown: eslintMarkdown
+    }
+});
+export default config;
+export { defineConfig } from 'eslint/config';

package/eslint.packageConfig.ts

@@ -0,0 +1,262 @@
+import eslintCspellRecommended from '@cspell/eslint-plugin/recommended'
+import eslintPluginEslintComments from '@eslint-community/eslint-plugin-eslint-comments/configs'
+import type { ConfigObject } from '@eslint/core'
+import eslintJs from '@eslint/js'
+import eslintJson from '@eslint/json'
+import eslintMarkdown from '@eslint/markdown'
+import eslintConfigLove from 'eslint-config-love'
+import eslintPluginJsdoc from 'eslint-plugin-jsdoc'
+import eslintPluginNoSecrets from 'eslint-plugin-no-secrets'
+import eslintPluginPackageJson from 'eslint-plugin-package-json'
+import eslintPluginPerfectionist from 'eslint-plugin-perfectionist'
+import * as eslintPluginRegexp from 'eslint-plugin-regexp'
+import eslintPluginSecurity from 'eslint-plugin-security'
+import eslintPluginSonarJs from 'eslint-plugin-sonarjs'
+import eslintPluginUnicorn from 'eslint-plugin-unicorn'
+import * as eslintPluginWriteGoodComments from 'eslint-plugin-write-good-comments'
+import { defineConfig } from 'eslint/config'
+import tseslint from 'typescript-eslint'
+
+import cspellFlagWords from './lists/cspell.flagWords.js'
+import cspellWords from './lists/cspell.words.js'
+import noMagicNumbers from './lists/noMagicNumbers.ignore.js'
+import writeGoodCommentsAllowlist from './lists/writeGoodComments.allowlist.js'
+
+/**
+ * ESLint Configuration for General TypeScript/JavaScript Projects
+ */
+export const config: ConfigObject[] = defineConfig(
+  {
+    linterOptions: {
+      reportUnusedDisableDirectives: 'error',
+      reportUnusedInlineConfigs: 'error'
+    }
+  },
+  eslintPluginPackageJson.configs.recommended,
+  {
+    extends: [
+      tseslint.configs.recommendedTypeChecked,
+      tseslint.configs.stylisticTypeChecked,
+
+      eslintJs.configs.recommended,
+
+      eslintCspellRecommended,
+      eslintPluginEslintComments.recommended,
+      eslintPluginJsdoc.configs['flat/recommended-typescript'],
+      eslintPluginPerfectionist.configs['recommended-natural'],
+      eslintPluginRegexp.configs['flat/recommended'],
+      eslintPluginSecurity.configs.recommended,
+      eslintPluginSonarJs.configs.recommended,
+      eslintPluginUnicorn.configs.recommended,
+      eslintConfigLove
+    ],
+    files: ['**/*.ts', '**/*.js'],
+    ignores: ['**/*.d.ts'],
+    languageOptions: {
+      parserOptions: {
+        ecmaFeatures: { modules: true },
+        ecmaVersion: 2022,
+        project: true,
+        sourceType: 'module'
+      }
+    },
+
+    plugins: {
+      'no-secrets': eslintPluginNoSecrets,
+      // sonarjs: eslintPluginSonarJs,
+      // unicorn: eslintPluginUnicorn,
+      // woke: eslintPluginWoke,
+      'write-good-comments': eslintPluginWriteGoodComments
+    },
+
+    rules: {
+      '@cspell/spellchecker': [
+        'warn',
+        {
+          cspell: {
+            flagWords: cspellFlagWords,
+            language: 'en-CA,en-US,en-GB',
+            words: cspellWords
+          }
+        }
+      ],
+
+      '@typescript-eslint/init-declarations': 'warn',
+      '@typescript-eslint/no-magic-numbers': [
+        'warn',
+        {
+          ignore: noMagicNumbers
+        }
+      ],
+      '@typescript-eslint/no-misused-promises': 'warn',
+      '@typescript-eslint/no-non-null-assertion': 'warn',
+      '@typescript-eslint/no-unnecessary-type-assertion': 'off',
+
+      '@typescript-eslint/no-unsafe-argument': 'warn',
+      '@typescript-eslint/no-unsafe-assignment': 'warn',
+      '@typescript-eslint/no-unsafe-call': 'warn',
+      '@typescript-eslint/no-unsafe-member-access': 'warn',
+      '@typescript-eslint/no-unsafe-type-assertion': 'warn',
+
+      '@typescript-eslint/non-nullable-type-assertion-style': 'off',
+      '@typescript-eslint/prefer-destructuring': 'off',
+      '@typescript-eslint/restrict-plus-operands': 'warn',
+      '@typescript-eslint/space-before-function-paren': 'off',
+      '@typescript-eslint/strict-boolean-expressions': 'warn',
+
+      complexity: [
+        'warn',
+        {
+          max: 20
+        }
+      ],
+
+      'eslint-comments/require-description': 'off',
+
+      'jsdoc/require-jsdoc': ['warn', { publicOnly: true }],
+
+      'n/no-missing-import': 'off',
+
+      'no-extra-semi': 'off',
+
+      'no-param-reassign': ['error', { props: false }],
+
+      'no-redeclare': 'off',
+      'no-secrets/no-secrets': 'error',
+      'no-undef': 'off',
+
+      // checked by "@typescript-eslint/no-unused-vars"
+      'no-unused-vars': 'off',
+
+      'perfectionist/sort-imports': [
+        'error',
+        {
+          groups: [
+            'builtin',
+            ['external', 'internal-type', 'internal', 'type'],
+            ['parent-type', 'parent'],
+            ['sibling-type', 'sibling'],
+            'unknown'
+          ],
+          partitionByNewLine: false
+        }
+      ],
+      'perfectionist/sort-interfaces': 'warn',
+      'perfectionist/sort-modules': 'warn',
+      'perfectionist/sort-named-exports': [
+        'error',
+        {
+          groupKind: 'types-first'
+        }
+      ],
+      'perfectionist/sort-named-imports': [
+        'error',
+        {
+          groupKind: 'types-first'
+        }
+      ],
+      'perfectionist/sort-object-types': 'warn',
+      'perfectionist/sort-objects': 'warn',
+
+      'perfectionist/sort-union-types': [
+        'error',
+        {
+          groups: ['unknown', 'nullish']
+        }
+      ],
+
+      // checked by "no-useless-escape"
+      'regexp/no-useless-escape': 'off',
+
+      // checked by "complexity"
+      'sonarjs/cognitive-complexity': 'off',
+
+      'sonarjs/different-types-comparison': 'off',
+
+      // checked by "regexp/no-dupe-characters-character-class"
+      'sonarjs/duplicates-in-character-class': 'off',
+
+      'sonarjs/no-duplicate-string': 'warn',
+
+      // checked by "@typescript-eslint/no-misused-promises"
+      'sonarjs/no-misused-promises': 'off',
+
+      // checked by "@typescript-eslint/no-redundant-type-constituents"
+      'sonarjs/no-redundant-type-constituents': 'off',
+
+      'sonarjs/unnecessary-character-escapes': 'off',
+
+      'unicorn/consistent-function-scoping': 'warn',
+      'unicorn/empty-brace-spaces': 'off',
+      'unicorn/filename-case': [
+        'error',
+        {
+          case: 'camelCase',
+          ignore: ['DB', 'URL']
+        }
+      ],
+      'unicorn/prevent-abbreviations': [
+        'error',
+        {
+          replacements: {
+            def: {
+              definition: true
+            },
+            ele: {
+              element: true
+            },
+            eles: {
+              elements: true
+            },
+            fns: {
+              functions: true
+            },
+            res: {
+              result: false
+            },
+            temp: {
+              temporary: false
+            }
+          }
+        }
+      ],
+
+      // 'woke/all': 'error',
+
+      'write-good-comments/write-good-comments': [
+        'warn',
+        {
+          passive: false,
+          whitelist: writeGoodCommentsAllowlist
+        }
+      ]
+    },
+    settings: {
+      perfectionist: {
+        partitionByNewLine: true
+      }
+    }
+  },
+  {
+    extends: [eslintJson.configs.recommended],
+    files: ['**/*.json'],
+    ignores: ['**/package.json', '**/package-lock.json'],
+    language: 'json/json',
+    plugins: {
+      json: eslintJson
+    }
+  },
+  {
+    extends: [eslintMarkdown.configs.recommended],
+    files: ['**/*.md'],
+    language: 'markdown/gfm',
+    plugins: {
+      markdown: eslintMarkdown
+    }
+  }
+)
+
+export default config
+
+export type { ConfigObject } from '@eslint/core'
+export { defineConfig } from 'eslint/config'

package/exports.d.ts

@@ -0,0 +1,4 @@
+export { default as cspellFlagWords } from './lists/cspell.flagWords.js';
+export { default as cspellWords } from './lists/cspell.words.js';
+export { httpStatusCodes as noMagicNumbersHttpStatusCodes, default as noMagicNumbersIgnore } from './lists/noMagicNumbers.ignore.js';
+export { default as writeGoodCommentsAllowlist } from './lists/writeGoodComments.allowlist.js';

package/exports.js

@@ -0,0 +1,4 @@
+export { default as cspellFlagWords } from './lists/cspell.flagWords.js';
+export { default as cspellWords } from './lists/cspell.words.js';
+export { httpStatusCodes as noMagicNumbersHttpStatusCodes, default as noMagicNumbersIgnore } from './lists/noMagicNumbers.ignore.js';
+export { default as writeGoodCommentsAllowlist } from './lists/writeGoodComments.allowlist.js';

package/exports.ts

@@ -0,0 +1,9 @@
+export { default as cspellFlagWords } from './lists/cspell.flagWords.js'
+export { default as cspellWords } from './lists/cspell.words.js'
+
+export {
+  httpStatusCodes as noMagicNumbersHttpStatusCodes,
+  default as noMagicNumbersIgnore
+} from './lists/noMagicNumbers.ignore.js'
+
+export { default as writeGoodCommentsAllowlist } from './lists/writeGoodComments.allowlist.js'

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "eslint-config-cityssm",
-  "version": "32.3.2",
+  "version": "33.0.0",
   "description": "ESLint rules used in the City of Sault Ste. Marie's TypeScript projects.",
   "keywords": [
     "eslint",
@@ -39,7 +39,11 @@
   "type": "module",
   "exports": {
     ".": "./eslint.config.js",
-    "./eslint.config.js": "./eslint.config.js"
+    "./packageConfig": "./eslint.packageConfig.js",
+    "./eslint.packageConfig.js": "./eslint.packageConfig.js",
+    "./eslint.config.js": "./eslint.config.js",
+    "./exports": "./exports.js",
+    "./exports.js": "./exports.js"
   },
   "main": "eslint.config.js",
   "scripts": {
@@ -57,8 +61,8 @@
     "@html-eslint/eslint-plugin": "^0.47.0",
     "@html-eslint/parser": "^0.47.0",
     "eslint": "9.37.0",
-    "eslint-config-love": "^130.0.0",
-    "eslint-plugin-jsdoc": "^61.0.0",
+    "eslint-config-love": "^133.0.0",
+    "eslint-plugin-jsdoc": "^61.0.1",
     "eslint-plugin-n": "^17.23.1",
     "eslint-plugin-no-secrets": "^2.2.1",
     "eslint-plugin-no-unsanitized": "^4.1.4",