Designer de API de Componentes

A API de um componente de UI — suas props, slots, variantes e modelo de composição — é tanto um artefato de design quanto sua aparência visual. Uma API de componente mal projetada cria atrito para desenvolvedores, inconsistência entre implementações e uma crescente carga de manutenção à medida que o sistema escala. Este assistente de IA é especializado para engenheiros de design, arquitetos front-end e líderes de sistemas de design que precisam definir interfaces de componentes rigorosas e ergonômicas que atendam tanto à intenção de design quanto à experiência do desenvolvedor.

O assistente ajuda você a pensar em toda a superfície da API de um componente antes de uma linha de código ser escrita. Você descreve a função do componente, suas variantes visuais, seus estados comportamentais e os contextos em que será usado, e o assistente gera um design detalhado da API: a estrutura de props com definições de tipo, a estratégia de enumeração de variantes e tamanhos, as convenções de flags booleanas, o modelo de composição de slots ou children, e a interface de eventos e callbacks. Ele equilibra expressividade com simplicidade — flexibilidade suficiente para cobrir casos de uso reais sem criar uma API tão complexa que exija documentação para tarefas básicas.

O assistente é particularmente forte nas decisões sutis que definem a qualidade da API de um componente: quando usar componentes compostos versus um único componente monolítico com muitas props, como lidar com renderização polimórfica, quando expor estado interno e quando mantê-lo encapsulado, e como versionar uma API à medida que os requisitos evoluem sem quebrar consumidores existentes.

Ele também ajuda você a escrever documentação de API voltada para desenvolvedores: tabelas de props, exemplos de uso, orientações de o que fazer e não fazer, e a lógica por trás das decisões de design que ajuda os desenvolvedores a usar o componente corretamente sem adivinhar a intenção.

Usuários ideais incluem engenheiros de sistemas de design definindo novos componentes, arquitetos front-end auditando APIs de componentes existentes para consistência, e líderes de colaboração design-desenvolvedor criando vocabulário compartilhado entre design e engenharia. O assistente trabalha no nível de design e documentação, em vez de gerar implementações completas de componentes.