From b952889300ba74d039553a86c61ed3b2c990b30e Mon Sep 17 00:00:00 2001
From: Martin Donadieu <martindonadieu@gmail.com>
Date: Tue, 14 Apr 2026 12:15:41 +0200
Subject: [PATCH 1/3] fix astro deprecation warnings

---
 apps/docs/src/components/doc/CopyPage.astro   | 27 ++++---------------
 apps/web/src/content.config.ts                |  8 +++---
 .../pages/tools/ios-udid-finder/result.astro  | 19 +++----------
 3 files changed, 12 insertions(+), 42 deletions(-)

diff --git a/apps/docs/src/components/doc/CopyPage.astro b/apps/docs/src/components/doc/CopyPage.astro
index ad343c435..e580df7e1 100644
--- a/apps/docs/src/components/doc/CopyPage.astro
+++ b/apps/docs/src/components/doc/CopyPage.astro
@@ -205,30 +205,13 @@ const translations = {
           throw new Error('Failed to fetch markdown from any source')
         }
 
-        // Copy to clipboard using the most reliable method
-        try {
-          await navigator.clipboard.writeText(content)
-          console.log('Copied to clipboard successfully')
-        } catch (clipboardError) {
-          console.error('Clipboard API failed, trying fallback:', clipboardError)
-
-          // Fallback method using textarea
-          const textarea = document.createElement('textarea')
-          textarea.value = content
-          textarea.style.position = 'fixed'
-          textarea.style.opacity = '0'
-          document.body.appendChild(textarea)
-          textarea.focus()
-          textarea.select()
-          // @ts-expect-error execCommand is deprecated but used as fallback for older browsers
-          const success = document.execCommand('copy')
-          document.body.removeChild(textarea)
-
-          if (!success) {
-            throw new Error('Fallback copy method also failed')
-          }
+        if (!navigator.clipboard?.writeText) {
+          throw new Error('Clipboard API unavailable')
         }
 
+        await navigator.clipboard.writeText(content)
+        console.log('Copied to clipboard successfully')
+
         // Show success feedback
         if (title) {
           title.textContent = translations.copied
diff --git a/apps/web/src/content.config.ts b/apps/web/src/content.config.ts
index 644bc26be..0658dc136 100644
--- a/apps/web/src/content.config.ts
+++ b/apps/web/src/content.config.ts
@@ -1,11 +1,9 @@
 import { glob } from 'astro/loaders'
-import { defineCollection, z } from 'astro:content'
+import { z } from 'astro/zod'
+import { defineCollection } from 'astro:content'
 import { locales, type Locales } from './services/locale'
 
-const localeSchema = z.custom<Locales>(
-  (value) => typeof value === 'string' && locales.includes(value as Locales),
-  { message: 'Invalid locale' },
-)
+const localeSchema = z.custom<Locales>((value) => typeof value === 'string' && locales.includes(value as Locales), { message: 'Invalid locale' })
 
 const blog = defineCollection({
   loader: glob({ pattern: '**/*.md', base: 'src/content/blog', generateId: ({ entry }) => entry }),
diff --git a/apps/web/src/pages/tools/ios-udid-finder/result.astro b/apps/web/src/pages/tools/ios-udid-finder/result.astro
index a65fd2f63..39f45f8f0 100644
--- a/apps/web/src/pages/tools/ios-udid-finder/result.astro
+++ b/apps/web/src/pages/tools/ios-udid-finder/result.astro
@@ -142,22 +142,11 @@ const signingDocsHref = getRelativeLocaleUrl(Astro.locals.locale, 'docs/cli/clou
   }
 
   async function copyText(value: string): Promise<void> {
-    try {
-      await navigator.clipboard.writeText(value)
-    } catch {
-      const helper = document.createElement('textarea')
-      helper.value = value
-      helper.setAttribute('readonly', 'true')
-      helper.style.position = 'absolute'
-      helper.style.opacity = '0'
-      document.body.append(helper)
-      helper.select()
-      const copied = document.execCommand('copy')
-      helper.remove()
-      if (!copied) {
-        throw new Error('Copy failed')
-      }
+    if (!navigator.clipboard?.writeText) {
+      throw new Error('Clipboard API unavailable')
     }
+
+    await navigator.clipboard.writeText(value)
   }
 
   function bindCopyButtons(): void {

From d8b478d184ce1794a9bc080c997f8e60072c18fe Mon Sep 17 00:00:00 2001
From: Martin Donadieu <martindonadieu@gmail.com>
Date: Tue, 14 Apr 2026 12:33:17 +0200
Subject: [PATCH 2/3] restore clipboard fallback paths

---
 apps/docs/src/components/doc/CopyPage.astro   | 61 ++++++++++++++-----
 .../pages/tools/ios-udid-finder/result.astro  | 27 +++++++-
 2 files changed, 72 insertions(+), 16 deletions(-)

diff --git a/apps/docs/src/components/doc/CopyPage.astro b/apps/docs/src/components/doc/CopyPage.astro
index e580df7e1..45bac3e56 100644
--- a/apps/docs/src/components/doc/CopyPage.astro
+++ b/apps/docs/src/components/doc/CopyPage.astro
@@ -127,7 +127,7 @@ const translations = {
     </button>
   </div>
 
-  <span class="copy-page-feedback sr-only" aria-live="polite" aria-atomic="true"></span>
+  <span class="copy-page-feedback sr-only" role="status" aria-live="polite" aria-atomic="true"></span>
 </div>
 
 <script is:inline define:vars={{ translations, editUrl: editUrl?.toString() ?? '' }}>
@@ -172,6 +172,40 @@ const translations = {
       const container = btn.closest('.copy-page-container')
       const feedback = container?.querySelector('.copy-page-feedback')
 
+      function updateFeedback(message) {
+        if (feedback instanceof HTMLElement) {
+          feedback.textContent = message
+        }
+      }
+
+      function resetFeedback() {
+        window.setTimeout(() => {
+          if (title) {
+            title.textContent = originalText || translations.copyPage
+          }
+          updateFeedback('')
+        }, 2000)
+      }
+
+      function fallbackCopy(value) {
+        const textarea = document.createElement('textarea')
+        textarea.value = value
+        textarea.style.position = 'fixed'
+        textarea.style.opacity = '0'
+        document.body.appendChild(textarea)
+        textarea.focus()
+        textarea.select()
+
+        const legacyCopy = Reflect.get(document, 'execCommand')
+        const copied = typeof legacyCopy === 'function' ? legacyCopy.call(document, 'copy') : false
+
+        document.body.removeChild(textarea)
+
+        if (!copied) {
+          throw new Error('Fallback copy method also failed')
+        }
+      }
+
       try {
         // Disable button during operation
         btn.disabled = true
@@ -206,31 +240,30 @@ const translations = {
         }
 
         if (!navigator.clipboard?.writeText) {
-          throw new Error('Clipboard API unavailable')
+          fallbackCopy(content)
+        } else {
+          try {
+            await navigator.clipboard.writeText(content)
+          } catch (clipboardError) {
+            console.error('Clipboard API failed, trying fallback:', clipboardError)
+            fallbackCopy(content)
+          }
         }
-
-        await navigator.clipboard.writeText(content)
         console.log('Copied to clipboard successfully')
 
         // Show success feedback
+        updateFeedback(translations.copied)
         if (title) {
           title.textContent = translations.copied
-          if (feedback) feedback.textContent = translations.copied
-          setTimeout(() => {
-            title.textContent = originalText || translations.copyPage
-            if (feedback) feedback.textContent = ''
-          }, 2000)
         }
+        resetFeedback()
       } catch (error) {
         console.error('Failed to copy:', error)
+        updateFeedback(translations.failedToCopy)
         if (title) {
           title.textContent = translations.failedToCopy
-          if (feedback) feedback.textContent = translations.failedToCopy
-          setTimeout(() => {
-            title.textContent = originalText || translations.copyPage
-            if (feedback) feedback.textContent = ''
-          }, 2000)
         }
+        resetFeedback()
       } finally {
         btn.disabled = false
       }
diff --git a/apps/web/src/pages/tools/ios-udid-finder/result.astro b/apps/web/src/pages/tools/ios-udid-finder/result.astro
index 39f45f8f0..81c6149ac 100644
--- a/apps/web/src/pages/tools/ios-udid-finder/result.astro
+++ b/apps/web/src/pages/tools/ios-udid-finder/result.astro
@@ -142,11 +142,34 @@ const signingDocsHref = getRelativeLocaleUrl(Astro.locals.locale, 'docs/cli/clou
   }
 
   async function copyText(value: string): Promise<void> {
+    const fallbackCopy = (): void => {
+      const helper = document.createElement('textarea')
+      helper.value = value
+      helper.setAttribute('readonly', 'true')
+      helper.style.position = 'absolute'
+      helper.style.opacity = '0'
+      document.body.append(helper)
+      helper.select()
+
+      const legacyCopy = Reflect.get(document, 'execCommand')
+      const copied = typeof legacyCopy === 'function' ? legacyCopy.call(document, 'copy') : false
+
+      helper.remove()
+      if (!copied) {
+        throw new Error('Copy failed')
+      }
+    }
+
     if (!navigator.clipboard?.writeText) {
-      throw new Error('Clipboard API unavailable')
+      fallbackCopy()
+      return
     }
 
-    await navigator.clipboard.writeText(value)
+    try {
+      await navigator.clipboard.writeText(value)
+    } catch {
+      fallbackCopy()
+    }
   }
 
   function bindCopyButtons(): void {

From 382e7ea15b42af42db069427a2863ec8a1f8d2a6 Mon Sep 17 00:00:00 2001
From: Martin Donadieu <martindonadieu@gmail.com>
Date: Tue, 14 Apr 2026 12:40:14 +0200
Subject: [PATCH 3/3] stabilize docs copy status reset

---
 apps/docs/src/components/doc/CopyPage.astro | 8 +++++++-
 1 file changed, 7 insertions(+), 1 deletion(-)

diff --git a/apps/docs/src/components/doc/CopyPage.astro b/apps/docs/src/components/doc/CopyPage.astro
index 45bac3e56..655091d71 100644
--- a/apps/docs/src/components/doc/CopyPage.astro
+++ b/apps/docs/src/components/doc/CopyPage.astro
@@ -157,6 +157,8 @@ const translations = {
 
   // Copy page as markdown
   document.querySelectorAll('.copy-markdown').forEach((btn) => {
+    let resetTimer
+
     btn.addEventListener('click', async (e) => {
       e.preventDefault()
       e.stopPropagation()
@@ -179,7 +181,11 @@ const translations = {
       }
 
       function resetFeedback() {
-        window.setTimeout(() => {
+        if (resetTimer) {
+          window.clearTimeout(resetTimer)
+        }
+
+        resetTimer = window.setTimeout(() => {
           if (title) {
             title.textContent = originalText || translations.copyPage
           }