# Component contract

## Purpose

Describe the user need this component serves and when a different pattern is more appropriate.

## Anatomy

- Required regions
- Optional regions
- Content limits

## API and states

- Variants and props
- Default, hover, focus, active, disabled, loading, and error states
- Empty and long-content behavior

## Responsive behavior

Document what reflows, wraps, truncates, or changes priority at each meaningful constraint.

## Accessibility

- Semantic element and accessible name
- Keyboard interaction
- Focus order and visible focus
- Screen-reader announcements
- Contrast and motion behavior

## Proof

Link the production component, Storybook stories, interaction tests, and relevant design frames.