Deprecate dot loading views

Author: danielsaidi

RELEASE_NOTES.md

@@ -4,6 +4,12 @@ SwiftUIKit makes its best effort to honor semver, but breaking changes can occur
 
 
 
+## 5.9.4
+
+This version deprecates the `DotLoading` views.
+
+
+
 ## 5.9.3
 
 This version makes image rotation available to all UIKit platforms.

Sources/SwiftUIKit/SwiftUIKit.docc/SwiftUIKit.md

@@ -90,11 +90,6 @@ SwiftUIKit is available under the MIT license.
 - ``KeychainService``
 - ``KeychainWrapper``
 
-### Loading
-
-- ``DotLoadingAnimation``
-- ``DotLoadingAnimationText``
-
 ### Lists
 
 - ``ListButtonGroup``
@@ -125,11 +120,6 @@ SwiftUIKit is available under the MIT license.
 
 - ``SwiftUIPreviewInspector``
 
-### Progress
-
-- ``CircularProgressBar``
-- ``LinearProgressBar``
-
 ### Regex
 
 - ``ValidationRegex``

Sources/SwiftUIKit/Loading/DotLoadingAnimation.swift renamed to Sources/SwiftUIKit/_Deprecated/DotLoadingAnimation.swift

@@ -9,14 +9,7 @@
 import Combine
 import SwiftUI
 
-/// This animation can be used to render dots, where a timer
-/// increments the number of presented dots.
-///
-/// The view just renders plain text, so you can style it as
-/// you would any other text.
-///
-/// You can use ``DotLoadingAnimationText`` to present texts
-/// with the dot animation playing after the text.
+@available(*, deprecated, message: "Use SF Symbols instead. See https://danielsaidi.com/blog/2025/06/19/creating-amazing-loading-animations-with-sf-symbols for more information.")
 public struct DotLoadingAnimation: View {
 
     /// Create a dot animation.
@@ -43,32 +36,21 @@ public struct DotLoadingAnimation: View {
         Text(dotText)
             .onReceive(timer) { _ in increaseDotCount() }
     }
-}
-
-private extension DotLoadingAnimation {
 
-    var dotText: String {
+    private var dotText: String {
         if currentDotCount == 0 {
             return ""
         }
         return (0..<currentDotCount)
             .map { _ in "." }
             .joined(separator: "")
     }
-}
-
-private extension DotLoadingAnimation {
 
-    func increaseDotCount() {
+    private func increaseDotCount() {
         var newCount = currentDotCount + 1
         if newCount > dotCount {
             newCount = 0
         }
         currentDotCount = newCount
     }
 }
-
-#Preview {
-
-    DotLoadingAnimation()
-}

Sources/SwiftUIKit/Loading/DotLoadingAnimationText.swift renamed to Sources/SwiftUIKit/_Deprecated/DotLoadingAnimationText.swift

@@ -8,13 +8,7 @@
 
 import SwiftUI
 
-/**
- This view adds a ``DotLoadingAnimation`` after the provided
- `text`, to indicate a loading state.
-
- The view just renders plain text, so you can style the text
- just like you would any other text.
- */
+@available(*, deprecated, message: "Use SF Symbols instead. See https://danielsaidi.com/blog/2025/06/19/creating-amazing-loading-animations-with-sf-symbols for more information.")
 public struct DotLoadingAnimationText: View {
 
     /// Create a dot animation text.
@@ -49,35 +43,24 @@ public struct DotLoadingAnimationText: View {
         .opacity(0)
         .overlay(titleAnimation, alignment: .leading)
     }
-}
-
-private extension DotLoadingAnimationText {
 
-    var dotAnimation: some View {
+    private var dotAnimation: some View {
         DotLoadingAnimation(
             dotCount: dotCount,
             interval: interval
         )
     }
 
-    var staticDotString: String {
+    private var staticDotString: String {
         (0..<dotCount)
             .map { _ in "." }
             .joined(separator: "")
     }
 
-    var titleAnimation: some View {
+    private var titleAnimation: some View {
         HStack(spacing: 0) {
             Text(text)
             dotAnimation
         }
     }
 }
-
-#Preview {
-
-    DotLoadingAnimationText(
-        text: "Preview.LoadingNoDots",
-        bundle: .module
-    )
-}