From 15cc032602a5871706fd0506f2652ffd10208c94 Mon Sep 17 00:00:00 2001
From: hongyi-chen <hongyigma@gmail.com>
Date: Tue, 28 Jul 2026 22:24:18 +0000
Subject: [PATCH] Fix Vite 8 (Rolldown/OXC) transform error in CopyPageButton
 script

Astro compiles client `<script>` blocks into virtual modules tagged
`?astro&type=script&index=0&lang.ts` and relies on the transformer to
strip TypeScript. With Astro 7 now pulling in Vite 8 (Rolldown-powered,
using the OXC transformer instead of esbuild), OXC infers the language
from the real `.astro` extension rather than the `lang.ts` query, so it
parses the script as plain JS and rejects the TS-only syntax with
`[PARSE_ERROR] Type assertion expressions can only be used in
TypeScript files`.

Convert the three bits of TS-only syntax in the script block to JSDoc
casts (valid JS that OXC accepts) so the type info is preserved for
`astro check` while `npm run dev`/`build` succeed on Vite 8:
- `as HTMLTemplateElement | null` -> `/** @type {...} */ (...)`
- `(e: MouseEvent)` -> `/** @param {MouseEvent} e */`
- `e.target as Node` -> `/** @type {Node} */ (e.target)`

Verified with a clean `astro dev` startup and a full `astro build` (exit
0, no vite:oxc parse errors) on Vite 8.1.5 + Rolldown 1.1.5 + Astro 7.1.3.

Co-Authored-By: Oz <oz-agent@warp.dev>
---
 src/components/CopyPageButton.astro | 13 +++++++++----
 1 file changed, 9 insertions(+), 4 deletions(-)

diff --git a/src/components/CopyPageButton.astro b/src/components/CopyPageButton.astro
index b892b0f4..725468ae 100644
--- a/src/components/CopyPageButton.astro
+++ b/src/components/CopyPageButton.astro
@@ -148,8 +148,12 @@ const claudeUrl = `https://claude.ai/new?q=${prompt}`;
     const copyPromptBtn = document.getElementById('copy-agent-prompt');
     const viewMdBtn = document.getElementById('view-as-markdown');
     const exportBtn = document.getElementById('export-as-pdf');
-    const mdTemplate = document.getElementById('page-markdown-content') as HTMLTemplateElement | null;
-    const promptTemplate = document.getElementById('agent-prompt-content') as HTMLTemplateElement | null;
+    const mdTemplate = /** @type {HTMLTemplateElement | null} */ (
+      document.getElementById('page-markdown-content')
+    );
+    const promptTemplate = /** @type {HTMLTemplateElement | null} */ (
+      document.getElementById('agent-prompt-content')
+    );
 
     if (!wrapper || !trigger || !panel) return;
 
@@ -163,8 +167,9 @@ const claudeUrl = `https://claude.ai/new?q=${prompt}`;
       }
     });
 
-    function closeOnOutsideClick(e: MouseEvent) {
-      if (!wrapper?.contains(e.target as Node)) {
+    /** @param {MouseEvent} e */
+    function closeOnOutsideClick(e) {
+      if (!wrapper?.contains(/** @type {Node} */ (e.target))) {
         panel?.classList.remove('open');
         trigger?.classList.remove('active');
         document.removeEventListener('click', closeOnOutsideClick);