core-cooldown/CHANGELOG.md

Changelog

v0.1.3

New Features

• Pomodoro Mode — Alternates short breaks with a longer recovery break after configurable focus sessions. Cycle indicator on dashboard, custom long break titles/messages, reset-on-skip option.
• Microbreaks (20-20-20 Rule) — Independent short eye breaks between main breaks. Subtle non-blocking overlay with activity suggestion and optional sound. Configurable frequency (5-60 min) and duration (10-60 sec).
• Breathing Guide — Visual breathing exercise during breaks with 5 patterns (Box, Relaxing, Energizing, Calm, Deep). Animated pulsing halo behind countdown ring with color interpolation between accent and break colors. Phase labels (Inhale/Hold/Exhale) with countdown.
• Screen Dimming — Gradual pre-break screen dimming. Configurable timing (3-60 sec before break) and maximum intensity (10-70%).
• Presentation Mode — Detects fullscreen applications and defers breaks until exit. Optional microbreak deferral and toast notification when breaks are deferred.
• Goals & Streaks — Daily break target with progress indicator inside dashboard ring. Confetti celebrations on milestones and goal completion. Streak tracking with toast notifications.
• Multi-Monitor Breaks — Fullscreen break overlay spans all connected monitors.
• Working Hours Schedule — Per-day schedule with multiple time ranges. Timer automatically pauses outside configured hours.
• Activity Manager — Browse, search, favorite, and disable built-in activities. Add custom activities with category assignment. Favorites appear 3x more often. Momentum drag scroll with elastic overscroll.
• Celebration Animations — Confetti particle effects on streak milestones and daily goal completion.
• Smart Breaks — Recognizes natural away-from-desk breaks (idle periods exceeding configurable threshold) and optionally counts them toward daily goal.
• Break Window (Standalone) — When fullscreen mode is disabled, breaks open in a separate centered transparent modal window instead of taking over the main window.
• Break Overlay — Multi-monitor break enforcement overlay that covers all screens during breaks.
• Microbreak Overlay — Subtle non-blocking overlay for 20-20-20 eye breaks with activity suggestion.
• Dim Overlay — Smooth pre-break screen dimming with gradual opacity transition.

UI Polish

• Settings Reordered — 18 logically grouped cards: Timer, Pomodoro, Microbreaks, Break Screen, Break Activities (conditional), Breathing Guide, Behavior, Alerts (merged notifications + screen dimming), Sound, Idle & Smart Breaks (merged), Presentation Mode, Goals & Streaks, Appearance, Working Hours, Mini Mode, General, Keyboard Shortcuts, Reset.
• Breathing Pattern Selector Redesigned — Replaced cramped 5-column grid with vertical radio-button list showing timing descriptions (e.g., "4s in - 4s hold - 4s out - 4s hold").
• Dashboard Indicators Inside Ring — Pomodoro cycle dots, microbreak countdown, and daily goal progress bar moved inside the timer ring for cleaner layout.
• Daily Goal Label — Progress bar now includes a target icon and "Goal" label.
• Break Screen Breathing Halo — Breathing guide renders as a pulsing circle behind the countdown ring with dynamic color gradient, in both fullscreen and standalone modes.

Improvements

• Expanded break activity library from 40 to 71 curated activities
• Added 4 new sound presets: Harp, Bowl, Rain, Whistle (now 8 total)
• Stats view now includes weekly summary, natural break tracking, and daily goal progress
• Timer store now handles microbreak, screen dim, celebration, and presentation mode events
• Config store expanded from ~30 to 71 keys with validation for all new features
• Timer state machine now tracks pomodoro cycles, microbreak scheduling, presentation mode deferral, and smart break detection
• Stats backend tracks natural breaks, daily goals, and weekly summaries

Documentation

• README comprehensively updated with all new features, accurate component/activity/config counts
• CLAUDE.md updated with current architecture (17 commands, 12 events, 20 components, 71 config keys)

---

v0.1.2

• WCAG 2.1 Level AA accessibility across all components
• Focus indicators, reduced motion support, forced colors, screen reader support
• Keyboard navigation, focus trapping, aria-live regions

v0.1.1

• Tighten TimeSpinner spacing and fix build warnings
• Enable custom-protocol for embedded frontend assets
• Fix WebView2 detection using loader API instead of registry
• Statically link WebView2Loader for single portable exe
• Fix fullscreen break screen centering and sizing

v0.1.0

• Initial release
• Dashboard with timer ring and status pill
• Break screen with activity suggestions
• Settings panel with sound, idle detection, and activity configuration
• Statistics view with 7-day bar chart
• System tray with dynamic icon, tooltip, and context menu
• Config and stats persistence (portable JSON files)
• Global keyboard shortcuts (Ctrl+Shift+P/B/S)
• Mini mode floating timer
• Toast notifications
• Always-on-top break enforcement
• Animated view transitions
• Idle detection via Windows API
• Custom titlebar with frosted glass effects
• Background gradient blobs with film grain