[V3] Hover events do not trigger in window when EnableFileDrop:true is set

[Etesam913]

Wails version family

v3

Operating System

macOS

Description

window := app.Window.NewWithOptions(application.WebviewWindowOptions{
		Title:     "Bytebook",
		Width:     1400,
		Height:    900,
		MinWidth:  800,
		MinHeight: 600,
		X:         rand.Intn(1000),
		Y:         rand.Intn(800),
		URL:       url,
		Mac: application.MacWindow{
			InvisibleTitleBarHeight: 35,
			TitleBar:                application.MacTitleBarHiddenInsetUnified,
			WebviewPreferences: application.MacWebviewPreferences{
				FullscreenEnabled: application.Enabled,
			},
		},
		BackgroundColour:   backgroundColor,
		ZoomControlEnabled: false,
		EnableFileDrop:     true,
	})

When I create a window with EnableFileDrop set to true the hover events elements in the webview stop triggering.

To Reproduce

1. go to the /v3/examples/drag-n-drop/assets/index.html file
2. add some basic hover css like

        .bucket:hover {
            background-color: orange !important;
        }

3. run cd v3/examples/drag-n-drop && go run .
4. Verify that hovering over a bucket does not change the backgronud color to orange.

Expected behaviour

It should pick up the mouse event and change the background color to orange,

Screenshots

No response

Attempted Fixes

No response

System Details

wails3 doctor                                                                                           
wails
Wails v3.0.0-alpha2.117 › Wails Doctor

# System

┌────────────────────────────┐
| Name          | MacOS      |
| Version       | 27.0       |
| ID            | 26A5378j   |
| Branding      | MacOS 27.0 |
| Platform      | darwin     |
| Architecture  | arm64      |
| Apple Silicon | true       |
| CPU           | Apple M2   |
| CPU           | Apple M2   |
| GPU           | 10 cores   |
| Memory        | 24 GB      |
└────────────────────────────┘

# Build Environment

┌──────────────────────────────────┐
| Wails CLI    | v3.0.0-alpha2.117 |
| Go Version   | go1.25.12         |
| -buildmode   | exe               |
| -compiler    | gc                |
| CGO_CFLAGS   |                   |
| CGO_CPPFLAGS |                   |
| CGO_CXXFLAGS |                   |
| CGO_ENABLED  | 1                 |
| CGO_LDFLAGS  |                   |
| GOARCH       | arm64             |
| GOARM64      | v8.0              |
| GOOS         | darwin            |
└──────────────────────────────────┘

# Dependencies

┌──────────────────────────────────────────────────────────────────────────────────────────────────────────┐
| *Android SDK       | Not found. Set ANDROID_HOME (install via Android Studio or the command-line tools). |
| *NSIS              | Not Installed. Install with `brew install makensis`.                                |
| *Xcode (iOS)       | Xcode 26.1, Build version 17B55                                                     |
| *iOS Device SDK    | 26.1                                                                                |
| *iOS Simulator SDK | 26.1                                                                                |
| Xcode cli tools    | 2417                                                                                |
| npm                | 11.4.2                                                                              |
| docker             | *Not installed (optional - for cross-compilation)                                   |
|                                                                                                          |
└──────────────────────────────────────── * - Optional Dependency ─────────────────────────────────────────┘

# Signing

┌────────────────────────────────────────┐
| macOS Signing   | Not configured       |
| Windows Signing | Not configured       |
| Linux Signing   | Not configured (GPG) |
└────────────────────────────────────────┘

# Checking for issues

 SUCCESS  No issues found

# Diagnosis

 SUCCESS  Your system is ready for Wails development!

Need documentation? Run: wails3 docs
 ♥   If Wails is useful to you or your company, please consider sponsoring the project: wails3 sponsor

Additional context

No response

[sanbiv]

Not sure if it helps, but I ran into the same issue and Fable suggested this temporary workaround:

//go:build darwin

package app

/*
#cgo CFLAGS: -x objective-c
#cgo LDFLAGS: -framework Foundation
#import <Foundation/Foundation.h>
#import <objc/runtime.h>

// Workaround for https://github.com/wailsapp/wails/issues/5771 (macOS 26+).
//
// WebKit's WebViewImpl::mouseMoved drops mouse-moved events when the view
// hit-tested under the cursor is not the WKWebView. With EnableFileDrop:true
// Wails v3 installs a full-window "WebviewDrag" overlay ABOVE the webview,
// which wins every hit-test and starves the page of hover/cursor updates:
// CSS :hover never applies, cursor: pointer never shows, and mouseenter-driven
// UI (submenus, tooltips) only reacts to clicks. Verified empirically: the
// same native mouseMoved delivered to WebKit's WKMouseTrackingObserver reaches
// the DOM only when WebviewDrag loses hit-testing (0/25 vs 25/25 events).
//
// Making the overlay transparent to mouse hit-testing restores hover, while
// file drops keep working: NSDraggingDestination discovery walks registered
// dragged types geometrically and does not consult hitTest:.
//
// class_addMethod is a no-op if a future Wails version defines its own
// hitTest: on WebviewDrag, so this shim retires itself automatically once
// upstream ships a fix. Remove it when the wails dependency is bumped to a
// version where #5771 is closed.
static void fixWebviewDragHitTest(void) {
	Class cls = NSClassFromString(@"WebviewDrag");
	if (!cls) {
		return;
	}
	SEL sel = @selector(hitTest:);
	Method inherited = class_getInstanceMethod(cls, sel);
	if (!inherited) {
		return;
	}
	IMP repl = imp_implementationWithBlock(^id(id self, NSPoint p) {
		return nil;
	});
	class_addMethod(cls, sel, repl, method_getTypeEncoding(inherited));
}
*/
import "C"

func init() {
	C.fixWebviewDragHitTest()
}