move interopChild checks into State

change interop variables into an enum

reorder interopType switch statements

move interop switch-case into enum

change Throughput and fileURL Summary types

remove old unused calls

introduce terminate method requirement + rewrite implementation for additional property

change additional property string summary to [String]

change string type to use String? and [String?]

add propertiesURL as available additional property type

formatting for readability

add propertiesUInt64 as available additional property type

deinit test for additional properties + fix for deinit fractionCompleted calculation

edit test to test deinit behavior for EstimatedTimeRemaining

replace redundant deinit complete(count:) call with mark dirty + add tests for deinit bahavior

more deinit tests

additional unit tests for deinit behavior

separate string additional properties into retaining vs non-retaining version

add custom URL property unit tests

add custom UInt64 property unit tests

update documentation for additional properties methods

updated initializer

draft additional property observation fix

establish keypaths for fileCount + rename terminate to finalSummary

add observationRegistrar access calls

add observationRegistrar withMutation calls

add accessObservation to withProperties

remove fileURL

Enhancements for Additional Properties

Author: chloe-yeo

Sources/FoundationEssentials/ProgressManager/ProgressManager+Interop.swift

@@ -220,6 +220,56 @@ extension ProgressManager {
         var reporterBridge: ProgressReporterBridge?
         var nsProgressBridge: Foundation.Progress?
     }
+    
+    internal enum InteropType {
+        case interopMirror(ProgressManager)
+        case interopObservation(InteropObservation)
+        
+        internal var totalCount: Int? {
+            switch self {
+            case .interopMirror(let mirror):
+                mirror.totalCount
+            case .interopObservation:
+                nil
+            }
+        }
+        
+        internal var completedCount: Int? {
+            switch self {
+            case .interopMirror(let mirror):
+                mirror.completedCount
+            case .interopObservation:
+                nil
+            }
+        }
+        
+        internal var fractionCompleted: Double? {
+            switch self {
+            case .interopMirror(let mirror):
+                mirror.fractionCompleted
+            case .interopObservation:
+                nil
+            }
+        }
+        
+        internal var isIndeterminate: Bool? {
+            switch self {
+            case .interopMirror(let mirror):
+                mirror.isIndeterminate
+            case .interopObservation:
+                nil
+            }
+        }
+        
+        internal var isFinished: Bool? {
+            switch self {
+            case .interopMirror(let mirror):
+                 mirror.isFinished
+            case .interopObservation:
+                nil
+            }
+        }
+    }
 }
 
 extension ProgressManager.State {
@@ -251,19 +301,23 @@ extension ProgressManager {
 
     internal func addBridge(reporterBridge: ProgressReporterBridge? = nil, nsProgressBridge: Foundation.Progress? = nil) {
         state.withLock { state in
+            var interopObservation = InteropObservation(subprogressBridge: nil)
+            
             if let reporterBridge {
-                state.interopObservation.reporterBridge = reporterBridge
+                interopObservation.reporterBridge = reporterBridge
             }
 
             if let nsProgressBridge {
-                state.interopObservation.nsProgressBridge = nsProgressBridge
+                interopObservation.nsProgressBridge = nsProgressBridge
             }
+            
+            state.interopType = .interopObservation(interopObservation)
         }
     }
 
-    internal func setInteropChild(interopChild: ProgressManager) {
+    internal func setInteropChild(interopMirror: ProgressManager) {
         state.withLock { state in
-            state.interopChild = interopChild
+            state.interopType = .interopMirror(interopMirror)
         }
     }
 }