@rapidmx/web-client 0.14.0 → 0.15.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (171) hide show
  1. package/apps/admin/domains/[uid].tsx +3 -2
  2. package/apps/shared/appearance/AppearanceForm.tsx +9 -1
  3. package/apps/shared/calendar/bookingPlugin.ts +100 -0
  4. package/apps/shared/calendar/calendarLiveUpdates.ts +27 -0
  5. package/apps/shared/components/admin/layout/AdminShell.tsx +37 -5
  6. package/apps/shared/components/admin/settings/MailboxCreateForm.tsx +3 -1
  7. package/apps/shared/components/admin/settings/PluginsManager.tsx +1545 -1491
  8. package/apps/shared/components/calendar/AppointmentQuickForm.tsx +327 -0
  9. package/apps/shared/components/calendar/DescriptionEditor.tsx +274 -0
  10. package/apps/shared/components/calendar/EventDescriptionView.tsx +70 -0
  11. package/apps/shared/components/calendar/EventDetails.tsx +401 -0
  12. package/apps/shared/components/calendar/EventEditor.tsx +640 -0
  13. package/apps/shared/components/calendar/EventExpandedForm.tsx +210 -0
  14. package/apps/shared/components/calendar/EventFormParts.tsx +622 -0
  15. package/apps/shared/components/calendar/EventModal.tsx +126 -862
  16. package/apps/shared/components/calendar/EventQuickForm.tsx +116 -0
  17. package/apps/shared/components/calendar/EventShell.tsx +202 -0
  18. package/apps/shared/components/calendar/FindATime.tsx +379 -0
  19. package/apps/shared/components/calendar/LazyDescriptionEditor.tsx +70 -0
  20. package/apps/shared/components/calendar/MonthView.tsx +15 -3
  21. package/apps/shared/components/calendar/QuickCreateFaces.tsx +87 -0
  22. package/apps/shared/components/calendar/QuickCreateTabs.tsx +81 -0
  23. package/apps/shared/components/calendar/QuickFaceFrame.tsx +81 -0
  24. package/apps/shared/components/calendar/RecurrenceEditor.tsx +10 -5
  25. package/apps/shared/components/calendar/RequestChangeForm.tsx +271 -0
  26. package/apps/shared/components/calendar/SplitDayView.tsx +6 -5
  27. package/apps/shared/components/calendar/TaskQuickForm.tsx +289 -0
  28. package/apps/shared/components/calendar/TimeGridView.tsx +8 -6
  29. package/apps/shared/components/calendar/eventDialogFields.ts +86 -0
  30. package/apps/shared/components/calendar/eventForm.ts +108 -0
  31. package/apps/shared/components/calendar/eventFormat.ts +183 -0
  32. package/apps/shared/components/calendar/findTimeGrid.ts +90 -0
  33. package/apps/shared/components/calendar/swipeNavigation.ts +14 -0
  34. package/apps/shared/components/layout/UserMenu.tsx +80 -28
  35. package/apps/shared/components/mail/ConversationList.tsx +100 -48
  36. package/apps/shared/components/mail/ConversationThreadPane.tsx +490 -486
  37. package/apps/shared/components/mail/InviteCard.tsx +387 -0
  38. package/apps/shared/components/mail/MessageDetailPane.tsx +24 -2
  39. package/apps/shared/components/mail/SwipeRow.tsx +120 -0
  40. package/apps/shared/components/mail/compose/ComposeWindow.tsx +7 -3
  41. package/apps/shared/components/mail/invite/InviteRowChip.tsx +104 -0
  42. package/apps/shared/components/mail/invite/InviteRsvpPopover.tsx +271 -0
  43. package/apps/shared/components/mail/invite/InviteTimeline.tsx +200 -0
  44. package/apps/shared/components/mail/invite/ProposeTimeForm.tsx +109 -0
  45. package/apps/shared/components/mail/invite/inviteFormat.ts +110 -0
  46. package/apps/shared/components/mail/invite/inviteStore.ts +114 -0
  47. package/apps/shared/components/mail/layout/MailShell.tsx +522 -490
  48. package/apps/shared/components/settings/layout/SettingsShell.tsx +1 -0
  49. package/apps/shared/gestures/useEnterSlide.ts +54 -0
  50. package/apps/shared/gestures/useSwipe.ts +114 -0
  51. package/apps/shared/gestures/useSwipeSlide.ts +113 -0
  52. package/apps/shared/gestures/useWheelPaging.ts +107 -0
  53. package/apps/shared/mail/newMailNotifications.ts +171 -183
  54. package/apps/shared/mail/useNewMailNotifications.ts +178 -178
  55. package/apps/shared/notifications/preferences.ts +36 -0
  56. package/apps/shared/notifications/store.ts +560 -551
  57. package/apps/www/_routes.ts +1 -0
  58. package/apps/www/calendar/index.tsx +139 -37
  59. package/apps/www/index.tsx +273 -126
  60. package/apps/www/messages/[uid].tsx +31 -4
  61. package/apps/www/settings/profile/index.tsx +248 -0
  62. package/dist/apps/admin/domains/[uid].js +4 -2
  63. package/dist/apps/shared/appearance/AppearanceForm.js +9 -1
  64. package/dist/apps/shared/calendar/bookingPlugin.d.ts +50 -0
  65. package/dist/apps/shared/calendar/bookingPlugin.js +57 -0
  66. package/dist/apps/shared/calendar/calendarLiveUpdates.d.ts +11 -0
  67. package/dist/apps/shared/calendar/calendarLiveUpdates.js +23 -0
  68. package/dist/apps/shared/components/admin/layout/AdminShell.d.ts +1 -1
  69. package/dist/apps/shared/components/admin/layout/AdminShell.js +7 -3
  70. package/dist/apps/shared/components/admin/settings/MailboxCreateForm.js +3 -1
  71. package/dist/apps/shared/components/admin/settings/PluginsManager.js +40 -6
  72. package/dist/apps/shared/components/calendar/AppointmentQuickForm.d.ts +47 -0
  73. package/dist/apps/shared/components/calendar/AppointmentQuickForm.js +135 -0
  74. package/dist/apps/shared/components/calendar/DescriptionEditor.d.ts +26 -0
  75. package/dist/apps/shared/components/calendar/DescriptionEditor.js +192 -0
  76. package/dist/apps/shared/components/calendar/EventDescriptionView.d.ts +14 -0
  77. package/dist/apps/shared/components/calendar/EventDescriptionView.js +39 -0
  78. package/dist/apps/shared/components/calendar/EventDetails.d.ts +33 -0
  79. package/dist/apps/shared/components/calendar/EventDetails.js +137 -0
  80. package/dist/apps/shared/components/calendar/EventEditor.d.ts +59 -0
  81. package/dist/apps/shared/components/calendar/EventEditor.js +549 -0
  82. package/dist/apps/shared/components/calendar/EventExpandedForm.d.ts +14 -0
  83. package/dist/apps/shared/components/calendar/EventExpandedForm.js +44 -0
  84. package/dist/apps/shared/components/calendar/EventFormParts.d.ts +69 -0
  85. package/dist/apps/shared/components/calendar/EventFormParts.js +202 -0
  86. package/dist/apps/shared/components/calendar/EventModal.d.ts +26 -13
  87. package/dist/apps/shared/components/calendar/EventModal.js +57 -455
  88. package/dist/apps/shared/components/calendar/EventQuickForm.d.ts +18 -0
  89. package/dist/apps/shared/components/calendar/EventQuickForm.js +25 -0
  90. package/dist/apps/shared/components/calendar/EventShell.d.ts +64 -0
  91. package/dist/apps/shared/components/calendar/EventShell.js +134 -0
  92. package/dist/apps/shared/components/calendar/FindATime.d.ts +18 -0
  93. package/dist/apps/shared/components/calendar/FindATime.js +190 -0
  94. package/dist/apps/shared/components/calendar/LazyDescriptionEditor.d.ts +8 -0
  95. package/dist/apps/shared/components/calendar/LazyDescriptionEditor.js +44 -0
  96. package/dist/apps/shared/components/calendar/MonthView.d.ts +5 -1
  97. package/dist/apps/shared/components/calendar/MonthView.js +11 -5
  98. package/dist/apps/shared/components/calendar/QuickCreateFaces.d.ts +30 -0
  99. package/dist/apps/shared/components/calendar/QuickCreateFaces.js +44 -0
  100. package/dist/apps/shared/components/calendar/QuickCreateTabs.d.ts +24 -0
  101. package/dist/apps/shared/components/calendar/QuickCreateTabs.js +46 -0
  102. package/dist/apps/shared/components/calendar/QuickFaceFrame.d.ts +25 -0
  103. package/dist/apps/shared/components/calendar/QuickFaceFrame.js +19 -0
  104. package/dist/apps/shared/components/calendar/RecurrenceEditor.d.ts +4 -1
  105. package/dist/apps/shared/components/calendar/RecurrenceEditor.js +2 -2
  106. package/dist/apps/shared/components/calendar/RequestChangeForm.d.ts +36 -0
  107. package/dist/apps/shared/components/calendar/RequestChangeForm.js +138 -0
  108. package/dist/apps/shared/components/calendar/SplitDayView.d.ts +3 -2
  109. package/dist/apps/shared/components/calendar/SplitDayView.js +3 -2
  110. package/dist/apps/shared/components/calendar/TaskQuickForm.d.ts +40 -0
  111. package/dist/apps/shared/components/calendar/TaskQuickForm.js +101 -0
  112. package/dist/apps/shared/components/calendar/TimeGridView.d.ts +4 -2
  113. package/dist/apps/shared/components/calendar/TimeGridView.js +3 -2
  114. package/dist/apps/shared/components/calendar/eventDialogFields.d.ts +28 -0
  115. package/dist/apps/shared/components/calendar/eventDialogFields.js +59 -0
  116. package/dist/apps/shared/components/calendar/eventForm.d.ts +98 -0
  117. package/dist/apps/shared/components/calendar/eventForm.js +1 -0
  118. package/dist/apps/shared/components/calendar/eventFormat.d.ts +67 -0
  119. package/dist/apps/shared/components/calendar/eventFormat.js +163 -0
  120. package/dist/apps/shared/components/calendar/findTimeGrid.d.ts +30 -0
  121. package/dist/apps/shared/components/calendar/findTimeGrid.js +83 -0
  122. package/dist/apps/shared/components/calendar/swipeNavigation.d.ts +9 -0
  123. package/dist/apps/shared/components/calendar/swipeNavigation.js +8 -0
  124. package/dist/apps/shared/components/layout/UserMenu.d.ts +10 -8
  125. package/dist/apps/shared/components/layout/UserMenu.js +70 -23
  126. package/dist/apps/shared/components/mail/ConversationList.d.ts +12 -1
  127. package/dist/apps/shared/components/mail/ConversationList.js +21 -4
  128. package/dist/apps/shared/components/mail/ConversationThreadPane.d.ts +4 -1
  129. package/dist/apps/shared/components/mail/InviteCard.d.ts +20 -0
  130. package/dist/apps/shared/components/mail/InviteCard.js +150 -0
  131. package/dist/apps/shared/components/mail/MessageDetailPane.js +13 -2
  132. package/dist/apps/shared/components/mail/SwipeRow.d.ts +22 -0
  133. package/dist/apps/shared/components/mail/SwipeRow.js +71 -0
  134. package/dist/apps/shared/components/mail/compose/ComposeWindow.js +8 -3
  135. package/dist/apps/shared/components/mail/invite/InviteRowChip.d.ts +23 -0
  136. package/dist/apps/shared/components/mail/invite/InviteRowChip.js +46 -0
  137. package/dist/apps/shared/components/mail/invite/InviteRsvpPopover.d.ts +20 -0
  138. package/dist/apps/shared/components/mail/invite/InviteRsvpPopover.js +141 -0
  139. package/dist/apps/shared/components/mail/invite/InviteTimeline.d.ts +27 -0
  140. package/dist/apps/shared/components/mail/invite/InviteTimeline.js +120 -0
  141. package/dist/apps/shared/components/mail/invite/ProposeTimeForm.d.ts +17 -0
  142. package/dist/apps/shared/components/mail/invite/ProposeTimeForm.js +45 -0
  143. package/dist/apps/shared/components/mail/invite/inviteFormat.d.ts +28 -0
  144. package/dist/apps/shared/components/mail/invite/inviteFormat.js +94 -0
  145. package/dist/apps/shared/components/mail/invite/inviteStore.d.ts +28 -0
  146. package/dist/apps/shared/components/mail/invite/inviteStore.js +95 -0
  147. package/dist/apps/shared/components/mail/layout/MailShell.d.ts +5 -0
  148. package/dist/apps/shared/components/mail/layout/MailShell.js +14 -3
  149. package/dist/apps/shared/components/settings/layout/SettingsShell.js +1 -0
  150. package/dist/apps/shared/gestures/useEnterSlide.d.ts +14 -0
  151. package/dist/apps/shared/gestures/useEnterSlide.js +47 -0
  152. package/dist/apps/shared/gestures/useSwipe.d.ts +45 -0
  153. package/dist/apps/shared/gestures/useSwipe.js +90 -0
  154. package/dist/apps/shared/gestures/useSwipeSlide.d.ts +40 -0
  155. package/dist/apps/shared/gestures/useSwipeSlide.js +95 -0
  156. package/dist/apps/shared/gestures/useWheelPaging.d.ts +32 -0
  157. package/dist/apps/shared/gestures/useWheelPaging.js +85 -0
  158. package/dist/apps/shared/mail/newMailNotifications.d.ts +3 -8
  159. package/dist/apps/shared/mail/newMailNotifications.js +3 -12
  160. package/dist/apps/shared/mail/useNewMailNotifications.js +3 -2
  161. package/dist/apps/shared/notifications/preferences.d.ts +13 -0
  162. package/dist/apps/shared/notifications/preferences.js +36 -0
  163. package/dist/apps/shared/notifications/store.d.ts +1 -0
  164. package/dist/apps/shared/notifications/store.js +7 -23
  165. package/dist/apps/www/_routes.js +1 -0
  166. package/dist/apps/www/calendar/index.js +76 -6
  167. package/dist/apps/www/index.js +140 -39
  168. package/dist/apps/www/messages/[uid].js +13 -5
  169. package/dist/apps/www/settings/profile/index.d.ts +4 -0
  170. package/dist/apps/www/settings/profile/index.js +124 -0
  171. package/package.json +3 -3
@@ -0,0 +1,104 @@
1
+ ///////////////////////////////////////////////////////////////////////////////
2
+ // Copyright (C) 2026 Jean-Philippe Steinmetz
3
+ // SPDX-License-Identifier: MPL-2.0
4
+ ///////////////////////////////////////////////////////////////////////////////
5
+ import React, { useRef, useState } from "react";
6
+ import { HiOutlineCalendarDays } from "react-icons/hi2";
7
+ import type { Message } from "@rapidmx/react-shared/mail/mailApi.js";
8
+ import type { MessageInvite } from "@rapidmx/react-shared/calendar/inviteApi.js";
9
+ import { ANSWER_LABEL, formatRowStart } from "./inviteFormat.js";
10
+ import { useMessageInvite } from "./inviteStore.js";
11
+ import InviteRsvpPopover from "./InviteRsvpPopover.js";
12
+
13
+ export interface InviteRowChipProps {
14
+ message: Message;
15
+ /** Called with the row's message carrying the reader's new answer (`meetingResponse`), after an RSVP, so the list can show it. */
16
+ onResponded?: (updated: Message) => void;
17
+ /** The chip's horizontal margins - the row's own padding. Default `mx-4`. */
18
+ className?: string;
19
+ }
20
+
21
+ /** Whether a list row draws the chip: a meeting request the server can read (an encrypted message's calendar file is inside its ciphertext). */
22
+ export function showsInviteChip(message: Pick<Message, "meetingMethod" | "encrypted">): boolean {
23
+ return message.meetingMethod === "REQUEST" && !message.encrypted;
24
+ }
25
+
26
+ /**
27
+ * The line a meeting request gets in a list of mail, under its preview, as Outlook draws it: a calendar icon, when the meeting starts (in the reader's
28
+ * zone), under that whether it conflicts with the reader's calendar - or, once answered, the answer - and an RSVP button that opens the day view with
29
+ * Accept, Decline and Tentative (`InviteRsvpPopover`).
30
+ *
31
+ * The invitation is looked up (once, through the shared cache) only for a row that `showsInviteChip()` - the rest of the list is never asked about. Until
32
+ * it arrives, or when the lookup fails, the chip says only "Meeting request", with no button.
33
+ *
34
+ * It lives beside the row's open button, not inside it (a button can't hold a button), and keeps taps and touches to itself: pressing RSVP neither
35
+ * opens the row nor starts a swipe of it. That holds for the popover too, which React nests under the chip even though it is drawn on the page.
36
+ */
37
+ export default function InviteRowChip({ message, onResponded, className = "mx-4" }: InviteRowChipProps) {
38
+ const eligible = showsInviteChip(message);
39
+ const { invite, setInvite } = useMessageInvite(message.uid, eligible);
40
+ const [open, setOpen] = useState(false);
41
+ const rsvpRef = useRef<HTMLButtonElement>(null);
42
+ if (!eligible) {
43
+ return null;
44
+ }
45
+
46
+ const answer = invite?.response ?? message.meetingResponse;
47
+ const conflicts = invite?.conflicts.length ?? 0;
48
+ const start = invite ? formatRowStart(invite) : undefined;
49
+
50
+ function answered(updated: MessageInvite) {
51
+ setInvite(updated);
52
+ onResponded?.({ ...message, meetingResponse: updated.response ?? message.meetingResponse });
53
+ }
54
+
55
+ const stop = (event: React.SyntheticEvent) => event.stopPropagation();
56
+ return (
57
+ <div
58
+ data-invite-chip
59
+ onClick={stop}
60
+ onTouchStart={stop}
61
+ onTouchMove={stop}
62
+ onTouchEnd={stop}
63
+ onTouchCancel={stop}
64
+ className={[className, "mb-2 -mt-1 flex items-center gap-2 rounded-sm border border-border bg-surface px-2 py-1.5 text-xs font-normal"].join(" ")}
65
+ >
66
+ <HiOutlineCalendarDays size={16} aria-hidden="true" className="shrink-0 text-text-muted" />
67
+ <div className="min-w-0 flex-1">
68
+ <div className="truncate text-text">{start ?? "Meeting request"}</div>
69
+ {invite && (
70
+ <div
71
+ className={[
72
+ "truncate",
73
+ answer === "accepted" ? "text-success" : answer === "declined" ? "text-danger" : conflicts > 0 ? "text-danger" : "text-text-muted",
74
+ ].join(" ")}
75
+ >
76
+ {answer ? ANSWER_LABEL[answer] : conflicts > 0 ? `Conflicts with ${conflicts} ${conflicts === 1 ? "event" : "events"}` : "No conflicts"}
77
+ </div>
78
+ )}
79
+ </div>
80
+ {invite?.canRespond && !invite.isOrganizer && (
81
+ <button
82
+ ref={rsvpRef}
83
+ type="button"
84
+ aria-haspopup="dialog"
85
+ aria-expanded={open}
86
+ aria-label={`RSVP to ${invite.summary?.trim() || "this meeting"}`}
87
+ onClick={() => setOpen((wasOpen) => !wasOpen)}
88
+ className="shrink-0 py-1 px-3 rounded-sm border border-border text-xs font-semibold text-text hover:bg-surface-alt"
89
+ >
90
+ RSVP
91
+ </button>
92
+ )}
93
+ {open && invite && (
94
+ <InviteRsvpPopover
95
+ messageUid={message.uid}
96
+ invite={invite}
97
+ anchorRef={rsvpRef}
98
+ onDone={answered}
99
+ onClose={() => setOpen(false)}
100
+ />
101
+ )}
102
+ </div>
103
+ );
104
+ }
@@ -0,0 +1,271 @@
1
+ ///////////////////////////////////////////////////////////////////////////////
2
+ // Copyright (C) 2026 Jean-Philippe Steinmetz
3
+ // SPDX-License-Identifier: MPL-2.0
4
+ ///////////////////////////////////////////////////////////////////////////////
5
+ import React, { RefObject, useEffect, useId, useRef, useState } from "react";
6
+ import { HiOutlineCheck, HiOutlineEllipsisHorizontal } from "react-icons/hi2";
7
+ import { InviteResponse, MessageInvite, ProposedTime, proposeNewTime, respondToMessageInvite } from "@rapidmx/react-shared/calendar/inviteApi.js";
8
+ import Button from "@rapidmx/react-shared/components/buttons/Button.js";
9
+ import Modal from "@rapidmx/react-shared/components/overlays/Modal.js";
10
+ import PopoverPortal from "@rapidmx/react-shared/components/overlays/PopoverPortal.js";
11
+ import useIsMobile from "@rapidmx/react-shared/util/useIsMobile.js";
12
+ import { notifyApiError } from "../../../notifications/apiErrors.js";
13
+ import { calendarHref, conflictSummary, formatInviteWhen } from "./inviteFormat.js";
14
+ import InviteTimeline from "./InviteTimeline.js";
15
+ import ProposeTimeForm from "./ProposeTimeForm.js";
16
+
17
+ /** The popover's width, and the room it leaves the window's edges. */
18
+ const WIDTH = 360;
19
+ const WINDOW_MARGIN = 16;
20
+ /** What the popover is tall for its own text and footer, before the day view (px), and how tall the day view is per hour drawn. */
21
+ const CHROME_HEIGHT = 190;
22
+ const CONFLICT_LINE_HEIGHT = 22;
23
+ const HOURS_HEIGHT = 36;
24
+ const PROPOSE_HEIGHT = 340;
25
+
26
+ /** The hours the day view draws for an invitation, as `InviteTimeline` will (a fixed estimate is all a popover's box needs). */
27
+ function estimateHeight(invite: MessageInvite, proposing: boolean): number {
28
+ const cap = window.innerHeight - WINDOW_MARGIN;
29
+ if (proposing) {
30
+ return Math.min(PROPOSE_HEIGHT, cap);
31
+ }
32
+ const start = invite.startDate ? new Date(invite.startDate) : undefined;
33
+ const end = invite.endDate ? new Date(invite.endDate) : undefined;
34
+ const spanHours = start && end ? Math.max(0, (end.getTime() - start.getTime()) / 3_600_000) : 1;
35
+ // The day view spans the invitation with two hours either side, and never less than five.
36
+ const hours = Math.min(24, Math.max(5, Math.ceil(spanHours) + 4));
37
+ const allDay = invite.schedule.filter((entry) => entry.allDay).length;
38
+ return Math.min(CHROME_HEIGHT + hours * HOURS_HEIGHT + allDay * CONFLICT_LINE_HEIGHT + (invite.conflicts.length > 0 ? CONFLICT_LINE_HEIGHT : 0), cap);
39
+ }
40
+
41
+ const RESPONSES: { response: InviteResponse; label: string; text: string; failure: string }[] = [
42
+ { response: "accepted", label: "Accept", text: "Accept", failure: "Couldn't accept this meeting" },
43
+ { response: "declined", label: "Decline", text: "Decline", failure: "Couldn't decline this meeting" },
44
+ { response: "tentative", label: "Tentative", text: "?", failure: "Couldn't respond tentatively to this meeting" },
45
+ ];
46
+
47
+ interface RsvpPanelProps {
48
+ messageUid: string;
49
+ invite: MessageInvite;
50
+ /** Called with the invitation as it stands after an answer or a proposal - the popover then closes. */
51
+ onDone: (invite: MessageInvite) => void;
52
+ /** Escape, or Cancel: close without returning anything. */
53
+ onClose: () => void;
54
+ /** The proposal form is showing, so the box can be sized for it. */
55
+ onProposingChange?: (proposing: boolean) => void;
56
+ }
57
+
58
+ /** What is inside the RSVP popover (or dialog): the meeting, a day view around it and the buttons that answer it. */
59
+ function RsvpPanel({ messageUid, invite, onDone, onClose, onProposingChange }: RsvpPanelProps) {
60
+ const titleId = useId();
61
+ const [pending, setPending] = useState<InviteResponse | "propose" | null>(null);
62
+ const [proposing, setProposingState] = useState(false);
63
+ const [menuOpen, setMenuOpen] = useState(false);
64
+ const rootRef = useRef<HTMLDivElement>(null);
65
+ const moreRef = useRef<HTMLButtonElement>(null);
66
+ const menuRef = useRef<HTMLDivElement>(null);
67
+ const busy = pending !== null;
68
+ const when = formatInviteWhen(invite);
69
+
70
+ // Focus goes to the first thing to do when the panel opens.
71
+ useEffect(() => {
72
+ rootRef.current?.querySelector<HTMLElement>("button:not([disabled])")?.focus();
73
+ }, []);
74
+
75
+ function setProposing(next: boolean) {
76
+ setProposingState(next);
77
+ onProposingChange?.(next);
78
+ }
79
+
80
+ async function answer(response: InviteResponse, failure: string) {
81
+ setPending(response);
82
+ try {
83
+ onDone(await respondToMessageInvite(messageUid, response));
84
+ } catch (err) {
85
+ notifyApiError(err, failure);
86
+ setPending(null);
87
+ }
88
+ }
89
+
90
+ async function propose(proposal: ProposedTime) {
91
+ setPending("propose");
92
+ try {
93
+ onDone(await proposeNewTime(messageUid, proposal));
94
+ } catch (err) {
95
+ notifyApiError(err, "Couldn't send the proposed time");
96
+ setPending(null);
97
+ }
98
+ }
99
+
100
+ function handleKeyDown(event: React.KeyboardEvent) {
101
+ if (event.key === "Escape") {
102
+ event.stopPropagation();
103
+ if (menuOpen) {
104
+ setMenuOpen(false);
105
+ moreRef.current?.focus();
106
+ } else {
107
+ onClose();
108
+ }
109
+ }
110
+ }
111
+
112
+ function handleMenuKeyDown(event: React.KeyboardEvent) {
113
+ if (event.key !== "ArrowDown" && event.key !== "ArrowUp") {
114
+ return;
115
+ }
116
+ event.preventDefault();
117
+ const items = Array.from(menuRef.current!.querySelectorAll<HTMLElement>('[role="menuitem"]'));
118
+ const at = items.indexOf(document.activeElement as HTMLElement);
119
+ items[(at + (event.key === "ArrowDown" ? 1 : -1) + items.length) % items.length].focus();
120
+ }
121
+
122
+ return (
123
+ <div
124
+ ref={rootRef}
125
+ role="group"
126
+ aria-labelledby={titleId}
127
+ tabIndex={-1}
128
+ onKeyDown={handleKeyDown}
129
+ className="relative flex-1 min-h-0 flex flex-col text-sm text-text outline-none"
130
+ >
131
+ <div className="flex-1 min-h-0 overflow-y-auto px-4 pt-3 pb-2 flex flex-col gap-2">
132
+ <h3 id={titleId} className="font-semibold break-words">
133
+ {invite.summary?.trim() || "(no title)"}
134
+ </h3>
135
+ {when && <p className="break-words">{when}{invite.recurring && <span className="text-text-muted"> (Repeats)</span>}</p>}
136
+ {invite.conflicts.length > 0 && (
137
+ <p className="text-danger break-words">
138
+ <span className="font-medium">Conflicts with:</span> {conflictSummary(invite.conflicts)}
139
+ </p>
140
+ )}
141
+ {proposing ? (
142
+ <ProposeTimeForm
143
+ invite={invite}
144
+ busy={pending === "propose"}
145
+ onSubmit={(proposal) => void propose(proposal)}
146
+ onCancel={() => setProposing(false)}
147
+ />
148
+ ) : (
149
+ <InviteTimeline invite={invite} />
150
+ )}
151
+ </div>
152
+ {!proposing && (
153
+ <div className="flex items-center gap-2 px-4 py-3 border-t border-border" aria-busy={busy || undefined}>
154
+ {RESPONSES.map(({ response, label, text, failure }) => {
155
+ const current = invite.response === response;
156
+ return (
157
+ <Button
158
+ key={response}
159
+ type="button"
160
+ variant={response === "accepted" && !current ? "primary" : "secondary"}
161
+ className={["!w-auto", response === "tentative" ? "!px-3" : "", current ? "!bg-primary/10 !border-primary disabled:!opacity-100" : ""].join(" ")}
162
+ aria-label={label}
163
+ title={label}
164
+ aria-pressed={current}
165
+ aria-busy={pending === response || undefined}
166
+ loading={pending === response}
167
+ disabled={busy || current}
168
+ onClick={() => void answer(response, failure)}
169
+ >
170
+ {current && <HiOutlineCheck size={14} aria-hidden="true" />}
171
+ {text}
172
+ </Button>
173
+ );
174
+ })}
175
+ <div className="ml-auto relative">
176
+ <button
177
+ ref={moreRef}
178
+ type="button"
179
+ aria-label="More actions"
180
+ aria-haspopup="menu"
181
+ aria-expanded={menuOpen}
182
+ disabled={busy}
183
+ onClick={() => setMenuOpen((open) => !open)}
184
+ className="inline-flex items-center justify-center p-1.5 rounded-md border border-border text-text hover:bg-surface-alt disabled:opacity-50"
185
+ >
186
+ <HiOutlineEllipsisHorizontal size={18} aria-hidden="true" />
187
+ </button>
188
+ {menuOpen && (
189
+ <div
190
+ ref={(node) => {
191
+ menuRef.current = node;
192
+ // A menu that has just opened takes the focus, as a menu does.
193
+ node?.querySelector<HTMLElement>('[role="menuitem"]')?.focus();
194
+ }}
195
+ role="menu"
196
+ aria-label="More actions"
197
+ onKeyDown={handleMenuKeyDown}
198
+ className="absolute bottom-full right-0 mb-1 w-48 py-1 rounded-md border border-border bg-surface shadow-modal z-10"
199
+ >
200
+ {invite.canPropose && (
201
+ <button
202
+ type="button"
203
+ role="menuitem"
204
+ onClick={() => {
205
+ setMenuOpen(false);
206
+ setProposing(true);
207
+ }}
208
+ className="w-full px-3 py-2 text-left hover:bg-surface-alt"
209
+ >
210
+ Propose new time
211
+ </button>
212
+ )}
213
+ <a role="menuitem" href={calendarHref(invite)} className="block px-3 py-2 hover:bg-surface-alt">
214
+ Open in calendar
215
+ </a>
216
+ </div>
217
+ )}
218
+ </div>
219
+ </div>
220
+ )}
221
+ </div>
222
+ );
223
+ }
224
+
225
+ export interface InviteRsvpPopoverProps {
226
+ messageUid: string;
227
+ invite: MessageInvite;
228
+ /** The RSVP button: the popover hangs from it, and focus goes back to it when the popover closes. */
229
+ anchorRef: RefObject<HTMLElement | null>;
230
+ /** Called with the invitation as it stands after an answer or a proposal. The popover has closed itself. */
231
+ onDone: (invite: MessageInvite) => void;
232
+ onClose: () => void;
233
+ }
234
+
235
+ /**
236
+ * What the RSVP button opens: an anchored popover on a desktop, a dialog on a phone. A day view of the reader's schedule around the meeting, with
237
+ * the invitation highlighted and its conflicts marked, and Accept, Decline, a "?" for Tentative and a "..." menu (Propose new time, Open in calendar).
238
+ * An answer is sent to the server, which puts the meeting on the calendar and replies to the organizer; the popover then closes and hands the
239
+ * updated invitation to its caller. A failure raises a pop-up and leaves the popover open.
240
+ *
241
+ * Focus moves to the first button when it opens, Escape closes it (a menu open inside it first), and focus returns to the RSVP button.
242
+ */
243
+ export default function InviteRsvpPopover({ messageUid, invite, anchorRef, onDone, onClose }: InviteRsvpPopoverProps) {
244
+ const isMobile = useIsMobile();
245
+ const [proposing, setProposing] = useState(false);
246
+ const title = invite.summary?.trim() || "(no title)";
247
+
248
+ function close() {
249
+ onClose();
250
+ anchorRef.current?.focus();
251
+ }
252
+
253
+ function done(updated: MessageInvite) {
254
+ onDone(updated);
255
+ close();
256
+ }
257
+
258
+ const panel = <RsvpPanel messageUid={messageUid} invite={invite} onDone={done} onClose={close} onProposingChange={setProposing} />;
259
+ if (isMobile) {
260
+ return (
261
+ <Modal open onClose={close} title="Meeting invitation">
262
+ {panel}
263
+ </Modal>
264
+ );
265
+ }
266
+ return (
267
+ <PopoverPortal anchorRef={anchorRef} onClose={onClose} width={WIDTH} height={estimateHeight(invite, proposing)} aria-label={`RSVP: ${title}`}>
268
+ {panel}
269
+ </PopoverPortal>
270
+ );
271
+ }
@@ -0,0 +1,200 @@
1
+ ///////////////////////////////////////////////////////////////////////////////
2
+ // Copyright (C) 2026 Jean-Philippe Steinmetz
3
+ // SPDX-License-Identifier: MPL-2.0
4
+ ///////////////////////////////////////////////////////////////////////////////
5
+ import React from "react";
6
+ import type { InviteScheduleEntry, MessageInvite } from "@rapidmx/react-shared/calendar/inviteApi.js";
7
+ import { validDate } from "./inviteFormat.js";
8
+
9
+ /** How tall one hour is drawn, in px. */
10
+ const HOUR_HEIGHT = 36;
11
+ /** The room the hour labels take at the left, as a CSS length. */
12
+ const LABEL_WIDTH = "3.25rem";
13
+ /** The hours of context shown before the invitation and after it, and the least the day view is tall (in hours). */
14
+ const CONTEXT_HOURS = 2;
15
+ const MIN_HOURS = 5;
16
+
17
+ const MINUTE_MS = 60_000;
18
+
19
+ /** A block of the day and where it sits among the blocks it overlaps. */
20
+ export interface PlacedBlock {
21
+ /** Which of the overlapping columns it is drawn in. */
22
+ column: number;
23
+ /** How many columns its cluster of overlapping blocks needs. */
24
+ columns: number;
25
+ }
26
+
27
+ /**
28
+ * Lays overlapping blocks side by side: blocks that overlap (directly or through a chain of others) form a cluster, and each block takes the first
29
+ * column of the cluster that is free where it starts. `blocks` must be sorted by start; the result is in the same order.
30
+ */
31
+ export function placeBlocks(blocks: { start: number; end: number }[]): PlacedBlock[] {
32
+ const placed: PlacedBlock[] = [];
33
+ let cluster: { index: number; column: number }[] = [];
34
+ let columnEnds: number[] = [];
35
+ let clusterEnd = -Infinity;
36
+ const close = () => {
37
+ for (const member of cluster) {
38
+ placed[member.index] = { column: member.column, columns: columnEnds.length };
39
+ }
40
+ cluster = [];
41
+ columnEnds = [];
42
+ };
43
+ blocks.forEach((block, index) => {
44
+ if (block.start >= clusterEnd) {
45
+ close();
46
+ }
47
+ let column = columnEnds.findIndex((end) => end <= block.start);
48
+ if (column === -1) {
49
+ column = columnEnds.length;
50
+ }
51
+ columnEnds[column] = block.end;
52
+ cluster.push({ index, column });
53
+ clusterEnd = Math.max(clusterEnd, block.end);
54
+ });
55
+ close();
56
+ return placed;
57
+ }
58
+
59
+ /** The hours the day view spans: the invitation's own, with `CONTEXT_HOURS` either side (at least `MIN_HOURS`), kept inside the invitation's day. */
60
+ function hourWindow(start: Date, end: Date): { from: number; to: number } {
61
+ const sameDay = start.toDateString() === end.toDateString();
62
+ const endHour = sameDay ? Math.ceil(end.getHours() + end.getMinutes() / 60) : 24;
63
+ let from = Math.max(0, start.getHours() - CONTEXT_HOURS);
64
+ let to = Math.min(24, endHour + CONTEXT_HOURS);
65
+ if (to - from < MIN_HOURS) {
66
+ to = Math.min(24, from + MIN_HOURS);
67
+ from = Math.max(0, to - MIN_HOURS);
68
+ }
69
+ return { from, to };
70
+ }
71
+
72
+ interface Block {
73
+ key: string;
74
+ title: string;
75
+ start: number;
76
+ end: number;
77
+ kind: "invite" | "conflict" | "busy" | "free";
78
+ tentative: boolean;
79
+ }
80
+
81
+ const BLOCK_CLASS: Record<Block["kind"], string> = {
82
+ invite: "bg-primary/20 border-primary text-text font-semibold",
83
+ conflict: "bg-danger-bg border-danger text-danger",
84
+ busy: "bg-surface border-border text-text",
85
+ free: "bg-transparent border-border text-text-muted",
86
+ };
87
+
88
+ const CLOCK = new Intl.DateTimeFormat(undefined, { hour: "numeric", minute: "2-digit" });
89
+ const HOUR = new Intl.DateTimeFormat(undefined, { hour: "numeric" });
90
+
91
+ export interface InviteTimelineProps {
92
+ invite: Pick<MessageInvite, "startDate" | "endDate" | "summary" | "conflicts" | "schedule">;
93
+ }
94
+
95
+ /**
96
+ * A small day agenda around an invitation, as Outlook draws it in its RSVP card: hour rows for the invitation's day (from a couple of hours before it
97
+ * to a couple after), the invitation itself as a highlighted block, and the reader's other events as blocks - the ones that overlap it marked in red
98
+ * (and named as conflicts to a screen reader). Overlapping blocks stand side by side. All-day events are listed above the hours rather than drawn.
99
+ * Draws nothing when the invitation has no usable time.
100
+ */
101
+ export default function InviteTimeline({ invite }: InviteTimelineProps) {
102
+ const start = validDate(invite.startDate);
103
+ const end = validDate(invite.endDate);
104
+ if (!start || !end || end <= start) {
105
+ return null;
106
+ }
107
+ const { from, to } = hourWindow(start, end);
108
+ const windowStart = new Date(start.getFullYear(), start.getMonth(), start.getDate(), from).getTime();
109
+ const windowEnd = new Date(start.getFullYear(), start.getMonth(), start.getDate(), to).getTime();
110
+ const conflictUids = new Set(invite.conflicts.map((entry) => entry.uid));
111
+ // A conflict the schedule doesn't list is still drawn.
112
+ const entries: InviteScheduleEntry[] = [...invite.schedule, ...invite.conflicts.filter((c) => !invite.schedule.some((s) => s.uid === c.uid))];
113
+ const allDay = entries.filter((entry) => entry.allDay);
114
+
115
+ const blocks: Block[] = [{ key: "invite", title: invite.summary?.trim() || "(no title)", start: start.getTime(), end: end.getTime(), kind: "invite", tentative: false }];
116
+ for (const entry of entries) {
117
+ const entryStart = validDate(entry.startDate)?.getTime();
118
+ const entryEnd = validDate(entry.endDate)?.getTime();
119
+ if (entry.allDay || entryStart === undefined || entryEnd === undefined) {
120
+ continue;
121
+ }
122
+ blocks.push({
123
+ key: entry.uid,
124
+ title: entry.title || "(no title)",
125
+ start: entryStart,
126
+ end: entryEnd,
127
+ kind: conflictUids.has(entry.uid) ? "conflict" : entry.busy ? "busy" : "free",
128
+ tentative: entry.tentative,
129
+ });
130
+ }
131
+ // Clipped to the hours shown; a block entirely outside them isn't drawn.
132
+ const visible = blocks
133
+ .map((block) => ({ ...block, start: Math.max(block.start, windowStart), end: Math.min(block.end, windowEnd), fullStart: block.start, fullEnd: block.end }))
134
+ .filter((block) => block.end > block.start)
135
+ .sort((a, b) => a.start - b.start || a.end - b.end);
136
+ const placed = placeBlocks(visible);
137
+ const hours = Array.from({ length: to - from }, (_, i) => from + i);
138
+
139
+ return (
140
+ <div aria-label="Your schedule around this meeting" role="group" className="text-xs">
141
+ {allDay.length > 0 && (
142
+ <ul aria-label="All-day events" className="mb-1 flex flex-col gap-0.5">
143
+ {allDay.map((entry) => (
144
+ <li key={entry.uid} className="px-2 py-0.5 rounded-sm border border-border bg-surface text-text-muted truncate">
145
+ All day: {entry.title || "(no title)"}
146
+ </li>
147
+ ))}
148
+ </ul>
149
+ )}
150
+ <div className="relative border-t border-border" style={{ height: hours.length * HOUR_HEIGHT }}>
151
+ {hours.map((hour) => (
152
+ <div
153
+ key={hour}
154
+ aria-hidden="true"
155
+ className="absolute inset-x-0 border-b border-border text-text-muted"
156
+ style={{ top: (hour - from) * HOUR_HEIGHT, height: HOUR_HEIGHT }}
157
+ >
158
+ <span className="absolute left-0 top-0 pr-1 leading-none pt-0.5" style={{ width: LABEL_WIDTH }}>
159
+ {HOUR.format(new Date(2000, 0, 1, hour))}
160
+ </span>
161
+ </div>
162
+ ))}
163
+ <ul aria-label="Events">
164
+ {visible.map((block, index) => {
165
+ const { column, columns } = placed[index];
166
+ const top = ((block.start - windowStart) / MINUTE_MS / 60) * HOUR_HEIGHT;
167
+ const height = Math.max(18, ((block.end - block.start) / MINUTE_MS / 60) * HOUR_HEIGHT - 1);
168
+ const range = `${CLOCK.format(block.fullStart)} to ${CLOCK.format(block.fullEnd)}`;
169
+ return (
170
+ <li
171
+ key={block.key}
172
+ title={`${block.title}, ${range}`}
173
+ data-kind={block.kind}
174
+ className={[
175
+ "absolute overflow-hidden rounded-sm border px-1.5 py-0.5 leading-tight",
176
+ BLOCK_CLASS[block.kind],
177
+ block.tentative ? "border-dashed" : "",
178
+ ].join(" ")}
179
+ style={{
180
+ top,
181
+ height,
182
+ left: `calc(${LABEL_WIDTH} + (100% - ${LABEL_WIDTH}) * ${column} / ${columns})`,
183
+ width: `calc((100% - ${LABEL_WIDTH}) / ${columns} - 2px)`,
184
+ }}
185
+ >
186
+ <span className="block truncate">{block.title}</span>
187
+ <span className="sr-only">
188
+ , {range}
189
+ {block.kind === "invite" ? ", this meeting" : ""}
190
+ {block.kind === "conflict" ? ", conflicts with this meeting" : ""}
191
+ {block.tentative ? ", tentative" : ""}
192
+ </span>
193
+ </li>
194
+ );
195
+ })}
196
+ </ul>
197
+ </div>
198
+ </div>
199
+ );
200
+ }