mirror of
https://github.com/MBombeck/HealthLog.git
synced 2026-11-15 23:12:04 +00:00
Six touch-disjoint waves landed on develop before this release: - W1-KNIP — exports/types tiers flipped to enforcing-mode on main; 35 unused exports + 52 unused types triaged to 0/0; shadcn surface + zod-infer contract types scoped via knip.json ignore-block. - W2-ZOD-MULTI-ISSUE — `returnAllZodIssues` shared helper + `/api/dashboard/widgets` 422 now returns every Zod issue + worker audit-ledger breadcrumb. 41 sibling routes documented for v1.4.43. - W3-QUERYKEY-LONGTAIL — 40 settings/medications/admin/hooks files migrated to the queryKeys factory; 9 new factory entries; ESLint rule + test-guard scope extended in lockstep. - W4-ARCH-HYGIENE — BERLIN_DAY_FORMATTER consolidated across nine sites (seven status helpers + bucket-series + bp-in-target); Suspense double-comment consolidated; doctor-report sanitiser regex rewritten to escape-form so diffs are reviewable; pr-detection- worker soft-delete filter; offhost-backup DR-intent comment. - W5-IOS-WORKOUTS — `dedupeWorkoutBatch` write-time cross-source dedup helper for the v1.5 iOS HealthKit observer ingest; dashboard tile-strip placeholder parity with the live TrendCard chrome. - W6-WITHINGS-OFF + ENV-CHECK — Withings off-response classifier (transient/reauth/persistent) + WithingsApiError typed throw + the `pnpm check-env` CLI. APNs `allOrNone: true` closes the AP-2 silent-disable gap the wave was conceived to close. No migration, no env-var change, no API contract break for iOS v0.5.4. The new `/api/dashboard/widgets` 422 envelope is additively extended. pnpm test --run green at 4815 passing / 1 skipped. pnpm typecheck, pnpm lint, pnpm knip (no --include flag) green.
246 lines
8.8 KiB
TypeScript
246 lines
8.8 KiB
TypeScript
"use client";
|
|
|
|
import { useMemo } from "react";
|
|
import { useQuery } from "@tanstack/react-query";
|
|
import { Loader2, ExternalLink } from "lucide-react";
|
|
|
|
import { useTranslations } from "@/lib/i18n/context";
|
|
import { queryKeys } from "@/lib/query-keys";
|
|
import { MedicationDetailSection } from "@/components/medications/medication-detail-section";
|
|
|
|
/**
|
|
* v1.4.25 W19f — GLP-1 titration-ladder section.
|
|
*
|
|
* Sits at the bottom of the medication detail page below the W19e
|
|
* SchedulingSection (v1.4.28 retired the IntakeHistoryList block).
|
|
* Same chrome as the W19d / W19e sections so the panels read as one
|
|
* visual group — chrome is now composed via the shared
|
|
* `<MedicationDetailSection>` wrapper.
|
|
*
|
|
* Layout:
|
|
* - Header: drug INN + "Standard ladder (EMA reference)"
|
|
* - Vertical step list (mobile) — same nodes laid horizontally
|
|
* from `sm` upwards. Each step shows dose, typical-weeks badge,
|
|
* and a status dot (current / past / upcoming).
|
|
* - Current-step ring with "You are here" caption.
|
|
* - Next-step caption + observational dwell hint when the EMA
|
|
* dwell-time has elapsed. Copy is strictly observational; the
|
|
* ladder is a *reference*, never a prescription (MDR boundary).
|
|
* - Disclaimer + EMA-source link.
|
|
*
|
|
* v1.4.25 W21 Fix-N — dropped the hand-rolled `templateFill` helper;
|
|
* the i18n `t()` function already accepts the `params` bag with
|
|
* `{key}` placeholder substitution. One source of truth for the
|
|
* template-fill semantics.
|
|
*
|
|
* Data comes from `/api/medications/[id]/titration`; that route owns
|
|
* the prisma queries and delegates math to the pure ladder helpers.
|
|
*/
|
|
|
|
interface TitrationStep {
|
|
stepIndex: number;
|
|
doseMg: number;
|
|
typicalWeeks: number;
|
|
}
|
|
|
|
interface TitrationResponse {
|
|
drugId: string;
|
|
drugInn: string;
|
|
ladder: TitrationStep[];
|
|
currentStep: TitrationStep | null;
|
|
currentStepIndex: number | null;
|
|
weeksOnCurrentStep: number;
|
|
nextStep: TitrationStep | null;
|
|
escalationDue: boolean;
|
|
sourceEMA: string;
|
|
}
|
|
|
|
interface TitrationSectionProps {
|
|
medicationId: string;
|
|
}
|
|
|
|
export function TitrationSection({ medicationId }: TitrationSectionProps) {
|
|
const { t } = useTranslations();
|
|
|
|
const { data, isLoading, error } = useQuery({
|
|
queryKey: queryKeys.medicationTitration(medicationId),
|
|
queryFn: async (): Promise<TitrationResponse> => {
|
|
const res = await fetch(`/api/medications/${medicationId}/titration`);
|
|
if (!res.ok) {
|
|
throw new Error(`Failed to load titration: ${res.status}`);
|
|
}
|
|
const json = await res.json();
|
|
return json.data as TitrationResponse;
|
|
},
|
|
});
|
|
|
|
const hasLadder = !!data && data.ladder.length > 0;
|
|
const currentIdx = data?.currentStepIndex ?? null;
|
|
|
|
// Compose the optional dwell hint AND the next-step caption. The
|
|
// dwell hint is strictly observational — no "you should step up";
|
|
// the boolean only gates *display*, never *action*.
|
|
const dwellHint = useMemo(() => {
|
|
if (!data || data.currentStep === null) return null;
|
|
if (data.weeksOnCurrentStep <= 0) return null;
|
|
if (data.escalationDue) {
|
|
return t("medications.titration.escalationDueHint", {
|
|
weeks: data.weeksOnCurrentStep,
|
|
typical: data.currentStep.typicalWeeks,
|
|
});
|
|
}
|
|
return t("medications.titration.currentStepDwell", {
|
|
weeks: data.weeksOnCurrentStep,
|
|
});
|
|
}, [data, t]);
|
|
|
|
const nextStepCaption = useMemo(() => {
|
|
if (!data) return null;
|
|
if (!data.nextStep) return null;
|
|
return t("medications.titration.nextStepCaption", {
|
|
dose: data.nextStep.doseMg,
|
|
weeks: data.currentStep?.typicalWeeks ?? data.nextStep.typicalWeeks,
|
|
});
|
|
}, [data, t]);
|
|
|
|
const headerExtras = data ? (
|
|
<span
|
|
className="text-muted-foreground text-xs uppercase tracking-wide"
|
|
data-slot="titration-drug-inn"
|
|
>
|
|
{data.drugInn}
|
|
</span>
|
|
) : null;
|
|
|
|
return (
|
|
<MedicationDetailSection
|
|
titleId="titration-heading"
|
|
title={t("medications.titration.section")}
|
|
headerExtras={headerExtras}
|
|
dataSlot="titration-section"
|
|
>
|
|
{isLoading && (
|
|
<div className="text-muted-foreground flex items-center gap-2">
|
|
<Loader2 className="h-3.5 w-3.5 animate-spin motion-reduce:animate-none" />
|
|
<span>{t("medications.titration.loading")}</span>
|
|
</div>
|
|
)}
|
|
|
|
{!!error && !isLoading && (
|
|
<p className="text-destructive">
|
|
{t("medications.titration.loadFailed")}
|
|
</p>
|
|
)}
|
|
|
|
{data && !isLoading && (
|
|
<div className="space-y-3">
|
|
<p className="text-muted-foreground text-xs uppercase tracking-wide">
|
|
{t("medications.titration.drugLadderHeader")}
|
|
</p>
|
|
|
|
{hasLadder ? (
|
|
<ol
|
|
// v1.4.27 MB7 / CF-48 — keep the vertical (`flex-col`)
|
|
// layout until `md:` instead of breaking to horizontal
|
|
// at `sm:`. On Pixel 5 (375 px) the horizontal ladder
|
|
// had 4-5 visible steps but each step's "Standard 0.5
|
|
// mg" + "typical 4 weeks" label combo wrapped to 3
|
|
// lines per step, which read as a denser block than
|
|
// the vertical layout below. From `md:` upwards the
|
|
// wider container can absorb the horizontal stride.
|
|
className="flex flex-col gap-2 md:flex-row md:flex-wrap md:items-stretch"
|
|
aria-label={t("medications.titration.drugLadderHeader")}
|
|
>
|
|
{data.ladder.map((step) => {
|
|
const isCurrent = currentIdx === step.stepIndex;
|
|
const isPast =
|
|
currentIdx !== null && step.stepIndex < currentIdx;
|
|
return (
|
|
<li
|
|
key={step.stepIndex}
|
|
className={[
|
|
"border-border/70 flex flex-1 flex-col rounded-md border px-2.5 py-2 md:min-w-[7rem]",
|
|
isCurrent
|
|
? "border-primary ring-primary/40 ring-2"
|
|
: "",
|
|
].join(" ")}
|
|
aria-current={isCurrent ? "step" : undefined}
|
|
data-slot="titration-step"
|
|
data-step-index={step.stepIndex}
|
|
data-step-state={
|
|
isCurrent ? "current" : isPast ? "past" : "upcoming"
|
|
}
|
|
>
|
|
<span className="text-muted-foreground text-xs uppercase tracking-wide">
|
|
{t("medications.titration.stepLabel", {
|
|
n: step.stepIndex + 1,
|
|
})}
|
|
</span>
|
|
<span className="text-foreground text-sm font-medium">
|
|
{step.doseMg} {t("medications.titration.doseUnitMg")}
|
|
</span>
|
|
<span className="text-muted-foreground text-xs">
|
|
{t("medications.titration.typicalWeeksOnStep", {
|
|
weeks: step.typicalWeeks,
|
|
})}
|
|
</span>
|
|
{isCurrent && (
|
|
<span className="text-primary mt-1 text-xs font-medium uppercase tracking-wide">
|
|
{t("medications.titration.youAreHere")}
|
|
</span>
|
|
)}
|
|
</li>
|
|
);
|
|
})}
|
|
</ol>
|
|
) : (
|
|
<p className="text-muted-foreground">
|
|
{t("medications.titration.emptyState")}
|
|
</p>
|
|
)}
|
|
|
|
{data.currentStep === null && hasLadder && (
|
|
<p className="text-muted-foreground">
|
|
{t("medications.titration.nonStandardDose")}
|
|
</p>
|
|
)}
|
|
|
|
{dwellHint && (
|
|
<p
|
|
className="text-muted-foreground"
|
|
data-slot="titration-dwell-hint"
|
|
>
|
|
{dwellHint}
|
|
</p>
|
|
)}
|
|
|
|
{nextStepCaption && (
|
|
<p className="text-muted-foreground">{nextStepCaption}</p>
|
|
)}
|
|
|
|
{data.nextStep === null && data.currentStep !== null && (
|
|
<p className="text-muted-foreground">
|
|
{t("medications.titration.ceilingMessage")}
|
|
</p>
|
|
)}
|
|
|
|
<div className="border-border/60 border-t pt-2">
|
|
<p className="text-muted-foreground text-xs">
|
|
{t("medications.titration.disclaimer")}
|
|
</p>
|
|
<a
|
|
href={data.sourceEMA}
|
|
target="_blank"
|
|
rel="noopener noreferrer"
|
|
className="text-foreground/80 hover:text-foreground mt-1 inline-flex items-center gap-1 text-xs underline-offset-2 hover:underline"
|
|
>
|
|
{t("medications.titration.emaSourceCta")}
|
|
<ExternalLink className="h-2.5 w-2.5" aria-hidden="true" />
|
|
</a>
|
|
</div>
|
|
</div>
|
|
)}
|
|
</MedicationDetailSection>
|
|
);
|
|
}
|