SPB Git

Repository Public

labels.ts 7.3 KB 156 lines typescript

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
Files main
Menu

Theme