iamcal 3.0.3 → 4.0.0

package/lib/duration.d.ts

@@ -0,0 +1,106 @@
+import { CalendarDateOrTime } from './date';
+export type DurationUnit = 'W' | 'D' | 'H' | 'M' | 'S';
+/**
+ * Represents a DURATION value as defined by RFC5545.
+ */
+export declare class CalendarDuration {
+    weeks?: number;
+    days?: number;
+    hours?: number;
+    minutes?: number;
+    seconds?: number;
+    constructor(duration: string | CalendarDuration);
+    /**
+     * Get the length of this duration object in seconds.
+     * @returns The total number of seconds represented by this duration.
+     */
+    inSeconds(): number;
+    /**
+     * Get the length of this duration object in milliseconds.
+     *
+     * Note that this will always return whole seconds, as durations do not
+     * support milliseconds.
+     * @returns The total number of milliseconds represented by this duration.
+     */
+    inMilliseconds(): number;
+    /**
+     * Get the duration string that represents this duration.
+     * @returns A duration string in the format `P[n]W` for weeks, or `P[n]DT[n]H[n]M[n]S` for days, hours, minutes and seconds. Prefixed with a `-` if negative.
+     */
+    getValue(): string;
+    /**
+     * Get the floor the duration to the nearest of a given unit.
+     * @param unit The unit to floor to.
+     * @returns The duration with units smaller than `unit` removed.
+     * @example
+     * const duration = new CalendarDuration("1W2D5H30M")
+     * const days = duration.floor("D") // Floor to days
+     * console.log(days.getValue()) // "1W2D"
+     */
+    floor(unit: DurationUnit): CalendarDuration;
+    /**
+     * Create a duration from a number of seconds.
+     * @param seconds How many seconds the duration should represent.
+     * @returns A {@link CalendarDuration} representing the specified number of seconds.
+     * @throws {Error} If seconds is NaN.
+     */
+    static fromSeconds(seconds: number): CalendarDuration;
+    /**
+     * Create a duration from a number of days.
+     * @param days How many days the duration should represent.
+     * @returns A {@link CalendarDuration} representing the specified number of days.
+     * @throws {Error} If days is NaN.
+     */
+    static fromDays(days: number): CalendarDuration;
+    /**
+     * Create a duration from a number of weeks.
+     * @param weeks How many weeks the duration should represent.
+     * @returns A {@link CalendarDuration} representing the specified number of weeks.
+     * @throws {Error} If weeks is NaN.
+     */
+    static fromWeeks(weeks: number): CalendarDuration;
+    /**
+     * Creates a duration from the difference between two dates.
+     * @param start The start date or time.
+     * @param end The end date or time.
+     * @returns A {@link CalendarDuration} representing the difference between the two dates.
+     * @throws {Error} If the start date and end date have different types.
+     */
+    static fromDifference(start: Date | CalendarDateOrTime, end: Date | CalendarDateOrTime): CalendarDuration;
+}
+/**
+ * Convert time units to a duration string.
+ *
+ * A duration is considered negative if any unit is less than 0.
+ * @param weeks How many weeks the duration should represent.
+ * @param days The days part of the duration.
+ * @param hours The hours part of the duration.
+ * @param minutes The minutes part of the duration.
+ * @param seconds The seconds part of the duration.
+ * @returns A string representing the duration in the format `P[n]W` or `P[n]DT[n]H[n]M[n]S` where values may be omitted if 0, prefixed with `-` if negative.
+ * @throws {Error} If weeks are combined with other values.
+ * @throws {Error} If any unit is NaN.
+ */
+export declare function formatDurationString(weeks: number | undefined, days: number | undefined, hours: number | undefined, minutes: number | undefined, seconds: number | undefined): string;
+/**
+ * Convert a number of seconds to a duration string.
+ * @param seconds How many seconds the duration should represent.
+ * @returns A string representing the duration in the format `PT[n]H[n]M[n]S` where values may be omitted if 0, prefixed with `-` if negative.
+ * @throws {Error} If seconds is NaN.
+ */
+export declare function secondsToDurationString(seconds: number): string;
+/**
+ * Convert a number of days to a duration string.
+ * @param days How many days the duration should represent.
+ * @returns A string representing the duration in the format `P[n]D`, prefixed with `-` if negative.
+ * @throws {Error} If days is NaN.
+ */
+export declare function daysToDurationString(days: number): string;
+/**
+ * Convert a number of weeks to a duration string.
+ * @param weeks How many weeks the duration should represent.
+ * @returns A string representing the duration in the format `P[n]W`, prefixed with `-` if negative.
+ * @throws {Error} If weeks is NaN.
+ */
+export declare function weeksToDurationString(weeks: number): string;
+//# sourceMappingURL=duration.d.ts.map

package/lib/duration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"duration.d.ts","sourceRoot":"","sources":["../src/duration.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,kBAAkB,EASrB,MAAM,QAAQ,CAAA;AAGf,MAAM,MAAM,YAAY,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,CAAA;AAEtD;;GAEG;AACH,qBAAa,gBAAgB;IACzB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,OAAO,CAAC,EAAE,MAAM,CAAA;gBAEJ,QAAQ,EAAE,MAAM,GAAG,gBAAgB;IAqC/C;;;OAGG;IACH,SAAS,IAAI,MAAM;IAUnB;;;;;;OAMG;IACH,cAAc,IAAI,MAAM;IAIxB;;;OAGG;IACH,QAAQ,IAAI,MAAM;IAUlB;;;;;;;;OAQG;IACH,KAAK,CAAC,IAAI,EAAE,YAAY,GAAG,gBAAgB;IAiB3C;;;;;OAKG;IACH,MAAM,CAAC,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,gBAAgB;IAIrD;;;;;OAKG;IACH,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB;IAI/C;;;;;OAKG;IACH,MAAM,CAAC,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,gBAAgB;IAIjD;;;;;;OAMG;IACH,MAAM,CAAC,cAAc,CACjB,KAAK,EAAE,IAAI,GAAG,kBAAkB,EAChC,GAAG,EAAE,IAAI,GAAG,kBAAkB,GAC/B,gBAAgB;CA4BtB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,oBAAoB,CAChC,KAAK,EAAE,MAAM,GAAG,SAAS,EACzB,IAAI,EAAE,MAAM,GAAG,SAAS,EACxB,KAAK,EAAE,MAAM,GAAG,SAAS,EACzB,OAAO,EAAE,MAAM,GAAG,SAAS,EAC3B,OAAO,EAAE,MAAM,GAAG,SAAS,GAC5B,MAAM,CAkDR;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAsB/D;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAQzD;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAQ3D"}

package/lib/duration.js

@@ -0,0 +1,277 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CalendarDuration = void 0;
+exports.formatDurationString = formatDurationString;
+exports.secondsToDurationString = secondsToDurationString;
+exports.daysToDurationString = daysToDurationString;
+exports.weeksToDurationString = weeksToDurationString;
+const date_1 = require("./date");
+const property_1 = require("./property");
+/**
+ * Represents a DURATION value as defined by RFC5545.
+ */
+class CalendarDuration {
+    weeks;
+    days;
+    hours;
+    minutes;
+    seconds;
+    constructor(duration) {
+        if (typeof duration === 'string') {
+            (0, property_1.validateDuration)(duration);
+            const negativeMultiplier = duration.startsWith('-') ? -1 : 1;
+            const findParts = /(\d+)([WDHMS])/g;
+            const parts = duration.matchAll(findParts);
+            for (const part of parts) {
+                const value = parseInt(part[1], 10);
+                const name = part[2];
+                switch (name) {
+                    case 'W':
+                        this.weeks = value * negativeMultiplier;
+                        break;
+                    case 'D':
+                        this.days = value * negativeMultiplier;
+                        break;
+                    case 'H':
+                        this.hours = value * negativeMultiplier;
+                        break;
+                    case 'M':
+                        this.minutes = value * negativeMultiplier;
+                        break;
+                    case 'S':
+                        this.seconds = value * negativeMultiplier;
+                        break;
+                }
+            }
+        }
+        else {
+            this.weeks = duration.weeks;
+            this.days = duration.days;
+            this.hours = duration.hours;
+            this.minutes = duration.minutes;
+            this.seconds = duration.seconds;
+        }
+    }
+    /**
+     * Get the length of this duration object in seconds.
+     * @returns The total number of seconds represented by this duration.
+     */
+    inSeconds() {
+        return ((this.weeks ?? 0) * date_1.ONE_WEEK_SECONDS +
+            (this.days ?? 0) * date_1.ONE_DAY_SECONDS +
+            (this.hours ?? 0) * date_1.ONE_HOUR_SECONDS +
+            (this.minutes ?? 0) * date_1.ONE_MINUTE_SECONDS +
+            (this.seconds ?? 0));
+    }
+    /**
+     * Get the length of this duration object in milliseconds.
+     *
+     * Note that this will always return whole seconds, as durations do not
+     * support milliseconds.
+     * @returns The total number of milliseconds represented by this duration.
+     */
+    inMilliseconds() {
+        return this.inSeconds() * date_1.ONE_SECOND_MS;
+    }
+    /**
+     * Get the duration string that represents this duration.
+     * @returns A duration string in the format `P[n]W` for weeks, or `P[n]DT[n]H[n]M[n]S` for days, hours, minutes and seconds. Prefixed with a `-` if negative.
+     */
+    getValue() {
+        return formatDurationString(this.weeks, this.days, this.hours, this.minutes, this.seconds);
+    }
+    /**
+     * Get the floor the duration to the nearest of a given unit.
+     * @param unit The unit to floor to.
+     * @returns The duration with units smaller than `unit` removed.
+     * @example
+     * const duration = new CalendarDuration("1W2D5H30M")
+     * const days = duration.floor("D") // Floor to days
+     * console.log(days.getValue()) // "1W2D"
+     */
+    floor(unit) {
+        const result = new CalendarDuration(this);
+        /* eslint-disable no-fallthrough */
+        switch (unit) {
+            case 'W':
+                result.days = undefined;
+            case 'D':
+                result.hours = undefined;
+            case 'H':
+                result.minutes = undefined;
+            case 'M':
+                result.seconds = undefined;
+        }
+        /* eslint-enable no-fallthrough */
+        return result;
+    }
+    /**
+     * Create a duration from a number of seconds.
+     * @param seconds How many seconds the duration should represent.
+     * @returns A {@link CalendarDuration} representing the specified number of seconds.
+     * @throws {Error} If seconds is NaN.
+     */
+    static fromSeconds(seconds) {
+        return new CalendarDuration(secondsToDurationString(seconds));
+    }
+    /**
+     * Create a duration from a number of days.
+     * @param days How many days the duration should represent.
+     * @returns A {@link CalendarDuration} representing the specified number of days.
+     * @throws {Error} If days is NaN.
+     */
+    static fromDays(days) {
+        return new CalendarDuration(daysToDurationString(days));
+    }
+    /**
+     * Create a duration from a number of weeks.
+     * @param weeks How many weeks the duration should represent.
+     * @returns A {@link CalendarDuration} representing the specified number of weeks.
+     * @throws {Error} If weeks is NaN.
+     */
+    static fromWeeks(weeks) {
+        return new CalendarDuration(weeksToDurationString(weeks));
+    }
+    /**
+     * Creates a duration from the difference between two dates.
+     * @param start The start date or time.
+     * @param end The end date or time.
+     * @returns A {@link CalendarDuration} representing the difference between the two dates.
+     * @throws {Error} If the start date and end date have different types.
+     */
+    static fromDifference(start, end) {
+        if ((0, date_1.isDateObject)(start)) {
+            // Date
+            if ((0, date_1.isDateObject)(end)) {
+                const differenceSeconds = (end.getTime() - start.getTime()) / date_1.ONE_SECOND_MS;
+                return CalendarDuration.fromSeconds(differenceSeconds);
+            }
+        }
+        else if (start.isFullDay()) {
+            // CalendarDate
+            if ((0, date_1.isCalendarDateOrTime)(end) && end.isFullDay()) {
+                const startMs = start.getDate().getTime();
+                const endMs = end.getDate().getTime();
+                const differenceDays = (endMs - startMs) / date_1.ONE_DAY_MS;
+                return CalendarDuration.fromDays(differenceDays);
+            }
+        }
+        else {
+            // CalendarDateTime
+            if ((0, date_1.isCalendarDateOrTime)(end) && !end.isFullDay()) {
+                const startMs = start.getDate().getTime();
+                const endMs = end.getDate().getTime();
+                const differenceSeconds = (endMs - startMs) / date_1.ONE_SECOND_MS;
+                return CalendarDuration.fromSeconds(differenceSeconds);
+            }
+        }
+        throw new Error('Start and end dates must be of the same type');
+    }
+}
+exports.CalendarDuration = CalendarDuration;
+/**
+ * Convert time units to a duration string.
+ *
+ * A duration is considered negative if any unit is less than 0.
+ * @param weeks How many weeks the duration should represent.
+ * @param days The days part of the duration.
+ * @param hours The hours part of the duration.
+ * @param minutes The minutes part of the duration.
+ * @param seconds The seconds part of the duration.
+ * @returns A string representing the duration in the format `P[n]W` or `P[n]DT[n]H[n]M[n]S` where values may be omitted if 0, prefixed with `-` if negative.
+ * @throws {Error} If weeks are combined with other values.
+ * @throws {Error} If any unit is NaN.
+ */
+function formatDurationString(weeks, days, hours, minutes, seconds) {
+    let prefix = '';
+    let durationString = prefix + 'P';
+    let hasTime = false;
+    let isEmpty = true;
+    const appendUnit = (time, unit) => {
+        if (time === undefined)
+            return;
+        if (isNaN(time)) {
+            throw new Error(`${unit} must not be NaN`);
+        }
+        if (time < 0)
+            prefix = '-';
+        const absTime = Math.abs(Math.floor(time));
+        durationString += absTime + unit.charAt(0);
+        isEmpty = false;
+    };
+    const appendTimeUnit = (time, unit) => {
+        if (time === undefined)
+            return;
+        if (!hasTime) {
+            durationString += 'T';
+            hasTime = true;
+        }
+        appendUnit(time, unit);
+    };
+    // Add units
+    if (weeks !== undefined) {
+        if (days !== undefined ||
+            hours !== undefined ||
+            minutes !== undefined ||
+            seconds !== undefined) {
+            throw new Error('Cannot combine weeks with other units in duration string');
+        }
+        appendUnit(weeks, 'Weeks');
+    }
+    appendUnit(days, 'Days');
+    appendTimeUnit(hours, 'Hours');
+    if (minutes !== undefined) {
+        appendTimeUnit(minutes, 'Minutes');
+    }
+    else if (hours !== undefined && seconds !== undefined) {
+        appendTimeUnit(0, 'Minutes');
+    }
+    appendTimeUnit(seconds, 'Seconds');
+    if (isEmpty) {
+        throw new Error('Duration string must not be empty');
+    }
+    return prefix + durationString;
+}
+/**
+ * Convert a number of seconds to a duration string.
+ * @param seconds How many seconds the duration should represent.
+ * @returns A string representing the duration in the format `PT[n]H[n]M[n]S` where values may be omitted if 0, prefixed with `-` if negative.
+ * @throws {Error} If seconds is NaN.
+ */
+function secondsToDurationString(seconds) {
+    if (isNaN(seconds))
+        throw new Error('Seconds must not be NaN');
+    seconds = Math.floor(seconds);
+    const absSeconds = Math.abs(seconds);
+    const minutes = Math.floor(absSeconds / 60);
+    const hours = Math.floor(minutes / 60);
+    let secondsValue = seconds % 60;
+    let minutesValue = minutes % 60;
+    let hoursValue = hours;
+    if (hoursValue === 0)
+        hoursValue = undefined;
+    if (minutesValue === 0)
+        minutesValue = undefined;
+    if (secondsValue === 0 && !(minutesValue === undefined && hoursValue === undefined))
+        secondsValue = undefined;
+    return formatDurationString(undefined, undefined, hoursValue, minutesValue, secondsValue);
+}
+/**
+ * Convert a number of days to a duration string.
+ * @param days How many days the duration should represent.
+ * @returns A string representing the duration in the format `P[n]D`, prefixed with `-` if negative.
+ * @throws {Error} If days is NaN.
+ */
+function daysToDurationString(days) {
+    return formatDurationString(undefined, days, undefined, undefined, undefined);
+}
+/**
+ * Convert a number of weeks to a duration string.
+ * @param weeks How many weeks the duration should represent.
+ * @returns A string representing the duration in the format `P[n]W`, prefixed with `-` if negative.
+ * @throws {Error} If weeks is NaN.
+ */
+function weeksToDurationString(weeks) {
+    return formatDurationString(weeks, undefined, undefined, undefined, undefined);
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZHVyYXRpb24uanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi9zcmMvZHVyYXRpb24udHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6Ijs7O0FBa05BLG9EQXdEQztBQVFELDBEQXNCQztBQVFELG9EQVFDO0FBUUQsc0RBUUM7QUF4VUQsaUNBVWU7QUFDZix5Q0FBNkM7QUFJN0M7O0dBRUc7QUFDSCxNQUFhLGdCQUFnQjtJQUN6QixLQUFLLENBQVM7SUFDZCxJQUFJLENBQVM7SUFDYixLQUFLLENBQVM7SUFDZCxPQUFPLENBQVM7SUFDaEIsT0FBTyxDQUFTO0lBRWhCLFlBQVksUUFBbUM7UUFDM0MsSUFBSSxPQUFPLFFBQVEsS0FBSyxRQUFRLEVBQUUsQ0FBQztZQUMvQixJQUFBLDJCQUFnQixFQUFDLFFBQVEsQ0FBQyxDQUFBO1lBRTFCLE1BQU0sa0JBQWtCLEdBQUcsUUFBUSxDQUFDLFVBQVUsQ0FBQyxHQUFHLENBQUMsQ0FBQyxDQUFDLENBQUMsQ0FBQyxDQUFDLENBQUMsQ0FBQyxDQUFDLENBQUMsQ0FBQTtZQUM1RCxNQUFNLFNBQVMsR0FBRyxpQkFBaUIsQ0FBQTtZQUNuQyxNQUFNLEtBQUssR0FBRyxRQUFRLENBQUMsUUFBUSxDQUFDLFNBQVMsQ0FBQyxDQUFBO1lBQzFDLEtBQUssTUFBTSxJQUFJLElBQUksS0FBSyxFQUFFLENBQUM7Z0JBQ3ZCLE1BQU0sS0FBSyxHQUFHLFFBQVEsQ0FBQyxJQUFJLENBQUMsQ0FBQyxDQUFDLEVBQUUsRUFBRSxDQUFDLENBQUE7Z0JBQ25DLE1BQU0sSUFBSSxHQUFHLElBQUksQ0FBQyxDQUFDLENBQWlCLENBQUE7Z0JBQ3BDLFFBQVEsSUFBSSxFQUFFLENBQUM7b0JBQ1gsS0FBSyxHQUFHO3dCQUNKLElBQUksQ0FBQyxLQUFLLEdBQUcsS0FBSyxHQUFHLGtCQUFrQixDQUFBO3dCQUN2QyxNQUFLO29CQUNULEtBQUssR0FBRzt3QkFDSixJQUFJLENBQUMsSUFBSSxHQUFHLEtBQUssR0FBRyxrQkFBa0IsQ0FB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

package/lib/index.d.ts

@@ -1,6 +1,7 @@
 export * from './component';
 export * from './components';
 export * from './date';
+export * from './duration';
 export * from './io';
 export * from './parse';
 export * from './property';

package/lib/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAA;AAC3B,cAAc,cAAc,CAAA;AAC5B,cAAc,QAAQ,CAAA;AACtB,cAAc,MAAM,CAAA;AACpB,cAAc,SAAS,CAAA;AACvB,cAAc,YAAY,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAA;AAC3B,cAAc,cAAc,CAAA;AAC5B,cAAc,QAAQ,CAAA;AACtB,cAAc,YAAY,CAAA;AAC1B,cAAc,MAAM,CAAA;AACpB,cAAc,SAAS,CAAA;AACvB,cAAc,YAAY,CAAA"}

package/lib/index.js

@@ -17,7 +17,8 @@ Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./component"), exports);
 __exportStar(require("./components"), exports);
 __exportStar(require("./date"), exports);
+__exportStar(require("./duration"), exports);
 __exportStar(require("./io"), exports);
 __exportStar(require("./parse"), exports);
 __exportStar(require("./property"), exports);
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi9zcmMvaW5kZXgudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6Ijs7Ozs7Ozs7Ozs7Ozs7OztBQUFBLDhDQUEyQjtBQUMzQiwrQ0FBNEI7QUFDNUIseUNBQXNCO0FBQ3RCLHVDQUFvQjtBQUNwQiwwQ0FBdUI7QUFDdkIsNkNBQTBCIn0=
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi9zcmMvaW5kZXgudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6Ijs7Ozs7Ozs7Ozs7Ozs7OztBQUFBLDhDQUEyQjtBQUMzQiwrQ0FBNEI7QUFDNUIseUNBQXNCO0FBQ3RCLDZDQUEwQjtBQUMxQix1Q0FBb0I7QUFDcEIsMENBQXVCO0FBQ3ZCLDZDQUEwQiJ9

package/lib/io.d.ts

@@ -5,14 +5,34 @@ import { Calendar } from './components/Calendar';
  * @param path Path to the file.
  * @returns The calendar deserialized from the file.
  * @throws {DeserializationError} If the file content is not a valid calendar.
+ * @deprecated Use `loadCalendarSync` instead.
  */
 export declare function load(path: fs.PathLike): Promise<Calendar>;
+/**
+ * Read a calendar from a iCalendar file.
+ * @param path Path to the file.
+ * @param encoding The file encoding, defaults to UTF-8.
+ * @returns The calendar deserialized from the file.
+ * @throws {DeserializationError} If the file content is not a valid component.
+ * @throws {ComponentValidationError} If the deserialized component is not a VCALENDAR.
+ */
+export declare function loadCalendarSync(path: fs.PathLike, encoding?: BufferEncoding): Calendar;
 /**
  * Write a calendar to a file.
  * @param calendar The calendar to write to file.
  * @param path Path to the file to write.
  * @example
  * dump(myCalendar, 'calendar.ics')
+ * @deprecated Use `dumpCalendarSync` instead.
  */
 export declare function dump(calendar: Calendar, path: string): Promise<void>;
+/**
+ * Write a calendar to a file.
+ * @param calendar The calendar to write to file.
+ * @param path Path to the file to write.
+ * @param encoding The file encoding, defaults to UTF-8.
+ * @example
+ * dump(myCalendar, 'calendar.ics')
+ */
+export declare function dumpCalendarSync(calendar: Calendar, path: string, encoding?: BufferEncoding): void;
 //# sourceMappingURL=io.d.ts.map

package/lib/io.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"io.d.ts","sourceRoot":"","sources":["../src/io.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,CAAA;AAEnB,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAA;AAGhD;;;;;GAKG;AACH,wBAAsB,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,CAc/D;AAED;;;;;;GAMG;AACH,wBAAgB,IAAI,CAAC,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAMpE"}
+{"version":3,"file":"io.d.ts","sourceRoot":"","sources":["../src/io.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,CAAA;AAEnB,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAA;AAQhD;;;;;;GAMG;AACH,wBAAsB,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,CAc/D;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAC5B,IAAI,EAAE,EAAE,CAAC,QAAQ,EACjB,QAAQ,GAAE,cAAuB,GAClC,QAAQ,CAIV;AAED;;;;;;;GAOG;AACH,wBAAgB,IAAI,CAAC,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAMpE;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAC5B,QAAQ,EAAE,QAAQ,EAClB,IAAI,EAAE,MAAM,EACZ,QAAQ,GAAE,cAAuB,GAClC,IAAI,CAGN"}

package/lib/io.js

@@ -4,7 +4,9 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.load = load;
+exports.loadCalendarSync = loadCalendarSync;
 exports.dump = dump;
+exports.dumpCalendarSync = dumpCalendarSync;
 const fs_1 = __importDefault(require("fs"));
 const readline_1 = __importDefault(require("readline"));
 const Calendar_1 = require("./components/Calendar");
@@ -14,6 +16,7 @@ const parse_1 = require("./parse");
  * @param path Path to the file.
  * @returns The calendar deserialized from the file.
  * @throws {DeserializationError} If the file content is not a valid calendar.
+ * @deprecated Use `loadCalendarSync` instead.
  */
 async function load(path) {
     const stream = fs_1.default.createReadStream(path);
@@ -27,12 +30,26 @@ async function load(path) {
     }
     return new Calendar_1.Calendar(component);
 }
+/**
+ * Read a calendar from a iCalendar file.
+ * @param path Path to the file.
+ * @param encoding The file encoding, defaults to UTF-8.
+ * @returns The calendar deserialized from the file.
+ * @throws {DeserializationError} If the file content is not a valid component.
+ * @throws {ComponentValidationError} If the deserialized component is not a VCALENDAR.
+ */
+function loadCalendarSync(path, encoding = 'utf8') {
+    const text = fs_1.default.readFileSync(path, { encoding: encoding });
+    const component = (0, parse_1.deserializeComponentString)(text);
+    return new Calendar_1.Calendar(component);
+}
 /**
  * Write a calendar to a file.
  * @param calendar The calendar to write to file.
  * @param path Path to the file to write.
  * @example
  * dump(myCalendar, 'calendar.ics')
+ * @deprecated Use `dumpCalendarSync` instead.
  */
 function dump(calendar, path) {
     return new Promise(resolve => {
@@ -41,4 +58,16 @@ function dump(calendar, path) {
         });
     });
 }
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW8uanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi9zcmMvaW8udHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6Ijs7Ozs7QUFXQSxvQkFjQztBQVNELG9CQU1DO0FBeENELDRDQUFtQjtBQUNuQix3REFBK0I7QUFDL0Isb0RBQWdEO0FBQ2hELG1DQUFvRTtBQUVwRTs7Ozs7R0FLRztBQUNJLEtBQUssVUFBVSxJQUFJLENBQUMsSUFBaUI7SUFDeEMsTUFBTSxNQUFNLEdBQUcsWUFBRSxDQUFDLGdCQUFnQixDQUFDLElBQUksQ0FBQyxDQUFBO0lBQ3hDLE1BQU0sS0FBSyxHQUFHLGtCQUFRLENBQUMsZUFBZSxDQUFDO1FBQ25DLEtBQUssRUFBRSxNQUFNO1FBQ2IsU0FBUyxFQUFFLFFBQVE7S0FDdEIsQ0FBQyxDQUFBO0lBRUYsTUFBTSxTQUFTLEdBQUcsTUFBTSxJQUFBLDRCQUFvQixFQUFDLEtBQUssQ0FBQyxDQUFBO0lBRW5ELElBQUksU0FBUyxDQUFDLElBQUksSUFBSSxXQUFXLEVBQUUsQ0FBQztRQUNoQyxNQUFNLElBQUksNEJBQW9CLENBQUMsK0JBQStCLENBQUMsQ0FBQTtJQUNuRSxDQUFDO0lBRUQsT0FBTyxJQUFJLG1CQUFRLENBQUMsU0FBUyxDQUFDLENBQUE7QUFDbEMsQ0FBQztBQUVEOzs7Ozs7R0FNRztBQUNILFNBQWdCLElBQUksQ0FBQyxRQUFrQixFQUFFLElBQVk7SUFDakQsT0FBTyxJQUFJLE9BQU8sQ0FBQyxPQUFPLENBQUMsRUFBRTtRQUN6QixZQUFFLENBQUMsU0FBUyxDQUFDLElBQUksRUFBRSxRQUFRLENBQUMsU0FBUyxFQUFFLEVBQUUsR0FBRyxFQUFFO1lBQzFDLE9BQU8sRUFBRSxDQUFBO1FBQ2IsQ0FBQyxDQUFDLENBQUE7SUFDTixDQUFDLENBQUMsQ0FBQTtBQUNOLENBQUMifQ==
+/**
+ * Write a calendar to a file.
+ * @param calendar The calendar to write to file.
+ * @param path Path to the file to write.
+ * @param encoding The file encoding, defaults to UTF-8.
+ * @example
+ * dump(myCalendar, 'calendar.ics')
+ */
+function dumpCalendarSync(calendar, path, encoding = 'utf8') {
+    const text = calendar.serialize();
+    fs_1.default.writeFileSync(path, text, { encoding: encoding });
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW8uanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi9zcmMvaW8udHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6Ijs7Ozs7QUFpQkEsb0JBY0M7QUFVRCw0Q0FPQztBQVVELG9CQU1DO0FBVUQsNENBT0M7QUFqRkQsNENBQW1CO0FBQ25CLHdEQUErQjtBQUMvQixvREFBZ0Q7QUFDaEQsbUNBSWdCO0FBR2hCOzs7Ozs7R0FNRztBQUNJLEtBQUssVUFBVSxJQUFJLENBQUMsSUFBaUI7SUFDeEMsTUFBTSxNQUFNLEdBQUcsWUFBRSxDQUFDLGdCQUFnQixDQUFDLElBQUksQ0FBQyxDQUFBO0lBQ3hDLE1BQU0sS0FBSyxHQUFHLGtCQUFRLENBQUMsZUFBZSxDQUFDO1FBQ25DLEtBQUssRUFBRSxNQUFNO1FBQ2IsU0FBUyxFQUFFLFFBQVE7S0FDdEIsQ0FBQyxDQUFBO0lBRUYsTUFBTSxTQUFTLEdBQUcsTUFBTSxJQUFBLDRCQUFvQixFQUFDLEtBQUssQ0FBQyxDQUFBO0lBRW5ELElBQUksU0FBUyxDQUFDLElBQUksSUFBSSxXQUFXLEVBQUUsQ0FBQztRQUNoQyxNQUFNLElBQUksNEJBQW9CLENBQUMsK0JBQStCLENBQUMsQ0FBQTtJQUNuRSxDQUFDO0lBRUQsT0FBTyxJQUFJLG1CQUFRLENBQUMsU0FBUyxDQUFDLENBQUE7QUFDbEMsQ0FBQztBQUVEOzs7Ozs7O0dBT0c7QUFDSCxTQUFnQixnQkFBZ0IsQ0FDNUIsSUFBaUIsRUFDakIsV0FBMkIsTUFBTTtJQUVqQyxNQUFNLElBQUksR0FBRyxZQUFFLENBQUMsWUFBWSxDQUFDLElBQUksRUFBRSxFQUFFLFFBQVEsRUFBRSxRQUFRLEVBQUUsQ0FBQyxDQUFBO0lBQzFELE1BQU0sU0FBUyxHQUFHLElBQUEsa0NBQTBCLEVBQUMsSUFBSSxDQUFDLENBQUE7SUFDbEQsT0FBTyxJQUFJLG1CQUFRLENBQUMsU0FBUyxDQUFDLENBQUE7QUFDbEMsQ0FBQztBQUVEOzs7Ozs7O0dBT0c7QUFDSCxTQUFnQixJQUFJLENBQUMsUUFBa0IsRUFBRSxJQUFZO0lBQ2pELE9BQU8sSUFBSSxPQUFPLENBQUMsT0FBTyxDQUFDLEVBQUU7UUFDekIsWUFBRSxDQUFDLFNBQVMsQ0FBQyxJQUFJLEVBQUUsUUFBUSxDQUFDLFNBQVMsRUFBRSxFQUFFLEdBQUcsRUFBRTtZQUMxQyxPQUFPLEVBQUUsQ0FBQTtRQUNiLENBQUMsQ0FBQyxDQUFBO0lBQ04sQ0FBQyxDQUFDLENBQUE7QUFDTixDQUFDO0FBRUQ7Ozs7Ozs7R0FPRztBQUNILFNBQWdCLGdCQUFnQixDQUM1QixRQUFrQixFQUNsQixJQUFZLEVBQ1osV0FBMkIsTUFBTTtJQUVqQyxNQUFNLElBQUksR0FBRyxRQUFRLENBQUMsU0FBUyxFQUFFLENBQUE7SUFDakMsWUFBRSxDQUFDLGFBQWEsQ0FBQyxJQUFJLEVBQUUsSUFBSSxFQUFFLEVBQUUsUUFBUSxFQUFFLFFBQVEsRUFBRSxDQUFDLENBQUE7QUFDeEQsQ0FBQyJ9

package/lib/parse.d.ts

@@ -11,27 +11,35 @@ export declare class DeserializationError extends Error {
  * @param lines The serialized component as a **readline** interface.
  * @returns The deserialized calendar component object.
  * @throws {DeserializationError} If the component is invalid.
+ * @deprecated Use the synchronous `deserializeComponentLines` instead.
  */
 export declare function deserializeComponent(lines: readline.Interface): Promise<Component>;
+/**
+ * Deserialize a calendar component from a list of lines.
+ * @param lines The serialized component as a list of lines.
+ * @returns The deserialized calendar component object.
+ * @throws {DeserializationError} If the component is invalid.
+ */
+export declare function deserializeComponentLines(lines: string[]): Component;
 /**
  * Deserialize a calendar component string.
  * @param text The serialized component.
  * @returns The deserialized component object.
  * @throws {DeserializationError} If the component is invalid.
  */
-export declare function deserializeComponentString(text: string): Promise<Component>;
+export declare function deserializeComponentString(text: string): Component;
 /**
  * Parse a serialized calendar.
  * @param text A serialized calendar as you would see in an iCalendar file.
  * @returns The parsed calendar object.
  */
-export declare function parseCalendar(text: string): Promise<Calendar>;
+export declare function parseCalendar(text: string): Calendar;
 /**
  * Parse a serialized calendar event.
  * @param text A serialized event as you would see in an iCalendar file.
  * @returns The parsed event object.
  */
-export declare function parseEvent(text: string): Promise<CalendarEvent>;
+export declare function parseEvent(text: string): CalendarEvent;
 /**
  * Deserialize a component property.
  * @param line The serialized content line that defines this property.

package/lib/parse.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"parse.d.ts","sourceRoot":"","sources":["../src/parse.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,MAAM,UAAU,CAAA;AAE/B,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AACvC,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AAMtD,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAA;AAM9C,+EAA+E;AAC/E,qBAAa,oBAAqB,SAAQ,KAAK;IAC3C,IAAI,SAAyB;CAChC;AAED;;;;;GAKG;AACH,wBAAsB,oBAAoB,CACtC,KAAK,EAAE,QAAQ,CAAC,SAAS,GAC1B,OAAO,CAAC,SAAS,CAAC,CAkHpB;AAED;;;;;GAKG;AACH,wBAAsB,0BAA0B,CAC5C,IAAI,EAAE,MAAM,GACb,OAAO,CAAC,SAAS,CAAC,CAOpB;AAED;;;;GAIG;AACH,wBAAsB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAGnE;AAED;;;;GAIG;AACH,wBAAsB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAGrE;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAC/B,IAAI,EAAE,MAAM,EACZ,MAAM,GAAE,OAAe,GACxB,QAAQ,CA8LV"}
+{"version":3,"file":"parse.d.ts","sourceRoot":"","sources":["../src/parse.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,MAAM,UAAU,CAAA;AAC/B,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AACvC,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AAMtD,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAA;AAM9C,+EAA+E;AAC/E,qBAAa,oBAAqB,SAAQ,KAAK;IAC3C,IAAI,SAAyB;CAChC;AAED;;;;;;GAMG;AACH,wBAAsB,oBAAoB,CACtC,KAAK,EAAE,QAAQ,CAAC,SAAS,GAC1B,OAAO,CAAC,SAAS,CAAC,CAGpB;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,SAAS,CAkHpE;AAqBD;;;;;GAKG;AACH,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAGlE;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,CAGpD;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,CAGtD;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAC/B,IAAI,EAAE,MAAM,EACZ,MAAM,GAAE,OAAe,GACxB,QAAQ,CA8LV"}