@react-x11/components 0.1.0 → 0.2.1

package/dist/desktop-calendar/eds.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"eds.d.ts","sourceRoot":"","sources":["../../src/desktop-calendar/eds.ts"],"names":[],"mappings":"AAmBA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AA2B5C,4CAA4C;AAC5C,MAAM,WAAW,mBAAmB;IAClC,GAAG,EAAE,MAAM,CAAC;IACZ,uDAAuD;IACvD,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;IACjB,yEAAyE;IACzE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,6CAA6C;IAC7C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,OAAO,CAAC;IAClB,gEAAgE;IAChE,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,mEAAmE;AACnE,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,IAAI,CAAC;IACZ,GAAG,EAAE,IAAI,CAAC;IACV,MAAM,EAAE,OAAO,CAAC;IAChB,SAAS,EAAE,OAAO,CAAC;IACnB,QAAQ,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CACzD;AAED,6EAA6E;AAC7E,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,mBAAmB,CAAC;IAC9B,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,YAAY,EAAE,CAAC;IACvB,MAAM,EAAE,oBAAoB,EAAE,CAAC;CAChC;AAED,2EAA2E;AAC3E,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,mBAAmB,CAAC;IAC9B,IAAI,EAAE,cAAc,GAAG,iBAAiB,GAAG,gBAAgB,CAAC;IAC5D,KAAK,EAAE,MAAM,CAAC;CACf;AAiBD;;;;GAIG;AACH,wBAAgB,YAAY,CAC1B,IAAI,EAAE,MAAM,GACX,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAmBxC;AAkBD;;;;;;;;;;;;;GAaG;AACH,qBAAa,eAAe;;IAM1B,YAAY,GAAG,EAAE,UAAU,EAE1B;IAED,+DAA+D;IACzD,aAAa,IAAI,OAAO,CAAC,mBAAmB,EAAE,CAAC,CA6BpD;IAoDD;;;;;;;OAOG;IACG,aAAa,CACjB,IAAI,EAAE,IAAI,EACV,EAAE,EAAE,IAAI,EACR,OAAO,GAAE;QAAE,SAAS,CAAC,EAAE,mBAAmB,EAAE,CAAA;KAAO,GAClD,OAAO,CAAC,YAAY,CAAC,CAoCvB;IAgFD;;;;;;;;;;;;OAYG;IACG,KAAK,CACT,IAAI,EAAE,IAAI,EACV,EAAE,EAAE,IAAI,EACR,QAAQ,EAAE,CAAC,MAAM,EAAE,cAAc,KAAK,IAAI,EAC1C,OAAO,GAAE;QAAE,SAAS,CAAC,EAAE,mBAAmB,EAAE,CAAA;KAAO,GAClD,OAAO,CAAC,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,CAgE9B;IAED,yEAAyE;IACnE,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAY7B;CACF"}

package/dist/desktop-calendar/eds.js

@@ -0,0 +1,356 @@
+import { loadIcal } from './ical.js';
+const SOURCES_NAME = 'org.gnome.evolution.dataserver.Sources5';
+const SOURCES_PATH = '/org/gnome/evolution/dataserver/SourceManager';
+const OBJECT_MANAGER = 'org.freedesktop.DBus.ObjectManager';
+const FACTORY_NAME = 'org.gnome.evolution.dataserver.Calendar8';
+const FACTORY_PATH = '/org/gnome/evolution/dataserver/CalendarFactory';
+const FACTORY_IFACE = 'org.gnome.evolution.dataserver.CalendarFactory';
+const CAL_IFACE = 'org.gnome.evolution.dataserver.Calendar';
+const VIEW_IFACE = 'org.gnome.evolution.dataserver.CalendarView';
+/**
+ * `E_CAL_CLIENT_VIEW_FLAGS_NONE`. A view is created with
+ * `NOTIFY_INITIAL` instead, which makes `Start()` replay everything already
+ * matching the query as `ObjectsAdded` — the current contents, announced as
+ * if they had just changed.
+ *
+ * That is the wrong signal for a watcher whose answer to a change is to run
+ * the query again: the re-query tears the view down, starts a new one, and is
+ * told the same thing again, for as long as the app is open. Flags of NONE is
+ * the whole of "only tell me what changes from here".
+ */
+const VIEW_FLAGS_NONE = 0;
+const pad = (n) => String(n).padStart(2, '0');
+/** `20260807T113000Z` — what the S-expression query wants. */
+function icalStamp(d) {
+    return (`${d.getUTCFullYear()}${pad(d.getUTCMonth() + 1)}${pad(d.getUTCDate())}T` +
+        `${pad(d.getUTCHours())}${pad(d.getUTCMinutes())}${pad(d.getUTCSeconds())}Z`);
+}
+/** The query EDS understands for "anything happening between these two". */
+function rangeQuery(from, to) {
+    return `(occur-in-time-range? (make-time "${icalStamp(from)}") (make-time "${icalStamp(to)}"))`;
+}
+/**
+ * A source's whole configuration is an ini-style keyfile carried in one D-Bus
+ * property, so it has to be parsed to find out whether a source is even a
+ * calendar (as opposed to an address book, a mail account or a task list).
+ */
+export function parseKeyFile(text) {
+    const out = {};
+    let section = null;
+    for (const raw of text.split('\n')) {
+        const line = raw.trim();
+        if (!line || line.startsWith('#'))
+            continue;
+        if (line.startsWith('[') && line.endsWith(']')) {
+            section = line.slice(1, -1);
+            out[section] = out[section] ?? {};
+            continue;
+        }
+        if (!section)
+            continue;
+        const eq = line.indexOf('=');
+        if (eq === -1)
+            continue;
+        const key = line.slice(0, eq).trim();
+        if (key.includes('['))
+            continue; // a DisplayName[ru] translation
+        out[section][key] = line.slice(eq + 1).trim();
+    }
+    return out;
+}
+/**
+ * The desktop's calendars, read over a bus someone else owns.
+ *
+ * ```ts
+ * const ref = await sessionBus();
+ * if (!ref) return;                       // no bus here; no calendars
+ * const desktop = new DesktopCalendar(ref.bus);
+ * const { events } = await desktop.eventsBetween(from, to);
+ * ```
+ *
+ * Nothing here closes the connection, because nothing here opened it. Call
+ * `dispose()` to drop the views this instance started, then release your own
+ * reference to the bus.
+ */
+export class DesktopCalendar {
+    #bus;
+    #open = new Map();
+    #views = [];
+    #timezones = new Set();
+    constructor(bus) {
+        this.#bus = bus;
+    }
+    /** Every calendar the desktop knows about, colour included. */
+    async listCalendars() {
+        const om = (await this.#bus
+            .getService(SOURCES_NAME)
+            .getInterface(SOURCES_PATH, OBJECT_MANAGER));
+        const managed = await om.GetManagedObjects();
+        const calendars = [];
+        for (const interfaces of Object.values(managed)) {
+            const src = interfaces['org.gnome.evolution.dataserver.Source'];
+            if (!src)
+                continue;
+            const cfg = parseKeyFile(String(src.Data ?? ''));
+            // no [Calendar] section means an address book, a task list or mail
+            if (!cfg.Calendar)
+                continue;
+            const ds = cfg['Data Source'] ?? {};
+            calendars.push({
+                uid: String(src.UID ?? ''),
+                name: ds.DisplayName ?? '',
+                enabled: ds.Enabled !== 'false',
+                color: cfg.Calendar.Color,
+                backend: cfg.Calendar.BackendName,
+                readOnly: !interfaces['org.gnome.evolution.dataserver.Source.Writable'],
+                account: cfg['GNOME Online Accounts']?.Account,
+            });
+        }
+        return calendars;
+    }
+    async #openCalendar(uid) {
+        const existing = this.#open.get(uid);
+        if (existing)
+            return existing;
+        const factory = (await this.#bus
+            .getService(FACTORY_NAME)
+            .getInterface(FACTORY_PATH, FACTORY_IFACE));
+        const [path, busName] = await factory.OpenCalendar(uid);
+        const cal = (await this.#bus
+            .getService(busName)
+            .getInterface(path, CAL_IFACE));
+        await cal.Open();
+        const entry = { cal, busName };
+        this.#open.set(uid, entry);
+        return entry;
+    }
+    /**
+     * Events reference timezones by id, but the payload rarely carries the
+     * matching VTIMEZONE — so definitions are fetched on demand and registered
+     * with ical.js. A backend that has none leaves the time floating, which is
+     * ical.js's own fallback and better than refusing the event.
+     */
+    async #ensureTimezone(ICAL, cal, tzid) {
+        if (!tzid || this.#timezones.has(tzid) || ICAL.TimezoneService.has(tzid)) {
+            return;
+        }
+        this.#timezones.add(tzid);
+        try {
+            const vtz = await cal.GetTimezone(tzid);
+            const comp = new ICAL.Component(ICAL.parse(vtz));
+            const sub = comp.name === 'vtimezone'
+                ? comp
+                : comp.getFirstSubcomponent('vtimezone');
+            if (sub)
+                ICAL.TimezoneService.register(tzid, new ICAL.Timezone(sub));
+        }
+        catch {
+            /* no definition for it; ical.js falls back to floating time */
+        }
+    }
+    /**
+     * Expanded occurrences between two `Date`s, across the calendars given (or
+     * every enabled one). Sorted by start.
+     *
+     * A backend that is offline or broken contributes an entry in `errors`
+     * rather than throwing: one unreachable CalDAV server must not blank a
+     * whole month of the user's own local calendar.
+     */
+    async eventsBetween(from, to, options = {}) {
+        const ICAL = await loadIcal();
+        const list = options.calendars ??
+            (await this.listCalendars()).filter((c) => c.enabled);
+        const query = rangeQuery(from, to);
+        const perCalendar = await Promise.all(list.map(async (meta) => {
+            try {
+                const { cal } = await this.#openCalendar(meta.uid);
+                const objects = await cal.GetObjectList(query);
+                return {
+                    events: await this.#expand(ICAL, cal, objects, from, to, meta),
+                    error: null,
+                };
+            }
+            catch (err) {
+                return {
+                    events: [],
+                    error: {
+                        calendar: meta,
+                        message: err instanceof Error ? err.message : String(err),
+                    },
+                };
+            }
+        }));
+        const events = [];
+        const errors = [];
+        for (const chunk of perCalendar) {
+            events.push(...chunk.events);
+            if (chunk.error)
+                errors.push(chunk.error);
+        }
+        events.sort((a, b) => a.start.getTime() - b.start.getTime());
+        return { events, errors };
+    }
+    async #expand(ICAL, cal, objects, from, to, meta) {
+        const out = [];
+        for (const ics of objects) {
+            let comp;
+            try {
+                comp = new ICAL.Component(ICAL.parse(ics));
+            }
+            catch {
+                continue; // one unparseable object is not the range's problem
+            }
+            // Register any VTIMEZONE shipped inline, then any referenced by id.
+            for (const vtz of comp.getAllSubcomponents('vtimezone')) {
+                const tz = new ICAL.Timezone(vtz);
+                if (!ICAL.TimezoneService.has(tz.tzid)) {
+                    ICAL.TimezoneService.register(tz.tzid, tz);
+                }
+            }
+            const vevents = comp.name === 'vevent' ? [comp] : comp.getAllSubcomponents('vevent');
+            for (const ve of vevents) {
+                for (const prop of ['dtstart', 'dtend']) {
+                    const p = ve.getFirstProperty(prop);
+                    if (p)
+                        await this.#ensureTimezone(ICAL, cal, p.getParameter('tzid'));
+                }
+                const event = new ICAL.Event(ve);
+                // folded in by the recurrence iterator below
+                if (event.isRecurrenceException())
+                    continue;
+                const push = (startTime, endTime) => {
+                    const start = startTime.toJSDate();
+                    const end = endTime ? endTime.toJSDate() : start;
+                    if (end < from || start >= to)
+                        return;
+                    out.push({
+                        uid: event.uid,
+                        summary: event.summary || '',
+                        location: event.location || undefined,
+                        description: event.description || undefined,
+                        start,
+                        end,
+                        allDay: event.startDate.isDate,
+                        recurring: event.isRecurring(),
+                        calendar: { uid: meta.uid, name: meta.name, color: meta.color },
+                    });
+                };
+                if (!event.isRecurring()) {
+                    push(event.startDate, event.endDate);
+                    continue;
+                }
+                const duration = event.duration;
+                const it = event.iterator();
+                let next;
+                // A malformed RRULE with no UNTIL and a tiny interval can iterate
+                // forever; the range check below normally ends it, and this is the
+                // backstop for the case where it cannot.
+                let guard = 0;
+                while ((next = it.next()) && guard++ < 2000) {
+                    if (next.toJSDate() >= to)
+                        break;
+                    const end = next.clone();
+                    end.addDuration(duration);
+                    if (end.toJSDate() < from)
+                        continue;
+                    const details = event.getOccurrenceDetails(next);
+                    push(details.startDate, details.endDate);
+                }
+            }
+        }
+        return out;
+    }
+    /**
+     * Live updates: `onChange` fires whenever anything in the range moves, so
+     * the caller can re-query. Returns an unsubscribe function.
+     *
+     * Deliberately a "something changed" signal rather than a patch — a
+     * recurrence master edited three months away can change what today looks
+     * like, and re-running the query is both simpler and correct.
+     *
+     * **Changes only.** What is in the range already is what `eventsBetween`
+     * answered; `onChange` fires for what happens after that. See
+     * {@link VIEW_FLAGS_NONE} for the loop that reporting the initial contents
+     * as a change costs a caller who re-queries on one.
+     */
+    async watch(from, to, onChange, options = {}) {
+        const list = options.calendars ??
+            (await this.listCalendars()).filter((c) => c.enabled);
+        const query = rangeQuery(from, to);
+        const started = [];
+        for (const meta of list) {
+            try {
+                const { cal, busName } = await this.#openCalendar(meta.uid);
+                const viewPath = await cal.GetView(query);
+                const view = (await this.#bus
+                    .getService(busName)
+                    .getInterface(viewPath, VIEW_IFACE));
+                // Belt to `VIEW_FLAGS_NONE`'s braces, for a backend that would not
+                // take the flags: `Complete` closes the initial delivery, so anything
+                // before it is the replay rather than a change. Only armed when
+                // `SetFlags` failed — a view that never reports `Complete` would
+                // otherwise be watched in silence, and losing live updates is the
+                // worse half of the trade.
+                let replaying = false;
+                try {
+                    await view.SetFlags(VIEW_FLAGS_NONE);
+                }
+                catch {
+                    replaying = true;
+                }
+                await view.$subscribe('Complete', () => {
+                    replaying = false;
+                });
+                for (const signal of [
+                    'ObjectsAdded',
+                    'ObjectsModified',
+                    'ObjectsRemoved',
+                ]) {
+                    await view.$subscribe(signal, (objects) => {
+                        if (replaying)
+                            return;
+                        onChange({
+                            calendar: meta,
+                            kind: signal,
+                            count: Array.isArray(objects) ? objects.length : 0,
+                        });
+                    });
+                }
+                await view.Start();
+                started.push(view);
+                this.#views.push(view);
+            }
+            catch {
+                /* skip a calendar that will not open; the others still update */
+            }
+        }
+        return async () => {
+            for (const view of started) {
+                this.#views = this.#views.filter((v) => v !== view);
+                try {
+                    await view.Stop();
+                    await view.Dispose();
+                }
+                catch {
+                    /* already gone */
+                }
+            }
+        };
+    }
+    /** Stop every view this instance started. Does **not** touch the bus. */
+    async dispose() {
+        const views = this.#views;
+        this.#views = [];
+        for (const view of views) {
+            try {
+                await view.Stop();
+                await view.Dispose();
+            }
+            catch {
+                /* already gone */
+            }
+        }
+        this.#open.clear();
+    }
+}
+//# sourceMappingURL=eds.js.map

package/dist/desktop-calendar/eds.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"eds.js","sourceRoot":"","sources":["../../src/desktop-calendar/eds.ts"],"names":[],"mappings":"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"}

package/dist/desktop-calendar/ical.d.ts

@@ -0,0 +1,63 @@
+/** An `ICAL.Time`. */
+export interface IcalTime {
+    toJSDate(): Date;
+    clone(): IcalTime;
+    addDuration(duration: unknown): void;
+    /** True for a date without a time — an all-day event's start. */
+    isDate: boolean;
+}
+export interface IcalProperty {
+    getParameter(name: string): string | undefined;
+}
+export interface IcalComponent {
+    name: string;
+    getFirstSubcomponent(name: string): IcalComponent | null;
+    getAllSubcomponents(name: string): IcalComponent[];
+    getFirstProperty(name: string): IcalProperty | null;
+}
+export interface IcalRecurExpansion {
+    next(): IcalTime | null;
+}
+export interface IcalEvent {
+    uid: string;
+    summary: string;
+    location: string;
+    description: string;
+    startDate: IcalTime;
+    endDate: IcalTime;
+    duration: unknown;
+    isRecurring(): boolean;
+    isRecurrenceException(): boolean;
+    iterator(): IcalRecurExpansion;
+    getOccurrenceDetails(time: IcalTime): {
+        startDate: IcalTime;
+        endDate: IcalTime;
+    };
+}
+export interface IcalTimezone {
+    tzid: string;
+}
+/** What `import('ical.js')` gives back, as far as this package is concerned. */
+export interface IcalModule {
+    parse(input: string): unknown;
+    Component: new (jcal: unknown) => IcalComponent;
+    Event: new (component: IcalComponent) => IcalEvent;
+    Timezone: new (component: IcalComponent) => IcalTimezone;
+    TimezoneService: {
+        has(tzid: string): boolean;
+        register(tzid: string, zone: IcalTimezone): void;
+    };
+}
+/** Thrown when the calendar is asked for events and `ical.js` is not there. */
+export declare class IcalUnavailableError extends Error {
+    constructor(cause?: unknown);
+}
+/**
+ * Load `ical.js`, once.
+ *
+ * Deliberately **not** cached as a rejection: a failed load is almost always
+ * "not installed", but retrying costs nothing and a cached rejection would
+ * outlive an app that installed it and re-rendered.
+ */
+export declare function loadIcal(): Promise<IcalModule>;
+//# sourceMappingURL=ical.d.ts.map

package/dist/desktop-calendar/ical.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ical.d.ts","sourceRoot":"","sources":["../../src/desktop-calendar/ical.ts"],"names":[],"mappings":"AAWA,sBAAsB;AACtB,MAAM,WAAW,QAAQ;IACvB,QAAQ,IAAI,IAAI,CAAC;IACjB,KAAK,IAAI,QAAQ,CAAC;IAClB,WAAW,CAAC,QAAQ,EAAE,OAAO,GAAG,IAAI,CAAC;IACrC,iEAAiE;IACjE,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,YAAY;IAC3B,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;CAChD;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,CAAC;IACzD,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,EAAE,CAAC;IACnD,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,CAAC;CACrD;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,IAAI,QAAQ,GAAG,IAAI,CAAC;CACzB;AAED,MAAM,WAAW,SAAS;IACxB,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,QAAQ,CAAC;IACpB,OAAO,EAAE,QAAQ,CAAC;IAClB,QAAQ,EAAE,OAAO,CAAC;IAClB,WAAW,IAAI,OAAO,CAAC;IACvB,qBAAqB,IAAI,OAAO,CAAC;IACjC,QAAQ,IAAI,kBAAkB,CAAC;IAC/B,oBAAoB,CAAC,IAAI,EAAE,QAAQ,GAAG;QACpC,SAAS,EAAE,QAAQ,CAAC;QACpB,OAAO,EAAE,QAAQ,CAAC;KACnB,CAAC;CACH;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;CACd;AAED,gFAAgF;AAChF,MAAM,WAAW,UAAU;IACzB,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;IAC9B,SAAS,EAAE,KAAK,IAAI,EAAE,OAAO,KAAK,aAAa,CAAC;IAChD,KAAK,EAAE,KAAK,SAAS,EAAE,aAAa,KAAK,SAAS,CAAC;IACnD,QAAQ,EAAE,KAAK,SAAS,EAAE,aAAa,KAAK,YAAY,CAAC;IACzD,eAAe,EAAE;QACf,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;QAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,GAAG,IAAI,CAAC;KAClD,CAAC;CACH;AAED,+EAA+E;AAC/E,qBAAa,oBAAqB,SAAQ,KAAK;IAC7C,YAAY,KAAK,CAAC,EAAE,OAAO,EAQ1B;CACF;AAID;;;;;;GAMG;AACH,wBAAsB,QAAQ,IAAI,OAAO,CAAC,UAAU,CAAC,CA4BpD"}

package/dist/desktop-calendar/ical.js

@@ -0,0 +1,57 @@
+// The slice of `ical.js` this package uses, and the loader that finds it.
+//
+// **`ical.js` is an `optionalDependency`, and these types are deliberately
+// ours rather than the package's.** `import type … from 'ical.js'` would put
+// the module in the type graph, and then an app that did not install it could
+// not type-check against this package at all — which is the opposite of what
+// "optional" means. So the surface is written out structurally, and the value
+// arrives through a dynamic `import()` that is allowed to fail.
+//
+// react-x11 makes the same call with `dbus-native`, for the same reason.
+/** Thrown when the calendar is asked for events and `ical.js` is not there. */
+export class IcalUnavailableError extends Error {
+    constructor(cause) {
+        super("@react-x11/components: reading desktop calendar events needs 'ical.js', " +
+            'which is an optional dependency and is not installed. ' +
+            'Run `npm install ical.js`. Listing calendars does not need it.', { cause });
+        this.name = 'IcalUnavailableError';
+    }
+}
+let cached = null;
+/**
+ * Load `ical.js`, once.
+ *
+ * Deliberately **not** cached as a rejection: a failed load is almost always
+ * "not installed", but retrying costs nothing and a cached rejection would
+ * outlive an app that installed it and re-rendered.
+ */
+export async function loadIcal() {
+    if (cached)
+        return cached;
+    const attempt = (async () => {
+        try {
+            // The specifier is built at run time so a bundler treats this as a
+            // genuinely optional import and does not fail the build resolving a
+            // package the app may well not have.
+            const name = 'ical.js';
+            const mod = (await import(/* @vite-ignore */ name));
+            // ical.js is CJS-with-a-default under some resolutions and a namespace
+            // under others; `parse` is on whichever one is real.
+            const resolved = typeof mod.parse === 'function' ? mod : mod.default;
+            if (!resolved || typeof resolved.parse !== 'function') {
+                throw new TypeError('ical.js did not export what was expected');
+            }
+            return resolved;
+        }
+        catch (err) {
+            throw new IcalUnavailableError(err);
+        }
+    })();
+    // Only a successful load is remembered.
+    cached = attempt.catch((err) => {
+        cached = null;
+        throw err;
+    });
+    return cached;
+}
+//# sourceMappingURL=ical.js.map

package/dist/desktop-calendar/ical.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ical.js","sourceRoot":"","sources":["../../src/desktop-calendar/ical.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,EAAE;AACF,2EAA2E;AAC3E,6EAA6E;AAC7E,8EAA8E;AAC9E,6EAA6E;AAC7E,8EAA8E;AAC9E,gEAAgE;AAChE,EAAE;AACF,yEAAyE;AA2DzE,+EAA+E;AAC/E,MAAM,OAAO,oBAAqB,SAAQ,KAAK;IAC7C,YAAY,KAAe;QACzB,KAAK,CACH,0EAA0E;YACxE,wDAAwD;YACxD,gEAAgE,EAClE,EAAE,KAAK,EAAE,CACV,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;IACrC,CAAC;CACF;AAED,IAAI,MAAM,GAA+B,IAAI,CAAC;AAE9C;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ;IAC5B,IAAI,MAAM;QAAE,OAAO,MAAM,CAAC;IAC1B,MAAM,OAAO,GAAG,CAAC,KAAK,IAAyB,EAAE;QAC/C,IAAI,CAAC;YACH,mEAAmE;YACnE,oEAAoE;YACpE,qCAAqC;YACrC,MAAM,IAAI,GAAG,SAAS,CAAC;YACvB,MAAM,GAAG,GAAG,CAAC,MAAM,MAAM,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAEpC,CAAC;YACf,uEAAuE;YACvE,qDAAqD;YACrD,MAAM,QAAQ,GAAG,OAAO,GAAG,CAAC,KAAK,KAAK,UAAU,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC;YACrE,IAAI,CAAC,QAAQ,IAAI,OAAO,QAAQ,CAAC,KAAK,KAAK,UAAU,EAAE,CAAC;gBACtD,MAAM,IAAI,SAAS,CAAC,0CAA0C,CAAC,CAAC;YAClE,CAAC;YACD,OAAO,QAAQ,CAAC;QAClB,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,IAAI,oBAAoB,CAAC,GAAG,CAAC,CAAC;QACtC,CAAC;IACH,CAAC,CAAC,EAAE,CAAC;IACL,wCAAwC;IACxC,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,GAAY,EAAE,EAAE;QACtC,MAAM,GAAG,IAAI,CAAC;QACd,MAAM,GAAG,CAAC;IACZ,CAAC,CAAC,CAAC;IACH,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/desktop-calendar/index.d.ts

@@ -0,0 +1,72 @@
+import type { CalendarChange, DesktopCalendarError, DesktopCalendarInfo, DesktopEvent } from './eds.js';
+export { DesktopCalendar, parseKeyFile } from './eds.js';
+export type { CalendarChange, DesktopCalendarError, DesktopCalendarInfo, DesktopEvent, EventsResult, } from './eds.js';
+export { IcalUnavailableError } from './ical.js';
+/**
+ * Occurrences grouped by the local day they appear on — which is what a
+ * calendar grid actually renders.
+ *
+ * An all-day event spans `[start, end)` across possibly several days, and a
+ * timed one can cross midnight, so an event lands under **every** day it
+ * touches rather than only under its start.
+ */
+export declare function byDay(events: DesktopEvent[]): Map<string, DesktopEvent[]>;
+export type DesktopCalendarStatus = 'idle' | 'loading' | 'ready' | 'unavailable';
+export interface UseDesktopCalendarEventsOptions {
+    /** Start of the window to read, inclusive. */
+    from: Date;
+    /** End of the window, exclusive. */
+    to: Date;
+    /** Restrict to these calendar UIDs. Default: every enabled calendar. */
+    calendars?: string[];
+    /** Re-query when the desktop says something in the range changed. */
+    watch?: boolean;
+    /** Set false to hold off entirely — a picker that is not open yet. */
+    enabled?: boolean;
+}
+export interface UseDesktopCalendarEventsResult {
+    events: DesktopEvent[];
+    /** The same events, keyed by `'YYYY-MM-DD'`, ready for `dayContent`. */
+    byDay: Map<string, DesktopEvent[]>;
+    /** Every calendar found, for a legend or a filter. */
+    calendars: DesktopCalendarInfo[];
+    /** Backends that would not answer. Not fatal; the rest still loaded. */
+    errors: DesktopCalendarError[];
+    status: DesktopCalendarStatus;
+    /** Why there are no events: no bus, or no `ical.js`. */
+    error: Error | null;
+    /** Re-query now. */
+    refresh: () => void;
+}
+/**
+ * The user's desktop calendar events, as rendering state.
+ *
+ * ```tsx
+ * const { byDay } = useDesktopCalendarEvents({ from, to });
+ *
+ * <Calendar
+ *   dayContent={(day, state) =>
+ *     byDay.get(day)?.slice(0, 3).map((ev) => (
+ *       <box key={ev.uid} style={{ width: 4, height: 4, borderRadius: 2,
+ *                                  backgroundColor: state.selected
+ *                                    ? state.color
+ *                                    : (ev.calendar.color ?? '$accent') }} />
+ *     ))
+ *   }
+ * />
+ * ```
+ *
+ * **`from` and `to` are read by their timestamps, not their identity**, so
+ * `new Date(...)` inline in the render is fine and will not re-query on every
+ * paint. That is the mistake this hook would otherwise invite, and it costs a
+ * D-Bus round trip per frame.
+ *
+ * `status` is `'unavailable'` when there is no session bus or `ical.js` is not
+ * installed — both are ordinary on a machine that simply does not have them,
+ * so neither throws, and `error` says which it was. Treat it as "no calendar
+ * integration here", not as a failure to report.
+ */
+export declare function useDesktopCalendarEvents(options: UseDesktopCalendarEventsOptions): UseDesktopCalendarEventsResult;
+/** A subscription that only reports *when* something changed. */
+export type { CalendarChange as DesktopCalendarChange };
+//# sourceMappingURL=index.d.ts.map

package/dist/desktop-calendar/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/desktop-calendar/index.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EACV,cAAc,EACd,oBAAoB,EACpB,mBAAmB,EACnB,YAAY,EACb,MAAM,UAAU,CAAC;AAElB,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AACzD,YAAY,EACV,cAAc,EACd,oBAAoB,EACpB,mBAAmB,EACnB,YAAY,EACZ,YAAY,GACb,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAC;AAkBjD;;;;;;;GAOG;AACH,wBAAgB,KAAK,CAAC,MAAM,EAAE,YAAY,EAAE,GAAG,GAAG,CAAC,MAAM,EAAE,YAAY,EAAE,CAAC,CAqBzE;AAED,MAAM,MAAM,qBAAqB,GAC/B,MAAM,GAAG,SAAS,GAAG,OAAO,GAAG,aAAa,CAAC;AAE/C,MAAM,WAAW,+BAA+B;IAC9C,8CAA8C;IAC9C,IAAI,EAAE,IAAI,CAAC;IACX,oCAAoC;IACpC,EAAE,EAAE,IAAI,CAAC;IACT,wEAAwE;IACxE,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,qEAAqE;IACrE,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,sEAAsE;IACtE,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,8BAA8B;IAC7C,MAAM,EAAE,YAAY,EAAE,CAAC;IACvB,wEAAwE;IACxE,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,YAAY,EAAE,CAAC,CAAC;IACnC,sDAAsD;IACtD,SAAS,EAAE,mBAAmB,EAAE,CAAC;IACjC,wEAAwE;IACxE,MAAM,EAAE,oBAAoB,EAAE,CAAC;IAC/B,MAAM,EAAE,qBAAqB,CAAC;IAC9B,wDAAwD;IACxD,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,oBAAoB;IACpB,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB;AAkBD;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,+BAA+B,GACvC,8BAA8B,CA+HhC;AAED,iEAAiE;AACjE,YAAY,EAAE,cAAc,IAAI,qBAAqB,EAAE,CAAC"}