Update

Author: coderchan

Example/Pods/Pods.xcodeproj/project.pbxproj

@@ -5,15 +5,13 @@ let package = Package(
     name: "SwifterUI",
     platforms: [.iOS(.v13)],
     products: [
-        // 主库
         .library(
             name: "SwiftlyUI",
             targets: ["SwiftlyUI"]
         ),
     ],
     dependencies: [],
     targets: [
-        // 核心模块（不依赖 SnapKit）
         .target(
             name: "SwiftlyUI",
             path: "SwiftlyUI",

Package.swift

@@ -10,18 +10,22 @@ import UIKit
 
 
 public extension UIActivityIndicatorView {
+    
+    /// SwiftlyUI extension for `UIActivityIndicatorView`.
     @discardableResult
     func style(_ style: UIActivityIndicatorView.Style) -> Self {
         self.style = style
         return self
     }
 
+    /// SwiftlyUI extension for `UIActivityIndicatorView`.
     @discardableResult
     func color(_ color: UIColor?) -> Self {
         self.color = color
         return self
     }
 
+    /// SwiftlyUI extension for `UIActivityIndicatorView`.
     @discardableResult
     func animating(_ animating: Bool) -> Self {
         if animating {
@@ -32,6 +36,7 @@ public extension UIActivityIndicatorView {
         return self
     }
 
+    /// SwiftlyUI extension for `UIActivityIndicatorView`.
     @discardableResult
     func hidesWhenStopped(_ hides: Bool) -> Self {
         self.hidesWhenStopped = hides

SwiftlyUI/Source/Core/UIActivityIndicatorView+SwiftlyUI.swift

@@ -13,67 +13,74 @@ import UIKit
 @available(iOS 14.0, watchOS 7.0, *)
 public extension UIBackgroundConfiguration {
 
+    
+    /// SwiftlyUI extension for `UIBackgroundConfiguration`.
+    /// - Parameter content: A closure that builds an array of `UIView` elements to be used as the custom view.
+    /// - Returns: A new `UIBackgroundConfiguration` instance with the custom view set.
     @discardableResult
     func customView(@SwiftlyUIBuilder content: () -> [UIView]) -> UIBackgroundConfiguration {
         var newConfig = self
         newConfig.customView = content().last
         return newConfig
     }
 
+    /// SwiftlyUI extension for `UIBackgroundConfiguration`.
     @discardableResult
     func customView(_ view: UIView?) -> UIBackgroundConfiguration {
         var newConfig = self
         newConfig.customView = view
         return newConfig
     }
 
+    /// SwiftlyUI extension for `UIBackgroundConfiguration`.
     @discardableResult
     func cornerRadius(_ radius: CGFloat) -> UIBackgroundConfiguration {
         var newConfig = self
         newConfig.cornerRadius = radius
         return newConfig
     }
 
+    /// SwiftlyUI extension for `UIBackgroundConfiguration`.
     @discardableResult
     func backgroundInsets(_ insets: NSDirectionalEdgeInsets) -> UIBackgroundConfiguration {
         var newConfig = self
         newConfig.backgroundInsets = insets
         return newConfig
     }
 
+    /// SwiftlyUI extension for `UIBackgroundConfiguration`.
     @discardableResult
     func edgesAddingLayoutMargins(_ edges: NSDirectionalRectEdge) -> UIBackgroundConfiguration {
         var newConfig = self
         newConfig.edgesAddingLayoutMarginsToBackgroundInsets = edges
         return newConfig
     }
 
-    // MARK: - 背景颜色相关
-    
+    /// SwiftlyUI extension for `UIBackgroundConfiguration`.
     @discardableResult
     func backgroundColor(_ color: UIColor?) -> UIBackgroundConfiguration {
         var newConfig = self
         newConfig.backgroundColor = color
         return newConfig
     }
 
+    /// SwiftlyUI extension for `UIBackgroundConfiguration`.
     @discardableResult
     func backgroundColorTransformer(_ transformer: UIConfigurationColorTransformer?) -> UIBackgroundConfiguration {
         var newConfig = self
         newConfig.backgroundColorTransformer = transformer
         return newConfig
     }
 
-    // MARK: - 视觉效果
-    
+    /// SwiftlyUI extension for `UIBackgroundConfiguration`.
     @discardableResult
     func visualEffect(_ effect: UIVisualEffect?) -> UIBackgroundConfiguration {
         var newConfig = self
         newConfig.visualEffect = effect
         return newConfig
     }
 
-    // MARK: - 图片配置 (iOS 15+/watchOS 8+)
+    /// SwiftlyUI extension for `UIBackgroundConfiguration`.
     @available(iOS 15.0, watchOS 8.0, tvOS 15.0, *)
     @discardableResult
     func image(_ image: UIImage?) -> UIBackgroundConfiguration {
@@ -82,6 +89,7 @@ public extension UIBackgroundConfiguration {
         return newConfig
     }
 
+    /// SwiftlyUI extension for `UIBackgroundConfiguration`.
     @available(iOS 15.0, watchOS 8.0, tvOS 15.0, *)
     @discardableResult
     func imageContentMode(_ mode: UIView.ContentMode) -> UIBackgroundConfiguration {
@@ -90,29 +98,31 @@ public extension UIBackgroundConfiguration {
         return newConfig
     }
 
-    // MARK: - 边框样式
-    
+    /// SwiftlyUI extension for `UIBackgroundConfiguration`.
     @discardableResult
     func strokeColor(_ color: UIColor?) -> UIBackgroundConfiguration {
         var newConfig = self
         newConfig.strokeColor = color
         return newConfig
     }
 
+    /// SwiftlyUI extension for `UIBackgroundConfiguration`.
     @discardableResult
     func strokeColorTransformer(_ transformer: UIConfigurationColorTransformer?) -> UIBackgroundConfiguration {
         var newConfig = self
         newConfig.strokeColorTransformer = transformer
         return newConfig
     }
 
+    /// SwiftlyUI extension for `UIBackgroundConfiguration`.
     @discardableResult
     func strokeWidth(_ width: CGFloat) -> UIBackgroundConfiguration {
         var newConfig = self
         newConfig.strokeWidth = width
         return newConfig
     }
 
+    /// SwiftlyUI extension for `UIBackgroundConfiguration`.
     @discardableResult
     func strokeOutset(_ outset: CGFloat) -> UIBackgroundConfiguration {
         var newConfig = self
@@ -122,6 +132,7 @@ public extension UIBackgroundConfiguration {
 
     // MARK: - 阴影属性 (iOS 18+/watchOS 11+)
 #if compiler(>=6.0)
+    /// SwiftlyUI extension for `UIBackgroundConfiguration`.
     @available(iOS 18.0, watchOS 11.0, tvOS 18.0, visionOS 2.0, *)
     @discardableResult
     func shadowProperties(_ properties: UIShadowProperties) -> UIBackgroundConfiguration {
@@ -130,15 +141,14 @@ public extension UIBackgroundConfiguration {
         return newConfig
     }
 #endif
-    // MARK: - 便捷方法
 
-    /// 链式更新状态配置
+    /// SwiftlyUI extension for `UIBackgroundConfiguration`.
     @discardableResult
     func update(for state: UIConfigurationState) -> UIBackgroundConfiguration {
         self.updated(for: state)
     }
 
-    /// 便捷设置背景边距（简化版）
+    /// SwiftlyUI extension for `UIBackgroundConfiguration`.
     @discardableResult
     func backgroundInsets(top: CGFloat = 0, leading: CGFloat = 0, bottom: CGFloat = 0, trailing: CGFloat = 0) -> UIBackgroundConfiguration {
         var newConfig = self

SwiftlyUI/Source/Core/UIBackgroundConfiguration+SwiftlyUI.swift

@@ -11,54 +11,63 @@ import UIKit
 
 public extension UIBarItem {
 
+    /// SwiftlyUI extension for `UIBarItem`.
     @discardableResult
     func title(_ title: String?) -> Self {
         self.title = title
         return self
     }
 
+    /// SwiftlyUI extension for `UIBarItem`.
     @discardableResult
     func enabled(_ enabled: Bool) -> Self {
         self.isEnabled = enabled
         return self
     }
 
+    /// SwiftlyUI extension for `UIBarItem`.
     @discardableResult
     func image(_ image: UIImage?) -> Self {
         self.image = image
         return self
     }
 
+    /// SwiftlyUI extension for `UIBarItem`.
     @discardableResult
     func landscapeImagePhone(_ image: UIImage?) -> Self {
         self.landscapeImagePhone = image
         return self
     }
 
+    /// SwiftlyUI extension for `UIBarItem`.
     @discardableResult
     func largeContentSizeImage(_ image: UIImage?) -> Self {
         self.largeContentSizeImage = image
         return self
     }
 
+    /// SwiftlyUI extension for `UIBarItem`.
     @discardableResult
     func imageInsets(_ insets: UIEdgeInsets) -> Self {
         self.imageInsets = insets
         return self
     }
 
+    /// SwiftlyUI extension for `UIBarItem`.
     @discardableResult
     func landscapeImagePhoneInsets(_ insets: UIEdgeInsets) -> Self {
         self.landscapeImagePhoneInsets = insets
         return self
     }
 
+    /// SwiftlyUI extension for `UIBarItem`.
     @discardableResult
     func largeContentSizeImageInsets(_ insets: UIEdgeInsets) -> Self {
         self.largeContentSizeImageInsets = insets
         return self
     }
 
+    /// SwiftlyUI extension for `UIBarItem`.
     @discardableResult
     func tag(_ tag: Int) -> Self {
         self.tag = tag
@@ -68,7 +77,7 @@ public extension UIBarItem {
 
 public extension UIBarButtonItem {
 
-    /// Creates a UIBarButtonItem with a custom view.
+    /// /// SwiftlyUI -  Creates a UIBarButtonItem with a custom view.
     @discardableResult
     convenience init(@SwiftlyUIBuilder customContentView: () -> [UIView]) {
         if customContentView().count != 1 {
@@ -78,45 +87,52 @@ public extension UIBarButtonItem {
         self.init(customView: content)
     }
 
+    /// SwiftlyUI extension for `UIBarButtonItem`.
     @discardableResult
     func possibleTitles(_ titles: Set<String>?) -> Self {
         self.possibleTitles = titles
         return self
     }
 
+    /// SwiftlyUI extension for `UIBarButtonItem`.
     @discardableResult
     func customView(_ view: UIView?) -> Self {
         self.customView = view
         return self
     }
 
+    /// SwiftlyUI extension for `UIBarButtonItem`.
     @discardableResult
     func style(_ style: UIBarButtonItem.Style) -> Self {
         self.style = style
         return self
     }
 
+    /// SwiftlyUI extension for `UIBarButtonItem`.
     @discardableResult
     func target(_ target: AnyObject?, action: Selector?) -> Self {
         self.target = target
         self.action = action
         return self
     }
 
+    /// SwiftlyUI extension for `UIBarButtonItem`.
     @discardableResult
     func tintColor(_ color: UIColor?) -> Self {
         self.tintColor = color
         return self
     }
 
 #if compiler(>=5.3)
+    /// SwiftlyUI extension for `UIBarButtonItem`.
     @available(iOS 14, *)
     @discardableResult
     func menu(_ menu: UIMenu?) -> Self {
         self.menu = menu
         return self
     }
 
+    /// SwiftlyUI extension for `UIBarButtonItem`.
     @available(iOS 14, *)
     @discardableResult
     func primaryAction(_ action: UIAction?) -> Self {
@@ -126,13 +142,15 @@ public extension UIBarButtonItem {
 
 #endif
 #if compiler(>=5.5)
+    /// SwiftlyUI extension for `UIBarButtonItem`.
     @available(iOS 15.0, *)
     @discardableResult
     func changesSelectionAsPrimaryAction(_ changes: Bool) -> Self {
         self.changesSelectionAsPrimaryAction = changes
         return self
     }
 
+    /// SwiftlyUI extension for `UIBarButtonItem`.
     @available(iOS 15.0, *)
     @discardableResult
     func selected(_ selected: Bool) -> Self {
@@ -143,20 +161,23 @@ public extension UIBarButtonItem {
 #endif
 
 #if compiler(>=5.7)
+    /// SwiftlyUI extension for `UIBarButtonItem`.
     @available(iOS 16.0, *)
     @discardableResult
     func hidden(_ hidden: Bool = true) -> Self {
         self.isHidden = hidden
         return self
     }
 
+    /// SwiftlyUI extension for `UIBarButtonItem`.
     @available(iOS 16.0, *)
     @discardableResult
     func preferredMenuElementOrder(_ order: UIContextMenuConfiguration.ElementOrder) -> Self {
         self.preferredMenuElementOrder = order
         return self
     }
 
+    /// SwiftlyUI extension for `UIBarButtonItem`.
     @available(iOS 16.0, *)
     @discardableResult
     func menuRepresentation(_ representation: UIMenuElement?) -> Self {