@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,327 @@
1
+ ///////////////////////////////////////////////////////////////////////////////
2
+ // Copyright (C) 2026 Jean-Philippe Steinmetz
3
+ // SPDX-License-Identifier: MPL-2.0
4
+ ///////////////////////////////////////////////////////////////////////////////
5
+ import React, { FormEvent, ReactNode, useState } from "react";
6
+ import { HiOutlineArrowTopRightOnSquare, HiOutlineCalendar, HiOutlineCalendarDays, HiOutlineClock, HiOutlineLink, HiOutlineMapPin } from "react-icons/hi2";
7
+ import { ApiRequestError } from "@rapidmx/react-shared/util/api.js";
8
+ import Button from "@rapidmx/react-shared/components/buttons/Button.js";
9
+ import CopyButton from "@rapidmx/react-shared/components/buttons/CopyButton.js";
10
+ import {
11
+ BookingLocationType,
12
+ CreateBookingTypeInput,
13
+ CreatedBookingType,
14
+ bookingPublicUrl,
15
+ createBookingType,
16
+ newBookingLinkHref,
17
+ slugFor,
18
+ } from "../../calendar/bookingPlugin.js";
19
+ import { EventFormController } from "./eventForm.js";
20
+ import { CalendarField, INPUT_CLASS, IconRow, SELECT_CLASS } from "./EventFormParts.js";
21
+ import QuickFaceFrame from "./QuickFaceFrame.js";
22
+
23
+ const DAY_NAMES = ["Sunday", "Monday", "Tuesday", "Wednesday", "Thursday", "Friday", "Saturday"];
24
+ const DURATIONS = ["15", "30", "45", "60"];
25
+ const BUFFERS = ["0", "5", "10", "15", "30"];
26
+ /** How often the plugin lets a slot repeat and how long one may be (`MIN_SLOT_MINUTES` to a day), in minutes. */
27
+ const MIN_DURATION = 5;
28
+ const MAX_DURATION = 1440;
29
+ /** How many times a taken link name is retried with a number after it (`intro`, `intro-2`, ...). */
30
+ const MAX_SLUG_ATTEMPTS = 5;
31
+
32
+ const LOCATIONS: { key: "video" | "phone" | "other"; type: BookingLocationType; label: string }[] = [
33
+ { key: "video", type: "video", label: "Video call" },
34
+ { key: "phone", type: "phone", label: "Phone call" },
35
+ { key: "other", type: "other", label: "Other" },
36
+ ];
37
+
38
+ /** What the Appointment schedule tab holds besides the title (which is the Event tab's): kept by `QuickCreateFaces`, so it survives a trip to another tab. */
39
+ export interface AppointmentDraft {
40
+ /** One of `DURATIONS`, or `"custom"` to use `customMinutes`. */
41
+ duration: string;
42
+ customMinutes: string;
43
+ /** Whether each weekday (0 = Sunday) is bookable. */
44
+ days: boolean[];
45
+ /** `HH:mm`, the hours every bookable day is open. */
46
+ startTime: string;
47
+ endTime: string;
48
+ /** Minutes kept free after each appointment. */
49
+ buffer: string;
50
+ video: boolean;
51
+ phone: boolean;
52
+ other: boolean;
53
+ /** Set once the schedule is saved: the face then shows its link. */
54
+ created: { name: string; url: string; uid: string; mailboxUid: string } | null;
55
+ }
56
+
57
+ /** A new schedule: 30 minutes, Monday to Friday 9:00 to 17:00, a video call, no buffer. */
58
+ export function initialAppointmentDraft(): AppointmentDraft {
59
+ return {
60
+ duration: "30",
61
+ customMinutes: "",
62
+ days: [false, true, true, true, true, true, false],
63
+ startTime: "09:00",
64
+ endTime: "17:00",
65
+ buffer: "0",
66
+ video: true,
67
+ phone: false,
68
+ other: false,
69
+ created: null,
70
+ };
71
+ }
72
+
73
+ /** Creates the booking type, trying the next number after `base` (`intro`, `intro-2`, ...) while its link name is taken (a 409). */
74
+ async function createWithFreeSlug(base: string, input: Omit<CreateBookingTypeInput, "slug">): Promise<CreatedBookingType> {
75
+ for (let attempt = 1; ; attempt++) {
76
+ try {
77
+ return await createBookingType({ ...input, slug: attempt === 1 ? base : `${base}-${attempt}` });
78
+ } catch (err) {
79
+ if (!(err instanceof ApiRequestError && err.status === 409 && attempt < MAX_SLUG_ATTEMPTS)) {
80
+ throw err;
81
+ }
82
+ }
83
+ }
84
+ }
85
+
86
+ function minutesOf(time: string): number {
87
+ const [hours, minutes] = time.split(":").map(Number);
88
+ return hours * 60 + minutes;
89
+ }
90
+
91
+ export interface AppointmentQuickFormProps {
92
+ c: EventFormController;
93
+ draft: AppointmentDraft;
94
+ onDraftChange: (patch: Partial<AppointmentDraft>) => void;
95
+ tabs: ReactNode;
96
+ /** The booking plugin's Settings path (`/settings/booking-types`), where More options goes. */
97
+ settingsHref: string;
98
+ /** The name booking pages show for the host. */
99
+ hostName: string;
100
+ /** The IANA zone the open hours are in. */
101
+ timeZone: string;
102
+ }
103
+
104
+ /**
105
+ * The Appointment schedule tab of the New event popover: publishes a bookable schedule (a booking type of `@rapidmx/booking-plugin`) with
106
+ * `POST /api/mail/booking-types` - a name (the title), a duration, the weekdays and hours people can book, the buffer after each
107
+ * appointment, how they may meet (video, phone, other) and which calendar takes the bookings - and then shows the public booking link with a
108
+ * Copy button. Everything else about a booking link (approval, notice, a window, per-day hours, date overrides, several meeting types, a
109
+ * description, the page's avatar and banner) is on the plugin's own page, which More options opens.
110
+ */
111
+ export default function AppointmentQuickForm({ c, draft, onDraftChange, tabs, settingsHref, hostName, timeZone }: AppointmentQuickFormProps) {
112
+ const { values } = c;
113
+ const [error, setError] = useState<string | null>(null);
114
+ const [saving, setSaving] = useState(false);
115
+
116
+ async function handleSubmit(event: FormEvent) {
117
+ event.preventDefault();
118
+ if (draft.created) {
119
+ c.onCancel();
120
+ return;
121
+ }
122
+ setError(null);
123
+ const name = values.title.trim();
124
+ const durationMinutes = Number(draft.duration === "custom" ? draft.customMinutes : draft.duration);
125
+ const startMinute = minutesOf(draft.startTime);
126
+ const endMinute = minutesOf(draft.endTime);
127
+ const locationOptions = LOCATIONS.filter((location) => draft[location.key]).map((location) => ({ type: location.type }));
128
+ let problem: string | undefined;
129
+ if (!name) {
130
+ problem = "A title is required.";
131
+ } else if (!Number.isInteger(durationMinutes) || durationMinutes < MIN_DURATION || durationMinutes > MAX_DURATION) {
132
+ problem = `A duration is a whole number of minutes from ${MIN_DURATION} to ${MAX_DURATION}.`;
133
+ } else if (!draft.days.some(Boolean)) {
134
+ problem = "Choose at least one day people can book.";
135
+ } else if (!(startMinute < endMinute)) {
136
+ problem = "The first bookable time must be before the last.";
137
+ } else if (endMinute - startMinute < durationMinutes) {
138
+ problem = "The hours people can book are shorter than one appointment.";
139
+ } else if (locationOptions.length === 0) {
140
+ problem = "Choose at least one way to meet.";
141
+ }
142
+ if (problem) {
143
+ setError(problem);
144
+ return;
145
+ }
146
+
147
+ setSaving(true);
148
+ try {
149
+ const base = slugFor(name);
150
+ const availability = draft.days.flatMap((open, dayOfWeek) => (open ? [{ dayOfWeek, startMinute, endMinute }] : []));
151
+ const created = await createWithFreeSlug(base, {
152
+ mailboxUid: values.targetMailboxUid,
153
+ calendarFolderUid: values.targetFolderUid,
154
+ name,
155
+ hostDisplayName: hostName,
156
+ meetingTypes: [{ name, durationMinutes, locationOptions }],
157
+ timezone: timeZone,
158
+ availability,
159
+ bufferAfterMinutes: Number(draft.buffer),
160
+ });
161
+ onDraftChange({
162
+ created: { name: created.name, url: bookingPublicUrl(created.mailboxUid, created.slug), uid: created.uid, mailboxUid: created.mailboxUid },
163
+ });
164
+ } catch (err) {
165
+ setError(err instanceof ApiRequestError ? err.message : "Could not create this appointment schedule.");
166
+ } finally {
167
+ setSaving(false);
168
+ }
169
+ }
170
+
171
+ const { created } = draft;
172
+ return (
173
+ <QuickFaceFrame
174
+ c={c}
175
+ tabs={tabs}
176
+ tab="appointment"
177
+ error={error}
178
+ hideTitle={!!created}
179
+ onSubmit={(event) => void handleSubmit(event)}
180
+ footer={
181
+ created ? (
182
+ <Button type="submit" className="!w-auto">
183
+ Done
184
+ </Button>
185
+ ) : (
186
+ <>
187
+ <a
188
+ href={newBookingLinkHref(settingsHref, values.targetMailboxUid)}
189
+ className="inline-flex items-center gap-1 text-sm font-semibold text-accent-dark hover:underline px-1 py-1"
190
+ >
191
+ More options
192
+ <HiOutlineArrowTopRightOnSquare size={14} aria-hidden="true" />
193
+ </a>
194
+ <Button type="submit" loading={saving} disabled={saving} className="!w-auto">
195
+ Save
196
+ </Button>
197
+ </>
198
+ )
199
+ }
200
+ >
201
+ {created ? (
202
+ <IconRow icon={<HiOutlineLink size={20} />}>
203
+ <p role="status" className="text-sm font-medium mb-1">
204
+ &ldquo;{created.name}&rdquo; is ready to book.
205
+ </p>
206
+ <p className="text-xs text-text-muted mb-2">Share this link and anyone can pick an open time - no account needed.</p>
207
+ <div className="flex items-center gap-2">
208
+ <input type="text" readOnly aria-label="Booking link" className={`${INPUT_CLASS} min-w-0`} value={created.url} onFocus={(e) => e.target.select()} />
209
+ <CopyButton value={created.url} label="Copy the booking link" />
210
+ </div>
211
+ <a
212
+ href={`${settingsHref}/${encodeURIComponent(created.uid)}?mailboxUid=${encodeURIComponent(created.mailboxUid)}`}
213
+ className="inline-block text-xs text-primary-dark hover:underline mt-2"
214
+ >
215
+ Change its settings
216
+ </a>
217
+ </IconRow>
218
+ ) : (
219
+ <>
220
+ <IconRow icon={<HiOutlineClock size={20} />}>
221
+ <div className="flex flex-wrap items-center gap-2 text-sm">
222
+ <select
223
+ aria-label="Duration"
224
+ className={SELECT_CLASS}
225
+ value={draft.duration}
226
+ onChange={(e) => onDraftChange({ duration: e.target.value })}
227
+ >
228
+ {DURATIONS.map((minutes) => (
229
+ <option key={minutes} value={minutes}>
230
+ {minutes} minutes
231
+ </option>
232
+ ))}
233
+ <option value="custom">Custom</option>
234
+ </select>
235
+ {draft.duration === "custom" && (
236
+ <>
237
+ <input
238
+ type="number"
239
+ min={MIN_DURATION}
240
+ max={MAX_DURATION}
241
+ aria-label="Custom duration in minutes"
242
+ className={`${INPUT_CLASS} !w-24`}
243
+ value={draft.customMinutes}
244
+ onChange={(e) => onDraftChange({ customMinutes: e.target.value })}
245
+ />
246
+ <span className="text-text-muted">minutes</span>
247
+ </>
248
+ )}
249
+ <span className="text-text-muted">with</span>
250
+ <select
251
+ aria-label="Buffer after each appointment"
252
+ className={SELECT_CLASS}
253
+ value={draft.buffer}
254
+ onChange={(e) => onDraftChange({ buffer: e.target.value })}
255
+ >
256
+ {BUFFERS.map((minutes) => (
257
+ <option key={minutes} value={minutes}>
258
+ {minutes === "0" ? "no buffer" : `${minutes} min buffer after`}
259
+ </option>
260
+ ))}
261
+ </select>
262
+ </div>
263
+ </IconRow>
264
+
265
+ <IconRow icon={<HiOutlineCalendarDays size={20} />}>
266
+ <div role="group" aria-label="Days people can book" className="flex gap-1 mb-2">
267
+ {DAY_NAMES.map((day, index) => (
268
+ <button
269
+ key={day}
270
+ type="button"
271
+ aria-label={day}
272
+ aria-pressed={draft.days[index]}
273
+ title={day}
274
+ onClick={() => onDraftChange({ days: draft.days.map((open, i) => (i === index ? !open : open)) })}
275
+ className={[
276
+ "w-8 h-8 rounded-full text-xs font-medium border",
277
+ draft.days[index] ? "bg-primary text-white border-primary" : "border-border text-text-muted hover:bg-surface-alt",
278
+ ].join(" ")}
279
+ >
280
+ {day[0]}
281
+ </button>
282
+ ))}
283
+ </div>
284
+ <div className="flex flex-wrap items-center gap-2 text-sm">
285
+ <input
286
+ type="time"
287
+ aria-label="Bookable from"
288
+ className={`${SELECT_CLASS} min-w-0`}
289
+ value={draft.startTime}
290
+ onChange={(e) => onDraftChange({ startTime: e.target.value })}
291
+ />
292
+ <span className="text-text-muted">to</span>
293
+ <input
294
+ type="time"
295
+ aria-label="Bookable until"
296
+ className={`${SELECT_CLASS} min-w-0`}
297
+ value={draft.endTime}
298
+ onChange={(e) => onDraftChange({ endTime: e.target.value })}
299
+ />
300
+ </div>
301
+ <p className="text-xs text-text-muted mt-1">Times are in {timeZone.replace(/_/g, " ")}.</p>
302
+ </IconRow>
303
+
304
+ <IconRow icon={<HiOutlineMapPin size={20} />}>
305
+ <div role="group" aria-label="How people can meet" className="flex flex-wrap gap-x-4 gap-y-1 text-sm py-1">
306
+ {LOCATIONS.map((location) => (
307
+ <label key={location.key} className="flex items-center gap-2">
308
+ <input
309
+ type="checkbox"
310
+ checked={draft[location.key]}
311
+ onChange={(e) => onDraftChange({ [location.key]: e.target.checked })}
312
+ />
313
+ {location.label}
314
+ </label>
315
+ ))}
316
+ </div>
317
+ </IconRow>
318
+
319
+ <IconRow icon={<HiOutlineCalendar size={20} />}>
320
+ <p className="text-xs text-text-muted mb-1">Bookings are added to</p>
321
+ <CalendarField c={c} />
322
+ </IconRow>
323
+ </>
324
+ )}
325
+ </QuickFaceFrame>
326
+ );
327
+ }
@@ -0,0 +1,274 @@
1
+ ///////////////////////////////////////////////////////////////////////////////
2
+ // Copyright (C) 2026 Jean-Philippe Steinmetz
3
+ // SPDX-License-Identifier: MPL-2.0
4
+ ///////////////////////////////////////////////////////////////////////////////
5
+ import React, { FormEvent, KeyboardEvent, useRef, useState } from "react";
6
+ import { EditorContent, useEditor, useEditorState, type Editor } from "@tiptap/react";
7
+ import StarterKit from "@tiptap/starter-kit";
8
+ import Placeholder from "@tiptap/extension-placeholder";
9
+ import type { IconType } from "react-icons";
10
+ import { BsEraser, BsLink45Deg, BsListOl, BsListUl, BsTypeBold, BsTypeItalic, BsTypeUnderline } from "react-icons/bs";
11
+ import { safeDescriptionHref } from "@rapidmx/react-shared/calendar/eventDescription.js";
12
+
13
+ export interface DescriptionEditorProps {
14
+ /** The description to start with, as HTML. Read once, when the editor is created: TipTap owns the document from then on. */
15
+ value: string;
16
+ /** Called with the document as HTML (`<p></p>` for an empty one) each time it changes. */
17
+ onChange: (html: string) => void;
18
+ /** Focus the text when the editor appears (the "Add description" row that opened it). */
19
+ autoFocus?: boolean;
20
+ /** The accessible name of the text box. */
21
+ label?: string;
22
+ }
23
+
24
+ /**
25
+ * The plain text on a clipboard as paragraphs, one for each line - what `handlePaste` inserts instead of the pasted formatting. Empty lines are kept as
26
+ * empty paragraphs, so a pasted block keeps its shape.
27
+ */
28
+ function paragraphsOf(text: string) {
29
+ return text.split(/\r\n|\r|\n/).map((line) => ({ type: "paragraph", content: line ? [{ type: "text", text: line }] : [] }));
30
+ }
31
+
32
+ /**
33
+ * What a typed link address is: an `http`, `https` or `mailto` link, with `https://` put in front of an address that names no scheme ("example.com") and
34
+ * `mailto:` in front of a plain email address. `undefined` for anything else (`javascript:`, `data:`, ...).
35
+ */
36
+ export function linkFromInput(input: string): string | undefined {
37
+ const text = input.trim();
38
+ if (/\s/.test(text)) {
39
+ return undefined;
40
+ }
41
+ if (/^[a-z][a-z0-9+.-]*:/i.test(text)) {
42
+ return safeDescriptionHref(text);
43
+ }
44
+ return safeDescriptionHref(/^[^\s@/]+@[^\s@/]+$/.test(text) ? `mailto:${text}` : `https://${text}`);
45
+ }
46
+
47
+ const NO_MARKS = { bold: false, italic: false, underline: false, bulletList: false, orderedList: false, link: false };
48
+
49
+ interface ToolbarButton {
50
+ label: string;
51
+ icon: IconType;
52
+ pressed?: boolean;
53
+ onClick: () => void;
54
+ }
55
+
56
+ /**
57
+ * The rich-text box of an event's description, as Google Calendar draws it: a toolbar (bold, italic, underline, numbered list, bulleted list, link, remove
58
+ * formatting) over the text. Built on TipTap with only the schema an event description may hold - paragraphs, line breaks, bold, italic, underline, lists and
59
+ * `http`/`https`/`mailto` links, so the HTML it writes has nothing the server would remove. Ctrl/Cmd+B, I and U format, Ctrl/Cmd+K asks for a link, and a
60
+ * paste keeps the text and drops the formatting.
61
+ *
62
+ * The toolbar is a WAI-ARIA toolbar: one tab stop, the arrow keys, Home and End move along it, and each toggle says whether it is on (`aria-pressed`). The
63
+ * buttons do not take focus from the text, so a selection survives pressing one.
64
+ */
65
+ export default function DescriptionEditor({ value, onChange, autoFocus, label = "Description" }: DescriptionEditorProps) {
66
+ const onChangeRef = useRef(onChange);
67
+ onChangeRef.current = onChange;
68
+ const openLinkRef = useRef<(() => void) | null>(null);
69
+ // The paste handler is created with the editor, before the editor exists.
70
+ const editorRef = useRef<Editor | null>(null);
71
+ const editor = useEditor({
72
+ extensions: [
73
+ StarterKit.configure({
74
+ heading: false,
75
+ blockquote: false,
76
+ code: false,
77
+ codeBlock: false,
78
+ horizontalRule: false,
79
+ strike: false,
80
+ dropcursor: false,
81
+ gapcursor: false,
82
+ trailingNode: false,
83
+ link: {
84
+ openOnClick: false,
85
+ autolink: false,
86
+ linkOnPaste: false,
87
+ protocols: ["http", "https", "mailto"],
88
+ HTMLAttributes: { rel: "noopener noreferrer", target: "_blank", class: "text-primary-dark underline" },
89
+ },
90
+ }),
91
+ Placeholder.configure({ placeholder: "Add description" }),
92
+ ],
93
+ content: value,
94
+ autofocus: autoFocus ? "end" : false,
95
+ immediatelyRender: false,
96
+ editorProps: {
97
+ attributes: { role: "textbox", "aria-multiline": "true", "aria-label": label },
98
+ handlePaste: (_view, event) => {
99
+ // A paste that came without a clipboard (ProseMirror then reads it back through a hidden field) has no text to give.
100
+ const text = event.clipboardData?.getData("text/plain") ?? "";
101
+ if (!text) {
102
+ return false;
103
+ }
104
+ event.preventDefault();
105
+ editorRef.current!.chain().focus().insertContent(paragraphsOf(text)).run();
106
+ return true;
107
+ },
108
+ handleKeyDown: (_view, event) => {
109
+ if ((event.ctrlKey || event.metaKey) && !event.shiftKey && !event.altKey && event.key.toLowerCase() === "k") {
110
+ event.preventDefault();
111
+ openLinkRef.current!();
112
+ return true;
113
+ }
114
+ return false;
115
+ },
116
+ },
117
+ onUpdate: ({ editor: updated }) => onChangeRef.current(updated.getHTML()),
118
+ });
119
+ editorRef.current = editor;
120
+
121
+ // Which formats the caret is in (re-read on every transaction). There is no editor until it has mounted, and then nothing is on.
122
+ const marks = useEditorState({
123
+ editor,
124
+ selector: ({ editor: current }) =>
125
+ current
126
+ ? {
127
+ bold: current.isActive("bold"),
128
+ italic: current.isActive("italic"),
129
+ underline: current.isActive("underline"),
130
+ bulletList: current.isActive("bulletList"),
131
+ orderedList: current.isActive("orderedList"),
132
+ link: current.isActive("link"),
133
+ }
134
+ : NO_MARKS,
135
+ }) as typeof NO_MARKS;
136
+
137
+ const [linkOpen, setLinkOpen] = useState(false);
138
+ const [linkText, setLinkText] = useState("");
139
+ const [linkError, setLinkError] = useState<string | null>(null);
140
+ const [focusIndex, setFocusIndex] = useState(0);
141
+ const buttons = useRef<(HTMLButtonElement | null)[]>([]);
142
+
143
+ function openLink() {
144
+ setLinkText(editor!.getAttributes("link").href ?? "");
145
+ setLinkError(null);
146
+ setLinkOpen(true);
147
+ }
148
+ openLinkRef.current = openLink;
149
+
150
+ function closeLink() {
151
+ setLinkOpen(false);
152
+ editor!.commands.focus();
153
+ }
154
+
155
+ function submitLink(event: FormEvent) {
156
+ // The description sits inside the event's own form: applying a link must not submit that.
157
+ event.preventDefault();
158
+ event.stopPropagation();
159
+ const chain = editor!.chain().focus();
160
+ if (linkText.trim() === "") {
161
+ chain.extendMarkRange("link").unsetLink().run();
162
+ } else {
163
+ const href = linkFromInput(linkText);
164
+ if (!href) {
165
+ setLinkError("Enter a web address (http or https) or an email address.");
166
+ return;
167
+ }
168
+ if (editor!.state.selection.empty && !editor!.isActive("link")) {
169
+ chain.insertContent({ type: "text", text: linkText.trim(), marks: [{ type: "link", attrs: { href } }] }).run();
170
+ } else {
171
+ chain.extendMarkRange("link").setLink({ href }).run();
172
+ }
173
+ }
174
+ setLinkOpen(false);
175
+ }
176
+
177
+ const items: ToolbarButton[] = [
178
+ { label: "Bold", icon: BsTypeBold, pressed: marks.bold, onClick: () => editor!.chain().focus().toggleBold().run() },
179
+ { label: "Italic", icon: BsTypeItalic, pressed: marks.italic, onClick: () => editor!.chain().focus().toggleItalic().run() },
180
+ { label: "Underline", icon: BsTypeUnderline, pressed: marks.underline, onClick: () => editor!.chain().focus().toggleUnderline().run() },
181
+ { label: "Numbered list", icon: BsListOl, pressed: marks.orderedList, onClick: () => editor!.chain().focus().toggleOrderedList().run() },
182
+ { label: "Bulleted list", icon: BsListUl, pressed: marks.bulletList, onClick: () => editor!.chain().focus().toggleBulletList().run() },
183
+ { label: "Link", icon: BsLink45Deg, pressed: marks.link, onClick: openLink },
184
+ { label: "Remove formatting", icon: BsEraser, onClick: () => editor!.chain().focus().unsetAllMarks().run() },
185
+ ];
186
+
187
+ function handleToolbarKeyDown(event: KeyboardEvent<HTMLDivElement>) {
188
+ const last = items.length - 1;
189
+ const next =
190
+ event.key === "ArrowRight" ? (focusIndex === last ? 0 : focusIndex + 1)
191
+ : event.key === "ArrowLeft" ? (focusIndex === 0 ? last : focusIndex - 1)
192
+ : event.key === "Home" ? 0
193
+ : event.key === "End" ? last
194
+ : undefined;
195
+ if (next !== undefined) {
196
+ event.preventDefault();
197
+ setFocusIndex(next);
198
+ buttons.current[next]!.focus();
199
+ }
200
+ }
201
+
202
+ return (
203
+ <div className="border border-border rounded-md bg-surface focus-within:border-primary">
204
+ <div role="toolbar" aria-label="Description formatting" onKeyDown={handleToolbarKeyDown} className="flex flex-wrap items-center gap-0.5 px-1.5 py-1 border-b border-border">
205
+ {items.map((item, index) => (
206
+ <button
207
+ key={item.label}
208
+ ref={(element) => {
209
+ buttons.current[index] = element;
210
+ }}
211
+ type="button"
212
+ aria-label={item.label}
213
+ title={item.label}
214
+ aria-pressed={item.pressed}
215
+ disabled={!editor}
216
+ tabIndex={index === focusIndex ? 0 : -1}
217
+ onFocus={() => setFocusIndex(index)}
218
+ // Pressing a button must not move focus (and the selection) out of the text.
219
+ onMouseDown={(event) => event.preventDefault()}
220
+ onClick={item.onClick}
221
+ className={[
222
+ "w-7 h-7 flex items-center justify-center rounded-sm disabled:opacity-40",
223
+ item.pressed ? "bg-primary/10 text-primary-dark" : "text-text-muted hover:bg-surface-alt hover:text-text",
224
+ ].join(" ")}
225
+ >
226
+ <item.icon size={15} aria-hidden="true" />
227
+ </button>
228
+ ))}
229
+ </div>
230
+ {linkOpen && (
231
+ <div className="flex flex-col gap-1 px-2 py-1.5 border-b border-border">
232
+ <div className="flex items-center gap-1.5">
233
+ <input
234
+ type="text"
235
+ autoFocus
236
+ aria-label="Link address"
237
+ placeholder="https://example.com"
238
+ value={linkText}
239
+ onChange={(event) => {
240
+ setLinkText(event.target.value);
241
+ setLinkError(null);
242
+ }}
243
+ onKeyDown={(event) => {
244
+ if (event.key === "Enter") {
245
+ submitLink(event);
246
+ } else if (event.key === "Escape") {
247
+ // Closes the prompt, not the dialog around it.
248
+ event.stopPropagation();
249
+ closeLink();
250
+ }
251
+ }}
252
+ className="flex-1 min-w-0 text-sm py-1 px-2 border border-border rounded-sm bg-surface"
253
+ />
254
+ <button type="button" onClick={submitLink} className="text-xs font-semibold text-primary-dark hover:underline">
255
+ Apply
256
+ </button>
257
+ <button type="button" onClick={closeLink} className="text-xs font-medium text-text-muted hover:underline">
258
+ Cancel
259
+ </button>
260
+ </div>
261
+ {linkError && (
262
+ <p role="alert" className="text-xs text-danger">
263
+ {linkError}
264
+ </p>
265
+ )}
266
+ </div>
267
+ )}
268
+ <EditorContent
269
+ editor={editor}
270
+ className="px-3 py-2 text-sm max-h-64 overflow-y-auto [&_.tiptap]:outline-none [&_.tiptap]:min-h-[4.5rem] [&_.tiptap_ul]:list-disc [&_.tiptap_ul]:pl-5 [&_.tiptap_ol]:list-decimal [&_.tiptap_ol]:pl-5 [&_.tiptap_p.is-editor-empty:first-child]:before:content-[attr(data-placeholder)] [&_.tiptap_p.is-editor-empty:first-child]:before:text-text-muted [&_.tiptap_p.is-editor-empty:first-child]:before:float-left [&_.tiptap_p.is-editor-empty:first-child]:before:h-0 [&_.tiptap_p.is-editor-empty:first-child]:before:pointer-events-none"
271
+ />
272
+ </div>
273
+ );
274
+ }