trcc-linux 8.2.4__tar.gz → 8.2.5__tar.gz

{trcc_linux-8.2.4 → trcc_linux-8.2.5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: trcc-linux
-Version: 8.2.4
+Version: 8.2.5
 Summary: Linux implementation of Thermalright LCD Control Center
 Project-URL: Homepage, https://github.com/Lexonight1/thermalright-trcc-linux
 Project-URL: Documentation, https://github.com/Lexonight1/thermalright-trcc-linux#readme
@@ -69,7 +69,7 @@ Description-Content-Type: text/markdown
 [![Platform](https://img.shields.io/badge/platform-Linux-FCC624?logo=linux&logoColor=black)](https://github.com/Lexonight1/thermalright-trcc-linux)
 
 [![CI](https://github.com/Lexonight1/thermalright-trcc-linux/actions/workflows/ci.yml/badge.svg)](https://github.com/Lexonight1/thermalright-trcc-linux/actions/workflows/ci.yml)
-[![Tests](https://img.shields.io/badge/tests-4105_passed-brightgreen.svg)](https://github.com/Lexonight1/thermalright-trcc-linux/actions/workflows/ci.yml)
+[![Tests](https://img.shields.io/badge/tests-4116_passed-brightgreen.svg)](https://github.com/Lexonight1/thermalright-trcc-linux/actions/workflows/ci.yml)
 [![Coverage](https://img.shields.io/badge/coverage-70%25-brightgreen.svg)](https://github.com/Lexonight1/thermalright-trcc-linux/actions/workflows/ci.yml)
 [![Python](https://img.shields.io/badge/python-3.9%2B-blue.svg)](https://python.org)
 [![Code Style](https://img.shields.io/badge/code_style-ruff-D7FF64?logo=ruff&logoColor=black)](https://docs.astral.sh/ruff/)
@@ -99,7 +99,7 @@ Description-Content-Type: text/markdown
 [![Buy Me a Beer](https://img.shields.io/badge/Buy_Me_a_Beer-🍺-FF5F5F?style=flat)](https://buymeacoffee.com/Lexonight1)
 [![Ko-fi](https://img.shields.io/badge/Ko--fi-☕-FF5E5B?style=flat&logo=kofi&logoColor=white)](https://ko-fi.com/lexonight1)
 
-> Huge thanks to **[@javisaman](https://github.com/javisaman)**, **[@Xentrino](https://github.com/Xentrino)**, **[@loosethoughts19-hash](https://github.com/loosethoughts19-hash)**, **[@Mr-Renegade](https://github.com/Mr-Renegade)**, and **[@Reborn627](https://github.com/Reborn627)** for the beers — you guys are legends.
+> Huge thanks to **[@javisaman](https://github.com/javisaman)**, **[@Xentrino](https://github.com/Xentrino)**, **[@loosethoughts19-hash](https://github.com/loosethoughts19-hash)**, **[@Mr-Renegade](https://github.com/Mr-Renegade)**, **[@Reborn627](https://github.com/Reborn627)**, and **[@knappstar](https://github.com/knappstar)** for the beers — you guys are legends.
 
 Native Linux port of the Thermalright LCD Control Center (Windows TRCC 2.1.2). Control and customize the LCD displays and LED segment displays on Thermalright CPU coolers, AIO pump heads, and fan hubs — entirely from Linux.
 

{trcc_linux-8.2.4 → trcc_linux-8.2.5}/README.md

@@ -10,7 +10,7 @@
 [![Platform](https://img.shields.io/badge/platform-Linux-FCC624?logo=linux&logoColor=black)](https://github.com/Lexonight1/thermalright-trcc-linux)
 
 [![CI](https://github.com/Lexonight1/thermalright-trcc-linux/actions/workflows/ci.yml/badge.svg)](https://github.com/Lexonight1/thermalright-trcc-linux/actions/workflows/ci.yml)
-[![Tests](https://img.shields.io/badge/tests-4105_passed-brightgreen.svg)](https://github.com/Lexonight1/thermalright-trcc-linux/actions/workflows/ci.yml)
+[![Tests](https://img.shields.io/badge/tests-4116_passed-brightgreen.svg)](https://github.com/Lexonight1/thermalright-trcc-linux/actions/workflows/ci.yml)
 [![Coverage](https://img.shields.io/badge/coverage-70%25-brightgreen.svg)](https://github.com/Lexonight1/thermalright-trcc-linux/actions/workflows/ci.yml)
 [![Python](https://img.shields.io/badge/python-3.9%2B-blue.svg)](https://python.org)
 [![Code Style](https://img.shields.io/badge/code_style-ruff-D7FF64?logo=ruff&logoColor=black)](https://docs.astral.sh/ruff/)
@@ -40,7 +40,7 @@
 [![Buy Me a Beer](https://img.shields.io/badge/Buy_Me_a_Beer-🍺-FF5F5F?style=flat)](https://buymeacoffee.com/Lexonight1)
 [![Ko-fi](https://img.shields.io/badge/Ko--fi-☕-FF5E5B?style=flat&logo=kofi&logoColor=white)](https://ko-fi.com/lexonight1)
 
-> Huge thanks to **[@javisaman](https://github.com/javisaman)**, **[@Xentrino](https://github.com/Xentrino)**, **[@loosethoughts19-hash](https://github.com/loosethoughts19-hash)**, **[@Mr-Renegade](https://github.com/Mr-Renegade)**, and **[@Reborn627](https://github.com/Reborn627)** for the beers — you guys are legends.
+> Huge thanks to **[@javisaman](https://github.com/javisaman)**, **[@Xentrino](https://github.com/Xentrino)**, **[@loosethoughts19-hash](https://github.com/loosethoughts19-hash)**, **[@Mr-Renegade](https://github.com/Mr-Renegade)**, **[@Reborn627](https://github.com/Reborn627)**, and **[@knappstar](https://github.com/knappstar)** for the beers — you guys are legends.
 
 Native Linux port of the Thermalright LCD Control Center (Windows TRCC 2.1.2). Control and customize the LCD displays and LED segment displays on Thermalright CPU coolers, AIO pump heads, and fan hubs — entirely from Linux.
 

{trcc_linux-8.2.4 → trcc_linux-8.2.5}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "trcc-linux"
-version = "8.2.4"
+version = "8.2.5"
 description = "Linux implementation of Thermalright LCD Control Center"
 readme = "README.md"
 license = "GPL-3.0-or-later"

{trcc_linux-8.2.4 → trcc_linux-8.2.5}/src/trcc/__version__.py

@@ -1,4 +1,4 @@
 """TRCC Linux version information. History in doc/CHANGELOG.md."""
 
-__version__ = "8.2.4"
+__version__ = "8.2.5"
 __version_info__ = tuple(int(x) for x in __version__.split("."))

{trcc_linux-8.2.4 → trcc_linux-8.2.5}/src/trcc/adapters/infra/data_repository.py

@@ -21,9 +21,10 @@ import shutil
 import subprocess
 from typing import List, Optional
 
-from ...core.models import ThemeDir  # re-export for back-compat
+from ...core.models import ThemeDir  # noqa: F401 — re-export for back-compat
 from ...core.paths import (
     ASSETS_DIR,  # noqa: F401 — re-export
+    DATA_DIR,  # noqa: F401 — re-export
     RESOURCES_DIR,  # noqa: F401 — re-export
     USER_CONFIG_DIR,  # noqa: F401 — re-export
     USER_DATA_DIR,  # noqa: F401 — re-export
@@ -132,8 +133,6 @@ def _find_pkg_data_dir() -> str:
 # All runtime data goes to ~/.trcc/data/ — always writable, works on
 # pip, pipx, pacman, dnf, apt installs. No read-only pkg_dir issues.
 _PKG_DATA_DIR = _find_pkg_data_dir()
-DATA_DIR = USER_DATA_DIR
-THEMES_DIR = DATA_DIR
 
 RESOURCE_SEARCH_PATHS = [RESOURCES_DIR]
 
@@ -449,30 +448,17 @@ class DataManager:
     # Directory resolution
     # ------------------------------------------------------------------
 
-    @staticmethod
-    def _resolve_web_subdir(res_key: str, check_fn=None) -> str:
-        """Resolve a web subdirectory, preferring pkg_dir if it has content.
-
-        Falls back to user_dir (always writable — safe on system-wide installs).
-        """
-        if check_fn is None:
-            check_fn = DataManager._has_any_content
-        pkg_dir = os.path.join(DATA_DIR, 'web', res_key)
-        if check_fn(pkg_dir):
-            return pkg_dir
-        return os.path.join(USER_DATA_DIR, 'web', res_key)
-
     @staticmethod
     def get_web_dir(width: int, height: int) -> str:
         """Get cloud theme Web directory for a resolution."""
-        return DataManager._resolve_web_subdir(f'{width}{height}')
+        from ...core.paths import get_web_dir
+        return get_web_dir(width, height)
 
     @staticmethod
     def get_web_masks_dir(width: int, height: int) -> str:
         """Get cloud masks directory for a resolution."""
-        return DataManager._resolve_web_subdir(
-            f'zt{width}{height}', check_fn=ThemeDir.has_themes,
-        )
+        from ...core.paths import get_web_masks_dir
+        return get_web_masks_dir(width, height)
 
 
 # =========================================================================

{trcc_linux-8.2.4 → trcc_linux-8.2.5}/src/trcc/conf.py

@@ -33,9 +33,8 @@ from pathlib import Path
 from typing import Optional
 
 from .__version__ import __version__
-from .adapters.infra.data_repository import DataManager, ThemeDir
-from .core.models import LOCALE_TO_LANG
-from .core.paths import USER_CONFIG_DIR, USER_DATA_DIR
+from .core.models import LOCALE_TO_LANG, ThemeDir
+from .core.paths import USER_CONFIG_DIR, USER_DATA_DIR, get_web_dir, get_web_masks_dir
 
 log = logging.getLogger(__name__)
 
@@ -408,8 +407,8 @@ class Settings:
         """Resolve theme/web/mask directories for current resolution."""
         w, h = self._width, self._height
         self.theme_dir = ThemeDir.for_resolution(w, h)
-        self.web_dir = Path(DataManager.get_web_dir(w, h))
-        self.masks_dir = Path(DataManager.get_web_masks_dir(w, h))
+        self.web_dir = Path(get_web_dir(w, h))
+        self.masks_dir = Path(get_web_masks_dir(w, h))
 
     def resolve_cloud_dirs(self, rotation: int = 0) -> None:
         """Re-resolve cloud background/mask dirs for rotation.
@@ -421,8 +420,8 @@ class Settings:
         w, h = self._width, self._height
         if w != h and rotation in (90, 270):
             w, h = h, w
-        self.web_dir = Path(DataManager.get_web_dir(w, h))
-        self.masks_dir = Path(DataManager.get_web_masks_dir(w, h))
+        self.web_dir = Path(get_web_dir(w, h))
+        self.masks_dir = Path(get_web_masks_dir(w, h))
 
 
 # Module-level singleton — import and use directly

{trcc_linux-8.2.4 → trcc_linux-8.2.5}/src/trcc/core/models.py

@@ -177,7 +177,7 @@ class ThemeDir:
 
         Lazy-imports infrastructure constants from data_repository.
         """
-        from ..adapters.infra.data_repository import DATA_DIR, USER_DATA_DIR
+        from .paths import DATA_DIR, USER_DATA_DIR
         name = f'theme{width}{height}'
         user_dir = os.path.join(USER_DATA_DIR, name)
         if cls.has_themes(user_dir):

trcc_linux-8.2.5/src/trcc/core/paths.py

@@ -0,0 +1,74 @@
+"""Application path constants and directory resolution — single source of truth.
+
+Zero project imports. Safe to import from any module without circular deps.
+"""
+from __future__ import annotations
+
+import os
+
+# Navigate from core/ back to the trcc package root
+_TRCC_PKG = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
+
+# Asset directories (inside trcc package)
+ASSETS_DIR = os.path.join(_TRCC_PKG, 'assets')
+RESOURCES_DIR = os.path.join(ASSETS_DIR, 'gui')
+
+# User config directory (~/.trcc/)
+USER_CONFIG_DIR = os.path.expanduser('~/.trcc')
+USER_DATA_DIR = os.path.join(USER_CONFIG_DIR, 'data')
+
+# Runtime data directory — always writable (~/.trcc/data/)
+DATA_DIR = USER_DATA_DIR
+
+
+# =========================================================================
+# Directory resolution — pure path logic, no I/O beyond os.path/os.listdir
+# =========================================================================
+
+def _has_any_content(d: str) -> bool:
+    """Check if a directory exists and has any files/subdirs."""
+    return os.path.isdir(d) and bool(os.listdir(d))
+
+
+def _has_themes(theme_dir: str) -> bool:
+    """Check if a directory contains valid theme subdirectories with PNGs.
+
+    Mirrors ThemeDir.has_themes — duplicated here to avoid circular import
+    with core/models.py (ThemeDir.for_resolution imports from this module).
+    """
+    if not os.path.isdir(theme_dir):
+        return False
+    for item in os.listdir(theme_dir):
+        item_path = os.path.join(theme_dir, item)
+        if (os.path.isdir(item_path)
+                and not item.startswith('.')
+                and not item.startswith('Custom_')):
+            if any(f.endswith('.png') for f in os.listdir(item_path)):
+                return True
+    return False
+
+
+def _resolve_web_subdir(
+    res_key: str,
+    check_fn: object = None,
+) -> str:
+    """Resolve a web subdirectory, preferring pkg_dir if it has content.
+
+    Falls back to user_dir (always writable — safe on system-wide installs).
+    """
+    if check_fn is None:
+        check_fn = _has_any_content
+    pkg_dir = os.path.join(DATA_DIR, 'web', res_key)
+    if check_fn(pkg_dir):  # type: ignore[operator]
+        return pkg_dir
+    return os.path.join(USER_DATA_DIR, 'web', res_key)
+
+
+def get_web_dir(width: int, height: int) -> str:
+    """Get cloud theme Web directory for a resolution."""
+    return _resolve_web_subdir(f'{width}{height}')
+
+
+def get_web_masks_dir(width: int, height: int) -> str:
+    """Get cloud masks directory for a resolution."""
+    return _resolve_web_subdir(f'zt{width}{height}', check_fn=_has_themes)

trcc_linux-8.2.5/src/trcc/qt_components/color_and_add_panels.py

@@ -0,0 +1,333 @@
+"""Color picker and add element panels — right-side overlay editors.
+
+ColorPickerPanel: RGB color picker, XY position, font selector, eyedropper.
+AddElementPanel: Create new overlay elements by type with category/metric selection.
+"""
+from __future__ import annotations
+
+from PySide6.QtCore import Qt, Signal
+from PySide6.QtGui import QColor, QFont, QIcon
+from PySide6.QtWidgets import (
+    QComboBox,
+    QFrame,
+    QLabel,
+    QLineEdit,
+    QPushButton,
+    QSpinBox,
+    QVBoxLayout,
+)
+
+from ..core.models import OverlayElementConfig, OverlayMode
+from .assets import Assets
+from .base import set_background_pixmap
+from .constants import Colors, Layout, Sizes, Styles
+from .overlay_element import CATEGORY_COLORS, CATEGORY_NAMES, SUB_METRICS
+
+
+class ColorPickerPanel(QFrame):
+    """Color and position editor (matches UCXiTongXianShiColor 230x374)."""
+
+    color_changed = Signal(int, int, int)
+    position_changed = Signal(int, int)
+    font_changed = Signal(str, int, int)  # name, size, style (0=Regular, 1=Bold)
+    eyedropper_requested = Signal()  # launch eyedropper color picker
+
+    def __init__(self, parent=None):
+        super().__init__(parent)
+        self.setFixedSize(Sizes.COLOR_PANEL_W, Sizes.COLOR_PANEL_H)
+
+        set_background_pixmap(self, 'ucXiTongXianShiColor1.BackgroundImage.png',
+            Sizes.COLOR_PANEL_W, Sizes.COLOR_PANEL_H,
+            fallback_style=f"background-color: {Colors.PANEL_FALLBACK}; border-radius: 5px;")
+
+        self._current_color = QColor(255, 255, 255)
+        self._setup_ui()
+
+    def _setup_ui(self):
+        # X coordinate input
+        self.x_spin = QSpinBox(self)
+        self.x_spin.setGeometry(*Layout.COLOR_X_SPIN)
+        self.x_spin.setRange(0, 480)
+        self.x_spin.setStyleSheet(Styles.INPUT_FIELD)
+        self.x_spin.setButtonSymbols(QSpinBox.ButtonSymbols.NoButtons)
+        self.x_spin.setToolTip("X position")
+        self.x_spin.valueChanged.connect(self._on_position_changed)
+
+        # Y coordinate input
+        self.y_spin = QSpinBox(self)
+        self.y_spin.setGeometry(*Layout.COLOR_Y_SPIN)
+        self.y_spin.setRange(0, 480)
+        self.y_spin.setStyleSheet(Styles.INPUT_FIELD)
+        self.y_spin.setButtonSymbols(QSpinBox.ButtonSymbols.NoButtons)
+        self.y_spin.setToolTip("Y position")
+        self.y_spin.valueChanged.connect(self._on_position_changed)
+
+        # Font picker button (name only)
+        self.font_btn = QPushButton(self)
+        self.font_btn.setGeometry(*Layout.COLOR_FONT_BTN)
+        self.font_btn.setStyleSheet(
+            f"QPushButton {{ background-color: transparent; border: none; "
+            f"color: {Colors.TEXT}; font-size: 10px; text-align: left; padding-left: 27px; }}"
+        )
+        self.font_btn.setText("Microsoft YaHei")
+        self.font_btn.setCursor(Qt.CursorShape.PointingHandCursor)
+        self.font_btn.setToolTip("Choose font")
+        self.font_btn.clicked.connect(self._pick_font)
+        self._current_font_name = "Microsoft YaHei"
+        self._current_font_size = 36
+        self._current_font_style = 0  # 0=Regular, 1=Bold
+
+        # Font size spinbox (separate adjuster)
+        self.font_size_spin = QSpinBox(self)
+        self.font_size_spin.setGeometry(*Layout.COLOR_FONT_SIZE_SPIN)
+        self.font_size_spin.setRange(6, 200)
+        self.font_size_spin.setValue(36)
+        self.font_size_spin.setStyleSheet(Styles.INPUT_FIELD)
+        self.font_size_spin.setToolTip("Font size")
+        self.font_size_spin.valueChanged.connect(self._on_font_size_changed)
+
+        # Color picker area click target
+        self.color_area_btn = QPushButton(self)
+        self.color_area_btn.setGeometry(*Layout.COLOR_AREA)
+        self.color_area_btn.setStyleSheet("background-color: transparent; border: none;")
+        self.color_area_btn.setCursor(Qt.CursorShape.CrossCursor)
+        self.color_area_btn.setToolTip("Pick color")
+        self.color_area_btn.clicked.connect(self._pick_color)
+
+        # RGB input boxes
+        self.r_input = QLineEdit("255", self)
+        self.r_input.setGeometry(*Layout.COLOR_R)
+        self.r_input.setStyleSheet(Styles.RGB_INPUT)
+        self.r_input.setAlignment(Qt.AlignmentFlag.AlignCenter)
+        self.r_input.setToolTip("Red (0-255)")
+
+        self.g_input = QLineEdit("255", self)
+        self.g_input.setGeometry(*Layout.COLOR_G)
+        self.g_input.setStyleSheet(Styles.RGB_INPUT)
+        self.g_input.setAlignment(Qt.AlignmentFlag.AlignCenter)
+        self.g_input.setToolTip("Green (0-255)")
+
+        self.b_input = QLineEdit("255", self)
+        self.b_input.setGeometry(*Layout.COLOR_B)
+        self.b_input.setStyleSheet(Styles.RGB_INPUT)
+        self.b_input.setAlignment(Qt.AlignmentFlag.AlignCenter)
+        self.b_input.setToolTip("Blue (0-255)")
+
+        for inp in (self.r_input, self.g_input, self.b_input):
+            inp.editingFinished.connect(self._on_rgb_changed)
+
+        # Preset color swatches
+        for i, (r, g, b) in enumerate(Colors.PRESET_COLORS):
+            btn = QPushButton(self)
+            btn.setGeometry(
+                Layout.COLOR_SWATCH_X0 + i * Layout.COLOR_SWATCH_DX,
+                Layout.COLOR_SWATCH_PRESET_Y,
+                Layout.COLOR_SWATCH_SIZE, Layout.COLOR_SWATCH_SIZE
+            )
+            btn.setStyleSheet(
+                f"QPushButton {{ background-color: rgb({r},{g},{b}); border: none; }}"
+                f"QPushButton:hover {{ border: 1px solid white; }}"
+            )
+            btn.setCursor(Qt.CursorShape.PointingHandCursor)
+            btn.clicked.connect(lambda checked, cr=r, cg=g, cb=b: self._set_color_from_swatch(cr, cg, cb))
+
+        # History color swatches
+        self._history_btns = []
+        for i in range(len(Colors.PRESET_COLORS)):
+            btn = QPushButton(self)
+            btn.setGeometry(
+                Layout.COLOR_SWATCH_X0 + i * Layout.COLOR_SWATCH_DX,
+                Layout.COLOR_SWATCH_HISTORY_Y,
+                Layout.COLOR_SWATCH_SIZE, Layout.COLOR_SWATCH_SIZE
+            )
+            btn.setStyleSheet("background-color: transparent; border: none;")
+            btn.setCursor(Qt.CursorShape.PointingHandCursor)
+            self._history_btns.append(btn)
+
+        # Eyedropper button (matches Windows buttonGetColor at (12, 276, 48, 48))
+        self.eyedropper_btn = QPushButton(self)
+        self.eyedropper_btn.setGeometry(*Layout.COLOR_EYEDROPPER)
+        eyedrop_pixmap = Assets.load_pixmap('P吸管.png', 48, 48)
+        if not eyedrop_pixmap.isNull():
+            self.eyedropper_btn.setIcon(QIcon(eyedrop_pixmap))
+            self.eyedropper_btn.setIconSize(self.eyedropper_btn.size())
+        self.eyedropper_btn.setFlat(True)
+        self.eyedropper_btn.setStyleSheet(Styles.ICON_BUTTON_HOVER)
+        self.eyedropper_btn.setCursor(Qt.CursorShape.PointingHandCursor)
+        self.eyedropper_btn.setToolTip("Pick color from screen")
+        self.eyedropper_btn.clicked.connect(self.eyedropper_requested.emit)
+
+    def _pick_color(self):
+        from PySide6.QtWidgets import QColorDialog
+        color = QColorDialog.getColor(self._current_color, self, "Pick Color")
+        if color.isValid():
+            self._apply_color(color.red(), color.green(), color.blue())
+
+    def _on_rgb_changed(self):
+        try:
+            r = max(0, min(255, int(self.r_input.text())))
+            g = max(0, min(255, int(self.g_input.text())))
+            b = max(0, min(255, int(self.b_input.text())))
+            self._apply_color(r, g, b)
+        except ValueError:
+            pass
+
+    def _set_color_from_swatch(self, r, g, b):
+        self._apply_color(r, g, b)
+
+    def _apply_color(self, r, g, b):
+        self._current_color = QColor(r, g, b)
+        self.r_input.setText(str(r))
+        self.g_input.setText(str(g))
+        self.b_input.setText(str(b))
+        self.color_changed.emit(r, g, b)
+
+    def _on_position_changed(self):
+        self.position_changed.emit(self.x_spin.value(), self.y_spin.value())
+
+    def set_color(self, r, g, b):
+        self._current_color = QColor(r, g, b)
+        self.r_input.setText(str(r))
+        self.g_input.setText(str(g))
+        self.b_input.setText(str(b))
+
+    def set_color_hex(self, hex_color):
+        """Set color from hex string like '#FF0000'."""
+        c = QColor(hex_color)
+        if c.isValid():
+            self.set_color(c.red(), c.green(), c.blue())
+
+    def set_position(self, x, y):
+        self.x_spin.blockSignals(True)
+        self.y_spin.blockSignals(True)
+        self.x_spin.setValue(x)
+        self.y_spin.setValue(y)
+        self.x_spin.blockSignals(False)
+        self.y_spin.blockSignals(False)
+
+    def _pick_font(self):
+        """Open font dialog (matches Windows FontDialog in UCXiTongXianShiColor)."""
+        from PySide6.QtWidgets import QFontDialog
+        current = QFont(self._current_font_name, self._current_font_size)
+        ok, font = QFontDialog.getFont(current, self, "Pick Font")
+        if ok:
+            self._current_font_name = font.family()
+            self._current_font_size = font.pointSize()
+            # C# Font.Style: 0=Regular, 1=Bold, 2=Italic, 3=BoldItalic
+            self._current_font_style = 1 if font.bold() else 0
+            self.font_btn.setText(font.family())
+            self.font_size_spin.blockSignals(True)
+            self.font_size_spin.setValue(font.pointSize())
+            self.font_size_spin.blockSignals(False)
+            self.font_changed.emit(font.family(), font.pointSize(),
+                                   self._current_font_style)
+
+    def _on_font_size_changed(self, size: int):
+        """Handle font size spinbox change independently."""
+        self._current_font_size = size
+        self.font_changed.emit(self._current_font_name, size,
+                               self._current_font_style)
+
+    def set_font_display(self, font_name, font_size, font_style=0):
+        self._current_font_name = font_name
+        self._current_font_size = font_size
+        self._current_font_style = font_style
+        self.font_btn.setText(font_name)
+        self.font_size_spin.blockSignals(True)
+        self.font_size_spin.setValue(font_size)
+        self.font_size_spin.blockSignals(False)
+
+
+class AddElementPanel(QFrame):
+    """Add new overlay element panel (matches UCXiTongXianShiAdd 230x430)."""
+
+    element_added = Signal(object)  # OverlayElementConfig
+
+    ELEMENT_TYPES = [
+        ("Hardware Data", OverlayMode.HARDWARE),
+        ("Time", OverlayMode.TIME),
+        ("Weekday", OverlayMode.WEEKDAY),
+        ("Date", OverlayMode.DATE),
+        ("Custom Text", OverlayMode.CUSTOM),
+    ]
+
+    def __init__(self, parent=None):
+        super().__init__(parent)
+        self.setFixedSize(Sizes.ADD_PANEL_W, Sizes.ADD_PANEL_H)
+
+        set_background_pixmap(self, 'ucXiTongXianShiAdd1.BackgroundImage.png',
+            Sizes.ADD_PANEL_W, Sizes.ADD_PANEL_H,
+            fallback_style=f"background-color: {Colors.PANEL_FALLBACK}; border-radius: 5px;")
+
+        self._setup_ui()
+
+    def _setup_ui(self):
+        y = Layout.ADD_BTN_Y0
+        for name, mode in self.ELEMENT_TYPES:
+            btn = QPushButton(name, self)
+            btn.setGeometry(Layout.ADD_BTN_X, y, Layout.ADD_BTN_W, Layout.ADD_BTN_H)
+            btn.setStyleSheet(Styles.ADD_ELEMENT_BTN)
+            btn.setCursor(Qt.CursorShape.PointingHandCursor)
+            btn.clicked.connect(lambda checked, m=mode: self._on_type_clicked(m))
+            y += Layout.ADD_BTN_DY
+
+        # Hardware category combo
+        self.hw_frame = QFrame(self)
+        self.hw_frame.setGeometry(Layout.ADD_BTN_X, y + 10, Layout.ADD_BTN_W, 100)
+        self.hw_frame.setStyleSheet("background: transparent;")
+
+        hw_layout = QVBoxLayout(self.hw_frame)
+        hw_layout.setContentsMargins(0, 0, 0, 0)
+
+        hw_label = QLabel("Category:")
+        hw_label.setStyleSheet(f"color: {Colors.STATUS_TEXT}; font-size: 10px; background: transparent;")
+        hw_layout.addWidget(hw_label)
+
+        self.hw_combo = QComboBox()
+        self.hw_combo.addItems(list(CATEGORY_NAMES.values()))
+        self.hw_combo.setToolTip("Hardware category")
+        self.hw_combo.setStyleSheet("""
+            QComboBox {
+                background-color: rgba(51, 51, 51, 180);
+                color: white; border: 1px solid #555; padding: 5px;
+            }
+        """)
+        hw_layout.addWidget(self.hw_combo)
+
+        metric_label = QLabel("Metric:")
+        metric_label.setStyleSheet(f"color: {Colors.STATUS_TEXT}; font-size: 10px; background: transparent;")
+        hw_layout.addWidget(metric_label)
+
+        self.metric_combo = QComboBox()
+        self.metric_combo.setToolTip("Sensor metric")
+        self.metric_combo.setStyleSheet("""
+            QComboBox {
+                background-color: rgba(51, 51, 51, 180);
+                color: white; border: 1px solid #555; padding: 5px;
+            }
+        """)
+        hw_layout.addWidget(self.metric_combo)
+
+        self.hw_combo.currentIndexChanged.connect(self._on_category_changed)
+        self._on_category_changed(0)
+
+        self.hw_frame.setVisible(False)
+
+    def _on_category_changed(self, idx):
+        self.metric_combo.clear()
+        metrics = SUB_METRICS.get(idx, {})
+        self.metric_combo.addItems(list(metrics.values()))
+
+    def _on_type_clicked(self, mode: OverlayMode):
+        cfg = OverlayElementConfig(mode=mode)
+
+        if mode == OverlayMode.HARDWARE:
+            self.hw_frame.setVisible(True)
+            cat_idx = self.hw_combo.currentIndex()
+            cfg.main_count = cat_idx
+            cfg.sub_count = self.metric_combo.currentIndex() + 1
+            cfg.color = CATEGORY_COLORS.get(cat_idx, '#FFFFFF')
+        else:
+            self.hw_frame.setVisible(False)
+
+        self.element_added.emit(cfg)