documentation improvements

Author: MiaKoring

Sources/GtkBackend/GtkBackend.swift

@@ -78,7 +78,6 @@ public final class GtkBackend: AppBackend {
             if ctx.interactiveDismissDisabled { return 1 }
 
             if ctx.isProgrammaticDismiss {
-                // Suppress onDismiss for programmatic closes
                 ctx.isProgrammaticDismiss = false
                 return 1
             }
@@ -98,9 +97,9 @@ public final class GtkBackend: AppBackend {
             guard let userData else { return 1 }
             let box = Unmanaged<ValueBox<() -> Void>>.fromOpaque(userData).takeUnretainedValue()
             box.value()
-            return 1 // consume
+            return 1
         }
-        return 0 // let others handle
+        return 0
     }
 
     // A separate initializer to satisfy ``AppBackend``'s requirements.
@@ -1685,7 +1684,6 @@ public final class GtkBackend: AppBackend {
     public func dismissSheet(_ sheet: Gtk.Window, window: ApplicationWindow?) {
         let key: OpaquePointer = OpaquePointer(sheet.widgetPointer)
         if let ctx = sheetContexts[key] {
-            // Suppress onDismiss when closing programmatically
             ctx.isProgrammaticDismiss = true
         }
         sheet.destroy()

Sources/SwiftCrossUI/Views/Modifiers/PresentationModifiers.swift

@@ -20,25 +20,47 @@ extension View {
     /// This modifier only affects the sheet presentation itself when applied to the
     /// top-level view within a sheet. It does not affect the content's corner radius.
     ///
-    /// supported platforms: iOS (ignored on unsupported platforms)
-    /// ignored on: older than iOS 15
+    /// supported platforms: iOS 15+, Gtk4 (ignored on unsupported platforms)
     ///
     /// - Parameter radius: The corner radius in pixels.
     /// - Returns: A view with the presentation corner radius preference set.
     public func presentationCornerRadius(_ radius: Double) -> some View {
         preference(key: \.presentationCornerRadius, value: radius)
     }
-
+    
+    /// Sets the visibility of a sheet's drag indicator.
+    ///
+    /// This modifier only affects the sheet presentation itself when applied to the
+    /// top-level view within a sheet.
+    ///
+    /// supported platforms: iOS 15+ (ignored on unsupported platforms)
+    ///
+    /// - Parameter visibiliy: visible or hidden
+    /// - Returns: A view with the presentation corner radius preference set.
     public func presentationDragIndicatorVisibility(
         _ visibility: PresentationDragIndicatorVisibility
     ) -> some View {
         preference(key: \.presentationDragIndicatorVisibility, value: visibility)
     }
-
+    
+    /// Sets the background of a sheet.
+    ///
+    /// This modifier only affects the sheet presentation itself when applied to the
+    /// top-level view within a sheet.
+    ///
+    /// - Parameter color: the background color
+    /// - Returns: A view with the presentation corner radius preference set.
     public func presentationBackground(_ color: Color) -> some View {
         preference(key: \.presentationBackground, value: color)
     }
-
+    
+    /// Sets wether the user should be able to dismiss the sheet themself.
+    ///
+    /// This modifier only affects the sheet presentation itself when applied to the
+    /// top-level view within a sheet.
+    ///
+    /// - Parameter isDisabled: is it disabled
+    /// - Returns: A view with the presentation corner radius preference set.
     public func interactiveDismissDisabled(_ isDisabled: Bool = true) -> some View {
         preference(key: \.interactiveDismissDisabled, value: isDisabled)
     }

Sources/SwiftCrossUI/Views/Modifiers/SheetModifier.swift

@@ -1,5 +1,5 @@
 extension View {
-    /// presents a conditional modal overlay
+    /// Presents a conditional modal overlay
     /// onDismiss optional handler gets executed before
     /// dismissing the sheet
     public func sheet<SheetContent: View>(