simpleui-py 1.2.2__tar.gz → 1.3.0__tar.gz

{simpleui_py-1.2.2/simpleui_py.egg-info → simpleui_py-1.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: simpleui-py
-Version: 1.2.2
+Version: 1.3.0
 Summary: Fluent风格Python UI组件库 - 简约设计，无限可能
 Author-email: SimpleUI Team <hello@simpleui.dev>
 License: MIT
@@ -46,7 +46,8 @@ Dynamic: license-file
 
 
 
-\## 安装
+\## 安装:pip install simpleui=={版本} 引用:from simpleui import {内容}
+
 
 
 

{simpleui_py-1.2.2 → simpleui_py-1.3.0}/README.md

@@ -22,7 +22,8 @@
 
 
 
-\## 安装
+\## 安装:pip install simpleui=={版本} 引用:from simpleui import {内容}
+
 
 
 

{simpleui_py-1.2.2 → simpleui_py-1.3.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "simpleui-py"
-version = "1.2.2"
+version = "1.3.0"
 description = "Fluent风格Python UI组件库 - 简约设计，无限可能"
 readme = "README.md"
 license = {text = "MIT"}

{simpleui_py-1.2.2 → simpleui_py-1.3.0}/simpleui/__init__.py

@@ -1,12 +1,10 @@
 """
 SimpleUI - Fluent 风格 Python UI 组件库
-简约设计，无限可能
 """
 
-__version__ = "1.2.2"
+__version__ = "1.3.0"
 __author__ = "SimpleUI Team"
 
-# 从 core 导入核心功能
 from .core import (
     Component,
     Theme,
@@ -17,7 +15,6 @@ from .core import (
     get_theme,
 )
 
-# 从 components 导入所有组件
 from .components import (
     Button,
     ButtonGroup,
@@ -31,18 +28,17 @@ from .components import (
     Container,
     Row,
     Column,
+    Window,
+    WindowManager,
 )
 
-# 从 utils 导入工具函数
+from .stage import Stage, Sprite  # 新增
+
 from .utils import preview, serve, demo, playground
 
-# 导出列表
 __all__ = [
-    # 版本信息
     "__version__",
     "__author__",
-    
-    # 核心类
     "Component",
     "Theme",
     "ThemeType",
@@ -50,8 +46,6 @@ __all__ = [
     "export_html",
     "set_theme",
     "get_theme",
-    
-    # 组件
     "Button",
     "ButtonGroup",
     "Input",
@@ -64,8 +58,10 @@ __all__ = [
     "Container",
     "Row",
     "Column",
-    
-    # 工具函数
+    "Window",
+    "WindowManager",
+    "Stage",    # 新增
+    "Sprite",   # 新增
     "preview",
     "serve",
     "demo",

{simpleui_py-1.2.2 → simpleui_py-1.3.0}/simpleui/components/__init__.py

@@ -10,7 +10,7 @@ from .tag import Tag
 from .progress import Progress
 from .alert import Alert
 from .layout import Container, Row, Column
-from .window import Window, WindowManager  # 新增
+from .window import Window, WindowManager
 
 __all__ = [
     "Button",
@@ -25,6 +25,6 @@ __all__ = [
     "Container",
     "Row",
     "Column",
-    "Window",        # 新增
-    "WindowManager", # 新增
+    "Window",
+    "WindowManager",
 ]

simpleui_py-1.3.0/simpleui/components/button.py

@@ -0,0 +1,105 @@
+"""按钮组件"""
+from typing import Optional, Literal
+from ..core import Component
+from ..icons import get_icon
+
+
+class Button(Component):
+    """按钮组件"""
+    
+    VARIANT_CLASSES = {
+        "primary": "sui-btn-primary",
+        "secondary": "sui-btn-secondary",
+        "outline": "sui-btn-outline",
+        "ghost": "sui-btn-ghost",
+        "danger": "sui-btn-danger",
+        "success": "sui-btn-success",
+    }
+    
+    SIZE_CLASSES = {
+        "sm": "sui-btn-sm",
+        "md": "",
+        "lg": "sui-btn-lg",
+    }
+    
+    def __init__(
+        self,
+        text: Optional[str] = None,
+        variant: str = "primary",
+        size: str = "md",
+        icon: Optional[str] = None,
+        icon_position: str = "left",
+        loading: bool = False,
+        disabled: bool = False,
+        href: Optional[str] = None,
+        onclick: Optional[str] = None,
+        **kwargs
+    ):
+        super().__init__(**kwargs)
+        self.text = text
+        self.variant = variant
+        self.size = size
+        self.icon = icon
+        self.icon_position = icon_position
+        self.loading = loading
+        self.disabled = disabled
+        self.href = href
+        self.onclick = onclick
+    
+    def _get_base_classes(self) -> str:
+        classes = ["sui-btn", self.VARIANT_CLASSES.get(self.variant, ""), self.SIZE_CLASSES.get(self.size, "")]
+        if self.loading:
+            classes.append("sui-btn-loading")
+        if self.class_name:
+            classes.append(self.class_name)
+        return " ".join(classes)
+    
+    def _get_attributes_str(self) -> str:
+        attrs = super()._get_attributes_str()
+        if self.disabled or self.loading:
+            attrs += " disabled"
+        if self.onclick and not self.disabled:
+            attrs += f' onclick="{self.onclick}"'
+        return attrs
+    
+    def _render_icon(self) -> str:
+        if not self.icon:
+            return ""
+        
+        icon_path = get_icon(self.icon)
+        if not icon_path:
+            return ""
+        
+        icon_html = f'<svg viewBox="0 0 24 24" fill="currentColor" width="16" height="16">{icon_path}</svg>'
+        
+        if self.icon_position == "right":
+            return f'<span>{self.text or ""}</span>{icon_html}'
+        return f'{icon_html}<span>{self.text or ""}</span>'
+    
+    def render(self) -> str:
+        content = self._render_icon() if self.icon else (self.text or "")
+        content += self._render_children()
+        
+        if self.href:
+            return f'<a href="{self.href}" {self._get_attributes_str()}>{content}</a>'
+        return f'<button {self._get_attributes_str()}>{content}</button>'
+    
+    @classmethod
+    def icon_button(cls, icon: str, variant: str = "primary", size: str = "md", **kwargs) -> "Button":
+        """创建图标按钮"""
+        return cls(variant=variant, size=size, icon=icon, class_name="sui-btn-icon " + kwargs.pop("class_name", ""), **kwargs)
+
+
+class ButtonGroup(Component):
+    """按钮组"""
+    
+    def __init__(self, *buttons, **kwargs):
+        super().__init__(**kwargs)
+        for btn in buttons:
+            self.add_child(btn)
+    
+    def _get_base_classes(self) -> str:
+        return f"sui-btn-group {self.class_name}".strip()
+    
+    def render(self) -> str:
+        return f'<div {self._get_attributes_str()}>{self._render_children()}</div>'

simpleui_py-1.3.0/simpleui/components/input.py

@@ -0,0 +1,85 @@
+"""输入框组件"""
+from typing import Optional, Literal
+from ..core import Component
+from ..icons import get_icon
+
+
+class Input(Component):
+    """输入框组件"""
+    
+    STATUS_CLASSES = {"default": "", "success": "sui-input-success", "error": "sui-input-error"}
+    
+    def __init__(
+        self,
+        label: Optional[str] = None,
+        placeholder: Optional[str] = None,
+        value: Optional[str] = None,
+        type: str = "text",
+        status: str = "default",
+        helper_text: Optional[str] = None,
+        icon: Optional[str] = None,  # 直接使用图标名
+        disabled: bool = False,
+        required: bool = False,
+        **kwargs
+    ):
+        super().__init__(**kwargs)
+        self.label = label
+        self.placeholder = placeholder
+        self.value = value
+        self.type = type
+        self.status = status
+        self.helper_text = helper_text
+        self.icon = icon
+        self.disabled = disabled
+        self.required = required
+    
+    def render(self) -> str:
+        html = ['<div class="sui-input-wrapper">']
+        
+        if self.label:
+            html.append(f'<label class="sui-input-label">{self.label}{" *" if self.required else ""}</label>')
+        
+        input_class = f"sui-input {self.STATUS_CLASSES.get(self.status, '')}".strip()
+        attrs = [f'type="{self.type}"', f'class="{input_class}"']
+        
+        if self.placeholder:
+            attrs.append(f'placeholder="{self.placeholder}"')
+        if self.value:
+            attrs.append(f'value="{self.value}"')
+        if self.disabled:
+            attrs.append("disabled")
+        if self.required:
+            attrs.append("required")
+        
+        if self.icon:
+            icon_path = get_icon(self.icon)
+            html.append('<div class="sui-input-icon-wrapper">')
+            html.append(f'<span class="sui-input-icon"><svg viewBox="0 0 24 24" fill="currentColor" width="18" height="18">{icon_path}</svg></span>')
+            html.append(f'<input {" ".join(attrs)}>')
+            html.append('</div>')
+        else:
+            html.append(f'<input {" ".join(attrs)}>')
+        
+        if self.helper_text:
+            h_class = "sui-input-helper" + (" sui-input-error-text" if self.status == "error" else "")
+            html.append(f'<span class="{h_class}">{self.helper_text}</span>')
+        
+        html.append('</div>')
+        return "".join(html)
+
+
+class TextArea(Component):
+    """多行文本"""
+    
+    def __init__(self, label: Optional[str] = None, placeholder: Optional[str] = None, rows: int = 4, **kwargs):
+        super().__init__(**kwargs)
+        self.label = label
+        self.placeholder = placeholder
+        self.rows = rows
+    
+    def render(self) -> str:
+        html = ['<div class="sui-input-wrapper">']
+        if self.label:
+            html.append(f'<label class="sui-input-label">{self.label}</label>')
+        html.append(f'<textarea class="sui-input sui-textarea" rows="{self.rows}" placeholder="{self.placeholder or ""}"></textarea></div>')
+        return "".join(html)

simpleui_py-1.3.0/simpleui/components/layout.py

@@ -0,0 +1,57 @@
+"""布局组件"""
+from typing import Union
+from ..core import Component
+
+
+class Container(Component):
+    """容器"""
+
+    def __init__(self, *children, max_width: str = "1200px", **kwargs):
+        super().__init__(**kwargs)
+        self.max_width = max_width
+        for child in children:
+            self.add_child(child)
+
+    def _get_style_str(self) -> str:
+        return f"max-width:{self.max_width};margin:0 auto;padding:2rem"
+
+    def render(self) -> str:
+        return f'<div class="sui-container" style="{self._get_style_str()}">{self._render_children()}</div>'
+
+
+class Row(Component):
+    """行布局"""
+
+    ALIGN = {"start": "flex-start", "center": "center", "end": "flex-end"}
+    JUSTIFY = {"start": "flex-start", "center": "center", "end": "flex-end", "between": "space-between",
+               "around": "space-around"}
+
+    def __init__(self, *children, gap: str = "1rem", justify: str = "start", align: str = "center", **kwargs):
+        super().__init__(**kwargs)
+        self.gap = gap
+        self.justify = justify
+        self.align = align
+        for child in children:
+            self.add_child(child)
+
+    def _get_style_str(self) -> str:
+        return f"display:flex;flex-wrap:wrap;gap:{self.gap};justify-content:{self.JUSTIFY.get(self.justify, self.justify)};align-items:{self.ALIGN.get(self.align, self.align)}"
+
+    def render(self) -> str:
+        return f'<div class="sui-row" style="{self._get_style_str()}">{self._render_children()}</div>'
+
+
+class Column(Component):
+    """列布局"""
+
+    def __init__(self, *children, flex: int = 1, **kwargs):
+        super().__init__(**kwargs)
+        self.flex = flex
+        for child in children:
+            self.add_child(child)
+
+    def _get_style_str(self) -> str:
+        return f"flex:{self.flex};min-width:200px"
+
+    def render(self) -> str:
+        return f'<div class="sui-column" style="{self._get_style_str()}">{self._render_children()}</div>'

{simpleui_py-1.2.2 → simpleui_py-1.3.0}/simpleui/components/window.py

@@ -1,6 +1,6 @@
 """
 窗口组件
-可拖动的窗口，支持子组件随窗口移动
+可拖动的窗口，使用 TurboWarp 坐标系
 """
 
 from typing import Optional, List, Union
@@ -11,12 +11,19 @@ class Window(Component):
     """
     可拖动窗口组件
     
+    使用 TurboWarp 坐标系：
+    - 原点在舞台中心
+    - X轴：右为正，左为负
+    - Y轴：上为正，下为负
+    
     参数:
         title: 窗口标题
         width: 窗口宽度
         height: 窗口高度
-        x: 初始X坐标
-        y: 初始Y坐标
+        x: X坐标（中心为0，右为正）
+        y: Y坐标（中心为0，上为正）
+        stage_width: 舞台宽度
+        stage_height: 舞台高度
         draggable: 是否可拖动
         resizable: 是否可调整大小
         closable: 是否可关闭
@@ -25,7 +32,7 @@ class Window(Component):
         fixed_child: 子组件是否随窗口移动
     
     示例:
-        win = Window(title="我的窗口", x=100, y=100)
+        win = Window(title="窗口", x=100, y=100)
         win.add_child(Button("按钮", variant="primary"))
         preview(win)
     """
@@ -35,30 +42,93 @@ class Window(Component):
         title: str = "窗口",
         width: str = "400px",
         height: str = "300px",
-        x: int = 100,
-        y: int = 100,
+        x: int = 0,
+        y: int = 0,
+        stage_width: int = 800,
+        stage_height: int = 600,
         draggable: bool = True,
         resizable: bool = True,
         closable: bool = True,
         minimize: bool = True,
         header: bool = True,
-        fixed_child: bool = True,  # 改这里
+        fixed_child: bool = True,
         **kwargs
     ):
         super().__init__(**kwargs)
         self.title = title
         self.width = width
         self.height = height
-        self.x = x
-        self.y = y
+        self._x = x
+        self._y = y
+        self.stage_width = stage_width
+        self.stage_height = stage_height
         self.draggable = draggable
         self.resizable = resizable
         self.closable = closable
         self.minimize = minimize
         self.header = header
-        self.fixed_child = fixed_child  # 改这里
+        self.fixed_child = fixed_child
         self._children: List[Union[Component, str]] = []
         self._minimized = False
+        
+        # 计算中心点
+        self._center_x = stage_width // 2
+        self._center_y = stage_height // 2
+    
+    @property
+    def x(self) -> int:
+        """获取 X 坐标"""
+        return self._x
+    
+    @x.setter
+    def x(self, value: int):
+        """设置 X 坐标"""
+        self._x = value
+    
+    @property
+    def y(self) -> int:
+        """获取 Y 坐标"""
+        return self._y
+    
+    @y.setter
+    def y(self, value: int):
+        """设置 Y 坐标"""
+        self._y = value
+    
+    def to_screen_coords(self) -> tuple:
+        """
+        将 TurboWarp 坐标转换为屏幕坐标
+        
+        返回:
+            (screen_x, screen_y) 屏幕坐标
+        """
+        screen_x = self._center_x + self._x
+        screen_y = self._center_y - self._y  # Y轴反转
+        return int(screen_x), int(screen_y)
+    
+    def move(self, dx: int, dy: int) -> 'Window':
+        """
+        移动窗口
+        
+        参数:
+            dx: X方向移动量（右为正）
+            dy: Y方向移动量（上为正）
+        """
+        self._x += dx
+        self._y += dy
+        return self
+    
+    def goto(self, x: int, y: int) -> 'Window':
+        """
+        移动到指定位置
+        
+        参数:
+            x: X坐标
+            y: Y坐标
+        """
+        self._x = x
+        self._y = y
+        return self
     
     def add_child(self, child: Union[Component, str]) -> 'Window':
         """添加子组件"""
@@ -80,12 +150,15 @@ class Window(Component):
     
     def render(self) -> str:
         """渲染窗口"""
+        # 转换坐标
+        screen_x, screen_y = self.to_screen_coords()
+        
         # 窗口样式
         window_style = f"""
             width: {self.width};
             height: {self.height};
-            left: {self.x}px;
-            top: {self.y}px;
+            left: {screen_x}px;
+            top: {screen_y}px;
         """
         
         # 标题栏按钮
@@ -101,11 +174,14 @@ class Window(Component):
         # 调整大小
         resize_handle = '<div class="sui-window-resize"></div>' if self.resizable else ''
         
-        # 子组件容器 - 改这里
+        # 子组件容器
         children_class = "sui-window-content" if self.fixed_child else "sui-window-content-absolute"
         
+        # 存储坐标信息
+        data_attrs = f'data-x="{self._x}" data-y="{self._y}" data-stage-width="{self.stage_width}" data-stage-height="{self.stage_height}"'
+        
         html = f'''
-<div class="{self._get_base_classes()}" style="{window_style}" {drag_attr}>
+<div class="{self._get_base_classes()}" style="{window_style}" {drag_attr} {data_attrs}>
     <!-- 标题栏 -->
     {'<div class="sui-window-header">' if self.header else '<div class="sui-window-header" style="display:none">'}
         <span class="sui-window-title">{self.title}</span>
@@ -129,26 +205,40 @@ class Window(Component):
 class WindowManager:
     """
     窗口管理器
-    用于管理多个窗口
     
-    示例:
-        wm = WindowManager()
-        wm.add_window(Window(title="窗口1"))
-        wm.add_window(Window(title="窗口2"))
-        preview(wm)
+    参数:
+        stage_width: 舞台宽度
+        stage_height: 舞台高度
     """
     
-    def __init__(self):
+    def __init__(
+        self,
+        stage_width: int = 800,
+        stage_height: int = 600
+    ):
         self.windows: List[Window] = []
+        self.stage_width = stage_width
+        self.stage_height = stage_height
     
     def add_window(self, window: Window) -> 'WindowManager':
         """添加窗口"""
         self.windows.append(window)
         return self
     
-    def create_window(self, title: str = "窗口", **kwargs) -> Window:
+    def create_window(
+        self,
+        title: str = "窗口",
+        x: int = 0,
+        y: int = 0,
+        **kwargs
+    ) -> Window:
         """创建并添加窗口"""
-        win = Window(title=title, **kwargs)
+        if 'stage_width' not in kwargs:
+            kwargs['stage_width'] = self.stage_width
+        if 'stage_height' not in kwargs:
+            kwargs['stage_height'] = self.stage_height
+        
+        win = Window(title=title, x=x, y=y, **kwargs)
         self.windows.append(win)
         return win