Mouse cursor stuck as crosshair after Option+key hides mouse with mouse-hide-while-typing enabled

[MrConnorKenway]

Issue Description

Ghostty uses keyToMouseShape to decide the proper mouse shape, and it early returns if surface mouse is hidden:

ghostty/src/surface_mouse.zig

Lines 61 to 63 in 7421b4b

	if (self.over_link or self.hidden) {
	return null;
	}

Thus, when mouse-hide-while-typing is enabled, pressing a modifier key combination that changes the cursor shape (for example, Option on macOS), followed by a key sequence that Ghostty interprets as typing (such as Option+i, a dead key on macOS), causes the cursor-shape state transitions to be skipped. As a result, the following key-release event fails to restore the cursor to its default shape (e.g., .text).

Expected Behavior

After pressing and releasing any modifier combination that changes the cursor shape but also triggers mouse-hide-while-typing, moving the mouse should restore it to the default cursor shape (text/I-beam in normal mode, or arrow in mouse tracking mode).

Actual Behavior

The mouse cursor remains stuck as a crosshair after the keys are released and the mouse is moved. The crosshair persists until another modifier key event triggers a shape transition.

Reproduction Steps

1. Open Ghostty with mouse-hide-while-typing = true in the configuration.
2. Ensure the terminal is in normal mode (no mouse tracking application running).
3. Press and hold the Option key — observe the cursor changes to a crosshair.
4. While holding Option, press i (Option+i is a dead key on macOS that produces text).
5. Release all keys.
6. Move the mouse — observe the cursor is visible again but remains a crosshair instead of the expected I-beam/text cursor.

Ghostty Logs

No response

Ghostty Version

1.3.1

OS Version Information

macOS 26

(Linux only) Display Server

None

(Linux only) Desktop Environment/Window Manager

No response

Minimal Ghostty Configuration

mouse-hide-while-typing = true

Additional Relevant Configuration

No response

I acknowledge that:

• I have reviewed the FAQ and confirm that my issue is NOT among them.
• I have searched the Ghostty repository (both open and closed Discussions and Issues) and confirm this is not a duplicate of an existing issue or discussion.
• I have checked the "Preview" tab on all text fields to ensure that everything looks right, and have wrapped all configuration and code in code blocks with a group of three backticks (```) on separate lines.

[bo2themax]

Tried to reproduce it myself, and found that this is not related mouse-hide-while-typing, but with macos-option-as-alt = false (default), so you can reproduce this an empty config,

Screen.Recording.2026-04-13.at.14.46.00.mp4

[bo2themax]

#12265