Add title bar style and control button APIs to window

Introduces title bar style support and window control button visibility APIs to the window abstraction. Updates native bindings and removes legacy window creation logic, switching to new native window creation functions. Also sets library type to dynamic in Swift Package manifests for iOS and macOS.

Author: lijy91

packages/cnativeapi/cxx_impl

@@ -11,6 +11,7 @@ let package = Package(
     products: [
         .library(
             name: "cnativeapi",
+            type: .dynamic,
             targets: ["cnativeapi"]
         )
     ],

packages/cnativeapi/ios/cnativeapi/Package.swift

@@ -62,6 +62,43 @@ class CNativeApiBindings {
   late final _native_accessibility_manager_is_enabled =
       _native_accessibility_manager_is_enabledPtr.asFunction<bool Function()>();
 
+  /// Window creation and destruction
+  native_window_t native_window_create() {
+    return _native_window_create();
+  }
+
+  late final _native_window_createPtr =
+      _lookup<ffi.NativeFunction<native_window_t Function()>>(
+        'native_window_create',
+      );
+  late final _native_window_create = _native_window_createPtr
+      .asFunction<native_window_t Function()>();
+
+  native_window_t native_window_create_from_native(
+    ffi.Pointer<ffi.Void> native_window,
+  ) {
+    return _native_window_create_from_native(native_window);
+  }
+
+  late final _native_window_create_from_nativePtr =
+      _lookup<
+        ffi.NativeFunction<native_window_t Function(ffi.Pointer<ffi.Void>)>
+      >('native_window_create_from_native');
+  late final _native_window_create_from_native =
+      _native_window_create_from_nativePtr
+          .asFunction<native_window_t Function(ffi.Pointer<ffi.Void>)>();
+
+  void native_window_destroy(native_window_t window) {
+    return _native_window_destroy(window);
+  }
+
+  late final _native_window_destroyPtr =
+      _lookup<ffi.NativeFunction<ffi.Void Function(native_window_t)>>(
+        'native_window_destroy',
+      );
+  late final _native_window_destroy = _native_window_destroyPtr
+      .asFunction<void Function(native_window_t)>();
+
   /// Window basic operations
   int native_window_get_id(native_window_t window) {
     return _native_window_get_id(window);
@@ -592,6 +629,33 @@ class CNativeApiBindings {
   late final _native_window_is_closable = _native_window_is_closablePtr
       .asFunction<bool Function(native_window_t)>();
 
+  void native_window_set_window_control_buttons_visible(
+    native_window_t window,
+    bool visible,
+  ) {
+    return _native_window_set_window_control_buttons_visible(window, visible);
+  }
+
+  late final _native_window_set_window_control_buttons_visiblePtr =
+      _lookup<ffi.NativeFunction<ffi.Void Function(native_window_t, ffi.Bool)>>(
+        'native_window_set_window_control_buttons_visible',
+      );
+  late final _native_window_set_window_control_buttons_visible =
+      _native_window_set_window_control_buttons_visiblePtr
+          .asFunction<void Function(native_window_t, bool)>();
+
+  bool native_window_is_window_control_buttons_visible(native_window_t window) {
+    return _native_window_is_window_control_buttons_visible(window);
+  }
+
+  late final _native_window_is_window_control_buttons_visiblePtr =
+      _lookup<ffi.NativeFunction<ffi.Bool Function(native_window_t)>>(
+        'native_window_is_window_control_buttons_visible',
+      );
+  late final _native_window_is_window_control_buttons_visible =
+      _native_window_is_window_control_buttons_visiblePtr
+          .asFunction<bool Function(native_window_t)>();
+
   void native_window_set_always_on_top(
     native_window_t window,
     bool always_on_top,
@@ -646,6 +710,37 @@ class CNativeApiBindings {
   late final _native_window_get_title = _native_window_get_titlePtr
       .asFunction<ffi.Pointer<ffi.Char> Function(native_window_t)>();
 
+  void native_window_set_title_bar_style(
+    native_window_t window,
+    native_title_bar_style_t style,
+  ) {
+    return _native_window_set_title_bar_style(window, style.value);
+  }
+
+  late final _native_window_set_title_bar_stylePtr =
+      _lookup<
+        ffi.NativeFunction<ffi.Void Function(native_window_t, ffi.UnsignedInt)>
+      >('native_window_set_title_bar_style');
+  late final _native_window_set_title_bar_style =
+      _native_window_set_title_bar_stylePtr
+          .asFunction<void Function(native_window_t, int)>();
+
+  native_title_bar_style_t native_window_get_title_bar_style(
+    native_window_t window,
+  ) {
+    return native_title_bar_style_t.fromValue(
+      _native_window_get_title_bar_style(window),
+    );
+  }
+
+  late final _native_window_get_title_bar_stylePtr =
+      _lookup<ffi.NativeFunction<ffi.UnsignedInt Function(native_window_t)>>(
+        'native_window_get_title_bar_style',
+      );
+  late final _native_window_get_title_bar_style =
+      _native_window_get_title_bar_stylePtr
+          .asFunction<int Function(native_window_t)>();
+
   void native_window_set_has_shadow(native_window_t window, bool has_shadow) {
     return _native_window_set_has_shadow(window, has_shadow);
   }
@@ -1553,7 +1648,7 @@ class CNativeApiBindings {
   ///
   /// @example
   /// ```c
-  /// native_window_t window = native_window_manager_create(&options);
+  /// native_window_t window = native_window_create();
   /// native_point_t offset = {0, 10};
   /// native_positioning_strategy_t strategy = native_positioning_strategy_relative_to_window(window,
   /// &offset); native_menu_open(menu, strategy); native_positioning_strategy_free(strategy);
@@ -3562,19 +3657,6 @@ class CNativeApiBindings {
   late final _native_tray_icon_list_free = _native_tray_icon_list_freePtr
       .asFunction<void Function(native_tray_icon_list_t)>();
 
-  /// Create a new window with default settings
-  /// @return Window handle, or NULL if creation failed
-  native_window_t native_window_manager_create() {
-    return _native_window_manager_create();
-  }
-
-  late final _native_window_manager_createPtr =
-      _lookup<ffi.NativeFunction<native_window_t Function()>>(
-        'native_window_manager_create',
-      );
-  late final _native_window_manager_create = _native_window_manager_createPtr
-      .asFunction<native_window_t Function()>();
-
   /// Get a window by its ID
   /// @param window_id The window ID
   /// @return Window handle, or NULL if not found
@@ -3888,6 +3970,23 @@ final class native_window_list_t extends ffi.Struct {
 /// Opaque window handle
 typedef native_window_t = ffi.Pointer<ffi.Void>;
 
+/// Title bar style enumeration
+enum native_title_bar_style_t {
+  NATIVE_TITLE_BAR_STYLE_NORMAL(0),
+  NATIVE_TITLE_BAR_STYLE_HIDDEN(1);
+
+  final int value;
+  const native_title_bar_style_t(this.value);
+
+  static native_title_bar_style_t fromValue(int value) => switch (value) {
+    0 => NATIVE_TITLE_BAR_STYLE_NORMAL,
+    1 => NATIVE_TITLE_BAR_STYLE_HIDDEN,
+    _ => throw ArgumentError(
+      "Unknown value for native_title_bar_style_t: $value",
+    ),
+  };
+}
+
 /// Window ID type
 typedef native_window_id_t = ffi.Long;
 typedef Dartnative_window_id_t = int;

packages/cnativeapi/lib/src/bindings_generated.dart

@@ -11,6 +11,7 @@ let package = Package(
     products: [
         .library(
             name: "cnativeapi",
+            type: .dynamic,
             targets: ["cnativeapi"]
         )
     ],

packages/cnativeapi/macos/cnativeapi/Package.swift

@@ -1,10 +1,29 @@
 import 'dart:ffi' hide Size;
 import 'package:ffi/ffi.dart' as ffi;
-import 'package:nativeapi/src/display_manager.dart';
 import 'package:nativeapi/src/foundation/cnativeapi_bindings_mixin.dart';
 import 'package:nativeapi/src/foundation/geometry.dart';
 import 'package:nativeapi/src/foundation/native_handle_wrapper.dart';
 
+/// Title bar style options for windows.
+///
+/// Defines how a window's title bar should be displayed. This affects the
+/// appearance and visibility of the standard window title bar including the
+/// title text and window control buttons (minimize, maximize, close).
+///
+/// Platform behavior may vary:
+/// - Windows: Hidden style removes the title bar but may retain window borders
+/// - macOS: Hidden style creates a borderless window with transparent title bar
+/// - Linux: Hidden style removes window decorations entirely
+enum TitleBarStyle {
+  /// Standard title bar with default platform appearance.
+  /// Shows title text and standard window control buttons.
+  normal,
+
+  /// Hidden title bar with no visible decorations.
+  /// The window appears without a title bar, useful for custom chrome.
+  hidden,
+}
+
 /// A cross-platform window abstraction.
 ///
 /// This class provides a unified interface for creating and managing windows
@@ -28,10 +47,14 @@ import 'package:nativeapi/src/foundation/native_handle_wrapper.dart';
 /// // Maximize the window
 /// window?.maximize();
 ///
+/// // Set title bar style
+/// window?.titleBarStyle = TitleBarStyle.hidden;
+///
 /// // Get window properties
 /// final title = window?.title;
 /// final size = window?.size;
 /// final position = window?.position;
+/// final titleBarStyle = window?.titleBarStyle;
 /// ```
 class Window
     with CNativeApiBindingsMixin
@@ -238,22 +261,8 @@ class Window
   }
 
   /// Centers the window on the primary screen.
-  ///
-  /// This method calculates the center position based on the primary display's
-  /// size and the window's current size, then sets the window position accordingly.
   void center() {
-    final primaryDisplay = DisplayManager.instance.getPrimary();
-    if (primaryDisplay == null) {
-      return;
-    }
-
-    final screenSize = primaryDisplay.size;
-    final windowSize = size;
-
-    final centerX = (screenSize.width - windowSize.width) / 2;
-    final centerY = (screenSize.height - windowSize.height) / 2;
-
-    setPosition(centerX, centerY);
+    bindings.native_window_center(_nativeHandle);
   }
 
   // === Window Properties ===
@@ -318,6 +327,41 @@ class Window
     return bindings.native_window_is_closable(_nativeHandle);
   }
 
+  /// Sets the visibility of window control buttons.
+  ///
+  /// 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.
+  ///
+  /// Platform availability:
+  /// - macOS: ✅ Fully supported - Hides/shows the traffic light buttons
+  /// - Windows: ❌ Not implemented
+  /// - Linux: ❌ Not implemented
+  /// - 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
+  set windowControlButtonsVisible(bool value) {
+    bindings.native_window_set_window_control_buttons_visible(
+      _nativeHandle,
+      value,
+    );
+  }
+
+  /// Checks if the window control buttons are visible.
+  ///
+  /// 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 get windowControlButtonsVisible {
+    return bindings.native_window_is_window_control_buttons_visible(
+      _nativeHandle,
+    );
+  }
+
   /// Sets whether the window is always on top.
   set isAlwaysOnTop(bool value) {
     bindings.native_window_set_always_on_top(_nativeHandle, value);
@@ -349,6 +393,33 @@ class Window
     return title;
   }
 
+  /// Sets the window's title bar style.
+  ///
+  /// Controls the appearance and visibility of the window's title bar.
+  /// Use [TitleBarStyle.normal] for standard appearance or [TitleBarStyle.hidden]
+  /// to hide the title bar for custom window chrome.
+  ///
+  /// Platform behavior may vary:
+  /// - Windows: Hidden style removes the title bar but may retain window borders
+  /// - macOS: Hidden style creates a borderless window with transparent title bar
+  /// - Linux: Hidden style removes window decorations entirely
+  set titleBarStyle(TitleBarStyle value) {
+    final nativeStyle = value == TitleBarStyle.hidden
+        ? native_title_bar_style_t.NATIVE_TITLE_BAR_STYLE_HIDDEN
+        : native_title_bar_style_t.NATIVE_TITLE_BAR_STYLE_NORMAL;
+    bindings.native_window_set_title_bar_style(_nativeHandle, nativeStyle);
+  }
+
+  /// Gets the window's title bar style.
+  TitleBarStyle get titleBarStyle {
+    final nativeStyle = bindings.native_window_get_title_bar_style(
+      _nativeHandle,
+    );
+    return nativeStyle == native_title_bar_style_t.NATIVE_TITLE_BAR_STYLE_HIDDEN
+        ? TitleBarStyle.hidden
+        : TitleBarStyle.normal;
+  }
+
   /// Sets whether the window has a shadow.
   set hasShadow(bool value) {
     bindings.native_window_set_has_shadow(_nativeHandle, value);