Vue3 migration

.codespellrc

@@ -1,6 +1,6 @@
 [codespell]
 # Ref: https://github.com/codespell-project/codespell#using-a-config-file
-skip = .git*,*.svg,*.css,*.min.*,.codespellrc
+skip = .git*,*.svg,*.css,*.min.*,.codespellrc,package-lock.json,dist,coverage,node_modules
 check-hidden = true
 # case sensitive etc, also assume very long lines manufactured
 ignore-regex = \b(afterAll|userR|Leary|thirdParty)\b|.{300,}|keywords: ".*

.eslintrc.js

@@ -2,71 +2,100 @@ module.exports = {
   root: true,
   env: {
     node: true,
-    jest: true
+    es2022: true,
   },
-  "extends": [
-    "plugin:vue/recommended",
-    "eslint:recommended"
+  extends: [
+    "plugin:vue/vue3-recommended",
+    "eslint:recommended",
+    "plugin:vue/base",
+    "plugin:vuetify/base",
+    "prettier",
   ],
-  "plugins": ["simple-import-sort"],
   rules: {
-    'no-console': process.env.NODE_ENV === "production" ? "error" : "off",
-    'no-debugger': process.env.NODE_ENV === "production" ? "error" : "off",
-    "simple-import-sort/imports": "error",
-    "simple-import-sort/exports": "error",
-    'vue/multi-word-component-names': "off",
-    "vue/order-in-components": ["error", {
-	"order": [
-	"el",
-        "name",
-        "key",
-        "parent",
-		"functional",
-        ["delimiters", "comments"],
-        ["components", "directives", "filters"],
-        "extends",
-        "mixins",
-        ["provide", "inject"],
-        "ROUTER_GUARDS",
-        "layout",
-        "middleware",
-        "validate",
-        "scrollToTop",
-        "transition",
-        "loading",
-        "inheritAttrs",
-        "model",
-        ["props", "propsData"],
-        "emits",
-        "setup",
-        "asyncData",
-        "data",
-        "fetch",
-        "head",
-        "computed",
-        "watch",
-        "watchQuery",
-        "LIFECYCLE_HOOKS",
-        "methods",
-        ["template", "render"],
-        "renderError"
-    ]
-    }
-  ]
+    "no-console": process.env.VITE_NODE_ENV === "production" ? "error" : "off",
+    "no-debugger": process.env.VITE_NODE_ENV === "production" ? "error" : "off",
+    "vue/multi-word-component-names": "off",
+    "quote-props": ["error", "as-needed"],
+    "vue/order-in-components": [
+      "error",
+      {
+        order: [
+          "el",
+          "name",
+          "key",
+          "parent",
+          "functional",
+          ["delimiters", "comments"],
+          ["components", "directives", "filters"],
+          "extends",
+          "mixins",
+          ["provide", "inject"],
+          "ROUTER_GUARDS",
+          "layout",
+          "middleware",
+          "validate",
+          "scrollToTop",
+          "transition",
+          "loading",
+          "inheritAttrs",
+          "model",
+          ["props", "propsData"],
+          "emits",
+          "setup",
+          "asyncData",
+          "data",
+          "beforeRouteEnter",
+          "fetch",
+          "head",
+          "computed",
+          "watch",
+          "watchQuery",
+          "LIFECYCLE_HOOKS",
+          "methods",
+          ["template", "render"],
+          "renderError",
+        ],
+      },
+    ],
+    "brace-style": [
+      "error",
+      "stroustrup",
+      {
+        allowSingleLine: true,
+      },
+    ],
+    indent: ["error", 2],
+    "space-in-parens": ["error", "never"],
   },
   parser: "vue-eslint-parser",
   parserOptions: {
-    parser: "@babel/eslint-parser"
+    // parser: '@babel/eslint-parser',
+    // babelOptions: {
+    //   parserOpts: {
+    //     plugins: ["jsx"]
+    //   }
+    // }
   },
   overrides: [
     {
       files: [
         "**/__tests__/*.{j,t}s?(x)",
-        "**/tests/unit/**/*.spec.{j,t}s?(x)"
+        "**/tests/unit/**/*.spec.{j,t}s?(x)",
       ],
       env: {
-        jest: true
-      }
-    }
-  ]
+        // jest: true
+        // vitest: true,
+      },
+    },
+  ],
+  globals: {
+    describe: "readonly",
+    it: "readonly",
+    expect: "readonly",
+    vi: "readonly",
+    beforeEach: "readonly",
+    afterEach: "readonly",
+    beforeAll: "readonly",
+    afterAll: "readonly"
+  }
 };

.github/workflows/documentation.yml

@@ -3,24 +3,24 @@ name: Doc
 on:
   push:
     branches-ignore:
-    - 'master'
+      - 'master'
 
 jobs:
   build:
     runs-on: ubuntu-latest
     steps:
-    - uses: actions/checkout@v3
-    - uses: actions/setup-node@v3
-      with:
-        node-version: '16.x'
-    - name: Install Dependencies
-      run: npm install
-    - name: Run the documentation
-      run: npm run doc:full
-    - name: Commit changes
-      uses: elstudio/actions-js-build/commit@v2
-      with:
-        commitMessage: 'Autogenerated documentation files'
-        wdPath: documentation
-      env:
-        GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: '20.x'
+      - name: Install Dependencies
+        run: npm install
+      - name: Run the documentation
+        run: npm run doc:full
+      - name: Commit changes
+        uses: elstudio/actions-js-build/commit@v2
+        with:
+          commitMessage: 'Autogenerated documentation files'
+          wdPath: documentation
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

.github/workflows/njsscan-analysis.yml

@@ -15,7 +15,7 @@ jobs:
     name: njsscan code scanning
     steps:
       - name: Checkout the code
-        uses: actions/checkout@v3
+        uses: actions/checkout@v4
       - name: nodejsscan scan
         id: njsscan
         uses: ajinabraham/njsscan-action@master

.github/workflows/unit_tests.yml

@@ -1,25 +1,49 @@
-name: Build
+name: Test and Coverage
 
-on: [push]
+on: [ push, pull_request ]
+
+# CRITICAL: Give the action permission to write PR comments
+permissions:
+  pull-requests: write
+  contents: read
 
 jobs:
   build:
 
     runs-on: ubuntu-latest
 
     steps:
-    - uses: actions/checkout@v3
-    - uses: actions/setup-node@v3
-      with:
-        node-version: '16.x'
-    - name: Install Dependencies
-      run: npm install
-    - name: Run npm unit tests
-      run: npm run test:unit
-    - name: Update coverage to coveralls
-      uses: coverallsapp/github-action@master
-      with:
-        github-token: ${{ secrets.GITHUB_TOKEN }}
-        path-to-lcov: './coverage/lcov.info'
-    - name: Update coverage to codacy
-      run: npm run codacy ${{ secrets.CODACY_PROJECT_TOKEN }}
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: '20.x'
+          # Optional: Speeds up the workflow
+          cache: 'npm'
+      - name: Install Dependencies
+        # 'npm ci' is strictly better than 'npm install' for pipelines
+        run: npm ci
+      # 1. Run the test script
+      - name: Run Tests with Coverage
+        run: npm run test:coverage
+
+      # 2. Add the PR Comment Action
+      - name: Report Coverage in PR
+        if: always() # Run even if coverage drops below 90%
+        uses: davelosert/vitest-coverage-report-action@v2
+
+      # 3. Upload to Coveralls
+      # This uses the official Codacy Action
+      - name: Update coverage to coveralls
+        if: always() # CRITICAL: Uploads report even if the 90% threshold fails
+        uses: coverallsapp/github-action@master
+        with:
+          github-token: ${{ secrets.GITHUB_TOKEN }}
+          path-to-lcov: './coverage/lcov.info'
+      # 3. Upload to Codacy
+      # This uses the official Codacy Action
+      - name: Run Codacy Coverage Reporter
+        if: always() # CRITICAL: Uploads report even if the 90% threshold fails
+        uses: codacy/codacy-coverage-reporter-action@v1
+        with:
+          project-token: ${{ secrets.CODACY_PROJECT_TOKEN }}
+          coverage-reports: coverage/lcov.info

.gitignore

@@ -3,9 +3,10 @@ node_modules
 docTemp
 /dist
 /source/index.html
-package-lock.json
+# package-lock.json //npm ci is strictly designed for automated environments and requires a package-lock.json
 coverage
 out
+yarn.lock
 
 # local env files
 .env.local

.nvmrc

@@ -0,0 +1 @@
+20.16.0

.prettierignore

@@ -0,0 +1,16 @@
+# Ignore artifacts:
+build
+coverage
+
+# Ignore all HTML files:
+**/*.html
+documentation/*
+.eslintrc.js
+.github/*
+babel.config.js
+package.json
+README.md
+vite.config.mjs
+vitest.config.js
+vue.config.js
+webpack.config.js

.stylelintrc.json

@@ -0,0 +1,12 @@
+{
+  "plugins": ["stylelint-scss"],
+  "rules": {
+    "at-rule-no-unknown": null,
+    "scss/at-rule-no-unknown": [
+      true,
+      {
+        "ignoreAtRules": ["tailwind", "keyframes"]
+      }
+    ]
+  }
+}

documentation/doc.conf.json

@@ -1,7 +1,6 @@
 {
   "plugins": [
     "node_modules/jsdoc-vuejs",
-    "jsdoc-vuex-plugin",
     "plugins/markdown"
   ],
   "source": {

documentation/html/ExternalRESTClients.html

@@ -161,7 +161,7 @@ <h4 class="name" id="ExternalRESTClients"><span class="type-signature"></span>ne
 		<ul class="dummy">
 			<li>
 				<a href="lib_Client_ExternalClients.js.html">lib/Client/ExternalClients.js</a>,
-				 <a href="lib_Client_ExternalClients.js.html#sunlight-1-line-9">line 9</a>
+				 <a href="lib_Client_ExternalClients.js.html#sunlight-1-line-8">line 8</a>
 			</li>
 		</ul>
 	</dd>
@@ -311,7 +311,7 @@ <h5>Parameters:</h5>
 		<ul class="dummy">
 			<li>
 				<a href="lib_Client_ExternalClients.js.html">lib/Client/ExternalClients.js</a>,
-				 <a href="lib_Client_ExternalClients.js.html#sunlight-1-line-82">line 82</a>
+				 <a href="lib_Client_ExternalClients.js.html#sunlight-1-line-83">line 83</a>
 			</li>
 		</ul>
 	</dd>
@@ -414,7 +414,7 @@ <h4 class="modal-title">Search results</h4>
 <span class="jsdoc-message">
 	Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 4.0.5</a>
 
-		on Fri Mar 20th 2026
+		on Fri Apr 10th 2026
 
 	using the <a href="https://github.com/docstrap/docstrap">DocStrap template</a>.
 </span>