Repository Public
1// SP Mail Next — libellés : forme du serveur, correspondance mot-clé JMAP ⇄ libellé, palette de dix teintes, ordre, collection2// synchronisée et écritures (/api/next/labels). L'état des messages reste dans JMAP (mots-clés `lbl_…`).3import { NextError, nx, toNextError } from "./api"4import { createCollection } from "./collection"56/** `GET /api/next/labels` (server/src/next/organize.ts) ; `keyword` est attribué par le serveur et ne change jamais. */7export interface Label {8 id: string9 name: string10 color: string11 keyword: string12 position: number13}1415// ---------------------------------------------------------------- fonctions pures16/** Les dix teintes de DESIGN-SYSTEM-NEXT §2 (valeurs du thème clair, celles que le serveur enregistre). */17export const LABEL_PALETTE = ["#b3261e", "#a14a00", "#7a5c00", "#2e6b2e", "#00695c", "#1d5fa8", "#4a4fb5", "#7a3fa0", "#a8327a", "#5c5f66"] as const18export const LABEL_PREFIX = "lbl_"19export const LABEL_NAME_MAX = 4020export const isLabelKeyword = (keyword: string): boolean => keyword.startsWith(LABEL_PREFIX)2122const rgb = (hex: string): [number, number, number] | null => {23 const m = /^#?([0-9a-f]{6})$/i.exec(hex.trim())24 if (!m) return null25 const n = Number.parseInt(m[1], 16)26 return [(n >> 16) & 255, (n >> 8) & 255, n & 255]27}28/**29 * Rang (1 à 10) de la teinte de la palette correspondant à une couleur : la teinte exacte, sinon la plus proche (un autre30 * client a pu enregistrer une couleur libre) ; 10 (gris) si la valeur est illisible.31 */32export function paletteIndex(color: string): number {33 const exact = LABEL_PALETTE.indexOf(color.trim().toLowerCase() as (typeof LABEL_PALETTE)[number])34 if (exact >= 0) return exact + 135 const c = rgb(color)36 if (!c) return LABEL_PALETTE.length37 let best = 038 let bestD = Number.POSITIVE_INFINITY39 LABEL_PALETTE.forEach((hex, i) => {40 const p = rgb(hex)!41 const d = (p[0] - c[0]) ** 2 + (p[1] - c[1]) ** 2 + (p[2] - c[2]) ** 242 if (d < bestD) {43 bestD = d44 best = i45 }46 })47 return best + 148}49/** Couleur CSS d'un libellé : toujours un jeton `--label-N` (contraste garanti dans les trois thèmes). */50export const labelColor = (color: string): string => `var(--label-${paletteIndex(color)})`5152export const sortLabels = (labels: readonly Label[]): Label[] => [...labels].sort((a, b) => a.position - b.position || a.name.localeCompare(b.name))5354/**55 * Libellés portés par un message, dans l'ordre de la liste des libellés. Les mots-clés `lbl_` inconnus (libellé supprimé,56 * collection pas encore lue) et tout autre mot-clé sont ignorés.57 */58export function labelsOfKeywords(keywords: Record<string, boolean> | readonly string[], labels: readonly Label[]): Label[] {59 const has = Array.isArray(keywords) ? (k: string) => (keywords as readonly string[]).includes(k) : (k: string) => !!(keywords as Record<string, boolean>)[k]60 return labels.filter((l) => isLabelKeyword(l.keyword) && has(l.keyword))61}62/** Mots-clés (liste de /api/v1) → dictionnaire JMAP. */63export const keywordSet = (keywords: readonly string[]): Record<string, boolean> => Object.fromEntries(keywords.map((k) => [k, true]))6465export type Tri = "all" | "some" | "none"66/** État d'un libellé sur un ensemble de messages (case cochée, partielle ou vide du sélecteur). */67export function labelState(keyword: string, messages: readonly Record<string, boolean>[]): Tri {68 const n = messages.filter((k) => k[keyword]).length69 return n === 0 ? "none" : n === messages.length ? "all" : "some"70}7172/** Déplace un libellé d'un cran (`delta` −1 = monter, +1 = descendre) et renumérote ; rend la même liste si rien ne bouge. */73export function reorder(labels: readonly Label[], id: string, delta: number): Label[] {74 const list = sortLabels(labels)75 const from = list.findIndex((l) => l.id === id)76 const to = Math.max(0, Math.min(list.length - 1, from + delta))77 if (from < 0 || to === from) return list78 const [moved] = list.splice(from, 1)79 list.splice(to, 0, moved)80 return list.map((l, position) => (l.position === position ? l : { ...l, position }))81}8283/** Comparaison insensible à la casse et aux accents (comme le serveur pour `label:`). */84export const fold = (s: string): string => s.normalize("NFD").replace(/[̀-ͯ]/g, "").toLowerCase().trim()85export function filterLabels(labels: readonly Label[], query: string): Label[] {86 const q = fold(query)87 return q ? labels.filter((l) => fold(l.name).includes(q)) : [...labels]88}89/** Nom accepté par le serveur : 1 à 40 caractères, sans caractère de contrôle. Rend le nom nettoyé, ou null. */90export function cleanName(raw: string): string | null {91 const name = raw.trim()92 if (!name || name.length > LABEL_NAME_MAX || /[\u0000-\u001f\u007f]/.test(name)) return null93 return name94}9596// ---------------------------------------------------------------- collection et écritures97export const labelsCollection = createCollection<Label>("labels", async () => sortLabels(await nx.list<Label>("labels")))98export const allLabels = (): Label[] => labelsCollection.store.get().items99100/** Échec d'une écriture : `name_taken`, `limit_reached`, `offline` ou `error`. */101export type LabelWriteError = "name_taken" | "limit_reached" | "offline" | "error"102export type LabelWrite = { ok: true; label: Label } | { ok: false; error: LabelWriteError }103const failure = (e: unknown): { ok: false; error: LabelWriteError } => {104 const err: NextError = toNextError(e)105 return { ok: false, error: err.code === "name_taken" ? "name_taken" : err.code === "limit_reached" ? "limit_reached" : err.kind === "offline" ? "offline" : "error" }106}107108export async function createLabel(name: string, color?: string): Promise<LabelWrite> {109 try {110 const label = await nx.post<Label>("labels", color ? { name, color } : { name })111 labelsCollection.mutate((items) => sortLabels([...items.filter((l) => l.id !== label.id), label]))112 return { ok: true, label }113 } catch (e) {114 return failure(e)115 }116}117export async function updateLabel(id: string, patch: { name?: string; color?: string }): Promise<LabelWrite> {118 try {119 const label = await nx.patch<Label>(`labels/${id}`, patch)120 labelsCollection.mutate((items) => sortLabels(items.map((l) => (l.id === id ? label : l))))121 return { ok: true, label }122 } catch (e) {123 return failure(e)124 }125}126/** Supprimer un libellé ne touche aucun message : son mot-clé devient inconnu, donc ignoré. */127export async function deleteLabel(id: string): Promise<boolean> {128 const before = allLabels()129 labelsCollection.mutate((items) => items.filter((l) => l.id !== id))130 try {131 await nx.del(`labels/${id}`)132 return true133 } catch (e) {134 if (toNextError(e).kind === "not_found") return true135 labelsCollection.mutate(() => before)136 void labelsCollection.refresh()137 return false138 }139}140/** Monte ou descend un libellé : l'ordre change tout de suite, le serveur renumérote ; en cas d'échec la liste est relue. */141export async function moveLabel(id: string, delta: number): Promise<boolean> {142 const before = allLabels()143 const after = reorder(before, id, delta)144 const position = after.findIndex((l) => l.id === id)145 if (position < 0 || position === sortLabels(before).findIndex((l) => l.id === id)) return true146 labelsCollection.mutate(() => after)147 try {148 await nx.patch<Label>(`labels/${id}`, { position })149 return true150 } catch {151 labelsCollection.mutate(() => before)152 void labelsCollection.refresh()153 return false154 }155}156