This wiki is the source of truth for future HTML and component work.

Pages

• HTML authoring: native-underneath markup and ownership.
• Primitive map: which primitive owns each native control.
• Tokens and sizing: reference, semantic, local, theme, density, and xs-xl contracts.
• Review checklist: 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.