15.0.0

Author: relatedcode

CHANGELOG.md

@@ -1,5 +1,21 @@
 # Change Log
 
+## [15.0.0](https://github.com/relatedcode/ProgressHUD/releases/tag/15.0.0)
+
+Released on 2025-11-28.
+
+#### Changed
+
+- Complete rewrite from UIKit to SwiftUI.
+- Minimum iOS requirement updated from iOS 13.0+ to iOS 17.0+.
+- Source path changed from `ProgressHUD/Sources` to `SwiftUI/Sources`.
+- All color, font, and image properties now use SwiftUI types (`Color`, `Font`, `Image`) instead of UIKit types.
+- Updated API to use SwiftUI's `@Observable` and modern Swift concurrency.
+
+#### Note
+
+- This version (15.0.0+) is built with SwiftUI. If you need the UIKit version, please use version 14.1.4.
+
 ## [14.1.4](https://github.com/relatedcode/ProgressHUD/releases/tag/14.1.4)
 
 Released on 2025-07-04.

Package.swift

@@ -6,7 +6,7 @@ let package = Package(
     name: "ProgressHUD",
     defaultLocalization: "en",
     platforms: [
-        .iOS(.v13),
+        .iOS(.v17),
     ],
     products: [
         .library(
@@ -18,7 +18,7 @@ let package = Package(
         .target(
             name: "ProgressHUD",
             dependencies: [],
-            path: "ProgressHUD/Sources",
+            path: "SwiftUI/Sources",
             resources: [
                 .process("PrivacyInfo.xcprivacy"),
             ]

README.md

@@ -1,3 +1,7 @@
+## Let's Build Together! ✨
+
+I'd be happy to work with you! 🚀 Whether you need help integrating ProgressHUD, have questions, or want to collaborate on a project, feel free to [reach out](https://relatedcode.com/#contact-form).
+
 ## WHAT'S NEW
 
 For detailed changes, please refer to the [Change log](CHANGELOG.md).
@@ -6,11 +10,13 @@ For detailed changes, please refer to the [Change log](CHANGELOG.md).
 
 **ProgressHUD** is a convenient and intuitive HUD tool designed specifically for iOS. It enables the seamless presentation of concise alerts or notifications to your app users in a simple and non-disruptive way.
 
+**Note:** This version (15.0.0+) is built with SwiftUI. If you need the UIKit version, please use version 14.1.4.
+
 ## INSTALLATION
 
 ### Swift Package Manager
 
-[Swift Package Manager](https://www.swift.org/documentation/package-manager) is a tool for managing Swift code distribution.
+[Swift Package Manager](https://docs.swift.org/swiftpm/documentation/packagemanagerdocs/) is a tool for managing Swift code distribution.
 
 To add **ProgressHUD** as a dependency to your project, follow these steps:
 
@@ -21,10 +27,30 @@ To add **ProgressHUD** as a dependency to your project, follow these steps:
 
 ### Manually
 
-If you prefer not to use the dependency manager above, you can integrate **ProgressHUD** into your project manually. Simply copy all the `*.swift` files from the `ProgressHUD/Sources` folder into your Xcode project.
+If you prefer not to use the dependency manager above, you can integrate **ProgressHUD** into your project manually. Simply copy all the `*.swift` files from the `SwiftUI/Sources` folder into your Xcode project.
 
 ## QUICK START
 
+### SwiftUI Setup
+
+Add the `.progressHUD()` modifier to your root view:
+
+```swift
+import SwiftUI
+
+@main
+struct MyApp: App {
+    var body: some Scene {
+        WindowGroup {
+            ContentView()
+                .progressHUD()
+        }
+    }
+}
+```
+
+### Usage Examples
+
 ```swift
 ProgressHUD.banner("Banner title", "Banner message to display.")
 ```
@@ -81,6 +107,22 @@ ProgressHUD.symbol(name: "box.truck")
 ProgressHUD.symbol("Some text...", name: "sun.max")
 ```
 
+```swift
+ProgressHUD.success("Success message")
+```
+
+```swift
+ProgressHUD.error("Error message")
+```
+
+```swift
+ProgressHUD.added("Item added")
+```
+
+```swift
+ProgressHUD.animate("Loading...", symbol: "star.fill")
+```
+
 ```swift
 ProgressHUD.dismiss()
 ```
@@ -91,7 +133,7 @@ ProgressHUD.remove()
 
 ## REQUIREMENTS
 
-- iOS 13.0+
+- iOS 17.0+
 - Xcode 15.0+
 
 ## CUSTOMIZATION
@@ -103,23 +145,23 @@ ProgressHUD.animationType = .circleStrokeSpin
 ```
 
 ```swift
-ProgressHUD.colorHUD = .systemGray
+ProgressHUD.colorHUD = .gray.opacity(0.1)
 ```
 
 ```swift
-ProgressHUD.colorBackground = .lightGray
+ProgressHUD.colorBackground = .gray.opacity(0.3)
 ```
 
 ```swift
-ProgressHUD.colorAnimation = .systemBlue
+ProgressHUD.colorAnimation = .blue
 ```
 
 ```swift
-ProgressHUD.colorProgress = .systemBlue
+ProgressHUD.colorProgress = .blue
 ```
 
 ```swift
-ProgressHUD.colorStatus = .label
+ProgressHUD.colorStatus = .primary
 ```
 
 ```swift
@@ -128,12 +170,22 @@ ProgressHUD.marginSize = 50
 ```
 
 ```swift
-ProgressHUD.fontStatus = .boldSystemFont(ofSize: 24)
+ProgressHUD.fontStatus = .system(size: 24, weight: .bold)
+```
+
+```swift
+ProgressHUD.imageSuccess = Image("success")
+ProgressHUD.imageError = Image("error")
 ```
 
+Banner customization:
+
 ```swift
-ProgressHUD.imageSuccess = UIImage(named: "success.png")
-ProgressHUD.imageError = UIImage(named: "error.png")
+ProgressHUD.colorBanner = .blue.opacity(0.1)
+ProgressHUD.colorBannerTitle = .primary
+ProgressHUD.colorBannerMessage = .secondary
+ProgressHUD.fontBannerTitle = .system(size: 16, weight: .semibold)
+ProgressHUD.fontBannerMessage = .system(size: 14)
 ```
 
 A comprehensive list of the predefined enums:

SwiftUI/Sources/Animations/ActivityIndicatorView.swift

@@ -0,0 +1,31 @@
+//
+// Copyright (c) 2025 Related Code - https://relatedcode.com
+//
+// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+// THE SOFTWARE.
+
+import SwiftUI
+
+// MARK: - ActivityIndicatorView
+struct ActivityIndicatorView: View {
+
+	// MARK: - Properties
+	@State private var hud = ProgressHUD.shared
+
+	// MARK: - Body
+	var body: some View {
+		ProgressView()
+			.controlSize(.large)
+			.scaleEffect(1.35)
+			.tint(hud.colorAnimation)
+	}
+}
+
+#Preview {
+	ActivityIndicatorView()
+}

SwiftUI/Sources/Animations/BallVerticalBounceView.swift

@@ -0,0 +1,130 @@
+//
+// Copyright (c) 2025 Related Code - https://relatedcode.com
+//
+// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+// THE SOFTWARE.
+
+import SwiftUI
+
+// MARK: - BallVerticalBounceView
+struct BallVerticalBounceView: View {
+
+	// MARK: - Properties
+	@State private var hud = ProgressHUD.shared
+
+	// MARK: - Body
+	var body: some View {
+		GeometryReader { geometry in
+			let size = geometry.size
+			let width = size.width
+			let height = size.height
+
+			let ballRadius = width * 0.12
+			let lineWidth = width * 0.96
+			let lineY = height * 0.75
+			let topY = height * 0.15
+
+			let fallDistance = (lineY - ballRadius) - topY
+			let maxBend = height * 0.2
+
+			let animationDuration: TimeInterval = 0.9
+
+			KeyframeAnimator(initialValue: AnimationPhase(t: 0), repeating: true) { phase in
+				let t = phase.t
+				let (yOffset, bend) = calculatePhysics(t: t, maxFall: fallDistance, maxBend: maxBend)
+
+				let rubberHeight = maxBend * 1.5
+
+				ZStack {
+					RubberBand(bend: bend)
+						.stroke(hud.colorAnimation, style: StrokeStyle(lineWidth: width * 0.08, lineCap: .round))
+						.frame(width: lineWidth, height: rubberHeight)
+						.position(x: width / 2, y: lineY + (rubberHeight / 2))
+
+					Circle()
+						.fill(hud.colorAnimation)
+						.frame(width: ballRadius * 2, height: ballRadius * 2)
+						.position(
+							x: width / 2,
+							y: topY + yOffset
+						)
+				}
+			} keyframes: { _ in
+				KeyframeTrack(\.t) {
+					LinearKeyframe(1.0, duration: animationDuration)
+				}
+			}
+		}
+	}
+
+	// MARK: - Private Methods
+	private func calculatePhysics(t: Double, maxFall: CGFloat, maxBend: CGFloat) -> (CGFloat, CGFloat) {
+		let fallEnd = 0.40
+		let bendEnd = 0.60
+
+		var yOffset: CGFloat = 0
+		var currentBend: CGFloat = 0
+
+		if t < fallEnd {
+			let nt = t / fallEnd
+			let progress = nt * nt
+			yOffset = maxFall * CGFloat(progress)
+			currentBend = 0
+
+		} else if t < bendEnd {
+			let nt = (t - fallEnd) / (bendEnd - fallEnd)
+
+			let bendProgress = sin(nt * .pi)
+			currentBend = maxBend * CGFloat(bendProgress)
+
+			yOffset = maxFall + currentBend
+
+		} else {
+			let nt = (t - bendEnd) / (1.0 - bendEnd)
+
+			let risingT = 1.0 - nt
+			let progress = risingT * risingT
+
+			yOffset = maxFall * CGFloat(progress)
+			currentBend = 0
+		}
+
+		return (yOffset, currentBend)
+	}
+}
+
+private struct AnimationPhase {
+	var t: Double
+}
+
+private struct RubberBand: Shape {
+	var bend: CGFloat
+
+	var animatableData: CGFloat {
+		get { bend }
+		set { bend = newValue }
+	}
+
+	func path(in rect: CGRect) -> Path {
+		var path = Path()
+		let start = CGPoint(x: 0, y: 0)
+		let end = CGPoint(x: rect.width, y: 0)
+
+		let control = CGPoint(x: rect.width / 2, y: bend * 2)
+
+		path.move(to: start)
+		path.addQuadCurve(to: end, control: control)
+
+		return path
+	}
+}
+
+#Preview {
+	BallVerticalBounceView()
+		.frame(width: 70, height: 70)
+}