Clean up code

Author: danielsaidi

Sources/SwiftUIKit/Data/MimeType.swift

@@ -9,13 +9,11 @@
 import Foundation
 import UniformTypeIdentifiers
 
-/**
- This enum represents a set of different MIME and file types.
- 
- Note that some types may be expected to be a different type,
- but are instead an `.application` type. For instance, `json`
- is a text format, but the mime type is `application/json`.
- */
+/// This enum defines different MIME and file types.
+///
+/// Note that some types are expected to be a different type,
+/// but instead use `application`. For instance, `json` is a
+/// text format, but the mime type is `application/json`.
 public enum MimeType: Identifiable {
 
     case

Sources/SwiftUIKit/Extensions/Text+Lines.swift

@@ -10,18 +10,12 @@ import SwiftUI
 
 public extension Text {
 
-    /**
-     Force multiline rendering of a `Text` view where a text
-     can become truncated even if there's space.
-     */
+    /// Force text to render as multiline.
     func forceMultiline() -> some View {
         self.fixedSize(horizontal: false, vertical: true)
     }
-    
-    /**
-     Force single-line rendering of a `Text` view, where the
-     text can become truncated even if there's space.
-     */
+
+    /// Force text to render as single line.
     func forceSingleLine() -> some View {
         self.fixedSize(horizontal: true, vertical: false)
     }

Sources/SwiftUIKit/Images/ImageRepresentable+Data.swift

@@ -24,3 +24,24 @@ public extension ImageRepresentable {
         return image.jpegData(compressionQuality: quality)
     }
 }
+
+#if os(macOS)
+import AppKit
+import Cocoa
+import CoreGraphics
+
+public extension ImageRepresentable {
+
+    /// Get the image's core graphics image representation.
+    var cgImage: CGImage? {
+        cgImage(forProposedRect: nil, context: nil, hints: nil)
+    }
+
+    /// Get the image's JPEG data representation.
+    func jpegData(compressionQuality: CGFloat) -> Data? {
+        guard let image = cgImage else { return nil }
+        let bitmap = NSBitmapImageRep(cgImage: image)
+        return bitmap.representation(using: .jpeg, properties: [.compressionFactor: compressionQuality])
+    }
+}
+#endif

Sources/SwiftUIKit/Images/ImageRepresentable+Resized.swift

@@ -11,10 +11,10 @@ import Foundation
 #if canImport(UIKit)
 import UIKit
 
-public extension UIImage {
+public extension ImageRepresentable {
 
     /// Create a resized copy of the image.
-    func resized(to size: CGSize) -> UIImage? {
+    func resized(to size: CGSize) -> ImageRepresentable? {
         UIGraphicsBeginImageContextWithOptions(size, false, scale)
         draw(in: CGRect(origin: CGPoint.zero, size: size))
         let result = UIGraphicsGetImageFromCurrentImageContext()
@@ -25,11 +25,11 @@ public extension UIImage {
 #elseif canImport(AppKit)
 import AppKit
 
-public extension NSImage {
+public extension ImageRepresentable {
 
     /// Create a resized copy of the image.
-    func resized(to newSize: CGSize) -> NSImage? {
-        let newImage = NSImage(size: newSize)
+    func resized(to newSize: CGSize) -> ImageRepresentable? {
+        let newImage = ImageRepresentable(size: newSize)
         newImage.lockFocus()
         let sourceRect = NSRect(x: 0, y: 0, width: size.width, height: size.height)
         let destRect = NSRect(x: 0, y: 0, width: newSize.width, height: newSize.height)

Sources/SwiftUIKit/Images/NSImage+Data.swift

@@ -0,0 +1,51 @@
+//
+//  SwiftUIPreviewInspector.swift
+//  SwiftUIKit
+//
+//  Created by Daniel Saidi on 2022-11-01.
+//  Copyright © 2022-2025 Daniel Saidi. All rights reserved.
+//
+
+import SwiftUI
+
+/// This protocol can be implemented by types that can check
+/// if the code is running in a SwiftUI preview.
+///
+/// The protocol is implemented by `ProcessInfo`.
+public protocol SwiftUIPreviewInspector {
+
+    /// Whether or not the code runs in a SwiftUI preview.
+    var isSwiftUIPreview: Bool { get }
+}
+
+public extension SwiftUIPreviewInspector {
+
+    /// Whether or not the code runs in a SwiftUI preview.
+     var isSwiftUIPreview: Bool {
+        ProcessInfo.isSwiftUIPreview
+    }
+}
+
+extension ProcessInfo: SwiftUIPreviewInspector {}
+
+public extension ProcessInfo {
+
+    /// Whether or not the code runs in a SwiftUI preview.
+    var isSwiftUIPreview: Bool {
+        environment["XCODE_RUNNING_FOR_PREVIEWS"] == "1"
+    }
+
+    /// Whether or not the code runs in a SwiftUI preview.
+    static var isSwiftUIPreview: Bool {
+        processInfo.isSwiftUIPreview
+    }
+}
+
+#Preview {
+
+    VStack {
+        Text("Preview.IsSwiftUIPreview", bundle: .module)
+            .font(.title)
+        Text("\(ProcessInfo.processInfo.isSwiftUIPreview ? "Preview.Yes" : "Preview.No")", bundle: .module)
+    }
+}

Sources/SwiftUIKit/Previews/ProcessInfo+SwiftPreviewInspector.swift

@@ -9,13 +9,8 @@
 #if os(iOS)
 import SwiftUI
 
-/**
- This sheet can be used to present `UIActivityViewController`
- modals for any kind of shareable content.
- 
- You can use a ``SheetContext`` to easily present this sheet
- as a modal sheet.
- */
+/// This sheet can present a `UIActivityViewController` when
+/// sharing any kind of shareable content.
 public struct ShareSheet: UIViewControllerRepresentable {
 
     public init(

Sources/SwiftUIKit/Previews/SwiftPreviewInspector.swift

@@ -121,7 +121,7 @@ SwiftUIKit is available under the MIT license.
 
 ### Previews
 
-- ``SwiftPreviewInspector``
+- ``SwiftUIPreviewInspector``
 
 ### Progress