fqml 0.1.0__tar.gz

fqml-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 aki-riko
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

fqml-0.1.0/PKG-INFO

@@ -0,0 +1,299 @@
+Metadata-Version: 2.4
+Name: fqml
+Version: 0.1.0
+Summary: A pure QML-based Fluent Design component library with 120fps+ smooth animations
+Author: aki-riko
+License: MIT License
+        
+        Copyright (c) 2026 aki-riko
+        
+        Permission is hereby granted, free of charge, to any person obtaining a copy
+        of this software and associated documentation files (the "Software"), to deal
+        in the Software without restriction, including without limitation the rights
+        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+        copies of the Software, and to permit persons to whom the Software is
+        furnished to do so, subject to the following conditions:
+        
+        The above copyright notice and this permission notice shall be included in all
+        copies or substantial portions of the Software.
+        
+        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+        SOFTWARE.
+        
+Project-URL: Homepage, https://github.com/aki-riko/FluentQML
+Project-URL: Documentation, https://github.com/aki-riko/FluentQML#readme
+Project-URL: Repository, https://github.com/aki-riko/FluentQML
+Project-URL: Issues, https://github.com/aki-riko/FluentQML/issues
+Keywords: qml,fluent,ui,pyside6,qt,design
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: User Interfaces
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: PySide6>=6.5.0
+Requires-Dist: qrcode>=7.0
+Provides-Extra: macos
+Requires-Dist: pyobjc-framework-Cocoa>=9.0; extra == "macos"
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0; extra == "dev"
+Requires-Dist: black>=23.0; extra == "dev"
+Requires-Dist: isort>=5.0; extra == "dev"
+Requires-Dist: maturin>=1.0; extra == "dev"
+Provides-Extra: rust
+Requires-Dist: fluentqml-rs>=0.1.0; extra == "rust"
+Dynamic: license-file
+
+# FluentQML
+
+**简体中文** | [English](./README.en.md)
+
+基于 PySide6 + QML 的 Fluent Design 组件库，提供 120fps+ 流畅动画体验。
+
+## ✨ 特性
+
+- **纯 QML 渲染**：无帧率限制，120fps+ 流畅动画
+- **Fluent Design**：微软 Fluent Design System 组件
+- **Python 集成**：PySide6 无缝集成，Python 侧管理业务逻辑
+- **配置系统**：JSON 持久化 + 原子写入 + QML Property 桥接
+- **响应式状态**：细粒度 Store 状态管理，支持 watch / batch 模式
+- **窗口管理**：多种窗口布局 + 懒加载 + 云母效果 + 系统托盘
+- **跨平台**：Windows、macOS、Linux
+
+## 📦 安装
+
+```bash
+pip install fluentqml
+```
+
+开发模式安装：
+
+```bash
+git clone https://github.com/aki-riko/FluentQML.git
+cd FluentQML
+pip install -e ".[dev]"
+```
+
+## 🚀 快速开始
+
+```python
+from fluentqml import App, Window, WindowType
+
+app = App()
+window = app.create_window(WindowType.BAR)
+window.setWindowTitle("我的应用")
+window.resize(1200, 800)
+
+# 添加导航页面
+window.addPage(HomePage, "Home", "首页")
+window.addPage(SettingsPage, "Settings", "设置")
+
+window.show()
+app.exec()
+```
+
+## 🏗️ 架构
+
+```
+fluentqml/
+├── FluentQML/              # QML 组件（模块名 FluentQML）
+│   ├── controls/           # UI 控件
+│   ├── _internal/          # 内部窗口实现
+│   └── FluentEnums/        # 枚举与常量
+└── python/                 # Python 模块
+    ├── config/             # 配置管理系统
+    ├── core/               # 核心引擎（主题/日志/图标/阴影）
+    ├── window/             # 窗口管理（懒加载/云母/托盘）
+    ├── state/              # 响应式状态存储
+    ├── providers/          # 功能提供者（SVG/二维码/取色器）
+    └── models/             # 数据模型（高性能表格）
+```
+
+## 📐 窗口类型
+
+| 类型 | 枚举值 | 说明 |
+|------|--------|------|
+| `WindowType.BAR` | 1 | 紧凑侧边导航（默认） |
+| `WindowType.SPLIT` | 0 | 展开式侧边导航 |
+| `WindowType.FILLED` | 2 | 填充式分割窗口 |
+
+```python
+from fluentqml import App, Window, WindowType
+
+app = App()
+
+# 紧凑侧边导航（默认）
+window = app.create_window(WindowType.BAR)
+
+# 展开式侧边导航
+window = app.create_window(WindowType.SPLIT)
+```
+
+## 🎨 主题系统
+
+### 切换主题
+
+```python
+from fluentqml import setTheme, Theme
+
+setTheme(Theme.LIGHT)   # 浅色
+setTheme(Theme.DARK)    # 深色
+setTheme(Theme.AUTO)    # 跟随系统
+```
+
+### 自定义主题色
+
+```python
+from fluentqml import setAccentColor, getAccentColor
+
+setAccentColor("#0078d4")
+print(getAccentColor())  # "#0078d4"
+```
+
+### QML 中使用
+
+```qml
+import FluentQML as Fluent
+
+// Primary 按钮（style_primary 自动使用全局主题色）
+Fluent.Button {
+    text: "确定"
+    style: Fluent.Enums.button.style_primary
+}
+
+// 访问 ThemeManager 属性
+Rectangle {
+    color: ThemeManager.accentColor
+}
+```
+
+> 说明：`ComboBox`、`Slider` 因与 QtQuick.Controls 原生类型同名，未在顶层 `FluentQML` 模块导出，
+> 需按子模块目录导入后使用，例如 `import "../fluentqml/FluentQML/controls/inputs"`。
+
+## ⚙️ 配置系统
+
+配置系统采用五层架构：`Validator` → `SettingEntry` → `SettingsBase` → `AppConfig` → `ConfigManager`
+
+- **JSON 持久化**：默认存储于 `~/.fluentqml/app.json`
+- **原子写入**：先写临时文件再替换，防止断电数据丢失
+- **QML 桥接**：通过 `ConfigManager` 单例暴露为 QML Property
+
+```python
+from fluentqml.python.config import AppConfig, getConfigManager
+
+# 获取配置值
+config = getConfigManager()
+print(config.lazyLoading)   # True
+print(config.dpiScale)      # 0（跟随系统）
+
+# 修改配置（自动保存到 JSON）
+config.setDpiScale(150)
+```
+
+### 自定义配置项
+
+```python
+from typing import ClassVar
+from fluentqml.python.config import (
+    SettingsBase, SettingEntry, EnumEntry,
+    Validator,
+)
+
+
+class MyAppConfig(SettingsBase):
+    auto_save: ClassVar[SettingEntry] = SettingEntry(
+        group="Editor", name="AutoSave",
+        default=True, validator=Validator.boolean(),
+    )
+    font_size: ClassVar[EnumEntry] = EnumEntry(
+        group="Editor", name="FontSize",
+        default=14,
+        validator=Validator.choice([12, 14, 16, 18, 20, 24]),
+    )
+```
+
+## 📊 状态管理
+
+`Store` 提供响应式状态存储，支持细粒度 watch 和批量更新：
+
+```python
+from fluentqml import Store
+
+class AppStore(Store):
+    def __init__(self):
+        super().__init__("app")
+        self.define("user", None)
+        self.define("count", 0)
+
+store = AppStore()
+
+# 监听变化
+store.watch("count", lambda new, old: print(f"{old} → {new}"))
+
+# 设置值
+store.set("count", 1)     # 输出: 0 → 1
+
+# 批量更新（合并通知）
+with store.batch():
+    store.set("count", 10)
+    store.set("user", "Alice")
+# 退出 with 时统一通知
+
+# 字典语法
+store["count"] = 20
+print(store["count"])      # 20
+```
+
+## 🔔 系统托盘
+
+```python
+from fluentqml import SystemTrayIcon, Icon
+
+tray = SystemTrayIcon(icon="AppIcon.png", toolTip="我的应用")
+tray.addAction(text="显示", icon="Visibility", triggered=window.show)
+tray.addSeparator()
+tray.addAction(text="退出", icon="Power", triggered=app.quit)
+tray.show()
+```
+
+## 🧩 UI 组件
+
+### 控件
+Button · Card · CheckBox · ToggleSwitch · LineEdit · ComboBox · Slider · ProgressBar · SpinBox · TableView · ListView · TreeView
+
+### 导航
+NavigationBar · NavigationView · Pivot · Breadcrumb · Windows
+
+### 特效
+Shadow · ShadowedRectangle · ColorOverlay · GaussianBlur
+
+> 完整组件清单见各 `controls/` 子目录的 `qmldir`。`ComboBox`、`Slider` 等与 QtQuick 原生同名的组件需经子模块目录导入。
+
+## 🧪 测试
+
+```bash
+python -m pytest tests/ -v
+```
+
+## 📄 License
+
+FluentQML is licensed under the [MIT License](./LICENSE).
+
+Copyright © 2026 aki-riko.
+
+## 🙏 Credits
+
+- Design inspired by the Microsoft Fluent Design System.
+- Icons from [Microsoft Fluent UI System Icons](https://github.com/microsoft/fluentui-system-icons) (MIT License).

fqml-0.1.0/README.md

@@ -0,0 +1,241 @@
+# FluentQML
+
+**简体中文** | [English](./README.en.md)
+
+基于 PySide6 + QML 的 Fluent Design 组件库，提供 120fps+ 流畅动画体验。
+
+## ✨ 特性
+
+- **纯 QML 渲染**：无帧率限制，120fps+ 流畅动画
+- **Fluent Design**：微软 Fluent Design System 组件
+- **Python 集成**：PySide6 无缝集成，Python 侧管理业务逻辑
+- **配置系统**：JSON 持久化 + 原子写入 + QML Property 桥接
+- **响应式状态**：细粒度 Store 状态管理，支持 watch / batch 模式
+- **窗口管理**：多种窗口布局 + 懒加载 + 云母效果 + 系统托盘
+- **跨平台**：Windows、macOS、Linux
+
+## 📦 安装
+
+```bash
+pip install fluentqml
+```
+
+开发模式安装：
+
+```bash
+git clone https://github.com/aki-riko/FluentQML.git
+cd FluentQML
+pip install -e ".[dev]"
+```
+
+## 🚀 快速开始
+
+```python
+from fluentqml import App, Window, WindowType
+
+app = App()
+window = app.create_window(WindowType.BAR)
+window.setWindowTitle("我的应用")
+window.resize(1200, 800)
+
+# 添加导航页面
+window.addPage(HomePage, "Home", "首页")
+window.addPage(SettingsPage, "Settings", "设置")
+
+window.show()
+app.exec()
+```
+
+## 🏗️ 架构
+
+```
+fluentqml/
+├── FluentQML/              # QML 组件（模块名 FluentQML）
+│   ├── controls/           # UI 控件
+│   ├── _internal/          # 内部窗口实现
+│   └── FluentEnums/        # 枚举与常量
+└── python/                 # Python 模块
+    ├── config/             # 配置管理系统
+    ├── core/               # 核心引擎（主题/日志/图标/阴影）
+    ├── window/             # 窗口管理（懒加载/云母/托盘）
+    ├── state/              # 响应式状态存储
+    ├── providers/          # 功能提供者（SVG/二维码/取色器）
+    └── models/             # 数据模型（高性能表格）
+```
+
+## 📐 窗口类型
+
+| 类型 | 枚举值 | 说明 |
+|------|--------|------|
+| `WindowType.BAR` | 1 | 紧凑侧边导航（默认） |
+| `WindowType.SPLIT` | 0 | 展开式侧边导航 |
+| `WindowType.FILLED` | 2 | 填充式分割窗口 |
+
+```python
+from fluentqml import App, Window, WindowType
+
+app = App()
+
+# 紧凑侧边导航（默认）
+window = app.create_window(WindowType.BAR)
+
+# 展开式侧边导航
+window = app.create_window(WindowType.SPLIT)
+```
+
+## 🎨 主题系统
+
+### 切换主题
+
+```python
+from fluentqml import setTheme, Theme
+
+setTheme(Theme.LIGHT)   # 浅色
+setTheme(Theme.DARK)    # 深色
+setTheme(Theme.AUTO)    # 跟随系统
+```
+
+### 自定义主题色
+
+```python
+from fluentqml import setAccentColor, getAccentColor
+
+setAccentColor("#0078d4")
+print(getAccentColor())  # "#0078d4"
+```
+
+### QML 中使用
+
+```qml
+import FluentQML as Fluent
+
+// Primary 按钮（style_primary 自动使用全局主题色）
+Fluent.Button {
+    text: "确定"
+    style: Fluent.Enums.button.style_primary
+}
+
+// 访问 ThemeManager 属性
+Rectangle {
+    color: ThemeManager.accentColor
+}
+```
+
+> 说明：`ComboBox`、`Slider` 因与 QtQuick.Controls 原生类型同名，未在顶层 `FluentQML` 模块导出，
+> 需按子模块目录导入后使用，例如 `import "../fluentqml/FluentQML/controls/inputs"`。
+
+## ⚙️ 配置系统
+
+配置系统采用五层架构：`Validator` → `SettingEntry` → `SettingsBase` → `AppConfig` → `ConfigManager`
+
+- **JSON 持久化**：默认存储于 `~/.fluentqml/app.json`
+- **原子写入**：先写临时文件再替换，防止断电数据丢失
+- **QML 桥接**：通过 `ConfigManager` 单例暴露为 QML Property
+
+```python
+from fluentqml.python.config import AppConfig, getConfigManager
+
+# 获取配置值
+config = getConfigManager()
+print(config.lazyLoading)   # True
+print(config.dpiScale)      # 0（跟随系统）
+
+# 修改配置（自动保存到 JSON）
+config.setDpiScale(150)
+```
+
+### 自定义配置项
+
+```python
+from typing import ClassVar
+from fluentqml.python.config import (
+    SettingsBase, SettingEntry, EnumEntry,
+    Validator,
+)
+
+
+class MyAppConfig(SettingsBase):
+    auto_save: ClassVar[SettingEntry] = SettingEntry(
+        group="Editor", name="AutoSave",
+        default=True, validator=Validator.boolean(),
+    )
+    font_size: ClassVar[EnumEntry] = EnumEntry(
+        group="Editor", name="FontSize",
+        default=14,
+        validator=Validator.choice([12, 14, 16, 18, 20, 24]),
+    )
+```
+
+## 📊 状态管理
+
+`Store` 提供响应式状态存储，支持细粒度 watch 和批量更新：
+
+```python
+from fluentqml import Store
+
+class AppStore(Store):
+    def __init__(self):
+        super().__init__("app")
+        self.define("user", None)
+        self.define("count", 0)
+
+store = AppStore()
+
+# 监听变化
+store.watch("count", lambda new, old: print(f"{old} → {new}"))
+
+# 设置值
+store.set("count", 1)     # 输出: 0 → 1
+
+# 批量更新（合并通知）
+with store.batch():
+    store.set("count", 10)
+    store.set("user", "Alice")
+# 退出 with 时统一通知
+
+# 字典语法
+store["count"] = 20
+print(store["count"])      # 20
+```
+
+## 🔔 系统托盘
+
+```python
+from fluentqml import SystemTrayIcon, Icon
+
+tray = SystemTrayIcon(icon="AppIcon.png", toolTip="我的应用")
+tray.addAction(text="显示", icon="Visibility", triggered=window.show)
+tray.addSeparator()
+tray.addAction(text="退出", icon="Power", triggered=app.quit)
+tray.show()
+```
+
+## 🧩 UI 组件
+
+### 控件
+Button · Card · CheckBox · ToggleSwitch · LineEdit · ComboBox · Slider · ProgressBar · SpinBox · TableView · ListView · TreeView
+
+### 导航
+NavigationBar · NavigationView · Pivot · Breadcrumb · Windows
+
+### 特效
+Shadow · ShadowedRectangle · ColorOverlay · GaussianBlur
+
+> 完整组件清单见各 `controls/` 子目录的 `qmldir`。`ComboBox`、`Slider` 等与 QtQuick 原生同名的组件需经子模块目录导入。
+
+## 🧪 测试
+
+```bash
+python -m pytest tests/ -v
+```
+
+## 📄 License
+
+FluentQML is licensed under the [MIT License](./LICENSE).
+
+Copyright © 2026 aki-riko.
+
+## 🙏 Credits
+
+- Design inspired by the Microsoft Fluent Design System.
+- Icons from [Microsoft Fluent UI System Icons](https://github.com/microsoft/fluentui-system-icons) (MIT License).

fqml-0.1.0/fluentqml/FluentQML/DpiManager.qml

@@ -0,0 +1,68 @@
+// Copyright 2026 aki-riko
+// SPDX-License-Identifier: MIT
+// This file is part of FluentQML, licensed under MIT.
+
+pragma Singleton
+import QtQuick
+
+// DpiManager - Handle high DPI screen scaling DPI管理器处理高DPI缩放
+QtObject {
+    id: dpiManager
+    
+    // Base DPI (design-time density, usually 96dpi) 基准DPI
+    readonly property real baseDpi: 96
+    
+    // Current screen DPI (guard against undefined on headless/embedded) 当前屏幕DPI
+    readonly property real screenDpi: (Screen && Screen.logicalPixelDensity) ? Screen.logicalPixelDensity * 25.4 : baseDpi
+    
+    // DPI scale factor DPI缩放因子
+    readonly property real scale: Math.max(1.0, screenDpi / baseDpi)
+    
+    // Device pixel ratio (guard against undefined) 设备像素比
+    readonly property real devicePixelRatio: (Screen && Screen.devicePixelRatio) ? Screen.devicePixelRatio : 1.0
+    
+    // User configured DPI scale (0=system, 100/125/150/175/200=fixed) 用户配置的DPI缩放
+    readonly property int userDpiScale: ConfigManager ? ConfigManager.dpiScale : 0
+    
+    // Effective scale factor 综合缩放因子
+    // 0=跟随系统(devicePixelRatio), >0=用户指定比例
+    readonly property real effectiveScale: {
+        if (userDpiScale > 0) {
+            return userDpiScale / 100.0
+        }
+        return Math.max(1.0, devicePixelRatio)
+    }
+    
+    // Convert dp to pixels (device-independent to physical) dp转像素
+    function dp(value) {
+        return Math.round(value * effectiveScale)
+    }
+    
+    // Convert sp to pixels (for font size) sp转像素用于字体
+    function sp(value) {
+        return Math.round(value * effectiveScale)
+    }
+    
+    // Predefined common sizes 预定义常用尺寸
+    readonly property int spacing2: dp(2)
+    readonly property int spacing4: dp(4)
+    readonly property int spacing8: dp(8)
+    readonly property int spacing12: dp(12)
+    readonly property int spacing16: dp(16)
+    readonly property int spacing24: dp(24)
+    readonly property int spacing32: dp(32)
+    
+    // Predefined font sizes 预定义字体大小
+    readonly property int fontSmall: sp(12)
+    readonly property int fontNormal: sp(14)
+    readonly property int fontLarge: sp(16)
+    readonly property int fontTitle: sp(20)
+    readonly property int fontLargeTitle: sp(28)
+    
+    // Predefined component heights 预定义组件高度
+    readonly property int buttonHeight: dp(32)
+    readonly property int inputHeight: dp(32)
+    readonly property int cardPadding: dp(16)
+    readonly property int borderRadius: dp(4)
+    readonly property int borderRadiusLarge: dp(8)
+}