fix(docs): declare touch-action to block pinch zoom

Add a root touch-action declaration to exported HTML and keep the gesture interception fallback so mobile browsers receive a pre-gesture signal to disable pinch zoom.

Author: trsoliu

scripts/export-docs-site.mjs

@@ -5,6 +5,8 @@ import { basename, join, resolve } from 'node:path';
 import { spawn } from 'node:child_process';
 
 const args = process.argv.slice(2);
+const mobileZoomLockStyle =
+  '<style id="disable-mobile-zoom-style">html,body{touch-action:pan-x pan-y;}</style>';
 const mobileZoomLockScript = `<script id="disable-mobile-zoom">(function(){let lastTouchEnd=0;const cancel=event=>event.preventDefault();document.addEventListener('gesturestart',cancel,{passive:false});document.addEventListener('gesturechange',cancel,{passive:false});document.addEventListener('gestureend',cancel,{passive:false});document.addEventListener('touchstart',event=>{if(event.touches.length>1){cancel(event);}}, {passive:false});document.addEventListener('touchend',event=>{const now=Date.now();if(now-lastTouchEnd<=300){cancel(event);}lastTouchEnd=now;},{passive:false});})();</script>`;
 
 function getArgValue(flag, defaultValue) {
@@ -74,8 +76,14 @@ function rewriteTextAsset(content, basePath) {
     rewritten = rewritten.replace(cssUrlPattern, `url(${basePath}/`);
   }
 
-  if (rewritten.includes('</head>') && !rewritten.includes('id="disable-mobile-zoom"')) {
-    rewritten = rewritten.replace('</head>', `${mobileZoomLockScript}</head>`);
+  if (rewritten.includes('</head>')) {
+    if (!rewritten.includes('id="disable-mobile-zoom-style"')) {
+      rewritten = rewritten.replace('</head>', `${mobileZoomLockStyle}</head>`);
+    }
+
+    if (!rewritten.includes('id="disable-mobile-zoom"')) {
+      rewritten = rewritten.replace('</head>', `${mobileZoomLockScript}</head>`);
+    }
   }
 
   return rewritten;