peachsim 0.1.2176 → 0.1.2179

package/sdk/ios/System/Library/Frameworks/Contacts.framework/Headers/CNLabeledValue.h

@@ -0,0 +1,69 @@
+//
+//  CNLabeledValue.h
+//  Contacts
+//
+//  Copyright (c) 2015–2019 Apple Inc. All rights reserved.
+//
+
+#import <Foundation/Foundation.h>
+#import <Contacts/ContactsDefines.h>
+
+NS_ASSUME_NONNULL_BEGIN
+
+
+/*!
+ * @abstract A contact property that has a value and label.
+ */
+NS_CLASS_AVAILABLE(10_11, 9_0)
+@interface CNLabeledValue<ValueType : id <NSCopying, NSSecureCoding>> : NSObject <NSCopying, NSSecureCoding>
+
+/*! The identifier is unique among contacts on the device. It can be saved and used for finding labeled values next application launch. */
+@property (readonly, copy, NS_NONATOMIC_IOSONLY) NSString *identifier;
+
+@property (readonly, nullable, copy, NS_NONATOMIC_IOSONLY) NSString *label;
+@property (readonly, copy, NS_NONATOMIC_IOSONLY) ValueType value;
+
+/*! Returns a new CNLabeledValue with a new identifier. */
++ (instancetype)labeledValueWithLabel:(nullable NSString *)label value:(ValueType)value;
+
+/*! Initializes the CNLabeledValue with a new identifier. */
+- (instancetype)initWithLabel:(nullable NSString *)label value:(ValueType)value;
+
+/*! Returns a new CNLabeledValue with the existing value and identifier. */
+- (instancetype)labeledValueBySettingLabel:(nullable NSString *)label;
+
+/*! Returns a new CNLabeledValue with the existing label and identifier. */
+- (instancetype)labeledValueBySettingValue:(ValueType)value;
+
+/*! Returns a new CNLabeledValue with the existing identifier. */
+- (instancetype)labeledValueBySettingLabel:(nullable NSString *)label value:(ValueType)value;
+
+/*!
+ * @abstract Get a localized label.
+ *
+ * @discussion Some labels are special keys representing generic labels. Use this to obtain a localized string for a label to display to a user.
+ *
+ * @param label to localize.
+ * @return The localized string if a Contacts framework defined label, otherwise just returns the label.
+ */
++ (NSString *)localizedStringForLabel:(NSString *)label;
+
+@end
+
+
+// Generic labels
+CONTACTS_EXTERN NSString * const CNLabelHome                             NS_AVAILABLE(10_11, 9_0);
+CONTACTS_EXTERN NSString * const CNLabelWork                             NS_AVAILABLE(10_11, 9_0);
+CONTACTS_EXTERN NSString * const CNLabelSchool                           NS_AVAILABLE(10_15, 13_0);
+CONTACTS_EXTERN NSString * const CNLabelOther                            NS_AVAILABLE(10_11, 9_0);
+
+// Additional email labels
+CONTACTS_EXTERN NSString * const CNLabelEmailiCloud                      NS_AVAILABLE(10_11, 9_0);
+
+// URL address labels
+CONTACTS_EXTERN NSString * const CNLabelURLAddressHomePage               NS_AVAILABLE(10_11, 9_0);
+
+// Date labels
+CONTACTS_EXTERN NSString * const CNLabelDateAnniversary                  NS_AVAILABLE(10_11, 9_0);
+
+NS_ASSUME_NONNULL_END

package/sdk/ios/System/Library/Frameworks/Contacts.framework/Headers/CNMutableContact.h

@@ -0,0 +1,74 @@
+//
+//  CNMutableContact.h
+//  Contacts
+//
+//  Copyright (c) 2015 Apple Inc. All rights reserved.
+//
+
+#import <Contacts/CNContact.h>
+
+NS_ASSUME_NONNULL_BEGIN
+
+
+/*!
+ * @abstract A mutable value object representing a contact.
+ *
+ * @discussion CNMutableContact is not thread safe. If this is a mutable copy of CNContact then it will throw CNContactPropertyNotFetchedExceptionName when accessing a property that was not fetched for the CNContact.
+ *
+ * @note To remove properties when saving a mutable contact, set string properties and array properties to empty values. Set other properties to nil.
+ */
+NS_CLASS_AVAILABLE(10_11, 9_0)
+@interface CNMutableContact : CNContact
+
+@property (NS_NONATOMIC_IOSONLY) CNContactType contactType;
+
+@property (copy, NS_NONATOMIC_IOSONLY) NSString *namePrefix;
+@property (copy, NS_NONATOMIC_IOSONLY) NSString *givenName;
+@property (copy, NS_NONATOMIC_IOSONLY) NSString *middleName;
+@property (copy, NS_NONATOMIC_IOSONLY) NSString *familyName;
+@property (copy, NS_NONATOMIC_IOSONLY) NSString *previousFamilyName;
+@property (copy, NS_NONATOMIC_IOSONLY) NSString *nameSuffix;
+@property (copy, NS_NONATOMIC_IOSONLY) NSString *nickname;
+
+@property (copy, NS_NONATOMIC_IOSONLY) NSString *organizationName;
+@property (copy, NS_NONATOMIC_IOSONLY) NSString *departmentName;
+@property (copy, NS_NONATOMIC_IOSONLY) NSString *jobTitle;
+
+@property (copy, NS_NONATOMIC_IOSONLY) NSString *phoneticGivenName;
+@property (copy, NS_NONATOMIC_IOSONLY) NSString *phoneticMiddleName;
+@property (copy, NS_NONATOMIC_IOSONLY) NSString *phoneticFamilyName;
+@property (copy, NS_NONATOMIC_IOSONLY) NSString *phoneticOrganizationName;
+
+@property (copy, NS_NONATOMIC_IOSONLY) NSString *note;
+
+@property (copy, nullable, NS_NONATOMIC_IOSONLY) NSData *imageData;
+
+@property (copy, NS_NONATOMIC_IOSONLY) NSArray<CNLabeledValue<CNPhoneNumber*>*>               *phoneNumbers;
+@property (copy, NS_NONATOMIC_IOSONLY) NSArray<CNLabeledValue<NSString*>*>                    *emailAddresses;
+@property (copy, NS_NONATOMIC_IOSONLY) NSArray<CNLabeledValue<CNPostalAddress*>*>             *postalAddresses;
+@property (copy, NS_NONATOMIC_IOSONLY) NSArray<CNLabeledValue<NSString*>*>                    *urlAddresses;
+@property (copy, NS_NONATOMIC_IOSONLY) NSArray<CNLabeledValue<CNContactRelation*>*>           *contactRelations;
+@property (copy, NS_NONATOMIC_IOSONLY) NSArray<CNLabeledValue<CNSocialProfile*>*>             *socialProfiles;
+@property (copy, NS_NONATOMIC_IOSONLY) NSArray<CNLabeledValue<CNInstantMessageAddress*>*>     *instantMessageAddresses;
+
+/*! @abstract The Gregorian birthday.
+ *
+ *  @description Only uses day, month and year components. Needs to have at least a day and a month.
+ */
+@property (copy, nullable, NS_NONATOMIC_IOSONLY) NSDateComponents *birthday;
+
+/*! @abstract The alternate birthday (Lunisolar).
+ *
+ *  @description Only uses day, month, year and calendar components. Needs to have at least a day and a month. Calendar must be Chinese, Hebrew or Islamic.
+ */
+@property (copy, nullable, NS_NONATOMIC_IOSONLY) NSDateComponents *nonGregorianBirthday;
+
+/*! @abstract Other Gregorian dates (anniversaries, etc).
+ *
+ *  @description Only uses day, month and year components. Needs to have at least a day and a month.
+ */
+@property (copy, NS_NONATOMIC_IOSONLY) NSArray<CNLabeledValue<NSDateComponents*>*> *dates;
+
+@end
+
+NS_ASSUME_NONNULL_END

package/sdk/ios/System/Library/Frameworks/Contacts.framework/Headers/CNMutableGroup.h

@@ -0,0 +1,25 @@
+//
+//  CNMutableGroup.h
+//  Contacts
+//
+//  Copyright (c) 2015–2019 Apple Inc. All rights reserved.
+//
+
+#import <Contacts/CNGroup.h>
+
+NS_ASSUME_NONNULL_BEGIN
+
+
+/*!
+ * @abstract A mutable value object representing a group.
+ *
+ * @discussion CNMutableGroup is not thread safe.
+ */
+NS_CLASS_AVAILABLE(10_11, 9_0)
+@interface CNMutableGroup : CNGroup
+
+@property (copy, NS_NONATOMIC_IOSONLY) NSString *name;
+
+@end
+
+NS_ASSUME_NONNULL_END

package/sdk/ios/System/Library/Frameworks/Contacts.framework/Headers/CNMutablePostalAddress.h

@@ -0,0 +1,35 @@
+//
+//  CNMutablePostalAddress.h
+//  Contacts
+//
+//  Copyright (c) 2015 Apple Inc. All rights reserved.
+//
+
+#import <Contacts/CNPostalAddress.h>
+
+NS_ASSUME_NONNULL_BEGIN
+
+
+/*!
+ * @abstract A mutable value object representing a postal address.
+ *
+ * @discussion CNMutablePostalAddress is not thread safe.
+ *
+ * @note To remove properties when saving a mutable postal address, set string properties to empty values.
+ */
+NS_CLASS_AVAILABLE(10_11, 9_0)
+@interface CNMutablePostalAddress : CNPostalAddress
+
+/*! multi-street address is delimited with carriage returns “\n” */
+@property (copy, NS_NONATOMIC_IOSONLY) NSString *street;
+@property (copy, NS_NONATOMIC_IOSONLY) NSString *subLocality            NS_AVAILABLE(10_12_4, 10_3);
+@property (copy, NS_NONATOMIC_IOSONLY) NSString *city;
+@property (copy, NS_NONATOMIC_IOSONLY) NSString *subAdministrativeArea  NS_AVAILABLE(10_12_4, 10_3);
+@property (copy, NS_NONATOMIC_IOSONLY) NSString *state;
+@property (copy, NS_NONATOMIC_IOSONLY) NSString *postalCode;
+@property (copy, NS_NONATOMIC_IOSONLY) NSString *country;
+@property (copy, NS_NONATOMIC_IOSONLY) NSString *ISOCountryCode;
+
+@end
+
+NS_ASSUME_NONNULL_END

package/sdk/ios/System/Library/Frameworks/Contacts.framework/Headers/CNPhoneNumber.h

@@ -0,0 +1,44 @@
+//
+//  CNPhoneNumber.h
+//  Contacts
+//
+//  Copyright (c) 2015 Apple Inc. All rights reserved.
+//
+
+#import <Foundation/Foundation.h>
+#import <Contacts/ContactsDefines.h>
+
+NS_ASSUME_NONNULL_BEGIN
+
+
+/*!
+ * @abstract An immutable value object representing a phone number.
+ *
+ * @discussion CNPhoneNumber is thread safe.
+ */
+NS_CLASS_AVAILABLE(10_11, 9_0)
+@interface CNPhoneNumber : NSObject <NSCopying, NSSecureCoding>
+
+/*! These will return nil if the stringValue is nil. */
++ (nullable instancetype)phoneNumberWithStringValue:(NSString *)stringValue;
+- (nullable instancetype)initWithStringValue:(NSString *)string;
+
+- (null_unspecified instancetype)init NS_DEPRECATED(10_11, 10_13, 9_0, 11_0, "Use initWithStringValue:");
++ (null_unspecified instancetype)new  NS_DEPRECATED(10_11, 10_13, 9_0, 11_0, "Use phoneNumberWithStringValue:");
+
+@property (readonly, copy, NS_NONATOMIC_IOSONLY) NSString *stringValue;
+
+@end
+
+
+// Phone number labels
+CONTACTS_EXTERN NSString * const CNLabelPhoneNumberiPhone                NS_AVAILABLE(10_11, 9_0);
+CONTACTS_EXTERN NSString * const CNLabelPhoneNumberAppleWatch            API_AVAILABLE(macos(11.1), ios(14.3), watchos(7.2));
+CONTACTS_EXTERN NSString * const CNLabelPhoneNumberMobile                NS_AVAILABLE(10_11, 9_0);
+CONTACTS_EXTERN NSString * const CNLabelPhoneNumberMain                  NS_AVAILABLE(10_11, 9_0);
+CONTACTS_EXTERN NSString * const CNLabelPhoneNumberHomeFax               NS_AVAILABLE(10_11, 9_0);
+CONTACTS_EXTERN NSString * const CNLabelPhoneNumberWorkFax               NS_AVAILABLE(10_11, 9_0);
+CONTACTS_EXTERN NSString * const CNLabelPhoneNumberOtherFax              NS_AVAILABLE(10_11, 9_0);
+CONTACTS_EXTERN NSString * const CNLabelPhoneNumberPager                 NS_AVAILABLE(10_11, 9_0);
+
+NS_ASSUME_NONNULL_END

package/sdk/ios/System/Library/Frameworks/Contacts.framework/Headers/CNPostalAddress.h

@@ -0,0 +1,50 @@
+//
+//  CNPostalAddress.h
+//  Contacts
+//
+//  Copyright (c) 2015 Apple Inc. All rights reserved.
+//
+
+#import <Foundation/Foundation.h>
+#import <Contacts/ContactsDefines.h>
+
+NS_ASSUME_NONNULL_BEGIN
+
+
+/*!
+ * @abstract An immutable value object representing a postal address.
+ *
+ * @discussion CNPostalAddress is thread safe.
+ */
+NS_CLASS_AVAILABLE(10_11, 9_0)
+NS_SWIFT_SENDABLE
+@interface CNPostalAddress : NSObject <NSCopying, NSMutableCopying, NSSecureCoding>
+
+/*! multi-street address is delimited with carriage returns “\n” */
+@property (readonly, copy, NS_NONATOMIC_IOSONLY) NSString *street;
+@property (readonly, copy, NS_NONATOMIC_IOSONLY) NSString *subLocality              NS_AVAILABLE(10_12_4, 10_3);
+@property (readonly, copy, NS_NONATOMIC_IOSONLY) NSString *city;
+@property (readonly, copy, NS_NONATOMIC_IOSONLY) NSString *subAdministrativeArea    NS_AVAILABLE(10_12_4, 10_3);
+@property (readonly, copy, NS_NONATOMIC_IOSONLY) NSString *state;
+@property (readonly, copy, NS_NONATOMIC_IOSONLY) NSString *postalCode;
+@property (readonly, copy, NS_NONATOMIC_IOSONLY) NSString *country;
+@property (readonly, copy, NS_NONATOMIC_IOSONLY) NSString *ISOCountryCode;
+
+/*! Returns a user displayable property name. */
++ (NSString *)localizedStringForKey:(NSString *)key;
+
+@end
+
+
+// Properties that are always fetched. Can be used with key value coding and observing.
+CONTACTS_EXTERN NSString * const CNPostalAddressStreetKey                            NS_AVAILABLE(10_11, 9_0);
+CONTACTS_EXTERN NSString * const CNPostalAddressSubLocalityKey                       NS_AVAILABLE(10_12_4, 10_3);
+CONTACTS_EXTERN NSString * const CNPostalAddressCityKey                              NS_AVAILABLE(10_11, 9_0);
+CONTACTS_EXTERN NSString * const CNPostalAddressSubAdministrativeAreaKey             NS_AVAILABLE(10_12_4, 10_3);
+CONTACTS_EXTERN NSString * const CNPostalAddressStateKey                             NS_AVAILABLE(10_11, 9_0);
+CONTACTS_EXTERN NSString * const CNPostalAddressPostalCodeKey                        NS_AVAILABLE(10_11, 9_0);
+CONTACTS_EXTERN NSString * const CNPostalAddressCountryKey                           NS_AVAILABLE(10_11, 9_0);
+CONTACTS_EXTERN NSString * const CNPostalAddressISOCountryCodeKey                    NS_AVAILABLE(10_11, 9_0);
+
+
+NS_ASSUME_NONNULL_END

package/sdk/ios/System/Library/Frameworks/Contacts.framework/Headers/CNPostalAddressFormatter.h

@@ -0,0 +1,91 @@
+//
+//  CNPostalAddressFormatter.h
+//  Contacts
+//
+//  Copyright (c) 2015–2016 Apple Inc. All rights reserved.
+//
+
+#import <Foundation/Foundation.h>
+#import <Contacts/ContactsDefines.h>
+
+NS_ASSUME_NONNULL_BEGIN
+
+@class CNPostalAddress;
+
+
+/*!
+ * @abstract The formatting styles for postal addresses.
+ */
+typedef NS_ENUM(NSInteger, CNPostalAddressFormatterStyle)
+{
+    /*! Combine the postal address components into a multi-line mailing address. */
+    CNPostalAddressFormatterStyleMailingAddress,
+} NS_ENUM_AVAILABLE(10_11, 9_0);
+
+
+/*!
+ * @abstract Formats a postal address.
+ *
+ * @discussion This formatter handles international formatting of a postal address.
+ */
+NS_CLASS_AVAILABLE(10_11, 9_0)
+@interface CNPostalAddressFormatter : NSFormatter
+
+/*!
+ * @abstract Formats the postal address.
+ *
+ * @param postalAddress The postal address to be formatted.
+ * @param style The formatting style to be used for the postal address.
+ * @return The formatted postal address.
+ */
++ (NSString *)stringFromPostalAddress:(CNPostalAddress *)postalAddress style:(CNPostalAddressFormatterStyle)style;
+
+
+/*!
+ * @abstract Formats the postal address returning an attributed string.
+ *
+ * @discussion This behaves like +stringFromPostalAddress: except it returns an attributed string. Includes attribute keys CNPostalAddressPropertyAttribute and CNPostalAddressLocalizedPropertyNameAttribute.
+ *
+ * @param postalAddress The postal address to be formatted.
+ * @param style The formatting style to be used for the postal address.
+ * @param attributes The default attributes to use. See NSFormatter for details.
+ * @return The formatted postal address as an attributed string.
+ */
++ (NSAttributedString *)attributedStringFromPostalAddress:(CNPostalAddress *)postalAddress style:(CNPostalAddressFormatterStyle)style withDefaultAttributes:(NSDictionary *)attributes;
+
+/*!
+ * @abstract The style for a postal address formatter instance.
+ *
+ * @discussion The default value is CNPostalAddressFormatterStyleMailingAddress.
+ */
+@property (NS_NONATOMIC_IOSONLY) CNPostalAddressFormatterStyle style;
+
+/*!
+ * @abstract Formats the postal address.
+ *
+ * @param postalAddress The postal address to be formatted.
+ * @return The formatted postal address.
+ */
+- (NSString *)stringFromPostalAddress:(CNPostalAddress *)postalAddress;
+
+/*!
+ * @abstract Formats the postal address returning an attributed string.
+ *
+ * @discussion This behaves like +stringFromPostalAddress: except it returns an attributed string. Includes attribute keys CNPostalAddressPropertyAttribute and CNPostalAddressLocalizedPropertyNameAttribute.
+ *
+ * @param postalAddress The postal address to be formatted.
+ * @param attributes The default attributes to use. See NSFormatter for details.
+ * @return The formatted postal address as an attributed string.
+ */
+- (NSAttributedString *)attributedStringFromPostalAddress:(CNPostalAddress *)postalAddress withDefaultAttributes:(NSDictionary *)attributes;
+
+@end
+
+
+// Attribute key whose value is a CNPostalAddress property key.
+CONTACTS_EXTERN NSString * const CNPostalAddressPropertyAttribute;
+
+// Attribute key whose value is a localized version of the CNPostalAddress property key.
+CONTACTS_EXTERN NSString * const CNPostalAddressLocalizedPropertyNameAttribute;
+
+NS_ASSUME_NONNULL_END

package/sdk/ios/System/Library/Frameworks/Contacts.framework/Headers/CNSaveRequest.h

@@ -0,0 +1,136 @@
+//
+//  CNSaveRequest.h
+//  Contacts
+//
+//  Copyright (c) 2015 Apple Inc. All rights reserved.
+//
+
+#import <Foundation/Foundation.h>
+
+NS_ASSUME_NONNULL_BEGIN
+
+@class CNContact, CNMutableContact, CNGroup, CNMutableGroup;
+
+
+/*!
+ * @abstract Specifies the changes to save.
+ *
+ * @discussion Create a new save request for each save execution on the contact store. Can have many changes batched into one save request. Do not access objects in the save request when it is executing.  A save request only applies the changes to the objects. If there are overlapping changes with multiple, concurrent CNSaveRequests then the last saved change wins.
+ *
+ * If adding an object (contact, group, container) and it is already in the contact store then the executing save request will fail to add that object and will return the error CNErrorCodeInsertedRecordAlreadyExists with CNErrorUserInfoAffectedRecordsKey value as an array containing that object.
+ *
+ * If updating/deleting an object (contact, group, container) and it is not in the contact store then the executing save request will fail to update/delete that object and will return the error CNErrorCodeRecordDoesNotExist with CNErrorUserInfoAffectedRecordsKey value as an array containing that object.
+ *
+ */
+API_AVAILABLE(macos(10.11), ios(9)) __WATCHOS_PROHIBITED
+@interface CNSaveRequest : NSObject
+
+/*!
+ * @abstract Add a new contact to the contact store.
+ *
+ * @discussion The contact may be modified by the executing save request. If the contact was previously specified to be deleted in the save request that will no longer occur.
+ *
+ * @param contact The new contact to add.
+ * @param identifier The container identifier to add the new contact to. Set to nil for the default container.
+ */
+- (void)addContact:(CNMutableContact *)contact toContainerWithIdentifier:(nullable NSString *)identifier;
+
+/*!
+ * @abstract Update an existing contact in the contact store.
+ *
+ * @discussion The contact must already exist in the contact store. The contact may be modified by the executing save request.
+ */
+- (void)updateContact:(CNMutableContact *)contact;
+
+/*!
+ * @abstract Delete a contact from the contact store.
+ *
+ * @discussion If the contact was previously specified to be added in the save request that will no longer occur.
+ */
+- (void)deleteContact:(CNMutableContact *)contact;
+
+/*!
+ * @abstract Add a new group to the contact store.
+ *
+ * @discussion If the group was previously specified to be deleted in the save request that will no longer occur.
+ *
+ * @param group The new group to add.
+ * @param identifier The container identifier to add the new group to. Set to nil for the default container.
+ */
+- (void)addGroup:(CNMutableGroup *)group toContainerWithIdentifier:(nullable NSString *)identifier;
+
+/*!
+ * @abstract Update an existing group in the contact store.
+ *
+ * @discussion The group must already exist in the contact store.
+ */
+- (void)updateGroup:(CNMutableGroup *)group;
+
+/*!
+ * @abstract Delete a group from the contact store.
+ *
+ * @discussion The contacts in the group are not deleted. If the group was previously specified to be added in the save request that will no longer occur.
+ */
+- (void)deleteGroup:(CNMutableGroup *)group;
+
+/*!
+ * @abstract Add a new subgroup to a group.
+ *
+ * @discussion If the subgroup was previously specified to be deleted in the save request that will no longer occur.
+ *
+ * @param subgroup The new group to add.
+ * @param group The group to add the subgroup to.
+ */
+- (void)addSubgroup:(CNGroup *)subgroup toGroup:(CNGroup *)group API_AVAILABLE(macos(10.11)) API_UNAVAILABLE(ios);
+
+/*!
+ * @abstract Remove a subgroup from a group.
+ *
+ * @discussion The contacts in the subgroup's membership are not affected. If the subgroup was previously specified to be added in the save request that will no longer occur.
+ *
+ * @param subgroup The new group to add.
+ * @param group The group to add the subgroup to.
+ */
+- (void)removeSubgroup:(CNGroup *)subgroup fromGroup:(CNGroup *)group API_AVAILABLE(macos(10.11)) API_UNAVAILABLE(ios);
+
+/*!
+ * @abstract Add a new member to a group.
+ *
+ * @discussion If the membership was previously specified to be deleted in the save request that will no longer occur.
+ *
+ * @param contact The new member to add to the group.
+ * @param group The group to add the member to.
+ */
+- (void)addMember:(CNContact *)contact toGroup:(CNGroup *)group;
+
+/*!
+ * @abstract Remove a member from a group.
+ *
+ * @discussion The contact is not deleted. It is only removed as a member of the group. If the membership was previously specified to be added in the save request that will no longer occur.
+ *
+ * @param contact The member to remove from the group.
+ * @param group The group to remove the member from.
+ */
+- (void)removeMember:(CNContact *)contact fromGroup:(CNGroup *)group;
+
+/*!
+ * @abstract    The author of this transaction.
+ *
+ * @discussion  Use this, in conjunction with @c CNChangeHistoryFetchRequest.excludedTransactionAuthors,
+ *              to suppress fetching of changes the author already knows about.
+ */
+@property (copy, nonatomic, nullable) NSString *transactionAuthor API_AVAILABLE(macos(12), ios(15));
+
+/*!
+ * @abstract    Should the contacts be refetched as part of executing the save request.
+ *
+ * @discussion  Default is `YES` where added and updated contacts are refetched by the executing save request.
+ *              Set to `NO` to suppress this refetch behavior and reduce the execution time of the save request.
+ *
+ * @note        If set to `NO` do not use the contacts after the executed save request as they may not be in a current state.
+ */
+@property (assign, nonatomic) BOOL shouldRefetchContacts API_AVAILABLE(macos(12.3), ios(15.4));
+
+@end
+
+NS_ASSUME_NONNULL_END

package/sdk/ios/System/Library/Frameworks/Contacts.framework/Headers/CNSocialProfile.h

@@ -0,0 +1,55 @@
+//
+//  CNSocialProfile.h
+//  Contacts
+//
+//  Copyright (c) 2015 Apple Inc. All rights reserved.
+//
+
+#import <Foundation/Foundation.h>
+#import <Contacts/ContactsDefines.h>
+
+NS_ASSUME_NONNULL_BEGIN
+
+
+/*!
+ * @abstract An immutable value object representing a social profile.
+ *
+ * @discussion CNSocialProfile is thread safe.
+ */
+NS_CLASS_AVAILABLE(10_11, 9_0)
+@interface CNSocialProfile : NSObject <NSCopying, NSSecureCoding>
+
+@property (readonly, copy, NS_NONATOMIC_IOSONLY) NSString *urlString;
+@property (readonly, copy, NS_NONATOMIC_IOSONLY) NSString *username;
+@property (readonly, copy, NS_NONATOMIC_IOSONLY) NSString *userIdentifier;
+@property (readonly, copy, NS_NONATOMIC_IOSONLY) NSString *service;
+
+- (instancetype)initWithUrlString:(nullable NSString *)urlString username:(nullable NSString *)username userIdentifier:(nullable NSString *)userIdentifier service:(nullable NSString *)service;
+
+/*! Returns a user displayable property name. */
++ (NSString *)localizedStringForKey:(NSString *)key;
+
+/*! Returns a user displayable service name. */
++ (NSString* )localizedStringForService:(NSString *)service;
+
+@end
+
+
+// Properties that are always fetched. Can be used with key value coding and observing.
+CONTACTS_EXTERN NSString * const CNSocialProfileURLStringKey                     NS_AVAILABLE(10_11, 9_0);
+CONTACTS_EXTERN NSString * const CNSocialProfileUsernameKey                      NS_AVAILABLE(10_11, 9_0);
+CONTACTS_EXTERN NSString * const CNSocialProfileUserIdentifierKey                NS_AVAILABLE(10_11, 9_0);
+CONTACTS_EXTERN NSString * const CNSocialProfileServiceKey                       NS_AVAILABLE(10_11, 9_0);
+
+// Social profile services.
+CONTACTS_EXTERN NSString * const CNSocialProfileServiceFacebook                  NS_AVAILABLE(10_11, 9_0);
+CONTACTS_EXTERN NSString * const CNSocialProfileServiceFlickr                    NS_AVAILABLE(10_11, 9_0);
+CONTACTS_EXTERN NSString * const CNSocialProfileServiceLinkedIn                  NS_AVAILABLE(10_11, 9_0);
+CONTACTS_EXTERN NSString * const CNSocialProfileServiceMySpace                   NS_AVAILABLE(10_11, 9_0);
+CONTACTS_EXTERN NSString * const CNSocialProfileServiceSinaWeibo                 NS_AVAILABLE(10_11, 9_0);
+CONTACTS_EXTERN NSString * const CNSocialProfileServiceTencentWeibo              NS_AVAILABLE(10_11, 9_0);
+CONTACTS_EXTERN NSString * const CNSocialProfileServiceTwitter                   NS_AVAILABLE(10_11, 9_0);
+CONTACTS_EXTERN NSString * const CNSocialProfileServiceYelp                      NS_AVAILABLE(10_11, 9_0);
+CONTACTS_EXTERN NSString * const CNSocialProfileServiceGameCenter                NS_AVAILABLE(10_11, 9_0);
+
+NS_ASSUME_NONNULL_END

package/sdk/ios/System/Library/Frameworks/Contacts.framework/Headers/Contacts.apinotes

@@ -0,0 +1,28 @@
+---
+Name: Contacts
+Tags:
+- Name: CNErrorCode
+  NSErrorDomain: CNErrorDomain
+Classes:
+- Name: CNPhoneNumber
+  Methods:
+  - Selector: 'initWithStringValue:'
+    MethodKind: Instance
+    ResultType: "CNPhoneNumber * _Nonnull"
+- Name: CNContactStore
+  Methods:
+  - Selector: 'defaultContainerIdentifier'
+    MethodKind: Instance
+    ResultType: "NSString * _Nonnull"
+
+SwiftVersions:
+  - Version: 4
+    Classes:
+    - Name: CNPhoneNumber
+      Methods:
+      - Selector: 'init'
+        MethodKind: Instance
+        ResultType: "CNPhoneNumber * _Nonnull"
+      - Selector: 'new'
+        MethodKind: Class
+        ResultType: "CNPhoneNumber * _Nonnull"

package/sdk/ios/System/Library/Frameworks/Contacts.framework/Headers/Contacts.h

@@ -0,0 +1,42 @@
+//
+//  Contacts.h
+//  Contacts
+//
+//  Copyright (c) 2015–2019 Apple Inc. All rights reserved.
+//
+
+#import <Contacts/CNContactStore.h>
+#import <Contacts/CNContactFetchRequest.h>
+#import <Contacts/CNFetchResult.h>
+#import <Contacts/CNSaveRequest.h>
+
+#import <Contacts/CNChangeHistoryFetchRequest.h>
+#import <Contacts/CNChangeHistoryEvent.h>
+
+#import <Contacts/CNContact.h>
+#import <Contacts/CNContact+Predicates.h>
+#import <Contacts/CNMutableContact.h>
+#import <Contacts/CNContact+NSItemProvider.h>
+
+#import <Contacts/CNLabeledValue.h>
+#import <Contacts/CNPhoneNumber.h>
+#import <Contacts/CNPostalAddress.h>
+#import <Contacts/CNMutablePostalAddress.h>
+#import <Contacts/CNInstantMessageAddress.h>
+#import <Contacts/CNSocialProfile.h>
+#import <Contacts/CNContactRelation.h>
+
+#import <Contacts/CNGroup.h>
+#import <Contacts/CNGroup+Predicates.h>
+#import <Contacts/CNMutableGroup.h>
+
+#import <Contacts/CNContainer.h>
+#import <Contacts/CNContainer+Predicates.h>
+
+#import <Contacts/CNContactFormatter.h>
+#import <Contacts/CNPostalAddressFormatter.h>
+
+#import <Contacts/CNContactVCardSerialization.h>
+#import <Contacts/CNContactsUserDefaults.h>
+#import <Contacts/CNContactProperty.h>
+#import <Contacts/CNError.h>

package/sdk/ios/System/Library/Frameworks/Contacts.framework/Headers/ContactsDefines.h

@@ -0,0 +1,14 @@
+//
+//  ContactsDefines.h
+//  Contacts
+//
+//  Copyright (c) 2015 Apple Inc. All rights reserved.
+//
+
+#import <Availability.h>
+
+#ifdef __cplusplus
+#define CONTACTS_EXTERN extern "C" __attribute__((visibility ("default")))
+#else
+#define CONTACTS_EXTERN extern __attribute__((visibility ("default")))
+#endif

package/sdk/ios/System/Library/Frameworks/Contacts.framework/Modules/module.modulemap

@@ -0,0 +1,5 @@
+framework module Contacts {
+  umbrella header "Contacts.h"
+  export *
+  module * { export * }
+}