Mercurial

view design_system/wiki/README.md @ 258:60a876c4587a

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
[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 source

# 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.