Update Darwin availability annotations. (#33405)

Author: bzbarsky-apple

src/darwin/Framework/CHIP/MTRBaseDevice.h

@@ -564,7 +564,7 @@ MTR_AVAILABLE(ios(16.1), macos(13.0), watchos(9.1), tvos(16.1))
                   timeout:(NSTimeInterval)timeout
                     queue:(dispatch_queue_t)queue
                completion:(void (^)(NSURL * _Nullable url, NSError * _Nullable error))completion
-    MTR_NEWLY_AVAILABLE;
+    MTR_AVAILABLE(ios(17.6), macos(14.6), watchos(10.6), tvos(17.6));
 
 @end
 

src/darwin/Framework/CHIP/MTRCluster.h

@@ -141,7 +141,7 @@ MTR_AVAILABLE(ios(16.1), macos(13.0), watchos(9.1), tvos(16.1))
  * those consumers is readAttributeWithEndpointID:clusterID:attributeID:params:
  * on MTRDevice.
  */
-@property (nonatomic, assign, getter=shouldAssumeUnknownAttributesReportable) BOOL assumeUnknownAttributesReportable MTR_NEWLY_AVAILABLE;
+@property (nonatomic, assign, getter=shouldAssumeUnknownAttributesReportable) BOOL assumeUnknownAttributesReportable MTR_AVAILABLE(ios(17.6), macos(14.6), watchos(10.6), tvos(17.6));
 
 @end
 

src/darwin/Framework/CHIP/MTRClusterNames.h

@@ -31,7 +31,7 @@
  *
  * For unknown IDs, a string '<Unknown clusterID %d>' will be returned.
  */
-MTR_EXTERN MTR_NEWLY_AVAILABLE NSString * MTRClusterNameForID(MTRClusterIDType clusterID);
+MTR_EXTERN MTR_AVAILABLE(ios(17.6), macos(14.6), watchos(10.6), tvos(17.6)) NSString * MTRClusterNameForID(MTRClusterIDType clusterID);
 
 /**
  * Resolve Matter attribute IDs into a descriptive string.
@@ -40,4 +40,4 @@ MTR_EXTERN MTR_NEWLY_AVAILABLE NSString * MTRClusterNameForID(MTRClusterIDType c
  * or '<Unknown attributeID %d>' (if the cluster ID is known but the attribute ID is not known)
  * will be returned.
  */
-MTR_EXTERN MTR_NEWLY_AVAILABLE NSString * MTRAttributeNameForID(MTRClusterIDType clusterID, MTRAttributeIDType attributeID);
+MTR_EXTERN MTR_AVAILABLE(ios(17.6), macos(14.6), watchos(10.6), tvos(17.6)) NSString * MTRAttributeNameForID(MTRClusterIDType clusterID, MTRAttributeIDType attributeID);

src/darwin/Framework/CHIP/MTRDevice.h

@@ -73,7 +73,7 @@ MTR_AVAILABLE(ios(16.1), macos(13.0), watchos(9.1), tvos(16.1))
  * if a subscription has ever been established at any point in the past.
  *
  */
-@property (readonly) BOOL deviceCachePrimed MTR_NEWLY_AVAILABLE;
+@property (readonly) BOOL deviceCachePrimed MTR_AVAILABLE(ios(17.6), macos(14.6), watchos(10.6), tvos(17.6));
 
 /**
  * The estimated device system start time.
@@ -357,11 +357,11 @@ MTR_AVAILABLE(ios(16.1), macos(13.0), watchos(9.1), tvos(16.1))
                   timeout:(NSTimeInterval)timeout
                     queue:(dispatch_queue_t)queue
                completion:(void (^)(NSURL * _Nullable url, NSError * _Nullable error))completion
-    MTR_NEWLY_AVAILABLE;
+    MTR_AVAILABLE(ios(17.6), macos(14.6), watchos(10.6), tvos(17.6));
 @end
 
-MTR_EXTERN NSString * const MTRPreviousDataKey MTR_NEWLY_AVAILABLE;
-MTR_EXTERN NSString * const MTRDataVersionKey MTR_NEWLY_AVAILABLE;
+MTR_EXTERN NSString * const MTRPreviousDataKey MTR_AVAILABLE(ios(17.6), macos(14.6), watchos(10.6), tvos(17.6));
+MTR_EXTERN NSString * const MTRDataVersionKey MTR_AVAILABLE(ios(17.6), macos(14.6), watchos(10.6), tvos(17.6));
 
 @protocol MTRDeviceDelegate <NSObject>
 @required
@@ -421,15 +421,15 @@ MTR_EXTERN NSString * const MTRDataVersionKey MTR_NEWLY_AVAILABLE;
  *
  * The intention is that after this is called, the client should be able to call read for mandatory attributes and likely expect non-nil values.
  */
-- (void)deviceCachePrimed:(MTRDevice *)device MTR_NEWLY_AVAILABLE;
+- (void)deviceCachePrimed:(MTRDevice *)device MTR_AVAILABLE(ios(17.6), macos(14.6), watchos(10.6), tvos(17.6));
 
 /**
  * This is called when the MTRDevice object detects a change in the device configuration.
  *
  * Device configuration is the set of functionality implemented by the device.
  *
  */
-- (void)deviceConfigurationChanged:(MTRDevice *)device MTR_NEWLY_AVAILABLE;
+- (void)deviceConfigurationChanged:(MTRDevice *)device MTR_AVAILABLE(ios(17.6), macos(14.6), watchos(10.6), tvos(17.6));
 
 @end
 

src/darwin/Framework/CHIP/MTRDeviceController+XPC.h

@@ -192,7 +192,7 @@ typedef void (^MTRValuesHandler)(id _Nullable values, NSError * _Nullable error)
                            nodeId:(NSNumber *)nodeId
                              type:(MTRDiagnosticLogType)type
                           timeout:(NSTimeInterval)timeout
-                       completion:(void (^)(NSString * _Nullable url, NSError * _Nullable error))completion MTR_NEWLY_AVAILABLE;
+                       completion:(void (^)(NSString * _Nullable url, NSError * _Nullable error))completion MTR_AVAILABLE(ios(17.6), macos(14.6), watchos(10.6), tvos(17.6));
 
 @end
 

src/darwin/Framework/CHIP/MTRDeviceController.h

@@ -58,7 +58,7 @@ MTR_AVAILABLE(ios(16.1), macos(13.0), watchos(9.1), tvos(16.1))
  * on the controller to avoid leaking it.
  */
 - (nullable instancetype)initWithParameters:(MTRDeviceControllerAbstractParameters *)parameters
-                                      error:(NSError * __autoreleasing *)error MTR_NEWLY_AVAILABLE;
+                                      error:(NSError * __autoreleasing *)error MTR_AVAILABLE(ios(17.6), macos(14.6), watchos(10.6), tvos(17.6));
 
 /**
  * If true, the controller has not been shut down yet.
@@ -68,7 +68,7 @@ MTR_AVAILABLE(ios(16.1), macos(13.0), watchos(9.1), tvos(16.1))
 /**
  * The ID assigned to this controller at creation time.
  */
-@property (readonly, nonatomic) NSUUID * uniqueIdentifier MTR_NEWLY_AVAILABLE;
+@property (readonly, nonatomic) NSUUID * uniqueIdentifier MTR_AVAILABLE(ios(17.6), macos(14.6), watchos(10.6), tvos(17.6));
 
 /**
  * Return the Node ID assigned to the controller.  Will return nil if the
@@ -178,8 +178,7 @@ MTR_AVAILABLE(ios(16.1), macos(13.0), watchos(9.1), tvos(16.1))
                                                         error:(NSError * __autoreleasing *)error
     MTR_AVAILABLE(ios(16.4), macos(13.3), watchos(9.4), tvos(16.4));
 
-- (void)preWarmCommissioningSession MTR_AVAILABLE(ios(16.4), macos(13.3), watchos(9.4), tvos(16.4))
-    MTR_NEWLY_DEPRECATED("-[MTRDeviceControllerFactory preWarmCommissioningSession]");
+- (void)preWarmCommissioningSession MTR_DEPRECATED("-[MTRDeviceControllerFactory preWarmCommissioningSession]", ios(16.4, 17.6), macos(13.3, 14.6), watchos(9.4, 10.6), tvos(16.4, 17.6));
 
 /**
  * Set the Delegate for the device controller  as well as the Queue on which the Delegate callbacks will be triggered
@@ -223,20 +222,20 @@ MTR_AVAILABLE(ios(16.1), macos(13.0), watchos(9.1), tvos(16.1))
  * 1) There is already an endpoint defined with the given endpoint id.
  * 2) There are too many endpoints defined already.
  */
-- (BOOL)addServerEndpoint:(MTRServerEndpoint *)endpoint MTR_NEWLY_AVAILABLE;
+- (BOOL)addServerEndpoint:(MTRServerEndpoint *)endpoint MTR_AVAILABLE(ios(17.6), macos(14.6), watchos(10.6), tvos(17.6));
 
 /**
  * Remove the given server endpoint from this controller.  If the endpoint is
  * not attached to this controller, will just call the completion and do nothing
  * else.
  */
-- (void)removeServerEndpoint:(MTRServerEndpoint *)endpoint queue:(dispatch_queue_t)queue completion:(dispatch_block_t)completion MTR_NEWLY_AVAILABLE;
+- (void)removeServerEndpoint:(MTRServerEndpoint *)endpoint queue:(dispatch_queue_t)queue completion:(dispatch_block_t)completion MTR_AVAILABLE(ios(17.6), macos(14.6), watchos(10.6), tvos(17.6));
 
 /**
  * Remove the given server endpoint without being notified when the removal
  * completes.
  */
-- (void)removeServerEndpoint:(MTRServerEndpoint *)endpoint MTR_NEWLY_AVAILABLE;
+- (void)removeServerEndpoint:(MTRServerEndpoint *)endpoint MTR_AVAILABLE(ios(17.6), macos(14.6), watchos(10.6), tvos(17.6));
 
 /**
  * Compute a PASE verifier for the desired setup passcode.

src/darwin/Framework/CHIP/MTRDeviceControllerDelegate.h

@@ -95,7 +95,7 @@ MTR_AVAILABLE(ios(16.4), macos(13.3), watchos(9.4), tvos(16.4))
 - (void)controller:(MTRDeviceController *)controller
     commissioningComplete:(NSError * _Nullable)error
                    nodeID:(NSNumber * _Nullable)nodeID
-                  metrics:(MTRMetrics *)metrics MTR_NEWLY_AVAILABLE;
+                  metrics:(MTRMetrics *)metrics MTR_AVAILABLE(ios(17.6), macos(14.6), watchos(10.6), tvos(17.6));
 
 /**
  * Notify the delegate when commissioning infomation has been read from the Basic

src/darwin/Framework/CHIP/MTRDeviceControllerFactory.h

@@ -187,7 +187,7 @@ MTR_AVAILABLE(ios(16.4), macos(13.3), watchos(9.4), tvos(16.4))
  * The controller factory must be running for pre-warming to take place.  Pre-warming can take place
  * before any controllers are started.
  */
-- (void)preWarmCommissioningSession MTR_NEWLY_AVAILABLE;
+- (void)preWarmCommissioningSession MTR_AVAILABLE(ios(17.6), macos(14.6), watchos(10.6), tvos(17.6));
 
 @end
 
@@ -224,7 +224,7 @@ MTR_AVAILABLE(ios(16.4), macos(13.3), watchos(9.4), tvos(16.4))
  *                                    the other side requests via its MRP
  *                                    parameters.
  */
-MTR_EXTERN MTR_NEWLY_AVAILABLE void MTRSetMessageReliabilityParameters(NSNumber * _Nullable idleRetransmitMs,
+MTR_EXTERN MTR_AVAILABLE(ios(17.6), macos(14.6), watchos(10.6), tvos(17.6)) void MTRSetMessageReliabilityParameters(NSNumber * _Nullable idleRetransmitMs,
     NSNumber * _Nullable activeRetransmitMs,
     NSNumber * _Nullable activeThresholdMs,
     NSNumber * _Nullable additionalRetransmitDelayMs);

src/darwin/Framework/CHIP/MTRDeviceControllerParameters.h

@@ -26,7 +26,7 @@ NS_ASSUME_NONNULL_BEGIN
  * interfaces inheriting from this one should be used to actually do the
  * initialization.
  */
-MTR_NEWLY_AVAILABLE
+MTR_AVAILABLE(ios(17.6), macos(14.6), watchos(10.6), tvos(17.6))
 @interface MTRDeviceControllerAbstractParameters : NSObject
 - (instancetype)init NS_UNAVAILABLE;
 + (instancetype)new NS_UNAVAILABLE;
@@ -36,7 +36,7 @@ MTR_NEWLY_AVAILABLE
  * Parameters that can be used to initialize an MTRDeviceController which
  * has a node identity.
  */
-MTR_NEWLY_AVAILABLE
+MTR_AVAILABLE(ios(17.6), macos(14.6), watchos(10.6), tvos(17.6))
 @interface MTRDeviceControllerParameters : MTRDeviceControllerAbstractParameters
 
 /**
@@ -79,7 +79,7 @@ MTR_NEWLY_AVAILABLE
 
 @end
 
-MTR_NEWLY_AVAILABLE
+MTR_AVAILABLE(ios(17.6), macos(14.6), watchos(10.6), tvos(17.6))
 @interface MTRDeviceControllerExternalCertificateParameters : MTRDeviceControllerParameters
 
 - (instancetype)init NS_UNAVAILABLE;

src/darwin/Framework/CHIP/MTRDeviceControllerStorageDelegate.h

@@ -25,7 +25,7 @@ typedef NS_ENUM(NSUInteger, MTRStorageSecurityLevel) {
     MTRStorageSecurityLevelSecure,
     // Data may be stored in the clear.
     MTRStorageSecurityLevelNotSecure,
-} MTR_NEWLY_AVAILABLE;
+} MTR_AVAILABLE(ios(17.6), macos(14.6), watchos(10.6), tvos(17.6));
 
 typedef NS_ENUM(NSUInteger, MTRStorageSharingType) {
     // Data must not be shared at all (just store locally).
@@ -42,7 +42,7 @@ typedef NS_ENUM(NSUInteger, MTRStorageSharingType) {
 
     // Data must be shared across all controllers on a given fabric.
     MTRStorageSharingTypeSameFabric,
-} MTR_NEWLY_AVAILABLE;
+} MTR_AVAILABLE(ios(17.6), macos(14.6), watchos(10.6), tvos(17.6));
 
 /**
  * Protocol for storing and retrieving controller-specific data.
@@ -65,7 +65,7 @@ typedef NS_ENUM(NSUInteger, MTRStorageSharingType) {
  *    and are provided to describe the data should the storage delegate choose to
  *    implement separating storage location by security level and sharing type.
  */
-MTR_NEWLY_AVAILABLE
+MTR_AVAILABLE(ios(17.6), macos(14.6), watchos(10.6), tvos(17.6))
 @protocol MTRDeviceControllerStorageDelegate <NSObject>
 @required
 /**
@@ -125,8 +125,7 @@ MTR_NEWLY_AVAILABLE
        sharingType:(MTRStorageSharingType)sharingType;
 @end
 
-MTR_EXTERN MTR_NEWLY_AVAILABLE
-    NSSet<Class> *
-    MTRDeviceControllerStorageClasses(void);
+MTR_EXTERN MTR_AVAILABLE(ios(17.6), macos(14.6), watchos(10.6), tvos(17.6))
+    NSSet<Class> * MTRDeviceControllerStorageClasses(void);
 
 NS_ASSUME_NONNULL_END

src/darwin/Framework/CHIP/MTRDiagnosticLogsType.h

@@ -24,4 +24,4 @@ typedef NS_ENUM(NSInteger, MTRDiagnosticLogType) {
     MTRDiagnosticLogTypeEndUserSupport = 0, // End user support log is requested
     MTRDiagnosticLogTypeNetworkDiagnostics = 1, // Network Diagnostics log is requested
     MTRDiagnosticLogTypeCrash = 2 // Crash log is requested
-} MTR_NEWLY_AVAILABLE;
+} MTR_AVAILABLE(ios(17.6), macos(14.6), watchos(10.6), tvos(17.6));

src/darwin/Framework/CHIP/MTRError.h

@@ -95,7 +95,7 @@ typedef NS_ERROR_ENUM(MTRErrorDomain, MTRErrorCode){
     /**
      * The operation was cancelled.
      */
-    MTRErrorCodeCancelled MTR_NEWLY_AVAILABLE = 16,
+    MTRErrorCodeCancelled MTR_AVAILABLE(ios(17.6), macos(14.6), watchos(10.6), tvos(17.6))= 16,
 };
 // clang-format on
 
@@ -138,8 +138,8 @@ typedef NS_ERROR_ENUM(MTRInteractionErrorDomain, MTRInteractionErrorCode){
     MTRInteractionErrorCodePathsExhausted                            = 0xc8,
     MTRInteractionErrorCodeTimedRequestMismatch                      = 0xc9,
     MTRInteractionErrorCodeFailsafeRequired                          = 0xca,
-    MTRInteractionErrorCodeInvalidInState        MTR_NEWLY_AVAILABLE = 0xcb,
-    MTRInteractionErrorCodeNoCommandResponse     MTR_NEWLY_AVAILABLE = 0xcc,
+    MTRInteractionErrorCodeInvalidInState        MTR_AVAILABLE(ios(17.6), macos(14.6), watchos(10.6), tvos(17.6))= 0xcb,
+    MTRInteractionErrorCodeNoCommandResponse     MTR_AVAILABLE(ios(17.6), macos(14.6), watchos(10.6), tvos(17.6))= 0xcc,
 };
 // clang-format on
 

src/darwin/Framework/CHIP/MTRMetrics.h

@@ -23,7 +23,7 @@ NS_ASSUME_NONNULL_BEGIN
 /**
  * Representation of metric data corresponding to a metric event.
  */
-MTR_NEWLY_AVAILABLE
+MTR_AVAILABLE(ios(17.6), macos(14.6), watchos(10.6), tvos(17.6))
 @interface MTRMetricData : NSObject
 
 /**
@@ -49,7 +49,7 @@ MTR_NEWLY_AVAILABLE
 /**
  * A representation of a collection of metrics data for an operation.
  */
-MTR_NEWLY_AVAILABLE
+MTR_AVAILABLE(ios(17.6), macos(14.6), watchos(10.6), tvos(17.6))
 @interface MTRMetrics : NSObject
 
 - (instancetype)init NS_UNAVAILABLE;