Add @Frozen Attribute to Public Enums (#147)

timbaev · web-flow · commit 2762ffacfb08 · 2025-07-11T19:33:49.000+03:00
* Mark all public enums as frozen
* Fix building for Mac Catalyst
diff --git a/Sources/Addons/Alert/AlertTextField.swift b/Sources/Addons/Alert/AlertTextField.swift
@@ -2,6 +2,7 @@
 import UIKit
 
 /// Types of text fields added to the alert.
+@frozen
 public enum AlertTextField: Sendable {
 
     /// A text field, with text and placeholder customization.
diff --git a/Sources/Addons/HUD/Animation/HUDAnimation.swift b/Sources/Addons/HUD/Animation/HUDAnimation.swift
@@ -3,6 +3,7 @@ import UIKit
 
 /// The animation type that should be used when the ``HUD`` is shown and hidden.
 @MainActor
+@frozen
 public enum HUDAnimation {
 
     /// Custom animation for showing and hiding the HUD.
diff --git a/Sources/Addons/HUD/Progress/Animation/ProgressAnimation.swift b/Sources/Addons/HUD/Progress/Animation/ProgressAnimation.swift
@@ -5,6 +5,7 @@ import UIKit
 ///
 /// An animation is used to update and show the `header`, `indicator` and `footer` parts of the progress view.
 @MainActor
+@frozen
 public enum ProgressAnimation {
 
     /// Custom animation for showing progress view of the HUD.
diff --git a/Sources/Addons/MediaPicker/MediaPickerImageExportPreset.swift b/Sources/Addons/MediaPicker/MediaPickerImageExportPreset.swift
@@ -2,6 +2,7 @@
 import UIKit
 
 /// A type that specifies how to export images to the client application.
+@frozen
 public enum MediaPickerImageExportPreset: Sendable {
 
     @available(iOS 11, *)
diff --git a/Sources/Addons/MediaPicker/MediaPickerSource.swift b/Sources/Addons/MediaPicker/MediaPickerSource.swift
@@ -6,6 +6,7 @@ import UIKit
 /// A given source may not be available on a given device because the source is not physically present
 /// or because it cannot currently be accessed.
 @MainActor
+@frozen
 public enum MediaPickerSource: CustomStringConvertible {
 
     /// Specifies the device’s photo library as the source for the image picker controller.
diff --git a/Sources/Addons/MediaPicker/MediaPickerType.swift b/Sources/Addons/MediaPicker/MediaPickerType.swift
@@ -19,6 +19,7 @@ import MobileCoreServices
 /// - Note: If you want to display a Live Photo rendered as a Loop or a Bounce, you must include ``movie`` case.
 ///
 /// To designate all available media types for a source, use a ``MediaPickerSource/availableMediaTypes``.
+@frozen
 public enum MediaPickerType: Sendable {
 
     /// The designates the still camera interface when capturing media,
diff --git a/Sources/Addons/MediaPicker/ScreenShowMediaPickerAction.swift b/Sources/Addons/MediaPicker/ScreenShowMediaPickerAction.swift
@@ -1,4 +1,4 @@
-#if canImport(UIKit) && canImport(Photos) && canImport(AVFoundation) && os(iOS)
+#if canImport(UIKit) && canImport(Photos) && canImport(AVFoundation) && os(iOS) && !targetEnvironment(macCatalyst)
 import UIKit
 import Photos
 import AVFoundation
diff --git a/Sources/Addons/Sharing/Item/SharingItem.swift b/Sources/Addons/Sharing/Item/SharingItem.swift
@@ -1,6 +1,7 @@
 #if canImport(UIKit) && os(iOS)
 import UIKit
 
+@frozen
 public enum SharingItem: CustomStringConvertible, @unchecked Sendable {
 
     case regular(Any)
diff --git a/Sources/Deeplink/DeeplinkType.swift b/Sources/Deeplink/DeeplinkType.swift
@@ -1,6 +1,7 @@
 import Foundation
 
 /// Different types of deep links.
+@frozen
 public enum DeeplinkType {
 
     /// A ``Deeplink`` handled from a URL.
diff --git a/Sources/Screen/Actions/Stack/SetStack/Animations/ScreenStackAnimation.swift b/Sources/Screen/Actions/Stack/SetStack/Animations/ScreenStackAnimation.swift
@@ -2,6 +2,7 @@
 import UIKit
 
 @MainActor
+@frozen
 public enum ScreenStackAnimation {
 
     case `default`
diff --git a/Sources/Screen/Actions/Tabs/SelectTab/Animations/ScreenTabAnimation.swift b/Sources/Screen/Actions/Tabs/SelectTab/Animations/ScreenTabAnimation.swift
@@ -2,6 +2,7 @@
 import UIKit
 
 @MainActor
+@frozen
 public enum ScreenTabAnimation {
 
     case custom(ScreenTabCustomAnimation)
diff --git a/Sources/Screen/Actions/Window/SetRoot/Animations/ScreenRootAnimation.swift b/Sources/Screen/Actions/Window/SetRoot/Animations/ScreenRootAnimation.swift
@@ -2,6 +2,7 @@
 import UIKit
 
 @MainActor
+@frozen
 public enum ScreenRootAnimation {
 
     case custom(ScreenRootCustomAnimation)
diff --git a/Sources/Screen/Decorators/Modal/ModalStyle/ScreenModalStyle.swift b/Sources/Screen/Decorators/Modal/ModalStyle/ScreenModalStyle.swift
@@ -3,6 +3,7 @@ import UIKit
 
 /// Modal screen presentation style.
 /// Changes the presentation animation when the screen is shown modally.
+@frozen
 public enum ScreenModalStyle {
 
     /// Default animation using `UIModalPresentationStyle` and `UIModalTransitionStyle`.
diff --git a/Sources/Screen/Navigator/Iterator/ScreenIterationResult.swift b/Sources/Screen/Navigator/Iterator/ScreenIterationResult.swift
@@ -2,6 +2,7 @@ import Foundation
 
 /// A value that represents either a continuation or a stop iteration,
 /// including the associated container value in each case.
+@frozen
 public enum ScreenIterationResult {
 
     /// Continue iterating if possible, starting from `suitableContainer`.
diff --git a/Sources/Tools/DictionaryDecoder/Options/DictionaryDataDecodingStrategy.swift b/Sources/Tools/DictionaryDecoder/Options/DictionaryDataDecodingStrategy.swift
@@ -1,6 +1,7 @@
 import Foundation
 
 /// The strategies for decoding raw data.
+@frozen
 public enum DictionaryDataDecodingStrategy {
 
     /// The strategy that encodes data using the encoding specified by the data instance itself.
diff --git a/Sources/Tools/DictionaryDecoder/Options/DictionaryDateDecodingStrategy.swift b/Sources/Tools/DictionaryDecoder/Options/DictionaryDateDecodingStrategy.swift
@@ -1,6 +1,7 @@
 import Foundation
 
 /// The strategies available for formatting dates when decoding them from Dictionary.
+@frozen
 public enum DictionaryDateDecodingStrategy {
 
     /// The strategy that uses formatting from the Date structure.
diff --git a/Sources/Tools/DictionaryDecoder/Options/DictionaryKeyDecodingStrategy.swift b/Sources/Tools/DictionaryDecoder/Options/DictionaryKeyDecodingStrategy.swift
@@ -1,6 +1,7 @@
 import Foundation
 
 /// The values that determine how to decode a type’s coding keys from Dictionary keys.
+@frozen
 public enum DictionaryKeyDecodingStrategy {
 
     /// A key decoding strategy that doesn’t change key names during decoding.
diff --git a/Sources/Tools/DictionaryDecoder/Options/DictionaryNonConformingFloatDecodingStrategy.swift b/Sources/Tools/DictionaryDecoder/Options/DictionaryNonConformingFloatDecodingStrategy.swift
@@ -2,6 +2,7 @@ import Foundation
 
 /// The strategies for encoding nonconforming floating-point numbers,
 /// also known as IEEE 754 exceptional values.
+@frozen
 public enum DictionaryNonConformingFloatDecodingStrategy {
 
     /// The strategy that throws an error upon decoding an exceptional floating-point value.
diff --git a/Sources/Tools/URLQueryDecoder/Options/URLQueryDataDecodingStrategy.swift b/Sources/Tools/URLQueryDecoder/Options/URLQueryDataDecodingStrategy.swift
@@ -1,6 +1,7 @@
 import Foundation
 
 /// The strategies for decoding raw data.
+@frozen
 public enum URLQueryDataDecodingStrategy {
 
     /// The strategy that encodes data using the encoding specified by the data instance itself.
diff --git a/Sources/Tools/URLQueryDecoder/Options/URLQueryDateDecodingStrategy.swift b/Sources/Tools/URLQueryDecoder/Options/URLQueryDateDecodingStrategy.swift
@@ -1,6 +1,7 @@
 import Foundation
 
 /// The strategies available for formatting dates when decoding them from URL.
+@frozen
 public enum URLQueryDateDecodingStrategy {
 
     /// The strategy that uses formatting from the Date structure.
diff --git a/Sources/Tools/URLQueryDecoder/Options/URLQueryKeyDecodingStrategy.swift b/Sources/Tools/URLQueryDecoder/Options/URLQueryKeyDecodingStrategy.swift
@@ -1,6 +1,7 @@
 import Foundation
 
 /// The values that determine how to decode a type’s coding keys from URL query keys.
+@frozen
 public enum URLQueryKeyDecodingStrategy {
 
     /// A key decoding strategy that doesn’t change key names during decoding.
diff --git a/Sources/Tools/URLQueryDecoder/Options/URLQueryNonConformingFloatDecodingStrategy.swift b/Sources/Tools/URLQueryDecoder/Options/URLQueryNonConformingFloatDecodingStrategy.swift
@@ -2,6 +2,7 @@ import Foundation
 
 /// The strategies for encoding nonconforming floating-point numbers,
 /// also known as IEEE 754 exceptional values.
+@frozen
 public enum URLQueryNonConformingFloatDecodingStrategy {
 
     /// The strategy that throws an error upon decoding an exceptional floating-point value.

Original file line number	Diff line number	Diff line change
`@@ -1,4 +1,4 @@`
`1`		`-#if canImport(UIKit) && canImport(Photos) && canImport(AVFoundation) && os(iOS)`
	`1`	`+#if canImport(UIKit) && canImport(Photos) && canImport(AVFoundation) && os(iOS) && !targetEnvironment(macCatalyst)`
`2`	`2`	`import UIKit`
`3`	`3`	`import Photos`
`4`	`4`	`import AVFoundation`