monkeyqt 0.1.0__py3-none-any.whl

monkeyqt/__init__.py

@@ -0,0 +1,154 @@
+from .components.basic.button import MkButton
+from .components.basic.checkbox import MkCheckBox
+# Navigation
+from .components.navigation.sidebar import MkMenu
+from .components.navigation.topbar import MkTopbar
+from .components.navigation.breadcrumb import MkBreadcrumb
+from .components.navigation.tabs import MkTabs
+from .components.navigation.pagination import MkPagination
+from .components.navigation.dropdown import MkDropdown
+
+# Form
+from .components.form.switch import MkSwitch
+from .components.form.slider import MkSlider
+from .components.form.date_picker import MkDatePicker
+from .components.form.form import MkForm
+from .components.form.input import MkInput
+from .components.form.captcha import MkCaptchaWidget
+from .components.form.auth import MkAuthScreen, MkMessage
+from .components.form.upload import MkUpload
+from .components.form.combobox import MkComboBox
+from .components.form.multicombobox import MkMultiComboBox
+
+# Data
+from .components.data.avatar import MkAvatar
+from .components.data.table import MkTable
+from .components.data.data_table import MkDataTable
+from .components.data.image_compare import MkImageCompare
+from .components.data.image_split import MkImageSplit
+
+# Feedback
+from .components.feedback.alert import MkAlert
+from .components.feedback.progress_bar import MkProgressBar
+from .components.feedback.progress_ring import MkProgressRing
+
+# Layout
+from .components.layout.window import MkTitleBar, MkWindow
+
+
+# Themes (67 UI Styles)
+from .themes import (
+    ThemeEngine,
+    apply_monkeyqt_theme,
+    use_theme,
+    set_theme_chrome,
+    clear_theme_chrome,
+    clear_theme,
+    set_theme_enabled,
+    exclude_from_theme,
+    include_in_theme,
+    MkThemeSelector,
+    ThemedButton,
+    ThemedCheckBox,
+    ThemedInput,
+    ThemedSwitch,
+    ThemedCard,
+    ThemedProgressBar,
+    ThemedProgressRing,
+    ThemedAlert,
+    ThemedComboBox,
+    ThemedSlider,
+    ThemedTabs,
+    ThemedAvatar,
+    ThemedPagination,
+    ThemedBreadcrumb,
+    ThemedDropdown,
+    ThemedTable,
+    ThemedForm,
+    ThemedDatePicker,
+    ThemedMultiComboBox,
+    ThemedUpload,
+    ThemedTopbar,
+    ThemedMenu,
+    ThemedMessage,
+    ThemedCaptchaWidget,
+    ThemedDataTable,
+    ThemedImageCompare,
+    ThemedImageSplit,
+    ThemedTitleBar,
+    ThemedWindowShell,
+)
+
+__version__ = "0.1.0"
+
+__all__ = [
+    "MkButton",
+    "MkCheckBox",
+    "MkMenu",
+    "MkTopbar",
+    "MkBreadcrumb",
+    "MkTabs",
+    "MkPagination",
+    "MkDropdown",
+    "MkSwitch",
+    "MkSlider",
+    "MkDatePicker",
+    "MkForm",
+    "MkInput",
+    "MkComboBox",
+    "MkMultiComboBox",
+    "MkCaptchaWidget",
+    "MkAuthScreen",
+    "MkMessage",
+    "MkUpload",
+    "MkAvatar",
+    "MkTable",
+    "MkDataTable",
+    "MkImageCompare",
+    "MkImageSplit",
+    "MkAlert",
+    "MkProgressBar",
+    "MkProgressRing",
+    "MkTitleBar",
+    "MkWindow",
+    # Themed components
+    "ThemeEngine",
+    "apply_monkeyqt_theme",
+    "use_theme",
+    "set_theme_chrome",
+    "clear_theme_chrome",
+    "clear_theme",
+    "set_theme_enabled",
+    "exclude_from_theme",
+    "include_in_theme",
+    "MkThemeSelector",
+    "ThemedButton",
+    "ThemedCheckBox",
+    "ThemedInput",
+    "ThemedSwitch",
+    "ThemedCard",
+    "ThemedProgressBar",
+    "ThemedProgressRing",
+    "ThemedAlert",
+    "ThemedComboBox",
+    "ThemedSlider",
+    "ThemedTabs",
+    "ThemedAvatar",
+    "ThemedPagination",
+    "ThemedBreadcrumb",
+    "ThemedDropdown",
+    "ThemedTable",
+    "ThemedForm",
+    "ThemedDatePicker",
+    "ThemedMultiComboBox",
+    "ThemedUpload",
+    "ThemedTopbar",
+    "ThemedMenu",
+    "ThemedMessage",
+    "ThemedCaptchaWidget",
+    "ThemedDataTable",
+    "ThemedImageCompare",
+    "ThemedImageSplit",
+    "ThemedTitleBar",
+    "ThemedWindowShell",
+]

monkeyqt/common/enums.py

@@ -0,0 +1,14 @@
+from enum import Enum
+
+class MkType(str, Enum):
+    DEFAULT = "default"
+    PRIMARY = "primary"
+    SUCCESS = "success"
+    WARNING = "warning"
+    DANGER = "danger"
+    INFO = "info"
+
+class MkSize(str, Enum):
+    LARGE = "large"
+    DEFAULT = "default"
+    SMALL = "small"

monkeyqt/components/basic/button.py

@@ -0,0 +1,191 @@
+from PySide6.QtWidgets import QPushButton, QWidget
+from PySide6.QtCore import Property, Qt
+from monkeyqt.common.enums import MkType, MkSize
+
+class MkButton(QPushButton):
+    """MkButton 组件"""
+    
+    def __init__(self, text="", parent=None, type=MkType.DEFAULT.value, size=MkSize.DEFAULT.value):
+        # 兼容 Qt Designer (它实例化时会将 parent 传给第一个参数)
+        if isinstance(text, QWidget):
+            parent = text
+            text = ""
+            
+        super().__init__(text, parent)
+        
+        self._mk_type = type
+        self._mk_size = size
+        
+        self.setCursor(Qt.CursorShape.PointingHandCursor)
+        
+        # 实际开发中，这里应该调用 ThemeManager 加载 QSS
+        # 以下是完整的 Element Plus 风格按钮样式
+        self.setStyleSheet("""
+            /* Default 基础样式 */
+            MkButton {
+                border-radius: 4px;
+                font-family: "Helvetica Neue", Helvetica, "PingFang SC", "Microsoft YaHei", Arial, sans-serif;
+                font-weight: 500;
+                border: 1px solid #dcdfe6;
+                background-color: #ffffff;
+                color: #606266;
+                outline: none;
+            }
+            MkButton:hover {
+                color: #409eff;
+                border-color: #c6e2ff;
+                background-color: #ecf5ff;
+            }
+            MkButton:pressed {
+                color: #3a8ee6;
+                border-color: #3a8ee6;
+                outline: none;
+            }
+            MkButton:disabled {
+                color: #c0c4cc;
+                background-color: #ffffff;
+                border-color: #ebeef5;
+            }
+
+            /* Primary */
+            MkButton[mk_type="primary"] {
+                color: #ffffff;
+                background-color: #409eff;
+                border-color: #409eff;
+            }
+            MkButton[mk_type="primary"]:hover {
+                background-color: #66b1ff;
+                border-color: #66b1ff;
+            }
+            MkButton[mk_type="primary"]:pressed {
+                background-color: #3a8ee6;
+                border-color: #3a8ee6;
+            }
+            MkButton[mk_type="primary"]:disabled {
+                color: #ffffff;
+                background-color: #a0cfff;
+                border-color: #a0cfff;
+            }
+
+            /* Success */
+            MkButton[mk_type="success"] {
+                color: #ffffff;
+                background-color: #67c23a;
+                border-color: #67c23a;
+            }
+            MkButton[mk_type="success"]:hover {
+                background-color: #85ce61;
+                border-color: #85ce61;
+            }
+            MkButton[mk_type="success"]:pressed {
+                background-color: #5daf34;
+                border-color: #5daf34;
+            }
+            MkButton[mk_type="success"]:disabled {
+                color: #ffffff;
+                background-color: #b3e19d;
+                border-color: #b3e19d;
+            }
+
+            /* Warning */
+            MkButton[mk_type="warning"] {
+                color: #ffffff;
+                background-color: #e6a23c;
+                border-color: #e6a23c;
+            }
+            MkButton[mk_type="warning"]:hover {
+                background-color: #ebb563;
+                border-color: #ebb563;
+            }
+            MkButton[mk_type="warning"]:pressed {
+                background-color: #cf9236;
+                border-color: #cf9236;
+            }
+            MkButton[mk_type="warning"]:disabled {
+                color: #ffffff;
+                background-color: #f3d19e;
+                border-color: #f3d19e;
+            }
+
+            /* Danger */
+            MkButton[mk_type="danger"] {
+                color: #ffffff;
+                background-color: #f56c6c;
+                border-color: #f56c6c;
+            }
+            MkButton[mk_type="danger"]:hover {
+                background-color: #f78989;
+                border-color: #f78989;
+            }
+            MkButton[mk_type="danger"]:pressed {
+                background-color: #dd6161;
+                border-color: #dd6161;
+            }
+            MkButton[mk_type="danger"]:disabled {
+                color: #ffffff;
+                background-color: #fab6b6;
+                border-color: #fab6b6;
+            }
+
+            /* Info */
+            MkButton[mk_type="info"] {
+                color: #ffffff;
+                background-color: #909399;
+                border-color: #909399;
+            }
+            MkButton[mk_type="info"]:hover {
+                background-color: #a6a9ad;
+                border-color: #a6a9ad;
+            }
+            MkButton[mk_type="info"]:pressed {
+                background-color: #82848a;
+                border-color: #82848a;
+            }
+            MkButton[mk_type="info"]:disabled {
+                color: #ffffff;
+                background-color: #c8c9cc;
+                border-color: #c8c9cc;
+            }
+
+            /* 尺寸 Sizes */
+            MkButton[mk_size="large"] {
+                padding: 12px 19px;
+                font-size: 14px;
+            }
+            MkButton[mk_size="default"] {
+                padding: 8px 15px;
+                font-size: 14px;
+            }
+            MkButton[mk_size="small"] {
+                padding: 5px 11px;
+                font-size: 12px;
+                border-radius: 3px;
+            }
+        """)
+
+    # 暴露给 Qt Designer 的右侧属性面板
+    @Property(str)
+    def mk_type(self):
+        return self._mk_type
+
+    @mk_type.setter
+    def mk_type(self, value):
+        if self._mk_type == value:
+            return
+        self._mk_type = value
+        self.setProperty("mk_type", value)
+        self.style().unpolish(self)
+        self.style().polish(self)
+
+    @Property(str)
+    def mk_size(self):
+        return self._mk_size
+
+    @mk_size.setter
+    def mk_size(self, value):
+        if self._mk_size == value:
+            return
+        self._mk_size = value
+        self.setProperty("mk_size", value)
+        self.style().unpolish(self)
+        self.style().polish(self)

monkeyqt/components/basic/checkbox.py

@@ -0,0 +1,112 @@
+from PySide6.QtWidgets import QCheckBox, QWidget
+from PySide6.QtCore import Property, Qt
+from monkeyqt.common.enums import MkSize
+
+class MkCheckBox(QCheckBox):
+    """
+    MkCheckBox 组件
+    对标 Element Plus 的 Checkbox，支持自定义尺寸和现代化的选中动画（通过 QSS）。
+    """
+    
+    def __init__(self, text="", parent=None, size=MkSize.DEFAULT.value):
+        # 兼容 Qt Designer
+        if isinstance(text, QWidget):
+            parent = text
+            text = ""
+            
+        super().__init__(text, parent)
+        
+        self._mk_size = size
+        self.setCursor(Qt.CursorShape.PointingHandCursor)
+        
+        self._apply_style()
+
+    def _apply_style(self):
+        """注入 Element Plus 风格的 QSS 样式"""
+        self.setStyleSheet("""
+            /* 基础样式与文本颜色 */
+            MkCheckBox {
+                font-family: "Helvetica Neue", Helvetica, "PingFang SC", "Microsoft YaHei", Arial, sans-serif;
+                color: #606266;
+                spacing: 8px; /* 框与文字的间距 */
+                outline: none;
+            }
+            MkCheckBox:hover {
+                color: #409eff;
+            }
+            MkCheckBox:disabled {
+                color: #c0c4cc;
+            }
+
+            /* 自定义勾选框 (Indicator) */
+            MkCheckBox::indicator {
+                width: 14px;
+                height: 14px;
+                background-color: #ffffff;
+                border: 1px solid #dcdfe6;
+                border-radius: 2px;
+                transition: border-color .25s cubic-bezier(.71,-.46,.29,1.46),background-color .25s cubic-bezier(.71,-.46,.29,1.46);
+            }
+
+            /* 悬浮时的框边框变蓝 */
+            MkCheckBox::indicator:hover {
+                border-color: #409eff;
+            }
+
+            /* 选中状态 */
+            MkCheckBox::indicator:checked {
+                background-color: #409eff;
+                border-color: #409eff;
+                /* Qt 的 QSS 不支持绘制复杂的 SVG，这里我们用一个 unicode 字符模拟对号，或者依赖背景图。
+                   为保持纯代码，我们先利用自带的选中样式或后续加载本地 svg */
+                image: url(none); /* 阻止原生丑陋渲染 */
+            }
+            
+            /* 禁用状态 */
+            MkCheckBox::indicator:disabled {
+                background-color: #edf2fc;
+                border-color: #dcdfe6;
+            }
+            MkCheckBox::indicator:checked:disabled {
+                background-color: #a0cfff;
+                border-color: #a0cfff;
+            }
+
+            /* --- 尺寸控制 --- */
+            MkCheckBox[mk_size="large"] {
+                font-size: 14px;
+                height: 40px;
+            }
+            MkCheckBox[mk_size="large"]::indicator {
+                width: 16px;
+                height: 16px;
+            }
+            
+            MkCheckBox[mk_size="default"] {
+                font-size: 14px;
+                height: 32px;
+            }
+            
+            MkCheckBox[mk_size="small"] {
+                font-size: 12px;
+                height: 24px;
+            }
+            MkCheckBox[mk_size="small"]::indicator {
+                width: 12px;
+                height: 12px;
+            }
+        """)
+
+    # --- 暴露属性 ---
+    @Property(str)
+    def mk_size(self):
+        return self._mk_size
+
+    @mk_size.setter
+    def mk_size(self, value):
+        if self._mk_size == value:
+            return
+        self._mk_size = value
+        self.setProperty("mk_size", value)
+        self.style().unpolish(self)
+        self.style().polish(self)

monkeyqt/components/data/avatar.py

@@ -0,0 +1,101 @@
+import os
+from PySide6.QtWidgets import QLabel, QSizePolicy
+from PySide6.QtCore import Qt, Property, QRect
+from PySide6.QtGui import QPainter, QPainterPath, QColor, QPixmap, QFont
+
+class MkAvatar(QLabel):
+    """
+    头像组件 (Avatar)
+    支持圆形和矩形，支持显示图片或文字。
+    """
+    def __init__(self, text="", image_path="", shape="circle", size=40, parent=None):
+        super().__init__(parent)
+        self._text = text
+        self._image_path = image_path
+        self._shape = shape # circle, square
+        self._avatar_size = size
+        
+        self.setFixedSize(self._avatar_size, self._avatar_size)
+        self.setAlignment(Qt.AlignCenter)
+        self._setup_style()
+
+    def _setup_style(self):
+        font = self.font()
+        font.setPixelSize(int(self._avatar_size * 0.4))
+        self.setFont(font)
+        
+        # We handle drawing entirely in paintEvent
+        self.setAttribute(Qt.WA_TranslucentBackground)
+
+    def paintEvent(self, event):
+        painter = QPainter(self)
+        painter.setRenderHint(QPainter.Antialiasing)
+        painter.setRenderHint(QPainter.SmoothPixmapTransform)
+
+        rect = self.rect()
+        path = QPainterPath()
+
+        if self._shape == "circle":
+            path.addEllipse(rect)
+        else:
+            # Rounded square
+            path.addRoundedRect(rect, 4, 4)
+
+        painter.setClipPath(path)
+
+        if self._image_path and os.path.exists(self._image_path):
+            pixmap = QPixmap(self._image_path)
+            # Scale and crop to fill
+            scaled = pixmap.scaled(self.size(), Qt.KeepAspectRatioByExpanding, Qt.SmoothTransformation)
+            
+            # Center the pixmap
+            x = (self.width() - scaled.width()) // 2
+            y = (self.height() - scaled.height()) // 2
+            painter.drawPixmap(x, y, scaled)
+        else:
+            # Draw background
+            painter.fillPath(path, QColor("#c0c4cc"))
+            
+            # Draw text
+            if self._text:
+                painter.setPen(QColor("white"))
+                painter.drawText(rect, Qt.AlignCenter, self._text[:2].upper())
+
+    @Property(str)
+    def text(self):
+        return self._text
+
+    @text.setter
+    def text(self, value):
+        self._text = value
+        self.update()
+
+    @Property(str)
+    def image_path(self):
+        return self._image_path
+
+    @image_path.setter
+    def image_path(self, value):
+        self._image_path = value
+        self.update()
+
+    @Property(str)
+    def shape(self):
+        return self._shape
+
+    @shape.setter
+    def shape(self, value):
+        if value in ["circle", "square"]:
+            self._shape = value
+            self.update()
+
+    @Property(int)
+    def size(self):
+        return self._avatar_size
+
+    @size.setter
+    def size(self, value):
+        self._avatar_size = value
+        self.setFixedSize(value, value)
+        self._setup_style()
+        self.update()