docs: bump docusaurus to 3.8.1 (#3009)

Author: B4nan

renovate.json

@@ -24,5 +24,5 @@
 		}
 	],
 	"schedule": ["every weekday"],
-	"ignoreDeps": ["crawlee", "cheerio", "playwright"]
+	"ignoreDeps": ["crawlee", "cheerio", "playwright", "yarn"]
 }

website/docusaurus.config.js

@@ -56,7 +56,20 @@ module.exports = {
     onBrokenMarkdownLinks:
     /** @type {import('@docusaurus/types').ReportingSeverity} */ ('throw'),
     future: {
-        experimental_faster: true,
+        experimental_faster: {
+            // ssgWorkerThreads: true,
+            swcJsLoader: true,
+            swcJsMinimizer: true,
+            swcHtmlMinimizer: true,
+            lightningCssMinimizer: true,
+            rspackBundler: true,
+            mdxCrossCompilerCache: true,
+            rspackPersistentCache: true,
+        },
+        v4: {
+            removeLegacyPostBuildHeadAttribute: true,
+            useCssCascadeLayers: false,
+        },
     },
     presets: /** @type {import('@docusaurus/types').PresetConfig[]} */ ([
         [

website/package.json

@@ -17,8 +17,8 @@
     "devDependencies": {
         "@apify/eslint-config-ts": "^0.4.0",
         "@apify/tsconfig": "^0.1.0",
-        "@docusaurus/module-type-aliases": "3.7.0",
-        "@docusaurus/types": "3.7.0",
+        "@docusaurus/module-type-aliases": "3.8.1",
+        "@docusaurus/types": "3.8.1",
         "@types/react": "^19.0.0",
         "@typescript-eslint/eslint-plugin": "^7.0.0",
         "@typescript-eslint/parser": "^7.0.0",
@@ -30,16 +30,18 @@
         "path-browserify": "^1.0.1",
         "prettier": "^3.0.0",
         "rimraf": "^6.0.0",
-        "typescript": "^5.7.2"
+        "typescript": "^5.8.3"
     },
     "dependencies": {
-        "@apify/docusaurus-plugin-typedoc-api": "^4.3.2",
+        "@apify/docusaurus-plugin-typedoc-api": "^4.4.5",
         "@apify/utilities": "^2.8.0",
-        "@docusaurus/core": "3.7.0",
-        "@docusaurus/faster": "3.7.0",
-        "@docusaurus/mdx-loader": "3.7.0",
-        "@docusaurus/plugin-client-redirects": "3.7.0",
-        "@docusaurus/preset-classic": "3.7.0",
+        "@docusaurus/core": "3.8.1",
+        "@docusaurus/faster": "3.8.1",
+        "@docusaurus/mdx-loader": "3.8.1",
+        "@docusaurus/plugin-client-redirects": "3.8.1",
+        "@docusaurus/plugin-content-docs": "3.8.1",
+        "@docusaurus/preset-classic": "3.8.1",
+        "@docusaurus/theme-common": "3.8.1",
         "@giscus/react": "^3.0.0",
         "@mdx-js/react": "^3.0.1",
         "axios": "^1.5.0",
@@ -58,5 +60,17 @@
         "stream-browserify": "^3.0.0",
         "unist-util-visit": "^5.0.0"
     },
+    "browserslist": {
+        "production": [
+            ">0.5%",
+            "not dead",
+            "not op_mini all"
+        ],
+        "development": [
+            "last 3 chrome version",
+            "last 3 firefox version",
+            "last 5 safari version"
+        ]
+    },
     "packageManager": "yarn@4.8.1"
 }

website/src/plugins/docusaurus-plugin-segment/index.js

@@ -1,38 +1,37 @@
 const path = require('path');
 
 module.exports = function (context, options) {
-  const { writeKey, allowedInDev = false } = options;
+    const { writeKey, allowedInDev = false } = options;
 
-  return {
-    name: 'docusaurus-plugin-segment',
+    return {
+        name: 'docusaurus-plugin-segment',
 
-    getClientModules() {
-      return [path.resolve(__dirname, './segment')];
-    },
+        getClientModules() {
+            return [path.resolve(__dirname, './segment')];
+        },
 
-    injectHtmlTags() {
-      if (!writeKey) {
-        throw new Error(
-          'You need to specify a Segment writeKey in the plugin options'
-        );
-      }
+        injectHtmlTags() {
+            if (process.env.NODE_ENV !== 'production' && !allowedInDev) {
+                return {};
+            }
 
-      if (process.env.NODE_ENV !== 'production' && !allowedInDev) {
-        return {};
-      }
+            if (!writeKey) {
+                console.warn('You need to specify a Segment writeKey in the plugin options');
+                return {};
+            }
 
-      return {
-        headTags: [
-          {
-            tagName: 'script',
-            innerHTML: `
+            return {
+                headTags: [
+                    {
+                        tagName: 'script',
+                        innerHTML: `
             !function(){var i="analytics",analytics=window[i]=window[i]||[];if(!analytics.initialize)if(analytics.invoked)window.console&&console.error&&console.error("Segment snippet included twice.");else{analytics.invoked=!0;analytics.methods=["trackSubmit","trackClick","trackLink","trackForm","pageview","identify","reset","group","track","ready","alias","debug","page","screen","once","off","on","addSourceMiddleware","addIntegrationMiddleware","setAnonymousId","addDestinationMiddleware","register"];analytics.factory=function(e){return function(){if(window[i].initialized)return window[i][e].apply(window[i],arguments);var n=Array.prototype.slice.call(arguments);if(["track","screen","alias","group","page","identify"].indexOf(e)>-1){var c=document.querySelector("link[rel='canonical']");n.push({__t:"bpc",c:c&&c.getAttribute("href")||void 0,p:location.pathname,u:location.href,s:location.search,t:document.title,r:document.referrer})}n.unshift(e);analytics.push(n);return analytics}};for(var n=0;n<analytics.methods.length;n++){var key=analytics.methods[n];analytics[key]=analytics.factory(key)}analytics.load=function(key,n){var t=document.createElement("script");t.type="text/javascript";t.async=!0;t.setAttribute("data-global-segment-analytics-key",i);t.src="https://cdn.segment.com/analytics.js/v1/" + key + "/analytics.min.js";var r=document.getElementsByTagName("script")[0];r.parentNode.insertBefore(t,r);analytics._loadOptions=n};analytics._writeKey="${writeKey}";;analytics.SNIPPET_VERSION="5.2.0";
             analytics.load("${writeKey}", { integrations: { "Segment.io": { apiHost: "analytics.apify.com/v1" } } });
             }}();
             `,
-          },
-        ],
-      };
-    },
-  };
+                    },
+                ],
+            };
+        },
+    };
 };

website/src/plugins/docusaurus-plugin-segment/segment.js

@@ -2,14 +2,14 @@ import ExecutionEnvironment from '@docusaurus/ExecutionEnvironment';
 
 export default ExecutionEnvironment.canUseDOM ? {
     onRouteUpdate({ location }) {
-      // Don't track page views on development
-      if (process.env.NODE_ENV === 'production' && window.analytics) {
-        window.analytics.page({
-          app: 'crawlee',
-          path: location.pathname,
-          url: location.href,
-          search: location.search,
-        });
-      }
+        // Don't track page views on development
+        if (process.env.NODE_ENV === 'production' && window.analytics) {
+            window.analytics.page({
+                app: 'crawlee',
+                path: location.pathname,
+                url: location.href,
+                search: location.search,
+            });
+        }
     },
 } : null;

website/src/theme/Navbar/MobileSidebar/index.js

@@ -1,7 +1,9 @@
+import {
+    useWindowSize,
+} from '@docusaurus/theme-common';
 import {
     useLockBodyScroll,
     useNavbarMobileSidebar,
-    useWindowSize,
 } from '@docusaurus/theme-common/internal';
 import NavbarMobileSidebarHeader from '@theme/Navbar/MobileSidebar/Header';
 import NavbarMobileSidebarLayout from '@theme/Navbar/MobileSidebar/Layout';