Component API Design

Use when designing, splitting, promoting, or reviewing reusable UI components, view/section/block components, hooks, widgets, controls, SDK helpers, or other caller-facing component APIs.

Read

The core below is the required contract. Open references/current-guidance.md only for an unresolved in-scope question:

• ## API Shape for full prefer/avoid lists.
• ## Lifecycle-Contract Merge Gate before merging look-alike components.
• ## Controlled State for controlled vs uncontrolled precedence.
• ## View And Block Components for split triggers, promotion.
• ## Product Boundary, ## Naming, ## Examples And States: edge cases.
• SOLID/Interface Segregation: solid-design-principles skill.

Must