add docs for other models related to modal

Author: mikhailChelbaev

Sources/ComponentsKit/Modal/Models/ModalRadius.swift

@@ -1,10 +1,18 @@
 import Foundation
 
+/// Defines the corner radius options for a modal's content area.
 public enum ModalRadius: Hashable {
+  /// No corner radius is applied, resulting in sharp edges.
   case none
+  /// A small corner radius is applied.
   case small
+  /// A medium corner radius is applied.
   case medium
+  /// A large corner radius is applied.
   case large
+  /// A custom corner radius specified by a `CGFloat` value.
+  ///
+  /// - Parameter value: The custom radius value to be applied.
   case custom(CGFloat)
 }
 

Sources/ComponentsKit/Modal/Models/ModalSize.swift

@@ -1,9 +1,14 @@
 import Foundation
 
+/// Defines the size options for a modal.
 public enum ModalSize {
+  /// A small modal size.
   case small
+  /// A medium modal size.
   case medium
+  /// A large modal size.
   case large
+  /// A full-screen modal that occupies the entire screen.
   case full
 }
 

Sources/ComponentsKit/Modal/Models/ModalTransition.swift

@@ -1,27 +1,34 @@
 import Foundation
 
-public struct ModalTransition: Hashable {
-  var value: TimeInterval
-
-  init(_ value: CGFloat) {
-    self.value = value
-  }
+/// Defines the transition speed options for a modal's appearance and dismissal animations.
+public enum ModalTransition: Hashable {
+  /// No transition is applied; the modal appears and disappears instantly.
+  case none
+  /// A slow transition speed.
+  case slow
+  /// A normal transition speed.
+  case normal
+  /// A fast transition speed.
+  case fast
+  /// A custom transition speed defined by a specific time interval.
+  ///
+  /// - Parameter duration: The duration of the custom transition in seconds.
+  case custom(TimeInterval)
 }
 
 extension ModalTransition {
-  public static var none: Self {
-    return Self(0.0)
-  }
-  public static var slow: Self {
-    return Self(0.5)
-  }
-  public static var normal: Self {
-    return Self(0.3)
-  }
-  public static var fast: Self {
-    return Self(0.2)
-  }
-  public static func custom(_ value: CGFloat) -> Self {
-    return Self(value)
+  var value: TimeInterval {
+    switch self {
+    case .none:
+      return 0.0
+    case .slow:
+      return 0.5
+    case .normal:
+      return 0.3
+    case .fast:
+      return 0.2
+    case .custom(let value):
+      return max(0, value)
+    }
   }
 }

Sources/ComponentsKit/Modal/Models/Paddings.swift

@@ -1,25 +1,48 @@
 import Foundation
 
+/// Defines padding values for each edge.
 public struct Paddings: Hashable {
+  /// The padding value for the top edge.
   public var top: CGFloat
+
+  /// The padding value for the leading edge.
   public var leading: CGFloat
+
+  /// The padding value for the bottom edge.
   public var bottom: CGFloat
+
+  /// The padding value for the trailing edge.
   public var trailing: CGFloat
 
+  /// Initializes a new `Paddings` instance with specific values for all edges.
+  ///
+  /// - Parameters:
+  ///   - top: The padding value for the top edge.
+  ///   - leading: The padding value for the leading edge.
+  ///   - bottom: The padding value for the bottom edge.
+  ///   - trailing: The padding value for the trailing edge.
   public init(top: CGFloat, leading: CGFloat, bottom: CGFloat, trailing: CGFloat) {
     self.top = top
     self.leading = leading
     self.bottom = bottom
     self.trailing = trailing
   }
 
+  /// Initializes a new `Paddings` instance with uniform horizontal and vertical values.
+  ///
+  /// - Parameters:
+  ///   - horizontal: The padding value applied to both the leading and trailing edges.
+  ///   - vertical: The padding value applied to both the top and bottom edges.
   public init(horizontal: CGFloat, vertical: CGFloat) {
     self.top = vertical
     self.leading = horizontal
     self.bottom = vertical
     self.trailing = horizontal
   }
 
+  /// Initializes a new `Paddings` instance with the same padding value applied to all edges.
+  ///
+  /// - Parameter padding: The uniform padding value for the top, leading, bottom, and trailing edges.
   public init(padding: CGFloat) {
     self.top = padding
     self.leading = padding