Files
HealthLog/src/components/day/use-day-value-format.ts
T
Marc-André Bombeck f8557f57a0 feat(timeline): colour each value line and name the selection's bucket
Each value line takes the colour its type carries in the measurement
list (a --chart-N token); where two chosen lines would share one, or a
type has none, the later line in the menu's order takes the first free
data token, and a sixth line with none left falls back to the
foreground. The swatch beside the name, the line, the dashed bridge,
filled and hollow points and a ring on the selected bucket all inherit
one colour from their group. The menu, the selection bar and the phone
chronicle mark each value with the same dot. The colour map moves to an
icon-free module so the timeline does not pull the list's icons.

The selection bar is a cross-section of one bucket and now says which:
its head names the quarter, month or week in full, its entries are the
ones that touch that bucket, and each mean keeps its readings count.
Values go through the day view's formatter, so sleep reads as a
duration and the unit preference applies; the server sends canonical
units, which the old formatter took for display units. Before anyone
picks a day the bar opens on the newest bucket it has something for in
the requested window (documents, which it never lists, no longer count),
and a short line says how to pick another.
2026-10-09 09:48:53 +02:00

139 lines
4.7 KiB
TypeScript
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
"use client";
import { useCallback } from "react";
import { useUnitDisplay } from "@/hooks/use-unit-display";
import type { DayValue } from "@/lib/day/contract";
import { useFormatters, useTranslations } from "@/lib/i18n/context";
import { formatDurationMinutes } from "@/lib/i18n/duration";
import { MEASUREMENT_TYPE_LABEL_KEYS } from "@/lib/measurements/type-label-keys";
import { getUnitForType } from "@/lib/measurements/unit-map";
import type { DayValueTile } from "./day-values-model";
/** Count metrics are whole numbers by definition. */
const WHOLE_NUMBER_TYPES: ReadonlySet<string> = new Set([
"ACTIVITY_STEPS",
"FLIGHTS_CLIMBED",
"ACTIVE_ENERGY_BURNED",
"TIME_IN_DAYLIGHT",
"BLOOD_PRESSURE_SYS",
"BLOOD_PRESSURE_DIA",
"PULSE",
"RESTING_HEART_RATE",
"HEART_RATE_VARIABILITY",
"HRV_RMSSD",
"OXYGEN_SATURATION",
"RESPIRATORY_RATE",
]);
/**
* Two spellings of one unit: the day route sends a duration in "min", the
* client's unit map knows it as "minutes". Read as the same unit, so a night
* reads as "6 h 52 min" and not as a bare 412.
*/
const UNIT_ALIASES: Readonly<Record<string, string>> = { min: "minutes" };
/** True when the row carries the type's canonical unit, in either spelling. */
function isCanonicalUnit(row: Pick<DayValue, "type" | "unit">): boolean {
const canonical = getUnitForType(row.type);
return row.unit === canonical || UNIT_ALIASES[row.unit] === canonical;
}
/** True for a type read in whole numbers (counts, pressures, pulses). */
export function isWholeNumberType(type: string): boolean {
return WHOLE_NUMBER_TYPES.has(type);
}
export interface FormattedDayValue {
label: string;
/** The number (or duration) as it is read. */
value: string;
/** The unit beside it, or "" when the value carries its own. */
unit: string;
/** The usual range in the same spelling, or null without a band. */
usual: string | null;
/** The usual range per row, for the spoken form. */
usualParts: Array<{ lo: string; hi: string }> | null;
}
/**
* Formats a day's values the way every other surface in the app shows them:
* the person's unit preference, the locale's decimal separator, sleep as a
* duration. The server sends canonical units; a row whose unit is not the
* canonical one is shown as sent.
*/
export function useDayValueFormat() {
const { t } = useTranslations();
const fmt = useFormatters();
const units = useUnitDisplay();
const labelFor = useCallback(
(tileKey: string): string => {
if (tileKey === "BLOOD_PRESSURE") return t("charts.bloodPressure");
const key = (MEASUREMENT_TYPE_LABEL_KEYS as Record<string, string>)[
tileKey
];
return key ? t(key) : tileKey;
},
[t],
);
const number = useCallback(
(row: Pick<DayValue, "type" | "unit">, raw: number): string => {
const canonical = isCanonicalUnit(row);
const shown = canonical ? units.toDisplay(row.type, raw) : raw;
if (row.type === "SLEEP_DURATION" && canonical) {
return formatDurationMinutes(shown, t);
}
if (WHOLE_NUMBER_TYPES.has(row.type)) {
return fmt.number(Math.round(shown), 0);
}
const decimals =
canonical && units.isTransformed(row.type)
? units.decimalsFor(row.type)
: 1;
const scale = 10 ** decimals;
return fmt.number(Math.round(shown * scale) / scale);
},
[fmt, t, units],
);
const unitFor = useCallback(
(row: Pick<DayValue, "type" | "unit">): string => {
if (row.type === "SLEEP_DURATION") return "";
const unit = isCanonicalUnit(row) ? units.unitFor(row.type) : row.unit;
// A device score reads in points, as on its chart.
return unit === "score" ? t("insights.deviceScore.unitScore") : unit;
},
[t, units],
);
const formatTile = useCallback(
(tile: DayValueTile): FormattedDayValue => {
const label = labelFor(tile.key);
const first = tile.values[0];
if (!first)
return { label, value: "", unit: "", usual: null, usualParts: null };
const join = (part: (row: DayValue) => string | null) => {
const parts = tile.values.map(part);
return parts.every((p) => p !== null) ? parts.join("/") : null;
};
const value = join((row) => number(row, row.value)) ?? "";
const usualParts = tile.values.every((row) => row.band !== null)
? tile.values.map((row) => ({
lo: number(row, row.band!.lo),
hi: number(row, row.band!.hi),
}))
: null;
const usual = usualParts
? usualParts.map((part) => `${part.lo}–${part.hi}`).join("/")
: null;
return { label, value, unit: unitFor(first), usual, usualParts };
},
[labelFor, number, unitFor],
);
return { labelFor, formatTile, number, unitFor };
}