Improve client/server wrappers

Author: apiad

examples/basic_pwa.py

@@ -7,7 +7,7 @@
 print(app.version)
 
 
-@app.route("/", pwa=True)
+@app.view("/", pwa=True)
 def index():
     doc = Document(title=f"Auto PWA")
     doc.body.extend(

examples/broadcast.py

@@ -8,7 +8,7 @@
 
 
 # --- 1. Client Side (Updates the UI) ---
-@app.client
+@app.client.realtime
 async def update_counter(count: int):
     # This runs in the User's Browser
     from violetear.dom import Document
@@ -18,12 +18,12 @@ async def update_counter(count: int):
     el.style(color="red" if count % 2 == 0 else "blue")
 
 
-@app.connect
+@app.server.on("connect")
 async def enter(id: str):
     print(f"Client connected {id}")
 
 
-@app.disconnect
+@app.server.on("disconnect")
 async def exit(id: str):
     print(f"Client disconnected {id}")
 
@@ -41,21 +41,13 @@ async def background_pinger():
 
 
 # --- Lifecycle Management ---
-@asynccontextmanager
-async def lifespan(api):
-    # Startup
-    task = asyncio.create_task(background_pinger())
-    yield
-    # Shutdown (optional cleanup)
-    task.cancel()
-
-
-# Hook into the internal FastAPI router to register lifespan
-app.api.router.lifespan_context = lifespan
+@app.server.on("startup")
+async def start_pinger():
+    asyncio.create_task(background_pinger())
 
 
 # --- 3. The UI (HTML) ---
-@app.route("/")
+@app.view("/")
 def home():
     # 1. Create the Document
     doc = Document(title="Live Counter")

examples/full_pwa.py

@@ -61,7 +61,7 @@ async def change_color(event: Event):
 
 # --- 3. Define Route ---
 # pwa=True enables the Service Worker
-@app.route("/", pwa=True)
+@app.view("/", pwa=True)
 def index():
     doc = Document(title="Cached PWA")
 

examples/hello_world.py

@@ -15,7 +15,7 @@
 
 
 # 3. Define your Routes (The "Controller")
-@app.route("/")
+@app.view("/")
 def index():
     doc = Document(title="My Styled App")
 

examples/quickstart.py

@@ -29,7 +29,7 @@
 
 
 # --- 2. THE SERVER (FastAPI RPC) ---
-@app.server
+@app.server.rpc
 async def report_count(current_count: int, action: str):
     """
     This runs on the server.
@@ -42,7 +42,7 @@ async def report_count(current_count: int, action: str):
 # --- 3. THE CLIENT (Pyodide Browser) ---
 
 
-@app.client
+@app.client.callback
 async def handle_change(event: Event):
     """
     Runs in the browser.
@@ -69,7 +69,7 @@ async def handle_change(event: Event):
     await report_count(current_count=new_value, action=action)
 
 
-@app.startup
+@app.client.on("ready")
 async def init_counter():
     """
     Runs automatically when the page loads (Client-Side).
@@ -89,7 +89,7 @@ async def init_counter():
 # --- 4. THE UI (Server-Side Rendered) ---
 
 
-@app.route("/")
+@app.view("/")
 def index():
     doc = Document(title="Violetear Counter")
     doc.style(style, href="/style.css")  # Link our style

examples/rpc_call.py

@@ -13,7 +13,7 @@ class UserData(BaseModel):
 
 
 # 2. Define the Server Logic
-@app.server
+@app.server.rpc
 async def create_user(name: str, age: int) -> UserData:
     # This runs on the SERVER.
     # Pydantic validation happens automatically here!
@@ -24,7 +24,7 @@ async def create_user(name: str, age: int) -> UserData:
 
 
 # 3. Define the Client Logic
-@app.client
+@app.client.callback
 async def on_submit(event: Event):
     from violetear.dom import Document
 
@@ -42,7 +42,7 @@ async def on_submit(event: Event):
 
 
 # 4. The UI
-@app.route("/")
+@app.view("/")
 def index():
     doc = Document(title="RPC Demo")
 

examples/simple_client.py

@@ -7,8 +7,8 @@
 
 # 2. Define Client-Side Code
 # This function is compiled into the bundle and sent to the browser.
-@app.client
-def on_button_click(event):
+@app.client.callback
+async def on_button_click(event):
     # This print shows up in the Browser DevTools Console!
     print("Hello from Client-Side Python!")
 
@@ -19,7 +19,7 @@ def on_button_click(event):
 
 
 # 3. Define Server-Side Route
-@app.route("/")
+@app.view("/")
 def home():
     doc = Document(title="Client-Side Demo")