strip unicode dashes, trim restating doc comments, untrack forbidden files

2026-03-13 14:05:59 +02:00
parent 4fdbec9b0f
commit 8c6f2b57a8
18 changed files with 62 additions and 145 deletions
--- a/src-tauri/build.rs
+++ b/src-tauri/build.rs
@@ -8,7 +8,7 @@ fn main() {
    }

    // On GNU targets, replace the WebView2Loader import library with the static
-    // library so the loader is baked into the exe - no DLL to ship.
+    // library so the loader is baked into the exe -- no DLL to ship.
    if std::env::var("CARGO_CFG_TARGET_ENV").as_deref() == Ok("gnu") {
        swap_webview2_to_static();
    }
@@ -44,7 +44,7 @@ fn fix_resource_lib() {
    // archive signature). A .res file starts with 0x00000000.
    if let Ok(header) = std::fs::read(&lib_file) {
        if header.len() >= 4 && header[0..4] == [0, 0, 0, 0] {
-            // This is a .res file, not COFF - re-compile with windres
+            // This is a .res file, not COFF -- re-compile with windres
            let windres = "C:/Users/lashman/mingw-w64/mingw64/bin/windres.exe";
            let status = Command::new(windres)
                .args([
--- a/src-tauri/src/config.rs
+++ b/src-tauri/src/config.rs
@@ -3,7 +3,6 @@ use serde::{Deserialize, Serialize};
 use std::fs;
 use std::path::PathBuf;

-/// A custom break activity defined by the user.
 #[derive(Debug, Clone, Serialize, Deserialize)]
 pub struct CustomActivity {
    pub id: String,
@@ -13,7 +12,6 @@ pub struct CustomActivity {
    pub enabled: bool,
 }

-/// A single time range (e.g., 09:00 to 17:00)
 #[derive(Debug, Clone, Serialize, Deserialize)]
 pub struct TimeRange {
    pub start: String, // Format: "HH:MM"
@@ -29,7 +27,6 @@ impl Default for TimeRange {
    }
 }

-/// Schedule for a single day
 #[derive(Debug, Clone, Serialize, Deserialize)]
 pub struct DaySchedule {
    pub enabled: bool,
@@ -46,7 +43,6 @@ impl Default for DaySchedule {
 }

 impl DaySchedule {
-    /// Create a default schedule for weekend days (disabled by default)
    fn weekend_default() -> Self {
        Self {
            enabled: false,
@@ -304,14 +300,13 @@ impl Default for Config {
 }

 impl Config {
-    /// Get the path to the config file (portable: next to the exe)
+    // Portable: next to the exe
    fn config_path() -> Result<PathBuf> {
        let exe_path = std::env::current_exe().context("Failed to determine exe path")?;
        let exe_dir = exe_path.parent().context("Failed to determine exe directory")?;
        Ok(exe_dir.join("config.json"))
    }

-    /// Load configuration from file, or return default if it doesn't exist
    pub fn load_or_default() -> Self {
        match Self::load() {
            Ok(config) => config,
@@ -327,7 +322,6 @@ impl Config {
        }
    }

-    /// Load configuration from file
    pub fn load() -> Result<Self> {
        let config_path = Self::config_path()?;

@@ -345,7 +339,6 @@ impl Config {
        Ok(config.validate())
    }

-    /// Save configuration to file
    pub fn save(&self) -> Result<()> {
        let config_path = Self::config_path()?;

@@ -357,7 +350,6 @@ impl Config {
        Ok(())
    }

-    /// Validate and sanitize configuration values
    pub fn validate(mut self) -> Self {
        // Break duration: 1-60 minutes
        self.break_duration = self.break_duration.clamp(1, 60);
@@ -511,7 +503,6 @@ impl Config {
        self
    }

-    /// Check if a time string is in valid HH:MM format
    fn is_valid_time_format(time: &str) -> bool {
        let parts: Vec<&str> = time.split(':').collect();
        if parts.len() != 2 {
@@ -536,29 +527,24 @@ impl Config {
        hours * 60 + minutes
    }

-    /// Check if a string is a valid hex color (#RRGGBB)
    fn is_valid_hex_color(color: &str) -> bool {
        color.len() == 7
            && color.starts_with('#')
            && color[1..].chars().all(|c| c.is_ascii_hexdigit())
    }

-    /// Get break duration in seconds
    pub fn break_duration_seconds(&self) -> u64 {
        self.break_duration as u64 * 60
    }

-    /// Get break frequency in seconds
    pub fn break_frequency_seconds(&self) -> u64 {
        self.break_frequency as u64 * 60
    }

-    /// Get snooze duration in seconds
    pub fn snooze_duration_seconds(&self) -> u64 {
        self.snooze_duration as u64 * 60
    }

-    /// Reset to default values
    pub fn reset_to_default(&mut self) {
        *self = Self::default();
    }
--- a/src-tauri/src/lib.rs
+++ b/src-tauri/src/lib.rs
@@ -310,7 +310,6 @@ fn save_window_position(

 // ── Dynamic Tray Icon Rendering ────────────────────────────────────────────

-/// Parse a "#RRGGBB" hex color string into (r, g, b). Falls back to fallback on invalid input.
 fn parse_hex_color(hex: &str, fallback: (u8, u8, u8)) -> (u8, u8, u8) {
    if hex.len() == 7 && hex.starts_with('#') {
        let r = u8::from_str_radix(&hex[1..3], 16).unwrap_or(fallback.0);
@@ -322,8 +321,6 @@ fn parse_hex_color(hex: &str, fallback: (u8, u8, u8)) -> (u8, u8, u8) {
    }
 }

-/// Render a 32x32 RGBA icon with a progress arc using the given accent/break colors.
-/// F10: Optionally renders a green checkmark when daily goal is met.
 fn render_tray_icon(
    progress: f64,
    is_break: bool,
@@ -401,33 +398,31 @@ fn update_tray(
    break_color: (u8, u8, u8),
    goal_met: bool,
 ) {
-    // Update tooltip
    let tooltip = match snapshot.state {
        timer::TimerState::Running => {
            if snapshot.deferred_break_pending {
-                "Core Cooldown - Break deferred (fullscreen)".to_string()
+                "Core Cooldown -- Break deferred (fullscreen)".to_string()
            } else {
                let m = snapshot.time_remaining / 60;
                let s = snapshot.time_remaining % 60;
-                format!("Core Cooldown - {:02}:{:02} until break", m, s)
+                format!("Core Cooldown -- {:02}:{:02} until break", m, s)
            }
        }
        timer::TimerState::Paused => {
            if snapshot.idle_paused {
-                "Core Cooldown - Paused (idle)".to_string()
+                "Core Cooldown -- Paused (idle)".to_string()
            } else {
-                "Core Cooldown - Paused".to_string()
+                "Core Cooldown -- Paused".to_string()
            }
        }
        timer::TimerState::BreakActive => {
            let m = snapshot.break_time_remaining / 60;
            let s = snapshot.break_time_remaining % 60;
-            format!("Core Cooldown - Break {:02}:{:02}", m, s)
+            format!("Core Cooldown -- Break {:02}:{:02}", m, s)
        }
    };
    let _ = tray.set_tooltip(Some(&tooltip));

-    // Update icon
    let (progress, is_break, is_paused) = match snapshot.state {
        timer::TimerState::Running => (snapshot.progress, false, false),
        timer::TimerState::Paused => (snapshot.progress, false, true),
@@ -554,7 +549,6 @@ pub fn run() {
                    let break_c = parse_hex_color(&break_hex, (124, 106, 239));
                    update_tray(&tray, &snapshot, accent, break_c, goal_met);

-                    // Emit tick event with full snapshot
                    let _ = handle.emit("timer-tick", &snapshot);

                    // F5: Screen dim window management
@@ -616,7 +610,6 @@ pub fn run() {
                            break_deferred_notified = false;
                        }
                        TickResult::BreakEnded => {
-                            // Restore normal window state and close break window
                            handle_break_end(&handle);
                            // F9: Close multi-monitor overlays
                            close_multi_monitor_overlays(&handle);
@@ -721,7 +714,7 @@ pub fn run() {
                                        .notification()
                                        .builder()
                                        .title("Break deferred")
-                                        .body("Fullscreen app detected - break will start when you exit.")
+                                        .body("Fullscreen app detected -- break will start when you exit.")
                                        .show();
                                }
                                let _ = handle.emit("break-deferred", &());
@@ -883,7 +876,6 @@ fn close_break_window(app: &AppHandle) {
    }
 }

-/// Handle break start: either fullscreen on main window, or open a separate modal break window.
 fn handle_break_start(app: &AppHandle, fullscreen_mode: bool) {
    if fullscreen_mode {
        // Fullscreen: show break inside the main window
@@ -899,7 +891,6 @@ fn handle_break_start(app: &AppHandle, fullscreen_mode: bool) {
    }
 }

-/// Handle break end: restore main window state and close break window if open.
 fn handle_break_end(app: &AppHandle) {
    if let Some(window) = app.get_webview_window("main") {
        let _ = window.set_always_on_top(false);
--- a/src-tauri/src/msvc_compat.rs
+++ b/src-tauri/src/msvc_compat.rs
@@ -9,7 +9,7 @@ use std::sync::atomic::{AtomicI32, Ordering};
 // ── MSVC Buffer Security Check (/GS) ────────────────────────────────────────
 //
 // MSVC's /GS flag instruments functions with stack canaries. These two symbols
-// implement the canary check. The cookie value is arbitrary - real MSVC CRT
+// implement the canary check. The cookie value is arbitrary -- real MSVC CRT
 // randomises it at startup, but for a statically-linked helper library this
 // fixed sentinel is sufficient.

@@ -44,15 +44,15 @@ pub unsafe extern "C" fn _Init_thread_header(guard: *mut i32) {
    loop {
        let val = guard.read_volatile();
        if val == 0 {
-            // Already initialised - tell caller to skip
+            // Already initialised -- tell caller to skip
            return;
        }
        if val == -1 {
-            // Not yet initialised - try to claim it
+            // Not yet initialised -- try to claim it
            guard.write_volatile(1);
            return;
        }
-        // val == 1: another thread is initialising - yield and retry
+        // val == 1: another thread is initialising -- yield and retry
        std::thread::yield_now();
    }
 }
@@ -71,22 +71,22 @@ pub unsafe extern "C" fn _Init_thread_footer(guard: *mut i32) {
 // MinGW's libstdc++ exports the same operators but with GCC/Itanium mangling,
 // so the linker can't match them. We provide the MSVC-mangled versions here.

-/// `std::nothrow` - MSVC-mangled `?nothrow@std@@3Unothrow_t@1@B`
+/// `std::nothrow` -- MSVC-mangled `?nothrow@std@@3Unothrow_t@1@B`
 /// An empty struct constant used as a tag for nothrow `new`.
 #[export_name = "?nothrow@std@@3Unothrow_t@1@B"]
 pub static MSVC_STD_NOTHROW: u8 = 0;

-/// `operator new(size_t, const std::nothrow_t&)` - nothrow allocation
+/// `operator new(size_t, const std::nothrow_t&)` -- nothrow allocation
 /// MSVC-mangled: `??2@YAPEAX_KAEBUnothrow_t@std@@@Z`
 #[export_name = "??2@YAPEAX_KAEBUnothrow_t@std@@@Z"]
 pub unsafe extern "C" fn msvc_operator_new_nothrow(size: usize, _nothrow: *const u8) -> *mut u8 {
    let size = if size == 0 { 1 } else { size };
    let layout = std::alloc::Layout::from_size_align_unchecked(size, 8);
    let ptr = std::alloc::alloc(layout);
-    ptr // null on failure - nothrow semantics
+    ptr // null on failure -- nothrow semantics
 }

-/// `operator delete(void*, size_t)` - sized deallocation
+/// `operator delete(void*, size_t)` -- sized deallocation
 /// MSVC-mangled: `??3@YAXPEAX_K@Z`
 #[export_name = "??3@YAXPEAX_K@Z"]
 pub unsafe extern "C" fn msvc_operator_delete_sized(ptr: *mut u8, size: usize) {
--- a/src-tauri/src/stats.rs
+++ b/src-tauri/src/stats.rs
@@ -3,7 +3,6 @@ use std::collections::HashMap;
 use std::fs;
 use std::path::PathBuf;

-/// A single day's break statistics.
 #[derive(Debug, Clone, Serialize, Deserialize, Default)]
 #[serde(rename_all = "camelCase")]
 pub struct DayRecord {
@@ -16,7 +15,6 @@ pub struct DayRecord {
    pub natural_break_time_secs: u64,
 }

-/// Persistent stats stored as JSON.
 #[derive(Debug, Clone, Serialize, Deserialize, Default)]
 pub struct StatsData {
    pub days: HashMap<String, DayRecord>,
@@ -24,12 +22,10 @@ pub struct StatsData {
    pub best_streak: u32,
 }

-/// Runtime stats manager.
 pub struct Stats {
    pub data: StatsData,
 }

-/// Snapshot sent to the frontend.
 #[derive(Debug, Clone, Serialize)]
 #[serde(rename_all = "camelCase")]
 pub struct StatsSnapshot {
@@ -47,13 +43,11 @@ pub struct StatsSnapshot {
    pub daily_goal_met: bool,
 }

-/// F10: Result of recording a completed break
 pub struct BreakCompletedResult {
    pub milestone_reached: Option<u32>,
    pub daily_goal_just_met: bool,
 }

-/// F7: Weekly summary for reports
 #[derive(Debug, Clone, Serialize)]
 #[serde(rename_all = "camelCase")]
 pub struct WeekSummary {
@@ -68,7 +62,7 @@ pub struct WeekSummary {
 const MILESTONES: &[u32] = &[3, 5, 7, 14, 21, 30, 50, 100, 365];

 impl Stats {
-    /// Portable: stats file lives next to the exe
+    // Portable: next to the exe
    fn stats_path() -> Option<PathBuf> {
        let exe_path = std::env::current_exe().ok()?;
        let exe_dir = exe_path.parent()?;
@@ -114,7 +108,6 @@ impl Stats {
            })
    }

-    /// Record a completed break. Returns milestone/goal info for gamification.
    pub fn record_break_completed(&mut self, duration_secs: u64, daily_goal: u32) -> BreakCompletedResult {
        let day = self.today_mut();
        let was_below_goal = day.breaks_completed < daily_goal;
@@ -182,7 +175,6 @@ impl Stats {
        }
    }

-    /// F10: Check if current streak exactly matches a milestone
    fn check_milestone(&self) -> Option<u32> {
        let streak = self.data.current_streak;
        if MILESTONES.contains(&streak) {
@@ -225,7 +217,6 @@ impl Stats {
        }
    }

-    /// Get recent N days of history, sorted chronologically.
    pub fn recent_days(&self, n: u32) -> Vec<DayRecord> {
        let today = chrono::Local::now().date_naive();
        let mut records = Vec::new();
@@ -243,7 +234,6 @@ impl Stats {
        records
    }

-    /// F7: Get weekly summaries for the past N weeks
    pub fn weekly_summary(&self, weeks: u32) -> Vec<WeekSummary> {
        let today = chrono::Local::now().date_naive();
        let mut summaries = Vec::new();
--- a/src-tauri/src/timer.rs
+++ b/src-tauri/src/timer.rs
@@ -26,7 +26,6 @@ pub enum AppView {
    Stats,
 }

-/// Snapshot of the full timer state, sent to the frontend on every tick
 #[derive(Debug, Clone, Serialize)]
 #[serde(rename_all = "camelCase")]
 pub struct TimerSnapshot {
@@ -74,7 +73,6 @@ pub struct TimerSnapshot {
    pub is_long_break: bool,
 }

-/// Events emitted by the timer to the frontend
 #[derive(Debug, Clone, Serialize)]
 #[serde(rename_all = "camelCase")]
 pub struct BreakStartedPayload {
@@ -161,8 +159,6 @@ impl TimerManager {
        }
    }

-    /// Check idle state and auto-pause/resume accordingly.
-    /// Returns IdleCheckResult indicating what happened.
    pub fn check_idle(&mut self) -> IdleCheckResult {
        if !self.config.idle_detection_enabled {
            // If idle detection disabled but we were idle-paused, resume
@@ -218,7 +214,6 @@ impl TimerManager {
        }
    }

-    /// F2: Check if the foreground window is fullscreen (presentation mode)
    pub fn check_presentation_mode(&mut self) -> bool {
        if !self.config.presentation_mode_enabled {
            self.presentation_mode_active = false;
@@ -230,7 +225,6 @@ impl TimerManager {
        fs
    }

-    /// Called every second. Returns what events should be emitted.
    pub fn tick(&mut self) -> TickResult {
        // Idle detection and natural break detection
        let idle_result = self.check_idle();
@@ -322,7 +316,6 @@ impl TimerManager {
        }
    }

-    /// F1: Called every second for microbreak logic. Returns microbreak events.
    pub fn tick_microbreak(&mut self) -> MicrobreakTickResult {
        if !self.config.microbreak_enabled {
            return MicrobreakTickResult::None;
@@ -416,7 +409,6 @@ impl TimerManager {
        self.snoozes_used = 0;
    }

-    /// F3: Advance the Pomodoro cycle position after a break completes
    fn advance_pomodoro_cycle(&mut self) {
        if !self.config.pomodoro_enabled {
            return;
@@ -472,14 +464,14 @@ impl TimerManager {
        let past_half = total > 0 && elapsed * 2 >= total;

        if past_half && self.config.allow_end_early {
-            // "End break" - counts as completed
+            // "End break" -- counts as completed
            self.has_had_break = true;
            self.seconds_since_last_break = 0;
            self.advance_pomodoro_cycle();
            self.reset_timer();
            true
        } else if !past_half {
-            // "Cancel break" - doesn't count
+            // "Cancel break" -- doesn't count
            // F3: Pomodoro reset-on-skip
            if self.config.pomodoro_enabled && self.config.pomodoro_reset_on_skip {
                self.pomodoro_cycle_position = 0;
@@ -672,14 +664,12 @@ pub enum TickResult {
    BreakDeferred, // F2
 }

-/// F1: Microbreak tick result
 pub enum MicrobreakTickResult {
    None,
    MicrobreakStarted,
    MicrobreakEnded,
 }

-/// Result of checking idle state
 pub enum IdleCheckResult {
    None,
    JustPaused,
@@ -687,7 +677,6 @@ pub enum IdleCheckResult {
    NaturalBreakDetected(u64), // duration in seconds
 }

-/// Returns the number of seconds since last user input (mouse/keyboard).
 #[cfg(windows)]
 pub fn get_idle_seconds() -> u64 {
    use std::mem;
@@ -712,7 +701,6 @@ pub fn get_idle_seconds() -> u64 {
    0
 }

-/// F2: Check if the foreground window is a fullscreen application
 #[cfg(windows)]
 pub fn is_foreground_fullscreen() -> bool {
    use std::mem;
@@ -756,7 +744,6 @@ pub fn is_foreground_fullscreen() -> bool {
    false
 }

-/// F9: Get all monitor rects for multi-monitor break enforcement
 #[cfg(windows)]
 pub fn get_all_monitors() -> Vec<MonitorInfo> {
    use winapi::shared::windef::{HMONITOR, HDC, LPRECT};
--- a/src/App.svelte
+++ b/src/App.svelte
@@ -62,7 +62,7 @@
    return () => mq.removeEventListener("change", handler);
  });

-  // Transition parameters - zero when reduced motion active
+  // Transition parameters -- zero when reduced motion active
  const DURATION = $derived(reducedMotion ? 0 : 700);
  const easing = cubicOut;

@@ -83,7 +83,7 @@
      settings: "Settings",
      stats: "Statistics",
    };
-    document.title = `Core Cooldown - ${viewNames[effectiveView] ?? "Dashboard"}`;
+    document.title = `Core Cooldown -- ${viewNames[effectiveView] ?? "Dashboard"}`;
  });

  // When fullscreen_mode is OFF, the separate break window handles breaks,
--- a/src/lib/components/BreakScreen.svelte
+++ b/src/lib/components/BreakScreen.svelte
@@ -483,7 +483,7 @@
    background: rgba(255, 255, 255, 0.03);
  }

-  /* Ripple container - sits behind the ring, overflows the card */
+  /* Ripple container -- sits behind the ring, overflows the card */
  .ripple-container {
    position: absolute;
    inset: 0;
--- a/src/lib/components/ColorPicker.svelte
+++ b/src/lib/components/ColorPicker.svelte
@@ -259,7 +259,7 @@
      </button>
    {/each}

-    <!-- Custom toggle swatch - ring shows when picker open OR value is custom -->
+    <!-- Custom toggle swatch -- ring shows when picker open OR value is custom -->
    <button
      type="button"
      class="group flex items-center justify-center min-h-[44px] min-w-[44px] bg-transparent border-none p-0"
@@ -277,7 +277,7 @@
    </button>
  </div>

-  <!-- Inline custom picker - slides open/closed -->
+  <!-- Inline custom picker -- slides open/closed -->
  {#if showCustom}
    <div
      class="flex flex-col gap-3 rounded-xl bg-[#0f0f0f] p-3 border border-[#1a1a1a]"
--- a/src/lib/components/Dashboard.svelte
+++ b/src/lib/components/Dashboard.svelte
@@ -104,7 +104,7 @@

  // Gap between ring and button, compensating for CSS transform phantom space.
  // transform: scale() doesn't affect layout, so the 280px box stays full-size
-  // even when visually shrunk - creating phantom space below the visual ring.
+  // even when visually shrunk -- creating phantom space below the visual ring.
  const ringSize = 280;
  const phantomBelow = $derived((ringSize * (1 - ringScale)) / 2);
  const targetGap = $derived(Math.max(16, Math.round((windowH - 400) * 0.05 + 16)));
--- a/src/lib/components/MicrobreakOverlay.svelte
+++ b/src/lib/components/MicrobreakOverlay.svelte
@@ -45,7 +45,7 @@
      <path d="M2.036 12.322a1.012 1.012 0 0 1 0-.639C3.423 7.51 7.36 4.5 12 4.5c4.638 0 8.573 3.007 9.963 7.178.07.207.07.431 0 .639C20.577 16.49 16.64 19.5 12 19.5c-4.638 0-8.573-3.007-9.963-7.178Z"/>
      <circle cx="12" cy="12" r="3"/>
    </svg>
-    <span id="microbreak-msg" class="text-[15px] font-medium text-white">Look away - 20 feet for {timeRemaining}s</span>
+    <span id="microbreak-msg" class="text-[15px] font-medium text-white">Look away -- 20 feet for {timeRemaining}s</span>
  </div>

  {#if activity && $config.microbreak_show_activity}
--- a/src/lib/components/StatsView.svelte
+++ b/src/lib/components/StatsView.svelte
@@ -88,7 +88,7 @@
    return milestones.find((m) => m > current) ?? null;
  });

-  // Chart rendering - 7-day
+  // Chart rendering -- 7-day
  let chartCanvas: HTMLCanvasElement | undefined = $state();

  $effect(() => {
@@ -96,7 +96,7 @@
    drawChart(chartCanvas, history);
  });

-  // Chart rendering - 30-day
+  // Chart rendering -- 30-day
  let monthChartCanvas: HTMLCanvasElement | undefined = $state();

  $effect(() => {
@@ -154,7 +154,7 @@
        ctx.fill();
      }

-      // Day label - show every Nth for 30-day
+      // Day label -- show every Nth for 30-day
      if (data.length <= 7 || i % 5 === 0) {
        ctx.fillStyle = "#a8a8a8";
        ctx.font = "10px -apple-system, sans-serif";
--- a/src/lib/components/TimeSpinner.svelte
+++ b/src/lib/components/TimeSpinner.svelte
@@ -7,7 +7,7 @@

  let { value, onchange, countdownFont = "" }: Props = $props();

-  // Local display values - driven by prop normally, overridden during drag/momentum
+  // Local display values -- driven by prop normally, overridden during drag/momentum
  let displayHours = $state(0);
  let displayMinutes = $state(0);
  let isAnimating = $state(false); // true during drag OR momentum
@@ -373,7 +373,7 @@
    border-color: rgba(255, 255, 255, 0.18);
  }

-  /* Perspective container - looking into the cylinder from outside */
+  /* Perspective container -- looking into the cylinder from outside */
  .wheel-viewport {
    width: 100%;
    height: 100%;
--- a/src/lib/components/TimerRing.svelte
+++ b/src/lib/components/TimerRing.svelte
@@ -55,7 +55,7 @@
  aria-label={label}
  aria-valuetext={valueText}
 >
-  <!-- Glow SVG - drawn larger than the container so blur isn't clipped -->
+  <!-- Glow SVG -- drawn larger than the container so blur isn't clipped -->
  <svg
    aria-hidden="true"
    width={viewSize}
@@ -145,7 +145,7 @@
    {/if}
  </svg>

-  <!-- Non-glow SVG - exact size, draws the track + crisp ring -->
+  <!-- Non-glow SVG -- exact size, draws the track + crisp ring -->
  <svg
    aria-hidden="true"
    width={size}
--- a/src/lib/components/Titlebar.svelte
+++ b/src/lib/components/Titlebar.svelte
@@ -9,7 +9,7 @@
  data-tauri-drag-region
  class="group absolute top-0 left-0 right-0 z-50 flex h-10 items-center justify-end pr-3.5 select-none"
 >
-  <!-- Centered app name (decorative - OS window title handles screen readers) -->
+  <!-- Centered app name (decorative -- OS window title handles screen readers) -->
  <span
    aria-hidden="true"
    class="pointer-events-none absolute inset-0 flex items-center justify-center
@@ -61,7 +61,7 @@
      </span>
    </button>

-    <!-- Close (red) - rightmost -->
+    <!-- Close (red) -- rightmost -->
    <button
      aria-label="Close"
      class="group/btn relative flex h-[44px] w-[44px] items-center justify-center"
--- a/src/lib/utils/activities.ts
+++ b/src/lib/utils/activities.ts
@@ -8,9 +8,9 @@ export const breakActivities: BreakActivity[] = [
  { category: "eyes", text: "Look at something 20 feet away for 20 seconds" },
  { category: "eyes", text: "Close your eyes and gently press your palms over them" },
  { category: "eyes", text: "Slowly roll your eyes in circles, 5 times each direction" },
-  { category: "eyes", text: "Focus on a distant object, then a near one — repeat 5 times" },
+  { category: "eyes", text: "Focus on a distant object, then a near one -- repeat 5 times" },
  { category: "eyes", text: "Blink rapidly 20 times to refresh your eyes" },
-  { category: "eyes", text: "Look up, down, left, right — hold each for 2 seconds" },
+  { category: "eyes", text: "Look up, down, left, right -- hold each for 2 seconds" },
  { category: "eyes", text: "Cup your hands over closed eyes and breathe deeply" },
  { category: "eyes", text: "Trace a figure-8 with your eyes, slowly" },
  { category: "eyes", text: "Look out the nearest window and find the farthest point" },
@@ -19,9 +19,9 @@ export const breakActivities: BreakActivity[] = [
  { category: "eyes", text: "Warm your palms by rubbing them together, then rest them over closed eyes" },
  { category: "eyes", text: "Slowly shift your gaze along the horizon line outside" },
  { category: "eyes", text: "Focus on the tip of your nose for 5 seconds, then a far wall" },
-  { category: "eyes", text: "Look at something green — plants reduce eye strain naturally" },
+  { category: "eyes", text: "Look at something green -- plants reduce eye strain naturally" },
  { category: "eyes", text: "Close your eyes and gently press your eyebrows outward from center" },
-  { category: "eyes", text: "Squeeze your eyes shut for 3 seconds, then open wide — repeat 5 times" },
+  { category: "eyes", text: "Squeeze your eyes shut for 3 seconds, then open wide -- repeat 5 times" },
  { category: "eyes", text: "Trace the outline of a window frame with your eyes, slowly" },

  // Stretches
@@ -35,7 +35,7 @@ export const breakActivities: BreakActivity[] = [
  { category: "stretch", text: "Drop your chin to your chest and slowly roll your neck" },
  { category: "stretch", text: "Extend each arm across your chest, hold for 15 seconds" },
  { category: "stretch", text: "Open and close your hands, spreading fingers wide" },
-  { category: "stretch", text: "Place your right hand on your left knee and twist gently — switch sides" },
+  { category: "stretch", text: "Place your right hand on your left knee and twist gently -- switch sides" },
  { category: "stretch", text: "Reach one arm overhead and lean to the opposite side, hold 10 seconds each" },
  { category: "stretch", text: "Interlace your fingers and flip your palms to the ceiling, push up" },
  { category: "stretch", text: "Pull each finger gently backward for 3 seconds to stretch your forearms" },
@@ -46,20 +46,20 @@ export const breakActivities: BreakActivity[] = [

  // Breathing
  { category: "breathing", text: "Inhale for 4 seconds, hold for 4, exhale for 6" },
-  { category: "breathing", text: "Take 5 deep belly breaths — feel your diaphragm expand" },
+  { category: "breathing", text: "Take 5 deep belly breaths -- feel your diaphragm expand" },
  { category: "breathing", text: "Box breathing: inhale 4s, hold 4s, exhale 4s, hold 4s" },
-  { category: "breathing", text: "Breathe in through your nose, out through your mouth — 5 times" },
+  { category: "breathing", text: "Breathe in through your nose, out through your mouth -- 5 times" },
  { category: "breathing", text: "Sigh deeply 3 times to release tension" },
  { category: "breathing", text: "Place a hand on your chest and breathe so only your belly moves" },
  { category: "breathing", text: "Alternate nostril breathing: 3 cycles each side" },
  { category: "breathing", text: "Exhale completely, then take the deepest breath you can" },
  { category: "breathing", text: "Count your breaths backward from 10 to 1" },
-  { category: "breathing", text: "Breathe in calm, breathe out tension — 5 rounds" },
+  { category: "breathing", text: "Breathe in calm, breathe out tension -- 5 rounds" },
  { category: "breathing", text: "4-7-8 breathing: inhale 4s, hold 7s, exhale slowly for 8s" },
  { category: "breathing", text: "Take 3 breaths making your exhale twice as long as your inhale" },
-  { category: "breathing", text: "Breathe in for 2 counts, out for 2 — gradually increase to 6 each" },
-  { category: "breathing", text: "Hum gently on each exhale for 5 breaths — feel the vibration in your chest" },
-  { category: "breathing", text: "Imagine breathing in cool blue air and exhaling warm red air — 5 rounds" },
+  { category: "breathing", text: "Breathe in for 2 counts, out for 2 -- gradually increase to 6 each" },
+  { category: "breathing", text: "Hum gently on each exhale for 5 breaths -- feel the vibration in your chest" },
+  { category: "breathing", text: "Imagine breathing in cool blue air and exhaling warm red air -- 5 rounds" },
  { category: "breathing", text: "Place both hands on your ribs and breathe so you feel them expand sideways" },
  { category: "breathing", text: "Breathe in through pursed lips slowly, then exhale in a long, steady stream" },

@@ -75,11 +75,11 @@ export const breakActivities: BreakActivity[] = [
  { category: "movement", text: "Shake out your hands and arms for 10 seconds" },
  { category: "movement", text: "Stand up, touch your toes, and slowly rise" },
  { category: "movement", text: "Walk to the farthest room in your home and back" },
-  { category: "movement", text: "Do 5 wall push-ups — hands on the wall, lean in and push back" },
+  { category: "movement", text: "Do 5 wall push-ups -- hands on the wall, lean in and push back" },
  { category: "movement", text: "Stand up and slowly shift your weight side to side for 20 seconds" },
  { category: "movement", text: "Walk in a small circle, paying attention to each footstep" },
-  { category: "movement", text: "Rise onto your tiptoes, hold for 5 seconds, lower slowly — repeat 5 times" },
-  { category: "movement", text: "Do a gentle standing forward fold — let your arms hang loose" },
+  { category: "movement", text: "Rise onto your tiptoes, hold for 5 seconds, lower slowly -- repeat 5 times" },
+  { category: "movement", text: "Do a gentle standing forward fold -- let your arms hang loose" },
  { category: "movement", text: "Step away from your desk and do 10 hip circles in each direction" },
  { category: "movement", text: "Stand with your back against a wall and slide down into a gentle wall sit for 15 seconds" },
 ];
--- a/src/lib/utils/animate.ts
+++ b/src/lib/utils/animate.ts
@@ -1,6 +1,6 @@
 import { animate } from "motion";

-// Module-level reduced motion query — shared across all actions
+// Module-level reduced motion query -- shared across all actions
 const reducedMotionQuery =
  typeof window !== "undefined"
    ? window.matchMedia("(prefers-reduced-motion: reduce)")
@@ -10,9 +10,6 @@ function prefersReducedMotion(): boolean {
  return reducedMotionQuery?.matches ?? false;
 }

-/**
- * Svelte action: fade in + slide up on mount
- */
 export function fadeIn(
  node: HTMLElement,
  options?: { duration?: number; delay?: number; y?: number },
@@ -38,9 +35,6 @@ export function fadeIn(
  };
 }

-/**
- * Svelte action: scale in + fade on mount
- */
 export function scaleIn(
  node: HTMLElement,
  options?: { duration?: number; delay?: number },
@@ -66,9 +60,6 @@ export function scaleIn(
  };
 }

-/**
- * Svelte action: animate when scrolled into view (IntersectionObserver)
- */
 export function inView(
  node: HTMLElement,
  options?: { delay?: number; y?: number; threshold?: number },
@@ -111,9 +102,6 @@ export function inView(
  };
 }

-/**
- * Svelte action: spring-scale press feedback on buttons
- */
 export function pressable(node: HTMLElement) {
  if (prefersReducedMotion()) {
    return { destroy() {} };
@@ -171,14 +159,7 @@ export function pressable(node: HTMLElement) {
  };
 }

-/**
- * Svelte action: animated glow band on hover.
- * Creates a crisp ring "band" plus a soft atmospheric glow.
- * Pass a hex color (e.g. "#ff4d00").
- *
- * Uses same-hue zero-alpha as the "off" state so the Web Animations API
- * interpolates through the correct color channel instead of through black.
- */
+// Animated glow band on hover. Pass a hex color (e.g. "#ff4d00").
 export function glowHover(
  node: HTMLElement,
  options?: { color?: string },
@@ -236,14 +217,7 @@ export function glowHover(
  };
 }

-/**
- * Svelte action: momentum-based grab-and-drag scrolling
- * with elastic overscroll and spring-back at boundaries.
- *
- * IMPORTANT: The node must have exactly one child element (a wrapper div).
- * Overscroll transforms are applied to that child, NOT to the scroll
- * container itself (which would break overflow clipping).
- */
+// Momentum grab-and-drag scrolling. Node must have exactly one child wrapper div.
 export function dragScroll(node: HTMLElement) {
  if (prefersReducedMotion()) {
    // Allow normal scrolling without the momentum/elastic physics
@@ -293,7 +267,7 @@ export function dragScroll(node: HTMLElement) {
    // Ensure DOM is clean after animation completes
    springAnim.finished.then(() => {
      if (content) content.style.transform = "";
-    }).catch(() => { /* cancelled — onDown handles cleanup */ });
+    }).catch(() => { /* cancelled -- onDown handles cleanup */ });
  }

  function forceReset() {
@@ -370,7 +344,7 @@ export function dragScroll(node: HTMLElement) {
    // Time-based exponential decay (iOS-style scroll physics).
    // position(t) = start + v0 * tau * (1 - e^(-t/tau))
    // velocity(t) = v0 * e^(-t/tau)   → naturally asymptotes to zero
-    const tau = 325; // time constant in ms — iOS UIScrollView feel
+    const tau = 325; // time constant in ms -- iOS UIScrollView feel
    const coastStart = performance.now();
    const scrollStart2 = node.scrollTop;
    const totalDist = v0 * tau;
--- a/src/lib/utils/sounds.ts
+++ b/src/lib/utils/sounds.ts
@@ -1,8 +1,3 @@
-/**
- * Synthesized notification sounds using the Web Audio API.
- * No external audio files needed — all sounds are generated programmatically.
- */
-
 let audioCtx: AudioContext | null = null;

 function getAudioContext(): AudioContext {
@@ -14,11 +9,6 @@ function getAudioContext(): AudioContext {

 type SoundPreset = "bell" | "chime" | "soft" | "digital" | "harp" | "bowl" | "rain" | "whistle";

-/**
- * Play a notification sound with the given preset and volume.
- * @param preset - One of: "bell", "chime", "soft", "digital"
- * @param volume - 0 to 100
- */
 export function playSound(preset: SoundPreset, volume: number): void {
  const ctx = getAudioContext();
  const gain = ctx.createGain();
@@ -53,7 +43,7 @@ export function playSound(preset: SoundPreset, volume: number): void {
  }
 }

-/** Warm bell — two sine tones with harmonics and slow decay */
+/** Warm bell -- two sine tones with harmonics and slow decay */
 function playBell(ctx: AudioContext, destination: GainNode, vol: number) {
  const now = ctx.currentTime;

@@ -103,7 +93,7 @@ function playChime(ctx: AudioContext, destination: GainNode, vol: number) {
  });
 }

-/** Gentle soft ping — filtered triangle wave */
+/** Gentle soft ping -- filtered triangle wave */
 function playSoft(ctx: AudioContext, destination: GainNode, vol: number) {
  const now = ctx.currentTime;

@@ -129,7 +119,7 @@ function playSoft(ctx: AudioContext, destination: GainNode, vol: number) {
  osc.stop(now + 1.2);
 }

-/** Digital blip — short square wave burst */
+/** Digital blip -- short square wave burst */
 function playDigital(ctx: AudioContext, destination: GainNode, vol: number) {
  const now = ctx.currentTime;

@@ -149,7 +139,7 @@ function playDigital(ctx: AudioContext, destination: GainNode, vol: number) {
  }
 }

-/** Harp — cascading arpeggiated sine tones (C5-E5-G5-C6) */
+/** Harp -- cascading arpeggiated sine tones (C5-E5-G5-C6) */
 function playHarp(ctx: AudioContext, destination: GainNode, vol: number) {
  const now = ctx.currentTime;
  const notes = [523.25, 659.25, 783.99, 1046.5]; // C5, E5, G5, C6
@@ -170,7 +160,7 @@ function playHarp(ctx: AudioContext, destination: GainNode, vol: number) {
  });
 }

-/** Singing bowl — low sine with slow beating from detuned pair */
+/** Singing bowl -- low sine with slow beating from detuned pair */
 function playBowl(ctx: AudioContext, destination: GainNode, vol: number) {
  const now = ctx.currentTime;

@@ -201,7 +191,7 @@ function playBowl(ctx: AudioContext, destination: GainNode, vol: number) {
  osc3.stop(now + 1.5);
 }

-/** Rain — filtered noise burst with gentle decay */
+/** Rain -- filtered noise burst with gentle decay */
 function playRain(ctx: AudioContext, destination: GainNode, vol: number) {
  const now = ctx.currentTime;
  const bufferSize = ctx.sampleRate * 1;
@@ -233,7 +223,7 @@ function playRain(ctx: AudioContext, destination: GainNode, vol: number) {
  noise.stop(now + 1.0);
 }

-/** Whistle — gentle two-note sine glide */
+/** Whistle -- gentle two-note sine glide */
 function playWhistle(ctx: AudioContext, destination: GainNode, vol: number) {
  const now = ctx.currentTime;

@@ -256,7 +246,6 @@ function playWhistle(ctx: AudioContext, destination: GainNode, vol: number) {
  osc.stop(now + 1.0);
 }

-/** Play a completion sound — slightly different from start (descending) */
 export function playBreakEndSound(preset: SoundPreset, volume: number): void {
  const ctx = getAudioContext();
  const gain = ctx.createGain();