eye-care 1.0.0

package/src/main/index.ts

@@ -0,0 +1,233 @@
+import { app, BrowserWindow, ipcMain, Tray, Menu, nativeImage, shell, BrowserWindowConstructorOptions } from "electron";
+import * as path from "path";
+import * as fs from "fs";
+import { Preferences, DEFAULT_PREFERENCES, BreakType, BreakPlan, Language, BackgroundConfig } from "../shared/types";
+import { exercisesForBreak } from "../data/exercises";
+import { t, TranslationKey } from "../data/i18n";
+import { loadPreferences, savePreferences } from "./preferences";
+import { Scheduler } from "./scheduler";
+import { registerBackgroundIpc, resolveBackgroundPath, pickRandomBackground } from "./backgrounds";
+
+let tray: Tray | null = null;
+let breakWindow: BrowserWindow | null = null;
+let settingsWindow: BrowserWindow | null = null;
+let scheduler: Scheduler | null = null;
+let preferences: Preferences = { ...DEFAULT_PREFERENCES };
+
+function windowOptionsForOverlay(): BrowserWindowConstructorOptions {
+  return {
+    width: 600,
+    height: 400,
+    fullscreen: true,
+    alwaysOnTop: true,
+    frame: false,
+    movable: false,
+    resizable: false,
+    skipTaskbar: true,
+    show: false,
+    backgroundColor: "#0b1020",
+    webPreferences: {
+      preload: path.join(__dirname, "..", "preload", "break.js"),
+      contextIsolation: true,
+      nodeIntegration: false,
+      sandbox: false,
+    },
+  };
+}
+
+function showBreakWindow(plan: BreakPlan): void {
+  if (breakWindow && !breakWindow.isDestroyed()) {
+    breakWindow.close();
+  }
+  breakWindow = new BrowserWindow(windowOptionsForOverlay());
+  breakWindow.loadFile(path.join(__dirname, "..", "renderer", "break.html"));
+  breakWindow.once("ready-to-show", () => {
+    breakWindow?.webContents.send("break:start", plan);
+    breakWindow?.show();
+  });
+  breakWindow.on("closed", () => {
+    breakWindow = null;
+    scheduler?.resumeAfterBreak();
+  });
+}
+
+function buildBreakPlan(type: BreakType): BreakPlan {
+  const duration =
+    type === "mini"
+      ? preferences.miniBreakDurationSeconds
+      : preferences.longBreakDurationSeconds;
+  let bgData: { mime: string; base64: string } | null = null;
+  if (preferences.background.mode !== "none") {
+    let file: string | null = null;
+    if (preferences.background.mode === "random") {
+      const pool = preferences.background.randomPool || "all";
+      file = pickRandomBackground(pool);
+    } else {
+      file = resolveBackgroundPath(preferences.background.selected, preferences.background.mode);
+    }
+    if (file) {
+      try {
+        const buf = fs.readFileSync(file);
+        const ext = path.extname(file).slice(1).toLowerCase();
+        const mime = ext === "svg" ? "image/svg+xml" : "image/" + ext;
+        bgData = { mime, base64: buf.toString("base64") };
+      } catch (err) {
+        console.error("Failed to read background:", err);
+      }
+    }
+  }
+  return {
+    type,
+    totalDurationSeconds: duration,
+    language: preferences.language,
+    soundEnabled: preferences.soundEnabled,
+    background: bgData ? { ...bgData, blurStrength: preferences.background.blurStrength ?? 3 } : null,
+    exercises: exercisesForBreak(type, duration),
+  };
+}
+
+function showSettingsWindow(): void {
+  if (settingsWindow && !settingsWindow.isDestroyed()) {
+    settingsWindow.focus();
+    return;
+  }
+  settingsWindow = new BrowserWindow({
+    width: 520,
+    height: 640,
+    title: "eye-care — Settings",
+    resizable: false,
+    backgroundColor: "#f7f8fa",
+    webPreferences: {
+      preload: path.join(__dirname, "..", "preload", "settings.js"),
+      contextIsolation: true,
+      nodeIntegration: false,
+      sandbox: false,
+    },
+  });
+  settingsWindow.loadFile(path.join(__dirname, "..", "renderer", "settings.html"));
+  settingsWindow.on("closed", () => {
+    settingsWindow = null;
+  });
+}
+
+function buildTrayMenu(): Menu {
+  const lang = preferences.language;
+  const tt = (k: TranslationKey) => t(lang, k);
+  const nextLabel = scheduler?.nextBreakLabel(lang) ?? tt("noBreakScheduled");
+  return Menu.buildFromTemplate([
+    { label: tt("appTitle"), enabled: false },
+    { type: "separator" },
+    { label: nextLabel, enabled: false },
+    { type: "separator" },
+    {
+      label: tt("trayTakeMiniNow"),
+      click: () => scheduler?.triggerNow("mini"),
+    },
+    {
+      label: tt("trayTakeLongNow"),
+      click: () => scheduler?.triggerNow("long"),
+    },
+    { type: "separator" },
+    {
+      label: tt("trayPause1Hour"),
+      click: () => scheduler?.pauseFor(60 * 60 * 1000),
+    },
+    {
+      label: tt("trayResume"),
+      click: () => scheduler?.resume(),
+    },
+    { type: "separator" },
+    {
+      label: tt("traySettings"),
+      click: () => showSettingsWindow(),
+    },
+    {
+      label: tt("trayAbout"),
+      click: () => {
+        shell.openExternal("https://github.com/uptodatelabs/eye-care");
+      },
+    },
+    { type: "separator" },
+    {
+      label: tt("trayQuit"),
+      click: () => app.quit(),
+    },
+  ]);
+}
+
+function updateTrayMenu(): void {
+  if (tray) tray.setContextMenu(buildTrayMenu());
+}
+
+function createTray(): void {
+  const iconPath = path.join(__dirname, "..", "..", "build", "tray.png");
+  let icon = nativeImage.createEmpty();
+  if (fs.existsSync(iconPath)) {
+    icon = nativeImage.createFromPath(iconPath);
+    if (process.platform === "darwin") {
+      icon.setTemplateImage(true);
+    }
+  }
+  tray = new Tray(icon);
+  tray.setToolTip("eye-care");
+  tray.on("double-click", () => showSettingsWindow());
+  updateTrayMenu();
+}
+
+function registerIpc(): void {
+  ipcMain.handle("prefs:get", () => preferences);
+  ipcMain.handle("prefs:update", (_e, next: Partial<Preferences>) => {
+    preferences = { ...preferences, ...next };
+    savePreferences(preferences);
+    scheduler?.applyPreferences(preferences);
+    updateTrayMenu();
+    return preferences;
+  });
+  ipcMain.handle("app:info", () => {
+    return {
+      version: app.getVersion(),
+      author: "uptodatelabs",
+      name: "eye-care",
+      homepage: "https://github.com/uptodatelabs/eye-care",
+    };
+  });
+  ipcMain.handle("break:skip", () => {
+    if (breakWindow && !breakWindow.isDestroyed()) breakWindow.close();
+  });
+  ipcMain.handle("break:openSource", (_e, url: string) => {
+    if (/^https:\/\//.test(url)) shell.openExternal(url);
+  });
+}
+
+app.whenReady().then(() => {
+  Menu.setApplicationMenu(null);
+  preferences = loadPreferences();
+  createTray();
+  registerIpc();
+  registerBackgroundIpc(
+    () => preferences.background,
+    (c) => {
+      preferences.background = c;
+      savePreferences(preferences);
+    }
+  );
+  scheduler = new Scheduler(preferences, (type) => {
+    showBreakWindow(buildBreakPlan(type));
+    updateTrayMenu();
+  });
+  scheduler.start();
+  if (preferences.firstRun) {
+    showSettingsWindow();
+    preferences.firstRun = false;
+    savePreferences(preferences);
+  }
+});
+
+app.on("window-all-closed", () => {
+  // Do nothing — keep app running in tray. Prevents default quit behavior.
+});
+
+app.on("before-quit", () => {
+  scheduler?.stop();
+  tray?.destroy();
+});

package/src/main/preferences.ts

@@ -0,0 +1,34 @@
+import { app, ipcMain } from "electron";
+import * as path from "path";
+import * as fs from "fs";
+import { Preferences, DEFAULT_PREFERENCES } from "../shared/types";
+
+function preferencesPath(): string {
+  return path.join(app.getPath("userData"), "preferences.json");
+}
+
+export function loadPreferences(): Preferences {
+  try {
+    const file = preferencesPath();
+    if (!fs.existsSync(file)) return { ...DEFAULT_PREFERENCES };
+    const raw = fs.readFileSync(file, "utf8");
+    const parsed = JSON.parse(raw) as Partial<Preferences>;
+    return { ...DEFAULT_PREFERENCES, ...parsed };
+  } catch {
+    return { ...DEFAULT_PREFERENCES };
+  }
+}
+
+export function savePreferences(prefs: Preferences): void {
+  try {
+    fs.writeFileSync(preferencesPath(), JSON.stringify(prefs, null, 2), "utf8");
+  } catch (err) {
+    console.error("Failed to save preferences:", err);
+  }
+}
+
+ipcMain.handle("prefs:load", () => loadPreferences());
+ipcMain.handle("prefs:save", (_e, prefs: Preferences) => {
+  savePreferences(prefs);
+  return prefs;
+});

package/src/main/scheduler.ts

@@ -0,0 +1,105 @@
+import { Preferences, BreakType, Language } from "../shared/types";
+import { t, TranslationKey } from "../data/i18n";
+
+type BreakCallback = (type: BreakType) => void;
+
+export class Scheduler {
+  private prefs: Preferences;
+  private onBreak: BreakCallback;
+  private miniTimer: NodeJS.Timeout | null = null;
+  private longTimer: NodeJS.Timeout | null = null;
+  private pausedUntil = 0;
+  private nextMiniAt = 0;
+  private nextLongAt = 0;
+
+  constructor(prefs: Preferences, onBreak: BreakCallback) {
+    this.prefs = prefs;
+    this.onBreak = onBreak;
+  }
+
+  start(): void {
+    this.scheduleNext();
+  }
+
+  stop(): void {
+    if (this.miniTimer) clearTimeout(this.miniTimer);
+    if (this.longTimer) clearTimeout(this.longTimer);
+    this.miniTimer = null;
+    this.longTimer = null;
+  }
+
+  applyPreferences(prefs: Preferences): void {
+    this.prefs = prefs;
+    this.stop();
+    this.scheduleNext();
+  }
+
+  private scheduleNext(): void {
+    const now = Date.now();
+    if (this.prefs.miniBreakEnabled) {
+      this.nextMiniAt = now + this.prefs.miniBreakIntervalMinutes * 60 * 1000;
+      const delay = Math.max(1000, this.nextMiniAt - now);
+      this.miniTimer = setTimeout(() => this.fire("mini"), delay);
+    }
+    if (this.prefs.longBreakEnabled) {
+      this.nextLongAt = now + this.prefs.longBreakIntervalMinutes * 60 * 1000;
+      const delay = Math.max(1000, this.nextLongAt - now);
+      this.longTimer = setTimeout(() => this.fire("long"), delay);
+    }
+  }
+
+  private fire(type: BreakType): void {
+    if (Date.now() < this.pausedUntil) {
+      const rescheduleIn = this.pausedUntil - Date.now();
+      const t = setTimeout(() => this.fire(type), rescheduleIn);
+      if (type === "mini") this.miniTimer = t;
+      else this.longTimer = t;
+      return;
+    }
+    this.onBreak(type);
+  }
+
+  triggerNow(type: BreakType): void {
+    if (type === "mini" && this.miniTimer) clearTimeout(this.miniTimer);
+    if (type === "long" && this.longTimer) clearTimeout(this.longTimer);
+    this.onBreak(type);
+  }
+
+  pauseFor(ms: number): void {
+    this.pausedUntil = Date.now() + ms;
+  }
+
+  resume(): void {
+    this.pausedUntil = 0;
+  }
+
+  resumeAfterBreak(): void {
+    const now = Date.now();
+    if (this.prefs.miniBreakEnabled) {
+      this.nextMiniAt = now + this.prefs.miniBreakIntervalMinutes * 60 * 1000;
+      if (this.miniTimer) clearTimeout(this.miniTimer);
+      this.miniTimer = setTimeout(() => this.fire("mini"), this.nextMiniAt - now);
+    }
+    if (this.prefs.longBreakEnabled) {
+      this.nextLongAt = now + this.prefs.longBreakIntervalMinutes * 60 * 1000;
+      if (this.longTimer) clearTimeout(this.longTimer);
+      this.longTimer = setTimeout(() => this.fire("long"), this.nextLongAt - now);
+    }
+  }
+
+  nextBreakLabel(lang: Language): string {
+    const tt = (k: TranslationKey) => t(lang, k);
+    const now = Date.now();
+    if (now < this.pausedUntil) {
+      const mins = Math.ceil((this.pausedUntil - now) / 60000);
+      return tt("trayPaused") + mins + " min";
+    }
+    const candidates: { type: string; at: number }[] = [];
+    if (this.prefs.miniBreakEnabled && this.nextMiniAt) candidates.push({ type: tt("breakTitleMini"), at: this.nextMiniAt });
+    if (this.prefs.longBreakEnabled && this.nextLongAt) candidates.push({ type: tt("breakTitleLong"), at: this.nextLongAt });
+    if (candidates.length === 0) return tt("noBreakScheduled");
+    candidates.sort((a, b) => a.at - b.at);
+    const mins = Math.max(0, Math.ceil((candidates[0].at - now) / 60000));
+    return tt("trayNextBreak") + candidates[0].type + " ~" + mins + " min";
+  }
+}

package/src/preload/break.ts

@@ -0,0 +1,9 @@
+import { contextBridge, ipcRenderer } from "electron";
+import { BreakPlan } from "../shared/types";
+
+contextBridge.exposeInMainWorld("eyeCare", {
+  onBreakStart: (cb: (plan: BreakPlan) => void) =>
+    ipcRenderer.on("break:start", (_e, plan: BreakPlan) => cb(plan)),
+  skipBreak: () => ipcRenderer.invoke("break:skip"),
+  openSource: (url: string) => ipcRenderer.invoke("break:openSource", url),
+});

package/src/preload/settings.ts

@@ -0,0 +1,18 @@
+import { contextBridge, ipcRenderer } from "electron";
+import { Preferences, BackgroundConfig } from "../shared/types";
+
+contextBridge.exposeInMainWorld("eyeCare", {
+  getPreferences: () => ipcRenderer.invoke("prefs:get"),
+  updatePreferences: (next: Partial<Preferences>) => ipcRenderer.invoke("prefs:update", next),
+  getAppInfo: () => ipcRenderer.invoke("app:info"),
+  backgrounds: {
+    listBuiltin: () => ipcRenderer.invoke("bg:listBuiltin"),
+    listUser: () => ipcRenderer.invoke("bg:listUser"),
+    addUser: () => ipcRenderer.invoke("bg:addUser"),
+    deleteUser: (name: string) => ipcRenderer.invoke("bg:deleteUser", name),
+    set: (cfg: BackgroundConfig) => ipcRenderer.invoke("bg:set", cfg),
+    get: () => ipcRenderer.invoke("bg:get"),
+    loadFile: (name: string, mode: "none" | "builtin" | "user" | "random") =>
+      ipcRenderer.invoke("bg:loadFile", name, mode),
+  },
+});

package/src/renderer/backgrounds/forest.svg

@@ -0,0 +1,13 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1920 1080" preserveAspectRatio="xMidYMid slice">
+  <defs>
+    <linearGradient id="forest" x1="0" y1="0" x2="0" y2="1">
+      <stop offset="0%" stop-color="#cae8c0"/>
+      <stop offset="40%" stop-color="#9bc99a"/>
+      <stop offset="100%" stop-color="#4a7a4f"/>
+    </linearGradient>
+  </defs>
+  <rect width="1920" height="1080" fill="url(#forest)"/>
+  <path d="M0,1080 L0,720 Q200,650 400,700 T800,680 T1200,700 T1600,680 T1920,700 L1920,1080 Z" fill="#5a8a5f" opacity="0.7"/>
+  <path d="M0,1080 L0,820 Q240,780 480,800 T960,790 T1440,810 T1920,800 L1920,1080 Z" fill="#3d6a44" opacity="0.85"/>
+  <path d="M0,1080 L0,920 Q320,890 640,910 T1280,900 T1920,910 L1920,1080 Z" fill="#2a4d34"/>
+</svg>

package/src/renderer/backgrounds/mountains.svg

@@ -0,0 +1,13 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1920 1080" preserveAspectRatio="xMidYMid slice">
+  <defs>
+    <linearGradient id="mtn" x1="0" y1="0" x2="0" y2="1">
+      <stop offset="0%" stop-color="#dde6f0"/>
+      <stop offset="50%" stop-color="#a8b8cf"/>
+      <stop offset="100%" stop-color="#6b7e98"/>
+    </linearGradient>
+  </defs>
+  <rect width="1920" height="1080" fill="url(#mtn)"/>
+  <path d="M0,1080 L0,700 L260,500 L480,640 L740,420 L1000,600 L1280,460 L1560,620 L1920,520 L1920,1080 Z" fill="#7a8ba5" opacity="0.8"/>
+  <path d="M0,1080 L0,820 L320,680 L620,780 L920,640 L1260,760 L1640,700 L1920,780 L1920,1080 Z" fill="#566886" opacity="0.9"/>
+  <path d="M0,1080 L0,940 L400,880 L800,920 L1280,880 L1920,910 L1920,1080 Z" fill="#3a4d6a"/>
+</svg>

package/src/renderer/backgrounds/sea.svg

@@ -0,0 +1,13 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1920 1080" preserveAspectRatio="xMidYMid slice">
+  <defs>
+    <linearGradient id="sea" x1="0" y1="0" x2="0" y2="1">
+      <stop offset="0%" stop-color="#cfeaf3"/>
+      <stop offset="35%" stop-color="#7fb8d6"/>
+      <stop offset="100%" stop-color="#2c5f7c"/>
+    </linearGradient>
+  </defs>
+  <rect width="1920" height="1080" fill="url(#sea)"/>
+  <path d="M0,560 Q480,520 960,560 T1920,560 L1920,1080 L0,1080 Z" fill="#4a89ab" opacity="0.6"/>
+  <path d="M0,720 Q480,690 960,720 T1920,720 L1920,1080 L0,1080 Z" fill="#2c5f7c" opacity="0.7"/>
+  <path d="M0,880 Q480,860 960,880 T1920,880 L1920,1080 L0,1080 Z" fill="#1c4a64" opacity="0.85"/>
+</svg>

package/src/renderer/backgrounds/sunny-sky.svg

@@ -0,0 +1,16 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1920 1080" preserveAspectRatio="xMidYMid slice">
+  <defs>
+    <linearGradient id="sky" x1="0" y1="0" x2="0" y2="1">
+      <stop offset="0%" stop-color="#a8d8f5"/>
+      <stop offset="60%" stop-color="#d4ecfb"/>
+      <stop offset="100%" stop-color="#fef9e7"/>
+    </linearGradient>
+    <radialGradient id="sun" cx="50%" cy="35%" r="25%">
+      <stop offset="0%" stop-color="#fff7d6" stop-opacity="0.9"/>
+      <stop offset="100%" stop-color="#fff7d6" stop-opacity="0"/>
+    </radialGradient>
+  </defs>
+  <rect width="1920" height="1080" fill="url(#sky)"/>
+  <rect width="1920" height="1080" fill="url(#sun)"/>
+  <ellipse cx="960" cy="900" rx="1400" ry="120" fill="#cfe8f5" opacity="0.6"/>
+</svg>

package/src/renderer/backgrounds/sunset.svg

@@ -0,0 +1,18 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1920 1080" preserveAspectRatio="xMidYMid slice">
+  <defs>
+    <linearGradient id="sunset" x1="0" y1="0" x2="0" y2="1">
+      <stop offset="0%" stop-color="#f5c26b"/>
+      <stop offset="35%" stop-color="#e8966b"/>
+      <stop offset="70%" stop-color="#9c5a7a"/>
+      <stop offset="100%" stop-color="#3a2e4a"/>
+    </linearGradient>
+    <radialGradient id="sun2" cx="50%" cy="62%" r="18%">
+      <stop offset="0%" stop-color="#fff0c2" stop-opacity="0.95"/>
+      <stop offset="100%" stop-color="#fff0c2" stop-opacity="0"/>
+    </radialGradient>
+  </defs>
+  <rect width="1920" height="1080" fill="url(#sunset)"/>
+  <rect width="1920" height="1080" fill="url(#sun2)"/>
+  <path d="M0,1080 L0,780 Q480,740 960,760 T1920,760 L1920,1080 Z" fill="#5a3a5a" opacity="0.8"/>
+  <path d="M0,1080 L0,900 Q480,880 960,890 T1920,900 L1920,1080 Z" fill="#2a1c3a"/>
+</svg>