peachsim 0.1.2176 → 0.1.2179

package/sdk/ios/System/Library/Frameworks/EventKit.framework/Headers/EKCalendarItem.h

@@ -0,0 +1,129 @@
+//
+//  EKCalendarItem.h
+//  EventKit
+//
+//  Copyright 2010 Apple Inc. All rights reserved.
+//
+
+#import <EventKit/EKObject.h>
+#import <EventKit/EventKitDefines.h>
+
+NS_ASSUME_NONNULL_BEGIN
+
+@class EKRecurrenceRule, EKAlarm, EKCalendar, EKParticipant;
+
+NS_CLASS_AVAILABLE(10_8, 5_0)
+@interface EKCalendarItem : EKObject
+
+/*!
+    @property   UUID
+    @discussion This is now deprecated; use calendarItemIdentifier instead.
+ */
+@property(nonatomic, readonly) NSString *UUID NS_DEPRECATED(NA, NA, 5_0, 6_0)
+#if defined(TARGET_OS_VISION) && TARGET_OS_VISION
+API_UNAVAILABLE(visionos)
+#endif
+;
+
+/*!
+    @property calendar
+    @abstract The calendar that this calendar item belongs to.
+    @discussion This will be nil for new calendar items until you set it.
+ */
+@property(nonatomic, strong, null_unspecified) EKCalendar *calendar;
+
+/*!
+    @property   calendarItemIdentifier
+    @abstract   A unique identifier for a calendar item.
+    @discussion Item identifiers are not sync-proof in that a full sync will lose
+                this identifier, so you should always have a back up plan for dealing
+                with a reminder that is no longer fetchable by this property, e.g. by title, etc.
+                Use [EKEventStore calendarItemWithIdentifier:] to look up the item by this value.
+*/
+@property(nonatomic, readonly) NSString *calendarItemIdentifier NS_AVAILABLE(10_8, 6_0);
+
+/*!
+    @property   calendarItemExternalIdentifier
+    @abstract   A server-provided identifier for this calendar item
+    @discussion This identifier, provided by the server, allows you to reference the same event or reminder across
+                multiple devices. For calendars stored locally on the device, including the birthday calendar,
+                it simply passes through to calendarItemIdentifier.
+ 
+                This identifier is unique as of creation for every calendar item.  However, there are some
+                cases where duplicate copies of a calendar item can exist in the same database, including:
+                - A calendar item was imported from an ICS file into multiple calendars
+                - An event was created in a calendar shared with the user and the user was also invited to the event
+                - The user is a delegate of a calendar that also has this event
+                - A subscribed calendar was added to multiple accounts
+                In such cases, you should choose between calendar items based on other factors, such as
+                the calendar or source.
+
+                This identifier is the same for all occurrences of a recurring event. If you wish to differentiate
+                between occurrences, you may want to use the start date.
+ 
+                This may be nil for new calendar items that do not yet belong to a calendar.
+ 
+                In addition, there are two caveats for Exchange-based calendars:
+                - This identifier will be different between EventKit on iOS versus OS X
+                - This identifier will be different between devices for EKReminders
+*/
+@property(nonatomic, readonly, null_unspecified) NSString *calendarItemExternalIdentifier NS_AVAILABLE(10_8, 6_0);
+
+/*!
+    @property title
+    @abstract The title of this calendar item.
+    @discussion This will be an empty string for new calendar items until you set it.
+ */
+@property(nonatomic, copy, null_unspecified) NSString *title;
+@property(nonatomic, copy, nullable) NSString *location;
+@property(nonatomic, copy, nullable) NSString *notes;
+@property(nonatomic, copy, nullable) NSURL *URL NS_AVAILABLE(10_8, 5_0);
+
+@property(nonatomic, readonly, nullable) NSDate *lastModifiedDate;
+@property(nonatomic, readonly, nullable, strong) NSDate *creationDate NS_AVAILABLE(10_8, 5_0);
+@property(nonatomic, copy, nullable) NSTimeZone *timeZone  NS_AVAILABLE(10_8, 5_0);
+
+// These exist to do simple checks for the presence of data without
+// loading said data. While at present only hasRecurrenceRules has a
+// fast path, it is a good idea to use these if you only need to know
+// the data exists anyway since at some point they will all be a
+// simple check.
+@property(nonatomic, readonly) BOOL hasAlarms  NS_AVAILABLE(10_8, 5_0);
+@property(nonatomic, readonly) BOOL hasRecurrenceRules  NS_AVAILABLE(10_8, 5_0);
+@property(nonatomic, readonly) BOOL hasAttendees  NS_AVAILABLE(10_8, 5_0);
+@property(nonatomic, readonly) BOOL hasNotes  NS_AVAILABLE(10_8, 5_0);
+
+// An array of EKParticipant objects
+@property(nonatomic, readonly, nullable) NSArray<__kindof EKParticipant *> *attendees;
+
+
+// An array of EKAlarm objects
+@property(nonatomic, copy, nullable) NSArray<EKAlarm *> *alarms;
+
+/*!
+    @method     addAlarm:
+    @abstract   Adds an alarm to this item.
+    @discussion This method add an alarm to an item. Be warned that some calendars can only
+                allow a certain maximum number of alarms. When this item is saved, it will
+                truncate any extra alarms from the array.
+*/
+- (void)addAlarm:(EKAlarm *)alarm;
+
+/*!
+    @method     removeAlarm:
+    @abstract   Removes an alarm from this item.
+*/
+- (void)removeAlarm:(EKAlarm *)alarm;
+
+/*!
+    @property   recurrenceRules
+    @abstract   An array of EKRecurrenceRules, or nil if none.
+*/
+@property(nonatomic, copy, nullable) NSArray<EKRecurrenceRule *> *recurrenceRules NS_AVAILABLE(10_8, 5_0);
+
+- (void)addRecurrenceRule:(EKRecurrenceRule *)rule;
+- (void)removeRecurrenceRule:(EKRecurrenceRule *)rule;
+
+@end
+
+NS_ASSUME_NONNULL_END

package/sdk/ios/System/Library/Frameworks/EventKit.framework/Headers/EKError.h

@@ -0,0 +1,105 @@
+//
+//  EKError.h
+//  EventKit
+//
+//  Copyright 2009-2010 Apple Inc. All rights reserved.
+//
+
+#import <Foundation/Foundation.h>
+#import <EventKit/EventKitDefines.h>
+
+/*!
+    @const      EKErrorDomain 
+    @abstract   Error domain for NSError values stemming from the EventKit Framework API.
+    @discussion This error domain is used as the domain for all NSError instances stemming from the
+                EventKit Framework.
+*/
+EVENTKIT_EXTERN NSString *const EKErrorDomain NS_AVAILABLE(10_8, 4_0);
+
+/*!
+    @enum       EKErrorCode
+    @abstract   Error codes for NSError values stemming from the Calendar Framework.
+    @discussion These error codes are used as the codes for all NSError instances stemmming from the
+                Calendar Framework.
+ 
+    @constant   EKErrorEventNotMutable                  The event is not mutable and cannot be saved/deleted.
+    @constant   EKErrorNoCalendar                       The event has no calendar set.
+    @constant   EKErrorNoStartDate                      The event has no start date set.
+    @constant   EKErrorNoEndDate                        The event has no end date set.
+    @constant   EKErrorDatesInverted                    The end date is before the start date.
+    @constant   EKErrorInternalFailure                  An internal error occurred.
+    @constant   EKErrorCalendarReadOnly                 Calendar can not have events added to it.
+    @constant   EKErrorDurationGreaterThanRecurrence    The duration of an event is greater than the recurrence interval.
+    @constant   EKErrorAlarmGreaterThanRecurrence       The alarm interval is greater than the recurrence interval
+    @constant   EKErrorStartDateTooFarInFuture          The start date is further into the future than the calendar will display.
+    @constant   EKErrorStartDateCollidesWithOtherOccurrence The start date specified collides with another occurrence of that event, and the current calendar doesn't allow it.
+    @constant   EKErrorObjectBelongsToDifferentStore    The object you are passing doesn't belong to the calendar store you're dealing with.
+    @constant   EKErrorInvitesCannotBeMoved             The event is an invite, and therefore cannot move to another calendar.
+    @constant   EKErrorInvalidSpan                      An invalid span was passed when saving/deleting.
+    @constant   EKErrorCalendarHasNoSource              An attempt to save a calendar with no source set was made.
+    @constant   EKErrorCalendarSourceCannotBeModified   The calendar cannot be moved to another source.
+    @constant   EKErrorCalendarIsImmutable              The calendar is immutable and cannot be modified or deleted.
+    @constant   EKErrorSourceDoesNotAllowCalendarAddDelete   Some sources (accounts) do not allow calendars to be added or removed.
+    @constant   EKErrorRecurringReminderRequiresDueDate A recurring reminder requires a due date.
+    @constant   EKErrorStructuredLocationsNotSupported  The source this calendar belongs to does not support structured locations.
+    @constant   EKErrorReminderLocationsNotSupported    This source doesn't support locations on Reminders.
+    @constant   EKErrorAlarmProximityNotSupported       This source doesn't allow alarm proximity (geofencing).
+    @constant   EKErrorCalendarDoesNotAllowEvents       You are trying to add an event to a calendar that does not allow events.
+    @constant   EKErrorCalendarDoesNotAllowReminders    You are trying to add a reminder to a calendar that does not allow reminders.
+    @constant   EKErrorSourceDoesNotAllowReminders      You are trying to add a calendar that allows reminders to a source that does not allow them.
+    @constant   EKErrorSourceDoesNotAllowEvents         You are trying to add a calendar that allows events to a source that does not allow them.
+    @constant   EKErrorPriorityIsInvalid                You have set an invalid priority for a reminder.  Priorities must be between 0 and 9.
+    @constant   EKErrorInvalidEntityType                This is not a valid EKEntityType
+    @constant   EKErrorProcedureAlarmsNotMutable        Procedure alarms may not be created or modified.
+    @constant   EKErrorEventStoreNotAuthorized          The user has not authorized your application to access their events and/or reminders.
+    @constant   EKErrorOSNotSupported                   The action is not supported on the current operating system.
+    @constant   EKErrorInvalidCalendar                  The given calendar is invalid or nil.
+    @constant   EKErrorNotificationsCollectionFlagNotSet  The given notification collection does not have the EKNotificationsCollectionFlag set.
+    @constant   EKErrorSourceMismatch                     The source for an object does not match its containers source.
+    @constant   EKErrorNotificationCollectionMismatch     The notification collection containing a given notification does not match the collection we are trying to save.
+    @constant   EKErrorNotificationSavedWithoutCollection The notification is being saved without first adding it to a notification collection and saving the collection.
+*/
+
+#if __IPHONE_4_0 <= __IPHONE_OS_VERSION_MAX_ALLOWED || !TARGET_OS_IPHONE
+typedef NS_ENUM(NSInteger, EKErrorCode) {
+    EKErrorEventNotMutable,
+    EKErrorNoCalendar,
+    EKErrorNoStartDate,
+    EKErrorNoEndDate,
+    EKErrorDatesInverted,
+    EKErrorInternalFailure,
+    EKErrorCalendarReadOnly,
+    EKErrorDurationGreaterThanRecurrence,
+    EKErrorAlarmGreaterThanRecurrence,
+    EKErrorStartDateTooFarInFuture,
+    EKErrorStartDateCollidesWithOtherOccurrence,
+    EKErrorObjectBelongsToDifferentStore,
+    EKErrorInvitesCannotBeMoved,
+    EKErrorInvalidSpan,
+    EKErrorCalendarHasNoSource,
+    EKErrorCalendarSourceCannotBeModified,
+    EKErrorCalendarIsImmutable,
+    EKErrorSourceDoesNotAllowCalendarAddDelete,
+    EKErrorRecurringReminderRequiresDueDate,
+    EKErrorStructuredLocationsNotSupported,
+    EKErrorReminderLocationsNotSupported,
+    EKErrorAlarmProximityNotSupported,
+    EKErrorCalendarDoesNotAllowEvents,
+    EKErrorCalendarDoesNotAllowReminders,
+    EKErrorSourceDoesNotAllowReminders,
+    EKErrorSourceDoesNotAllowEvents,
+    EKErrorPriorityIsInvalid,
+    EKErrorInvalidEntityType,
+    EKErrorProcedureAlarmsNotMutable,
+    EKErrorEventStoreNotAuthorized,
+    EKErrorOSNotSupported,
+    EKErrorInvalidInviteReplyCalendar,
+    EKErrorNotificationsCollectionFlagNotSet,
+    EKErrorSourceMismatch,
+    EKErrorNotificationCollectionMismatch,
+    EKErrorNotificationSavedWithoutCollection,
+    EKErrorReminderAlarmContainsEmailOrUrl,
+    
+    EKErrorLast // used internally
+};
+#endif

package/sdk/ios/System/Library/Frameworks/EventKit.framework/Headers/EKEvent.h

@@ -0,0 +1,205 @@
+//
+//  EKEvent.h
+//  EventKit
+//
+//  Copyright 2009-2010 Apple Inc. All rights reserved.
+//
+
+#import <Foundation/Foundation.h>
+#import <EventKit/EventKitDefines.h>
+#import <EventKit/EKCalendarItem.h>
+
+NS_ASSUME_NONNULL_BEGIN
+
+@class EKEventStore, EKCalendar, EKRecurrenceRule, EKAlarm, EKParticipant, EKStructuredLocation;
+
+typedef NS_ENUM(NSInteger, EKEventAvailability) {
+    EKEventAvailabilityNotSupported = -1,
+    EKEventAvailabilityBusy = 0,
+    EKEventAvailabilityFree,
+    EKEventAvailabilityTentative,
+    EKEventAvailabilityUnavailable
+};
+
+typedef NS_ENUM(NSInteger, EKEventStatus) {
+    EKEventStatusNone = 0,
+    EKEventStatusConfirmed,
+    EKEventStatusTentative,
+    EKEventStatusCanceled,
+};
+
+
+/*!
+    @class      EKEvent
+    @abstract   The EKEvent class represents an occurrence of an event.
+*/
+NS_CLASS_AVAILABLE(10_8, 4_0)
+@interface EKEvent : EKCalendarItem
+
+/*!
+    @method     eventWithEventStore:
+    @abstract   Creates a new autoreleased event object.
+*/
++ (EKEvent *)eventWithEventStore:(EKEventStore *)eventStore;
+
+/*!
+    @property   eventIdentifier
+    @abstract   A unique identifier for this event.
+    @discussion This identifier can be used to look the event up using [EKEventStore eventWithIdentifier:].
+                You can use this not only to simply fetch the event, but also to validate the event
+                has not been deleted out from under you when you get an external change notification
+                via the EKEventStore database changed notification. If eventWithIdentifier: returns nil,
+                the event was deleted.
+
+                Please note that if you change the calendar of an event, this ID will likely change. It is
+                currently also possible for the ID to change due to a sync operation. For example, if
+                a user moved an event on a different client to another calendar, we'd see it as a 
+                completely new event here.
+ 
+                This may be nil for events that have not been saved.
+*/
+@property(null_unspecified, nonatomic, readonly) NSString *eventIdentifier;
+
+/*!
+    @property   allDay
+    @abstract   Indicates this event is an 'all day' event.
+*/
+@property(nonatomic, getter=isAllDay) BOOL allDay;
+
+/*!
+     @property   startDate
+     @abstract   The start date for the event.
+     @discussion This property represents the start date for this event. Floating events (such
+                 as all-day events) are currently always returned in the default time zone.
+                 ([NSTimeZone defaultTimeZone])
+
+                 This will be nil for new events until you set it.
+ */
+@property(null_unspecified, nonatomic, copy) NSDate *startDate;
+
+/*!
+    @property   endDate
+    @abstract   The end date for the event.
+    @discussion This will be nil for new events until you set it.
+*/
+
+@property(null_unspecified, nonatomic, copy) NSDate *endDate;
+
+
+/*!
+    @property   structuredLocation
+    @abstract   Allows you to set a structured location (a location with a potential geo-coordinate) on an
+                event. The getter for EKEvent’s location property just returns the structured location’s title.
+                The setter for EKEvent’s location property is equivalent to
+                [event setStructuredLocation:[EKStructuredLocation locationWithTitle:…]].
+ */
+@property(nonatomic, copy, nullable) EKStructuredLocation *structuredLocation NS_AVAILABLE(10_11, 9_0);
+
+/*!
+    @method     compareStartDateWithEvent
+    @abstract   Comparison function you can pass to sort NSArrays of EKEvents by start date.
+*/
+- (NSComparisonResult)compareStartDateWithEvent:(EKEvent *)other;
+
+/*!
+    @property   organizer
+    @abstract   The organizer of this event, or nil.
+*/
+@property(nonatomic, readonly, nullable) EKParticipant *organizer;
+
+/*!
+    @property   availability
+    @abstract   The availability setting for this event.
+    @discussion The availability setting is used by CalDAV and Exchange servers to indicate
+                how the time should be treated for scheduling. If the calendar the event is
+                currently in does not support event availability, EKEventAvailabilityNotSupported
+                is returned.
+*/
+@property(nonatomic) EKEventAvailability    availability;
+
+/*!
+    @property   status
+    @abstract   The status of the event.
+    @discussion While the status offers four different values in the EKEventStatus enumeration,
+                in practice, the only actionable and reliable status is canceled. Any other status
+                should be considered informational at best. You cannot set this property. If you
+                wish to cancel an event, you should simply remove it using removeEvent:.
+*/
+@property(nonatomic, readonly) EKEventStatus          status;
+
+/*!
+    @property   isDetached
+    @abstract   Represents whether this event is detached from a recurring series.
+    @discussion If this EKEvent is an instance of a repeating event, and an attribute of this 
+                EKEvent has been changed from the default value generated by the repeating event,
+                isDetached will return YES. If the EKEvent is unchanged from its default state, or
+                is not a repeating event, isDetached returns NO.
+*/
+@property(nonatomic, readonly) BOOL isDetached;
+
+/*!
+    @property   occurrenceDate:
+    @abstract   The occurrence date of an event if it is part of a recurring series.
+    @discussion This is only set if the event is part of a recurring series. It returns
+                the date on which this event was originally scheduled to occur. For occurrences
+                that are unmodified from the recurring series, this is the same as the start date.
+                This value will remain the same even if the event has been detached and its start 
+                date has changed. Floating events (such as all-day events) are currently returned
+                in the default time zone. ([NSTimeZone defaultTimeZone])
+ 
+                This will be nil for new events until you set startDate.
+ */
+@property(null_unspecified, nonatomic, readonly) NSDate *occurrenceDate NS_AVAILABLE(10_8, 9_0);
+
+/*!
+     @method     refresh
+     @abstract   Refreshes an event object to ensure it's still valid.
+     @discussion When the database changes, your application is sent an EKEventStoreChangedNotification
+                 note. You should generally consider all EKEvent instances to be invalid as soon as
+                 you receive the notification. However, for events you truly care to keep around, you
+                 can call this method. It ensures the record is still valid by ensuring the event and
+                 start date are still valid. It also attempts to refresh all properties except those
+                 you might have modified. If this method returns NO, the record has been deleted or is
+                 otherwise invalid. You should not continue to use it. If it returns YES, all is still
+                 well, and the record is ready for continued use. You should only call this method on
+                 events that are more critical to keep around if possible, such as an event that is
+                 being actively edited, as this call is fairly heavyweight. Do not use it to refresh
+                 the entire selected range of events you might have had selected. It is mostly pointless
+                 anyway, as recurrence information may have changed.
+*/
+- (BOOL)refresh;
+
+/*!
+    @method     birthdayContactIdentifier
+    @abstract   Specifies the contact identifier of the person this event was created for.
+    @discussion This property is only valid for events in the built-in Birthdays calendar. It specifies
+                the contact identifier (for use with the Contacts framework) of the person this event was
+                created for. For any other type of event, this property returns nil.
+ */
+@property(nonatomic, readonly, nullable) NSString *birthdayContactIdentifier NS_AVAILABLE(10_11, 9_0);
+
+/*!
+    @property   birthdayPersonID
+    @abstract   Specifies the address book ID of the person this event was created for.
+    @discussion  This property is only valid for events in the built-in Birthdays calendar. It specifies
+                the Address Book ID of the person this event was created for. For any other type of event,
+                this property returns -1.
+*/
+@property(nonatomic, readonly) NSInteger birthdayPersonID NS_DEPRECATED_IOS(5_0, 9_0, "Use birthdayContactIdentifier instead")
+#if defined(TARGET_OS_VISION) && TARGET_OS_VISION
+API_UNAVAILABLE(visionos)
+#endif
+;
+
+/*!
+    @property   birthdayPersonUniqueID
+    @abstract   Specifies the address book unique ID of the person this event was created for.
+    @discussion This property is only valid for events in the built-in Birthdays calendar. It specifies
+                the Address Book unique ID of the person this event was created for. For any other type of event,
+                this property returns nil.
+ */
+@property(nonatomic, readonly, nullable) NSString *birthdayPersonUniqueID NS_DEPRECATED_MAC(10_8, 10_11, "Use birthdayContactIdentifier instead");
+
+@end
+
+NS_ASSUME_NONNULL_END