feat(docs): add Google Analytics tracking to VitePress documentation (#216)

- Integrate vitepress-plugin-google-analytics for clean SPA navigation handling
- Support VITE_GA_ID env var override, default to G-RY1XJ7LR5F

Closes #214

Author: polaz

docs/.vitepress/theme/index.ts

@@ -1,6 +1,7 @@
 import { h } from "vue";
 import DefaultTheme from "vitepress/theme";
 import type { Theme } from "vitepress";
+import googleAnalytics from "vitepress-plugin-google-analytics";
 import "./style.css";
 import BugReportWidget from "./components/BugReportWidget.vue";
 
@@ -11,4 +12,9 @@ export default {
       "layout-bottom": () => h(BugReportWidget),
     });
   },
+  enhanceApp({ app }) {
+    googleAnalytics({
+      id: import.meta.env.VITE_GA_ID || "G-RY1XJ7LR5F",
+    });
+  },
 } satisfies Theme;

package.json

@@ -112,6 +112,7 @@
     "ts-jest": "^29.4.6",
     "ts-node": "^10.9.2",
     "typescript": "^5.9.3",
-    "vitepress": "^1.6.4"
+    "vitepress": "^1.6.4",
+    "vitepress-plugin-google-analytics": "^1.0.2"
   }
 }

yarn.lock

@@ -2657,6 +2657,7 @@ __metadata:
     typescript: "npm:^5.9.3"
     undici: "npm:^7.19.1"
     vitepress: "npm:^1.6.4"
+    vitepress-plugin-google-analytics: "npm:^1.0.2"
     yaml: "npm:^2.8.2"
     zod: "npm:^4.3.6"
   bin:
@@ -11049,6 +11050,13 @@ __metadata:
   languageName: node
   linkType: hard
 
+"vitepress-plugin-google-analytics@npm:^1.0.2":
+  version: 1.0.2
+  resolution: "vitepress-plugin-google-analytics@npm:1.0.2"
+  checksum: 10c0/17b09ff91cf7f3bdd43373386f37315e88094576834dd5256071c8f357f43b23a0cb3a059f014cabccd80aea5f685c3947451f81b79d8f82add7e263ed80ccde
+  languageName: node
+  linkType: hard
+
 "vitepress@npm:^1.6.4":
   version: 1.6.4
   resolution: "vitepress@npm:1.6.4"