fix(docsite): prerender the templates gallery

[imdreamrunner]

Summary

• keep the /templates gallery in the prerendered static shell by narrowing useSearchParams() to an invisible URL synchronizer
• link template playground actions by slug, resolve source inside the playground instead of serializing every template's code into gallery HTML, then replace the bootstrap URL with the original canonical /playground#code=… form
• preserve preview deep links, close/navigation behavior, and native playground links with regression coverage

Measured result

Using the same headless Chromium probe against the current deploy and this production build:

• gallery heading after response start: ~515 ms → ~19 ms
• layout shift: 0.258 → 0.005
• script execution: 690 ms → 546 ms
• the production build now reports /templates as static, and its initial HTML contains the heading and gallery description

Test plan

• pnpm lint:strict
• pnpm -F @astryxdesign/docsite typecheck
• pnpm -F @astryxdesign/docsite test — 457 passed
• pnpm -F @astryxdesign/docsite build — 341 static pages, /templates static
• pnpm vitest run --project node packages/cli — 3,119 passed
• Playwright production-build flow: card → preview query, close clears query, direct preview deep link, template → playground source handoff

The monolithic pnpm test run hit the repository's known full-load CLI timeout cluster (12 tests); the isolated CLI project above passed all 3,119 tests.

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated
astryx	Ready	Preview	Sep 2, 2026 10:46pm UTC

[github-actions]

PR Analysis Report

Current run: The current CI run completed, but its trusted analysis is unavailable. Preview links are not shown.

---

_{Generated by PR Enrichment workflow | View current CI run}