ci/cd: install buildx to fix deprecated warning

mac, linux, win: fix dead URLs and improve docs
This commit fixes dead URLs and updates documentation references, improving accuracy and reliability. Key changes: - Fix dead URLs by using archived snapshots when they are detected as down by tests. - Update URLs to their new redirected locations. Other supporting changes: - Introduce long URLs for `archive.ph` links to retain the original URLs within the documentation. It simplifies the maintenance by removing the need to document the original locations along with the short URLs. - Improve some of the documentation to use more current sources, replacing the outdated ones.
2024-03-22 00:39:07 +01:00 · 2024-03-21 22:11:31 +01:00 · 2024-03-20 08:38:23 +01:00 · 2024-03-19 09:09:29 +01:00 · 2024-03-18 11:55:56 +01:00 · 2024-03-17 21:40:23 +01:00
26 changed files with 1137 additions and 1124 deletions
--- a/.github/workflows/checks.build.yaml
+++ b/.github/workflows/checks.build.yaml
@@ -81,10 +81,15 @@ jobs:
        uses: actions/checkout@v4
      -
        name: Install Docker on macOS
-        if: matrix.os == 'macos' # macOS runner is missing Docker
+        if: matrix.os == 'macos' # macOS runner is missing Docker (see actions/runner-images#17)
        run: |-
          # Install Docker
          brew install docker
+          # Install `buildx` (`docker build` without `buildx` is deprecated)
+          brew install docker-buildx
+          mkdir -p ~/.docker/cli-plugins
+          ln -sfn $(which docker-buildx) ~/.docker/cli-plugins/docker-buildx
+          # docker buildx install # Allow running `docker build` instead of `docker buildx build`
          # Docker on macOS misses daemon due to licensing, so install colima as runtime
          brew install colima
          # Start the daemon
--- a/.github/workflows/checks.external-urls.yaml
+++ b/.github/workflows/checks.external-urls.yaml
@@ -1,7 +1,6 @@
 name: checks.external-urls

 on:
-  push:
  schedule:
    - cron: '0 0 * * 0' # at 00:00 on every Sunday

@@ -21,7 +20,3 @@ jobs:
      -
        name: Test
        run: npm run check:external-urls
-        env:
-          RANDOMIZED_URL_CHECK_LIMIT: "${{ github.event_name == 'push' && '10' || '' }}"
-          # - Scheduled checks has no limits, ensuring thorough testing.
-          # - For push events, triggered by code changes, the amount of URLs are limited to provide quick feedback.
--- a/docs/script-guidelines.md
+++ b/docs/script-guidelines.md
@@ -35,8 +35,8 @@ Key attributes of a good script:
 ## Documentation

 - Use credible and reputable sources for references.
- Use archived links by using [archive.org](https://archive.org) or [archive.today](https://archive.today).
-  - Format archive.today links fully, for example: `https://archive.today/YYYYMMDDhhmmss/https://privacy.sexy`.
+- Use archived links by using [archive.org](https://archive.org) or [archive.ph](https://archive.ph).
+  - Format archive.today links fully, for example: `https://archive.ph/YYYYMMDDhhmmss/https://privacy.sexy`.
 - Explain the default behavior if the script is not executed.

 ## Shared functions
--- a/electron-builder.cjs
+++ b/electron-builder.cjs
@@ -1,8 +1,13 @@
 /* eslint-disable no-template-curly-in-string */

 const { join } = require('node:path');
+const { readdirSync } = require('fs');
 const { electronBundled, electronUnbundled } = require('./dist-dirs.json');

+/**
+* @type {import('electron-builder').Configuration}
+* @see https://www.electron.build/configuration/configuration
+*/
 module.exports = {
  // Common options
  publish: {
@@ -14,7 +19,9 @@ module.exports = {
    output: electronBundled,
  },
  extraMetadata: {
-    main: join(electronUnbundled, 'main/index.cjs'), // do not `path.resolve`, it expects a relative path
+    main: findMainEntryFile(
+      join(electronUnbundled, 'main'), // do not `path.resolve`, it expects a relative path
+    ),
  },

  // Windows
@@ -41,3 +48,15 @@ module.exports = {
    artifactName: '${name}-${version}.${ext}',
  },
 };
+
+/**
+ * Finds by accommodating different JS file extensions and module formats.
+ */
+function findMainEntryFile(parentDirectory) {
+  const files = readdirSync(parentDirectory);
+  const entryFile = files.find((file) => /^index\.(cjs|mjs|js)$/.test(file));
+  if (!entryFile) {
+    throw new Error(`Main entry file not found in ${parentDirectory}.`);
+  }
+  return join(parentDirectory, entryFile);
+}
--- a/electron.vite.config.ts
+++ b/electron.vite.config.ts
@@ -14,7 +14,7 @@ const ELECTRON_DIST_SUBDIRECTORIES = {
  renderer: resolveElectronDistSubdirectory('renderer'),
 };

-process.env.ELECTRON_ENTRY = resolve(ELECTRON_DIST_SUBDIRECTORIES.main, 'index.cjs');
+process.env.ELECTRON_ENTRY = resolve(ELECTRON_DIST_SUBDIRECTORIES.main, 'index.mjs');

 export default defineConfig({
  main: getSharedElectronConfig({
@@ -54,13 +54,23 @@ function getSharedElectronConfig(options: {
      },
      rollupOptions: {
        output: {
-          // Mark: electron-esm-support
-          //  This is needed so `type="module"` works
-          entryFileNames: '[name].cjs',
+          format: 'es',
+
+          // Ensure all generated files use '.mjs' for module consistency.
+          // Otherwise, preloader process get `.mjs` extension but main process get `.js` extension, see https://github.com/alex8088/electron-vite/issues/397.
+          entryFileNames: '[name].mjs',
        },
      },
    },
-    plugins: [externalizeDepsPlugin()],
+    plugins: [externalizeDepsPlugin({
+      exclude: [
+        // Keep 'electron-log' in bundling process.
+        // This is a workaround for inability of Electron's ESM loader to resolve subpath imports.
+        // Do not externalize `electron-log` so subpath imports such as `electron-log/main` works.
+        // See https://github.com/electron/electron/issues/41241, https://github.com/alex8088/electron-vite/issues/401
+        'electron-log',
+      ],
+    })],
    define: {
      ...getClientEnvironmentVariables(),
    },
--- a/package-lock.json
+++ b/package-lock.json
@@ -13,7 +13,7 @@
        "@juggle/resize-observer": "^3.4.0",
        "@types/markdown-it": "^13.0.7",
        "ace-builds": "^1.30.0",
-        "electron-log": "^5.0.1",
+        "electron-log": "^5.1.2",
        "electron-progressbar": "^2.1.0",
        "electron-updater": "^6.1.4",
        "file-saver": "^2.0.5",
@@ -34,8 +34,8 @@
        "@vue/test-utils": "^2.4.1",
        "autoprefixer": "^10.4.16",
        "cypress": "^13.3.1",
-        "electron": "^27.0.0",
-        "electron-builder": "^24.6.4",
+        "electron": "^29.1.4",
+        "electron-builder": "^24.13.3",
        "electron-devtools-installer": "^3.2.0",
        "electron-icon-builder": "^2.0.1",
        "electron-vite": "^2.1.0",
@@ -4879,19 +4879,6 @@
        "electron-builder-squirrel-windows": "24.13.3"
      }
    },
-    "node_modules/app-builder-lib/node_modules/builder-util-runtime": {
-      "version": "9.2.4",
-      "resolved": "https://registry.npmjs.org/builder-util-runtime/-/builder-util-runtime-9.2.4.tgz",
-      "integrity": "sha512-upp+biKpN/XZMLim7aguUyW8s0FUpDvOtK6sbanMFDAMBzpHDqdhgVYm6zc9HJ6nWo7u2Lxk60i2M6Jd3aiNrA==",
-      "dev": true,
-      "dependencies": {
-        "debug": "^4.3.4",
-        "sax": "^1.2.4"
-      },
-      "engines": {
-        "node": ">=12.0.0"
-      }
-    },
    "node_modules/app-builder-lib/node_modules/form-data": {
      "version": "4.0.0",
      "resolved": "https://registry.npmjs.org/form-data/-/form-data-4.0.0.tgz",
@@ -5718,9 +5705,9 @@
      }
    },
    "node_modules/builder-util-runtime": {
-      "version": "9.2.1",
-      "resolved": "https://registry.npmjs.org/builder-util-runtime/-/builder-util-runtime-9.2.1.tgz",
-      "integrity": "sha512-2rLv/uQD2x+dJ0J3xtsmI12AlRyk7p45TEbE/6o/fbb633e/S3pPgm+ct+JHsoY7r39dKHnGEFk/AASRFdnXmA==",
+      "version": "9.2.4",
+      "resolved": "https://registry.npmjs.org/builder-util-runtime/-/builder-util-runtime-9.2.4.tgz",
+      "integrity": "sha512-upp+biKpN/XZMLim7aguUyW8s0FUpDvOtK6sbanMFDAMBzpHDqdhgVYm6zc9HJ6nWo7u2Lxk60i2M6Jd3aiNrA==",
      "dependencies": {
        "debug": "^4.3.4",
        "sax": "^1.2.4"
@@ -5744,19 +5731,6 @@
        "url": "https://github.com/chalk/ansi-styles?sponsor=1"
      }
    },
-    "node_modules/builder-util/node_modules/builder-util-runtime": {
-      "version": "9.2.4",
-      "resolved": "https://registry.npmjs.org/builder-util-runtime/-/builder-util-runtime-9.2.4.tgz",
-      "integrity": "sha512-upp+biKpN/XZMLim7aguUyW8s0FUpDvOtK6sbanMFDAMBzpHDqdhgVYm6zc9HJ6nWo7u2Lxk60i2M6Jd3aiNrA==",
-      "dev": true,
-      "dependencies": {
-        "debug": "^4.3.4",
-        "sax": "^1.2.4"
-      },
-      "engines": {
-        "node": ">=12.0.0"
-      }
-    },
    "node_modules/builder-util/node_modules/chalk": {
      "version": "4.1.2",
      "resolved": "https://registry.npmjs.org/chalk/-/chalk-4.1.2.tgz",
@@ -7140,19 +7114,6 @@
        "dmg-license": "^1.0.11"
      }
    },
-    "node_modules/dmg-builder/node_modules/builder-util-runtime": {
-      "version": "9.2.4",
-      "resolved": "https://registry.npmjs.org/builder-util-runtime/-/builder-util-runtime-9.2.4.tgz",
-      "integrity": "sha512-upp+biKpN/XZMLim7aguUyW8s0FUpDvOtK6sbanMFDAMBzpHDqdhgVYm6zc9HJ6nWo7u2Lxk60i2M6Jd3aiNrA==",
-      "dev": true,
-      "dependencies": {
-        "debug": "^4.3.4",
-        "sax": "^1.2.4"
-      },
-      "engines": {
-        "node": ">=12.0.0"
-      }
-    },
    "node_modules/dmg-builder/node_modules/fs-extra": {
      "version": "10.1.0",
      "resolved": "https://registry.npmjs.org/fs-extra/-/fs-extra-10.1.0.tgz",
@@ -7347,14 +7308,14 @@
      }
    },
    "node_modules/electron": {
-      "version": "27.0.0",
-      "resolved": "https://registry.npmjs.org/electron/-/electron-27.0.0.tgz",
-      "integrity": "sha512-mr3Zoy82l8XKK/TgguE5FeNeHZ9KHXIGIpUMjbjZWIREfAv+X2Q3vdX6RG0Pmi1K23AFAxANXQezIHBA2Eypwg==",
+      "version": "29.1.4",
+      "resolved": "https://registry.npmjs.org/electron/-/electron-29.1.4.tgz",
+      "integrity": "sha512-IWXys0SqgmIfrqXusUGQC0gGG7CCqA5vfmNsUMj8dFkAnK3lisKyjSESStWlrsste/OX/AAC5wsVlf23reUNnw==",
      "dev": true,
      "hasInstallScript": true,
      "dependencies": {
        "@electron/get": "^2.0.0",
-        "@types/node": "^18.11.18",
+        "@types/node": "^20.9.0",
        "extract-zip": "^2.0.1"
      },
      "bin": {
@@ -7433,19 +7394,6 @@
        "url": "https://github.com/chalk/ansi-styles?sponsor=1"
      }
    },
-    "node_modules/electron-builder/node_modules/builder-util-runtime": {
-      "version": "9.2.4",
-      "resolved": "https://registry.npmjs.org/builder-util-runtime/-/builder-util-runtime-9.2.4.tgz",
-      "integrity": "sha512-upp+biKpN/XZMLim7aguUyW8s0FUpDvOtK6sbanMFDAMBzpHDqdhgVYm6zc9HJ6nWo7u2Lxk60i2M6Jd3aiNrA==",
-      "dev": true,
-      "dependencies": {
-        "debug": "^4.3.4",
-        "sax": "^1.2.4"
-      },
-      "engines": {
-        "node": ">=12.0.0"
-      }
-    },
    "node_modules/electron-builder/node_modules/chalk": {
      "version": "4.1.2",
      "resolved": "https://registry.npmjs.org/chalk/-/chalk-4.1.2.tgz",
@@ -7565,9 +7513,9 @@
      }
    },
    "node_modules/electron-log": {
-      "version": "5.0.1",
-      "resolved": "https://registry.npmjs.org/electron-log/-/electron-log-5.0.1.tgz",
-      "integrity": "sha512-x4wnwHg00h/onWQgjmvcdLV7Mrd9TZjxNs8LmXVpqvANDf4FsSs5wLlzOykWLcaFzR3+5hdVEQ8ctmrUxgHlPA==",
+      "version": "5.1.2",
+      "resolved": "https://registry.npmjs.org/electron-log/-/electron-log-5.1.2.tgz",
+      "integrity": "sha512-Cpg4hAZ27yM9wzE77c4TvgzxzavZ+dVltCczParXN+Vb3jocojCSAuSMCVOI9fhFuuOR+iuu3tZLX1cu0y0kgQ==",
      "engines": {
        "node": ">= 14"
      }
@@ -7610,19 +7558,6 @@
        "url": "https://github.com/chalk/ansi-styles?sponsor=1"
      }
    },
-    "node_modules/electron-publish/node_modules/builder-util-runtime": {
-      "version": "9.2.4",
-      "resolved": "https://registry.npmjs.org/builder-util-runtime/-/builder-util-runtime-9.2.4.tgz",
-      "integrity": "sha512-upp+biKpN/XZMLim7aguUyW8s0FUpDvOtK6sbanMFDAMBzpHDqdhgVYm6zc9HJ6nWo7u2Lxk60i2M6Jd3aiNrA==",
-      "dev": true,
-      "dependencies": {
-        "debug": "^4.3.4",
-        "sax": "^1.2.4"
-      },
-      "engines": {
-        "node": ">=12.0.0"
-      }
-    },
    "node_modules/electron-publish/node_modules/chalk": {
      "version": "4.1.2",
      "resolved": "https://registry.npmjs.org/chalk/-/chalk-4.1.2.tgz",
@@ -7699,11 +7634,11 @@
      "dev": true
    },
    "node_modules/electron-updater": {
-      "version": "6.1.4",
-      "resolved": "https://registry.npmjs.org/electron-updater/-/electron-updater-6.1.4.tgz",
-      "integrity": "sha512-yYAJc6RQjjV4WtInZVn+ZcLyXRhbVXoomKEfUUwDqIk5s2wxzLhWaor7lrNgxODyODhipjg4SVPMhJHi5EnsCA==",
+      "version": "6.2.1",
+      "resolved": "https://registry.npmjs.org/electron-updater/-/electron-updater-6.2.1.tgz",
+      "integrity": "sha512-83eKIPW14qwZqUUM6wdsIRwVKZyjmHxQ4/8G+1C6iS5PdDt7b1umYQyj1/qPpH510GmHEQe4q0kCPe3qmb3a0Q==",
      "dependencies": {
-        "builder-util-runtime": "9.2.1",
+        "builder-util-runtime": "9.2.4",
        "fs-extra": "^10.1.0",
        "js-yaml": "^4.1.0",
        "lazy-val": "^1.0.5",
@@ -7755,6 +7690,21 @@
        }
      }
    },
+    "node_modules/electron/node_modules/@types/node": {
+      "version": "20.11.28",
+      "resolved": "https://registry.npmjs.org/@types/node/-/node-20.11.28.tgz",
+      "integrity": "sha512-M/GPWVS2wLkSkNHVeLkrF2fD5Lx5UC4PxA0uZcKc6QqbIQUJyW1jVjueJYi1z8n0I5PxYrtpnPnWglE+y9A0KA==",
+      "dev": true,
+      "dependencies": {
+        "undici-types": "~5.26.4"
+      }
+    },
+    "node_modules/electron/node_modules/undici-types": {
+      "version": "5.26.5",
+      "resolved": "https://registry.npmjs.org/undici-types/-/undici-types-5.26.5.tgz",
+      "integrity": "sha512-JlCMO+ehdEIKqlFxk6IfVoAUVmgz7cU7zD/h9XZ0qzeosSHmUJVOzSQvvYSYWXkFXC+IfLKSIffhv0sVZup6pA==",
+      "dev": true
+    },
    "node_modules/emoji-regex": {
      "version": "9.2.2",
      "resolved": "https://registry.npmjs.org/emoji-regex/-/emoji-regex-9.2.2.tgz",
@@ -24107,16 +24057,6 @@
        "temp-file": "^3.4.0"
      },
      "dependencies": {
-        "builder-util-runtime": {
-          "version": "9.2.4",
-          "resolved": "https://registry.npmjs.org/builder-util-runtime/-/builder-util-runtime-9.2.4.tgz",
-          "integrity": "sha512-upp+biKpN/XZMLim7aguUyW8s0FUpDvOtK6sbanMFDAMBzpHDqdhgVYm6zc9HJ6nWo7u2Lxk60i2M6Jd3aiNrA==",
-          "dev": true,
-          "requires": {
-            "debug": "^4.3.4",
-            "sax": "^1.2.4"
-          }
-        },
        "form-data": {
          "version": "4.0.0",
          "resolved": "https://registry.npmjs.org/form-data/-/form-data-4.0.0.tgz",
@@ -24751,16 +24691,6 @@
            "color-convert": "^2.0.1"
          }
        },
-        "builder-util-runtime": {
-          "version": "9.2.4",
-          "resolved": "https://registry.npmjs.org/builder-util-runtime/-/builder-util-runtime-9.2.4.tgz",
-          "integrity": "sha512-upp+biKpN/XZMLim7aguUyW8s0FUpDvOtK6sbanMFDAMBzpHDqdhgVYm6zc9HJ6nWo7u2Lxk60i2M6Jd3aiNrA==",
-          "dev": true,
-          "requires": {
-            "debug": "^4.3.4",
-            "sax": "^1.2.4"
-          }
-        },
        "chalk": {
          "version": "4.1.2",
          "resolved": "https://registry.npmjs.org/chalk/-/chalk-4.1.2.tgz",
@@ -24815,9 +24745,9 @@
      }
    },
    "builder-util-runtime": {
-      "version": "9.2.1",
-      "resolved": "https://registry.npmjs.org/builder-util-runtime/-/builder-util-runtime-9.2.1.tgz",
-      "integrity": "sha512-2rLv/uQD2x+dJ0J3xtsmI12AlRyk7p45TEbE/6o/fbb633e/S3pPgm+ct+JHsoY7r39dKHnGEFk/AASRFdnXmA==",
+      "version": "9.2.4",
+      "resolved": "https://registry.npmjs.org/builder-util-runtime/-/builder-util-runtime-9.2.4.tgz",
+      "integrity": "sha512-upp+biKpN/XZMLim7aguUyW8s0FUpDvOtK6sbanMFDAMBzpHDqdhgVYm6zc9HJ6nWo7u2Lxk60i2M6Jd3aiNrA==",
      "requires": {
        "debug": "^4.3.4",
        "sax": "^1.2.4"
@@ -25829,16 +25759,6 @@
        "js-yaml": "^4.1.0"
      },
      "dependencies": {
-        "builder-util-runtime": {
-          "version": "9.2.4",
-          "resolved": "https://registry.npmjs.org/builder-util-runtime/-/builder-util-runtime-9.2.4.tgz",
-          "integrity": "sha512-upp+biKpN/XZMLim7aguUyW8s0FUpDvOtK6sbanMFDAMBzpHDqdhgVYm6zc9HJ6nWo7u2Lxk60i2M6Jd3aiNrA==",
-          "dev": true,
-          "requires": {
-            "debug": "^4.3.4",
-            "sax": "^1.2.4"
-          }
-        },
        "fs-extra": {
          "version": "10.1.0",
          "resolved": "https://registry.npmjs.org/fs-extra/-/fs-extra-10.1.0.tgz",
@@ -25989,14 +25909,31 @@
      }
    },
    "electron": {
-      "version": "27.0.0",
-      "resolved": "https://registry.npmjs.org/electron/-/electron-27.0.0.tgz",
-      "integrity": "sha512-mr3Zoy82l8XKK/TgguE5FeNeHZ9KHXIGIpUMjbjZWIREfAv+X2Q3vdX6RG0Pmi1K23AFAxANXQezIHBA2Eypwg==",
+      "version": "29.1.4",
+      "resolved": "https://registry.npmjs.org/electron/-/electron-29.1.4.tgz",
+      "integrity": "sha512-IWXys0SqgmIfrqXusUGQC0gGG7CCqA5vfmNsUMj8dFkAnK3lisKyjSESStWlrsste/OX/AAC5wsVlf23reUNnw==",
      "dev": true,
      "requires": {
        "@electron/get": "^2.0.0",
-        "@types/node": "^18.11.18",
+        "@types/node": "^20.9.0",
        "extract-zip": "^2.0.1"
+      },
+      "dependencies": {
+        "@types/node": {
+          "version": "20.11.28",
+          "resolved": "https://registry.npmjs.org/@types/node/-/node-20.11.28.tgz",
+          "integrity": "sha512-M/GPWVS2wLkSkNHVeLkrF2fD5Lx5UC4PxA0uZcKc6QqbIQUJyW1jVjueJYi1z8n0I5PxYrtpnPnWglE+y9A0KA==",
+          "dev": true,
+          "requires": {
+            "undici-types": "~5.26.4"
+          }
+        },
+        "undici-types": {
+          "version": "5.26.5",
+          "resolved": "https://registry.npmjs.org/undici-types/-/undici-types-5.26.5.tgz",
+          "integrity": "sha512-JlCMO+ehdEIKqlFxk6IfVoAUVmgz7cU7zD/h9XZ0qzeosSHmUJVOzSQvvYSYWXkFXC+IfLKSIffhv0sVZup6pA==",
+          "dev": true
+        }
      }
    },
    "electron-builder": {
@@ -26027,16 +25964,6 @@
            "color-convert": "^2.0.1"
          }
        },
-        "builder-util-runtime": {
-          "version": "9.2.4",
-          "resolved": "https://registry.npmjs.org/builder-util-runtime/-/builder-util-runtime-9.2.4.tgz",
-          "integrity": "sha512-upp+biKpN/XZMLim7aguUyW8s0FUpDvOtK6sbanMFDAMBzpHDqdhgVYm6zc9HJ6nWo7u2Lxk60i2M6Jd3aiNrA==",
-          "dev": true,
-          "requires": {
-            "debug": "^4.3.4",
-            "sax": "^1.2.4"
-          }
-        },
        "chalk": {
          "version": "4.1.2",
          "resolved": "https://registry.npmjs.org/chalk/-/chalk-4.1.2.tgz",
@@ -26157,9 +26084,9 @@
      }
    },
    "electron-log": {
-      "version": "5.0.1",
-      "resolved": "https://registry.npmjs.org/electron-log/-/electron-log-5.0.1.tgz",
-      "integrity": "sha512-x4wnwHg00h/onWQgjmvcdLV7Mrd9TZjxNs8LmXVpqvANDf4FsSs5wLlzOykWLcaFzR3+5hdVEQ8ctmrUxgHlPA=="
+      "version": "5.1.2",
+      "resolved": "https://registry.npmjs.org/electron-log/-/electron-log-5.1.2.tgz",
+      "integrity": "sha512-Cpg4hAZ27yM9wzE77c4TvgzxzavZ+dVltCczParXN+Vb3jocojCSAuSMCVOI9fhFuuOR+iuu3tZLX1cu0y0kgQ=="
    },
    "electron-progressbar": {
      "version": "2.1.0",
@@ -26193,16 +26120,6 @@
            "color-convert": "^2.0.1"
          }
        },
-        "builder-util-runtime": {
-          "version": "9.2.4",
-          "resolved": "https://registry.npmjs.org/builder-util-runtime/-/builder-util-runtime-9.2.4.tgz",
-          "integrity": "sha512-upp+biKpN/XZMLim7aguUyW8s0FUpDvOtK6sbanMFDAMBzpHDqdhgVYm6zc9HJ6nWo7u2Lxk60i2M6Jd3aiNrA==",
-          "dev": true,
-          "requires": {
-            "debug": "^4.3.4",
-            "sax": "^1.2.4"
-          }
-        },
        "chalk": {
          "version": "4.1.2",
          "resolved": "https://registry.npmjs.org/chalk/-/chalk-4.1.2.tgz",
@@ -26263,11 +26180,11 @@
      "dev": true
    },
    "electron-updater": {
-      "version": "6.1.4",
-      "resolved": "https://registry.npmjs.org/electron-updater/-/electron-updater-6.1.4.tgz",
-      "integrity": "sha512-yYAJc6RQjjV4WtInZVn+ZcLyXRhbVXoomKEfUUwDqIk5s2wxzLhWaor7lrNgxODyODhipjg4SVPMhJHi5EnsCA==",
+      "version": "6.2.1",
+      "resolved": "https://registry.npmjs.org/electron-updater/-/electron-updater-6.2.1.tgz",
+      "integrity": "sha512-83eKIPW14qwZqUUM6wdsIRwVKZyjmHxQ4/8G+1C6iS5PdDt7b1umYQyj1/qPpH510GmHEQe4q0kCPe3qmb3a0Q==",
      "requires": {
-        "builder-util-runtime": "9.2.1",
+        "builder-util-runtime": "9.2.4",
        "fs-extra": "^10.1.0",
        "js-yaml": "^4.1.0",
        "lazy-val": "^1.0.5",
--- a/package.json
+++ b/package.json
@@ -37,7 +37,7 @@
    "@juggle/resize-observer": "^3.4.0",
    "@types/markdown-it": "^13.0.7",
    "ace-builds": "^1.30.0",
-    "electron-log": "^5.0.1",
+    "electron-log": "^5.1.2",
    "electron-progressbar": "^2.1.0",
    "electron-updater": "^6.1.4",
    "file-saver": "^2.0.5",
@@ -58,8 +58,8 @@
    "@vue/test-utils": "^2.4.1",
    "autoprefixer": "^10.4.16",
    "cypress": "^13.3.1",
-    "electron": "^27.0.0",
-    "electron-builder": "^24.6.4",
+    "electron": "^29.1.4",
+    "electron-builder": "^24.13.3",
    "electron-devtools-installer": "^3.2.0",
    "electron-icon-builder": "^2.0.1",
    "electron-vite": "^2.1.0",
--- a/scripts/verify-build-artifacts.js
+++ b/scripts/verify-build-artifacts.js
@@ -44,8 +44,8 @@ function getBuildVerificationConfigs() {
    '--electron-unbundled': {
      printDistDirScriptArgument: '--electron-unbundled',
      filePatterns: [
-        /main[/\\]index\.cjs/,
-        /preload[/\\]index\.cjs/,
+        /main[/\\]index\.(cjs|mjs|js)/,
+        /preload[/\\]index\.(cjs|mjs|js)/,
        /renderer[/\\]index\.htm(l)?/,
      ],
    },
--- a/src/application/Common/Shuffle.ts
+++ b/src/application/Common/Shuffle.ts
@@ -1,12 +0,0 @@
-/*
-  Shuffle an array of strings, returning a new array with elements in random order.
-  Uses the Fisher-Yates (or Durstenfeld) algorithm.
-*/
-export function shuffle<T>(array: readonly T[]): T[] {
-  const shuffledArray = [...array];
-  for (let i = array.length - 1; i > 0; i--) {
-    const j = Math.floor(Math.random() * (i + 1));
-    [shuffledArray[i], shuffledArray[j]] = [shuffledArray[j], shuffledArray[i]];
-  }
-  return shuffledArray;
-}
--- a/src/application/Parser/Script/Compiler/Expressions/Pipes/PipeDefinitions/InlinePowerShell.ts
+++ b/src/application/Parser/Script/Compiler/Expressions/Pipes/PipeDefinitions/InlinePowerShell.ts
@@ -95,7 +95,7 @@ function getLines(code: string): string[] {

 /*
  Merges inline here-strings to a single lined string with Windows line terminator (\r\n)
-  https://docs.microsoft.com/en-us/powershell/module/microsoft.powershell.core/about/about_quoting_rules#here-strings
+  https://learn.microsoft.com/en-us/powershell/module/microsoft.powershell.core/about/about_quoting_rules?view=powershell-7.4#here-strings
 */
 function mergeHereStrings(code: string) {
  const regex = /@(['"])\s*(?:\r\n|\r|\n)((.|\n|\r)+?)(\r\n|\r|\n)\1@/g;
--- a/src/application/collections/linux.yaml
+++ b/src/application/collections/linux.yaml
@@ -74,7 +74,7 @@ actions:
                - [tcsh source code](https://web.archive.org/web/20221029212024/https://github.com/tcsh-org/tcsh).

                [1]: https://web.archive.org/web/20221029134950/https://linux.die.net/man/1/tcsh "tcsh(1) - Linux man page | linux.die.net"
-                [2]: https://web.archive.org/web/20221029135041/https://books.google.com/books?id=LyDP5b2xzaMC&pg=PA56 "Sams Teach Yourself FreeBSD in 24 Hours - Michael Urban, Brian Tiemann - Google Books | books.google.com"
+                [2]: https://web.archive.org/web/20221029135007/https://books.google.com/books?id=LyDP5b2xzaMC&pg=PA56#v=onepage&q&f=false "Sams Teach Yourself FreeBSD in 24 Hours - Michael Urban, Brian Tiemann - Google Books | books.google.com"
              call:
                function: DeleteFileFromUserAndRootHome
                parameters:
@@ -1733,7 +1733,7 @@ actions:
              See also:
              - [Source code for the Ubuntu Report tool | github.com](https://web.archive.org/web/20221029221854/https://github.com/ubuntu/ubuntu-report/)
              - [Statistics gathered and visualized | ubuntu.com/desktop/statistics](https://web.archive.org/web/20221029221910/https://ubuntu.com/desktop/statistics)
-              - [ubuntu-devel mailing list thread where ubuntu-report was first proposed, | lists.ubuntu.com ](https://web.archive.org/web/20221029221924/https://lists.ubuntu.com/archives/ubuntu-devel/2018-February/040139.html)
+              - [ubuntu-devel mailing list thread where ubuntu-report was first proposed, | lists.ubuntu.com ](https://web.archive.org/web/20221029162523/https://lists.ubuntu.com/archives/ubuntu-devel/2018-February/040139.html)

              [1]: https://web.archive.org/web/20221029162505/https://github.com/ubuntu/ubuntu-report/blob/30e902ebc17e4e10d83392d7cd3dc05fc9e35cc4/README.md "ubuntu-report/README.md at master · ubuntu/ubuntu-report | github.com"
              [2]: https://web.archive.org/web/20221029162538/https://github.com/ubuntu/ubuntu-report/blob/8e6030ff9bbeacacf41a9b58ea638a5c9a6f864d/README.md "More diagnostics data from desktop | lists.ubuntu.com"
@@ -1974,10 +1974,10 @@ actions:

          Read more about Zeitgeist:

-          - [Official website | zeitgeist.freedesktop.org](https://web.archive.org/web/20221029222739/https://zeitgeist.freedesktop.org/)
+          - [Official website | zeitgeist.freedesktop.org](https://web.archive.org/web/20221029150843/https://zeitgeist.freedesktop.org/)
          - [Wikipedia article | en.wikipedia.org](https://web.archive.org/web/20221029222921/https://en.wikipedia.org/wiki/Zeitgeist_%28free_software%29)
          - [Launchpad project page | launchpad.net](https://web.archive.org/web/20221029223026/https://launchpad.net/zeitgeist/)
-          - [ArchWiki article | wiki.archlinux.org](https://web.archive.org/web/20221029223033/https://wiki.archlinux.org/title/Zeitgeist)
+          - [ArchWiki article | wiki.archlinux.org](https://web.archive.org/web/20221029164539/https://wiki.archlinux.org/title/Zeitgeist)

          [1]: https://web.archive.org/web/20221029163704/https://packages.debian.org/en/sid/libdevel/libzeitgeist-2.0-dev "libzeitgeist-2.0-dev | Debian Packages | packages.debian.org"
          [2]: https://web.archive.org/web/20221029163817/https://gitlab.gnome.org/crvi/gnome-activity-journal "crvi / GNOME Activity Journal · GitLab | gitlab.gnome.org"
@@ -2116,7 +2116,7 @@ actions:
          [3]: https://web.archive.org/web/20221029170026/https://packages.ubuntu.com/bionic/all/network-manager-config-connectivity-ubuntu/filelist "Ubuntu - File list of package network-manager-config-connectivity-ubuntu/bionic/all | packages.ubuntu.com"
          [4]: https://web.archive.org/web/20221029170108/https://github.com/pop-os/connectivity/blob/master/debian/20-connectivity-pop.conf "connectivity/20-connectivity-pop.conf at master · pop-os/connectivity | github.com"
          [5]: https://web.archive.org/web/20221029170202/https://cgit.freedesktop.org/NetworkManager/NetworkManager/tree/contrib/fedora/rpm/20-connectivity-fedora.conf "20-connectivity-fedora.conf\rpm\fedora\contrib - NetworkManager/NetworkManager - Network connection manager and user applications | reedesktop.org"
-          [6]: https://web.archive.org/web/20221029170207/https://fedora.pkgs.org/35/fedora-updates-testing-x86_64/NetworkManager-config-connectivity-fedora-1.32.12-1.fc35.noarch.rpm.html "NetworkManager-config-connectivity-fedora | fedora.pkgs.org"
+          [6]: https://archive.ph/2023.12.06-185917/https://pkgs.org/download/NetworkManager-config-connectivity-fedora "Networkmanager-config-connectivity-fedora Download (RPM) | pkgs.org"
        call:
          function: RunIfCommandExists
          parameters:
@@ -2202,7 +2202,7 @@ actions:
            - Diagnostic information about your system and usage is sent to Microsoft servers [3].
            - Your usage data and data about feature performance [3].

-            [1]: https://web.archive.org/web/20221029170818/https://en.wikipedia.org/wiki/Visual_Studio_Code "Visual Studio Code - Wikipedia | en.wikipedia.org"
+            [1]: https://web.archive.org/web/20221029142001/https://en.wikipedia.org/wiki/Visual_Studio_Code "Visual Studio Code - Wikipedia | en.wikipedia.org"
            [2]: https://web.archive.org/web/20221029170840/https://code.visualstudio.com/updates/v1_26#_offline-mode "Visual Studio Code July 2018 | code.visualstudio.com"
            [3]: https://web.archive.org/web/20221029171138/https://code.visualstudio.com/docs/getstarted/telemetry "Visual Studio Code Telemetry | code.visualstudio.com"
        children:
@@ -2697,7 +2697,7 @@ actions:
                      [2]: https://web.archive.org/web/20231003094154/https://bugzilla.mozilla.org/show_bug.cgi?id=1746646 "1746646 - (tcp-mochitests) [meta] Make mochitests work with TCP enabled (cookieBehavior = 5) | bugzilla.mozilla.org"
                      [3]: https://web.archive.org/web/20230918172155/https://developer.mozilla.org/en-US/docs/Web/Privacy/State_Partitioning#disable_dynamic_state_partitioning "State Partitioning - Privacy on the web | MDN"
                      [4]: https://web.archive.org/web/20231003094207/https://bugzilla.mozilla.org/show_bug.cgi?id=1649876#c5 "1649876 - Migrate FPI users to dFPI | bugzilla.mozilla.org"
-                      [5]: https://blog.mozilla.org/en/products/firefox/firefox-rolls-out-total-cookie-protection-by-default-to-all-users-worldwide/ "Firefox Rolls Out Total Cookie Protection By Default"
+                      [5]: https://web.archive.org/web/20231207105610/https://blog.mozilla.org/en/products/firefox/firefox-rolls-out-total-cookie-protection-by-default-to-all-users-worldwide/ "Firefox Rolls Out Total Cookie Protection By Default"
                      [6]: https://web.archive.org/web/20231003094350/https://bugzilla.mozilla.org/show_bug.cgi?id=1631676#c25 "1631676 - Disable dfpi when privacy.firstparty.isolate=true | bugzilla.mozilla.org"
                    call:
                      function: AddFirefoxPrefs
@@ -2887,7 +2887,7 @@ actions:
                  setting [4].

                  [1]: https://web.archive.org/web/20221015102124/https://firefox-source-docs.mozilla.org/toolkit/components/telemetry/internals/preferences.html "Preferences and Defines — Firefox Source Docs documentation | firefox-source-docs.mozilla.org"
-                  [2]: https://web.archive.org/web/20221015102305/https://searchfox.org/mozilla-central/source/modules/libpref/Preferences.cpp#3213
+                  [2]: https://web.archive.org/web/20221015102338/https://searchfox.org/mozilla-central/source/modules/libpref/Preferences.cpp#3213
                  [3]: https://web.archive.org/web/20221015102419/https://bugzilla.mozilla.org/show_bug.cgi?id=1422689#c1
                  [4]: https://web.archive.org/web/20221015102604/https://stigviewer.com/stig/mozilla_firefox/2020-12-10/finding/V-223170
                call:
@@ -3173,7 +3173,7 @@ actions:
              portal is in place and blocking traffic, this feature prevents all other connection attempts,
              possibly revealing your usage habits.

-              See also: [Captive portal | Wikipedia](https://web.archive.org/web/20221029223534/https://en.wikipedia.org/wiki/Captive_portal).
+              See also: [Captive portal | Wikipedia](https://web.archive.org/web/20221029163002/https://en.wikipedia.org/wiki/Captive_portal).

              This script sets `network.captive-portal-service.enabled` to 'false', thereby disabling automatic
              connections [1].
@@ -3207,7 +3207,7 @@ actions:
              There have been concerns about the potential for Google Safe Browsing to be used for censorship
              in the future, although this has not occurred as of yet [3].

-              [1]: https://web.archive.org/web/20221025192643/https://wiki.mozilla.org/Security/Safe_Browsing "Security/Safe Browsing - MozillaWiki | wiki.mozilla.org"
+              [1]: https://web.archive.org/web/20221026164502/https://wiki.mozilla.org/Security/Safe_Browsing "Security/Safe Browsing - MozillaWiki | wiki.mozilla.org"
              [2]: https://web.archive.org/web/20221025193000/https://support.mozilla.org/en-US/kb/how-does-phishing-and-malware-protection-work#w_what-information-is-sent-to-mozilla-or-its-partners-when-phishing-and-malware-protection-is-enabled
              [3]: https://web.archive.org/web/20221025192516/https://www.usnews.com/opinion/articles/2016-06-22/google-is-the-worlds-biggest-censor-and-its-power-must-be-regulated "Google Is the World's Biggest Censor and Its Power Must Be Regulated | usnews.com"
            children:
@@ -3226,7 +3226,7 @@ actions:

                  If this blocking is removed, the user should be knowledgeable about the potential risks and will take precautions.

-                  [1]: https://web.archive.org/web/20221025192643/https://wiki.mozilla.org/Security/Safe_Browsing#Prefs "Security/Safe Browsing - MozillaWiki | wiki.mozilla.org"
+                  [1]: https://web.archive.org/web/20221026164502/https://wiki.mozilla.org/Security/Safe_Browsing#Prefs "Security/Safe Browsing - MozillaWiki | wiki.mozilla.org"
                  [2]: https://web.archive.org/web/20230811024650/https://blog.mozilla.org/addons/2020/08/24/introducing-a-scalable-add-ons-blocklist/ "Introducing a scalable add-ons blocklist | Mozilla Add-ons Community Blog"
                call:
                  function: AddFirefoxPrefs
@@ -3286,7 +3286,7 @@ actions:

                  It is active by default [2].

-                  [1]: https://web.archive.org/web/20221025192643/https://wiki.mozilla.org/Security/Safe_Browsing#Prefs "Security/Safe Browsing - MozillaWiki | wiki.mozilla.org"
+                  [1]: https://web.archive.org/web/20221026164502/https://wiki.mozilla.org/Security/Safe_Browsing#Prefs "Security/Safe Browsing - MozillaWiki | wiki.mozilla.org"
                  [2]: https://web.archive.org/web/20221029173442/https://github.com/mozilla/policy-templates/blob/master/README.md#preferences "policy-templates/README.md at master · mozilla/policy-templates · GitHub | github.com"
                call:
                  function: AddFirefoxPrefs
--- a/src/application/collections/macos.yaml
+++ b/src/application/collections/macos.yaml
@@ -108,7 +108,7 @@ actions:
                        name: Clear user activity audit logs (login, logout, authentication, etc.)
                        docs:
                            - https://papers.put.as/papers/macosx/2012/Mac_Log_Analysis_Sarah_Edwards_DFIRSummit2012.pdf
-                            - http://macadmins.psu.edu/wp-content/uploads/sites/24696/2016/06/psumac2016-19-osxlogs_macadmins_2016.pdf
+                            - https://web.archive.org/web/20240314054514/https://bpb-us-e1.wpmucdn.com/sites.psu.edu/dist/4/24696/files/2016/06/psumac2016-19-osxlogs_macadmins_2016.pdf
                        code: |-
                            sudo rm -rfv /var/audit/*
                            sudo rm -rfv /private/var/audit/*
@@ -171,7 +171,7 @@ actions:
                            -
                                name: Clear Safari last session (open tabs) history
                                docs:
-                                    - https://apple.stackexchange.com/a/374116
+                                    - https://web.archive.org/web/20240314061752/https://apple.stackexchange.com/questions/374099/where-does-safari-store-the-open-tabs/374116#374116
                                    - https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2013-7127
                                code: rm -f ~/Library/Safari/LastSession.plist
                            -
@@ -191,7 +191,7 @@ actions:
                                        name: Clear Safari webpage previews (thumbnails)
                                        docs:
                                          - https://davidkoepi.wordpress.com/2013/04/20/safariforensic/
-                                          - https://www.reddit.com/r/apple/comments/18lp92/your_apple_computer_keeps_a_screen_shot_of_nearly/
+                                          - https://archive.ph/2024.03.14-100910/https://www.reddit.com/r/apple/comments/18lp92/your_apple_computer_keeps_a_screen_shot_of_nearly/?rdt=59921
                                        code: rm -rfv ~/Library/Caches/com.apple.Safari/Webpage\ Previews
                            -
                                name: Clear Safari history copy
@@ -204,8 +204,8 @@ actions:
                            -
                                name: Clear Safari cookies
                                docs:
-                                  - https://www.toolbox.com/tech/operating-systems/blogs/understanding-the-safari-cookiesbinarycookies-file-format-010712/
-                                  - https://link.springer.com/content/pdf/10.1007/0-387-36891-4_13.pdf
+                                  - https://web.archive.org/web/20240314132018/https://community.spiceworks.com/t/understanding-the-safari-cookies-binarycookies-file-format/928827
+                                  - https://web.archive.org/web/20240314060318/https://link.springer.com/content/pdf/10.1007/0-387-36891-4_13.pdf
                                code: |-
                                    rm -f ~/Library/Cookies/Cookies.binarycookies
                                    # Used before Safari 5.1
@@ -520,7 +520,7 @@ actions:
                    you'll be prompted to grant or deny permission. It's a proactive step to ensure that your sensitive information
                    or system services are accessed only with your current and informed consent.
                children:
-                    # Main documentation: https://archive.ph/26Hlq (https://developer.apple.com/documentation/devicemanagement/privacypreferencespolicycontrol/services)
+                    # Main documentation: https://archive.ph/2023.11.24-170934/https://developer.apple.com/documentation/devicemanagement/privacypreferencespolicycontrol/services
                    -
                        name: Clear **"All"** permissions
                        docs: |-
@@ -536,7 +536,7 @@ actions:
                            This script resets permissions for camera access [1].
                            It ensures no application can access the system camera without explicit user permission, protecting against unauthorized surveillance and data breaches.

-                            [1]: https://archive.ph/26Hlq "PrivacyPreferencesPolicyControl.Services | Apple Developer Documentation | apple.com"
+                            [1]: https://archive.ph/2023.11.24-170934/https://developer.apple.com/documentation/devicemanagement/privacypreferencespolicycontrol/services "PrivacyPreferencesPolicyControl.Services | Apple Developer Documentation | apple.com"
                        call:
                            function: ResetServicePermissions
                            parameters:
@@ -547,7 +547,7 @@ actions:
                            This script resets permissions for microphone access [1].
                            It revokes all granted access to the microphone, protecting against eavesdropping and unauthorized audio recording by applications.

-                            [1]: https://archive.ph/26Hlq "PrivacyPreferencesPolicyControl.Services | Apple Developer Documentation | apple.com"
+                            [1]: https://archive.ph/2023.11.24-170934/https://developer.apple.com/documentation/devicemanagement/privacypreferencespolicycontrol/services "PrivacyPreferencesPolicyControl.Services | Apple Developer Documentation | apple.com"
                        call:
                            function: ResetServicePermissions
                            parameters:
@@ -558,7 +558,7 @@ actions:
                            This script resets permissions for accessibility features [1].
                            It revokes application access to accessibility services, preventing misuse and ensuring these features are used only with user consent.

-                            [1]: https://archive.ph/26Hlq "PrivacyPreferencesPolicyControl.Services | Apple Developer Documentation | apple.com"
+                            [1]: https://archive.ph/2023.11.24-170934/https://developer.apple.com/documentation/devicemanagement/privacypreferencespolicycontrol/services "PrivacyPreferencesPolicyControl.Services | Apple Developer Documentation | apple.com"
                        call:
                            function: ResetServicePermissions
                            parameters:
@@ -569,7 +569,7 @@ actions:
                            This script resets permissions for screen capture [1].
                            It ensures applications cannot capture screen content without user authorization, protecting sensitive information displayed on the screen.

-                            [1]: https://archive.ph/26Hlq "PrivacyPreferencesPolicyControl.Services | Apple Developer Documentation | apple.com"
+                            [1]: https://archive.ph/2023.11.24-170934/https://developer.apple.com/documentation/devicemanagement/privacypreferencespolicycontrol/services "PrivacyPreferencesPolicyControl.Services | Apple Developer Documentation | apple.com"
                        call:
                            function: ResetServicePermissions
                            parameters:
@@ -580,7 +580,7 @@ actions:
                            This script resets permissions for accessing reminders information managed by the Reminders app [1].
                            It ensures applications cannot access or modify reminders data without explicit user permission, maintaining the privacy of personal reminders.

-                            [1]: https://archive.ph/26Hlq "PrivacyPreferencesPolicyControl.Services | Apple Developer Documentation | apple.com"
+                            [1]: https://archive.ph/2023.11.24-170934/https://developer.apple.com/documentation/devicemanagement/privacypreferencespolicycontrol/services "PrivacyPreferencesPolicyControl.Services | Apple Developer Documentation | apple.com"
                        call:
                            function: ResetServicePermissions
                            parameters:
@@ -591,7 +591,7 @@ actions:
                            This script resets permissions for accessing the pictures managed by the Photos app [1].
                            It revokes all permissions granted to applications, safeguarding personal photos and media from unauthorized access.

-                            [1]: https://archive.ph/26Hlq "PrivacyPreferencesPolicyControl.Services | Apple Developer Documentation | apple.com"
+                            [1]: https://archive.ph/2023.11.24-170934/https://developer.apple.com/documentation/devicemanagement/privacypreferencespolicycontrol/services "PrivacyPreferencesPolicyControl.Services | Apple Developer Documentation | apple.com"
                        call:
                            function: ResetServicePermissions
                            parameters:
@@ -602,7 +602,7 @@ actions:
                            This script resets permissions for accessing the calendar information managed by the Calendar app [1].
                            It ensures that applications cannot access calendar data without user consent, protecting personal and sensitive calendar information.

-                            [1]: https://archive.ph/26Hlq "PrivacyPreferencesPolicyControl.Services | Apple Developer Documentation | apple.com"
+                            [1]: https://archive.ph/2023.11.24-170934/https://developer.apple.com/documentation/devicemanagement/privacypreferencespolicycontrol/services "PrivacyPreferencesPolicyControl.Services | Apple Developer Documentation | apple.com"
                        call:
                            function: ResetServicePermissions
                            parameters:
@@ -614,7 +614,7 @@ actions:
                            Full disk access allows the application access to all protected files, including system administration files [1].
                            It revokes broad file access from applications, significantly reducing the risk of data exposure and enhancing overall system security.

-                            [1]: https://archive.ph/26Hlq "PrivacyPreferencesPolicyControl.Services | Apple Developer Documentation | apple.com"
+                            [1]: https://archive.ph/2023.11.24-170934/https://developer.apple.com/documentation/devicemanagement/privacypreferencespolicycontrol/services "PrivacyPreferencesPolicyControl.Services | Apple Developer Documentation | apple.com"
                        call:
                            function: ResetServicePermissions
                            parameters:
@@ -626,7 +626,7 @@ actions:
                            The contact information managed by the Contacts app [1].
                            It ensures that applications cannot access the user's contact list without explicit permission, maintaining the confidentiality of personal contacts.

-                            [1]: https://archive.ph/26Hlq "PrivacyPreferencesPolicyControl.Services | Apple Developer Documentation | apple.com"
+                            [1]: https://archive.ph/2023.11.24-170934/https://developer.apple.com/documentation/devicemanagement/privacypreferencespolicycontrol/services "PrivacyPreferencesPolicyControl.Services | Apple Developer Documentation | apple.com"
                        call:
                            function: ResetServicePermissions
                            parameters:
@@ -637,7 +637,7 @@ actions:
                            This script resets permissions for accessing the Desktop folder [1].
                            It revokes application access to files on the desktop, protecting personal and work-related documents from unauthorized access.

-                            [1]: https://archive.ph/26Hlq "PrivacyPreferencesPolicyControl.Services | Apple Developer Documentation | apple.com"
+                            [1]: https://archive.ph/2023.11.24-170934/https://developer.apple.com/documentation/devicemanagement/privacypreferencespolicycontrol/services "PrivacyPreferencesPolicyControl.Services | Apple Developer Documentation | apple.com"
                        call:
                            function: ResetServicePermissions
                            parameters:
@@ -648,7 +648,7 @@ actions:
                            This script resets permissions for accessing the Documents folder [1].
                            It prevents applications from accessing files in this folder without user consent, safeguarding important and private documents.

-                            [1]: https://archive.ph/26Hlq "PrivacyPreferencesPolicyControl.Services | Apple Developer Documentation | apple.com"
+                            [1]: https://archive.ph/2023.11.24-170934/https://developer.apple.com/documentation/devicemanagement/privacypreferencespolicycontrol/services "PrivacyPreferencesPolicyControl.Services | Apple Developer Documentation | apple.com"
                        call:
                            function: ResetServicePermissions
                            parameters:
@@ -659,7 +659,7 @@ actions:
                            This script resets permissions for accessing the Downloads folder [1].
                            It ensures that applications cannot access downloaded files without user authorization, protecting downloaded content from misuse.

-                            [1]: https://archive.ph/26Hlq "PrivacyPreferencesPolicyControl.Services | Apple Developer Documentation | apple.com"
+                            [1]: https://archive.ph/2023.11.24-170934/https://developer.apple.com/documentation/devicemanagement/privacypreferencespolicycontrol/services "PrivacyPreferencesPolicyControl.Services | Apple Developer Documentation | apple.com"
                        call:
                            function: ResetServicePermissions
                            parameters:
@@ -670,7 +670,7 @@ actions:
                            This script resets permissions for Apple Events [1].
                            It revokes permissions for applications to send restricted Apple Events to other processes [1], enhancing privacy and security.

-                            [1]: https://archive.ph/26Hlq "PrivacyPreferencesPolicyControl.Services | Apple Developer Documentation | apple.com"
+                            [1]: https://archive.ph/2023.11.24-170934/https://developer.apple.com/documentation/devicemanagement/privacypreferencespolicycontrol/services "PrivacyPreferencesPolicyControl.Services | Apple Developer Documentation | apple.com"
                        call:
                            function: ResetServicePermissions
                            parameters:
@@ -681,7 +681,7 @@ actions:
                            This script resets permissions for File Provider Presence [1].
                            It revokes the ability of File Provider applications to know when the user is accessing their managed files [1], enhancing user privacy.

-                            [1]: https://archive.ph/26Hlq "PrivacyPreferencesPolicyControl.Services | Apple Developer Documentation | apple.com"
+                            [1]: https://archive.ph/2023.11.24-170934/https://developer.apple.com/documentation/devicemanagement/privacypreferencespolicycontrol/services "PrivacyPreferencesPolicyControl.Services | Apple Developer Documentation | apple.com"
                        call:
                            function: ResetServicePermissions
                            parameters:
@@ -692,7 +692,7 @@ actions:
                            This script resets "ListenEvent" permissions [1].
                            It revokes application access to listen to system events [1], preventing unauthorized monitoring of user interactions with the system.

-                            [1]: https://archive.ph/26Hlq "PrivacyPreferencesPolicyControl.Services | Apple Developer Documentation | apple.com"
+                            [1]: https://archive.ph/2023.11.24-170934/https://developer.apple.com/documentation/devicemanagement/privacypreferencespolicycontrol/services "PrivacyPreferencesPolicyControl.Services | Apple Developer Documentation | apple.com"
                        call:
                            function: ResetServicePermissions
                            parameters:
@@ -703,7 +703,7 @@ actions:
                            This script resets permissions for accessing the Media Library [1].
                            It ensures that applications cannot access Apple Music, music and video activity, and the media library [1] without user consent.

-                            [1]: https://archive.ph/26Hlq "PrivacyPreferencesPolicyControl.Services | Apple Developer Documentation | apple.com"
+                            [1]: https://archive.ph/2023.11.24-170934/https://developer.apple.com/documentation/devicemanagement/privacypreferencespolicycontrol/services "PrivacyPreferencesPolicyControl.Services | Apple Developer Documentation | apple.com"
                        call:
                            function: ResetServicePermissions
                            parameters:
@@ -714,7 +714,7 @@ actions:
                            This script resets permissions for sending "PostEvent" [1].
                            It prevents applications from using CoreGraphics APIs to send system events [1], safeguarding against potential misuse.

-                            [1]: https://archive.ph/26Hlq "PrivacyPreferencesPolicyControl.Services | Apple Developer Documentation | apple.com"
+                            [1]: https://archive.ph/2023.11.24-170934/https://developer.apple.com/documentation/devicemanagement/privacypreferencespolicycontrol/services "PrivacyPreferencesPolicyControl.Services | Apple Developer Documentation | apple.com"
                        call:
                            function: ResetServicePermissions
                            parameters:
@@ -726,7 +726,7 @@ actions:
                            This script resets permissions for using Speech Recognition [1].
                            It revokes application access to the speech recognition facility and sending speech data to Apple [1], protecting user privacy.

-                            [1]: https://archive.ph/26Hlq "PrivacyPreferencesPolicyControl.Services | Apple Developer Documentation | apple.com"
+                            [1]: https://archive.ph/2023.11.24-170934/https://developer.apple.com/documentation/devicemanagement/privacypreferencespolicycontrol/services "PrivacyPreferencesPolicyControl.Services | Apple Developer Documentation | apple.com"
                        call:
                            function: ResetServicePermissions
                            parameters:
@@ -737,7 +737,7 @@ actions:
                            This script resets permissions for modifying other apps [1].
                            It prevents applications from updating or deleting other apps [1], maintaining system integrity and user control.

-                            [1]: https://archive.ph/26Hlq "PrivacyPreferencesPolicyControl.Services | Apple Developer Documentation | apple.com"
+                            [1]: https://archive.ph/2023.11.24-170934/https://developer.apple.com/documentation/devicemanagement/privacypreferencespolicycontrol/services "PrivacyPreferencesPolicyControl.Services | Apple Developer Documentation | apple.com"
                        call:
                            function: ResetServicePermissions
                            parameters:
@@ -748,7 +748,7 @@ actions:
                            This script resets permissions for accessing application data [1].
                            It revokes application access to specific application data, enhancing privacy and data security.

-                            [1]: https://archive.ph/26Hlq "PrivacyPreferencesPolicyControl.Services | Apple Developer Documentation | apple.com"
+                            [1]: https://archive.ph/2023.11.24-170934/https://developer.apple.com/documentation/devicemanagement/privacypreferencespolicycontrol/services "PrivacyPreferencesPolicyControl.Services | Apple Developer Documentation | apple.com"
                        call:
                            function: ResetServicePermissions
                            parameters:
@@ -759,7 +759,7 @@ actions:
                            This script resets permissions for accessing files on network volumes [1].
                            It ensures applications cannot access network files without user authorization.

-                            [1]: https://archive.ph/26Hlq "PrivacyPreferencesPolicyControl.Services | Apple Developer Documentation | apple.com"
+                            [1]: https://archive.ph/2023.11.24-170934/https://developer.apple.com/documentation/devicemanagement/privacypreferencespolicycontrol/services "PrivacyPreferencesPolicyControl.Services | Apple Developer Documentation | apple.com"
                        call:
                            function: ResetServicePermissions
                            parameters:
@@ -770,7 +770,7 @@ actions:
                            This script resets permissions for accessing files on removable volumes [1].
                            It protects data on external drives from unauthorized application access.

-                            [1]: https://archive.ph/26Hlq "PrivacyPreferencesPolicyControl.Services | Apple Developer Documentation | apple.com"
+                            [1]: https://archive.ph/2023.11.24-170934/https://developer.apple.com/documentation/devicemanagement/privacypreferencespolicycontrol/services "PrivacyPreferencesPolicyControl.Services | Apple Developer Documentation | apple.com"
                        call:
                            function: ResetServicePermissions
                            parameters:
@@ -781,7 +781,7 @@ actions:
                            This script resets permissions for accessing system administration files [1].
                            It enhances system security by restricting application access to critical system files.

-                            [1]: https://archive.ph/26Hlq "PrivacyPreferencesPolicyControl.Services | Apple Developer Documentation | apple.com"
+                            [1]: https://archive.ph/2023.11.24-170934/https://developer.apple.com/documentation/devicemanagement/privacypreferencespolicycontrol/services "PrivacyPreferencesPolicyControl.Services | Apple Developer Documentation | apple.com"
                        call:
                            function: ResetServicePermissions
                            parameters:
@@ -877,7 +877,7 @@ actions:
                            There is also `WelcomeScreenPromo.PromoOff` setting that's pre-configured to `1` (`no` as
                            default). It's undocumented but still kept disabled by this script.

-                            [1]: https://web.archive.org/save/https://forum.parallels.com/threads/unable-to-process-the-upgrade-request.345603/ "Unable to process the upgrade request | Parallels Forums | forum.parallels.com"
+                            [1]: https://web.archive.org/web/20240314062932/https://forum.parallels.com/threads/unable-to-process-the-upgrade-request.345603/ "Unable to process the upgrade request | Parallels Forums | forum.parallels.com"
                            [2]: https://web.archive.org/web/20221012151800/https://kb.parallels.com/114422 "How do I turn off notifications in Parallels Desktop and Parallels Access? | Knowledge Base | parallels.com"
                        code: |-
                            defaults write 'com.parallels.Parallels Desktop' 'ProductPromo.ForcePromoOff' -bool yes
@@ -988,16 +988,16 @@ actions:
                                recommend: strict
                                docs:
                                    - https://github.com/privacysexy-forks/starter/blob/master/system/siri.sh
-                                    - https://machippie.github.io/system/
+                                    - https://web.archive.org/web/20201002133713/https://machippie.github.io/system/
                                code: defaults write com.apple.assistant.backedup 'Use device speaker for TTS' -int 3
                                revertCode: defaults write com.apple.assistant.backedup 'Use device speaker for TTS' -int 2
                            -
                                name: Disable Siri services (Siri and assistantd)
                                recommend: strict
                                docs:
-                                    - https://apple.stackexchange.com/questions/57514/what-is-assistantd
-                                    - https://www.jamf.com/jamf-nation/discussions/22757/kill-siri#responseChild137563
-                                    - https://apple.stackexchange.com/a/370426
+                                    - https://web.archive.org/web/20240314060540/https://apple.stackexchange.com/questions/57514/what-is-assistantd
+                                    - https://archive.ph/2024.03.14-055010/https://community.jamf.com/t5/jamf-pro/kill-siri/td-p/171543
+                                    - https://web.archive.org/web/20240314060501/https://apple.stackexchange.com/questions/258816/how-to-completely-disable-siri-on-sierra/370426#370426
                                # To see status: • `launchctl print-disabled system` • `launchctl print-disabled user/$UID` • `launchctl print-disabled gui/$UID`
                                code: |-
                                    launchctl disable "user/$UID/com.apple.assistantd"
@@ -1021,10 +1021,20 @@ actions:
                                    fi
                            -
                                name: Disable "Do you want to enable Siri?" pop-up
-                                docs:
-                                    - https://discussions.apple.com/thread/7694127?answerId=30752577022#30752577022
-                                    - https://windowsreport.com/mac/siri-keeps-popping-up/
-                                    - https://www.jamf.com/jamf-nation/discussions/21783/disable-siri-setup-assistant-in-macos-sierra#responseChild131588
+                                docs: |-
+                                    This script stops the "Enable Siri" pop-up [1] from appearing the first time a user logs into macOS [2].
+                                    
+                                    Introduced in macOS version 10.12 [2], this pop-up asks, "Do you want to enable Siri?" [1]
+                                    which could lead to Siri being enabled unintentionally.
+                                    
+                                    This script configures the `com.apple.SetupAssistant!DidSeeSiriSetup` setting to suppress this pop-up [1] [2] [3] [4].
+                                    This command tells the system that the Siri setup is complete, preventing the pop-up in future sessions and
+                                    enhancing privacy by avoiding unintended Siri activation.
+
+                                    [1]: https://archive.ph/2024.03.14-053325/https://discussions.apple.com/thread/7694127?answerId=30752577022&sortBy=best%2330752577022 "macOS keeps nagging me about enabling Siri - Apple Community | discussions.apple.com"
+                                    [2]: https://web.archive.org/web/20240314052600/https://derflounder.wordpress.com/2016/09/20/supressing-siri-pop-up-windows-on-macos-sierra/ "Suppressing Siri pop-up windows on macOS Sierra | Der Flounder"
+                                    [3]: https://web.archive.org/web/20240314052901/https://windowsreport.com/mac/siri-keeps-popping-up/ "Siri keeps popping up on Mac? Here's how to easily fix that • MacTips | windowsreport.com"
+                                    [4]: https://web.archive.org/web/20240314052247/https://community.jamf.com/t5/jamf-pro/disable-siri-setup-assistant-in-macos-sierra/m-p/205836/highlight/true#M194536 "Solved: Re: Disable Siri setup assistant in macOS Sierra - Jamf Nation Community - 205834 | community.jamf.com"
                                code: defaults write com.apple.SetupAssistant 'DidSeeSiriSetup' -bool True
                                revertCode: defaults delete com.apple.SetupAssistant 'DidSeeSiriSetup'
                    -
@@ -1084,7 +1094,7 @@ actions:
                    by default.

                    [1]: https://web.archive.org/web/20230731152633/https://www.apple.com/legal/privacy/data/en/apple-advertising/ "Legal - Apple Advertising & Privacy - Apple"
-                    [2]: https://web.archive.org/web/20220805052411/https://support.apple.com/en-sg/guide/mac-help/mh32356/mac: "Change Privacy preferences on Mac - Apple Support (SG)"
+                    [2]: https://web.archive.org/web/20220805052411/https://support.apple.com/en-sg/guide/mac-help/mh32356/mac "Change Privacy preferences on Mac - Apple Support (SG)"
                    [3]: https://web.archive.org/web/20230731155827/https://developer.apple.com/documentation/devicemanagement/restrictions "Restrictions | Apple Developer Documentation"
                    [4]: https://web.archive.org/web/20230731155653/https://paper.bobylive.com/Security/CIS/CIS_Apple_macOS_11_0_Big_Sur_Benchmark_v2_0_0.pdf "CIS Apple macOS 11.0 Big Sur Benchmark"
                    [5]: https://web.archive.org/web/20230731155131/https://developer.apple.com/documentation/adsupport/asidentifiermanager/1614151-advertisingidentifier "advertisingIdentifier | Apple Developer Documentation"
@@ -1280,7 +1290,7 @@ actions:
                # OS tracks downloaded files with help of quarantine-aware applications
                # (such as Safari, Chrome) adding quarantine extended attributes to files.
                # then OS warns and asks if you really want to open it
-                docs: https://support.apple.com/en-gb/HT202491
+                docs: https://web.archive.org/web/20210319081714/https://support.apple.com/en-gb/HT202491
                children:
                    -
                        category: Clean File Quarantine from downloaded files
@@ -1391,7 +1401,7 @@ actions:
                        name: Disable Gatekeeper's automatic reactivation
                        docs:
                            - https://osxdaily.com/2015/11/05/stop-gatekeeper-auto-rearm-mac-os-x/
-                            - https://www.cnet.com/tech/computing/how-to-disable-gatekeeper-permanently-on-os-x/
+                            - https://web.archive.org/web/20230327050142/https://www.cnet.com/tech/computing/how-to-disable-gatekeeper-permanently-on-os-x/
                        code: sudo defaults write /Library/Preferences/com.apple.security GKAutoRearm -bool true
                        revertCode: sudo defaults write /Library/Preferences/com.apple.security GKAutoRearm -bool false
                    -
@@ -1450,13 +1460,19 @@ actions:
                revertCode: sudo defaults write /Library/Preferences/com.apple.security.libraryvalidation.plist 'DisableLibraryValidation' -bool false
            -
                category: Disable automatic updates
-                docs:
-                    - https://developer.apple.com/documentation/devicemanagement/deviceinformationresponse/queryresponses/osupdatesettings
-                    - https://macadminsdoc.readthedocs.io/en/master/Profiles-and-Settings/OS-X-Updates.html
+                docs: |-
+                    This category contains scripts to disable automatic operating system updates.
+
+                    Disabling automatic updates gives users full control over when and which updates are applied to their system.
+                    It improves privacy by preventing unwanted data collection, new vulnerabilities and unapproved changes to system settings.
+
+                    > **Caution**:
+                    > Disabling automatic updates can leave your system vulnerable to unpatched exploits.
+                    > Manually check and and apply updates to stay protected.
                children:
                    -
                        name: Disable automatic checks for updates
-                        docs: https://developer.apple.com/documentation/devicemanagement/softwareupdate
+                        docs: https://archive.ph/2024.03.21-180353/https://developer.apple.com/documentation/devicemanagement/softwareupdate
                        code: |-
                            # For OS X Yosemite and newer (>= 10.10)
                            sudo defaults write /Library/Preferences/com.apple.SoftwareUpdate 'AutomaticCheckEnabled' -bool false
@@ -1465,7 +1481,7 @@ actions:
                            sudo defaults write /Library/Preferences/com.apple.SoftwareUpdate 'AutomaticCheckEnabled' -bool true
                    -
                        name: Disable automatic downloads for updates
-                        docs: https://developer.apple.com/documentation/devicemanagement/softwareupdate
+                        docs: https://archive.ph/2024.03.21-180353/https://developer.apple.com/documentation/devicemanagement/softwareupdate
                        code: |-
                            # For OS X Yosemite and newer (>= 10.10)
                            sudo defaults write /Library/Preferences/com.apple.SoftwareUpdate 'AutomaticDownload' -bool false
@@ -1474,12 +1490,41 @@ actions:
                            sudo defaults write /Library/Preferences/com.apple.SoftwareUpdate 'AutomaticDownload' -bool true
                    -
                        name: Disable automatic installation of macOS updates
-                        docs:
-                            # References for AutoUpdateRestartRequired
-                                - https://kb.vmware.com/s/article/2960635
-                                - https://derflounder.wordpress.com/2018/12/28/enabling-automatic-macos-software-updates-for-os-x-yosemite-through-macos-mojave/
-                            # References for AutomaticallyInstallMacOSUpdates
-                                - https://developer.apple.com/documentation/devicemanagement/softwareupdate
+                        docs: |-
+                            This script stops macOS from automatically installing updates.
+
+                            This script improves privacy by reducing unwanted data collection and ensuring updates don't change
+                            settings or data without your approval.
+
+                            The Center for Internet Security (CIS) advises against automatic updates in scenarios where changes require
+                            thorough testing and approval processes to avoid operational disruptions [1] [2] [3] [4].
+
+                            This script configures following to stop macOS from installing updates automatically:
+
+                            1. `/Library/Preferences/com.apple.commerce!AutoUpdateRestartRequired`:
+                                This preference stops the system from automatically installing macOS updates [1] [2] [3] [4] [5] [6] [7] [8].
+                                By doing this, updates will only be installed when you decide, giving you a chance to check them first [1] [2] [3] [4] [5] [6] [7] [8].
+                                This setting applies to OS X Yosemite through macOS High Sierra [7] [9].
+
+                            2. `/Library/Preferences/com.apple.commerce!AutomaticallyInstallMacOSUpdates`:
+                                Changing this setting stops macOS from installing updates automatically [3] [5] [9] [10], giving you control over when to update.
+                                If restricts the *Install macOS Updates* option and prevents the user from changing the option [10].
+                                While this setting enhances privacy, it's generally not advised by NIST due to potential security risks [9].
+                                This setting applies to macOS Mojave and newer versions [9].
+
+                            > **Caution**: Disabling automatic updates requires you to manually check and apply updates to stay protected against security threats [1] [2] [3] [4].
+
+                            [1]: https://web.archive.org/web/20240321165149/https://www.tenable.com/audits/items/CIS_Apple_macOS_10.12_v1.1.0_Level_1.audit:e02dfdd6bec9556a3ce537f60b91b549 "CIS Apple macOS 10.12 L1 v1.1.0 | 1.5 Enable OS X update installs | Tenable®"
+                            [2]: https://web.archive.org/web/20240321165851/https://paper.bobylive.com/Security/CIS/CIS_Apple_macOS_10_13_Benchmark_v1_1_0---PDF.pdf "CIS Apple macOS 10.13 Benchmark v1.1.0 | paper.bobylive.com"
+                            [3]: https://web.archive.org/web/20240321170400/https://www.tenable.com/audits/items/CIS_Apple_macOS_13.0_Ventura_v1.0.0_L1.audit:fe03c59a39c7c949507ff20d07f89993 "1.4 Ensure Install of macOS Updates Is Enabled | Tenable® | www.tenable.com"
+                            [4]: https://web.archive.org/web/20240321170036/https://paper.bobylive.com/Security/CIS/CIS_Apple_macOS_10_14_Benchmark_v1_4_0_PDF.pdf "CIS Apple macOS 10.14 Benchmark v1.4.0 | paper.bobylive.com"
+                            [5]: https://web.archive.org/web/20240321164917/https://www.ncsc.gov.uk/files/macos_provisioning_script.sh_.txt "macOS provisioning script | UK National Cyber Security Centre | www.ncsc.gov.uk"
+                            [6]: https://web.archive.org/web/20240321165118/https://macadminsdoc.readthedocs.io/en/master/Profiles-and-Settings/OS-X-Updates.html "macOS Updates — MacAdmins Community Documentation documentation | macadminsdoc.readthedocs.io"
+                            [7]: https://web.archive.org/web/20240321165304/https://derflounder.wordpress.com/2014/12/29/managing-automatic-app-store-and-os-x-update-installation-on-yosemite/ "Managing automatic App Store and OS X update installation on Yosemite | Der Flounder | derflounder.wordpress.com"
+                            [8]: https://web.archive.org/web/20240321170034/https://krypted.com/mac-os-x/app-store-preferences-set-server-5-4-macos-high-sierra/ "App Store Preferences To Set In On Server 5.4 for macOS High Sierra – krypted | krypted.com"
+                            [9]: https://web.archive.org/web/20240321170251/https://derflounder.wordpress.com/2018/12/28/enabling-automatic-macos-software-updates-for-os-x-yosemite-through-macos-mojave/ "Enabling automatic macOS software updates for OS X Yosemite through macOS Mojave | Der Flounder | derflounder.wordpress.com"
+                            [10]: https://archive.ph/2024.03.21-180353/https://developer.apple.com/documentation/devicemanagement/softwareupdate "SoftwareUpdate | Apple Developer Documentation | developer.apple.com"
+                            [11]: https://web.archive.org/web/20240321165931/https://csrc.nist.gov/CSRC/media/Projects/national-vulnerability-database/documents/CCE/CCE-macos_monterey.xls "CCE-91129-7 | CCE-macos_monterey.xls | Sheet 1 - NIST Computer Security Resource Center | csrc.nist.gov"
                        code: |-
                            # For OS X Yosemite through macOS High Sierra (>= 10.10 && < 10.14)
                            sudo defaults write /Library/Preferences/com.apple.commerce 'AutoUpdateRestartRequired' -bool false
@@ -1492,9 +1537,44 @@ actions:
                            sudo defaults write /Library/Preferences/com.apple.SoftwareUpdate 'AutomaticallyInstallMacOSUpdates' -bool true
                    -
                        name: Disable automatic app updates from the App Store
-                        docs:
-                            - https://kb.vmware.com/s/article/2960635
-                            - https://derflounder.wordpress.com/2018/12/28/enabling-automatic-macos-software-updates-for-os-x-yosemite-through-macos-mojave/
+                        docs: |-
+                            This script disables automatic app updates [1] [2] [3] [4] from the App Store [5] [6] [7] [8] [9] [10] [11] [12] [13].
+                            It prevents automatic installation of application updates as soon as they become available from Apple [2] [3] [6] [9] [11] [12] [13].
+                            Thus, applications are updated only when you choose to do so [5].
+
+                            Disabling automatic updates prevents unexpected app behavior or settings changes.
+                            It helps you to maintain your current app configurations and privacy settings.
+                            It also protects against potential zero-day vulnerabilities in your apps.
+                            This gives you the ability to choose which updates to install and when, enabling you to review the details of updates before deciding to proceed.
+
+                            The script modifies the following settings:
+
+                            1. `/Library/Preferences/com.apple.commerce!AutoUpdate`:
+                                Disables automated app updates [1] [2] [3] [6] [9] [10] [13] from the App Store [7] [8].
+                                This setting applies to OS X Yosemite and newer versions [1].
+                            2. `/Library/Preferences/com.apple.SoftwareUpdate!AutomaticallyInstallAppUpdates`:
+                                Stops the automatic installation of app updates [1] [4] from App Store [9] [10] [11] [12] [13].
+                                It deselects the *Install app updates from the App Store* option and prevents the user from changing the option [10].
+                                While this setting enhances privacy, it's generally not advised by NIST due to potential security risks [4].
+                                This setting applies to macOS Mojave and newer versions [1].
+
+                            > **Caution**:
+                            > Disabling app updates means you should manually check for and install important security patches for every application
+                            > to protect against vulnerabilities [2] [3] [5] [6] [9] [11] [12] [13].
+
+                            [1]: https://web.archive.org/web/20240321170251/https://derflounder.wordpress.com/2018/12/28/enabling-automatic-macos-software-updates-for-os-x-yosemite-through-macos-mojave/ "Enabling automatic macOS software updates for OS X Yosemite through macOS Mojave | Der Flounder | derflounder.wordpress.com"
+                            [2]: https://web.archive.org/web/20240321190032/https://www.irs.gov/pub/irs-utl/safeguards-scsem-macosx-v6-1-093021.xlsx "SCSEM OSX 10.14 | Internal Revenue Service Office of Safeguards | www.irs.gov"
+                            [3]: https://web.archive.org/web/20240321170036/https://paper.bobylive.com/Security/CIS/CIS_Apple_macOS_10_14_Benchmark_v1_4_0_PDF.pdf "CIS Apple macOS 10.14 Benchmark v1.4.0 | paper.bobylive.com"
+                            [5]: https://web.archive.org/web/20240321190244/https://github-wiki-see.page/m/edamametechnologies/threatmodels/wiki/threatmodel-macOS-EN "threatmodel macOS EN - edamametechnologies/threatmodels GitHub Wiki | github-wiki-see.page"
+                            [6]: https://web.archive.org/web/20240321190315/https://www.tenable.com/audits/items/CIS_Apple_macOS_14.0_Sonoma_v1.0.0_L1.audit:66d3b86318384ba7947a3409e0c6e902 "1.5 Ensure Install Application Updates from the App Store Is E... | Tenable® | www.tenable.com"
+                            [7]: https://web.archive.org/web/20240321165304/https://derflounder.wordpress.com/2014/12/29/managing-automatic-app-store-and-os-x-update-installation-on-yosemite/ "Managing automatic App Store and OS X update installation on Yosemite | Der Flounder | derflounder.wordpress.com"
+                            [8]: https://web.archive.org/web/20240321190410/https://krypted.com/mac-security/app-store-preferences-set-server-5-2-macos-sierra/ "App Store Preferences To Set In On Server 5.2 for macOS Sierra – krypted | krypted.com"
+                            [4]: https://web.archive.org/web/20240321165931/https://csrc.nist.gov/CSRC/media/Projects/national-vulnerability-database/documents/CCE/CCE-macos_monterey.xls "CCE-91129-7 | CCE-macos_monterey.xls | Sheet 1 - NIST Computer Security Resource Center | csrc.nist.gov"
+                            [9]: https://web.archive.org/web/20240321190114/https://www.irs.gov/pub/irs-utl/safeguards-scsem-macosx.xlsx "SCSEM OSX 13.0 | Internal Revenue Service Office of Safeguards | www.irs.gov"
+                            [10]: https://archive.ph/2024.03.21-180353/https://developer.apple.com/documentation/devicemanagement/softwareupdate "SoftwareUpdate | Apple Developer Documentation | developer.apple.com"
+                            [11]: https://web.archive.org/web/20240321190122/https://paper.bobylive.com/Security/CIS/CIS_Apple_macOS_12_0_Monterey_Benchmark_v1_0_0.pdf "CIS Apple macOS 12.0 Monterey | CIS Benchmarks | paper.bobylive.com"
+                            [12]: https://web.archive.org/web/20240321190537/https://www.tenable.com/audits/items/CIS_Apple_macOS_11_v2.0.0_L1.audit:55e8759872dce781b8dbc5a3f42e23b9 "1.4 Ensure Installation of App Update Is Enabled | Tenable® | www.tenable.com"
+                            [13]: https://web.archive.org/web/20240321164917/https://www.ncsc.gov.uk/files/macos_provisioning_script.sh_.txt "macOS provisioning script | UK National Cyber Security Centre | www.ncsc.gov.uk"
                        code: |-
                            # For OS X Yosemite and newer (>= 10.10)
                            sudo defaults write /Library/Preferences/com.apple.commerce 'AutoUpdate' -bool false
@@ -1507,7 +1587,7 @@ actions:
                            sudo defaults write /Library/Preferences/com.apple.SoftwareUpdate 'AutomaticallyInstallAppUpdates' -bool true
                    -
                        name: Disable macOS beta release installation
-                        docs: https://support.apple.com/en-gb/HT203018
+                        docs: https://web.archive.org/web/20170106103856/https://support.apple.com/en-gb/HT203018
                        code: |-
                            # For OS X Yosemite and newer (>= 10.10)
                            sudo defaults write /Library/Preferences/com.apple.SoftwareUpdate 'AllowPreReleaseInstallation' -bool false
@@ -1516,7 +1596,7 @@ actions:
                            sudo defaults write /Library/Preferences/com.apple.SoftwareUpdate 'AllowPreReleaseInstallation' -bool true
                    -
                        name: Disable automatic installation for configuration data (e.g. XProtect, Gatekeeper, MRT)
-                        docs: https://derflounder.wordpress.com/2018/12/28/enabling-automatic-macos-software-updates-for-os-x-yosemite-through-macos-mojave/
+                        docs: https://web.archive.org/web/20240321170251/https://derflounder.wordpress.com/2018/12/28/enabling-automatic-macos-software-updates-for-os-x-yosemite-through-macos-mojave/
                        code: |-
                            # For OS X Yosemite and newer (>= 10.10)
                            sudo defaults write /Library/Preferences/com.apple.SoftwareUpdate 'ConfigDataInstall' -bool false
@@ -1525,12 +1605,47 @@ actions:
                            sudo defaults write /Library/Preferences/com.apple.SoftwareUpdate 'ConfigDataInstall' -bool true
                    -
                        name: Disable automatic installation for system data files and security updates
-                        docs:
-                            # References for CriticalUpdateInstall
-                                - https://derflounder.wordpress.com/2014/12/24/managing-os-xs-automatic-security-updates/
-                                - https://developer.apple.com/documentation/devicemanagement/softwareupdate
-                            # References for softwareupdate --background-critical
-                                - https://managingosx.wordpress.com/2013/04/30/undocumented-options/
+                        docs: |-
+                            This script stops automatic installations of critical updates [1],
+                            including security [1] [2] [3] [4] [5] [6] [7] and system data file [1] [8] updates.
+
+                            It improves privacy by providing:
+
+                            - **Control Over Update Timing**:
+                              Users can review updates before installation to ensure they meet privacy standards and do not introduce
+                              unwanted telemetry or changes.
+                            - **Reduced External Communications**:
+                              Reduces how often it connects to update servers, potentially protection user information.
+
+                            The script configures the `/Library/Preferences/com.apple.SoftwareUpdate!CriticalUpdateInstall` setting [1] [4] [5] [7] [8].
+                            This action prevents automatic downloads and installations of updates [1].
+                            It also prevents users from changing the Install system data files and security updates option manually [1].
+                            This script is compatible with OS X Yosemite and later versions [6] [8].
+
+                            The revert script triggers `softwareupdate --background-critical` to install any pending critical updates directly [2] [9].
+
+                            > **Caution:**
+                            > Only disable automatic updates if you're committed to manually installing them quickly to maintain your computer's security [4] [5] [8].
+                            > It's important to install updates soon to protect your computer. [4] [5] [8].
+                            >
+                            > This script disables:
+                            >
+                            > - Definition updates for **XProtect** and **Gatekeeper** that keep your computer safe from new threats [5].
+                            > - **Rapid Security Response** [10] [11].
+                            >   **Rapid Security Responses** are software releases providing important security improvements between standard updates [12].
+
+                            [1]: https://archive.ph/2024.03.21-180353/https://developer.apple.com/documentation/devicemanagement/softwareupdate "SoftwareUpdate | Apple Developer Documentation | developer.apple.com"
+                            [2]: https://web.archive.org/web/20240321201417/https://derflounder.wordpress.com/2014/12/24/managing-os-xs-automatic-security-updates/ "Managing OS X’s automatic security updates | Der Flounder | derflounder.wordpress.com"
+                            [3]: https://web.archive.org/web/20240321165118/https://macadminsdoc.readthedocs.io/en/master/Profiles-and-Settings/OS-X-Updates.html "macOS Updates — MacAdmins Community Documentation documentation | macadminsdoc.readthedocs.io"
+                            [4]: https://web.archive.org/web/20240321165931/https://csrc.nist.gov/CSRC/media/Projects/national-vulnerability-database/documents/CCE/CCE-macos_monterey.xls "CCE-91129-7 | CCE-macos_monterey.xls | Sheet 1 - NIST Computer Security Resource Center | csrc.nist.gov"
+                            [5]: https://web.archive.org/web/20240321201450/https://paper.bobylive.com/Security/CIS/CIS_Apple_OSX_10_9_Benchmark_v1_3_0.pdf "CIS Apple OSX 10.9 Benchmark | paper.bobylive.com"
+                            [6]: https://web.archive.org/web/20240321201643/https://derflounder.wordpress.com/2014/12/27/managing-automatic-installation-of-configdata-and-security-software-updates-on-yosemite/ "Managing automatic installation of ConfigData and security software updates on Yosemite | Der Flounder | derflounder.wordpress.com"
+                            [7]: https://web.archive.org/web/20240321201652/https://ss64.com/mac/syntax-defaults.html "System preference settings for macOS - macOS - SS64.com | ss64.com"
+                            [8]: https://web.archive.org/web/20240321201436/https://www.tenable.com/audits/items/CIS_OSX_10.10_v1.2.0_L1.audit:97f36c2eaa06045e85a1beff1a76a088 "1.4 Enable system data files and security update installs - 'C... | Tenable® | www.tenable.com"
+                            [9]: https://web.archive.org/web/20240321201406/https://managingosx.wordpress.com/2013/04/30/undocumented-options/ "Undocumented options – Managing OS X | managingosx.wordpress.com"
+                            [10]: https://web.archive.org/web/20240321201558/https://www.intuneirl.com/rapid-security-response/ "Managing Rapid Security Response on Apple Devices | www.intuneirl.com"
+                            [11]: https://web.archive.org/web/20240321201614/https://onsitegroup.co.za/rapid-security-response/ "Rapid security response - Onsite | onsitegroup.co.za"
+                            [12]: https://web.archive.org/web/20240321201623/https://support.apple.com/en-us/102657 "About Rapid Security Responses for iOS, iPadOS, and macOS - Apple Support | support.apple.com"
                        code: |-
                            # For OS X Yosemite and newer (>= 10.10)
                            sudo defaults write /Library/Preferences/com.apple.SoftwareUpdate 'CriticalUpdateInstall' -bool false
--- a/src/application/collections/windows.yaml
+++ b/src/application/collections/windows.yaml
--- a/src/presentation/assets/styles/_mixins.scss
+++ b/src/presentation/assets/styles/_mixins.scss
@@ -128,3 +128,8 @@
  $calculated-width-in-em: calc(#{$estimated-width-per-character-in-em} * #{$value-in-ch});
  #{$property}: $calculated-width-in-em;
 }
+
+@mixin base-font-style {
+  font-family: $font-family-main;
+  font-size: $font-size-absolute-normal;
+}
--- a/src/presentation/assets/styles/base/_index.scss
+++ b/src/presentation/assets/styles/base/_index.scss
@@ -21,9 +21,7 @@ $base-spacing: 1em;

 body {
  background: $color-background;
-  font-family: $font-family-main;
-  font-size: $font-size-absolute-normal;
-
+  @include base-font-style;
  @include apply-uniform-spacing($base-spacing: $base-spacing)
 }

--- a/src/presentation/components/Shared/TooltipWrapper.vue
+++ b/src/presentation/components/Shared/TooltipWrapper.vue
@@ -220,7 +220,9 @@ $color-tooltip-background: $color-primary-darkest;
  color: $color-on-primary;
  border-radius: 16px;
  padding: 12px 10px;
-  font-size: $font-size-absolute-normal;
+
+  // Explicitly set font styling for tooltips to prevent inconsistent appearances due to style inheritance from trigger elements.
+  @include base-font-style;

  /*
    This margin creates a visual buffer between the tooltip and the edges of the document.
--- a/src/presentation/electron/main/ElectronConfig.ts
+++ b/src/presentation/electron/main/ElectronConfig.ts
@@ -13,4 +13,4 @@ export const RENDERER_URL = process.env.ELECTRON_RENDERER_URL;

 export const RENDERER_HTML_PATH = join('file://', __dirname, '../renderer/index.html');

-export const PRELOADER_SCRIPT_PATH = join(__dirname, '../preload/index.cjs');
+export const PRELOADER_SCRIPT_PATH = join(__dirname, '../preload/index.mjs');
--- a/src/presentation/electron/main/Update/AutomaticUpdateCoordinator.ts
+++ b/src/presentation/electron/main/Update/AutomaticUpdateCoordinator.ts
@@ -1,18 +1,20 @@
 import { app, dialog } from 'electron/main';
-import { autoUpdater, type UpdateInfo } from 'electron-updater';
 import { ElectronLogger } from '@/infrastructure/Log/ElectronLogger';
 import { UpdateProgressBar } from './UpdateProgressBar';
+import { getAutoUpdater } from './ElectronAutoUpdaterFactory';
+import type { AppUpdater, UpdateInfo } from 'electron-updater';
 import type { ProgressInfo } from 'electron-builder';

 export async function handleAutoUpdate() {
+  const autoUpdater = getAutoUpdater();
  if (await askDownloadAndInstall() === DownloadDialogResult.NotNow) {
    return;
  }
-  startHandlingUpdateProgress();
+  startHandlingUpdateProgress(autoUpdater);
  await autoUpdater.downloadUpdate();
 }

-function startHandlingUpdateProgress() {
+function startHandlingUpdateProgress(autoUpdater: AppUpdater) {
  const progressBar = new UpdateProgressBar();
  progressBar.showIndeterminateState();
  autoUpdater.on('error', (e) => {
@@ -29,11 +31,11 @@ function startHandlingUpdateProgress() {
  autoUpdater.on('update-downloaded', async (info: UpdateInfo) => {
    ElectronLogger.info('@update-downloaded@\n', info);
    progressBar.close();
-    await handleUpdateDownloaded();
+    await handleUpdateDownloaded(autoUpdater);
  });
 }

-async function handleUpdateDownloaded() {
+async function handleUpdateDownloaded(autoUpdater: AppUpdater) {
  if (await askRestartAndInstall() === InstallDialogResult.NotNow) {
    return;
  }
--- a/src/presentation/electron/main/Update/ElectronAutoUpdaterFactory.ts
+++ b/src/presentation/electron/main/Update/ElectronAutoUpdaterFactory.ts
@@ -0,0 +1,8 @@
+import electronUpdater, { type AppUpdater } from 'electron-updater';
+
+export function getAutoUpdater(): AppUpdater {
+  // Using destructuring to access autoUpdater due to the CommonJS module of 'electron-updater'.
+  // It is a workaround for ESM compatibility issues, see https://github.com/electron-userland/electron-builder/issues/7976.
+  const { autoUpdater } = electronUpdater;
+  return autoUpdater;
+}
--- a/src/presentation/electron/main/Update/UpdateInitializer.ts
+++ b/src/presentation/electron/main/Update/UpdateInitializer.ts
@@ -1,13 +1,16 @@
-import { autoUpdater, type UpdateInfo } from 'electron-updater';
 import { ElectronLogger } from '@/infrastructure/Log/ElectronLogger';
 import { requiresManualUpdate, startManualUpdateProcess } from './ManualUpdater/ManualUpdateCoordinator';
 import { handleAutoUpdate } from './AutomaticUpdateCoordinator';
+import { getAutoUpdater } from './ElectronAutoUpdaterFactory';
+import type { UpdateInfo } from 'electron-updater';

 interface Updater {
  checkForUpdates(): Promise<void>;
 }

 export function setupAutoUpdater(): Updater {
+  const autoUpdater = getAutoUpdater();
+
  autoUpdater.logger = ElectronLogger;

  // Auto-downloads are disabled to allow separate handling of 'check' and 'download' actions,
--- a/tests/checks/desktop-runtime-errors/main.spec.ts
+++ b/tests/checks/desktop-runtime-errors/main.spec.ts
@@ -1,6 +1,7 @@
 import {
  describe, it, beforeAll, afterAll,
 } from 'vitest';
+import { formatAssertionMessage } from '@tests/shared/FormatAssertionMessage';
 import { main } from './check-desktop-runtime-errors/main';
 import { COMMAND_LINE_FLAGS, CommandLineFlag } from './check-desktop-runtime-errors/cli-args';

@@ -14,7 +15,10 @@ describe('desktop runtime error checks', () => {
      () => main(),
    );
    // assert
-    expect(exitCode).to.equal(0);
+    expect(exitCode).to.equal(0, formatAssertionMessage([
+      `Test failed with exit code ${exitCode}; expected 0.`,
+      'Examine preceding logs to identify errors.',
+    ]));
  }, {
    timeout: 60 /* minutes */ * 60000,
  });
--- a/tests/checks/external-urls/DocumentationUrlExtractor.ts
+++ b/tests/checks/external-urls/DocumentationUrlExtractor.ts
@@ -1,69 +0,0 @@
-import type { IApplication } from '@/domain/IApplication';
-import type { TestExecutionDetailsLogger } from './TestExecutionDetailsLogger';
-
-interface UrlExtractionContext {
-  readonly logger: TestExecutionDetailsLogger;
-  readonly application: IApplication;
-  readonly urlExclusionPatterns: readonly RegExp[];
-}
-
-export function extractDocumentationUrls(
-  context: UrlExtractionContext,
-): string[] {
-  const urlsInApplication = extractUrlsFromApplication(context.application);
-  context.logger.logLabeledInformation(
-    'Extracted URLs from application',
-    urlsInApplication.length.toString(),
-  );
-  const uniqueUrls = filterDuplicateUrls(urlsInApplication);
-  context.logger.logLabeledInformation(
-    'Unique URLs after deduplication',
-    `${uniqueUrls.length} (duplicates removed)`,
-  );
-  context.logger.logLabeledInformation(
-    'Exclusion patterns for URLs',
-    context.urlExclusionPatterns.length === 0
-      ? 'None (all URLs included)'
-      : context.urlExclusionPatterns.map((pattern, index) => `${index + 1}) ${pattern.toString()}`).join('\n'),
-  );
-  const includedUrls = filterUrlsExcludingPatterns(uniqueUrls, context.urlExclusionPatterns);
-  context.logger.logLabeledInformation(
-    'URLs extracted for testing',
-    `${includedUrls.length} (after applying exclusion patterns; ${uniqueUrls.length - includedUrls.length} URLs ignored)`,
-  );
-  return includedUrls;
-}
-
-function extractUrlsFromApplication(application: IApplication): string[] {
-  return [ // Get all executables
-    ...application.collections.flatMap((c) => c.getAllCategories()),
-    ...application.collections.flatMap((c) => c.getAllScripts()),
-  ]
-    // Get all docs
-    .flatMap((documentable) => documentable.docs)
-    // Parse all URLs
-    .flatMap((docString) => extractUrlsExcludingCodeBlocks(docString));
-}
-
-function filterDuplicateUrls(urls: readonly string[]): string[] {
-  return urls.filter((url, index, array) => array.indexOf(url) === index);
-}
-
-function filterUrlsExcludingPatterns(
-  urls: readonly string[],
-  patterns: readonly RegExp[],
-): string[] {
-  return urls.filter((url) => !patterns.some((pattern) => pattern.test(url)));
-}
-
-function extractUrlsExcludingCodeBlocks(textWithInlineCode: string): string[] {
-  /*
-    Matches URLs:
-    - Excludes inline code blocks as they may contain URLs not intended for user interaction
-      and not guaranteed to support expected HTTP methods, leading to false-negatives.
-    - Supports URLs containing parentheses, avoiding matches within code that might not represent
-      actual links.
-  */
-  const nonCodeBlockUrlRegex = /(?<!`)(https?:\/\/[^\s`"<>()]+(?:\([^\s`"<>()]*\))?[^\s`"<>()]*)/g;
-  return textWithInlineCode.match(nonCodeBlockUrlRegex) || [];
-}
--- a/tests/checks/external-urls/TestExecutionDetailsLogger.ts
+++ b/tests/checks/external-urls/TestExecutionDetailsLogger.ts
@@ -1,26 +0,0 @@
-import { indentText } from '@tests/shared/Text';
-
-export class TestExecutionDetailsLogger {
-  public logTestSectionStartDelimiter(): void {
-    this.logSectionDelimiterLine();
-  }
-
-  public logTestSectionEndDelimiter(): void {
-    this.logSectionDelimiterLine();
-  }
-
-  public logLabeledInformation(
-    label: string,
-    detailedInformation: string,
-  ): void {
-    console.log([
-      `${label}:`,
-      indentText(detailedInformation),
-    ].join('\n'));
-  }
-
-  private logSectionDelimiterLine(): void {
-    const horizontalLine = '─'.repeat(40);
-    console.log(horizontalLine);
-  }
-}
--- a/tests/checks/external-urls/main.spec.ts
+++ b/tests/checks/external-urls/main.spec.ts
@@ -1,26 +1,19 @@
 import { test, expect } from 'vitest';
 import { parseApplication } from '@/application/Parser/ApplicationParser';
+import type { IApplication } from '@/domain/IApplication';
 import { indentText } from '@tests/shared/Text';
 import { formatAssertionMessage } from '@tests/shared/FormatAssertionMessage';
-import { shuffle } from '@/application/Common/Shuffle';
 import { type UrlStatus, formatUrlStatus } from './StatusChecker/UrlStatus';
 import { getUrlStatusesInParallel, type BatchRequestOptions } from './StatusChecker/BatchStatusChecker';
-import { TestExecutionDetailsLogger } from './TestExecutionDetailsLogger';
-import { extractDocumentationUrls } from './DocumentationUrlExtractor';

 // arrange
-const logger = new TestExecutionDetailsLogger();
-logger.logTestSectionStartDelimiter();
 const app = parseApplication();
-let urls = extractDocumentationUrls({
-  logger,
-  urlExclusionPatterns: [
+const urls = collectUniqueUrls({
+  application: app,
+  excludePatterns: [
    /^https:\/\/archive\.ph/, // Drops HEAD/GET requests via fetch/curl, responding to Postman/Chromium.
  ],
-  application: app,
 });
-urls = filterUrlsToEnvironmentCheckLimit(urls);
-logger.logLabeledInformation('URLs submitted for testing', urls.length.toString());
 const requestOptions: BatchRequestOptions = {
  domainOptions: {
    sameDomainParallelize: false, // be nice to our third-party servers
@@ -37,65 +30,55 @@ const requestOptions: BatchRequestOptions = {
    enableCookies: true,
  },
 };
-logger.logLabeledInformation('HTTP request options', JSON.stringify(requestOptions, null, 2));
 const testTimeoutInMs = urls.length * 60 /* seconds */ * 1000;
-logger.logLabeledInformation('Scheduled test duration', convertMillisecondsToHumanReadableFormat(testTimeoutInMs));
-logger.logTestSectionEndDelimiter();
 test(`all URLs (${urls.length}) should be alive`, async () => {
  // act
-  console.log('URLS', urls); // TODO: Delete
  const results = await getUrlStatusesInParallel(urls, requestOptions);
  // assert
  const deadUrls = results.filter((r) => r.code === undefined || !isOkStatusCode(r.code));
-  expect(deadUrls).to.have.lengthOf(
-    0,
-    formatAssertionMessage([createReportForDeadUrlStatuses(deadUrls)]),
-  );
+  expect(deadUrls).to.have.lengthOf(0, formatAssertionMessage([formatUrlStatusReport(deadUrls)]));
 }, testTimeoutInMs);

 function isOkStatusCode(statusCode: number): boolean {
  return statusCode >= 200 && statusCode < 300;
 }

-function createReportForDeadUrlStatuses(deadUrlStatuses: readonly UrlStatus[]): string {
+function collectUniqueUrls(
+  options: {
+    readonly application: IApplication,
+    readonly excludePatterns?: readonly RegExp[],
+  },
+): string[] {
+  return [ // Get all nodes
+    ...options.application.collections.flatMap((c) => c.getAllCategories()),
+    ...options.application.collections.flatMap((c) => c.getAllScripts()),
+  ]
+    // Get all docs
+    .flatMap((documentable) => documentable.docs)
+    // Parse all URLs
+    .flatMap((docString) => extractUrls(docString))
+    // Remove duplicates
+    .filter((url, index, array) => array.indexOf(url) === index)
+    // Exclude certain URLs based on patterns
+    .filter((url) => !shouldExcludeUrl(url, options.excludePatterns ?? []));
+}
+
+function shouldExcludeUrl(url: string, patterns: readonly RegExp[]): boolean {
+  return patterns.some((pattern) => pattern.test(url));
+}
+
+function formatUrlStatusReport(deadUrlStatuses: readonly UrlStatus[]): string {
  return `\n${deadUrlStatuses.map((status) => indentText(formatUrlStatus(status))).join('\n---\n')}\n`;
 }

-function filterUrlsToEnvironmentCheckLimit(originalUrls: string[]): string[] {
-  const { RANDOMIZED_URL_CHECK_LIMIT } = process.env;
-  logger.logLabeledInformation('URL check limit', RANDOMIZED_URL_CHECK_LIMIT || 'Unlimited');
-  if (RANDOMIZED_URL_CHECK_LIMIT !== undefined && RANDOMIZED_URL_CHECK_LIMIT !== '') {
-    const maxUrlsInTest = parseInt(RANDOMIZED_URL_CHECK_LIMIT, 10);
-    if (Number.isNaN(maxUrlsInTest)) {
-      throw new Error(`Invalid URL limit: ${RANDOMIZED_URL_CHECK_LIMIT}`);
-    }
-    if (maxUrlsInTest < originalUrls.length) {
-      return shuffle(originalUrls).slice(0, maxUrlsInTest);
-    }
-  }
-  return originalUrls;
-}
-
-function convertMillisecondsToHumanReadableFormat(milliseconds: number): string {
-  const timeParts: string[] = [];
-  const addTimePart = (amount: number, label: string) => {
-    if (amount === 0) {
-      return;
-    }
-    timeParts.push(`${amount} ${label}`);
-  };
-
-  const hours = milliseconds / (1000 * 60 * 60);
-  const absoluteHours = Math.floor(hours);
-  addTimePart(absoluteHours, 'hours');
-
-  const minutes = (hours - absoluteHours) * 60;
-  const absoluteMinutes = Math.floor(minutes);
-  addTimePart(absoluteMinutes, 'minutes');
-
-  const seconds = (minutes - absoluteMinutes) * 60;
-  const absoluteSeconds = Math.floor(seconds);
-  addTimePart(absoluteSeconds, 'seconds');
-
-  return timeParts.join(', ');
+function extractUrls(textWithInlineCode: string): string[] {
+  /*
+    Matches URLs:
+    - Excludes inline code blocks as they may contain URLs not intended for user interaction
+      and not guaranteed to support expected HTTP methods, leading to false-negatives.
+    - Supports URLs containing parentheses, avoiding matches within code that might not represent
+      actual links.
+  */
+  const nonCodeBlockUrlRegex = /(?<!`)(https?:\/\/[^\s`"<>()]+(?:\([^\s`"<>()]*\))?[^\s`"<>()]*)/g;
+  return textWithInlineCode.match(nonCodeBlockUrlRegex) || [];
 }
--- a/tests/unit/application/Common/Shuffle.spec.ts
+++ b/tests/unit/application/Common/Shuffle.spec.ts
@@ -1,52 +0,0 @@
-import { describe, it, expect } from 'vitest';
-import { shuffle } from '@/application/Common/Shuffle';
-
-describe('Shuffle', () => {
-  describe('shuffle', () => {
-    it('returns a new array', () => {
-      // arrange
-      const inputArray = ['a', 'b', 'c', 'd'];
-      // act
-      const result = shuffle(inputArray);
-      // assert
-      expect(result).not.to.equal(inputArray);
-    });
-
-    it('returns an array of the same length', () => {
-      // arrange
-      const inputArray = ['a', 'b', 'c', 'd'];
-      // act
-      const result = shuffle(inputArray);
-      // assert
-      expect(result.length).toBe(inputArray.length);
-    });
-
-    it('contains the same elements', () => {
-      // arrange
-      const inputArray = ['a', 'b', 'c', 'd'];
-      // act
-      const result = shuffle(inputArray);
-      // assert
-      expect(result).to.have.members(inputArray);
-    });
-
-    it('does not modify the input array', () => {
-      // arrange
-      const inputArray = ['a', 'b', 'c', 'd'];
-      const inputArrayCopy = [...inputArray];
-      // act
-      shuffle(inputArray);
-      // assert
-      expect(inputArray).to.deep.equal(inputArrayCopy);
-    });
-
-    it('handles an empty array correctly', () => {
-      // arrange
-      const inputArray: string[] = [];
-      // act
-      const result = shuffle(inputArray);
-      // assert
-      expect(result).have.lengthOf(0);
-    });
-  });
-});
--- a/vite-config-helper.ts
+++ b/vite-config-helper.ts
@@ -55,7 +55,7 @@ function getPathAliasesFromTsConfig(): ViteAliasDefinitions {
 }

 function getElectronProcessSpecificModuleAliases(): ViteAliasDefinitions {
-  // Workaround for scoped Electron module imports due to https://github.com/alex8088/electron-vite/issues/372
+  // Workaround for Vite not being able to build tests with scoped Electron module imports.
  const electronProcessScopedModuleAliases = [
    'electron/main',
    'electron/renderer',
Author	SHA1	Message	Date
undergroundwires	fb65b32c6c	ci/cd: install `buildx` to fix deprecated warning	2024-03-22 00:39:07 +01:00
undergroundwires	8f497974a8	mac, linux, win: fix dead URLs and improve docs This commit fixes dead URLs and updates documentation references, improving accuracy and reliability. Key changes: - Fix dead URLs by using archived snapshots when they are detected as down by tests. - Update URLs to their new redirected locations. Other supporting changes: - Introduce long URLs for `archive.ph` links to retain the original URLs within the documentation. It simplifies the maintenance by removing the need to document the original locations along with the short URLs. - Improve some of the documentation to use more current sources, replacing the outdated ones.	2024-03-21 22:11:31 +01:00
undergroundwires	b71ad797a3	win: fix VSCode manual update switch script #312 This commit addresses a regression from refactoring in #215. It restores YAML escape mechanism with quoting around 'manual' in the `powerShellValue` attribute to ensure PowerShell interprets the value correctly. This change is documented with a comment to avoid future omissions. This reverts commit `c27172c32e`.	2024-03-20 08:38:23 +01:00
undergroundwires	ec34ac1124	Fix tooltip styling inconsistency This commit fixes inconsistent tooltip styling by setting the font explicitly on the tooltip container to ensure uniform tooltip fonts. As tooltip is rendered inside the parent elements' DOM, styling parent element's font was also styling the font's font due to style propogation, but setting fonts explicitly on tooltip ensure this does not happen.	2024-03-19 09:09:29 +01:00
undergroundwires	840adf9429	Bump Electron to latest and use native ESM This commit bumps Electron and related dependencies to their latest versions to leverage native ESM support. It adjusts build configuration to use native ESM support instead of relying on CommonJS bundling. Key changes: - Bump Electron to latest v29. Electron v28 ships with native ESM/ECMAScript modules support. Details on Electron ESM support: - electron/electron#21457 - electron/electron#37535 - Bump `electron-builder` to latest v24.13. `electron-builder` is used to package and publish the application. It supports ESM since 24.10. Details on `electron-builder` ESM support: - electron-userland/electron-builder#7936 - electron-userland/electron-builder#7935 - Bump `electron-log` to latest v5.1. `electron-log` supports ESM since version 5.0.4. Details on `electron-log` ESM support: - megahertz/electron-log#390. - Change `electron-vite` configuration to bundle as ESM instead of CommonJS to leverage Electron's native ESM support. Other supporting changes: - Add type hint for electron-builder configuration file. - Update import statements for `electron-updater` as it still is a CommonJS module and does not support ESM. Details: - electron-userland/electron-builder#7976 - Improve `electron-builder` configuration file to dynamically locate main entry files, supporting various JavaScript file extensions (`.js`, `.mjs` and `.cjs`) to facilitate easier future changes. - Change comment about Electron process-specific module alias registration. This issue has been fixed in `electron-vite`, but subpath module imports for Electron still do not work when building tests (`npm run test:unit`). Details: - alex8088/electron-vite#372 - Add `electron-log` in bundling process instead of externalizing to workaround Electron ESM loader issues with subpath imports (inability to do `electron-log/main`). Details: - alex8088/electron-vite#401 - electron/electron#41241 - Improve desktop runtime error checks' assertion message for better clarity.	2024-03-18 11:55:56 +01:00
undergroundwires	5eff3a0488	win: improve OneDrive data deletion safety This commit improves the safety mechanisms in the script for deleting OneDrive user data on Windows. Key changes: - System Integrity Protection: The script now checks if user shell folders point to the OneDrive directory. If they do, it halts the deletion and provides guidance to the user. This ensures system stability is not compromised. - Data Loss Prevention: The script will no longer delete files or non-empty folders. This precaution helps to avoid unintended data loss. Other supporting changes: - This script now covers OneDrive folders for multi-account users. - Separation of concerns: The 'Remove OneDrive residual files' script is is divided into two distinct scripts for better maintainability and documentation clarity: 1. 'Remove OneDrive user data and synced folders' 2. 'Remove OneDrive installation files and cache' - Fix an issue with the Windows 11 check in the 'Disable automatic OneDrive installation' revert script. - Update related documentation with archived URLs for reliability. - Fix indentation of OneDrive removal scripts.	2024-03-17 21:40:23 +01:00
undergroundwires	5abf8ff216	Improve URL checks to reduce false-negatives This commit improves the URL health checking mechanism to reduce false negatives. - Treat all 2XX status codes as successful, addressing issues with codes like `204`. - Improve URL matching to exclude URLs within Markdown inline code block and support URLs containing parentheses. - Add `forceHttpGetForUrlPatterns` to customize HTTP method per URL to allow verifying URLs behind CDN/WAFs that do not respond to HTTP HEAD. - Send the Host header for improved handling of webpages behind proxies. - Improve formatting and context for output messages. - Fix the defaulting options for redirects and cookie handling. - Update the user agent pool to modern browsers and platforms. - Add support for randomizing TLS fingerprint to mimic various clients better, improving the effectiveness of checks. However, this is not fully supported by Node.js's HTTP client; see nodejs/undici#1983 for more details. - Use `AbortSignal` instead of `AbortController` as more modern and simpler way to handle timeouts.	2024-03-16 18:15:34 +01:00