Add window control buttons visibility API

Introduces SetWindowControlButtonsVisible and IsWindowControlButtonsVisible methods to the Window class. Implements actual visibility toggling for macOS, stubs for Android, iOS, and OpenHarmony (not applicable), and placeholders for Windows and Linux (not yet implemented). Updates documentation in window.h to reflect platform support.

Author: lijy91

src/capi/window_c.cpp

@@ -470,6 +470,22 @@ bool native_window_is_closable(native_window_t window) {
   return win->IsClosable();
 }
 
+FFI_PLUGIN_EXPORT
+void native_window_set_window_control_buttons_visible(native_window_t window, bool visible) {
+  if (!window)
+    return;
+  auto* win = static_cast<nativeapi::Window*>(window);
+  win->SetWindowControlButtonsVisible(visible);
+}
+
+FFI_PLUGIN_EXPORT
+bool native_window_is_window_control_buttons_visible(native_window_t window) {
+  if (!window)
+    return true;
+  auto* win = static_cast<nativeapi::Window*>(window);
+  return win->IsWindowControlButtonsVisible();
+}
+
 FFI_PLUGIN_EXPORT
 void native_window_set_always_on_top(native_window_t window, bool always_on_top) {
   if (!window)

src/capi/window_c.h

@@ -184,6 +184,12 @@ void native_window_set_closable(native_window_t window, bool closable);
 FFI_PLUGIN_EXPORT
 bool native_window_is_closable(native_window_t window);
 
+FFI_PLUGIN_EXPORT
+void native_window_set_window_control_buttons_visible(native_window_t window, bool visible);
+
+FFI_PLUGIN_EXPORT
+bool native_window_is_window_control_buttons_visible(native_window_t window);
+
 FFI_PLUGIN_EXPORT
 void native_window_set_always_on_top(native_window_t window, bool always_on_top);
 

src/platform/android/window_android.cpp

@@ -262,6 +262,15 @@ bool Window::IsClosable() const {
   return true;
 }
 
+void Window::SetWindowControlButtonsVisible(bool is_visible) {
+  // Not applicable to Android - mobile apps don't have window control buttons
+}
+
+bool Window::IsWindowControlButtonsVisible() const {
+  // Not applicable to Android - mobile apps don't have window control buttons
+  return false;
+}
+
 void Window::SetAlwaysOnTop(bool is_always_on_top) {
   ALOGW("SetAlwaysOnTop not fully supported on Android");
 }

src/platform/ios/window_ios.mm

@@ -262,6 +262,15 @@
   return true;
 }
 
+void Window::SetWindowControlButtonsVisible(bool is_visible) {
+  // Not applicable to iOS - mobile apps don't have window control buttons
+}
+
+bool Window::IsWindowControlButtonsVisible() const {
+  // Not applicable to iOS - mobile apps don't have window control buttons
+  return false;
+}
+
 void Window::SetAlwaysOnTop(bool is_always_on_top) {
   // Not applicable to iOS (no multi-window in traditional sense)
 }

src/platform/linux/window_linux.cpp

@@ -384,6 +384,16 @@ bool Window::IsClosable() const {
   return true;  // Default assumption
 }
 
+void Window::SetWindowControlButtonsVisible(bool is_visible) {
+  // TODO: Implement for Linux
+  // This would involve manipulating GTK window decorations
+}
+
+bool Window::IsWindowControlButtonsVisible() const {
+  // TODO: Implement for Linux
+  return true;  // Default to visible
+}
+
 void Window::SetAlwaysOnTop(bool is_always_on_top) {
   if (pimpl_->gdk_window_) {
     gdk_window_set_keep_above(pimpl_->gdk_window_, is_always_on_top);

src/platform/macos/window_macos.mm

@@ -299,6 +299,30 @@
   return [pimpl_->ns_window_ styleMask] & NSWindowStyleMaskClosable;
 }
 
+void Window::SetWindowControlButtonsVisible(bool is_visible) {
+  NSButton* closeButton = [pimpl_->ns_window_ standardWindowButton:NSWindowCloseButton];
+  NSButton* miniaturizeButton = [pimpl_->ns_window_ standardWindowButton:NSWindowMiniaturizeButton];
+  NSButton* zoomButton = [pimpl_->ns_window_ standardWindowButton:NSWindowZoomButton];
+
+  if (closeButton) {
+    [closeButton setHidden:!is_visible];
+  }
+  if (miniaturizeButton) {
+    [miniaturizeButton setHidden:!is_visible];
+  }
+  if (zoomButton) {
+    [zoomButton setHidden:!is_visible];
+  }
+}
+
+bool Window::IsWindowControlButtonsVisible() const {
+  NSButton* closeButton = [pimpl_->ns_window_ standardWindowButton:NSWindowCloseButton];
+  if (closeButton) {
+    return ![closeButton isHidden];
+  }
+  return true;  // Default to visible if button not found
+}
+
 void Window::SetAlwaysOnTop(bool is_always_on_top) {
   [pimpl_->ns_window_ setLevel:is_always_on_top ? NSFloatingWindowLevel : NSNormalWindowLevel];
 }

src/platform/ohos/window_ohos.cpp

@@ -244,6 +244,15 @@ bool Window::IsClosable() const {
   return true;
 }
 
+void Window::SetWindowControlButtonsVisible(bool is_visible) {
+  // Not applicable to OpenHarmony - mobile apps don't have window control buttons
+}
+
+bool Window::IsWindowControlButtonsVisible() const {
+  // Not applicable to OpenHarmony - mobile apps don't have window control buttons
+  return false;
+}
+
 void Window::SetAlwaysOnTop(bool is_always_on_top) {
   // SetAlwaysOnTop not fully supported on OpenHarmony
 }

src/platform/windows/window_windows.cpp

@@ -573,6 +573,16 @@ bool Window::IsClosable() const {
   return (style & WS_SYSMENU) != 0;
 }
 
+void Window::SetWindowControlButtonsVisible(bool is_visible) {
+  // TODO: Implement for Windows
+  // This would involve custom window chrome or DWM frame manipulation
+}
+
+bool Window::IsWindowControlButtonsVisible() const {
+  // TODO: Implement for Windows
+  return true;  // Default to visible
+}
+
 void Window::SetAlwaysOnTop(bool is_always_on_top) {
   if (pimpl_->hwnd_) {
     SetWindowPos(pimpl_->hwnd_, is_always_on_top ? HWND_TOPMOST : HWND_NOTOPMOST, 0, 0, 0, 0,

src/window.h

@@ -429,6 +429,40 @@ class Window : public NativeObjectProvider, public std::enable_shared_from_this<
    */
   bool IsClosable() const;
 
+  /**
+   * @brief Sets the visibility of window control buttons.
+   *
+   * @param is_visible true to show window control buttons, false to hide them
+   *
+   * Controls the visibility of window control buttons (minimize, maximize, close)
+   * in the title bar. When hidden, the buttons are not visible but the window
+   * can still be controlled programmatically.
+   *
+   * @note Platform availability:
+   * - macOS: ✅ Fully supported - Hides/shows the traffic light buttons (red, yellow, green)
+   * - Windows: ❌ Not implemented - Returns default value (visible)
+   * - Linux: ❌ Not implemented - Returns default value (visible)
+   * - Android: ❌ Not applicable - Mobile apps don't have window control buttons
+   * - iOS: ❌ Not applicable - Mobile apps don't have window control buttons
+   * - OpenHarmony: ❌ Not applicable - Mobile apps don't have window control buttons
+   */
+  void SetWindowControlButtonsVisible(bool is_visible);
+
+  /**
+   * @brief Checks if the window control buttons are visible.
+   *
+   * @return true if window control buttons are visible, false if hidden
+   *
+   * @note Platform availability:
+   * - macOS: ✅ Fully supported - Returns actual visibility state
+   * - Windows: ❌ Not implemented - Always returns true
+   * - Linux: ❌ Not implemented - Always returns true
+   * - Android: ❌ Not applicable - Always returns false
+   * - iOS: ❌ Not applicable - Always returns false
+   * - OpenHarmony: ❌ Not applicable - Always returns false
+   */
+  bool IsWindowControlButtonsVisible() const;
+
   /**
    * @brief Sets whether the window stays on top of other windows.
    *