docs(ui): define component contracts and consolidation roadmap