feat(day): collapse the docked day to an edge instead of closing it

From 1280 px the day sits beside the page, and its control at the top
left took it away entirely: after a page change there was no way back to
the day short of finding it again. The control now hides the day the way
a sidebar collapses. A narrow edge stays on the right, holding the date,
with a button that opens the last day again on this page or any other.
Focus lands on that button when the day collapses and on the day's
heading when it comes back.

The last open day is remembered per browser, bound to the account and
the record it was read in, and removed at every session end. The Coach
button keeps clear of the edge as it does of the open day. Sheets below
1280 px and on phones close as before, and Back still closes them.
This commit is contained in:
Marc-André Bombeck committed 2026-10-09 08:54:11 +02:00
1 parent 09f94d3eac
commit c3dff2c388
17 files changed
+457 -20

No files matched your search

+11 -1
View File
@@ -266,7 +266,7 @@ test.describe("the dashboard and the list of all values", () => {
);
});
test("the docked day moves the Coach button off its footer", async ({
test("the docked day, open or collapsed, moves the Coach button off it", async ({
page,
}, testInfo) => {
test.skip(isPhone(testInfo), "docked from 1280 px");
@@ -290,6 +290,16 @@ test.describe("the dashboard and the list of all values", () => {
return b.x + b.width;
})
.toBeLessThanOrEqual(panelBox.x);
// Collapsed, the day keeps a narrow edge; the launcher stays clear of it.
await page.locator('[data-slot="day-close"]').click();
const edge = (await page.locator('[data-slot="day-rail"]').boundingBox())!;
await expect
.poll(async () => {
const b = (await fab.boundingBox())!;
return b.x + b.width;
})
.toBeLessThanOrEqual(edge.x);
});
});
+66 -1
View File
@@ -21,11 +21,14 @@ import { MOBILE_ROUTES_ANALYTE } from "./setup/mobile-routes-fixture";
* - `?day=` opens the layer on any page, Back and Escape close it, a date in
* the future is dropped;
* - stepping to the neighbouring days never adds history entries;
* - docked, the day collapses to a narrow edge that brings it back on any
* page; a sheet closes for good;
* - the dashboard's today area offers no door; its charts below do.
*
* Stable data attributes only: `day-panel` (+ `data-shell`), `day-link`,
* `chart-plot[data-day-links]`, `chart-tooltip-open-day`, `day-prev` /
* `day-next` / `day-close`.
* `day-next` / `day-close`, and the collapsed edge `day-rail` (+ `data-day`)
* with its `day-expand`.
*/
const panel = (page: Page) => page.locator('[data-slot="day-panel"]');
@@ -117,6 +120,68 @@ test.describe("the day view", () => {
await expect(page).toHaveURL(/\/mood$/);
});
test("the docked day collapses to an edge and comes back on another page", async ({
page,
}, testInfo) => {
test.skip(
testInfo.project.name !== "chromium-desktop",
"docked from 1280 px",
);
const day = isoDaysAgo(3);
await page.goto(`/mood?day=${day}`);
await expect(panel(page)).toHaveAttribute("data-shell", "docked");
await page.locator('[data-slot="day-close"]').click();
await expect(panel(page)).toHaveCount(0);
await expect(page).toHaveURL(/\/mood$/);
// A narrow edge stays, holding the day, and focus waits on its button.
const rail = page.locator('[data-slot="day-rail"]');
const expand = page.locator('[data-slot="day-expand"]');
await expect(rail).toHaveAttribute("data-day", day);
await expect(expand).toBeFocused();
await expect(expand).toHaveAttribute("aria-expanded", "false");
expect(await expand.getAttribute("aria-label")).toMatch(/^Show /);
expect((await rail.boundingBox())!.width).toBeLessThanOrEqual(48);
// Another page: the edge is still there and brings the same day back,
// from the keyboard too.
await page.goto("/labs");
await expect(rail).toHaveAttribute("data-day", day);
await expand.focus();
await page.keyboard.press("Enter");
await expect(panel(page)).toHaveAttribute("data-shell", "docked");
await expect(page.locator('[data-slot="day-view"]')).toHaveAttribute(
"data-day",
day,
);
await expect(page).toHaveURL(new RegExp(`/labs\\?day=${day}$`));
await expect(panel(page).locator("h2").first()).toBeFocused();
await expect(rail).toHaveCount(0);
});
test("a sheet closes for good and leaves no edge behind", async ({
page,
}, testInfo) => {
const desktop = testInfo.project.name === "chromium-desktop";
// Below 1280 px the day is a sheet from the right; on a phone, from the
// bottom. Neither collapses.
if (desktop) await page.setViewportSize({ width: 1024, height: 800 });
const day = isoDaysAgo(3);
await page.goto(`/mood?day=${day}`);
await expect(panel(page)).toHaveAttribute(
"data-shell",
desktop ? "sheet" : "bottom",
);
await expect(page.locator('[data-slot="day-close"]')).toHaveAttribute(
"aria-label",
"Close day",
);
await page.locator('[data-slot="day-close"]').click();
await expect(panel(page)).toHaveCount(0);
await expect(page).toHaveURL(/\/mood$/);
await expect(page.locator('[data-slot="day-rail"]')).toHaveCount(0);
});
test("a future or malformed ?day= is dropped without a word", async ({
page,
}) => {
+2
View File
@@ -12207,6 +12207,8 @@
"previousDay": "Vortag",
"nextDay": "Folgetag",
"close": "Tag schließen",
"hidePanel": "Tag ausblenden",
"showPanel": "{date} einblenden",
"openDay": "Tag öffnen",
"viewWholeDay": "Ganzen Tag ansehen",
"captureForDay": "Für diesen Tag erfassen",
+2
View File
@@ -12207,6 +12207,8 @@
"previousDay": "Previous day",
"nextDay": "Next day",
"close": "Close day",
"hidePanel": "Hide day",
"showPanel": "Show {date}",
"openDay": "Open day",
"viewWholeDay": "View the whole day",
"captureForDay": "Add for this day",
+2
View File
@@ -12207,6 +12207,8 @@
"previousDay": "Día anterior",
"nextDay": "Día siguiente",
"close": "Cerrar día",
"hidePanel": "Ocultar día",
"showPanel": "Mostrar {date}",
"openDay": "Abrir día",
"viewWholeDay": "Ver el día completo",
"captureForDay": "Registrar para este día",
+2
View File
@@ -12207,6 +12207,8 @@
"previousDay": "Jour précédent",
"nextDay": "Jour suivant",
"close": "Fermer le jour",
"hidePanel": "Masquer le jour",
"showPanel": "Afficher {date}",
"openDay": "Ouvrir le jour",
"viewWholeDay": "Voir toute la journée",
"captureForDay": "Saisir pour ce jour",
+2
View File
@@ -12207,6 +12207,8 @@
"previousDay": "Giorno precedente",
"nextDay": "Giorno successivo",
"close": "Chiudi giorno",
"hidePanel": "Nascondi giorno",
"showPanel": "Mostra {date}",
"openDay": "Apri giorno",
"viewWholeDay": "Vedi l’intera giornata",
"captureForDay": "Registra per questo giorno",
+2
View File
@@ -12207,6 +12207,8 @@
"previousDay": "전날",
"nextDay": "다음 날",
"close": "하루 닫기",
"hidePanel": "하루 숨기기",
"showPanel": "{date} 보기",
"openDay": "하루 열기",
"viewWholeDay": "하루 전체 보기",
"captureForDay": "이 날에 기록하기",
+2
View File
@@ -12207,6 +12207,8 @@
"previousDay": "Poprzedni dzień",
"nextDay": "Następny dzień",
"close": "Zamknij dzień",
"hidePanel": "Ukryj dzień",
"showPanel": "Pokaż {date}",
"openDay": "Otwórz dzień",
"viewWholeDay": "Zobacz cały dzień",
"captureForDay": "Dodaj dla tego dnia",
+15 -1
View File
@@ -146,6 +146,7 @@ async function render(
date: string;
today: string;
focus: unknown;
shell: "docked" | "sheet" | "bottom";
}> = {},
) {
const { I18nProvider } = await import("@/lib/i18n/context");
@@ -156,7 +157,7 @@ async function render(
date={props.date ?? "2026-01-03"}
today={props.today ?? "2026-10-08"}
focus={(props.focus as never) ?? null}
shell="docked"
shell={props.shell ?? "docked"}
onClose={() => undefined}
onStep={() => undefined}
Title={(p) => <h2 {...p} />}
@@ -232,6 +233,19 @@ describe("<DayView>", () => {
expect(leave).not.toContain("FAMILY");
});
it("collapses the docked day and closes a sheet, and says which", async () => {
const docked = await render();
const hide = docked.match(/<button[^>]*data-slot="day-close"[^>]*>/)?.[0];
expect(hide).toContain('aria-label="Hide day"');
expect(hide).toContain('aria-expanded="true"');
for (const shell of ["sheet", "bottom"] as const) {
const sheet = await render({ shell });
const close = sheet.match(/<button[^>]*data-slot="day-close"[^>]*>/)?.[0];
expect(close).toContain('aria-label="Close day"');
expect(close).not.toContain("aria-expanded");
}
});
it("folds the blood pressure into one tile on its number line", async () => {
const html = await render();
expect(html).toContain('data-type="BLOOD_PRESSURE"');
+132 -8
View File
@@ -12,21 +12,32 @@ import {
useSyncExternalStore,
} from "react";
import { PanelRightOpen } from "lucide-react";
import { ShellSidePanel } from "@/components/layout/shell-side-panel";
import { SHELL_HEADER_BAND } from "@/components/layout/shell-metrics";
import { Button } from "@/components/ui/button";
import {
Sheet,
SheetContent,
SheetDescription,
SheetTitle,
} from "@/components/ui/sheet";
import { useAuth } from "@/hooks/use-auth";
import { useIsMobile } from "@/hooks/use-is-mobile";
import { DAY_QUERY_PARAM, type DateKey } from "@/lib/day/contract";
import {
readLastDay,
subscribeLastDay,
writeLastDay,
} from "@/lib/day/last-day";
import { getRecordScope } from "@/lib/query-keys/record-scope";
import { useTranslations } from "@/lib/i18n/context";
import { cn } from "@/lib/utils";
import {
closeDay,
openDay,
peekDayTriggerAt,
publishOpenDay,
stepDay,
@@ -34,7 +45,12 @@ import {
useDayFocus,
} from "./day-layer-controller";
import { parseDayParam, shiftDateKey, withDayHref } from "./day-url";
import { DayView, useLongDayLabel } from "./day-view";
import {
DayView,
PANEL_TOGGLE,
PANEL_TOGGLE_ICON,
useLongDayLabel,
} from "./day-view";
import { usePrefetchDay } from "./use-day";
import { useTodayKey } from "./use-today-key";
@@ -47,7 +63,10 @@ import { useTodayKey } from "./use-today-key";
* - from 1280 px, a column docked beside the page, the same place and the
* same breakpoint as the Coach's conversations panel. Not modal: the
* chart beside it stays usable, and another point swaps the day. It is a
* landmark (`complementary`) named by the date.
* landmark (`complementary`) named by the date. It collapses like a
* sidebar instead of going away: hidden, a narrow edge stays on the
* right with a button that brings the last day back, on this page or any
* other (`last-day.ts` remembers it per browser and account).
* - from 768 px, a sheet from the right, modal.
* - on a phone, a sheet from the bottom at a bit over half the height, so
* the chart stays in view above it; dragging the handle up (or tapping
@@ -57,7 +76,9 @@ import { useTodayKey } from "./use-today-key";
* there is never more than one docked panel: the day opens as a sheet there.
*
* The parameter is the state. A date that is not a calendar date, or lies in
* the future, is removed from the URL without a word.
* the future, is removed from the URL without a word. Collapsing the docked
* day removes the parameter like closing does; only the remembered date
* stays, and expanding opens it again.
*/
export function DayLayerMount() {
// `useSearchParams` suspends a statically rendered route until the client
@@ -120,6 +141,18 @@ function DayLayer() {
}, [date]);
useEffect(() => () => publishOpenDay(null), []);
// The last open day, bound to the account and the record it belongs to.
const { user } = useAuth();
const owner = user ? `${user.id}:${getRecordScope() ?? "own"}` : null;
useEffect(() => {
if (date !== null && owner !== null) writeLastDay(owner, date);
}, [date, owner]);
const lastDay = useSyncExternalStore(
subscribeLastDay,
() => readLastDay(owner),
() => null,
);
const wide = useWideViewport();
const phone = useIsMobile();
const shell: "docked" | "sheet" | "bottom" = phone
@@ -136,9 +169,27 @@ function DayLayer() {
const prefetchDay = usePrefetchDay();
const focus = useDayFocus(date);
const longLabel = useLongDayLabel();
const shortLabel = useLongDayLabel("short");
const { t } = useTranslations();
const titleId = useId();
const titleRef = useRef<HTMLHeadingElement>(null);
const panelRef = useRef<HTMLElement>(null);
const expandRef = useRef<HTMLButtonElement>(null);
// Set by the collapse control: focus then lands on the control that
// brings the day back, in the same place, as a sidebar's toggle does.
const collapsing = useRef(false);
// The collapsed edge: the docked frame only, and only with a day to bring
// back that is still a day the layer would open.
const railDay =
shell === "docked" && date === null && lastDay !== null
? parseDayParam(lastDay, today)
: null;
const collapse = useCallback(() => {
collapsing.current = true;
closeDay();
}, []);
// What the polite region says: the day that just opened or was stepped to.
const announcement = date !== null ? longLabel(date) : "";
@@ -154,7 +205,16 @@ function DayLayer() {
}
return;
}
if (before !== null && shell === "docked") returnFocus();
if (before !== null && shell === "docked") {
const rail = expandRef.current;
if (collapsing.current && rail) {
takeDayTrigger();
rail.focus({ preventScroll: true });
} else {
returnFocus(rail);
}
}
collapsing.current = false;
}, [date, shell]);
const onStep = useCallback(
@@ -213,7 +273,64 @@ function DayLayer() {
</p>
);
if (date === null) return live;
if (date === null) {
if (railDay === null) return live;
const label = t("day.showPanel", { date: longLabel(railDay) });
const expand = () =>
openDay(railDay, { trigger: expandRef.current ?? undefined });
return (
<>
{live}
<ShellSidePanel>
<div
data-slot="day-rail"
data-day={railDay}
className="bg-card text-card-foreground border-border flex h-full w-12 shrink-0 flex-col border-l"
>
{/* The top bar's band, so the two bottom borders draw one line;
the control sits where the open day keeps its own. */}
<div
className={cn(
SHELL_HEADER_BAND,
"border-border flex shrink-0 items-center justify-center",
)}
>
<Button
ref={expandRef}
type="button"
variant="ghost"
size="icon"
data-slot="day-expand"
aria-expanded={false}
aria-label={label}
title={label}
onClick={expand}
className={PANEL_TOGGLE}
>
<PanelRightOpen
className={cn(PANEL_TOGGLE_ICON, "-scale-x-100")}
aria-hidden="true"
/>
</Button>
</div>
{/* The rest of the edge takes a click too and names the day it
holds; the keyboard has the button above. */}
<button
type="button"
tabIndex={-1}
aria-hidden="true"
onClick={expand}
className="hover:bg-muted/60 text-muted-foreground flex min-h-0 flex-1 cursor-pointer flex-col items-center justify-start pt-4 text-xs transition-colors"
>
<span className="[writing-mode:vertical-rl]">
{shortLabel(railDay)}
</span>
</button>
</div>
</ShellSidePanel>
</>
);
}
const view = (
Title: Parameters<typeof DayView>[0]["Title"],
@@ -224,7 +341,7 @@ function DayLayer() {
today={today}
focus={focus}
shell={shell}
onClose={closeDay}
onClose={shell === "docked" ? collapse : closeDay}
onStep={onStep}
Title={Title}
titleId={titleId}
@@ -334,13 +451,20 @@ function DockedTitle({
return <h2 ref={ref} {...props} />;
}
/** Return focus to whatever opened the day, or to the page. */
function returnFocus() {
/**
* Return focus to whatever opened the day; failing that, to `fallback` (the
* collapsed edge's control), or to the page.
*/
function returnFocus(fallback?: HTMLElement | null) {
const trigger = takeDayTrigger();
if (trigger && trigger.isConnected) {
trigger.focus({ preventScroll: true });
return;
}
if (fallback && fallback.isConnected) {
fallback.focus({ preventScroll: true });
return;
}
document.getElementById("main-content")?.focus({ preventScroll: true });
}
+13 -9
View File
@@ -96,14 +96,15 @@ const ICON_BUTTON =
"text-muted-foreground hover:text-foreground size-11 shrink-0 pointer-fine:size-9";
/**
* The close control is the Coach panel's own toggle, in the same place: the
* panel's top-left corner, the panel icon mirrored so it points the way the
* panel goes. Same size and glyph as `PANEL_HEADER_BUTTON` there (kept as a
* copy so the day layer does not pull the Coach's panel into the shell).
* The collapse control is the Coach panel's own toggle, in the same place:
* the panel's top-left corner, the panel icon mirrored so it points the way
* the panel goes. Same size and glyph as `PANEL_HEADER_BUTTON` there (kept as
* a copy so the day layer does not pull the Coach's panel into the shell).
* The collapsed edge's control in `day-layer.tsx` takes the same pair.
*/
const PANEL_TOGGLE =
export const PANEL_TOGGLE =
"text-muted-foreground hover:text-foreground size-11 shrink-0 pointer-fine:size-7";
const PANEL_TOGGLE_ICON = "size-5 pointer-fine:size-4";
export const PANEL_TOGGLE_ICON = "size-5 pointer-fine:size-4";
export function DayView({
date,
@@ -178,6 +179,7 @@ export function DayView({
].join(" · ")
: null;
const compact = shell === "bottom";
const closeLabel = shell === "docked" ? t("day.hidePanel") : t("day.close");
return (
<div
@@ -194,14 +196,16 @@ export function DayView({
headerClassName,
)}
>
{/* Top left, where the Coach panel keeps its toggle: the way out. */}
{/* Top left, where the Coach panel keeps its toggle: the way out.
Docked, it collapses the day to the edge; a sheet closes. */}
<Button
type="button"
variant="ghost"
size="icon"
data-slot="day-close"
aria-label={t("day.close")}
title={t("day.close")}
aria-label={closeLabel}
aria-expanded={shell === "docked" ? true : undefined}
title={closeLabel}
onClick={onClose}
className={PANEL_TOGGLE}
>
@@ -261,6 +261,9 @@ export function LayoutCoachFab() {
// the page and never over the day's footer actions. The `:has()`
// gate keys off the docked panel's slot, like the yields below.
"[body:has([data-slot=day-panel][data-shell=docked])_&]:right-[calc(26.25rem+2rem)]",
// Collapsed, the day keeps a 3 rem edge on the right; the launcher
// stays clear of it the same way.
"[body:has([data-slot=day-rail])_&]:right-[calc(3rem+2rem)]",
// Yield to the data-list selection bar: its delete action lands
// in the same lower-right band, and the destructive control
// wins. The `:has()` gate keys off the bar's `data-slot`.
@@ -23,6 +23,12 @@ vi.mock("@/lib/pwa/query-persister", () => ({
clearOfflineCachesForSessionEnd: () => clearOfflineCachesForSessionEnd(),
}));
// The day layer's remembered date is a date of the ending account's record.
const clearLastDay = vi.fn();
vi.mock("@/lib/day/last-day", () => ({
clearLastDay: () => clearLastDay(),
}));
// `use-auth` pulls in the typed fetch wrapper, the router, and the i18n
// context at module load. None of them matter for the pure session-end
// helper, so stub them so the import is side-effect free in the test env.
@@ -41,6 +47,7 @@ import { clearCachesForSessionEnd } from "../use-auth";
afterEach(() => {
clearOfflineCachesForSessionEnd.mockClear();
clearLastDay.mockClear();
});
describe("clearCachesForSessionEnd — cross-user in-memory wipe", () => {
@@ -68,4 +75,9 @@ describe("clearCachesForSessionEnd — cross-user in-memory wipe", () => {
// in-memory clear — the existing offline-leak guard stays intact.
expect(clearOfflineCachesForSessionEnd).toHaveBeenCalledTimes(1);
});
it("forgets the day the layer last showed", () => {
clearCachesForSessionEnd(new QueryClient());
expect(clearLastDay).toHaveBeenCalledTimes(1);
});
});
+3
View File
@@ -27,6 +27,7 @@ import type { CoachReasoningState } from "@/lib/ai/reasoning/resolve";
import type { ModuleAccessState } from "@/lib/sharing/module-disclosure";
import type { OnboardingStateDto } from "@/lib/onboarding/needs";
import type { TourProgress } from "@/lib/onboarding/tour-progress";
import { clearLastDay } from "@/lib/day/last-day";
import { clearOfflineCachesForSessionEnd } from "@/lib/pwa/query-persister";
import {
setRecordScope,
@@ -621,6 +622,8 @@ export function clearCachesForSessionEnd(queryClient: QueryClient): void {
// end the next cold offline launch must land on the login gate, not the
// cached shell.
clearWasAuthenticated();
// The day the layer last showed is a date of this account's record.
clearLastDay();
void clearOfflineCachesForSessionEnd();
}
+75
View File
@@ -0,0 +1,75 @@
/**
* The remembered last day of the day layer: bound to its account and record,
* gone at a session end, and never a reason to throw when storage refuses.
*/
import { describe, expect, it } from "vitest";
import {
clearLastDay,
LAST_DAY_STORAGE_KEY,
readLastDay,
writeLastDay,
} from "../last-day";
function memoryStorage() {
const map = new Map<string, string>();
return {
map,
getItem: (key: string) => map.get(key) ?? null,
setItem: (key: string, value: string) => void map.set(key, value),
removeItem: (key: string) => void map.delete(key),
};
}
const throwing = {
getItem: () => {
throw new Error("SecurityError");
},
setItem: () => {
throw new Error("QuotaExceededError");
},
removeItem: () => {
throw new Error("SecurityError");
},
};
describe("last day", () => {
it("gives the day back to the account and record that opened it", () => {
const storage = memoryStorage();
writeLastDay("u1:own", "2026-10-05", storage);
expect(readLastDay("u1:own", storage)).toBe("2026-10-05");
});
it("gives nothing to another account, another record or no session", () => {
const storage = memoryStorage();
writeLastDay("u1:own", "2026-10-05", storage);
expect(readLastDay("u2:own", storage)).toBeNull();
expect(readLastDay("u1:rec-9", storage)).toBeNull();
expect(readLastDay(null, storage)).toBeNull();
});
it("is gone after a session end", () => {
const storage = memoryStorage();
writeLastDay("u1:own", "2026-10-05", storage);
clearLastDay(storage);
expect(storage.map.has(LAST_DAY_STORAGE_KEY)).toBe(false);
expect(readLastDay("u1:own", storage)).toBeNull();
});
it("reads a damaged value as nothing", () => {
const storage = memoryStorage();
storage.setItem(LAST_DAY_STORAGE_KEY, "{not json");
expect(readLastDay("u1:own", storage)).toBeNull();
storage.setItem(
LAST_DAY_STORAGE_KEY,
JSON.stringify({ owner: "u1:own", day: "yesterday" }),
);
expect(readLastDay("u1:own", storage)).toBeNull();
});
it("never throws when storage refuses", () => {
expect(readLastDay("u1:own", throwing)).toBeNull();
expect(() => writeLastDay("u1:own", "2026-10-05", throwing)).not.toThrow();
expect(() => clearLastDay(throwing)).not.toThrow();
});
});
+113
View File
@@ -0,0 +1,113 @@
/**
* The last day the layer showed, per browser, so the docked day can be shut
* to a narrow edge and brought back on another page (v1.42).
*
* A convenience, not a record: it lives in `localStorage`, every read and
* write is wrapped because storage can throw (private windows, blocked site
* data), and an unreadable store means "nothing remembered". The value is
* bound to the account and the record it was read in (`owner`), so another
* account on the same browser, or the same person reading a shared record,
* never gets it back; a session end removes it outright
* (`clearCachesForSessionEnd`).
*
* Client-only and free of Zod and server imports, like `contract.ts`.
*/
import type { DateKey } from "@/lib/day/contract";
export const LAST_DAY_STORAGE_KEY = "healthlog.day.last";
const DATE_KEY = /^\d{4}-\d{2}-\d{2}$/;
/** Same-tab change signal; the `storage` event only fires in other tabs. */
export const LAST_DAY_CHANGE_EVENT = "healthlog:day-last";
interface Stored {
owner: string;
day: DateKey;
}
function safeLocalStorage(): Storage | null {
if (typeof window === "undefined") return null;
try {
return window.localStorage;
} catch {
return null;
}
}
/** The remembered day for `owner`, or null (nothing, someone else's, unreadable). */
export function readLastDay(
owner: string | null,
storage: Pick<Storage, "getItem"> | null = safeLocalStorage(),
): DateKey | null {
if (owner === null || !storage) return null;
try {
const raw = storage.getItem(LAST_DAY_STORAGE_KEY);
if (!raw) return null;
const parsed = JSON.parse(raw) as Partial<Stored> | null;
if (
parsed === null ||
typeof parsed !== "object" ||
parsed.owner !== owner ||
typeof parsed.day !== "string" ||
!DATE_KEY.test(parsed.day)
) {
return null;
}
return parsed.day;
} catch {
return null;
}
}
function notify() {
if (typeof window !== "undefined") {
window.dispatchEvent(new Event(LAST_DAY_CHANGE_EVENT));
}
}
/** Remember `day` as the last one `owner` opened. Best effort. */
export function writeLastDay(
owner: string,
day: DateKey,
storage: Pick<Storage, "getItem" | "setItem"> | null = safeLocalStorage(),
): void {
if (!storage) return;
try {
if (readLastDay(owner, storage) === day) return;
storage.setItem(
LAST_DAY_STORAGE_KEY,
JSON.stringify({ owner, day } satisfies Stored),
);
} catch {
return;
}
notify();
}
/** Forget the remembered day, whoever it belonged to (a session end). */
export function clearLastDay(
storage: Pick<Storage, "removeItem"> | null = safeLocalStorage(),
): void {
if (!storage) return;
try {
storage.removeItem(LAST_DAY_STORAGE_KEY);
} catch {
return;
}
notify();
}
/** For `useSyncExternalStore`: storage changes here and in other tabs. */
export function subscribeLastDay(callback: () => void): () => void {
if (typeof window === "undefined") return () => {};
const onStorage = (event: StorageEvent) => {
if (event.key === null || event.key === LAST_DAY_STORAGE_KEY) callback();
};
window.addEventListener("storage", onStorage);
window.addEventListener(LAST_DAY_CHANGE_EVENT, callback);
return () => {
window.removeEventListener("storage", onStorage);
window.removeEventListener(LAST_DAY_CHANGE_EVENT, callback);
};
}