docs

Author: linkdata

ui/README.md

@@ -112,3 +112,13 @@ func (w *UList) JawsUpdate(e *jaws.Element) {
   w.UpdateContainer(e)
 }
 ```
+
+## Container error behavior
+
+`ContainerHelper` treats child render/update failures as application bugs.
+
+- During initial render, child render failures are returned as errors.
+- During updates, append render failures are reported through `MustLog` (and
+  may panic if no logger is configured).
+- After such failures, partial DOM/request state updates are expected; state may
+  remain inconsistent until a subsequent full render/reload.

ui/containerhelper.go

@@ -17,6 +17,13 @@ import (
 //
 // A ContainerHelper belongs to a widget instance and is intended for render-scoped
 // widget lifetimes (for example widgets created via RequestWriter helper methods).
+//
+// Error model:
+// Child render/update failures are treated as application bugs. Initial-render
+// errors are returned to the caller, and update-time append render errors are
+// reported through MustLog (which may panic when no logger is configured).
+// After such failures, DOM and request-tracked element state may be partially
+// updated and therefore inconsistent until the next full render/reload.
 type ContainerHelper struct {
 	Container core.Container
 	Tag       any