Added

• Add ActiveEventLoop::create_proxy().

• On Web, add ActiveEventLoopExtWeb::is_cursor_lock_raw() to determine if DeviceEvent::MouseMotion is returning raw data, not OS accelerated, when using CursorGrabMode::Locked.

• On Web, implement MonitorHandle and VideoModeHandle.

  Without prompting the user for permission, only the current monitor is returned. But when prompting and being granted permission through ActiveEventLoop::request_detailed_monitor_permission(), access to all monitors and their details is available. Handles created with "detailed monitor permissions" can be used in Window::set_fullscreen() as well.

  Keep in mind that handles do not auto-upgrade after permissions are granted and have to be re-created to make full use of this feature.

• Implement Clone, Copy, Debug, Deserialize, Eq, Hash, Ord, PartialEq, PartialOrd and Serialize on many types.

• Add MonitorHandle::current_video_mode().

• Add ApplicationHandlerExtMacOS trait, and a macos_handler method to ApplicationHandler which returns a dyn ApplicationHandlerExtMacOS which allows for macOS specific extensions to winit.

• Add a standard_key_binding method to the ApplicationHandlerExtMacOS trait. This allows handling of standard keybindings such as "go to end of line" on macOS.

• On macOS, add WindowExtMacOS::set_unified_titlebar and WindowAttributesMacOS::with_unified_titlebar to use a larger style of titlebar.

• Add WindowId::into_raw() and from_raw().

• Add PointerKind, PointerSource, ButtonSource, FingerId, primary and position to all pointer events as part of the pointer event overhaul.

• Add DeviceId::into_raw() and from_raw().

• Added Window::surface_position, which is the position of the surface inside the window.

• Added Window::safe_area, which describes the area of the surface that is unobstructed.

• On X11, Wayland, Windows and macOS, improved scancode conversions for more obscure key codes.

• Add ability to make non-activating window on macOS using NSPanel with NSWindowStyleMask::NonactivatingPanel.

• Implement MonitorHandleProvider for MonitorHandle to access common monitor API.

• On X11, set an "area" attribute on XIM input connection to convey the cursor area.

• Implement CustomCursorProvider for CustomCursor to access cursor API.

• Add CustomCursorSource::Url, CustomCursorSource::from_animation.

• Implement CustomIconProvider for RgbaIcon.

• Add icon module that exposes winit's icon API.

• VideoMode::new to create a VideoMode.

• keyboard::ModifiersKey to track which modifier is exactly pressed.

• ActivationToken::as_raw to get a ref to raw token.

• Each platform now has corresponding WindowAttributes struct instead of trait extension.

• On Wayland, added implementation for Window::set_window_icon

• On Wayland, added PanGesture, PinchGesture, and RotationGesture

• Add Window::request_ime_update to atomically apply set of IME changes.

• Add Ime::DeleteSurrounding to let the input method delete text.

• Add more ImePurpose values.

• Add ImeHints to request particular IME behaviour.

• Add Pen input support on Wayland, Windows, and Web via new Pointer event.

Changed

• Change ActiveEventLoop and Window to be traits, and added cast_ref/cast_mut/cast methods to extract the backend type from those.

• ActiveEventLoop::create_window now returns Box<dyn Window>.

• ApplicationHandler now uses dyn ActiveEventLoop.

• On Web, let events wake up event loop immediately when using ControlFlow::Poll.

• Bump MSRV from 1.70 to 1.85.

• Changed ApplicationHandler::user_event to user_wake_up, removing the generic user event.

  Winit will now only indicate that wake up happened, you will have to pair this with an external mechanism like std::sync::mpsc::channel if you want to send specific data to be processed on the main thread.

• Changed EventLoopProxy::send_event to EventLoopProxy::wake_up, it now only wakes up the loop.

• On X11, implement smooth resizing through the sync extension API.

• ApplicationHandler::can_create|destroy_surfaces() was split off from ApplicationHandler::resumed/suspended().

  ApplicationHandler::can_create_surfaces() should, for portability reasons to Android, be the only place to create render surfaces.

  ApplicationHandler::resumed/suspended() are now only emitted by iOS, Web and Android, and now signify actually resuming/suspending the application.

• Rename platform::web::*ExtWebSys to *ExtWeb.

• Change signature of EventLoop::run_app, EventLoopExtPumpEvents::pump_app_events and EventLoopExtRunOnDemand::run_app_on_demand to accept a impl ApplicationHandler directly, instead of requiring a &mut reference to it.

• On Web, Window::canvas() now returns a reference.

• On Web, CursorGrabMode::Locked now lets DeviceEvent::MouseMotion return raw data, not OS accelerated, if the browser supports it.

• (Active)EventLoop::create_custom_cursor() now returns a Result<CustomCursor, ExternalError>.

Removed

• Remove Event.

• Remove already deprecated APIs:

  • EventLoop::create_window()
  • EventLoop::run.
  • EventLoopBuilder::new()
  • EventLoopExtPumpEvents::pump_events.
  • EventLoopExtRunOnDemand::run_on_demand.
  • VideoMode
  • WindowAttributes::new()
  • Window::set_cursor_icon()

• On iOS, remove platform::ios::EventLoopExtIOS and related platform::ios::Idiom type.

  This feature was incomplete, and the equivalent functionality can be trivially achieved outside of winit using objc2-ui-kit and calling UIDevice::currentDevice().userInterfaceIdiom().

• On Web, remove unused platform::web::CustomCursorError::Animation.

• Remove the rwh_04 and rwh_05 cargo feature and the corresponding raw-window-handle v0.4 and v0.5 support. v0.6 remains in place and is enabled by default.

• Remove DeviceEvent::Added and DeviceEvent::Removed.

• Remove DeviceEvent::Motion and WindowEvent::AxisMotion.

• Remove MonitorHandle::size() and refresh_rate_millihertz() in favor of MonitorHandle::current_video_mode().

• On Android, remove all MonitorHandle support instead of emitting false data.

• Remove impl From<u64> for WindowId and impl From<WindowId> for u64. Replaced with WindowId::into_raw() and from_raw().

• Remove dummy() from WindowId and DeviceId.

• Remove WindowEvent::Touch and Touch in favor of the new PointerKind, PointerSource and ButtonSource as part of the new pointer event overhaul.

• Remove Force::altitude_angle.

• Remove Window::inner_position, use the new instead.

Fixed

• On Orbital, MonitorHandle::name() now returns None instead of a dummy name.
• On Orbital, implement fullscreen.
• On iOS, fixed SurfaceResized and Window::surface_size not reporting the size of the actual surface.
• On macOS, fixed the scancode conversion for audio volume keys.
• On macOS, fixed the scancode conversion for IntlBackslash.
• On macOS, fixed redundant SurfaceResized event at window creation.
• On macOS, don't panic on monitors with unknown bit-depths.
• On macOS, fixed crash when closing the window on macOS 26+.
• On Windows, account for mouse wheel lines per scroll setting for WindowEvent::MouseWheel.
• On Windows, Window::theme will return the correct theme after setting it through Window::set_theme.
• On Windows, Window::set_theme will change the title bar color immediately now.
• On Windows 11, prevent incorrect shifting when dragging window onto a monitor with different DPI.
• On Windows, avoid returning SurfaceResized with size zero when an application is minimized. Let Window::surface_size return the pre-minimization window size even while minimized.
• On Web, device events are emitted regardless of cursor type.
• On Wayland, axis_value120 scroll events now generate MouseScrollDelta::LineDelta
• On X11, mouse scroll button events no longer cause duplicated WindowEvent::MouseWheel events.
• On macOS, fixed crash when dragging non-file content onto window.