spaday-regular-layout 0.1.0__py3-none-any.whl

spaday_regular_layout/__init__.py

@@ -0,0 +1,17 @@
+from pathlib import Path
+
+from spaday import ComponentPackage
+
+from .components import RegularLayoutFrame, SpadayRegularLayout
+
+__version__ = "0.1.0"
+
+package = ComponentPackage(
+    name="regular-layout",
+    assets_dir=Path(__file__).parent / "extension",
+    assets=(("css", "css/lorax.css"), ("js", "cdn/index.js")),
+)
+
+RegularLayout = SpadayRegularLayout
+
+__all__ = ["RegularLayout", "RegularLayoutFrame", "package"]

spaday_regular_layout/components.cem.json

@@ -0,0 +1,40 @@
+{
+  "schemaVersion": "1.0.0",
+  "modules": [
+    {
+      "path": "src/ts/index.ts",
+      "declarations": [
+        {
+          "kind": "class",
+          "name": "RegularLayout",
+          "customElement": true,
+          "tagName": "spaday-regular-layout",
+          "summary": "Resizable panel layout driven by a serializable split/tab tree.",
+          "attributes": [
+            {
+              "name": "layout",
+              "type": { "text": "unknown" },
+              "description": "Serializable regular-layout split/tab tree."
+            }
+          ],
+          "slots": [{ "name": "" }]
+        },
+        {
+          "kind": "class",
+          "name": "RegularLayoutFrame",
+          "customElement": true,
+          "tagName": "regular-layout-frame",
+          "summary": "Named draggable panel frame inside a RegularLayout.",
+          "attributes": [
+            {
+              "name": "name",
+              "type": { "text": "string" },
+              "description": "Panel name referenced by the layout tree."
+            }
+          ],
+          "slots": [{ "name": "" }]
+        }
+      ]
+    }
+  ]
+}

spaday_regular_layout/components.py

@@ -0,0 +1,52 @@
+# Generated by spaday.cem from components.cem.json — do not edit by hand.
+from __future__ import annotations
+
+from typing import Any
+
+from spaday.component import Child, Component
+
+__all__ = ["RegularLayoutFrame", "SpadayRegularLayout"]
+
+
+class SpadayRegularLayout(Component):
+    """Resizable panel layout driven by a serializable split/tab tree."""
+
+    tag = "spaday-regular-layout"
+
+    def __init__(
+        self,
+        *children: Child,
+        key: str | None = None,
+        layout: Any = None,
+        **props: Any,
+    ) -> None:
+        super().__init__(
+            *children,
+            key=key,
+            props={
+                "layout": layout,
+            },
+            **props,
+        )
+
+
+class RegularLayoutFrame(Component):
+    """Named draggable panel frame inside a RegularLayout."""
+
+    tag = "regular-layout-frame"
+
+    def __init__(
+        self,
+        *children: Child,
+        key: str | None = None,
+        name: str | None = None,
+        **props: Any,
+    ) -> None:
+        super().__init__(
+            *children,
+            key=key,
+            props={
+                "name": name,
+            },
+            **props,
+        )

spaday_regular_layout/example.py

@@ -0,0 +1,113 @@
+import asyncio
+import logging
+from copy import deepcopy
+from typing import Any
+
+import transports
+import uvicorn
+from pydantic import BaseModel
+from spaday import CallEndpoint, If, Wire, element, event_value, not_, prop, this
+from spaday.backends.starlette import serve
+from starlette.responses import JSONResponse
+from starlette.routing import Route, WebSocketRoute
+
+from spaday_regular_layout import RegularLayout, RegularLayoutFrame, package
+
+logger = logging.getLogger("uvicorn.error")
+
+initial_layout = {
+    "type": "split-layout",
+    "orientation": "horizontal",
+    "sizes": [0.28, 0.72],
+    "children": [
+        {"type": "tab-layout", "tabs": ["navigation"], "selected": 0},
+        {
+            "type": "split-layout",
+            "orientation": "vertical",
+            "sizes": [0.68, 0.32],
+            "children": [
+                {"type": "tab-layout", "tabs": ["workspace"], "selected": 0},
+                {"type": "tab-layout", "tabs": ["activity"], "selected": 0},
+            ],
+        },
+    ],
+}
+
+alternate_layout = {
+    "type": "split-layout",
+    "orientation": "vertical",
+    "sizes": [0.65, 0.35],
+    "children": [
+        {"type": "tab-layout", "tabs": ["workspace", "navigation"], "selected": 0},
+        {"type": "tab-layout", "tabs": ["activity"], "selected": 0},
+    ],
+}
+
+
+class LayoutFeed(BaseModel):
+    layout: dict[str, Any]
+
+
+layout_feed = LayoutFeed(layout=initial_layout)
+session = transports.Session()
+session.host(layout_feed)
+server = transports.Server(session)
+
+
+async def rotate_layout() -> None:
+    layouts = (alternate_layout, initial_layout)
+    index = 0
+    while True:
+        await asyncio.sleep(5)
+        layout_feed.layout = deepcopy(layouts[index])
+        logger.info("Server pushed layout %s", index + 1)
+        index = (index + 1) % len(layouts)
+
+
+async def save_layout(request):
+    updated = await request.json()
+    if updated != layout_feed.layout:
+        layout_feed.layout = updated
+        logger.info("Layout received from browser: %s", updated)
+    return JSONResponse({"saved": True})
+
+
+def panel(title: str, copy: str, name: str) -> RegularLayoutFrame:
+    return RegularLayoutFrame(
+        element("h2").text(title),
+        element("p").text(copy),
+        name=name,
+        style="padding: 1rem; box-sizing: border-box; font-family: system-ui",
+    )
+
+
+page = (
+    RegularLayout(
+        panel("Navigation", "Drag this panel's tab to rearrange it.", "navigation"),
+        panel("Workspace", "Drop another tab here to create a stack.", "workspace"),
+        panel("Activity", "Drag either divider to resize nested splits.", "activity"),
+        layout=initial_layout,
+        style="height: calc(100vh - 2rem); margin: 1rem",
+    )
+    .prop("class", "lorax")
+    .bind("layout", "layout")
+    .on(
+        "regular-layout-update",
+        If(not_(prop(this(), "restoring")), CallEndpoint("POST", "/api/layout", event_value())),
+    )
+)
+
+app = serve(
+    page,
+    packages=[package],
+    wire=[Wire("/ws", flatten=False)],
+    routes=[
+        WebSocketRoute("/ws", transports.ws_endpoint(server)),
+        Route("/api/layout", save_layout, methods=["POST"]),
+    ],
+    background=[transports.autosync(server), rotate_layout()],
+    title="spaday-regular-layout example",
+)
+
+if __name__ == "__main__":
+    uvicorn.run(app, host="127.0.0.1", port=8013)