Martin Dvorak
618ad5fb9c
English stays the default; Czech is a full translation. Only the app chrome is translated - notes and generated decks keep their own language, which is a core feature, not a setting. i18n - lib/i18n-dict.ts: flat en/cs dictionaries (441 keys each), translate() and translatePlural() with real Czech plural rules (1 sada / 2-4 sady / 5+ sad). English is the default and the fallback for a missing key. - lib/i18n.ts: browser store (freezmo.locale.v1), useI18n() hook, and the x-freezmo-locale header. The hook's t/plural are bound to the locale React is rendering with, so the first client render matches the server HTML and then re-renders in the stored language; module-level t is only for event handlers and non-React helpers. - <html lang> follows the choice (inline script + setLocale). UI - Settings -> Language segmented control (English / Cestina), plus an EN/CS button on the key gate for first run. - Every screen translated: sidebar, header, tab bar, library, deck cards, folder bar, create flow, all seven activities, study chrome, results, settings + health panel, API-key gate and help, install sheet, offline and the deck-not-found page. - Plural-aware counts everywhere (decks, folders, activities, runs, photos, documents, pages, words, wrong attempts). Server - API routes and guards (generate, grade, health, http-guard, rate-limit, ollama error mapping) answer in the request's language, so error cards and the health panel never fall back to English mid-sentence. Fixes - A hydration mismatch when a non-default locale was stored silently dropped the .dark class after hydration; render-time t() is now bound to the hook's locale (UploadScreen.describeExtraction, ResultsScreen.answerFor, DeckCard's folder fallback). - Bumped the service worker cache to freezmo-v4 for this deploy. Tests: i18n 27/27 (gate toggle, persistence, html lang, Czech plurals, settings switch) and a rebuilt regression suite 72/72 (English default, library, create, all 7 activity types, results, settings, install sheet, offline, PWA, security, Czech smoke).
383 lines
14 KiB
TypeScript
383 lines
14 KiB
TypeScript
"use client";
|
|
|
|
import { AnimatePresence, motion, useDragControls, useReducedMotion } from "framer-motion";
|
|
import { useCallback, useEffect, useState } from "react";
|
|
|
|
import {
|
|
AddToHomeIcon,
|
|
ChevronDownIcon,
|
|
ChromeIcon,
|
|
CompassIcon,
|
|
DownloadIcon,
|
|
EllipsisIcon,
|
|
PlusIcon,
|
|
ShareIcon,
|
|
XIcon,
|
|
} from "@/components/icons";
|
|
import { Spinner } from "@/components/ui";
|
|
import { useI18n } from "@/lib/i18n";
|
|
import {
|
|
detectBrowser,
|
|
detectPlatform,
|
|
dismissInstallPrompt,
|
|
INSTALL_PROMPT_EVENT,
|
|
INSTALLED_EVENT,
|
|
installSheetTheme,
|
|
isDismissed,
|
|
isInstalled,
|
|
isStandalone,
|
|
markInstalled,
|
|
OPEN_INSTALL_EVENT,
|
|
type BeforeInstallPromptEvent,
|
|
type InstallBrowser,
|
|
type InstallPlatform,
|
|
} from "@/lib/install";
|
|
import { cn } from "@/lib/utils";
|
|
|
|
type SheetInfo = {
|
|
platform: InstallPlatform;
|
|
browser: InstallBrowser;
|
|
theme: "dark" | "light";
|
|
};
|
|
|
|
/**
|
|
* "Install the app" bottom sheet. Mounted once in the root layout so it can
|
|
* appear over any screen (including the API-key gate) about a second after
|
|
* load. Phones/tablets only, never when already installed, and at most once
|
|
* per 7 days after a dismissal. Closing it leaves the site exactly as it was.
|
|
*/
|
|
export function InstallSheet() {
|
|
const [info, setInfo] = useState<SheetInfo | null>(null);
|
|
const [open, setOpen] = useState(false);
|
|
const [promptEvent, setPromptEvent] = useState<BeforeInstallPromptEvent | null>(null);
|
|
const [installing, setInstalling] = useState(false);
|
|
const dragControls = useDragControls();
|
|
const reduceMotion = useReducedMotion();
|
|
const { t } = useI18n();
|
|
const domain = typeof window === "undefined" ? "" : window.location.hostname;
|
|
|
|
/** Everything needed to render the sheet, or null if it shouldn't appear. */
|
|
const prepare = useCallback((): SheetInfo | null => {
|
|
const platform = detectPlatform();
|
|
if (platform === "other" || isInstalled()) return null;
|
|
return { platform, browser: detectBrowser(platform), theme: installSheetTheme() };
|
|
}, []);
|
|
|
|
// Automatic prompt: about a second after load, unless dismissed recently.
|
|
useEffect(() => {
|
|
if (isStandalone()) {
|
|
markInstalled();
|
|
return;
|
|
}
|
|
const next = prepare();
|
|
if (!next || isDismissed()) return;
|
|
const timer = window.setTimeout(() => {
|
|
setInfo(next);
|
|
setOpen(true);
|
|
}, 1000);
|
|
return () => window.clearTimeout(timer);
|
|
}, [prepare]);
|
|
|
|
// Manual open from the Settings row (ignores the 7-day window).
|
|
useEffect(() => {
|
|
const onOpen = () => {
|
|
const next = prepare();
|
|
if (!next) return;
|
|
setInfo(next);
|
|
setOpen(true);
|
|
};
|
|
window.addEventListener(OPEN_INSTALL_EVENT, onOpen);
|
|
return () => window.removeEventListener(OPEN_INSTALL_EVENT, onOpen);
|
|
}, [prepare]);
|
|
|
|
// Chrome's deferred install prompt + the "installed" signal.
|
|
useEffect(() => {
|
|
const sync = () => setPromptEvent(window.__freezmoInstallPrompt ?? null);
|
|
const onInstalled = () => {
|
|
markInstalled();
|
|
setPromptEvent(null);
|
|
setInstalling(false);
|
|
setOpen(false);
|
|
};
|
|
window.addEventListener(INSTALL_PROMPT_EVENT, sync);
|
|
window.addEventListener(INSTALLED_EVENT, onInstalled);
|
|
window.addEventListener("appinstalled", onInstalled);
|
|
sync();
|
|
return () => {
|
|
window.removeEventListener(INSTALL_PROMPT_EVENT, sync);
|
|
window.removeEventListener(INSTALLED_EVENT, onInstalled);
|
|
window.removeEventListener("appinstalled", onInstalled);
|
|
};
|
|
}, []);
|
|
|
|
const close = useCallback(() => {
|
|
dismissInstallPrompt();
|
|
setOpen(false);
|
|
setInstalling(false);
|
|
}, []);
|
|
|
|
// Escape closes, like every other sheet in the app.
|
|
useEffect(() => {
|
|
if (!open) return;
|
|
const onKey = (event: KeyboardEvent) => {
|
|
if (event.key === "Escape") close();
|
|
};
|
|
window.addEventListener("keydown", onKey);
|
|
return () => window.removeEventListener("keydown", onKey);
|
|
}, [open, close]);
|
|
|
|
const runPrompt = async () => {
|
|
if (!promptEvent || installing) return;
|
|
setInstalling(true);
|
|
try {
|
|
await promptEvent.prompt();
|
|
const choice = await promptEvent.userChoice;
|
|
if (choice.outcome === "accepted") {
|
|
markInstalled();
|
|
setOpen(false);
|
|
setInstalling(false);
|
|
return;
|
|
}
|
|
} catch {
|
|
/* the native prompt can fail; the steps below still work */
|
|
}
|
|
setInstalling(false);
|
|
};
|
|
|
|
// The exact iOS flow: Safari users skip the "open in Safari" step entirely.
|
|
const steps: React.ReactNode[] = [];
|
|
if (info?.platform === "ios") {
|
|
if (info.browser !== "safari") {
|
|
steps.push(
|
|
<>
|
|
{t("install.openIn")} <Chip icon={<CompassIcon className="size-4" />}>Safari</Chip>
|
|
</>,
|
|
);
|
|
}
|
|
steps.push(
|
|
<>
|
|
{t("install.tap")}{" "}
|
|
<IconChip icon={<EllipsisIcon className="size-4" />} label={t("install.moreOptions")} />{" "}
|
|
{t("install.inBrowserBar")}
|
|
</>,
|
|
);
|
|
steps.push(
|
|
<>
|
|
{t("install.tap")} <Chip icon={<ShareIcon className="size-4" />}>{t("install.share")}</Chip>
|
|
{t("install.then")} <Chip icon={<ChevronDownIcon className="size-4" />}>{t("install.more")}</Chip>
|
|
</>,
|
|
);
|
|
steps.push(
|
|
<>
|
|
{t("install.choose")}{" "}
|
|
<Chip icon={<AddToHomeIcon className="size-4" />}>{t("install.addToHome")}</Chip>
|
|
</>,
|
|
);
|
|
steps.push(
|
|
<>
|
|
{t("install.tapConfirm")}{" "}
|
|
<AccentPill icon={<PlusIcon className="size-4" />}>{t("install.add")}</AccentPill>{" "}
|
|
{t("install.toConfirm")}
|
|
</>,
|
|
);
|
|
} else if (info?.platform === "android") {
|
|
if (info.browser !== "chrome") {
|
|
steps.push(
|
|
<>
|
|
{t("install.openIn")} <Chip icon={<ChromeIcon className="size-4" />}>Chrome</Chip>
|
|
</>,
|
|
);
|
|
}
|
|
steps.push(
|
|
<>
|
|
{t("install.tap")}{" "}
|
|
<IconChip icon={<EllipsisIcon className="size-4" />} label={t("install.moreOptions")} />{" "}
|
|
{t("install.inTopRight")}
|
|
</>,
|
|
);
|
|
steps.push(
|
|
<>
|
|
{t("install.choose")}{" "}
|
|
<Chip icon={<DownloadIcon className="size-4" />}>{t("install.installApp")}</Chip>{" "}
|
|
{t("install.or")}{" "}
|
|
<Chip icon={<AddToHomeIcon className="size-4" />}>{t("install.addToHomeScreen")}</Chip>
|
|
</>,
|
|
);
|
|
steps.push(
|
|
<>
|
|
{t("install.tapConfirm")}{" "}
|
|
<AccentPill icon={<DownloadIcon className="size-4" />}>{t("install.install")}</AccentPill>{" "}
|
|
{t("install.toConfirm")}
|
|
</>,
|
|
);
|
|
}
|
|
|
|
const showNativePrompt = info?.platform === "android" && Boolean(promptEvent);
|
|
|
|
return (
|
|
// The sheet is dark by default; only an explicit light choice in the app
|
|
// switches the palette (the wrapper scopes the app's .dark tokens).
|
|
<div className={info?.theme === "light" ? undefined : "dark"}>
|
|
<AnimatePresence>
|
|
{open && info ? (
|
|
<div className="fixed inset-x-0 top-0 z-[60] h-dvh">
|
|
<motion.div
|
|
aria-hidden
|
|
onClick={close}
|
|
initial={{ opacity: 0 }}
|
|
animate={{ opacity: 1 }}
|
|
exit={{ opacity: 0 }}
|
|
transition={{ duration: 0.25 }}
|
|
className="absolute inset-0 bg-black/50 backdrop-blur-[4px]"
|
|
/>
|
|
<motion.div
|
|
role="dialog"
|
|
aria-modal="true"
|
|
aria-labelledby="install-sheet-title"
|
|
drag="y"
|
|
dragControls={dragControls}
|
|
dragListener={false}
|
|
dragMomentum={false}
|
|
dragConstraints={{ top: 0, bottom: 0 }}
|
|
dragElastic={{ top: 0, bottom: 0.55 }}
|
|
onDragEnd={(_, gesture) => {
|
|
if (gesture.offset.y > 90 || gesture.delta.y > 140 || gesture.velocity.y > 700) close();
|
|
}}
|
|
initial={reduceMotion ? { opacity: 0 } : { y: "100%" }}
|
|
animate={reduceMotion ? { opacity: 1 } : { y: 0 }}
|
|
exit={reduceMotion ? { opacity: 0 } : { y: "100%" }}
|
|
transition={{ duration: 0.34, ease: [0.22, 1, 0.36, 1] }}
|
|
className="gate-card absolute inset-x-0 bottom-0 mx-auto w-full rounded-b-none border-b-0 sm:max-w-xl"
|
|
>
|
|
<div className="thin-scroll max-h-[90dvh] overflow-y-auto px-5 pt-2 pb-[calc(24px+env(safe-area-inset-bottom))]">
|
|
<div
|
|
aria-hidden
|
|
onPointerDown={(event) => dragControls.start(event)}
|
|
className="mx-auto flex h-6 w-full cursor-grab touch-none items-center justify-center active:cursor-grabbing"
|
|
>
|
|
<span className="h-1 w-9 rounded-full bg-[var(--text-subtle)] opacity-40" />
|
|
</div>
|
|
|
|
<div className="flex items-center justify-between gap-4">
|
|
<h2
|
|
id="install-sheet-title"
|
|
className="text-[17px] font-semibold tracking-[-0.02em] text-[var(--text)]"
|
|
>
|
|
{info.platform === "ios" ? t("install.titleIos") : t("install.titleAndroid")}
|
|
</h2>
|
|
<button
|
|
type="button"
|
|
onClick={close}
|
|
aria-label={t("common.close")}
|
|
className="grid size-10 shrink-0 place-items-center rounded-full text-[var(--text-muted)] transition hover:bg-[var(--hover)] hover:text-[var(--text)]"
|
|
>
|
|
<XIcon className="size-[18px]" />
|
|
</button>
|
|
</div>
|
|
|
|
{/* app card */}
|
|
<div className="mt-1 flex items-center gap-3 rounded-2xl border border-[var(--install-border)] bg-[var(--install-card)] p-3">
|
|
{/* eslint-disable-next-line @next/next/no-img-element -- static app icon, no optimisation needed */}
|
|
<img
|
|
src="/icons/icon-192.png"
|
|
alt=""
|
|
aria-hidden
|
|
className="size-11 shrink-0 rounded-[11px]"
|
|
/>
|
|
<span className="min-w-0">
|
|
<span className="block text-[15px] font-semibold leading-tight text-[var(--text)]">
|
|
Freezmo
|
|
</span>
|
|
<span className="block truncate text-[13px] text-[var(--text-subtle)]">
|
|
{domain}
|
|
</span>
|
|
</span>
|
|
</div>
|
|
|
|
{showNativePrompt ? (
|
|
<button
|
|
type="button"
|
|
onClick={() => void runPrompt()}
|
|
disabled={installing}
|
|
className="btn-primary mt-4 h-12 w-full rounded-[14px] text-[15px] font-medium disabled:cursor-not-allowed disabled:opacity-60"
|
|
>
|
|
{installing ? (
|
|
<>
|
|
<Spinner className="size-4" /> {t("install.installing")}
|
|
</>
|
|
) : (
|
|
<>
|
|
<DownloadIcon className="size-4" /> {t("install.install")}
|
|
</>
|
|
)}
|
|
</button>
|
|
) : null}
|
|
|
|
{showNativePrompt ? (
|
|
<p className="mt-4 text-center text-[12px] text-[var(--text-subtle)]">
|
|
{t("install.orManually")}
|
|
</p>
|
|
) : null}
|
|
|
|
<ol className={cn("space-y-4", showNativePrompt ? "mt-3" : "mt-5")}>
|
|
{steps.map((step, index) => (
|
|
<li key={index} className="grid grid-cols-[24px_1fr] items-start gap-3">
|
|
<span
|
|
aria-hidden
|
|
className="grid size-6 place-items-center rounded-full border border-[var(--install-border)] text-[11.5px] font-medium tabular-nums text-[var(--text-subtle)]"
|
|
>
|
|
{index + 1}
|
|
</span>
|
|
<span className="text-[16px] leading-6 text-[var(--text-muted)]">{step}</span>
|
|
</li>
|
|
))}
|
|
</ol>
|
|
|
|
<button
|
|
type="button"
|
|
onClick={close}
|
|
className="mt-6 w-full rounded-[14px] py-3 text-center text-[15px] font-medium text-[var(--text-muted)] transition hover:bg-[var(--hover)] hover:text-[var(--text)]"
|
|
>
|
|
{t("install.maybeLater")}
|
|
</button>
|
|
</div>
|
|
</motion.div>
|
|
</div>
|
|
) : null}
|
|
</AnimatePresence>
|
|
</div>
|
|
);
|
|
}
|
|
|
|
/** Small pill for a UI element the user has to tap. */
|
|
function Chip({ icon, children }: { icon: React.ReactNode; children: React.ReactNode }) {
|
|
return (
|
|
<span className="mx-0.5 inline-flex items-center gap-1.5 rounded-full border border-[var(--install-border)] bg-[var(--install-chip)] px-2.5 py-1 align-middle text-[16px] font-medium leading-none text-[var(--text)]">
|
|
<span aria-hidden>{icon}</span>
|
|
{children}
|
|
</span>
|
|
);
|
|
}
|
|
|
|
/** Icon-only pill, for buttons that are just a glyph (the ⋯ menu). */
|
|
function IconChip({ icon, label }: { icon: React.ReactNode; label: string }) {
|
|
return (
|
|
<span
|
|
role="img"
|
|
aria-label={label}
|
|
className="mx-0.5 inline-flex items-center rounded-full border border-[var(--install-border)] bg-[var(--install-chip)] px-2.5 py-1 align-middle text-[var(--text)]"
|
|
>
|
|
<span aria-hidden>{icon}</span>
|
|
</span>
|
|
);
|
|
}
|
|
|
|
/** The one coloured element: the final confirmation button (iOS blue). */
|
|
function AccentPill({ icon, children }: { icon: React.ReactNode; children: React.ReactNode }) {
|
|
return (
|
|
<span className="mx-0.5 inline-flex items-center gap-1.5 rounded-full bg-[#007AFF] px-3 py-1 align-middle text-[16px] font-medium leading-none text-white dark:bg-[#0A84FF]">
|
|
<span aria-hidden>{icon}</span>
|
|
{children}
|
|
</span>
|
|
);
|
|
}
|