docs(examples): mark page shell html boundaries

Document that remaining SafeHtml use in examples is limited to full-page shell composition of already-rendered hemplate fragments, while effect payloads use render helpers.

req: html_safety/002

req: view/001
This commit is contained in:
slhx agent
2026-05-26 01:34:05 +02:00
parent 5972785c3c
commit e20d356c1d
4 changed files with 6 additions and 1 deletions
+1 -1
View File
@@ -558,7 +558,7 @@ what a valid business email is.
001 Raw HTML insertion requires an explicit safe HTML type (`SafeHtml` or equivalent). Plain `String` renders as escaped text unless explicitly wrapped.
### req: html/002
002 Hemplate-rendered output may be converted to `SafeHtml` by trusted render APIs. User input is never `SafeHtml` by default.
002 Hemplate-rendered output may be converted to `SafeHtml` by trusted render APIs. User input is never `SafeHtml` by default. Full-page shell composition may pass already-rendered hemplate fragments through explicit `SafeHtml` fields; handlers should prefer slot/resource render helpers for effect payloads.
### req: html/003
003 Slot render commands distinguish text payloads from HTML payloads at the type level.