Desktop: Add app menu for Mac (#3428)

timon-schelling · Keavon · web-flow · commit bb4516e377f2 · 2025-11-28T23:42:14.000Z
* add mac app menu

* review fixup

* Remove "About Graphite" ellipsis, add "Show All", make it say "Quit Graphite"

---------

Co-authored-by: Keavon Chambers &lt;keavon@keavon.com&gt;
diff --git a/desktop/src/app.rs b/desktop/src/app.rs
@@ -174,24 +174,6 @@ impl App {
 					graphics_state.set_overlays_scene(scene);
 				}
 			}
-			DesktopFrontendMessage::MinimizeWindow => {
-				if let Some(window) = &self.window {
-					window.minimize();
-				}
-			}
-			DesktopFrontendMessage::MaximizeWindow => {
-				if let Some(window) = &self.window {
-					window.toggle_maximize();
-				}
-			}
-			DesktopFrontendMessage::DragWindow => {
-				if let Some(window) = &self.window {
-					window.start_drag();
-				}
-			}
-			DesktopFrontendMessage::CloseWindow => {
-				self.app_event_scheduler.schedule(AppEvent::CloseWindow);
-			}
 			DesktopFrontendMessage::PersistenceWriteDocument { id, document } => {
 				self.persistent_data.write_document(id, document);
 			}
@@ -270,6 +252,39 @@ impl App {
 					window.update_menu(entries);
 				}
 			}
+			DesktopFrontendMessage::WindowClose => {
+				self.app_event_scheduler.schedule(AppEvent::CloseWindow);
+			}
+			DesktopFrontendMessage::WindowMinimize => {
+				if let Some(window) = &self.window {
+					window.minimize();
+				}
+			}
+			DesktopFrontendMessage::WindowMaximize => {
+				if let Some(window) = &self.window {
+					window.toggle_maximize();
+				}
+			}
+			DesktopFrontendMessage::WindowDrag => {
+				if let Some(window) = &self.window {
+					window.start_drag();
+				}
+			}
+			DesktopFrontendMessage::WindowHide => {
+				if let Some(window) = &self.window {
+					window.hide();
+				}
+			}
+			DesktopFrontendMessage::WindowHideOthers => {
+				if let Some(window) = &self.window {
+					window.hide_others();
+				}
+			}
+			DesktopFrontendMessage::WindowShowAll => {
+				if let Some(window) = &self.window {
+					window.show_all();
+				}
+			}
 		}
 	}
 
diff --git a/desktop/src/window.rs b/desktop/src/window.rs
@@ -11,6 +11,9 @@ pub(crate) trait NativeWindow {
 	fn configure(attributes: WindowAttributes, event_loop: &dyn ActiveEventLoop) -> WindowAttributes;
 	fn new(window: &dyn WinitWindow, app_event_scheduler: AppEventScheduler) -> Self;
 	fn update_menu(&self, _entries: Vec<MenuItem>) {}
+	fn hide(&self) {}
+	fn hide_others(&self) {}
+	fn show_all(&self) {}
 }
 
 #[cfg(target_os = "linux")]
@@ -93,6 +96,18 @@ impl Window {
 		let _ = self.winit_window.drag_window();
 	}
 
+	pub(crate) fn hide(&self) {
+		self.native_handle.hide();
+	}
+
+	pub(crate) fn hide_others(&self) {
+		self.native_handle.hide_others();
+	}
+
+	pub(crate) fn show_all(&self) {
+		self.native_handle.show_all();
+	}
+
 	pub(crate) fn set_cursor(&self, cursor: winit::cursor::Cursor) {
 		self.winit_window.set_cursor(cursor);
 	}
diff --git a/desktop/src/window/mac.rs b/desktop/src/window/mac.rs
@@ -34,4 +34,16 @@ impl super::NativeWindow for NativeWindowImpl {
 	fn update_menu(&self, entries: Vec<MenuItem>) {
 		self.menu.update(entries);
 	}
+
+	fn hide(&self) {
+		app::hide();
+	}
+
+	fn hide_others(&self) {
+		app::hide_others();
+	}
+
+	fn show_all(&self) {
+		app::show_all();
+	}
 }
diff --git a/desktop/src/window/mac/app.rs b/desktop/src/window/mac/app.rs
@@ -2,12 +2,6 @@ use objc2::{ClassType, define_class, msg_send};
 use objc2_app_kit::{NSApplication, NSEvent, NSEventType, NSResponder};
 use objc2_foundation::NSObject;
 
-pub(super) fn init() {
-	unsafe {
-		let _: &NSApplication = msg_send![GraphiteApplication::class(), sharedApplication];
-	}
-}
-
 define_class!(
 	#[unsafe(super(NSApplication, NSResponder, NSObject))]
 	#[name = "GraphiteApplication"]
@@ -25,3 +19,23 @@ define_class!(
 		}
 	}
 );
+
+fn instance() -> objc2::rc::Retained<NSApplication> {
+	unsafe { msg_send![GraphiteApplication::class(), sharedApplication] }
+}
+
+pub(super) fn init() {
+	let _ = instance();
+}
+
+pub(super) fn hide() {
+	instance().hide(None);
+}
+
+pub(super) fn hide_others() {
+	instance().hideOtherApplications(None);
+}
+
+pub(super) fn show_all() {
+	instance().unhideAllApplications(None);
+}
diff --git a/desktop/src/window/mac/menu.rs b/desktop/src/window/mac/menu.rs
@@ -43,11 +43,11 @@ impl Menu {
 		let existing_entries = self.inner.items();
 
 		let mut new_entries_iter = new_entries.iter();
-		let mut existing_entries_iter = existing_entries.iter().skip(1); // Skip first menu (app menu)
+		let mut existing_entries_iter = existing_entries.iter();
 
 		let incremental_update_ok = std::iter::from_fn(move || match (existing_entries_iter.next(), new_entries_iter.next()) {
 			(Some(MenuItemKind::Submenu(old)), Some(MenuItemKind::Submenu(new))) if old.text() == new.text() => {
-				replace_children(old, 0, new.items());
+				replace_children(old, new.items());
 				Some(true)
 			}
 			(None, None) => None,
@@ -57,7 +57,7 @@ impl Menu {
 
 		if !incremental_update_ok {
 			// Fallback to full replace
-			replace_children(&self.inner, 1, new_entries); // Skip first menu (app menu)
+			replace_children(&self.inner, new_entries);
 		}
 	}
 }
@@ -111,10 +111,10 @@ fn menu_id_to_u64(id: &MenuId) -> Option<u64> {
 	u64::from_str_radix(&id.0, 16).ok()
 }
 
-fn replace_children<'a, T: Into<MenuContainer<'a>>>(menu: T, skip: usize, new_items: Vec<MenuItemKind>) {
+fn replace_children<'a, T: Into<MenuContainer<'a>>>(menu: T, new_items: Vec<MenuItemKind>) {
 	let menu: MenuContainer = menu.into();
 	let items = menu.items();
-	for item in items.iter().skip(skip) {
+	for item in items.iter() {
 		menu.remove(menu_item_kind_to_dyn(item)).unwrap();
 	}
 	let items = new_items.iter().map(|item| menu_item_kind_to_dyn(item)).collect::<Vec<&dyn IsMenuItem>>();
diff --git a/desktop/wrapper/src/handle_desktop_wrapper_message.rs b/desktop/wrapper/src/handle_desktop_wrapper_message.rs
@@ -117,7 +117,7 @@ pub(super) fn handle_desktop_wrapper_message(dispatcher: &mut DesktopWrapperMess
 				Platform::Mac => AppWindowPlatform::Mac,
 				Platform::Linux => AppWindowPlatform::Linux,
 			};
-			let message = AppWindowMessage::AppWindowUpdatePlatform { platform };
+			let message = AppWindowMessage::UpdatePlatform { platform };
 			dispatcher.queue_editor_message(message);
 		}
 		DesktopWrapperMessage::UpdateMaximized { maximized } => {
diff --git a/desktop/wrapper/src/intercept_frontend_message.rs b/desktop/wrapper/src/intercept_frontend_message.rs
@@ -67,18 +67,6 @@ pub(super) fn intercept_frontend_message(dispatcher: &mut DesktopWrapperMessageD
 		FrontendMessage::TriggerVisitLink { url } => {
 			dispatcher.respond(DesktopFrontendMessage::OpenUrl(url));
 		}
-		FrontendMessage::DragWindow => {
-			dispatcher.respond(DesktopFrontendMessage::DragWindow);
-		}
-		FrontendMessage::CloseWindow => {
-			dispatcher.respond(DesktopFrontendMessage::CloseWindow);
-		}
-		FrontendMessage::TriggerMinimizeWindow => {
-			dispatcher.respond(DesktopFrontendMessage::MinimizeWindow);
-		}
-		FrontendMessage::TriggerMaximizeWindow => {
-			dispatcher.respond(DesktopFrontendMessage::MaximizeWindow);
-		}
 		FrontendMessage::UpdateViewportPhysicalBounds { x, y, width, height } => {
 			dispatcher.respond(DesktopFrontendMessage::UpdateViewportPhysicalBounds { x, y, width, height });
 		}
@@ -131,6 +119,27 @@ pub(super) fn intercept_frontend_message(dispatcher: &mut DesktopWrapperMessageD
 
 			return Some(FrontendMessage::UpdateMenuBarLayout { layout, layout_target });
 		}
+		FrontendMessage::WindowClose => {
+			dispatcher.respond(DesktopFrontendMessage::WindowClose);
+		}
+		FrontendMessage::WindowMinimize => {
+			dispatcher.respond(DesktopFrontendMessage::WindowMinimize);
+		}
+		FrontendMessage::WindowMaximize => {
+			dispatcher.respond(DesktopFrontendMessage::WindowMaximize);
+		}
+		FrontendMessage::WindowDrag => {
+			dispatcher.respond(DesktopFrontendMessage::WindowDrag);
+		}
+		FrontendMessage::WindowHide => {
+			dispatcher.respond(DesktopFrontendMessage::WindowHide);
+		}
+		FrontendMessage::WindowHideOthers => {
+			dispatcher.respond(DesktopFrontendMessage::WindowHideOthers);
+		}
+		FrontendMessage::WindowShowAll => {
+			dispatcher.respond(DesktopFrontendMessage::WindowShowAll);
+		}
 		m => return Some(m),
 	}
 	None
@@ -151,11 +160,7 @@ fn convert_menu_bar_entry_to_menu_item(
 	}: &MenuBarEntry,
 ) -> Option<MenuItem> {
 	let id = action.widget_id.0;
-	let text = if label.is_empty() {
-		return None;
-	} else {
-		label.clone()
-	};
+	let text = label.clone();
 	let enabled = !*disabled;
 
 	if !children.0.is_empty() {
diff --git a/desktop/wrapper/src/messages.rs b/desktop/wrapper/src/messages.rs
@@ -32,10 +32,6 @@ pub enum DesktopFrontendMessage {
 		height: f64,
 	},
 	UpdateOverlays(vello::Scene),
-	MinimizeWindow,
-	MaximizeWindow,
-	DragWindow,
-	CloseWindow,
 	PersistenceWriteDocument {
 		id: DocumentId,
 		document: Document,
@@ -58,6 +54,13 @@ pub enum DesktopFrontendMessage {
 	UpdateMenu {
 		entries: Vec<MenuItem>,
 	},
+	WindowClose,
+	WindowMinimize,
+	WindowMaximize,
+	WindowDrag,
+	WindowHide,
+	WindowHideOthers,
+	WindowShowAll,
 }
 
 pub enum DesktopWrapperMessage {
diff --git a/editor/src/dispatcher.rs b/editor/src/dispatcher.rs
@@ -285,6 +285,7 @@ impl Dispatcher {
 	pub fn collect_actions(&self) -> ActionList {
 		// TODO: Reduce the number of heap allocations
 		let mut list = Vec::new();
+		list.extend(self.message_handlers.app_window_message_handler.actions());
 		list.extend(self.message_handlers.dialog_message_handler.actions());
 		list.extend(self.message_handlers.animation_message_handler.actions());
 		list.extend(self.message_handlers.input_preprocessor_message_handler.actions());
diff --git a/editor/src/messages/app_window/app_window_message.rs b/editor/src/messages/app_window/app_window_message.rs
@@ -5,9 +5,12 @@ use super::app_window_message_handler::AppWindowPlatform;
 #[impl_message(Message, AppWindow)]
 #[derive(PartialEq, Clone, Debug, serde::Serialize, serde::Deserialize)]
 pub enum AppWindowMessage {
-	AppWindowMinimize,
-	AppWindowMaximize,
-	AppWindowUpdatePlatform { platform: AppWindowPlatform },
-	AppWindowDrag,
-	AppWindowClose,
+	UpdatePlatform { platform: AppWindowPlatform },
+	Close,
+	Minimize,
+	Maximize,
+	Drag,
+	Hide,
+	HideOthers,
+	ShowAll,
 }
diff --git a/editor/src/messages/app_window/app_window_message_handler.rs b/editor/src/messages/app_window/app_window_message_handler.rs
@@ -11,28 +11,41 @@ pub struct AppWindowMessageHandler {
 impl MessageHandler<AppWindowMessage, ()> for AppWindowMessageHandler {
 	fn process_message(&mut self, message: AppWindowMessage, responses: &mut std::collections::VecDeque<Message>, _: ()) {
 		match message {
-			AppWindowMessage::AppWindowMaximize => {
-				responses.add(FrontendMessage::TriggerMaximizeWindow);
-			}
-			AppWindowMessage::AppWindowMinimize => {
-				responses.add(FrontendMessage::TriggerMinimizeWindow);
-			}
-			AppWindowMessage::AppWindowUpdatePlatform { platform } => {
+			AppWindowMessage::UpdatePlatform { platform } => {
 				self.platform = platform;
 				responses.add(FrontendMessage::UpdatePlatform { platform: self.platform });
 			}
-			AppWindowMessage::AppWindowDrag => {
-				responses.add(FrontendMessage::DragWindow);
+			AppWindowMessage::Close => {
+				responses.add(FrontendMessage::WindowClose);
+			}
+			AppWindowMessage::Minimize => {
+				responses.add(FrontendMessage::WindowMinimize);
+			}
+			AppWindowMessage::Maximize => {
+				responses.add(FrontendMessage::WindowMaximize);
+			}
+			AppWindowMessage::Drag => {
+				responses.add(FrontendMessage::WindowDrag);
 			}
-			AppWindowMessage::AppWindowClose => {
-				responses.add(FrontendMessage::CloseWindow);
+			AppWindowMessage::Hide => {
+				responses.add(FrontendMessage::WindowHide);
+			}
+			AppWindowMessage::HideOthers => {
+				responses.add(FrontendMessage::WindowHideOthers);
+			}
+			AppWindowMessage::ShowAll => {
+				responses.add(FrontendMessage::WindowShowAll);
 			}
 		}
 	}
-
-	fn actions(&self) -> ActionList {
-		actions!(AppWindowMessageDiscriminant;)
-	}
+	advertise_actions!(AppWindowMessageDiscriminant;
+		Close,
+		Minimize,
+		Maximize,
+		Drag,
+		Hide,
+		HideOthers,
+	);
 }
 
 #[derive(PartialEq, Eq, Clone, Copy, Default, Debug, serde::Serialize, serde::Deserialize, specta::Type)]
diff --git a/editor/src/messages/frontend/frontend_message.rs b/editor/src/messages/frontend/frontend_message.rs
@@ -121,8 +121,6 @@ pub enum FrontendMessage {
 	TriggerVisitLink {
 		url: String,
 	},
-	TriggerMinimizeWindow,
-	TriggerMaximizeWindow,
 
 	// Update prefix: give the frontend a new value or state for it to use
 	UpdateActiveDocument {
@@ -348,8 +346,6 @@ pub enum FrontendMessage {
 	UpdateMaximized {
 		maximized: bool,
 	},
-	DragWindow,
-	CloseWindow,
 	UpdateViewportHolePunch {
 		active: bool,
 	},
@@ -365,4 +361,11 @@ pub enum FrontendMessage {
 		#[derivative(Debug = "ignore", PartialEq = "ignore")]
 		context: OverlayContext,
 	},
+	WindowClose,
+	WindowMinimize,
+	WindowMaximize,
+	WindowDrag,
+	WindowHide,
+	WindowHideOthers,
+	WindowShowAll,
 }
diff --git a/editor/src/messages/input_mapper/input_mappings.rs b/editor/src/messages/input_mapper/input_mappings.rs
diff --git a/editor/src/messages/portfolio/menu_bar/menu_bar_message_handler.rs b/editor/src/messages/portfolio/menu_bar/menu_bar_message_handler.rs
diff --git a/frontend/wasm/src/editor_api.rs b/frontend/wasm/src/editor_api.rs

Original file line number	Diff line number	Diff line change
`@@ -43,11 +43,11 @@ impl Menu {`
`43`	`43`	`let existing_entries = self.inner.items();`
`44`	`44`
`45`	`45`	`let mut new_entries_iter = new_entries.iter();`
`46`		`- let mut existing_entries_iter = existing_entries.iter().skip(1); // Skip first menu (app menu)`
	`46`	`+ let mut existing_entries_iter = existing_entries.iter();`
`47`	`47`
`48`	`48`	`let incremental_update_ok = std::iter::from_fn(move \|\| match (existing_entries_iter.next(), new_entries_iter.next()) {`
`49`	`49`	`(Some(MenuItemKind::Submenu(old)), Some(MenuItemKind::Submenu(new))) if old.text() == new.text() => {`
`50`		`- replace_children(old, 0, new.items());`
	`50`	`+ replace_children(old, new.items());`
`51`	`51`	`Some(true)`
`52`	`52`	`}`
`53`	`53`	`(None, None) => None,`
`@@ -57,7 +57,7 @@ impl Menu {`
`57`	`57`
`58`	`58`	`if !incremental_update_ok {`
`59`	`59`	`// Fallback to full replace`
`60`		`- replace_children(&self.inner, 1, new_entries); // Skip first menu (app menu)`
	`60`	`+ replace_children(&self.inner, new_entries);`
`61`	`61`	`}`
`62`	`62`	`}`
`63`	`63`	`}`
`@@ -111,10 +111,10 @@ fn menu_id_to_u64(id: &MenuId) -> Option<u64> {`
`111`	`111`	`u64::from_str_radix(&id.0, 16).ok()`
`112`	`112`	`}`
`113`	`113`
`114`		`-fn replace_children<'a, T: Into<MenuContainer<'a>>>(menu: T, skip: usize, new_items: Vec<MenuItemKind>) {`
	`114`	`+fn replace_children<'a, T: Into<MenuContainer<'a>>>(menu: T, new_items: Vec<MenuItemKind>) {`
`115`	`115`	`let menu: MenuContainer = menu.into();`
`116`	`116`	`let items = menu.items();`
`117`		`- for item in items.iter().skip(skip) {`
	`117`	`+ for item in items.iter() {`
`118`	`118`	`menu.remove(menu_item_kind_to_dyn(item)).unwrap();`
`119`	`119`	`}`
`120`	`120`	`let items = new_items.iter().map(\|item\| menu_item_kind_to_dyn(item)).collect::<Vec<&dyn IsMenuItem>>();`
Original file line number	Diff line number	Diff line change
`@@ -117,7 +117,7 @@ pub(super) fn handle_desktop_wrapper_message(dispatcher: &mut DesktopWrapperMess`
`117`	`117`	`Platform::Mac => AppWindowPlatform::Mac,`
`118`	`118`	`Platform::Linux => AppWindowPlatform::Linux,`
`119`	`119`	`};`
`120`		`- let message = AppWindowMessage::AppWindowUpdatePlatform { platform };`
	`120`	`+ let message = AppWindowMessage::UpdatePlatform { platform };`
`121`	`121`	`dispatcher.queue_editor_message(message);`
`122`	`122`	`}`
`123`	`123`	`DesktopWrapperMessage::UpdateMaximized { maximized } => {`