From a955b75204bf7e8ddf9429da6a9155cf5765c8c4 Mon Sep 17 00:00:00 2001 From: Claude Date: Sun, 6 Sep 2026 08:12:52 +0000 Subject: [PATCH] docs(ui): react-pages html-tier names are verbatim, not kebab-case The html-tier spelling paragraph in react-pages.mdx told authors that registered block names are "lowercase and kebab-case", but four registered names (record:line_items, record:quick_actions, record:reference_rail, record:related_list) are snake_case after their namespace prefix. The sdui-parser whitelist is an exact Set.has comparison with no case folding or separator normalisation, so a kebab-case respelling of one of those names (record:related-list) is rejected at save time exactly like a PascalCase borrow. Drop the "lowercase and kebab-case" gloss, let the verbatim rule stand on its own, and add a second snake_case example (record:line_items) plus a concrete negative example so the shape is demonstrated rather than described. Co-Authored-By: Claude Fable 5.1 Claude-Session: https://claude.ai/code/session_01Vbw3RPgdtqesx4azk9SbW8 --- content/docs/ui/react-pages.mdx | 9 ++++++--- 1 file changed, 6 insertions(+), 3 deletions(-) diff --git a/content/docs/ui/react-pages.mdx b/content/docs/ui/react-pages.mdx index 69e29b8c27..42e6d7ace0 100644 --- a/content/docs/ui/react-pages.mdx +++ b/content/docs/ui/react-pages.mdx @@ -31,9 +31,12 @@ tags in the public block manifest are accepted, props are checked against each b declared inputs, and an unknown tag is a hard error at save time. That is the tier for author- or AI-generated pages you have not reviewed. -Those tags are the **registered type names, written verbatim** — lowercase and -kebab-case, keeping the namespace prefix where a block has one: ``, -``, ``, ``, ``. The **PascalCase** +Those tags are the **registered type names, written verbatim** — whatever the registry +spells, character for character, including a `record:` / `page:` / `element:` / +`action:` namespace prefix and any underscore inside the name: ``, +``, ``, ``, ``, +``. A name re-spelled to look uniform is not registered: `` +is rejected at save time, only `` exists. The **PascalCase** spellings further down this page (``, ``, ``) are the **react tier's** convention and are not registered names, so an html page that borrows one is rejected at save time with ` is not an allowed component`.