ical-generator 8.1.2-develop.9 → 9.0.0-develop.1

package/dist/index.d.ts

@@ -1,359 +1,508 @@
-/**
- * ical-generator supports [native Date](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Date),
- * [moment.js](https://momentjs.com/) (and [moment-timezone](https://momentjs.com/timezone/), [Day.js](https://day.js.org/en/) and
- * [Luxon](https://moment.github.io/luxon/)'s [DateTime](https://moment.github.io/luxon/docs/class/src/datetime.js~DateTime.html)
- * objects. You can also pass a string which is then passed to javascript's Date internally.
- */
-type ICalDateTimeValue = Date | ICalMomentStub | ICalMomentTimezoneStub | ICalLuxonDateTimeStub | ICalDayJsStub | string;
-interface ICalRepeatingOptions {
-    freq: ICalEventRepeatingFreq;
-    count?: number;
-    interval?: number;
-    until?: ICalDateTimeValue;
-    byDay?: ICalWeekday[] | ICalWeekday;
-    byMonth?: number[] | number;
-    byMonthDay?: number[] | number;
-    bySetPos?: number[] | number;
-    exclude?: ICalDateTimeValue[] | ICalDateTimeValue;
-    startOfWeek?: ICalWeekday;
-}
-type ICalLocation = ICalLocationWithTitle | ICalLocationWithoutTitle;
-interface ICalLocationWithTitle {
-    title: string;
-    address?: string;
-    radius?: number;
-    geo?: ICalGeo;
-}
-interface ICalLocationWithoutTitle {
-    geo: ICalGeo;
-}
-interface ICalGeo {
-    lat: number;
-    lon: number;
-}
-interface ICalOrganizer {
-    name: string;
-    email?: string;
-    mailto?: string;
-    sentBy?: string;
-}
-interface ICalDescription {
-    plain: string;
-    html?: string;
-}
-interface ICalTimezone {
-    name: string | null;
-    generator?: (timezone: string) => string | null;
-}
-interface ICalMomentStub {
-    format(format?: string): string;
-    clone(): ICalMomentStub;
-    utc(): ICalMomentStub;
-    toDate(): Date;
-    isValid(): boolean;
-    toJSON(): string;
-}
-interface ICalMomentTimezoneStub extends ICalMomentStub {
-    clone(): ICalMomentTimezoneStub;
-    utc(): ICalMomentTimezoneStub;
-    tz(): string | undefined;
-    tz(timezone: string): ICalMomentTimezoneStub;
-}
-interface ICalMomentDurationStub {
-    asSeconds(): number;
-}
-interface ICalLuxonDateTimeStub {
-    setZone(zone?: string): ICalLuxonDateTimeStub;
-    zone: {
-        type: string;
-    };
-    toFormat(fmt: string): string;
-    toJSDate(): Date;
-    get isValid(): boolean;
-    toJSON(): string | null;
-}
-interface ICalDayJsStub {
-    tz(zone?: string): ICalDayJsStub;
-    utc(): ICalDayJsStub;
-    format(format?: string): string;
-    toDate(): Date;
-    isValid(): boolean;
-    toJSON(): string;
-}
-interface ICalRRuleStub {
-    between(after: Date, before: Date, inc?: boolean, iterator?: (d: Date, len: number) => boolean): Date[];
-    toString(): string;
-}
-declare enum ICalEventRepeatingFreq {
-    SECONDLY = "SECONDLY",
-    MINUTELY = "MINUTELY",
-    HOURLY = "HOURLY",
-    DAILY = "DAILY",
-    WEEKLY = "WEEKLY",
-    MONTHLY = "MONTHLY",
-    YEARLY = "YEARLY"
-}
-declare enum ICalWeekday {
-    SU = "SU",
-    MO = "MO",
-    TU = "TU",
-    WE = "WE",
-    TH = "TH",
-    FR = "FR",
-    SA = "SA"
+declare enum ICalAttendeeRole {
+    CHAIR = "CHAIR",
+    NON = "NON-PARTICIPANT",
+    OPT = "OPT-PARTICIPANT",
+    REQ = "REQ-PARTICIPANT"
 }
-
-declare enum ICalAlarmType {
-    display = "display",
-    audio = "audio",
-    email = "email"
+declare enum ICalAttendeeStatus {
+    ACCEPTED = "ACCEPTED",
+    DECLINED = "DECLINED",
+    DELEGATED = "DELEGATED",
+    NEEDSACTION = "NEEDS-ACTION",
+    TENTATIVE = "TENTATIVE"
 }
-declare const ICalAlarmRelatesTo: {
-    readonly end: "END";
-    readonly start: "START";
-};
-type ICalAlarmRelatesTo = typeof ICalAlarmRelatesTo[keyof typeof ICalAlarmRelatesTo];
-type ICalAlarmTypeValue = keyof ICalAlarmType;
-interface ICalAttachment {
-    uri: string;
-    mime: string | null;
+declare enum ICalAttendeeType {
+    GROUP = "GROUP",
+    INDIVIDUAL = "INDIVIDUAL",
+    RESOURCE = "RESOURCE",
+    ROOM = "ROOM",
+    UNKNOWN = "UNKNOWN"
 }
-type ICalAlarmData = ICalAlarmBaseData | ICalAlarmTriggerData | ICalAlarmTriggerAfterData | ICalAlarmTriggerBeforeData;
-type ICalAlarmTriggerData = ICalAlarmBaseData & {
-    trigger: number | ICalDateTimeValue;
-};
-type ICalAlarmTriggerAfterData = ICalAlarmBaseData & {
-    triggerAfter: number | ICalDateTimeValue;
-};
-type ICalAlarmTriggerBeforeData = ICalAlarmBaseData & {
-    triggerBefore: number | ICalDateTimeValue;
-};
-interface ICalAlarmBaseData {
-    type?: ICalAlarmType;
-    relatesTo?: ICalAlarmRelatesTo | null;
-    repeat?: ICalAlarmRepeatData | null;
-    attach?: string | ICalAttachment | null;
-    description?: string | null;
-    summary?: string | null;
-    attendees?: ICalAttendee[] | ICalAttendeeData[];
-    x?: {
+interface ICalAttendeeData {
+    delegatedFrom?: ICalAttendee | ICalAttendeeData | null | string;
+    delegatedTo?: ICalAttendee | ICalAttendeeData | null | string;
+    delegatesFrom?: ICalAttendee | ICalAttendeeData | null | string;
+    delegatesTo?: ICalAttendee | ICalAttendeeData | null | string;
+    email: string;
+    mailto?: null | string;
+    name?: null | string;
+    role?: ICalAttendeeRole;
+    rsvp?: boolean | null;
+    sentBy?: null | string;
+    status?: ICalAttendeeStatus | null;
+    type?: ICalAttendeeType | null;
+    x?: [string, string][] | Record<string, string> | {
         key: string;
         value: string;
-    }[] | [string, string][] | Record<string, string>;
-}
-interface ICalAlarmRepeatData {
-    times: number;
-    interval: number;
+    }[];
 }
-interface ICalAlarmJSONData {
-    type: ICalAlarmType;
-    trigger: string | number;
-    relatesTo: ICalAlarmRelatesTo | null;
-    repeat: ICalAlarmRepeatData | null;
-    interval: number | null;
-    attach: ICalAttachment | null;
-    description: string | null;
-    summary: string | null;
-    attendees: ICalAttendee[];
+interface ICalAttendeeJSONData {
+    delegatedFrom: null | string;
+    delegatedTo: null | string;
+    email: string;
+    mailto: null | string;
+    name: null | string;
+    role: ICalAttendeeRole;
+    rsvp: boolean | null;
+    sentBy: null | string;
+    status: ICalAttendeeStatus | null;
+    type: ICalAttendeeType | null;
     x: {
         key: string;
         value: string;
     }[];
 }
 /**
- * Usually you get an {@link ICalAlarm} object like this:
+ * Usually you get an {@link ICalAttendee} object like this:
  *
  * ```javascript
  * import ical from 'ical-generator';
  * const calendar = ical();
  * const event = calendar.createEvent();
- * const alarm = event.createAlarm();
+ * const attendee = event.createAttendee({ email: 'mail@example.com' });
  * ```
  *
- * You can also use the {@link ICalAlarm} object directly:
+ * You can also use the {@link ICalAttendee} object directly:
  *
  * ```javascript
- * import ical, {ICalAlarm} from 'ical-generator';
- * const alarm = new ICalAlarm();
- * event.alarms([alarm]);
+ * import ical, {ICalAttendee} from 'ical-generator';
+ * const attendee = new ICalAttendee({ email: 'mail@example.com' });
+ * event.attendees([attendee]);
  * ```
  */
-declare class ICalAlarm {
+declare class ICalAttendee {
     private readonly data;
-    private readonly event;
+    private readonly parent;
     /**
-     * Constructor of {@link ICalAttendee}. The event reference is required
-     * to query the calendar's timezone and summary when required.
+     * Constructor of {@link ICalAttendee}. The event reference is
+     * required to query the calendar's timezone when required.
      *
-     * @param data Alarm Data
-     * @param event Reference to ICalEvent object
+     * @param data Attendee Data
+     * @param parent Reference to ICalEvent object
      */
-    constructor(data: ICalAlarmData, event: ICalEvent);
+    constructor(data: ICalAttendeeData, parent: ICalAlarm | ICalEvent);
     /**
-     * Get the alarm type
-     * @since 0.2.1
+     * Get the attendee's delegated-from field
+     * @since 0.2.0
      */
-    type(type: ICalAlarmType): this;
+    delegatedFrom(): ICalAttendee | null;
     /**
-     * Set the alarm type. See {@link ICalAlarmType}
-     * for available status options.
-     * @since 0.2.1
+     * Set the attendee's delegated-from field
+     *
+     * Creates a new Attendee if the passed object is not already a
+     * {@link ICalAttendee} object. Will set the `delegatedTo` and
+     * `delegatedFrom` attributes.
+     *
+     * @param delegatedFrom
      */
-    type(): ICalAlarmType;
+    delegatedFrom(delegatedFrom: ICalAttendee | ICalAttendeeData | null | string): this;
     /**
-     * Get the trigger time for the alarm. Can either
-     * be a date and time value ({@link ICalDateTimeValue}) or
-     * a number, which will represent the seconds between
-     * alarm and event start. The number is negative, if the
-     * alarm is triggered after the event started.
-     *
-     * @since 0.2.1
+     * Get the attendee's delegated-to value.
+     * @since 0.2.0
      */
-    trigger(): number | ICalDateTimeValue;
+    delegatedTo(): ICalAttendee | null;
     /**
-     * Use this method to set the alarm time.
+     * Set the attendee's delegated-to field.
+     *
+     * Creates a new Attendee if the passed object is not already a
+     * {@link ICalAttendee} object. Will set the `delegatedTo` and
+     * `delegatedFrom` attributes.
+     *
+     * Will also set the `status` to `DELEGATED`, if attribute is set.
      *
      * ```javascript
      * const cal = ical();
      * const event = cal.createEvent();
-     * const alarm = cal.createAlarm();
-     *
-     * alarm.trigger(600); // -> 10 minutes before event starts
-     * alarm.trigger(new Date()); // -> now
-     * ```
+     * const attendee = cal.createAttendee();
      *
-     * You can use any supported date object, see
-     * [readme](https://github.com/sebbo2002/ical-generator#-date-time--timezones)
-     * for details about supported values and timezone handling.
+     * attendee.delegatesTo({email: 'foo@bar.com', name: 'Foo'});
+     ```
      *
-     * @since 0.2.1
+     * @since 0.2.0
      */
-    trigger(trigger: number | ICalDateTimeValue | Date): this;
+    delegatedTo(delegatedTo: ICalAttendee | ICalAttendeeData | null | string): this;
     /**
-     * Get to which time alarm trigger relates to.
-     * Can be either `START` or `END`. If the value is
-     * `START` the alarm is triggerd relative to the event start time.
-     * If the value is `END` the alarm is triggerd relative to the event end time
+     * Create a new attendee this attendee delegates from and returns
+     * this new attendee. Creates a new attendee if the passed object
+     * is not already an {@link ICalAttendee}.
      *
-     * @since 4.0.1
+     * ```javascript
+     * const cal = ical();
+     * const event = cal.createEvent();
+     * const attendee = cal.createAttendee();
+     *
+     * attendee.delegatesFrom({email: 'foo@bar.com', name: 'Foo'});
+     * ```
+     *
+     * @since 0.2.0
      */
-    relatesTo(): ICalAlarmRelatesTo | null;
+    delegatesFrom(options: ICalAttendee | ICalAttendeeData | string): ICalAttendee;
     /**
-     * Use this method to set to which time alarm trigger relates to.
-     * Works only if trigger is a `number`
+     * Create a new attendee this attendee delegates to and returns
+     * this new attendee. Creates a new attendee if the passed object
+     * is not already an {@link ICalAttendee}.
      *
      * ```javascript
      * const cal = ical();
      * const event = cal.createEvent();
-     * const alarm = cal.createAlarm();
-     *
-     * alarm.trigger(600); // -> 10 minutes before event starts
+     * const attendee = cal.createAttendee();
      *
-     * alarm.relatesTo('START'); // -> 10 minutes before event starts
-     * alarm.relatesTo('END'); // -> 10 minutes before event ends
+     * attendee.delegatesTo({email: 'foo@bar.com', name: 'Foo'});
+     * ```
      *
-     * alarm.trigger(-600); // -> 10 minutes after event starts
-     *
-     * alarm.relatesTo('START'); // -> 10 minutes after event starts
-     * alarm.relatesTo('END'); // -> 10 minutes after event ends
-     * ```
-     * @since 4.0.1
+     * @since 0.2.0
      */
-    relatesTo(relatesTo: ICalAlarmRelatesTo | null): this;
+    delegatesTo(options: ICalAttendee | ICalAttendeeData | string): ICalAttendee;
     /**
-     * Get the trigger time for the alarm. Can either
-     * be a date and time value ({@link ICalDateTimeValue}) or
-     * a number, which will represent the seconds between
-     * alarm and event start. The number is negative, if the
-     * alarm is triggered before the event started.
+     * Get the attendee's email address
+     * @since 0.2.0
+     */
+    email(): string;
+    /**
+     * Set the attendee's email address
+     * @since 0.2.0
+     */
+    email(email: string): this;
+    /**
+     * Get the attendee's email address
+     * @since 1.3.0
+     */
+    mailto(): null | string;
+    /**
+     * Set the attendee's email address
+     * @since 1.3.0
+     */
+    mailto(mailto: null | string): this;
+    /**
+     * Get the attendee's name
+     * @since 0.2.0
+     */
+    name(): null | string;
+    /**
+     * Set the attendee's name
+     * @since 0.2.0
+     */
+    name(name: null | string): this;
+    /**
+     * Get attendee's role
+     * @since 0.2.0
+     */
+    role(): ICalAttendeeRole;
+    /**
+     * Set the attendee's role, defaults to `REQ` / `REQ-PARTICIPANT`.
+     * Checkout {@link ICalAttendeeRole} for available roles.
      *
+     * @since 0.2.0
+     */
+    role(role: ICalAttendeeRole): this;
+    /**
+     * Get attendee's RSVP expectation
      * @since 0.2.1
      */
-    triggerAfter(): number | ICalDateTimeValue;
+    rsvp(): boolean | null;
     /**
-     * Use this method to set the alarm time. Unlike `trigger`, this time
-     * the alarm takes place after the event has started.
-     *
-     * ```javascript
-     * const cal = ical();
-     * const event = cal.createEvent();
-     * const alarm = cal.createAlarm();
+     * Set the attendee's RSVP expectation
+     * @since 0.2.1
+     */
+    rsvp(rsvp: boolean | null): this;
+    /**
+     * Get the acting user's email adress
+     * @since 3.3.0
+     */
+    sentBy(): null | string;
+    /**
+     * Set the acting user's email adress
+     * @since 3.3.0
+     */
+    sentBy(email: null | string): this;
+    /**
+     * Get attendee's status
+     * @since 0.2.0
+     */
+    status(): ICalAttendeeStatus | null;
+    /**
+     * Set the attendee's status. See {@link ICalAttendeeStatus}
+     * for available status options.
      *
-     * alarm.trigger(600); // -> 10 minutes after event starts
-     * ```
+     * @since 0.2.0
+     */
+    status(status: ICalAttendeeStatus | null): this;
+    /**
+     * Return a shallow copy of the attendee's options for JSON stringification.
+     * Can be used for persistence.
      *
-     * You can use any supported date object, see
-     * [readme](https://github.com/sebbo2002/ical-generator#-date-time--timezones)
-     * for details about supported values and timezone handling.
+     * @since 0.2.4
+     */
+    toJSON(): ICalAttendeeJSONData;
+    /**
+     * Return generated attendee as a string.
      *
-     * @since 0.2.1
+     * ```javascript
+     * console.log(attendee.toString()); // → ATTENDEE;ROLE=…
+     * ```
      */
-    triggerAfter(trigger: number | ICalDateTimeValue): this;
+    toString(): string;
     /**
-     * Get the trigger time for the alarm. Can either
-     * be a date and time value ({@link ICalDateTimeValue}) or
-     * a number, which will represent the seconds between
-     * alarm and event start. The number is negative, if the
-     * alarm is triggered after the event started.
+     * Get attendee's type (a.k.a. CUTYPE)
+     * @since 0.2.3
+     */
+    type(): ICalAttendeeType;
+    /**
+     * Set attendee's type (a.k.a. CUTYPE).
+     * See {@link ICalAttendeeType} for available status options.
      *
-     * @since 0.2.1
-     * @see {@link trigger}
-     * @see {@link triggerAfter}
+     * @since 0.2.3
      */
-    triggerBefore(trigger: number | ICalDateTimeValue): this;
+    type(type: ICalAttendeeType | null): this;
     /**
-     * Use this method to set the alarm time.
+     * Set X-* attributes. Woun't filter double attributes,
+     * which are also added by another method (e.g. status),
+     * so these attributes may be inserted twice.
      *
      * ```javascript
-     * const cal = ical();
-     * const event = cal.createEvent();
-     * const alarm = cal.createAlarm();
+     * attendee.x([
+     *     {
+     *         key: "X-MY-CUSTOM-ATTR",
+     *         value: "1337!"
+     *     }
+     * ]);
      *
-     * alarm.trigger(600); // -> 10 minutes before event starts
-     * alarm.trigger(new Date()); // -> now
+     * attendee.x([
+     *     ["X-MY-CUSTOM-ATTR", "1337!"]
+     * ]);
+     *
+     * attendee.x({
+     *     "X-MY-CUSTOM-ATTR": "1337!"
+     * });
      * ```
      *
-     * You can use any supported date object, see
-     * [readme](https://github.com/sebbo2002/ical-generator#-date-time--timezones)
-     * for details about supported values and timezone handling.
+     * @since 1.9.0
+     */
+    x(keyOrArray: [string, string][] | Record<string, string> | {
+        key: string;
+        value: string;
+    }[]): this;
+    /**
+     * Set a X-* attribute. Woun't filter double attributes,
+     * which are also added by another method (e.g. status),
+     * so these attributes may be inserted twice.
      *
-     * @since 0.2.1
-     * @see {@link trigger}
-     * @see {@link triggerAfter}
+     * ```javascript
+     * attendee.x("X-MY-CUSTOM-ATTR", "1337!");
+     * ```
+     *
+     * @since 1.9.0
      */
-    triggerBefore(): number | ICalDateTimeValue;
+    x(keyOrArray: string, value: string): this;
     /**
-     * Get Alarm Repetitions
-     * @since 0.2.1
+     * Get all custom X-* attributes.
+     * @since 1.9.0
      */
-    repeat(): ICalAlarmRepeatData | null;
+    x(): {
+        key: string;
+        value: string;
+    }[];
+}
+
+declare enum ICalEventRepeatingFreq {
+    DAILY = "DAILY",
+    HOURLY = "HOURLY",
+    MINUTELY = "MINUTELY",
+    MONTHLY = "MONTHLY",
+    SECONDLY = "SECONDLY",
+    WEEKLY = "WEEKLY",
+    YEARLY = "YEARLY"
+}
+declare enum ICalWeekday {
+    FR = "FR",
+    MO = "MO",
+    SA = "SA",
+    SU = "SU",
+    TH = "TH",
+    TU = "TU",
+    WE = "WE"
+}
+/**
+ * ical-generator supports [native Date](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Date),
+ * [moment.js](https://momentjs.com/) (and [moment-timezone](https://momentjs.com/timezone/), [Day.js](https://day.js.org/en/) and
+ * [Luxon](https://moment.github.io/luxon/)'s [DateTime](https://moment.github.io/luxon/docs/class/src/datetime.js~DateTime.html)
+ * objects. You can also pass a string which is then passed to javascript's Date internally.
+ */
+type ICalDateTimeValue = Date | ICalDayJsStub | ICalLuxonDateTimeStub | ICalMomentStub | ICalMomentTimezoneStub | string;
+interface ICalDayJsStub {
+    format(format?: string): string;
+    isValid(): boolean;
+    toDate(): Date;
+    toJSON(): string;
+    tz(zone?: string): ICalDayJsStub;
+    utc(): ICalDayJsStub;
+}
+interface ICalDescription {
+    html?: string;
+    plain: string;
+}
+interface ICalGeo {
+    lat: number;
+    lon: number;
+}
+type ICalLocation = ICalLocationWithoutTitle | ICalLocationWithTitle;
+interface ICalLocationWithoutTitle {
+    geo: ICalGeo;
+}
+interface ICalLocationWithTitle {
+    address?: string;
+    geo?: ICalGeo;
+    radius?: number;
+    title: string;
+}
+interface ICalLuxonDateTimeStub {
+    get isValid(): boolean;
+    setZone(zone?: string): ICalLuxonDateTimeStub;
+    toFormat(fmt: string): string;
+    toJSDate(): Date;
+    toJSON(): null | string;
+    zone: {
+        type: string;
+    };
+}
+interface ICalMomentDurationStub {
+    asSeconds(): number;
+}
+interface ICalMomentStub {
+    clone(): ICalMomentStub;
+    format(format?: string): string;
+    isValid(): boolean;
+    toDate(): Date;
+    toJSON(): string;
+    utc(): ICalMomentStub;
+}
+interface ICalMomentTimezoneStub extends ICalMomentStub {
+    clone(): ICalMomentTimezoneStub;
+    tz(): string | undefined;
+    tz(timezone: string): ICalMomentTimezoneStub;
+    utc(): ICalMomentTimezoneStub;
+}
+interface ICalOrganizer {
+    email?: string;
+    mailto?: string;
+    name: string;
+    sentBy?: string;
+}
+interface ICalRepeatingOptions {
+    byDay?: ICalWeekday | ICalWeekday[];
+    byMonth?: number | number[];
+    byMonthDay?: number | number[];
+    bySetPos?: number | number[];
+    count?: number;
+    exclude?: ICalDateTimeValue | ICalDateTimeValue[];
+    freq: ICalEventRepeatingFreq;
+    interval?: number;
+    startOfWeek?: ICalWeekday;
+    until?: ICalDateTimeValue;
+}
+interface ICalRRuleStub {
+    between(after: Date, before: Date, inc?: boolean, iterator?: (d: Date, len: number) => boolean): Date[];
+    toString(): string;
+}
+interface ICalTimezone {
+    generator?: (timezone: string) => null | string;
+    name: null | string;
+}
+
+declare enum ICalAlarmType {
+    audio = "audio",
+    display = "display",
+    email = "email"
+}
+interface ICalAlarmBaseData {
+    attach?: ICalAttachment | null | string;
+    attendees?: ICalAttendee[] | ICalAttendeeData[];
+    description?: null | string;
+    relatesTo?: ICalAlarmRelatesTo | null;
+    repeat?: ICalAlarmRepeatData | null;
+    summary?: null | string;
+    type?: ICalAlarmType;
+    x?: [string, string][] | Record<string, string> | {
+        key: string;
+        value: string;
+    }[];
+}
+type ICalAlarmData = ICalAlarmBaseData | ICalAlarmTriggerAfterData | ICalAlarmTriggerBeforeData | ICalAlarmTriggerData;
+interface ICalAlarmJSONData {
+    attach: ICalAttachment | null;
+    attendees: ICalAttendee[];
+    description: null | string;
+    interval: null | number;
+    relatesTo: ICalAlarmRelatesTo | null;
+    repeat: ICalAlarmRepeatData | null;
+    summary: null | string;
+    trigger: number | string;
+    type: ICalAlarmType;
+    x: {
+        key: string;
+        value: string;
+    }[];
+}
+declare const ICalAlarmRelatesTo: {
+    readonly end: "END";
+    readonly start: "START";
+};
+type ICalAlarmRelatesTo = (typeof ICalAlarmRelatesTo)[keyof typeof ICalAlarmRelatesTo];
+interface ICalAlarmRepeatData {
+    interval: number;
+    times: number;
+}
+type ICalAlarmTriggerAfterData = ICalAlarmBaseData & {
+    triggerAfter: ICalDateTimeValue | number;
+};
+type ICalAlarmTriggerBeforeData = ICalAlarmBaseData & {
+    triggerBefore: ICalDateTimeValue | number;
+};
+type ICalAlarmTriggerData = ICalAlarmBaseData & {
+    trigger: ICalDateTimeValue | number;
+};
+type ICalAlarmTypeValue = keyof ICalAlarmType;
+interface ICalAttachment {
+    mime: null | string;
+    uri: string;
+}
+/**
+ * Usually you get an {@link ICalAlarm} object like this:
+ *
+ * ```javascript
+ * import ical from 'ical-generator';
+ * const calendar = ical();
+ * const event = calendar.createEvent();
+ * const alarm = event.createAlarm();
+ * ```
+ *
+ * You can also use the {@link ICalAlarm} object directly:
+ *
+ * ```javascript
+ * import ical, {ICalAlarm} from 'ical-generator';
+ * const alarm = new ICalAlarm();
+ * event.alarms([alarm]);
+ * ```
+ */
+declare class ICalAlarm {
+    private readonly data;
+    private readonly event;
     /**
-     * Set Alarm Repetitions. Use this to repeat the alarm.
-     *
-     * ```javascript
-     * const cal = ical();
-     * const event = cal.createEvent();
-     *
-     * // repeat the alarm 4 times every 5 minutes…
-     * cal.createAlarm({
-     *     repeat: {
-     *         times: 4,
-     *         interval: 300
-     *     }
-     * });
-     * ```
+     * Constructor of {@link ICalAttendee}. The event reference is required
+     * to query the calendar's timezone and summary when required.
      *
-     * @since 0.2.1
+     * @param data Alarm Data
+     * @param event Reference to ICalEvent object
      */
-    repeat(repeat: ICalAlarmRepeatData | null): this;
+    constructor(data: ICalAlarmData, event: ICalEvent);
     /**
      * Get Attachment
      * @since 0.2.1
      */
-    attach(): {
+    attach(): null | {
+        mime: null | string;
         uri: string;
-        mime: string | null;
-    } | null;
+    };
     /**
      * Set Alarm attachment. Used to set the alarm sound
      * if alarm type is audio. Defaults to "Basso".
@@ -378,40 +527,21 @@ declare class ICalAlarm {
      *
      * @since 0.2.1
      */
-    attach(attachment: {
+    attach(attachment: null | string | {
+        mime?: null | string;
         uri: string;
-        mime?: string | null;
-    } | string | null): this;
-    /**
-     * Get the alarm description. Used to set the alarm message
-     * if alarm type is `display`. If the alarm type is `email`, it's
-     * used to set the email body. Defaults to the event's summary.
-     *
-     * @since 0.2.1
-     */
-    description(): string | null;
-    /**
-     * Set the alarm description. Used to set the alarm message
-     * if alarm type is `display`. If the alarm type is `email`, it's
-     * used to set the email body. Defaults to the event's summary.
-     *
-     * @since 0.2.1
-     */
-    description(description: string | null): this;
+    }): this;
     /**
-     * Get the alarm summary. Used to set the email subject
-     * if alarm type is `email`. Defaults to the event's summary.
-     *
+     * Get all attendees
      * @since 7.0.0
      */
-    summary(): string | null;
+    attendees(): ICalAttendee[];
     /**
-     * Set the alarm summary. Used to set the email subject
-     * if alarm type is display. Defaults to the event's summary.
+     * Add multiple attendees to your event
      *
-     * @since 0.2.1
+     * @since 7.0.0
      */
-    summary(summary: string | null): this;
+    attendees(attendees: (ICalAttendee | ICalAttendeeData | string)[]): this;
     /**
      * Creates a new {@link ICalAttendee} and returns it. Use options to prefill
      * the attendee's attributes. Calling this method without options will create
@@ -421,359 +551,244 @@ declare class ICalAlarm {
      */
     createAttendee(data: ICalAttendee | ICalAttendeeData | string): ICalAttendee;
     /**
-     * Get all attendees
-     * @since 7.0.0
-     */
-    attendees(): ICalAttendee[];
-    /**
-     * Add multiple attendees to your event
-     *
-     * @since 7.0.0
-     */
-    attendees(attendees: (ICalAttendee | ICalAttendeeData | string)[]): this;
-    /**
-     * Set X-* attributes. Woun't filter double attributes,
-     * which are also added by another method (e.g. type),
-     * so these attributes may be inserted twice.
-     *
-     * ```javascript
-     * alarm.x([
-     *     {
-     *         key: "X-MY-CUSTOM-ATTR",
-     *         value: "1337!"
-     *     }
-     * ]);
-     *
-     * alarm.x([
-     *     ["X-MY-CUSTOM-ATTR", "1337!"]
-     * ]);
-     *
-     * alarm.x({
-     *     "X-MY-CUSTOM-ATTR": "1337!"
-     * });
-     * ```
+     * Get the alarm description. Used to set the alarm message
+     * if alarm type is `display`. If the alarm type is `email`, it's
+     * used to set the email body. Defaults to the event's summary.
      *
-     * @since 1.9.0
+     * @since 0.2.1
      */
-    x(keyOrArray: {
-        key: string;
-        value: string;
-    }[] | [string, string][] | Record<string, string>): this;
+    description(): null | string;
     /**
-     * Set a X-* attribute. Woun't filter double attributes,
-     * which are also added by another method (e.g. type),
-     * so these attributes may be inserted twice.
-     *
-     * ```javascript
-     * alarm.x("X-MY-CUSTOM-ATTR", "1337!");
-     * ```
+     * Set the alarm description. Used to set the alarm message
+     * if alarm type is `display`. If the alarm type is `email`, it's
+     * used to set the email body. Defaults to the event's summary.
      *
-     * @since 1.9.0
-     */
-    x(keyOrArray: string, value: string): this;
-    /**
-     * Get all custom X-* attributes.
-     * @since 1.9.0
+     * @since 0.2.1
      */
-    x(): {
-        key: string;
-        value: string;
-    }[];
+    description(description: null | string): this;
     /**
-     * Return a shallow copy of the alarm's options for JSON stringification.
-     * Third party objects like moment.js values are stringified as well. Can
-     * be used for persistence.
+     * Get to which time alarm trigger relates to.
+     * Can be either `START` or `END`. If the value is
+     * `START` the alarm is triggerd relative to the event start time.
+     * If the value is `END` the alarm is triggerd relative to the event end time
      *
-     * @since 0.2.4
+     * @since 4.0.1
      */
-    toJSON(): ICalAlarmJSONData;
+    relatesTo(): ICalAlarmRelatesTo | null;
     /**
-     * Return generated event as a string.
+     * Use this method to set to which time alarm trigger relates to.
+     * Works only if trigger is a `number`
      *
      * ```javascript
-     * const alarm = event.createAlarm();
-     * console.log(alarm.toString()); // → BEGIN:VALARM…
-     * ```
-     */
-    toString(): string;
-}
-
-interface ICalAttendeeData {
-    name?: string | null;
-    email: string;
-    mailto?: string | null;
-    sentBy?: string | null;
-    status?: ICalAttendeeStatus | null;
-    role?: ICalAttendeeRole;
-    rsvp?: boolean | null;
-    type?: ICalAttendeeType | null;
-    delegatedTo?: ICalAttendee | ICalAttendeeData | string | null;
-    delegatedFrom?: ICalAttendee | ICalAttendeeData | string | null;
-    delegatesTo?: ICalAttendee | ICalAttendeeData | string | null;
-    delegatesFrom?: ICalAttendee | ICalAttendeeData | string | null;
-    x?: {
-        key: string;
-        value: string;
-    }[] | [string, string][] | Record<string, string>;
-}
-interface ICalAttendeeJSONData {
-    name: string | null;
-    email: string;
-    mailto: string | null;
-    sentBy: string | null;
-    status: ICalAttendeeStatus | null;
-    role: ICalAttendeeRole;
-    rsvp: boolean | null;
-    type: ICalAttendeeType | null;
-    delegatedTo: string | null;
-    delegatedFrom: string | null;
-    x: {
-        key: string;
-        value: string;
-    }[];
-}
-declare enum ICalAttendeeRole {
-    CHAIR = "CHAIR",
-    REQ = "REQ-PARTICIPANT",
-    OPT = "OPT-PARTICIPANT",
-    NON = "NON-PARTICIPANT"
-}
-declare enum ICalAttendeeStatus {
-    ACCEPTED = "ACCEPTED",
-    TENTATIVE = "TENTATIVE",
-    DECLINED = "DECLINED",
-    DELEGATED = "DELEGATED",
-    NEEDSACTION = "NEEDS-ACTION"
-}
-declare enum ICalAttendeeType {
-    INDIVIDUAL = "INDIVIDUAL",
-    GROUP = "GROUP",
-    RESOURCE = "RESOURCE",
-    ROOM = "ROOM",
-    UNKNOWN = "UNKNOWN"
-}
-/**
- * Usually you get an {@link ICalAttendee} object like this:
- *
- * ```javascript
- * import ical from 'ical-generator';
- * const calendar = ical();
- * const event = calendar.createEvent();
- * const attendee = event.createAttendee({ email: 'mail@example.com' });
- * ```
- *
- * You can also use the {@link ICalAttendee} object directly:
- *
- * ```javascript
- * import ical, {ICalAttendee} from 'ical-generator';
- * const attendee = new ICalAttendee({ email: 'mail@example.com' });
- * event.attendees([attendee]);
- * ```
- */
-declare class ICalAttendee {
-    private readonly data;
-    private readonly parent;
-    /**
-     * Constructor of {@link ICalAttendee}. The event reference is
-     * required to query the calendar's timezone when required.
+     * const cal = ical();
+     * const event = cal.createEvent();
+     * const alarm = cal.createAlarm();
      *
-     * @param data Attendee Data
-     * @param parent Reference to ICalEvent object
-     */
-    constructor(data: ICalAttendeeData, parent: ICalEvent | ICalAlarm);
-    /**
-     * Get the attendee's name
-     * @since 0.2.0
-     */
-    name(): string | null;
-    /**
-     * Set the attendee's name
-     * @since 0.2.0
-     */
-    name(name: string | null): this;
-    /**
-     * Get the attendee's email address
-     * @since 0.2.0
-     */
-    email(): string;
-    /**
-     * Set the attendee's email address
-     * @since 0.2.0
-     */
-    email(email: string): this;
-    /**
-     * Get the attendee's email address
-     * @since 1.3.0
-     */
-    mailto(): string | null;
-    /**
-     * Set the attendee's email address
-     * @since 1.3.0
-     */
-    mailto(mailto: string | null): this;
-    /**
-     * Get the acting user's email adress
-     * @since 3.3.0
-     */
-    sentBy(): string | null;
-    /**
-     * Set the acting user's email adress
-     * @since 3.3.0
-     */
-    sentBy(email: string | null): this;
-    /**
-     * Get attendee's role
-     * @since 0.2.0
-     */
-    role(): ICalAttendeeRole;
-    /**
-     * Set the attendee's role, defaults to `REQ` / `REQ-PARTICIPANT`.
-     * Checkout {@link ICalAttendeeRole} for available roles.
+     * alarm.trigger(600); // -> 10 minutes before event starts
      *
-     * @since 0.2.0
+     * alarm.relatesTo('START'); // -> 10 minutes before event starts
+     * alarm.relatesTo('END'); // -> 10 minutes before event ends
+     *
+     * alarm.trigger(-600); // -> 10 minutes after event starts
+     *
+     * alarm.relatesTo('START'); // -> 10 minutes after event starts
+     * alarm.relatesTo('END'); // -> 10 minutes after event ends
+     * ```
+     * @since 4.0.1
      */
-    role(role: ICalAttendeeRole): this;
+    relatesTo(relatesTo: ICalAlarmRelatesTo | null): this;
     /**
-     * Get attendee's RSVP expectation
+     * Get Alarm Repetitions
      * @since 0.2.1
      */
-    rsvp(): boolean | null;
+    repeat(): ICalAlarmRepeatData | null;
     /**
-     * Set the attendee's RSVP expectation
+     * Set Alarm Repetitions. Use this to repeat the alarm.
+     *
+     * ```javascript
+     * const cal = ical();
+     * const event = cal.createEvent();
+     *
+     * // repeat the alarm 4 times every 5 minutes…
+     * cal.createAlarm({
+     *     repeat: {
+     *         times: 4,
+     *         interval: 300
+     *     }
+     * });
+     * ```
+     *
      * @since 0.2.1
      */
-    rsvp(rsvp: boolean | null): this;
+    repeat(repeat: ICalAlarmRepeatData | null): this;
     /**
-     * Get attendee's status
-     * @since 0.2.0
+     * Get the alarm summary. Used to set the email subject
+     * if alarm type is `email`. Defaults to the event's summary.
+     *
+     * @since 7.0.0
      */
-    status(): ICalAttendeeStatus | null;
+    summary(): null | string;
     /**
-     * Set the attendee's status. See {@link ICalAttendeeStatus}
-     * for available status options.
+     * Set the alarm summary. Used to set the email subject
+     * if alarm type is display. Defaults to the event's summary.
      *
-     * @since 0.2.0
+     * @since 0.2.1
      */
-    status(status: ICalAttendeeStatus | null): this;
+    summary(summary: null | string): this;
     /**
-     * Get attendee's type (a.k.a. CUTYPE)
-     * @since 0.2.3
+     * Return a shallow copy of the alarm's options for JSON stringification.
+     * Third party objects like moment.js values are stringified as well. Can
+     * be used for persistence.
+     *
+     * @since 0.2.4
      */
-    type(): ICalAttendeeType;
+    toJSON(): ICalAlarmJSONData;
     /**
-     * Set attendee's type (a.k.a. CUTYPE).
-     * See {@link ICalAttendeeType} for available status options.
+     * Return generated event as a string.
      *
-     * @since 0.2.3
+     * ```javascript
+     * const alarm = event.createAlarm();
+     * console.log(alarm.toString()); // → BEGIN:VALARM…
+     * ```
      */
-    type(type: ICalAttendeeType | null): this;
+    toString(): string;
     /**
-     * Get the attendee's delegated-to value.
-     * @since 0.2.0
+     * Get the trigger time for the alarm. Can either
+     * be a date and time value ({@link ICalDateTimeValue}) or
+     * a number, which will represent the seconds between
+     * alarm and event start. The number is negative, if the
+     * alarm is triggered after the event started.
+     *
+     * @since 0.2.1
      */
-    delegatedTo(): ICalAttendee | null;
+    trigger(): ICalDateTimeValue | number;
     /**
-     * Set the attendee's delegated-to field.
-     *
-     * Creates a new Attendee if the passed object is not already a
-     * {@link ICalAttendee} object. Will set the `delegatedTo` and
-     * `delegatedFrom` attributes.
-     *
-     * Will also set the `status` to `DELEGATED`, if attribute is set.
+     * Use this method to set the alarm time.
      *
      * ```javascript
      * const cal = ical();
      * const event = cal.createEvent();
-     * const attendee = cal.createAttendee();
+     * const alarm = cal.createAlarm();
      *
-     * attendee.delegatesTo({email: 'foo@bar.com', name: 'Foo'});
-     ```
+     * alarm.trigger(600); // -> 10 minutes before event starts
+     * alarm.trigger(new Date()); // -> now
+     * ```
      *
-     * @since 0.2.0
-     */
-    delegatedTo(delegatedTo: ICalAttendee | ICalAttendeeData | string | null): this;
-    /**
-     * Get the attendee's delegated-from field
-     * @since 0.2.0
+     * You can use any supported date object, see
+     * [readme](https://github.com/sebbo2002/ical-generator#-date-time--timezones)
+     * for details about supported values and timezone handling.
+     *
+     * @since 0.2.1
      */
-    delegatedFrom(): ICalAttendee | null;
+    trigger(trigger: Date | ICalDateTimeValue | number): this;
     /**
-     * Set the attendee's delegated-from field
-     *
-     * Creates a new Attendee if the passed object is not already a
-     * {@link ICalAttendee} object. Will set the `delegatedTo` and
-     * `delegatedFrom` attributes.
+     * Get the trigger time for the alarm. Can either
+     * be a date and time value ({@link ICalDateTimeValue}) or
+     * a number, which will represent the seconds between
+     * alarm and event start. The number is negative, if the
+     * alarm is triggered before the event started.
      *
-     * @param delegatedFrom
+     * @since 0.2.1
      */
-    delegatedFrom(delegatedFrom: ICalAttendee | ICalAttendeeData | string | null): this;
+    triggerAfter(): ICalDateTimeValue | number;
     /**
-     * Create a new attendee this attendee delegates to and returns
-     * this new attendee. Creates a new attendee if the passed object
-     * is not already an {@link ICalAttendee}.
+     * Use this method to set the alarm time. Unlike `trigger`, this time
+     * the alarm takes place after the event has started.
      *
      * ```javascript
      * const cal = ical();
      * const event = cal.createEvent();
-     * const attendee = cal.createAttendee();
+     * const alarm = cal.createAlarm();
      *
-     * attendee.delegatesTo({email: 'foo@bar.com', name: 'Foo'});
+     * alarm.trigger(600); // -> 10 minutes after event starts
      * ```
      *
-     * @since 0.2.0
+     * You can use any supported date object, see
+     * [readme](https://github.com/sebbo2002/ical-generator#-date-time--timezones)
+     * for details about supported values and timezone handling.
+     *
+     * @since 0.2.1
      */
-    delegatesTo(options: ICalAttendee | ICalAttendeeData | string): ICalAttendee;
+    triggerAfter(trigger: ICalDateTimeValue | number): this;
     /**
-     * Create a new attendee this attendee delegates from and returns
-     * this new attendee. Creates a new attendee if the passed object
-     * is not already an {@link ICalAttendee}.
+     * Get the trigger time for the alarm. Can either
+     * be a date and time value ({@link ICalDateTimeValue}) or
+     * a number, which will represent the seconds between
+     * alarm and event start. The number is negative, if the
+     * alarm is triggered after the event started.
+     *
+     * @since 0.2.1
+     * @see {@link trigger}
+     * @see {@link triggerAfter}
+     */
+    triggerBefore(trigger: ICalDateTimeValue | number): this;
+    /**
+     * Use this method to set the alarm time.
      *
      * ```javascript
      * const cal = ical();
      * const event = cal.createEvent();
-     * const attendee = cal.createAttendee();
+     * const alarm = cal.createAlarm();
      *
-     * attendee.delegatesFrom({email: 'foo@bar.com', name: 'Foo'});
+     * alarm.trigger(600); // -> 10 minutes before event starts
+     * alarm.trigger(new Date()); // -> now
      * ```
      *
-     * @since 0.2.0
+     * You can use any supported date object, see
+     * [readme](https://github.com/sebbo2002/ical-generator#-date-time--timezones)
+     * for details about supported values and timezone handling.
+     *
+     * @since 0.2.1
+     * @see {@link trigger}
+     * @see {@link triggerAfter}
      */
-    delegatesFrom(options: ICalAttendee | ICalAttendeeData | string): ICalAttendee;
+    triggerBefore(): ICalDateTimeValue | number;
+    /**
+     * Get the alarm type
+     * @since 0.2.1
+     */
+    type(type: ICalAlarmType): this;
+    /**
+     * Set the alarm type. See {@link ICalAlarmType}
+     * for available status options.
+     * @since 0.2.1
+     */
+    type(): ICalAlarmType;
     /**
      * Set X-* attributes. Woun't filter double attributes,
-     * which are also added by another method (e.g. status),
+     * which are also added by another method (e.g. type),
      * so these attributes may be inserted twice.
      *
      * ```javascript
-     * attendee.x([
+     * alarm.x([
      *     {
      *         key: "X-MY-CUSTOM-ATTR",
      *         value: "1337!"
      *     }
      * ]);
      *
-     * attendee.x([
+     * alarm.x([
      *     ["X-MY-CUSTOM-ATTR", "1337!"]
      * ]);
      *
-     * attendee.x({
+     * alarm.x({
      *     "X-MY-CUSTOM-ATTR": "1337!"
      * });
      * ```
      *
      * @since 1.9.0
      */
-    x(keyOrArray: {
+    x(keyOrArray: [string, string][] | Record<string, string> | {
         key: string;
         value: string;
-    }[] | [string, string][] | Record<string, string>): this;
+    }[]): this;
     /**
      * Set a X-* attribute. Woun't filter double attributes,
-     * which are also added by another method (e.g. status),
+     * which are also added by another method (e.g. type),
      * so these attributes may be inserted twice.
      *
      * ```javascript
-     * attendee.x("X-MY-CUSTOM-ATTR", "1337!");
+     * alarm.x("X-MY-CUSTOM-ATTR", "1337!");
      * ```
      *
      * @since 1.9.0
@@ -787,30 +802,15 @@ declare class ICalAttendee {
         key: string;
         value: string;
     }[];
-    /**
-     * Return a shallow copy of the attendee's options for JSON stringification.
-     * Can be used for persistence.
-     *
-     * @since 0.2.4
-     */
-    toJSON(): ICalAttendeeJSONData;
-    /**
-     * Return generated attendee as a string.
-     *
-     * ```javascript
-     * console.log(attendee.toString()); // → ATTENDEE;ROLE=…
-     * ```
-     */
-    toString(): string;
 }
 
 interface ICalCategoryData {
     name: string;
 }
+type ICalCategoryInternalData = ICalCategoryJSONData;
 interface ICalCategoryJSONData {
     name: string;
 }
-type ICalCategoryInternalData = ICalCategoryJSONData;
 /**
  * Usually you get an {@link ICalCategory} object like this:
  *
@@ -863,100 +863,100 @@ declare class ICalCategory {
     toString(): string;
 }
 
-declare enum ICalEventStatus {
-    CONFIRMED = "CONFIRMED",
-    TENTATIVE = "TENTATIVE",
-    CANCELLED = "CANCELLED"
-}
 declare enum ICalEventBusyStatus {
-    FREE = "FREE",
-    TENTATIVE = "TENTATIVE",
     BUSY = "BUSY",
-    OOF = "OOF"
-}
-declare enum ICalEventTransparency {
-    TRANSPARENT = "TRANSPARENT",
-    OPAQUE = "OPAQUE"
+    FREE = "FREE",
+    OOF = "OOF",
+    TENTATIVE = "TENTATIVE"
 }
 declare enum ICalEventClass {
-    PUBLIC = "PUBLIC",
+    CONFIDENTIAL = "CONFIDENTIAL",
     PRIVATE = "PRIVATE",
-    CONFIDENTIAL = "CONFIDENTIAL"
+    PUBLIC = "PUBLIC"
+}
+declare enum ICalEventStatus {
+    CANCELLED = "CANCELLED",
+    CONFIRMED = "CONFIRMED",
+    TENTATIVE = "TENTATIVE"
+}
+declare enum ICalEventTransparency {
+    OPAQUE = "OPAQUE",
+    TRANSPARENT = "TRANSPARENT"
 }
 interface ICalEventData {
-    id?: string | number | null;
-    sequence?: number;
-    start: ICalDateTimeValue;
-    end?: ICalDateTimeValue | null;
-    recurrenceId?: ICalDateTimeValue | null;
-    timezone?: string | null;
-    stamp?: ICalDateTimeValue;
+    alarms?: ICalAlarm[] | ICalAlarmData[];
     allDay?: boolean;
-    floating?: boolean;
-    repeating?: ICalRepeatingOptions | ICalRRuleStub | string | null;
-    summary?: string;
-    location?: ICalLocation | string | null;
-    description?: ICalDescription | string | null;
-    organizer?: ICalOrganizer | string | null;
+    attachments?: string[];
     attendees?: ICalAttendee[] | ICalAttendeeData[];
-    alarms?: ICalAlarm[] | ICalAlarmData[];
-    categories?: ICalCategory[] | ICalCategoryData[];
-    status?: ICalEventStatus | null;
     busystatus?: ICalEventBusyStatus | null;
-    priority?: number | null;
-    url?: string | null;
-    attachments?: string[];
-    transparency?: ICalEventTransparency | null;
+    categories?: ICalCategory[] | ICalCategoryData[];
+    class?: ICalEventClass | null;
     created?: ICalDateTimeValue | null;
+    description?: ICalDescription | null | string;
+    end?: ICalDateTimeValue | null;
+    floating?: boolean;
+    id?: null | number | string;
     lastModified?: ICalDateTimeValue | null;
-    class?: ICalEventClass | null;
-    x?: {
+    location?: ICalLocation | null | string;
+    organizer?: ICalOrganizer | null | string;
+    priority?: null | number;
+    recurrenceId?: ICalDateTimeValue | null;
+    repeating?: ICalRepeatingOptions | ICalRRuleStub | null | string;
+    sequence?: number;
+    stamp?: ICalDateTimeValue;
+    start: ICalDateTimeValue;
+    status?: ICalEventStatus | null;
+    summary?: string;
+    timezone?: null | string;
+    transparency?: ICalEventTransparency | null;
+    url?: null | string;
+    x?: [string, string][] | Record<string, string> | {
         key: string;
         value: string;
-    }[] | [string, string][] | Record<string, string>;
+    }[];
 }
 interface ICalEventJSONData {
-    id: string;
-    sequence: number;
-    start: string;
-    end: string | null;
-    recurrenceId: string | null;
-    timezone: string | null;
-    stamp: string;
+    alarms: ICalAlarm[];
     allDay: boolean;
-    floating: boolean;
-    repeating: ICalEventJSONRepeatingData | string | null;
-    summary: string;
-    location: ICalLocation | null;
-    description: ICalDescription | null;
-    organizer: ICalOrganizer | null;
+    attachments: string[];
     attendees: ICalAttendee[];
-    alarms: ICalAlarm[];
+    busystatus: ICalEventBusyStatus | null;
     categories: ICalCategory[];
+    created: null | string;
+    description: ICalDescription | null;
+    end: null | string;
+    floating: boolean;
+    id: string;
+    lastModified: null | string;
+    location: ICalLocation | null;
+    organizer: ICalOrganizer | null;
+    priority?: null | number;
+    recurrenceId: null | string;
+    repeating: ICalEventJSONRepeatingData | null | string;
+    sequence: number;
+    stamp: string;
+    start: string;
     status: ICalEventStatus | null;
-    busystatus: ICalEventBusyStatus | null;
-    priority?: number | null;
-    url: string | null;
-    attachments: string[];
+    summary: string;
+    timezone: null | string;
     transparency: ICalEventTransparency | null;
-    created: string | null;
-    lastModified: string | null;
+    url: null | string;
     x: {
         key: string;
         value: string;
     }[];
 }
 interface ICalEventJSONRepeatingData {
-    freq: ICalEventRepeatingFreq;
-    count?: number;
-    interval?: number;
-    until?: ICalDateTimeValue;
     byDay?: ICalWeekday[];
     byMonth?: number[];
     byMonthDay?: number[];
     bySetPos?: number[];
+    count?: number;
     exclude?: ICalDateTimeValue[];
+    freq: ICalEventRepeatingFreq;
+    interval?: number;
     startOfWeek?: ICalWeekday;
+    until?: ICalDateTimeValue;
 }
 /**
  * Usually you get an {@link ICalEvent} object like this:
@@ -967,8 +967,8 @@ interface ICalEventJSONRepeatingData {
  * ```
  */
 declare class ICalEvent {
-    private readonly data;
     private readonly calendar;
+    private readonly data;
     /**
      * Constructor of [[`ICalEvent`]. The calendar reference is
      * required to query the calendar's timezone when required.
@@ -978,70 +978,50 @@ declare class ICalEvent {
      */
     constructor(data: ICalEventData, calendar: ICalCalendar);
     /**
-     * Get the event's ID
+     * Get all alarms
      * @since 0.2.0
      */
-    id(): string;
+    alarms(): ICalAlarm[];
     /**
-     * Use this method to set the event's ID.
-     * If not set, a UUID will be generated randomly.
+     * Add one or multiple alarms
      *
-     * @param id Event ID you want to set
-     */
-    id(id: string | number): this;
-    /**
-     * Get the event's ID
-     * @since 0.2.0
-     * @see {@link id}
-     */
-    uid(): string;
-    /**
-     * Use this method to set the event's ID.
-     * If not set, a UUID will be generated randomly.
+     * ```javascript
+     * const event = ical().createEvent();
      *
-     * @param id Event ID you want to set
-     */
-    uid(id: string | number): this;
-    /**
-     * Get the event's SEQUENCE number. Use this method to get the event's
-     * revision sequence number of the calendar component within a sequence of revisions.
+     * cal.alarms([
+     *     {type: ICalAlarmType.display, trigger: 600},
+     *     {type: ICalAlarmType.audio, trigger: 300}
+     * ]);
      *
-     * @since 0.2.6
-     */
-    sequence(): number;
-    /**
-     * Set the event's SEQUENCE number. For a new event, this should be zero.
-     * Each time the organizer  makes a significant revision, the sequence
-     * number should be incremented.
+     * cal.alarms(); // --> [ICalAlarm, ICalAlarm]
+     ```
      *
-     * @param sequence Sequence number or null to unset it
+     * @since 0.2.0
      */
-    sequence(sequence: number): this;
+    alarms(alarms: ICalAlarm[] | ICalAlarmData[]): this;
     /**
-     * Get the event start time which is currently
-     * set. Can be any supported date object.
-     *
+     * Get the event's allDay flag
      * @since 0.2.0
      */
-    start(): ICalDateTimeValue;
+    allDay(): boolean;
     /**
-     * Set the appointment date of beginning, which is required for all events.
-     * You can use any supported date object, see
-     * [Readme](https://github.com/sebbo2002/ical-generator#-date-time--timezones)
-     * for details about supported values and timezone handling.
+     * Set the event's allDay flag.
+     *
+     * ```javascript
+     * event.allDay(true); // → appointment is for the whole day
+     * ```
      *
      * ```typescript
      * import ical from 'ical-generator';
      *
      * const cal = ical();
      *
-     * const event = cal.createEvent({
-     *   start: new Date('2020-01-01')
+     * cal.createEvent({
+     *   start: new Date('2020-01-01'),
+     *   summary: 'Very Important Day',
+     *   allDay: true
      * });
      *
-     * // overwrites old start date
-     * event.start(new Date('2024-02-01'));
-     *
      * cal.toString();
      * ```
      *
@@ -1050,203 +1030,173 @@ declare class ICalEvent {
      * VERSION:2.0
      * PRODID:-//sebbo.net//ical-generator//EN
      * BEGIN:VEVENT
-     * UID:7e2aee64-b07a-4256-9b3e-e9eaa452bac8
+     * UID:1964fe8d-32c5-4f2a-bd62-7d9d7de5992b
      * SEQUENCE:0
-     * DTSTAMP:20240212T190915Z
-     * DTSTART:20240201T000000Z
-     * SUMMARY:
+     * DTSTAMP:20240212T191956Z
+     * DTSTART;VALUE=DATE:20200101
+     * X-MICROSOFT-CDO-ALLDAYEVENT:TRUE
+     * X-MICROSOFT-MSNCALENDAR-ALLDAYEVENT:TRUE
+     * SUMMARY:Very Important Day
      * END:VEVENT
      * END:VCALENDAR
      * ```
      *
      * @since 0.2.0
      */
-    start(start: ICalDateTimeValue): this;
+    allDay(allDay: boolean): this;
     /**
-     * Get the event end time which is currently
-     * set. Can be any supported date object.
-     *
-     * @since 0.2.0
+     * Get all attachment urls
+     * @since 3.2.0-develop.1
      */
-    end(): ICalDateTimeValue | null;
+    attachments(): string[];
     /**
-     * Set the appointment date of end. You can use any supported date object, see
-     * [readme](https://github.com/sebbo2002/ical-generator#-date-time--timezones)
-     * for details about supported values and timezone handling.
+     * Add one or multiple alarms
      *
-     * @since 0.2.0
-     */
-    end(end: ICalDateTimeValue | null): this;
-    /**
-     * Checks if the start date is after the end date and swaps them if necessary.
-     * @private
-     */
-    private swapStartAndEndIfRequired;
-    /**
-     * Get the event's recurrence id
-     * @since 0.2.0
-     */
-    recurrenceId(): ICalDateTimeValue | null;
-    /**
-     * Set the event's recurrence id. You can use any supported date object, see
-     * [readme](https://github.com/sebbo2002/ical-generator#-date-time--timezones)
-     * for details about supported values and timezone handling.
+     * ```javascript
+     * const event = ical().createEvent();
      *
-     * @since 0.2.0
+     * cal.attachments([
+     *     'https://files.sebbo.net/calendar/attachments/foo',
+     *     'https://files.sebbo.net/calendar/attachments/bar'
+     * ]);
+     *
+     * cal.attachments(); // --> [string, string]
+     ```
+     *
+     * 3.2.0-develop.1
      */
-    recurrenceId(recurrenceId: ICalDateTimeValue | null): this;
+    attachments(attachments: string[]): this;
     /**
-     * Get the event's timezone.
-     * @since 0.2.6
+     * Get all attendees
+     * @since 0.2.0
      */
-    timezone(): string | null;
+    attendees(): ICalAttendee[];
     /**
-     * Sets the time zone to be used for this event. If a time zone has been
-     * defined in both the event and the calendar, the time zone of the event
-     * is used.
-     *
-     * Please note that if the time zone is set, ical-generator assumes
-     * that all times are already in the correct time zone. Alternatively,
-     * a `moment-timezone` or a Luxon object can be passed with `setZone`,
-     * ical-generator will then set the time zone itself.
+     * Add multiple attendees to your event
      *
-     * This and the 'floating' flag (see below) are mutually exclusive, and setting a timezone will unset the
-     * 'floating' flag.  If neither 'timezone' nor 'floating' are set, the date will be output with in UTC format
-     * (see [date-time form #2 in section 3.3.5 of RFC 554](https://tools.ietf.org/html/rfc5545#section-3.3.5)).
+     * ```javascript
+     * const event = ical().createEvent();
      *
-     * See [Readme](https://github.com/sebbo2002/ical-generator#-date-time--timezones) for details about
-     * supported values and timezone handling.
+     * cal.attendees([
+     *     {email: 'a@example.com', name: 'Person A'},
+     *     {email: 'b@example.com', name: 'Person B'}
+     * ]);
      *
-     * ```javascript
-     * event.timezone('America/New_York');
+     * cal.attendees(); // --> [ICalAttendee, ICalAttendee]
      * ```
      *
-     * @see https://github.com/sebbo2002/ical-generator#-date-time--timezones
-     * @since 0.2.6
-     */
-    timezone(timezone: string | null): this;
-    /**
-     * Get the event's timestamp
-     * @since 0.2.0
-     * @see {@link timestamp}
-     */
-    stamp(): ICalDateTimeValue;
-    /**
-     * Set the appointment date of creation. Defaults to the current time and date (`new Date()`). You can use
-     * any supported date object, see [readme](https://github.com/sebbo2002/ical-generator#-date-time--timezones)
-     * for details about supported values and timezone handling.
-     *
      * @since 0.2.0
-     * @see {@link timestamp}
      */
-    stamp(stamp: ICalDateTimeValue): this;
+    attendees(attendees: (ICalAttendee | ICalAttendeeData | string)[]): this;
     /**
-     * Get the event's timestamp
-     * @since 0.2.0
-     * @see {@link stamp}
+     * Get the event's busy status
+     * @since 1.0.2
      */
-    timestamp(): ICalDateTimeValue;
+    busystatus(): ICalEventBusyStatus | null;
     /**
-     * Set the appointment date of creation. Defaults to the current time and date (`new Date()`). You can use
-     * any supported date object, see [readme](https://github.com/sebbo2002/ical-generator#-date-time--timezones)
-     * for details about supported values and timezone handling.
+     * Set the event's busy status. Will add the
+     * [`X-MICROSOFT-CDO-BUSYSTATUS`](https://docs.microsoft.com/en-us/openspecs/exchange_server_protocols/ms-oxcical/cd68eae7-ed65-4dd3-8ea7-ad585c76c736)
+     * attribute to your event.
      *
-     * @since 0.2.0
-     * @see {@link stamp}
+     * ```javascript
+     * import ical, {ICalEventBusyStatus} from 'ical-generator';
+     * event.busystatus(ICalEventBusyStatus.BUSY);
+     * ```
+     *
+     * @since 1.0.2
      */
-    timestamp(stamp: ICalDateTimeValue): this;
+    busystatus(busystatus: ICalEventBusyStatus | null): this;
     /**
-     * Get the event's allDay flag
-     * @since 0.2.0
+     * Get all categories
+     * @since 0.3.0
      */
-    allDay(): boolean;
+    categories(): ICalCategory[];
     /**
-     * Set the event's allDay flag.
+     * Add categories to the event or return all selected categories.
      *
      * ```javascript
-     * event.allDay(true); // → appointment is for the whole day
-     * ```
-     *
-     * ```typescript
-     * import ical from 'ical-generator';
-     *
-     * const cal = ical();
-     *
-     * cal.createEvent({
-     *   start: new Date('2020-01-01'),
-     *   summary: 'Very Important Day',
-     *   allDay: true
-     * });
+     * const event = ical().createEvent();
      *
-     * cal.toString();
-     * ```
+     * cal.categories([
+     *     {name: 'APPOINTMENT'},
+     *     {name: 'MEETING'}
+     * ]);
      *
-     * ```text
-     * BEGIN:VCALENDAR
-     * VERSION:2.0
-     * PRODID:-//sebbo.net//ical-generator//EN
-     * BEGIN:VEVENT
-     * UID:1964fe8d-32c5-4f2a-bd62-7d9d7de5992b
-     * SEQUENCE:0
-     * DTSTAMP:20240212T191956Z
-     * DTSTART;VALUE=DATE:20200101
-     * X-MICROSOFT-CDO-ALLDAYEVENT:TRUE
-     * X-MICROSOFT-MSNCALENDAR-ALLDAYEVENT:TRUE
-     * SUMMARY:Very Important Day
-     * END:VEVENT
-     * END:VCALENDAR
+     * cal.categories(); // --> [ICalCategory, ICalCategory]
      * ```
      *
-     * @since 0.2.0
+     * @since 0.3.0
      */
-    allDay(allDay: boolean): this;
+    categories(categories: (ICalCategory | ICalCategoryData)[]): this;
     /**
-     * Get the event's floating flag.
-     * @since 0.2.0
+     * Get the event's class
+     * @since 2.0.0
      */
-    floating(): boolean;
-    floating(floating: boolean): this;
+    class(): ICalEventClass | null;
     /**
-     * Get the event's repeating options
-     * @since 0.2.0
+     * Set the event's class
+     *
+     * ```javascript
+     * import ical, { ICalEventClass } from 'ical-generator';
+     * event.class(ICalEventClass.PRIVATE);
+     * ```
+     *
+     * @since 2.0.0
      */
-    repeating(): ICalEventJSONRepeatingData | ICalRRuleStub | string | null;
+    class(class_: ICalEventClass | null): this;
     /**
-     * Set the event's repeating options by passing an {@link ICalRepeatingOptions} object.
+     * Creates a new {@link ICalAlarm} and returns it. Use options to prefill
+     * the alarm's attributes. Calling this method without options will create
+     * an empty alarm.
      *
      * ```javascript
-     * event.repeating({
-     *    freq: 'MONTHLY', // required
-     *    count: 5,
-     *    interval: 2,
-     *    until: new Date('Jan 01 2014 00:00:00 UTC'),
-     *    byDay: ['su', 'mo'], // repeat only sunday and monday
-     *    byMonth: [1, 2], // repeat only in january and february,
-     *    byMonthDay: [1, 15], // repeat only on the 1st and 15th
-     *    bySetPos: 3, // repeat every 3rd sunday (will take the first element of the byDay array)
-     *    exclude: [new Date('Dec 25 2013 00:00:00 UTC')], // exclude these dates
-     *    excludeTimezone: 'Europe/Berlin', // timezone of exclude
-     *    wkst: 'SU' // Start the week on Sunday, default is Monday
+     * const cal = ical();
+     * const event = cal.createEvent();
+     * const alarm = event.createAlarm({type: ICalAlarmType.display, trigger: 300});
+     *
+     * // add another alarm
+     * event.createAlarm({
+     *     type: ICalAlarmType.audio,
+     *     trigger: 300, // 5min before event
      * });
      * ```
      *
-     * **Example:**
+     * @since 0.2.1
+     */
+    createAlarm(data: ICalAlarm | ICalAlarmData): ICalAlarm;
+    /**
+     * Adds an attachment to the event by adding the file URL to the calendar.
      *
-     *```typescript
-     * import ical, { ICalEventRepeatingFreq } from 'ical-generator';
+     * `ical-generator` only supports external attachments. File attachments that
+     * are directly included in the file are not supported, because otherwise the
+     * calendar file could easily become unfavourably large.
      *
+     * ```javascript
      * const cal = ical();
+     * const event = cal.createEvent();
+     * event.createAttachment('https://files.sebbo.net/calendar/attachments/foo');
+     * ```
+     *
+     * @since 3.2.0-develop.1
+     */
+    createAttachment(url: string): this;
+    /**
+     * Creates a new {@link ICalAttendee} and returns it. Use options to prefill
+     * the attendee's attributes. Calling this method without options will create
+     * an empty attendee.
+     *
+     * ```javascript
+     * import ical from 'ical-generator';
      *
+     * const cal = ical();
      * const event = cal.createEvent({
-     *   start: new Date('2020-01-01T20:00:00Z'),
-     *   summary: 'Repeating Event'
-     * });
-     * event.repeating({
-     *   freq: ICalEventRepeatingFreq.WEEKLY,
-     *   count: 4
+     *   start: new Date()
      * });
      *
-     * cal.toString();
+     * event.createAttendee({email: 'hui@example.com', name: 'Hui'});
+     *
+     * // add another attendee
+     * event.createAttendee('Buh <buh@example.net>');
      * ```
      *
      * ```text
@@ -1254,83 +1204,126 @@ declare class ICalEvent {
      * VERSION:2.0
      * PRODID:-//sebbo.net//ical-generator//EN
      * BEGIN:VEVENT
-     * UID:b80e6a68-c2cd-48f5-b94d-cecc7ce83871
+     * UID:b4944f07-98e4-4581-ac80-2589bb20273d
      * SEQUENCE:0
-     * DTSTAMP:20240212T193646Z
-     * DTSTART:20200101T200000Z
-     * RRULE:FREQ=WEEKLY;COUNT=4
-     * SUMMARY:Repeating Event
+     * DTSTAMP:20240212T194232Z
+     * DTSTART:20240212T194232Z
+     * SUMMARY:
+     * ATTENDEE;ROLE=REQ-PARTICIPANT;CN="Hui":MAILTO:hui@example.com
+     * ATTENDEE;ROLE=REQ-PARTICIPANT;CN="Buh":MAILTO:buh@example.net
      * END:VEVENT
      * END:VCALENDAR
      * ```
      *
+     * As with the organizer, you can also add an explicit `mailto` address.
+     *
+     * ```javascript
+     * event.createAttendee({email: 'hui@example.com', name: 'Hui', mailto: 'another@mailto.com'});
+     *
+     * // overwrite an attendee's mailto address
+     * attendee.mailto('another@mailto.net');
+     * ```
+     *
      * @since 0.2.0
      */
-    repeating(repeating: ICalRepeatingOptions | null): this;
+    createAttendee(data: ICalAttendee | ICalAttendeeData | string): ICalAttendee;
     /**
-     * Set the event's repeating options by passing an [RRule object](https://github.com/jakubroztocil/rrule).
-     * @since 2.0.0-develop.5
-     *
-     * ```typescript
-     * import ical from 'ical-generator';
-     * import { datetime, RRule } from 'rrule';
+     * Creates a new {@link ICalCategory} and returns it. Use options to prefill the category's attributes.
+     * Calling this method without options will create an empty category.
      *
+     * ```javascript
      * const cal = ical();
+     * const event = cal.createEvent();
+     * const category = event.createCategory({name: 'APPOINTMENT'});
      *
-     * const event = cal.createEvent({
-     *   start: new Date('2020-01-01T20:00:00Z'),
-     *   summary: 'Repeating Event'
+     * // add another category
+     * event.createCategory({
+     *     name: 'MEETING'
      * });
+     * ```
      *
-     * const rule = new RRule({
-     *   freq: RRule.WEEKLY,
-     *   interval: 5,
-     *   byweekday: [RRule.MO, RRule.FR],
-     *   dtstart: datetime(2012, 2, 1, 10, 30),
-     *   until: datetime(2012, 12, 31)
-     * })
-     * event.repeating(rule);
+     * @since 0.3.0
+     */
+    createCategory(data: ICalCategory | ICalCategoryData): ICalCategory;
+    /**
+     * Get the event's creation date
+     * @since 0.3.0
+     */
+    created(): ICalDateTimeValue | null;
+    /**
+     * Set the event's creation date
+     * @since 0.3.0
+     */
+    created(created: ICalDateTimeValue | null): this;
+    /**
+     * Get the event's description as an {@link ICalDescription} object.
+     * @since 0.2.0
+     */
+    description(): ICalDescription | null;
+    /**
+     * Set the events description by passing a plaintext string or
+     * an object containing both a plaintext and a html description.
+     * Only a few calendar apps support html descriptions and like in
+     * emails, supported HTML tags and styling is limited.
      *
-     * cal.toString();
+     * ```javascript
+     * event.description({
+     *     plain: 'Hello World!',
+     *     html: '<p>Hello World!</p>'
+     * });
      * ```
      *
      * ```text
-     * BEGIN:VCALENDAR
-     * VERSION:2.0
-     * PRODID:-//sebbo.net//ical-generator//EN
-     * BEGIN:VEVENT
-     * UID:36585e40-8fa8-460d-af0c-88b6f434030b
-     * SEQUENCE:0
-     * DTSTAMP:20240212T193827Z
-     * DTSTART:20200101T200000Z
-     * RRULE:FREQ=WEEKLY;INTERVAL=5;BYDAY=MO,FR;UNTIL=20121231T000000Z
-     * SUMMARY:Repeating Event
-     * END:VEVENT
-     * END:VCALENDAR
+     * DESCRIPTION:Hello World!
+     * X-ALT-DESC;FMTTYPE=text/html:<p>Hello World!</p>
      * ```
+     *
+     * @since 0.2.0
      */
-    repeating(repeating: ICalRRuleStub | null): this;
+    description(description: ICalDescription | null | string): this;
     /**
-     * Set the events repeating options by passing a string which is inserted in the ical file.
-     * @since 2.0.0-develop.5
+     * Get the event end time which is currently
+     * set. Can be any supported date object.
+     *
+     * @since 0.2.0
      */
-    repeating(repeating: string | null): this;
+    end(): ICalDateTimeValue | null;
     /**
-     * @internal
+     * Set the appointment date of end. You can use any supported date object, see
+     * [readme](https://github.com/sebbo2002/ical-generator#-date-time--timezones)
+     * for details about supported values and timezone handling.
+     *
+     * @since 0.2.0
      */
-    repeating(repeating: ICalRepeatingOptions | ICalRRuleStub | string | null): this;
+    end(end: ICalDateTimeValue | null): this;
     /**
-     * Get the event's summary
+     * Get the event's floating flag.
      * @since 0.2.0
      */
-    summary(): string;
+    floating(): boolean;
+    floating(floating: boolean): this;
     /**
-     * Set the event's summary.
-     * Defaults to an empty string if nothing is set.
-     *
+     * Get the event's ID
      * @since 0.2.0
      */
-    summary(summary: string): this;
+    id(): string;
+    /**
+     * Use this method to set the event's ID.
+     * If not set, a UUID will be generated randomly.
+     *
+     * @param id Event ID you want to set
+     */
+    id(id: number | string): this;
+    /**
+     * Get the event's last modification date
+     * @since 0.3.0
+     */
+    lastModified(): ICalDateTimeValue | null;
+    /**
+     * Set the event's last modification date
+     * @since 0.3.0
+     */
+    lastModified(lastModified: ICalDateTimeValue | null): this;
     /**
      * Get the event's location
      * @since 0.2.0
@@ -1380,83 +1373,155 @@ declare class ICalEvent {
      *
      * @since 0.2.0
      */
-    location(location: ICalLocation | string | null): this;
+    location(location: ICalLocation | null | string): this;
     /**
-     * Get the event's description as an {@link ICalDescription} object.
+     * Get the event's organizer
      * @since 0.2.0
      */
-    description(): ICalDescription | null;
+    organizer(): ICalOrganizer | null;
     /**
-     * Set the events description by passing a plaintext string or
-     * an object containing both a plaintext and a html description.
-     * Only a few calendar apps support html descriptions and like in
-     * emails, supported HTML tags and styling is limited.
+     * Set the event's organizer
      *
      * ```javascript
-     * event.description({
-     *     plain: 'Hello World!',
-     *     html: '<p>Hello World!</p>'
+     * event.organizer({
+     *    name: 'Organizer\'s Name',
+     *    email: 'organizer@example.com'
      * });
+     *
+     * // OR
+     *
+     * event.organizer('Organizer\'s Name <organizer@example.com>');
      * ```
      *
-     * ```text
-     * DESCRIPTION:Hello World!
-     * X-ALT-DESC;FMTTYPE=text/html:<p>Hello World!</p>
+     * You can also add an explicit `mailto` email address or or the sentBy address.
+     *
+     * ```javascript
+     *     event.organizer({
+     *    name: 'Organizer\'s Name',
+     *    email: 'organizer@example.com',
+     *    mailto: 'explicit@mailto.com',
+     *    sentBy: 'substitute@example.com'
+     * })
      * ```
      *
      * @since 0.2.0
      */
-    description(description: ICalDescription | string | null): this;
+    organizer(organizer: ICalOrganizer | null | string): this;
+    /**
+     * Get the event's priority. A value of 1 represents
+     * the highest priority, 9 the lowest. 0 specifies an undefined
+     * priority.
+     *
+     * @since v2.0.0-develop.7
+     */
+    priority(): null | number;
+    /**
+     * Set the event's priority. A value of 1 represents
+     * the highest priority, 9 the lowest. 0 specifies an undefined
+     * priority.
+     *
+     * @since v2.0.0-develop.7
+     */
+    priority(priority: null | number): this;
+    /**
+     * Get the event's recurrence id
+     * @since 0.2.0
+     */
+    recurrenceId(): ICalDateTimeValue | null;
     /**
-     * Get the event's organizer
+     * Set the event's recurrence id. You can use any supported date object, see
+     * [readme](https://github.com/sebbo2002/ical-generator#-date-time--timezones)
+     * for details about supported values and timezone handling.
+     *
      * @since 0.2.0
      */
-    organizer(): ICalOrganizer | null;
+    recurrenceId(recurrenceId: ICalDateTimeValue | null): this;
     /**
-     * Set the event's organizer
+     * Get the event's repeating options
+     * @since 0.2.0
+     */
+    repeating(): ICalEventJSONRepeatingData | ICalRRuleStub | null | string;
+    /**
+     * Set the event's repeating options by passing an {@link ICalRepeatingOptions} object.
      *
      * ```javascript
-     * event.organizer({
-     *    name: 'Organizer\'s Name',
-     *    email: 'organizer@example.com'
+     * event.repeating({
+     *    freq: 'MONTHLY', // required
+     *    count: 5,
+     *    interval: 2,
+     *    until: new Date('Jan 01 2014 00:00:00 UTC'),
+     *    byDay: ['su', 'mo'], // repeat only sunday and monday
+     *    byMonth: [1, 2], // repeat only in january and february,
+     *    byMonthDay: [1, 15], // repeat only on the 1st and 15th
+     *    bySetPos: 3, // repeat every 3rd sunday (will take the first element of the byDay array)
+     *    exclude: [new Date('Dec 25 2013 00:00:00 UTC')], // exclude these dates
+     *    excludeTimezone: 'Europe/Berlin', // timezone of exclude
+     *    wkst: 'SU' // Start the week on Sunday, default is Monday
      * });
+     * ```
      *
-     * // OR
+     * **Example:**
      *
-     * event.organizer('Organizer\'s Name <organizer@example.com>');
-     * ```
+     *```typescript
+     * import ical, { ICalEventRepeatingFreq } from 'ical-generator';
      *
-     * You can also add an explicit `mailto` email address or or the sentBy address.
+     * const cal = ical();
      *
-     * ```javascript
-     *     event.organizer({
-     *    name: 'Organizer\'s Name',
-     *    email: 'organizer@example.com',
-     *    mailto: 'explicit@mailto.com',
-     *    sentBy: 'substitute@example.com'
-     * })
+     * const event = cal.createEvent({
+     *   start: new Date('2020-01-01T20:00:00Z'),
+     *   summary: 'Repeating Event'
+     * });
+     * event.repeating({
+     *   freq: ICalEventRepeatingFreq.WEEKLY,
+     *   count: 4
+     * });
+     *
+     * cal.toString();
+     * ```
+     *
+     * ```text
+     * BEGIN:VCALENDAR
+     * VERSION:2.0
+     * PRODID:-//sebbo.net//ical-generator//EN
+     * BEGIN:VEVENT
+     * UID:b80e6a68-c2cd-48f5-b94d-cecc7ce83871
+     * SEQUENCE:0
+     * DTSTAMP:20240212T193646Z
+     * DTSTART:20200101T200000Z
+     * RRULE:FREQ=WEEKLY;COUNT=4
+     * SUMMARY:Repeating Event
+     * END:VEVENT
+     * END:VCALENDAR
      * ```
      *
      * @since 0.2.0
      */
-    organizer(organizer: ICalOrganizer | string | null): this;
+    repeating(repeating: ICalRepeatingOptions | null): this;
     /**
-     * Creates a new {@link ICalAttendee} and returns it. Use options to prefill
-     * the attendee's attributes. Calling this method without options will create
-     * an empty attendee.
+     * Set the event's repeating options by passing an [RRule object](https://github.com/jakubroztocil/rrule).
+     * @since 2.0.0-develop.5
      *
-     * ```javascript
+     * ```typescript
      * import ical from 'ical-generator';
+     * import { datetime, RRule } from 'rrule';
      *
      * const cal = ical();
+     *
      * const event = cal.createEvent({
-     *   start: new Date()
+     *   start: new Date('2020-01-01T20:00:00Z'),
+     *   summary: 'Repeating Event'
      * });
      *
-     * event.createAttendee({email: 'hui@example.com', name: 'Hui'});
+     * const rule = new RRule({
+     *   freq: RRule.WEEKLY,
+     *   interval: 5,
+     *   byweekday: [RRule.MO, RRule.FR],
+     *   dtstart: datetime(2012, 2, 1, 10, 30),
+     *   until: datetime(2012, 12, 31)
+     * })
+     * event.repeating(rule);
      *
-     * // add another attendee
-     * event.createAttendee('Buh <buh@example.net>');
+     * cal.toString();
      * ```
      *
      * ```text
@@ -1464,133 +1529,101 @@ declare class ICalEvent {
      * VERSION:2.0
      * PRODID:-//sebbo.net//ical-generator//EN
      * BEGIN:VEVENT
-     * UID:b4944f07-98e4-4581-ac80-2589bb20273d
+     * UID:36585e40-8fa8-460d-af0c-88b6f434030b
      * SEQUENCE:0
-     * DTSTAMP:20240212T194232Z
-     * DTSTART:20240212T194232Z
-     * SUMMARY:
-     * ATTENDEE;ROLE=REQ-PARTICIPANT;CN="Hui":MAILTO:hui@example.com
-     * ATTENDEE;ROLE=REQ-PARTICIPANT;CN="Buh":MAILTO:buh@example.net
+     * DTSTAMP:20240212T193827Z
+     * DTSTART:20200101T200000Z
+     * RRULE:FREQ=WEEKLY;INTERVAL=5;BYDAY=MO,FR;UNTIL=20121231T000000Z
+     * SUMMARY:Repeating Event
      * END:VEVENT
      * END:VCALENDAR
      * ```
-     *
-     * As with the organizer, you can also add an explicit `mailto` address.
-     *
-     * ```javascript
-     * event.createAttendee({email: 'hui@example.com', name: 'Hui', mailto: 'another@mailto.com'});
-     *
-     * // overwrite an attendee's mailto address
-     * attendee.mailto('another@mailto.net');
-     * ```
-     *
-     * @since 0.2.0
      */
-    createAttendee(data: ICalAttendee | ICalAttendeeData | string): ICalAttendee;
+    repeating(repeating: ICalRRuleStub | null): this;
     /**
-     * Get all attendees
-     * @since 0.2.0
+     * Set the events repeating options by passing a string which is inserted in the ical file.
+     * @since 2.0.0-develop.5
      */
-    attendees(): ICalAttendee[];
+    repeating(repeating: null | string): this;
     /**
-     * Add multiple attendees to your event
-     *
-     * ```javascript
-     * const event = ical().createEvent();
-     *
-     * cal.attendees([
-     *     {email: 'a@example.com', name: 'Person A'},
-     *     {email: 'b@example.com', name: 'Person B'}
-     * ]);
-     *
-     * cal.attendees(); // --> [ICalAttendee, ICalAttendee]
-     * ```
-     *
-     * @since 0.2.0
+     * @internal
      */
-    attendees(attendees: (ICalAttendee | ICalAttendeeData | string)[]): this;
+    repeating(repeating: ICalRepeatingOptions | ICalRRuleStub | null | string): this;
     /**
-     * Creates a new {@link ICalAlarm} and returns it. Use options to prefill
-     * the alarm's attributes. Calling this method without options will create
-     * an empty alarm.
-     *
-     * ```javascript
-     * const cal = ical();
-     * const event = cal.createEvent();
-     * const alarm = event.createAlarm({type: ICalAlarmType.display, trigger: 300});
+     * Get the event's SEQUENCE number. Use this method to get the event's
+     * revision sequence number of the calendar component within a sequence of revisions.
      *
-     * // add another alarm
-     * event.createAlarm({
-     *     type: ICalAlarmType.audio,
-     *     trigger: 300, // 5min before event
-     * });
-     * ```
+     * @since 0.2.6
+     */
+    sequence(): number;
+    /**
+     * Set the event's SEQUENCE number. For a new event, this should be zero.
+     * Each time the organizer  makes a significant revision, the sequence
+     * number should be incremented.
      *
-     * @since 0.2.1
+     * @param sequence Sequence number or null to unset it
      */
-    createAlarm(data: ICalAlarm | ICalAlarmData): ICalAlarm;
+    sequence(sequence: number): this;
     /**
-     * Get all alarms
+     * Get the event's timestamp
      * @since 0.2.0
+     * @see {@link timestamp}
      */
-    alarms(): ICalAlarm[];
+    stamp(): ICalDateTimeValue;
     /**
-     * Add one or multiple alarms
-     *
-     * ```javascript
-     * const event = ical().createEvent();
-     *
-     * cal.alarms([
-     *     {type: ICalAlarmType.display, trigger: 600},
-     *     {type: ICalAlarmType.audio, trigger: 300}
-     * ]);
+     * Set the appointment date of creation. Defaults to the current time and date (`new Date()`). You can use
+     * any supported date object, see [readme](https://github.com/sebbo2002/ical-generator#-date-time--timezones)
+     * for details about supported values and timezone handling.
      *
-     * cal.alarms(); // --> [ICalAlarm, ICalAlarm]
-     ```
+     * @since 0.2.0
+     * @see {@link timestamp}
+     */
+    stamp(stamp: ICalDateTimeValue): this;
+    /**
+     * Get the event start time which is currently
+     * set. Can be any supported date object.
      *
      * @since 0.2.0
      */
-    alarms(alarms: ICalAlarm[] | ICalAlarmData[]): this;
+    start(): ICalDateTimeValue;
     /**
-     * Creates a new {@link ICalCategory} and returns it. Use options to prefill the category's attributes.
-     * Calling this method without options will create an empty category.
+     * Set the appointment date of beginning, which is required for all events.
+     * You can use any supported date object, see
+     * [Readme](https://github.com/sebbo2002/ical-generator#-date-time--timezones)
+     * for details about supported values and timezone handling.
+     *
+     * ```typescript
+     * import ical from 'ical-generator';
      *
-     * ```javascript
      * const cal = ical();
-     * const event = cal.createEvent();
-     * const category = event.createCategory({name: 'APPOINTMENT'});
      *
-     * // add another category
-     * event.createCategory({
-     *     name: 'MEETING'
+     * const event = cal.createEvent({
+     *   start: new Date('2020-01-01')
      * });
-     * ```
-     *
-     * @since 0.3.0
-     */
-    createCategory(data: ICalCategory | ICalCategoryData): ICalCategory;
-    /**
-     * Get all categories
-     * @since 0.3.0
-     */
-    categories(): ICalCategory[];
-    /**
-     * Add categories to the event or return all selected categories.
      *
-     * ```javascript
-     * const event = ical().createEvent();
+     * // overwrites old start date
+     * event.start(new Date('2024-02-01'));
      *
-     * cal.categories([
-     *     {name: 'APPOINTMENT'},
-     *     {name: 'MEETING'}
-     * ]);
+     * cal.toString();
+     * ```
      *
-     * cal.categories(); // --> [ICalCategory, ICalCategory]
+     * ```text
+     * BEGIN:VCALENDAR
+     * VERSION:2.0
+     * PRODID:-//sebbo.net//ical-generator//EN
+     * BEGIN:VEVENT
+     * UID:7e2aee64-b07a-4256-9b3e-e9eaa452bac8
+     * SEQUENCE:0
+     * DTSTAMP:20240212T190915Z
+     * DTSTART:20240201T000000Z
+     * SUMMARY:
+     * END:VEVENT
+     * END:VCALENDAR
      * ```
      *
-     * @since 0.3.0
+     * @since 0.2.0
      */
-    categories(categories: (ICalCategory | ICalCategoryData)[]): this;
+    start(start: ICalDateTimeValue): this;
     /**
      * Get the event's status
      * @since 0.2.0
@@ -1608,87 +1641,87 @@ declare class ICalEvent {
      */
     status(status: ICalEventStatus | null): this;
     /**
-     * Get the event's busy status
-     * @since 1.0.2
+     * Get the event's summary
+     * @since 0.2.0
      */
-    busystatus(): ICalEventBusyStatus | null;
+    summary(): string;
     /**
-     * Set the event's busy status. Will add the
-     * [`X-MICROSOFT-CDO-BUSYSTATUS`](https://docs.microsoft.com/en-us/openspecs/exchange_server_protocols/ms-oxcical/cd68eae7-ed65-4dd3-8ea7-ad585c76c736)
-     * attribute to your event.
-     *
-     * ```javascript
-     * import ical, {ICalEventBusyStatus} from 'ical-generator';
-     * event.busystatus(ICalEventBusyStatus.BUSY);
-     * ```
+     * Set the event's summary.
+     * Defaults to an empty string if nothing is set.
      *
-     * @since 1.0.2
+     * @since 0.2.0
      */
-    busystatus(busystatus: ICalEventBusyStatus | null): this;
+    summary(summary: string): this;
     /**
-     * Get the event's priority. A value of 1 represents
-     * the highest priority, 9 the lowest. 0 specifies an undefined
-     * priority.
-     *
-     * @since v2.0.0-develop.7
+     * Get the event's timestamp
+     * @since 0.2.0
+     * @see {@link stamp}
      */
-    priority(): number | null;
+    timestamp(): ICalDateTimeValue;
     /**
-     * Set the event's priority. A value of 1 represents
-     * the highest priority, 9 the lowest. 0 specifies an undefined
-     * priority.
+     * Set the appointment date of creation. Defaults to the current time and date (`new Date()`). You can use
+     * any supported date object, see [readme](https://github.com/sebbo2002/ical-generator#-date-time--timezones)
+     * for details about supported values and timezone handling.
      *
-     * @since v2.0.0-develop.7
-     */
-    priority(priority: number | null): this;
-    /**
-     * Get the event's URL
      * @since 0.2.0
+     * @see {@link stamp}
      */
-    url(): string | null;
+    timestamp(stamp: ICalDateTimeValue): this;
     /**
-     * Set the event's URL
-     * @since 0.2.0
+     * Get the event's timezone.
+     * @since 0.2.6
      */
-    url(url: string | null): this;
+    timezone(): null | string;
     /**
-     * Adds an attachment to the event by adding the file URL to the calendar.
+     * Sets the time zone to be used for this event. If a time zone has been
+     * defined in both the event and the calendar, the time zone of the event
+     * is used.
      *
-     * `ical-generator` only supports external attachments. File attachments that
-     * are directly included in the file are not supported, because otherwise the
-     * calendar file could easily become unfavourably large.
+     * Please note that if the time zone is set, ical-generator assumes
+     * that all times are already in the correct time zone. Alternatively,
+     * a `moment-timezone` or a Luxon object can be passed with `setZone`,
+     * ical-generator will then set the time zone itself.
+     *
+     * This and the 'floating' flag (see below) are mutually exclusive, and setting a timezone will unset the
+     * 'floating' flag.  If neither 'timezone' nor 'floating' are set, the date will be output with in UTC format
+     * (see [date-time form #2 in section 3.3.5 of RFC 554](https://tools.ietf.org/html/rfc5545#section-3.3.5)).
+     *
+     * See [Readme](https://github.com/sebbo2002/ical-generator#-date-time--timezones) for details about
+     * supported values and timezone handling.
      *
      * ```javascript
-     * const cal = ical();
-     * const event = cal.createEvent();
-     * event.createAttachment('https://files.sebbo.net/calendar/attachments/foo');
+     * event.timezone('America/New_York');
      * ```
      *
-     * @since 3.2.0-develop.1
-     */
-    createAttachment(url: string): this;
-    /**
-     * Get all attachment urls
-     * @since 3.2.0-develop.1
+     * @see https://github.com/sebbo2002/ical-generator#-date-time--timezones
+     * @since 0.2.6
      */
-    attachments(): string[];
+    timezone(timezone: null | string): this;
     /**
-     * Add one or multiple alarms
+     * Return a shallow copy of the events's options for JSON stringification.
+     * Third party objects like moment.js values or RRule objects are stringified
+     * as well. Can be used for persistence.
      *
      * ```javascript
      * const event = ical().createEvent();
+     * const json = JSON.stringify(event);
      *
-     * cal.attachments([
-     *     'https://files.sebbo.net/calendar/attachments/foo',
-     *     'https://files.sebbo.net/calendar/attachments/bar'
-     * ]);
+     * // later: restore event data
+     * const calendar = ical().createEvent(JSON.parse(json));
+     * ```
      *
-     * cal.attachments(); // --> [string, string]
-     ```
+     * @since 0.2.4
+     */
+    toJSON(): ICalEventJSONData;
+    /**
+     * Return generated event as a string.
      *
-     * 3.2.0-develop.1
+     * ```javascript
+     * const event = ical().createEvent();
+     * console.log(event.toString()); // → BEGIN:VEVENT…
+     * ```
      */
-    attachments(attachments: string[]): this;
+    toString(): string;
     /**
      * Get the event's transparency
      * @since 1.7.3
@@ -1712,41 +1745,28 @@ declare class ICalEvent {
      */
     transparency(transparency: ICalEventTransparency | null): this;
     /**
-     * Get the event's creation date
-     * @since 0.3.0
-     */
-    created(): ICalDateTimeValue | null;
-    /**
-     * Set the event's creation date
-     * @since 0.3.0
-     */
-    created(created: ICalDateTimeValue | null): this;
-    /**
-     * Get the event's last modification date
-     * @since 0.3.0
+     * Get the event's ID
+     * @since 0.2.0
+     * @see {@link id}
      */
-    lastModified(): ICalDateTimeValue | null;
+    uid(): string;
     /**
-     * Set the event's last modification date
-     * @since 0.3.0
+     * Use this method to set the event's ID.
+     * If not set, a UUID will be generated randomly.
+     *
+     * @param id Event ID you want to set
      */
-    lastModified(lastModified: ICalDateTimeValue | null): this;
+    uid(id: number | string): this;
     /**
-     * Get the event's class
-     * @since 2.0.0
+     * Get the event's URL
+     * @since 0.2.0
      */
-    class(): ICalEventClass | null;
+    url(): null | string;
     /**
-     * Set the event's class
-     *
-     * ```javascript
-     * import ical, { ICalEventClass } from 'ical-generator';
-     * event.class(ICalEventClass.PRIVATE);
-     * ```
-     *
-     * @since 2.0.0
+     * Set the event's URL
+     * @since 0.2.0
      */
-    class(class_: ICalEventClass | null): this;
+    url(url: null | string): this;
     /**
      * Set X-* attributes. Woun't filter double attributes,
      * which are also added by another method (e.g. summary),
@@ -1771,10 +1791,10 @@ declare class ICalEvent {
      *
      * @since 1.9.0
      */
-    x(keyOrArray: {
+    x(keyOrArray: [string, string][] | Record<string, string> | {
         key: string;
         value: string;
-    }[] | [string, string][] | Record<string, string>): this;
+    }[]): this;
     /**
      * Set a X-* attribute. Woun't filter double attributes,
      * which are also added by another method (e.g. summary),
@@ -1796,59 +1816,49 @@ declare class ICalEvent {
         value: string;
     }[];
     /**
-     * Return a shallow copy of the events's options for JSON stringification.
-     * Third party objects like moment.js values or RRule objects are stringified
-     * as well. Can be used for persistence.
-     *
-     * ```javascript
-     * const event = ical().createEvent();
-     * const json = JSON.stringify(event);
-     *
-     * // later: restore event data
-     * const calendar = ical().createEvent(JSON.parse(json));
-     * ```
-     *
-     * @since 0.2.4
-     */
-    toJSON(): ICalEventJSONData;
-    /**
-     * Return generated event as a string.
-     *
-     * ```javascript
-     * const event = ical().createEvent();
-     * console.log(event.toString()); // → BEGIN:VEVENT…
-     * ```
+     * Checks if the start date is after the end date and swaps them if necessary.
+     * @private
      */
-    toString(): string;
+    private swapStartAndEndIfRequired;
 }
 
+declare enum ICalCalendarMethod {
+    ADD = "ADD",
+    CANCEL = "CANCEL",
+    COUNTER = "COUNTER",
+    DECLINECOUNTER = "DECLINECOUNTER",
+    PUBLISH = "PUBLISH",
+    REFRESH = "REFRESH",
+    REPLY = "REPLY",
+    REQUEST = "REQUEST"
+}
 interface ICalCalendarData {
-    prodId?: ICalCalendarProdIdData | string;
-    method?: ICalCalendarMethod | null;
-    name?: string | null;
-    description?: string | null;
-    timezone?: ICalTimezone | string | null;
-    source?: string | null;
-    url?: string | null;
-    scale?: string | null;
-    ttl?: number | ICalMomentDurationStub | null;
+    description?: null | string;
     events?: (ICalEvent | ICalEventData)[];
-    x?: {
+    method?: ICalCalendarMethod | null;
+    name?: null | string;
+    prodId?: ICalCalendarProdIdData | string;
+    scale?: null | string;
+    source?: null | string;
+    timezone?: ICalTimezone | null | string;
+    ttl?: ICalMomentDurationStub | null | number;
+    url?: null | string;
+    x?: [string, string][] | Record<string, string> | {
         key: string;
         value: string;
-    }[] | [string, string][] | Record<string, string>;
+    }[];
 }
 interface ICalCalendarJSONData {
-    prodId: string;
-    method: ICalCalendarMethod | null;
-    name: string | null;
-    description: string | null;
-    timezone: string | null;
-    source: string | null;
-    url: string | null;
-    scale: string | null;
-    ttl: number | null;
+    description: null | string;
     events: ICalEventJSONData[];
+    method: ICalCalendarMethod | null;
+    name: null | string;
+    prodId: string;
+    scale: null | string;
+    source: null | string;
+    timezone: null | string;
+    ttl: null | number;
+    url: null | string;
     x: {
         key: string;
         value: string;
@@ -1856,18 +1866,8 @@ interface ICalCalendarJSONData {
 }
 interface ICalCalendarProdIdData {
     company: string;
-    product: string;
     language?: string;
-}
-declare enum ICalCalendarMethod {
-    PUBLISH = "PUBLISH",
-    REQUEST = "REQUEST",
-    REPLY = "REPLY",
-    ADD = "ADD",
-    CANCEL = "CANCEL",
-    REFRESH = "REFRESH",
-    COUNTER = "COUNTER",
-    DECLINECOUNTER = "DECLINECOUNTER"
+    product: string;
 }
 /**
  * Usually you get an {@link ICalCalendar} object like this:
@@ -1920,32 +1920,90 @@ declare class ICalCalendar {
      */
     constructor(data?: ICalCalendarData);
     /**
-     * Get your feed's prodid. Will always return a string.
+     * Remove all events from the calendar without
+     * touching any other data like name or prodId.
+     *
+     * @since 2.0.0-develop.1
+     */
+    clear(): this;
+    /**
+     * Creates a new {@link ICalEvent} and returns it. Use options to prefill the event's attributes.
+     * Calling this method without options will create an empty event.
+     *
+     * ```javascript
+     * import ical from 'ical-generator';
+     *
+     * // or use require:
+     * // const { default: ical } = require('ical-generator');
+     *
+     * const cal = ical();
+     * const event = cal.createEvent({summary: 'My Event'});
+     *
+     * // overwrite event summary
+     * event.summary('Your Event');
+     * ```
+     *
      * @since 0.2.0
      */
-    prodId(): string;
+    createEvent(data: ICalEvent | ICalEventData): ICalEvent;
     /**
-     * Set your feed's prodid. `prodid` can be either a
-     * string like `//sebbo.net//ical-generator//EN` or a
-     * valid {@link ICalCalendarProdIdData} object. `language`
-     * is optional and defaults to `EN`.
+     * Get your feed's description
+     * @since 0.2.7
+     */
+    description(): null | string;
+    /**
+     * Set your feed's description
+     * @since 0.2.7
+     */
+    description(description: null | string): this;
+    /**
+     * Returns all events of this calendar.
+     *
+     * ```javascript
+     * const cal = ical();
+     *
+     * cal.events([
+     *     {
+     *        start: new Date(),
+     *        end: new Date(new Date().getTime() + 3600000),
+     *        summary: 'Example Event',
+     *        description: 'It works ;)',
+     *        url: 'http://sebbo.net/'
+     *     }
+     * ]);
+     *
+     * cal.events(); // --> [ICalEvent]
+     * ```
+     *
+     * @since 0.2.0
+     */
+    events(): ICalEvent[];
+    /**
+     * Add multiple events to your calendar.
      *
      * ```javascript
-     * cal.prodId({
-     *     company: 'My Company',
-     *     product: 'My Product',
-     *     language: 'EN' // optional, defaults to EN
-     * });
-     * ```
+     * const cal = ical();
      *
-     * `cal.toString()` would then produce the following string:
-     * ```text
-     * PRODID:-//My Company//My Product//EN
+     * cal.events([
+     *     {
+     *        start: new Date(),
+     *        end: new Date(new Date().getTime() + 3600000),
+     *        summary: 'Example Event',
+     *        description: 'It works ;)',
+     *        url: 'http://sebbo.net/'
+     *     }
+     * ]);
+     *
+     * cal.events(); // --> [ICalEvent]
      * ```
      *
      * @since 0.2.0
      */
-    prodId(prodId: ICalCalendarProdIdData | string): this;
+    events(events: (ICalEvent | ICalEventData)[]): this;
+    /**
+     * Get the number of events added to your calendar
+     */
+    length(): number;
     /**
      * Get the feed method attribute.
      * See {@link ICalCalendarMethod} for possible results.
@@ -1972,7 +2030,7 @@ declare class ICalCalendar {
      * Get your feed's name
      * @since 0.2.0
      */
-    name(): string | null;
+    name(): null | string;
     /**
      * Set your feed's name. Is used to fill `NAME`
      * and `X-WR-CALNAME` in your iCal file.
@@ -1997,22 +2055,80 @@ declare class ICalCalendar {
      *
      * @since 0.2.0
      */
-    name(name: string | null): this;
+    name(name: null | string): this;
     /**
-     * Get your feed's description
-     * @since 0.2.7
+     * Get your feed's prodid. Will always return a string.
+     * @since 0.2.0
      */
-    description(): string | null;
+    prodId(): string;
     /**
-     * Set your feed's description
-     * @since 0.2.7
+     * Set your feed's prodid. `prodid` can be either a
+     * string like `//sebbo.net//ical-generator//EN` or a
+     * valid {@link ICalCalendarProdIdData} object. `language`
+     * is optional and defaults to `EN`.
+     *
+     * ```javascript
+     * cal.prodId({
+     *     company: 'My Company',
+     *     product: 'My Product',
+     *     language: 'EN' // optional, defaults to EN
+     * });
+     * ```
+     *
+     * `cal.toString()` would then produce the following string:
+     * ```text
+     * PRODID:-//My Company//My Product//EN
+     * ```
+     *
+     * @since 0.2.0
+     */
+    prodId(prodId: ICalCalendarProdIdData | string): this;
+    /**
+     * Get current value of the `CALSCALE` attribute. It will
+     * return `null` if no value was set. The iCal standard
+     * specifies this as `GREGORIAN` if no value is present.
+     *
+     * @since 1.8.0
+     */
+    scale(): null | string;
+    /**
+     * Use this method to set your feed's `CALSCALE` attribute. There is no
+     * default value for this property and it will not appear in your iCal
+     * file unless set. The iCal standard specifies this as `GREGORIAN` if
+     * no value is present.
+     *
+     * ```javascript
+     * cal.scale('gregorian');
+     * ```
+     *
+     * @since 1.8.0
+     */
+    scale(scale: null | string): this;
+    /**
+     * Get current value of the `SOURCE` attribute.
+     * @since 2.2.0-develop.1
+     */
+    source(): null | string;
+    /**
+     * Use this method to set your feed's `SOURCE` attribute.
+     * This tells the client where to refresh your feed.
+     *
+     * ```javascript
+     * cal.source('http://example.com/my/original_source.ical');
+     * ```
+     *
+     * ```text
+     * SOURCE;VALUE=URI:http://example.com/my/original_source.ical
+     * ```
+     *
+     * @since 2.2.0-develop.1
      */
-    description(description: string | null): this;
+    source(source: null | string): this;
     /**
      * Get the current calendar timezone
      * @since 0.2.0
      */
-    timezone(): string | null;
+    timezone(): null | string;
     /**
      * Use this method to set your feed's timezone. Is used
      * to fill `TIMEZONE-ID` and `X-WR-TIMEZONE` in your iCal export.
@@ -2027,7 +2143,7 @@ declare class ICalCalendar {
      * @see https://github.com/sebbo2002/ical-generator#-date-time--timezones
      * @since 0.2.0
      */
-    timezone(timezone: string | null): this;
+    timezone(timezone: null | string): this;
     /**
      * Sets the time zone to be used in this calendar file for all times of all
      * events. Please note that if the time zone is set, ical-generator assumes
@@ -2062,68 +2178,37 @@ declare class ICalCalendar {
      * @see https://github.com/sebbo2002/ical-generator#-date-time--timezones
      * @since 2.0.0
      */
-    timezone(timezone: ICalTimezone | string | null): this;
-    /**
-     * Get current value of the `SOURCE` attribute.
-     * @since 2.2.0-develop.1
-     */
-    source(): string | null;
+    timezone(timezone: ICalTimezone | null | string): this;
     /**
-     * Use this method to set your feed's `SOURCE` attribute.
-     * This tells the client where to refresh your feed.
+     * Return a shallow copy of the calendar's options for JSON stringification.
+     * Third party objects like moment.js values or RRule objects are stringified
+     * as well. Can be used for persistence.
      *
      * ```javascript
-     * cal.source('http://example.com/my/original_source.ical');
-     * ```
-     *
-     * ```text
-     * SOURCE;VALUE=URI:http://example.com/my/original_source.ical
-     * ```
-     *
-     * @since 2.2.0-develop.1
-     */
-    source(source: string | null): this;
-    /**
-     * Get your feed's URL
-     * @since 0.2.5
-     */
-    url(): string | null;
-    /**
-     * Set your feed's URL
+     * const cal = ical();
+     * const json = JSON.stringify(cal);
      *
-     * ```javascript
-     * calendar.url('http://example.com/my/feed.ical');
+     * // later: restore calendar data
+     * cal = ical(JSON.parse(json));
      * ```
      *
-     * @since 0.2.5
-     */
-    url(url: string | null): this;
-    /**
-     * Get current value of the `CALSCALE` attribute. It will
-     * return `null` if no value was set. The iCal standard
-     * specifies this as `GREGORIAN` if no value is present.
-     *
-     * @since 1.8.0
+     * @since 0.2.4
      */
-    scale(): string | null;
+    toJSON(): ICalCalendarJSONData;
     /**
-     * Use this method to set your feed's `CALSCALE` attribute. There is no
-     * default value for this property and it will not appear in your iCal
-     * file unless set. The iCal standard specifies this as `GREGORIAN` if
-     * no value is present.
+     * Return generated calendar as a string.
      *
      * ```javascript
-     * cal.scale('gregorian');
+     * const cal = ical();
+     * console.log(cal.toString()); // → BEGIN:VCALENDAR…
      * ```
-     *
-     * @since 1.8.0
      */
-    scale(scale: string | null): this;
+    toString(): string;
     /**
      * Get the current ttl duration in seconds
      * @since 0.2.5
      */
-    ttl(): number | null;
+    ttl(): null | number;
     /**
      * Use this method to set your feed's time to live
      * (in seconds). Is used to fill `REFRESH-INTERVAL` and
@@ -2138,78 +2223,22 @@ declare class ICalCalendar {
      *
      * @since 0.2.5
      */
-    ttl(ttl: number | ICalMomentDurationStub | null): this;
-    /**
-     * Creates a new {@link ICalEvent} and returns it. Use options to prefill the event's attributes.
-     * Calling this method without options will create an empty event.
-     *
-     * ```javascript
-     * import ical from 'ical-generator';
-     *
-     * // or use require:
-     * // const { default: ical } = require('ical-generator');
-     *
-     * const cal = ical();
-     * const event = cal.createEvent({summary: 'My Event'});
-     *
-     * // overwrite event summary
-     * event.summary('Your Event');
-     * ```
-     *
-     * @since 0.2.0
-     */
-    createEvent(data: ICalEvent | ICalEventData): ICalEvent;
+    ttl(ttl: ICalMomentDurationStub | null | number): this;
     /**
-     * Returns all events of this calendar.
-     *
-     * ```javascript
-     * const cal = ical();
-     *
-     * cal.events([
-     *     {
-     *        start: new Date(),
-     *        end: new Date(new Date().getTime() + 3600000),
-     *        summary: 'Example Event',
-     *        description: 'It works ;)',
-     *        url: 'http://sebbo.net/'
-     *     }
-     * ]);
-     *
-     * cal.events(); // --> [ICalEvent]
-     * ```
-     *
-     * @since 0.2.0
+     * Get your feed's URL
+     * @since 0.2.5
      */
-    events(): ICalEvent[];
+    url(): null | string;
     /**
-     * Add multiple events to your calendar.
+     * Set your feed's URL
      *
      * ```javascript
-     * const cal = ical();
-     *
-     * cal.events([
-     *     {
-     *        start: new Date(),
-     *        end: new Date(new Date().getTime() + 3600000),
-     *        summary: 'Example Event',
-     *        description: 'It works ;)',
-     *        url: 'http://sebbo.net/'
-     *     }
-     * ]);
-     *
-     * cal.events(); // --> [ICalEvent]
+     * calendar.url('http://example.com/my/feed.ical');
      * ```
      *
-     * @since 0.2.0
-     */
-    events(events: (ICalEvent | ICalEventData)[]): this;
-    /**
-     * Remove all events from the calendar without
-     * touching any other data like name or prodId.
-     *
-     * @since 2.0.0-develop.1
+     * @since 0.2.5
      */
-    clear(): this;
+    url(url: null | string): this;
     /**
      * Set X-* attributes. Woun't filter double attributes,
      * which are also added by another method (e.g. busystatus),
@@ -2242,10 +2271,10 @@ declare class ICalCalendar {
      *
      * @since 1.9.0
      */
-    x(keyOrArray: {
+    x(keyOrArray: [string, string][] | Record<string, string> | {
         key: string;
         value: string;
-    }[] | [string, string][] | Record<string, string>): this;
+    }[]): this;
     /**
      * Set a X-* attribute. Woun't filter double attributes,
      * which are also added by another method (e.g. busystatus),
@@ -2274,58 +2303,29 @@ declare class ICalCalendar {
         key: string;
         value: string;
     }[];
-    /**
-     * Return a shallow copy of the calendar's options for JSON stringification.
-     * Third party objects like moment.js values or RRule objects are stringified
-     * as well. Can be used for persistence.
-     *
-     * ```javascript
-     * const cal = ical();
-     * const json = JSON.stringify(cal);
-     *
-     * // later: restore calendar data
-     * cal = ical(JSON.parse(json));
-     * ```
-     *
-     * @since 0.2.4
-     */
-    toJSON(): ICalCalendarJSONData;
-    /**
-     * Get the number of events added to your calendar
-     */
-    length(): number;
-    /**
-     * Return generated calendar as a string.
-     *
-     * ```javascript
-     * const cal = ical();
-     * console.log(cal.toString()); // → BEGIN:VCALENDAR…
-     * ```
-     */
-    toString(): string;
 }
 
+/**
+ * Escapes special characters in the given string
+ */
+declare function escape(str: string | unknown, inQuotes: boolean): string;
+/**
+ * Trim line length of given string
+ */
+declare function foldLines(input: string): string;
 /**
  * Converts a valid date/time object supported by this library to a string.
  */
-declare function formatDate(timezone: string | null, d: ICalDateTimeValue, dateonly?: boolean, floating?: boolean): string;
+declare function formatDate(timezone: null | string, d: ICalDateTimeValue, dateonly?: boolean, floating?: boolean): string;
 /**
  * Converts a valid date/time object supported by this library to a string.
  * For information about this format, see RFC 5545, section 3.3.5
  * https://tools.ietf.org/html/rfc5545#section-3.3.5
  */
-declare function formatDateTZ(timezone: string | null, property: string, date: ICalDateTimeValue | Date | string, eventData?: {
+declare function formatDateTZ(timezone: null | string, property: string, date: Date | ICalDateTimeValue | string, eventData?: {
     floating?: boolean | null;
-    timezone?: string | null;
+    timezone?: null | string;
 }): string;
-/**
- * Escapes special characters in the given string
- */
-declare function escape(str: string | unknown, inQuotes: boolean): string;
-/**
- * Trim line length of given string
- */
-declare function foldLines(input: string): string;
 
 /**
  * ical-generator entrypoint