Merge changes from v1.9.2-next.1 into main (#175)

Author: trevor-anderson

.github/workflows/chore.annual-license-update.yaml

@@ -0,0 +1,43 @@
+name: 📝 Annual License Update Workflow
+
+on:
+  # This workflow runs on Jan 1st every year.
+  schedule:
+    - cron: "0 0 1 1 *"
+
+jobs:
+  update-license:
+    name: 📝 Update License File
+    runs-on: ubuntu-latest
+    timeout-minutes: 5
+    permissions:
+      contents: write # to checkout the code and update the LICENSE file
+    steps:
+      - uses: actions/checkout@v5
+        with:
+          token: ${{ secrets.SEMANTIC_RELEASE_TOKEN }}
+
+      - name: Configure Git User
+        run: |
+          git config user.name 'github-actions[bot]'
+          git config user.email 'github-actions[bot]@users.noreply.github.com'
+
+      - name: Update Copyright Date Range in LICENSE
+        run: |
+          function log_error_and_exit() {
+              local problem_description="$1"
+              printf '%s\n' '🚨LICENSE UPDATE FAILED🚨' "ERROR: $problem_description."
+              exit 1
+          }
+
+          year=$( date +%Y )
+
+          sed -i -E "s/(Copyright © [0-9]{4})-[0-9]{4}(.*)/\1-$year\2/" ./LICENSE ||
+              log_error_and_exit 'sed command exited with non-zero exit code'
+
+          git add ./LICENSE
+
+          git commit -m "chore(license): update copyright date range to include $year" ||
+              log_error_and_exit 'git commit command exited with non-zero exit code'
+
+          echo '✅ License Copyright date range successfully updated.'

.github/workflows/cicd.yaml

@@ -33,13 +33,13 @@ jobs:
       id-token: write #     to enable use of OIDC for npm provenance
       issues: write #       to be able to comment on released issues
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v5
         with:
           persist-credentials: false
 
       - uses: actions/setup-node@v4
         with:
-          node-version-file: ".nvmrc"
+          node-version-file: .nvmrc
 
       - name: Install Dependencies
         run: npm ci --include=dev

.github/workflows/test.yaml

@@ -21,11 +21,11 @@ jobs:
     permissions:
       contents: read # to checkout the code
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v5
 
       - uses: actions/setup-node@v4
         with:
-          node-version-file: ".nvmrc"
+          node-version-file: .nvmrc
 
       - name: Install Dependencies
         run: npm ci --include=dev
@@ -51,7 +51,7 @@ jobs:
     needs: run-tests # run job if tests passed
     if: needs.run-tests.outputs.success == 'true'
     steps:
-      - uses: actions/download-artifact@v4
+      - uses: actions/download-artifact@v5
         with: { name: test-coverage-reports }
       - uses: codecov/codecov-action@v4
         with:
@@ -66,9 +66,9 @@ jobs:
       contents: write #      to auto-merge dependabot PRs
       pull-requests: write # to update the PR
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v5
       - name: Download Test Coverage Reports
-        uses: actions/download-artifact@v4
+        uses: actions/download-artifact@v5
         with: { name: test-coverage-reports, path: ./coverage }
       - name: Add Vitest Test Coverage Report to PR
         uses: davelosert/vitest-coverage-report-action@v2
@@ -84,28 +84,20 @@ jobs:
   update-github-commit-status:
     name: 📡 Update GitHub Commit Status
     runs-on: ubuntu-latest
-    needs: run-tests # run job if the workflow has not been cancelled
+    needs: run-tests # always run job unless the workflow was cancelled
     if: ${{ !cancelled() }}
     permissions:
       statuses: write # to update commit status
     steps:
       - run: |
-          if [ ${{ needs.run-tests.outputs.success }} == 'true' ]; then
-              commit_status_state='success'
-              description='Tests passed'
-          else
-              commit_status_state='failure'
-              description='Tests failed'
-          fi
-
           curl --request POST \
               --url https://api.github.com/repos/${{ github.repository }}/statuses/${{ github.sha }} \
               --header 'Authorization: Bearer ${{ secrets.GITHUB_TOKEN }}' \
               --header 'Accept: application/vnd.github+json' \
               --header 'X-GitHub-Api-Version: 2022-11-28' \
               --data "{
                   \"context\": \"tests\",
-                  \"state\": \"$commit_status_state\",
-                  \"description\": \"$description\",
+                  \"state\": \"${{ needs.run-tests.result }}\",
+                  \"description\": \"Tests ${{ needs.run-tests.result == 'success' && 'passed' || 'failed' }}\",
                   \"target_url\": \"https://github.com/${{ github.repository }}/actions/runs/${{ github.run_id }}\"
               }"

.nvmrc

@@ -1 +1 @@
-v22
+v22.19

CHANGELOG.md

@@ -4,6 +4,8 @@ All notable changes to this project will be documented in this file.
 
 ---
 
+## [1.9.2-next.1](https://github.com/Nerdware-LLC/ts-string-helpers/compare/v1.9.1...v1.9.2-next.1) (2025-12-15)
+
 ## [1.9.1](https://github.com/Nerdware-LLC/ts-string-helpers/compare/v1.9.0...v1.9.1) (2025-03-06)
 
 ## [1.9.1-next.1](https://github.com/Nerdware-LLC/ts-string-helpers/compare/v1.9.0...v1.9.1-next.1) (2025-03-06)

LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2024-2025 Trevor Anderson
+Copyright © 2024-2025 Trevor Anderson
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

eslint.config.js

@@ -1,51 +1,86 @@
 import eslintJS from "@eslint/js";
 import stylisticPlugin from "@stylistic/eslint-plugin";
 import vitestPlugin from "@vitest/eslint-plugin";
+import { defineConfig } from "eslint/config";
 import eslintConfigPrettier from "eslint-config-prettier";
-import importPlugin from "eslint-plugin-import-x";
+import { createTypeScriptImportResolver } from "eslint-import-resolver-typescript";
+import {
+  importX as importXPlugin,
+  createNodeResolver,
+} from "eslint-plugin-import-x";
 import nodePlugin from "eslint-plugin-n";
 import globals from "globals";
 import tsEslint from "typescript-eslint";
 
-export default tsEslint.config(
-  ///////////////////////////////////////////////////////////////////
-  // ALL FILES
+// Shared constants:
+const PARSED_EXTENSIONS = [".ts", ".js"];
+
+export default defineConfig(
+  /////////////////////////////////////////////////////////////////////////////
+  // GLOBAL CONFIGS
   {
-    files: ["src/**/*.ts", "./*.[tj]s"],
-    linterOptions: { reportUnusedDisableDirectives: true },
+    name: "global/ignores",
+    ignores: ["**/node_modules/", "**/coverage/", "**/dist/"],
+  },
+  {
+    name: "global/languageOptions",
     languageOptions: {
       ecmaVersion: "latest",
       sourceType: "module",
-      globals: globals.node,
       parser: tsEslint.parser,
       parserOptions: {
         projectService: true,
         tsconfigRootDir: import.meta.dirname,
       },
     },
+  },
+  {
+    name: "global/linterOptions",
+    linterOptions: {
+      reportUnusedDisableDirectives: true,
+    },
+  },
+  {
+    name: "global/plugins",
     plugins: {
       "@stylistic": stylisticPlugin,
       "@typescript-eslint": tsEslint.plugin,
-      "import-x": importPlugin,
+      "import-x": importXPlugin,
       "n": nodePlugin,
+      "vitest": vitestPlugin,
     },
     settings: {
-      "import-x/extensions": [".ts", ".js"],
+      ...importXPlugin.configs.typescript.settings,
+      "import-x/extensions": PARSED_EXTENSIONS,
       "import-x/parsers": {
-        "@typescript-eslint/parser": [".ts", ".js"],
+        "@typescript-eslint/parser": PARSED_EXTENSIONS,
       },
-      "import-x/resolver": {
-        node: { extensions: [".ts", ".js"] },
-        typescript: { project: ["tsconfig.json"] },
+      "import-x/resolver-next": [
+        createTypeScriptImportResolver({ alwaysTryTypes: true }),
+        createNodeResolver({ extensions: PARSED_EXTENSIONS }),
+      ],
+      "n": {
+        // Runtime nodejs version !== dev nodejs version
+        version: ">=22.19.0",
       },
     },
+  },
+  /////////////////////////////////////////////////////////////////////////////
+  // ALL FILES
+  {
+    name: "files:all/base",
+    files: ["src/**/*.ts", "./*.[tj]s"],
+    languageOptions: {
+      globals: globals.node,
+    },
     rules: {
       // MERGE PRESETS:
       ...stylisticPlugin.configs.customize(
         { semi: true, quotes: "double", arrowParens: true, braceStyle: "1tbs" } // prettier-ignore
       ).rules,
       ...eslintJS.configs.recommended.rules,
-      ...importPlugin.configs.recommended.rules,
+      ...importXPlugin.configs.recommended.rules,
+      ...importXPlugin.configs.typescript.rules,
       ...nodePlugin.configs["flat/recommended-module"].rules,
       ...[
         ...tsEslint.configs.strictTypeChecked,
@@ -75,7 +110,7 @@ export default tsEslint.config(
       "import-x/order": [
         "warn",
         {
-          "groups": ["builtin", "external", "internal", "parent", "sibling", "type"], // prettier-ignore
+          "groups": ["builtin", "external", "internal", "parent", ["index", "sibling"], "type"], // prettier-ignore
           "alphabetize": { order: "asc", orderImportKind: "desc" },
           "newlines-between": "never",
         },
@@ -93,22 +128,19 @@ export default tsEslint.config(
       ...eslintConfigPrettier.rules,
     },
   },
-  ///////////////////////////////////////////////////////////////////
+  /////////////////////////////////////////////////////////////////////////////
   // TEST FILES
   {
     files: ["src/**/*.test.ts"],
     languageOptions: {
       globals: vitestPlugin.environments.env.globals,
     },
-    plugins: {
-      vitest: vitestPlugin,
-    },
     rules: {
       ...vitestPlugin.configs.recommended.rules,
       "vitest/no-disabled-tests": "warn",
       "vitest/no-focused-tests": "warn",
       "vitest/valid-expect": "warn",
     },
   }
-  ///////////////////////////////////////////////////////////////////
+  /////////////////////////////////////////////////////////////////////////////
 );