v1.0.0 — The Milestone Release

v1.0.0 is focused on Polish & Discovery — making ZGameLib feel welcoming from
the very first launch. Three major features land alongside a set of smaller
quality-of-life additions.

Download and more info at https://zsync.eu/zgamelib/

─────────────────────────────────────────────────────────────────────────────

🎬 Interactive Onboarding Tour

The signature 1.0 feature. On first launch, pick a tour mode and ZGameLib
walks you through the entire UI automatically.

• Three modes: Quick Start (~2 min, 10 steps), Standard (~5 min, 23 steps),
  Deep Dive (~10 min, 37 steps)
• Animated SVG spotlight overlay with glow ring and pulse effects; auto-scrolls
  off-screen targets before measuring
• Live demonstrations — context menu actually opens on a game card, scan
  dropdown expands and highlights its options, game detail tabs switch, settings
  page scrolls to each section
• Full toolbar coverage: dedicated steps for Bulk IGDB, Remove Duplicates, Scan
  Log, HLTB, and IGDB buttons in the detail panel
• Auto-scan runs when the tour starts so your library populates while you watch
• Chapter system in Deep Dive (37 steps across 9 labeled chapters)
• Cinematic finale: fly-through purple heart animation + "Made By TheHolyOneZ"
  credit with particle effects
• Keyboard navigation: Enter/→ advance, ← back, Escape skip
• Re-triggerable anytime from Settings → About
• Onboarding reset on upgrade: users coming from 0.x get the tour automatically
  on first 1.0.0 launch

📅 Year in Review (/wrapped)

Annual gaming recap accessible from the sidebar or the W shortcut.

• Year selector defaulting to current year; only shows years with session data
• 9 animated stat cards: total hours, most played, top rated, new additions,
  completed, longest session, busiest month (12-bar chart), platform split
  (SVG donut), and games explored
• Empty state shown when no session data exists for the selected year

💡 Smart Play Recommendations

"Play Next" strip on the library page surfacing backlog games you're most
likely to enjoy.

• Frontend-only algorithm: taste profile = tags + genre of all games rated ≥ 8;
  score = matching tags ×2 + genre match ×3; tiebreak by time in library
• Each card shows "X matching tags" so you know why it was suggested
• Per-card dismiss (session only, no persistent blacklist)
• Only activates when the library has ≥ 3 games rated ≥ 8 and ≥ 3 eligible
  suggestions; otherwise hidden entirely

─────────────────────────────────────────────────────────────────────────────

Also in 1.0.0

What's New Modal

• Shown automatically on first launch after an update
• "What's New" button in Settings → About to re-open it anytime

Contextual Empty State

• When the library is empty and onboarding is complete: three action cards
  (Scan for Games, Add Manually, Browse Steam)
• First-run users still see the original illustration + Take the Tour CTA

New Keyboard Shortcuts

• S — focus the Scan Games dropdown
• W — navigate to Year in Review
• H — toggle visibility of hidden/duplicate games
• 1–9, 0 — quick-rate the open game detail (0 = 10 stars)
• Ctrl+Z — undo last game deletion
• All new shortcuts added to the ? overlay

Changed

• Default grid columns changed from 4 to 6

─────────────────────────────────────────────────────────────────────────────

Full Changelog (1.0.0)

Interactive Onboarding Tour (F-050)

• Tour Mode Selector: full-screen mode picker on first launch with three
  options; skip option marks onboarding complete without running tour
• Cinematic spotlight overlay: SVG mask-based cutout, accent glow ring, double
  pulse rings, radial gradient highlight; auto-scrolls off-screen targets
• Live interactive demonstrations: scan dropdown expands, context menu appears
  via synthetic right-click, Add Game modal opens, game detail opens with IGDB
  and HLTB buttons highlighted, settings page scrolls to each section
• Full toolbar coverage: dedicated steps for Bulk IGDB Metadata, Remove
  Duplicates, and Scan Log buttons
• Auto-scan on first launch in every tour mode
• Chapter system (Deep Dive): 37 steps across 9 labeled chapters with gradient
  indicator strip
• Tour card: glass-morphism floating card with gradient accent header, step
  counter badge, animated position transitions, smooth content crossfade
• Cinematic finale: fly-through purple SVG heart, "Made By TheHolyOneZ" credit,
  particle effects, phased reveal
• Keyboard navigation: Enter/→ advance, ← back, Escape skip
• afterRender hook system: context menu opens after spotlight is stable to
  prevent scroll-triggered dismissal
• Persistent state: onboarding_completed and onboarding_tour_mode saved to
  settings; backend event and frontend check ensure reliable first-launch trigger
• Onboarding reset on upgrade: users from 0.x get the tour on first 1.0.0 launch
• Restart tour: "Take the Tour" button in Settings → About
• data-tour attributes on all targeted elements

Year in Review / Wrapped (F-051)

• New /wrapped page accessible from sidebar (between Spin and Settings) and W shortcut
• Year selector: dropdown defaulting to current year; only years with sessions shown
• Stat cards (staggered Framer Motion entry):
  Hero: total hours across total sessions
  Most Played: cover, name, platform badge, total hours
  Top Rated: highest-rated game played or added in the year
  New Additions: games added to the library this year
  Completed: games marked completed this year
  Longest Session: formatted as hours + minutes
  Busiest Month: month name with 12-bar chart
  Platform Split: SVG donut chart
  Games Explored: distinct games with at least one session
• Empty state when no session data exists for the selected year
• Rust backend command get_year_in_review(year) with multi-join SQLite queries

Smart Play Recommendations (F-052)

• Recommendations strip: collapsible horizontal scroll row below Pinned, above
  grid; up to 5 personalized suggestions
• Taste profiling: frontend-only; scores status=none/backlog games with
  playtime_mins < 30; matching tags ×2 + genre match ×3; tiebreak by time in library
• Hint label: each card shows "X matching tags"
• Per-card dismiss: hides for session, resets on reload
• Threshold guard: only renders when ≥ 3 games rated ≥ 8 AND ≥ 3 eligible suggestions

What's New Modal (I-047)

• Auto-shown on first launch after an update
• Rust compares last_seen_version to CARGO_PKG_VERSION; emits show-whats-new event
• "View full changelog" link opens GitHub releases
• Manual trigger via Settings → About

Empty State Enhancement (I-048)

• Contextual empty state: three action cards when library empty + onboarding complete
• First-run users see original illustration-based empty state

Keyboard Shortcut Additions (I-049)

• S: focus Scan Games dropdown
• W: navigate to /wrapped
• H: toggle hidden/duplicate game visibility
• 1–9, 0: quick-rate open game detail (only when panel is open, never in fields)
• Ctrl+Z: undo last game deletion
• All added to ? overlay

Changed

• Default grid columns: 4 → 6 (Rust default and frontend fallback)
• Wrapped page added to sidebar between Spin and Settings
• Settings → About: added "Take the Tour" and "What's New" buttons