Field Notes
Composition

Worked Examples

Real-world scenarios showing how to apply the dimensional model.

Example 1: API Key Expiry Banner

A user's API key is expiring. The banner needs to communicate this clearly without over-alarming when the deadline is distant.

3 days remaining

The situation is not yet urgent. The container provides visibility, the action carries the caution.

<banner sentiment="neutral" emphasis="high">
  <text>Your API key expires in 3 days</text>
  <button sentiment="warning" emphasis="medium">
    Renew Key
  </button>
</banner>
ComponentSentimentEmphasisReasoning
BannerneutralhighStrong presence without alarm — user can still proceed
ButtonwarningmediumAction carries the caution — renewal resolves a future risk

Expires today

The situation is now imminent. Both container and action escalate.

<banner sentiment="warning" emphasis="high">
  <text>Your API key expires today</text>
  <button sentiment="warning" emphasis="high">
    Renew Key Now
  </button>
</banner>
ComponentSentimentEmphasisReasoning
BannerwarninghighContainer itself signals urgency
ButtonwarninghighBoth demand immediate attention

Example 2: Data Table Actions

A data table row has edit and delete actions. These serve categorically different purposes.

Spacing

[ Edit ]  --size-4--  [ Duplicate ]        --size-32--        [ Delete ]
   ↑ tight: related constructive actions        ↑ loose: destructive, separated

Dimensional assignment

ComponentSentimentEmphasisSize
Edit buttonneutralmediumsmall
Duplicate buttonneutrallowsmall
Delete buttonwarninglowsmall

All buttons use size="sm" because they're in a data table (compact layout). The delete button uses warning sentiment but low emphasis — it's available but not screaming at the user.

Example 3: Feature Announcement Card

A new feature is being promoted on the dashboard.

<card sentiment="new" emphasis="high" size="md">
  <badge sentiment="new" emphasis="high">New</badge>
  <heading>Analytics Dashboard</heading>
  <text>Track your usage patterns with real-time charts.</text>
  <button sentiment="highlight" emphasis="medium">
    Try it out
  </button>
</card>

The card uses new sentiment (recently added) and the action button uses highlight (recommended action).

Applying the Checklist

For any composition, walk through:

  1. What does this communicate? → Assign sentiment
  2. How urgently? → Assign emphasis
  3. Semantically coherent? → Validate the combination
  4. What scale? → Assign size
  5. Spacing tier? → Apply tight/medium/loose
  6. Coherent hierarchy? → Check the postmodern balance

On this page