Mercurial
diff design_system/wiki/README.md @ 258:60a876c4587a
[ui] Add semantic primitive ownership
Build a layered Zenbu token and sizing system, make authored controls use native-underneath primitives, migrate mrjunejune without imposing visual surfaces, and document/enforce HTML ownership in the catalog and wiki.
Co-authored-by: Copilot <[email protected]>
| author | MrJuneJune <me@mrjunejune.com> |
|---|---|
| date | Wed, 05 Aug 2026 05:25:40 -0700 |
| parents | |
| children |
line wrap: on
line diff
--- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/design_system/wiki/README.md Wed Aug 05 05:25:40 2026 -0700 @@ -0,0 +1,23 @@ +# Zenbu UI wiki + +This wiki is the source of truth for future HTML and component work. + +## Pages + +- [HTML authoring](HTML_AUTHORING.md): native-underneath markup and ownership. +- [Primitive map](PRIMITIVE_MAP.md): which primitive owns each native control. +- [Tokens and sizing](TOKENS_AND_SIZING.md): reference, semantic, local, theme, + density, and xs-xl contracts. +- [Review checklist](REVIEW_CHECKLIST.md): required searches, tests, and + accessibility checks. + +## Core rules + +1. Keep browser semantics. A Zenbu control contains the appropriate native + element rather than replacing it. +2. Give every authored interactive control one owning primitive. +3. Use `appearance="plain"` when only behavior and scale are shared. +4. Consume `--zenbu-sys-*` intent in application/component CSS. +5. Use reference values only while defining semantic mappings. +6. Keep business state and workflows outside the design system. +7. Add catalog and browser evidence for every public primitive.