affineui 0.4.0__tar.gz

affineui-0.4.0/CMakeLists.txt

@@ -0,0 +1,65 @@
+cmake_minimum_required(VERSION 3.20)
+
+project(affineui_python
+    VERSION 0.0.1
+    DESCRIPTION "Python bindings for AffineUI"
+    LANGUAGES CXX
+)
+
+find_package(Python COMPONENTS Interpreter Development.Module REQUIRED)
+find_package(pybind11 CONFIG REQUIRED)
+
+if(NOT TARGET affineui)
+    set(AFFINEUI_BUILD_EXAMPLES OFF CACHE BOOL "" FORCE)
+    set(AFFINEUI_BUILD_TESTS OFF CACHE BOOL "" FORCE)
+    set(AFFINEUI_BUILD_TOOLS OFF CACHE BOOL "" FORCE)
+    set(AFFINEUI_BUILD_PYTHON_BINDINGS OFF CACHE BOOL "" FORCE)
+    set(AFFINEUI_INSTALL OFF CACHE BOOL "" FORCE)
+    add_subdirectory(
+        "${CMAKE_CURRENT_LIST_DIR}/../.."
+        "${CMAKE_CURRENT_BINARY_DIR}/affineui-core"
+    )
+endif()
+
+pybind11_add_module(_affineui MODULE
+    src/affineui_py.cpp
+)
+
+target_link_libraries(_affineui PRIVATE affineui::affineui)
+target_compile_features(_affineui PRIVATE cxx_std_20)
+target_compile_definitions(_affineui PRIVATE
+    AFFINEUI_PY_VERSION="${PROJECT_VERSION}"
+)
+
+install(TARGETS _affineui
+    LIBRARY DESTINATION affineui
+    RUNTIME DESTINATION affineui
+)
+
+# ── photo_core: example-support extension module (NOT part of affineui) ──────
+# The Decius Photo Edit sample's raster core lives with the other C++ example
+# sidecars in examples/core/. Building it here (where pybind11 is already in
+# scope) yields a standalone `photo_core` module the sample imports alongside
+# `affineui`. It is not shipped inside the affineui package.
+add_subdirectory(
+    "${CMAKE_CURRENT_LIST_DIR}/../../examples/core/photoedit"
+    "${CMAKE_CURRENT_BINARY_DIR}/photoedit"
+)
+affineui_photoedit_python_module()
+
+# photo_core installs as a top-level module at the wheel root so both the
+# sample (`import photo_core`) and the test suite import it the normal way.
+# It shares process-global pybind11 internals with affineui's _affineui, so
+# the two MUST come from the same build — a clean editable reinstall keeps
+# them in lockstep; the sample additionally carries a self-locator fallback
+# that loads an ABI-matched photo_core from _affineui's own directory if the
+# top-level import ever misses (partial/edited trees).
+install(TARGETS photo_core
+    LIBRARY DESTINATION .
+    RUNTIME DESTINATION .
+)
+
+install(FILES
+    "${CMAKE_CURRENT_LIST_DIR}/../../extras/browser_server/affineui_browser_server.h"
+    DESTINATION affineui/include
+)

affineui-0.4.0/PKG-INFO

@@ -0,0 +1,204 @@
+Metadata-Version: 2.2
+Name: affineui
+Version: 0.4.0
+Summary: Python bindings for AffineUI — GPU-accelerated HTML/CSS UI for tools and game engines. EXPERIMENTAL preview; APIs will change.
+Author: AffineUI contributors
+License: MIT
+Classifier: Development Status :: 3 - Alpha
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: C++
+Classifier: Topic :: Software Development :: User Interfaces
+Project-URL: Repository, https://github.com/affineui/affineui
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+
+# AffineUI for Python
+
+<img src="https://raw.githubusercontent.com/affineui/affineui/main/images/affineui_dender.png" width="720" alt="AffineUI running the Dender 3D-print slicer — the default Decius CSS look">
+
+<img src="https://raw.githubusercontent.com/affineui/affineui/main/images/affineui_bootstrap.png" width="720" alt="AffineUI rendering a Bootstrap dashboard">
+
+**A small, HTML5-compliant, GPU-accelerated UI renderer with an integrated
+component framework — a native replacement for Electron and Qt, for Python.**
+
+Think Gradio, but native: describe your UI as a tree of typed components,
+get a real HTML/CSS renderer with a browser-quality cascade, animations,
+hit-testing, and 120 Hz paint — all in one binary, no browser embedded, no
+JavaScript runtime, no Electron. Bootstrap and Tailwind-style stylesheets
+render out of the box; the bundled default is
+[Decius CSS](https://deciuscss.com).
+
+**Status:** alpha. Broad standards coverage, real UIs run today, but
+expect bugs and expect APIs to move.
+
+> **Note:** this release carries no `-alpha` suffix in its version number,
+> but AffineUI is alpha and pre-1.0. Features, APIs, and the set of supported
+> platforms are all still in flux.
+>
+> Verified on: **Linux (Ubuntu, x86-64)**, **macOS (Apple Silicon)**, and
+> **Windows (x86-64)** — the full suite (600+ tests) passes on each. Other
+> platforms and architectures are not yet supported.
+
+---
+
+## Install
+
+```bash
+pip install affineui
+```
+
+Prebuilt wheels ship for CPython 3.9 – 3.13 on Linux (`manylinux_2_28`
+x86_64), macOS (universal2 — Intel + Apple Silicon), and Windows AMD64.
+
+For a source install from a clone of the [main repo](https://github.com/affineui/affineui):
+
+```bash
+pip install ./bindings/python           # regular install
+pip install -e ./bindings/python        # editable / dev
+```
+
+---
+
+## Hello, world
+
+### Component API (recommended)
+
+```python
+import affineui as ui
+
+view = ui.View(ui.ViewTheme.Decius)
+view.begin()
+view.heading(1, "Hello from Python")
+view.paragraph("AffineUI — native HTML/CSS, no browser, no JS.")
+view.button("Click me", primary=True, key="go").on_click(lambda: print("clicked!"))
+view.end()
+
+app = ui.App(title="Hello", width=720, height=480)
+app.load_view(view)
+raise SystemExit(app.run())
+```
+
+### Raw HTML
+
+```python
+import affineui as ui
+
+app = ui.App(title="Hello", width=720, height=480)
+app.load_html("""
+  <main style="padding: 24px; font-family: sans-serif;">
+    <h1>Hello from Python</h1>
+    <p>AffineUI is alive.</p>
+    <button>Click me</button>
+  </main>
+""")
+raise SystemExit(app.run())
+```
+
+### Headless (no window — for CI and tests)
+
+```python
+import affineui as ui
+
+doc = ui.document(
+    "<main><h1>Hello</h1><p>Layout without a window.</p></main>",
+    "main { padding: 16px; } h1 { font-size: 32px; }",
+    width=640, height=360,
+)
+print(ui.version(), doc.content_size())
+```
+
+---
+
+## A modest app
+
+A live-updating counter — state lives in Python; the reconciler diffs
+your view and patches the DOM in place. CSS hover/focus/animation keeps
+running between updates.
+
+```python
+import affineui as ui
+
+count = 0
+app = ui.App(title="Counter", width=480, height=240)
+
+def build_view() -> ui.View:
+    view = ui.View(ui.ViewTheme.Decius)
+    view.begin()
+    view.heading(1, f"Count: {count}")
+    view.button("Increment", primary=True, key="inc").on_click(bump)
+    view.button("Reset",                    key="reset").on_click(reset)
+    view.end()
+    return view
+
+def bump():
+    global count
+    count += 1
+    app.load_view(build_view())
+
+def reset():
+    global count
+    count = 0
+    app.load_view(build_view())
+
+app.load_view(build_view())
+raise SystemExit(app.run())
+```
+
+The main repo's [`bindings/python/examples/`](https://github.com/affineui/affineui/tree/main/bindings/python/examples)
+ships larger runnable programs — a component gallery, a photo editor,
+and a full Bootstrap-styled panel demo.
+
+---
+
+## Loading design-system CSS
+
+Decius CSS is the default when you use the component API. To render your
+own HTML with a framework stylesheet, tell the app where its asset
+folder is:
+
+```python
+app = ui.App(
+    title="Bootstrap demo",
+    width=1280,
+    height=720,
+    asset_folders=["examples"],          # so href="frameworks/..." resolves
+)
+app.load_html("""
+  <link rel="stylesheet" href="frameworks/css/bootstrap-5.3.8.min.css">
+  <div class="container py-4">
+    <button class="btn btn-primary">Native Bootstrap</button>
+  </div>
+""")
+raise SystemExit(app.run())
+```
+
+Bootstrap 4.6 / 5.3, Tailwind-style utility classes, and Ant-style
+component markup all render — this is a real CSS engine, not an
+HTML-shaped layout solver.
+
+---
+
+## What AffineUI is *not*
+
+- **Not a browser.** No navigation, no `fetch`, no cookies.
+- **Not a nerfed HTML5.** Missing non-esoteric features are bugs.
+- **Not a security sandbox.** Never feed it untrusted HTML/CSS/JS.
+- **Not an everything-included framework.** No video decode, no audio,
+  no 3D — those are your app's job.
+- **Not (yet) a JS runtime.** JS + React support is on the roadmap as
+  an opt-in extension.
+
+See the [main README](https://github.com/affineui/affineui) for the
+full picture, embedding notes, C++ / Rust / C# APIs, and the demo
+gallery.
+
+---
+
+## Links
+
+- **Repository:** <https://github.com/affineui/affineui>
+- **Docs:** <https://github.com/affineui/affineui/tree/main/docs>
+- **Issues:** <https://github.com/affineui/affineui/issues>
+- **Discussion:** [r/affineui](https://www.reddit.com/r/affineui/) — questions,
+  show-and-tell, and general chat
+- **License:** MIT

affineui-0.4.0/README.md

@@ -0,0 +1,190 @@
+# AffineUI for Python
+
+<img src="https://raw.githubusercontent.com/affineui/affineui/main/images/affineui_dender.png" width="720" alt="AffineUI running the Dender 3D-print slicer — the default Decius CSS look">
+
+<img src="https://raw.githubusercontent.com/affineui/affineui/main/images/affineui_bootstrap.png" width="720" alt="AffineUI rendering a Bootstrap dashboard">
+
+**A small, HTML5-compliant, GPU-accelerated UI renderer with an integrated
+component framework — a native replacement for Electron and Qt, for Python.**
+
+Think Gradio, but native: describe your UI as a tree of typed components,
+get a real HTML/CSS renderer with a browser-quality cascade, animations,
+hit-testing, and 120 Hz paint — all in one binary, no browser embedded, no
+JavaScript runtime, no Electron. Bootstrap and Tailwind-style stylesheets
+render out of the box; the bundled default is
+[Decius CSS](https://deciuscss.com).
+
+**Status:** alpha. Broad standards coverage, real UIs run today, but
+expect bugs and expect APIs to move.
+
+> **Note:** this release carries no `-alpha` suffix in its version number,
+> but AffineUI is alpha and pre-1.0. Features, APIs, and the set of supported
+> platforms are all still in flux.
+>
+> Verified on: **Linux (Ubuntu, x86-64)**, **macOS (Apple Silicon)**, and
+> **Windows (x86-64)** — the full suite (600+ tests) passes on each. Other
+> platforms and architectures are not yet supported.
+
+---
+
+## Install
+
+```bash
+pip install affineui
+```
+
+Prebuilt wheels ship for CPython 3.9 – 3.13 on Linux (`manylinux_2_28`
+x86_64), macOS (universal2 — Intel + Apple Silicon), and Windows AMD64.
+
+For a source install from a clone of the [main repo](https://github.com/affineui/affineui):
+
+```bash
+pip install ./bindings/python           # regular install
+pip install -e ./bindings/python        # editable / dev
+```
+
+---
+
+## Hello, world
+
+### Component API (recommended)
+
+```python
+import affineui as ui
+
+view = ui.View(ui.ViewTheme.Decius)
+view.begin()
+view.heading(1, "Hello from Python")
+view.paragraph("AffineUI — native HTML/CSS, no browser, no JS.")
+view.button("Click me", primary=True, key="go").on_click(lambda: print("clicked!"))
+view.end()
+
+app = ui.App(title="Hello", width=720, height=480)
+app.load_view(view)
+raise SystemExit(app.run())
+```
+
+### Raw HTML
+
+```python
+import affineui as ui
+
+app = ui.App(title="Hello", width=720, height=480)
+app.load_html("""
+  <main style="padding: 24px; font-family: sans-serif;">
+    <h1>Hello from Python</h1>
+    <p>AffineUI is alive.</p>
+    <button>Click me</button>
+  </main>
+""")
+raise SystemExit(app.run())
+```
+
+### Headless (no window — for CI and tests)
+
+```python
+import affineui as ui
+
+doc = ui.document(
+    "<main><h1>Hello</h1><p>Layout without a window.</p></main>",
+    "main { padding: 16px; } h1 { font-size: 32px; }",
+    width=640, height=360,
+)
+print(ui.version(), doc.content_size())
+```
+
+---
+
+## A modest app
+
+A live-updating counter — state lives in Python; the reconciler diffs
+your view and patches the DOM in place. CSS hover/focus/animation keeps
+running between updates.
+
+```python
+import affineui as ui
+
+count = 0
+app = ui.App(title="Counter", width=480, height=240)
+
+def build_view() -> ui.View:
+    view = ui.View(ui.ViewTheme.Decius)
+    view.begin()
+    view.heading(1, f"Count: {count}")
+    view.button("Increment", primary=True, key="inc").on_click(bump)
+    view.button("Reset",                    key="reset").on_click(reset)
+    view.end()
+    return view
+
+def bump():
+    global count
+    count += 1
+    app.load_view(build_view())
+
+def reset():
+    global count
+    count = 0
+    app.load_view(build_view())
+
+app.load_view(build_view())
+raise SystemExit(app.run())
+```
+
+The main repo's [`bindings/python/examples/`](https://github.com/affineui/affineui/tree/main/bindings/python/examples)
+ships larger runnable programs — a component gallery, a photo editor,
+and a full Bootstrap-styled panel demo.
+
+---
+
+## Loading design-system CSS
+
+Decius CSS is the default when you use the component API. To render your
+own HTML with a framework stylesheet, tell the app where its asset
+folder is:
+
+```python
+app = ui.App(
+    title="Bootstrap demo",
+    width=1280,
+    height=720,
+    asset_folders=["examples"],          # so href="frameworks/..." resolves
+)
+app.load_html("""
+  <link rel="stylesheet" href="frameworks/css/bootstrap-5.3.8.min.css">
+  <div class="container py-4">
+    <button class="btn btn-primary">Native Bootstrap</button>
+  </div>
+""")
+raise SystemExit(app.run())
+```
+
+Bootstrap 4.6 / 5.3, Tailwind-style utility classes, and Ant-style
+component markup all render — this is a real CSS engine, not an
+HTML-shaped layout solver.
+
+---
+
+## What AffineUI is *not*
+
+- **Not a browser.** No navigation, no `fetch`, no cookies.
+- **Not a nerfed HTML5.** Missing non-esoteric features are bugs.
+- **Not a security sandbox.** Never feed it untrusted HTML/CSS/JS.
+- **Not an everything-included framework.** No video decode, no audio,
+  no 3D — those are your app's job.
+- **Not (yet) a JS runtime.** JS + React support is on the roadmap as
+  an opt-in extension.
+
+See the [main README](https://github.com/affineui/affineui) for the
+full picture, embedding notes, C++ / Rust / C# APIs, and the demo
+gallery.
+
+---
+
+## Links
+
+- **Repository:** <https://github.com/affineui/affineui>
+- **Docs:** <https://github.com/affineui/affineui/tree/main/docs>
+- **Issues:** <https://github.com/affineui/affineui/issues>
+- **Discussion:** [r/affineui](https://www.reddit.com/r/affineui/) — questions,
+  show-and-tell, and general chat
+- **License:** MIT