@rapidmx/web-client 0.15.1 → 0.16.0

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 (189) hide show
  1. package/README.md +373 -373
  2. package/apps/admin/branding/index.tsx +39 -39
  3. package/apps/admin/data-requests/index.tsx +482 -480
  4. package/apps/admin/domains/[uid].tsx +164 -164
  5. package/apps/admin/escrow-scopes/[uid].tsx +348 -348
  6. package/apps/admin/index.tsx +127 -124
  7. package/apps/admin/mailboxes/[uid].tsx +269 -224
  8. package/apps/admin/mailboxes/new/index.tsx +28 -28
  9. package/apps/admin/plugins/index.tsx +15 -15
  10. package/apps/admin/retention-policy/index.tsx +39 -39
  11. package/apps/admin/signing-certificates/index.tsx +343 -343
  12. package/apps/escrow/audit-log/index.tsx +196 -196
  13. package/apps/escrow/matters/[uid].tsx +621 -621
  14. package/apps/shared/auth/adminAccess.ts +99 -99
  15. package/apps/shared/components/admin/layout/AdminShell.tsx +378 -378
  16. package/apps/shared/components/admin/mailboxes/EraseLeftoverDataDialog.tsx +238 -0
  17. package/apps/shared/components/admin/mailboxes/EscrowScopeCard.tsx +152 -152
  18. package/apps/shared/components/admin/mailboxes/LeftoverMailboxesSection.tsx +194 -0
  19. package/apps/shared/components/admin/settings/BrandingForm.tsx +423 -423
  20. package/apps/shared/components/admin/settings/EncryptionPolicyForm.tsx +119 -119
  21. package/apps/shared/components/admin/settings/MailboxCreateForm.tsx +50 -3
  22. package/apps/shared/components/admin/settings/MailboxPolicyForm.tsx +198 -198
  23. package/apps/shared/components/admin/settings/PluginsManager.tsx +1545 -1545
  24. package/apps/shared/components/admin/settings/RetentionPolicyForm.tsx +182 -182
  25. package/apps/shared/components/admin/setup/EscrowSetupStep.tsx +288 -288
  26. package/apps/shared/components/admin/setup/SetupWizard.tsx +444 -444
  27. package/apps/shared/components/admin/usePagedList.tsx +129 -129
  28. package/apps/shared/components/calendar/EventEditor.tsx +5 -10
  29. package/apps/shared/components/calendar/EventFormParts.tsx +16 -47
  30. package/apps/shared/components/calendar/EventModal.tsx +206 -206
  31. package/apps/shared/components/calendar/GuestInput.tsx +100 -0
  32. package/apps/shared/components/calendar/MonthView.tsx +185 -185
  33. package/apps/shared/components/calendar/RecurrenceEditor.tsx +227 -227
  34. package/apps/shared/components/calendar/RequestChangeForm.tsx +23 -54
  35. package/apps/shared/components/calendar/SplitDayView.tsx +144 -144
  36. package/apps/shared/components/calendar/TimeGridView.tsx +246 -246
  37. package/apps/shared/components/calendar/allDay.ts +124 -124
  38. package/apps/shared/components/calendar/eventForm.ts +2 -2
  39. package/apps/shared/components/calendar/eventFormat.ts +49 -22
  40. package/apps/shared/components/calendar/layout/CalendarShell.tsx +201 -200
  41. package/apps/shared/components/contacts/ContactForm.tsx +383 -383
  42. package/apps/shared/components/contacts/ContactsSidebar.tsx +1 -1
  43. package/apps/shared/components/contacts/ContactsToolbar.tsx +103 -98
  44. package/apps/shared/components/contacts/layout/ContactsShell.tsx +217 -216
  45. package/apps/shared/components/escrow/layout/EscrowShell.tsx +155 -155
  46. package/apps/shared/components/layout/AppShell.tsx +480 -480
  47. package/apps/shared/components/layout/FloatingActionButton.tsx +31 -0
  48. package/apps/shared/components/layout/KeyEnrollmentGate.tsx +398 -398
  49. package/apps/shared/components/layout/MailboxProvisioning.tsx +168 -168
  50. package/apps/shared/components/layout/ResponsiveToolbar.tsx +315 -315
  51. package/apps/shared/components/layout/ThemeSwitch.tsx +84 -84
  52. package/apps/shared/components/layout/UserMenu.tsx +439 -424
  53. package/apps/shared/components/mail/ConversationList.tsx +323 -323
  54. package/apps/shared/components/mail/ConversationThreadPane.tsx +612 -491
  55. package/apps/shared/components/mail/MailSelectionBar.tsx +236 -227
  56. package/apps/shared/components/mail/MessageDetailPane.tsx +1559 -1559
  57. package/apps/shared/components/mail/compose/ComposeContext.tsx +312 -312
  58. package/apps/shared/components/mail/compose/ComposeToolbar.tsx +422 -422
  59. package/apps/shared/components/mail/compose/ComposeWindow.tsx +1681 -1677
  60. package/apps/shared/components/mail/compose/RecipientInput.tsx +54 -11
  61. package/apps/shared/components/mail/compose/RichTextEditor.tsx +147 -147
  62. package/apps/shared/components/mail/compose/composeFlushRegistry.ts +60 -60
  63. package/apps/shared/components/mail/compose/quotedBody.ts +161 -161
  64. package/apps/shared/components/mail/layout/FolderBadgeChip.tsx +21 -0
  65. package/apps/shared/components/mail/layout/MailShell.tsx +137 -113
  66. package/apps/shared/components/mail/layout/SidebarSection.tsx +66 -0
  67. package/apps/shared/components/mail/reading/PendingMessageCard.tsx +68 -0
  68. package/apps/shared/components/mail/verificationSeals.ts +125 -125
  69. package/apps/shared/components/rules/RuleBuilder.tsx +311 -311
  70. package/apps/shared/components/settings/SigningCertificateCard.tsx +344 -344
  71. package/apps/shared/components/settings/layout/SettingsShell.tsx +255 -254
  72. package/apps/shared/components/tasks/TasksSidebar.tsx +1 -1
  73. package/apps/shared/components/tasks/layout/TasksShell.tsx +218 -217
  74. package/apps/shared/keyboard/GlobalShortcuts.tsx +51 -51
  75. package/apps/shared/keyboard/ShortcutProvider.tsx +62 -62
  76. package/apps/shared/keyboard/ShortcutsDialog.tsx +84 -84
  77. package/apps/shared/keyboard/dispatch.ts +124 -124
  78. package/apps/shared/keyboard/format.ts +89 -89
  79. package/apps/shared/keyboard/keymap.ts +114 -114
  80. package/apps/shared/keyboard/registry.ts +65 -65
  81. package/apps/shared/keyboard/targets.ts +79 -79
  82. package/apps/shared/mail/folderCounts.ts +17 -0
  83. package/apps/shared/mail/folderTree.ts +143 -143
  84. package/apps/shared/mail/listAllPages.ts +39 -39
  85. package/apps/shared/mail/newMailNotifications.ts +171 -171
  86. package/apps/shared/mail/outbox/outgoingReplies.ts +192 -0
  87. package/apps/shared/mail/outbox/sendJob.ts +19 -1
  88. package/apps/shared/mail/outbox/sendOutcomes.ts +13 -4
  89. package/apps/shared/mail/primaryMailbox.ts +71 -0
  90. package/apps/shared/mail/useCollapsedSections.ts +146 -0
  91. package/apps/shared/mail/useMailConnection.ts +205 -203
  92. package/apps/shared/mail/useMailLiveUpdates.ts +277 -277
  93. package/apps/shared/mail/useMarkMessageRead.ts +47 -47
  94. package/apps/shared/mail/useNewMailNotifications.ts +178 -178
  95. package/apps/shared/navigation/AppRouter.tsx +300 -300
  96. package/apps/shared/navigation/routerContext.tsx +83 -83
  97. package/apps/shared/notifications/store.ts +560 -560
  98. package/apps/shared/search/LocalIndexLifecycle.tsx +114 -114
  99. package/apps/shared/search/crossMailboxSearch.ts +169 -0
  100. package/apps/shared/search/localIndexBuilder.ts +481 -481
  101. package/apps/shared/signing/enrollmentStorage.ts +33 -33
  102. package/apps/shared/signing/enrollmentTracker.ts +385 -385
  103. package/apps/shared/signing/enrollmentView.ts +251 -251
  104. package/apps/shared/signing/useNow.ts +19 -19
  105. package/apps/shared/signing/useSigningEnrollmentWatcher.ts +90 -90
  106. package/apps/shared/styles/app.css +396 -386
  107. package/apps/www/calendar/index.tsx +578 -571
  108. package/apps/www/contacts/[uid].tsx +109 -109
  109. package/apps/www/contacts/index.tsx +6 -0
  110. package/apps/www/index.tsx +2847 -2479
  111. package/apps/www/messages/[uid].tsx +135 -135
  112. package/apps/www/settings/auto-reply/index.tsx +133 -133
  113. package/apps/www/settings/encryption/index.tsx +1287 -1287
  114. package/apps/www/settings/filters/[uid].tsx +176 -176
  115. package/apps/www/settings/filters/index.tsx +102 -102
  116. package/apps/www/settings/filters/new/index.tsx +140 -140
  117. package/apps/www/settings/labels/index.tsx +204 -204
  118. package/apps/www/settings/privacy/index.tsx +492 -492
  119. package/apps/www/settings/profile/index.tsx +248 -248
  120. package/apps/www/settings/read-receipts/index.tsx +147 -147
  121. package/apps/www/settings/sharing/index.tsx +256 -256
  122. package/apps/www/settings/signatures/[uid].tsx +172 -172
  123. package/apps/www/settings/signatures/index.tsx +88 -88
  124. package/apps/www/settings/signatures/new/index.tsx +135 -135
  125. package/apps/www/tasks/index.tsx +649 -649
  126. package/dist/apps/admin/data-requests/index.js +1 -1
  127. package/dist/apps/admin/index.js +2 -1
  128. package/dist/apps/admin/mailboxes/[uid].js +12 -2
  129. package/dist/apps/shared/components/admin/layout/AdminShell.js +2 -2
  130. package/dist/apps/shared/components/admin/mailboxes/EraseLeftoverDataDialog.d.ts +35 -0
  131. package/dist/apps/shared/components/admin/mailboxes/EraseLeftoverDataDialog.js +115 -0
  132. package/dist/apps/shared/components/admin/mailboxes/LeftoverMailboxesSection.d.ts +16 -0
  133. package/dist/apps/shared/components/admin/mailboxes/LeftoverMailboxesSection.js +92 -0
  134. package/dist/apps/shared/components/admin/settings/BrandingForm.js +3 -3
  135. package/dist/apps/shared/components/admin/settings/MailboxCreateForm.js +25 -3
  136. package/dist/apps/shared/components/calendar/EventEditor.js +5 -10
  137. package/dist/apps/shared/components/calendar/EventFormParts.d.ts +3 -2
  138. package/dist/apps/shared/components/calendar/EventFormParts.js +5 -16
  139. package/dist/apps/shared/components/calendar/GuestInput.d.ts +45 -0
  140. package/dist/apps/shared/components/calendar/GuestInput.js +30 -0
  141. package/dist/apps/shared/components/calendar/RequestChangeForm.js +11 -22
  142. package/dist/apps/shared/components/calendar/eventForm.d.ts +2 -2
  143. package/dist/apps/shared/components/calendar/eventFormat.d.ts +21 -8
  144. package/dist/apps/shared/components/calendar/eventFormat.js +50 -23
  145. package/dist/apps/shared/components/calendar/layout/CalendarShell.js +3 -2
  146. package/dist/apps/shared/components/contacts/ContactsSidebar.js +1 -1
  147. package/dist/apps/shared/components/contacts/ContactsToolbar.d.ts +3 -1
  148. package/dist/apps/shared/components/contacts/ContactsToolbar.js +4 -2
  149. package/dist/apps/shared/components/contacts/layout/ContactsShell.js +4 -3
  150. package/dist/apps/shared/components/layout/FloatingActionButton.d.ts +13 -0
  151. package/dist/apps/shared/components/layout/FloatingActionButton.js +9 -0
  152. package/dist/apps/shared/components/layout/UserMenu.d.ts +4 -1
  153. package/dist/apps/shared/components/layout/UserMenu.js +6 -5
  154. package/dist/apps/shared/components/mail/ConversationThreadPane.js +127 -22
  155. package/dist/apps/shared/components/mail/MailSelectionBar.d.ts +6 -1
  156. package/dist/apps/shared/components/mail/MailSelectionBar.js +3 -3
  157. package/dist/apps/shared/components/mail/compose/ComposeWindow.js +8 -4
  158. package/dist/apps/shared/components/mail/compose/RecipientInput.d.ts +21 -1
  159. package/dist/apps/shared/components/mail/compose/RecipientInput.js +18 -10
  160. package/dist/apps/shared/components/mail/layout/FolderBadgeChip.d.ts +6 -0
  161. package/dist/apps/shared/components/mail/layout/FolderBadgeChip.js +9 -0
  162. package/dist/apps/shared/components/mail/layout/MailShell.d.ts +5 -0
  163. package/dist/apps/shared/components/mail/layout/MailShell.js +64 -45
  164. package/dist/apps/shared/components/mail/layout/SidebarSection.d.ts +23 -0
  165. package/dist/apps/shared/components/mail/layout/SidebarSection.js +16 -0
  166. package/dist/apps/shared/components/mail/reading/PendingMessageCard.d.ts +14 -0
  167. package/dist/apps/shared/components/mail/reading/PendingMessageCard.js +16 -0
  168. package/dist/apps/shared/components/settings/layout/SettingsShell.js +6 -5
  169. package/dist/apps/shared/components/tasks/TasksSidebar.js +1 -1
  170. package/dist/apps/shared/components/tasks/layout/TasksShell.js +4 -3
  171. package/dist/apps/shared/mail/folderCounts.d.ts +10 -0
  172. package/dist/apps/shared/mail/folderCounts.js +12 -0
  173. package/dist/apps/shared/mail/outbox/outgoingReplies.d.ts +80 -0
  174. package/dist/apps/shared/mail/outbox/outgoingReplies.js +131 -0
  175. package/dist/apps/shared/mail/outbox/sendJob.d.ts +5 -1
  176. package/dist/apps/shared/mail/outbox/sendJob.js +14 -1
  177. package/dist/apps/shared/mail/outbox/sendOutcomes.js +13 -4
  178. package/dist/apps/shared/mail/primaryMailbox.d.ts +29 -0
  179. package/dist/apps/shared/mail/primaryMailbox.js +61 -0
  180. package/dist/apps/shared/mail/useCollapsedSections.d.ts +32 -0
  181. package/dist/apps/shared/mail/useCollapsedSections.js +110 -0
  182. package/dist/apps/shared/mail/useMailConnection.js +3 -1
  183. package/dist/apps/shared/search/crossMailboxSearch.d.ts +72 -0
  184. package/dist/apps/shared/search/crossMailboxSearch.js +136 -0
  185. package/dist/apps/shared/styles/app.css +396 -386
  186. package/dist/apps/www/calendar/index.js +3 -2
  187. package/dist/apps/www/contacts/index.js +3 -1
  188. package/dist/apps/www/index.js +426 -189
  189. package/package.json +2 -2
@@ -1,422 +1,422 @@
1
- ///////////////////////////////////////////////////////////////////////////////
2
- // Copyright (C) 2026 Jean-Philippe Steinmetz
3
- // SPDX-License-Identifier: MPL-2.0
4
- ///////////////////////////////////////////////////////////////////////////////
5
- import React, { ReactNode, Suspense, lazy, useRef, useState } from "react";
6
- import type { Editor } from "@tiptap/react";
7
- import type { IconType } from "react-icons";
8
- import {
9
- BsArrowClockwise,
10
- BsArrowCounterclockwise,
11
- BsEraser,
12
- BsHighlighter,
13
- BsImage,
14
- BsIndent,
15
- BsJustify,
16
- BsLink45Deg,
17
- BsListOl,
18
- BsListUl,
19
- BsPaletteFill,
20
- BsTable,
21
- BsTextCenter,
22
- BsTextLeft,
23
- BsTextRight,
24
- BsTypeBold,
25
- BsTypeItalic,
26
- BsTypeStrikethrough,
27
- BsTypeUnderline,
28
- BsUnindent,
29
- } from "react-icons/bs";
30
- import GifPicker from "./GifPicker.js";
31
-
32
- /** Loaded when the picker is first opened: the emoji list is a half-megabyte JSON file that nothing else needs. */
33
- const EmojiPicker = lazy(() => import("./EmojiPicker.js"));
34
-
35
- export interface ComposeToolbarProps {
36
- /** `null` before the editor has mounted client-side (see `RichTextEditor`'s `immediatelyRender: false`
37
- * doc comment) — every button is disabled in that state rather than the toolbar rendering nothing, so
38
- * its layout doesn't shift the instant the editor becomes ready. */
39
- editor: Editor | null;
40
- /** Uploads `file` as an attachment on the current draft and resolves to a URL the browser can
41
- * preview it at while composing — see `BaseMailComposeRoute.rewriteInlineImageSources()`'s doc
42
- * comment for why that's not the final URL the message actually ships with. Resolves to `null`
43
- * (rather than rejecting) on failure — `ComposeWindow`'s own implementation is responsible for
44
- * surfacing the error itself, so a failed upload here just quietly doesn't insert an image. */
45
- onUploadImage: (file: File) => Promise<string | null>;
46
- }
47
-
48
- const FONT_FAMILIES = [
49
- { label: "Default", value: "" },
50
- { label: "Sans Serif", value: "Arial, Helvetica, sans-serif" },
51
- { label: "Serif", value: "Georgia, 'Times New Roman', serif" },
52
- { label: "Monospace", value: "'Courier New', monospace" },
53
- ];
54
-
55
- const FONT_SIZES = [
56
- { label: "Small", value: "12px" },
57
- { label: "Normal", value: "" },
58
- { label: "Large", value: "18px" },
59
- { label: "Huge", value: "24px" },
60
- ];
61
-
62
- function ToolbarButton({
63
- label,
64
- icon: Icon,
65
- active,
66
- disabled,
67
- onClick,
68
- }: {
69
- label: string;
70
- icon: IconType;
71
- active?: boolean;
72
- disabled?: boolean;
73
- onClick: () => void;
74
- }) {
75
- return (
76
- <button
77
- type="button"
78
- aria-label={label}
79
- aria-pressed={active ?? false}
80
- title={label}
81
- disabled={disabled}
82
- onClick={onClick}
83
- className={[
84
- "w-8 h-8 flex items-center justify-center rounded-sm disabled:opacity-40 disabled:cursor-not-allowed",
85
- active ? "bg-primary/10 text-primary-dark" : "text-text-muted hover:bg-surface-alt hover:text-text",
86
- ].join(" ")}
87
- >
88
- <Icon size={16} aria-hidden="true" />
89
- </button>
90
- );
91
- }
92
-
93
- function Divider() {
94
- return <div className="w-px self-stretch my-1.5 bg-border" aria-hidden="true" />;
95
- }
96
-
97
- /**
98
- * The compose page's rich-text formatting toolbar — a practical single Outlook-Home-tab-style bar
99
- * (font/size, bold/italic/underline/strikethrough, text/highlight color, alignment, lists/indent, insert
100
- * link/image/table, clear formatting, undo/redo), not a full multi-tab ribbon replica. Every command is a
101
- * plain `editor.chain().focus().<command>().run()` call against the `Editor` instance `RichTextEditor`
102
- * creates; active-state styling comes from `editor.isActive(...)`.
103
- */
104
- type Popup = "link" | "emoji" | "gif" | null;
105
-
106
- export default function ComposeToolbar({ editor, onUploadImage }: ComposeToolbarProps) {
107
- const [openPopup, setOpenPopup] = useState<Popup>(null);
108
- const [linkUrl, setLinkUrl] = useState("");
109
- const imageInputRef = useRef<HTMLInputElement>(null);
110
- const emojiButtonRef = useRef<HTMLButtonElement>(null);
111
- const gifButtonRef = useRef<HTMLButtonElement>(null);
112
-
113
- const disabled = !editor;
114
-
115
- // Every control that calls `run()` is itself `disabled` while `editor` is null (see `disabled` above),
116
- // and `editor` never reverts to null once TipTap actually creates it (only `immediatelyRender: false`'s
117
- // one-render gap before mount produces a null `editor` at all) — so `run()` is never reachable with a
118
- // null `editor` through any real UI interaction; asserted non-null rather than guarded, matching this
119
- // codebase's established pattern for the same class of "always non-null by the time it's called" value.
120
- function run(fn: (editor: Editor) => void) {
121
- fn(editor!);
122
- }
123
-
124
- async function handleImageFileSelected(e: React.ChangeEvent<HTMLInputElement>) {
125
- const file = e.target.files?.[0];
126
- e.target.value = "";
127
- if (!file) {
128
- return;
129
- }
130
- const url = await onUploadImage(file);
131
- if (url) {
132
- run((ed) => ed.chain().focus().setImage({ src: url }).run());
133
- }
134
- }
135
-
136
- function handleInsertEmoji(native: string) {
137
- run((e) => e.chain().focus().insertContent(native).run());
138
- setOpenPopup(null);
139
- }
140
-
141
- function handleInsertGif(url: string) {
142
- run((e) => e.chain().focus().setImage({ src: url }).run());
143
- setOpenPopup(null);
144
- }
145
-
146
- function openLinkPrompt() {
147
- setLinkUrl(editor?.getAttributes("link").href ?? "");
148
- setOpenPopup("link");
149
- }
150
-
151
- function submitLink(e: React.FormEvent) {
152
- e.preventDefault();
153
- if (linkUrl.trim().length === 0) {
154
- run((ed) => ed.chain().focus().extendMarkRange("link").unsetLink().run());
155
- } else {
156
- run((ed) => ed.chain().focus().extendMarkRange("link").setLink({ href: linkUrl.trim() }).run());
157
- }
158
- setOpenPopup(null);
159
- }
160
-
161
- let linkPrompt: ReactNode = null;
162
- if (openPopup === "link") {
163
- linkPrompt = (
164
- <form onSubmit={submitLink} className="flex items-center gap-1.5 px-2 py-1.5 border-t border-border">
165
- <input
166
- type="text"
167
- autoFocus
168
- aria-label="Link URL"
169
- placeholder="https://example.com"
170
- value={linkUrl}
171
- onChange={(e) => setLinkUrl(e.target.value)}
172
- className="flex-1 text-sm py-1 px-2 border border-border rounded-sm bg-surface"
173
- />
174
- <button type="submit" className="text-xs font-semibold text-primary-dark hover:underline">
175
- Apply
176
- </button>
177
- <button
178
- type="button"
179
- onClick={() => setOpenPopup(null)}
180
- className="text-xs font-medium text-text-muted hover:underline"
181
- >
182
- Cancel
183
- </button>
184
- </form>
185
- );
186
- }
187
-
188
- return (
189
- <div className="border-b border-border bg-surface-alt">
190
- <div className="flex flex-wrap items-center gap-0.5 px-2 py-1.5">
191
- <select
192
- aria-label="Font family"
193
- disabled={disabled}
194
- value={editor?.getAttributes("textStyle").fontFamily ?? ""}
195
- onChange={(e) =>
196
- run((ed) =>
197
- e.target.value
198
- ? ed.chain().focus().setFontFamily(e.target.value).run()
199
- : ed.chain().focus().unsetFontFamily().run(),
200
- )
201
- }
202
- className="text-xs py-1 px-1.5 border border-border rounded-sm bg-surface disabled:opacity-40"
203
- >
204
- {FONT_FAMILIES.map((f) => (
205
- <option key={f.label} value={f.value}>
206
- {f.label}
207
- </option>
208
- ))}
209
- </select>
210
-
211
- <select
212
- aria-label="Font size"
213
- disabled={disabled}
214
- value={editor?.getAttributes("textStyle").fontSize ?? ""}
215
- onChange={(e) =>
216
- run((ed) =>
217
- e.target.value
218
- ? ed.chain().focus().setFontSize(e.target.value).run()
219
- : ed.chain().focus().unsetFontSize().run(),
220
- )
221
- }
222
- className="text-xs py-1 px-1.5 border border-border rounded-sm bg-surface disabled:opacity-40"
223
- >
224
- {FONT_SIZES.map((f) => (
225
- <option key={f.label} value={f.value}>
226
- {f.label}
227
- </option>
228
- ))}
229
- </select>
230
-
231
- <Divider />
232
-
233
- <ToolbarButton
234
- label="Bold"
235
- icon={BsTypeBold}
236
- disabled={disabled}
237
- active={editor?.isActive("bold")}
238
- onClick={() => run((e) => e.chain().focus().toggleBold().run())}
239
- />
240
- <ToolbarButton
241
- label="Italic"
242
- icon={BsTypeItalic}
243
- disabled={disabled}
244
- active={editor?.isActive("italic")}
245
- onClick={() => run((e) => e.chain().focus().toggleItalic().run())}
246
- />
247
- <ToolbarButton
248
- label="Underline"
249
- icon={BsTypeUnderline}
250
- disabled={disabled}
251
- active={editor?.isActive("underline")}
252
- onClick={() => run((e) => e.chain().focus().toggleUnderline().run())}
253
- />
254
- <ToolbarButton
255
- label="Strikethrough"
256
- icon={BsTypeStrikethrough}
257
- disabled={disabled}
258
- active={editor?.isActive("strike")}
259
- onClick={() => run((e) => e.chain().focus().toggleStrike().run())}
260
- />
261
-
262
- <Divider />
263
-
264
- <label className="w-8 h-8 flex items-center justify-center rounded-sm text-text-muted hover:bg-surface-alt hover:text-text cursor-pointer has-[:disabled]:opacity-40 has-[:disabled]:cursor-not-allowed">
265
- <BsPaletteFill size={16} aria-hidden="true" />
266
- <span className="sr-only">Text color</span>
267
- <input
268
- type="color"
269
- disabled={disabled}
270
- value={editor?.getAttributes("textStyle").color ?? "#000000"}
271
- onChange={(e) => run((ed) => ed.chain().focus().setColor(e.target.value).run())}
272
- className="sr-only"
273
- />
274
- </label>
275
- <ToolbarButton
276
- label="Highlight"
277
- icon={BsHighlighter}
278
- disabled={disabled}
279
- active={editor?.isActive("highlight")}
280
- onClick={() => run((e) => e.chain().focus().toggleHighlight().run())}
281
- />
282
-
283
- <Divider />
284
-
285
- <ToolbarButton
286
- label="Align left"
287
- icon={BsTextLeft}
288
- disabled={disabled}
289
- active={editor?.isActive({ textAlign: "left" })}
290
- onClick={() => run((e) => e.chain().focus().setTextAlign("left").run())}
291
- />
292
- <ToolbarButton
293
- label="Align center"
294
- icon={BsTextCenter}
295
- disabled={disabled}
296
- active={editor?.isActive({ textAlign: "center" })}
297
- onClick={() => run((e) => e.chain().focus().setTextAlign("center").run())}
298
- />
299
- <ToolbarButton
300
- label="Align right"
301
- icon={BsTextRight}
302
- disabled={disabled}
303
- active={editor?.isActive({ textAlign: "right" })}
304
- onClick={() => run((e) => e.chain().focus().setTextAlign("right").run())}
305
- />
306
- <ToolbarButton
307
- label="Justify"
308
- icon={BsJustify}
309
- disabled={disabled}
310
- active={editor?.isActive({ textAlign: "justify" })}
311
- onClick={() => run((e) => e.chain().focus().setTextAlign("justify").run())}
312
- />
313
-
314
- <Divider />
315
-
316
- <ToolbarButton
317
- label="Bulleted list"
318
- icon={BsListUl}
319
- disabled={disabled}
320
- active={editor?.isActive("bulletList")}
321
- onClick={() => run((e) => e.chain().focus().toggleBulletList().run())}
322
- />
323
- <ToolbarButton
324
- label="Numbered list"
325
- icon={BsListOl}
326
- disabled={disabled}
327
- active={editor?.isActive("orderedList")}
328
- onClick={() => run((e) => e.chain().focus().toggleOrderedList().run())}
329
- />
330
- <ToolbarButton
331
- label="Decrease indent"
332
- icon={BsUnindent}
333
- disabled={disabled}
334
- onClick={() => run((e) => e.chain().focus().liftListItem("listItem").run())}
335
- />
336
- <ToolbarButton
337
- label="Increase indent"
338
- icon={BsIndent}
339
- disabled={disabled}
340
- onClick={() => run((e) => e.chain().focus().sinkListItem("listItem").run())}
341
- />
342
-
343
- <Divider />
344
-
345
- <ToolbarButton
346
- label="Insert link"
347
- icon={BsLink45Deg}
348
- disabled={disabled}
349
- active={editor?.isActive("link")}
350
- onClick={openLinkPrompt}
351
- />
352
- <ToolbarButton label="Insert image" icon={BsImage} disabled={disabled} onClick={() => imageInputRef.current?.click()} />
353
- <input
354
- ref={imageInputRef}
355
- type="file"
356
- accept="image/*"
357
- onChange={handleImageFileSelected}
358
- className="sr-only"
359
- aria-label="Insert image file"
360
- />
361
- <ToolbarButton
362
- label="Insert table"
363
- icon={BsTable}
364
- disabled={disabled}
365
- onClick={() => run((e) => e.chain().focus().insertTable({ rows: 3, cols: 3, withHeaderRow: true }).run())}
366
- />
367
-
368
- <button
369
- ref={emojiButtonRef}
370
- type="button"
371
- aria-label="Insert emoji"
372
- title="Insert emoji"
373
- disabled={disabled}
374
- onClick={() => setOpenPopup((p) => (p === "emoji" ? null : "emoji"))}
375
- className="w-8 h-8 flex items-center justify-center text-base rounded-sm disabled:opacity-40 disabled:cursor-not-allowed text-text-muted hover:bg-surface-alt hover:text-text"
376
- >
377
- 😀
378
- </button>
379
- {openPopup === "emoji" && (
380
- <Suspense fallback={null}>
381
- <EmojiPicker anchorRef={emojiButtonRef} onSelect={handleInsertEmoji} onClose={() => setOpenPopup(null)} />
382
- </Suspense>
383
- )}
384
-
385
- <button
386
- ref={gifButtonRef}
387
- type="button"
388
- aria-label="Insert GIF"
389
- title="Insert GIF"
390
- disabled={disabled}
391
- onClick={() => setOpenPopup((p) => (p === "gif" ? null : "gif"))}
392
- className="w-8 h-8 flex items-center justify-center text-[10px] font-extrabold tracking-tight rounded-sm disabled:opacity-40 disabled:cursor-not-allowed text-text-muted hover:bg-surface-alt hover:text-text"
393
- >
394
- GIF
395
- </button>
396
- {openPopup === "gif" && <GifPicker anchorRef={gifButtonRef} onSelect={handleInsertGif} onClose={() => setOpenPopup(null)} />}
397
-
398
- <Divider />
399
-
400
- <ToolbarButton
401
- label="Clear formatting"
402
- icon={BsEraser}
403
- disabled={disabled}
404
- onClick={() => run((e) => e.chain().focus().unsetAllMarks().clearNodes().run())}
405
- />
406
- <ToolbarButton
407
- label="Undo"
408
- icon={BsArrowCounterclockwise}
409
- disabled={disabled || !editor?.can().undo()}
410
- onClick={() => run((e) => e.chain().focus().undo().run())}
411
- />
412
- <ToolbarButton
413
- label="Redo"
414
- icon={BsArrowClockwise}
415
- disabled={disabled || !editor?.can().redo()}
416
- onClick={() => run((e) => e.chain().focus().redo().run())}
417
- />
418
- </div>
419
- {linkPrompt}
420
- </div>
421
- );
422
- }
1
+ ///////////////////////////////////////////////////////////////////////////////
2
+ // Copyright (C) 2026 Jean-Philippe Steinmetz
3
+ // SPDX-License-Identifier: MPL-2.0
4
+ ///////////////////////////////////////////////////////////////////////////////
5
+ import React, { ReactNode, Suspense, lazy, useRef, useState } from "react";
6
+ import type { Editor } from "@tiptap/react";
7
+ import type { IconType } from "react-icons";
8
+ import {
9
+ BsArrowClockwise,
10
+ BsArrowCounterclockwise,
11
+ BsEraser,
12
+ BsHighlighter,
13
+ BsImage,
14
+ BsIndent,
15
+ BsJustify,
16
+ BsLink45Deg,
17
+ BsListOl,
18
+ BsListUl,
19
+ BsPaletteFill,
20
+ BsTable,
21
+ BsTextCenter,
22
+ BsTextLeft,
23
+ BsTextRight,
24
+ BsTypeBold,
25
+ BsTypeItalic,
26
+ BsTypeStrikethrough,
27
+ BsTypeUnderline,
28
+ BsUnindent,
29
+ } from "react-icons/bs";
30
+ import GifPicker from "./GifPicker.js";
31
+
32
+ /** Loaded when the picker is first opened: the emoji list is a half-megabyte JSON file that nothing else needs. */
33
+ const EmojiPicker = lazy(() => import("./EmojiPicker.js"));
34
+
35
+ export interface ComposeToolbarProps {
36
+ /** `null` before the editor has mounted client-side (see `RichTextEditor`'s `immediatelyRender: false`
37
+ * doc comment) — every button is disabled in that state rather than the toolbar rendering nothing, so
38
+ * its layout doesn't shift the instant the editor becomes ready. */
39
+ editor: Editor | null;
40
+ /** Uploads `file` as an attachment on the current draft and resolves to a URL the browser can
41
+ * preview it at while composing — see `BaseMailComposeRoute.rewriteInlineImageSources()`'s doc
42
+ * comment for why that's not the final URL the message actually ships with. Resolves to `null`
43
+ * (rather than rejecting) on failure — `ComposeWindow`'s own implementation is responsible for
44
+ * surfacing the error itself, so a failed upload here just quietly doesn't insert an image. */
45
+ onUploadImage: (file: File) => Promise<string | null>;
46
+ }
47
+
48
+ const FONT_FAMILIES = [
49
+ { label: "Default", value: "" },
50
+ { label: "Sans Serif", value: "Arial, Helvetica, sans-serif" },
51
+ { label: "Serif", value: "Georgia, 'Times New Roman', serif" },
52
+ { label: "Monospace", value: "'Courier New', monospace" },
53
+ ];
54
+
55
+ const FONT_SIZES = [
56
+ { label: "Small", value: "12px" },
57
+ { label: "Normal", value: "" },
58
+ { label: "Large", value: "18px" },
59
+ { label: "Huge", value: "24px" },
60
+ ];
61
+
62
+ function ToolbarButton({
63
+ label,
64
+ icon: Icon,
65
+ active,
66
+ disabled,
67
+ onClick,
68
+ }: {
69
+ label: string;
70
+ icon: IconType;
71
+ active?: boolean;
72
+ disabled?: boolean;
73
+ onClick: () => void;
74
+ }) {
75
+ return (
76
+ <button
77
+ type="button"
78
+ aria-label={label}
79
+ aria-pressed={active ?? false}
80
+ title={label}
81
+ disabled={disabled}
82
+ onClick={onClick}
83
+ className={[
84
+ "w-8 h-8 flex items-center justify-center rounded-sm disabled:opacity-40 disabled:cursor-not-allowed",
85
+ active ? "bg-primary/10 text-primary-dark" : "text-text-muted hover:bg-surface-alt hover:text-text",
86
+ ].join(" ")}
87
+ >
88
+ <Icon size={16} aria-hidden="true" />
89
+ </button>
90
+ );
91
+ }
92
+
93
+ function Divider() {
94
+ return <div className="w-px self-stretch my-1.5 bg-border" aria-hidden="true" />;
95
+ }
96
+
97
+ /**
98
+ * The compose page's rich-text formatting toolbar — a practical single Outlook-Home-tab-style bar
99
+ * (font/size, bold/italic/underline/strikethrough, text/highlight color, alignment, lists/indent, insert
100
+ * link/image/table, clear formatting, undo/redo), not a full multi-tab ribbon replica. Every command is a
101
+ * plain `editor.chain().focus().<command>().run()` call against the `Editor` instance `RichTextEditor`
102
+ * creates; active-state styling comes from `editor.isActive(...)`.
103
+ */
104
+ type Popup = "link" | "emoji" | "gif" | null;
105
+
106
+ export default function ComposeToolbar({ editor, onUploadImage }: ComposeToolbarProps) {
107
+ const [openPopup, setOpenPopup] = useState<Popup>(null);
108
+ const [linkUrl, setLinkUrl] = useState("");
109
+ const imageInputRef = useRef<HTMLInputElement>(null);
110
+ const emojiButtonRef = useRef<HTMLButtonElement>(null);
111
+ const gifButtonRef = useRef<HTMLButtonElement>(null);
112
+
113
+ const disabled = !editor;
114
+
115
+ // Every control that calls `run()` is itself `disabled` while `editor` is null (see `disabled` above),
116
+ // and `editor` never reverts to null once TipTap actually creates it (only `immediatelyRender: false`'s
117
+ // one-render gap before mount produces a null `editor` at all) — so `run()` is never reachable with a
118
+ // null `editor` through any real UI interaction; asserted non-null rather than guarded, matching this
119
+ // codebase's established pattern for the same class of "always non-null by the time it's called" value.
120
+ function run(fn: (editor: Editor) => void) {
121
+ fn(editor!);
122
+ }
123
+
124
+ async function handleImageFileSelected(e: React.ChangeEvent<HTMLInputElement>) {
125
+ const file = e.target.files?.[0];
126
+ e.target.value = "";
127
+ if (!file) {
128
+ return;
129
+ }
130
+ const url = await onUploadImage(file);
131
+ if (url) {
132
+ run((ed) => ed.chain().focus().setImage({ src: url }).run());
133
+ }
134
+ }
135
+
136
+ function handleInsertEmoji(native: string) {
137
+ run((e) => e.chain().focus().insertContent(native).run());
138
+ setOpenPopup(null);
139
+ }
140
+
141
+ function handleInsertGif(url: string) {
142
+ run((e) => e.chain().focus().setImage({ src: url }).run());
143
+ setOpenPopup(null);
144
+ }
145
+
146
+ function openLinkPrompt() {
147
+ setLinkUrl(editor?.getAttributes("link").href ?? "");
148
+ setOpenPopup("link");
149
+ }
150
+
151
+ function submitLink(e: React.FormEvent) {
152
+ e.preventDefault();
153
+ if (linkUrl.trim().length === 0) {
154
+ run((ed) => ed.chain().focus().extendMarkRange("link").unsetLink().run());
155
+ } else {
156
+ run((ed) => ed.chain().focus().extendMarkRange("link").setLink({ href: linkUrl.trim() }).run());
157
+ }
158
+ setOpenPopup(null);
159
+ }
160
+
161
+ let linkPrompt: ReactNode = null;
162
+ if (openPopup === "link") {
163
+ linkPrompt = (
164
+ <form onSubmit={submitLink} className="flex items-center gap-1.5 px-2 py-1.5 border-t border-border">
165
+ <input
166
+ type="text"
167
+ autoFocus
168
+ aria-label="Link URL"
169
+ placeholder="https://example.com"
170
+ value={linkUrl}
171
+ onChange={(e) => setLinkUrl(e.target.value)}
172
+ className="flex-1 text-sm py-1 px-2 border border-border rounded-sm bg-surface"
173
+ />
174
+ <button type="submit" className="text-xs font-semibold text-primary-dark hover:underline">
175
+ Apply
176
+ </button>
177
+ <button
178
+ type="button"
179
+ onClick={() => setOpenPopup(null)}
180
+ className="text-xs font-medium text-text-muted hover:underline"
181
+ >
182
+ Cancel
183
+ </button>
184
+ </form>
185
+ );
186
+ }
187
+
188
+ return (
189
+ <div className="border-b border-border bg-surface-alt">
190
+ <div className="flex flex-wrap items-center gap-0.5 px-2 py-1.5">
191
+ <select
192
+ aria-label="Font family"
193
+ disabled={disabled}
194
+ value={editor?.getAttributes("textStyle").fontFamily ?? ""}
195
+ onChange={(e) =>
196
+ run((ed) =>
197
+ e.target.value
198
+ ? ed.chain().focus().setFontFamily(e.target.value).run()
199
+ : ed.chain().focus().unsetFontFamily().run(),
200
+ )
201
+ }
202
+ className="text-xs py-1 px-1.5 border border-border rounded-sm bg-surface disabled:opacity-40"
203
+ >
204
+ {FONT_FAMILIES.map((f) => (
205
+ <option key={f.label} value={f.value}>
206
+ {f.label}
207
+ </option>
208
+ ))}
209
+ </select>
210
+
211
+ <select
212
+ aria-label="Font size"
213
+ disabled={disabled}
214
+ value={editor?.getAttributes("textStyle").fontSize ?? ""}
215
+ onChange={(e) =>
216
+ run((ed) =>
217
+ e.target.value
218
+ ? ed.chain().focus().setFontSize(e.target.value).run()
219
+ : ed.chain().focus().unsetFontSize().run(),
220
+ )
221
+ }
222
+ className="text-xs py-1 px-1.5 border border-border rounded-sm bg-surface disabled:opacity-40"
223
+ >
224
+ {FONT_SIZES.map((f) => (
225
+ <option key={f.label} value={f.value}>
226
+ {f.label}
227
+ </option>
228
+ ))}
229
+ </select>
230
+
231
+ <Divider />
232
+
233
+ <ToolbarButton
234
+ label="Bold"
235
+ icon={BsTypeBold}
236
+ disabled={disabled}
237
+ active={editor?.isActive("bold")}
238
+ onClick={() => run((e) => e.chain().focus().toggleBold().run())}
239
+ />
240
+ <ToolbarButton
241
+ label="Italic"
242
+ icon={BsTypeItalic}
243
+ disabled={disabled}
244
+ active={editor?.isActive("italic")}
245
+ onClick={() => run((e) => e.chain().focus().toggleItalic().run())}
246
+ />
247
+ <ToolbarButton
248
+ label="Underline"
249
+ icon={BsTypeUnderline}
250
+ disabled={disabled}
251
+ active={editor?.isActive("underline")}
252
+ onClick={() => run((e) => e.chain().focus().toggleUnderline().run())}
253
+ />
254
+ <ToolbarButton
255
+ label="Strikethrough"
256
+ icon={BsTypeStrikethrough}
257
+ disabled={disabled}
258
+ active={editor?.isActive("strike")}
259
+ onClick={() => run((e) => e.chain().focus().toggleStrike().run())}
260
+ />
261
+
262
+ <Divider />
263
+
264
+ <label className="w-8 h-8 flex items-center justify-center rounded-sm text-text-muted hover:bg-surface-alt hover:text-text cursor-pointer has-[:disabled]:opacity-40 has-[:disabled]:cursor-not-allowed">
265
+ <BsPaletteFill size={16} aria-hidden="true" />
266
+ <span className="sr-only">Text color</span>
267
+ <input
268
+ type="color"
269
+ disabled={disabled}
270
+ value={editor?.getAttributes("textStyle").color ?? "#000000"}
271
+ onChange={(e) => run((ed) => ed.chain().focus().setColor(e.target.value).run())}
272
+ className="sr-only"
273
+ />
274
+ </label>
275
+ <ToolbarButton
276
+ label="Highlight"
277
+ icon={BsHighlighter}
278
+ disabled={disabled}
279
+ active={editor?.isActive("highlight")}
280
+ onClick={() => run((e) => e.chain().focus().toggleHighlight().run())}
281
+ />
282
+
283
+ <Divider />
284
+
285
+ <ToolbarButton
286
+ label="Align left"
287
+ icon={BsTextLeft}
288
+ disabled={disabled}
289
+ active={editor?.isActive({ textAlign: "left" })}
290
+ onClick={() => run((e) => e.chain().focus().setTextAlign("left").run())}
291
+ />
292
+ <ToolbarButton
293
+ label="Align center"
294
+ icon={BsTextCenter}
295
+ disabled={disabled}
296
+ active={editor?.isActive({ textAlign: "center" })}
297
+ onClick={() => run((e) => e.chain().focus().setTextAlign("center").run())}
298
+ />
299
+ <ToolbarButton
300
+ label="Align right"
301
+ icon={BsTextRight}
302
+ disabled={disabled}
303
+ active={editor?.isActive({ textAlign: "right" })}
304
+ onClick={() => run((e) => e.chain().focus().setTextAlign("right").run())}
305
+ />
306
+ <ToolbarButton
307
+ label="Justify"
308
+ icon={BsJustify}
309
+ disabled={disabled}
310
+ active={editor?.isActive({ textAlign: "justify" })}
311
+ onClick={() => run((e) => e.chain().focus().setTextAlign("justify").run())}
312
+ />
313
+
314
+ <Divider />
315
+
316
+ <ToolbarButton
317
+ label="Bulleted list"
318
+ icon={BsListUl}
319
+ disabled={disabled}
320
+ active={editor?.isActive("bulletList")}
321
+ onClick={() => run((e) => e.chain().focus().toggleBulletList().run())}
322
+ />
323
+ <ToolbarButton
324
+ label="Numbered list"
325
+ icon={BsListOl}
326
+ disabled={disabled}
327
+ active={editor?.isActive("orderedList")}
328
+ onClick={() => run((e) => e.chain().focus().toggleOrderedList().run())}
329
+ />
330
+ <ToolbarButton
331
+ label="Decrease indent"
332
+ icon={BsUnindent}
333
+ disabled={disabled}
334
+ onClick={() => run((e) => e.chain().focus().liftListItem("listItem").run())}
335
+ />
336
+ <ToolbarButton
337
+ label="Increase indent"
338
+ icon={BsIndent}
339
+ disabled={disabled}
340
+ onClick={() => run((e) => e.chain().focus().sinkListItem("listItem").run())}
341
+ />
342
+
343
+ <Divider />
344
+
345
+ <ToolbarButton
346
+ label="Insert link"
347
+ icon={BsLink45Deg}
348
+ disabled={disabled}
349
+ active={editor?.isActive("link")}
350
+ onClick={openLinkPrompt}
351
+ />
352
+ <ToolbarButton label="Insert image" icon={BsImage} disabled={disabled} onClick={() => imageInputRef.current?.click()} />
353
+ <input
354
+ ref={imageInputRef}
355
+ type="file"
356
+ accept="image/*"
357
+ onChange={handleImageFileSelected}
358
+ className="sr-only"
359
+ aria-label="Insert image file"
360
+ />
361
+ <ToolbarButton
362
+ label="Insert table"
363
+ icon={BsTable}
364
+ disabled={disabled}
365
+ onClick={() => run((e) => e.chain().focus().insertTable({ rows: 3, cols: 3, withHeaderRow: true }).run())}
366
+ />
367
+
368
+ <button
369
+ ref={emojiButtonRef}
370
+ type="button"
371
+ aria-label="Insert emoji"
372
+ title="Insert emoji"
373
+ disabled={disabled}
374
+ onClick={() => setOpenPopup((p) => (p === "emoji" ? null : "emoji"))}
375
+ className="w-8 h-8 flex items-center justify-center text-base rounded-sm disabled:opacity-40 disabled:cursor-not-allowed text-text-muted hover:bg-surface-alt hover:text-text"
376
+ >
377
+ 😀
378
+ </button>
379
+ {openPopup === "emoji" && (
380
+ <Suspense fallback={null}>
381
+ <EmojiPicker anchorRef={emojiButtonRef} onSelect={handleInsertEmoji} onClose={() => setOpenPopup(null)} />
382
+ </Suspense>
383
+ )}
384
+
385
+ <button
386
+ ref={gifButtonRef}
387
+ type="button"
388
+ aria-label="Insert GIF"
389
+ title="Insert GIF"
390
+ disabled={disabled}
391
+ onClick={() => setOpenPopup((p) => (p === "gif" ? null : "gif"))}
392
+ className="w-8 h-8 flex items-center justify-center text-[10px] font-extrabold tracking-tight rounded-sm disabled:opacity-40 disabled:cursor-not-allowed text-text-muted hover:bg-surface-alt hover:text-text"
393
+ >
394
+ GIF
395
+ </button>
396
+ {openPopup === "gif" && <GifPicker anchorRef={gifButtonRef} onSelect={handleInsertGif} onClose={() => setOpenPopup(null)} />}
397
+
398
+ <Divider />
399
+
400
+ <ToolbarButton
401
+ label="Clear formatting"
402
+ icon={BsEraser}
403
+ disabled={disabled}
404
+ onClick={() => run((e) => e.chain().focus().unsetAllMarks().clearNodes().run())}
405
+ />
406
+ <ToolbarButton
407
+ label="Undo"
408
+ icon={BsArrowCounterclockwise}
409
+ disabled={disabled || !editor?.can().undo()}
410
+ onClick={() => run((e) => e.chain().focus().undo().run())}
411
+ />
412
+ <ToolbarButton
413
+ label="Redo"
414
+ icon={BsArrowClockwise}
415
+ disabled={disabled || !editor?.can().redo()}
416
+ onClick={() => run((e) => e.chain().focus().redo().run())}
417
+ />
418
+ </div>
419
+ {linkPrompt}
420
+ </div>
421
+ );
422
+ }