feat(docs): add post-build script to update routes excluding HTML files

apps/web/package.json

@@ -5,8 +5,9 @@
   "type": "module",
   "scripts": {
     "dev": "vite dev",
-    "build": "pnpm build:docs && vite build",
+    "build": "pnpm build:docs && vite build && pnpm post-build",
     "build:docs": "tsx scripts/build-docs.ts",
+    "post-build": "tsx scripts/post-build.ts",
     "preview": "vite preview",
     "deploy": "pnpm build && wrangler pages deploy .svelte-kit/cloudflare",
     "test": "vitest",

apps/web/scripts/post-build.ts

@@ -0,0 +1,57 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+
+const PROJECT_ROOT = path.resolve(__dirname, '..');
+const CLOUDFLARE_DIR = path.join(PROJECT_ROOT, '.svelte-kit/cloudflare');
+const ROUTES_FILE = path.join(CLOUDFLARE_DIR, '_routes.json');
+
+interface RoutesJson {
+  version: number;
+  description: string;
+  include: string[];
+  exclude: string[];
+}
+
+const routesJson: RoutesJson = JSON.parse(fs.readFileSync(ROUTES_FILE, 'utf-8'));
+
+const docsExcludes = routesJson.exclude.filter((rule) => rule.startsWith('/docs/') && rule.endsWith('.html'));
+
+const htmlLessExcludes = docsExcludes.map((rule) => rule.replace(/\.html$/, ''));
+
+const newExcludes = [...routesJson.exclude];
+for (const exclude of htmlLessExcludes) {
+  if (!newExcludes.includes(exclude)) {
+    newExcludes.push(exclude);
+  }
+}
+
+if (!newExcludes.includes('/docs')) {
+  newExcludes.push('/docs');
+}
+if (!newExcludes.includes('/docs/user')) {
+  newExcludes.push('/docs/user');
+}
+if (!newExcludes.includes('/docs/developer')) {
+  newExcludes.push('/docs/developer');
+}
+if (!newExcludes.includes('/docs/user/features')) {
+  newExcludes.push('/docs/user/features');
+}
+if (!newExcludes.includes('/docs/user/features/common')) {
+  newExcludes.push('/docs/user/features/common');
+}
+if (!newExcludes.includes('/docs/user/features/home')) {
+  newExcludes.push('/docs/user/features/home');
+}
+if (!newExcludes.includes('/docs/user/features/themes')) {
+  newExcludes.push('/docs/user/features/themes');
+}
+
+routesJson.exclude = newExcludes;
+
+fs.writeFileSync(ROUTES_FILE, JSON.stringify(routesJson, null, '\t'));
+console.log('Updated _routes.json with html-less doc paths');