Tokens

Tokens are the public theming surface. They should make the library feel easy to restyle without requiring users to understand every component implementation detail.

Public Surface

Tokens exposed as the public theming API, kept small and semantic.

Internal Tokens

Component-local tokens allowed when they reduce duplication or make component code clearer.

Theme Contract

What a theme must override to restyle the library without touching components.

Component Mapping

How components map global tokens to local aliases for a clear theme and variant contract.

Non-Goals

Decisions deliberately excluded from the token surface to keep it small.