mirror of
https://github.com/MBombeck/HealthLog.git
synced 2026-11-08 20:42:43 +00:00
Marc-André Bombeck
4273af231e
The wrench beside Upload opens Settings, Appearance, Documents, the way the illness journal offers its display options: preview cards or a compact list, and months stacked as blocks or flowing across the full width with the month name inline above the document that opens it. The choice is stored per account in `users.documents_layout_json` behind GET/PUT /api/documents/inbound/layout (preserve-when-absent, module gated, the read delegable like the rest of the vault), carried in the account-settings backup and cleared by the data wipe. Deleting from the vault now always asks first. The bulk bar's Delete and a focused card's Delete key both go through one confirmation on the page, and the detail sheet's Delete opens its own; before, all three deleted on the spot with only an undo toast behind them. The selection bar is two tight lines: the count with an X at its right edge, then one action row with Delete alone at the right in the destructive style. Below 1024 px the verbs are icon-only at the 44 px tap floor, so the row stays one line at 360 px. The bar carries the selection-bar slot the Coach launcher already steps aside for.
71 lines
2.4 KiB
TypeScript
71 lines
2.4 KiB
TypeScript
/**
|
|
* Document vault presentation — persisted in `User.documentsLayoutJson`.
|
|
*
|
|
* Two independent choices, both display-only:
|
|
*
|
|
* - `view`: `cards` is the monthly grid of preview tiles; `list` is one
|
|
* compact row per document.
|
|
* - `arrangement`: `stacked` gives every month its own block, one under the
|
|
* other; `flow` lets the documents run left to right across the full width
|
|
* and wrap, with each month's name riding inline as a small marker that does
|
|
* not break the run.
|
|
*
|
|
* Null / missing column = the defaults below (cards, stacked — the vault as it
|
|
* has always looked). The GET endpoint never lazy-writes, so the column only
|
|
* carries data once the user has changed one of the two. Mirrors
|
|
* `medication-list-layout.ts`: tolerant resolver on read, normaliser on write,
|
|
* preserve-when-absent PUT (see the route).
|
|
*/
|
|
|
|
export const DOCUMENTS_LAYOUT_VIEWS = ["cards", "list"] as const;
|
|
export type DocumentsLayoutView = (typeof DOCUMENTS_LAYOUT_VIEWS)[number];
|
|
|
|
export const DOCUMENTS_LAYOUT_ARRANGEMENTS = ["stacked", "flow"] as const;
|
|
export type DocumentsLayoutArrangement =
|
|
(typeof DOCUMENTS_LAYOUT_ARRANGEMENTS)[number];
|
|
|
|
export interface DocumentsLayout {
|
|
version: 1;
|
|
view: DocumentsLayoutView;
|
|
arrangement: DocumentsLayoutArrangement;
|
|
}
|
|
|
|
export const DEFAULT_DOCUMENTS_LAYOUT: DocumentsLayout = {
|
|
version: 1,
|
|
view: "cards",
|
|
arrangement: "stacked",
|
|
};
|
|
|
|
function isView(value: unknown): value is DocumentsLayoutView {
|
|
return (
|
|
typeof value === "string" &&
|
|
(DOCUMENTS_LAYOUT_VIEWS as readonly string[]).includes(value)
|
|
);
|
|
}
|
|
|
|
function isArrangement(value: unknown): value is DocumentsLayoutArrangement {
|
|
return (
|
|
typeof value === "string" &&
|
|
(DOCUMENTS_LAYOUT_ARRANGEMENTS as readonly string[]).includes(value)
|
|
);
|
|
}
|
|
|
|
/**
|
|
* Any malformed, partial or legacy blob collapses onto the defaults field by
|
|
* field, so a GET never fails on a stored row and a field added later
|
|
* defaults cleanly for blobs written before it existed.
|
|
*/
|
|
export function resolveDocumentsLayout(raw: unknown): DocumentsLayout {
|
|
if (raw === null || raw === undefined || typeof raw !== "object") {
|
|
return { ...DEFAULT_DOCUMENTS_LAYOUT };
|
|
}
|
|
const blob = raw as { view?: unknown; arrangement?: unknown };
|
|
return {
|
|
version: 1,
|
|
view: isView(blob.view) ? blob.view : DEFAULT_DOCUMENTS_LAYOUT.view,
|
|
arrangement: isArrangement(blob.arrangement)
|
|
? blob.arrangement
|
|
: DEFAULT_DOCUMENTS_LAYOUT.arrangement,
|
|
};
|
|
}
|