feat(build): add lower-aware put helper

Generate ui::put(slot, view) for lower-aware slot HTML updates and move examples/docs/contracts to that ergonomic path instead of hand-composing slot.html(render(...)).

req: dx/006

req: component/003

req: runtime/001

req: examples/003

examples/kanban.md

@@ -240,7 +240,7 @@ pub fn apply_board_patch(
 
         PatchResult::Conflict { canonical_board } => Effect::batch((
             Effect::set(atoms::BOARD, canonical_board.clone()),
-            slots::board.html(ui::render(&BoardView::from(canonical_board))),
+            ui::put(slots::board, &BoardView::from(canonical_board)),
         )),
     }
 }

examples/kanban/src/lib.rs

@@ -27,7 +27,7 @@ mod tests {
     #[test]
     fn kanban_board_updates_generated_slot() {
         fn render_board() -> impl IntoEffect {
-            board::slots::board.html(super::ui::render(&empty_board()))
+            super::ui::put(board::slots::board, &empty_board())
         }
 
         let effect = inspect(render_board());

examples/kanban/src/main.rs

@@ -138,13 +138,13 @@ async fn interact(
 // req: push/001 req: push/003 req: examples/001
 async fn events(Query(params): Query<BTreeMap<String, String>>) -> impl IntoResponse {
     if params.contains_key("once") {
-        let effect = slots::presence.html(ui::render(&Presence { count: 1 }));
+        let effect = ui::put(slots::presence, &Presence { count: 1 });
         return sse(stream::iter([Ok::<_, Infallible>(effect.into_batch(ui::BUILD_FINGERPRINT))]).boxed());
     }
 
     let batches = stream::unfold(1_u64, |count| async move {
         tokio::time::sleep(Duration::from_secs(4)).await;
-        let effect = slots::presence.html(ui::render(&Presence { count }));
+        let effect = ui::put(slots::presence, &Presence { count });
         Some((Ok::<_, Infallible>(effect.into_batch(ui::BUILD_FINGERPRINT)), count + 1))
     })
     .boxed();
@@ -206,7 +206,7 @@ fn registry(state: Arc<AppState>) -> impl DispatchRegistry {
 
 fn board_effects(board: &BoardState, notice: &'static str) -> impl IntoEffect {
     (
-        slots::board.html(ui::render(&board_view(board))),
+        ui::put(slots::board, &board_view(board)),
         slots::notice.text(notice),
         forms::create_card.clear("title"),
     )

examples/techdemo/src/lib.rs

@@ -30,7 +30,7 @@ mod tests {
     fn techdemo_uses_generated_slots_for_multi_target_updates() {
         fn update() -> impl IntoEffect {
             (
-                slots::hero_metrics.html(super::ui::render(&FastMetric { label: "fast" })),
+                super::ui::put(slots::hero_metrics, &FastMetric { label: "fast" }),
                 slots::notice.text("typed"),
             )
         }

examples/techdemo/src/main.rs

@@ -269,13 +269,13 @@ async fn interact(
 // req: push/001 req: push/003 req: examples/001
 async fn events(Query(params): Query<BTreeMap<String, String>>) -> impl IntoResponse {
     if params.contains_key("once") {
-        let effect = slots::live_feed.html(ui::render(&LiveFeed { tick: 1 }));
+        let effect = ui::put(slots::live_feed, &LiveFeed { tick: 1 });
         return sse(stream::iter([Ok::<_, Infallible>(effect.into_batch(ui::BUILD_FINGERPRINT))]).boxed());
     }
 
     let batches = stream::unfold(1_u64, |tick| async move {
         tokio::time::sleep(Duration::from_secs(4)).await;
-        let effect = slots::live_feed.html(ui::render(&LiveFeed { tick }));
+        let effect = ui::put(slots::live_feed, &LiveFeed { tick });
         Some((Ok::<_, Infallible>(effect.into_batch(ui::BUILD_FINGERPRINT)), tick + 1))
     })
     .boxed();
@@ -384,10 +384,10 @@ fn registry(shared: Arc<Shared>) -> impl DispatchRegistry {
                 let mut demo = shared.demo.lock().unwrap();
                 demo.log("Simulated push event produced the same EffectBatch shape");
                 (
-                    slots::live_feed.html(ui::render(&LiveFeed {
+                    ui::put(slots::live_feed, &LiveFeed {
                         tick: demo.activity.len() as u64,
-                    })),
-                    slots::activity.html(ui::render(&activity_view(&demo))),
+                    }),
+                    ui::put(slots::activity, &activity_view(&demo)),
                     slots::notice.text("Push simulated · no client app code"),
                     slhx::event("slhx:island-orbit", island_snapshot(&demo)),
                 )
@@ -414,10 +414,10 @@ fn update_work(demo: &mut DemoState, id: Option<u64>, update: impl FnOnce(&mut W
 
 fn demo_effects(demo: &DemoState, notice: &'static str) -> impl IntoEffect {
     (
-        slots::hero_metrics.html(ui::render(&hero_view(demo))),
-        slots::board.html(ui::render(&board_view(demo))),
-        slots::activity.html(ui::render(&activity_view(demo))),
-        slots::inspector.html(ui::render(&inspector_view(demo))),
+        ui::put(slots::hero_metrics, &hero_view(demo)),
+        ui::put(slots::board, &board_view(demo)),
+        ui::put(slots::activity, &activity_view(demo)),
+        ui::put(slots::inspector, &inspector_view(demo)),
         slots::notice.text(notice),
         forms::launch_work.clear("title"),
         slhx::event("slhx:island-orbit", island_snapshot(demo)),

examples/v0/src/lib.rs

@@ -121,9 +121,9 @@ mod tests {
     fn page_swap_updates_content_and_history() {
         fn load_docs() -> impl IntoEffect {
             (
-                page_swap::slots::content.html(page_swap::render(&DocsContent {
+                page_swap::put(page_swap::slots::content, &DocsContent {
                     message: "This page was swapped.",
-                })),
+                }),
                 page_swap::slots::title.text("Docs"),
                 push("/docs"),
             )

examples/v0/src/main.rs

@@ -145,7 +145,7 @@ fn registry(state: Arc<ExampleState>) -> impl DispatchRegistry {
                     todos.push(Todo { id, title: title.into() });
                 }
                 (
-                    todo_slots::todo_list.html(ui::render(&todos_view(&todos))),
+                    todos::put(todo_slots::todo_list, &todos_view(&todos)),
                     todo_forms::new_todo.clear("title"),
                 )
             }
@@ -172,9 +172,9 @@ fn registry(state: Arc<ExampleState>) -> impl DispatchRegistry {
         .on(page_handles::load_docs, |_| {
             // req: page_swap/002, req: examples/001
             (
-                page_slots::content.html(ui::render(&DocsContent {
+                page_swap::put(page_slots::content, &DocsContent {
                     message: "This content came from an EffectBatch.",
-                })),
+                }),
                 page_slots::title.text("Docs"),
                 push("/docs"),
             )