Merge pull request tsparticles#5735 from tsparticles/v4

build: update sitemaps covering typedoc pages too

Author: matteobruni

websites/website/package.json

@@ -11,8 +11,8 @@
         "docs:typedoc": "node ./scripts/sync-typedoc.mjs",
         "docs:assets": "node ./scripts/sync-public-assets.mjs",
         "dev": "pnpm run typedoc:api && pnpm run docs:typedoc && pnpm run docs:assets && vitepress dev docs --host",
-        "docs:build": "pnpm run typedoc:api && pnpm run docs:typedoc && pnpm run lint:fix && pnpm run docs:assets && vitepress build docs",
-        "docs:build:ci": "pnpm run typedoc:api && pnpm run docs:typedoc && pnpm run lint && pnpm run docs:assets && vitepress build docs",
+        "docs:build": "pnpm run typedoc:api && pnpm run docs:typedoc && pnpm run lint:fix && pnpm run docs:assets && vitepress build docs && node ./scripts/merge-sitemaps.mjs",
+        "docs:build:ci": "pnpm run typedoc:api && pnpm run docs:typedoc && pnpm run lint && pnpm run docs:assets && vitepress build docs && node ./scripts/merge-sitemaps.mjs",
         "docs:preview": "vitepress preview docs --host",
         "build": "pnpm run docs:build",
         "lint": "prettier --check \"docs/**/*.{md,ts,css}\"",

websites/website/scripts/merge-sitemaps.mjs

@@ -0,0 +1,36 @@
+#!/usr/bin/env node
+import { readFileSync, writeFileSync, existsSync } from "node:fs";
+import { resolve } from "node:path";
+
+const rootDir = resolve(new URL("..", import.meta.url).pathname);
+const distDir = resolve(rootDir, "docs", ".vitepress", "dist");
+const mainSitemap = resolve(distDir, "sitemap.xml");
+const typedocSitemap = resolve(distDir, "docs", "sitemap.xml");
+
+if (!existsSync(mainSitemap)) {
+  console.log("[merge-sitemaps] main sitemap not found, skipping");
+  process.exit(0);
+}
+
+if (!existsSync(typedocSitemap)) {
+  console.log("[merge-sitemaps] typedoc sitemap not found, skipping");
+  process.exit(0);
+}
+
+const main = readFileSync(mainSitemap, "utf-8");
+const typedoc = readFileSync(typedocSitemap, "utf-8");
+
+const urlEntries = typedoc.match(/<url>[\s\S]*?<\/url>/g);
+
+if (!urlEntries || urlEntries.length === 0) {
+  console.log("[merge-sitemaps] no typedoc URLs found, skipping");
+  process.exit(0);
+}
+
+const merged = main.replace("</urlset>", urlEntries.join("\n") + "\n</urlset>");
+
+writeFileSync(mainSitemap, merged, "utf-8");
+
+console.log(
+  `[merge-sitemaps] merged ${urlEntries.length} typedoc URLs into sitemap.xml`,
+);

websites/website/typedoc.json

@@ -158,7 +158,7 @@
   "includeVersion": true,
   "hideGenerator": true,
   "out": "typedoc-dist",
-  "hostedBaseUrl": "https://particles.js.org/typedoc",
+  "hostedBaseUrl": "https://particles.js.org/docs",
   "useHostedBaseUrlForAbsoluteLinks": true,
   "plugin": [
     "typedoc-plugin-google-ads",