echoui 0.9.1__tar.gz

echoui-0.9.1/.github/workflows/ci.yml

@@ -0,0 +1,38 @@
+name: CI
+
+on:
+  push:
+    branches: [main, master]
+  pull_request:
+    branches: [main, master]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.11", "3.12"]
+    steps:
+      - uses: actions/checkout@v4
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+      - name: Install dependencies
+        run: pip install -e ".[web,dev]" tree-sitter tree-sitter-language-pack echotools
+      - name: Prefetch tree-sitter parsers
+        run: python -c "from tree_sitter_language_pack import download; download(['python','javascript','typescript','tsx','json','yaml','toml','html','css','bash','markdown','vue'])"
+      - name: check_banned_terms
+        run: python scripts/check_banned_terms.py
+      - name: ruff
+        run: ruff check .
+      - name: mypy
+        run: mypy echoui
+      - name: pytest
+        run: pytest -q
+      - name: achecker
+        run: python achecker.py
+      - name: build
+        run: python -m build
+      - name: twine check
+        run: twine check dist/*

echoui-0.9.1/.github/workflows/ios-build.yml

@@ -0,0 +1,42 @@
+name: iOS Build
+
+on:
+  workflow_dispatch:
+  push:
+    tags:
+      - "v*"
+
+jobs:
+  build-ios:
+    runs-on: macos-latest
+    steps:
+      - uses: actions/checkout@v4
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+      - name: Install EchoUI
+        run: pip install -e ".[web,dev]"
+      - name: Build web bundle for mobile shell
+        run: |
+          python - <<'PY'
+          import importlib.util
+          from pathlib import Path
+          spec = importlib.util.spec_from_file_location("demo", "examples/01_hello_web/main.py")
+          mod = importlib.util.module_from_spec(spec)
+          spec.loader.exec_module(mod)
+          out = Path("dist/ios-web")
+          mod.app.compile(target="web", out_dir=str(out))
+          assert (out / "index.html").exists()
+          print("web bundle ready for iOS WebView shell")
+          PY
+      - name: Package placeholder IPA metadata
+        run: |
+          mkdir -p dist/ios
+          echo "EchoUI iOS shell uses web bundle + WKWebView template" > dist/ios/README.txt
+          tar -czf dist/echoui-ios-web-bundle.tar.gz dist/ios-web dist/ios
+      - name: Upload artifact
+        uses: actions/upload-artifact@v4
+        with:
+          name: echoui-ios-bundle
+          path: dist/echoui-ios-web-bundle.tar.gz

echoui-0.9.1/.gitignore

@@ -0,0 +1,64 @@
+# Directories
+.qoder
+.claude
+.codebuddy
+.env
+.git
+.idea
+.pytest_cache
+.scripts
+.svn
+.vscode
+.zed
+.opencode
+__pycache__
+data
+env
+node_modules
+persist
+venv
+agent_log
+config/
+.agents/
+/plugins/
+
+# Extensions
+*.dll
+*.dylib
+*.json
+!_manifest.json
+!**/_manifest.json
+*.pyc
+*.pyd
+*.pyo
+*.so
+*.srt
+config.toml
+*.wasm
+*.zip
+
+# File names
+.DS_Store
+Thumbs.db
+desktop.ini
+abnormis.txt
+CLAUDE.local.md
+CLAUDE.md
+nul
+
+# plugins
+/plugins/
+
+# Build artifacts
+dist/
+*.egg-info/
+_scan_out.txt
+
+!template/
+
+# Config manager backups
+template/old/
+.backup/
+
+logs/
+.htaccess

echoui-0.9.1/AGENTS.md

@@ -0,0 +1,24 @@
+## Task Completion Requirements
+
+- Environment/configuration health check and static type checking must pass before considering tasks completed.
+- Run code style/lint checks (`ruff check .`) — must pass.
+- Run `python achecker.py` — must pass with 0 violations.
+- Run `pytest -q`, `mypy echoui`, `python -m build`, `twine check dist/*` for release-ready changes.
+
+## Project Snapshot
+
+EchoUI is a Python-first UI framework using the **Screen → Stage → Sprite** paradigm. It compiles to web, static, TUI, desktop, and GUI targets.
+
+Package: `echoui` · Version line: **0.9.0** · License: MIT
+
+## Core Priorities
+
+1. Reactive correctness (Signal / Computed / Store).
+2. Compiler + runtime parity across documented targets.
+3. Honest capability matrix — mark `done-degraded` or `interface-only` instead of silent stubs.
+
+## Documentation
+
+- User docs: `docs/api/`
+- Spec mirror: `docs-src/`
+- Phase matrix: `.claude/docs/08_全量追踪矩阵.md` (sync with `PROGRESS.md`)

echoui-0.9.1/CHANGELOG.md

@@ -0,0 +1,27 @@
+# Changelog
+
+## 0.9.1
+
+- Fix TUI build JSON serialization for reactive lambdas
+- Add `python -m echoui` entry via `__main__.py`
+- Bootstrap modules, examples `01_hello_web` / `03_game_free_mode`, visual/a11y tests
+- docs-src API catalog entries; iOS CI workflow; reactive benchmark script
+
+## 0.9.0
+
+- Release-ready packaging: version aligned across pyproject, package, docs, and CHANGELOG
+- Quality gate: ruff, mypy, pytest; wheel build + twine check
+- Marks v0.1–v0.9 feature set as the first public-ready cut (see PROGRESS.md)
+
+## 0.1.0
+
+- Reactive core: Signal, Computed, Effect, batch, Store
+- Screen–Stage–Sprite paradigm with flow and free layout
+- Web compiler pipeline: parser → analyzer → optimizer → lower → emit → bundler
+- CLI: new, dev, build, check, version
+- Testing harness: mount, fire, tick, snapshot
+- Router with guards and middleware
+- Forms, storage, query, animation, gestures, overlay
+- Escape layer (raw.js/html/css) and bridge.web_api
+- Static, TUI, desktop, GUI, Android template targets
+- Collab CRDT, data tables, i18n, a11y, print, platform, plugins

echoui-0.9.1/DELIVERY_PLAN.md

@@ -0,0 +1,34 @@
+# EchoUI Delivery Plan
+
+## DoD (v0.9 全量)
+- [x] Version 0.9.0 aligned in pyproject / package / CHANGELOG / docs-src
+- [x] Local CI equivalent green: ruff, mypy, pytest
+- [x] `python -m build` + `twine check dist/*` pass
+- [x] `py achecker.py` → 0 violations
+- [x] User docs under `docs/api/` (getting-started, targets, non-goals, roles)
+- [x] `08_全量追踪矩阵.md` synced with PROGRESS (no blank `not-started` on shipped scope)
+- [x] Initial git commit on `main` (no push unless requested)
+
+## Non-goals
+- Do not require `twine upload` without credentials
+- Do not change completed API semantics without documenting degradation
+
+## Work items
+1. [x] Bump to 0.9.0; fix docs still marked 待实现
+2. [x] Quality gate: ruff → mypy → pytest
+3. [x] Build wheel + twine check
+4. [x] achecker EchoUI layout exemptions + docs/api fill
+5. [x] AGENTS.md / README / PROGRESS / matrix sync
+6. [x] CI workflow includes achecker + build smoke
+
+## Verify
+```powershell
+cd X:\Project\Public\EchoUI
+pip install -e ".[web,dev]"
+ruff check .
+mypy echoui
+pytest -q
+py achecker.py
+python -m build
+twine check dist/*
+```

echoui-0.9.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 nichengfuben
+
+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.

echoui-0.9.1/PKG-INFO

@@ -0,0 +1,137 @@
+Metadata-Version: 2.4
+Name: echoui
+Version: 0.9.1
+Summary: Universal Python-first UI framework — one Screen-Stage-Sprite paradigm compiles to Web, desktop, mobile, TUI, and GUI.
+Project-URL: Homepage, https://github.com/nichengfuben/echoui
+Project-URL: Documentation, https://echoui.dev
+Author-email: nichengfuben <nichengfuben@outlook.com>
+License: MIT
+License-File: LICENSE
+Keywords: compiler,desktop,framework,fullstack,gui,mobile,tui,ui,web
+Requires-Python: >=3.11
+Requires-Dist: csscompressor>=0.9.5
+Requires-Dist: rjsmin>=1.2.2
+Requires-Dist: watchfiles>=0.21.0
+Provides-Extra: all
+Requires-Dist: aiohttp>=3.9.5; extra == 'all'
+Requires-Dist: box2d-py>=2.3.10; extra == 'all'
+Requires-Dist: build>=1.2.1; extra == 'all'
+Requires-Dist: fastapi>=0.110.0; extra == 'all'
+Requires-Dist: hatchling; extra == 'all'
+Requires-Dist: msgpack>=1.0.8; extra == 'all'
+Requires-Dist: mypy>=1.9.0; extra == 'all'
+Requires-Dist: playwright>=1.43.0; extra == 'all'
+Requires-Dist: pyarrow>=15.0.2; extra == 'all'
+Requires-Dist: pyinstaller>=6.6.0; extra == 'all'
+Requires-Dist: pyside6>=6.7.0; extra == 'all'
+Requires-Dist: pytest-asyncio>=0.23.6; extra == 'all'
+Requires-Dist: pytest-qt>=4.4.0; extra == 'all'
+Requires-Dist: pytest>=8.1.1; extra == 'all'
+Requires-Dist: rich>=13.7.1; extra == 'all'
+Requires-Dist: ruff>=0.4.1; extra == 'all'
+Requires-Dist: textual>=0.58.0; extra == 'all'
+Requires-Dist: twine>=5.1.1; extra == 'all'
+Requires-Dist: uvicorn[standard]>=0.29.0; extra == 'all'
+Provides-Extra: data
+Requires-Dist: pyarrow>=15.0.2; extra == 'data'
+Provides-Extra: desktop
+Requires-Dist: pyinstaller>=6.6.0; extra == 'desktop'
+Requires-Dist: pyside6>=6.7.0; extra == 'desktop'
+Provides-Extra: dev
+Requires-Dist: build>=1.2.1; extra == 'dev'
+Requires-Dist: hatchling; extra == 'dev'
+Requires-Dist: mypy>=1.9.0; extra == 'dev'
+Requires-Dist: pytest-asyncio>=0.23.6; extra == 'dev'
+Requires-Dist: pytest>=8.1.1; extra == 'dev'
+Requires-Dist: ruff>=0.4.1; extra == 'dev'
+Requires-Dist: twine>=5.1.1; extra == 'dev'
+Provides-Extra: dev-extended
+Requires-Dist: playwright>=1.43.0; extra == 'dev-extended'
+Requires-Dist: pytest-qt>=4.4.0; extra == 'dev-extended'
+Provides-Extra: fastapi
+Requires-Dist: fastapi>=0.110.0; extra == 'fastapi'
+Requires-Dist: uvicorn[standard]>=0.29.0; extra == 'fastapi'
+Provides-Extra: gui
+Requires-Dist: pyside6>=6.7.0; extra == 'gui'
+Provides-Extra: mobile
+Provides-Extra: physics
+Requires-Dist: box2d-py>=2.3.10; extra == 'physics'
+Provides-Extra: tui
+Requires-Dist: rich>=13.7.1; extra == 'tui'
+Requires-Dist: textual>=0.58.0; extra == 'tui'
+Provides-Extra: web
+Requires-Dist: aiohttp>=3.9.5; extra == 'web'
+Requires-Dist: msgpack>=1.0.8; extra == 'web'
+Description-Content-Type: text/markdown
+
+# EchoUI — Universal Python-first UI framework
+
+One **Screen–Stage–Sprite** paradigm compiles to Web, desktop, mobile, TUI, and GUI.
+
+**Version:** 0.9.0 · **License:** MIT · **Docs:** [docs/api/INDEX.md](docs/api/INDEX.md)
+
+## Quick Start
+
+```bash
+pip install -e ".[web,dev]"
+```
+
+Create `main.py`:
+
+```python
+from echoui import App, Screen, Store, col, text, button
+
+class CounterStore(Store):
+    count: int = 0
+
+store = CounterStore()
+
+class Counter(Screen):
+    def build(self):
+        return col(
+            text(lambda: f"Count: {store.count}"),
+            button("+1", on_click=lambda: setattr(store, "count", store.count + 1)),
+        )
+
+app = App(screens=[Counter], initial="Counter")
+```
+
+Build and run:
+
+```bash
+echoui build --target web
+echoui dev --target web --port 7999
+```
+
+Open http://127.0.0.1:7999 — click **+1** and the count increments.
+
+## CLI
+
+| Command | Description |
+|---------|-------------|
+| `echoui new [name]` | Scaffold a counter project |
+| `echoui dev --target web` | Dev server with hot reload |
+| `echoui build --target web\|static\|tui\|desktop\|gui` | Compile for target |
+| `echoui check` | Validate project |
+| `echoui version` | Print version |
+
+## Quality Gate
+
+```bash
+ruff check .
+mypy echoui
+pytest -q
+python achecker.py
+python -m build
+twine check dist/*
+```
+
+## Testing
+
+```bash
+pytest -q
+```
+
+## License
+
+MIT — see [LICENSE](LICENSE).

echoui-0.9.1/PROGRESS.md

@@ -0,0 +1,47 @@
+# EchoUI Progress
+
+## 当前阶段
+
+v0.9 生态与发布 — 收尾中（对照 `.claude/docs/09_验收与闭环协议.md`）
+
+## 已闭环（可验证）
+
+- [x] 核心引擎 v0.1–v0.4：reactive / compiler / web+SSR / 逃生层
+- [x] 多端 target v0.5–v0.8：web / static / tui / desktop / gui / android（代码+测试）
+- [x] v0.9 生态：collab / data / i18n / a11y / plugin / devtools
+- [x] `ruff` / `mypy` / `pytest`（36 passed）/ `achecker` 0 违规
+- [x] examples：`01_hello_web` `02_counter` `03_game_free_mode` `04_multi_screen_game` `05_escape_layer`
+- [x] tests：`unit` / `integration` / `visual` / `a11y`
+- [x] docs-src API 图鉴（v0.1 P0 条目 + 四件套）
+- [x] `scripts/benchmark_reactive.py`（§3 细粒度更新）
+- [x] `.github/workflows/ios-build.yml`（macOS CI 绕行，产出 web bundle artifact）
+- [x] `python -m build` + `twine check` 本地通过
+
+## 本阶段 TODO（09 协议机器检查项）
+
+- [ ] `pip install --no-cache-dir echoui` 从 PyPI 安装成功
+- [ ] `gh repo view` + `gh release list`（需创建远程仓库并打 tag）
+- [ ] CLI 链：`echoui new demo && build web/tui` 端到端
+- [ ] Desktop `.exe` / Android `.apk` 本机产出验证（A 类，需 PySide6 / Android SDK）
+- [ ] iOS CI workflow 首次跑通并下载 artifact
+
+## 已知降级/占位（诚实标注）
+
+| 项 | 类别 | 说明 |
+|----|------|------|
+| iOS 本地构建 | B | Windows 无法跑 Xcode；已配 `ios-build.yml` macOS runner |
+| 应用商店签名/上架 | C | 流程就绪，需用户提供开发者账号 |
+| Web sqlite / os_api / gpu | interface-only | 见 `docs/api/targets.md` |
+| v0.1 编译器 | 简化 | 运行时内省 IR，静态分析为后续目标 |
+| WCAG 认证 | done-degraded | `a11y_audit` 规则检查，非完整 WCAG |
+
+## 阻塞项
+
+- GitHub 远程仓库 `nichengfuben/echoui` 尚未创建（本地仅有 `main` 分支）
+- PyPI 尚无 `echoui` 包（待 `twine upload`）
+
+## 环境记录
+
+- Python 3.14.6（`py`）
+- Git：`E:\Program Files\Git\cmd\git.exe`
+- `PYPI_TOKEN` / `GH_TOKEN`：已配置

echoui-0.9.1/README.md

@@ -0,0 +1,71 @@
+# EchoUI — Universal Python-first UI framework
+
+One **Screen–Stage–Sprite** paradigm compiles to Web, desktop, mobile, TUI, and GUI.
+
+**Version:** 0.9.0 · **License:** MIT · **Docs:** [docs/api/INDEX.md](docs/api/INDEX.md)
+
+## Quick Start
+
+```bash
+pip install -e ".[web,dev]"
+```
+
+Create `main.py`:
+
+```python
+from echoui import App, Screen, Store, col, text, button
+
+class CounterStore(Store):
+    count: int = 0
+
+store = CounterStore()
+
+class Counter(Screen):
+    def build(self):
+        return col(
+            text(lambda: f"Count: {store.count}"),
+            button("+1", on_click=lambda: setattr(store, "count", store.count + 1)),
+        )
+
+app = App(screens=[Counter], initial="Counter")
+```
+
+Build and run:
+
+```bash
+echoui build --target web
+echoui dev --target web --port 7999
+```
+
+Open http://127.0.0.1:7999 — click **+1** and the count increments.
+
+## CLI
+
+| Command | Description |
+|---------|-------------|
+| `echoui new [name]` | Scaffold a counter project |
+| `echoui dev --target web` | Dev server with hot reload |
+| `echoui build --target web\|static\|tui\|desktop\|gui` | Compile for target |
+| `echoui check` | Validate project |
+| `echoui version` | Print version |
+
+## Quality Gate
+
+```bash
+ruff check .
+mypy echoui
+pytest -q
+python achecker.py
+python -m build
+twine check dist/*
+```
+
+## Testing
+
+```bash
+pytest -q
+```
+
+## License
+
+MIT — see [LICENSE](LICENSE).