lumiview 0.1.0__tar.gz

lumiview-0.1.0/.github/ISSUE_TEMPLATE/bug_report.yml

@@ -0,0 +1,135 @@
+name: Bug Report - Bug反馈
+description: Create a report to help us improve. - 反馈问题，帮助我们改进
+title: "[Bug] "
+labels:
+  - 🐛 bug
+
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Before filling in this `issue`, please make sure that there are no similar or duplicate `issues` that have been opened.
+        填写此 `issue` 前，请先确认已经开启的 `issue` 没有类似或重复的 `issue`。
+
+  - type: dropdown
+    id: system
+    attributes:
+      label: OS - 操作系统
+      options:
+        - Windows
+        - macOS
+        - Linux
+    validations:
+      required: true
+
+  - type: input
+    id: os_version
+    attributes:
+      label: OS Version - 操作系统版本
+      description: |
+        e.g. Windows 11 24H2 / macOS 15 Sequoia / Ubuntu 24.04
+        例如：Windows 11 24H2 / macOS 15 Sequoia / Ubuntu 24.04
+      placeholder: Windows 11 24H2
+    validations:
+      required: true
+
+  - type: input
+    id: python_version
+    attributes:
+      label: Python Version - Python 版本
+      description: |
+        LumiView requires Python >= 3.10.
+        LumiView 要求 Python >= 3.10。
+      placeholder: "3.12"
+    validations:
+      required: true
+
+  - type: input
+    id: version
+    attributes:
+      label: LumiView Version - LumiView 版本
+      description: |
+        Run `pip show lumiview` to check. LumiView is still in alpha, so please always test with the latest version first.
+        运行 `pip show lumiview` 查看。LumiView 仍处于 alpha 阶段，请务必先测试最新版本再提交。
+      placeholder: 0.1.0
+    validations:
+      required: true
+
+  - type: dropdown
+    id: area
+    attributes:
+      label: Affected Area - 影响范围
+      description: |
+        Which part of LumiView is involved? You can select multiple.
+        涉及 LumiView 的哪个部分？可多选。
+      multiple: true
+      options:
+        - Window / 窗口管理（几何、状态、特效、全屏）
+        - WebView / 网页加载与渲染
+        - JS Bridge (IPC) / 桥接通信
+        - Event system / 事件系统
+        - Plugins / 插件
+        - serve protocol / 协议处理
+        - Installation & build / 安装与构建
+        - Other / 其他
+    validations:
+      required: false
+
+  - type: textarea
+    id: exist
+    attributes:
+      label: Existing behavior - 现有行为
+      description: |
+        Please describe the problem you have encountered carefully.
+        请仔细描述你所遇到的问题。
+    validations:
+      required: true
+
+  - type: textarea
+    id: expect
+    attributes:
+      label: Expected behavior - 预期行为
+      description: |
+        Please describe in detail the results you wish to achieve.
+        请仔细描述你要得到的结果。
+    validations:
+      required: true
+
+  - type: textarea
+    id: reproduce
+    attributes:
+      label: To Reproduce - 复现问题
+      description: |
+        How do you trigger this bug? Please walk us through it step by step, and provide a minimal reproduction script if possible.
+        这个 bug 是怎么触发的？请详细告诉我们是怎样出现这个情况的，如果可能请提供最小复现脚本。
+      placeholder: |
+        ```python
+        from lumiview import App, Window, WindowOptions
+
+        # minimal reproduction code
+        ```
+    validations:
+      required: false
+
+  - type: textarea
+    id: logs
+    attributes:
+      label: Logs & Screenshots - 日志与截图
+      description: |
+        Please provide the full traceback, console output, or screenshots. If the window crashes, try running with `RUST_BACKTRACE=1`.
+        请提供完整的 traceback、控制台输出或截图。若窗口崩溃，可尝试以 `RUST_BACKTRACE=1` 运行。
+    validations:
+      required: false
+
+  - type: checkboxes
+    id: know
+    attributes:
+      label: This issue is unique - 这个 issue 是唯一的
+      options:
+        - label: I have searched the issue tracker and confirmed that there is no identical issue. 我已经搜索问题追踪器并且确认没有相同的 Issue。
+          required: true
+        - label: I admit that I previously checked all options without thorough verification and directly submitted this Issue, and I agree that it can be closed directly. 我承认此前未充分核实便勾选了所有选项并直接提交此 Issue ，且同意该 Issue 可被直接关闭。
+        - label: I confirm that I am currently using the latest version of LumiView. If not, this issue can be closed directly. 我确认当前使用的是最新版本的 LumiView，若非如此，此 Issue 可被直接关闭。
+          required: true
+        - label: I promise to provide a detailed description of the encountered issue, along with relevant logs and screenshots, rather than offering incomplete or vague information. 我承诺将详细描述遇到的问题，并提供相关日志与截图，而非提供不完整或模糊的信息。
+          required: true

lumiview-0.1.0/.github/ISSUE_TEMPLATE/feature_request.yml

@@ -0,0 +1,65 @@
+name: Feature request - 功能请求
+description: Suggest an idea for this project - 为这个项目推荐一个新想法
+title: "[Feature] "
+labels:
+  - 🪁 enhancement
+
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Before filling in this `issue`, please make sure that there are no similar or duplicate `issues` that have been opened.
+        填写此 `issue` 前，请先确认已经开启的 `issue` 没有类似或重复的 `issue`。
+
+  - type: textarea
+    id: feature
+    attributes:
+      label: What new features do you want? - 你想要什么新功能？
+      description: |
+        What new feature or change you want? How it improves? Please tell us the requirements is with a clear and detailed description, put your screenshots if possible.
+        你想要什么新功能或者什么改变？这会带来什么提升？请清晰而详细地描述你的需求，如果可以的话最好附带截图。
+    validations:
+      required: true
+
+  - type: textarea
+    id: use_case
+    attributes:
+      label: Use Case - 使用场景
+      description: |
+        What is your application scenario and how do you use LumiView? (e.g. a desktop app you are building with LumiView)
+        你的应用场景是什么？你如何使用 LumiView？（例如：你正在用 LumiView 构建的桌面应用）
+      placeholder: |
+        I'm building a desktop app with LumiView, and I need...
+    validations:
+      required: false
+
+  - type: dropdown
+    id: area
+    attributes:
+      label: Related Area - 相关范围
+      description: |
+        Which part of LumiView is involved? You can select multiple.
+        涉及 LumiView 的哪个部分？可多选。
+      multiple: true
+      options:
+        - Window / 窗口管理
+        - WebView
+        - JS Bridge (IPC)
+        - Event system / 事件系统
+        - Plugins / 插件
+        - serve protocol / 协议处理
+        - Packaging / 打包分发
+        - Other / 其他
+    validations:
+      required: false
+
+  - type: checkboxes
+    id: know
+    attributes:
+      label: This issue is unique - 这个 issue 是唯一的
+      options:
+        - label: I have searched the issue tracker and confirmed that there is no identical issue. 我已经搜索问题追踪器并且确认没有相同的 Issue。
+          required: true
+        - label: I admit that I previously checked all options without thorough verification and directly submitted this Issue, and I agree that it can be closed directly. 我承认此前未充分核实便勾选了所有选项并直接提交此 Issue ，且同意该 Issue 可被直接关闭。
+        - label: I promise to provide a detailed description of the new feature I want, along with reasonable justification, rather than offering incomplete or vague information. 我承诺我会详细描述我想要的新功能，并附上合理的理由，而非提供不完整或模糊的信息。
+          required: true

lumiview-0.1.0/.github/workflows/build.yml

@@ -0,0 +1,185 @@
+name: Build
+
+on:
+  push:
+    tags:
+      - 'v*'
+    branches:
+      - main
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+jobs:
+  linux:
+    runs-on: ${{ matrix.platform.runner }}
+    strategy:
+      matrix:
+        platform:
+          - runner: ubuntu-latest
+            target: x86_64
+    steps:
+      - uses: actions/checkout@v4
+      - name: Install webkit2gtk
+        run: |
+          sudo apt-get update
+          # libxdo-dev: muda's GTK backend sends predefined-item shortcuts
+          # (copy/paste/...) through xdo; bundled into the wheel by
+          # auditwheel (no GTK-style global-type-registry concern).
+          sudo apt-get install -y libwebkit2gtk-4.1-dev libgtk-3-dev libglib2.0-dev libxdo-dev
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Build wheel
+        uses: PyO3/maturin-action@v1
+        with:
+          args: --release --out dist
+      - name: Repair manylinux (exclude system GTK/GLib/dbus — must not bundle)
+        run: |
+          pip install auditwheel
+          # GTK/GLib libraries can never be bundled into the wheel: the
+          # GObject type registry is process-global, so a second copy breaks
+          # any process that also links the system GTK (LumiView's own tao
+          # window and wryview both do). libdbus-1/libsystemd likewise exist
+          # on every desktop that can run GTK3 (the gtk .deb depends on
+          # them) — bundling them only adds weight and risks version skew.
+          auditwheel repair \
+            --exclude 'libgtk-3.*' \
+            --exclude 'libgdk-3.*' \
+            --exclude 'libglib-2.0.*' \
+            --exclude 'libgobject-2.0.*' \
+            --exclude 'libgio-2.0.*' \
+            --exclude 'libgmodule-2.0.*' \
+            --exclude 'libgdk_pixbuf-2.0.*' \
+            --exclude 'libpango-1.0.*' \
+            --exclude 'libpangocairo-1.0.*' \
+            --exclude 'libpangoft2-1.0.*' \
+            --exclude 'libatk-1.0.*' \
+            --exclude 'libharfbuzz.*' \
+            --exclude 'libfribidi.*' \
+            --exclude 'libepoxy.*' \
+            --exclude 'libcairo.*' \
+            --exclude 'libcairo-gobject.*' \
+            --exclude 'libxkbcommon.*' \
+            --exclude 'libwayland-client.*' \
+            --exclude 'libdbus-1.*' \
+            --exclude 'libsystemd.*' \
+            --exclude 'libgcrypt.*' \
+            --exclude 'libgpg-error.*' \
+            --exclude 'libcap.*' \
+            --exclude 'libzstd.*' \
+            --exclude 'liblz4.*' \
+            --exclude 'liblzma.*' \
+            -w dist dist/lumiview-*.whl
+          rm -f dist/*-linux_x86_64.whl
+      - name: Upload wheels
+        uses: actions/upload-artifact@v4
+        with:
+          name: wheels-linux
+          path: dist
+
+  windows:
+    runs-on: ${{ matrix.platform.runner }}
+    strategy:
+      matrix:
+        platform:
+          - runner: windows-latest
+            target: x64
+          - runner: windows-latest
+            target: x86
+            python-arch: x86
+    steps:
+      - uses: actions/checkout@v7
+      - uses: actions/setup-python@v7
+        with:
+          python-version: "3.12"
+          architecture: ${{ matrix.platform.python-arch || 'x64' }}
+      - name: Build wheels
+        uses: PyO3/maturin-action@v1
+        with:
+          target: ${{ matrix.platform.target }}
+          args: --release --out dist --find-interpreter
+      - name: Upload wheels
+        uses: actions/upload-artifact@v4
+        with:
+          name: wheels-windows-${{ matrix.platform.target }}
+          path: dist
+
+  macos:
+    runs-on: ${{ matrix.platform.runner }}
+    strategy:
+      matrix:
+        platform:
+          - runner: macos-14
+            target: x86_64
+          - runner: macos-latest
+            target: aarch64
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+      - name: Build wheel
+        uses: PyO3/maturin-action@v1
+        with:
+          target: ${{ matrix.platform.target }}
+          args: --release --out dist
+      - name: Upload wheels
+        uses: actions/upload-artifact@v4
+        with:
+          name: wheels-macos-${{ matrix.platform.target }}
+          path: dist
+
+  sdist:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - name: Build sdist
+        uses: PyO3/maturin-action@v1
+        with:
+          command: sdist
+          args: --out dist
+      - name: Upload sdist
+        uses: actions/upload-artifact@v4
+        with:
+          name: wheels-sdist
+          path: dist
+
+  pypi-publish:
+    runs-on: ubuntu-latest
+    if: startsWith(github.ref, 'refs/tags/v')
+    needs: [linux, windows, macos, sdist]
+    permissions:
+      id-token: write
+      contents: read
+    environment:
+      name: pypi
+      url: https://pypi.org/project/lumiview/
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Validate version match
+        shell: pwsh
+        run: |
+          $pyprojectVersion = (Select-String -Path pyproject.toml -Pattern 'version = "(.+?)"').Matches.Groups[1].Value
+          $gitTag = "${{ github.ref }}".Split('/')[-1]
+          $gitTagVersion = $gitTag.TrimStart('v')
+          if ($pyprojectVersion -ne $gitTagVersion) {
+            Write-Error "Version mismatch: pyproject.toml=$pyprojectVersion vs tag=$gitTag"
+            exit 1
+          }
+          Write-Host "Versions match: $pyprojectVersion"
+
+      - name: Retrieve release distributions
+        uses: actions/download-artifact@v4
+        with:
+          pattern: wheels-*
+          path: dist/
+          merge-multiple: true
+
+      - name: Publish release distributions to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          packages-dir: dist/

lumiview-0.1.0/.gitignore

@@ -0,0 +1,222 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[codz]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+parts/
+sdist/
+var/
+wheels/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# PyInstaller
+#  Usually these files are written by a python script from a template
+#  before PyInstaller builds the exe, so as to inject date/other infos into it.
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py.cover
+.hypothesis/
+.pytest_cache/
+cover/
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+local_settings.py
+db.sqlite3
+db.sqlite3-journal
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+.pybuilder/
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# IPython
+profile_default/
+ipython_config.py
+
+# pyenv
+#   For a library or package, you might want to ignore these files since the code is
+#   intended to run in multiple environments; otherwise, check them in:
+# .python-version
+
+# pipenv
+#   According to pypa/pipenv#598, it is recommended to include Pipfile.lock in version control.
+#   However, in case of collaboration, if having platform-specific dependencies or dependencies
+#   having no cross-platform support, pipenv may install dependencies that don't work, or not
+#   install all needed dependencies.
+#Pipfile.lock
+
+# UV
+#   Similar to Pipfile.lock, it is generally recommended to include uv.lock in version control.
+#   This is especially recommended for binary packages to ensure reproducibility, and is more
+#   commonly ignored for libraries.
+#uv.lock
+
+# poetry
+#   Similar to Pipfile.lock, it is generally recommended to include poetry.lock in version control.
+#   This is especially recommended for binary packages to ensure reproducibility, and is more
+#   commonly ignored for libraries.
+#   https://python-poetry.org/docs/basic-usage/#commit-your-poetrylock-file-to-version-control
+#poetry.lock
+#poetry.toml
+
+# pdm
+#   Similar to Pipfile.lock, it is generally recommended to include pdm.lock in version control.
+#   pdm recommends including project-wide configuration in pdm.toml, but excluding .pdm-python.
+#   https://pdm-project.org/en/latest/usage/project/#working-with-version-control
+#pdm.lock
+#pdm.toml
+.pdm-python
+.pdm-build/
+
+# pixi
+#   Similar to Pipfile.lock, it is generally recommended to include pixi.lock in version control.
+#pixi.lock
+#   Pixi creates a virtual environment in the .pixi directory, just like venv module creates one
+#   in the .venv directory. It is recommended not to include this directory in version control.
+.pixi
+
+# PEP 582; used by e.g. github.com/David-OConnor/pyflow and github.com/pdm-project/pdm
+__pypackages__/
+
+# Celery stuff
+celerybeat-schedule
+celerybeat.pid
+
+# SageMath parsed files
+*.sage.py
+
+# Environments
+.env
+.envrc
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Pyre type checker
+.pyre/
+
+# pytype static type analyzer
+.pytype/
+
+# Cython debug symbols
+cython_debug/
+
+# PyCharm
+#  JetBrains specific template is maintained in a separate JetBrains.gitignore that can
+#  be found at https://github.com/github/gitignore/blob/main/Global/JetBrains.gitignore
+#  and can be added to the global gitignore or merged into this file.  For a more nuclear
+#  option (not recommended) you can uncomment the following to ignore the entire idea folder.
+.idea/
+
+# Abstra
+# Abstra is an AI-powered process automation framework.
+# Ignore directories containing user credentials, local state, and settings.
+# Learn more at https://abstra.io/docs
+.abstra/
+
+# Visual Studio Code
+#  Visual Studio Code specific template is maintained in a separate VisualStudioCode.gitignore 
+#  that can be found at https://github.com/github/gitignore/blob/main/Global/VisualStudioCode.gitignore
+#  and can be added to the global gitignore or merged into this file. However, if you prefer, 
+#  you could uncomment the following to ignore the entire vscode folder
+.vscode/
+
+# Ruff stuff:
+.ruff_cache/
+
+# PyPI configuration file
+.pypirc
+
+# Cursor
+#  Cursor is an AI-powered code editor. `.cursorignore` specifies files/directories to
+#  exclude from AI features like autocomplete and code analysis. Recommended for sensitive data
+#  refer to https://docs.cursor.com/context/ignore-files
+.cursorignore
+.cursorindexingignore
+
+# Marimo
+marimo/_static/
+marimo/_lsp/
+__marimo__/
+
+
+# stubs
+
+stubs/
+
+python/**/*.pyd
+python/**/*.pdb
+
+.claude
+CLAUDE.md
+
+.DS_Store
+
+plan.md
+TODO.md
+docs/superpowers

lumiview-0.1.0/CONTRIBUTING.md

@@ -0,0 +1,72 @@
+# Contributing to LumiView
+
+Thank you for your interest in contributing! LumiView is in early development, and we welcome feedback, bug reports, and thoughtful PRs.
+
+**Before starting any significant work**, please open a [Discussion](https://github.com/xiaosuawa/LumiView/discussions) or [Issue](https://github.com/xiaosuawa/LumiView/issues) to align on the approach. Unsolicited PRs that touch the public API may not be merged if they conflict with the planned direction.
+
+## Ways to Contribute
+
+### 🐛 Bug Reports
+
+- Check existing [Issues](https://github.com/xiaosuawa/LumiView/issues) first
+- Include: OS + version, Python version, `lumiview` version, minimal repro code
+- **Include logs**: run the repro with DEBUG logging enabled and paste
+  the relevant output:
+
+  ```python
+  import logging
+
+  logging.getLogger("lumiview").setLevel(logging.DEBUG)
+  ```
+
+  The `lumiview.*` log tree covers window / tray lifecycle and event
+  dispatch — it usually pinpoints the issue faster than the repro alone.
+
+### 💡 Feature Ideas
+
+- Use [Discussions](https://github.com/xiaosuawa/LumiView/discussions) for brainstorming
+- Tell us about your use case — it helps us prioritize
+
+### 📖 Examples & Documentation
+
+- Improvements to the [`examples/`](examples/) directory are always welcome
+- Docstring improvements and typo fixes don't need prior discussion
+
+### 🔧 Code Contributions
+
+1. **Discuss first** — open an issue or discussion for anything beyond small fixes
+2. **Follow existing patterns** — match the code style, type annotations, and docstring conventions
+3. **Keep PRs focused** — one thing per PR
+
+## Development Setup
+
+```bash
+# Clone and install dev dependencies
+git clone https://github.com/xiaosuawa/LumiView.git
+cd lumiview
+pip install maturin
+
+# Build and install in debug mode
+maturin develop
+
+# Run an example
+python examples/hello_world.py
+```
+
+## Project Structure
+
+```
+src/              Rust bindings (PyO3 + tao + wryview)
+python/lumiview/ Python layer (App, Window, Bridge, Task, serve)
+examples/         Runnable example scripts
+```
+
+## Code Style
+
+- Python: follow existing type annotation patterns (all public APIs are typed)
+- Rust: standard `cargo fmt` + `cargo clippy`
+- Docstrings: Google-style for Python, `///` for Rust
+
+## License
+
+By contributing, you agree that your contributions will be licensed under the [MPL-2.0](LICENSE).