update

Author: swiftuiux

Sources/sharelink-for-swiftui/ShareLinkButton.swift

@@ -1,22 +1,41 @@
-import UIKit
+//
+//  ShareLinkButton.swift
+//
+//
+//  Created by Igor on 29.10.2023.
+//
+
 import SwiftUI
-import LinkPresentation
-import CoreLocation
-import Contacts
 
+/// A SwiftUI view that provides a button to share data using `UIActivityViewController`.
+@available(iOS 14.0, *)
 public struct ShareLinkButton<Label: View>: View {
 
+    /// State to control the presentation of the share sheet.
     @State private var isPresented: Bool = false
 
+    /// The data to be shared. It can include items like text, images, URLs, etc.
     private let data: [Any]
 
+    /// A closure that provides the label for the button.
     private let label: () -> Label
 
+    /// Optional custom activities to include in the share sheet.
     private let applicationActivities: [UIActivity]?
 
+    /// Optional activity types to exclude from the share sheet.
     private let excludedActivityTypes: [UIActivity.ActivityType]?
 
-    // Initializer for Transportable items using the builder internally
+    /// Initializer for `Transportable` items using the builder internally.
+    ///
+    /// - Parameters:
+    ///   - item: The item to be shared, conforming to the `Transportable` protocol.
+    ///   - icon: An optional icon for the item.
+    ///   - title: An optional title for the item.
+    ///   - printAction: A flag to determine if the print action should be included.
+    ///   - applicationActivities: Optional custom activities to include in the share sheet.
+    ///   - excludedActivityTypes: Optional activity types to exclude from the share sheet.
+    ///   - label: A closure that provides the label for the button.
     public init<T: Transportable>(
         item: T,
         icon: UIImage? = nil,
@@ -37,7 +56,13 @@ public struct ShareLinkButton<Label: View>: View {
         self.label = label
     }
 
-    // Initializer for UIActivityItemSource items
+    /// Initializer for `UIActivityItemSource` items.
+    ///
+    /// - Parameters:
+    ///   - itemSource: The item source to be shared.
+    ///   - applicationActivities: Optional custom activities to include in the share sheet.
+    ///   - excludedActivityTypes: Optional activity types to exclude from the share sheet.
+    ///   - label: A closure that provides the label for the button.
     public init(
         itemSource: UIActivityItemSource,
         applicationActivities: [UIActivity]? = nil,
@@ -50,6 +75,7 @@ public struct ShareLinkButton<Label: View>: View {
         self.label = label
     }
 
+    /// The content and behavior of the view.
     public var body: some View {
         Button(action: {
             isPresented = true

Sources/sharelink-for-swiftui/error/ShareLinkError.swift

@@ -8,18 +8,23 @@ import UIKit
 import CoreLocation
 
 /// Protocol `Transportable` inherits `CustomStringConvertible` for providing textual descriptions of objects.
+/// This protocol and its extensions are available only on iOS and available since iOS 14.
+@available(iOS 14.0, *)
 public protocol Transportable: CustomStringConvertible {}
 
+@available(iOS 14.0, *)
 extension String: Transportable {
     /// The description of a string is the string itself.
     public var description: String { self }
 }
 
+@available(iOS 14.0, *)
 extension URL: Transportable {
     /// The description of a URL is its absolute string representation.
     public var description: String { self.absoluteString }
 }
 
+@available(iOS 14.0, *)
 extension UIImage: Transportable {
     /// Property to extract the named parameter from the image description.
     var namedParameter: String? {
@@ -39,13 +44,16 @@ extension UIImage: Transportable {
     }
 }
 
+@available(iOS 14.0, *)
 extension Data: Transportable {
     /// The description of data is its string representation, or "Data object" if conversion fails.
     public var description: String {
         return String(data: self, encoding: .utf8) ?? "Data object"
     }
 }
 
+@available(iOS 14.0, *)
 extension NSAttributedString: Transportable {}
 
+@available(iOS 14.0, *)
 extension CLLocation: Transportable {}

Sources/sharelink-for-swiftui/protocol/Transportable.swift

@@ -8,7 +8,7 @@
 import UIKit
 
 /// A custom `UIActivityViewController` subclass that customizes the presentation of the activity sheet.
-class ActivitySheetController: UIActivityViewController {
+final class ActivitySheetController: UIActivityViewController {
 
     deinit {
         #if DEBUG

Sources/sharelink-for-swiftui/uikit/ActivitySheetController.swift

@@ -34,7 +34,7 @@ final class TransportableItem<T: Transportable>: NSObject, UIActivityItemSource
     ///
     /// - Parameter activityViewController: The `UIActivityViewController` requesting the placeholder item.
     /// - Returns: The item to be shared.
-    func activityViewControllerPlaceholderItem(_ activityViewController: UIActivityViewController) -> Any {
+    public func activityViewControllerPlaceholderItem(_ activityViewController: UIActivityViewController) -> Any {
         return item
     }
 
@@ -44,15 +44,15 @@ final class TransportableItem<T: Transportable>: NSObject, UIActivityItemSource
     ///   - activityViewController: The `UIActivityViewController` requesting the item.
     ///   - activityType: The type of activity requesting the item.
     /// - Returns: The item to be shared.
-    func activityViewController(_ activityViewController: UIActivityViewController, itemForActivityType activityType: UIActivity.ActivityType?) -> Any? {
+    public func activityViewController(_ activityViewController: UIActivityViewController, itemForActivityType activityType: UIActivity.ActivityType?) -> Any? {
         return item
     }
 
     /// Provides metadata for the link being shared.
     ///
     /// - Parameter activityViewController: The `UIActivityViewController` requesting the metadata.
     /// - Returns: The `LPLinkMetadata` object containing metadata about the item.
-    func activityViewControllerLinkMetadata(_ activityViewController: UIActivityViewController) -> LPLinkMetadata? {
+    public func activityViewControllerLinkMetadata(_ activityViewController: UIActivityViewController) -> LPLinkMetadata? {
         let metadata = LPLinkMetadata()
 
         // Set icon if available

Sources/sharelink-for-swiftui/uikit/TransportableItem.swift

@@ -8,9 +8,9 @@
 import UIKit
 
 /// Builder class for creating `NSAttributedString` with custom attributes.
-class AttributedStringBuilder {
+final class AttributedStringBuilder {
 
-    // Private variables for attributes
+    /// Private variables for attributes
     private var font: UIFont = UIFont.systemFont(ofSize: 12)
     private var foregroundColor: UIColor = .black
 

Sources/sharelink-for-swiftui/utils/AttributedStringBuilder.swift

@@ -30,6 +30,8 @@ final class TransportableItemBuilder<T: Transportable> {
         self.item = item
     }
 
+    // MARK: - API
+    
     /// Sets the title for the item.
     ///
     /// - Parameter title: An optional title for the item.
@@ -65,6 +67,8 @@ final class TransportableItemBuilder<T: Transportable> {
             + createPrintFormatterIfNeeded()
     }
 
+    // MARK: - Private
+    
     /// Creates the transportable item based on its type.
     ///
     /// - Returns: An array containing the transportable item.
@@ -108,6 +112,8 @@ final class TransportableItemBuilder<T: Transportable> {
     }
 }
 
+// MARK: - Fileprivate
+
 /// Resolves the title for the item if it is not provided.
 ///
 /// - Parameters: