changelog/v<major>/<major>.<minor>.x/<version>.md for each of the 42 releases from v1.0.0 to v4.7.1, and changelog/beta/ for pre-releases (none has been published; its README says how one would be filed). CHANGELOG.md becomes the index: what the layout is, [Unreleased] exactly as it was, and a table per major version (version, date, edition) that links each file. Each file is its section, copied byte for byte except that its heading is the file's H1 (so the sub-headings move up one level, outside code fences), relative links gain ../../../ so they name the same repository paths, and the --- separators between sections are gone. Checked by reversing all three changes on every file and comparing with the original section: 40 of 40 equal. Two releases had no section: v1.0.0 (its GitHub release notes, which the changelog pointed to as "Initial stable") and v1.1.3 (its tag message). Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
7.5 KiB
7.5 KiB
v3.3.0 – 2026-06-12 (The "Lazy-Load + Error Pages" Edition)
Feature release on top of v3.2.7, two themes: a web-app performance overhaul (route-level code splitting, lazy echarts/openpgp/locale chunks — first-load JS drops from ~574 KB to ~163 KB gzipped, −72%) and a proper error-page system (403/404/419/5xx/offline pages, React error boundaries, a real GitHub Pages 404.html). Web app + desktop bumped 1.2.7 → 1.3.0. Repo public-facing version 3.2.7 → 3.3.0. Tag v3.3.0 is GPG-signed; companion desktop tag is desktop-v1.3.0.
⚡ Lazy-loading overhaul
- Route splitting — web/src/App.tsx: every page except
Dashboard(the landing route) is nowReact.lazyvia a newlazyWithRetryhelper (web/src/lib/lazy.ts). The<Suspense>boundary sits inside Layout.tsx around<Outlet/>, so the sidebar/topbar stay mounted during navigation; fallback reuses the existingLoadingState. - echarts (~666 KB raw) — new LazyEChart.tsx wrapper is the single dynamic boundary for
EChart.tsx(which keeps theecharts.use([...])registration). All 15 chart components swap one import line; a fixed-heightanimate-pulseskeleton prevents layout shift. echarts now downloads only when a chart mounts. - openpgp (~391 KB raw) — web/src/lib/gpg.ts switches to a type-only import + memoized
await import("openpgp"). All exports were already async, so zero caller changes; visitors without a saved GPG key never download the crypto chunk at all. - Per-locale i18n — web/src/i18n/index.ts:
en.jsonstays bundled (it'sfallbackLng— a missing key can never render raw),vi.jsonbecomes a dynamic import.initI18n()preloads the detected locale beforei18n.init, and main.tsx awaits it before first render — no flash of raw keys, verified with a hard reload underf2p:lang=vi.setLanguage()is now async and loads the bundle before switching. Also syncs<html lang>(was hardcodedvifor everyone). - manualChunks fix — forcing
echarts/openpgpintomanualChunksmade Rollup hoist shared helpers (tslib) into the echarts chunk, which the eager graph then statically imported — echarts was being modulepreloaded on first paint, nullifying the lazy boundary. Both entries are removed from vite.config.ts; the dynamic-import boundaries split them naturally.dist/index.htmlnow modulepreloads onlyreact+query. - Net effect: eager JS
~1746 KB → ~494 KBraw (~574 → ~163 KBgzip). The PWA still precaches everything in the background, but first paint no longer waits for charts + crypto.
🚦 Error pages (403 / 404 / 419 / 500 / 502 / 503 / 504 / offline)
- New web/src/pages/errors/ErrorPage.tsx — one config-driven component: per-code lucide icon + tone (neutral/warn/destructive, reusing the exact
ErrorState/PwaIndicatorpalettes), monoERROR {{code}}badge, i18n'd title/description, and three actions (Go home / Reload / Report issue → GitHub Issues). Fullerrors.*key blocks added to both en.json and vi.json. Kept in the eager bundle on purpose — error UI must not live in a lazy chunk. - Routing —
#/error/:codedeep links viaErrorCodeRoute(unknown codes render 404 in place, no redirect), and the catch-all<Route path="*">now shows a real 404 page instead of silently redirecting to the Dashboard. - GitHub Pages
404.html— new web/public/404.html: standalone dark page (inline CSS, no JS deps), bilingual via a one-liner that respects the app's ownf2p:lang,noindex, absolute link back to/free-steam-games-list/#/. Excluded from the SW precache viaglobIgnoresin vite.config.ts — SW-controlled clients getnavigateFallbackand never see it.
🛡️ Error boundaries + stale-deploy resilience
- New ErrorBoundary.tsx (own ~40-line class, no new dep) with a
resetKeyprop — navigating away clears a stuck error without remounting the page subtree on every navigation (whichkeywould do, destroying table scroll/selection state). - Two mounts: route-level inside
Layout(chunk-load error → 503 page with "new version deployed, reload" copy; render crash → 500 page, error message shown in dev only), and a top-level AppErrorBoundary outside the router with inline styles + hardcoded bilingual strings — immune to i18n/Tailwind/router failures. lazyWithRetryhandles the deploy-mid-session case: a chunk 404 triggers ONE auto-reload per tab (sessionStorageflag, try/catch-guarded for lockdown webviews) which also picks up the waiting service worker; a second failure throws to the boundary.
🔌 Real error flows wired in
- QueryState.tsx
ErrorStateupgraded in place (contract preserved): offline detection swaps in theerrors.offline.*copy +WifiOfficon, plus Retry / Report-issue action buttons. All 17 call sites now passonRetry={() => void q.refetch()}. - Expired/revoked token on session restore (stores/auth.ts
hydrate()catch) now fires a Sonner toast with the sharederrors.419.*copy and an "Open Settings" action (10 s duration — the 4 s default is too short for action toasts). Deliberately a toast, not a redirect: don't hijack whatever page the user opened. Auth gating on/addstays as-is.
🖼️ Images
decoding="async"added to every<img>(10 sites: table thumbs, mobile cards, command palette, detail drawer, avatars, About QRs) — keeps image decode off the main thread during virtualised scrolling.- Detail drawer header image now goes through a new
preferWebp()(web/src/lib/image.ts): weserv WebP transcode (~50 KB → ~20 KB) on web, direct Steam URL on Tauri desktop (no third-party calls from the bundled app), with anonErrorfallback to the original. Replaces the old<picture><source>markup, which only falls back on unsupported type — a weserv outage would have shown a broken image. Thumbnails intentionally stay on direct Steam capsules (~10 KB, SW-cached);webpProxyUrlis no longer exported.
⌨️ Search responsiveness
- GamesTable.tsx: the Fuse.js search input is wrapped in
useDeferredValue— typing stays per-keystroke responsive while filtering ~1.2k records lags at React's low priority. No debounce timer (deferral only delays when the machine is actually busy). Same treatment +useMemofor the command palette's game scan.
🧰 Tooling & misc
rollup-plugin-visualizerdevDependency +npm run analyze(vite build --mode analyze→dist/stats.htmltreemap, gzip/brotli sizes).- index.html:
preconnecthints forraw.githubusercontent.com(shard fetches, crossorigin) andshared.akamai.steamstatic.com(thumbnails). npm audit fix— react-router open-redirect advisory GHSA-2j2x-hqr9-3h42 (react-router-dom6.30.x patch line);npm auditandpip-auditboth report 0 known vulnerabilities.