feat(widgets): chart WAN throughput instead of static figures

L'API UniFi ne fournit que l'instantané et Homarr ne stocke aucun
historique : la série est accumulée côté client, comme le fait déjà le
widget systemResources. Elle repart donc vide à chaque rechargement.

Deux décisions d'honnêteté, dans la ligne du reste du widget :
- une lecture en échec est ignorée, jamais enregistrée comme un zéro,
  qui dessinerait une chute à la ligne de base n'ayant pas eu lieu ;
- sous deux points, on affiche les chiffres seuls : une ligne plate
  tracée sur un point unique se lit comme un réseau au repos alors
  qu'on n'a rien mesuré.

Couleurs validées par le validateur de palette (bande de luminosité,
chroma, séparation daltonisme et vision normale, contraste) en thème
clair ET sombre. La paire orange.5/yellow.5 du widget systemResources
n'a délibérément pas été reprise : son ΔE en vision normale est de
12,1, sous le plancher de lisibilité de 15.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This commit is contained in:
zacharyandClaude Opus 5 committed 2026-09-09 21:24:51 +02:00
1 parent f1e4f43fbf
commit 2bd080293a
5 files changed
+297 -9

No files matched your search

@@ -0,0 +1,119 @@
"use client";
import { AreaChart } from "@mantine/charts";
import { Group, Paper, Stack, Text } from "@mantine/core";
import type { ThroughputPoint } from "./throughput-history";
/**
* Series colours.
*
* Not copied from the `systemResources` network chart, which pairs `orange.5`
* with `yellow.5`: that pair scores a normal-vision ΔE of 12.1, below the
* legibility floor of 15, so even readers with full colour vision struggle to
* tell the two lines apart. This pair was validated instead, and passes every
* check — lightness band, chroma, colour-vision-deficiency separation,
* normal-vision separation and surface contrast — against BOTH the light and
* the dark chart surface, so one pair serves both themes.
*/
const DOWN_COLOR = "blue.7";
const UP_COLOR = "orange.8";
const CHART_HEIGHT = 44;
/**
* A dot carries the series identity so the figure beside it can stay in muted
* ink: colour is never the only thing distinguishing up from down — the arrow
* glyph and the label do it too.
*/
const SeriesKey = ({ color, label }: { color: string; label: string }) => (
<Group gap={4} wrap="nowrap">
<Text c={color} size="xs" lh={1} aria-hidden>
●
</Text>
<Text c="dimmed" size="xs" ff="monospace" lh={1}>
{label}
</Text>
</Group>
);
/**
* Defined at module level rather than inline in the `content` prop: recharts
* clones this element and injects `payload`, so it keeps a stable identity
* across renders. The repo's other chart tooltips pass a closure instead and
* each carries a `no-unstable-nested-components` warning for it.
*/
const ThroughputTooltip = ({
payload,
formatRate,
upName,
downName,
}: {
payload?: { name?: string | number; value?: string | number }[];
formatRate: (bitsPerSecond: number) => string;
upName: string;
downName: string;
}) => {
if (!payload || payload.length === 0) return null;
return (
<Paper px="xs" py={4} shadow="md" withBorder>
<Stack gap={2}>
{payload.map((item) => (
<Text key={String(item.name)} size="xs" c="dimmed" ff="monospace">
{item.name === "up" ? `↑ ${upName}` : `↓ ${downName}`} {formatRate(Number(item.value))}
</Text>
))}
</Stack>
</Paper>
);
};
export interface ThroughputChartProps {
history: ThroughputPoint[];
/** Rendered beside the up marker, already formatted. */
upLabel: string;
/** Rendered beside the down marker, already formatted. */
downLabel: string;
/** Formats a raw bits-per-second value for the tooltip. */
formatRate: (bitsPerSecond: number) => string;
upName: string;
downName: string;
}
export const ThroughputChart = ({
history,
upLabel,
downLabel,
formatRate,
upName,
downName,
}: ThroughputChartProps) => (
<Stack gap={2}>
<Group gap="sm" wrap="nowrap" justify="flex-end">
<SeriesKey color={UP_COLOR} label={`↑ ${upLabel}`} />
<SeriesKey color={DOWN_COLOR} label={`↓ ${downLabel}`} />
</Group>
<AreaChart
h={CHART_HEIGHT}
data={history}
dataKey="index"
series={[
{ name: "down", label: downName, color: DOWN_COLOR },
{ name: "up", label: upName, color: UP_COLOR },
]}
curveType="monotone"
strokeWidth={2}
withDots={false}
withXAxis={false}
withYAxis={false}
gridAxis="none"
withLegend={false}
tooltipAnimationDuration={150}
tooltipProps={{
content: <ThroughputTooltip formatRate={formatRate} upName={upName} downName={downName} />,
}}
/>
</Stack>
);