chore: deps upgrade + Docusaurus 3.10 hardening

.github/workflows/deploy.yml

@@ -15,10 +15,10 @@ jobs:
     name: Deploy to GitHub Pages
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v3
-      - uses: actions/setup-node@v3
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
         with:
-          node-version: 18
+          node-version: 24
           cache: npm
 
       - name: Install dependencies
@@ -31,7 +31,7 @@ jobs:
       # Popular action to deploy to GitHub Pages:
       # Docs: https://github.com/peaceiris/actions-gh-pages#%EF%B8%8F-docusaurus
       - name: Deploy to GitHub Pages
-        uses: peaceiris/actions-gh-pages@v3
+        uses: peaceiris/actions-gh-pages@v4
         with:
           github_token: ${{ secrets.GITHUB_TOKEN }}
           # Build output to publish to the `gh-pages` branch:

.github/workflows/test-deploy.yml

@@ -12,10 +12,10 @@ jobs:
     name: Test deployment
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v3
-      - uses: actions/setup-node@v3
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
         with:
-          node-version: 18
+          node-version: 24
           cache: npm
 
       - name: Install dependencies

docs/Server-Admin-Onboarding.md

@@ -367,7 +367,7 @@ After first login, you can control how additional users are created through Sett
    - Verify you're the first user created
    - Confirm `SECURITY_ENABLELOGIN=true` is set
 
-:::caution Secure Your Admin Account
+:::warning Secure Your Admin Account
 - **Change the default password immediately** after first login
 - Use a strong password (12+ characters, mixed case, numbers, symbols)
 - Consider using SSO (OAuth2/SAML2) to avoid password management entirely
@@ -462,7 +462,7 @@ processExecutor:
 
 Navigate to **Settings → Security**
 
-:::caution Critical for Production
+:::warning Critical for Production
 These settings directly impact your organization's security. Review carefully!
 :::
 

docusaurus.config.js

@@ -21,7 +21,25 @@ const config = {
     projectName: 'Stirling-PDF', // Usually your repo name.
 
     onBrokenLinks: 'throw',
-    onBrokenMarkdownLinks: 'warn',
+    onBrokenAnchors: 'throw',
+
+    markdown: {
+        hooks: {
+            onBrokenMarkdownLinks: 'warn',
+        },
+    },
+
+    future: {
+        v4: {
+            removeLegacyPostBuildHeadAttribute: true,
+        },
+        faster: true,
+    },
+
+    storage: {
+        type: 'localStorage',
+        namespace: true,
+    },
 
     i18n: {
         defaultLocale: 'en',
@@ -55,6 +73,28 @@ const config = {
         enableInDevelopment: true, // optional
       },
     ],
+    function scarfTrackingPixelPlugin() {
+      return {
+        name: 'scarf-tracking-pixel',
+        injectHtmlTags() {
+          return {
+            postBodyTags: [
+              {
+                tagName: 'img',
+                attributes: {
+                  referrerpolicy: 'no-referrer-when-downgrade',
+                  src: 'https://static.scarf.sh/a.png?x-pxid=5d074971-2ecb-4c54-8397-30c0f91896b3',
+                  height: '1',
+                  width: '1',
+                  style: 'display:none',
+                  alt: 'x',
+                },
+              },
+            ],
+          };
+        },
+      };
+    },
   ],
   clientModules: [
     require.resolve('./src/clientModules/anchorScroll.js'),
@@ -84,26 +124,21 @@ const config = {
                 theme: {
                     customCss: require.resolve('./src/css/custom.css'),
                 },
+                sitemap: {
+                    lastmod: 'date',
+                    priority: null,
+                    changefreq: null,
+                },
             }),
         ],
     ],
-	headTags: [
-	  {
-		tagName: 'img',
-		attributes: {
-		  referrerpolicy: 'no-referrer-when-downgrade',
-		  src: 'https://static.scarf.sh/a.png?x-pxid=5d074971-2ecb-4c54-8397-30c0f91896b3',
-		  height: '1',
-		  width: '1',
-		  style: 'display:none',
-		  alt: 'x',
-		},
-	  },
-	],
-
     themeConfig:
         /** @type {import('@docusaurus/preset-classic').ThemeConfig} */
         ({
+			colorMode: {
+				defaultMode: 'light',
+				respectPrefersColorScheme: true,
+			},
 			// Improve anchor scrolling behavior
 			scrollToTop: true,
 			scrollToTopOptions: {