jadeui 0.1.0__tar.gz

jadeui-0.1.0/.gitignore

@@ -0,0 +1,68 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+
+# Virtual environments
+venv/
+ENV/
+env/
+.venv/
+
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+*~
+.cursor/
+
+# Testing
+.tox/
+.nox/
+.coverage
+.coverage.*
+htmlcov/
+.pytest_cache/
+.mypy_cache/
+
+# Build
+*.manifest
+*.spec
+
+# DLL (development only, included in wheel)
+jadeui/dll/
+
+# Logs
+*.log
+JadeViewDemo_error.log
+JadeUI_error.log
+
+# Node.js
+node_modules/
+package-lock.json
+
+# OS
+.DS_Store
+Thumbs.db
+
+# uv
+.uv/
+

jadeui-0.1.0/PKG-INFO

@@ -0,0 +1,247 @@
+Metadata-Version: 2.4
+Name: jadeui
+Version: 0.1.0
+Summary: Python SDK for JadeView - Create desktop applications with WebView
+Project-URL: Homepage, https://jade.run
+Project-URL: Documentation, https://jade.run/python-sdk
+Project-URL: Repository, https://github.com/ArcletProject/jadeui
+Project-URL: Issues, https://github.com/ArcletProject/jadeui/issues
+Author: JadeView Team
+License: MIT
+Keywords: desktop,gui,jadeui,jadeview,ui,webview
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Desktop Environment
+Classifier: Topic :: Software Development :: User Interfaces
+Requires-Python: >=3.10
+Requires-Dist: imageio>=2.37.2
+Requires-Dist: nuitka>=2.8.9
+Provides-Extra: dev
+Requires-Dist: build>=1.0; extra == 'dev'
+Requires-Dist: mypy>=1.0; extra == 'dev'
+Requires-Dist: pytest>=7.0; extra == 'dev'
+Requires-Dist: ruff>=0.1.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# JadeUI
+
+<p align="center">
+  <strong>Python SDK for JadeView - Create desktop applications with WebView</strong>
+</p>
+
+<p align="center">
+  <a href="https://pypi.org/project/jadeui/"><img src="https://img.shields.io/pypi/v/jadeui.svg" alt="PyPI version"></a>
+  <a href="https://pypi.org/project/jadeui/"><img src="https://img.shields.io/pypi/pyversions/jadeui.svg" alt="Python versions"></a>
+</p>
+
+---
+
+JadeUI 是 [JadeView](https://jade.run) 的 Python SDK，让你可以使用 Python + Web 技术构建现代桌面应用程序。
+
+## 特性
+
+- **WebView 窗口** - 使用 HTML/CSS/JS 构建 UI
+- **现代外观** - 支持 Windows 11 Mica/Acrylic 效果
+- **主题切换** - Light/Dark/System 主题
+- **IPC 通信** - Python 与前端双向通信
+
+## 安装
+
+```bash
+pip install jadeui
+```
+
+## 快速开始
+
+```python
+from jadeui import JadeUIApp, Window
+
+app = JadeUIApp()
+app.initialize()  # 可选参数见下方
+
+@app.on_ready
+def on_ready():
+    window = Window(
+        title="Hello JadeUI",
+        width=800,
+        height=600,
+        url="https://example.com"
+    )
+    window.show()
+
+app.run()
+```
+
+### 初始化选项
+
+```python
+app.initialize(
+    enable_dev_tools=True,      # 启用开发者工具 (F12)
+    log_file="./app.log",       # 日志文件路径
+    data_directory="./data",    # WebView 数据目录，否则在当前目录解压资源
+)
+```
+
+## 完整示例
+
+### 加载本地 HTML
+
+```python
+from jadeui import JadeUIApp, Window, LocalServer
+
+app = JadeUIApp()
+server = LocalServer()
+
+@app.on_ready
+def on_ready():
+    url = server.start("./web", "myapp")
+    
+    window = Window(
+        title="My App",
+        width=1024,
+        height=768,
+        url=f"{url}/index.html",
+        remove_titlebar=True,  # 无边框窗口
+        transparent=True,
+    )
+    window.show()
+    window.set_backdrop("mica")  # Windows 11 效果
+
+app.run()
+```
+
+### IPC 通信
+
+```python
+from jadeui import JadeUIApp, Window, IPCManager
+
+app = JadeUIApp()
+ipc = IPCManager()
+
+# 注册消息处理器
+@ipc.on("message")
+def handle_message(window_id, message):
+    print(f"收到: {message}")
+    ipc.send(window_id, "reply", f"Echo: {message}")
+    return 1
+
+@app.on_ready
+def on_ready():
+    Window(title="IPC Demo", url="...").show()
+
+app.run()
+```
+
+**前端 JavaScript:**
+
+```javascript
+// 发送消息到 Python (使用 jade.ipcSend)
+jade.ipcSend("message", "Hello from JS!");
+
+// 接收 Python 消息 (使用 jade.ipcMain)
+jade.ipcMain("reply", function(data) {
+    console.log("Python replied:", data);
+});
+```
+
+## 窗口选项
+
+```python
+window = Window(
+    title="My App",
+    width=1024,
+    height=768,
+    url="https://example.com",
+    
+    # 外观
+    remove_titlebar=True,      # 移除标题栏
+    transparent=True,          # 透明背景
+    theme="Dark",              # Light/Dark/System
+    
+    # 大小限制
+    min_width=800,
+    min_height=600,
+    max_width=1920,
+    max_height=1080,
+    resizable=True,
+    
+    # 位置
+    x=100,                     # -1 为居中
+    y=100,
+    
+    # 状态
+    maximized=False,
+    fullscreen=False,
+    always_on_top=False,
+    
+    # WebView
+    autoplay=False,
+    disable_right_click=False,
+    user_agent="Custom UA",
+)
+```
+
+## 窗口方法
+
+```python
+# 显示/隐藏
+window.show()
+window.hide()
+window.close()
+
+# 状态
+window.minimize()
+window.maximize()
+window.restore()
+window.focus()
+window.set_fullscreen(True)
+
+# 属性
+window.set_title("New Title")
+window.set_size(1280, 720)
+window.set_position(100, 100)
+window.center()
+window.set_always_on_top(True)
+
+# 主题
+window.set_theme("Dark")
+window.set_backdrop("mica")  # none/mica/mica_alt/acrylic/tabbed
+
+# WebView
+window.load_url("https://example.com")
+window.execute_js("console.log('Hello!')")
+
+# 状态查询
+window.is_visible
+window.is_maximized
+window.is_minimized
+window.is_focused
+```
+
+## API 文档
+
+完整文档请访问: https://jade.run/python-sdk
+
+## 系统要求
+
+- **操作系统**: Windows 10/11
+- **Python**: 3.10+
+- **依赖**: 无（纯 Python + DLL）
+
+## 许可证
+
+MIT License
+
+## 链接
+
+- [Python SDK 文档](https://jade.run/python-sdk)
+- [JadeView 官网](https://jade.run)
+- [GitHub](https://github.com/ArcletProject/jadeui)
+- [PyPI](https://pypi.org/project/jadeui/)
+

jadeui-0.1.0/README.md

@@ -0,0 +1,216 @@
+# JadeUI
+
+<p align="center">
+  <strong>Python SDK for JadeView - Create desktop applications with WebView</strong>
+</p>
+
+<p align="center">
+  <a href="https://pypi.org/project/jadeui/"><img src="https://img.shields.io/pypi/v/jadeui.svg" alt="PyPI version"></a>
+  <a href="https://pypi.org/project/jadeui/"><img src="https://img.shields.io/pypi/pyversions/jadeui.svg" alt="Python versions"></a>
+</p>
+
+---
+
+JadeUI 是 [JadeView](https://jade.run) 的 Python SDK，让你可以使用 Python + Web 技术构建现代桌面应用程序。
+
+## 特性
+
+- **WebView 窗口** - 使用 HTML/CSS/JS 构建 UI
+- **现代外观** - 支持 Windows 11 Mica/Acrylic 效果
+- **主题切换** - Light/Dark/System 主题
+- **IPC 通信** - Python 与前端双向通信
+
+## 安装
+
+```bash
+pip install jadeui
+```
+
+## 快速开始
+
+```python
+from jadeui import JadeUIApp, Window
+
+app = JadeUIApp()
+app.initialize()  # 可选参数见下方
+
+@app.on_ready
+def on_ready():
+    window = Window(
+        title="Hello JadeUI",
+        width=800,
+        height=600,
+        url="https://example.com"
+    )
+    window.show()
+
+app.run()
+```
+
+### 初始化选项
+
+```python
+app.initialize(
+    enable_dev_tools=True,      # 启用开发者工具 (F12)
+    log_file="./app.log",       # 日志文件路径
+    data_directory="./data",    # WebView 数据目录，否则在当前目录解压资源
+)
+```
+
+## 完整示例
+
+### 加载本地 HTML
+
+```python
+from jadeui import JadeUIApp, Window, LocalServer
+
+app = JadeUIApp()
+server = LocalServer()
+
+@app.on_ready
+def on_ready():
+    url = server.start("./web", "myapp")
+    
+    window = Window(
+        title="My App",
+        width=1024,
+        height=768,
+        url=f"{url}/index.html",
+        remove_titlebar=True,  # 无边框窗口
+        transparent=True,
+    )
+    window.show()
+    window.set_backdrop("mica")  # Windows 11 效果
+
+app.run()
+```
+
+### IPC 通信
+
+```python
+from jadeui import JadeUIApp, Window, IPCManager
+
+app = JadeUIApp()
+ipc = IPCManager()
+
+# 注册消息处理器
+@ipc.on("message")
+def handle_message(window_id, message):
+    print(f"收到: {message}")
+    ipc.send(window_id, "reply", f"Echo: {message}")
+    return 1
+
+@app.on_ready
+def on_ready():
+    Window(title="IPC Demo", url="...").show()
+
+app.run()
+```
+
+**前端 JavaScript:**
+
+```javascript
+// 发送消息到 Python (使用 jade.ipcSend)
+jade.ipcSend("message", "Hello from JS!");
+
+// 接收 Python 消息 (使用 jade.ipcMain)
+jade.ipcMain("reply", function(data) {
+    console.log("Python replied:", data);
+});
+```
+
+## 窗口选项
+
+```python
+window = Window(
+    title="My App",
+    width=1024,
+    height=768,
+    url="https://example.com",
+    
+    # 外观
+    remove_titlebar=True,      # 移除标题栏
+    transparent=True,          # 透明背景
+    theme="Dark",              # Light/Dark/System
+    
+    # 大小限制
+    min_width=800,
+    min_height=600,
+    max_width=1920,
+    max_height=1080,
+    resizable=True,
+    
+    # 位置
+    x=100,                     # -1 为居中
+    y=100,
+    
+    # 状态
+    maximized=False,
+    fullscreen=False,
+    always_on_top=False,
+    
+    # WebView
+    autoplay=False,
+    disable_right_click=False,
+    user_agent="Custom UA",
+)
+```
+
+## 窗口方法
+
+```python
+# 显示/隐藏
+window.show()
+window.hide()
+window.close()
+
+# 状态
+window.minimize()
+window.maximize()
+window.restore()
+window.focus()
+window.set_fullscreen(True)
+
+# 属性
+window.set_title("New Title")
+window.set_size(1280, 720)
+window.set_position(100, 100)
+window.center()
+window.set_always_on_top(True)
+
+# 主题
+window.set_theme("Dark")
+window.set_backdrop("mica")  # none/mica/mica_alt/acrylic/tabbed
+
+# WebView
+window.load_url("https://example.com")
+window.execute_js("console.log('Hello!')")
+
+# 状态查询
+window.is_visible
+window.is_maximized
+window.is_minimized
+window.is_focused
+```
+
+## API 文档
+
+完整文档请访问: https://jade.run/python-sdk
+
+## 系统要求
+
+- **操作系统**: Windows 10/11
+- **Python**: 3.10+
+- **依赖**: 无（纯 Python + DLL）
+
+## 许可证
+
+MIT License
+
+## 链接
+
+- [Python SDK 文档](https://jade.run/python-sdk)
+- [JadeView 官网](https://jade.run)
+- [GitHub](https://github.com/ArcletProject/jadeui)
+- [PyPI](https://pypi.org/project/jadeui/)
+

jadeui-0.1.0/examples/README.md

@@ -0,0 +1,21 @@
+# JadeUI Examples
+
+示例程序，展示 JadeUI 的各种用法。
+
+## 示例列表
+
+| 示例 | 说明 |
+|------|------|
+| [calculator](./calculator/) | 简单计算器，演示基础窗口和 IPC |
+| [router_demo](./router_demo/) | 内置路由系统，多页面应用 |
+| [custom_template](./custom_template/) | 自定义 HTML 模板 |
+| [backdrop_demo](./backdrop_demo/) | Windows 11 背景材料效果 |
+| [vue_app](./vue_app/) | Vue.js 前端框架集成 |
+
+## 运行方式
+
+```bash
+cd examples/<示例名>
+python app.py
+```
+

jadeui-0.1.0/examples/backdrop_demo/README.md

@@ -0,0 +1,36 @@
+# Backdrop Demo
+
+Windows 11 背景材料效果演示。
+
+## 功能
+
+- Mica 效果
+- Mica Alt 效果
+- Acrylic 效果
+- 主题切换
+
+## 运行
+
+```bash
+python app.py
+```
+
+## 打包
+
+```bash
+python ..\..\scripts\build.py app.py --output backdrop_demo
+```
+
+## 背景材料
+
+| 类型 | 说明 |
+|------|------|
+| `mica` | 从桌面壁纸采样颜色，性能最佳 |
+| `micaAlt` | Mica 的替代版本，效果更明显 |
+| `acrylic` | 半透明模糊效果 |
+
+## 注意
+
+- 需要 Windows 11
+- 窗口必须设置 `transparent=True`
+

jadeui-0.1.0/examples/calculator/README.md

@@ -0,0 +1,38 @@
+# Calculator
+
+简单计算器示例，演示基础的窗口创建和 IPC 通信。
+
+## 功能
+
+- 自定义标题栏
+- 键盘输入支持
+- Python 后端计算
+- Mica 透明背景效果
+- 应用图标
+
+## 运行
+
+```bash
+python examples/calculator/app.py
+```
+
+## 打包
+
+在 `examples/calculator` 目录下执行：
+
+```bash
+python ..\..\scripts\build.py app.py --output calculator
+```
+
+脚本会自动包含 `web` 目录和 `web/favicon.png` 图标。
+
+## 文件结构
+
+```
+calculator/
+├── app.py          # Python 后端
+├── README.md       # 说明文档
+└── web/
+    ├── index.html  # 前端界面
+    └── favicon.png # 应用图标
+```

jadeui-0.1.0/examples/custom_template/README.md

@@ -0,0 +1,49 @@
+# Custom Template
+
+自定义 HTML 模板示例，完全控制应用布局。
+
+## 功能
+
+- 自定义导航栏布局
+- 自定义主题切换
+- 使用 Router 处理页面内容
+
+## 运行
+
+```bash
+python app.py
+```
+
+## 打包
+
+```bash
+python ..\..\scripts\build.py app.py --output custom_template
+```
+
+## 文件结构
+
+```
+custom_template/
+├── app.py              # Python 后端
+└── web/
+    ├── index.html      # 自定义模板
+    ├── css/
+    │   └── custom.css  # 自定义样式
+    └── pages/          # 页面内容
+```
+
+## 自定义模板要求
+
+1. 包含 `id="page-content"` 的元素用于渲染页面
+2. 监听 `router:update` IPC 消息
+3. 发送 `router:ready` 通知后端
+
+```javascript
+jade.ipcMain('router:update', async function(data) {
+    const navData = JSON.parse(data);
+    // 加载页面内容到 #page-content
+});
+
+jade.ipcSend('router:ready', '');
+```
+

jadeui-0.1.0/examples/router_demo/README.md

@@ -0,0 +1,45 @@
+# Router Demo
+
+内置路由系统示例，展示多页面应用的实现。
+
+## 功能
+
+- 后端驱动的路由
+- 自动生成侧边栏导航
+- 主题切换（浅色/深色/跟随系统）
+- 动态页面加载
+
+## 运行
+
+```bash
+python app.py
+```
+
+## 打包
+
+```bash
+python ..\..\scripts\build.py app.py --output router_demo
+```
+
+## 文件结构
+
+```
+router_demo/
+├── app.py              # Python 后端，定义路由
+└── web/
+    ├── _app.html       # 自动生成的框架
+    ├── css/
+    │   └── jadeui.css  # 内置样式
+    └── pages/          # 页面模板
+        ├── home.html
+        ├── dashboard.html
+        ├── users.html
+        └── ...
+```
+
+## 添加新页面
+
+```python
+router.page("/new", "pages/new.html", title="新页面", icon="📄")
+```
+