persian-clock-widget 0.0.0-stage → 1.0.0

package/src/widget.py

@@ -0,0 +1,3351 @@
+# -*- coding: utf-8 -*-
+"""
+ویجت حرفه‌ای ساعت تهران، تقویم شمسی، مناسبت‌ها، ابزار کپی زمان برنامه‌نویسی (۱۰ فرمت API + تولیدکننده GUID) و سیستم آلارم/رویداد
+طراحی و توسعه: شایان بامیار (® Shayan Bamyar)
+"""
+
+from datetime import datetime, timezone
+import json
+import os
+import sys
+import time
+import tkinter as tk
+from tkinter import colorchooser, font as tkfont, ttk
+import uuid
+
+try:
+    from src.alarm_manager import (
+        AlarmManagerWindow,
+        AlarmStore,
+        AnimatedBellPopup,
+        draw_outlined_canvas_text,
+    )
+    from src.calendar_data import (
+        PERSIAN_MONTHS,
+        PERSIAN_WEEK_SHORT,
+        TEHRAN_TZ,
+        get_jalali_month_days,
+        get_month_calendar,
+        get_today_info,
+        gregorian_to_jalali,
+    )
+    from src.win_utils import (
+        SystemTrayIcon,
+        apply_rounded_corners,
+        apply_z_order_and_clickthrough,
+        enable_dpi_awareness,
+        get_data_dir,
+        get_resource_path,
+        hide_from_taskbar,
+        is_startup_enabled,
+        register_bundled_fonts,
+        set_startup_enabled,
+    )
+    from src.taskbar_clock import (
+        TaskbarButtonProxy,
+        TaskbarClockOverlay,
+        WindowsClockReplacer,
+        get_windows11_tray_clock_hidden,
+        set_windows11_tray_clock_hidden,
+    )
+except ImportError:
+    from alarm_manager import (
+        AlarmManagerWindow,
+        AlarmStore,
+        AnimatedBellPopup,
+        draw_outlined_canvas_text,
+    )
+    from calendar_data import (
+        PERSIAN_MONTHS,
+        PERSIAN_WEEK_SHORT,
+        TEHRAN_TZ,
+        get_jalali_month_days,
+        get_month_calendar,
+        get_today_info,
+        gregorian_to_jalali,
+    )
+    from win_utils import (
+        SystemTrayIcon,
+        apply_rounded_corners,
+        apply_z_order_and_clickthrough,
+        enable_dpi_awareness,
+        get_data_dir,
+        get_resource_path,
+        hide_from_taskbar,
+        is_startup_enabled,
+        register_bundled_fonts,
+        set_startup_enabled,
+    )
+    from taskbar_clock import (
+        TaskbarButtonProxy,
+        TaskbarClockOverlay,
+        WindowsClockReplacer,
+        get_windows11_tray_clock_hidden,
+        set_windows11_tray_clock_hidden,
+    )
+
+DATA_DIR = get_data_dir()
+CONFIG_PATH = os.path.join(DATA_DIR, "config.json")
+CUSTOM_OCCASIONS_PATH = os.path.join(DATA_DIR, "custom_occasions.json")
+ALARMS_PATH = os.path.join(DATA_DIR, "alarms.json")
+
+TRANSPARENT_KEY = "#010203"
+
+DEFAULT_CONFIG = {
+    "x": None,
+    "y": None,
+    "locked": False,            # False = آزاد (🔓) | True = فیکس و Click-Through (🔒)
+    "z_mode": "topmost",        # 'topmost' (همیشه روی برنامه‌ها) یا 'desktop' (چسبیده به دسکتاپ)
+    "opacity": 0.90,
+    "transparent_bg": False,
+    "persian_digits": False,
+    "calendar_expanded": False,
+    "calendar_position": "beside",
+    # تنظیمات رنگ‌ها
+    "bg_color": "#141821",
+    "border_color": "#2A3244",
+    "clock_color": "#F8FAFC",
+    "date_color": "#CBD5E1",
+    "occasion_color": "#94A3B8",
+    "holiday_color": "#F87171",
+    "accent_color": "#38BDF8",
+    # تنظیمات سایز ویجت و فونت‌ها (با پیش‌فرض فونت وزیر Vazir)
+    "widget_scale": 100,
+    "font_family": "Vazir",
+    "clock_font_family": "Vazir",
+    "clock_font_size": 26,
+    "date_font_size": 11,
+    "occasion_font_size": 9,
+    # نمایش و جایگزینی در تسک‌بار ویندوز
+    "replace_windows_clock": False,     # ⭐ جایگزینی کامل و پوشاندن ساعت پیش‌فرض ویندوز
+    "replace_clock_hide_widget": False, # مخفی کردن ویجت دسکتاپ هنگام فعال بودن جایگزین
+    "replace_clock_width": 118,         # عرض باکس پوشش‌دهنده ساعت ویندوز
+    "replace_clock_offset": 8,          # فاصله از گوشه راست تسک‌بار
+    "replace_clock_bg": "auto",         # تشخیص خودکار رنگ تسک‌بار ویندوز (یا رنگ دلخواه)
+    "taskbar_clock": False,         # نمایش ساعت و تاریخ شمسی روی خود نوار تسک‌بار (شناور)
+    "taskbar_clock_seconds": False, # نمایش ثانیه در ساعت تسک‌بار
+    "taskbar_clock_offset": None,   # مکان ذخیره‌شده ساعت روی تسک‌بار (فاصله از لبه راست)
+    "taskbar_button": False,        # نمایش دکمه/آیکون برنامه در تسک‌بار
+    "snap_side": "right",           # جهت چسبیدن به لبه صفحه در حالت قفل ('right' یا 'left')
+}
+
+
+def format_digits(text: str, use_persian: bool) -> str:
+    """تبدیل اعداد انگلیسی به فارسی در صورت فعال بودن گزینه مربوطه"""
+    if not use_persian:
+        return str(text)
+    en = "0123456789"
+    fa = "۰۱۲۳۴۵۶۷۸۹"
+    return str(text).translate(str.maketrans(en, fa))
+
+
+class HoverTooltip:
+    """
+    افکت Hover فوری و نمایش Tooltip شناور همیشه در بالاترین لایه (Topmost)
+    هنگام نگه داشتن ماوس روی آیکون‌ها
+    """
+
+    def __init__(
+        self,
+        widget: tk.Widget,
+        text_or_fn,
+        base_bg_fn,
+        base_fg_fn,
+        hover_bg: str = "#0284C7",
+        hover_fg: str = "#FFFFFF",
+        font_family: str = "Vazir",
+    ):
+        self.widget = widget
+        self.text_or_fn = text_or_fn
+        self.base_bg_fn = base_bg_fn
+        self.base_fg_fn = base_fg_fn
+        self.hover_bg = hover_bg
+        self.hover_fg = hover_fg
+        self.font_family = font_family
+        self.tip_win: tk.Toplevel | None = None
+        self._after_id: str | None = None
+        self.is_hovered = False
+
+        self.widget.bind("<Enter>", self._on_enter, add="+")
+        self.widget.bind("<Leave>", self._on_leave, add="+")
+        self.widget.bind("<ButtonPress>", self._on_press, add="+")
+
+    def _on_enter(self, event=None):
+        self.is_hovered = True
+        try:
+            self.widget.configure(bg=self.hover_bg, fg=self.hover_fg)
+        except Exception:
+            pass
+        self._cancel_timer()
+        self._after_id = self.widget.after(90, self._show_tip)
+
+    def _on_leave(self, event=None):
+        self.is_hovered = False
+        self._cancel_timer()
+        try:
+            self.widget.configure(bg=self.base_bg_fn(), fg=self.base_fg_fn())
+        except Exception:
+            pass
+        self._hide_tip()
+
+    def _on_press(self, event=None):
+        self._cancel_timer()
+        self._hide_tip()
+
+    def _cancel_timer(self):
+        if self._after_id is not None:
+            try:
+                self.widget.after_cancel(self._after_id)
+            except Exception:
+                pass
+            self._after_id = None
+
+    def _show_tip(self):
+        if not self.is_hovered or self.tip_win is not None:
+            return
+        txt = self.text_or_fn() if callable(self.text_or_fn) else str(self.text_or_fn)
+        if not txt:
+            return
+        try:
+            wx = self.widget.winfo_rootx()
+            wy = self.widget.winfo_rooty()
+            wh = self.widget.winfo_height()
+
+            win = tk.Toplevel(self.widget)
+            self.tip_win = win
+            win.overrideredirect(True)
+            win.attributes("-topmost", True)
+            win.configure(bg="#0F172A")
+
+            frm = tk.Frame(
+                win,
+                bg="#0F172A",
+                highlightbackground="#38BDF8",
+                highlightthickness=1,
+                padx=8,
+                pady=4,
+            )
+            frm.pack()
+            lbl = tk.Label(
+                frm,
+                text=txt,
+                font=(self.font_family, 8, "bold"),
+                fg="#F8FAFC",
+                bg="#0F172A",
+            )
+            lbl.pack()
+
+            win.update_idletasks()
+            tw = win.winfo_reqwidth()
+            th = win.winfo_reqheight()
+            screen_w = win.winfo_screenwidth()
+            screen_h = win.winfo_screenheight()
+
+            # نمایش در بالای آیکون یا پایین آیکون به‌گونه‌ای که همیشه کامل دیده شود
+            pos_x = wx - (tw // 3)
+            if pos_x + tw > screen_w - 8:
+                pos_x = screen_w - tw - 8
+            pos_x = max(8, pos_x)
+
+            if wy - th - 6 >= 8:
+                pos_y = wy - th - 6
+            else:
+                pos_y = min(screen_h - th - 8, wy + wh + 6)
+
+            win.geometry(f"+{int(pos_x)}+{int(pos_y)}")
+            hide_from_taskbar(win)
+            apply_z_order_and_clickthrough(win, "topmost", click_through=True)
+        except Exception:
+            self._hide_tip()
+
+    def _hide_tip(self):
+        if self.tip_win is not None:
+            try:
+                self.tip_win.destroy()
+            except Exception:
+                pass
+            self.tip_win = None
+
+
+class PersianClockWidget:
+    BASE_MIN_W = 290
+    BASE_CALENDAR_W = 310
+    BASE_CALENDAR_H = 385
+
+    LOCK_BTN_SIZE = 24
+    LOCK_OFFSET_X = 8
+    LOCK_OFFSET_Y = 8
+    GAP = 8
+
+    def __init__(self):
+        enable_dpi_awareness()
+        register_bundled_fonts()
+
+        self.config = self._load_config()
+        if self.config.get("z_mode") == "overlay_locked":
+            self.config["z_mode"] = "topmost"
+            self.config["locked"] = True
+
+        # پنجره ریشه مخفی (بدون هیچ آیکونی در Taskbar)
+        self.root = tk.Tk()
+        self.root.title("PersianClockHiddenRoot")
+        self.root.attributes("-alpha", 0.0)
+        self.root.withdraw()
+
+        sys_fams = set(tkfont.families())
+        if self.config["font_family"] not in sys_fams:
+            for candidate in ("Vazir", "B Yekan+", "A Iranian Sans", "Tahoma"):
+                if candidate in sys_fams:
+                    self.config["font_family"] = candidate
+                    break
+        if self.config["clock_font_family"] not in sys_fams:
+            for candidate in ("Vazir", "B Yekan+", "A Iranian Sans", "Segoe UI Semibold", "Tahoma"):
+                if candidate in sys_fams:
+                    self.config["clock_font_family"] = candidate
+                    break
+
+        ico_path = get_resource_path(os.path.join("assets", "icons", "app_icon.ico"))
+        if os.path.exists(ico_path):
+            try:
+                self.root.iconbitmap(default=ico_path)
+            except Exception:
+                pass
+
+        self.alarm_store = AlarmStore(ALARMS_PATH)
+
+        today = get_today_info(CUSTOM_OCCASIONS_PATH)
+        self.current_jy = today["jy"]
+        self.current_jm = today["jm"]
+        self.current_jd = today["jd"]
+
+        self.view_jy = today["jy"]
+        self.view_jm = today["jm"]
+        self.selected_day_info = today
+
+        self._computed_w = self.BASE_MIN_W
+        self._computed_h = 118
+        self._toast_text = ""
+
+        self._drag_start_x = 0
+        self._drag_start_y = 0
+        self._is_dragging = False
+        self._is_minimized = False
+        self._unlocked_x = self.config.get("x")
+        self._unlocked_y = self.config.get("y")
+        self._tooltips: list[HoverTooltip] = []
+
+        self.widget_win: tk.Toplevel | None = None
+        self.lock_win: tk.Toplevel | None = None
+        self.cal_win: tk.Toplevel | None = None
+        self.dev_popup_win: tk.Toplevel | None = None
+        self.settings_win: tk.Toplevel | None = None
+        self.alarm_win: AlarmManagerWindow | None = None
+        self.custom_occ_win: tk.Toplevel | None = None
+
+        self._build_compact_ui()
+        self._build_lock_badge_window()
+        self._build_calendar_window()
+        self._build_context_menu()
+        self._build_dev_copy_menu()
+
+        self._init_position()
+        self.root.after(60, self._apply_all_styles)
+
+        self.tray = SystemTrayIcon(
+            tooltip=self._format_tray_tooltip(today),
+            on_left_click=self._on_tray_left_click,
+            on_right_click=self._on_tray_right_click,
+        )
+        self.tray.start()
+
+        self.taskbar_clock: TaskbarClockOverlay | None = None
+        self.taskbar_proxy: TaskbarButtonProxy | None = None
+        self.clock_replacer: WindowsClockReplacer | None = None
+        self.root.after(300, self.sync_taskbar_features)
+
+        self._update_clock_loop()
+        self._keep_z_order_loop()
+
+    # ------------------------------------------------------------------
+    # نمایش در تسک‌بار (ساعت روی تسک‌بار + دکمه برنامه در تسک‌بار)
+    # ------------------------------------------------------------------
+    def format_digits_public(self, text: str, use_fa: bool) -> str:
+        return format_digits(text, use_fa)
+
+    def sync_taskbar_features(self):
+        """فعال/غیرفعال کردن جایگزین ساعت ویندوز، ساعت روی تسک‌بار و دکمه تسک‌بار بر اساس تنظیمات"""
+        want_replacer = bool(self.config.get("replace_windows_clock", False))
+        want_clock = bool(self.config.get("taskbar_clock", False))
+        want_btn = bool(self.config.get("taskbar_button", False))
+        hide_desktop = bool(self.config.get("replace_clock_hide_widget", False)) and want_replacer
+
+        # ۱. جایگزین کامل ساعت و تاریخ ویندوز
+        if want_replacer and self.clock_replacer is None:
+            self.clock_replacer = WindowsClockReplacer(self)
+            self.clock_replacer.refresh(get_today_info(CUSTOM_OCCASIONS_PATH))
+        elif not want_replacer and self.clock_replacer is not None:
+            self.clock_replacer.destroy()
+            self.clock_replacer = None
+
+        # ۲. ساعت و تاریخ شناور روی تسک‌بار
+        if want_clock and self.taskbar_clock is None:
+            self.taskbar_clock = TaskbarClockOverlay(self)
+            self.taskbar_clock.refresh(get_today_info(CUSTOM_OCCASIONS_PATH))
+        elif not want_clock and self.taskbar_clock is not None:
+            self.taskbar_clock.destroy()
+            self.taskbar_clock = None
+
+        # ۳. دکمه/آیکون برنامه در تسک‌بار
+        if want_btn and self.taskbar_proxy is None:
+            self.taskbar_proxy = TaskbarButtonProxy(self)
+        elif not want_btn and self.taskbar_proxy is not None:
+            self.taskbar_proxy.destroy()
+            self.taskbar_proxy = None
+
+        # ۴. مدیریت نمایش/مخفی‌سازی ویجت دسکتاپ بر اساس تنظیمات جایگزینی
+        if hide_desktop:
+            if self.widget_win and self.widget_win.winfo_viewable():
+                self.widget_win.withdraw()
+            if self.lock_win and self.lock_win.winfo_viewable():
+                self.lock_win.withdraw()
+        else:
+            if not getattr(self, "_is_minimized", False):
+                if self.widget_win and not self.widget_win.winfo_viewable():
+                    self.widget_win.deiconify()
+                if self.lock_win and not self.lock_win.winfo_viewable() and self.config.get("locked"):
+                    self.lock_win.deiconify()
+
+        for var_name, key in (
+            ("_settings_tb_clock_var", "taskbar_clock"),
+            ("_settings_tb_btn_var", "taskbar_button"),
+            ("_settings_replace_clock_var", "replace_windows_clock"),
+            ("_settings_hide_widget_var", "replace_clock_hide_widget"),
+        ):
+            var = getattr(self, var_name, None)
+            if var is not None:
+                try:
+                    var.set(bool(self.config.get(key, False)))
+                except Exception:
+                    pass
+
+    def _toggle_taskbar_setting(self, key: str):
+        self.config[key] = not self.config.get(key, False)
+        self._save_config()
+        self.sync_taskbar_features()
+
+    def minimize_widget(self):
+        """مخفی کردن ویجت از صفحه دسکتاپ و نمایش فقط در تسک‌بار و Hidden Icons"""
+        self._is_minimized = True
+        self._close_dev_popup_window()
+        if self.widget_win:
+            self.widget_win.withdraw()
+        if self.lock_win:
+            self.lock_win.withdraw()
+        if self.cal_win:
+            self.cal_win.withdraw()
+        # اطمینان از حضور دکمه در تسک‌بار تا کاربر بتواند با یک کلیک آن را بازگرداند
+        if self.taskbar_proxy is None:
+            self.taskbar_proxy = TaskbarButtonProxy(self)
+        info = get_today_info(CUSTOM_OCCASIONS_PATH)
+        use_fa = self.config.get("persian_digits", False)
+        self.taskbar_proxy.update_title(
+            format_digits(f"{info['time_str'][:5]} | {info['date_text']}", use_fa)
+        )
+        if getattr(self, "taskbar_clock", None) is not None:
+            try:
+                self.taskbar_clock.refresh(info)
+            except Exception:
+                pass
+        if getattr(self, "clock_replacer", None) is not None:
+            try:
+                self.clock_replacer.refresh(info)
+            except Exception:
+                pass
+
+    def restore_widget(self):
+        """نمایش مجدد ویجت روی صفحه دسکتاپ"""
+        self._is_minimized = False
+        if self.widget_win:
+            self.widget_win.deiconify()
+            self.widget_win.lift()
+        if self.lock_win:
+            self.lock_win.deiconify()
+            self.lock_win.lift()
+        self._position_lock_window()
+        self._apply_all_styles()
+        self.sync_taskbar_features()
+
+    def on_taskbar_clicked(self):
+        """کلیک روی ساعت تسک‌بار یا دکمه تسک‌بار: بازیابی از مینیمایز یا باز/بسته کردن تقویم"""
+        now_ts = time.monotonic()
+        if now_ts - getattr(self, "_last_tb_click_ts", 0.0) < 0.22:
+            return
+        self._last_tb_click_ts = now_ts
+
+        hide_desktop = (
+            bool(self.config.get("replace_windows_clock", False))
+            and bool(self.config.get("replace_clock_hide_widget", False))
+        )
+        if self._is_minimized:
+            if not hide_desktop:
+                self.restore_widget()
+                return
+            self._is_minimized = False
+
+        if not hide_desktop:
+            if self.widget_win and not self.widget_win.winfo_viewable():
+                self.widget_win.deiconify()
+            if self.lock_win and not self.lock_win.winfo_viewable() and self.config.get("locked"):
+                self.lock_win.deiconify()
+
+        self._toggle_calendar(None)
+        if self.config.get("calendar_expanded") and self.cal_win:
+            self.cal_win.lift()
+
+    def show_menu_at_pointer(self):
+        self._populate_context_menu()
+        x = self.root.winfo_pointerx()
+        y = self.root.winfo_pointery()
+        try:
+            self.menu.tk_popup(x, y)
+        finally:
+            self.menu.grab_release()
+
+    def _get_btn_base_bg(self) -> str:
+        return "#1E2638" if not self.config.get("transparent_bg", False) else "#141821"
+
+    def _attach_hover(
+        self,
+        widget: tk.Widget,
+        tooltip_text,
+        base_fg_fn,
+        hover_bg: str = "#0284C7",
+        hover_fg: str = "#FFFFFF",
+        base_bg_fn=None,
+    ):
+        tip = HoverTooltip(
+            widget=widget,
+            text_or_fn=tooltip_text,
+            base_bg_fn=base_bg_fn or self._get_btn_base_bg,
+            base_fg_fn=base_fg_fn,
+            hover_bg=hover_bg,
+            hover_fg=hover_fg,
+            font_family=self.config.get("font_family", "Vazir"),
+        )
+        self._tooltips.append(tip)
+
+    def _format_tray_tooltip(self, info: dict) -> str:
+        base = f"{info['time_str']} | {info['date_text']}"
+        if info.get("has_occasion") and info.get("occasion"):
+            return f"{base} - {info['occasion']}"
+        return base
+
+    def _load_config(self) -> dict:
+        cfg = DEFAULT_CONFIG.copy()
+        if os.path.exists(CONFIG_PATH):
+            try:
+                with open(CONFIG_PATH, "r", encoding="utf-8") as f:
+                    saved = json.load(f)
+                if isinstance(saved, dict):
+                    cfg.update(saved)
+            except Exception:
+                pass
+        return cfg
+
+    def _save_config(self):
+        try:
+            os.makedirs(os.path.dirname(CONFIG_PATH), exist_ok=True)
+            with open(CONFIG_PATH, "w", encoding="utf-8") as f:
+                json.dump(self.config, f, ensure_ascii=False, indent=2)
+        except Exception:
+            pass
+
+    @property
+    def compact_w(self) -> int:
+        return self._computed_w
+
+    @property
+    def compact_h(self) -> int:
+        return self._computed_h
+
+    @property
+    def calendar_w(self) -> int:
+        scale = max(80, min(150, int(self.config.get("widget_scale", 100)))) / 100.0
+        return int(self.BASE_CALENDAR_W * scale)
+
+    @property
+    def calendar_h(self) -> int:
+        scale = max(80, min(150, int(self.config.get("widget_scale", 100)))) / 100.0
+        return int(self.BASE_CALENDAR_H * scale)
+
+    def _build_compact_ui(self):
+        self.widget_win = tk.Toplevel(self.root)
+        self.widget_win.title("ویجت ساعت و تقویم")
+        self.widget_win.overrideredirect(True)
+
+        bg = TRANSPARENT_KEY if self.config["transparent_bg"] else self.config["bg_color"]
+        self.widget_win.configure(bg=bg)
+
+        self.main_frame = tk.Frame(
+            self.widget_win,
+            bg=bg,
+            highlightbackground=self.config["border_color"] if not self.config["transparent_bg"] else bg,
+            highlightthickness=0 if self.config["transparent_bg"] else 1,
+        )
+        self.main_frame.pack(fill="both", expand=True)
+
+        self.canvas = tk.Canvas(
+            self.main_frame,
+            bg=bg,
+            highlightthickness=0,
+            bd=0,
+        )
+        self.canvas.pack(fill="both", expand=True)
+
+        self.btn_container = tk.Frame(self.canvas, bg=bg)
+
+        # ۱. دکمه باز/بسته کردن تقویم (Extend)
+        self.extend_btn = tk.Label(
+            self.btn_container,
+            text="◂ تقویم",
+            font=(self.config["font_family"], 8, "bold"),
+            fg=self.config["accent_color"],
+            bg="#1E2638",
+            padx=5,
+            pady=2,
+            cursor="hand2",
+        )
+        self.extend_btn.pack(side="left", padx=(0, 3))
+        self.extend_btn.bind("<Button-1>", self._toggle_calendar)
+        self.extend_btn.bind("<Double-Button-1>", lambda e: "break")
+        self._attach_hover(
+            self.extend_btn,
+            lambda: "بستن تقویم ماهانه" if self.config.get("calendar_expanded") else "نمایش تقویم ماهانه و مناسبت‌ها",
+            base_fg_fn=lambda: self.config.get("accent_color", "#38BDF8"),
+            hover_bg="#0284C7",
+            hover_fg="#FFFFFF",
+        )
+
+        # ۲. دکمه کپی ۱۰ فرمت زمان برنامه‌نویسی برای API + GUID
+        self.copy_time_btn = tk.Label(
+            self.btn_container,
+            text="📋",
+            font=("Segoe UI Emoji", 8),
+            fg="#A7F3D0",
+            bg="#1E2638",
+            padx=5,
+            pady=2,
+            cursor="hand2",
+        )
+        self.copy_time_btn.pack(side="left", padx=(0, 3))
+        self.copy_time_btn.bind("<Button-1>", self._toggle_dev_popup_window)
+        self.copy_time_btn.bind("<Double-Button-1>", lambda e: "break")
+        self._attach_hover(
+            self.copy_time_btn,
+            "کپی زمان (۱۰ فرمت API: تاریخ+ساعت / تاریخ جدا / ساعت جدا) + GUID",
+            base_fg_fn=lambda: "#A7F3D0",
+            hover_bg="#059669",
+            hover_fg="#FFFFFF",
+        )
+
+        # ۳. دکمه اختصاصی رندر و کپی سریع GUID (UUID v4)
+        self.guid_btn = tk.Label(
+            self.btn_container,
+            text="GUID",
+            font=("Consolas", 8, "bold"),
+            fg="#C4B5FD",
+            bg="#1E2638",
+            padx=5,
+            pady=2,
+            cursor="hand2",
+        )
+        self.guid_btn.pack(side="left", padx=(0, 3))
+        self.guid_btn.bind("<Button-1>", self._quick_copy_guid)
+        self.guid_btn.bind("<Double-Button-1>", lambda e: "break")
+        self.guid_btn.bind("<Button-3>", self._toggle_dev_popup_window)
+        self._attach_hover(
+            self.guid_btn,
+            "کلیک چپ: رندر و کپی فوری GUID جدید | کلیک راست: منوی کامل",
+            base_fg_fn=lambda: "#C4B5FD",
+            hover_bg="#7C3AED",
+            hover_fg="#FFFFFF",
+        )
+
+        # ۴. دکمه مدیریت رویدادها و آلارم‌ها
+        self.alarm_btn = tk.Label(
+            self.btn_container,
+            text="⏰",
+            font=("Segoe UI Emoji", 8),
+            fg="#FBBF24",
+            bg="#1E2638",
+            padx=5,
+            pady=2,
+            cursor="hand2",
+        )
+        self.alarm_btn.pack(side="left", padx=(0, 3))
+        self.alarm_btn.bind("<Button-1>", lambda e: (self.open_alarm_manager(), "break")[1])
+        self.alarm_btn.bind("<Double-Button-1>", lambda e: "break")
+        self._attach_hover(
+            self.alarm_btn,
+            "مدیریت رویدادها و آلارم‌ها (تقویم چندانتخابی)",
+            base_fg_fn=lambda: "#FBBF24",
+            hover_bg="#D97706",
+            hover_fg="#FFFFFF",
+        )
+
+        # ۵. دکمه تنظیمات ظاهری
+        self.settings_btn = tk.Label(
+            self.btn_container,
+            text="⚙",
+            font=("Segoe UI", 8),
+            fg=self.config["date_color"],
+            bg="#1E2638",
+            padx=5,
+            pady=2,
+            cursor="hand2",
+        )
+        self.settings_btn.pack(side="left", padx=(0, 2))
+        self.settings_btn.bind("<Button-1>", lambda e: (self.open_settings_window(), "break")[1])
+        self.settings_btn.bind("<Double-Button-1>", lambda e: "break")
+        self._attach_hover(
+            self.settings_btn,
+            "تنظیمات ظاهری، رنگ، سایز و فونت",
+            base_fg_fn=lambda: self.config.get("date_color", "#CBD5E1"),
+            hover_bg="#475569",
+            hover_fg="#FFFFFF",
+        )
+
+        # ۶. دکمه مینیمایز (مخفی کردن از صفحه؛ فقط در تسک‌بار و Hidden Icons)
+        self.min_btn = tk.Label(
+            self.btn_container,
+            text="🗕",
+            font=("Segoe UI", 8, "bold"),
+            fg=self.config["date_color"],
+            bg="#1E2638",
+            padx=5,
+            pady=2,
+            cursor="hand2",
+        )
+        self.min_btn.pack(side="left")
+        self.min_btn.bind("<Button-1>", lambda e: (self.minimize_widget(), "break")[1])
+        self.min_btn.bind("<Double-Button-1>", lambda e: "break")
+        self._attach_hover(
+            self.min_btn,
+            "مینیمایز ویجت (نمایش فقط در تسک‌بار و Hidden Icons)",
+            base_fg_fn=lambda: self.config.get("date_color", "#CBD5E1"),
+            hover_bg="#475569",
+            hover_fg="#FFFFFF",
+        )
+
+        # ایجاد یک‌باره پنجره نوار ابزار روی Canvas تا در رفرش ثانیه‌ای حذف نشود و Hover پایدار بماند
+        toolbar_x = self.LOCK_OFFSET_X + self.LOCK_BTN_SIZE + 8
+        toolbar_y = self.LOCK_OFFSET_Y
+        self._toolbar_win_id = self.canvas.create_window(
+            toolbar_x,
+            toolbar_y,
+            window=self.btn_container,
+            anchor="nw",
+            tags="toolbar",
+        )
+
+        # بایندینگ درگ و دابل‌کلیک فقط روی بوم و قاب اصلی (نه روی toplevel تا دکمه‌های نوار ابزار را نگیرد)
+        for w in (self.main_frame, self.canvas):
+            w.bind("<ButtonPress-1>", self._on_drag_start)
+            w.bind("<B1-Motion>", self._on_drag_motion)
+            w.bind("<ButtonRelease-1>", self._on_drag_end)
+            w.bind("<Button-3>", self._show_context_menu)
+            w.bind("<Double-Button-1>", self._toggle_calendar)
+
+    def _quick_copy_guid(self, event=None):
+        """تولید و کپی فوری یک GUID (UUID v4) استاندارد با یک کلیک روی دکمه GUID"""
+        if self.config.get("locked", False):
+            return "break"
+        new_guid = str(uuid.uuid4())
+        self._copy_to_clipboard(new_guid, f"✓ GUID کپی شد!")
+        return "break"
+
+    def _build_lock_badge_window(self):
+        self.lock_win = tk.Toplevel(self.root)
+        self.lock_win.overrideredirect(True)
+        self.lock_win.configure(bg="#1E293B")
+
+        self.lock_frame = tk.Frame(
+            self.lock_win,
+            bg="#1E293B",
+            highlightbackground=self.config["border_color"],
+            highlightthickness=1,
+        )
+        self.lock_frame.pack(fill="both", expand=True)
+
+        self.lock_btn_label = tk.Label(
+            self.lock_frame,
+            text="🔒" if self.config.get("locked") else "🔓",
+            font=("Segoe UI Emoji", 8),
+            fg="#FBBF24" if self.config.get("locked") else self.config["accent_color"],
+            bg="#1E293B",
+            cursor="hand2",
+        )
+        self.lock_btn_label.pack(fill="both", expand=True)
+
+        self.lock_btn_label.bind("<Button-1>", lambda e: self._toggle_lock())
+        self.lock_frame.bind("<Button-1>", lambda e: self._toggle_lock())
+        self.lock_btn_label.bind("<Button-3>", self._on_lock_btn_right_click)
+        self._attach_hover(
+            self.lock_btn_label,
+            lambda: "باز کردن قفل ویجت (🔓)" if self.config.get("locked") else "قفل روی صفحه و عبوردهی کلیک (🔒)",
+            base_fg_fn=lambda: "#FBBF24" if self.config.get("locked") else self.config.get("accent_color", "#38BDF8"),
+            hover_bg="#334155",
+            hover_fg="#FDE047",
+        )
+
+    def _on_lock_btn_right_click(self, event):
+        if not self.config.get("locked", False):
+            self._show_context_menu(event)
+
+    def _position_lock_window(self):
+        if not self.lock_win or not self.widget_win:
+            return
+        wx = self.widget_win.winfo_x()
+        wy = self.widget_win.winfo_y()
+        sz = self.LOCK_BTN_SIZE
+        lx = wx + self.LOCK_OFFSET_X
+        ly = wy + self.LOCK_OFFSET_Y
+        self.lock_win.geometry(f"{sz}x{sz}+{int(lx)}+{int(ly)}")
+
+    def _get_dev_copy_data(self) -> dict:
+        """محاسبه لحظه‌ای ۱۰ فرمت پرکاربرد تاریخ و ساعت برای API + مقادیر GUID"""
+        now_utc = datetime.now(timezone.utc)
+        now_teh = now_utc.astimezone(TEHRAN_TZ)
+        jy, jm, jd = gregorian_to_jalali(now_teh.year, now_teh.month, now_teh.day)
+
+        ms_teh = now_teh.microsecond // 1000
+        ms_utc = now_utc.microsecond // 1000
+
+        fmt_1_utc_iso = f"{now_utc.strftime('%Y-%m-%dT%H:%M:%S')}.{ms_utc:03d}Z"
+        fmt_2_teh_iso = f"{now_teh.strftime('%Y-%m-%dT%H:%M:%S')}.{ms_teh:03d}+03:30"
+        fmt_3_sql_dt = f"{now_teh.strftime('%Y-%m-%d %H:%M:%S')}.{ms_teh:03d}"
+        fmt_4_jalali_dt = f"{jy:04d}/{jm:02d}/{jd:02d} {now_teh.strftime('%H:%M:%S')}.{ms_teh:03d}"
+
+        fmt_5_greg_date = now_teh.strftime("%Y-%m-%d")
+        fmt_6_jalali_date = f"{jy:04d}/{jm:02d}/{jd:02d}"
+
+        fmt_7_time_ms = f"{now_teh.strftime('%H:%M:%S')}.{ms_teh:03d}"
+        fmt_8_time_std = now_teh.strftime("%H:%M:%S")
+
+        unix_ms = int(now_utc.timestamp() * 1000)
+        unix_sec = int(now_utc.timestamp())
+        fmt_9_unix_ms = str(unix_ms)
+        fmt_10_unix_sec = str(unix_sec)
+
+        new_guid_lower = str(uuid.uuid4())
+        new_guid_upper = new_guid_lower.upper()
+        new_guid_no_dash = new_guid_lower.replace("-", "")
+        empty_guid = "00000000-0000-0000-0000-000000000000"
+
+        json_payload = json.dumps(
+            {
+                "utc_iso": fmt_1_utc_iso,
+                "tehran_iso": fmt_2_teh_iso,
+                "sql_datetime": fmt_3_sql_dt,
+                "jalali_datetime": fmt_4_jalali_dt,
+                "date_gregorian": fmt_5_greg_date,
+                "date_jalali": fmt_6_jalali_date,
+                "time_ms": fmt_7_time_ms,
+                "time_std": fmt_8_time_std,
+                "unix_ms": unix_ms,
+                "unix_sec": unix_sec,
+                "guid": new_guid_lower,
+            },
+            ensure_ascii=False,
+        )
+
+        return {
+            "fmt_1_utc_iso": fmt_1_utc_iso,
+            "fmt_2_teh_iso": fmt_2_teh_iso,
+            "fmt_3_sql_dt": fmt_3_sql_dt,
+            "fmt_4_jalali_dt": fmt_4_jalali_dt,
+            "fmt_5_greg_date": fmt_5_greg_date,
+            "fmt_6_jalali_date": fmt_6_jalali_date,
+            "fmt_7_time_ms": fmt_7_time_ms,
+            "fmt_8_time_std": fmt_8_time_std,
+            "fmt_9_unix_ms": fmt_9_unix_ms,
+            "fmt_10_unix_sec": fmt_10_unix_sec,
+            "new_guid_lower": new_guid_lower,
+            "new_guid_upper": new_guid_upper,
+            "new_guid_no_dash": new_guid_no_dash,
+            "empty_guid": empty_guid,
+            "json_payload": json_payload,
+        }
+
+    def _toggle_dev_popup_window(self, event=None):
+        """
+        نمایش پنجره شناور اختصاصی کپی زمان برنامه‌نویسی (۱۰ فرمت API) و GUID
+        با فاصله استاندارد از ویجت و در بالاترین لایه (Topmost) تا هرگز زیر ویجت نرود.
+        """
+        if self.config.get("locked", False):
+            return "break"
+        if self.dev_popup_win and self.dev_popup_win.winfo_exists():
+            self._close_dev_popup_window()
+            return "break"
+        # جلوگیری از باز شدن مجدد در همان کلیک وقتی FocusOut پنجره را تازه بسته است
+        if time.monotonic() - getattr(self, "_dev_popup_closed_ts", 0.0) < 0.28:
+            return "break"
+
+        d = self._get_dev_copy_data()
+        font_fa = self.config.get("font_family", "Vazir")
+
+        win = tk.Toplevel(self.root)
+        self.dev_popup_win = win
+        win.title("ابزار کپی زمان API و GUID")
+        win.overrideredirect(True)
+        win.attributes("-topmost", True)
+        win.configure(bg="#0F172A")
+
+        outer = tk.Frame(
+            win,
+            bg="#0F172A",
+            highlightbackground="#38BDF8",
+            highlightthickness=1,
+            padx=10,
+            pady=8,
+        )
+        outer.pack(fill="both", expand=True)
+
+        # هدر پنل
+        hdr = tk.Frame(outer, bg="#0F172A")
+        hdr.pack(fill="x", pady=(0, 6))
+        tk.Label(
+            hdr,
+            text="📋 کپی سریع تاریخ، ساعت API و تولید GUID",
+            font=(font_fa, 9, "bold"),
+            fg="#38BDF8",
+            bg="#0F172A",
+        ).pack(side="right")
+
+        close_lbl = tk.Label(
+            hdr,
+            text="✕",
+            font=("Segoe UI", 9, "bold"),
+            fg="#94A3B8",
+            bg="#1E293B",
+            padx=6,
+            pady=1,
+            cursor="hand2",
+        )
+        close_lbl.pack(side="left")
+        close_lbl.bind("<Button-1>", lambda e: self._close_dev_popup_window())
+        close_lbl.bind("<Enter>", lambda e: close_lbl.configure(bg="#EF4444", fg="#FFFFFF"))
+        close_lbl.bind("<Leave>", lambda e: close_lbl.configure(bg="#1E293B", fg="#94A3B8"))
+
+        def add_section_title(txt: str):
+            tk.Label(
+                outer,
+                text=txt,
+                font=(font_fa, 8, "bold"),
+                fg="#FBBF24",
+                bg="#0F172A",
+                anchor="e",
+            ).pack(fill="x", pady=(4, 2))
+
+        def add_copy_row(title_txt: str, value_txt: str, copy_fn_or_val, toast_msg: str = "✓ کپی شد!"):
+            row = tk.Frame(outer, bg="#1E293B", padx=6, pady=3, cursor="hand2")
+            row.pack(fill="x", pady=1)
+
+            val_lbl = tk.Label(
+                row,
+                text=value_txt,
+                font=("Consolas", 8, "bold"),
+                fg="#38BDF8",
+                bg="#1E293B",
+                anchor="w",
+                cursor="hand2",
+            )
+            val_lbl.pack(side="left")
+
+            t_lbl = tk.Label(
+                row,
+                text=title_txt,
+                font=(font_fa, 8),
+                fg="#E2E8F0",
+                bg="#1E293B",
+                anchor="e",
+                cursor="hand2",
+            )
+            t_lbl.pack(side="right")
+
+            def on_click(e=None):
+                val = copy_fn_or_val() if callable(copy_fn_or_val) else copy_fn_or_val
+                self._copy_to_clipboard(val, toast_msg)
+                self._close_dev_popup_window()
+
+            def on_enter(e=None):
+                row.configure(bg="#0284C7")
+                val_lbl.configure(bg="#0284C7", fg="#FFFFFF")
+                t_lbl.configure(bg="#0284C7", fg="#FFFFFF")
+
+            def on_leave(e=None):
+                row.configure(bg="#1E293B")
+                val_lbl.configure(bg="#1E293B", fg="#38BDF8")
+                t_lbl.configure(bg="#1E293B", fg="#E2E8F0")
+
+            for w in (row, val_lbl, t_lbl):
+                w.bind("<Button-1>", on_click)
+                w.bind("<Enter>", on_enter)
+                w.bind("<Leave>", on_leave)
+
+        # بخش اول: تولید و کپی GUID (UUID v4)
+        add_section_title("🔑 تولید و کپی GUID (UUID v4):")
+        add_copy_row("🎲 رندر GUID جدید (استاندارد)", d["new_guid_lower"], lambda: str(uuid.uuid4()), "✓ GUID کپی شد!")
+        add_copy_row("🎲 رندر GUID (حروف بزرگ)", d["new_guid_upper"], lambda: str(uuid.uuid4()).upper(), "✓ GUID (Upper) کپی شد!")
+        add_copy_row("🎲 رندر GUID (بدون خط تیره)", d["new_guid_no_dash"], lambda: uuid.uuid4().hex, "✓ GUID (Hex) کپی شد!")
+        add_copy_row("🎲 کپی Empty GUID (صفر)", d["empty_guid"], d["empty_guid"], "✓ Empty GUID کپی شد!")
+
+        # بخش دوم: ۱۰ فرمت پرکاربرد تاریخ و ساعت برای API
+        add_section_title("📅+🕒 تاریخ و ساعت با هم (Date & Time - API):")
+        add_copy_row("۱. ISO-8601 UTC (با میلی‌ثانیه)", d["fmt_1_utc_iso"], d["fmt_1_utc_iso"])
+        add_copy_row("۲. ISO-8601 تهران (با میلی‌ثانیه)", d["fmt_2_teh_iso"], d["fmt_2_teh_iso"])
+        add_copy_row("۳. SQL / API DateTime", d["fmt_3_sql_dt"], d["fmt_3_sql_dt"])
+        add_copy_row("۴. تاریخ و ساعت شمسی (با ms)", d["fmt_4_jalali_dt"], d["fmt_4_jalali_dt"])
+
+        add_section_title("📅 فقط تاریخ جدا (Date Only):")
+        add_copy_row("۵. فقط تاریخ میلادی (Gregorian)", d["fmt_5_greg_date"], d["fmt_5_greg_date"])
+        add_copy_row("۶. فقط تاریخ شمسی (Jalali)", d["fmt_6_jalali_date"], d["fmt_6_jalali_date"])
+
+        add_section_title("🕒 فقط ساعت جدا (Time Only) و تایم‌استمپ:")
+        add_copy_row("۷. فقط ساعت + میلی‌ثانیه (تهران)", d["fmt_7_time_ms"], d["fmt_7_time_ms"])
+        add_copy_row("۸. فقط ساعت استاندارد (HH:MM:SS)", d["fmt_8_time_std"], d["fmt_8_time_std"])
+        add_copy_row("۹. Unix Timestamp (میلی‌ثانیه ms)", d["fmt_9_unix_ms"], d["fmt_9_unix_ms"])
+        add_copy_row("۱۰. Unix Timestamp (ثانیه sec)", d["fmt_10_unix_sec"], d["fmt_10_unix_sec"])
+
+        add_copy_row("📦 کپی همه موارد به صورت JSON", "{ ... }", d["json_payload"], "✓ JSON کپی شد!")
+
+        win.update_idletasks()
+        pw = max(370, win.winfo_reqwidth())
+        ph = win.winfo_reqheight()
+
+        wx = self.widget_win.winfo_x()
+        wy = self.widget_win.winfo_y()
+        ww = self.compact_w
+        wh = self.compact_h
+        screen_w = self.root.winfo_screenwidth()
+        screen_h = self.root.winfo_screenheight()
+
+        # قرارگیری با فاصله ۱۲ پیکسلی در پایین یا بالای ویجت (بدون همپوشانی با خود ویجت)
+        px = wx + ww - pw
+        px = max(10, min(px, screen_w - pw - 10))
+        if wy + wh + 12 + ph <= screen_h - 40:
+            py = wy + wh + 12
+        elif wy - ph - 12 >= 10:
+            py = wy - ph - 12
+        else:
+            # در کنار ویجت با فاصله ۱۲ پیکسل
+            if wx - pw - 12 >= 10:
+                px = wx - pw - 12
+            else:
+                px = min(screen_w - pw - 10, wx + ww + 12)
+            py = max(10, min(wy, screen_h - ph - 40))
+
+        win.geometry(f"{pw}x{ph}+{int(px)}+{int(py)}")
+        hide_from_taskbar(win)
+        apply_rounded_corners(win, pw, ph, radius=12, enabled=True)
+        apply_z_order_and_clickthrough(win, "topmost", click_through=False)
+        win.lift()
+        win.bind("<Escape>", lambda e: self._close_dev_popup_window())
+        win.after(60, lambda: win.winfo_exists() and win.focus_force())
+        win.after(180, lambda: win.winfo_exists() and win.bind("<FocusOut>", self._on_dev_popup_focus_out))
+        return "break"
+
+    def _on_dev_popup_focus_out(self, event=None):
+        if self.dev_popup_win is None or not self.dev_popup_win.winfo_exists():
+            return
+        try:
+            foc = self.root.focus_get()
+            if foc is not None and str(foc).startswith(str(self.dev_popup_win)):
+                return
+        except Exception:
+            pass
+        self._dev_popup_closed_ts = time.monotonic()
+        self._close_dev_popup_window()
+
+    def _close_dev_popup_window(self):
+        if self.dev_popup_win is not None:
+            self._dev_popup_closed_ts = time.monotonic()
+            try:
+                self.dev_popup_win.destroy()
+            except Exception:
+                pass
+            self.dev_popup_win = None
+
+    def _build_dev_copy_menu(self):
+        """منوی آبشاری کپی زمان و GUID برای منوی راست‌کلیک System Tray"""
+        self.copy_menu = tk.Menu(
+            self.root,
+            tearoff=0,
+            bg="#0F172A",
+            fg="#F8FAFC",
+            activebackground="#0284C7",
+            activeforeground="#FFFFFF",
+            font=("Consolas", 9),
+        )
+
+    def _populate_dev_copy_menu(self):
+        self.copy_menu.delete(0, "end")
+        d = self._get_dev_copy_data()
+
+        self.copy_menu.add_command(label="─── 🔑 GUID / UUID v4 Generator ───", state="disabled")
+        self.copy_menu.add_command(
+            label=f"🎲 Render & Copy GUID (v4):   {d['new_guid_lower']}",
+            command=lambda: self._copy_to_clipboard(str(uuid.uuid4()), "✓ GUID کپی شد!"),
+        )
+        self.copy_menu.add_command(
+            label=f"🎲 Render GUID (UPPERCASE):   {d['new_guid_upper']}",
+            command=lambda: self._copy_to_clipboard(str(uuid.uuid4()).upper(), "✓ GUID (Upper) کپی شد!"),
+        )
+        self.copy_menu.add_command(
+            label=f"🎲 Render GUID (No Hyphens):  {d['new_guid_no_dash']}",
+            command=lambda: self._copy_to_clipboard(uuid.uuid4().hex, "✓ GUID (Hex) کپی شد!"),
+        )
+        self.copy_menu.add_command(
+            label=f"🎲 Copy Empty GUID (0000...): {d['empty_guid']}",
+            command=lambda: self._copy_to_clipboard(d["empty_guid"], "✓ Empty GUID کپی شد!"),
+        )
+
+        self.copy_menu.add_separator()
+        self.copy_menu.add_command(label="─── 📅+🕒 Date & Time (API / ISO / DB) ───", state="disabled")
+        for lbl, val in [
+            (f"1. ISO-8601 UTC (ms):     {d['fmt_1_utc_iso']}", d["fmt_1_utc_iso"]),
+            (f"2. ISO-8601 Tehran (ms):  {d['fmt_2_teh_iso']}", d["fmt_2_teh_iso"]),
+            (f"3. SQL / API DateTime:    {d['fmt_3_sql_dt']}", d["fmt_3_sql_dt"]),
+            (f"4. Jalali DateTime (ms):  {d['fmt_4_jalali_dt']}", d["fmt_4_jalali_dt"]),
+        ]:
+            self.copy_menu.add_command(label=lbl, command=lambda v=val: self._copy_to_clipboard(v))
+
+        self.copy_menu.add_separator()
+        self.copy_menu.add_command(label="─── 📅 Date Only (فقط تاریخ جدا) ───", state="disabled")
+        for lbl, val in [
+            (f"5. Date Only (Gregorian): {d['fmt_5_greg_date']}", d["fmt_5_greg_date"]),
+            (f"6. Date Only (Jalali):    {d['fmt_6_jalali_date']}", d["fmt_6_jalali_date"]),
+        ]:
+            self.copy_menu.add_command(label=lbl, command=lambda v=val: self._copy_to_clipboard(v))
+
+        self.copy_menu.add_separator()
+        self.copy_menu.add_command(label="─── 🕒 Time Only & Unix Epoch ───", state="disabled")
+        for lbl, val in [
+            (f"7. Time Only + ms (Teh):  {d['fmt_7_time_ms']}", d["fmt_7_time_ms"]),
+            (f"8. Time Only (HH:MM:SS):  {d['fmt_8_time_std']}", d["fmt_8_time_std"]),
+            (f"9.  Unix Timestamp (ms):  {d['fmt_9_unix_ms']}", d["fmt_9_unix_ms"]),
+            (f"10. Unix Timestamp (sec): {d['fmt_10_unix_sec']}", d["fmt_10_unix_sec"]),
+        ]:
+            self.copy_menu.add_command(label=lbl, command=lambda v=val: self._copy_to_clipboard(v))
+
+        self.copy_menu.add_separator()
+        self.copy_menu.add_command(
+            label="📦 Copy All as JSON Object",
+            command=lambda v=d["json_payload"]: self._copy_to_clipboard(v, "✓ JSON کپی شد!"),
+        )
+
+    def _copy_to_clipboard(self, text_val: str, toast_msg: str = "✓ کپی شد!"):
+        self.root.clipboard_clear()
+        self.root.clipboard_append(text_val)
+        self.root.update()
+        self._show_toast(toast_msg)
+
+    def _show_toast(self, msg: str):
+        self._toast_text = msg
+        self._refresh_display()
+
+        def _clear():
+            self._toast_text = ""
+            self._refresh_display()
+
+        self.root.after(1600, _clear)
+
+    def _build_calendar_window(self):
+        self.cal_win = tk.Toplevel(self.root)
+        self.cal_win.overrideredirect(True)
+        bg = self.config["bg_color"]
+        self.cal_win.configure(bg=bg)
+
+        self.cal_frame = tk.Frame(
+            self.cal_win,
+            bg=bg,
+            highlightbackground=self.config["border_color"],
+            highlightthickness=1,
+            padx=12,
+            pady=10,
+        )
+        self.cal_frame.pack(fill="both", expand=True)
+
+        self.cal_header = tk.Frame(self.cal_frame, bg=bg)
+        self.cal_header.pack(fill="x", pady=(0, 6))
+
+        self.next_month_btn = tk.Label(
+            self.cal_header,
+            text="‹",
+            font=("Segoe UI", 13, "bold"),
+            fg=self.config["clock_color"],
+            bg="#1E2638",
+            padx=8,
+            pady=0,
+            cursor="hand2",
+        )
+        self.next_month_btn.pack(side="left")
+        self.next_month_btn.bind("<Button-1>", lambda e: self._change_month(1))
+        self._attach_hover(
+            self.next_month_btn,
+            "ماه بعد",
+            base_fg_fn=lambda: self.config.get("clock_color", "#F8FAFC"),
+            hover_bg="#0284C7",
+            hover_fg="#FFFFFF",
+            base_bg_fn=lambda: "#1E2638",
+        )
+
+        self.today_btn = tk.Label(
+            self.cal_header,
+            text="امروز",
+            font=(self.config["font_family"], 8, "bold"),
+            fg=self.config["accent_color"],
+            bg="#1E2638",
+            padx=6,
+            pady=2,
+            cursor="hand2",
+        )
+        self.today_btn.pack(side="left", padx=(4, 0))
+        self.today_btn.bind("<Button-1>", lambda e: self._go_to_today())
+        self._attach_hover(
+            self.today_btn,
+            "بازگشت به تاریخ امروز",
+            base_fg_fn=lambda: self.config.get("accent_color", "#38BDF8"),
+            hover_bg="#0284C7",
+            hover_fg="#FFFFFF",
+            base_bg_fn=lambda: "#1E2638",
+        )
+
+        self.prev_month_btn = tk.Label(
+            self.cal_header,
+            text="›",
+            font=("Segoe UI", 13, "bold"),
+            fg=self.config["clock_color"],
+            bg="#1E2638",
+            padx=8,
+            pady=0,
+            cursor="hand2",
+        )
+        self.prev_month_btn.pack(side="right")
+        self.prev_month_btn.bind("<Button-1>", lambda e: self._change_month(-1))
+        self._attach_hover(
+            self.prev_month_btn,
+            "ماه قبل",
+            base_fg_fn=lambda: self.config.get("clock_color", "#F8FAFC"),
+            hover_bg="#0284C7",
+            hover_fg="#FFFFFF",
+            base_bg_fn=lambda: "#1E2638",
+        )
+
+        self.cal_title_canvas = tk.Canvas(
+            self.cal_header,
+            height=26,
+            bg=bg,
+            highlightthickness=0,
+        )
+        self.cal_title_canvas.pack(side="right", fill="x", expand=True)
+
+        self.week_header = tk.Frame(self.cal_frame, bg=bg)
+        self.week_header.pack(fill="x", pady=(0, 4))
+        self.week_canvases: list[tk.Canvas] = []
+        for col_idx in range(7):
+            c_canvas = tk.Canvas(
+                self.week_header,
+                width=36,
+                height=22,
+                bg=bg,
+                highlightthickness=0,
+            )
+            c_canvas.grid(row=0, column=col_idx, sticky="nsew", padx=1)
+            self.week_header.grid_columnconfigure(col_idx, weight=1)
+            self.week_canvases.append(c_canvas)
+
+        self.days_grid_frame = tk.Frame(self.cal_frame, bg=bg)
+        self.days_grid_frame.pack(fill="x", pady=(0, 6))
+
+        self.day_cells: list[tk.Canvas] = []
+        for r in range(6):
+            self.days_grid_frame.grid_rowconfigure(r, weight=1)
+            for c in range(7):
+                self.days_grid_frame.grid_columnconfigure(c, weight=1)
+                cell = tk.Canvas(
+                    self.days_grid_frame,
+                    width=36,
+                    height=28,
+                    bg=bg,
+                    highlightthickness=0,
+                    cursor="hand2",
+                )
+                cell.grid(row=r, column=c, sticky="nsew", padx=1, pady=1)
+                self.day_cells.append(cell)
+
+        self.cal_sep = tk.Frame(self.cal_frame, bg=self.config["border_color"], height=1)
+        self.cal_sep.pack(fill="x", pady=(2, 6))
+
+        self.detail_canvas = tk.Canvas(
+            self.cal_frame,
+            height=74,
+            bg=bg,
+            highlightthickness=0,
+        )
+        self.detail_canvas.pack(fill="both", expand=True)
+
+        self.cal_bottom_bar = tk.Frame(self.cal_frame, bg=bg)
+        self.cal_bottom_bar.pack(fill="x", pady=(4, 0))
+
+        self.add_event_btn = tk.Label(
+            self.cal_bottom_bar,
+            text="⏰ + آلارم / رویداد",
+            font=(self.config["font_family"], 8, "bold"),
+            fg="#FBBF24",
+            bg="#1E2638",
+            padx=7,
+            pady=3,
+            cursor="hand2",
+        )
+        self.add_event_btn.pack(side="right")
+        self.add_event_btn.bind("<Button-1>", lambda e: self.open_alarm_manager())
+        self._attach_hover(
+            self.add_event_btn,
+            "افزودن یا ویرایش آلارم و رویداد با انتخاب چندروزه",
+            base_fg_fn=lambda: "#FBBF24",
+            hover_bg="#D97706",
+            hover_fg="#FFFFFF",
+            base_bg_fn=lambda: "#1E2638",
+        )
+
+        self.add_occasion_btn = tk.Label(
+            self.cal_bottom_bar,
+            text="🎂 + مناسبت / تولد",
+            font=(self.config["font_family"], 8, "bold"),
+            fg="#F472B6",
+            bg="#1E2638",
+            padx=7,
+            pady=3,
+            cursor="hand2",
+        )
+        self.add_occasion_btn.pack(side="right", padx=(0, 6))
+        self.add_occasion_btn.bind("<Button-1>", lambda e: self.open_custom_occasions_manager())
+        self._attach_hover(
+            self.add_occasion_btn,
+            "ثبت تولد دوستان و مناسبت‌های شخصی روی تقویم + آلارم روز قبل",
+            base_fg_fn=lambda: "#F472B6",
+            hover_bg="#DB2777",
+            hover_fg="#FFFFFF",
+            base_bg_fn=lambda: "#1E2638",
+        )
+
+        self.cal_copyright_lbl = tk.Label(
+            self.cal_bottom_bar,
+            text="® Shayan Bamyar",
+            font=("Segoe UI", 7, "bold"),
+            fg="#64748B",
+            bg=bg,
+        )
+        self.cal_copyright_lbl.pack(side="left")
+
+        self.cal_win.bind("<Button-3>", self._show_context_menu)
+
+        if not self.config.get("calendar_expanded", False):
+            self.cal_win.withdraw()
+
+    def _render_calendar_month(self):
+        month_data = get_month_calendar(self.view_jy, self.view_jm, CUSTOM_OCCASIONS_PATH)
+        use_fa = self.config.get("persian_digits", False)
+        bg = self.config["bg_color"]
+        font_fa = self.config.get("font_family", "Vazir")
+
+        self.cal_title_canvas.configure(bg=bg)
+        self.cal_title_canvas.delete("all")
+        self.cal_title_canvas.update_idletasks()
+        tw = max(140, self.cal_title_canvas.winfo_width())
+        draw_outlined_canvas_text(
+            self.cal_title_canvas,
+            tw // 2,
+            13,
+            text=format_digits(month_data["header_title"], use_fa),
+            font_spec=(font_fa, 10, "bold"),
+            fill=self.config["clock_color"],
+            outline="#000000",
+        )
+
+        for col_idx, w_canvas in enumerate(self.week_canvases):
+            p_idx = 6 - col_idx
+            day_short = PERSIAN_WEEK_SHORT[p_idx]
+            fg_color = self.config["holiday_color"] if p_idx == 6 else self.config["occasion_color"]
+            w_canvas.configure(bg=bg)
+            w_canvas.delete("all")
+            draw_outlined_canvas_text(
+                w_canvas,
+                18,
+                11,
+                text=day_short,
+                font_spec=(font_fa, 8, "bold"),
+                fill=fg_color,
+                outline="#000000",
+            )
+
+        for cell in self.day_cells:
+            cell.configure(bg=bg, cursor="arrow")
+            cell.delete("all")
+            cell.unbind("<Button-1>")
+            cell.unbind("<Enter>")
+            cell.unbind("<Leave>")
+
+        first_week_idx = month_data["first_day_week_idx"]
+
+        for day_info in month_data["days"]:
+            d = day_info["jd"]
+            offset = first_week_idx + (d - 1)
+            row = offset // 7
+            persian_col = offset % 7
+            grid_col = 6 - persian_col
+            cell_idx = row * 7 + grid_col
+            if cell_idx >= len(self.day_cells):
+                continue
+
+            cell = self.day_cells[cell_idx]
+            day_str = format_digits(str(d), use_fa)
+
+            user_alarms = self.alarm_store.get_events_for_jalali_day(
+                day_info["jy"], day_info["jm"], day_info["jd"], day_info["persian_week_idx"]
+            )
+            has_any_event = day_info["has_occasion"] or len(user_alarms) > 0
+
+            is_today = (
+                day_info["jy"] == self.current_jy
+                and day_info["jm"] == self.current_jm
+                and day_info["jd"] == self.current_jd
+            )
+            is_selected = (
+                self.selected_day_info
+                and day_info["jy"] == self.selected_day_info["jy"]
+                and day_info["jm"] == self.selected_day_info["jm"]
+                and day_info["jd"] == self.selected_day_info["jd"]
+            )
+
+            if is_today:
+                cell_bg = "#0369A1"
+                cell_fg = "#FFFFFF"
+            elif is_selected:
+                cell_bg = "#334155"
+                cell_fg = self.config["holiday_color"] if day_info["is_holiday"] else "#FFFFFF"
+            else:
+                cell_bg = bg
+                cell_fg = self.config["holiday_color"] if day_info["is_holiday"] else self.config["clock_color"]
+
+            cell.configure(bg=cell_bg, cursor="hand2")
+            draw_outlined_canvas_text(
+                cell,
+                18,
+                12,
+                text=day_str,
+                font_spec=(font_fa, 9, "bold" if (is_today or is_selected) else "normal"),
+                fill=cell_fg,
+                outline="#000000",
+            )
+            if has_any_event:
+                dot_color = "#FBBF24" if user_alarms else self.config["accent_color"]
+                cell.create_oval(16, 22, 20, 26, fill=dot_color, outline="#000000")
+
+            cell.bind("<Button-1>", lambda e, info=day_info: self._on_day_clicked(info))
+            if not is_today and not is_selected:
+                cell.bind("<Enter>", lambda e, c=cell: c.configure(bg="#1E293B"))
+                cell.bind("<Leave>", lambda e, c=cell, b=cell_bg: c.configure(bg=b))
+
+        self._update_selected_day_panel()
+
+    def _on_day_clicked(self, day_info: dict):
+        if self.config.get("locked", False):
+            return
+        self.selected_day_info = day_info
+        self._render_calendar_month()
+
+    def _update_selected_day_panel(self):
+        info = self.selected_day_info
+        if not info:
+            return
+        use_fa = self.config.get("persian_digits", False)
+        bg = self.config["bg_color"]
+        font_fa = self.config.get("font_family", "Vazir")
+
+        self.detail_canvas.configure(bg=bg)
+        self.detail_canvas.delete("all")
+        cw = self.calendar_w - 28
+
+        status_badge = " (تعطیل)" if info["is_holiday"] else ""
+        header_text = format_digits(f"{info['date_text']}{status_badge}", use_fa)
+
+        draw_outlined_canvas_text(
+            self.detail_canvas,
+            cw - 4,
+            4,
+            text=header_text,
+            font_spec=(font_fa, 9, "bold"),
+            fill=self.config["holiday_color"] if info["is_holiday"] else self.config["accent_color"],
+            outline="#000000",
+            anchor="ne",
+            justify="right",
+        )
+
+        lines = []
+        for title, is_hol in info.get("events", []):
+            prefix = "🔴 " if is_hol else "• "
+            lines.append(f"{prefix}{title}")
+
+        user_alarms = self.alarm_store.get_events_for_jalali_day(
+            info["jy"], info["jm"], info["jd"], info["persian_week_idx"]
+        )
+        for a in user_alarms:
+            t_str = f"{int(a.get('hour', 0)):02d}:{int(a.get('minute', 0)):02d}"
+            lines.append(f"⏰ {t_str} - {a.get('title', '')}")
+
+        if lines:
+            occ_text = format_digits("\n".join(lines[:3]), use_fa)
+            draw_outlined_canvas_text(
+                self.detail_canvas,
+                cw - 4,
+                26,
+                text=occ_text,
+                font_spec=(font_fa, 8),
+                fill=self.config["holiday_color"] if (info["is_holiday"] and info["has_occasion"]) else self.config["date_color"],
+                outline="#000000",
+                anchor="ne",
+                justify="right",
+                width=cw - 8,
+            )
+
+    def _change_month(self, delta: int):
+        if self.config.get("locked", False):
+            return
+        new_jm = self.view_jm + delta
+        new_jy = self.view_jy
+        if new_jm > 12:
+            new_jm = 1
+            new_jy += 1
+        elif new_jm < 1:
+            new_jm = 12
+            new_jy -= 1
+        self.view_jy = new_jy
+        self.view_jm = new_jm
+        month_data = get_month_calendar(self.view_jy, self.view_jm, CUSTOM_OCCASIONS_PATH)
+        if self.view_jy == self.current_jy and self.view_jm == self.current_jm:
+            for d_info in month_data["days"]:
+                if d_info["jd"] == self.current_jd:
+                    self.selected_day_info = d_info
+                    break
+        else:
+            self.selected_day_info = month_data["days"][0]
+        self._render_calendar_month()
+
+    def _go_to_today(self):
+        if self.config.get("locked", False):
+            return
+        today = get_today_info(CUSTOM_OCCASIONS_PATH)
+        self.view_jy = today["jy"]
+        self.view_jm = today["jm"]
+        self.selected_day_info = today
+        self._render_calendar_month()
+
+    def _toggle_calendar(self, event=None):
+        if event is not None and self.config.get("locked", False):
+            return "break"
+        expanded = not self.config.get("calendar_expanded", False)
+        self.config["calendar_expanded"] = expanded
+        self._save_config()
+        self._sync_calendar_visibility()
+        return "break"
+
+    def _sync_calendar_visibility(self):
+        expanded = self.config.get("calendar_expanded", False)
+        is_locked = bool(self.config.get("locked", False))
+        z_mode = self.config.get("z_mode", "topmost")
+
+        if expanded:
+            today = get_today_info(CUSTOM_OCCASIONS_PATH)
+            self.view_jy = today["jy"]
+            self.view_jm = today["jm"]
+            if not self.selected_day_info:
+                self.selected_day_info = today
+            self._position_calendar_window()
+            self.cal_win.deiconify()
+            self._render_calendar_month()
+            hide_from_taskbar(self.cal_win)
+            apply_rounded_corners(self.cal_win, self.calendar_w, self.calendar_h, radius=16, enabled=True)
+            cal_alpha = max(0.85, float(self.config.get("opacity", 0.90)))
+            if is_locked and cal_alpha >= 1.0:
+                cal_alpha = 0.99
+            self.cal_win.attributes("-alpha", cal_alpha)
+            apply_z_order_and_clickthrough(self.cal_win, z_mode, click_through=is_locked)
+            self.extend_btn.configure(text="▸ بستن")
+        else:
+            if self.cal_win:
+                self.cal_win.withdraw()
+            self.extend_btn.configure(text="◂ تقویم")
+
+    def _position_calendar_window(self):
+        if not self.cal_win or not self.widget_win:
+            return
+        screen_w = self.root.winfo_screenwidth()
+        screen_h = self.root.winfo_screenheight()
+        cw, ch = self.calendar_w, self.calendar_h
+
+        # در صورتی که ویجت دسکتاپ مخفی است (نمایش فقط در تسک‌بار)، تقویم دقیقاً بالای ساعت گوشه تسک‌بار باز شود
+        hide_desktop = (
+            bool(self.config.get("replace_windows_clock", False))
+            and bool(self.config.get("replace_clock_hide_widget", False))
+        )
+        if hide_desktop or not self.widget_win.winfo_viewable():
+            cx = screen_w - cw - 12
+            cy = screen_h - ch - 54
+            self.cal_win.geometry(f"{cw}x{ch}+{int(cx)}+{int(cy)}")
+            return
+
+        wx = self.widget_win.winfo_x()
+        wy = self.widget_win.winfo_y()
+        ww, wh = self.compact_w, self.compact_h
+
+        mode = self.config.get("calendar_position", "beside")
+        if mode == "below":
+            cx = wx + ww - cw
+            cy = wy + wh + self.GAP
+            if cy + ch > screen_h - 40:
+                cy = wy - ch - self.GAP
+        else:
+            if wx - cw - self.GAP >= 10:
+                cx = wx - cw - self.GAP
+            else:
+                cx = wx + ww + self.GAP
+            cy = wy
+            if cy + ch > screen_h - 48:
+                cy = max(10, screen_h - ch - 48)
+
+        cx = max(8, min(cx, screen_w - cw - 8))
+        cy = max(8, min(cy, screen_h - ch - 8))
+        self.cal_win.geometry(f"{cw}x{ch}+{int(cx)}+{int(cy)}")
+
+    def open_alarm_manager(self):
+        if self.alarm_win and self.alarm_win.win and self.alarm_win.win.winfo_exists():
+            self.alarm_win.win.deiconify()
+            self.alarm_win.win.lift()
+            self.alarm_win.win.focus_force()
+            return
+
+        sel = self.selected_day_info or get_today_info(CUSTOM_OCCASIONS_PATH)
+        init_jalali = (sel["jy"], sel["jm"], sel["jd"])
+        self.alarm_win = AlarmManagerWindow(
+            root=self.root,
+            store=self.alarm_store,
+            font_family=self.config.get("font_family", "Vazir"),
+            initial_jalali=init_jalali,
+            on_change_callback=self._on_alarms_updated,
+        )
+
+    def _load_custom_occasions_dict(self) -> dict:
+        if os.path.exists(CUSTOM_OCCASIONS_PATH):
+            try:
+                with open(CUSTOM_OCCASIONS_PATH, "r", encoding="utf-8") as f:
+                    data = json.load(f)
+                    if isinstance(data, dict):
+                        return data
+            except Exception:
+                pass
+        return {}
+
+    def _save_custom_occasions_dict(self, data: dict):
+        os.makedirs(os.path.dirname(CUSTOM_OCCASIONS_PATH), exist_ok=True)
+        with open(CUSTOM_OCCASIONS_PATH, "w", encoding="utf-8") as f:
+            json.dump(data, f, ensure_ascii=False, indent=2)
+
+    def open_custom_occasions_manager(self):
+        """پنجره مدیریت مناسبت‌های شخصی و تولد دوستان + ثبت خودکار آلارم یادآور ۱ روز قبل"""
+        if self.custom_occ_win and self.custom_occ_win.winfo_exists():
+            self.custom_occ_win.deiconify()
+            self.custom_occ_win.lift()
+            self.custom_occ_win.focus_force()
+            return
+
+        font_fa = self.config.get("font_family", "Vazir")
+        sel = self.selected_day_info or get_today_info(CUSTOM_OCCASIONS_PATH)
+        init_m = int(sel.get("jm", 1))
+        init_d = int(sel.get("jd", 1))
+        init_y = int(sel.get("jy", 1405))
+
+        win = tk.Toplevel(self.root)
+        self.custom_occ_win = win
+        win.title("🎂 مدیریت مناسبت‌های شخصی و تولدها")
+        win.configure(bg="#0F172A")
+        win.attributes("-topmost", True)
+        w, h = 470, 520
+        sx = (win.winfo_screenwidth() - w) // 2
+        sy = (win.winfo_screenheight() - h) // 2
+        win.geometry(f"{w}x{h}+{sx}+{sy}")
+        win.resizable(False, False)
+
+        container = tk.Frame(win, bg="#0F172A", padx=14, pady=12)
+        container.pack(fill="both", expand=True)
+
+        tk.Label(
+            container,
+            text="🎂 ثبت روز تولد دوستان و مناسبت‌های شخصی در تقویم",
+            font=(font_fa, 10, "bold"),
+            fg="#F472B6",
+            bg="#0F172A",
+        ).pack(anchor="e", pady=(0, 8))
+
+        form = tk.LabelFrame(
+            container,
+            text=" افزودن مناسبت جدید ",
+            font=(font_fa, 9, "bold"),
+            fg="#E2E8F0",
+            bg="#1E293B",
+            bd=1,
+            padx=10,
+            pady=8,
+        )
+        form.pack(fill="x", pady=(0, 10))
+
+        # عنوان مناسبت
+        row1 = tk.Frame(form, bg="#1E293B")
+        row1.pack(fill="x", pady=3)
+        tk.Label(row1, text="عنوان:", font=(font_fa, 9), fg="#CBD5E1", bg="#1E293B").pack(side="right", padx=(6, 0))
+        title_entry = tk.Entry(
+            row1,
+            font=(font_fa, 9),
+            bg="#0F172A",
+            fg="#F8FAFC",
+            insertbackground="#F8FAFC",
+            relief="flat",
+            justify="right",
+        )
+        title_entry.pack(side="right", fill="x", expand=True, ipady=4, padx=(0, 6))
+        title_entry.focus_set()
+
+        # نوع مناسبت
+        row2 = tk.Frame(form, bg="#1E293B")
+        row2.pack(fill="x", pady=4)
+        kind_var = tk.StringVar(value="birthday")
+        holiday_var = tk.BooleanVar(value=False)
+        prev_alarm_var = tk.BooleanVar(value=True)
+
+        def on_kind_change():
+            if kind_var.get() == "birthday":
+                prev_alarm_var.set(True)
+                holiday_var.set(False)
+            elif kind_var.get() == "holiday":
+                holiday_var.set(True)
+            else:
+                holiday_var.set(False)
+
+        for val, lbl_txt, fg_c in (
+            ("birthday", "🎂 روز تولد", "#F472B6"),
+            ("personal", "🎉 مناسبت شخصی", "#38BDF8"),
+            ("holiday", "🏖 تعطیل شخصی", "#F87171"),
+        ):
+            tk.Radiobutton(
+                row2,
+                text=lbl_txt,
+                value=val,
+                variable=kind_var,
+                command=on_kind_change,
+                font=(font_fa, 8, "bold"),
+                fg=fg_c,
+                bg="#1E293B",
+                selectcolor="#0F172A",
+                activebackground="#1E293B",
+            ).pack(side="right", padx=(8, 0))
+
+        # انتخاب ماه و روز شمسی
+        row3 = tk.Frame(form, bg="#1E293B")
+        row3.pack(fill="x", pady=4)
+        tk.Label(row3, text="تاریخ شمسی:", font=(font_fa, 9), fg="#CBD5E1", bg="#1E293B").pack(side="right", padx=(6, 0))
+
+        month_names = [f"{m} - {PERSIAN_MONTHS[m]}" for m in range(1, 13)]
+        month_var = tk.StringVar(value=month_names[max(0, min(11, init_m - 1))])
+        m_menu = tk.OptionMenu(row3, month_var, *month_names)
+        m_menu.configure(
+            font=(font_fa, 8, "bold"),
+            bg="#0F172A",
+            fg="#F8FAFC",
+            activebackground="#334155",
+            highlightthickness=0,
+            bd=0,
+        )
+        m_menu["menu"].configure(bg="#0F172A", fg="#F8FAFC", font=(font_fa, 8))
+        m_menu.pack(side="right", padx=(6, 0))
+
+        tk.Label(row3, text="روز:", font=(font_fa, 9), fg="#CBD5E1", bg="#1E293B").pack(side="right", padx=(8, 4))
+        day_spin = tk.Spinbox(
+            row3,
+            from_=1,
+            to=31,
+            width=4,
+            font=("Segoe UI", 9, "bold"),
+            bg="#0F172A",
+            fg="#F8FAFC",
+            buttonbackground="#334155",
+        )
+        day_spin.delete(0, "end")
+        day_spin.insert(0, str(init_d))
+        day_spin.pack(side="right")
+
+        # تیک آلارم ۱ روز قبل (تکرار سالانه)
+        row4 = tk.Frame(form, bg="#1E293B")
+        row4.pack(fill="x", pady=(6, 2))
+        tk.Checkbutton(
+            row4,
+            text="⏰ ثبت خودکار آلارم یادآور ۱ روز قبل (تکرار سالانه)",
+            variable=prev_alarm_var,
+            font=(font_fa, 8, "bold"),
+            fg="#FBBF24",
+            bg="#1E293B",
+            selectcolor="#0F172A",
+            activebackground="#1E293B",
+            anchor="e",
+        ).pack(side="right")
+
+        row5 = tk.Frame(form, bg="#1E293B")
+        row5.pack(fill="x", pady=2)
+        tk.Label(row5, text="ساعت یادآوری روز قبل:", font=(font_fa, 8), fg="#CBD5E1", bg="#1E293B").pack(side="right", padx=(6, 0))
+        sp_m = tk.Spinbox(row5, from_=0, to=59, width=3, format="%02.0f", font=("Segoe UI", 9, "bold"), bg="#0F172A", fg="#F8FAFC", buttonbackground="#334155")
+        sp_m.delete(0, "end")
+        sp_m.insert(0, "00")
+        sp_m.pack(side="right", padx=2)
+        tk.Label(row5, text=":", font=("Segoe UI", 9, "bold"), fg="#F8FAFC", bg="#1E293B").pack(side="right")
+        sp_h = tk.Spinbox(row5, from_=0, to=23, width=3, format="%02.0f", font=("Segoe UI", 9, "bold"), bg="#0F172A", fg="#F8FAFC", buttonbackground="#334155")
+        sp_h.delete(0, "end")
+        sp_h.insert(0, "09")
+        sp_h.pack(side="right", padx=2)
+
+        status_lbl = tk.Label(form, text="", font=(font_fa, 8, "bold"), fg="#10B981", bg="#1E293B")
+        status_lbl.pack(anchor="e", pady=(2, 0))
+
+        # بخش لیست مناسبت‌های ثبت‌شده
+        list_frame = tk.LabelFrame(
+            container,
+            text=" مناسبت‌های شخصی ثبت‌شده ",
+            font=(font_fa, 9, "bold"),
+            fg="#E2E8F0",
+            bg="#1E293B",
+            bd=1,
+            padx=8,
+            pady=6,
+        )
+        list_frame.pack(fill="both", expand=True)
+
+        list_canvas = tk.Canvas(list_frame, bg="#1E293B", highlightthickness=0)
+        scrollbar = tk.Scrollbar(list_frame, orient="vertical", command=list_canvas.yview)
+        items_inner = tk.Frame(list_canvas, bg="#1E293B")
+        items_inner.bind("<Configure>", lambda e: list_canvas.configure(scrollregion=list_canvas.bbox("all")))
+        list_canvas.create_window((0, 0), window=items_inner, anchor="nw")
+        list_canvas.configure(yscrollcommand=scrollbar.set)
+        scrollbar.pack(side="left", fill="y")
+        list_canvas.pack(side="right", fill="both", expand=True)
+
+        def refresh_list():
+            for ch in items_inner.winfo_children():
+                ch.destroy()
+            data = self._load_custom_occasions_dict()
+            if not data:
+                tk.Label(
+                    items_inner,
+                    text="هنوز مناسبتی ثبت نشده است.",
+                    font=(font_fa, 8),
+                    fg="#64748B",
+                    bg="#1E293B",
+                ).pack(pady=16, padx=10)
+                return
+
+            for mmdd in sorted(data.keys()):
+                items = data.get(mmdd, [])
+                try:
+                    m_i, d_i = map(int, mmdd.split("-"))
+                    m_name = PERSIAN_MONTHS[m_i] if 1 <= m_i <= 12 else str(m_i)
+                    date_lbl = f"{d_i} {m_name}"
+                except Exception:
+                    date_lbl = mmdd
+
+                for idx_i, item in enumerate(items):
+                    t = item.get("title", "") if isinstance(item, dict) else str(item)
+                    is_h = bool(item.get("holiday", False)) if isinstance(item, dict) else False
+                    row = tk.Frame(items_inner, bg="#0F172A", padx=8, pady=5)
+                    row.pack(fill="x", pady=2, padx=2)
+
+                    def make_del(k=mmdd, ix=idx_i, occ_title=t):
+                        def _del():
+                            d_cur = self._load_custom_occasions_dict()
+                            lst = d_cur.get(k, [])
+                            if 0 <= ix < len(lst):
+                                lst.pop(ix)
+                                if lst:
+                                    d_cur[k] = lst
+                                else:
+                                    d_cur.pop(k, None)
+                                self._save_custom_occasions_dict(d_cur)
+                                # حذف آلارم یادآور سالانه مرتبط در صورت وجود
+                                clean_t = occ_title.replace("🎂 ", "").strip()
+                                expected_alarm = f"🎂 یادآور فردا: {clean_t}"
+                                before_n = len(self.alarm_store.alarms)
+                                self.alarm_store.alarms = [
+                                    a for a in self.alarm_store.alarms
+                                    if not (a.get("repeat_mode") == "yearly" and a.get("title") == expected_alarm)
+                                ]
+                                if len(self.alarm_store.alarms) != before_n:
+                                    self.alarm_store.save()
+                                self._on_alarms_updated()
+                                refresh_list()
+                        return _del
+
+                    tk.Button(
+                        row,
+                        text="🗑 حذف",
+                        font=(font_fa, 8),
+                        bg="#7F1D1D",
+                        fg="#FCA5A5",
+                        relief="flat",
+                        cursor="hand2",
+                        command=make_del(),
+                    ).pack(side="left")
+
+                    tk.Label(
+                        row,
+                        text=f"📅 {date_lbl}  —  {t}",
+                        font=(font_fa, 8, "bold"),
+                        fg="#F87171" if is_h else "#F8FAFC",
+                        bg="#0F172A",
+                        anchor="e",
+                    ).pack(side="right", fill="x", expand=True, padx=(8, 0))
+
+        def on_add_occasion():
+            raw_title = title_entry.get().strip()
+            if not raw_title:
+                status_lbl.configure(text="لطفاً عنوان مناسبت یا نام را وارد کنید.", fg="#F87171")
+                return
+            try:
+                jm = int(month_var.get().split("-")[0].strip())
+                jd = int(day_spin.get())
+                max_d = get_jalali_month_days(init_y, jm)
+                jd = max(1, min(jd, max_d))
+            except Exception:
+                status_lbl.configure(text="تاریخ واردشده معتبر نیست.", fg="#F87171")
+                return
+
+            kind = kind_var.get()
+            final_title = raw_title
+            if kind == "birthday" and "🎂" not in final_title:
+                final_title = f"🎂 {final_title}"
+
+            key = f"{jm:02d}-{jd:02d}"
+            data = self._load_custom_occasions_dict()
+            data.setdefault(key, [])
+            data[key].append({"title": final_title, "holiday": bool(holiday_var.get())})
+            self._save_custom_occasions_dict(data)
+
+            alarm_msg = ""
+            if prev_alarm_var.get():
+                try:
+                    ah = max(0, min(23, int(sp_h.get())))
+                    am = max(0, min(59, int(sp_m.get())))
+                except Exception:
+                    ah, am = 9, 0
+                if jd > 1:
+                    pm, pd = jm, jd - 1
+                else:
+                    pm = 12 if jm == 1 else jm - 1
+                    pd = get_jalali_month_days(init_y, pm)
+                prev_key = f"{pm:02d}-{pd:02d}"
+                clean_t = final_title.replace("🎂 ", "").strip()
+                self.alarm_store.add_or_update({
+                    "title": f"🎂 یادآور فردا: {clean_t}",
+                    "hour": ah,
+                    "minute": am,
+                    "repeat_mode": "yearly",
+                    "yearly_days": [prev_key],
+                    "enabled": True,
+                    "play_sound": True,
+                })
+                alarm_msg = f" + آلارم روز قبل ({pd} {PERSIAN_MONTHS[pm]} ساعت {ah:02d}:{am:02d})"
+
+            title_entry.delete(0, "end")
+            status_lbl.configure(text=f"✓ «{final_title}» ثبت شد{alarm_msg}", fg="#10B981")
+            self._on_alarms_updated()
+            refresh_list()
+
+        tk.Button(
+            form,
+            text="✓ افزودن مناسبت به تقویم",
+            font=(font_fa, 9, "bold"),
+            bg="#059669",
+            fg="#FFFFFF",
+            padx=12,
+            pady=4,
+            relief="flat",
+            cursor="hand2",
+            command=on_add_occasion,
+        ).pack(anchor="w", pady=(6, 0))
+
+        refresh_list()
+        hide_from_taskbar(win)
+        apply_rounded_corners(win, w, h, radius=14, enabled=True)
+
+    def _on_alarms_updated(self):
+        self._refresh_display()
+        if self.config.get("calendar_expanded"):
+            self._render_calendar_month()
+
+    def _on_alarm_dismissed(self, alarm: dict):
+        """وقتی آلارم بدون Snooze بسته شد، اگر یک‌باره یا تاریخ‌محور بود از لیست حذف شود"""
+        removed = self.alarm_store.on_alarm_dismissed(alarm)
+        if removed:
+            self._on_alarms_updated()
+            if self.alarm_win and self.alarm_win.win and self.alarm_win.win.winfo_exists():
+                self.alarm_win._refresh_list()
+                self.alarm_win._render_picker_calendar()
+
+    def _init_position(self):
+        screen_w = self.root.winfo_screenwidth()
+        screen_h = self.root.winfo_screenheight()
+        ww, wh = self.compact_w, self.compact_h
+
+        x = self.config.get("x")
+        y = self.config.get("y")
+        if self.config.get("locked"):
+            snap_side = self.config.get("snap_side", "right")
+            x = (screen_w - ww) if snap_side == "right" else 0
+        elif x is None or y is None:
+            x = screen_w - ww - 32
+            y = 32
+            self.config["x"] = x
+            self.config["y"] = y
+            self._save_config()
+
+        x = max(0, min(int(x), screen_w - ww))
+        y = max(0, min(int(y), screen_h - wh))
+        self.widget_win.geometry(f"{ww}x{wh}+{x}+{y}")
+        self._position_lock_window()
+
+    def _apply_all_styles(self):
+        if not self.widget_win:
+            return
+
+        hide_from_taskbar(self.widget_win)
+        if self.lock_win:
+            hide_from_taskbar(self.lock_win)
+
+        is_locked = bool(self.config.get("locked", False))
+        transparent_bg = bool(self.config.get("transparent_bg", False))
+        bg_color = self.config.get("bg_color", "#141821")
+        border_color = self.config.get("border_color", "#2A3244")
+        bg = TRANSPARENT_KEY if transparent_bg else bg_color
+
+        self.widget_win.configure(bg=bg)
+        self.main_frame.configure(
+            bg=bg,
+            highlightbackground=border_color if not transparent_bg else bg,
+            highlightthickness=0 if transparent_bg else 1,
+        )
+        self.canvas.configure(bg=bg)
+        self.btn_container.configure(bg=bg)
+
+        btn_bg = self._get_btn_base_bg()
+        font_fa = self.config.get("font_family", "Vazir")
+
+        for tip in self._tooltips:
+            tip.font_family = font_fa
+
+        self.extend_btn.configure(
+            bg=btn_bg,
+            fg=self.config.get("accent_color", "#38BDF8"),
+            font=(font_fa, 8, "bold"),
+        )
+        self.copy_time_btn.configure(bg=btn_bg, fg="#A7F3D0")
+        self.guid_btn.configure(bg=btn_bg, fg="#C4B5FD")
+        self.alarm_btn.configure(bg=btn_bg, fg="#FBBF24")
+        self.settings_btn.configure(
+            bg=btn_bg,
+            fg=self.config.get("date_color", "#CBD5E1"),
+        )
+        if hasattr(self, "min_btn"):
+            self.min_btn.configure(
+                bg=btn_bg,
+                fg=self.config.get("date_color", "#CBD5E1"),
+            )
+
+        self._refresh_display()
+
+        ww, wh = self.compact_w, self.compact_h
+        screen_w = self.root.winfo_screenwidth()
+        screen_h = self.root.winfo_screenheight()
+        cur_x = self.widget_win.winfo_x()
+        cur_y = self.widget_win.winfo_y()
+        if is_locked:
+            snap_side = self.config.get("snap_side", "right")
+            pos_x = (screen_w - ww) if snap_side == "right" else 0
+            pos_y = max(0, min(cur_y, screen_h - wh - 40))
+        else:
+            pos_x = max(0, min(cur_x, screen_w - ww))
+            pos_y = max(0, min(cur_y, screen_h - wh - 40))
+        self.widget_win.geometry(f"{ww}x{wh}+{int(pos_x)}+{int(pos_y)}")
+        self._position_lock_window()
+
+        alpha_val = float(self.config.get("opacity", 0.90))
+        if is_locked and alpha_val >= 1.0:
+            alpha_val = 0.99
+
+        if transparent_bg:
+            apply_rounded_corners(self.widget_win, ww, wh, enabled=False)
+            self.widget_win.attributes("-transparentcolor", TRANSPARENT_KEY)
+            self.widget_win.attributes("-alpha", alpha_val)
+        else:
+            self.widget_win.attributes("-transparentcolor", "")
+            self.widget_win.attributes("-alpha", alpha_val)
+            apply_rounded_corners(self.widget_win, ww, wh, radius=16, enabled=True)
+
+        z_mode = self.config.get("z_mode", "topmost")
+        if self.lock_win:
+            lock_bg = "#1E2638" if not transparent_bg else "#141821"
+            lock_border = "#F59E0B" if is_locked else border_color
+            self.lock_win.configure(bg=lock_bg)
+            self.lock_frame.configure(bg=lock_bg, highlightbackground=lock_border, highlightthickness=1)
+            self.lock_btn_label.configure(
+                text="🔒" if is_locked else "🔓",
+                fg="#FBBF24" if is_locked else self.config.get("accent_color", "#38BDF8"),
+                bg=lock_bg,
+            )
+            apply_rounded_corners(self.lock_win, self.LOCK_BTN_SIZE, self.LOCK_BTN_SIZE, radius=6, enabled=True)
+            self.lock_win.attributes("-alpha", max(0.85, alpha_val))
+            apply_z_order_and_clickthrough(self.lock_win, z_mode, click_through=False)
+
+        if self.cal_win:
+            self.cal_win.configure(bg=bg_color)
+            self.cal_frame.configure(bg=bg_color, highlightbackground=border_color)
+            self.cal_header.configure(bg=bg_color)
+            self.week_header.configure(bg=bg_color)
+            self.days_grid_frame.configure(bg=bg_color)
+            self.cal_sep.configure(bg=border_color)
+            self.cal_bottom_bar.configure(bg=bg_color)
+            self.cal_copyright_lbl.configure(bg=bg_color)
+            self.add_event_btn.configure(font=(font_fa, 8, "bold"))
+            self.today_btn.configure(font=(font_fa, 8, "bold"))
+
+        apply_z_order_and_clickthrough(
+            self.widget_win,
+            z_mode,
+            click_through=is_locked,
+        )
+        if self.lock_win:
+            apply_z_order_and_clickthrough(self.lock_win, z_mode, click_through=False)
+
+        self._sync_calendar_visibility()
+
+    def _on_drag_start(self, event):
+        if self.config.get("locked", False):
+            return
+        self._close_dev_popup_window()
+        self._is_dragging = True
+        self._drag_start_x = event.x_root - self.widget_win.winfo_x()
+        self._drag_start_y = event.y_root - self.widget_win.winfo_y()
+
+    def _on_drag_motion(self, event):
+        if not self._is_dragging or self.config.get("locked", False):
+            return
+        new_x = event.x_root - self._drag_start_x
+        new_y = event.y_root - self._drag_start_y
+        self.widget_win.geometry(f"{self.compact_w}x{self.compact_h}+{int(new_x)}+{int(new_y)}")
+        self._position_lock_window()
+        if self.config.get("calendar_expanded", False):
+            self._position_calendar_window()
+
+    def _on_drag_end(self, event):
+        if not self._is_dragging:
+            return
+        self._is_dragging = False
+        self.config["x"] = self.widget_win.winfo_x()
+        self.config["y"] = self.widget_win.winfo_y()
+        self._unlocked_x = self.config["x"]
+        self._unlocked_y = self.config["y"]
+        self._save_config()
+        z_mode = self.config.get("z_mode", "topmost")
+        is_locked = bool(self.config.get("locked", False))
+        apply_z_order_and_clickthrough(self.widget_win, z_mode, click_through=is_locked)
+        if self.lock_win:
+            apply_z_order_and_clickthrough(self.lock_win, z_mode, click_through=False)
+
+    def _build_context_menu(self):
+        self.menu = tk.Menu(
+            self.root,
+            tearoff=0,
+            bg="#1E293B",
+            fg="#F8FAFC",
+            activebackground="#0284C7",
+            activeforeground="#FFFFFF",
+            font=("Tahoma", 9),
+        )
+
+    def _populate_context_menu(self):
+        self.menu.delete(0, "end")
+
+        locked_label = (
+            "🔓 باز کردن قفل ویجت (فعال‌سازی کلیک و جابه‌جایی)"
+            if self.config.get("locked")
+            else "🔒 قفل و فیکس کردن ویجت (کوچک‌ترین حالت و چسبیدن به لبه صفحه)"
+        )
+        self.menu.add_command(label=locked_label, command=self._toggle_lock)
+        self.menu.add_separator()
+
+        if getattr(self, "_is_minimized", False):
+            self.menu.add_command(
+                label="🗖 نمایش مجدد ویجت روی صفحه (Restore)",
+                command=self.restore_widget,
+            )
+        else:
+            self.menu.add_command(
+                label="🗕 مینیمایز ویجت (نمایش فقط در تسک‌بار و Hidden Icons)",
+                command=self.minimize_widget,
+            )
+        self.menu.add_separator()
+
+        self.menu.add_command(
+            label="🎲 رندر و کپی فوری GUID جدید (UUID v4)",
+            command=lambda: self._copy_to_clipboard(str(uuid.uuid4()), "✓ GUID کپی شد!"),
+        )
+        self.menu.add_command(
+            label="📋 باز کردن پنل کپی زمان (۱۰ فرمت API) و GUID...",
+            command=self._toggle_dev_popup_window,
+        )
+
+        self._populate_dev_copy_menu()
+        self.menu.add_cascade(
+            label="🕒 لیست سریع فرمت‌های زمان API و GUID",
+            menu=self.copy_menu,
+        )
+        self.menu.add_separator()
+
+        self.menu.add_command(
+            label="⏰ مدیریت رویدادها و آلارم‌ها...",
+            command=self.open_alarm_manager,
+        )
+        self.menu.add_command(
+            label="🎂 مدیریت مناسبت‌های شخصی و تولدها...",
+            command=self.open_custom_occasions_manager,
+        )
+
+        self.menu.add_command(
+            label="⚙️ تنظیمات ظاهری، رنگ، سایز و فونت...",
+            command=self.open_settings_window,
+        )
+
+        cal_text = "▾ بستن تقویم ماهانه" if self.config.get("calendar_expanded") else "📅 نمایش تقویم ماهانه (Extend)"
+        self.menu.add_command(label=cal_text, command=lambda: self._toggle_calendar(None))
+
+        z_menu = tk.Menu(
+            self.menu,
+            tearoff=0,
+            bg="#1E293B",
+            fg="#F8FAFC",
+            activebackground="#0284C7",
+            activeforeground="#FFFFFF",
+            font=("Tahoma", 9),
+        )
+        cur_z = self.config.get("z_mode", "topmost")
+        for mode_key, mode_title in [
+            ("topmost", "همیشه روی تمام برنامه‌ها (Z-Index بالا - پیشنهادی)"),
+            ("desktop", "چسبیده به دسکتاپ (پشت پنجره‌های باز)"),
+        ]:
+            prefix = "✓ " if cur_z == mode_key else ""
+            z_menu.add_command(
+                label=f"{prefix}{mode_title}",
+                command=lambda m=mode_key: self._set_z_mode(m),
+            )
+        self.menu.add_cascade(label="📌 لایه قرارگیری (Z-Index)", menu=z_menu)
+
+        bg_label = (
+            "✓ 🖼 حالت: بدون پس‌زمینه (تغییر به کارت با پس‌زمینه)"
+            if self.config.get("transparent_bg")
+            else "🖼 حالت: با پس‌زمینه (تغییر به بدون پس‌زمینه)"
+        )
+        self.menu.add_command(label=bg_label, command=self._toggle_transparent_bg)
+
+        digits_label = (
+            "🔢 نمایش اعداد: فارسی (تغییر به انگلیسی)"
+            if self.config.get("persian_digits")
+            else "🔢 نمایش اعداد: انگلیسی (تغییر به فارسی)"
+        )
+        self.menu.add_command(label=digits_label, command=self._toggle_digits)
+
+        self.menu.add_separator()
+
+        startup_on = is_startup_enabled()
+        os_name_fa = "ویندوز" if sys.platform == "win32" else "لینوکس"
+        startup_label = f"✓ 🚀 اجرا با شروع {os_name_fa} (فعال)" if startup_on else f"🚀 اجرا خودکار با شروع {os_name_fa} (Startup)"
+        self.menu.add_command(label=startup_label, command=self._toggle_startup)
+
+        # جایگزینی کامل ساعت ویندوز در تسک‌بار
+        replace_clk_label = (
+            "✓ ⭐ جایگزینی کامل ساعت و تاریخ ویندوز در تسک‌بار (فعال)"
+            if self.config.get("replace_windows_clock")
+            else "⭐ جایگزینی کامل ساعت و تاریخ ویندوز در تسک‌بار"
+        )
+        self.menu.add_command(label=replace_clk_label, command=lambda: self._toggle_taskbar_setting("replace_windows_clock"))
+
+        if self.config.get("replace_windows_clock"):
+            hide_desk_label = (
+                "✓ 👁️ مخفی کردن ویجت دسکتاپ (فقط ساعت تسک‌بار)"
+                if self.config.get("replace_clock_hide_widget")
+                else "👁️ مخفی کردن ویجت دسکتاپ (فقط ساعت تسک‌بار)"
+            )
+            self.menu.add_command(label=hide_desk_label, command=lambda: self._toggle_taskbar_setting("replace_clock_hide_widget"))
+
+        tb_clock_label = (
+            "✓ 🕒 نمایش ساعت و تاریخ شناور روی تسک‌بار (فعال)"
+            if self.config.get("taskbar_clock")
+            else "🕒 نمایش ساعت و تاریخ شناور روی تسک‌بار"
+        )
+        self.menu.add_command(label=tb_clock_label, command=lambda: self._toggle_taskbar_setting("taskbar_clock"))
+        tb_btn_label = (
+            "✓ 📌 نمایش آیکون برنامه در تسک‌بار (فعال)"
+            if self.config.get("taskbar_button")
+            else "📌 نمایش آیکون برنامه در تسک‌بار"
+        )
+        self.menu.add_command(label=tb_btn_label, command=lambda: self._toggle_taskbar_setting("taskbar_button"))
+
+        self.menu.add_command(label="🔄 بازنشانی مکان به گوشه مانیتور", command=self._reset_position)
+        self.menu.add_separator()
+        self.menu.add_command(label="® Shayan Bamyar", state="disabled")
+        self.menu.add_command(label="❌ خروج کامل از ویجت", command=self.quit_app)
+
+    def _show_context_menu(self, event):
+        if self.config.get("locked", False):
+            return
+        self._populate_context_menu()
+        try:
+            self.menu.tk_popup(event.x_root, event.y_root)
+        finally:
+            self.menu.grab_release()
+
+    def _set_z_mode(self, mode: str):
+        self.config["z_mode"] = mode
+        self._save_config()
+        self._apply_all_styles()
+
+    def _toggle_lock(self):
+        self._close_dev_popup_window()
+        going_to_lock = not self.config.get("locked", False)
+        self.config["locked"] = going_to_lock
+        screen_w = self.root.winfo_screenwidth()
+        if going_to_lock:
+            # ذخیره مکان آزاد قبل از قفل و تعیین جهت چسبیدن به لبه صفحه (چپ یا راست)
+            if self.widget_win:
+                self._unlocked_x = self.widget_win.winfo_x()
+                self._unlocked_y = self.widget_win.winfo_y()
+                center_x = self._unlocked_x + (self.compact_w / 2)
+                self.config["snap_side"] = "right" if center_x >= (screen_w / 2) else "left"
+            if self.config.get("calendar_expanded", False):
+                self.config["calendar_expanded"] = False
+        else:
+            # هنگام باز کردن قفل، مکان به شکلی بازگردد که ویجت باز شده از صفحه بیرون نزند
+            if self.config.get("snap_side") == "right":
+                self.config["x"] = max(10, screen_w - self.BASE_MIN_W - 20)
+            elif getattr(self, "_unlocked_x", None) is not None:
+                self.config["x"] = max(10, min(int(self._unlocked_x), screen_w - self.BASE_MIN_W - 10))
+        self._save_config()
+        self._apply_all_styles()
+        if hasattr(self, "_settings_lock_var") and self._settings_lock_var is not None:
+            try:
+                self._settings_lock_var.set(bool(self.config["locked"]))
+            except Exception:
+                pass
+
+    def _toggle_transparent_bg(self):
+        self.config["transparent_bg"] = not self.config.get("transparent_bg", False)
+        self._save_config()
+        self._apply_all_styles()
+
+    def _toggle_digits(self):
+        self.config["persian_digits"] = not self.config.get("persian_digits", False)
+        self._save_config()
+        self._apply_all_styles()
+
+    def _toggle_startup(self):
+        cur = is_startup_enabled()
+        set_startup_enabled(not cur, os.path.abspath(sys.argv[0]))
+
+    def _reset_position(self):
+        self.config["x"] = None
+        self.config["y"] = None
+        self._init_position()
+        if self.config.get("calendar_expanded"):
+            self._position_calendar_window()
+
+    def open_settings_window(self):
+        if self.settings_win and self.settings_win.winfo_exists():
+            self.settings_win.deiconify()
+            self.settings_win.lift()
+            self.settings_win.focus_force()
+            return
+
+        win = tk.Toplevel(self.root)
+        self.settings_win = win
+        win.title("تنظیمات ویجت ساعت و تقویم شمسی")
+        win.configure(bg="#0F172A")
+        win.resizable(False, False)
+        win.attributes("-topmost", True)
+
+        ico_path = get_resource_path(os.path.join("assets", "icons", "app_icon.ico"))
+        if os.path.exists(ico_path):
+            try:
+                win.iconbitmap(ico_path)
+            except Exception:
+                pass
+
+        w_width, w_height = 500, 800
+        sx = (win.winfo_screenwidth() - w_width) // 2
+        sy = (win.winfo_screenheight() - w_height) // 2
+        win.geometry(f"{w_width}x{w_height}+{sx}+{sy}")
+
+        font_fa = self.config.get("font_family", "Vazir")
+        container = tk.Frame(win, bg="#0F172A", padx=18, pady=14)
+        container.pack(fill="both", expand=True)
+
+        tk.Label(
+            container,
+            text="⚙️ تنظیمات ظاهری و رفتاری ویجت",
+            font=(font_fa, 12, "bold"),
+            fg="#38BDF8",
+            bg="#0F172A",
+            anchor="e",
+        ).pack(fill="x", pady=(0, 8))
+
+        sec1 = tk.LabelFrame(
+            container,
+            text=" ۱. لایه نمایش (Z-Index) و قفل روی صفحه ",
+            font=(font_fa, 9, "bold"),
+            fg="#E2E8F0",
+            bg="#1E293B",
+            bd=1,
+            padx=10,
+            pady=6,
+        )
+        sec1.pack(fill="x", pady=(0, 8))
+
+        z_var = tk.StringVar(value=self.config.get("z_mode", "topmost"))
+
+        def on_z_change():
+            self.config["z_mode"] = z_var.get()
+            self._save_config()
+            self._apply_all_styles()
+
+        for val, txt in [
+            ("topmost", "همیشه روی تمام برنامه‌ها (با باز شدن برنامه‌ها، ویجت روی آن‌ها می‌ماند)"),
+            ("desktop", "چسبیده به والپیپر دسکتاپ (پشت پنجره‌های باز)"),
+        ]:
+            tk.Radiobutton(
+                sec1,
+                text=txt,
+                variable=z_var,
+                value=val,
+                command=on_z_change,
+                font=(font_fa, 8),
+                fg="#F8FAFC",
+                bg="#1E293B",
+                selectcolor="#0F172A",
+                activebackground="#1E293B",
+                activeforeground="#38BDF8",
+                anchor="w",
+            ).pack(fill="x", pady=1)
+
+        self._settings_lock_var = tk.BooleanVar(value=bool(self.config.get("locked", False)))
+
+        def on_lock_change():
+            new_locked = self._settings_lock_var.get()
+            self.config["locked"] = new_locked
+            screen_w = self.root.winfo_screenwidth()
+            if new_locked:
+                if self.widget_win:
+                    self._unlocked_x = self.widget_win.winfo_x()
+                    self._unlocked_y = self.widget_win.winfo_y()
+                    center_x = self._unlocked_x + (self.compact_w / 2)
+                    self.config["snap_side"] = "right" if center_x >= (screen_w / 2) else "left"
+                if self.config.get("calendar_expanded", False):
+                    self.config["calendar_expanded"] = False
+            else:
+                if self.config.get("snap_side") == "right":
+                    self.config["x"] = max(10, screen_w - self.BASE_MIN_W - 20)
+                elif getattr(self, "_unlocked_x", None) is not None:
+                    self.config["x"] = max(10, min(int(self._unlocked_x), screen_w - self.BASE_MIN_W - 10))
+            self._save_config()
+            self._apply_all_styles()
+
+        tk.Checkbutton(
+            sec1,
+            text="قفل و فیکس کردن ویجت (🔒 عبوردهی کلیک به برنامه زیرین؛ فقط دکمه قفل قابل کلیک است)",
+            variable=self._settings_lock_var,
+            command=on_lock_change,
+            font=(font_fa, 8, "bold"),
+            fg="#FBBF24",
+            bg="#1E293B",
+            selectcolor="#0F172A",
+            activebackground="#1E293B",
+        ).pack(anchor="w", pady=(4, 0))
+
+        startup_var = tk.BooleanVar(value=is_startup_enabled())
+        os_name_fa = "ویندوز" if sys.platform == "win32" else "لینوکس"
+
+        def on_startup_change():
+            want = bool(startup_var.get())
+            script_target = os.path.abspath(sys.argv[0]) if sys.argv else os.path.abspath(__file__)
+            ok = set_startup_enabled(want, script_target)
+            if not ok:
+                startup_var.set(is_startup_enabled())
+
+        tk.Checkbutton(
+            sec1,
+            text=f"🚀 اجرا خودکار ویجت هم‌زمان با بالا آمدن {os_name_fa} (Startup)",
+            variable=startup_var,
+            command=on_startup_change,
+            font=(font_fa, 8, "bold"),
+            fg="#38BDF8",
+            bg="#1E293B",
+            selectcolor="#0F172A",
+            activebackground="#1E293B",
+        ).pack(anchor="w", pady=(2, 0))
+
+        sec2 = tk.LabelFrame(
+            container,
+            text=" ۲. پس‌زمینه و میزان شفافیت ",
+            font=(font_fa, 9, "bold"),
+            fg="#E2E8F0",
+            bg="#1E293B",
+            bd=1,
+            padx=10,
+            pady=6,
+        )
+        sec2.pack(fill="x", pady=(0, 8))
+
+        trans_var = tk.BooleanVar(value=bool(self.config.get("transparent_bg", False)))
+
+        def on_trans_change():
+            self.config["transparent_bg"] = trans_var.get()
+            self._save_config()
+            self._apply_all_styles()
+
+        tk.Checkbutton(
+            sec2,
+            text="حالت بدون پس‌زمینه (نمایش فقط متن با خط دور مشکی روی صفحه)",
+            variable=trans_var,
+            command=on_trans_change,
+            font=(font_fa, 8, "bold"),
+            fg="#F8FAFC",
+            bg="#1E293B",
+            selectcolor="#0F172A",
+            activebackground="#1E293B",
+        ).pack(anchor="w")
+
+        op_row = tk.Frame(sec2, bg="#1E293B")
+        op_row.pack(fill="x", pady=(4, 0))
+        tk.Label(
+            op_row,
+            text="شفافیت کل ویجت (%):",
+            font=(font_fa, 8),
+            fg="#CBD5E1",
+            bg="#1E293B",
+        ).pack(side="right")
+
+        op_scale = tk.Scale(
+            op_row,
+            from_=25,
+            to=100,
+            orient="horizontal",
+            bg="#1E293B",
+            fg="#F8FAFC",
+            highlightthickness=0,
+            troughcolor="#0F172A",
+            length=220,
+            command=lambda v: self._on_opacity_slider(int(v)),
+        )
+        op_scale.set(int(float(self.config.get("opacity", 0.90)) * 100))
+        op_scale.pack(side="left")
+
+        sec3 = tk.LabelFrame(
+            container,
+            text=" ۳. انتخاب رنگ نوشته‌ها و پس‌زمینه ",
+            font=(font_fa, 9, "bold"),
+            fg="#E2E8F0",
+            bg="#1E293B",
+            bd=1,
+            padx=10,
+            pady=6,
+        )
+        sec3.pack(fill="x", pady=(0, 8))
+
+        color_items = [
+            ("clock_color", "رنگ ساعت:"),
+            ("date_color", "رنگ تاریخ شمسی:"),
+            ("occasion_color", "رنگ مناسبت‌ها:"),
+            ("holiday_color", "رنگ روزهای تعطیل:"),
+            ("bg_color", "رنگ کارت پس‌زمینه:"),
+            ("accent_color", "رنگ دکمه‌ها و تاکید:"),
+        ]
+
+        self._color_previews: dict[str, tk.Button] = {}
+        grid_colors = tk.Frame(sec3, bg="#1E293B")
+        grid_colors.pack(fill="x")
+
+        for idx, (cfg_key, label_txt) in enumerate(color_items):
+            r = idx // 2
+            c = (idx % 2) * 2
+            tk.Label(
+                grid_colors,
+                text=label_txt,
+                font=(font_fa, 8),
+                fg="#CBD5E1",
+                bg="#1E293B",
+                anchor="e",
+            ).grid(row=r, column=c + 1, sticky="e", padx=(6, 4), pady=3)
+
+            btn = tk.Button(
+                grid_colors,
+                text="انتخاب رنگ",
+                font=(font_fa, 8),
+                bg=self.config.get(cfg_key, "#FFFFFF"),
+                fg="#000000" if cfg_key != "bg_color" else "#FFFFFF",
+                width=10,
+                relief="flat",
+                cursor="hand2",
+                command=lambda k=cfg_key: self._pick_color(k),
+            )
+            btn.grid(row=r, column=c, sticky="w", padx=4, pady=3)
+            self._color_previews[cfg_key] = btn
+
+        for ci in range(4):
+            grid_colors.grid_columnconfigure(ci, weight=1)
+
+        sec4 = tk.LabelFrame(
+            container,
+            text=" ۴. اندازه ویجت و تنظیمات فونت (پیش‌فرض: Vazir) ",
+            font=(font_fa, 9, "bold"),
+            fg="#E2E8F0",
+            bg="#1E293B",
+            bd=1,
+            padx=10,
+            pady=6,
+        )
+        sec4.pack(fill="x", pady=(0, 8))
+
+        scale_row = tk.Frame(sec4, bg="#1E293B")
+        scale_row.pack(fill="x", pady=2)
+        tk.Label(
+            scale_row,
+            text="اندازه کلی ویجت (%):",
+            font=(font_fa, 8),
+            fg="#CBD5E1",
+            bg="#1E293B",
+        ).pack(side="right")
+
+        widget_scale_slider = tk.Scale(
+            scale_row,
+            from_=70,
+            to=170,
+            orient="horizontal",
+            bg="#1E293B",
+            fg="#F8FAFC",
+            highlightthickness=0,
+            troughcolor="#0F172A",
+            length=220,
+            command=lambda v: self._on_scale_slider(int(v)),
+        )
+        widget_scale_slider.set(int(self.config.get("widget_scale", 100)))
+        widget_scale_slider.pack(side="left")
+
+        bundled_and_std = [
+            "Vazir",
+            "B Yekan+",
+            "A Iranian Sans",
+            "Tahoma",
+            "Segoe UI",
+            "Calibri",
+            "Arial",
+            "Consolas",
+        ]
+        try:
+            sys_fonts = set(tkfont.families())
+            for pf in ["Vazirmatn", "IRANSans", "IRANSansWeb", "B Nazanin", "B Yekan", "Samim", "Shabnam"]:
+                if pf in sys_fonts and pf not in bundled_and_std:
+                    bundled_and_std.append(pf)
+        except Exception:
+            pass
+
+        font_row = tk.Frame(sec4, bg="#1E293B")
+        font_row.pack(fill="x", pady=3)
+        tk.Label(
+            font_row,
+            text="فونت تاریخ و متون:",
+            font=(font_fa, 8),
+            fg="#CBD5E1",
+            bg="#1E293B",
+        ).pack(side="right")
+
+        font_cb = ttk.Combobox(font_row, values=bundled_and_std, state="readonly", width=20)
+        font_cb.set(self.config.get("font_family", "Vazir"))
+        font_cb.pack(side="left")
+
+        clock_font_row = tk.Frame(sec4, bg="#1E293B")
+        clock_font_row.pack(fill="x", pady=3)
+        tk.Label(
+            clock_font_row,
+            text="فونت اعداد ساعت:",
+            font=(font_fa, 8),
+            fg="#CBD5E1",
+            bg="#1E293B",
+        ).pack(side="right")
+
+        clock_font_cb = ttk.Combobox(
+            clock_font_row,
+            values=["Vazir", "B Yekan+", "A Iranian Sans", "Segoe UI Semibold", "Tahoma", "Consolas"],
+            state="readonly",
+            width=20,
+        )
+        clock_font_cb.set(self.config.get("clock_font_family", "Vazir"))
+        clock_font_cb.pack(side="left")
+
+        def on_font_selected(event=None):
+            self.config["font_family"] = font_cb.get()
+            self.config["clock_font_family"] = clock_font_cb.get()
+            self._save_config()
+            self._apply_all_styles()
+
+        font_cb.bind("<<ComboboxSelected>>", on_font_selected)
+        clock_font_cb.bind("<<ComboboxSelected>>", on_font_selected)
+
+        sizes_row = tk.Frame(sec4, bg="#1E293B")
+        sizes_row.pack(fill="x", pady=(6, 2))
+
+        def make_size_spin(parent, label_text, cfg_key, min_v, max_v):
+            frame = tk.Frame(parent, bg="#1E293B")
+            frame.pack(side="right", expand=True)
+            tk.Label(
+                frame,
+                text=label_text,
+                font=(font_fa, 8),
+                fg="#CBD5E1",
+                bg="#1E293B",
+            ).pack(side="right", padx=(2, 4))
+            sp = tk.Spinbox(
+                frame,
+                from_=min_v,
+                to=max_v,
+                width=4,
+                font=("Segoe UI", 9),
+                bg="#0F172A",
+                fg="#F8FAFC",
+                buttonbackground="#334155",
+            )
+            sp.delete(0, "end")
+            sp.insert(0, str(self.config.get(cfg_key, 10)))
+
+            def on_spin_change(*args):
+                try:
+                    val = int(sp.get())
+                    if min_v <= val <= max_v:
+                        self.config[cfg_key] = val
+                        self._save_config()
+                        self._apply_all_styles()
+                except ValueError:
+                    pass
+
+            sp.configure(command=on_spin_change)
+            sp.bind("<Return>", on_spin_change)
+            sp.bind("<FocusOut>", on_spin_change)
+            sp.pack(side="left")
+
+        make_size_spin(sizes_row, "ساعت:", "clock_font_size", 12, 52)
+        make_size_spin(sizes_row, "تاریخ:", "date_font_size", 6, 28)
+        make_size_spin(sizes_row, "مناسبت:", "occasion_font_size", 6, 22)
+
+        sec5 = tk.LabelFrame(
+            container,
+            text=" ۵. نمایش و جایگزینی در تسک‌بار ویندوز ",
+            font=(font_fa, 9, "bold"),
+            fg="#E2E8F0",
+            bg="#1E293B",
+            bd=1,
+            padx=10,
+            pady=6,
+        )
+        sec5.pack(fill="x", pady=(0, 8))
+
+        self._settings_replace_clock_var = tk.BooleanVar(value=bool(self.config.get("replace_windows_clock", False)))
+        self._settings_hide_widget_var = tk.BooleanVar(value=bool(self.config.get("replace_clock_hide_widget", False)))
+        self._settings_tb_clock_var = tk.BooleanVar(value=bool(self.config.get("taskbar_clock", False)))
+        self._settings_tb_btn_var = tk.BooleanVar(value=bool(self.config.get("taskbar_button", False)))
+        tb_sec_var = tk.BooleanVar(value=bool(self.config.get("taskbar_clock_seconds", False)))
+
+        def on_tb_change():
+            self.config["replace_windows_clock"] = bool(self._settings_replace_clock_var.get())
+            self.config["replace_clock_hide_widget"] = bool(self._settings_hide_widget_var.get())
+            self.config["taskbar_clock"] = bool(self._settings_tb_clock_var.get())
+            self.config["taskbar_button"] = bool(self._settings_tb_btn_var.get())
+            self.config["taskbar_clock_seconds"] = bool(tb_sec_var.get())
+            self._save_config()
+            self.sync_taskbar_features()
+
+        def on_reset_replacer_pos():
+            self.config["replace_clock_offset"] = 8
+            self.config["replace_clock_width"] = 118
+            self._save_config()
+            try:
+                sp_rw.delete(0, "end")
+                sp_rw.insert(0, "118")
+            except Exception:
+                pass
+            if self.clock_replacer:
+                self.clock_replacer.refresh(get_today_info(CUSTOM_OCCASIONS_PATH))
+
+        def on_tb_reset_pos():
+            self.config["taskbar_clock_offset"] = None
+            self._save_config()
+            if self.taskbar_clock:
+                self.taskbar_clock.refresh(get_today_info(CUSTOM_OCCASIONS_PATH))
+
+        def on_pick_replacer_bg():
+            cur_c = self.config.get("replace_clock_bg", "auto")
+            if cur_c == "auto":
+                cur_c = "#1C1C1C"
+            c = colorchooser.askcolor(initialcolor=cur_c, title="انتخاب رنگ پس‌زمینه ساعت تسک‌بار", parent=win)
+            if c and c[1]:
+                self.config["replace_clock_bg"] = c[1]
+                self._save_config()
+                if self.clock_replacer:
+                    self.clock_replacer.refresh(get_today_info(CUSTOM_OCCASIONS_PATH))
+
+        def on_auto_replacer_bg():
+            self.config["replace_clock_bg"] = "auto"
+            self._save_config()
+            if self.clock_replacer:
+                self.clock_replacer._last_color_probe_ts = 0.0
+                self.clock_replacer.refresh(get_today_info(CUSTOM_OCCASIONS_PATH))
+
+        win11_hide_var = tk.BooleanVar(value=get_windows11_tray_clock_hidden())
+
+        def on_toggle_win11_clock():
+            want_hide = bool(win11_hide_var.get())
+            set_windows11_tray_clock_hidden(want_hide)
+            try:
+                os.startfile("ms-settings:dateandtime")
+            except Exception:
+                pass
+
+        # الف) جایگزینی کامل ساعت ویندوز
+        tk.Checkbutton(
+            sec5,
+            text="⭐ جایگزینی کامل ساعت و تاریخ ویندوز در تسک‌بار (پوشاندن ساعت انگلیسی با ساعت و تاریخ شمسی)",
+            variable=self._settings_replace_clock_var,
+            command=on_tb_change,
+            font=(font_fa, 8, "bold"),
+            fg="#38BDF8",
+            bg="#1E293B",
+            selectcolor="#0F172A",
+            activebackground="#1E293B",
+            anchor="w",
+        ).pack(fill="x", pady=2)
+
+        tk.Checkbutton(
+            sec5,
+            text="   👁️ مخفی کردن ویجت دسکتاپ هنگام فعال بودن جایگزینی (نمایش اختصاصی در تسک‌بار)",
+            variable=self._settings_hide_widget_var,
+            command=on_tb_change,
+            font=(font_fa, 8),
+            fg="#CBD5E1",
+            bg="#1E293B",
+            selectcolor="#0F172A",
+            activebackground="#1E293B",
+            anchor="w",
+        ).pack(fill="x", pady=1)
+
+        tk.Checkbutton(
+            sec5,
+            text="   🗑 حذف کامل ساعت و تاریخ انگلیسی از تسک‌بار ویندوز ۱۱ (تنظیم رسمی ویندوز)",
+            variable=win11_hide_var,
+            command=on_toggle_win11_clock,
+            font=(font_fa, 8),
+            fg="#FBBF24",
+            bg="#1E293B",
+            selectcolor="#0F172A",
+            activebackground="#1E293B",
+            anchor="w",
+        ).pack(fill="x", pady=1)
+
+        # ب) گزینه‌های دیگر تسک‌بار
+        for var, txt in (
+            (self._settings_tb_clock_var, "🕒 نمایش ساعت و تاریخ شمسی شناور روی تسک‌بار (کنار ساعت ویندوز)"),
+            (tb_sec_var, "⏱ نمایش ثانیه در ساعت تسک‌بار"),
+            (self._settings_tb_btn_var, "📌 نمایش دکمه/آیکون برنامه در نوار وظیفه (تسک‌بار)"),
+        ):
+            tk.Checkbutton(
+                sec5,
+                text=txt,
+                variable=var,
+                command=on_tb_change,
+                font=(font_fa, 8),
+                fg="#F8FAFC",
+                bg="#1E293B",
+                selectcolor="#0F172A",
+                activebackground="#1E293B",
+                anchor="w",
+            ).pack(fill="x", pady=1)
+
+        btn_row = tk.Frame(sec5, bg="#1E293B")
+        btn_row.pack(fill="x", pady=(4, 0))
+
+        tk.Label(
+            btn_row,
+            text="عرض:",
+            font=(font_fa, 8),
+            fg="#CBD5E1",
+            bg="#1E293B",
+        ).pack(side="left", padx=(0, 3))
+
+        sp_rw = tk.Spinbox(
+            btn_row,
+            from_=80,
+            to=200,
+            width=4,
+            font=("Segoe UI", 8, "bold"),
+            bg="#0F172A",
+            fg="#F8FAFC",
+            buttonbackground="#334155",
+        )
+        sp_rw.delete(0, "end")
+        sp_rw.insert(0, str(self.config.get("replace_clock_width", 118)))
+
+        def on_rw_change(*args):
+            try:
+                val = int(sp_rw.get())
+                if 80 <= val <= 200:
+                    self.config["replace_clock_width"] = val
+                    self._save_config()
+                    if self.clock_replacer:
+                        self.clock_replacer.refresh(get_today_info(CUSTOM_OCCASIONS_PATH))
+            except ValueError:
+                pass
+
+        sp_rw.configure(command=on_rw_change)
+        sp_rw.bind("<Return>", on_rw_change)
+        sp_rw.bind("<FocusOut>", on_rw_change)
+        sp_rw.pack(side="left", padx=(0, 6))
+
+        tk.Button(
+            btn_row,
+            text="🔄 مکان پیش‌فرض",
+            font=(font_fa, 8),
+            bg="#334155",
+            fg="#F8FAFC",
+            relief="flat",
+            cursor="hand2",
+            command=on_reset_replacer_pos,
+        ).pack(side="left", padx=(0, 5))
+
+        tk.Button(
+            btn_row,
+            text="🎨 رنگ خودکار",
+            font=(font_fa, 8),
+            bg="#334155",
+            fg="#38BDF8",
+            relief="flat",
+            cursor="hand2",
+            command=on_auto_replacer_bg,
+        ).pack(side="left", padx=(0, 5))
+
+        tk.Button(
+            btn_row,
+            text="🎨 رنگ دلخواه",
+            font=(font_fa, 8),
+            bg="#334155",
+            fg="#F8FAFC",
+            relief="flat",
+            cursor="hand2",
+            command=on_pick_replacer_bg,
+        ).pack(side="left", padx=(0, 5))
+
+        tk.Button(
+            btn_row,
+            text="بازنشانی ساعت شناور",
+            font=(font_fa, 8),
+            bg="#334155",
+            fg="#CBD5E1",
+            relief="flat",
+            cursor="hand2",
+            command=on_tb_reset_pos,
+        ).pack(side="left")
+
+        bottom_bar = tk.Frame(container, bg="#0F172A")
+        bottom_bar.pack(fill="x", pady=(8, 0))
+
+        tk.Button(
+            bottom_bar,
+            text="بستن و ذخیره",
+            font=(font_fa, 9, "bold"),
+            bg="#0284C7",
+            fg="#FFFFFF",
+            padx=16,
+            pady=4,
+            relief="flat",
+            cursor="hand2",
+            command=win.destroy,
+        ).pack(side="left")
+
+        tk.Label(
+            bottom_bar,
+            text="® Shayan Bamyar",
+            font=("Segoe UI", 8, "bold"),
+            fg="#64748B",
+            bg="#0F172A",
+        ).pack(side="left", padx=14)
+
+        tk.Button(
+            bottom_bar,
+            text="بازنشانی پیش‌فرض",
+            font=(font_fa, 8),
+            bg="#334155",
+            fg="#F8FAFC",
+            padx=10,
+            pady=4,
+            relief="flat",
+            cursor="hand2",
+            command=lambda: self._reset_all_defaults(win),
+        ).pack(side="right")
+
+    def _on_opacity_slider(self, val: int):
+        self.config["opacity"] = round(val / 100.0, 2)
+        self._save_config()
+        self._apply_all_styles()
+
+    def _on_scale_slider(self, val: int):
+        self.config["widget_scale"] = int(val)
+        self._save_config()
+        self._apply_all_styles()
+
+    def _pick_color(self, cfg_key: str):
+        initial = self.config.get(cfg_key, "#FFFFFF")
+        color_code = colorchooser.askcolor(
+            color=initial,
+            title="انتخاب رنگ دلخواه",
+            parent=self.settings_win if self.settings_win else self.root,
+        )
+        if color_code and color_code[1]:
+            hex_c = color_code[1]
+            self.config[cfg_key] = hex_c
+            self._save_config()
+            if cfg_key in self._color_previews and self._color_previews[cfg_key].winfo_exists():
+                self._color_previews[cfg_key].configure(bg=hex_c)
+            self._apply_all_styles()
+
+    def _reset_all_defaults(self, settings_win):
+        x, y = self.config.get("x"), self.config.get("y")
+        self.config = DEFAULT_CONFIG.copy()
+        self.config["x"] = x
+        self.config["y"] = y
+        self._save_config()
+        self._apply_all_styles()
+        self.sync_taskbar_features()
+        if settings_win and settings_win.winfo_exists():
+            settings_win.destroy()
+            self.open_settings_window()
+
+    def _on_tray_left_click(self):
+        def _act():
+            if self._is_minimized:
+                self.restore_widget()
+                return
+            if self.widget_win:
+                self.widget_win.deiconify()
+            if self.lock_win:
+                self.lock_win.deiconify()
+            self._toggle_calendar(None)
+        self.root.after(0, _act)
+
+    def _on_tray_right_click(self):
+        def _popup():
+            self._populate_context_menu()
+            x = self.root.winfo_pointerx()
+            y = self.root.winfo_pointery()
+            self.root.focus_force()
+            try:
+                self.menu.tk_popup(x, y)
+            finally:
+                self.menu.grab_release()
+        self.root.after(0, _popup)
+
+    def _refresh_display(self):
+        info = get_today_info(CUSTOM_OCCASIONS_PATH)
+        self.current_jy = info["jy"]
+        self.current_jm = info["jm"]
+        self.current_jd = info["jd"]
+
+        prev_count = len(self.alarm_store.alarms)
+        due_alarms = self.alarm_store.check_due_alarms(info)
+        if len(self.alarm_store.alarms) != prev_count:
+            if self.alarm_win and self.alarm_win.win and self.alarm_win.win.winfo_exists():
+                self.alarm_win._refresh_list()
+                self.alarm_win._render_picker_calendar()
+            if self.config.get("calendar_expanded"):
+                self._render_calendar_month()
+
+        for alarm in due_alarms:
+            if alarm.get("show_popup", True) or alarm.get("play_sound", True):
+                AnimatedBellPopup(
+                    root=self.root,
+                    alarm=alarm,
+                    font_family=self.config.get("font_family", "Vazir"),
+                    on_snooze=lambda a: self.alarm_store.add_snooze(a, 5),
+                    on_dismiss=self._on_alarm_dismissed,
+                )
+
+        use_fa = self.config.get("persian_digits", False)
+        is_locked = bool(self.config.get("locked", False))
+        scale = max(70, min(200, int(self.config.get("widget_scale", 100)))) / 100.0
+
+        c_size = max(10, int(self.config.get("clock_font_size", 26) * scale))
+        d_size = max(6, int(self.config.get("date_font_size", 11) * scale))
+        o_size = max(6, int(self.config.get("occasion_font_size", 9) * scale))
+
+        font_fa = self.config.get("font_family", "Vazir")
+        font_clock = self.config.get("clock_font_family", "Vazir")
+
+        # فقط متون پویا را پاک می‌کنیم تا نوار ابزار (toolbar) و وضعیت Hover آیکون‌ها هرگز ریست نشوند
+        self.canvas.delete("drawn_text")
+
+        toolbar_x = self.LOCK_OFFSET_X + self.LOCK_BTN_SIZE + 8
+        toolbar_y = self.LOCK_OFFSET_Y
+        # فضای نوار ابزار همیشه رزرو می‌شود (چه قفل چه باز) تا ابعاد و مکان ویجت
+        # بعد از قفل/باز کردن هیچ تغییری نکند و ویجت روی صفحه جابه‌جا نشود
+        self.canvas.coords(self._toolbar_win_id, toolbar_x, toolbar_y)
+        self.btn_container.update_idletasks()
+        toolbar_right = toolbar_x + self.btn_container.winfo_reqwidth()
+        if not is_locked:
+            self.canvas.itemconfigure(self._toolbar_win_id, state="normal")
+        else:
+            self.canvas.itemconfigure(self._toolbar_win_id, state="hidden")
+
+        time_str = format_digits(info["time_str"], use_fa)
+        date_str = format_digits(info["date_text"], use_fa)
+
+        today_alarms = self.alarm_store.get_events_for_jalali_day(
+            info["jy"], info["jm"], info["jd"], info["persian_week_idx"]
+        )
+        occ_parts = []
+        if info["has_occasion"] and info["occasion"]:
+            occ_parts.append(info["occasion"])
+        for a in today_alarms:
+            occ_parts.append(f"⏰ {int(a['hour']):02d}:{int(a['minute']):02d} {a['title']}")
+        occ_full = " | ".join(occ_parts)
+        if len(occ_full) > 40:
+            occ_full = occ_full[:39] + "…"
+        occ_str = format_digits(occ_full, use_fa) if occ_full else ""
+
+        tmp_t = self.canvas.create_text(0, 0, text=time_str, font=(font_clock, c_size, "bold"), anchor="nw")
+        tmp_d = self.canvas.create_text(0, 0, text=date_str, font=(font_fa, d_size, "bold"), anchor="nw")
+        tb_t = self.canvas.bbox(tmp_t) or (0, 0, 90, 32)
+        tb_d = self.canvas.bbox(tmp_d) or (0, 0, 140, 20)
+        time_w, time_h = tb_t[2] - tb_t[0], tb_t[3] - tb_t[1]
+        date_w, date_h = tb_d[2] - tb_d[0], tb_d[3] - tb_d[1]
+
+        occ_w, occ_h = 0, 0
+        if occ_str:
+            tmp_o = self.canvas.create_text(0, 0, text=occ_str, font=(font_fa, o_size), anchor="nw")
+            tb_o = self.canvas.bbox(tmp_o) or (0, 0, 120, 16)
+            occ_w, occ_h = tb_o[2] - tb_o[0], tb_o[3] - tb_o[1]
+
+        self.canvas.delete(tmp_t, tmp_d)
+        if occ_str:
+            self.canvas.delete(tmp_o)
+
+        if is_locked:
+            top_needed_w = self.LOCK_OFFSET_X + self.LOCK_BTN_SIZE + 10 + time_w + 14
+            body_needed_w = max(date_w, occ_w) + 24
+            target_w = max(top_needed_w, body_needed_w, int(130 * scale))
+        else:
+            top_needed_w = toolbar_right + time_w + 38
+            body_needed_w = max(date_w, occ_w) + 32
+            target_w = max(int(self.BASE_MIN_W * scale), top_needed_w, body_needed_w)
+
+        right_x = target_w - 14
+        cur_y = 6
+
+        draw_outlined_canvas_text(
+            self.canvas,
+            right_x,
+            cur_y,
+            text=time_str,
+            font_spec=(font_clock, c_size, "bold"),
+            fill=self.config.get("clock_color", "#F8FAFC"),
+            outline="#000000",
+            anchor="ne",
+            justify="right",
+            tags="drawn_text",
+        )
+        cur_y += max(time_h, self.LOCK_BTN_SIZE + 4) + 4
+
+        draw_outlined_canvas_text(
+            self.canvas,
+            right_x,
+            cur_y,
+            text=date_str,
+            font_spec=(font_fa, d_size, "bold"),
+            fill=self.config.get("holiday_color", "#F87171")
+            if info["is_holiday"]
+            else self.config.get("date_color", "#CBD5E1"),
+            outline="#000000",
+            anchor="ne",
+            justify="right",
+            tags="drawn_text",
+        )
+        cur_y += date_h + 5
+
+        if occ_str:
+            draw_outlined_canvas_text(
+                self.canvas,
+                right_x,
+                cur_y,
+                text=occ_str,
+                font_spec=(font_fa, o_size),
+                fill=self.config.get("holiday_color", "#F87171")
+                if (info["is_holiday"] and info["has_occasion"])
+                else self.config.get("occasion_color", "#94A3B8"),
+                outline="#000000",
+                anchor="ne",
+                justify="right",
+                tags="drawn_text",
+            )
+            cur_y += occ_h + 4
+
+        footer_y = cur_y + 2
+        if self._toast_text:
+            draw_outlined_canvas_text(
+                self.canvas,
+                10,
+                footer_y,
+                text=self._toast_text,
+                font_spec=(font_fa, 8, "bold"),
+                fill="#10B981",
+                outline="#000000",
+                anchor="nw",
+                tags="drawn_text",
+            )
+            target_h = footer_y + 18
+        elif not is_locked:
+            draw_outlined_canvas_text(
+                self.canvas,
+                10,
+                footer_y,
+                text="® Shayan Bamyar",
+                font_spec=("Segoe UI", 7, "bold"),
+                fill="#64748B",
+                outline="#000000",
+                anchor="nw",
+                tags="drawn_text",
+            )
+            target_h = footer_y + 18
+        else:
+            # در حالت قفل، فوتر @shayan bamyar حذف می‌شود و ارتفاع به حداقل ممکن کاهش می‌یابد
+            target_h = cur_y + 6
+
+        size_changed = (target_w != self._computed_w) or (target_h != self._computed_h)
+        self._computed_w = target_w
+        self._computed_h = target_h
+
+        if self.widget_win and not getattr(self, "_is_minimized", False):
+            screen_w = self.root.winfo_screenwidth()
+            screen_h = self.root.winfo_screenheight()
+            cur_cx = self.widget_win.winfo_x()
+            cur_cy = self.widget_win.winfo_y()
+            if is_locked:
+                snap_side = self.config.get("snap_side", "right")
+                target_x = (screen_w - target_w) if snap_side == "right" else 0
+                target_y = max(0, min(cur_cy, screen_h - target_h - 40))
+            else:
+                target_x = max(0, min(cur_cx, screen_w - target_w))
+                target_y = max(0, min(cur_cy, screen_h - target_h - 40))
+
+            if size_changed or (cur_cx != target_x) or (cur_cy != target_y):
+                self.widget_win.geometry(f"{target_w}x{target_h}+{int(target_x)}+{int(target_y)}")
+                self._position_lock_window()
+                if not self.config.get("transparent_bg", False):
+                    apply_rounded_corners(self.widget_win, target_w, target_h, radius=10 if is_locked else 16, enabled=True)
+                if self.config.get("calendar_expanded"):
+                    self._position_calendar_window()
+
+        if hasattr(self, "tray") and self.tray:
+            self.tray.update_tooltip(self._format_tray_tooltip(info))
+
+        if getattr(self, "clock_replacer", None) is not None:
+            try:
+                self.clock_replacer.refresh(info)
+            except Exception:
+                pass
+        if getattr(self, "taskbar_clock", None) is not None:
+            try:
+                self.taskbar_clock.refresh(info)
+            except Exception:
+                pass
+        if getattr(self, "taskbar_proxy", None) is not None:
+            self.taskbar_proxy.update_title(
+                format_digits(f"{info['time_str'][:5]} | {info['date_text']}", use_fa)
+            )
+
+    def _update_clock_loop(self):
+        self._refresh_display()
+        self.root.after(1000, self._update_clock_loop)
+
+    def _keep_z_order_loop(self):
+        if not self._is_dragging and not getattr(self, "_is_minimized", False) and self.widget_win and self.widget_win.winfo_viewable():
+            z_mode = self.config.get("z_mode", "topmost")
+            is_locked = bool(self.config.get("locked", False))
+            apply_z_order_and_clickthrough(self.widget_win, z_mode, click_through=is_locked)
+            if self.lock_win and self.lock_win.winfo_viewable():
+                apply_z_order_and_clickthrough(self.lock_win, z_mode, click_through=False)
+            if self.cal_win and self.config.get("calendar_expanded"):
+                apply_z_order_and_clickthrough(self.cal_win, z_mode, click_through=is_locked)
+            # حفظ پنجره کپی زمان/GUID و Tooltipها روی ویجت تا هرگز زیر ویجت نروند
+            if self.dev_popup_win and self.dev_popup_win.winfo_exists():
+                apply_z_order_and_clickthrough(self.dev_popup_win, "topmost", click_through=False)
+            for tip in self._tooltips:
+                if tip.tip_win and tip.tip_win.winfo_exists():
+                    apply_z_order_and_clickthrough(tip.tip_win, "topmost", click_through=True)
+        if getattr(self, "clock_replacer", None) is not None:
+            self.clock_replacer.keep_on_top()
+        if getattr(self, "taskbar_clock", None) is not None:
+            self.taskbar_clock.keep_on_top()
+        self.root.after(800, self._keep_z_order_loop)
+
+    def quit_app(self):
+        try:
+            if getattr(self, "clock_replacer", None) is not None:
+                self.clock_replacer.destroy()
+            if getattr(self, "taskbar_clock", None) is not None:
+                self.taskbar_clock.destroy()
+            if getattr(self, "taskbar_proxy", None) is not None:
+                self.taskbar_proxy.destroy()
+        except Exception:
+            pass
+        try:
+            if hasattr(self, "tray") and self.tray:
+                self.tray.stop()
+        except Exception:
+            pass
+        self.root.quit()
+        self.root.destroy()
+        sys.exit(0)
+
+    def run(self):
+        self.root.mainloop()
+
+
+if __name__ == "__main__":
+    app = PersianClockWidget()
+    app.run()