wapyt 0.1.0__tar.gz

wapyt-0.1.0/MANIFEST.in

@@ -0,0 +1 @@
+recursive-include wapyt/assets *

wapyt-0.1.0/PKG-INFO

@@ -0,0 +1,79 @@
+Metadata-Version: 2.4
+Name: wapyt
+Version: 0.1.0
+Summary: DHTMLX-free PyTincture widgetset with layout, chat, card panel, and tab widgets.
+License: MIT
+Project-URL: homepage, https://github.com/schapman1974/wA_pytincture_widgetset
+Keywords: pytincture,widgetset,pyodide,wapyt
+Requires-Python: >=3.13
+Description-Content-Type: text/markdown
+Requires-Dist: pyodide-py>=0.28.0
+Requires-Dist: itsdangerous>=2.2.0
+
+# wA PyTincture Widgetset (`wapyt`)
+
+`wapyt` is a lightweight widgetset for [pyTincture](https://github.com/schapman1974/pytincture) that avoids the commercial DHTMLX dependency used by the legacy package. It focuses on a DOM-driven layout engine and a set of first-class widgets that can be composed entirely from Python when running inside Pyodide.
+
+## Highlights
+- **Theme-aware layout**: Flexbox-based layout manager that mirrors the familiar `LayoutConfig`/`CellConfig` API, supports nested rows/columns, and exposes helper methods such as `attach_html`, `collapse`, `toggle`, `hide`, etc.
+- **Widgets that don’t require DHTMLX**: Native Chat, CardPanel, TabWidget, Sidebar, ModalWindow, and ResourceBoard implementations with the streaming/events helpers the PyTincture samples expect.
+- **`MainWindow` wrapper**: Thin helper built on top of `Layout` so existing apps can continue to expose a `MainWindow` class with no additional boilerplate.
+- **PyTincture metadata**: Exposes `__widgetset__ = "wapyt"` so the platform can auto-discover the package name/version during `***WIDGETSET***` substitution.
+- **Test/demo apps**: Located under `tests/` to show how to embed the widgets inside PyTincture applications.
+
+## Widget Catalog
+- `Layout` / `MainWindow`: Flexbox-driven layout primitives plus a drop-in `MainWindow` helper that mirrors the legacy PyTincture entrypoint.
+- `Chat`: Streaming chat surface with agent metadata, artifact events, and helpers for incremental responses.
+- `CardPanel`: Searchable, template-driven card grid with add/view/action callbacks and custom renderers.
+- `TabWidget`: Lightweight tab host that supports badges, closable tabs, and attaching HTML or PyTincture components per tab.
+- `Sidebar`: Collapsible navigation rail with badges, icons, and selection events for driving the rest of your layout.
+- `ModalWindow`: Simple modal shell that can host arbitrary Layout instances or HTML snippets.
+- `ResourceBoard`: Master/detail resource explorer with selectable rows, action hooks, and optional add button wiring.
+
+## Runtime Architecture
+- Layouts and widgets are declared in Python but render as DOM nodes through the JavaScript bundles under `wapyt/assets/`. Each helper (e.g., `Layout.add_chat`) forwards config dictionaries directly to the matching JS constructor.
+- The `wapyt/_runtime.py` bridge exposes `require_js` to lazily inject JS/CSS exactly once per interpreter and `create_proxy` to keep Pyodide callback proxies alive for event handlers.
+- Layout cells are plain flexbox containers (`wapyt/assets/layout.js` + `wapyt/assets/wapyt.css`), so attaching raw HTML or third-party widgets is as simple as calling `layout.attach_html(cell_id, markup)`.
+- Because everything routes through `window.wapyt`, you can add new widgets by dropping a JS file into `wapyt/assets/`, exporting a constructor, and calling `require_js("MyWidget")` before instantiating it from Python.
+
+## Getting Started
+
+```bash
+cd wapyt
+uv venv --python 3.13 && source .venv/bin/activate
+uv pip install -e .
+```
+
+Then run a PyTincture example pointing at this widgetset:
+
+```bash
+cd ../pytincture
+uv run pytincture launch_service --modules_folder ../wA_pytincture_widgetset/tests --port 8070
+```
+
+Open http://localhost:8070/layout_demo in your browser to see the native layout, and swap in `chat_demo` / `cardpanel_demo` / `tabs_demo` to explore the specialized widgets.
+
+## Package Layout
+
+```
+wapyt/
+  ├── chat/        # Chat widget config + wrapper
+  ├── cardpanel/   # CardPanel widget config + wrapper
+  ├── layout/      # Layout/MainWindow helpers
+  ├── modal/       # ModalWindow + config
+  ├── resourceboard/ # ResourceBoard widget + config
+  ├── sidebar/     # Sidebar widget config + wrapper
+  ├── tabwidget/   # Tab widget config + wrapper
+  └── assets/      # JS + CSS evaluated automatically by PyTincture
+```
+
+
+## Development Notes
+
+- The JavaScript bundles define the `window.wapyt` namespace and are evaluated automatically by PyTincture’s loader (see `pytincture/frontend/pytincture.js`).
+- Layout styles live in `assets/wapyt.css`; adjust tokens there to integrate with your design system.
+- The tests are intentionally small, framework-free PyTincture apps so you can copy/paste into your own projects.
+
+## License
+
+MIT – see `pyproject.toml` for details.

wapyt-0.1.0/README.md

@@ -0,0 +1,67 @@
+# wA PyTincture Widgetset (`wapyt`)
+
+`wapyt` is a lightweight widgetset for [pyTincture](https://github.com/schapman1974/pytincture) that avoids the commercial DHTMLX dependency used by the legacy package. It focuses on a DOM-driven layout engine and a set of first-class widgets that can be composed entirely from Python when running inside Pyodide.
+
+## Highlights
+- **Theme-aware layout**: Flexbox-based layout manager that mirrors the familiar `LayoutConfig`/`CellConfig` API, supports nested rows/columns, and exposes helper methods such as `attach_html`, `collapse`, `toggle`, `hide`, etc.
+- **Widgets that don’t require DHTMLX**: Native Chat, CardPanel, TabWidget, Sidebar, ModalWindow, and ResourceBoard implementations with the streaming/events helpers the PyTincture samples expect.
+- **`MainWindow` wrapper**: Thin helper built on top of `Layout` so existing apps can continue to expose a `MainWindow` class with no additional boilerplate.
+- **PyTincture metadata**: Exposes `__widgetset__ = "wapyt"` so the platform can auto-discover the package name/version during `***WIDGETSET***` substitution.
+- **Test/demo apps**: Located under `tests/` to show how to embed the widgets inside PyTincture applications.
+
+## Widget Catalog
+- `Layout` / `MainWindow`: Flexbox-driven layout primitives plus a drop-in `MainWindow` helper that mirrors the legacy PyTincture entrypoint.
+- `Chat`: Streaming chat surface with agent metadata, artifact events, and helpers for incremental responses.
+- `CardPanel`: Searchable, template-driven card grid with add/view/action callbacks and custom renderers.
+- `TabWidget`: Lightweight tab host that supports badges, closable tabs, and attaching HTML or PyTincture components per tab.
+- `Sidebar`: Collapsible navigation rail with badges, icons, and selection events for driving the rest of your layout.
+- `ModalWindow`: Simple modal shell that can host arbitrary Layout instances or HTML snippets.
+- `ResourceBoard`: Master/detail resource explorer with selectable rows, action hooks, and optional add button wiring.
+
+## Runtime Architecture
+- Layouts and widgets are declared in Python but render as DOM nodes through the JavaScript bundles under `wapyt/assets/`. Each helper (e.g., `Layout.add_chat`) forwards config dictionaries directly to the matching JS constructor.
+- The `wapyt/_runtime.py` bridge exposes `require_js` to lazily inject JS/CSS exactly once per interpreter and `create_proxy` to keep Pyodide callback proxies alive for event handlers.
+- Layout cells are plain flexbox containers (`wapyt/assets/layout.js` + `wapyt/assets/wapyt.css`), so attaching raw HTML or third-party widgets is as simple as calling `layout.attach_html(cell_id, markup)`.
+- Because everything routes through `window.wapyt`, you can add new widgets by dropping a JS file into `wapyt/assets/`, exporting a constructor, and calling `require_js("MyWidget")` before instantiating it from Python.
+
+## Getting Started
+
+```bash
+cd wapyt
+uv venv --python 3.13 && source .venv/bin/activate
+uv pip install -e .
+```
+
+Then run a PyTincture example pointing at this widgetset:
+
+```bash
+cd ../pytincture
+uv run pytincture launch_service --modules_folder ../wA_pytincture_widgetset/tests --port 8070
+```
+
+Open http://localhost:8070/layout_demo in your browser to see the native layout, and swap in `chat_demo` / `cardpanel_demo` / `tabs_demo` to explore the specialized widgets.
+
+## Package Layout
+
+```
+wapyt/
+  ├── chat/        # Chat widget config + wrapper
+  ├── cardpanel/   # CardPanel widget config + wrapper
+  ├── layout/      # Layout/MainWindow helpers
+  ├── modal/       # ModalWindow + config
+  ├── resourceboard/ # ResourceBoard widget + config
+  ├── sidebar/     # Sidebar widget config + wrapper
+  ├── tabwidget/   # Tab widget config + wrapper
+  └── assets/      # JS + CSS evaluated automatically by PyTincture
+```
+
+
+## Development Notes
+
+- The JavaScript bundles define the `window.wapyt` namespace and are evaluated automatically by PyTincture’s loader (see `pytincture/frontend/pytincture.js`).
+- Layout styles live in `assets/wapyt.css`; adjust tokens there to integrate with your design system.
+- The tests are intentionally small, framework-free PyTincture apps so you can copy/paste into your own projects.
+
+## License
+
+MIT – see `pyproject.toml` for details.

wapyt-0.1.0/pyproject.toml

@@ -0,0 +1,25 @@
+[build-system]
+requires = ["setuptools>=64", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "wapyt"
+version = "0.1.0"
+description = "DHTMLX-free PyTincture widgetset with layout, chat, card panel, and tab widgets."
+readme = "README.md"
+license = { text = "MIT" }
+requires-python = ">=3.13"
+keywords = ["pytincture", "widgetset", "pyodide", "wapyt"]
+dependencies = [
+    "pyodide-py>=0.28.0",
+    "itsdangerous>=2.2.0",
+]
+
+[project.urls]
+homepage = "https://github.com/schapman1974/wA_pytincture_widgetset"
+
+[tool.setuptools]
+include-package-data = true
+
+[tool.setuptools.packages.find]
+where = ["."]

wapyt-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

wapyt-0.1.0/tests/cardpanel_demo.py

@@ -0,0 +1,119 @@
+import sys
+
+from wapyt.cardpanel import CardPanelConfig, CardPanelCardConfig
+from wapyt.layout import Layout, MainWindow, LayoutConfig, CellConfig
+from wapyt.modal import ModalWindow, ModalConfig
+
+
+class cardpanel_demo(MainWindow):
+    layout_config = LayoutConfig(rows=[CellConfig(id="cards", grow=1)])
+
+    def load_ui(self):
+        self._modal = ModalWindow(ModalConfig(title="Add Provider", width=520, height=380))
+        self._modal_layout = Layout(LayoutConfig(rows=[CellConfig(id="form", grow=1)]))
+        self._modal.set_content(self._modal_layout.layout)
+        self._render_modal_form()
+
+        config = CardPanelConfig(
+            title="Data Sources",
+            description="A minimal card panel rendered without DHTMLX.",
+            search_placeholder="Search connectors…",
+            add_button_text="New Source",
+            card_columns=3,
+            card_height=200,
+            card_template={
+                "class": "card-card",
+                "children": [
+                    {
+                        "class": "card-head",
+                        "children": [
+                            {"class": "card-icon", "text": "{extra.initial}"},
+                            {
+                                "children": [
+                                    {"tag": "h3", "class": "card-title", "text": "{title}"},
+                                    {"tag": "p", "class": "card-sub", "text": "{subtitle}"},
+                                    {"tag": "span", "class": "card-pill", "text": "{pill}"},
+                                ]
+                            },
+                        ],
+                    },
+                    {"class": "card-content", "text": "Status: {extra.status}"},
+                    {
+                        "class": "card-foot",
+                        "children": [
+                            {
+                                "tag": "button",
+                                "class": "card-action",
+                                "text": "View",
+                                "attrs": {"data-card-action": "view"},
+                            },
+                            {
+                                "tag": "button",
+                                "class": "card-action",
+                                "text": "Sync",
+                                "attrs": {"data-card-action": "sync"},
+                            },
+                        ],
+                    },
+                ],
+            },
+            cards=[
+                CardPanelCardConfig(
+                    id="duckdb",
+                    title="DuckDB",
+                    subtitle="Fast OLAP engine",
+                    pill="Warehouse",
+                    extra={"status": "Healthy", "initial": "D"},
+                ),
+                CardPanelCardConfig(
+                    id="snowflake",
+                    title="Snowflake",
+                    subtitle="Elastic cloud analytics",
+                    pill="Warehouse",
+                    extra={"status": "Syncing", "initial": "S"},
+                ),
+                CardPanelCardConfig(
+                    id="lakehouse",
+                    title="Lakehouse",
+                    subtitle="S3 compatible store",
+                    pill="Lake",
+                    extra={"status": "Healthy", "initial": "L"},
+                ),
+            ],
+        )
+        panel = self.add_cardpanel("cards", config)
+        panel.on_card_click(lambda payload: print("Card clicked:", payload))
+        panel.on_add(lambda: self._show_modal())
+        panel.on_action(lambda payload: self._show_modal(payload.get("cardId")))
+
+    def _render_modal_form(self, provider_id: str = "", status: str = ""):
+        form_html = f"""
+        <form style="display:flex;flex-direction:column;gap:12px;">
+            <label>Provider ID
+                <input type="text" value="{provider_id}" style="width:100%;padding:8px;" />
+            </label>
+            <label>Status
+                <input type="text" value="{status}" style="width:100%;padding:8px;" />
+            </label>
+            <label>Models<br/>
+                <textarea style="width:100%;height:120px;padding:8px;">gpt-4o-mini</textarea>
+            </label>
+            <div style="display:flex;justify-content:flex-end;gap:8px;">
+                <button type="button" style="padding:8px 12px;">Cancel</button>
+                <button type="submit" style="padding:8px 12px;background:#2563eb;color:#fff;border:none;border-radius:8px;">Save</button>
+            </div>
+        </form>
+        """
+        self._modal_layout.attach_html("form", form_html)
+
+    def _show_modal(self, provider_id: str = None):
+        title = "Add Provider" if not provider_id else f"Configure {provider_id}"
+        self._modal.set_title(title)
+        self._render_modal_form(provider_id or "", "Healthy")
+        self._modal.show()
+
+
+if __name__ == "__main__" and sys.platform != "emscripten":
+    from pytincture import launch_service
+
+    launch_service(modules_folder=".")