chore: update dev and test environments

Signed-off-by: Lexus Drumgold <[email protected]>

Author: unicornware

.eslintrc.base.cjs

@@ -53,6 +53,7 @@ const config = {
       },
       plugins: [
         '@typescript-eslint',
+        'import',
         'jsdoc',
         'node',
         'prettier',
@@ -171,7 +172,6 @@ const config = {
           }
         ],
         '@typescript-eslint/no-dupe-class-members': 2,
-        '@typescript-eslint/no-duplicate-imports': 2,
         '@typescript-eslint/no-dynamic-delete': 2,
         '@typescript-eslint/no-empty-function': [
           2,
@@ -352,7 +352,11 @@ const config = {
           2,
           {
             allowAny: false,
-            checkCompoundAssignments: false
+            allowBoolean: false,
+            allowNullish: false,
+            allowNumberAndString: true,
+            allowRegExp: false,
+            skipCompoundAssignments: true
           }
         ],
         '@typescript-eslint/restrict-template-expressions': [
@@ -366,7 +370,7 @@ const config = {
           }
         ],
         '@typescript-eslint/return-await': [2, 'in-try-catch'],
-        '@typescript-eslint/sort-type-union-intersection-members': 2,
+        '@typescript-eslint/sort-type-constituents': 2,
         '@typescript-eslint/strict-boolean-expressions': [
           2,
           {
@@ -394,6 +398,13 @@ const config = {
         '@typescript-eslint/unified-signatures': 2,
         'default-param-last': 0,
         eqeqeq: 1,
+        'import/no-duplicates': [
+          2,
+          {
+            considerQueryString: true,
+            'prefer-inline': true
+          }
+        ],
         'init-declarations': 0,
         'jsdoc/check-access': 1,
         'jsdoc/check-alignment': 1,
@@ -417,6 +428,7 @@ const config = {
           1,
           {
             definedTags: [
+              'decorator',
               'experimental',
               'maximum',
               'minimum',
@@ -434,7 +446,6 @@ const config = {
         'jsdoc/match-description': 0,
         'jsdoc/match-name': 0,
         'jsdoc/multiline-blocks': 1,
-        'jsdoc/newline-after-description': [1, 'always'],
         'jsdoc/no-bad-blocks': [1, { preventAllMultiAsteriskBlocks: true }],
         'jsdoc/no-defaults': 0,
         'jsdoc/no-missing-syntax': 0,
@@ -557,9 +568,10 @@ const config = {
           1,
           'any',
           {
+            applyToEndTag: true,
             count: 1,
-            dropEndLines: true,
-            noEndLines: false,
+            endLines: 0,
+            startLines: 1,
             tags: {}
           }
         ],
@@ -572,6 +584,7 @@ const config = {
         'no-empty-function': 0,
         'no-ex-assign': 0,
         'no-extra-parens': 0,
+        'no-extra-semi': 0,
         'no-implied-eval': 0,
         'no-invalid-this': 0,
         'no-loop-func': 0,
@@ -661,7 +674,7 @@ const config = {
             terms: ['@fixme', '@todo']
           }
         ],
-        'unicorn/explicit-length-check': 2,
+        'unicorn/explicit-length-check': 0,
         'unicorn/filename-case': [
           2,
           {
@@ -774,15 +787,8 @@ const config = {
             allowArgumentsExplicitlyTypedAsAny: true,
             allowDirectConstAssertionInArrowFunctions: true,
             allowHigherOrderFunctions: false,
-            allowTypedFunctionExpressions: true,
-            allowedNames: [],
-            shouldTrackReferences: true
-          }
-        ],
-        '@typescript-eslint/no-implicit-any-catch': [
-          2,
-          {
-            allowExplicitAny: false
+            allowTypedFunctionExpressions: false,
+            allowedNames: []
           }
         ],
         'no-undef': 0
@@ -835,6 +841,7 @@ const config = {
       },
       plugins: ['chai-expect', 'jest-formatting'],
       rules: {
+        '@typescript-eslint/class-literal-property-style': 0,
         '@typescript-eslint/consistent-indexed-object-style': 0,
         '@typescript-eslint/no-base-to-string': 0,
         '@typescript-eslint/no-empty-function': 0,
@@ -858,7 +865,6 @@ const config = {
         'promise/valid-params': 0,
         'unicorn/consistent-destructuring': 0,
         'unicorn/error-message': 0,
-        'unicorn/explicit-length-check': 0,
         'unicorn/no-array-for-each': 0,
         'unicorn/no-hex-escape': 0,
         'unicorn/no-useless-undefined': 0,
@@ -878,6 +884,12 @@ const config = {
         '@typescript-eslint/no-redundant-type-constituents': 0
       }
     },
+    {
+      files: ['**/decorators/*.constraint.ts', '**/*.decorator.ts'],
+      rules: {
+        '@typescript-eslint/ban-types': 0
+      }
+    },
     {
       files: ['**/enums/*.ts', '**/interfaces/*.ts', '**/types/*.ts'],
       rules: {
@@ -990,6 +1002,7 @@ const config = {
         '@typescript-eslint/naming-convention': 0,
         '@typescript-eslint/no-base-to-string': 0,
         '@typescript-eslint/no-confusing-void-expression': 0,
+        '@typescript-eslint/no-duplicate-type-constituents': 0,
         '@typescript-eslint/no-floating-promises': 0,
         '@typescript-eslint/no-for-in-array': 0,
         '@typescript-eslint/no-implied-eval': 0,
@@ -1006,12 +1019,14 @@ const config = {
         '@typescript-eslint/no-unsafe-argument': 0,
         '@typescript-eslint/no-unsafe-assignment': 0,
         '@typescript-eslint/no-unsafe-call': 0,
+        '@typescript-eslint/no-unsafe-enum-comparison': 0,
         '@typescript-eslint/no-unsafe-member-access': 0,
         '@typescript-eslint/no-unsafe-return': 0,
         '@typescript-eslint/no-unused-expressions': 0,
         '@typescript-eslint/non-nullable-type-assertion-style': 0,
         '@typescript-eslint/prefer-includes': 0,
         '@typescript-eslint/prefer-nullish-coalescing': 0,
+        '@typescript-eslint/prefer-optional-chain': 0,
         '@typescript-eslint/prefer-readonly': 0,
         '@typescript-eslint/prefer-readonly-parameter-types': 0,
         '@typescript-eslint/prefer-reduce-type-parameter': 0,
@@ -1032,7 +1047,7 @@ const config = {
       }
     },
     {
-      files: '**/*.yml',
+      files: '**/*.+(yaml|yml)',
       parser: 'yaml-eslint-parser',
       plugins: ['yml'],
       rules: {
@@ -1151,20 +1166,35 @@ const config = {
     'prettier/prettier': [2, {}, { usePrettierrc: true }]
   },
   settings: {
+    'import/parsers': {
+      '@typescript-eslint/parser': ['.cts', '.mts', '.ts', '.tsx']
+    },
+    'import/resolver': {
+      node: true,
+      typescript: true
+    },
     jsdoc: {
       augmentsExtendsReplacesDocs: true,
       ignoreInternal: false,
       ignorePrivate: false,
       implementsReplacesDocs: true,
       overrideReplacesDocs: true,
       preferredTypes: {
-        '*': false
+        '*': false,
+        '.<>': false,
+        'Array<>': { replacement: '[]' },
+        Object: { replacement: 'object' },
+        'Object<>': { replacement: 'Record<>' },
+        object: 'object'
       },
       structuredTags: {
         const: {
           name: 'namepath-defining',
           required: ['name']
         },
+        decorator: {
+          name: 'none'
+        },
         enum: {
           name: 'namepath-defining',
           required: ['name', 'type']

.github/infrastructure.yml

@@ -40,8 +40,8 @@ branches:
           - context: test (18)
           - context: test (19)
           - context: typescript (5.0.4)
+          - context: typescript (5.1.6)
           - context: typescript (latest)
-          - context: typescript (~4.9.0)
         strict: true
       restrictions: null
 # https://docs.github.com/rest/deployments/environments#create-or-update-an-environment
@@ -190,8 +190,6 @@ repository:
   is_template: false
   private: false
   security_and_analysis:
-    advanced_security:
-      status: disabled
     secret_scanning:
       status: enabled
     secret_scanning_push_protection:

.github/workflows/ci.yml

@@ -236,7 +236,7 @@ jobs:
         typescript-version:
           - ${{ needs.preflight.outputs.version-typescript }}
           - latest
-          - ~4.9.0
+          - 5.0.4
     steps:
       - id: checkout
         name: Checkout ${{ env.REF_NAME }}
@@ -268,14 +268,10 @@ jobs:
         if: steps.test-files-check.outputs.files_exists == 'true'
         name: Install typescript@${{ matrix.typescript-version }}
         run: yarn add -D typescript@${{ matrix.typescript-version }}
-      - id: set-typescript-version
-        name: Set env.TYPESCRIPT_VERSION
-        run: |
-          echo "TYPESCRIPT_VERSION=$(jq .devDependencies.typescript package.json -r)" >>$GITHUB_ENV
       - id: print-typescript-version
         if: steps.test-files-check.outputs.files_exists == 'true'
         name: Print TypeScript version
-        run: echo $TYPESCRIPT_VERSION
+        run: jq .devDependencies.typescript package.json -r
       - id: typecheck
         if: steps.test-files-check.outputs.files_exists == 'true'
         name: Run typecheck

.github/workflows/typescript-canary.yml

@@ -21,7 +21,7 @@ name: typescript-canary
 on:
   schedule:
     # every day, 3 hours after typescript@next release
-    # https://github.com/microsoft/TypeScript/blob/v4.9.5/.github/workflows/nightly.yaml
+    # https://github.com/microsoft/TypeScript/blob/v5.0.4/.github/workflows/nightly.yaml
     - cron: 0 10 * * *
   workflow_dispatch:
 permissions:
@@ -65,13 +65,9 @@ jobs:
       - id: typescript
         name: Install typescript@${{ matrix.typescript-version }}
         run: yarn add -D typescript@${{ matrix.typescript-version }}
-      - id: set-typescript-version
-        name: Set env.TYPESCRIPT_VERSION
-        run: |
-          echo "TYPESCRIPT_VERSION=$(jq .devDependencies.typescript package.json -r)" >>$GITHUB_ENV
       - id: print-typescript-version
         name: Print TypeScript version
-        run: echo $TYPESCRIPT_VERSION
+        run: jq .devDependencies.typescript package.json -r
       - id: build
         name: Build project
         run: yarn build

.prettierrc.json

@@ -1,6 +1,7 @@
 {
   "arrowParens": "avoid",
   "bracketSpacing": true,
+  "plugins": ["prettier-plugin-sh"],
   "proseWrap": "always",
   "quoteProps": "as-needed",
   "semi": false,

.vscode/settings.json

@@ -256,6 +256,7 @@
   "shellformat.flag": "-ci -fn -i=2 -sr",
   "shellformat.useEditorConfig": true,
   "terminal.integrated.copyOnSelection": true,
+  "terminal.integrated.scrollback": 10000,
   "todo-tree.filtering.ignoreGitSubmodules": true,
   "todo-tree.filtering.includeHiddenFiles": false,
   "todo-tree.filtering.useBuiltInExcludes": "file and search excludes",

__tests__/interfaces/mock.ts

@@ -1,6 +1,6 @@
 /**
- * @file Test Environment Interfaces - Spy
- * @module tests/interfaces/Spy
+ * @file Test Environment Interfaces - Mock
+ * @module tests/interfaces/Mock
  */
 
 import type { Fn } from '@flex-development/tutils'
@@ -11,9 +11,11 @@ import type * as vitest from 'vitest'
  *
  * @template F - Function being mocked
  *
+ * @extends {Fn<Parameters<F>,ReturnType<F>>}
  * @extends {vitest.Mock<Parameters<F>,ReturnType<F>>}
  */
 interface Mock<F extends Fn = Fn>
-  extends vitest.Mock<Parameters<F>, ReturnType<F>> {}
+  extends Fn<Parameters<F>, ReturnType<F>>,
+    vitest.Mock<Parameters<F>, ReturnType<F>> {}
 
 export type { Mock as default }

__tests__/interfaces/spy.ts

@@ -11,9 +11,11 @@ import type * as vitest from 'vitest'
  *
  * @template F - Function being spied on
  *
+ * @extends {Fn<Parameters<F>,ReturnType<F>>}
  * @extends {vitest.SpyInstance<Parameters<F>,ReturnType<F>>}
  */
 interface Spy<F extends Fn = Fn>
-  extends vitest.SpyInstance<Parameters<F>, ReturnType<F>> {}
+  extends Fn<Parameters<F>, ReturnType<F>>,
+    vitest.SpyInstance<Parameters<F>, ReturnType<F>> {}
 
 export type { Spy as default }