@fullcalendar/icalendar 7.0.0-rc.0 → 7.1.0-alpha.0

package/LICENSE.md

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2021 Adam Shaw
+Copyright (c) 2025 Adam Shaw
 
 Permission is hereby granted, free of charge, to any person obtaining
 a copy of this software and associated documentation files (the

package/README.md

@@ -14,7 +14,7 @@ npm install ical.js
 Then, install the FullCalendar core package, the iCalendar plugin, and any other plugins (like [daygrid](https://fullcalendar.io/docs/month-view)):
 
 ```sh
-npm install @fullcalendar/core @fullcalendar/icalendar @fullcalendar/daygrid
+npm install fullcalendar @fullcalendar/icalendar temporal-polyfill
 ```
 
 ## Usage
@@ -22,15 +22,21 @@ npm install @fullcalendar/core @fullcalendar/icalendar @fullcalendar/daygrid
 Instantiate a Calendar with the necessary plugins and options:
 
 ```js
-import { Calendar } from '@fullcalendar/core'
+import { Calendar } from 'fullcalendar'
+import classicThemePlugin from 'fullcalendar/themes/classic'
+import dayGridPlugin from 'fullcalendar/daygrid'
 import iCalendarPlugin from '@fullcalendar/icalendar'
-import dayGridPlugin from '@fullcalendar/daygrid'
+
+import 'fullcalendar/skeleton.css'
+import 'fullcalendar/themes/classic/theme.css'
+import 'fullcalendar/themes/classic/palette.css'
 
 const calendarEl = document.getElementById('calendar')
 const calendar = new Calendar(calendarEl, {
   plugins: [
     iCalendarPlugin,
-    dayGridPlugin
+    dayGridPlugin,
+    classicThemePlugin
   ],
   initialView: 'dayGridMonth',
   events: {

package/{index.global.js → global.js}

@@ -1,14 +1,39 @@
 /*!
-FullCalendar iCalendar Plugin v7.0.0-rc.0
+FullCalendar iCalendar Plugin v7.1.0-alpha.0
 Docs & License: https://fullcalendar.io/docs/icalendar
-(c) 2024 Adam Shaw
+(c) 2025 Adam Shaw
 */
-FullCalendar.ICalendar = (function (exports, core, internal, ICAL) {
+(function (ICAL) {
     'use strict';
 
-    function _interopDefault (e) { return e && e.__esModule ? e : { 'default': e }; }
+    function _interopDefaultLegacy (e) { return e && typeof e === 'object' && 'default' in e ? e : { 'default': e }; }
 
-    var ICAL__default = /*#__PURE__*/_interopDefault(ICAL);
+    var ICAL__default = /*#__PURE__*/_interopDefaultLegacy(ICAL);
+
+    function addDays(m, n) {
+        let a = dateToUtcArray(m);
+        a[2] += n;
+        return arrayToUtcDate(a);
+    }
+    function dateToUtcArray(date) {
+        return [
+            date.getUTCFullYear(),
+            date.getUTCMonth(),
+            date.getUTCDate(),
+            date.getUTCHours(),
+            date.getUTCMinutes(),
+            date.getUTCSeconds(),
+            date.getUTCMilliseconds(),
+        ];
+    }
+    function arrayToUtcDate(a) {
+        // according to web standards (and Safari), a month index is required.
+        // massage if only given a year.
+        if (a.length === 1) {
+            a = a.concat([0]);
+        }
+        return new Date(Date.UTC(...a));
+    }
 
     /* eslint-disable */
     class IcalExpander {
@@ -120,7 +145,8 @@ FullCalendar.ICalendar = (function (exports, core, internal, ICAL) {
             }
             return null;
         },
-        fetch(arg, successCallback, errorCallback) {
+        fetch(arg, successCallback, // any
+        errorCallback) {
             let meta = arg.eventSource.meta;
             let { internalState } = meta;
             /*
@@ -152,24 +178,32 @@ FullCalendar.ICalendar = (function (exports, core, internal, ICAL) {
     function expandICalEvents(iCalExpander, range) {
         // expand the range. because our `range` is timeZone-agnostic UTC
         // or maybe because ical.js always produces dates in local time? i forget
-        let rangeStart = internal.addDays(range.start, -1);
-        let rangeEnd = internal.addDays(range.end, 1);
+        let rangeStart = addDays(range.start, -1);
+        let rangeEnd = addDays(range.end, 1);
         let iCalRes = iCalExpander.between(rangeStart, rangeEnd); // end inclusive. will give extra results
         let expanded = [];
         // TODO: instead of using startDate/endDate.toString to communicate allDay,
         // we can query startDate/endDate.isDate. More efficient to avoid formatting/reparsing.
         // single events
         for (let iCalEvent of iCalRes.events) {
-            expanded.push(Object.assign(Object.assign({}, buildNonDateProps(iCalEvent)), { start: iCalEvent.startDate.toString(), end: (specifiesEnd(iCalEvent) && iCalEvent.endDate)
+            expanded.push({
+                ...buildNonDateProps(iCalEvent),
+                start: iCalEvent.startDate.toString(),
+                end: (specifiesEnd(iCalEvent) && iCalEvent.endDate)
                     ? iCalEvent.endDate.toString()
-                    : null }));
+                    : null,
+            });
         }
         // recurring event instances
         for (let iCalOccurence of iCalRes.occurrences) {
             let iCalEvent = iCalOccurence.item;
-            expanded.push(Object.assign(Object.assign({}, buildNonDateProps(iCalEvent)), { start: iCalOccurence.startDate.toString(), end: (specifiesEnd(iCalEvent) && iCalOccurence.endDate)
+            expanded.push({
+                ...buildNonDateProps(iCalEvent),
+                start: iCalOccurence.startDate.toString(),
+                end: (specifiesEnd(iCalEvent) && iCalOccurence.endDate)
                     ? iCalOccurence.endDate.toString()
-                    : null }));
+                    : null,
+            });
         }
         return expanded;
     }
@@ -193,17 +227,11 @@ FullCalendar.ICalendar = (function (exports, core, internal, ICAL) {
             Boolean(iCalEvent.component.getFirstProperty('duration'));
     }
 
-    var plugin = core.createPlugin({
-        name: '@fullcalendar/icalendar',
+    var plugin = {
+        name: 'icalendar',
         eventSourceDefs: [eventSourceDef],
-    });
-
-    core.globalPlugins.push(plugin);
-
-    exports["default"] = plugin;
-
-    Object.defineProperty(exports, '__esModule', { value: true });
+    };
 
-    return exports;
+    FullCalendar.globalPlugins.push(plugin);
 
-})({}, FullCalendar, FullCalendar.Internal, ICAL);
+})(ICAL);

package/index.d.ts

@@ -1,6 +1,60 @@
-import { PluginDef } from '@fullcalendar/core';
+import ICAL from 'ical.js';
+import * as _full_ui_headless_calendar from '@full-ui/headless-calendar';
 
-declare const _default: PluginDef;
+declare class IcalExpander {
+    constructor(opts: any);
+    maxIterations: any;
+    skipInvalidDates: any;
+    jCalData: any;
+    component: ICAL.Component;
+    events: ICAL.Event[];
+    between(after: any, before: any): {
+        events: any[];
+        occurrences: any[];
+    };
+    before(before: any): {
+        events: any[];
+        occurrences: any[];
+    };
+    after(after: any): {
+        events: any[];
+        occurrences: any[];
+    };
+    all(): {
+        events: any[];
+        occurrences: any[];
+    };
+}
+
+interface ICalFeedMeta {
+    url: string;
+    format: 'ics';
+    internalState?: InternalState;
+}
+interface InternalState {
+    iCalExpanderPromise: Promise<IcalExpander>;
+    response: Response | null;
+}
+
+declare const _default: {
+    name: string;
+    eventSourceDefs: {
+        parseMeta(refined: {
+            url: string;
+            format: string;
+        }): {
+            url: string;
+            format: string;
+        };
+        fetch(arg: {
+            isRefetch: boolean;
+            range: _full_ui_headless_calendar.DateRange;
+            eventSource: {
+                meta: ICalFeedMeta;
+            };
+        }, successCallback: any, errorCallback: any): void;
+    }[];
+};
 //# sourceMappingURL=index.d.ts.map
 
 export { _default as default };

package/index.js

@@ -1,5 +1,4 @@
-import { createPlugin } from '@fullcalendar/core/index.js';
-import { addDays } from '@fullcalendar/core/internal.js';
+import { addDays } from '@full-ui/headless-calendar';
 import ICAL from 'ical.js';
 
 /* eslint-disable */
@@ -112,7 +111,8 @@ const eventSourceDef = {
         }
         return null;
     },
-    fetch(arg, successCallback, errorCallback) {
+    fetch(arg, successCallback, // any
+    errorCallback) {
         let meta = arg.eventSource.meta;
         let { internalState } = meta;
         /*
@@ -152,16 +152,24 @@ function expandICalEvents(iCalExpander, range) {
     // we can query startDate/endDate.isDate. More efficient to avoid formatting/reparsing.
     // single events
     for (let iCalEvent of iCalRes.events) {
-        expanded.push(Object.assign(Object.assign({}, buildNonDateProps(iCalEvent)), { start: iCalEvent.startDate.toString(), end: (specifiesEnd(iCalEvent) && iCalEvent.endDate)
+        expanded.push({
+            ...buildNonDateProps(iCalEvent),
+            start: iCalEvent.startDate.toString(),
+            end: (specifiesEnd(iCalEvent) && iCalEvent.endDate)
                 ? iCalEvent.endDate.toString()
-                : null }));
+                : null,
+        });
     }
     // recurring event instances
     for (let iCalOccurence of iCalRes.occurrences) {
         let iCalEvent = iCalOccurence.item;
-        expanded.push(Object.assign(Object.assign({}, buildNonDateProps(iCalEvent)), { start: iCalOccurence.startDate.toString(), end: (specifiesEnd(iCalEvent) && iCalOccurence.endDate)
+        expanded.push({
+            ...buildNonDateProps(iCalEvent),
+            start: iCalOccurence.startDate.toString(),
+            end: (specifiesEnd(iCalEvent) && iCalOccurence.endDate)
                 ? iCalOccurence.endDate.toString()
-                : null }));
+                : null,
+        });
     }
     return expanded;
 }
@@ -185,9 +193,9 @@ function specifiesEnd(iCalEvent) {
         Boolean(iCalEvent.component.getFirstProperty('duration'));
 }
 
-var index = createPlugin({
-    name: '@fullcalendar/icalendar',
+var index = {
+    name: 'icalendar',
     eventSourceDefs: [eventSourceDef],
-});
+};
 
 export { index as default };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fullcalendar/icalendar",
-  "version": "7.0.0-rc.0",
+  "version": "7.1.0-alpha.0",
   "title": "FullCalendar iCalendar Plugin",
   "description": "Display events from a public iCalendar feed",
   "keywords": [
@@ -12,9 +12,13 @@
     "ics"
   ],
   "homepage": "https://fullcalendar.io/docs/icalendar",
+  "dependencies": {
+    "@full-ui/headless-calendar": "7.1.0-alpha.0",
+    "@fullcalendar/core": "7.1.0-alpha.0"
+  },
   "peerDependencies": {
-    "@fullcalendar/core": "7.0.0-rc.0",
-    "ical.js": "^2.0.0"
+    "ical.js": "^2.0.0",
+    "temporal-polyfill": "^0.3.2"
   },
   "type": "module",
   "bugs": "https://fullcalendar.io/reporting-bugs",
@@ -29,21 +33,17 @@
     "email": "arshaw@arshaw.com",
     "url": "http://arshaw.com/"
   },
-  "copyright": "2024 Adam Shaw",
+  "copyright": "2025 Adam Shaw",
   "types": "./index.d.ts",
-  "main": "./index.cjs",
-  "module": "./index.js",
-  "unpkg": "./index.global.min.js",
-  "jsdelivr": "./index.global.min.js",
+  "main": "./index.js",
   "exports": {
     "./package.json": "./package.json",
-    "./index.cjs": "./index.cjs",
-    "./index.js": "./index.js",
     ".": {
       "types": "./index.d.ts",
-      "require": "./index.cjs",
-      "import": "./index.js"
+      "default": "./index.js"
     }
   },
-  "sideEffects": false
+  "sideEffects": [
+    "./global.js"
+  ]
 }

package/index.cjs

@@ -1,201 +0,0 @@
-'use strict';
-
-Object.defineProperty(exports, '__esModule', { value: true });
-
-var index_cjs = require('@fullcalendar/core/index.cjs');
-var internal_cjs = require('@fullcalendar/core/internal.cjs');
-var ICAL = require('ical.js');
-
-function _interopDefaultLegacy (e) { return e && typeof e === 'object' && 'default' in e ? e : { 'default': e }; }
-
-var ICAL__default = /*#__PURE__*/_interopDefaultLegacy(ICAL);
-
-/* eslint-disable */
-class IcalExpander {
-    constructor(opts) {
-        this.maxIterations = opts.maxIterations != null ? opts.maxIterations : 1000;
-        this.skipInvalidDates = opts.skipInvalidDates != null ? opts.skipInvalidDates : false;
-        this.jCalData = ICAL__default["default"].parse(opts.ics);
-        this.component = new ICAL__default["default"].Component(this.jCalData);
-        this.events = this.component.getAllSubcomponents('vevent').map(vevent => new ICAL__default["default"].Event(vevent));
-        if (this.skipInvalidDates) {
-            this.events = this.events.filter((evt) => {
-                try {
-                    evt.startDate.toJSDate();
-                    evt.endDate.toJSDate();
-                    return true;
-                }
-                catch (err) {
-                    // skipping events with invalid time
-                    return false;
-                }
-            });
-        }
-    }
-    between(after, before) {
-        function isEventWithinRange(startTime, endTime) {
-            return (!after || endTime >= after.getTime()) &&
-                (!before || startTime <= before.getTime());
-        }
-        function getTimes(eventOrOccurrence) {
-            const startTime = eventOrOccurrence.startDate.toJSDate().getTime();
-            let endTime = eventOrOccurrence.endDate.toJSDate().getTime();
-            // If it is an all day event, the end date is set to 00:00 of the next day
-            // So we need to make it be 23:59:59 to compare correctly with the given range
-            if (eventOrOccurrence.endDate.isDate && (endTime > startTime)) {
-                endTime -= 1;
-            }
-            return { startTime, endTime };
-        }
-        const exceptions = [];
-        this.events.forEach((event) => {
-            if (event.isRecurrenceException())
-                exceptions.push(event);
-        });
-        const ret = {
-            events: [],
-            occurrences: [],
-        };
-        this.events.filter(e => !e.isRecurrenceException()).forEach((event) => {
-            const exdates = [];
-            event.component.getAllProperties('exdate').forEach((exdateProp) => {
-                const exdate = exdateProp.getFirstValue();
-                exdates.push(exdate.toJSDate().getTime());
-            });
-            // Recurring event is handled differently
-            if (event.isRecurring()) {
-                const iterator = event.iterator();
-                let next;
-                let i = 0;
-                do {
-                    i += 1;
-                    next = iterator.next();
-                    if (next) {
-                        const occurrence = event.getOccurrenceDetails(next);
-                        const { startTime, endTime } = getTimes(occurrence);
-                        const isOccurrenceExcluded = exdates.indexOf(startTime) !== -1;
-                        // TODO check that within same day?
-                        const exception = exceptions.find(ex => ex.uid === event.uid && ex.recurrenceId.toJSDate().getTime() === occurrence.startDate.toJSDate().getTime());
-                        // We have passed the max date, stop
-                        if (before && startTime > before.getTime())
-                            break;
-                        // Check that we are within our range
-                        if (isEventWithinRange(startTime, endTime)) {
-                            if (exception) {
-                                ret.events.push(exception);
-                            }
-                            else if (!isOccurrenceExcluded) {
-                                ret.occurrences.push(occurrence);
-                            }
-                        }
-                    }
-                } while (next && (!this.maxIterations || i < this.maxIterations));
-                return;
-            }
-            // Non-recurring event:
-            const { startTime, endTime } = getTimes(event);
-            if (isEventWithinRange(startTime, endTime))
-                ret.events.push(event);
-        });
-        return ret;
-    }
-    before(before) {
-        return this.between(undefined, before);
-    }
-    after(after) {
-        return this.between(after);
-    }
-    all() {
-        return this.between();
-    }
-}
-
-const eventSourceDef = {
-    parseMeta(refined) {
-        if (refined.url && refined.format === 'ics') {
-            return {
-                url: refined.url,
-                format: 'ics',
-            };
-        }
-        return null;
-    },
-    fetch(arg, successCallback, errorCallback) {
-        let meta = arg.eventSource.meta;
-        let { internalState } = meta;
-        /*
-        NOTE: isRefetch is a HACK. we would do the recurring-expanding in a separate plugin hook,
-        but we couldn't leverage built-in allDay-guessing, among other things.
-        */
-        if (!internalState || arg.isRefetch) {
-            internalState = meta.internalState = {
-                response: null,
-                iCalExpanderPromise: fetch(meta.url, { method: 'GET' }).then((response) => {
-                    return response.text().then((icsText) => {
-                        internalState.response = response;
-                        return new IcalExpander({
-                            ics: icsText,
-                            skipInvalidDates: true,
-                        });
-                    });
-                }),
-            };
-        }
-        internalState.iCalExpanderPromise.then((iCalExpander) => {
-            successCallback({
-                rawEvents: expandICalEvents(iCalExpander, arg.range),
-                response: internalState.response,
-            });
-        }, errorCallback);
-    },
-};
-function expandICalEvents(iCalExpander, range) {
-    // expand the range. because our `range` is timeZone-agnostic UTC
-    // or maybe because ical.js always produces dates in local time? i forget
-    let rangeStart = internal_cjs.addDays(range.start, -1);
-    let rangeEnd = internal_cjs.addDays(range.end, 1);
-    let iCalRes = iCalExpander.between(rangeStart, rangeEnd); // end inclusive. will give extra results
-    let expanded = [];
-    // TODO: instead of using startDate/endDate.toString to communicate allDay,
-    // we can query startDate/endDate.isDate. More efficient to avoid formatting/reparsing.
-    // single events
-    for (let iCalEvent of iCalRes.events) {
-        expanded.push(Object.assign(Object.assign({}, buildNonDateProps(iCalEvent)), { start: iCalEvent.startDate.toString(), end: (specifiesEnd(iCalEvent) && iCalEvent.endDate)
-                ? iCalEvent.endDate.toString()
-                : null }));
-    }
-    // recurring event instances
-    for (let iCalOccurence of iCalRes.occurrences) {
-        let iCalEvent = iCalOccurence.item;
-        expanded.push(Object.assign(Object.assign({}, buildNonDateProps(iCalEvent)), { start: iCalOccurence.startDate.toString(), end: (specifiesEnd(iCalEvent) && iCalOccurence.endDate)
-                ? iCalOccurence.endDate.toString()
-                : null }));
-    }
-    return expanded;
-}
-function buildNonDateProps(iCalEvent) {
-    return {
-        title: iCalEvent.summary,
-        url: extractEventUrl(iCalEvent),
-        extendedProps: {
-            location: iCalEvent.location,
-            organizer: iCalEvent.organizer,
-            description: iCalEvent.description,
-        },
-    };
-}
-function extractEventUrl(iCalEvent) {
-    let urlProp = iCalEvent.component.getFirstProperty('url');
-    return urlProp ? urlProp.getFirstValue() : '';
-}
-function specifiesEnd(iCalEvent) {
-    return Boolean(iCalEvent.component.getFirstProperty('dtend')) ||
-        Boolean(iCalEvent.component.getFirstProperty('duration'));
-}
-
-var index = index_cjs.createPlugin({
-    name: '@fullcalendar/icalendar',
-    eventSourceDefs: [eventSourceDef],
-});
-
-exports["default"] = index;

package/index.global.min.js

@@ -1,6 +0,0 @@
-/*!
-FullCalendar iCalendar Plugin v7.0.0-rc.0
-Docs & License: https://fullcalendar.io/docs/icalendar
-(c) 2024 Adam Shaw
-*/
-FullCalendar.ICalendar=function(e,t,n,r){"use strict";function a(e){return e&&e.__esModule?e:{default:e}}var s=a(r);class i{constructor(e){this.maxIterations=null!=e.maxIterations?e.maxIterations:1e3,this.skipInvalidDates=null!=e.skipInvalidDates&&e.skipInvalidDates,this.jCalData=s.default.parse(e.ics),this.component=new s.default.Component(this.jCalData),this.events=this.component.getAllSubcomponents("vevent").map(e=>new s.default.Event(e)),this.skipInvalidDates&&(this.events=this.events.filter(e=>{try{return e.startDate.toJSDate(),e.endDate.toJSDate(),!0}catch(e){return!1}}))}between(e,t){function n(n,r){return(!e||r>=e.getTime())&&(!t||n<=t.getTime())}function r(e){const t=e.startDate.toJSDate().getTime();let n=e.endDate.toJSDate().getTime();return e.endDate.isDate&&n>t&&(n-=1),{startTime:t,endTime:n}}const a=[];this.events.forEach(e=>{e.isRecurrenceException()&&a.push(e)});const s={events:[],occurrences:[]};return this.events.filter(e=>!e.isRecurrenceException()).forEach(e=>{const i=[];if(e.component.getAllProperties("exdate").forEach(e=>{const t=e.getFirstValue();i.push(t.toJSDate().getTime())}),e.isRecurring()){const o=e.iterator();let l,u=0;do{if(u+=1,l=o.next(),l){const o=e.getOccurrenceDetails(l),{startTime:u,endTime:c}=r(o),d=-1!==i.indexOf(u),p=a.find(t=>t.uid===e.uid&&t.recurrenceId.toJSDate().getTime()===o.startDate.toJSDate().getTime());if(t&&u>t.getTime())break;n(u,c)&&(p?s.events.push(p):d||s.occurrences.push(o))}}while(l&&(!this.maxIterations||u<this.maxIterations));return}const{startTime:o,endTime:l}=r(e);n(o,l)&&s.events.push(e)}),s}before(e){return this.between(void 0,e)}after(e){return this.between(e)}all(){return this.between()}}const o={parseMeta:e=>e.url&&"ics"===e.format?{url:e.url,format:"ics"}:null,fetch(e,t,n){let r=e.eventSource.meta,{internalState:a}=r;a&&!e.isRefetch||(a=r.internalState={response:null,iCalExpanderPromise:fetch(r.url,{method:"GET"}).then(e=>e.text().then(t=>(a.response=e,new i({ics:t,skipInvalidDates:!0}))))}),a.iCalExpanderPromise.then(n=>{t({rawEvents:l(n,e.range),response:a.response})},n)}};function l(e,t){let r=n.addDays(t.start,-1),a=n.addDays(t.end,1),s=e.between(r,a),i=[];for(let e of s.events)i.push(Object.assign(Object.assign({},u(e)),{start:e.startDate.toString(),end:d(e)&&e.endDate?e.endDate.toString():null}));for(let e of s.occurrences){let t=e.item;i.push(Object.assign(Object.assign({},u(t)),{start:e.startDate.toString(),end:d(t)&&e.endDate?e.endDate.toString():null}))}return i}function u(e){return{title:e.summary,url:c(e),extendedProps:{location:e.location,organizer:e.organizer,description:e.description}}}function c(e){let t=e.component.getFirstProperty("url");return t?t.getFirstValue():""}function d(e){return Boolean(e.component.getFirstProperty("dtend"))||Boolean(e.component.getFirstProperty("duration"))}var p=t.createPlugin({name:"@fullcalendar/icalendar",eventSourceDefs:[o]});return t.globalPlugins.push(p),e.default=p,Object.defineProperty(e,"__esModule",{value:!0}),e}({},FullCalendar,FullCalendar.Internal,ICAL);