perf(site): parallelize and cache pre-build scripts via turbo tasks (#1202)

Co-authored-by: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

site/package.json

@@ -5,10 +5,9 @@
   "scripts": {
     "api-docs": "tsx scripts/api-docs-builder/src/index.ts",
     "ejected-skins": "tsx scripts/build-ejected-skins.ts",
-    "predev": "pnpm api-docs && pnpm ejected-skins",
     "dev": "NETLIFY_DEV=1 astro dev",
-    "prebuild": "pnpm api-docs && pnpm ejected-skins",
     "build": "astro build",
+    "clean": "rm -rf dist .netlify src/content/generated-component-reference src/content/generated-util-reference src/content/ejected-skins.json",
     "astro": "astro",
     "test": "vitest run",
     "test:watch": "vitest",

site/turbo.json

@@ -2,7 +2,16 @@
   "$schema": "https://turbo.build/schema.json",
   "extends": ["//"],
   "tasks": {
+    "api-docs": {
+      "dependsOn": ["^build"],
+      "outputs": ["src/content/generated-component-reference/**", "src/content/generated-util-reference/**"]
+    },
+    "ejected-skins": {
+      "dependsOn": ["^build"],
+      "outputs": ["src/content/ejected-skins.json"]
+    },
     "build": {
+      "dependsOn": ["$TURBO_EXTENDS$", "api-docs", "ejected-skins"],
       "env": [
         "OAUTH_CLIENT_ID",
         "OAUTH_CLIENT_SECRET",
@@ -14,6 +23,7 @@
       ]
     },
     "dev": {
+      "dependsOn": ["$TURBO_EXTENDS$", "api-docs", "ejected-skins"],
       "env": [
         "OAUTH_CLIENT_ID",
         "OAUTH_CLIENT_SECRET",