@xingwangzhe/stalux 1.28.2 → 1.28.4

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@xingwangzhe/stalux",
-    "version": "1.28.2",
+    "version": "1.28.4",
     "description": "A powerful, modern Astro blog theme — use as template or install as plugin",
     "keywords": [
         "astro",
@@ -121,13 +121,13 @@
         "@biomejs/biome": "2.5.14",
         "@types/node": "^26.6.2",
         "@vitest/coverage-v8": "5.0.1",
-        "astro": "^7.3.4",
+        "astro": "^7.3.5",
         "knip": "^6.37.0",
         "typescript": "npm:@typescript/typescript6@6.0.2",
         "vite": "8.3.0",
         "vitest": "5.0.1"
     },
     "peerDependencies": {
-        "astro": "7.3.4"
+        "astro": "^7.3.5"
     }
 }

package/src/scripts/google-analytics.ts

@@ -12,6 +12,36 @@ declare global {
     }
 }
 
+function appendWhenIdle(script: HTMLScriptElement): void {
+    const append = () => document.head.appendChild(script);
+    const requestIdle = (
+        window as Window & {
+            requestIdleCallback?: (callback: () => void, options?: { timeout: number }) => number;
+        }
+    ).requestIdleCallback;
+
+    if (requestIdle) requestIdle.call(window, append, { timeout: 1200 });
+    else window.setTimeout(append, 0);
+}
+
+function appendAfterPageLoad(script: HTMLScriptElement): void {
+    let appended = false;
+    const schedule = () => {
+        if (appended) return;
+        appended = true;
+        appendWhenIdle(script);
+    };
+
+    if (document.readyState === "complete") {
+        schedule();
+        return;
+    }
+
+    window.addEventListener("load", schedule, { once: true });
+    // Avoid indefinitely delaying analytics if an image or other resource stalls load.
+    window.setTimeout(schedule, 5000);
+}
+
 function load() {
     const gaID = document.body?.dataset.staluxGaId;
     if (!gaID) return;
@@ -21,6 +51,7 @@ function load() {
         window.__staluxGoogleScriptLoaded = true;
         const script = document.createElement("script");
         script.async = true;
+        script.fetchPriority = "low";
         script.dataset.staluxGoogle = "true";
         script.src = `https://www.googletagmanager.com/gtag/js?id=${encodeURIComponent(gaID)}`;
         script.addEventListener("load", () => logger.debug("external script loaded"), {
@@ -31,8 +62,8 @@ function load() {
             () => logger.warn("external script failed to load (network or content blocker)"),
             { once: true },
         );
-        logger.debug("loading external script");
-        document.head.appendChild(script);
+        logger.debug("deferred external script until page load and idle time");
+        appendAfterPageLoad(script);
     }
     if (!window.__staluxAnalyticsLoaded) {
         window.__staluxAnalyticsLoaded = true;