Repository Public
1// Coquille du courrier : trois volets redimensionnables (dossiers, liste, lecture), disposition au choix, barre du bas sur2// téléphone, raccourcis clavier, aide, suivi des envois, rédaction.3import { Suspense, useEffect } from "react"4import { t } from "../i18n"5import type { DeliveredState } from "../jmap/types"6import { S, routeHref, type Delivery } from "../state/app"7import { composeNew, dismissDelivery } from "../state/composer"8import { closeThread, moveCursor, toggleSelect } from "../state/mail"9import { runShortcut, useMainPane, useShortcuts } from "../state/registry"10import { navigate } from "../state/session"11import { useStore } from "../state/store"12import { BottomNav } from "./BottomNav"13import { Composer } from "./Composer"14import { MessageList } from "./MessageList"15import { Reader } from "./Reader"16import { Sidebar } from "./Sidebar"17import { Splitter } from "./Splitter"18import { doArchive, doDelete, doJunk, doMarkRead, doReply, doToggleFlag, doTogglePin, openRow } from "./actions"19import { goView, snoozeTargets, toggleSidebar } from "./commands"20import { ConfirmHost, Dialog, ErrorBoundary, Icon, IconButton, Spinner } from "./kit"21import { unifiedKeys } from "./unifiedKeys"2223const SHORTCUTS: [string, "help.palette" | "help.next" | "help.prev" | "help.open" | "help.back" | "help.select" | "help.archive" | "help.delete" | "help.flag" | "help.pin" | "help.snooze" | "help.reply" | "help.replyAll" | "help.forward" | "help.compose" | "help.search" | "help.goInbox" | "help.goAll" | "help.goFlagged" | "help.goDrafts" | "help.goSent" | "help.read" | "help.unread" | "help.junk" | "help.send" | "help.sidebar" | "help.escape" | "help.help"][] = [24 ["Ctrl/⌘+K", "help.palette"], ["j", "help.next"], ["k", "help.prev"], ["o / ↵", "help.open"], ["u", "help.back"], ["x", "help.select"], ["e", "help.archive"], ["#", "help.delete"], ["s", "help.flag"], ["p", "help.pin"], ["b", "help.snooze"],25 ["r", "help.reply"], ["a", "help.replyAll"], ["f", "help.forward"], ["c", "help.compose"], ["/", "help.search"], ["g i", "help.goInbox"], ["g a", "help.goAll"], ["g s", "help.goFlagged"], ["g d", "help.goDrafts"], ["g t", "help.goSent"],26 ["Shift+I", "help.read"], ["Shift+U", "help.unread"], ["!", "help.junk"], ["Ctrl/⌘+↵", "help.send"], ["[", "help.sidebar"], ["Esc", "help.escape"], ["?", "help.help"],27]2829const TEMPLATE_SHORTCUTS: [string, "help.tpl.new" | "help.tpl.search" | "help.tpl.save" | "help.tpl.find" | "help.tpl.generate" | "help.tpl.tabOut" | "help.tpl.tabs"][] = [30 ["n", "help.tpl.new"], ["/", "help.tpl.search"], ["Ctrl/⌘+S", "help.tpl.save"], ["Ctrl/⌘+F", "help.tpl.find"], ["Ctrl/⌘+↵", "help.tpl.generate"], ["Esc Tab", "help.tpl.tabOut"], ["← →", "help.tpl.tabs"],31]3233function ShortcutList({ items }: { items: [string, Parameters<typeof t>[0]][] }) {34 return (35 <dl className="shortcuts">36 {items.map(([keys, label]) => (37 <div key={keys}>38 <dt>39 {keys.split(" ").map((k, i) => (k === "/" && keys !== "/" ? <span key={i}> / </span> : <kbd key={i}>{k}</kbd>))}40 </dt>41 <dd>{t(label)}</dd>42 </div>43 ))}44 </dl>45 )46}4748/** Aide des raccourcis : ceux du courrier et ceux du studio de modèles (la section de la zone affichée vient en premier). */49export function HelpDialog({ area = "mail" }: { area?: "mail" | "templates" }) {50 const extra = useShortcuts()51 const mail = (52 <section key="mail">53 <h3 className="shortcuts-title">{t("help.section.mail")}</h3>54 <ShortcutList items={SHORTCUTS} />55 {extra.length ? (56 <dl className="shortcuts shortcuts-extra">57 {extra.map((sc) => (58 <div key={sc.id}>59 <dt>60 {sc.keys.split(" ").map((k, i) => (61 <kbd key={i}>{k}</kbd>62 ))}63 </dt>64 <dd>{sc.label()}</dd>65 </div>66 ))}67 </dl>68 ) : null}69 </section>70 )71 const templates = (72 <section key="templates">73 <h3 className="shortcuts-title">{t("help.section.templates")}</h3>74 <ShortcutList items={TEMPLATE_SHORTCUTS} />75 </section>76 )77 return (78 <Dialog title={t("help.title")} onClose={() => S.set({ helpOpen: false })} wide>79 {/* contenu plus haut que le dialogue : la zone défilante doit pouvoir recevoir le focus (défilement au clavier) */}80 <div className="stack shortcuts-body" tabIndex={0} role="group" aria-label={t("help.title")}>81 {area === "templates" ? [templates, mail] : [mail, templates]}82 </div>83 </Dialog>84 )85}8687let gPending = 088function onKey(e: KeyboardEvent) {89 if (e.defaultPrevented || e.metaKey || e.ctrlKey || e.altKey) return90 const s = S.get()91 if (s.phase !== "ready" || (s.route.name !== "mail" && s.route.name !== "next")) return92 const target = e.target as HTMLElement | null93 if (target && (target.isContentEditable || /^(INPUT|TEXTAREA|SELECT)$/.test(target.tagName))) return94 if (document.querySelector('[aria-modal="true"]')) return95 if (target?.closest(".composer, .menu")) return96 const k = e.key97 const done = () => e.preventDefault()98 if (gPending && Date.now() - gPending < 1500) {99 gPending = 0100 // séquences « g x » inscrites par les modules (state/registry.ts) : elles l'emportent sur celles d'origine101 if (runShortcut(k, true, s)) return done()102 if (k === "a" && (s.me?.mailboxes.length ?? 0) > 1) {103 done()104 navigate(routeHref({ name: "mail", all: true, mbIndex: 0, view: "inbox", threadId: null, q: "" }))105 return106 }107 const dest = { i: "inbox", s: "flagged", d: "drafts", t: "sent" }[k]108 if (dest) {109 done()110 goView(dest)111 return112 }113 }114 if (k === "g") {115 gPending = Date.now()116 return117 }118 if (runShortcut(k, false, s)) return done()119 if (s.route.name !== "mail") {120 // écrans « Next » : seuls rédaction, aide et raccourcis inscrits valent ici121 if (k === "c") (done(), composeNew())122 else if (k === "?") (done(), S.set({ helpOpen: true }))123 return124 }125 // « Toutes les boîtes » : la liste unifiée traite ses propres touches ; le reste (lecteur, rédaction, aide) est commun126 if (s.all && unifiedKeys.handle?.(k, target)) return done()127 switch (k) {128 case "j":129 case "ArrowDown":130 case "k":131 case "ArrowUp": {132 if ((k === "ArrowDown" || k === "ArrowUp") && !target?.closest("#message-list")) return133 done()134 const id = moveCursor(k === "j" || k === "ArrowDown" ? 1 : -1)135 if (id && s.open) openRow(id)136 return137 }138 case "o":139 case "Enter":140 if (k === "Enter" && target && /^(BUTTON|A|SUMMARY)$/.test(target.tagName)) return141 {142 // sans curseur (liste tout juste affichée), la première ligne est visée143 const id = s.cursor ?? moveCursor(1)144 if (id) {145 done()146 openRow(id)147 }148 }149 return150 case " ":151 case "x":152 if (k === " " && !target?.closest("#message-list")) return153 {154 const id = s.cursor ?? moveCursor(1)155 if (id) {156 done()157 toggleSelect(id)158 }159 }160 return161 case "u":162 if (s.open) {163 done()164 closeThread()165 document.getElementById("message-list")?.focus()166 }167 return168 case "Escape":169 if (s.navOpen) S.set({ navOpen: false })170 else if (s.selected.size) S.set({ selected: new Set() })171 else if (s.open) {172 closeThread()173 document.getElementById("message-list")?.focus()174 }175 return176 case "e":177 done()178 void doArchive()179 return180 case "#":181 case "Delete":182 done()183 void doDelete()184 return185 case "!":186 done()187 void doJunk(s.view !== "junk")188 return189 case "s":190 done()191 void doToggleFlag()192 return193 case "p":194 done()195 void doTogglePin()196 return197 case "b":198 done()199 snoozeTargets()200 return201 case "[":202 done()203 toggleSidebar()204 return205 case "I":206 done()207 void doMarkRead(true)208 return209 case "U":210 done()211 void doMarkRead(false)212 return213 case "r":214 case "a":215 case "f":216 if (s.open) {217 done()218 doReply(k === "r" ? "reply" : k === "a" ? "replyAll" : "forward")219 }220 return221 case "c":222 done()223 composeNew()224 return225 case "/":226 done()227 document.getElementById("search-input")?.focus()228 return229 case "?":230 done()231 S.set({ helpOpen: true })232 return233 }234}235236const STATUS_KEY: Record<DeliveredState, "send.status.queued" | "send.status.yes" | "send.status.no" | "send.status.unknown"> = { queued: "send.status.queued", yes: "send.status.yes", no: "send.status.no", unknown: "send.status.unknown" }237const STATUS_CLASS: Record<DeliveredState, string> = { queued: "warn", yes: "ok", no: "danger", unknown: "" }238239function DeliveryCard({ d }: { d: Delivery }) {240 return (241 <li className="delivery" data-testid="delivery">242 <div className="row">243 <Icon name="check" className="delivery-ok" />244 <strong className="spacer">{t("send.accepted")}</strong>245 <IconButton icon="close" label={t("common.dismiss")} onClick={() => dismissDelivery(d.key)} />246 </div>247 <p className="small muted truncate">{d.subject.trim() || t("list.noSubject")}</p>248 <p className="small muted">{t("send.acceptedHint")}</p>249 <ul className="delivery-rcpts">250 {d.recipients.map((r) => {251 const st = d.status ? Object.entries(d.status).find(([k]) => k.toLowerCase() === r.toLowerCase())?.[1] : undefined252 return (253 <li key={r} data-recipient={r} data-delivered={st?.delivered ?? "pending"}>254 <span className="truncate mono">{r}</span>255 {st ? <span className={`badge ${STATUS_CLASS[st.delivered]}`}>{t(STATUS_KEY[st.delivered])}</span> : <span className="badge">{d.polling ? t("send.status.checking") : t("send.status.unknown")}</span>}256 {st && st.delivered !== "yes" && st.smtpReply ? <span className="small muted delivery-reply">{st.smtpReply}</span> : null}257 </li>258 )259 })}260 </ul>261 </li>262 )263}264function Deliveries() {265 const deliveries = useStore(S, (s) => s.deliveries)266 return (267 <ul className="deliveries" aria-label={t("send.tracker")} aria-live="polite">268 {deliveries.map((d) => (269 <DeliveryCard key={d.key} d={d} />270 ))}271 </ul>272 )273}274275export function Shell() {276 const hasThread = useStore(S, (s) => !!s.open)277 const navOpen = useStore(S, (s) => s.navOpen)278 const helpOpen = useStore(S, (s) => s.helpOpen)279 const hasDraft = useStore(S, (s) => !!s.draft)280 const layout = useStore(S, (s) => s.device.layout)281 const Pane = useMainPane()282 useEffect(() => {283 document.addEventListener("keydown", onKey)284 return () => document.removeEventListener("keydown", onKey)285 }, [])286 return (287 <div className={`shell${hasThread && !Pane ? " has-thread" : ""}${navOpen ? " nav-open" : ""}${Pane ? " has-pane" : ""}`}>288 <a className="skip-link" href="#main">289 {t("nav.skip")}290 </a>291 <Sidebar />292 {navOpen ? <div className="scrim" onClick={() => S.set({ navOpen: false })} aria-hidden="true" /> : null}293 <Splitter pane="sidebar" controls="sidebar" />294 {Pane ? (295 // écran inscrit par un module (tableau de bord, contacts, galerie…) : il occupe la place de la liste et du lecteur296 <main className="shell-main shell-pane" id="main" tabIndex={-1}>297 <ErrorBoundary compact>298 <Suspense fallback={<div className="boot"><Spinner label={t("common.loading")} /></div>}>299 <Pane />300 </Suspense>301 </ErrorBoundary>302 </main>303 ) : (304 <div className="shell-main">305 <ErrorBoundary compact>306 <MessageList />307 </ErrorBoundary>308 {layout === "none" ? null : <Splitter pane={layout === "below" ? "listHeight" : "list"} controls="list-pane" />}309 <main className="reader-pane" id="main" tabIndex={-1} aria-label={t("reader.region")}>310 <ErrorBoundary compact>311 <Reader />312 </ErrorBoundary>313 </main>314 </div>315 )}316 <BottomNav />317 {hasDraft ? (318 <ErrorBoundary compact>319 <Composer />320 </ErrorBoundary>321 ) : null}322 <Deliveries />323 {helpOpen ? <HelpDialog /> : null}324 <ConfirmHost />325 </div>326 )327}328