Improve Vite running detection

Author: emmadesilva

packages/framework/src/Facades/Vite.php

@@ -17,7 +17,23 @@ class Vite
 
     public static function running(): bool
     {
-        return Filesystem::exists('app/storage/framework/runtime/vite.hot');
+        $hotFile = 'app/storage/framework/runtime/vite.hot';
+
+        // If hot file doesn't exist, Vite is definitely not running
+        if (! Filesystem::exists($hotFile)) {
+            return false;
+        }
+
+        // Validate that Vite is actually running by checking if port 5173 is in use
+        if (static::isVitePortActive()) {
+            return true;
+        }
+
+        // If hot file exists but port is not active, clean up stale file
+        // This handles cases where processes didn't clean up properly (common on Windows)
+        static::cleanUpStaleHotFile($hotFile);
+
+        return false;
     }
 
     public static function asset(string $path): HtmlString
@@ -76,4 +92,44 @@ protected static function formatScriptInclude(string $path): string
     {
         return sprintf('<script src="http://localhost:5173/%s" type="module"></script>', $path);
     }
+
+    /**
+     * Check if Vite development server is actually running on port 5173.
+     */
+    protected static function isVitePortActive(): bool
+    {
+        $socket = @fsockopen('localhost', 5173, $errno, $errstr, 1);
+
+        if ($socket !== false) {
+            fclose($socket);
+            return true;
+        }
+
+        return false;
+    }
+
+    /**
+     * Clean up stale vite.hot file with Windows-compatible handling.
+     */
+    protected static function cleanUpStaleHotFile(string $hotFile): void
+    {
+        try {
+            // On Windows, files might be locked, so we attempt deletion with retries
+            $maxAttempts = PHP_OS_FAMILY === 'Windows' ? 3 : 1;
+
+            for ($attempt = 1; $attempt <= $maxAttempts; $attempt++) {
+                if (Filesystem::delete($hotFile)) {
+                    break;
+                }
+
+                // If on Windows and not the last attempt, wait a bit before retrying
+                if (PHP_OS_FAMILY === 'Windows' && $attempt < $maxAttempts) {
+                    usleep(100000); // 100ms delay
+                }
+            }
+        } catch (\Exception $exception) {
+            // Silently handle cleanup failures - the stale file will be checked again next time
+            // This prevents the application from breaking due to file system issues
+        }
+    }
 }