@govbr-ds/webcomponents 2.4.0 → 2.6.0

package/cem/webcomponents.html-custom-data.json

@@ -4,7 +4,7 @@
   "tags": [
     {
       "name": "br-avatar",
-      "description": "O componente `br-avatar` é a representação visual compacta de um usuário, pessoa ou entidade no GovBR-DS. Ele exibe fotos de perfil, ícones institucionais ou iniciais textuais com suporte a múltiplos tamanhos, temas e indicador de status contextual.\n\n### Para que serve\n\n- **Identificação visual de perfil:** Exibe a foto do usuário logado em barras de cabeçalho, cartões de perfil, listas de contatos ou comentários.\n- **Resiliência e fallback visual:** Caso a imagem informada falhe ao carregar (`src`), o componente passa suavemente para o ícone padrão ou texto alternativo sem quebrar o leiaute.\n- **Indicador de status integrado:** Informa estados operacionais (online, offline, ocupado, ausente) através do slot dedicado `status`.\n- **Acessibilidade:** Garante descrição textual adequada através da propriedade `alt`, essencial para pessoas que utilizam leitores de tela.\n\n### Quando utilizar\n\n- **Utilize quando:**\n  - For necessário identificar a pessoa autenticada no cabeçalho ou menu da aplicação.\n  - Exibir listas de contatos, autores de publicações, membros de equipe ou participantes de um fluxo colaborativo.\n  - Indicar o status de disponibilidade de um usuário ou atendente no sistema.\n- **Evite e prefira outro componente quando:**\n  - For necessária uma exibição de imagem ilustrativa ampla ou promocional (prefira tags HTML `<img>` semânticas ou contêineres ilustrativos do design).\n  - O elemento requerer interações ricas com múltiplas ações (prefira compor com `br-card`).\n\n### Estrutura e Slots\n\nO `br-avatar` é um componente autônomo e direto:\n- `default`: Conteúdo interno livre (quando não for utilizada imagem via prop `src`), permitindo inserir ícones como `br-icon` ou texto de iniciais.\n- `status`: Slot posicionado para inserção de um indicador visual de status sobreposto ao avatar.\n\nPara a documentação completa de design, incluindo diretrizes de acessibilidade e especificações visuais, consulte o [Design System do GovBR](https://www.gov.br/ds/components/avatar?tab=designer).\n---\n\n\n### **Methods:**\n - **handleDensityChange(newValue: _AvatarDensity_)** - Observa mudanças na propriedade density para validação e sincronização com atributo DOM.\nGarante que apenas valores válidos sejam aceitos e atualiza o atributo no elemento host.\n- **setFocus()** - Move o foco programaticamente para o avatar.\n\n### **Slots:**\n - **status** - Conteúdo customizado para o indicador de status. Quando usado, substitui a tag padrão.\n\n### **CSS Parts:**\n - **container** - Elemento externo do avatar.\n- **content** - Conteúdo interno do avatar (imagem, ícone ou texto).\n- **status** - Indicador de status posicionado sobre o avatar.",
+      "description": "O `br-avatar` representa uma pessoa ou entidade de forma compacta: mostra uma foto, a primeira letra de um nome ou um ícone de usuário.\n\n### Como o conteúdo é escolhido\n\n1. Com `iconic`, mostra sempre o ícone de usuário.\n2. Com `text`, mostra a primeira letra do texto em maiúscula.\n3. Com `src`, mostra a imagem. Se ela não carregar, mostra o ícone.\n4. Sem nenhum deles, mostra o ícone.\n\n```html\n<br-avatar src=\"/fotos/maria.jpg\" alt=\"Foto de Maria Souza\"></br-avatar>\n<br-avatar text=\"Maria\"></br-avatar>\n<br-avatar iconic></br-avatar>\n```\n\nPara indicar disponibilidade, ative `status`. A cor fica em `status-bg-color` e o texto lido pelo leitor de tela, em `status-label`. Para outro indicador, use o slot `status`.\n\n### Quando usar\n\n- Identificar a pessoa autenticada no cabeçalho ou no menu.\n- Mostrar autores, contatos ou participantes em listas.\n\n### Quando evitar\n\n- Imagens grandes ou ilustrativas: use `<img>`.\n\nConsulte as [diretrizes de design do GovBR](https://www.gov.br/ds/components/avatar?tab=designer).\n---\n\n\n### **Methods:**\n - **handleDensityChange(newValue: _AvatarDensity_)** - Observa mudanças na propriedade density para validação e sincronização com atributo DOM.\nGarante que apenas valores válidos sejam aceitos e atualiza o atributo no elemento host.\n- **setFocus()** - Move o foco programaticamente para o avatar.\n\n### **Slots:**\n - **status** - Conteúdo customizado para o indicador de status. Quando usado, substitui a tag padrão.\n\n### **CSS Parts:**\n - **container** - Elemento externo do avatar.\n- **content** - Conteúdo interno do avatar (imagem, ícone ou texto).\n- **status** - Indicador de status posicionado sobre o avatar.",
       "attributes": [
         {
           "name": "density",
@@ -81,7 +81,7 @@
     },
     {
       "name": "br-breadcrumb",
-      "description": "O componente `br-breadcrumb` é o controle de navegação estrutural do GovBR-DS, desenvolvido para exibir o caminho hierárquico até a página atual e permitir que a pessoa usuária retorne facilmente a níveis anteriores da aplicação.\n\n### Para que serve\n\n- **Localização contextual:** Informa em qual nível da arquitetura de informação o usuário se encontra dentro do portal ou sistema.\n- **Navegação de retorno:** Oferece atalhos diretos para páginas ancestrais sem a necessidade de recorrer repetidamente ao botão \"Voltar\" do navegador.\n- **Acessibilidade estruturada WAI-ARIA:** Utiliza a semântica nativa de `<nav aria-label=\"Breadcrumb\">`, identifica a página atual com `aria-current=\"page\"` e gera separadores visuais acessíveis.\n\n### Quando utilizar\n\n- **Utilize quando:**\n  - A aplicação possuir estrutura hierárquica com dois ou mais níveis de profundidade (ex.: Início > Serviços > Cidadão > Solicitar documento).\n- **Evite e prefira outro componente quando:**\n  - A aplicação possuir navegação plana (flat) de nível único sem hierarquia.\n  - O fluxo for linear com etapas progressivas de um formulário (prefira `br-step` ou `br-wizard`).\n\n### Composição e Subcomponentes\n\nO ecossistema do Breadcrumb é composto pelo orquestrador e seus itens:\n\n| Subcomponente | Papel | Regra de uso |\n| --- | --- | --- |\n| `br-breadcrumb` | **Orquestrador principal.** Gerencia a trilha de navegação, insere separadores visuais e controla acessibilidade. | Deve ser o contêiner raiz declarado no template da página. |\n| `br-breadcrumb-item` | **Item declarativo canônico.** Representa cada nível do caminho hierárquico. | Declarado dentro do slot padrão do `br-breadcrumb`. |\n| `br-crumb` | **Item legado de compatibilidade.** Equivalente ao `br-breadcrumb-item`. | Mantido para compatibilidade; prefira `br-breadcrumb-item` em novos códigos. |\n\n### Como os subcomponentes se relacionam\n\nO `br-breadcrumb` atua como container pai que monitora os itens declarados em seu slot padrão:\n1. **Identificação da página atual:** O último item da lista é automaticamente identificado como o destino atual, recebendo destaque visual e `aria-current=\"page\"` sem link ativo.\n2. **Separação visual padronizada:** O componente pai insere e padroniza os ícones separadores entre os níveis sem poluir a árvore do leitor de tela.\n\nPara a documentação completa de design, incluindo diretrizes de acessibilidade e especificações visuais, consulte o [Design System do GovBR](https://www.gov.br/ds/components/breadcrumb?tab=designer).\n---\n\n\n### **Events:**\n - **brNavigate** - Evento cancelável emitido em `navigation-mode=\"event\"` para cliques primários sem modificadores em links `_self`.\nChame `event.preventDefault()` no listener para impedir a navegação nativa e entregar `event.detail.href` ao roteador da SPA.\n\n### **Slots:**\n - **default** - Itens de breadcrumb declarados via elementos br-breadcrumb-item. O elemento br-crumb é aceito apenas por compatibilidade.\n\n### **CSS Parts:**\n - **nav** - Elemento nav do breadcrumb.\n- **list** - Lista ordenada de itens do breadcrumb.",
+      "description": "O `br-breadcrumb` mostra o caminho até a página atual e permite voltar aos níveis anteriores.\n\n### Como montar\n\n1. Declare um `br-breadcrumb-item` para cada nível, do início até a página atual.\n2. Use `home` no primeiro item para exibir o ícone de página inicial.\n3. Marque a página atual com `active`: ela aparece sem link e com `aria-current=\"page\"`.\n\n```html\n<br-breadcrumb>\n  <br-breadcrumb-item home label=\"Início\" href=\"/\"></br-breadcrumb-item>\n  <br-breadcrumb-item label=\"Serviços\" href=\"/servicos\"></br-breadcrumb-item>\n  <br-breadcrumb-item label=\"Emitir documento\" active></br-breadcrumb-item>\n</br-breadcrumb>\n```\n\nOs mesmos itens podem ser passados em `crumbs`, como array ou texto JSON. Quando falta espaço, os níveis intermediários são agrupados; `truncate-after` define a partir de quantos itens isso acontece.\n\n### Navegação em SPA\n\nCom `navigation-mode=\"event\"`, o clique em um item emite `brNavigate`. Cancele o evento e passe o endereço para o roteador:\n\n```js\nbreadcrumb.addEventListener('brNavigate', (event) => {\n  event.preventDefault();\n  router.push(event.detail.href);\n});\n```\n\n### Quando usar\n\n- Páginas com dois ou mais níveis de hierarquia.\n\n### Quando evitar\n\n- Navegação sem hierarquia.\n- Etapas de um processo: use `br-wizard` ou `br-step`.\n\nConsulte as [diretrizes de design do GovBR](https://www.gov.br/ds/components/breadcrumb?tab=designer).\n---\n\n\n### **Events:**\n - **brNavigate** - Evento cancelável emitido em `navigation-mode=\"event\"` para cliques primários sem modificadores em links `_self`.\nChame `event.preventDefault()` no listener para impedir a navegação nativa e entregar `event.detail.href` ao roteador da SPA.\n\n### **Slots:**\n - **default** - Itens de breadcrumb declarados via elementos br-breadcrumb-item. O elemento br-crumb é aceito apenas por compatibilidade.\n\n### **CSS Parts:**\n - **nav** - Elemento nav do breadcrumb.\n- **list** - Lista ordenada de itens do breadcrumb.",
       "attributes": [
         {
           "name": "custom-id",
@@ -95,7 +95,7 @@
         },
         {
           "name": "home-href",
-          "description": "URL canônica da página inicial. Quando informada, tem precedência sobre `homeUrl`.",
+          "description": "URL padrão da página inicial. Quando informada, tem precedência sobre `homeUrl`.",
           "values": []
         },
         {
@@ -118,7 +118,7 @@
     },
     {
       "name": "br-breadcrumb-item",
-      "description": "Subcomponente declarativo canônico de `br-breadcrumb`, utilizado para representar cada nível individual dentro da trilha hierárquica de navegação.\n\n### Papel na composição\n\n- Define o rótulo legível e o destino de navegação (`href`) de um nível hierárquico específico.\n- Suporta a propriedade `home` para renderizar o ícone institucional da página inicial no primeiro item da trilha.\n\n### Regra de uso e relacionamento\n\nDeve ser declarado exclusivamente dentro do slot padrão do orquestrador `br-breadcrumb`. Ele não deve ser utilizado isoladamente fora da trilha de breadcrumb. O componente pai monitora os itens para aplicar automaticamente os separadores visuais e demarcar o último item como a página atual.\n\nPara a documentação completa de design, consulte o [Design System do GovBR](https://www.gov.br/ds/components/breadcrumb?tab=designer).\n---\n\n\n### **Events:**\n - **brCrumbPropsChange** - Protocolo compatível com o listener atual do breadcrumb.\n\n### **Slots:**\n - **default** - Conteúdo alternativo do rótulo. Quando usado, substitui o texto fornecido em `label`.",
+      "description": "Representa um nível do `br-breadcrumb`. Use somente dentro dele.\n\nInforme `label` e `href`. Use `home` no primeiro item e `active` na página atual. O conteúdo do item, quando houver, substitui o texto de `label`.\n\nVeja como montar a trilha na documentação do `br-breadcrumb`.\n---\n\n\n### **Events:**\n - **brCrumbPropsChange** - Protocolo compatível com o listener atual do breadcrumb.\n\n### **Slots:**\n - **default** - Conteúdo alternativo do rótulo. Quando usado, substitui o texto fornecido em `label`.",
       "attributes": [
         { "name": "label", "description": "Rótulo do item.", "values": [] },
         { "name": "href", "description": "URL do item.", "values": [] },
@@ -142,7 +142,7 @@
     },
     {
       "name": "br-crumb",
-      "description": "@deprecated Use `br-breadcrumb-item`.\n\nSubcomponente legado de `br-breadcrumb`, mantido para compatibilidade com implementações existentes que utilizavam a nomenclatura antiga.\n\n### Papel na composição\n\n- Equivalente funcional do `br-breadcrumb-item`, representando um nível na trilha de navegação.\n\n### Regra de uso e relacionamento\n\nDeclarado dentro do slot padrão do `br-breadcrumb`. Em novos desenvolvimentos e manutenções ativas, **recomenda-se utilizar a tag canônica `br-breadcrumb-item`**.\n\nPara a documentação canônica completa, consulte a página do [br-breadcrumb](/docs/components/breadcrumb).\n---\n\n\n### **Events:**\n - **brCrumbPropsChange** - Evento disparado quando as propriedades do crumb mudam.\nO componente pai (br-breadcrumb) escuta este evento para se atualizar.\n\n### **Slots:**\n - **default** - Conteúdo alternativo do rótulo do item de navegação.",
+      "description": "@deprecated Use `br-breadcrumb-item`.\n\nNome antigo do `br-breadcrumb-item`, mantido para compatibilidade. Funciona da mesma forma; em código novo, use `br-breadcrumb-item`.\n---\n\n\n### **Events:**\n - **brCrumbPropsChange** - Evento disparado quando as propriedades do crumb mudam.\nO componente pai (br-breadcrumb) escuta este evento para se atualizar.\n\n### **Slots:**\n - **default** - Conteúdo alternativo do rótulo do item de navegação.",
       "attributes": [
         {
           "name": "label",
@@ -174,7 +174,7 @@
     },
     {
       "name": "br-button",
-      "description": "O componente `br-button` é o controle fundamental de ação e acionamento do GovBR-DS. Desenvolvido para permitir que pessoas usuárias executem comandos, confirmem intenções e submetam ou redefinam formulários, ele oferece retorno visual imediato e conformidade com diretrizes de acessibilidade WAI-ARIA.\n\n### Para que serve\n\n- **Disparo de ações do sistema:** Executa comandos locais ou assíncronos na interface (ex.: salvar dados, abrir modais, aplicar filtros).\n- **Integração com formulários:** Suporta os tipos nativos de botão (`type=\"button\"`, `type=\"submit\"` e `type=\"reset\"`), integrando-se ao ciclo de submissão do formulário HTML.\n- **Variantes e hierarquia visual:** Oferece diferentes estilos visuais (primário, secundário), densidades e opções de exibição (com ícone, somente ícone, circular e em bloco).\n- **Feedback de carregamento e estado:** Informa estados de processamento com o modo `loading` e desativação acessível com `disabled`.\n\n### Quando utilizar\n\n- **Utilize quando:**\n  - A pessoa usuária precisar executar uma ação imediata ou submeter dados dentro do fluxo atual da página.\n  - For necessário acionar componentes flutuantes (como abrir `br-modal`, alternar `br-collapse` ou expandir `br-dropdown`).\n- **Evite e prefira outro componente quando:**\n  - A ação tiver como objetivo navegar para outra página ou alterar a URL do navegador (prefira `br-link` ou um elemento `<a>` nativo).\n  - O controle representar uma escolha de valor fixo entre poucas opções mutuamente exclusivas (prefira `br-radio` ou `br-radio-group`).\n\n### Estrutura e Slots\n\nO `br-button` é um controle direto e autônomo:\n- `default`: Slot para inserção do texto do rótulo, ícones de apoio (`br-icon`) ou composições personalizadas.\n\nPara a documentação completa de design, incluindo diretrizes de acessibilidade e especificações visuais, consulte o [Design System do GovBR](https://www.gov.br/ds/components/button?tab=designer).\n---\n\n\n### **Slots:**\n - **default** - Slot para o rótulo ou conteúdo do botão.\n\n### **CSS Parts:**\n - **button** - Parte para o elemento button interno, usada para estilos customizados via ::part(button).",
+      "description": "O `br-button` executa uma ação: salvar, enviar um formulário, abrir um modal, aplicar um filtro.\n\nO texto e o ícone vão dentro do botão. A aparência é definida por `emphasis` (`primary`, `secondary` ou `tertiary`) e `shape` (`circle`, `block` ou `pill`).\n\n```html\n<br-button emphasis=\"primary\" type=\"submit\">Enviar</br-button>\n\n<br-button shape=\"circle\" aria-label=\"Fechar\">\n  <br-icon src=\"/icones/fechar.svg\"></br-icon>\n</br-button>\n```\n\nO tipo padrão é `button`. Use `type=\"submit\"` ou `type=\"reset\"` para agir sobre o formulário em que o botão está. Durante uma operação demorada, ative `loading`.\n\n### Quando usar\n\n- Executar uma ação na página atual.\n- Abrir modal, menu ou painel.\n\n### Quando evitar\n\n- Para ir a outra página: use `br-link` ou `<a>`.\n- Para escolher entre opções: use `br-radio` ou `br-checkbox`.\n\nConsulte as [diretrizes de design do GovBR](https://www.gov.br/ds/components/button?tab=designer).\n---\n\n\n### **Slots:**\n - **default** - Slot para o rótulo ou conteúdo do botão.\n\n### **CSS Parts:**\n - **button** - Parte para o elemento button interno, usada para estilos customizados via ::part(button).",
       "attributes": [
         {
           "name": "color-mode",
@@ -208,7 +208,7 @@
         },
         {
           "name": "active",
-          "description": "Estado ativo canônico. Quando informado, tem precedência sobre `isActive`.",
+          "description": "Estado ativo atual. Quando informado, tem precedência sobre `isActive`.",
           "values": []
         },
         {
@@ -218,7 +218,7 @@
         },
         {
           "name": "loading",
-          "description": "Estado de carregamento canônico. Quando informado, tem precedência sobre `isLoading`.",
+          "description": "Estado de carregamento atual. Quando informado, tem precedência sobre `isLoading`.",
           "values": []
         },
         {
@@ -271,7 +271,7 @@
     },
     {
       "name": "br-card",
-      "description": "O componente `br-card` é um contêiner estruturado e flexível do GovBR-DS, projetado para agrupar informações, mídias e ações correlacionadas em uma superfície visual coesa e destacada.\n\n### Para que serve\n\n- **Agrupamento de informações modulares:** Organiza conteúdos heterogêneos de um mesmo assunto (como resumos de serviços, cartões de notícias, painéis de métricas ou resultados de busca).\n- **Segmentação visual limpa:** Proporciona hierarquia e legibilidade através de bordas, elevações e espaçamentos padronizados pelos tokens do design system.\n- **Suporte a interação opcional:** Pode atuar como elemento estático de leitura ou como contêiner interativo/navegável.\n\n### Quando utilizar\n\n- **Utilize quando:**\n  - Desejar exibir blocos independentes de conteúdo em grades (grid) ou listas de cartões.\n  - O conteúdo for composto por uma combinação de elementos (imagem/vídeo, cabeçalho, texto explicativo e botões de ação).\n- **Evite e prefira outro componente quando:**\n  - Os dados forem puramente tabulares ou comparativos entre múltiplos itens homogêneos (prefira `br-table`).\n  - Houver apenas uma sequência linear simples de textos ou links (prefira `br-list`).\n\n### Estrutura e Slots\n\nO `br-card` oferece estrutura modular com slots nomeados ou composição livre:\n- `media`: Slot superior para exibição de imagens, ilustrações ou mídia de destaque.\n- `header`: Slot para título, subtítulo ou cabeçalho informativo do card.\n- `content`: Slot principal para o corpo de texto e conteúdo descritivo.\n- `footer`: Slot inferior para botões de ação (`br-button`), links complementares ou metadados.\n- `default`: Slot livre para renderização direta quando não for necessária a divisão pré-definida em seções.\n\nPara a documentação completa de design, incluindo diretrizes de acessibilidade e especificações visuais, consulte o [Design System do GovBR](https://www.gov.br/ds/components/card?tab=designer).\n---\n\n\n### **Slots:**\n - **default** - Slot para conteúdo livre do card, quando não usar a estrutura de slots nomeados.\n- **media** - Slot para conteúdo de mídia exibido antes do cabeçalho.\n- **header** - Slot para o conteúdo do cabeçalho do card.\n- **content** - Slot para o corpo principal do card ao usar a estrutura de slots.\n- **footer** - Slot para o conteúdo do rodapé do card.\n\n### **CSS Parts:**\n - **wrapper** - Área principal do card.\n- **media** - Área de mídia do card.\n- **header** - Área do cabeçalho.\n- **content** - Área do conteúdo principal.\n- **footer** - Área do rodapé.",
+      "description": "O `br-card` agrupa conteúdos sobre um mesmo assunto em um bloco destacado, como um serviço, uma notícia ou um resultado de busca.\n\nOrganize o conteúdo nos slots `media`, `header`, `content` e `footer`, ou coloque tudo no slot padrão.\n\n```html\n<br-card>\n  <img slot=\"media\" src=\"/imagens/servico.jpg\" alt=\"\" />\n  <h3 slot=\"header\">Carteira de Trabalho Digital</h3>\n  <p slot=\"content\">Consulte seus vínculos de emprego.</p>\n  <br-button slot=\"footer\" emphasis=\"secondary\">Acessar</br-button>\n</br-card>\n```\n\nUse `interactive` quando o card inteiro for clicável, para dar o retorno visual ao passar o mouse.\n\n### Quando usar\n\n- Blocos independentes exibidos em grade ou lista.\n- Conteúdo que combina imagem, título, texto e ações.\n\n### Quando evitar\n\n- Dados para comparar em linhas e colunas: use `br-table`.\n- Uma lista simples de textos ou links: use `br-list`.\n\nConsulte as [diretrizes de design do GovBR](https://www.gov.br/ds/components/card?tab=designer).\n---\n\n\n### **Slots:**\n - **default** - Slot para conteúdo livre do card, quando não usar a estrutura de slots nomeados.\n- **media** - Slot para conteúdo de mídia exibido antes do cabeçalho.\n- **header** - Slot para o conteúdo do cabeçalho do card.\n- **content** - Slot para o corpo principal do card ao usar a estrutura de slots.\n- **footer** - Slot para o conteúdo do rodapé do card.\n\n### **CSS Parts:**\n - **wrapper** - Área principal do card.\n- **media** - Área de mídia do card.\n- **header** - Área do cabeçalho.\n- **content** - Área do conteúdo principal.\n- **footer** - Área do rodapé.",
       "attributes": [
         {
           "name": "custom-id",
@@ -298,7 +298,7 @@
     },
     {
       "name": "br-carousel",
-      "description": "O componente `br-carousel` é o contêiner de apresentação rotativa e sequencial de conteúdos do GovBR-DS, desenvolvido para exibir múltiplos slides em um espaço delimitado onde apenas um item (ou grupo ativo) fica em foco por vez.\n\n### Para que serve\n\n- **Apresentação rotativa de destaque:** Ideal para galerias visuais, banners informativos, campanhas institucionais e passos ilustrativos.\n- **Navegação assistida:** Fornece controles de avanço e retrocesso (setas), barra de indicadores de página/slides (bolinhas de paginação) e suporte a gestos de toque (swipe) em dispositivos móveis.\n- **Reprodução automática controlável:** Suporta transição automática temporizada com botão obrigatório de pausa/reprodução para conformidade com diretrizes de acessibilidade (WCAG).\n\n### Quando utilizar\n\n- **Utilize quando:**\n  - Houver um conjunto de imagens, avisos ou destaques que compartilham o mesmo nível de relevância visual.\n  - O espaço vertical da página for restrito e comportar a rotação sequencial de conteúdos.\n- **Evite e prefira outro componente quando:**\n  - Todas as informações forem cruciais para a tarefa do usuário e precisarem ficar simultaneamente visíveis (prefira uma grade com `br-card`).\n  - O fluxo representar preenchimento obrigatório de formulário por etapas (prefira `br-wizard` ou `br-step`).\n\n### Composição e Subcomponentes\n\nO ecossistema do Carousel é composto por:\n\n| Subcomponente | Papel | Regra de uso |\n| --- | --- | --- |\n| `br-carousel` | **Orquestrador principal.** Gerencia a rotação, temporizador, botões de paginação, navegação por teclado e gestos. | Contêiner raiz obrigatório declarado na página. |\n| `br-carousel-page` | **Slide individual.** Encapsula o conteúdo visual ou textual de cada página do carrossel. | Declarado dentro do slot padrão do `br-carousel`. |\n\n### Como os subcomponentes se relacionam\n\nO `br-carousel` projeta internamente os controles de navegação e gerencia os elementos `br-carousel-page` declarados em seu interior:\n1. O componente pai monitora os slides filhos, calcula o total de páginas e gera dinamicamente os botões indicadores.\n2. Apenas a página correspondente ao índice ativo é exibida e anunciada para leitores de tela com atributos `aria-roledescription=\"slide\"`.\n\nPara a documentação completa de design, incluindo diretrizes de acessibilidade e especificações visuais, consulte o [Design System do GovBR](https://www.gov.br/ds/components/carousel?tab=designer).\n---\n\n\n### **Events:**\n - **brDidPageChange** - Emitido quando o slide ativo muda.\nDisparado por clique nos botões de navegação, clique no indicador de step,\ngesto swipe (apenas em mobile, breakpoint < 576px) ou avanço automático.\n`activePage` é 1-based: o primeiro slide emite `1`, o segundo `2`, e assim por diante.\n- **brCarouselPageChange** - Evento canônico emitido quando o slide ativo muda.\n- **brDidAutoPlayStart** - Emitido quando a reprodução automática é iniciada ou retomada.\n- **brCarouselAutoplayStart** - Evento canônico emitido quando a reprodução automática começa.\n- **brDidAutoPlayPause** - Emitido quando a reprodução automática é pausada.\n- **brCarouselAutoplayPause** - Evento canônico emitido quando a reprodução automática é pausada.\n\n### **Methods:**\n - **onTablistKeydown(e: _KeyboardEvent_)** - Navegação por teclado para o modo tablist (`indicatorType=\"simple\"`).\n\nO W3C APG Carousel Pattern especifica que, quando os controles de seleção de slide\nsão implementados como tabs, a interação de teclado segue o\nhttps://www.w3.org/WAI/ARIA/apg/patterns/tabs/ Tabs Pattern (W3C APG).\nEsse padrão define o comportamento de roving tabindex com as teclas:\n- `ArrowLeft` / `ArrowRight` (ou `ArrowUp` / `ArrowDown`): move o foco entre as tabs.\n- `Home`: move o foco para a primeira tab.\n- `End`: move o foco para a última tab.\n\nO handler está no `br-carousel` (e não no `br-step`) porque a lógica de\n`effectiveCircular` é uma responsabilidade do carrossel, mantendo uma única\nfonte de verdade para a navegação circular.\n\nO evento `keydown` é composto (`composed: true`), portanto borbulha através do\nshadow DOM do `br-step-item` até o host do `br-carousel`.\n- **nextPage(): _Promise<void>_** - Avança para o próximo slide. Respeita a prop `isCircular` (ou ativo automaticamente com `autoPlay`).\n- **previousPage(): _Promise<void>_** - Retorna ao slide anterior. Respeita a prop `isCircular` (ou ativo automaticamente com `autoPlay`).\n- **goToPage(index: _number_): _Promise<void>_** - Navega para o slide de número `index` (1 = primeiro slide, 2 = segundo, …).\nValores fora do intervalo válido são ignorados.\n- **getActivePage(): _Promise<number>_** - Retorna o número do slide atualmente ativo (1 = primeiro slide, 2 = segundo, …).\n- **play(): _Promise<void>_** - Inicia ou retoma a reprodução automática programaticamente.\n- **pause(): _Promise<void>_** - Pausa a reprodução automática programaticamente.\n- **getIsPlaying(): _Promise<boolean>_** - Retorna `true` se a reprodução automática está ativa no momento.\n\n### **Slots:**\n - **default** - Slot para os slides do carrossel. Aceita exclusivamente elementos `br-carousel-page`.\n\n### **CSS Parts:**\n - **container** - Elemento raiz do carrossel. Recebe `role=\"region\"` e `aria-roledescription=\"carousel\"`.\n- **stage** - Área do palco que contém os slides. Recebe `aria-live` e `aria-atomic`.\n- **nav-prev** - Wrapper do botão de navegação para o slide anterior.\n- **nav-next** - Wrapper do botão de navegação para o próximo slide.\n- **indicator** - Wrapper do indicador de páginas. - Quando `indicatorType=\"simple\"`: renderiza `br-step` em `mode=\"tablist\"`. - Quando `indicatorType=\"textual\"`: renderiza um `span[aria-live]` com \"X/N\".\n- **play-button** - Wrapper do botão de play/pause. Presente apenas quando `autoPlay=true`.",
+      "description": "O `br-carousel` mostra uma sequência de slides, um por vez, com botões de anterior e próximo e indicadores de posição.\n\nColoque cada slide em um `br-carousel-page` e dê um nome ao carrossel com `aria-label`.\n\n```html\n<br-carousel aria-label=\"Destaques\">\n  <br-carousel-page>\n    <img src=\"/imagens/campanha.jpg\" alt=\"Campanha de vacinação\" />\n  </br-carousel-page>\n  <br-carousel-page>\n    <p>Atualize seu cadastro até 30 de junho.</p>\n  </br-carousel-page>\n</br-carousel>\n```\n\nPara ouvir a troca de slide, use `brCarouselPageChange`; `detail.activePage` começa em 1.\n\n### Quando usar\n\n- Imagens ou avisos com a mesma importância, em espaço limitado.\n\n### Quando evitar\n\n- Informação essencial para a tarefa: mostre tudo de uma vez, por exemplo em uma grade de `br-card`.\n- Etapas de um formulário: use `br-wizard` ou `br-step`.\n\nConsulte as [diretrizes de design do GovBR](https://www.gov.br/ds/components/carousel?tab=designer).\n---\n\n\n### **Events:**\n - **brDidPageChange** - Emitido quando o slide ativo muda.\nDisparado por clique nos botões de navegação, clique no indicador de step,\ngesto swipe (apenas em mobile, breakpoint < 576px) ou avanço automático.\n`activePage` é 1-based: o primeiro slide emite `1`, o segundo `2`, e assim por diante.\n- **brCarouselPageChange** - Evento emitido quando o slide ativo muda.\n- **brDidAutoPlayStart** - Emitido quando a reprodução automática é iniciada ou retomada.\n- **brCarouselAutoplayStart** - Evento emitido quando a reprodução automática começa.\n- **brDidAutoPlayPause** - Emitido quando a reprodução automática é pausada.\n- **brCarouselAutoplayPause** - Evento emitido quando a reprodução automática é pausada.\n\n### **Methods:**\n - **onTablistKeydown(e: _KeyboardEvent_)** - Navegação por teclado para o modo tablist (`indicatorType=\"simple\"`).\n\nO W3C APG Carousel Pattern especifica que, quando os controles de seleção de slide\nsão implementados como tabs, a interação de teclado segue o\nhttps://www.w3.org/WAI/ARIA/apg/patterns/tabs/ Tabs Pattern (W3C APG).\nEsse padrão define o comportamento de roving tabindex com as teclas:\n- `ArrowLeft` / `ArrowRight` (ou `ArrowUp` / `ArrowDown`): move o foco entre as tabs.\n- `Home`: move o foco para a primeira tab.\n- `End`: move o foco para a última tab.\n\nO handler está no `br-carousel` (e não no `br-step`) porque a lógica de\n`effectiveCircular` é uma responsabilidade do carrossel, mantendo uma única\nfonte de verdade para a navegação circular.\n\nO evento `keydown` é composto (`composed: true`), portanto borbulha através do\nshadow DOM do `br-step-item` até o host do `br-carousel`.\n- **nextPage(): _Promise<void>_** - Avança para o próximo slide. Respeita a prop `isCircular` (ou ativo automaticamente com `autoPlay`).\n- **previousPage(): _Promise<void>_** - Retorna ao slide anterior. Respeita a prop `isCircular` (ou ativo automaticamente com `autoPlay`).\n- **goToPage(index: _number_): _Promise<void>_** - Navega para o slide de número `index` (1 = primeiro slide, 2 = segundo, …).\nValores fora do intervalo válido são ignorados.\n- **getActivePage(): _Promise<number>_** - Retorna o número do slide atualmente ativo (1 = primeiro slide, 2 = segundo, …).\n- **play(): _Promise<void>_** - Inicia ou retoma a reprodução automática programaticamente.\n- **pause(): _Promise<void>_** - Pausa a reprodução automática programaticamente.\n- **getIsPlaying(): _Promise<boolean>_** - Retorna `true` se a reprodução automática está ativa no momento.\n\n### **Slots:**\n - **default** - Slot para os slides do carrossel. Aceita exclusivamente elementos `br-carousel-page`.\n\n### **CSS Parts:**\n - **container** - Elemento raiz do carrossel. Recebe `role=\"region\"` e `aria-roledescription=\"carousel\"`.\n- **stage** - Área do palco que contém os slides. Recebe `aria-live` e `aria-atomic`.\n- **nav-prev** - Wrapper do botão de navegação para o slide anterior.\n- **nav-next** - Wrapper do botão de navegação para o próximo slide.\n- **indicator** - Wrapper do indicador de páginas. - Quando `indicatorType=\"simple\"`: renderiza `br-step` em `mode=\"tablist\"`. - Quando `indicatorType=\"textual\"`: renderiza um `span[aria-live]` com \"X/N\".\n- **play-button** - Wrapper do botão de play/pause. Presente apenas quando `autoPlay=true`.",
       "attributes": [
         {
           "name": "custom-id",
@@ -390,7 +390,7 @@
     },
     {
       "name": "br-carousel-page",
-      "description": "Subcomponente especializado de `br-carousel`, responsável por encapsular exatamente um slide ou página individual dentro da sequência de apresentação.\n\n### Papel na composição\n\n- Contém a mídia visual (imagem, ilustração ou vídeo), textos informativos e botões de ação associados àquele slide específico.\n- Recebe as classes e propriedades de visibilidade ativa gerenciadas pelo carrossel pai.\n\n### Regra de uso e relacionamento\n\nDeve ser instanciado exclusivamente dentro do slot padrão do orquestrador `br-carousel`. O componente pai coordena as transições de deslize, calcula o índice do slide e gerencia a acessibilidade. Não deve ser usado como elemento autônomo fora de um carrossel.\n\nPara a documentação completa de design, consulte o [Design System do GovBR](https://www.gov.br/ds/components/carousel?tab=designer).\n---\n\n\n### **Methods:**\n - **setLabel(defaultLabel: _string_): _Promise<void>_** - Define o label acessível (`aria-label`) do slide.\n\nChamado pelo `br-carousel` pai para aplicar o label gerado automaticamente\ncom base na posição do slide (ex: `\"Slide 1 de 3\"`).\n\nO `aria-label` declarado diretamente no elemento tem prioridade:\nse o consumidor definir `aria-label` no HTML ou via `setAttribute`,\nesse valor será mantido e o parâmetro `defaultLabel` será ignorado.\n- **setActive(active: _boolean_): _Promise<void>_** - Ativa ou desativa o slide.\n\n### **Slots:**\n - **default** - Qualquer conteúdo: imagens, textos, cards, vídeos, outros componentes do Design System.\n\n### **CSS Parts:**\n - **content** - Wrapper interno do conteúdo do slide.",
+      "description": "Representa um slide do `br-carousel`. Use somente dentro dele.\n\nColoque no slide a imagem, o texto e as ações. Para começar em um slide que não seja o primeiro, marque-o com `active`; depois disso, o `br-carousel` controla o slide ativo.\n---\n\n\n### **Methods:**\n - **setLabel(defaultLabel: _string_): _Promise<void>_** - Define o label acessível (`aria-label`) do slide.\n\nChamado pelo `br-carousel` pai para aplicar o label gerado automaticamente\ncom base na posição do slide (ex: `\"Slide 1 de 3\"`).\n\nO `aria-label` declarado diretamente no elemento tem prioridade:\nse o consumidor definir `aria-label` no HTML ou via `setAttribute`,\nesse valor será mantido e o parâmetro `defaultLabel` será ignorado.\n- **setActive(active: _boolean_): _Promise<void>_** - Ativa ou desativa o slide.\n\n### **Slots:**\n - **default** - Qualquer conteúdo: imagens, textos, cards, vídeos, outros componentes do Design System.\n\n### **CSS Parts:**\n - **content** - Wrapper interno do conteúdo do slide.",
       "attributes": [
         {
           "name": "custom-id",
@@ -407,7 +407,7 @@
     },
     {
       "name": "br-checkbox",
-      "description": "O componente `br-checkbox` é o controle de formulário oficial do GovBR-DS para seleção binária independente (marcado ou desmarcado) ou intermediária (indeterminada). Compatível com as diretrizes WAI-ARIA para checkboxes, ele integra-se nativamente a formulários HTML via `formAssociated`.\n\n### Para que serve\n\n- **Seleção independente múltipla:** Permite que a pessoa usuária escolha qualquer quantidade de opções (zero, uma ou várias) de uma lista de alternativas independentes.\n- **Confirmação e aceite binário:** Utilizado para termos de uso, declarações de concordância e confirmações obrigatórias.\n- **Estado indeterminado:** Suporta a propriedade `indeterminate`, essencial para checkboxes mestres em listas hierárquicas (indicando que parte dos itens filhos está marcada).\n- **Validação e formulários:** Comunica valor, estado de validação e mensagens contextuais de erro (`feedback`) diretamente com a API nativa de formulários HTML (`ElementInternals`).\n\n### Quando utilizar\n\n- **Utilize quando:**\n  - Houver uma lista de opções onde a seleção de uma alternativa não anula nem depende das demais.\n  - O usuário precisar confirmar explicitamente uma condição única (ex.: \"Li e concordo com os termos\").\n  - For necessário criar controle de seleção em lote (\"Selecionar todos\").\n- **Evite e prefira outro componente quando:**\n  - As opções forem mutuamente exclusivas (apenas uma pode ser escolhida): prefira `br-radio` ou `br-radio-group`.\n  - A ação ativar ou desativar instantaneamente um recurso sem exigir submissão de formulário: prefira `br-switch`.\n  - Houver muitas opções (mais de 7) em espaço reduzido: prefira `br-select` múltiplo.\n\n### Estrutura e Slots\n\nO `br-checkbox` é um controle autônomo com slots de suporte:\n- `default`: Slot para o texto do rótulo associado ao checkbox (alternativa à propriedade `label`).\n- `feedback`: Slot para exibição de mensagens de validação e alertas contextuais (como `br-message`).\n\nPara a documentação completa de design, incluindo diretrizes de acessibilidade e especificações visuais, consulte o [Design System do GovBR](https://www.gov.br/ds/components/checkbox?tab=designer).\n---\n\n\n### **Events:**\n - **checkedChange** - Disparado depois que o valor do `checked` foi alterado.\n- **indeterminateChange** - Disparado depois que o valor do `indeterminate` foi alterado.\n- **brCheckboxValidationChange** - Emitido ao iniciar e concluir a validação customizada.\n\n### **Methods:**\n - **checkValidity(): _Promise<boolean>_** - Retorna `true` se o valor do checkbox for válido, caso contrário `false`.\nSe o checkbox for inválido, dispara um evento 'invalid'.\n- **reportValidity(): _Promise<boolean>_** - Retorna `true` se o valor do checkbox for válido, caso contrário `false`.\nSe for inválido, exibe a mensagem de erro padrão do navegador.\n- **setCustomValidity(message: _string_): _Promise<void>_** - Define uma mensagem de validação customizada para o checkbox.\nSe a mensagem for uma string vazia, o erro customizado é limpo.\n- **validate(): _Promise<boolean>_** - Executa o validator do checkbox e retorna se o valor atual é válido.\n- **getValidationState(): _Promise<FormValidationState>_** - Retorna um snapshot serializável da Constraint Validation API.\n- **setIndeterminate(value: _boolean_)** - Define o estado indeterminado do checkbox.\n- **toggleChecked()** - @deprecated Atualize a propriedade `checked` diretamente. - Inverte o valor da prop `checked`\n- **setNumberOfChildren(value: _number_)** - Define o número de checkboxes filhos em um grupo de checkboxes.\n\n### **Slots:**\n - **default** - Slot para o rótulo do checkbox, como alternativa à propriedade label.\n- **feedback** - Mensagem de validação, normalmente um `br-message`.\n\n### **CSS Parts:**\n - **container** - Contêiner visual do checkbox.\n- **input** - Elemento input nativo do checkbox.\n- **label** - Rótulo do checkbox.\n- **feedback** - Contêiner da mensagem de validação.",
+      "description": "O `br-checkbox` marca ou desmarca uma opção independente. Funciona em formulários como um `<input type=\"checkbox\">`: é enviado com `name` e `value` quando está marcado.\n\n```html\n<br-checkbox name=\"termos\" value=\"aceito\" label=\"Li e aceito os termos\" required></br-checkbox>\n```\n\nUse `indeterminate` para indicar seleção parcial, por exemplo em um \"selecionar todos\" quando só parte dos itens está marcada.\n\n### Quando usar\n\n- Opções em que escolher uma não impede escolher outra.\n- Confirmar uma condição, como aceitar termos.\n\n### Quando evitar\n\n- Só uma opção pode ser escolhida: use `br-radio-group`.\n- A mudança vale na hora, sem enviar formulário: use `br-switch`.\n- Muitas opções em pouco espaço: use `br-select` com `multiple`.\n\nPara várias opções da mesma pergunta, agrupe-as em um `br-checkbox-group`.\n\nConsulte as [diretrizes de design do GovBR](https://www.gov.br/ds/components/checkbox?tab=designer).\n---\n\n\n### **Events:**\n - **checkedChange** - Disparado depois que o valor do `checked` foi alterado.\n- **indeterminateChange** - Disparado depois que o valor do `indeterminate` foi alterado.\n- **brCheckboxValidationChange** - Emitido ao iniciar e concluir a validação customizada.\n\n### **Methods:**\n - **checkValidity(): _Promise<boolean>_** - Retorna `true` se o valor do checkbox for válido, caso contrário `false`.\nSe o checkbox for inválido, dispara um evento 'invalid'.\n- **reportValidity(): _Promise<boolean>_** - Retorna `true` se o valor do checkbox for válido, caso contrário `false`.\nSe for inválido, exibe a mensagem de erro padrão do navegador.\n- **setCustomValidity(message: _string_): _Promise<void>_** - Define uma mensagem de validação customizada para o checkbox.\nSe a mensagem for uma string vazia, o erro customizado é limpo.\n- **validate(): _Promise<boolean>_** - Executa o validator do checkbox e retorna se o valor atual é válido.\n- **getValidationState(): _Promise<FormValidationState>_** - Retorna um snapshot serializável da Constraint Validation API.\n- **setIndeterminate(value: _boolean_)** - Define o estado indeterminado do checkbox.\n- **toggleChecked()** - @deprecated Atualize a propriedade `checked` diretamente. - Inverte o valor da prop `checked`\n- **setNumberOfChildren(value: _number_)** - Define o número de checkboxes filhos em um grupo de checkboxes.\n\n### **Slots:**\n - **default** - Slot para o rótulo do checkbox, como alternativa à propriedade label.\n- **feedback** - Mensagem de validação, normalmente um `br-message`.\n\n### **CSS Parts:**\n - **container** - Contêiner visual do checkbox.\n- **input** - Elemento input nativo do checkbox.\n- **label** - Rótulo do checkbox.\n- **feedback** - Contêiner da mensagem de validação.",
       "attributes": [
         {
           "name": "indeterminate",
@@ -466,7 +466,7 @@
         },
         {
           "name": "feedback-state",
-          "description": "Estado de feedback canônico. Quando informado, tem precedência sobre `state`.",
+          "description": "Estado de feedback. Quando informado, tem precedência sobre `state`.",
           "values": [{ "name": "valid" }, { "name": "invalid" }]
         },
         {
@@ -484,7 +484,7 @@
     },
     {
       "name": "br-checkbox-group",
-      "description": "O componente `br-checkbox-group` é o contêiner semântico e orquestrador de múltiplos controles `br-checkbox` que pertencem a um mesmo contexto ou pergunta em formulários do GovBR-DS.\n\n### Para que serve\n\n- **Agrupamento semântico e acessibilidade:** Cria a estrutura recomendada de `fieldset` e `legend` para leitores de tela, garantindo que o contexto da pergunta seja anunciado antes de cada opção individual.\n- **Validação conjunta:** Permite coordenar regras de validação em grupo (como exigir uma quantidade mínima ou máxima de checkboxes selecionados).\n- **Alinhamento e padronização visual:** Organiza os checkboxes vertical ou horizontalmente conforme o leiaute da interface.\n\n### Quando utilizar\n\n- **Utilize quando:**\n  - Existirem duas ou mais opções em checkbox que respondem à mesma pergunta ou pertencem ao mesmo conjunto lógico de preferências.\n  - For necessário aplicar rótulo geral e mensagens de validação ao grupo completo de escolhas.\n- **Evite e prefira outro componente quando:**\n  - Houver apenas um único checkbox independente (ex.: aceite de termos): use `br-checkbox` isoladamente.\n  - A seleção for de escolha única (mutuamente exclusiva): use `br-radio-group`.\n\n### Estrutura e Slots\n\nO `br-checkbox-group` atua como container orquestrador:\n- `default`: Slot onde devem ser inseridos os elementos `br-checkbox` que compõem o grupo.\n- `feedback`: Slot opcional para mensagem de erro ou orientação de validação associada ao grupo todo.\n\nPara a documentação completa de design, incluindo diretrizes de acessibilidade e especificações visuais, consulte o [Design System do GovBR](https://www.gov.br/ds/components/checkgroup?tab=designer).\n---\n\n\n### **Slots:**\n - **default** - Slot para adicionar os checkboxes controlados pelo grupo.",
+      "description": "O `br-checkbox-group` reúne checkboxes da mesma pergunta e adiciona um checkbox \"Selecionar tudo\" no topo.\n\nO \"Selecionar tudo\" marca ou desmarca todas as opções e fica em estado parcial quando só algumas estão marcadas. O `label` vira a legenda do grupo para leitores de tela.\n\n```html\n<br-checkbox-group label=\"Receber notificações por\">\n  <br-checkbox name=\"canais\" value=\"email\" label=\"E-mail\"></br-checkbox>\n  <br-checkbox name=\"canais\" value=\"sms\" label=\"SMS\"></br-checkbox>\n  <br-checkbox name=\"canais\" value=\"app\" label=\"Aplicativo\"></br-checkbox>\n</br-checkbox-group>\n```\n\nUse `orientation=\"horizontal\"` para as opções lado a lado, e `select-all-label` e `unselect-all-label` para trocar os textos do \"Selecionar tudo\".\n\n### Quando usar\n\n- Várias opções independentes que respondem à mesma pergunta.\n\n### Quando evitar\n\n- Um único checkbox, como aceite de termos: use só o `br-checkbox`.\n- Apenas uma opção pode ser escolhida: use `br-radio-group`.\n\nConsulte as [diretrizes de design do GovBR](https://www.gov.br/ds/components/checkgroup?tab=designer).\n---\n\n\n### **Slots:**\n - **default** - Slot para adicionar os checkboxes controlados pelo grupo.",
       "attributes": [
         {
           "name": "disabled",
@@ -526,7 +526,7 @@
     },
     {
       "name": "br-checkgroup",
-      "description": "@deprecated Use `br-checkbox-group`.\n\nO componente `br-checkgroup` é o alias legado mantido para compatibilidade com versões anteriores da biblioteca.\n\n### Papel na biblioteca\n\n- Atua como um redirecionador direto para a implementação do `br-checkbox-group`.\n- Permite que aplicações já existentes mantenham o funcionamento sem interrupções enquanto realizam a transição gradativa.\n\n### Regra de uso e migração\n\nEm novos projetos e manutenções ativas, **utilize sempre a tag canônica `br-checkbox-group`**. O uso de `br-checkgroup` está depreciado e deve ser substituído pela tag oficial.\n\nPara a documentação canônica completa, consulte a página do [br-checkbox-group](/docs/components/checkbox-group).\n---\n\n\n### **Slots:**\n - **default** - Slot para adicionar os checkboxes controlados pelo grupo.",
+      "description": "@deprecated Use `br-checkbox-group`.\n\nNome antigo do `br-checkbox-group`, mantido para compatibilidade. Em código novo, use `br-checkbox-group`.\n---\n\n\n### **Slots:**\n - **default** - Slot para adicionar os checkboxes controlados pelo grupo.",
       "attributes": [
         {
           "name": "label",
@@ -573,7 +573,7 @@
     },
     {
       "name": "br-collapse",
-      "description": "O componente `br-collapse` é o controle retrátil do GovBR-DS baseado no elemento semântico HTML5 `<details>`, desenvolvido para permitir que a pessoa usuária expanda ou recolha seções de conteúdo sob demanda.\n\n### Para que serve\n\n- **Otimização de espaço e hierarquia:** Reduz a sobrecarga de informação inicial na tela, ocultando blocos secundários até que o usuário decida visualizá-los.\n- **Estruturação de perguntas e respostas:** Padrão oficial para construção de seções de FAQ (perguntas frequentes) e listas explicativas sanfonadas (accordion).\n- **Acessibilidade nativa:** Por utilizar internamente os elementos `<details>` e `<summary>`, possui controle total de teclado, estado acessível (`open`) e anúncios para tecnologias assistivas sem exigir scripts adicionais complexos.\n\n### Quando utilizar\n\n- **Utilize quando:**\n  - O conteúdo for extenso, dividido em tópicos independentes e a maioria dos usuários só precisa consultar itens específicos.\n  - Houver seções complementares opcionais em um formulário longo.\n- **Evite e prefira outro componente quando:**\n  - A informação contida for crítica para a tomada de decisão imediata ou segurança da pessoa usuária (ela deve ficar permanentemente visível).\n  - A intenção for alternar entre diferentes visões de uma mesma tela completa (prefira `br-tab`).\n\n### Estrutura e Slots\n\nO `br-collapse` organiza o acionamento e a área expansível:\n- `trigger`: Slot para personalizar o botão/gatilho de expansão (texto, ícones ou componentes de apoio dentro do summary).\n- `default`: Slot para inserção do conteúdo que é revelado quando o componente é expandido.\n\nPara a documentação completa de design, incluindo diretrizes de acessibilidade e especificações visuais, consulte o [Design System do GovBR](https://www.gov.br/ds/components/collapse?tab=designer).\n---\n\n\n### **Events:**\n - **brDidOpen** - Emitido ao expandir, com o identificador e o grupo de accordion.\n- **brCollapseOpen** - Evento canônico emitido ao expandir.\n- **brDidClose** - Emitido ao recolher, com o identificador e o grupo de accordion.\n- **brCollapseClose** - Evento canônico emitido ao recolher.\n\n### **Methods:**\n - **openCollapse()** - @deprecated Atualize a propriedade `open`. - Abre o collapse programaticamente.\n- **closeCollapse()** - @deprecated Atualize a propriedade `open`. - Fecha o collapse programaticamente.\n- **toggle(): _Promise<void>_** - Alterna o estado aberto.\nO elemento também redispara o evento nativo `toggle` no host; essa ocorrência é sintética (`isTrusted === false`).\n- **render()** - Renderiza o <details> com acionador e conteúdo expansível.\n\n### **Slots:**\n - **default** - Slot para o conteúdo expansível exibido ao abrir o collapse.\n- **trigger** - Slot para personalizar o acionador (texto, ícones, imagens, etc.).\n- **icon-to-show** - Ícone exibido quando o conteúdo está oculto (ex.: `<i slot=\"icon-to-show\" class=\"fas fa-plus\"></i>`). Forma preferida para ícones por classe CSS; tem precedência sobre a prop `iconToShow`.\n- **icon-to-hide** - Ícone exibido quando o conteúdo está visível. Forma preferida para ícones por classe CSS; tem precedência sobre a prop `iconToHide`.\n\n### **CSS Parts:**\n - **details** - Elemento details nativo do collapse.\n- **trigger** - Acionador (summary) do collapse.\n- **content** - Área de conteúdo expansível.",
+      "description": "O `br-collapse` mostra e esconde um bloco de conteúdo ao clicar no título. Funciona como um `<details>`.\n\n```html\n<br-collapse>\n  <span slot=\"trigger\">Quem pode solicitar?</span>\n  <p>Qualquer pessoa com CPF regular.</p>\n</br-collapse>\n```\n\nUse `open` para começar aberto. Para que só um item fique aberto por vez (sanfona), dê o mesmo `accordion-group` a todos:\n\n```html\n<br-collapse accordion-group=\"faq\">…</br-collapse>\n<br-collapse accordion-group=\"faq\">…</br-collapse>\n```\n\nOs ícones de abrir e fechar podem ser trocados por `icon-to-show` e `icon-to-hide`, como propriedade ou como slot.\n\n### Quando usar\n\n- Perguntas frequentes e conteúdos longos divididos em tópicos.\n- Seções opcionais de um formulário longo.\n\n### Quando evitar\n\n- Informação essencial, que precisa ficar sempre visível.\n- Alternar entre visões diferentes da mesma tela: use `br-tab`.\n\nConsulte as [diretrizes de design do GovBR](https://www.gov.br/ds/components/collapse?tab=designer).\n---\n\n\n### **Events:**\n - **brDidOpen** - Emitido ao expandir, com o identificador e o grupo de accordion.\n- **brCollapseOpen** - Evento emitido ao expandir.\n- **brDidClose** - Emitido ao recolher, com o identificador e o grupo de accordion.\n- **brCollapseClose** - Evento emitido ao recolher.\n\n### **Methods:**\n - **openCollapse()** - @deprecated Atualize a propriedade `open`. - Abre o collapse programaticamente.\n- **closeCollapse()** - @deprecated Atualize a propriedade `open`. - Fecha o collapse programaticamente.\n- **toggle(): _Promise<void>_** - Alterna o estado aberto.\nO elemento também redispara o evento nativo `toggle` no host; essa ocorrência é sintética (`isTrusted === false`).\n- **render()** - Renderiza o <details> com acionador e conteúdo expansível.\n\n### **Slots:**\n - **default** - Slot para o conteúdo expansível exibido ao abrir o collapse.\n- **trigger** - Slot para personalizar o acionador (texto, ícones, imagens, etc.).\n- **icon-to-show** - Ícone exibido quando o conteúdo está oculto (ex.: `<i slot=\"icon-to-show\" class=\"fas fa-plus\"></i>`). Forma preferida para ícones por classe CSS; tem precedência sobre a prop `iconToShow`.\n- **icon-to-hide** - Ícone exibido quando o conteúdo está visível. Forma preferida para ícones por classe CSS; tem precedência sobre a prop `iconToHide`.\n\n### **CSS Parts:**\n - **details** - Elemento details nativo do collapse.\n- **trigger** - Acionador (summary) do collapse.\n- **content** - Área de conteúdo expansível.",
       "attributes": [
         {
           "name": "custom-id",
@@ -597,12 +597,12 @@
         },
         {
           "name": "icon-to-show",
-          "description": "Identificador Iconify do ícone exibido quando o conteúdo está oculto. O valor padrão usa o registro SVG local.\nPara ícones por classe CSS, use o slot `icon-to-show`.",
+          "description": "Identificador de ícone Font Awesome 5 Free presente no cache local, exibido quando o conteúdo está oculto.\nPara ícones por classe CSS, use o slot `icon-to-show`.",
           "values": []
         },
         {
           "name": "icon-to-hide",
-          "description": "Identificador Iconify do ícone exibido quando o conteúdo está visível. O valor padrão usa o registro SVG local.\nPara ícones por classe CSS, use o slot `icon-to-hide`.",
+          "description": "Identificador de ícone Font Awesome 5 Free presente no cache local, exibido quando o conteúdo está visível.\nPara ícones por classe CSS, use o slot `icon-to-hide`.",
           "values": []
         },
         {
@@ -635,7 +635,7 @@
     },
     {
       "name": "br-cookiebar",
-      "description": "O componente `br-cookiebar` é o orquestrador completo do GovBR-DS para aviso e gestão de consentimento de cookies, atendendo às exigências da LGPD (Lei Geral de Proteção de Dados).\n\n### Para que serve\n\n- **Aviso de privacidade e cookies:** Informa com clareza à pessoa usuária sobre a coleta e finalidade de cookies no sistema.\n- **Gestão de consentimento:** Permite aceitar todos os cookies, rejeitar os não essenciais ou gerenciar categorias de forma granular.\n- **Detalhamento transparente:** Exibe a relação técnica de cookies utilizados por categoria com nome, validade e finalidade.\n\n### Quando utilizar\n\n- **Utilize quando:**\n  - A aplicação ou portal público utilizar cookies de sessão, rastreamento ou preferências que demandem consentimento explícito.\n  - For necessário dar cumprimento às diretrizes de privacidade e proteção de dados pessoais (LGPD).\n- **Evite e prefira outro componente quando:**\n  - A notificação for apenas um alerta contextual ou mensagem simples de status sem relação com consentimento (prefira `br-message` ou `br-notification`).\n\n### Composição e Subcomponentes\n\n| Subcomponente | Papel | Regra de uso |\n| --- | --- | --- |\n| `br-cookiebar` | **Orquestrador principal.** Gerencia abertura, fechamento, persistência e emissão dos eventos de consentimento. | Declarado como contêiner do aviso de cookies na aplicação. |\n| `br-cookiebar-header` | **Cabeçalho informativo.** Exibe título e mensagem inicial de contexto. | Inserido no slot de topo do `br-cookiebar`. |\n| `br-cookiebar-group` | **Categoria de cookies.** Agrupa cookies por finalidade com controle de seleção. | Inserido no corpo de opções do `br-cookiebar`. |\n| `br-cookiebar-cookie` | **Item de cookie.** Descreve detalhadamente um cookie específico. | Inserido dentro de um `br-cookiebar-group`. |\n| `br-cookiebar-link` | **Link informativo.** Atalho para a Política de Privacidade e termos. | Usado no cabeçalho ou notas do `br-cookiebar`. |\n| `br-cookiebar-note` | **Nota complementar.** Mensagem ou aviso jurídico adicional. | Inserido individualmente ou em `br-cookiebar-note-group`. |\n| `br-cookiebar-note-group` | **Agrupador de notas.** Organiza múltiplas notas informativas. | Posicionado na área de notas do `br-cookiebar`. |\n\n### Como os subcomponentes se relacionam\n\nO `br-cookiebar` atua como orquestrador central. Ele controla a visualização do painel (modo compacto ou expandido), agrupa as categorias (`br-cookiebar-group`) com seus respectivos cookies (`br-cookiebar-cookie`) e disponibiliza os botões de ação para aceitar todos, rejeitar ou salvar preferências. A aplicação consome eventos unificados de consentimento disparados pelo componente pai.\n\nPara a documentação completa de design, incluindo diretrizes de acessibilidade e especificações visuais, consulte o [Design System do GovBR](https://www.gov.br/ds/components/cookiebar?tab=designer).\n---\n\n\n### **Events:**\n - **brCookiebarShow** - Emitido quando o componente se torna visível (`show` → true).\n- **brCookiebarHide** - Emitido quando o componente é ocultado (`show` → false).\n- **brCookiebarOpen** - Emitido quando o painel expande para modo open.\n- **brCookiebarClose** - Emitido quando o painel recolhe para modo default.\n- **brCookiebarAccept** - Sinal emitido quando o usuário clica em Aceitar.\nNão carrega payload — ouça `brCookiebarResponse` para obter o estado completo de consentimento.\n- **brCookiebarReject** - Sinal emitido quando o usuário clica em \"Rejeitar não obrigatórios\".\nNão carrega payload — ouça `brCookiebarResponse` para obter o estado completo de consentimento.\n- **brCookiebarResponse** - Emitido após `brCookiebarAccept` ou `brCookiebarReject`, com o estado final de consentimento.\nÉ o único evento que carrega `CookiebarOutputData` — use-o para persistir o consentimento\n(localStorage, cookie HTTP, API etc.).\nNão é disparado durante interações com checkboxes e switches internos.\n- **brCookiebarPolicyClick** - Emitido quando o usuário clica no botão secundário no modo opt-in (`allOptOut=false`).\nO consumidor é responsável por navegar para a página de Política de Cookies.\n\n### **Methods:**\n - **handleShowChange(newValue: _boolean_)** - Observa mudanças em `show`.\nAo exibir o componente, garante que o modo inicial seja sempre `default` e emite `brCookiebarShow`.\nCom `scrim=true`, aplica `inert` nos irmãos e registra o trap de foco.\nCom `scrim=false`, o usuário pode navegar livremente pela página (WCAG 2.1.2).\nAo ocultar, emite `brCookiebarHide`.\n- **handleModeChange(newValue: _CookiebarMode_)** - Observa mudanças em `mode`.\nAo entrar em modo `open`, emite `brCookiebarOpen`, aplica `inert` nos irmãos e move o foco\npara o botão fechar (trap focus modal).\nAo sair do modo `open`, emite `brCookiebarClose` e — se `scrim=true` — reaplica `inert`\ne o listener de trap para o painel default. Sem scrim, nenhum trap é ativado.\n- **handleSelectAllPropChange(newValue: _boolean_)** - Observa mudanças externas na prop `selectAll`.\nSincroniza o estado interno do checkbox e propaga o valor para todos os grupos opt-out.\n- **handleGroupChange()** - Escuta o evento `brCookiebarGroupChange` emitido por qualquer `br-cookiebar-group` filho.\nApenas recalcula o estado visual do checkbox \"Selecionar tudo\" — não emite `brCookiebarResponse`.\nO evento de resposta completo é emitido somente ao clicar em Aceitar ou Rejeitar.\n- **openDefault(): _Promise<void>_** - Exibe o cookiebar no modo `default` (barra inferior).\n- **openPanel(): _Promise<void>_** - Exibe o cookiebar diretamente no modo `open` (painel de tela cheia).\n- **close(): _Promise<void>_** - Oculta o cookiebar.\n- **getSelectedCookies(): _Promise<CookiebarOutputData>_** - Retorna o JSON com o estado atual de seleção de todos os grupos e cookies.\n\n### **Slots:**\n - **default** - Recebe os subcomponentes `br-cookiebar-group`, `br-cookiebar-note-group` e `br-cookiebar-note`.\n- **header** - Recebe `br-cookiebar-header` ou HTML livre.\n- **links** - Recebe links complementares (`br-cookiebar-link` ou elementos `<a>` livres).\n- **actions** - Recebe botões de ação. Se vazio, o componente renderiza os botões padrão.\n\n### **CSS Parts:**\n - **container** - Container raiz do componente.\n- **default-panel** - Painel fechado (modo default).\n- **open-panel** - Painel expandido (modo open).\n- **header** - Cabeçalho do painel aberto.\n- **body** - Corpo do painel aberto (com rolagem).\n- **footer** - Rodapé com botões de ação.\n- **scrim** - Camada de sobreposição opcional.",
+      "description": "O `br-cookiebar` avisa sobre o uso de cookies e registra o consentimento da pessoa, por categoria e por cookie.\n\nEle aparece como uma barra no rodapé (`mode=\"default\"`) e abre um painel com as categorias quando a pessoa escolhe \"Definir Cookies\" (`mode=\"open\"`).\n\n### Como usar\n\n1. Escreva o texto da barra em `info-text`.\n2. Coloque o título e a introdução do painel em um `br-cookiebar-header`.\n3. Crie um `br-cookiebar-group` por categoria e, dentro dele, um `br-cookiebar-cookie` por cookie. Use `group-opt-out=\"false\"` nas categorias que não podem ser desativadas.\n4. Adicione os links de política em `br-cookiebar-link`, no slot `links`.\n5. Ouça `brCookiebarResponse` para salvar a escolha e ative `show` somente enquanto não houver escolha salva.\n\n```html\n<br-cookiebar info-text=\"Usamos cookies para melhorar sua experiência.\">\n  <br-cookiebar-header slot=\"header\" main-title=\"Aviso de cookies\" entry-text=\"Escolha quais cookies aceitar.\"></br-cookiebar-header>\n\n  <br-cookiebar-group group-id=\"necessarios\" group-name=\"Necessários\" group-text=\"Essenciais para o site funcionar.\" group-opt-out=\"false\">\n    <br-cookiebar-cookie cookie-id=\"sessao\" cookie-name=\"sessao\" expires=\"Ao fechar o navegador\" domain=\"exemplo.gov.br\" enterprise=\"Próprio\" purpose=\"Manter a sessão\" description=\"Identifica a sessão de acesso.\"></br-cookiebar-cookie>\n  </br-cookiebar-group>\n\n  <br-cookiebar-link slot=\"links\" name=\"Política de privacidade\" href=\"/privacidade\"></br-cookiebar-link>\n</br-cookiebar>\n```\n\n```js\nconst cookiebar = document.querySelector('br-cookiebar');\ncookiebar.show = !localStorage.getItem('consentimento');\ncookiebar.addEventListener('brCookiebarResponse', (event) => {\n  localStorage.setItem('consentimento', JSON.stringify(event.detail));\n});\n```\n\n`event.detail` traz o estado de cada categoria (`cookieGroups`) e de cada cookie (`cookieList`). Para reabrir o painel depois, por exemplo num link \"Preferências de cookies\", chame `openPanel()`.\n\n### Quando evitar\n\n- Avisos que não tratam de consentimento: use `br-message` ou `br-notification`.\n\nConsulte as [diretrizes de design do GovBR](https://www.gov.br/ds/components/cookiebar?tab=designer).\n---\n\n\n### **Events:**\n - **brCookiebarShow** - Emitido quando o componente se torna visível (`show` → true).\n- **brCookiebarHide** - Emitido quando o componente é ocultado (`show` → false).\n- **brCookiebarOpen** - Emitido quando o painel expande para modo open.\n- **brCookiebarClose** - Emitido quando o painel recolhe para modo default.\n- **brCookiebarAccept** - Sinal emitido quando o usuário clica em Aceitar.\nNão carrega payload — ouça `brCookiebarResponse` para obter o estado completo de consentimento.\n- **brCookiebarReject** - Sinal emitido quando o usuário clica em \"Rejeitar não obrigatórios\".\nNão carrega payload — ouça `brCookiebarResponse` para obter o estado completo de consentimento.\n- **brCookiebarResponse** - Emitido após `brCookiebarAccept` ou `brCookiebarReject`, com o estado final de consentimento.\nÉ o único evento que carrega `CookiebarOutputData` — use-o para persistir o consentimento\n(localStorage, cookie HTTP, API etc.).\nNão é disparado durante interações com checkboxes e switches internos.\n- **brCookiebarPolicyClick** - Emitido quando o usuário clica no botão secundário no modo opt-in (`allOptOut=false`).\nO consumidor é responsável por navegar para a página de Política de Cookies.\n\n### **Methods:**\n - **handleShowChange(newValue: _boolean_)** - Observa mudanças em `show`.\nAo exibir o componente, garante que o modo inicial seja sempre `default` e emite `brCookiebarShow`.\nCom `scrim=true`, aplica `inert` nos irmãos e registra o trap de foco.\nCom `scrim=false`, o usuário pode navegar livremente pela página (WCAG 2.1.2).\nAo ocultar, emite `brCookiebarHide`.\n- **handleModeChange(newValue: _CookiebarMode_)** - Observa mudanças em `mode`.\nAo entrar em modo `open`, emite `brCookiebarOpen`, aplica `inert` nos irmãos e move o foco\npara o botão fechar (trap focus modal).\nAo sair do modo `open`, emite `brCookiebarClose` e — se `scrim=true` — reaplica `inert`\ne o listener de trap para o painel default. Sem scrim, nenhum trap é ativado.\n- **handleSelectAllPropChange(newValue: _boolean_)** - Observa mudanças externas na prop `selectAll`.\nSincroniza o estado interno do checkbox e propaga o valor para todos os grupos opt-out.\n- **handleGroupChange()** - Escuta o evento `brCookiebarGroupChange` emitido por qualquer `br-cookiebar-group` filho.\nApenas recalcula o estado visual do checkbox \"Selecionar tudo\" — não emite `brCookiebarResponse`.\nO evento de resposta completo é emitido somente ao clicar em Aceitar ou Rejeitar.\n- **openDefault(): _Promise<void>_** - Exibe o cookiebar no modo `default` (barra inferior).\n- **openPanel(): _Promise<void>_** - Exibe o cookiebar diretamente no modo `open` (painel de tela cheia).\n- **close(): _Promise<void>_** - Oculta o cookiebar.\n- **getSelectedCookies(): _Promise<CookiebarOutputData>_** - Retorna o JSON com o estado atual de seleção de todos os grupos e cookies.\n\n### **Slots:**\n - **default** - Recebe os subcomponentes `br-cookiebar-group`, `br-cookiebar-note-group` e `br-cookiebar-note`.\n- **header** - Recebe `br-cookiebar-header` ou HTML livre.\n- **links** - Recebe links complementares (`br-cookiebar-link` ou elementos `<a>` livres).\n- **actions** - Recebe botões de ação. Se vazio, o componente renderiza os botões padrão.\n\n### **CSS Parts:**\n - **container** - Container raiz do componente.\n- **default-panel** - Painel fechado (modo default).\n- **open-panel** - Painel expandido (modo open).\n- **header** - Cabeçalho do painel aberto.\n- **body** - Corpo do painel aberto (com rolagem).\n- **footer** - Rodapé com botões de ação.\n- **scrim** - Camada de sobreposição opcional.",
       "attributes": [
         {
           "name": "custom-id",
@@ -742,7 +742,7 @@
     },
     {
       "name": "br-cookiebar-cookie",
-      "description": "O componente `br-cookiebar-cookie` é o subcomponente do GovBR-DS que descreve as especificações técnicas de um cookie individual.\n\n### Para que serve\n\n- **Transparência técnica:** Detalha nome, validade, finalidade e fornecedor do cookie.\n- **Esclarecimento ao cidadão:** Oferece visibilidade granular sobre cada elemento de persistência.\n\n### Papel na composição\n\nAtua como item folha descritivo na listagem de cookies.\n\n### Regra de uso e relacionamento\n\n- Deve ser utilizado exclusivamente dentro de um `br-cookiebar-group`.\n- Não deve ser utilizado fora do ecossistema de gestão de cookies.\n---\n\n\n### **Events:**\n - **brCookiebarCookieChange** - Emitido ao ligar/desligar o switch.\nBorbulha até o `br-cookiebar-group` pai para recalcular o estado do grupo.\n\n### **Slots:**\n - **default** - Área livre para inserir conteúdo personalizado abaixo dos itens do cookie.\n\n### **CSS Parts:**\n - **card** - Container principal do cookie.\n- **switch** - Área que contém o switch de ativação.\n- **details** - Wrapper interno com o switch, alerta e lista de itens.",
+      "description": "Descreve um cookie dentro de um `br-cookiebar-group`: nome, validade, domínio, empresa responsável, finalidade e descrição.\n\nUse `cookie-opt-out=\"false\"` quando o cookie não puder ser desativado.\n---\n\n\n### **Events:**\n - **brCookiebarCookieChange** - Emitido ao ligar/desligar o switch.\nBorbulha até o `br-cookiebar-group` pai para recalcular o estado do grupo.\n\n### **Slots:**\n - **default** - Área livre para inserir conteúdo personalizado abaixo dos itens do cookie.\n\n### **CSS Parts:**\n - **card** - Container principal do cookie.\n- **switch** - Área que contém o switch de ativação.\n- **details** - Wrapper interno com o switch, alerta e lista de itens.",
       "attributes": [
         {
           "name": "custom-id",
@@ -854,7 +854,7 @@
     },
     {
       "name": "br-cookiebar-group",
-      "description": "O componente `br-cookiebar-group` é o subcomponente do GovBR-DS que representa uma categoria de cookies (ex.: necessários, desempenho, marketing) acompanhada de um controle de seleção (switch ou checkbox).\n\n### Para que serve\n\n- **Segmentação por finalidade:** Organiza os cookies conforme o tipo e necessidade técnica.\n- **Controle de consentimento:** Permite habilitar ou desabilitar categorias não obrigatórias.\n\n### Papel na composição\n\nAtua como contêiner de agrupamento intermediário dentro do `br-cookiebar`, contendo instâncias de `br-cookiebar-cookie`.\n\n### Regra de uso e relacionamento\n\n- Deve ser utilizado dentro do corpo de configuração do `br-cookiebar`.\n- Recebe elementos filhos do tipo `br-cookiebar-cookie`.\n---\n\n\n### **Events:**\n - **brCookiebarGroupChange** - Emitido quando o estado de seleção do grupo muda (por interação do usuário ou propagação).\nO `br-cookiebar` pai escuta este evento para recalcular o checkbox \"Selecionar todos\".\n- **brCookiebarGroupToggle** - Emitido ao expandir ou recolher a lista de cookies do grupo.\n\n### **Methods:**\n - **handleGroupSelectedChange(newValue: _boolean_)** - Observa mudanças externas em `groupSelected` (propagação top-down do `br-cookiebar`).\nPropaga o novo valor para todos os cookies opt-out filhos e atualiza os contadores.\nIgnorado quando a mudança é originada internamente pelo recálculo bottom-up.\n- **handleCookieChange()** - Escuta o evento `brCookiebarCookieChange` emitido por qualquer `br-cookiebar-cookie` filho.\nRecalcula o estado do grupo (marcado / desmarcado / indeterminado) com base\nno estado atual de todos os cookies opt-out. Ignorado durante propagações top-down.\n- **getState(): _Promise<CookiebarSelectionState>_** - Retorna o estado atual de seleção do grupo:\n- `true`: todos os cookies opt-out estão selecionados.\n- `false`: nenhum cookie opt-out está selecionado.\n- `'indeterminate'`: seleção parcial.\n\n### **Slots:**\n - **default** - Recebe os subcomponentes `br-cookiebar-cookie` do grupo.\n\n### **CSS Parts:**\n - **container** - Div raiz do grupo.\n- **header** - Linha de cabeçalho com nome, contadores e controles.\n- **body** - Área expansível que contém os cookies.",
+      "description": "Uma categoria de cookies dentro do `br-cookiebar`, como \"Necessários\" ou \"Estatísticas\". Contém um `br-cookiebar-cookie` para cada cookie.\n\nInforme `group-id`, `group-name` e `group-text`. Use `group-opt-out=\"false\"` quando a categoria não puder ser desativada: ela aparece como \"Sempre ativo\".\n---\n\n\n### **Events:**\n - **brCookiebarGroupChange** - Emitido quando o estado de seleção do grupo muda (por interação do usuário ou propagação).\nO `br-cookiebar` pai escuta este evento para recalcular o checkbox \"Selecionar todos\".\n- **brCookiebarGroupToggle** - Emitido ao expandir ou recolher a lista de cookies do grupo.\n\n### **Methods:**\n - **handleGroupSelectedChange(newValue: _boolean_)** - Observa mudanças externas em `groupSelected` (propagação top-down do `br-cookiebar`).\nPropaga o novo valor para todos os cookies opt-out filhos e atualiza os contadores.\nIgnorado quando a mudança é originada internamente pelo recálculo bottom-up.\n- **handleCookieChange()** - Escuta o evento `brCookiebarCookieChange` emitido por qualquer `br-cookiebar-cookie` filho.\nRecalcula o estado do grupo (marcado / desmarcado / indeterminado) com base\nno estado atual de todos os cookies opt-out. Ignorado durante propagações top-down.\n- **getState(): _Promise<CookiebarSelectionState>_** - Retorna o estado atual de seleção do grupo:\n- `true`: todos os cookies opt-out estão selecionados.\n- `false`: nenhum cookie opt-out está selecionado.\n- `'indeterminate'`: seleção parcial.\n\n### **Slots:**\n - **default** - Recebe os subcomponentes `br-cookiebar-cookie` do grupo.\n\n### **CSS Parts:**\n - **container** - Div raiz do grupo.\n- **header** - Linha de cabeçalho com nome, contadores e controles.\n- **body** - Área expansível que contém os cookies.",
       "attributes": [
         {
           "name": "custom-id",
@@ -916,7 +916,7 @@
     },
     {
       "name": "br-cookiebar-header",
-      "description": "O componente `br-cookiebar-header` é o subcomponente de topo do GovBR-DS que apresenta o título e o texto introdutório do aviso de cookies.\n\n### Para que serve\n\n- **Apresentação do contexto:** Explica resumidamente a finalidade do aviso de privacidade.\n- **Identificação visual:** Fornece o cabeçalho padronizado da barra de cookies.\n\n### Papel na composição\n\nAtua como elemento introdutório estrutural do `br-cookiebar`.\n\n### Regra de uso e relacionamento\n\n- Deve ser posicionado no slot de cabeçalho do `br-cookiebar`.\n- Não deve ser utilizado de forma independente fora do aviso de cookies.\n---\n\n\n### **Slots:**\n - **default** - Conteúdo HTML personalizado que substitui o layout estruturado. Quando preenchido, as props `main-title`, `entry-text` e `last-update` são ignoradas.\n\n### **CSS Parts:**\n - **container** - Div raiz do cabeçalho.",
+      "description": "Título e texto de introdução do painel do `br-cookiebar`. Use no slot `header` do cookiebar.\n\nInforme `main-title`, `entry-text` e, se quiser, a data em `last-update`. Para outro layout, coloque seu próprio conteúdo dentro do componente.\n---\n\n\n### **Slots:**\n - **default** - Conteúdo HTML personalizado que substitui o layout estruturado. Quando preenchido, as props `main-title`, `entry-text` e `last-update` são ignoradas.\n\n### **CSS Parts:**\n - **container** - Div raiz do cabeçalho.",
       "attributes": [
         {
           "name": "custom-id",
@@ -948,7 +948,7 @@
     },
     {
       "name": "br-cookiebar-link",
-      "description": "O componente `br-cookiebar-link` é o subcomponente de hiperlink do GovBR-DS destinado a apontar para Políticas de Privacidade, Termos de Uso e orientações legais.\n\n### Para que serve\n\n- **Acesso a termos legais:** Encaminha a pessoa usuária para a documentação completa de proteção de dados.\n- **Estilo consistente:** Garante conformidade visual e acessibilidade no contexto do aviso de cookies.\n\n### Papel na composição\n\nAtua como item de navegação auxiliar no aviso de cookies.\n\n### Regra de uso e relacionamento\n\n- Pode ser utilizado dentro do cabeçalho, notas ou corpo do componente `br-cookiebar`.\n---\n\n\n### **Events:**\n - **brNavigate** - Evento cancelável emitido em `navigation-mode=\"event\"` para cliques primários sem modificadores em links `_self`.\nChame `event.preventDefault()` no listener para impedir a navegação nativa e entregar `event.detail.href` ao roteador da SPA.\n\n### **CSS Parts:**\n - **link** - Elemento âncora (`<a>`) do link.",
+      "description": "Link do `br-cookiebar` para a política de privacidade ou os termos de uso. Use no slot `links` do cookiebar.\n\nInforme `name` e `href`. Em SPA, use `navigation-mode=\"event\"` e trate o evento `brNavigate`.\n---\n\n\n### **Events:**\n - **brNavigate** - Evento cancelável emitido em `navigation-mode=\"event\"` para cliques primários sem modificadores em links `_self`.\nChame `event.preventDefault()` no listener para impedir a navegação nativa e entregar `event.detail.href` ao roteador da SPA.\n\n### **CSS Parts:**\n - **link** - Elemento âncora (`<a>`) do link.",
       "attributes": [
         {
           "name": "custom-id",
@@ -980,7 +980,7 @@
     },
     {
       "name": "br-cookiebar-note",
-      "description": "O componente `br-cookiebar-note` é o subcomponente textual do GovBR-DS que exibe notas explicativas, orientações complementares ou avisos jurídicos adicionais.\n\n### Para que serve\n\n- **Notas de rodapé do aviso:** Apresenta esclarecimentos sobre retenção de dados, atualizações de termos ou exceções regulatórias.\n\n### Papel na composição\n\nAtua como bloco textual informativo complementar.\n\n### Regra de uso e relacionamento\n\n- Deve ser utilizado diretamente no `br-cookiebar` ou dentro de um `br-cookiebar-note-group`.\n---\n\n\n### **CSS Parts:**\n - **container** - Div raiz do item.\n- **question** - Parágrafo da pergunta.\n- **answer** - Parágrafo da resposta.",
+      "description": "Uma pergunta e resposta complementar no painel do `br-cookiebar`. Informe `question` e `answer`.\n\nPara reunir várias notas, coloque-as em um `br-cookiebar-note-group`.\n---\n\n\n### **CSS Parts:**\n - **container** - Div raiz do item.\n- **question** - Parágrafo da pergunta.\n- **answer** - Parágrafo da resposta.",
       "attributes": [
         {
           "name": "custom-id",
@@ -998,7 +998,7 @@
     },
     {
       "name": "br-cookiebar-note-group",
-      "description": "O componente `br-cookiebar-note-group` é o subcomponente contêiner do GovBR-DS que agrupa uma ou mais notas informativas `br-cookiebar-note`.\n\n### Para que serve\n\n- **Estruturação de notas:** Agrupa avisos jurídicos e observações complementares em uma seção visualmente delimitada.\n\n### Papel na composição\n\nAtua como contêiner estrutural para instâncias de `br-cookiebar-note`.\n\n### Regra de uso e relacionamento\n\n- Deve ser inserido na seção de notas informativas do `br-cookiebar`.\n---\n\n\n### **Events:**\n - **brCookiebarNoteGroupToggle** - Emitido ao expandir ou recolher a seção.\n\n### **Slots:**\n - **default** - Recebe `br-cookiebar-note` ou qualquer conteúdo HTML livre.\n\n### **CSS Parts:**\n - **container** - Div raiz do grupo.\n- **header** - Cabeçalho acessível que expande ou recolhe o conteúdo.\n- **content** - Área de conteúdo exibida quando o grupo está expandido.",
+      "description": "Agrupa notas do `br-cookiebar` em uma seção que pode ser expandida. O título vem de `note-title`.\n\nColoque dentro dele elementos `br-cookiebar-note` ou outro conteúdo.\n---\n\n\n### **Events:**\n - **brCookiebarNoteGroupToggle** - Emitido ao expandir ou recolher a seção.\n\n### **Slots:**\n - **default** - Recebe `br-cookiebar-note` ou qualquer conteúdo HTML livre.\n\n### **CSS Parts:**\n - **container** - Div raiz do grupo.\n- **header** - Cabeçalho acessível que expande ou recolhe o conteúdo.\n- **content** - Área de conteúdo exibida quando o grupo está expandido.",
       "attributes": [
         {
           "name": "custom-id",
@@ -1020,7 +1020,7 @@
     },
     {
       "name": "br-datetime-picker",
-      "description": "O `br-datetime-picker` é o controle completo do GovBR-DS para digitação e seleção visual de datas e horários. Orquestra o campo textual e os seletores internos, consolidando valor, validação e integração com formulários HTML.\n\n### Para que serve\n\n- Oferece os modos `date`, `time` e `datetime`, com seleção única (`single`) ou de intervalo (`range`).\n- Combina edição textual com máscara, calendário e ajuste de horas e minutos conforme o modo escolhido.\n- Centraliza restrições de seleção, validação e submissão do valor por meio de `formAssociated`.\n\n### Quando utilizar\n\n- Utilize quando o formulário precisar de um controle completo de data ou horário com digitação e seleção visual.\n- Utilize para períodos com início e fim, inclusive com horários nos modos `time` e `datetime`.\n- Evite quando precisar apenas apresentar uma data: prefira texto formatado.\n- Para um calendário permanentemente visível sem o campo textual, considere `br-date-picker`; a aplicação assume a integração com o restante do formulário.\n- A seleção não oferece uma coleção de datas independentes: use `single` para um valor ou `range` para um intervalo.\n\n### Composição e Subcomponentes\n\n| Componente | Papel | Regra de uso |\n| --- | --- | --- |\n| `br-datetime-picker` | Orquestrador do valor consolidado, validação, formulário e abertura do painel. | Declare este controle no template para obter a composição completa. |\n| `br-datetime-input` | Campo textual com máscara, interpretação da entrada e ação de abertura do painel. | Instanciado internamente pelo pai; não deve ser fornecido em slot. |\n| `br-date-picker` | Calendário para navegação e seleção de data única ou intervalo. | Criado pelo pai nos modos `date` e `datetime`; pode ser usado isoladamente como calendário embutido. |\n| `br-time-picker` | Controles de hora e minuto. | Criado pelo pai nos modos `time` e `datetime`, com uma instância por limite quando a seleção é `range`. |\n\nO slot `feedback` recebe conteúdo declarativo de validação, normalmente um `br-message`; não substitui os seletores internos.\n\n### Como os subcomponentes se relacionam\n\nO pai fornece valores e configurações aos filhos por propriedades e consolida suas alterações por eventos DOM. O campo textual solicita a abertura do painel; o calendário e os controles de horário atualizam a seleção compartilhada, sem coordenar diretamente uns aos outros.\n\n`referenceDate` representa a referência de navegação visual, distinta da seleção efetiva. O orquestrador mantém o campo textual, os seletores e o valor de formulário sincronizados. A aplicação consome o valor e os eventos do pai, incluindo `brDatetimePickerChange` para a seleção completa e tipada.\n\nO uso isolado dos filhos exige que a aplicação assuma a coordenação de estado, validação e formulário; eles não herdam a associação nativa ao formulário do `br-datetime-picker`.\n\nPara a documentação completa de design, incluindo diretrizes de uso, acessibilidade e exemplos visuais, consulte o [Design System do GovBR](https://www.gov.br/ds/components/datetimepicker?tab=designer).\n---\n\n\n### **Events:**\n - **dateStateChange** - Evento público emitido quando a data de referência ou a seleção mudam.\n\nPayload (`DatetimePickerDateState`):\n- `referenceDate`: Date — data usada para navegação visual (mês/semana exibidos).\n- `value`: Date | null — valor selecionado atualmente.\n- **brDatetimePickerChange** - Evento público canônico emitido quando a seleção muda.\n\nPayload (`DatetimePickerChangeDetail`):\n- `mode`: DatetimePickerMode — modo atual do componente (`date` | `time` | `datetime`).\n- `selectionMode`: DatetimePickerSelectionMode — `single` ou `range`.\n- `value`: Date | null | DatetimePickerDateRange — seleção atual (tipo depende de `selectionMode`).\n- `serializedValue`: string | undefined — representação serializada para integração com formulários.\n- **valueChange** - Evento emitido quando o valor selecionado muda.\n- **brDatetimePickerValidationChange** - Emitido ao iniciar e concluir a validação customizada.\n\nPayload (`FormValidationChangeDetail`):\n- `validating`: boolean — indica se a validação está em execução.\n- `valid`: boolean | null — resultado da validação (`null` enquanto valida).\n- `message`: string | null — mensagem de validação associada.\n\n### **Methods:**\n - **handleModeChange(newValue: _string_)** - Revalida o modo sempre que a prop mudar.\n- **handleRequiredChange()** - Revalida o estado do formulário quando required mudar.\n- **handleDisabledChange()** - Exclui o valor do FormData enquanto o componente estiver desabilitado.\n- **handleSelectionModeChange(newValue: _DatetimePickerSelectionMode_)** - Reage a mudanças no modo de seleção e limpa intervalo quando necessário.\n- **handleWeekStartsOnChange(newValue: _DatetimePickerWeekDayIndex_)** - Revalida o dia inicial da semana sempre que a prop mudar.\n- **handleInitialMomentChange(newValue: _DatetimePickerInitialMoment_)** - Aplica ou limpa a seleção da data atual conforme o novo valor da prop.\n- **handleValueChange(newValue: _Date | null_)** - Sincroniza alterações externas do valor com o estado visual e o formulário nativo.\n- **handleSerializedValueChange(newValue: _string_)** - Converte alterações externas no valor serializado sem mudar o tipo da prop legada `value`.\n- **handleValueAsDateChange(newValue: _Date | null_)** - Mantém `valueAsDate` e a prop legada `value` apontando para o mesmo estado observável.\n- **handleDisabledDatesChange(newValue: _DatetimePickerDisabledDates_)** - Recalcula a lista de datas desabilitadas quando a prop mudar.\n- **formResetCallback()** - Restaura o estado do componente quando o formulário é restaurado.\n- **formStateRestoreCallback(state: _string | File | FormData | null_)** - Restaura o estado do formulário (autofill / histórico).\n- **setDisabledDates(dates: _DatetimePickerDisabledDate[] | null_): _Promise<void>_** - Define programaticamente as datas desabilitadas.\n\nUse quando scripts externos precisam fornecer uma lista tipada de\ndatas a bloquear no calendário. Substitui a prop `disabledDates` para\natualizações imperativas.\n- **setValue(value: _Date | string | null_): _Promise<void>_** - Define o valor do componente de forma imperativa.\n\nAceita `Date`, string compatível com o `mode`, ou `null` para limpar a seleção.\nValidação de datas desabilitadas é aplicada antes da atribuição.\n- **getValue(): _Promise<Date | null>_** - Retorna uma cópia do valor selecionado atualmente.\n- **clear(): _Promise<void>_** - Limpa valor e intervalo selecionados.\n\nRemove seleção atual e restaura a referência de navegação para a data atual.\n- **open(): _Promise<void>_** - Abre o picker quando o componente estiver habilitado.\n- **close(): _Promise<void>_** - Fecha o picker.\n- **toggle(): _Promise<void>_** - Alterna o estado de abertura do picker.\n- **focusInput(): _Promise<void>_** - Move o foco para o input nativo interno.\n- **setRange(start: _Date | string | null_, end: _Date | string | null_): _Promise<void>_** - Define um intervalo no modo atual e ativa `selectionMode=\"range\"`.\n\nValida datas contra bloqueios e sincroniza estado visual e de formulário.\nEm `datetime`, mantém os limites informados e sinaliza intervalo inválido\nquando o término precede o início, sem ajustar datas automaticamente.\n- **getRange(): _Promise<{ start: Date | null; end: Date | null } | null>_** - Retorna o intervalo de datas selecionado quando em modo `selectionMode=\"range\"`.\n- **isOpen(): _Promise<boolean>_** - Consulta se o picker está atualmente aberto.\n- **resetToInitial(): _Promise<void>_** - Restaura o estado inicial atualmente registrado para reset.\n- **checkValidity(): _Promise<boolean>_** - Permite que consumidores acionem validação nativa do formulário via host.\n- **reportValidity(): _Promise<boolean>_** - Permite exibir mensagens nativas de validação no host.\n- **setCustomValidity(message: _string_): _Promise<void>_** - Define ou limpa uma mensagem de validade customizada.\n- **validate(): _Promise<boolean>_** - Executa o validator customizado (se houver) e valida o controle.\n\nEmite eventos de início/conclusão da validação e atualiza mensagens internas.\n- **getValidationState(): _Promise<FormValidationState>_** - Retorna um snapshot serializável da Constraint Validation API.\n- **render()** - Renderização principal do componente.\n\n### **Slots:**\n - **feedback** - Mensagem de validação, normalmente um `br-message`.\n\n### **CSS Parts:**\n - **container** - Parte para o container base do seletor.\n- **panel** - Parte para o painel em forma de card que engloba o seletor.\n- **input-container** - Container base do campo de entrada interno.\n- **input-field** - Campo textual interno.\n- **input-icon** - Ícone de ação (calendário/relógio).\n- **feedback** - Contêiner da mensagem de validação.",
+      "description": "O `br-datetime-picker` é um campo para informar data, hora ou data e hora. A pessoa pode digitar ou escolher no calendário e nos controles de horário.\n\nEscolha o tipo em `mode`: `date`, `time` ou `datetime`. Para início e fim, use `selection-mode=\"range\"`.\n\n```html\n<br-datetime-picker mode=\"date\" name=\"nascimento\" required></br-datetime-picker>\n\n<br-datetime-picker mode=\"date\" selection-mode=\"range\" name=\"periodo\"></br-datetime-picker>\n```\n\n### Ler o valor\n\n| Onde | Formato |\n| --- | --- |\n| `value` | `Date` (ou `null`) |\n| `rangeValue` | `{ start, end }` com `Date` |\n| `serialized-value` e envio do formulário | `2026-05-20` (data), `14:30` (hora), `2026-05-20T14:30:00-03:00` (data e hora), `início/fim` (intervalo) |\n\nAtribua valores do tipo `Date` pelo JavaScript (`picker.value = new Date()`), não por atributo. Para restringir datas, use `min`, `max` e `disabled-dates`.\n\n### Quando usar\n\n- Formulários que pedem uma data, um horário ou um período.\n\n### Quando evitar\n\n- Para só exibir uma data: use texto formatado.\n- Para escolher várias datas soltas: o componente aceita uma data ou um intervalo.\n\nO calendário (`br-date-picker`), os controles de horário (`br-time-picker`) e o campo de texto (`br-datetime-input`) são criados pelo próprio componente; não é preciso declará-los.\n\nConsulte as [diretrizes de design do GovBR](https://www.gov.br/ds/components/datetimepicker?tab=designer).\n---\n\n\n### **Events:**\n - **dateStateChange** - Evento público emitido quando a data de referência ou a seleção mudam.\n\nPayload (`DatetimePickerDateState`):\n- `referenceDate`: Date — data usada para navegação visual (mês/semana exibidos).\n- `value`: Date | null — valor selecionado atualmente.\n- **brDatetimePickerChange** - Evento emitido quando a seleção muda.\n\nPayload (`DatetimePickerChangeDetail`):\n- `mode`: DatetimePickerMode — modo atual do componente (`date` | `time` | `datetime`).\n- `selectionMode`: DatetimePickerSelectionMode — `single` ou `range`.\n- `value`: Date | null | DatetimePickerDateRange — seleção atual (tipo depende de `selectionMode`).\n- `serializedValue`: string | undefined — representação serializada para integração com formulários.\n- **valueChange** - Evento emitido quando o valor selecionado muda.\n- **brDatetimePickerValidationChange** - Emitido ao iniciar e concluir a validação customizada.\n\nPayload (`FormValidationChangeDetail`):\n- `validating`: boolean — indica se a validação está em execução.\n- `valid`: boolean | null — resultado da validação (`null` enquanto valida).\n- `message`: string | null — mensagem de validação associada.\n\n### **Methods:**\n - **handleModeChange(newValue: _string_)** - Revalida o modo sempre que a prop mudar.\n- **handleRequiredChange()** - Revalida o estado do formulário quando required mudar.\n- **handleDisabledChange()** - Exclui o valor do FormData enquanto o componente estiver desabilitado.\n- **handleSelectionModeChange(newValue: _DatetimePickerSelectionMode_)** - Reage a mudanças no modo de seleção e limpa intervalo quando necessário.\n- **handleWeekStartsOnChange(newValue: _DatetimePickerWeekDayIndex_)** - Revalida o dia inicial da semana sempre que a prop mudar.\n- **handleInitialMomentChange(newValue: _DatetimePickerInitialMoment_)** - Aplica ou limpa a seleção da data atual conforme o novo valor da prop.\n- **handleValueChange(newValue: _Date | null_)** - Sincroniza alterações externas do valor com o estado visual e o formulário nativo.\n- **handleSerializedValueChange(newValue: _string_)** - Converte alterações externas no valor serializado sem mudar o tipo da prop legada `value`.\n- **handleValueAsDateChange(newValue: _Date | null_)** - Mantém `valueAsDate` e a prop legada `value` apontando para o mesmo estado observável.\n- **handleDisabledDatesChange(newValue: _DatetimePickerDisabledDates_)** - Recalcula a lista de datas desabilitadas quando a prop mudar.\n- **formResetCallback()** - Restaura o estado do componente quando o formulário é restaurado.\n- **formStateRestoreCallback(state: _string | File | FormData | null_)** - Restaura o estado do formulário (autofill / histórico).\n- **setDisabledDates(dates: _DatetimePickerDisabledDate[] | null_): _Promise<void>_** - Define programaticamente as datas desabilitadas.\n\nUse quando scripts externos precisam fornecer uma lista tipada de\ndatas a bloquear no calendário. Substitui a prop `disabledDates` para\natualizações imperativas.\n- **setValue(value: _Date | string | null_): _Promise<void>_** - Define o valor do componente de forma imperativa.\n\nAceita `Date`, string compatível com o `mode`, ou `null` para limpar a seleção.\nValidação de datas desabilitadas é aplicada antes da atribuição.\n- **getValue(): _Promise<Date | null>_** - Retorna uma cópia do valor selecionado atualmente.\n- **clear(): _Promise<void>_** - Limpa valor e intervalo selecionados.\n\nRemove seleção atual e restaura a referência de navegação para a data atual.\n- **open(): _Promise<void>_** - Abre o picker quando o componente estiver habilitado.\n- **close(): _Promise<void>_** - Fecha o picker.\n- **toggle(): _Promise<void>_** - Alterna o estado de abertura do picker.\n- **focusInput(): _Promise<void>_** - Move o foco para o input nativo interno.\n- **setRange(start: _Date | string | null_, end: _Date | string | null_): _Promise<void>_** - Define um intervalo no modo atual e ativa `selectionMode=\"range\"`.\n\nValida datas contra bloqueios e sincroniza estado visual e de formulário.\nEm `datetime`, mantém os limites informados e sinaliza intervalo inválido\nquando o término precede o início, sem ajustar datas automaticamente.\n- **getRange(): _Promise<{ start: Date | null; end: Date | null } | null>_** - Retorna o intervalo de datas selecionado quando em modo `selectionMode=\"range\"`.\n- **isOpen(): _Promise<boolean>_** - Consulta se o picker está atualmente aberto.\n- **resetToInitial(): _Promise<void>_** - Restaura o estado inicial atualmente registrado para reset.\n- **checkValidity(): _Promise<boolean>_** - Permite que consumidores acionem validação nativa do formulário via host.\n- **reportValidity(): _Promise<boolean>_** - Permite exibir mensagens nativas de validação no host.\n- **setCustomValidity(message: _string_): _Promise<void>_** - Define ou limpa uma mensagem de validade customizada.\n- **validate(): _Promise<boolean>_** - Executa o validator customizado (se houver) e valida o controle.\n\nEmite eventos de início/conclusão da validação e atualiza mensagens internas.\n- **getValidationState(): _Promise<FormValidationState>_** - Retorna um snapshot serializável da Constraint Validation API.\n- **render()** - Renderização principal do componente.\n\n### **Slots:**\n - **feedback** - Mensagem de validação, normalmente um `br-message`.\n\n### **CSS Parts:**\n - **container** - Parte para o container base do seletor.\n- **panel** - Parte para o painel em forma de card que engloba o seletor.\n- **input-container** - Container base do campo de entrada interno.\n- **input-field** - Campo textual interno.\n- **input-icon** - Ícone de ação (calendário/relógio).\n- **feedback** - Contêiner da mensagem de validação.",
       "attributes": [
         {
           "name": "mode",
@@ -1113,7 +1113,7 @@
     },
     {
       "name": "br-date-picker",
-      "description": "O `br-date-picker` é o subcomponente de calendário do `br-datetime-picker`, responsável pela seleção visual de uma data ou de um intervalo.\n\n### Papel na composição\n\nExibe a grade mensal, a navegação entre meses e anos e os estados de seleção e bloqueio dos dias. `referenceDate` determina o período exibido, enquanto `value` e os limites do intervalo representam a seleção.\n\n### Regra de uso e relacionamento\n\nO `br-datetime-picker` instancia e configura este calendário internamente nos modos `date` e `datetime`, recebendo suas alterações pelo evento `dateStateChange`. Não declare o calendário em um slot do pai.\n\nUse diretamente quando precisar de um calendário embutido e permanentemente visível. Nesse caso, a aplicação deve coordenar valores e eventos e implementar a integração com formulários e a validação do fluxo completo. O calendário isolado não fornece o campo textual, o seletor de horários nem a associação ao formulário do orquestrador.\n\nPara a documentação completa de design, incluindo diretrizes de uso, acessibilidade e exemplos visuais, consulte o [Design System do GovBR](https://www.gov.br/ds/components/date-picker?tab=designer).\n---\n\n\n### **Events:**\n - **dateStateChange** - Emite o estado consolidado do componente quando há mudança de referência/seleção.\n\nPayload (DatetimePickerDateState):\n\n### **Methods:**\n - **handleValueChange(newValue: _Date | null_)** - Sincroniza `focusedDate` quando o valor selecionado muda externamente.\n- **handleWeekStartsOnChange(newValue: _number_)** - Revalida a configuração quando o início da semana muda.\n- **handleLocaleChange(newValue: _string_)** - Revalida o locale quando a prop muda.\n\n### **CSS Parts:**\n - **container** - Parte para o container base do calendário.\n- **header** - Cabeçalho do calendário (contendo navegação e seleção de mês/ano).\n- **month-select** - Elemento de seleção do mês.\n- **year-input** - Elemento de entrada do ano.\n- **calendar** - Grade geral do calendário.\n- **weekdays** - Container para os rótulos dos dias da semana.\n- **weekday** - Rótulo individual do dia da semana.\n- **grid** - Grade de dias do mês.\n- **day** - Célula individual do dia no calendário.",
+      "description": "Calendário usado pelo `br-datetime-picker`. Também pode ser usado sozinho, quando a tela precisa de um calendário sempre visível.\n\nUsado sozinho, ele não tem campo de texto nem participa de formulário: a aplicação lê a seleção e cuida da validação.\n\n```html\n<br-date-picker id=\"agenda\"></br-date-picker>\n```\n\n```js\nconst calendario = document.querySelector('#agenda');\ncalendario.addEventListener('change', () => console.log(calendario.value));\n```\n\n- `value`: data selecionada (`Date`).\n- `referenceDate`: mês exibido.\n- `disabledDates`: datas que não podem ser escolhidas.\n- `selectionMode=\"range\"`: seleção de intervalo, lida em `rangeValue`.\n\nPara mudar o idioma, veja \"Idiomas\" na documentação do `br-datetime-picker`.\n---\n\n\n### **Events:**\n - **dateStateChange** - Emite o estado consolidado do componente quando há mudança de referência/seleção.\n\nPayload (DatetimePickerDateState):\n\n### **Methods:**\n - **handleValueChange(newValue: _Date | null_, oldValue: _Date | null_)** - Sincroniza `focusedDate` quando o valor selecionado muda externamente.\n- **handleWeekStartsOnChange(newValue: _number_)** - Revalida a configuração quando o início da semana muda.\n- **handleLocaleChange(newValue: _string_)** - Revalida o locale quando a prop muda.\n\n### **CSS Parts:**\n - **container** - Parte para o container base do calendário.\n- **header** - Cabeçalho do calendário (contendo navegação e seleção de mês/ano).\n- **month-select** - Elemento de seleção do mês.\n- **year-input** - Elemento de entrada do ano.\n- **calendar** - Grade geral do calendário.\n- **weekdays** - Container para os rótulos dos dias da semana.\n- **weekday** - Rótulo individual do dia da semana.\n- **grid** - Grade de dias do mês.\n- **day** - Célula individual do dia no calendário.",
       "attributes": [
         {
           "name": "week-starts-on",
@@ -1175,7 +1175,7 @@
     },
     {
       "name": "br-datetime-input",
-      "description": "O `br-datetime-input` é o subcomponente de edição textual do `br-datetime-picker`, com máscara, interpretação de datas e horários e validação local sobre um `br-input` interno.\n\n### Papel na composição\n\nExibe e permite editar a seleção única ou os limites de um intervalo nos modos `date`, `time` e `datetime`. Comunica alterações por `dateStateChange`, informa a validação local por `inputValidationChange` e solicita a abertura ou o fechamento do painel por `togglePicker`.\n\n### Regra de uso e relacionamento\n\nO `br-datetime-picker` instancia este campo internamente e fornece valores e configurações por propriedades. O pai coordena a seleção com o calendário e os controles de horário; o campo não abre esses seletores por conta própria nem deve ser fornecido em slot.\n\nPrefira o `br-datetime-picker` para o controle completo. Use o campo isoladamente apenas em composições personalizadas nas quais a aplicação assuma a sincronização de estado, o tratamento dos eventos e a integração com formulários. Este subcomponente não possui a associação nativa ao formulário do orquestrador.\n\nConsulte também as [diretrizes de design do GovBR](https://www.gov.br/ds/components/datetime?tab=designer).\n---\n\n\n### **Events:**\n - **dateStateChange** - Evento emitido quando o estado de data/hora muda (após commit ou parsing).\n\nPayload (`detail`):\n- **togglePicker** - Emite uma solicitação ao componente pai para alternar a abertura do picker.\nEmite sem payload.\n- **inputValidationChange** - Emite validação do texto digitado sem alterar o valor selecionado.\n\nPayload (`detail`):\n\n### **Methods:**\n - **handleRangeValueChange(newValue: _DatetimePickerDateRange | undefined_): _void_** - Watcher: sincroniza `rangeStart`/`rangeEnd` a partir de `rangeValue` controlado.\n- **handleValueChange(newValue: _Date | null_): _void_** - Watcher: reage a mudanças externas em `value`, normalizando e sincronizando\no texto exibido no input.\n- **handleModeChange(newValue: _string_): _void_** - Watcher: aplica normalização do `mode` e atualiza a máscara/valor exibido.\n- **handleReferenceDateChange(newValue: _Date_): _void_** - Watcher: valida `referenceDate` e resina o input quando não há seleção.\n- **handleRangeStartChange(newValue): _void_** - Watcher: atualiza a representação textual quando o início do range muda.\n- **handleRangeEndChange(newValue): _void_** - Watcher: atualiza a representação textual quando o fim do range muda.\n- **render()** - Renderização principal do componente.\n\n### **CSS Parts:**\n - **container** - Container do campo.\n- **input** - Elemento de entrada textual interno.\n- **icon** - Ícone de ação (calendário/relógio).",
+      "description": "Campo de texto com máscara usado pelo `br-datetime-picker`. Interpreta a data ou a hora digitada e abre o calendário pelo botão do campo.\n\nÉ criado pelo `br-datetime-picker`; não é preciso declará-lo. Para um campo de data em formulário, use o `br-datetime-picker`.\n---\n\n\n### **Events:**\n - **dateStateChange** - Evento emitido quando o estado de data/hora muda (após commit ou parsing).\n\nPayload (`detail`):\n- **togglePicker** - Emite uma solicitação ao componente pai para alternar a abertura do picker.\nEmite sem payload.\n- **inputValidationChange** - Emite validação do texto digitado sem alterar o valor selecionado.\n\nPayload (`detail`):\n\n### **Methods:**\n - **handleRangeValueChange(newValue: _DatetimePickerDateRange | undefined_): _void_** - Watcher: sincroniza `rangeStart`/`rangeEnd` a partir de `rangeValue` controlado.\n- **handleValueChange(newValue: _Date | null_): _void_** - Watcher: reage a mudanças externas em `value`, normalizando e sincronizando\no texto exibido no input.\n- **handleModeChange(newValue: _string_): _void_** - Watcher: aplica normalização do `mode` e atualiza a máscara/valor exibido.\n- **handleReferenceDateChange(newValue: _Date_): _void_** - Watcher: valida `referenceDate` e resina o input quando não há seleção.\n- **handleRangeStartChange(newValue): _void_** - Watcher: atualiza a representação textual quando o início do range muda.\n- **handleRangeEndChange(newValue): _void_** - Watcher: atualiza a representação textual quando o fim do range muda.\n- **render()** - Renderização principal do componente.\n\n### **CSS Parts:**\n - **container** - Container do campo.\n- **input** - Elemento de entrada textual interno.\n- **icon** - Ícone de ação (calendário/relógio).",
       "attributes": [
         {
           "name": "placeholder",
@@ -1227,7 +1227,7 @@
     },
     {
       "name": "br-time-picker",
-      "description": "O `br-time-picker` é o subcomponente de ajuste de horas e minutos do `br-datetime-picker`.\n\n### Papel na composição\n\nOferece campos textuais e botões de incremento e decremento para hora e minuto. Usa uma data de referência e comunica alterações por `dateStateChange`; não coordena diretamente o calendário nem o campo textual principal.\n\n### Regra de uso e relacionamento\n\nO `br-datetime-picker` instancia e sincroniza este seletor nos modos `time` e `datetime`. Na seleção de intervalo, o pai cria dois seletores, um para o início e outro para o fim, e consolida os respectivos valores. Não forneça seletores de horário em slots do pai.\n\nPrefira o orquestrador para um controle completo de horário com campo textual e formulário. Use diretamente apenas quando precisar dos controles de hora e minuto em uma composição personalizada e assumir a sincronização de estado, a validação e a integração com formulários. O uso isolado não herda a associação nativa ao formulário do pai.\n\nConsulte também as [diretrizes de design do GovBR](https://www.gov.br/ds/components/time-picker?tab=designer).\n---\n\n\n### **Events:**\n - **dateStateChange** - Evento emitido sempre que `referenceDate` ou `value` são atualizados.\n\nO `detail` segue a forma de `DatetimePickerDateState` e contém o estado\ncompartilhado entre subcomponentes de data e horário.\n\nPayload (`detail`):\n\n### **Methods:**\n - **handleValueChange(newValue: _Date | null_): _void_** - Sincroniza `referenceDate` quando a prop `value` muda.\n\nNormaliza segundos/milissegundos e restaura rascunhos locais.\n- **render(): _JSX.Element_** - Render principal do componente.\n\n### **CSS Parts:**\n - **container** - Container base do seletor de horários.\n- **timer** - Grupo que contém os campos de hora e minuto.\n- **field** - Campo de tempo com botões de ajuste.\n- **separator** - Separador visual entre hora e minuto.\n- **input** - Campo de entrada textual interno do tempo.",
+      "description": "Controles de hora e minuto usados pelo `br-datetime-picker`. Em um intervalo, o componente cria um controle para o início e outro para o fim.\n\nPara um campo de horário em formulário, use `<br-datetime-picker mode=\"time\">`. Usado sozinho, ele não participa de formulário: leia o horário em `value` e trate a validação na aplicação.\n---\n\n\n### **Events:**\n - **dateStateChange** - Evento emitido sempre que `referenceDate` ou `value` são atualizados.\n\nO `detail` segue a forma de `DatetimePickerDateState` e contém o estado\ncompartilhado entre subcomponentes de data e horário.\n\nPayload (`detail`):\n\n### **Methods:**\n - **handleValueChange(newValue: _Date | null_): _void_** - Sincroniza `referenceDate` quando a prop `value` muda.\n\nNormaliza segundos/milissegundos e restaura rascunhos locais.\n- **render(): _JSX.Element_** - Render principal do componente.\n\n### **CSS Parts:**\n - **container** - Container base do seletor de horários.\n- **timer** - Grupo que contém os campos de hora e minuto.\n- **field** - Campo de tempo com botões de ajuste.\n- **separator** - Separador visual entre hora e minuto.\n- **input** - Campo de entrada textual interno do tempo.",
       "attributes": [
         {
           "name": "reference-date",
@@ -1236,7 +1236,7 @@
         },
         {
           "name": "value",
-          "description": "Valor canônico selecionado pelo usuário.",
+          "description": "Valor selecionado pelo usuário.",
           "values": [{ "name": "Date" }]
         },
         {
@@ -1249,7 +1249,7 @@
     },
     {
       "name": "br-divider",
-      "description": "O componente `br-divider` é o elemento separador visual e semântico do GovBR-DS, utilizado para demarcar limites claros entre seções, listas de conteúdos ou áreas temáticas da página.\n\n### Para que serve\n\n- **Separação visual estruturada:** Cria linhas divisórias sutis horizontais ou verticais para organizar blocos de informação com espaçamentos padronizados.\n- **Rotulação intermediária:** Permite incluir texto (ex.: \"ou\"), ícones ou outros elementos centralizados ao longo da linha divisória através do slot padrão.\n- **Variações visuais:** Suporta estilos contínuos, tracejados (`dashed`) e diferentes densidades para se adequar ao leiaute.\n\n### Quando utilizar\n\n- **Utilize quando:**\n  - Houver necessidade de indicar explicitamente o término de um bloco temático e o início de outro.\n  - Separar alternativas com um divisor textual (ex.: \"Entrar com conta Gov.BR\" --- ou --- \"Entrar com certificado digital\").\n  - Dividir colunas de rodapés, menus laterais ou cabeçalhos.\n- **Evite e prefira outro componente quando:**\n  - Os espaçamentos em branco (margens e paddings) já forem suficientes para garantir a percepção de separação sem sobrecarregar visualmente a tela.\n\n### Estrutura e Slots\n\nO `br-divider` é um componente autônomo e de apresentação:\n- `default`: Slot opcional para texto ou elemento centralizado intercalado na linha do divisor.\n\nPara a documentação completa de design, incluindo diretrizes de acessibilidade e especificações visuais, consulte o [Design System do GovBR](https://www.gov.br/ds/components/divider?tab=designer).\n---\n\n\n### **Methods:**\n - **updateColor()** - Watcher para a cor do divisor.\nAtualiza a propriedade CSS '--border-color' do elemento para refletir a cor definida.\nIsso permite que o divisor use cores personalizadas sem precisar de estilos adicionais.\n- **updateMargins()** - Watcher para as propriedades de margin.\nAtualiza as propriedades CSS customizáveis do elemento para refletir os margins definidos.\n\n### **Slots:**\n - **default** - Slot opcional para conteúdo dentro do divisor (texto, ícones ou elementos personalizados).\n\n### **CSS Parts:**\n - **divider** - Elemento principal do divisor.\n- **content** - Conteúdo do divisor (quando há slot).",
+      "description": "O `br-divider` é uma linha que separa seções ou grupos de conteúdo. Pode ser horizontal ou vertical e ter um texto no meio.\n\n```html\n<br-divider></br-divider>\n\n<br-divider>ou</br-divider>\n\n<br-divider orientation=\"vertical\" thickness=\"medium\" border-style=\"dashed\"></br-divider>\n```\n\n### Quando usar\n\n- Marcar o fim de um bloco e o início de outro.\n- Separar alternativas, como \"Entrar com gov.br\" ou \"Entrar com certificado digital\".\n\n### Quando evitar\n\n- Quando o espaço em branco já separa bem o conteúdo.\n\nConsulte as [diretrizes de design do GovBR](https://www.gov.br/ds/components/divider?tab=designer).\n---\n\n\n### **Methods:**\n - **updateColor()** - Watcher para a cor do divisor.\nAtualiza a propriedade CSS '--border-color' do elemento para refletir a cor definida.\nIsso permite que o divisor use cores personalizadas sem precisar de estilos adicionais.\n- **updateMargins()** - Watcher para as propriedades de margin.\nAtualiza as propriedades CSS customizáveis do elemento para refletir os margins definidos.\n\n### **Slots:**\n - **default** - Slot opcional para conteúdo dentro do divisor (texto, ícones ou elementos personalizados).\n\n### **CSS Parts:**\n - **divider** - Elemento principal do divisor.\n- **content** - Conteúdo do divisor (quando há slot).",
       "attributes": [
         {
           "name": "custom-id",
@@ -1278,7 +1278,7 @@
         },
         {
           "name": "color-mode",
-          "description": "Esquema de cor canônico. Quando informado, tem precedência sobre `isDarkMode`; valores inválidos usam `light`.",
+          "description": "Esquema de cor padrão. Quando informado, tem precedência sobre `isDarkMode`; valores inválidos usam `light`.",
           "values": [{ "name": "light" }, { "name": "dark" }]
         },
         {
@@ -1321,7 +1321,7 @@
     },
     {
       "name": "br-dropdown",
-      "description": "O componente `br-dropdown` é o painel flutuante de sobreposição do GovBR-DS, ativado por um controle gatilho para apresentar listas contextuais de comandos, opções ou conteúdos complementares.\n\n### Para que serve\n\n- **Menus de contexto e ações:** Agrupa múltiplas ações secundárias ou suplementares que não precisam ficar expostas permanentemente na interface (ex.: menu \"Mais opções\", \"Exportar\", \"Filtrar por\").\n- **Posicionamento flutuante inteligente:** Gerencia a exibição da superfície suspensa sobre o conteúdo da página, garantindo contraste, elevação e fechamento ao clicar fora (`click outside`) ou pressionar a tecla Escape.\n- **Comportamento acessível:** Associa o elemento acionador ao painel de destino via atributos WAI-ARIA (`aria-expanded`, `aria-haspopup`).\n\n### Quando utilizar\n\n- **Utilize quando:**\n  - O espaço na barra de ferramentas ou cabeçalho for limitado e houver várias ações pontuais a serem oferecidas.\n  - For necessário apresentar uma lista suspensa de comandos acionáveis.\n- **Evite e prefira outro componente quando:**\n  - O objetivo for permitir a seleção de valor para submissão em formulário (prefira `br-select`).\n  - O conteúdo for a estrutura principal de navegação do site (prefira `br-menu`).\n  - A mensagem for uma notificação assíncrona ou alerta (prefira `br-message` ou `br-notification`).\n\n### Estrutura e Slots\n\nO `br-dropdown` é composto por duas regiões fundamentais:\n- `trigger`: Slot obrigatório onde a aplicação declara o botão ou link de acionamento (como um `br-button`).\n- `target`: Slot onde a aplicação declara o painel, lista de itens ou conteúdo flutuante exibido ao abrir o dropdown.\n\nPara a documentação completa de design, incluindo diretrizes de acessibilidade e especificações visuais, consulte o [Design System do GovBR](https://www.gov.br/ds/components/dropdown?tab=designer).\n---\n\n\n### **Events:**\n - **brDidOpen** - Emitido quando o dropdown abre.\n- **brDidClose** - Emitido quando o dropdown fecha.\n- **brDropdownChange**\n- **brDropdownOpenChange** - Evento canônico emitido quando o estado aberto muda.\n\n### **Methods:**\n - **targetZIndexChanged()** - Aplica o novo valor de z-index ao elemento target.\n- **matchTriggerWidthChanged()** - Recalcula a superfície aberta quando a política de largura muda.\n- **disabledChanged(newValue: _boolean_)** - Fecha o dropdown se for desabilitado enquanto estiver aberto.\n- **hide(): _Promise<{ isOpen: boolean }>_** - @deprecated Use `close`. - Esconde o dropdown.\nDefine a propriedade `isOpen` como falsa e retorna o novo estado.\nEste método pode ser chamado externamente.\n- **close(): _Promise<{ isOpen: boolean }>_** - Fecha o dropdown e mantém o formato de retorno legado.\n- **open(): _Promise<{ isOpen: boolean }>_** - Abre o dropdown.\nDefine a propriedade `isOpen` como verdadeira e retorna o novo estado.\nEste método pode ser chamado externamente.\n- **setFocus()** - Define o foco no elemento interno do componente.\nEste método pode ser chamado externamente para garantir que o foco seja aplicado ao elemento correto.\n\n### **Slots:**\n - **trigger** - Slot para o elemento que aciona a abertura do dropdown.\n- **target** - Slot para o conteúdo exibido pelo dropdown.\n\n### **CSS Parts:**\n - **trigger** - Área do acionador do dropdown.\n- **target** - Área de conteúdo exibida pelo dropdown.\n- **trigger-arrow** - Indicador visual opcional do acionador do dropdown.",
+      "description": "O `br-dropdown` abre um painel flutuante a partir de um botão, com ações ou conteúdo complementar, como um menu \"Mais opções\".\n\nColoque o botão no slot `trigger` e o conteúdo no slot `target`:\n\n```html\n<br-dropdown>\n  <br-button slot=\"trigger\" emphasis=\"tertiary\">Mais opções</br-button>\n  <br-list slot=\"target\">\n    <br-item>Exportar</br-item>\n    <br-item>Imprimir</br-item>\n  </br-list>\n</br-dropdown>\n```\n\nO painel fecha com Escape ou com um clique fora dele (desative com `prevent-auto-dismiss`). A posição é definida por `placement`, por exemplo `bottom-start` ou `top-end`. Para acompanhar a abertura e o fechamento, ouça `brDropdownOpenChange`.\n\n### Quando usar\n\n- Várias ações secundárias quando há pouco espaço na tela.\n\n### Quando evitar\n\n- Escolher um valor de formulário: use `br-select`.\n- Navegação principal do site: use `br-menu`.\n- Avisos: use `br-message` ou `br-notification`.\n\nConsulte as [diretrizes de design do GovBR](https://www.gov.br/ds/components/dropdown?tab=designer).\n---\n\n\n### **Events:**\n - **brDidOpen** - Emitido quando o dropdown abre.\n- **brDidClose** - Emitido quando o dropdown fecha.\n- **brDropdownChange**\n- **brDropdownOpenChange** - Evento emitido quando o estado aberto muda.\n\n### **Methods:**\n - **targetZIndexChanged()** - Aplica o novo valor de z-index ao elemento target.\n- **matchTriggerWidthChanged()** - Recalcula a superfície aberta quando a política de largura muda.\n- **disabledChanged(newValue: _boolean_)** - Fecha o dropdown se for desabilitado enquanto estiver aberto.\n- **hide(): _Promise<{ isOpen: boolean }>_** - @deprecated Use `close`. - Esconde o dropdown.\nDefine a propriedade `isOpen` como falsa e retorna o novo estado.\nEste método pode ser chamado externamente.\n- **close(): _Promise<{ isOpen: boolean }>_** - Fecha o dropdown e mantém o formato de retorno legado.\n- **open(): _Promise<{ isOpen: boolean }>_** - Abre o dropdown.\nDefine a propriedade `isOpen` como verdadeira e retorna o novo estado.\nEste método pode ser chamado externamente.\n- **setFocus()** - Define o foco no elemento interno do componente.\nEste método pode ser chamado externamente para garantir que o foco seja aplicado ao elemento correto.\n\n### **Slots:**\n - **trigger** - Slot para o elemento que aciona a abertura do dropdown.\n- **target** - Slot para o conteúdo exibido pelo dropdown.\n\n### **CSS Parts:**\n - **trigger** - Área do acionador do dropdown.\n- **target** - Área de conteúdo exibida pelo dropdown.\n- **trigger-arrow** - Indicador visual opcional do acionador do dropdown.",
       "attributes": [
         {
           "name": "custom-id",
@@ -1378,7 +1378,7 @@
     },
     {
       "name": "br-footer",
-      "description": "O componente `br-footer` é o orquestrador completo de rodapé institucional do GovBR-DS. Fornece o fechamento estrutural da página, centralizando links de navegação categorizados, canais de redes sociais, menção legal de licenciamento aberto e a marca do Governo Federal.\n\n### Para que serve\n\n- **Fechamento e navegação secundária:** Agrupa em categorias os links úteis de apoio, mapas do site e serviços da entidade pública.\n- **Conformidade legal e transparência:** Apresenta a nota de licenciamento de conteúdo (ex.: Creative Commons) e termos legais obrigatórios.\n- **Redes sociais institucionais:** Exibe links oficiais de comunicação pública com a sociedade.\n- **Responsividade integrada:** Converte categorias de links em painéis expansíveis (sanfona) automaticamente no modo mobile.\n\n### Quando utilizar\n\n- **Utilize quando:**\n  - Finalizar a estrutura da página em portais e sistemas governamentais alinhados ao padrão GovBR-DS.\n  - Oferecer navegação complementar, canais sociais e declarações de direitos autorais.\n- **Evite e prefira outro componente quando:**\n  - A interface for um diálogo modal ou painel isolado que não representa uma página completa do portal.\n\n### Composição e Subcomponentes\n\n| Subcomponente | Papel | Regra de uso |\n| --- | --- | --- |\n| `br-footer` | **Orquestrador principal.** Gerencia a distribuição visual em colunas/linhas e o comportamento sanfona em telas menores. | Deve ser declarado como elemento de rodapé ao final da página. |\n| `br-footer-category` | **Categoria de links.** Agrupa links temáticos sob um título expansível. | Deve ser inserido no contêiner de categorias do `br-footer`. |\n| `br-footer-item` | **Item de link.** Link individual dentro de uma categoria de rodapé. | Deve ser utilizado dentro de um `br-footer-category`. |\n| `br-footer-logo` | **Logotipo.** Exibe a logomarca do órgão ou do Governo Federal. | Posicionado na área designada de logotipo do `br-footer`. |\n| `br-footer-social` | **Redes sociais.** Reúne links e ícones para canais sociais oficiais. | Posicionado no slot ou área de mídias sociais do `br-footer`. |\n| `br-footer-legal` | **Texto legal.** Exibe termos de licenciamento aberto e direitos autorais. | Posicionado na base legal do `br-footer`. |\n\n### Como os subcomponentes se relacionam\n\nO `br-footer` atua como contêiner estrutural orquestrador. Ele organiza as categorias (`br-footer-category`) em colunas no desktop e alterna para comportamento de acordeão no mobile. Os itens (`br-footer-item`) herdam o contexto da categoria correspondente, enquanto as áreas de logotipo, redes sociais e notas legais completam o fechamento padronizado.\n\nPara a documentação completa de design, incluindo diretrizes de acessibilidade e especificações visuais, consulte o [Design System do GovBR](https://www.gov.br/ds/components/footer?tab=designer).\n---\n\n\n### **Methods:**\n - **render(): __** - Renderiza o componente.\n\n### **Slots:**\n - **logo** - Slot para o logo do rodapé, utilizando o componente br-logo.\n- **default** - Slot para o mapa do site, utilizando br-footer-category e br-footer-item.\n- **social-network** - Slot para as redes sociais, utilizando br-footer-social.\n- **partner-logo** - Slot para logos de parceiros, utilizando br-logo.\n- **legal** - Slot para informações legais, utilizando br-footer-legal.\n\n### **CSS Parts:**\n - **container** - Wrapper principal do footer.\n- **site-map** - Área do mapa do site.\n- **social** - Área de redes sociais.\n- **partners** - Área de logos de parceiros.",
+      "description": "O `br-footer` é o rodapé da página: logotipo, mapa do site, redes sociais, parceiros e informações legais.\n\n### Como montar\n\n| Área | Onde colocar |\n| --- | --- |\n| Logotipo | `br-footer-logo` no slot `logo` |\n| Mapa do site | `br-footer-category` com `br-footer-item`, no conteúdo do footer |\n| Redes sociais | `br-footer-social` no slot `social-network` |\n| Parceiros | `br-footer-logo partner` no slot `partner-logo` |\n| Informações legais | `br-footer-legal` no slot `legal` |\n\n```html\n<br-footer social-network-title=\"Redes sociais\">\n  <br-footer-logo slot=\"logo\" src=\"/logo.svg\" description=\"Nome do órgão\" href=\"/\"></br-footer-logo>\n\n  <br-footer-category label=\"Serviços\">\n    <br-footer-item href=\"/servicos/emitir\">Emitir documento</br-footer-item>\n    <br-footer-item href=\"/servicos/consultar\">Consultar processo</br-footer-item>\n  </br-footer-category>\n\n  <br-footer-social slot=\"social-network\" icon=\"instagram\" description=\"Instagram\" href=\"https://instagram.com/orgao\" target=\"_blank\"></br-footer-social>\n\n  <br-footer-legal slot=\"legal\">Texto destinado a exibir informações sobre o licenciamento.</br-footer-legal>\n</br-footer>\n```\n\nEm telas pequenas, as categorias viram seções que abrem e fecham. O tema padrão é escuro; use `theme=\"light\"` para o claro.\n\nConsulte as [diretrizes de design do GovBR](https://www.gov.br/ds/components/footer?tab=designer).\n---\n\n\n### **Methods:**\n - **render(): __** - Renderiza o componente.\n\n### **Slots:**\n - **logo** - Slot para o logo do rodapé, utilizando o componente br-logo.\n- **default** - Slot para o mapa do site, utilizando br-footer-category e br-footer-item.\n- **social-network** - Slot para as redes sociais, utilizando br-footer-social.\n- **partner-logo** - Slot para logos de parceiros, utilizando br-logo.\n- **legal** - Slot para informações legais, utilizando br-footer-legal.\n\n### **CSS Parts:**\n - **container** - Wrapper principal do footer.\n- **site-map** - Área do mapa do site.\n- **social** - Área de redes sociais.\n- **partners** - Área de logos de parceiros.",
       "attributes": [
         {
           "name": "custom-id",
@@ -1392,7 +1392,7 @@
         },
         {
           "name": "color-mode",
-          "description": "Esquema de cor canônico. Quando informado, tem precedência sobre `theme`.",
+          "description": "Esquema de cor padrão. Quando informado, tem precedência sobre `theme`.",
           "values": [{ "name": "FooterTheme" }]
         },
         {
@@ -1410,7 +1410,7 @@
     },
     {
       "name": "br-footer-category",
-      "description": "O componente `br-footer-category` é o subcomponente do GovBR-DS que agrupa links de rodapé por tema sob um título estruturado.\n\n### Para que serve\n\n- **Organização temática:** Divide os links de apoio em blocos temáticos claros.\n- **Colapso responsivo:** Funciona como seção que pode ser expandida ou recolhida no layout mobile, otimizando o espaço da tela.\n\n### Papel na composição\n\nAtua como agrupador intermediário entre o `br-footer` e os itens filhos individuais `br-footer-item`.\n\n### Regra de uso e relacionamento\n\n- Deve ser inserido dentro do `br-footer`.\n- Acomoda instâncias de `br-footer-item` representando cada link pertencente àquela categoria.\n---\n\n\n### **Methods:**\n - **render(): __** - Renderiza o componente.\n\n### **Slots:**\n - **default** - Slot para os itens da categoria no rodapé, utilizando br-footer-item.",
+      "description": "Grupo de links do mapa do site no `br-footer`. O título vem de `label` e os links são `br-footer-item`.\n\nEm telas pequenas, a categoria vira uma seção que abre e fecha.\n---\n\n\n### **Methods:**\n - **render(): __** - Renderiza o componente.\n\n### **Slots:**\n - **default** - Slot para os itens da categoria no rodapé, utilizando br-footer-item.",
       "attributes": [
         {
           "name": "custom-id",
@@ -1427,7 +1427,7 @@
     },
     {
       "name": "br-footer-item",
-      "description": "O componente `br-footer-item` é o subcomponente folha do GovBR-DS que renderiza um link de navegação individual dentro de uma categoria do rodapé.\n\n### Para que serve\n\n- **Acesso direto a links:** Conduz a pessoa usuária a páginas de serviços, transparência ou seções institucionais.\n- **Estilo padronizado:** Garante tipografia, espaçamento e estados acessíveis no rodapé.\n\n### Papel na composição\n\nAtua como item de link final na hierarquia de rodapé.\n\n### Regra de uso e relacionamento\n\n- Deve ser utilizado exclusivamente dentro de um componente `br-footer-category`.\n- Não deve ser declarado de forma isolada fora de uma categoria de rodapé.\n---\n\n\n### **Events:**\n - **brNavigate** - Evento cancelável emitido em `navigation-mode=\"event\"` para cliques primários sem modificadores em links `_self`.\nChame `event.preventDefault()` no listener para impedir a navegação nativa e entregar `event.detail.href` ao roteador da SPA.\n\n### **Methods:**\n - **render(): __** - Renderiza o componente\n\n### **Slots:**\n - **default** - Slot para o conteúdo do item no rodapé, incluindo texto ou componentes de roteamento para SPAs.",
+      "description": "Um link do mapa do site, dentro de um `br-footer-category`. Informe o destino em `href` e o texto no conteúdo.\n\nEm SPA, use `navigation-mode=\"event\"` e trate o evento `brNavigate`.\n---\n\n\n### **Events:**\n - **brNavigate** - Evento cancelável emitido em `navigation-mode=\"event\"` para cliques primários sem modificadores em links `_self`.\nChame `event.preventDefault()` no listener para impedir a navegação nativa e entregar `event.detail.href` ao roteador da SPA.\n\n### **Methods:**\n - **render(): __** - Renderiza o componente\n\n### **Slots:**\n - **default** - Slot para o conteúdo do item no rodapé, incluindo texto ou componentes de roteamento para SPAs.",
       "attributes": [
         {
           "name": "custom-id",
@@ -1449,7 +1449,7 @@
     },
     {
       "name": "br-footer-legal",
-      "description": "O componente `br-footer-legal` é o subcomponente do GovBR-DS que apresenta as informações de licenciamento aberto de conteúdo (como Creative Commons) e termos legais obrigatórios.\n\n### Para que serve\n\n- **Transparência jurídica:** Comunica a licença de uso dos dados e conteúdos do portal público.\n- **Fechamento de conformidade:** Atende às normas governamentais de publicação de páginas federais.\n\n### Papel na composição\n\nAtua como elemento informativo legal no rodapé.\n\n### Regra de uso e relacionamento\n\n- Deve ser posicionado na área base de menções legais do `br-footer`.\n---\n\n\n### **Methods:**\n - **render(): __** - Renderiza o componente.\n\n### **Slots:**\n - **default** - Slot para informações legais no rodapé, como direitos autorais ou termos de uso.\n\n### **CSS Parts:**\n - **container** - Wrapper principal do footer-legal.",
+      "description": "Informações legais do `br-footer`, como licença de uso e direitos autorais. Use no slot `legal`.\n---\n\n\n### **Methods:**\n - **render(): __** - Renderiza o componente.\n\n### **Slots:**\n - **default** - Slot para informações legais no rodapé, como direitos autorais ou termos de uso.\n\n### **CSS Parts:**\n - **container** - Wrapper principal do footer-legal.",
       "attributes": [
         {
           "name": "custom-id",
@@ -1461,7 +1461,7 @@
     },
     {
       "name": "br-footer-logo",
-      "description": "O componente `br-footer-logo` é o subcomponente do GovBR-DS responsável por renderizar a marca oficial do órgão ou a marca unificada do Governo Federal no rodapé.\n\n### Para que serve\n\n- **Assinatura institucional:** Reforça a autenticidade governamental no fechamento da página.\n- **Link oficial:** Permite redirecionar a pessoa usuária para o portal principal do Governo Federal ou do órgão.\n\n### Papel na composição\n\nAtua como elemento de identidade institucional no rodapé.\n\n### Regra de uso e relacionamento\n\n- Deve ser inserido na área ou slot de logotipo do `br-footer`.\n- Não deve ser utilizado fora do ecossistema de rodapé.\n---\n\n\n### **Events:**\n - **brNavigate** - Evento cancelável emitido em `navigation-mode=\"event\"` para cliques primários sem modificadores em links `_self`.\nChame `event.preventDefault()` no listener para impedir a navegação nativa e entregar `event.detail.href` ao roteador da SPA.\n\n### **Methods:**\n - **render(): __** - Monta o JSX que representa o componente.\n\n### **CSS Parts:**\n - **container** - Wrapper principal do footer-logo.",
+      "description": "Logotipo do `br-footer`. Use no slot `logo` para a marca do órgão, ou com `partner` no slot `partner-logo` para parceiros.\n\nInforme a imagem em `src` e o texto alternativo em `description`. Com `href`, a logo vira link.\n---\n\n\n### **Events:**\n - **brNavigate** - Evento cancelável emitido em `navigation-mode=\"event\"` para cliques primários sem modificadores em links `_self`.\nChame `event.preventDefault()` no listener para impedir a navegação nativa e entregar `event.detail.href` ao roteador da SPA.\n\n### **Methods:**\n - **render(): __** - Monta o JSX que representa o componente.\n\n### **CSS Parts:**\n - **container** - Wrapper principal do footer-logo.",
       "attributes": [
         {
           "name": "custom-id",
@@ -1509,7 +1509,7 @@
     },
     {
       "name": "br-footer-social",
-      "description": "O componente `br-footer-social` é o subcomponente do GovBR-DS que agrupa e renderiza atalhos e ícones para os canais oficiais de redes sociais da organização pública.\n\n### Para que serve\n\n- **Canais oficiais:** Facilita o acesso do cidadão às mídias sociais e de comunicação do órgão.\n- **Acessibilidade nos atalhos:** Fornece rótulos acessíveis e abertura segura de links externos.\n\n### Papel na composição\n\nAtua como bloco de engajamento social no rodapé.\n\n### Regra de uso e relacionamento\n\n- Deve ser inserido na área ou slot destinado a redes sociais do `br-footer`.\n---\n\n\n### **Events:**\n - **brNavigate** - Evento cancelável emitido em `navigation-mode=\"event\"` para cliques primários sem modificadores em links `_self`.\nChame `event.preventDefault()` no listener para impedir a navegação nativa e entregar `event.detail.href` ao roteador da SPA.\n\n### **Methods:**\n - **render(): __** - Renderiza o componente.\n\n### **Slots:**\n - **icon** - Ícone personalizado. Quando preenchido, substitui o ícone definido por `icon`.",
+      "description": "Link para uma rede social no `br-footer`. Use no slot `social-network`.\n\nInforme em `icon` o nome do ícone de marca, como `instagram` ou `youtube`; em `description`, o nome da rede (usado como texto acessível); e em `href`, o endereço. Para outro ícone, use o slot `icon`.\n---\n\n\n### **Events:**\n - **brNavigate** - Evento cancelável emitido em `navigation-mode=\"event\"` para cliques primários sem modificadores em links `_self`.\nChame `event.preventDefault()` no listener para impedir a navegação nativa e entregar `event.detail.href` ao roteador da SPA.\n\n### **Methods:**\n - **render(): __** - Renderiza o componente.\n\n### **Slots:**\n - **icon** - Ícone personalizado. Quando preenchido, substitui o ícone definido por `icon`.",
       "attributes": [
         {
           "name": "custom-id",
@@ -1518,7 +1518,7 @@
         },
         {
           "name": "icon",
-          "description": "Identificador da rede social. Os ícones oficiais mais comuns são\nrenderizados pelo registro SVG local; use o slot `icon` para uma fonte\ndiferente ou uma classe Font Awesome personalizada.",
+          "description": "Nome do ícone Font Awesome 5 Free presente no cache local, sem o prefixo\n`fa-brands:` (ex.: `instagram`). Use o slot `icon` para conteúdo próprio.",
           "values": []
         },
         {
@@ -1542,7 +1542,7 @@
     },
     {
       "name": "br-header",
-      "description": "O componente `br-header` é o orquestrador principal de cabeçalho do GovBR-DS. Centraliza a identidade visual do órgão ou sistema público, links de navegação hierárquica, atalhos de funcionalidades, mecanismo de busca e botão de acesso ou autenticação.\n\n### Para que serve\n\n- **Identidade institucional unificada:** Apresenta a marca e assinatura visual oficial do Governo Federal e da entidade pública.\n- **Navegação e atalhos rápidos:** Reúne links para áreas centrais e botões funcionais (como contraste, acessibilidade e suporte).\n- **Busca e autenticação integradas:** Fornece áreas reservadas e slots para barra de busca rápida e gatilho de login/acesso.\n- **Comportamento responsivo e densidades:** Adapta-se automaticamente a diferentes telas com suporte a densidades padrão, compacta, pequena e grande.\n\n### Quando utilizar\n\n- **Utilize quando:**\n  - Desenvolver páginas, portais e sistemas públicos federais que requerem a barra superior padronizada do GovBR-DS.\n  - For necessário integrar identidade visual, navegação rápida, busca e acesso em uma estrutura consistente.\n- **Evite e prefira outro componente quando:**\n  - A navegação for exclusivamente lateral ou contextual interna de uma ferramenta gráfica (prefira `br-menu` ou barras de ferramentas específicas).\n\n### Composição e Subcomponentes\n\n| Subcomponente | Papel | Regra de uso |\n| --- | --- | --- |\n| `br-header` | **Orquestrador principal.** Estrutura as áreas superior e inferior, gerencia responsividade e densidade. | Deve ser declarado como elemento raiz do topo da página. |\n| `br-header-logo` | **Identidade visual.** Exibe o logotipo ou brasão institucional. | Posicionado nos slots `logo` ou `signature` do `br-header`. |\n| `br-header-list` | **Agrupador de lista.** Contêiner semântico horizontal para links ou funções. | Encaixa-se nos slots `links` ou `functions` do `br-header`. |\n| `br-header-link` | **Item de link.** Atalho ou hiperlink de navegação institucional. | Deve ser inserido dentro de um `br-header-list` no slot `links`. |\n| `br-header-function` | **Ação funcional.** Botão de utilidade rápida (contraste, ajuda, etc.). | Deve ser inserido dentro de um `br-header-list` no slot `functions`. |\n\n### Como os subcomponentes se relacionam\n\nO `br-header` orquestra as áreas da barra através de slots nomeados (`logo`, `signature`, `links`, `functions`, `search`, `access`, `menu-trigger`, `caption`, `subcaption`). Ele observa o tamanho de tela e a densidade configurada, reorganizando os blocos e delegando a exibição correta aos subcomponentes filhos.\n\nPara a documentação completa de design, incluindo diretrizes de acessibilidade e especificações visuais, consulte o [Design System do GovBR](https://www.gov.br/ds/components/header?tab=designer).\n---\n\n\n### **Events:**\n - **headerCompactChange** - Evento disparado quando o cabeçalho entra ou sai do modo compacto.\nO evento contém os detalhes do estado compacto e o ID do componente pai.\n- **brHeaderCompactChange** - Evento canônico emitido quando o modo compacto muda.\n- **headerWidthChange** - Evento disparado para indicar qual lista deve encolher primeiro.\nO evento contém os detalhes do ID do componente pai e o nome da lista.\n- **brMenuToggle** - Evento disparado para alternar o estado de um menu associado.\n- **brNavigate** - Evento cancelável emitido em `navigation-mode=\"event\"` para cliques primários sem modificadores em links `_self`.\nChame `event.preventDefault()` no listener para impedir a navegação nativa e entregar `event.detail.href` ao roteador da SPA.\n\n### **Methods:**\n - **watchIsCompact(newValue: _boolean_)** - Observa mudanças na propriedade isCompact.\n- **resetHeaderList()** - Reinicializa o estado das listas do cabeçalho, disparando o evento de redimensionamento.\nPode ser chamado externamente para forçar a atualização das listas.\n- **render(): __** - Renderiza o componente.\n\n### **Slots:**\n - **logo** - Slot para a logo do cabeçalho.\n- **signature** - Slot para a assinatura visual da organização.\n- **links** - Slot para links de navegação principais.\n- **functions** - Slot para botões de ação no cabeçalho.\n- **search** - Slot para o campo de busca.\n- **access** - Slot para o botão de acesso ou autenticação.\n- **menu-trigger** - Slot para o botão que abre o menu.\n- **caption** - Slot para o título do cabeçalho.\n- **subcaption** - Slot para o subtítulo do cabeçalho.\n\n### **CSS Parts:**\n - **header** - Elemento header principal.\n- **top** - Área superior do header.\n- **top-left** - Área superior esquerda (logo + assinatura).\n- **top-right** - Área superior direita (links + funções + busca + acesso).\n- **bottom** - Área inferior do header.\n- **bottom-left** - Área inferior esquerda (menu + título).\n- **bottom-right** - Área inferior direita (busca expandida).",
+      "description": "O `br-header` é o cabeçalho da página: logotipo, nome do sistema, links, atalhos, busca, acesso e botão do menu.\n\n### Como montar\n\nCada área tem um slot:\n\n| Área | Slot | Componente sugerido |\n| --- | --- | --- |\n| Logotipo | `logo` | `br-header-logo` |\n| Nome e subtítulo | — | props `caption` e `subcaption` |\n| Links | `links` | `br-header-list` com `br-header-link` |\n| Atalhos (contraste, ajuda…) | `functions` | `br-header-list` com `br-header-function` |\n| Busca | `search` e `search-icon` | `br-input` e um `br-button` com ícone |\n| Entrar | `access` | `br-sign-in` |\n| Menu | `menu-trigger` | `br-button` que abre o `br-menu` |\n\n```html\n<br-header caption=\"Nome do sistema\" subcaption=\"Nome do órgão\" sticky>\n  <br-header-logo slot=\"logo\" src=\"/logo.svg\" description=\"gov.br\"></br-header-logo>\n\n  <br-header-list slot=\"links\" list-title=\"Acesso rápido\">\n    <br-header-link href=\"/servicos\">Serviços</br-header-link>\n  </br-header-list>\n\n  <br-input slot=\"search\" label=\"Buscar\" type=\"search\"></br-input>\n\n  <br-button slot=\"menu-trigger\" shape=\"circle\" aria-label=\"Abrir menu\" data-toggle=\"menu\" data-target=\"#menu-principal\">\n    <br-icon src=\"/icones/menu.svg\"></br-icon>\n  </br-button>\n</br-header>\n```\n\nUse `sticky` para manter o cabeçalho visível ao rolar a página e `compact` para a versão reduzida. Em telas menores, a busca fica escondida até o clique no botão do slot `search-icon`.\n\nConsulte as [diretrizes de design do GovBR](https://www.gov.br/ds/components/header?tab=designer).\n---\n\n\n### **Events:**\n - **headerCompactChange** - Evento disparado quando o cabeçalho entra ou sai do modo compacto.\nO evento contém os detalhes do estado compacto e o ID do componente pai.\n- **brHeaderCompactChange** - Evento emitido quando o modo compacto muda.\n- **headerWidthChange** - Evento disparado para indicar qual lista deve encolher primeiro.\nO evento contém os detalhes do ID do componente pai e o nome da lista.\n- **brMenuToggle** - Evento disparado para alternar o estado de um menu associado.\n- **brNavigate** - Evento cancelável emitido em `navigation-mode=\"event\"` para cliques primários sem modificadores em links `_self`.\nChame `event.preventDefault()` no listener para impedir a navegação nativa e entregar `event.detail.href` ao roteador da SPA.\n\n### **Methods:**\n - **watchIsCompact(newValue: _boolean_)** - Observa mudanças na propriedade isCompact.\n- **resetHeaderList()** - Reinicializa o estado das listas do cabeçalho, disparando o evento de redimensionamento.\nPode ser chamado externamente para forçar a atualização das listas.\n- **render(): __** - Renderiza o componente.\n\n### **Slots:**\n - **logo** - Slot para a logo do cabeçalho.\n- **signature** - Slot para a assinatura visual da organização.\n- **links** - Slot para links de navegação principais.\n- **functions** - Slot para botões de ação no cabeçalho.\n- **search-icon** - Botão que mostra o campo de busca em telas menores e no modo compacto.\n- **search** - Slot para o campo de busca.\n- **access** - Slot para o botão de acesso ou autenticação.\n- **menu-trigger** - Slot para o botão que abre o menu.\n- **caption** - Slot para o título do cabeçalho.\n- **subcaption** - Slot para o subtítulo do cabeçalho.\n\n### **CSS Parts:**\n - **header** - Elemento header principal.\n- **top** - Área superior do header.\n- **top-left** - Área superior esquerda (logo + assinatura).\n- **top-right** - Área superior direita (links + funções + busca + acesso).\n- **bottom** - Área inferior do header.\n- **bottom-left** - Área inferior esquerda (menu + título).\n- **bottom-right** - Área inferior direita (busca expandida).",
       "attributes": [
         {
           "name": "caption",
@@ -1571,7 +1571,7 @@
         },
         {
           "name": "compact",
-          "description": "Estado compacto canônico. Quando informado, tem precedência sobre `isCompact`.",
+          "description": "Estado compacto. Quando informado, tem precedência sobre `isCompact`.",
           "values": []
         },
         {
@@ -1619,7 +1619,7 @@
     },
     {
       "name": "br-header-function",
-      "description": "O componente `br-header-function` é o subcomponente do GovBR-DS que representa uma ação funcional ou utilitária rápida no cabeçalho (como alto contraste, atalhos de acessibilidade, suporte ou configurações).\n\n### Para que serve\n\n- **Ações utilitárias rápidas:** Permite disparar funcionalidades auxiliares com ícone e rótulo sem sair do fluxo da página.\n- **Feedback interativo:** Oferece estados visuais consistentes de foco, hover e ativação.\n\n### Papel na composição\n\nAtua como controle interativo de utilidade dentro do cabeçalho.\n\n### Regra de uso e relacionamento\n\n- Deve ser utilizado dentro de um `br-header-list` posicionado no slot `functions` do `br-header`.\n- Não deve ser utilizado como botão genérico de formulário ou ação primária de conteúdo (para esses casos, utilize `br-button`).\n---\n\n\n### **Events:**\n - **brNavigate** - Evento cancelável emitido em `navigation-mode=\"event\"` para cliques primários sem modificadores em links `_self`.\nChame `event.preventDefault()` no listener para impedir a navegação nativa e entregar `event.detail.href` ao roteador da SPA.\n\n### **Methods:**\n - **handleHeaderWidthChange(event: _CustomEvent<{ id: string; listNames: string[]; shrink: boolean }>_)** - Listener para o evento 'headerWidthChange', disparado pelo componente pai 'br-header'.\nO evento contém o ID do pai e o nome da lista.\nSe o ID do pai corresponder ao ID do cabeçalho atual, o evento será tratado.\n- **render(): __** - Renderiza o componente.\n\n### **Slots:**\n - **default** - Slot para o nome ou rótulo da funcionalidade.\n- **icon** - Slot para ícone que representa a funcionalidade.",
+      "description": "Atalho do `br-header`, como contraste ou ajuda, dentro de um `br-header-list` no slot `functions`.\n\nColoque o ícone no slot `icon` e o nome no conteúdo:\n\n```html\n<br-header-function href=\"/ajuda\">\n  <br-icon slot=\"icon\" src=\"/icones/ajuda.svg\"></br-icon>\n  Ajuda\n</br-header-function>\n```\n\nEm telas grandes, aparece como botão de ícone, e o nome é usado como texto acessível. Em telas menores, aparece com ícone e nome dentro do menu da lista.\n---\n\n\n### **Events:**\n - **brNavigate** - Evento cancelável emitido em `navigation-mode=\"event\"` para cliques primários sem modificadores em links `_self`.\nChame `event.preventDefault()` no listener para impedir a navegação nativa e entregar `event.detail.href` ao roteador da SPA.\n\n### **Methods:**\n - **handleHeaderWidthChange(event: _CustomEvent<{ id: string; listNames: string[]; shrink: boolean }>_)** - Listener para o evento 'headerWidthChange', disparado pelo componente pai 'br-header'.\nO evento contém o ID do pai e o nome da lista.\nSe o ID do pai corresponder ao ID do cabeçalho atual, o evento será tratado.\n- **render(): __** - Renderiza o componente.\n\n### **Slots:**\n - **default** - Slot para o nome ou rótulo da funcionalidade.\n- **icon** - Slot para ícone que representa a funcionalidade.",
       "attributes": [
         {
           "name": "custom-id",
@@ -1651,7 +1651,7 @@
     },
     {
       "name": "br-header-link",
-      "description": "O componente `br-header-link` é o subcomponente de navegação do GovBR-DS que representa um atalho ou hiperlink de navegação institucional no cabeçalho.\n\n### Para que serve\n\n- **Navegação institucional:** Oferece acesso direto a páginas de serviços, portais correlatos ou áreas centrais do órgão.\n- **Integração SPA:** Suporta navegação web padrão via atributo `href` ou integração com roteadores SPA via eventos de navegação.\n\n### Papel na composição\n\nAtua como item folha de navegação dentro do cabeçalho.\n\n### Regra de uso e relacionamento\n\n- Deve ser utilizado dentro de um `br-header-list` posicionado no slot `links` do `br-header`.\n- Não deve ser utilizado de forma avulsa fora do ecossistema de cabeçalho.\n---\n\n\n### **Events:**\n - **brNavigate** - Evento cancelável emitido em `navigation-mode=\"event\"` para cliques primários sem modificadores em links `_self`.\nChame `event.preventDefault()` no listener para impedir a navegação nativa e entregar `event.detail.href` ao roteador da SPA.\n\n### **Methods:**\n - **render(): __** - Renderiza o componente.\n\n### **Slots:**\n - **default** - Slot para o conteúdo do link exibido no cabeçalho.",
+      "description": "Link do `br-header`, dentro de um `br-header-list` no slot `links`. Informe o destino em `href` e o texto no conteúdo.\n\nEm SPA, use `navigation-mode=\"event\"` e trate `brNavigate`.\n---\n\n\n### **Events:**\n - **brNavigate** - Evento cancelável emitido em `navigation-mode=\"event\"` para cliques primários sem modificadores em links `_self`.\nChame `event.preventDefault()` no listener para impedir a navegação nativa e entregar `event.detail.href` ao roteador da SPA.\n\n### **Methods:**\n - **render(): __** - Renderiza o componente.\n\n### **Slots:**\n - **default** - Slot para o conteúdo do link exibido no cabeçalho.",
       "attributes": [
         {
           "name": "custom-id",
@@ -1674,7 +1674,7 @@
     },
     {
       "name": "br-header-list",
-      "description": "O componente `br-header-list` é o subcomponente contêiner do GovBR-DS que organiza links de navegação ou botões funcionais em uma estrutura de lista horizontal acessível.\n\n### Para que serve\n\n- **Agrupamento semântico:** Estrutura itens navegáveis ou funcionais em elementos de lista semânticos.\n- **Distribuição e espaçamento:** Garante o alinhamento horizontal padronizado de itens no cabeçalho.\n\n### Papel na composição\n\nAtua como elo intermediário entre o orquestrador `br-header` e os itens filhos individuais (`br-header-link` ou `br-header-function`).\n\n### Regra de uso e relacionamento\n\n- Deve ser inserido nos slots `links` ou `functions` do orquestrador `br-header`.\n- Serve de contêiner direto para subcomponentes `br-header-link` ou `br-header-function`.\n---\n\n\n### **Events:**\n - **headerListUpdate** - Evento disparado para indicar qual lista deve encolher primeiro.\nO evento envia o ID do componente pai e o nome da lista.\n- **headerListFocused** - Evento disparado quando a lista recebe foco.\nO evento envia o ID do componente.\n\n### **Methods:**\n - **closeList()** - Fecha a lista.\n- **isListOpen(): _Promise<boolean>_** - Verifica se a lista está aberta.\n- **openList(): _Promise<void>_** - Abre a lista.\n- **render(): __** - Renderiza o componente.\n\n### **Slots:**\n - **default** - Slot para o conteúdo da lista de navegação no cabeçalho.",
+      "description": "Lista de links ou atalhos do `br-header`. Use no slot `links`, com `br-header-link`, ou no slot `functions`, com `br-header-function`.\n\nEm telas menores, a lista vira um menu que abre e fecha; o título desse menu vem de `list-title`.\n---\n\n\n### **Events:**\n - **headerListUpdate** - Evento disparado para indicar qual lista deve encolher primeiro.\nO evento envia o ID do componente pai e o nome da lista.\n- **headerListFocused** - Evento disparado quando a lista recebe foco.\nO evento envia o ID do componente.\n\n### **Methods:**\n - **closeList()** - Fecha a lista.\n- **isListOpen(): _Promise<boolean>_** - Verifica se a lista está aberta.\n- **openList(): _Promise<void>_** - Abre a lista.\n- **render(): __** - Renderiza o componente.\n\n### **Slots:**\n - **default** - Slot para o conteúdo da lista de navegação no cabeçalho.",
       "attributes": [
         {
           "name": "custom-id",
@@ -1691,7 +1691,7 @@
     },
     {
       "name": "br-header-logo",
-      "description": "O componente `br-header-logo` é o subcomponente do GovBR-DS responsável por renderizar a marca visual oficial ou a assinatura do órgão dentro do cabeçalho.\n\n### Para que serve\n\n- **Exibição de marca:** Apresenta a imagem ou logotipo institucional no topo da página.\n- **Link de retorno:** Permite associar um link à marca, direcionando a pessoa usuária à página inicial do portal ou sistema.\n\n### Papel na composição\n\nAtua como elemento de identidade visual no cabeçalho. Não gerencia a estrutura do topo nem as ações utilitárias, papel reservado ao orquestrador `br-header`.\n\n### Regra de uso e relacionamento\n\n- Deve ser utilizado posicionado preferencialmente no slot `logo` ou `signature` do componente orquestrador `br-header`.\n- Não deve ser utilizado isoladamente fora do contexto de cabeçalho institucional.\n---\n\n\n### **Events:**\n - **brNavigate** - Evento cancelável emitido em `navigation-mode=\"event\"` para cliques primários sem modificadores em links `_self`.\nChame `event.preventDefault()` no listener para impedir a navegação nativa e entregar `event.detail.href` ao roteador da SPA.\n\n### **Methods:**\n - **handleIsCompactChange()** - Observa mudanças na propriedade `isCompact` e ajusta a altura da logo se `hasDefaultHeight` for verdadeiro.\n- **render(): __** - Renderiza o componente.\n\n### **Slots:**\n - **default** - Slot para a logo personalizada exibida no cabeçalho.\n\n### **CSS Parts:**\n - **container** - Wrapper da logo do header.",
+      "description": "Logotipo do `br-header`. Use no slot `logo`.\n\nInforme a imagem em `src` e o texto alternativo em `description`. Com `href`, a logo vira link; em SPA, use `navigation-mode=\"event\"` e trate `brNavigate`.\n---\n\n\n### **Events:**\n - **brNavigate** - Evento cancelável emitido em `navigation-mode=\"event\"` para cliques primários sem modificadores em links `_self`.\nChame `event.preventDefault()` no listener para impedir a navegação nativa e entregar `event.detail.href` ao roteador da SPA.\n\n### **Methods:**\n - **handleIsCompactChange()** - Observa mudanças na propriedade `isCompact` e ajusta a altura da logo se `hasDefaultHeight` for verdadeiro.\n- **render(): __** - Renderiza o componente.\n\n### **Slots:**\n - **default** - Slot para a logo personalizada exibida no cabeçalho.\n\n### **CSS Parts:**\n - **container** - Wrapper da logo do header.",
       "attributes": [
         {
           "name": "custom-id",
@@ -1731,7 +1731,7 @@
     },
     {
       "name": "br-icon",
-      "description": "O componente `br-icon` é o elemento oficial do GovBR-DS para renderização dinâmica e padronizada de ícones vetoriais. Ele suporta a família tipográfica Font Awesome e ícones utilitários do governo, garantindo contraste, escalabilidade e acessibilidade visual.\n\n### Para que serve\n\n- **Comunicação visual imediata:** Fornece apoio gráfico rápido para ações em botões, links, cartões, menus e alertas contextuais.\n- **Acessibilidade nativa:** Gerencia automaticamente a visibilidade para leitores de tela: ícones decorativos recebem `aria-hidden=\"true\"`, enquanto ícones informativos recebem nome acessível via `aria-label`.\n- **Flexibilidade dimensional e cromática:** Permite personalizar tamanho, cor através de tokens CSS do GovBR-DS, rotação e efeitos de espelhamento.\n\n### Quando utilizar\n\n- **Utilize quando:**\n  - For necessário reforçar o significado de um texto ou ação com uma representação gráfica familiar.\n  - Criar controles compactos com ícone acompanhado de descrição acessível.\n- **Evite e prefira outro componente quando:**\n  - For necessária uma imagem fotográfica ou ilustração visual ampla com detalhes cromáticos complexos (prefira tags HTML `<img>` ou SVG ilustrativo).\n\n### Estrutura e Slots\n\nO `br-icon` renderiza um elemento vetorial direto com base no atributo `name` informado ou através de classes utilitárias.\n\nPara a documentação completa de design, incluindo diretrizes de acessibilidade e especificações visuais, consulte o [Design System do GovBR](https://www.gov.br/ds/components/icon?tab=designer).\n---\n\n\n### **Slots:**\n - _default_ - Conteúdo customizado do ícone. Pode receber elementos como `<i>`, `<svg>` ou componentes de outras bibliotecas.\n\n### **CSS Parts:**\n - **icon** - Elemento interno que representa o ícone renderizado.\n- **image** - Elemento img interno quando `src` é usado.\n- **svg** - Elemento interno que recebe SVG inline quando `svg` é usado.\n- **slot** - Elemento interno que recebe conteúdo via slot.",
+      "description": "O `br-icon` exibe um ícone com tamanho e alinhamento padronizados. O ícone vem da sua aplicação, de uma destas formas:\n\n```html\n<!-- Arquivo ou URL -->\n<br-icon src=\"/icones/busca.svg\"></br-icon>\n\n<!-- SVG no próprio código -->\n<br-icon svg='<svg viewBox=\"0 0 24 24\"><path d=\"…\" fill=\"currentColor\"/></svg>'></br-icon>\n\n<!-- Outra biblioteca, como Font Awesome -->\n<br-icon><i class=\"fas fa-search\"></i></br-icon>\n```\n\nSem `label`, o ícone é decorativo e ignorado por leitores de tela. Quando o ícone transmite informação sozinho, descreva-o em `label`:\n\n```html\n<br-icon src=\"/icones/alerta.svg\" label=\"Atenção\"></br-icon>\n```\n\nO tamanho padrão é 16 × 16 px; ajuste com `width` e `height`, em qualquer unidade CSS. Use `rotate` e `flip` para girar ou espelhar.\n\nSe mais de uma forma for informada, vale nesta ordem: conteúdo, `svg`, `src` e, por último, `icon-name` (depreciado). Para fixar uma delas, use `source`.\n\n### Quando evitar\n\n- Fotos e ilustrações: use `<img>`.\n\nConsulte as [diretrizes de design do GovBR](https://www.gov.br/ds/components/icon?tab=designer).\n---\n\n\n### **Slots:**\n - _default_ - Conteúdo customizado do ícone. Pode receber elementos como `<i>`, `<svg>` ou componentes de outras bibliotecas.\n\n### **CSS Parts:**\n - **icon** - Elemento interno que representa o ícone renderizado.\n- **image** - Elemento img interno quando `src` é usado.\n- **svg** - Elemento interno que recebe SVG inline quando `svg` é usado.\n- **slot** - Elemento interno que recebe conteúdo via slot.",
       "attributes": [
         {
           "name": "label",
@@ -1740,7 +1740,7 @@
         },
         {
           "name": "icon-name",
-          "description": "Identificador legado do ícone. Identificadores que pertencem ao registro local são\nrenderizados como SVG empacotado; nomes desconhecidos continuam disponíveis via Iconify\nsomente para compatibilidade.",
+          "description": "Identificador legado do ícone. Nomes no cache local são renderizados como SVG empacotado;\nem `source=\"auto\"`, nomes ausentes usam Iconify como fallback. `source=\"iconify\"` força essa origem.",
           "values": []
         },
         {
@@ -1755,7 +1755,7 @@
         },
         {
           "name": "source",
-          "description": "Define explicitamente a origem do ícone.\nQuando `auto`, o componente prioriza slot, SVG inline e imagem por URL.\nIconify fica apenas como fallback de compatibilidade quando nenhuma fonte própria foi informada.\nAceita `auto`, `iconify`, `image`, `svg` ou `slot`; valores inválidos usam `auto`.",
+          "description": "Define explicitamente a origem do ícone.\nQuando `auto`, o componente prioriza slot, SVG inline, imagem por URL e o cache local Font Awesome 5 Free.\nSe `iconName` não estiver no cache, usa Iconify como fallback. `iconify` força essa origem mesmo para nomes presentes no cache.\nAceita `auto`, `iconify`, `image`, `svg` ou `slot`; valores inválidos usam `auto`.",
           "values": [{ "name": "IconSource" }]
         },
         {
@@ -1810,7 +1810,7 @@
         },
         {
           "name": "lazy",
-          "description": "Controla o comportamento de carregamento do ícone.\n\nComportamento:\n- Padrão (propriedade não definida): carregamento imediato aplicando `noobserver` para evitar problemas de layout shift\n- `lazy={true}`: ativa o carregamento tardio nativo para imagens em `src` e o observer do Iconify no fallback legado\n- `lazy={false}`: carregamento imediato\n\n**Nota**: O padrão foi alterado para carregamento imediato para resolver problemas de deslocamento de layout\nque ocorriam quando ícones eram carregados depois do conteúdo inicial.\n\nSVG inline e conteúdo em slot não precisam de carregamento tardio, pois já estão disponíveis no DOM.",
+          "description": "Controla o comportamento de carregamento do ícone.\n\nComportamento:\n- Padrão (propriedade não definida): carregamento imediato aplicando `noobserver` para evitar problemas de layout shift\n- `lazy={true}`: ativa o carregamento tardio nativo para imagens em `src`\n- `lazy={false}`: carregamento imediato\n\n**Nota**: O padrão foi alterado para carregamento imediato para resolver problemas de deslocamento de layout\nque ocorriam quando ícones eram carregados depois do conteúdo inicial.\n\nSVG inline e conteúdo em slot não precisam de carregamento tardio, pois já estão disponíveis no DOM.",
           "values": []
         }
       ],
@@ -1818,7 +1818,7 @@
     },
     {
       "name": "br-input",
-      "description": "O componente `br-input` é o controle padrão do GovBR-DS para entrada de dados textuais em linha única. Totalmente integrado à validação nativa de formulários HTML via `ElementInternals` (`formAssociated`), ele suporta múltiplos tipos de entrada, máscaras e formatação.\n\n### Para que serve\n\n- **Captura de dados curtos em formulários:** Entrada de textos, senhas, endereços de e-mail, números, telefones, documentos e termos de busca.\n- **Alternância de visualização de senha:** No tipo `type=\"password\"`, oferece botão embutido para alternar entre texto visível e caracteres mascarados com feedback acessível.\n- **Validação e mensagens contextuais:** Comunica valor, validade e mensagens de erro ou orientação diretamente ao formulário HTML e leitores de tela.\n- **Densidade e ícones de apoio:** Suporta diferentes densidades visuais (alta, média e baixa) e ícones prefixados ou sufixados para enriquecer a experiência.\n\n### Quando utilizar\n\n- **Utilize quando:**\n  - A informação digitada couber em uma única linha (ex.: nome, CPF, e-mail, valor monetário, busca).\n- **Evite e prefira outro componente quando:**\n  - O texto for extenso ou exigir múltiplas linhas (prefira `br-textarea`).\n  - A escolha for feita a partir de uma lista pré-determinada de opções (prefira `br-select`, `br-radio` ou `br-checkbox`).\n  - O valor for uma data ou hora estruturada (prefira `br-datetime-picker`).\n\n### Estrutura e Slots\n\nO `br-input` é composto pelo campo de entrada e slots de apoio:\n- `icon`: Slot para ícone de apoio visual (prefixado ou sufixado ao campo de digitação).\n- `feedback`: Slot para exibição de mensagens de validação contextual (como `br-message`).\n\nPara a documentação completa de design, incluindo diretrizes de acessibilidade e especificações visuais, consulte o [Design System do GovBR](https://www.gov.br/ds/components/input?tab=designer).\n---\n\n\n### **Events:**\n - **valueChange** - Valor atualizado do input\n- **brClear** - Emitted when the input clear button action is triggered.\n- **brInputActionClick** - Notifica a ativação do botão do slot `action` por clique ou teclado.\nEmitido no host com `detail.originalEvent` contendo o clique original.\nPropaga e atravessa Shadow DOM; não é cancelável nem altera o clique nativo.\nNão emite para o campo textual, botão de senha, inicialização ou controle desabilitado.\n- **brInputValidationChange** - Informa o início e o resultado do validator, inclusive quando ele consulta\num serviço remoto. O `detail` contém `validating`, `valid` e `message`;\nescrita programática e reset não representam interação do usuário.\n\n### **Methods:**\n - **reportValidity(): _Promise<boolean>_** - Retorna `true` se o valor do input for válido, caso contrário `false`.\nSe o input for inválido, exibe uma mensagem de erro padrão do navegador.\n- **setCustomValidity(message: _string_): _Promise<void>_** - Define uma mensagem de validação customizada para o input.\nSe a mensagem for uma string vazia, o erro customizado é limpo.\n- **validate(): _Promise<boolean>_** - Executa a regra customizada e retorna se o campo está válido.\nSe o validator for assíncrono, aguarda a resposta e ignora resultados\nantigos quando uma execução posterior já começou.\n- **checkValidity(): _Promise<boolean>_** - Retorna `true` se o valor do input for válido, caso contrário `false`.\nSe o input for inválido, dispara um evento 'invalid'.\n- **getValidationState(): _Promise<FormValidationState>_** - Retorna um snapshot serializável da Constraint Validation API.\n- **select(): _Promise<void>_** - Seleciona todo o texto do controle nativo, conforme HTMLInputElement.select().\n- **setRangeText(replacement: _string_, start: _number_, end: _number_, selectionMode: _SelectionMode_): _Promise<void>_** - Substitui um intervalo de texto usando a API nativa do input.\n- **setSelectionRange(start: _number_, end: _number_, direction: _'forward' | 'backward' | 'none'_): _Promise<void>_** - Define o intervalo selecionado no controle nativo.\n- **stepUp(n: _number_): _Promise<void>_** - Incrementa o valor numérico pelo step nativo.\n- **stepDown(n: _number_): _Promise<void>_** - Decrementa o valor numérico pelo step nativo.\n- **showPicker(): _Promise<void>_** - Abre o picker nativo quando o navegador e o tipo do input oferecem essa API.\n- **render(): __** - Renderiza o componente de input.\n\n### **Slots:**\n - **action** - Botão à direita do input.\n- **icon** - Ícone à esquerda do input.\n- **help-text** - Personalização do texto de ajuda.\n- **feedback** - Mensagem de feedback como resposta específica a uma interação do usuário com o input. Pode ser feedback de erro, aviso, sucesso ou informação.\n- **validation-loading** - Indicador exibido enquanto o validator assíncrono está pendente.\n\n### **CSS Parts:**\n - **container** - Contêiner visual principal do input.\n- **label** - Rótulo do input.\n- **input** - Elemento input nativo.\n- **group** - Grupo que contém ícone, input, botão e ajuda.\n- **icon** - Contêiner do slot de ícone.\n- **action** - Botão de ação lateral.\n- **action-button** - Botão interno reexportado do br-button da ação.\n- **help-text** - Texto de ajuda ou slot de ajuda.\n- **feedback** - Slot de feedback.",
+      "description": "O `br-input` captura dados de texto em linha única, como nomes, e-mails, números ou senhas.\n\nConfigure `label`, `placeholder` e o tipo em `type` (como `text`, `email`, `password`, `number`). Use `state` (`success`, `danger`, `info`, `warning`) para indicar validação.\n\n```html\n<br-input label=\"E-mail\" type=\"email\" placeholder=\"nome@exemplo.com\"></br-input>\n<br-input label=\"Senha\" type=\"password\"></br-input>\n```\n\nEm formulários HTML, o componente integra-se nativamente via `ElementInternals`, participando do submit e da validação nativa com `required`.\n\n### Quando usar\n\n- Entrada de texto curto que cabe em uma única linha (nome, CPF, e-mail, telefone).\n- Campo de busca ou senha com alternância de visualização.\n\n### Quando evitar\n\n- Textos longos ou com quebra de linha: use `br-textarea`.\n- Escolha entre opções pré-definidas: use `br-select` ou `br-radio`.\n\nConsulte as [diretrizes de design do GovBR](https://www.gov.br/ds/components/input?tab=designer).\n---\n\n\n### **Events:**\n - **valueChange** - Valor atualizado do input\n- **brClear** - Emitido quando o usuário aciona o botão de limpar (`clearable`), depois que o\nvalor foi limpo e o evento `input` foi disparado.\n- **brInputActionClick** - Notifica a ativação do botão do slot `action` por clique ou teclado.\nEmitido no host com `detail.originalEvent` contendo o clique original.\nPropaga e atravessa Shadow DOM; não é cancelável nem altera o clique nativo.\nNão emite para o campo textual, botão de senha, inicialização ou controle desabilitado.\n- **brInputValidationChange** - Informa o início e o resultado do validator, inclusive quando ele consulta\num serviço remoto. O `detail` contém `validating`, `valid` e `message`;\nescrita programática e reset não representam interação do usuário.\n\n### **Methods:**\n - **reportValidity(): _Promise<boolean>_** - Retorna `true` se o valor do input for válido, caso contrário `false`.\nSe o input for inválido, exibe uma mensagem de erro padrão do navegador.\n- **setCustomValidity(message: _string_): _Promise<void>_** - Define uma mensagem de validação customizada para o input.\nSe a mensagem for uma string vazia, o erro customizado é limpo.\n- **validate(): _Promise<boolean>_** - Executa a regra customizada e retorna se o campo está válido.\nSe o validator for assíncrono, aguarda a resposta e ignora resultados\nantigos quando uma execução posterior já começou.\n- **checkValidity(): _Promise<boolean>_** - Retorna `true` se o valor do input for válido, caso contrário `false`.\nSe o input for inválido, dispara um evento 'invalid'.\n- **getValidationState(): _Promise<FormValidationState>_** - Retorna um snapshot serializável da Constraint Validation API.\n- **select(): _Promise<void>_** - Seleciona todo o texto do controle nativo, conforme HTMLInputElement.select().\n- **setRangeText(replacement: _string_, start: _number_, end: _number_, selectionMode: _SelectionMode_): _Promise<void>_** - Substitui um intervalo de texto usando a API nativa do input.\n- **setSelectionRange(start: _number_, end: _number_, direction: _'forward' | 'backward' | 'none'_): _Promise<void>_** - Define o intervalo selecionado no controle nativo.\n- **stepUp(n: _number_): _Promise<void>_** - Incrementa o valor numérico pelo step nativo.\n- **stepDown(n: _number_): _Promise<void>_** - Decrementa o valor numérico pelo step nativo.\n- **showPicker(): _Promise<void>_** - Abre o picker nativo quando o navegador e o tipo do input oferecem essa API.\n- **render(): __** - Renderiza o componente de input.\n\n### **Slots:**\n - **action** - Botão à direita do input.\n- **icon** - Ícone à esquerda do input.\n- **help-text** - Personalização do texto de ajuda.\n- **feedback** - Mensagem de feedback como resposta específica a uma interação do usuário com o input. Pode ser feedback de erro, aviso, sucesso ou informação.\n- **validation-loading** - Indicador exibido enquanto o validator assíncrono está pendente.\n\n### **CSS Parts:**\n - **container** - Contêiner visual principal do input.\n- **label** - Rótulo do input.\n- **input** - Elemento input nativo.\n- **group** - Grupo que contém ícone, input, botão e ajuda.\n- **icon** - Contêiner do slot de ícone.\n- **action** - Botão de ação lateral.\n- **action-button** - Botão interno reexportado do br-button da ação.\n- **clear** - Botão de limpar exibido com `clearable` enquanto há texto editável.\n- **help-text** - Texto de ajuda ou slot de ajuda.\n- **feedback** - Slot de feedback.",
       "attributes": [
         {
           "name": "type",
@@ -1867,7 +1867,7 @@
         },
         {
           "name": "feedback-state",
-          "description": "Estado de feedback canônico. Quando informado, tem precedência sobre `state`.",
+          "description": "Estado de feedback. Quando informado, tem precedência sobre `state`.",
           "values": [{ "name": "InputState" }]
         },
         {
@@ -1984,13 +1984,18 @@
           "name": "action-tab-index",
           "description": "Define o tabindex do botão de ação.\nÚtil para remover o botão da sequência de tabulação quando o foco é gerenciado externamente (ex.: br-select).\nAceita inteiros maiores ou iguais a -1; valores inválidos são ignorados.",
           "values": []
+        },
+        {
+          "name": "clearable",
+          "description": "Exibe um botão para limpar o texto enquanto o campo tem valor e aceita edição.\nO botão fica à esquerda do botão de ação, quando houver. Ao ser acionado,\nlimpa o valor, emite `input` uma única vez e `brClear`, e devolve o foco ao campo.\nNão é exibido com `disabled` ou `readonly`.",
+          "values": []
         }
       ],
       "references": []
     },
     {
       "name": "br-item",
-      "description": "O componente `br-item` é o elemento flexível e padronizado do GovBR-DS para construção de linhas navegáveis, selecionáveis ou de exibição em listas, menus contextuais e painéis suspensos.\n\n### Para que serve\n\n- **Padronização de linhas interativas:** Garante espaçamento, tipografia, contraste e efeitos de estado (hover, foco visível, seleção e desativação) em conformidade com os tokens do design system.\n- **Polimorfismo semântico:** Pode renderizar internamente um botão interativo (`<button>`), um hiperlink navegável (`<a>`) ou uma divisão semântica (`<div>`) dependendo dos atributos fornecidos (`href`, `clickable`).\n- **Suporte a seleção visual:** Oferece suporte a estados de seleção (`selected`), marcas de verificação e densidades ajustáveis.\n\n### Quando utilizar\n\n- **Utilize quando:**\n  - Estiver montando linhas de conteúdo em listas (`br-list`), painéis flutuantes (`br-dropdown`) ou agrupamentos verticais.\n  - Cada entrada representar um item de dado ou uma ação com estilo homogêneo.\n- **Evite e prefira outro componente quando:**\n  - O item pertencer especificamente à navegação de abas (use `br-tab-item`), etapas de fluxo (use `br-step-item`) ou seleção em formulário (use `br-select-option`).\n\n### Estrutura e Slots\n\nO `br-item` é um componente estrutural direto:\n- `default`: Slot para inserção do conteúdo livre da linha (textos, ícones, badges ou metadados).\n\nPara a documentação completa de design, incluindo diretrizes de acessibilidade e especificações visuais, consulte o [Design System do GovBR](https://www.gov.br/ds/components/item?tab=designer).\n---\n\n\n### **Events:**\n - **brDidClick** - Evento customizado emitido quando o item é clicado, aplicável apenas se o item for um botão (`<button>`).\nPode ser utilizado para ações personalizadas, exceto quando o item está desativado.\n- **brItemClick** - Evento canônico emitido quando o item com comportamento de botão é acionado.\n- **brDidSelect** - Evento customizado aplicável para todos os tipos de elementos (`div`, `button`, `a`), emitido quando a seleção do item interativo ou botão muda.\nO `detail` expõe `{ selected: boolean }` indicando o novo estado.\nNão é emitido quando `disabled` está ativo.\n- **brItemSelect** - Evento canônico emitido quando a seleção muda.\n- **brNavigate** - Evento cancelável emitido em `navigation-mode=\"event\"` para cliques primários sem modificadores em links `_self`.\nChame `event.preventDefault()` no listener para impedir a navegação nativa e entregar `event.detail.href` ao roteador da SPA.\n\n### **Methods:**\n - **activate()** - Ativa o item programaticamente, simulando um clique na superfície.\nUtilizado pelo br-list para tratar Enter e Espaço via teclado, e\ninternamente pelo próprio item quando standalone (fora de br-list).\n- **setFocus()** - Define o foco no elemento interno do componente.\nEste método pode ser chamado externamente para garantir que o foco seja aplicado ao elemento correto.\n- **setTabIndex(value: _number_)** - Define o tabIndex do elemento interno.\nUtilizado pelo br-list para implementar o padrão roving tabindex,\ngarantindo que apenas um item por vez seja alcançável via Tab.\n\n### **Slots:**\n - **default** - Área de conteúdo, podendo conter qualquer componente, exceto botões primários e componentes relacionados à navegação (como carrosséis, paginações, abas, menus, etc.).\n- **start** - Área de recursos visuais, podendo conter elementos como ícones, avatares e mídias.\n- **end** - Área de recursos complementares, podendo conter componentes interativos, metadados e informações adicionais.\n\n### **CSS Parts:**\n - **item** - Elemento principal do item (botão, link ou div).",
+      "description": "O `br-item` padroniza uma linha de conteúdo, ação ou link dentro de listas, menus ou agrupamentos verticais.\n\nColoque o texto ou elementos no slot padrão. Use `interactive` para habilitar efeito de clique e foco, ou `href` para transformá-lo em link navegável. Para destacar um item escolhido, use `selected`.\n\n```html\n<br-item interactive>Item de ação</br-item>\n<br-item href=\"/perfil\">Meu Perfil</br-item>\n```\n\n### Quando usar\n\n- Linhas de dados em listas (`br-list`) ou painéis verticais.\n- Linhas com foco, hover e seleção consistentes com o design system.\n\n### Quando evitar\n\n- Itens específicos de navegação estruturada: use `br-breadcrumb-item`, `br-tab-item` ou `br-step-item`.\n- Opções de seleção em formulário: use `br-select-option`.\n\nConsulte as [diretrizes de design do GovBR](https://www.gov.br/ds/components/item?tab=designer).\n---\n\n\n### **Events:**\n - **brDidClick** - Evento customizado emitido quando o item é clicado, aplicável apenas se o item for um botão (`<button>`).\nPode ser utilizado para ações personalizadas, exceto quando o item está desativado.\n- **brItemClick** - Evento emitido quando o item com comportamento de botão é acionado.\n- **brDidSelect** - Evento customizado aplicável para todos os tipos de elementos (`div`, `button`, `a`), emitido quando a seleção do item interativo ou botão muda.\nO `detail` expõe `{ selected: boolean }` indicando o novo estado.\nNão é emitido quando `disabled` está ativo.\n- **brItemSelect** - Evento emitido quando a seleção muda.\n- **brNavigate** - Evento cancelável emitido em `navigation-mode=\"event\"` para cliques primários sem modificadores em links `_self`.\nChame `event.preventDefault()` no listener para impedir a navegação nativa e entregar `event.detail.href` ao roteador da SPA.\n\n### **Methods:**\n - **activate()** - Ativa o item programaticamente, simulando um clique na superfície.\nUtilizado pelo br-list para tratar Enter e Espaço via teclado, e\ninternamente pelo próprio item quando standalone (fora de br-list).\n- **setFocus()** - Define o foco no elemento interno do componente.\nEste método pode ser chamado externamente para garantir que o foco seja aplicado ao elemento correto.\n- **setTabIndex(value: _number_)** - Define o tabIndex do elemento interno.\nUtilizado pelo br-list para implementar o padrão roving tabindex,\ngarantindo que apenas um item por vez seja alcançável via Tab.\n\n### **Slots:**\n - **default** - Área de conteúdo, podendo conter qualquer componente, exceto botões primários e componentes relacionados à navegação (como carrosséis, paginações, abas, menus, etc.).\n- **start** - Área de recursos visuais, podendo conter elementos como ícones, avatares e mídias.\n- **end** - Área de recursos complementares, podendo conter componentes interativos, metadados e informações adicionais.\n\n### **CSS Parts:**\n - **item** - Elemento principal do item (botão, link ou div).",
       "attributes": [
         {
           "name": "disabled",
@@ -2009,7 +2014,7 @@
         },
         {
           "name": "active",
-          "description": "Estado ativo canônico. Quando informado, tem precedência sobre `isActive`.",
+          "description": "Estado ativo atual. Quando informado, tem precedência sobre `isActive`.",
           "values": []
         },
         {
@@ -2019,7 +2024,7 @@
         },
         {
           "name": "selected",
-          "description": "Estado selecionado canônico. Em itens interativos, também é atualizado pelo acionamento.",
+          "description": "Estado selecionado. Em itens interativos, também é atualizado pelo acionamento.",
           "values": []
         },
         {
@@ -2077,7 +2082,7 @@
     },
     {
       "name": "br-link",
-      "description": "O componente `br-link` é o controle oficial de hiperlink do GovBR-DS, projetado para orientar e conduzir a pessoa usuária em navegações internas entre páginas ou encaminhamentos para destinos externos.\n\n### Para que serve\n\n- **Navegação estruturada:** Conduz o usuário para novas URLs, rotas de aplicação, âncoras dentro da mesma página ou arquivos para download.\n- **Identificação de links externos:** Permite sinalizar visualmente que o link aponta para um domínio externo ou abre em nova aba/janela, adicionando os atributos de segurança e acessibilidade necessários (`target=\"_blank\"`, `rel=\"noopener noreferrer\"`).\n- **Estilos inline e de bloco:** Adapta-se ao fluxo de leitura textual em parágrafos ou como elemento de navegação isolado com suporte a ícones.\n\n### Quando utilizar\n\n- **Utilize quando:**\n  - A ação resultar na alteração da URL do navegador, navegação para outra página ou download de arquivo.\n- **Evite e prefira outro componente quando:**\n  - A ação disparar um comportamento na interface sem alterar a URL (como abrir modal, submeter formulário ou acionar filtro): prefira `br-button`.\n\n### Estrutura e Slots\n\nO `br-link` é um componente autônomo:\n- `default`: Slot para o texto do link, ícones auxiliares ou elementos combinados.\n\nPara a documentação completa de design, incluindo diretrizes de acessibilidade e especificações visuais, consulte o [Design System do GovBR](https://www.gov.br/ds/components/link?tab=designer).\n---\n\n\n### **Events:**\n - **brNavigate** - Evento cancelável emitido em `navigation-mode=\"event\"` para cliques primários sem modificadores em links `_self`.\nChame `event.preventDefault()` no listener para impedir a navegação nativa e entregar `event.detail.href` ao roteador da SPA.\n- **brSpaNavigate**\n\n### **Slots:**\n - **default** - Conteúdo do link (texto, ícones ou outros elementos).\n\n### **CSS Parts:**\n - **anchor** - Parte exposta para o elemento âncora interno, usada para estilos customizados via `::part(anchor)`.",
+      "description": "O `br-link` conduz a pessoa usuária a outra página, arquivo para download ou seção externa.\n\nColoque o texto ou ícone no slot padrão e aponte o destino em `href`. Para destinos externos ou abas novas, use `target=\"_blank\"`. Para integração com roteadores de SPA, use `navigation-mode=\"event\"` e ouça o evento `brNavigate`.\n\n```html\n<br-link href=\"/servicos\">Serviços disponíveis</br-link>\n<br-link href=\"https://www.gov.br\" target=\"_blank\">Portal Gov.br</br-link>\n```\n\n### Quando usar\n\n- Navegar para outra página, rota ou domínio.\n- Fazer download de arquivos ou saltar para âncoras na mesma página.\n\n### Quando evitar\n\n- Executar uma ação na página atual (salvar, abrir diálogo): use `br-button`.\n\nConsulte as [diretrizes de design do GovBR](https://www.gov.br/ds/components/link?tab=designer).\n---\n\n\n### **Events:**\n - **brNavigate** - Evento cancelável emitido em `navigation-mode=\"event\"` para cliques primários sem modificadores em links `_self`.\nChame `event.preventDefault()` no listener para impedir a navegação nativa e entregar `event.detail.href` ao roteador da SPA.\n- **brSpaNavigate**\n\n### **Slots:**\n - **default** - Conteúdo do link (texto, ícones ou outros elementos).\n\n### **CSS Parts:**\n - **anchor** - Parte exposta para o elemento âncora interno, usada para estilos customizados via `::part(anchor)`.",
       "attributes": [
         {
           "name": "href",
@@ -2151,7 +2156,7 @@
         },
         {
           "name": "aria-expanded",
-          "description": "Valor canônico de `aria-expanded`.",
+          "description": "Valor de `aria-expanded`.",
           "values": []
         },
         {
@@ -2161,7 +2166,7 @@
         },
         {
           "name": "aria-selected",
-          "description": "Valor canônico de `aria-selected`.",
+          "description": "Valor de `aria-selected`.",
           "values": []
         },
         {
@@ -2171,7 +2176,7 @@
         },
         {
           "name": "aria-haspopup",
-          "description": "Valor canônico de `aria-haspopup`.",
+          "description": "Valor de `aria-haspopup`.",
           "values": []
         },
         {
@@ -2181,7 +2186,7 @@
         },
         {
           "name": "aria-current",
-          "description": "Valor canônico de `aria-current`.",
+          "description": "Valor de `aria-current`.",
           "values": []
         },
         {
@@ -2191,7 +2196,7 @@
         },
         {
           "name": "aria-label",
-          "description": "Valor canônico de `aria-label`.",
+          "description": "Valor de `aria-label`.",
           "values": []
         },
         {
@@ -2201,7 +2206,7 @@
         },
         {
           "name": "aria-describedby",
-          "description": "Valor canônico de `aria-describedby`.",
+          "description": "Valor de `aria-describedby`.",
           "values": []
         }
       ],
@@ -2209,7 +2214,7 @@
     },
     {
       "name": "br-list",
-      "description": "O componente `br-list` é o contêiner estrutural do GovBR-DS desenvolvido para apresentar coleções verticais de itens homogêneos ou relacionados de forma organizada, fácil de percorrer visualmente e acessível.\n\n### Para que serve\n\n- **Apresentação sequencial de informações:** Organiza listagens de dados, tarefas, configurações, opções de navegação ou mensagens.\n- **Cabeçalho e ações integradas:** Suporta cabeçalho contextual (`header`) para exibição de título da lista, contadores de itens ou botões de ação em lote.\n- **Composição com itens padronizados:** Integra-se perfeitamente com elementos `br-item` e divisores `br-divider`, mantendo ritmo visual e alinhamento consistentes.\n\n### Quando utilizar\n\n- **Utilize quando:**\n  - Desejar exibir uma sequência vertical de itens que compartilham a mesma estrutura ou propósito.\n  - O conteúdo favorecer leitura linear ou seleção de uma linha e precisar ser percorrido visualmente com rapidez.\n- **Evite e prefira outro componente quando:**\n  - As informações forem tabulares com múltiplas colunas e necessidade de ordenação por coluna (prefira `br-table`).\n  - A lista representar o menu principal de navegação do sistema (prefira `br-menu`).\n\n### Estrutura e Slots\n\nO `br-list` atua como contêiner de itens:\n- `header`: Slot opcional para cabeçalho da lista (título, filtros ou ações globais).\n- `default`: Slot principal onde são inseridos os elementos filhos (como `br-item` ou divs semânticas).\n\nPara a documentação completa de design, incluindo diretrizes de acessibilidade e especificações visuais, consulte o [Design System do GovBR](https://www.gov.br/ds/components/list?tab=designer).\n---\n\n\n### **Methods:**\n - **handleAccordionExclusivity(event: _CustomEvent<{ accordionGroup?: string }>_)** - Coordena o accordion entre listas irmãs. Quando o `br-collapse` interno\ndesta lista abre, fecha o `br-collapse` das demais `br-list` irmãs que\ncompartilham o mesmo valor de `accordion`. Só reage ao evento da própria\nlista — `brCollapseOpen` de outras listas não passa por este host.\n- **focusFirstItem()** - Move o foco para o primeiro item navegável da lista.\nAPI pública para componentes que abrem a lista programaticamente\n(ex.: `br-dropdown`), evitando acesso direto ao `br-item`.\n\n### **Slots:**\n - **default** - Slot para os itens da lista.\n- **header** - Slot para ações ou conteúdo do cabeçalho da lista.\n\n### **CSS Parts:**\n - **container** - Wrapper principal da lista.",
+      "description": "O `br-list` organiza coleções verticais de itens homogêneos ou relacionados, como listas de contatos, tarefas ou configurações.\n\nAdicione os itens (como `br-item`) no slot padrão. Se precisar de um título ou ações no topo da lista, use o slot `header` ou a propriedade `title`.\n\n```html\n<br-list title=\"Configurações\">\n  <br-item interactive>Notificações</br-item>\n  <br-item interactive>Segurança</br-item>\n</br-list>\n```\n\n### Quando usar\n\n- Sequências verticais de itens com leitura linear.\n- Listas de opções simples ou links agrupados.\n\n### Quando evitar\n\n- Dados em linhas e colunas com ordenação: use `br-table`.\n- Menu lateral de navegação da página: use `br-menu`.\n\nConsulte as [diretrizes de design do GovBR](https://www.gov.br/ds/components/list?tab=designer).\n---\n\n\n### **Methods:**\n - **handleAccordionExclusivity(event: _CustomEvent<{ accordionGroup?: string }>_)** - Coordena o accordion entre listas irmãs. Quando o `br-collapse` interno\ndesta lista abre, fecha o `br-collapse` das demais `br-list` irmãs que\ncompartilham o mesmo valor de `accordion`. Só reage ao evento da própria\nlista — `brCollapseOpen` de outras listas não passa por este host.\n- **focusFirstItem()** - Move o foco para o primeiro item navegável da lista.\nAPI pública para componentes que abrem a lista programaticamente\n(ex.: `br-dropdown`), evitando acesso direto ao `br-item`.\n\n### **Slots:**\n - **default** - Slot para os itens da lista.\n- **header** - Slot para ações ou conteúdo do cabeçalho da lista.\n\n### **CSS Parts:**\n - **container** - Wrapper principal da lista.",
       "attributes": [
         {
           "name": "header",
@@ -2223,7 +2228,7 @@
         },
         {
           "name": "orientation",
-          "description": "Orientação canônica. Quando informada, tem precedência sobre `isHorizontal`; valores inválidos usam `vertical`.",
+          "description": "Orientação padrão. Quando informada, tem precedência sobre `isHorizontal`; valores inválidos usam `vertical`.",
           "values": [{ "name": "horizontal" }, { "name": "vertical" }]
         },
         {
@@ -2270,7 +2275,7 @@
     },
     {
       "name": "br-loading",
-      "description": "O componente `br-loading` é o indicador de carregamento e progresso do GovBR-DS, utilizado para informar visualmente e de forma acessível que uma operação assíncrona está em execução no sistema.\n\n### Para que serve\n\n- **Feedback de processamento:** Alerta a pessoa usuária de que uma requisição, cálculo ou carregamento de dados está ocorrendo, evitando múltiplos cliques acidentais.\n- **Modo spinner (indeterminado):** Indicador circular contínuo para operações de duração imprevisível.\n- **Modo progress (determinado):** Indicador com percentual explícito (0 a 100%) para downloads, uploads ou tarefas com progresso mensurável, suportando ação de cancelamento.\n- **Acessibilidade para tecnologias assistivas:** Comunica o estado de carregamento através de regiões acessíveis (`aria-live=\"polite\"` e papéis `progressbar` ou `status`).\n\n### Quando utilizar\n\n- **Utilize quando:**\n  - Uma operação assíncrona demorar mais de 300 a 500 milissegundos para responder.\n  - Durante o envio de formulários volumosos, processamento de arquivos ou transição de telas pesadas.\n- **Evite e prefira outro componente quando:**\n  - A resposta for quase instantânea (menos de 300ms), para evitar piscamento rápido de tela que cause desconforto visual.\n  - A espera ocorrer dentro de um botão durante o clique (use a prop `loading` do próprio `br-button`).\n\n### Estrutura e Slots\n\nO `br-loading` oferece slots para personalização:\n- `label`: Slot para rótulo ou mensagem descritiva do carregamento (substitui a prop `label`).\n- `cancel-button`: Slot para botão customizado de cancelamento no modo `progress`.\n\nPara a documentação completa de design, incluindo diretrizes de acessibilidade e especificações visuais, consulte o [Design System do GovBR](https://www.gov.br/ds/components/loading?tab=designer).\n---\n\n\n### **Events:**\n - **brLoadingChange** - Notifica mudança de progresso no modo `progress`.\n- **brLoadingComplete** - Notifica conclusão do progresso no modo `progress`.\n- **brLoadingReset** - Notifica reinício do progresso no modo `progress`.\n- **brLoadingCancel** - Notifica clique no botão de cancelamento no modo `progress`.\nEste evento não altera o progresso automaticamente.\nA aplicação consumidora define a ação após o cancelamento (ex.: limpar ou ocultar).\n- **brIndeterminateStateChange** - Notifica mudança do estado lógico no modo `spinner`.\n- **brDidShow** - Notifica que o componente foi exibido.\n- **brLoadingShow** - Evento canônico emitido quando o loading é exibido.\n- **brDidHide** - Notifica que o componente foi ocultado.\n- **brLoadingHide** - Evento canônico emitido quando o loading é ocultado.\n\n### **Methods:**\n - **handleCompletion(newValue: _number_)** - Reage a mudanças em `value` no modo `progress`.\n- **handleModeChange()** - Reage a mudanças em `mode` e atualiza o estado lógico de atividade.\n- **setValue(value: _number_): _Promise<{ value: number }>_** - Define o valor do progresso.\n- **incrementValue(step): _Promise<{ value: number }>_** - Soma um valor ao progresso atual.\n- **complete(): _Promise<{ value: number }>_** - Define o progresso como concluído.\n- **reset(): _Promise<{ value: number }>_** - Reinicia o progresso e exibe o componente.\n- **show(): _Promise<{ visible: boolean }>_** - Exibe o componente.\n- **hide(): _Promise<{ visible: boolean }>_** - Oculta o componente.\n- **render(): __** - Renderiza o componente conforme o modo atual.\n\n### **Slots:**\n - **label** - Rótulo customizado do loading. Quando utilizado, a prop `label` é ignorada.\n- **cancel-button** - Conteúdo customizado do botão de cancelar. Quando utilizado, a prop `cancelLabel` é ignorada.\n\n### **CSS Parts:**\n - **container** - Wrapper principal do loading.\n- **wrapper** - Wrapper do conteúdo do spinner/progress.\n- **svg** - Elemento SVG principal do loading.\n- **percentage** - Texto de percentual no modo `progress`.\n- **label-wrapper** - Wrapper do rótulo no modo `spinner`.\n- **cancel-button** - Botão de cancelamento no modo `progress` cancelável.",
+      "description": "O `br-loading` indica visualmente que uma operação assíncrona está em andamento.\n\nSuporta o modo circular padrão (indeterminado) ou o modo determinístico com barra e percentual via `progress`. Para adicionar uma mensagem explicativa, informe `label`.\n\n```html\n<br-loading label=\"Carregando dados...\"></br-loading>\n<br-loading progress=\"60\" label=\"Enviando arquivo...\"></br-loading>\n```\n\n### Quando usar\n\n- Operações que demoram mais de 300 ms (carregamento de dados, envio de formulário).\n- Downloads ou uploads com percentual de progresso mensurável.\n\n### Quando evitar\n\n- Operações instantâneas (menos de 300 ms).\n- Carregamento interno em botão: use a propriedade `loading` do `br-button`.\n\nConsulte as [diretrizes de design do GovBR](https://www.gov.br/ds/components/loading?tab=designer).\n---\n\n\n### **Events:**\n - **brLoadingChange** - Notifica mudança de progresso no modo `progress`.\n- **brLoadingComplete** - Notifica conclusão do progresso no modo `progress`.\n- **brLoadingReset** - Notifica reinício do progresso no modo `progress`.\n- **brLoadingCancel** - Notifica clique no botão de cancelamento no modo `progress`.\nEste evento não altera o progresso automaticamente.\nA aplicação consumidora define a ação após o cancelamento (ex.: limpar ou ocultar).\n- **brIndeterminateStateChange** - Notifica mudança do estado lógico no modo `spinner`.\n- **brDidShow** - Notifica que o componente foi exibido.\n- **brLoadingShow** - Evento emitido quando o loading é exibido.\n- **brDidHide** - Notifica que o componente foi ocultado.\n- **brLoadingHide** - Evento emitido quando o loading é ocultado.\n\n### **Methods:**\n - **handleCompletion(newValue: _number_)** - Reage a mudanças em `value` no modo `progress`.\n- **handleModeChange()** - Reage a mudanças em `mode` e atualiza o estado lógico de atividade.\n- **setValue(value: _number_): _Promise<{ value: number }>_** - Define o valor do progresso.\n- **incrementValue(step): _Promise<{ value: number }>_** - Soma um valor ao progresso atual.\n- **complete(): _Promise<{ value: number }>_** - Define o progresso como concluído.\n- **reset(): _Promise<{ value: number }>_** - Reinicia o progresso e exibe o componente.\n- **show(): _Promise<{ visible: boolean }>_** - Exibe o componente.\n- **hide(): _Promise<{ visible: boolean }>_** - Oculta o componente.\n- **render(): __** - Renderiza o componente conforme o modo atual.\n\n### **Slots:**\n - **label** - Rótulo customizado do loading. Quando utilizado, a prop `label` é ignorada.\n- **cancel-button** - Conteúdo customizado do botão de cancelar. Quando utilizado, a prop `cancelLabel` é ignorada.\n\n### **CSS Parts:**\n - **container** - Wrapper principal do loading.\n- **wrapper** - Wrapper do conteúdo do spinner/progress.\n- **svg** - Elemento SVG principal do loading.\n- **percentage** - Texto de percentual no modo `progress`.\n- **label-wrapper** - Wrapper do rótulo no modo `spinner`.\n- **cancel-button** - Botão de cancelamento no modo `progress` cancelável.",
       "attributes": [
         {
           "name": "label-position",
@@ -2294,7 +2299,7 @@
         },
         {
           "name": "density",
-          "description": "Densidade visual canônica. Quando informada, tem precedência sobre `size`.\nAceita `small`, `medium` ou `large`. Valores inválidos usam `medium`.",
+          "description": "Densidade visual. Quando informada, tem precedência sobre `size`.\nAceita `small`, `medium` ou `large`. Valores inválidos usam `medium`.",
           "values": [{ "name": "LoadingSize" }]
         },
         {
@@ -2337,7 +2342,7 @@
     },
     {
       "name": "br-magic-button",
-      "description": "O componente `br-magic-button` é o botão de ação flutuante (Floating Action Button - FAB) do GovBR-DS, projetado para destacar a ação primária ou mais relevante da tela, mantendo-se acessível e visível durante a navegação.\n\n### Para que serve\n\n- **Destaque da ação principal:** Cria um ponto focal imediato para a ação central de uma tela (ex.: \"Nova mensagem\", \"Criar solicitação\", \"Adicionar item\").\n- **Posicionamento persistente ou integrado:** Pode ser fixado em um canto da tela (em dispositivos móveis) ou posicionado no fluxo de leitura de painéis e tabelas.\n- **Modos circular e expandido:** Suporta visual circular compacto com ícone ou versão expandida com texto explicativo.\n\n### Quando utilizar\n\n- **Utilize quando:**\n  - Houver uma única ação dominante que represente o principal objetivo da pessoa usuária naquela tela.\n  - Em aplicações móveis ou responsivas que necessitem de um atalho de fácil alcance para os polegares.\n- **Evite e prefira outro componente quando:**\n  - Houver múltiplas ações de importância equivalente (prefira uma barra de botões com `br-button`).\n  - A ação for secundária, destrutiva ou de cancelamento.\n\n### Estrutura e Slots\n\nO `br-magic-button` é um controle direto:\n- `default`: Slot para rótulo de texto ou conteúdo interno do botão.\n- `icon`: Slot para personalização do ícone de ação (como `br-icon`).\n\nPara a documentação completa de design, incluindo diretrizes de acessibilidade e especificações visuais, consulte o [Design System do GovBR](https://www.gov.br/ds/components/magic-button?tab=designer).\n---\n\n\n### **Methods:**\n - **render()** - Renderiza o componente.\n\n### **Slots:**\n - **default** - Conteúdo interno do botão (texto ou ícone).\n- **icon** - Ícone customizado do botão. Quando utilizado, a prop `icon` é ignorada.\n\n### **CSS Parts:**\n - **container** - Wrapper principal do magic-button.\n- **button** - Elemento button interno.",
+      "description": "O `br-magic-button` é o botão de ação flutuante (FAB) que destaca a ação primária ou mais frequente da tela.\n\nPode ser exibido apenas com ícone (formato circular) ou expandido com texto descritivo.\n\n```html\n<br-magic-button icon=\"fa-solid:plus\" aria-label=\"Novo item\"></br-magic-button>\n<br-magic-button icon=\"fa-solid:plus\">Criar documento</br-magic-button>\n```\n\n### Quando usar\n\n- Ação principal e dominante da tela em dispositivos móveis ou interfaces focadas em uma tarefa única.\n\n### Quando evitar\n\n- Múltiplas ações de mesma importância: use `br-button`.\n- Ações secundárias ou destrutivas.\n\nConsulte as [diretrizes de design do GovBR](https://www.gov.br/ds/components/magic-button?tab=designer).\n---\n\n\n### **Methods:**\n - **render()** - Renderiza o componente.\n\n### **Slots:**\n - **default** - Conteúdo interno do botão (texto ou ícone).\n- **icon** - Ícone customizado do botão. Quando utilizado, a prop `icon` é ignorada.\n\n### **CSS Parts:**\n - **container** - Wrapper principal do magic-button.\n- **button** - Elemento button interno.",
       "attributes": [
         {
           "name": "custom-id",
@@ -2351,7 +2356,7 @@
         },
         {
           "name": "icon",
-          "description": "Ícone como identificador Iconify (ex.: `fa6-solid:star`) ou nome simples (ex.: `question`,\nresolvido como `fa6-solid:question` no registro SVG local), renderizado pelo `br-icon`.\nPara classes CSS (ex.: Font Awesome) ou SVGs personalizados, use o slot `icon`, a forma preferida.\nUso descontinuado: classes CSS nesta prop (ex.: `fas fa-star`) não são exibidas no Shadow DOM\ne geram aviso.",
+          "description": "Ícone como identificador Font Awesome 5 Free do cache local (ex.: `fa-solid:star`) ou nome simples\n(ex.: `question`, resolvido como `fa-solid:question`), renderizado pelo `br-icon`.\nPara classes CSS (ex.: Font Awesome) ou SVGs personalizados, use o slot `icon`, a forma preferida.\nUso descontinuado: classes CSS nesta prop (ex.: `fas fa-star`) não são exibidas no Shadow DOM\ne geram aviso.",
           "values": []
         },
         {
@@ -2374,7 +2379,7 @@
     },
     {
       "name": "br-menu",
-      "description": "O componente `br-menu` é o orquestrador completo de navegação lateral (drawer/sidebar) do GovBR-DS. Estrutura a navegação multinível de portais e sistemas públicos, oferecendo suporte a hierarquias em árvore, agrupamentos, busca interna, informações do usuário e canais sociais.\n\n### Para que serve\n\n- **Navegação estruturada em árvore:** Permite navegar por hierarquias profundas de seções e subsistemas governamentais.\n- **Modos responsivos:** Suporta exibição fixa/lateral no desktop e painel retrátil suspenso com cortina de fundo (`br-scrim`) em telas mobile.\n- **Acessibilidade completa:** Gerencia controle de foco por teclado, armadilha de foco (trap focus) quando aberto e atributos WAI-ARIA (`aria-expanded`, `role=\"dialog\"` ou `role=\"navigation\"`).\n- **Navegação multinível fluida:** Oferece transições suaves entre níveis hierárquicos com botões de retorno ao nível anterior.\n\n### Quando utilizar\n\n- **Utilize quando:**\n  - A aplicação ou portal exigir uma estrutura de navegação lateral abrangente, com menus de múltiplos níveis e categorias.\n  - Houver necessidade de um menu que possa ser recolhido ou deslizado em dispositivos móveis com controle de foco integrado.\n- **Evite e prefira outro componente quando:**\n  - A navegação tiver poucos itens e puder ser acomodada confortavelmente apenas no cabeçalho (prefira `br-header`).\n  - O objetivo for alternar visualizações na mesma tela de forma plana (prefira `br-tab`).\n\n### Composição e Subcomponentes\n\n| Subcomponente | Papel | Regra de uso |\n| --- | --- | --- |\n| `br-menu` | **Orquestrador principal.** Gerencia estado aberto/fechado, navegação multinível, scrim e armadilha de foco. | Deve ser declarado como contêiner principal da navegação lateral. |\n| `br-menu-header` | **Cabeçalho do menu.** Exibe título e botão de fechar o painel. | Inserido no topo do `br-menu`. |\n| `br-menu-group` | **Agrupador temático.** Agrupa itens sob um subtítulo de seção. | Inserido no corpo de navegação do `br-menu`. |\n| `br-menu-list` | **Lista de opções.** Estrutura semântica de lista contendo itens navegáveis. | Inserido no `br-menu` ou dentro de um `br-menu-group`. |\n| `br-menu-item` | **Item de menu.** Opção clicável de rota ou gatilho para submenu. | Deve ser utilizado dentro de um `br-menu-list`. |\n| `br-menu-link` | **Hiperlink.** Link textual padronizado no menu. | Inserido dentro de `br-menu-item` ou seções de apoio. |\n| `br-menu-info` | **Informações de apoio.** Exibe dados de sessão, versão ou contexto do sistema. | Posicionado na base ou topo do `br-menu`. |\n| `br-menu-logo` | **Logotipo.** Exibe a marca do órgão no interior do menu. | Posicionado no cabeçalho ou topo do `br-menu`. |\n| `br-menu-social` | **Redes sociais.** Bloco de canais sociais oficiais no menu. | Posicionado preferencialmente no rodapé do `br-menu`. |\n\n### Como os subcomponentes se relacionam\n\nO `br-menu` atua como o orquestrador soberano da navegação. Ele controla a transição de visibilidade, a ativação do scrim de fundo e o comportamento dos subníveis. Ao navegar entre níveis, os itens (`br-menu-item`) comunicam suas seleções ao `br-menu`, que desliza os painéis correspondentes e mantém a ordem correta de tabulação do teclado.\n\nPara a documentação completa de design, incluindo diretrizes de acessibilidade e especificações visuais, consulte o [Design System do GovBR](https://www.gov.br/ds/components/menu?tab=designer).\n---\n\n\n### **Events:**\n - **brMenuStateChange** - Evento emitido quando o menu abre ou fecha.\n- **brMenuOpenChange** - Evento canônico emitido quando o menu abre ou fecha.\n`detail.open` contém o estado concluído e `detail.sourceId` identifica a instância pelo `id` ou `customId`.\n\n### **Methods:**\n - **onDocumentClick(ev: _MouseEvent_)** - Escuta cliques no documento para alternar o estado do menu automaticamente\nquando um elemento com o atributo `data-toggle=\"menu\"` é clicado.\nUtiliza o caminho completo do evento (composedPath) para permitir o funcionamento\ncorreto quando o botão acionador está dentro de outros componentes com Shadow DOM (ex: br-header).\n- **open(): _Promise<void>_** - Abre o painel do menu.\nPode ser chamado externamente: `menuEl.open()`.\n- **close(): _Promise<void>_** - Fecha o painel do menu.\nPode ser chamado externamente: `menuEl.close()`.\n- **toggle(): _Promise<void>_** - Alterna o estado do painel do menu (abre se fechado, fecha se aberto).\nPode ser chamado externamente: `menuEl.toggle()`.\n\n### **Slots:**\n - **default** - Slot para o conteúdo principal do menu (menu-list, menu-group e menu-item).\n- **header** - Slot para o cabeçalho do menu, exibido apenas em modo não contextual e não push.\n- **logo** - Slot para logotipos de parceiros no rodapé.\n- **link** - Slot para links externos no rodapé (use br-menu-link).\n- **social** - Slot para ícones de redes sociais no rodapé.\n- **info** - Slot para informações adicionais no rodapé.\n\n### **CSS Parts:**\n - **footer** - Parte para o contêiner principal do rodapé do menu, agrupando logos, links, redes sociais e informações.\n- **logo** - Parte para a área de logotipos de parceiros no rodapé.\n- **link** - Parte para links úteis ou navegação secundária no rodapé.\n- **social** - Parte para ícones de redes sociais no rodapé.\n- **info** - Parte para informações adicionais, como licença ou direitos autorais.\n- **container** - Parte para o container externo que envolve o menu inteiro.\n- **panel** - Parte para o painel de navegação do menu (o menu propriamente dito).\n- **body** - Parte principal onde ficam os links e grupos de navegação.\n- **trigger** - Botão de acionamento do menu (hambúrguer ou contextual).\n- **back-btn** - Botão de voltar do menu de navegação drill-down.",
+      "description": "O `br-menu` organiza a navegação lateral da aplicação em gaveta retrátil ou barra fixa.\n\nUse `is-open` para controlar a visibilidade, ou chame os métodos `open()`, `close()` e `toggle()`. Estruture a navegação com os subcomponentes `br-menu-header`, `br-menu-group`, `br-menu-list` e `br-menu-item`.\n\n```html\n<br-menu id=\"menu-principal\">\n  <div slot=\"header\">\n    <br-menu-header title-text=\"Menu Principal\"></br-menu-header>\n  </div>\n  <br-menu-list>\n    <br-menu-item>\n      <br-menu-link href=\"/inicio\">Início</br-menu-link>\n    </br-menu-item>\n    <br-menu-item>\n      <br-menu-link href=\"/servicos\">Serviços</br-menu-link>\n    </br-menu-item>\n  </br-menu-list>\n</br-menu>\n```\n\n### Quando usar\n\n- Menus com hierarquia de seções, grupos ou múltiplos níveis de páginas.\n- Navegação lateral que precisa ser recolhida em telas móveis com fechamento por máscara (`br-scrim`).\n\n### Quando evitar\n\n- Poucos itens que cabem diretamente no cabeçalho: use `br-header`.\n- Alternar visões na mesma página: use `br-tab`.\n\nConsulte as [diretrizes de design do GovBR](https://www.gov.br/ds/components/menu?tab=designer).\n---\n\n\n### **Events:**\n - **brMenuStateChange** - Evento emitido quando o menu abre ou fecha.\n- **brMenuOpenChange** - Evento emitido quando o menu abre ou fecha.\n`detail.open` contém o estado concluído e `detail.sourceId` identifica a instância pelo `id` ou `customId`.\n\n### **Methods:**\n - **onDocumentClick(ev: _MouseEvent_)** - Escuta cliques no documento para alternar o estado do menu automaticamente\nquando um elemento com o atributo `data-toggle=\"menu\"` é clicado.\nUtiliza o caminho completo do evento (composedPath) para permitir o funcionamento\ncorreto quando o botão acionador está dentro de outros componentes com Shadow DOM (ex: br-header).\n- **open(): _Promise<void>_** - Abre o painel do menu.\nPode ser chamado externamente: `menuEl.open()`.\n- **close(): _Promise<void>_** - Fecha o painel do menu.\nPode ser chamado externamente: `menuEl.close()`.\n- **toggle(): _Promise<void>_** - Alterna o estado do painel do menu (abre se fechado, fecha se aberto).\nPode ser chamado externamente: `menuEl.toggle()`.\n\n### **Slots:**\n - **default** - Slot para o conteúdo principal do menu (menu-list, menu-group e menu-item).\n- **header** - Slot para o cabeçalho do menu, exibido apenas em modo não contextual e não push.\n- **logo** - Slot para logotipos de parceiros no rodapé.\n- **link** - Slot para links externos no rodapé (use br-menu-link).\n- **social** - Slot para ícones de redes sociais no rodapé.\n- **info** - Slot para informações adicionais no rodapé.\n\n### **CSS Parts:**\n - **footer** - Parte para o contêiner principal do rodapé do menu, agrupando logos, links, redes sociais e informações.\n- **logo** - Parte para a área de logotipos de parceiros no rodapé.\n- **link** - Parte para links úteis ou navegação secundária no rodapé.\n- **social** - Parte para ícones de redes sociais no rodapé.\n- **info** - Parte para informações adicionais, como licença ou direitos autorais.\n- **container** - Parte para o container externo que envolve o menu inteiro.\n- **panel** - Parte para o painel de navegação do menu (o menu propriamente dito).\n- **body** - Parte principal onde ficam os links e grupos de navegação.\n- **trigger** - Botão de acionamento do menu (hambúrguer ou contextual).\n- **back-btn** - Botão de voltar do menu de navegação drill-down.",
       "attributes": [
         {
           "name": "custom-id",
@@ -2426,7 +2431,7 @@
     },
     {
       "name": "br-menu-group",
-      "description": "O componente `br-menu-group` é o subcomponente do GovBR-DS que divide os itens de navegação em blocos ou agrupamentos temáticos com subtítulos.\n\n### Para que serve\n\n- **Segmentação visual:** Separa blocos de links afins para facilitar a leitura.\n- **Hierarquia clara:** Estabelece grupos com rótulos descritivos.\n\n### Papel na composição\n\nAtua como agrupador intermediário dentro do corpo do `br-menu`.\n\n### Regra de uso e relacionamento\n\n- Deve ser utilizado no interior do componente `br-menu`.\n- Contém instâncias de `br-menu-list` ou `br-menu-item`.\n---\n\n\n### **Slots:**\n - **default** - Itens do grupo.\n\n### **CSS Parts:**\n - **container** - Contêiner do agrupamento.\n- **label** - Rótulo visual do agrupamento.\n- **list** - Contêiner dos itens agrupados.",
+      "description": "Agrupa itens de menu sob um título ou categoria comum. Use dentro do `br-menu`.\n\nDefina o título do grupo pelo slot `label` ou pela propriedade `label`. Insira a lista de itens (`br-menu-list`) no slot padrão.\n---\n\n\n### **Slots:**\n - **default** - Itens do grupo.\n\n### **CSS Parts:**\n - **container** - Contêiner do agrupamento.\n- **label** - Rótulo visual do agrupamento.\n- **list** - Contêiner dos itens agrupados.",
       "attributes": [
         {
           "name": "label",
@@ -2443,7 +2448,7 @@
     },
     {
       "name": "br-menu-header",
-      "description": "O componente `br-menu-header` é o subcomponente do GovBR-DS que fornece o cabeçalho superior do menu lateral, contendo o título da área e o botão de fechamento.\n\n### Para que serve\n\n- **Identificação da navegação:** Exibe o título do menu ou seção atual.\n- **Controle de fechamento:** Fornece o botão de fechar acessível que recolhe o menu.\n\n### Papel na composição\n\nAtua como cabeçalho funcional e acessível no topo do `br-menu`.\n\n### Regra de uso e relacionamento\n\n- Deve ser posicionado no início do orquestrador `br-menu`.\n- Dispara a ação de fechamento gerenciada pelo componente pai.\n---\n\n\n### **Events:**\n - **brMenuToggle** - Evento emitido para alternar o estado do menu\n\n### **Slots:**\n - **logo** - Slot para logo personalizado no cabeçalho.\n- **signature** - Slot para a assinatura personalizada do sistema.\n\n### **CSS Parts:**\n - **container** - Wrapper do cabeçalho do menu.\n- **title** - Área do título com logo e assinatura.\n- **close** - Área do botão de fechar.\n- **logo** - Elemento de imagem do logotipo (se renderizado a partir de logoSrc).\n- **signature** - Elemento de texto contendo a assinatura do sistema.",
+      "description": "Cabeçalho do menu lateral com título e botão de fechar. Use no slot `header` do `br-menu`.\n\nDefina o título da área em `title-text`. O botão de fechar emite o fechamento para o `br-menu` pai.\n---\n\n\n### **Events:**\n - **brMenuToggle** - Evento emitido para alternar o estado do menu\n\n### **Slots:**\n - **logo** - Slot para logo personalizado no cabeçalho.\n- **signature** - Slot para a assinatura personalizada do sistema.\n\n### **CSS Parts:**\n - **container** - Wrapper do cabeçalho do menu.\n- **title** - Área do título com logo e assinatura.\n- **close** - Área do botão de fechar.\n- **logo** - Elemento de imagem do logotipo (se renderizado a partir de logoSrc).\n- **signature** - Elemento de texto contendo a assinatura do sistema.",
       "attributes": [
         {
           "name": "custom-id",
@@ -2470,7 +2475,7 @@
     },
     {
       "name": "br-menu-info",
-      "description": "O componente `br-menu-info` é o subcomponente do GovBR-DS destinado a exibir textos informativos, versão do sistema, status da aplicação ou informações de usuário no menu.\n\n### Para que serve\n\n- **Informações contextuais:** Apresenta dados de apoio ao usuário sem poluir o fluxo de links.\n\n### Papel na composição\n\nAtua como área informativa complementar no menu.\n\n### Regra de uso e relacionamento\n\n- Posiciona-se geralmente no rodapé ou na área superior do `br-menu`.\n---\n\n\n### **Slots:**\n - **default** - Slot para conteúdo personalizado no lugar do texto padrão de informações.",
+      "description": "Exibe informações de apoio (versão do sistema, dados do usuário ou licença) no menu. Use no slot `info` ou no rodapé do `br-menu`.\n---\n\n\n### **Slots:**\n - **default** - Slot para conteúdo personalizado no lugar do texto padrão de informações.",
       "attributes": [
         {
           "name": "custom-id",
@@ -2487,7 +2492,7 @@
     },
     {
       "name": "br-menu-item",
-      "description": "O componente `br-menu-item` é o subcomponente interativo do GovBR-DS que representa uma opção de navegação ou gatilho para submenu na árvore de menu.\n\n### Para que serve\n\n- **Opção de rota ou submenu:** Funciona como link direto para uma página ou como nó que abre um próximo nível hierárquico.\n- **Estados visuais de navegação:** Reflete estados ativo, focado, hover e selecionado.\n\n### Papel na composição\n\nAtua como item interativo central da navegação.\n\n### Regra de uso e relacionamento\n\n- Deve ser utilizado exclusivamente dentro de um `br-menu-list`.\n- Quando contiver subníveis, comunica-se com o orquestrador `br-menu` para ativar a transição entre telas.\n---\n\n\n### **Events:**\n - **brNavigate** - Evento cancelável emitido em `navigation-mode=\"event\"` para cliques primários sem modificadores em links `_self`.\nChame `event.preventDefault()` no listener para impedir a navegação nativa e entregar `event.detail.href` ao roteador da SPA.\n\n### **Slots:**\n - **default** - Conteúdo textual principal exibido no item de menu.\n- **icon** - Ícone personalizado. Quando preenchido, substitui o ícone definido por `icon`.\n\n### **CSS Parts:**\n - **link** - Elemento âncora do item de menu.\n- **icon** - Ícone do item de menu.\n- **content** - Conteúdo textual do item de menu.\n- **support** - Ícone de suporte (seta para baixo/direita).",
+      "description": "Representa uma linha de navegação ou botão de submenu dentro do `br-menu-list`.\n\nColoque um `br-menu-link` ou texto no slot padrão. Para submenus multiníveis, adicione a lista filha no interior do item.\n---\n\n\n### **Events:**\n - **brNavigate** - Evento cancelável emitido em `navigation-mode=\"event\"` para cliques primários sem modificadores em links `_self`.\nChame `event.preventDefault()` no listener para impedir a navegação nativa e entregar `event.detail.href` ao roteador da SPA.\n\n### **Slots:**\n - **default** - Conteúdo textual principal exibido no item de menu.\n- **icon** - Ícone personalizado. Quando preenchido, substitui o ícone definido por `icon`.\n\n### **CSS Parts:**\n - **link** - Elemento âncora do item de menu.\n- **icon** - Ícone do item de menu.\n- **content** - Conteúdo textual do item de menu.\n- **support** - Ícone de suporte (seta para baixo/direita).",
       "attributes": [
         {
           "name": "icon",
@@ -2534,7 +2539,7 @@
     },
     {
       "name": "br-menu-link",
-      "description": "O componente `br-menu-link` é o subcomponente do GovBR-DS que renderiza um hiperlink textual acessível dentro da estrutura de menu.\n\n### Para que serve\n\n- **Navegação direta:** Oferece link textual para destinos internos ou externos.\n- **Estilo GovBR-DS:** Aplica a tipografia e cores padronizadas de links de menu.\n\n### Papel na composição\n\nAtua como elemento folha de navegação.\n\n### Regra de uso e relacionamento\n\n- Utilizado dentro de `br-menu-item` ou seções de apoio do `br-menu`.\n---\n\n\n### **Events:**\n - **brLinkClick** - Evento emitido quando o link externo é clicado.\n- **brMenuLinkClick** - Evento canônico emitido quando o link externo é clicado.\n- **brNavigate** - Evento cancelável emitido em `navigation-mode=\"event\"` para cliques primários sem modificadores em links `_self`.\nChame `event.preventDefault()` no listener para impedir a navegação nativa e entregar `event.detail.href` ao roteador da SPA.\n\n### **Slots:**\n - **icon** - Slot para ícone personalizado do link.\n- **url** - Slot para o texto exibido no link.\n\n### **CSS Parts:**\n - **link** - Elemento âncora do link.",
+      "description": "Hiperlink de navegação dentro do `br-menu`. Use dentro de um `br-menu-item` ou no rodapé do menu.\n\nAponte o destino em `href`. Para destinos externos, use `target=\"_blank\"`.\n---\n\n\n### **Events:**\n - **brLinkClick** - Evento emitido quando o link externo é clicado.\n- **brMenuLinkClick** - Evento emitido quando o link externo é clicado.\n- **brNavigate** - Evento cancelável emitido em `navigation-mode=\"event\"` para cliques primários sem modificadores em links `_self`.\nChame `event.preventDefault()` no listener para impedir a navegação nativa e entregar `event.detail.href` ao roteador da SPA.\n\n### **Slots:**\n - **icon** - Slot para ícone personalizado do link.\n- **url** - Slot para o texto exibido no link.\n\n### **CSS Parts:**\n - **link** - Elemento âncora do link.",
       "attributes": [
         {
           "name": "custom-id",
@@ -2555,7 +2560,7 @@
         { "name": "titulo", "description": "Título do link", "values": [] },
         {
           "name": "label",
-          "description": "Texto canônico do link. Quando informado, tem precedência sobre `titulo`.",
+          "description": "Texto do link. Quando informado, tem precedência sobre `titulo`.",
           "values": []
         }
       ],
@@ -2563,7 +2568,7 @@
     },
     {
       "name": "br-menu-list",
-      "description": "O componente `br-menu-list` é o subcomponente do GovBR-DS que fornece a estrutura semântica de lista de navegação para acomodar os itens interativos do menu.\n\n### Para que serve\n\n- **Semântica de lista:** Garante marcação acessível (`<ul>`) para tecnologias assistivas.\n- **Alinhamento e ordenação:** Organiza os itens verticalmente com espaçamentos padronizados.\n\n### Papel na composição\n\nAtua como contêiner semântico de itens dentro de `br-menu` ou `br-menu-group`.\n\n### Regra de uso e relacionamento\n\n- Deve ser inserido no interior de `br-menu` ou `br-menu-group`.\n- Acomoda múltiplos subcomponentes `br-menu-item`.\n---\n\n\n### **Events:**\n - **folderToggled** - Emitido quando um folder é expandido ou recolhido no nível 0 (comportamento acordeão).\n- **navigateToSubmenu** - Emitido quando navegando para um submenu nos níveis 1+ (comportamento drill-down).\n\n### **Slots:**\n - **default** - Itens filhos renderizados no conteúdo do grupo.\n- **icon** - Ícone personalizado do item principal. Quando preenchido, substitui `icon`.\n\n### **CSS Parts:**\n - **container** - Wrapper do grupo de menu.\n- **list** - Lista de itens do grupo.\n- **header-link** - Elemento âncora do item de menu principal (header).\n- **header-icon** - Ícone do item de menu principal (header).\n- **header-content** - Conteúdo textual do item de menu principal (header).\n- **header-support** - Ícone de suporte (seta) do item de menu principal (header).",
+      "description": "Lista de itens de navegação dentro do `br-menu` ou `br-menu-group`.\n\nInsira os elementos `br-menu-item` no slot padrão para compor a lista navegável.\n---\n\n\n### **Events:**\n - **folderToggled** - Emitido quando um folder é expandido ou recolhido no nível 0 (comportamento acordeão).\n- **navigateToSubmenu** - Emitido quando navegando para um submenu nos níveis 1+ (comportamento drill-down).\n\n### **Slots:**\n - **default** - Itens filhos renderizados no conteúdo do grupo.\n- **icon** - Ícone personalizado do item principal. Quando preenchido, substitui `icon`.\n\n### **CSS Parts:**\n - **container** - Wrapper do grupo de menu.\n- **list** - Lista de itens do grupo.\n- **header-link** - Elemento âncora do item de menu principal (header).\n- **header-icon** - Ícone do item de menu principal (header).\n- **header-content** - Conteúdo textual do item de menu principal (header).\n- **header-support** - Ícone de suporte (seta) do item de menu principal (header).",
       "attributes": [
         {
           "name": "icon",
@@ -2595,7 +2600,7 @@
     },
     {
       "name": "br-menu-logo",
-      "description": "O componente `br-menu-logo` é o subcomponente do GovBR-DS que renderiza a logomarca do sistema ou do Governo Federal no menu lateral.\n\n### Para que serve\n\n- **Identidade no menu:** Reforça a marca da aplicação na navegação lateral móvel ou desktop.\n\n### Papel na composição\n\nAtua como identificador visual institucional no menu.\n\n### Regra de uso e relacionamento\n\n- Posiciona-se preferencialmente no topo ou no cabeçalho do `br-menu`.\n---\n\n\n### **Events:**\n - **brMenuLogoError** - Emitido quando a imagem principal e o fallback falham.\n- **brMenuLogoError**\n\n### **Slots:**\n - **default** - Slot para logo ou conteúdo que substitui a imagem padrão.\n\n### **CSS Parts:**\n - **container** - Wrapper da logo.",
+      "description": "Exibe o logotipo institucional no interior do `br-menu`. Use no cabeçalho ou rodapé do menu.\n---\n\n\n### **Events:**\n - **brMenuLogoError** - Emitido quando a imagem principal e o fallback falham.\n- **brMenuLogoError**\n\n### **Slots:**\n - **default** - Slot para logo ou conteúdo que substitui a imagem padrão.\n\n### **CSS Parts:**\n - **container** - Wrapper da logo.",
       "attributes": [
         {
           "name": "custom-id",
@@ -2628,7 +2633,7 @@
     },
     {
       "name": "br-menu-social",
-      "description": "O componente `br-menu-social` é o subcomponente do GovBR-DS que reúne atalhos para os canais de redes sociais institucionais no interior do menu.\n\n### Para que serve\n\n- **Acesso rápido a mídias:** Permite que o cidadão acesse perfis institucionais a partir da gaveta de navegação.\n\n### Papel na composição\n\nAtua como bloco de engajamento social no menu.\n\n### Regra de uso e relacionamento\n\n- Posiciona-se preferencialmente na base ou rodapé interno do `br-menu`.\n---\n\n\n### **Events:**\n - **brSocialClick** - Evento emitido quando o link de rede social é clicado.\n- **brMenuSocialClick** - Evento canônico emitido quando o link de rede social é clicado.\n- **brNavigate** - Evento cancelável emitido em `navigation-mode=\"event\"` para cliques primários sem modificadores em links `_self`.\nChame `event.preventDefault()` no listener para impedir a navegação nativa e entregar `event.detail.href` ao roteador da SPA.\n\n### **Slots:**\n - **icon** - Slot para ícone personalizado da rede social.",
+      "description": "Bloco de canais e redes sociais institucionais dentro do `br-menu`. Use no slot `social` ou rodapé do menu.\n---\n\n\n### **Events:**\n - **brSocialClick** - Evento emitido quando o link de rede social é clicado.\n- **brMenuSocialClick** - Evento emitido quando o link de rede social é clicado.\n- **brNavigate** - Evento cancelável emitido em `navigation-mode=\"event\"` para cliques primários sem modificadores em links `_self`.\nChame `event.preventDefault()` no listener para impedir a navegação nativa e entregar `event.detail.href` ao roteador da SPA.\n\n### **Slots:**\n - **icon** - Slot para ícone personalizado da rede social.",
       "attributes": [
         {
           "name": "custom-id",
@@ -2653,7 +2658,7 @@
         },
         {
           "name": "icon",
-          "description": "Identificador da rede social. Os ícones oficiais mais comuns são\nrenderizados pelo registro SVG local; use o slot `icon` para uma fonte\ndiferente ou uma classe Font Awesome personalizada.",
+          "description": "Nome do ícone Font Awesome 5 Free presente no cache local, sem o prefixo\n`fa-brands:` (ex.: `facebook-f`). Use o slot `icon` para conteúdo próprio.",
           "values": []
         }
       ],
@@ -2661,7 +2666,7 @@
     },
     {
       "name": "br-message",
-      "description": "O componente `br-message` é a superfície de feedback contextual e notificação em linha do GovBR-DS, utilizada para comunicar mensagens de sucesso, informação, alerta ou erro diretamente associadas à tela ou a um formulário.\n\n### Para que serve\n\n- **Comunicação de estados do sistema:** Exibe mensagens com cores, ícones e semânticas padronizadas: `success` (sucesso), `info` (informação), `warning` (aviso) e `danger` (erro).\n- **Validação de formulários:** Atua como o contêiner oficial de mensagem de erro e orientação nos slots `feedback` de componentes de formulário (como `br-input`, `br-select` e `br-checkbox`).\n- **Opção de fechamento:** Suporta botão de dispensa (`closable`), permitindo que a pessoa usuária feche a notificação após a leitura.\n\n### Quando utilizar\n\n- **Utilize quando:**\n  - For necessário dar feedback sobre uma ação recém-executada (ex.: \"Dados salvos com sucesso\").\n  - Houver orientações contextuais ou erros de validação em campos de formulário.\n- **Evite e prefira outro componente quando:**\n  - A mensagem for crítica e exigir confirmação bloqueadora antes de continuar (prefira `br-modal`).\n  - As notificações forem assíncronas do sistema e acumuladas em uma central de mensagens (prefira `br-notification`).\n\n### Estrutura e Slots\n\nO `br-message` oferece personalização modular:\n- `message-title`: Slot para título de destaque da mensagem.\n- `message-body`: Slot para o corpo detalhado do texto.\n- `icon`: Slot para substituição do ícone contextual padrão.\n- `close-button`: Slot para botão de fechar customizado.\n- `default`: Slot livre para renderização direta do conteúdo.\n\nPara a documentação completa de design, incluindo diretrizes de acessibilidade e especificações visuais, consulte o [Design System do GovBR](https://www.gov.br/ds/components/message?tab=designer).\n---\n\n\n### **Events:**\n - **brDidClose** - Evento emitido quando o usuário fecha a mensagem, se closable for true.\n- **brMessageClose** - Evento canônico emitido quando a mensagem é fechada.\n\n### **Slots:**\n - **default** - Conteúdo principal da mensagem. Quando utilizado, a prop `message` é ignorada.\n- **icon** - Ícone customizado da mensagem. Quando utilizado, o ícone padrão gerado pela prop `state` é ignorado.\n- **message-title** - Título customizado da mensagem. Quando utilizado, a prop `messageTitle` é ignorada.\n- **message-body** - Corpo customizado da mensagem. Quando utilizado, a prop `message` é ignorada.\n- **close-button** - Botão de fechar customizado. Quando utilizado, o botão padrão é substituído.\n\n### **CSS Parts:**\n - **container** - Wrapper principal da mensagem.\n- **icon** - Área do ícone da mensagem.\n- **content** - Área de conteúdo da mensagem.\n- **close** - Área do botão de fechar.",
+      "description": "O `br-message` apresenta um aviso contextual ou feedback em linha sobre uma operação ou estado do sistema.\n\nDefina o tipo de mensagem em `state` (`success`, `danger`, `warning` ou `info`). Opcionalmente, adicione um botão para fechar com `closable`.\n\n```html\n<br-message state=\"success\" message-title=\"Sucesso\">\n  Operação realizada com sucesso.\n</br-message>\n<br-message state=\"danger\" closable>\n  Não foi possível salvar os dados. Tente novamente.\n</br-message>\n```\n\n### Quando usar\n\n- Feedback sobre uma ação recém-executada na página (salvar, excluir, atualizar).\n- Mensagens de erro ou orientação em formulários (no slot `feedback` de inputs).\n\n### Quando evitar\n\n- Avisos críticos que exigem decisão antes de prosseguir: use `br-modal`.\n- Notificações acumuladas em uma central: use `br-notification`.\n\nConsulte as [diretrizes de design do GovBR](https://www.gov.br/ds/components/message?tab=designer).\n---\n\n\n### **Events:**\n - **brDidClose** - Evento emitido quando o usuário fecha a mensagem, se closable for true.\n- **brMessageClose** - Evento emitido quando a mensagem é fechada.\n\n### **Slots:**\n - **default** - Conteúdo principal da mensagem. Quando utilizado, a prop `message` é ignorada.\n- **icon** - Ícone customizado da mensagem. Quando utilizado, o ícone padrão gerado pela prop `state` é ignorado.\n- **message-title** - Título customizado da mensagem. Quando utilizado, a prop `messageTitle` é ignorada.\n- **message-body** - Corpo customizado da mensagem. Quando utilizado, a prop `message` é ignorada.\n- **close-button** - Botão de fechar customizado. Quando utilizado, o botão padrão é substituído.\n\n### **CSS Parts:**\n - **container** - Wrapper principal da mensagem.\n- **icon** - Área do ícone da mensagem.\n- **content** - Área de conteúdo da mensagem.\n- **close** - Área do botão de fechar.",
       "attributes": [
         {
           "name": "message-title",
@@ -2725,7 +2730,7 @@
         },
         {
           "name": "feedback-state",
-          "description": "Estado de feedback canônico. Quando informado, tem precedência sobre `state`.",
+          "description": "Estado de feedback. Quando informado, tem precedência sobre `state`.",
           "values": [{ "name": "BrFeedbackState" }]
         },
         {
@@ -2738,7 +2743,7 @@
     },
     {
       "name": "br-modal",
-      "description": "O componente `br-modal` é a caixa de diálogo bloqueadora (dialog modal) do GovBR-DS, desenvolvida para capturar o foco e exigir a atenção imediata da pessoa usuária antes de permitir o retorno ao fluxo de trabalho normal.\n\n### Para que serve\n\n- **Confirmação de ações críticas:** Solicita confirmação explícita para ações irreversíveis ou de grande impacto (ex.: excluir registro, cancelar processo em andamento).\n- **Entrada de dados pontual:** Permite preencher formulários breves e contextuais sem sair da tela principal.\n- **Gestão de foco e acessibilidade WAI-ARIA:** Bloqueia o foco dentro do diálogo (`focus trap`), impede a rolagem do fundo, aplica `aria-modal=\"true\"` e fecha com a tecla Escape ou clique externo.\n\n### Quando utilizar\n\n- **Utilize quando:**\n  - A decisão for estritamente obrigatória e a continuação sem ela puder causar perda de dados ou inconsistência.\n  - Apresentar detalhes suplementares que requerem fechamento explícito.\n- **Evite e prefira outro componente quando:**\n  - A mensagem for informativa e não exigir ação imediata (prefira `br-message`).\n  - O conteúdo for extenso, demandando navegação complexa (prefira uma nova página dedicada).\n\n### Estrutura e Slots\n\nO `br-modal` organiza o diálogo em regiões padronizadas:\n- `header`: Slot para cabeçalho e título (substitui a prop `title-text`).\n- `default`: Slot principal onde é inserido o corpo de texto ou formulário do modal.\n- `footer`: Slot para ações de rodapé (botões de confirmação, envio e cancelamento com `br-button`).\n- `close-button`: Slot para personalizar o botão de fechar do canto superior.\n\nPara a documentação completa de design, incluindo diretrizes de acessibilidade e especificações visuais, consulte o [Design System do GovBR](https://www.gov.br/ds/components/modal?tab=designer).\n---\n\n\n### **Events:**\n - **brModalOpen** - Evento emitido quando o modal é aberto (quando `show` muda de `false` para `true`).\n- **brModalClose** - Evento emitido após o modal ser fechado (quando `show` muda de `true` para `false`).\n- **brModalBeforeClose** - Evento emitido antes do fechamento do modal (quando o botão X é clicado).\nSe autoClose está desativado, o desenvolvedor deve fechar manualmente o modal após este evento.\nSe autoClose está ativado, o modal fecha automaticamente após este evento.\n- **brModalOpened** - Evento emitido após o modal estar completamente aberto e com o foco estabilizado\ndentro dele. Complementa `brModalOpen` (que dispara imediatamente ao abrir):\nuse `brModalOpened` quando precisar interagir com o modal já pronto.\n\n### **Methods:**\n - **open()** - Método público para abrir o modal\n- **showModal(): _Promise<void>_** - Abre o modal usando a nomenclatura de `HTMLDialogElement`.\n- **close()** - Método público para fechar o modal\n- **requestClose(): _Promise<void>_** - Solicita fechamento e permite cancelamento pelo evento `cancel`.\n- **toggle()** - Método público para alternar a visibilidade do modal\n\n### **Slots:**\n - **header** - Cabeçalho do modal. Se não for usado, o `title-text` será exibido.\n- **default** - Corpo do modal.\n- **footer** - Rodapé do modal.\n- **close-button** - Botão de fechar customizado. Se não for usado, o botão padrão será exibido.\n\n### **CSS Parts:**\n - **container** - Wrapper principal do modal.\n- **header** - Cabeçalho do modal.\n- **title** - Título do modal.\n- **body** - Corpo do modal.\n- **footer** - Rodapé do modal.\n- **close-button** - Botão de fechar do modal.",
+      "description": "O `br-modal` abre uma janela de diálogo bloqueadora sobre uma máscara, capturando a atenção imediata da pessoa usuária.\n\nControle a abertura com os métodos `open()`, `close()` e `showModal()`. Estruture o conteúdo usando os slots `header`, `default` (corpo) e `footer` (botões de ação).\n\n```html\n<br-modal title-text=\"Excluir item\">\n  <p>Deseja realmente excluir este registro? Esta ação não pode ser desfeita.</p>\n  <div slot=\"footer\">\n    <br-button emphasis=\"secondary\">Cancelar</br-button>\n    <br-button emphasis=\"primary\">Excluir</br-button>\n  </div>\n</br-modal>\n```\n\n### Quando usar\n\n- Confirmação de ações críticas ou irreversíveis (excluir registro, descartar alterações).\n- Formulários curtos e contextuais sem sair da tela atual.\n\n### Quando evitar\n\n- Mensagens informativas que não exigem confirmação: use `br-message`.\n- Conteúdos longos com navegação interna: use uma página dedicada.\n\nConsulte as [diretrizes de design do GovBR](https://www.gov.br/ds/components/modal?tab=designer).\n---\n\n\n### **Events:**\n - **brModalOpen** - Evento emitido quando o modal é aberto (quando `show` muda de `false` para `true`).\n- **brModalClose** - Evento emitido após o modal ser fechado (quando `show` muda de `true` para `false`).\n- **brModalBeforeClose** - Evento emitido antes do fechamento do modal (quando o botão X é clicado).\nSe autoClose está desativado, o desenvolvedor deve fechar manualmente o modal após este evento.\nSe autoClose está ativado, o modal fecha automaticamente após este evento.\n- **brModalOpened** - Evento emitido após o modal estar completamente aberto e com o foco estabilizado\ndentro dele. Complementa `brModalOpen` (que dispara imediatamente ao abrir):\nuse `brModalOpened` quando precisar interagir com o modal já pronto.\n\n### **Methods:**\n - **open()** - Método público para abrir o modal\n- **showModal(): _Promise<void>_** - Abre o modal usando a nomenclatura de `HTMLDialogElement`.\n- **close()** - Método público para fechar o modal\n- **requestClose(): _Promise<void>_** - Solicita fechamento e permite cancelamento pelo evento `cancel`.\n- **toggle()** - Método público para alternar a visibilidade do modal\n\n### **Slots:**\n - **header** - Cabeçalho do modal. Se não for usado, o `title-text` será exibido.\n- **default** - Corpo do modal.\n- **footer** - Rodapé do modal.\n- **close-button** - Botão de fechar customizado. Se não for usado, o botão padrão será exibido.\n\n### **CSS Parts:**\n - **container** - Wrapper principal do modal.\n- **header** - Cabeçalho do modal.\n- **title** - Título do modal.\n- **body** - Corpo do modal.\n- **footer** - Rodapé do modal.\n- **close-button** - Botão de fechar do modal.",
       "attributes": [
         {
           "name": "custom-id",
@@ -2785,7 +2790,7 @@
     },
     {
       "name": "br-notification",
-      "description": "O componente `br-notification` é o painel oficial do GovBR-DS para centralização e exibição de avisos, comunicados e notificações do sistema, tipicamente acionado a partir de um botão com ícone de sino no cabeçalho.\n\n### Para que serve\n\n- **Central de notificações do usuário:** Reúne em uma única gaveta ou painel suspenso todas as mensagens, lembretes e alertas direcionados à pessoa usuária.\n- **Estruturação por abas e contexto:** Permite organizar notificações por abas (ex.: \"Todas\", \"Não lidas\", \"Arquivadas\") com ações rápidas (marcar como lida, excluir).\n- **Gerenciamento de abertura e foco:** Controla abertura, fechamento, tecla Escape e foco acessível.\n\n### Quando utilizar\n\n- **Utilize quando:**\n  - O sistema gerar eventos e comunicados assíncronos que a pessoa usuária precise consultar a qualquer momento.\n- **Evite e prefira outro componente quando:**\n  - A mensagem for uma resposta imediata a uma ação na tela atual (prefira `br-message`).\n  - O aviso exigir confirmação bloqueadora antes de continuar (prefira `br-modal`).\n\n### Composição e Subcomponentes\n\n| Subcomponente | Papel | Regra de uso |\n| --- | --- | --- |\n| `br-notification` | **Orquestrador principal.** Gerencia a superfície flutuante, estado de visibilidade e foco. | Contêiner raiz obrigatório. |\n| `br-notification-header` | **Cabeçalho do painel.** Exibe o título, avatar do usuário, contadores e botão de fechar. | Declarado no slot `header` ou topo do `br-notification`. |\n| `br-notification-body` | **Corpo principal.** Contém a listagem das notificações e abas de filtro opcionais. | Declarado no slot padrão do `br-notification`. |\n| `br-notification-item` | **Notificação individual.** Representa cada mensagem com ícone, data, texto e ações. | Declarado dentro do `br-notification-body`. |\n\n### Como os subcomponentes se relacionam\n\nO `br-notification` projeta o painel suspenso:\n1. O cabeçalho (`br-notification-header`) contextualiza o painel e fornece o botão de dispensa.\n2. O corpo (`br-notification-body`) agrupa e organiza a coleção de itens (`br-notification-item`).\n3. Cada item (`br-notification-item`) expõe eventos de clique e ações individuais (como marcar como lida).\n\nPara a documentação completa de design, incluindo diretrizes de acessibilidade e especificações visuais, consulte o [Design System do GovBR](https://www.gov.br/ds/components/notification?tab=designer).\n---\n\n\n### **Events:**\n - **brOpenChange** - Informa a mudança de estado aberto/fechado do painel.\n- **brNotificationOpen** - Informa que o painel foi aberto.\n- **brNotificationClose** - Informa que o painel foi fechado.\n- **brNotificationItemClick** - Expõe a interação com um item da lista.\n- **brNotificationTabChange** - Informa troca de aba quando o componente possuir navegação por tabs.\n\n### **Methods:**\n - **show()** - Abre o painel de notificações.\n- **hide(reason: _NotificationCloseReason_)** - Fecha o painel de notificações.\n- **toggle()** - Alterna o estado aberto/fechado.\n- **focusTrigger()** - Move o foco de volta para o acionador.\n- **focusFirstItem()** - Move o foco para o primeiro item interativo da lista.\n\n### **Slots:**\n - **trigger** - Elemento acionador externo responsável por abrir e fechar o painel.\n- **header** - Região superior do componente, para uso com subcomponentes de cabeçalho ou conteúdo customizado.\n- **tabs** - Região opcional para navegação por abas.\n- **default** - Região principal da lista de notificações.\n- **footer** - Região opcional para ações complementares, como \"ver todas\".\n\n### **CSS Parts:**\n - **base** - Superfície principal do painel.\n- **header** - Região superior do componente.\n- **body** - Região principal do componente.\n- **tabs** - Região de abas, quando existir.\n- **list** - Região com rolagem onde os itens são exibidos.\n- **close-button** - Botão de fechar do painel.\n- **divider** - Divisor entre itens da lista.",
+      "description": "O `br-notification` organiza a central de mensagens, comunicados e avisos do usuário em um painel retrátil.\n\nUse os métodos `open()`, `close()` ou a propriedade `isOpen` para controlar o painel. Estruture o conteúdo com `br-notification-header`, `br-notification-body` e `br-notification-item`.\n\n```html\n<br-notification>\n  <div slot=\"header\">\n    <br-notification-header title-text=\"Notificações\"></br-notification-header>\n  </div>\n  <br-notification-body>\n    <br-notification-item title-text=\"Seu processo foi atualizado\" date=\"10/10/2026\"></br-notification-item>\n  </br-notification-body>\n</br-notification>\n```\n\n### Quando usar\n\n- Central de avisos acumulados da aplicação, normalmente acionada por um botão no cabeçalho.\n\n### Quando evitar\n\n- Mensagens em linha como resposta direta a uma ação na tela: use `br-message`.\n- Confirmação de ação crítica: use `br-modal`.\n\nConsulte as [diretrizes de design do GovBR](https://www.gov.br/ds/components/notification?tab=designer).\n---\n\n\n### **Events:**\n - **brOpenChange** - Informa a mudança de estado aberto/fechado do painel.\n- **brNotificationOpen** - Informa que o painel foi aberto.\n- **brNotificationClose** - Informa que o painel foi fechado.\n- **brNotificationItemClick** - Expõe a interação com um item da lista.\n- **brNotificationTabChange** - Informa troca de aba quando o componente possuir navegação por tabs.\n\n### **Methods:**\n - **show()** - Abre o painel de notificações.\n- **hide(reason: _NotificationCloseReason_)** - Fecha o painel de notificações.\n- **toggle()** - Alterna o estado aberto/fechado.\n- **focusTrigger()** - Move o foco de volta para o acionador.\n- **focusFirstItem()** - Move o foco para o primeiro item interativo da lista.\n\n### **Slots:**\n - **trigger** - Elemento acionador externo responsável por abrir e fechar o painel.\n- **header** - Região superior do componente, para uso com subcomponentes de cabeçalho ou conteúdo customizado.\n- **tabs** - Região opcional para navegação por abas.\n- **default** - Região principal da lista de notificações.\n- **footer** - Região opcional para ações complementares, como \"ver todas\".\n\n### **CSS Parts:**\n - **base** - Superfície principal do painel.\n- **header** - Região superior do componente.\n- **body** - Região principal do componente.\n- **tabs** - Região de abas, quando existir.\n- **list** - Região com rolagem onde os itens são exibidos.\n- **close-button** - Botão de fechar do painel.\n- **divider** - Divisor entre itens da lista.",
       "attributes": [
         {
           "name": "custom-id",
@@ -2852,7 +2857,7 @@
     },
     {
       "name": "br-notification-body",
-      "description": "Subcomponente de corpo da superfície `br-notification`, responsável por agrupar e organizar a lista de itens de notificação.\n\n### Papel na composição\n\n- Atua como contêiner com rolagem independente para a lista de comunicados (`br-notification-item`).\n- Suporta filtros por abas ou categorias de mensagens (ex.: \"Todas\", \"Não lidas\").\n\n### Regra de uso e relacionamento\n\nDeclarado dentro do slot padrão do `br-notification`, posicionado abaixo do cabeçalho. Ele recebe múltiplos elementos `br-notification-item` em seu interior. Não deve ser usado fora do painel de notificação.\n\nPara a documentação completa de design, consulte o [Design System do GovBR](https://www.gov.br/ds/components/notification?tab=designer).\n---\n\n\n### **Slots:**\n - **tabs** - Navegação por abas quando presente.\n- **default** - Lista principal de notificações.\n- **empty** - Conteúdo para estado vazio.",
+      "description": "Corpo do painel de notificações com rolagem independente. Use dentro do `br-notification`.\n\nInsira os itens `br-notification-item` no slot padrão.\n---\n\n\n### **Slots:**\n - **tabs** - Navegação por abas quando presente.\n- **default** - Lista principal de notificações.\n- **empty** - Conteúdo para estado vazio.",
       "attributes": [
         {
           "name": "custom-id",
@@ -2874,7 +2879,7 @@
     },
     {
       "name": "br-notification-header",
-      "description": "Subcomponente de cabeçalho da superfície `br-notification`, responsável pela identificação da área e controles de fechamento.\n\n### Papel na composição\n\n- Exibe o título da central de notificações, avatar da pessoa autenticada e botão de ação para fechar o painel.\n- Fornece contexto visual imediato ao abrir a gaveta de notificações.\n\n### Regra de uso e relacionamento\n\nDeve ser utilizado como o elemento inicial dentro do orquestrador `br-notification`. Ele é coordenado pelo painel pai para disparar o evento de fechamento quando o botão de dispensa é acionado. Não deve ser usado fora de um `br-notification`.\n\nPara a documentação completa de design, consulte o [Design System do GovBR](https://www.gov.br/ds/components/notification?tab=designer).\n---\n\n\n### **Events:**\n - **brNotificationHeaderClose** - Solicita o fechamento do painel a partir do cabeçalho.\n\n### **Slots:**\n - **avatar** - Área para avatar ou elemento visual do usuário.\n- **title** - Conteúdo customizado do título.\n- **subtitle** - Conteúdo customizado do subtítulo.\n- **actions** - Região para botão de fechar ou outras ações contextuais.",
+      "description": "Cabeçalho da central de notificações com título e botão de fechar. Use no slot `header` do `br-notification`.\n\nDefina o título em `title-text`. O botão de fechar emite o fechamento para o painel pai.\n---\n\n\n### **Events:**\n - **brNotificationHeaderClose** - Solicita o fechamento do painel a partir do cabeçalho.\n\n### **Slots:**\n - **title** - Conteúdo customizado do título.\n- **subtitle** - Conteúdo customizado do subtítulo.\n- **actions** - Região para botão de fechar ou outras ações contextuais.",
       "attributes": [
         {
           "name": "custom-id",
@@ -2906,7 +2911,7 @@
     },
     {
       "name": "br-notification-item",
-      "description": "Subcomponente individual de `br-notification`, utilizado para representar visualmente cada mensagem, aviso ou comunicado do sistema.\n\n### Papel na composição\n\n- Exibe o ícone de status (sucesso, aviso, erro, informação), título do comunicado, data/hora e texto explicativo.\n- Suporta indicação visual de lida/não lida e botões de ação específicos (ex.: \"Ver detalhes\", \"Arquivar\").\n\n### Regra de uso e relacionamento\n\nDeve ser declarado dentro do contêiner `br-notification-body` (ou no slot padrão do `br-notification`). Comunica interações da pessoa usuária (clique no item, dispensa) através de eventos emitidos para a aplicação.\n\nPara a documentação completa de design, consulte o [Design System do GovBR](https://www.gov.br/ds/components/notification?tab=designer).\n---\n\n\n### **Events:**\n - **brNotificationItemSelect** - Informa seleção ou acionamento do item.\n- **brNotificationItemRead** - Informa mudança de estado para lido.\n\n### **Methods:**\n - **callFocus()** - Move o foco para o elemento interativo do item.\n\n### **Slots:**\n - **status** - Região para tag, badge ou marcador visual de status.\n- **title** - Conteúdo customizado do título.\n- **meta** - Região para informação cronológica ou metadados.\n- **default** - Conteúdo principal da notificação.\n- **actions** - Ações contextuais do item.",
+      "description": "Item individual de notificação com título, data e status de leitura. Use dentro do `br-notification-body`.\n\nDefina o título em `title-text` e a data em `date`. Use `read` para indicar se o item já foi lido.\n---\n\n\n### **Events:**\n - **brNotificationItemSelect** - Informa seleção ou acionamento do item.\n- **brNotificationItemRead** - Informa mudança de estado para lido.\n\n### **Methods:**\n - **callFocus()** - Move o foco para o elemento interativo do item.\n\n### **Slots:**\n - **default** - Conteúdo principal da notificação.\n- **actions** - Ações contextuais do item.",
       "attributes": [
         {
           "name": "item-id",
@@ -2948,7 +2953,7 @@
     },
     {
       "name": "br-pagination",
-      "description": "O componente `br-pagination` é o controle de navegação paginada do GovBR-DS, desenvolvido para segmentar grandes volumes de dados ou conteúdos extensos em páginas sequenciais numeradas.\n\n### Para que serve\n\n- **Segmentação de dados volumosos:** Divide listas, tabelas e catálogos em blocos gerenciáveis de itens, reduzindo o tempo de carregamento da página e o consumo de memória.\n- **Navegação direta e sequencial:** Oferece botões para avançar, retroceder, ir diretamente a uma página específica e navegar através de atalhos de reticências.\n- **Variante contextual completa:** Permite alterar a quantidade de itens exibidos por página (ex.: 10, 20, 50, 100 itens) e pular diretamente para qualquer página através de campo de digitação integrado.\n\n### Quando utilizar\n\n- **Utilize quando:**\n  - O número total de itens for superior ao limite recomendado para visualização em uma única rolagem (geralmente mais de 20 a 50 registros).\n  - Integrar com tabelas de dados (`br-table`) ou grades de cartões (`br-card`).\n- **Evite e prefira outro componente quando:**\n  - O conjunto completo de itens for pequeno (menos de 20 itens) e puder ser visualizado sem perda de performance.\n  - A navegação representar etapas interdependentes de um processo sequencial com validação (prefira `br-step` ou `br-wizard`).\n\n### Estrutura e Slots\n\nO `br-pagination` disponibiliza slots para complementar a navegação:\n- `pagination-info`: Slot para customização do texto de contagem (ex.: \"Exibindo 1-20 de 240 itens\").\n- `loading`: Slot para indicador visual exibido durante a troca assíncrona de páginas.\n\nPara a documentação completa de design, incluindo diretrizes de acessibilidade e especificações visuais, consulte o [Design System do GovBR](https://www.gov.br/ds/components/pagination?tab=designer).\n---\n\n\n### **Events:**\n - **pageChange** - Solicita uma página por interação do usuário ou pelo método público.\n\nEm `controlled`, o evento informa a página solicitada, mas `current` só\nmuda quando a aplicação confirma o resultado. O componente não faz\nchamadas remotas nem cancela a consulta do consumidor.\n- **brPaginationPageChange** - Evento canônico para iniciar o carregamento de uma página.\nO `detail` contém `{ page }`; o evento não é cancelável.\n- **perPageChange** - Solicita uma quantidade de itens por página (variante contextual).\nEm `controlled`, a aplicação confirma a mudança atribuindo `perPage`.\n- **brPaginationPerPageChange** - Evento canônico para iniciar o carregamento de uma nova quantidade de\nitens. O `detail` contém `{ perPage }`; o evento não é cancelável.\n\n### **Methods:**\n - **setPage(page: _number_): _Promise<void>_** - Define programaticamente a página atual dentro do intervalo permitido.\n- **goToPage(page: _number_): _Promise<void>_** - Solicita navegação programática para uma página (1-indexada).\nEm `controlled`, aguarda a confirmação externa para alterar `current`.\n\n### **Slots:**\n - **pagination-info** - Informação customizada da paginação contextual. Quando utilizado, o texto padrão de contagem é substituído.\n- **loading** - Indicador exibido enquanto uma página é carregada.\n\n### **CSS Parts:**\n - **nav** - Parte para o contêiner raiz da paginação (elemento nav), usada para estilização via ::part().\n- **list** - Parte para a lista de páginas (elemento ul), usada para estilização via ::part().\n- **page** - Parte para os itens de página numérica (elemento a), usada para estilização via ::part().\n- **ellipsis** - Parte para o botão de reticências e seu contêiner.\n- **ellipsis-button** - Parte encaminhada do botão de reticências.\n- **per-page** - Parte para o seletor de itens por página na variante contextual.\n- **per-page-container** - Contêiner encaminhado do seletor de itens por página.\n- **per-page-input** - Campo encaminhado do seletor de itens por página.\n- **per-page-input-label** - Rótulo encaminhado do seletor de itens por página.\n- **per-page-list** - Lista encaminhada do seletor de itens por página.\n- **go-to** - Parte para o seletor de navegação direta na variante contextual.\n- **go-to-container** - Contêiner encaminhado do seletor de navegação direta.\n- **go-to-input** - Campo encaminhado do seletor de navegação direta.\n- **go-to-input-label** - Rótulo encaminhado do seletor de navegação direta.\n- **go-to-list** - Lista encaminhada do seletor de navegação direta.\n- **prev-button** - Parte para o botão de página anterior, usada para estilização via ::part().\n- **prev-button-inner** - Botão interno encaminhado da página anterior.\n- **next-button** - Parte para o botão de próxima página, usada para estilização via ::part().\n- **next-button-inner** - Botão interno encaminhado da próxima página.\n- **loading** - Área do indicador de carregamento.",
+      "description": "O `br-pagination` divide grandes volumes de dados em páginas numeradas sequenciais.\n\nInforme a quantidade total de itens em `total` e a página atual em `current`. Ouça o evento `brPaginationPageChange` para carregar a página solicitada. Para permitir alterar itens por página, use a variante contextual ou defina `per-page`.\n\n```html\n<br-pagination total=\"100\" per-page=\"10\" current=\"1\"></br-pagination>\n```\n\n### Quando usar\n\n- Paginação de tabelas (`br-table`) ou listas extensas.\n\n### Quando evitar\n\n- Poucos itens (menos de 20 itens) que cabem em uma visualização direta.\n- Etapas sequenciais de um formulário ou cadastro: use `br-step` ou `br-wizard`.\n\nConsulte as [diretrizes de design do GovBR](https://www.gov.br/ds/components/pagination?tab=designer).\n---\n\n\n### **Events:**\n - **pageChange** - Solicita uma página por interação do usuário ou pelo método público.\n\nEm `controlled`, o evento informa a página solicitada, mas `current` só\nmuda quando a aplicação confirma o resultado. O componente não faz\nchamadas remotas nem cancela a consulta do consumidor.\n- **brPaginationPageChange** - Evento para iniciar o carregamento de uma página.\nO `detail` contém `{ page }`; o evento não é cancelável.\n- **perPageChange** - Solicita uma quantidade de itens por página (variante contextual).\nEm `controlled`, a aplicação confirma a mudança atribuindo `perPage`.\n- **brPaginationPerPageChange** - Evento para iniciar o carregamento de uma nova quantidade de\nitens. O `detail` contém `{ perPage }`; o evento não é cancelável.\n\n### **Methods:**\n - **setPage(page: _number_): _Promise<void>_** - Define programaticamente a página atual dentro do intervalo permitido.\n- **goToPage(page: _number_): _Promise<void>_** - Solicita navegação programática para uma página (1-indexada).\nEm `controlled`, aguarda a confirmação externa para alterar `current`.\n\n### **Slots:**\n - **pagination-info** - Informação customizada da paginação contextual. Quando utilizado, o texto padrão de contagem é substituído.\n- **loading** - Indicador exibido enquanto uma página é carregada.\n\n### **CSS Parts:**\n - **nav** - Parte para o contêiner raiz da paginação (elemento nav), usada para estilização via ::part().\n- **list** - Parte para a lista de páginas (elemento ul), usada para estilização via ::part().\n- **page** - Parte para os itens de página numérica (elemento a), usada para estilização via ::part().\n- **ellipsis** - Parte para o botão de reticências e seu contêiner.\n- **ellipsis-button** - Parte encaminhada do botão de reticências.\n- **per-page** - Parte para o seletor de itens por página na variante contextual.\n- **per-page-container** - Contêiner encaminhado do seletor de itens por página.\n- **per-page-input** - Campo encaminhado do seletor de itens por página.\n- **per-page-input-label** - Rótulo encaminhado do seletor de itens por página.\n- **per-page-list** - Lista encaminhada do seletor de itens por página.\n- **go-to** - Parte para o seletor de navegação direta na variante contextual.\n- **go-to-container** - Contêiner encaminhado do seletor de navegação direta.\n- **go-to-input** - Campo encaminhado do seletor de navegação direta.\n- **go-to-input-label** - Rótulo encaminhado do seletor de navegação direta.\n- **go-to-list** - Lista encaminhada do seletor de navegação direta.\n- **prev-button** - Parte para o botão de página anterior, usada para estilização via ::part().\n- **prev-button-inner** - Botão interno encaminhado da página anterior.\n- **next-button** - Parte para o botão de próxima página, usada para estilização via ::part().\n- **next-button-inner** - Botão interno encaminhado da próxima página.\n- **loading** - Área do indicador de carregamento.",
       "attributes": [
         {
           "name": "color-mode",
@@ -3055,7 +3060,7 @@
     },
     {
       "name": "br-radio",
-      "description": "O componente `br-radio` é o controle de formulário do GovBR-DS para seleção de uma única opção dentro de um conjunto mutuamente exclusivo. Compatível com as diretrizes WAI-ARIA, ele integra-se nativamente a formulários HTML via `formAssociated`.\n\n### Para que serve\n\n- **Escolha exclusiva:** Permite que a pessoa usuária escolha exatamente uma alternativa entre as opções apresentadas no mesmo grupo.\n- **Integração com formulários:** Comunica valor, estado de seleção (`checked`), desativação e validação diretamente com a API nativa de formulários HTML (`ElementInternals`).\n- **Navegação acessível:** Suporta foco e seleção via teclado (teclas de seta e barra de espaço) quando agrupado.\n\n### Quando utilizar\n\n- **Utilize quando:**\n  - Houver um conjunto pequeno de opções (entre 2 e 5 alternativas) mutuamente exclusivas e for importante manter todas as opções imediatamente visíveis.\n- **Evite e prefira outro componente quando:**\n  - O número de opções for superior a 5 ou 7 itens: prefira `br-select` para economizar espaço de tela.\n  - A pessoa usuária puder selecionar múltiplas opções simultaneamente: prefira `br-checkbox` ou `br-checkbox-group`.\n  - Houver uma escolha binária simples de ativação/desativação imediata: prefira `br-switch`.\n\n### Estrutura e Slots\n\nO `br-radio` é um controle individual:\n- `default`: Slot para o texto do rótulo da opção (alternativa à propriedade `label`).\n\nPara a documentação completa de design, incluindo diretrizes de acessibilidade e especificações visuais, consulte o [Design System do GovBR](https://www.gov.br/ds/components/radio?tab=designer).\n---\n\n\n### **Events:**\n - **checkedChange** - Disparado depois que o valor do `checked` foi alterado.\n- **brRadioValidationChange** - Emitido ao iniciar e concluir a validação customizada.\n\n### **Methods:**\n - **handleCheckedChange(event: _CustomEvent<boolean>_)** - @deprecated A coordenação interna agora é limitada à raiz DOM do grupo. - Mantém o protocolo legado de sincronização por `checkedChange`.\n- **handleKeyDown(event: _KeyboardEvent_)** - Navega e seleciona o próximo/anterior rádio habilitado no grupo via teclas de seta.\nAtivado por 'keydown', move a seleção entre rádios do mesmo 'name'\nusando as setas, partindo do rádio atualmente checado.\n- **checkValidity(): _Promise<boolean>_** - Retorna `true` se o valor do radio for válido, caso contrário `false`.\nSe o radio for inválido, dispara um evento 'invalid'.\n- **reportValidity(): _Promise<boolean>_** - Retorna `true` se o valor do radio for válido, caso contrário `false`.\nSe for inválido, exibe a mensagem de erro padrão do navegador.\n- **setCustomValidity(message: _string_): _Promise<void>_** - Define uma mensagem de validação customizada para o radio.\nSe a mensagem for uma string vazia, o erro customizado é limpo.\n- **validate(): _Promise<boolean>_** - Executa o validator do radio e retorna se o valor atual é válido.\n- **getValidationState(): _Promise<FormValidationState>_** - Retorna um snapshot serializável da Constraint Validation API.\n- **toggleChecked()** - @deprecated Atualize a propriedade `checked` diretamente. - Inverte o valor da prop `checked`\n- **setFocus()** - Move o foco para o input radio nativo interno.\n\n### **Slots:**\n - **default** - Slot para o rótulo do rádio, como alternativa à propriedade label.\n- **feedback** - Mensagem de validação, normalmente um `br-message`.\n\n### **CSS Parts:**\n - **container** - Contêiner visual do radio.\n- **radio-input** - Elemento input nativo do radio.\n- **radio-label** - Rótulo do radio.\n- **feedback** - Contêiner da mensagem de validação.",
+      "description": "O `br-radio` representa uma opção individual dentro de um conjunto de escolha única.\n\nDefina `name` para associar as opções do mesmo grupo, `value` para o valor enviado no formulário e `label` para o texto exibido.\n\n```html\n<br-radio name=\"preferencia\" value=\"email\" label=\"Receber por e-mail\" checked></br-radio>\n<br-radio name=\"preferencia\" value=\"sms\" label=\"Receber por SMS\"></br-radio>\n```\n\nEm formulários HTML, integra-se nativamente via `ElementInternals` com suporte a `required`.\n\n### Quando usar\n\n- Opção única em grupos pequenos de 2 a 5 alternativas.\n\n### Quando evitar\n\n- Mais de 5 opções: use `br-select`.\n- Seleção múltipla: use `br-checkbox`.\n\nConsulte as [diretrizes de design do GovBR](https://www.gov.br/ds/components/radio?tab=designer).\n---\n\n\n### **Events:**\n - **checkedChange** - Disparado depois que o valor do `checked` foi alterado.\n- **brRadioValidationChange** - Emitido ao iniciar e concluir a validação customizada.\n\n### **Methods:**\n - **handleCheckedChange(event: _CustomEvent<boolean>_)** - @deprecated A coordenação interna agora é limitada à raiz DOM do grupo. - Mantém o protocolo legado de sincronização por `checkedChange`.\n- **handleKeyDown(event: _KeyboardEvent_)** - Navega e seleciona o próximo/anterior rádio habilitado no grupo via teclas de seta.\nAtivado por 'keydown', move a seleção entre rádios do mesmo 'name'\nusando as setas, partindo do rádio atualmente checado.\n- **checkValidity(): _Promise<boolean>_** - Retorna `true` se o valor do radio for válido, caso contrário `false`.\nSe o radio for inválido, dispara um evento 'invalid'.\n- **reportValidity(): _Promise<boolean>_** - Retorna `true` se o valor do radio for válido, caso contrário `false`.\nSe for inválido, exibe a mensagem de erro padrão do navegador.\n- **setCustomValidity(message: _string_): _Promise<void>_** - Define uma mensagem de validação customizada para o radio.\nSe a mensagem for uma string vazia, o erro customizado é limpo.\n- **validate(): _Promise<boolean>_** - Executa o validator do radio e retorna se o valor atual é válido.\n- **getValidationState(): _Promise<FormValidationState>_** - Retorna um snapshot serializável da Constraint Validation API.\n- **toggleChecked()** - @deprecated Atualize a propriedade `checked` diretamente. - Inverte o valor da prop `checked`\n- **setFocus()** - Move o foco para o input radio nativo interno.\n\n### **Slots:**\n - **default** - Slot para o rótulo do rádio, como alternativa à propriedade label.\n- **feedback** - Mensagem de validação, normalmente um `br-message`.\n\n### **CSS Parts:**\n - **container** - Contêiner visual do radio.\n- **radio-input** - Elemento input nativo do radio.\n- **radio-label** - Rótulo do radio.\n- **feedback** - Contêiner da mensagem de validação.",
       "attributes": [
         {
           "name": "checked",
@@ -3094,7 +3099,7 @@
         },
         {
           "name": "feedback-state",
-          "description": "Estado de feedback canônico. Quando informado, tem precedência sobre `state`.",
+          "description": "Estado de feedback. Quando informado, tem precedência sobre `state`.",
           "values": [{ "name": "valid" }, { "name": "invalid" }]
         },
         {
@@ -3132,7 +3137,7 @@
     },
     {
       "name": "br-radio-group",
-      "description": "O componente `br-radio-group` é o contêiner semântico e orquestrador de opções `br-radio` no GovBR-DS, responsável por garantir a exclusividade mútua de seleção, a navegação contínua por teclado e a validação integrada do grupo.\n\n### Para que serve\n\n- **Coordenação de seleção mútua:** Garante que apenas um botão de rádio permaneça selecionado por vez entre todos os rádios filhos.\n- **Navegação acessível por teclado WAI-ARIA:** Implementa o padrão de navegação com setas direcionais (cima/baixo/esquerda/direita) com foco cíclico dentro do grupo.\n- **Agrupamento semântico:** Estrutura o grupo com a semântica de `radiogroup`, fornecendo rótulo acessível para tecnologias assistivas.\n- **Associação com formulários:** Atua como controle integrado (`formAssociated`), emitindo o valor consolidado selecionado para o formulário pai.\n\n### Quando utilizar\n\n- **Utilize quando:**\n  - Apresentar um conjunto de 2 a 5 alternativas mutuamente exclusivas onde todas as opções devam ser comparadas lado a lado ou em lista vertical.\n- **Evite e prefira outro componente quando:**\n  - Houver muitas alternativas (mais de 5 a 7 opções): prefira `br-select`.\n  - A seleção permitir múltiplas alternativas independentes: prefira `br-checkbox-group`.\n\n### Estrutura e Slots\n\nO `br-radio-group` é um orquestrador de seleção:\n- `default`: Slot onde devem ser declarados os componentes filhos `br-radio`.\n- `label`: Slot para personalização do rótulo ou enunciado da pergunta do grupo.\n\nPara a documentação completa de design, incluindo diretrizes de acessibilidade e especificações visuais, consulte o [Design System do GovBR](https://www.gov.br/ds/components/radio-group?tab=designer).\n---\n\n\n### **Events:**\n - **brRadioGroupValidationChange** - Emitido ao iniciar e concluir uma validação customizada.\n\n### **Methods:**\n - **checkValidity(): _Promise<boolean>_** - Verifica a validade do grupo.\n- **reportValidity(): _Promise<boolean>_** - Verifica a validade e apresenta a mensagem do grupo.\n- **setCustomValidity(message: _string_): _Promise<void>_** - Define a mensagem de validade customizada do grupo.\n- **validate(): _Promise<boolean>_** - Executa o validator do grupo.\n- **getValidationState(): _Promise<FormValidationState>_** - Retorna o snapshot de validade do grupo.\n- **setFocus(): _Promise<void>_** - Move o foco para o radio marcado ou para o primeiro radio habilitado.\n\n### **Slots:**\n - **default** - Radios pertencentes ao grupo.\n- **label** - Legenda do grupo, como alternativa à propriedade `label`.\n- **description** - Texto auxiliar do grupo.\n- **feedback** - Mensagem de validação do grupo.\n- **validation-loading** - Indicador exibido durante validação assíncrona.\n\n### **CSS Parts:**\n - **group** - Fieldset semântico do grupo.\n- **legend** - Legenda e nome acessível do grupo.\n- **options** - Contêiner das opções.\n- **description** - Área de texto auxiliar.\n- **feedback** - Área de mensagem de validação.\n- **validation-loading** - Área do indicador de validação assíncrona.",
+      "description": "O `br-radio-group` agrupa opções de múltipla escolha onde apenas uma pode ser selecionada.\n\nAdicione os elementos `br-radio` no slot padrão. Defina o rótulo do grupo em `label` e o valor selecionado em `value`.\n\n```html\n<br-radio-group label=\"Turno de atendimento\" name=\"turno\">\n  <br-radio value=\"manha\" label=\"Manhã\"></br-radio>\n  <br-radio value=\"tarde\" label=\"Tarde\"></br-radio>\n  <br-radio value=\"noite\" label=\"Noite\"></br-radio>\n</br-radio-group>\n```\n\nEm formulários HTML, o grupo integra-se via `ElementInternals`, controlando validação nativa com `required`.\n\n### Quando usar\n\n- Entre 2 e 5 opções mutuamente exclusivas que devem permanecer visíveis.\n\n### Quando evitar\n\n- Mais de 6 opções: use `br-select` para economizar espaço de tela.\n- Seleção de múltiplas opções ao mesmo tempo: use `br-checkbox-group`.\n- Liga/desliga imediato: use `br-switch`.\n\nConsulte as [diretrizes de design do GovBR](https://www.gov.br/ds/components/radio-group?tab=designer).\n---\n\n\n### **Events:**\n - **brRadioGroupValidationChange** - Emitido ao iniciar e concluir uma validação customizada.\n\n### **Methods:**\n - **checkValidity(): _Promise<boolean>_** - Verifica a validade do grupo.\n- **reportValidity(): _Promise<boolean>_** - Verifica a validade e apresenta a mensagem do grupo.\n- **setCustomValidity(message: _string_): _Promise<void>_** - Define a mensagem de validade customizada do grupo.\n- **validate(): _Promise<boolean>_** - Executa o validator do grupo.\n- **getValidationState(): _Promise<FormValidationState>_** - Retorna o snapshot de validade do grupo.\n- **setFocus(): _Promise<void>_** - Move o foco para o radio marcado ou para o primeiro radio habilitado.\n\n### **Slots:**\n - **default** - Radios pertencentes ao grupo.\n- **label** - Legenda do grupo, como alternativa à propriedade `label`.\n- **description** - Texto auxiliar do grupo.\n- **feedback** - Mensagem de validação do grupo.\n- **validation-loading** - Indicador exibido durante validação assíncrona.\n\n### **CSS Parts:**\n - **group** - Fieldset semântico do grupo.\n- **legend** - Legenda e nome acessível do grupo.\n- **options** - Contêiner das opções.\n- **description** - Área de texto auxiliar.\n- **feedback** - Área de mensagem de validação.\n- **validation-loading** - Área do indicador de validação assíncrona.",
       "attributes": [
         {
           "name": "name",
@@ -3194,7 +3199,7 @@
     },
     {
       "name": "br-scrim",
-      "description": "O componente `br-scrim` é a camada de sobreposição visual (backdrop / máscara) do GovBR-DS, utilizada para escurecer temporariamente a interface e direcionar a atenção da pessoa usuária para um ponto de interesse ou diálogo.\n\n### Para que serve\n\n- **Destaque visual exclusivo (Spotlight):** Cria um foco exclusivo sobre determinado elemento da página (como um tour guiado ou tutorial introdutório).\n- **Bloqueio de interação com o fundo:** Impede cliques acidentais e rolagem na interface subjacente enquanto uma superfície flutuante estiver ativa.\n- **Comportamento acessível de fechamento:** Suporta fechamento ao clicar na máscara ou ao pressionar a tecla Escape, com controle de foco previsível.\n\n### Quando utilizar\n\n- **Utilize quando:**\n  - For necessário criar máscaras de fundo personalizadas para fluxos de onboarding, tutoriais ou menus temporários imersivos.\n- **Evite e prefira outro componente quando:**\n  - Estiver implementando uma caixa de diálogo padrão com cabeçalho, corpo e rodapé (prefira `br-modal`, que já inclui seu próprio scrim interno).\n\n### Estrutura e Slots\n\nO `br-scrim` atua como superfície de sobreposição:\n- `default`: Slot para inserção do elemento que receberá o destaque em primeiro plano sobre a máscara.\n\nPara a documentação completa de design, incluindo diretrizes de acessibilidade e especificações visuais, consulte o [Design System do GovBR](https://www.gov.br/ds/components/scrim?tab=designer).\n---\n\n\n### **Events:**\n - **brScrimOpen** - Indica que o scrim foi aberto.\n- **brScrimClose** - Indica que o scrim foi fechado\n\n### **Methods:**\n - **setScrollThreshold(threshold: _number_)** - Define o limite de rolagem para o fechamento automático do scrim.\n- **open()** - Método público para exibir o scrim\n- **close()** - Método público para esconder o scrim\n- **toggle()** - Método público para alternar o estado de exibição do scrim\n- **updateSpotlight()** - Recalcula manualmente a posição e dimensões da fresta do scrim vazado.\nÚtil quando o elemento alvo muda de posição sem disparar resize ou scroll.\n- **handleDocumentKeyDown(event: _KeyboardEvent_)** - Intercepta todos os eventos de teclado globalmente quando o scrim está ativo.\n\nUsa `composedPath()[0]` para obter o elemento real com foco, mesmo dentro de shadow roots.\n`event.target` é redirecionado ao cruzar shadow boundaries e não reflete o elemento concreto\nquando o foco está dentro do shadow DOM de componentes filhos como `br-modal`.\n\n### **Slots:**\n - **default** - Slot para o conteúdo principal a ser exibido sobre o fundo escurecido do scrim.\n- **activator** - Slot para o elemento ativador do scrim, com prioridade sobre a propriedade activator.",
+      "description": "O `br-scrim` cria uma máscara visual escura sobre a tela ou sobre um elemento pai para focar a atenção do usuário.\n\nUse os métodos `show()`, `hide()` ou a propriedade `active` para controlar a exibição. Coloque o conteúdo em destaque no slot padrão.\n\n```html\n<br-scrim active>\n  <div class=\"destaque\">Conteúdo em evidência</div>\n</br-scrim>\n```\n\n### Quando usar\n\n- Destaque visual pontual de um elemento (tutoriais guiados ou máscaras personalizadas).\n\n### Quando evitar\n\n- Caixas de diálogo modais padrão: use `br-modal` (que já gerencia seu próprio scrim internamente).\n\nConsulte as [diretrizes de design do GovBR](https://www.gov.br/ds/components/scrim?tab=designer).\n---\n\n\n### **Events:**\n - **brScrimOpen** - Indica que o scrim foi aberto.\n- **brScrimClose** - Indica que o scrim foi fechado\n\n### **Methods:**\n - **setScrollThreshold(threshold: _number_)** - Define o limite de rolagem para o fechamento automático do scrim.\n- **open()** - Método público para exibir o scrim\n- **close()** - Método público para esconder o scrim\n- **toggle()** - Método público para alternar o estado de exibição do scrim\n- **updateSpotlight()** - Recalcula manualmente a posição e dimensões da fresta do scrim vazado.\nÚtil quando o elemento alvo muda de posição sem disparar resize ou scroll.\n- **handleDocumentKeyDown(event: _KeyboardEvent_)** - Intercepta todos os eventos de teclado globalmente quando o scrim está ativo.\n\nUsa `composedPath()[0]` para obter o elemento real com foco, mesmo dentro de shadow roots.\n`event.target` é redirecionado ao cruzar shadow boundaries e não reflete o elemento concreto\nquando o foco está dentro do shadow DOM de componentes filhos como `br-modal`.\n\n### **Slots:**\n - **default** - Slot para o conteúdo principal a ser exibido sobre o fundo escurecido do scrim.\n- **activator** - Slot para o elemento ativador do scrim, com prioridade sobre a propriedade activator.",
       "attributes": [
         {
           "name": "custom-id",
@@ -3301,7 +3306,7 @@
     },
     {
       "name": "br-select",
-      "description": "O componente `br-select` é o controle oficial de seleção do GovBR-DS, desenvolvido para permitir que o usuário escolha uma ou múltiplas opções a partir de uma lista expansível. Compatível com o padrão WAI-ARIA Combobox, ele reúne em um único componente acessível o campo de acionamento/digitação, a lista suspensa e as opções selecionáveis, integrando-se nativamente a formulários HTML e frameworks modernos.\n\n### Para que serve\n\nO `br-select` gerencia todo o fluxo de interação de seleção:\n- **Seleção simples e múltipla:** Permite selecionar uma única opção ou múltiplas opções (`multiple`), incluindo a opção de selecionar ou desmarcar todas em lote.\n- **Busca e filtragem:** Oferece filtro local integrado (conforme o usuário digita) e suporte a busca remota assíncrona (`search-mode=\"remote\"`), disparando eventos para carregamento sob demanda via API.\n- **Agrupamento de opções:** Organiza opções contíguas por categoria, preservando virtualização, busca local e semântica nativa de formulário.\n- **Integração com formulários:** É associado a formulários nativos (`formAssociated`), comunicando seu valor, estado de validação (válido/inválido), mensagens de erro contextuais e eventos padrão (`change`, `input`).\n- **Navegação acessível:** Suporta controle total via teclado (setas para cima/baixo, Enter, Escape, Home, End), foco gerenciado e anúncios para leitores de tela.\n\n### Navegação por teclado\n\nO foco permanece no campo `combobox` enquanto a lista está aberta; a opção em destaque é comunicada por `aria-activedescendant`.\nAo receber foco, o campo abre a lista sem alterar a seleção atual.\n\n- **ArrowDown / ArrowUp:** abre a lista e destaca a próxima opção na direção pressionada; com a lista aberta, move o destaque sem mover o foco físico.\n- **Home / End:** em modo não filtrável, destaca a primeira ou a última opção habilitada; em modo filtrável, preserva o movimento do cursor no texto.\n- **Enter:** abre a lista quando fechada e confirma a opção destacada quando aberta.\n- **Espaço:** confirma a opção destacada em modo não filtrável; em modo filtrável, insere um espaço no campo de busca.\n- **Escape:** fecha a lista, remove o destaque e devolve o foco ao campo.\n- **Tab:** fecha a lista e deixa o navegador mover o foco para o próximo controle, sem alterar a seleção implicitamente.\n- **Busca incremental:** em modo não filtrável, caracteres consecutivos destacam a primeira opção habilitada correspondente; em modo filtrável, a digitação filtra a lista.\n- **Alt+ArrowDown / Alt+ArrowUp:** abre ou fecha a lista sem alterar a seleção.\n\n### Quando utilizar\n\n- **Utilize quando:**\n  - O número de opções for moderado a grande (mais de 5 a 7 itens), onde listar todas diretamente na tela consumiria muito espaço visual.\n  - For necessário filtrar opções por texto (digitação em lista longa).\n  - As opções forem carregadas dinamicamente de uma API externa (busca remota/paginada).\n  - O espaço no leiaute for restrito e exigir um controle compacto e expansível.\n- **Evite e prefira outro componente quando:**\n  - Houver poucas opções fixas (de 2 a 4 opções mutuamente exclusivas): prefira `br-radio` ou `br-radio-group` para manter as alternativas imediatamente visíveis.\n  - Houver uma escolha binária (sim/não, ativo/inativo): prefira `br-switch` ou `br-checkbox`.\n  - Houver seleção múltipla com até 4 alternativas: prefira `br-checkbox` ou um grupo de checkboxes visíveis.\n\n### Composição e Subcomponentes\n\nO ecossistema do Select é composto pelo elemento principal orquestrador e três subcomponentes especializados:\n\n| Subcomponente | Papel | Regra de uso |\n| --- | --- | --- |\n| `br-select` | **Orquestrador principal.** Gerencia o valor, ciclo de vida, acessibilidade, busca, formulário e renderização dos elementos internos. | Deve ser o único componente diretamente instanciado no template da aplicação. |\n| `br-select-input` | **Campo de acionamento.** Exibe o valor selecionado, o rótulo (`label`), o campo de busca/digitação e o botão de expandir/recolher. | Coordenado automaticamente pelo `br-select`; utilize isoladamente apenas em composições arquiteturais avançadas. |\n| `br-select-list` | **Lista suspensa virtualizada.** Contêiner flutuante que renderiza as opções de forma otimizada com suporte a rolagem e virtualização. | Gerenciada exclusivamente pelo `br-select`; não deve ser usada como controle autônomo. |\n| `br-select-option` | **Item individual de opção.** Representa um valor selecionável, exibindo texto, estado de seleção e checkbox/radio associado. | Deve ser declarado dentro do slot padrão do `br-select` para cada opção desejada. |\n\nAlém dos subcomponentes, o `br-select` oferece slots dedicados:\n- `default`: Slot principal onde são passados os elementos `br-select-option`.\n- `feedback`: Slot para exibição de mensagens de validação (ex.: `br-message`).\n- `loading`: Slot para indicador de carregamento durante busca remota.\n- `validation-loading`: Slot para indicador visual durante validação assíncrona.\n\n### Como fornecer opções\n\nO `br-select` possui uma API declarativa canônica e uma API imperativa para atualizações dinâmicas:\n\n1. **Slot com `br-select-option`:** é a forma declarativa canônica para código novo. O pai lê os atributos e o conteúdo de cada opção e os transforma em dados para a lista. Em frameworks, a coleção também pode ser renderizada como vários elementos `br-select-option`.\n2. **Método `setOptions()`:** substitui a coleção de forma imperativa e deve ser reservado para dados dinâmicos, especialmente respostas de busca remota. A lista recebe os objetos e cria internamente somente a janela visível de opções.\n\n`br-select-input` e `br-select-list` não substituem essas fontes. Eles são peças internas da composição: o primeiro controla o campo de acionamento e busca; o segundo recebe a coleção normalizada e renderiza a lista virtualizada.\n\nEvite misturar slot e dados imperativos sem necessidade. Na inicialização, opções declaradas no slot têm precedência quando existem. Depois que `options` é alterada ou `setOptions()` é chamado, a coleção imperativa passa a ser a fonte de dados e alterações posteriores no slot não são sincronizadas.\n\nA prop `options` é uma API legada e está depreciada. Ela continua funcionando apenas para preservar compatibilidade: no HTML, recebe uma string JSON; em JavaScript e frameworks, recebe um array por property binding. Não a adote em código novo; use `br-select-option` ou, para respostas dinâmicas/remotas, `setOptions()`.\n\nCada objeto deve conter `value` string e pode conter `label`, `selected`, `disabled`, `indeterminate` e `content`. `content` é renderizado como HTML na lista; não use esse campo com conteúdo não confiável.\n\n### O Conceito \"Lego\" e a Diferença entre os Componentes {#conceito-lego}\n\nO ecossistema de seleção do GovBR-DS foi projetado seguindo o **conceito de peças de Lego**: modular, flexível e combinável:\n\n1. **`br-select` (Componente Principal / Modelo Pronto):**\n   É o **componente principal**. Já vem montado com todas as peças essenciais integradas: o acionador (`br-select-input`), a lista flutuante virtualizada (`br-select-list`), a navegação por teclado e a integração nativa com formulários (`formAssociated`). Na quase totalidade das aplicações (99% dos casos), você deve usar apenas `<br-select>`.\n\n2. **`br-select-option` (Peça de Conteúdo):**\n   É a peça de Lego que você encaixa diretamente no slot padrão do `<br-select>` para definir cada valor selecionável.\n\n3. **`br-select-input` e `br-select-list` (Subcomponentes Internos):**\n   São as peças internas que formam a estrutura do `br-select`. No uso comum, **não devem ser declarados manualmente**, pois o `br-select` já os instancia e os sincroniza automaticamente.\n\n#### Quando usar apenas `<br-select>`?\nUse apenas `<br-select>` em quase todos os fluxos. Para opções fixas, declare os itens `<br-select-option>` no slot padrão; para opções dinâmicas, alimente a coleção com `setOptions()`. A prop `options` permanece disponível somente para compatibilidade legada.\n\n#### Quando montar os componentes separadamente?\nA montagem separada das peças avulsas de Lego (`br-select-input` + `br-select-list` + `br-select-option`) destina-se exclusivamente a **composições arquiteturais avançadas**, onde o leiaute exige desacoplar fisicamente o campo de acionamento da lista suspensa (ex.: campo de busca fixo na barra superior e a lista exibida dentro de um drawer ou modal lateral). Nesse caso, a aplicação precisa implementar manualmente a sincronização de foco, abertura, navegação por teclado e repasse de valor ao formulário.\n\n### Como os subcomponentes se relacionam\n\nA arquitetura do `br-select` segue o padrão de **orquestrador centralizado**:\n1. **O componente pai coordena o estado:** A aplicação declara o `<br-select>` com múltiplos `<br-select-option>` filhos ou usa `setOptions()` para dados dinâmicos. O `br-select` projeta internamente o `<br-select-input>` e a `<br-select-list>`, garantindo sincronia total de foco, estados de abertura, termos pesquisados e eventos. A prop `options` não é uma alternativa para código novo; existe somente para compatibilidade legada.\n2. **Evite montagem manual desarticulada:** Tentar declarar manualmente `br-select-input` e `br-select-list` fora do `br-select` quebra as relações de acessibilidade WAI-ARIA (combobox, controles expandidos, aria-activedescendant) e desvincula o controle da validação nativa de formulários (`ElementInternals`).\n3. **Comunicação por eventos:** Para busca remota ou resposta a seleção, a aplicação escuta os eventos disparados diretamente pelo `br-select` (`brSearch`, `change`, `input`), sem precisar interceptar nós internos da lista ou do campo de texto.\n\nPara a documentação completa de design, incluindo diretrizes de acessibilidade e especificações visuais, consulte o [Design System do GovBR](https://www.gov.br/ds/components/select?tab=designer).\n---\n\n\n### **Events:**\n - **brSelectStateChange** - Evento emitido quando o estado público do select muda.\n- **valueChange** - Evento emitido quando o valor público do select é alterado.\n- **optionHover** - Emite a opção que recebeu foco ou hover.\n- **brSelectSearch** - Emitido uma vez por edição do campo de busca, inclusive ao limpar a consulta.\nO `detail` contém `{ query }`; o evento é informativo e não cancelável.\nA aplicação deve controlar debounce, transporte e ciclo de vida da busca.\n- **opened** - Emitido quando a lista é aberta.\n- **closed** - Emitido quando a lista é fechada.\n- **brSelectValidationChange** - Informa o início e o resultado de uma validação síncrona ou assíncrona.\nO `detail` contém `validating`, `valid` e `message`.\n\n### **Methods:**\n - **handleSelectOptionPropsChange(event: _Event_)** - Recalcula a coleção quando uma opção projetada muda por atribuição direta\nde `selected`, `disabled`, `label`, `group` ou `value`. A lista virtualizada em\nShadow DOM não é uma fonte independente; ela recebe o snapshot pelo seu\ncontrato público `options`.\n- **enable(): _Promise<void>_** - Habilita o select para interação do usuário.\n- **disable(): _Promise<void>_** - Desabilita o select e impede novas interações.\n- **show(): _Promise<void>_** - Abre a lista de opções quando o componente está habilitado.\n- **close(): _Promise<void>_** - Fecha a lista de opções quando o componente está habilitado.\n- **toggleOpen(): _Promise<void>_** - Alterna entre os estados aberto e fechado do select.\n- **clear(): _Promise<void>_** - @deprecated Use `setValue('')` ou a API de formulário. - Limpa a seleção atual.\n- **getValue(): _Promise<string | string[]>_** - @deprecated Leia a propriedade `value` diretamente. - Retorna o valor público atual.\n- **setValue(value: _string | string[]_): _Promise<void>_** - @deprecated Atribua a propriedade `value` diretamente. - Define o valor público do select.\n- **setFocus(): _Promise<void>_** - @deprecated Use o foco nativo do componente quando possível. - Move o foco para o campo interno.\n- **setOptions(options: _SelectOptionData[]_): _Promise<void>_** - Substitui a coleção atual de opções por uma nova lista.\n- **setOption(option: _SelectOptionData_): _Promise<void>_** - Adiciona ou atualiza uma única opção na coleção interna.\n\n### **Slots:**\n - **default** - Opções declaradas com elementos br-select-option.\n- **feedback** - Mensagem de validação, normalmente um br-message.\n- **validation-loading** - Indicador exibido durante validação assíncrona.\n- **loading** - Indicador exibido durante a busca remota de opções.\n\n### **CSS Parts:**\n - **container** - Contêiner visual principal do select.\n- **input** - Campo de seleção e busca.\n- **input-container** - Contêiner visual do campo.\n- **input-label** - Rótulo do campo.\n- **input-field** - Campo input nativo.\n- **input-group** - Grupo visual do campo.\n- **input-icon** - Ícone do campo.\n- **input-action** - Botão de abertura e fechamento.\n- **input-action-button** - Botão interno da ação.\n- **list** - Lista de opções.\n- **option** - Opção individual.\n- **option-group** - Cabeçalho visual de um grupo de opções.\n- **select-all** - Alias legado para a opção de selecionar todos.\n- **empty-option** - Alias legado para a opção vazia da lista.\n- **option-checkbox** - Alias legado para o checkbox da opção.\n- **option-radio** - Alias legado para o radio da opção.\n- **hidden-select** - Select nativo invisível usado na integração com formulários.\n- **feedback** - Área de mensagem de validação.\n- **validation-loading** - Área do indicador de validação assíncrona.",
+      "description": "O `br-select` permite escolher uma ou mais opções em uma lista suspensa expansível com suporte a busca e virtualização.\n\nDeclare as opções com `<br-select-option>` no slot padrão, ou forneça os dados dinamicamente com o método `setOptions()`. Para seleção múltipla, use `multiple`. Para habilitar busca por digitação, use `filterable`.\n\n```html\n<br-select label=\"Estado\" placeholder=\"Selecione um estado\">\n  <br-select-option value=\"df\" label=\"Distrito Federal\"></br-select-option>\n  <br-select-option value=\"sp\" label=\"São Paulo\"></br-select-option>\n  <br-select-option value=\"rj\" label=\"Rio de Janeiro\"></br-select-option>\n</br-select>\n```\n\nEm formulários HTML, o componente integra-se nativamente via `ElementInternals`, enviando os valores selecionados no submit e validando campos obrigatórios com `required`.\n\n### Quando usar\n\n- Listas com 5 ou mais opções que ocupariam muito espaço visível se exibidas abertas.\n- Seleção que exige filtro ou busca por digitação.\n- Carregamento dinâmico ou remoto de opções a partir de uma API (`search-mode=\"remote\"`).\n\n### Quando evitar\n\n- Poucas opções fixas (2 a 4 opções): use `br-radio` ou `br-radio-group`.\n- Escolha simples de sim/não: use `br-switch` ou `br-checkbox`.\n\nConsulte as [diretrizes de design do GovBR](https://www.gov.br/ds/components/select?tab=designer).\n---\n\n\n### **Events:**\n - **brSelectStateChange** - Evento emitido quando o estado público do select muda.\n- **valueChange** - Evento emitido quando o valor público do select é alterado.\n- **optionHover** - Emite a opção que recebeu foco ou hover.\n- **brSelectSearch** - Emitido uma vez por edição do campo de busca, inclusive ao limpar a consulta.\nO `detail` contém `{ query }`; o evento é informativo e não cancelável.\nA aplicação deve controlar debounce, transporte e ciclo de vida da busca.\n- **opened** - Emitido quando a lista é aberta.\n- **closed** - Emitido quando a lista é fechada.\n- **brSelectValidationChange** - Informa o início e o resultado de uma validação síncrona ou assíncrona.\nO `detail` contém `validating`, `valid` e `message`.\n\n### **Methods:**\n - **handleSelectOptionPropsChange(event: _Event_)** - Recalcula a coleção quando uma opção projetada muda por atribuição direta\nde `selected`, `disabled`, `label`, `group` ou `value`. A lista virtualizada em\nShadow DOM não é uma fonte independente; ela recebe o snapshot pelo seu\ncontrato público `options`.\n- **enable(): _Promise<void>_** - Habilita o select para interação do usuário.\n- **disable(): _Promise<void>_** - Desabilita o select e impede novas interações.\n- **show(): _Promise<void>_** - Abre a lista de opções quando o componente está habilitado.\n- **close(): _Promise<void>_** - Fecha a lista de opções quando o componente está habilitado.\n- **toggleOpen(): _Promise<void>_** - Alterna entre os estados aberto e fechado do select.\n- **clear(): _Promise<void>_** - @deprecated Use `setValue('')` ou a API de formulário. - Limpa a seleção atual.\n- **getValue(): _Promise<string | string[]>_** - @deprecated Leia a propriedade `value` diretamente. - Retorna o valor público atual.\n- **setValue(value: _string | string[]_): _Promise<void>_** - @deprecated Atribua a propriedade `value` diretamente. - Define o valor público do select.\n- **setFocus(): _Promise<void>_** - @deprecated Use o foco nativo do componente quando possível. - Move o foco para o campo interno.\n- **setOptions(options: _SelectOptionData[]_): _Promise<void>_** - Substitui a coleção atual de opções por uma nova lista.\n- **setOption(option: _SelectOptionData_): _Promise<void>_** - Adiciona ou atualiza uma única opção na coleção interna.\n\n### **Slots:**\n - **default** - Opções declaradas com elementos br-select-option.\n- **feedback** - Mensagem de validação, normalmente um br-message.\n- **validation-loading** - Indicador exibido durante validação assíncrona.\n- **loading** - Indicador exibido na lista enquanto `loading` está ativo. Padrão: spinner com o texto \"Pesquisando…\"; aceita texto, imagem ou qualquer HTML.\n\n### **CSS Parts:**\n - **container** - Contêiner visual principal do select.\n- **input** - Campo de seleção e busca.\n- **input-container** - Contêiner visual do campo.\n- **input-label** - Rótulo do campo.\n- **input-field** - Campo input nativo.\n- **input-group** - Grupo visual do campo.\n- **input-icon** - Ícone do campo.\n- **input-action** - Botão de abertura e fechamento.\n- **input-action-button** - Botão interno da ação.\n- **input-clear** - Botão de limpar o termo digitado durante a busca.\n- **list** - Lista de opções.\n- **option** - Opção individual.\n- **option-group** - Cabeçalho visual de um grupo de opções.\n- **select-all** - Alias legado para a opção de selecionar todos.\n- **empty-option** - Alias legado para a opção vazia da lista.\n- **option-checkbox** - Alias legado para o checkbox da opção.\n- **option-radio** - Alias legado para o radio da opção.\n- **hidden-select** - Select nativo invisível usado na integração com formulários.\n- **feedback** - Área de mensagem de validação.\n- **validation-loading** - Área do indicador de validação assíncrona.",
       "attributes": [
         {
           "name": "borderless",
@@ -3415,17 +3420,22 @@
         },
         {
           "name": "search-mode",
-          "description": "Define se as opções são filtradas localmente ou fornecidas por uma busca remota.\nEm `remote`, o componente emite `brSelectSearch`; a aplicação deve buscar,\nvalidar e aplicar as opções por `setOptions()`.",
+          "description": "Define se as opções são filtradas localmente ou fornecidas por uma busca remota.\nEm `remote`, o componente emite `brSelectSearch` e exibe as opções recebidas\nsem filtrá-las de novo pelo termo digitado; a aplicação deve buscar, validar e\naplicar a resposta com `setOptions()` ou re-renderizando os `br-select-option`.\nA seleção é preservada mesmo quando não aparece na resposta seguinte.",
           "values": [{ "name": "SelectSearchMode" }]
         },
         {
           "name": "loading",
-          "description": "Indica que uma busca remota de opções está pendente.\nEnquanto ativo, novas opções não podem ser selecionadas; a aplicação\ncontinua responsável por debounce, cancelamento, erros e autenticação.",
+          "description": "Indica que uma busca remota de opções está pendente.\nEnquanto ativo, a lista exibe o slot `loading` (padrão: \"Pesquisando…\") e novas\nopções não podem ser selecionadas; a aplicação continua responsável por\ndebounce, cancelamento, erros e autenticação.",
           "values": []
         },
         {
           "name": "show-search-icon",
-          "description": "Exibe o ícone de busca no campo de entrada.",
+          "description": "Exibe a lupa mesmo quando o select não é filtrável; selects com `filterable`\njá a exibem. A lupa é omitida quando o campo é estreito demais (menos de\n128px) para comportar lupa, valor e seta.",
+          "values": []
+        },
+        {
+          "name": "hide-search-icon",
+          "description": "Oculta a lupa mesmo quando `filterable` está ativo, sem desabilitar a busca.\nTem precedência visual sobre `showSearchIcon` e não altera o comportamento padrão.",
           "values": []
         },
         {
@@ -3474,7 +3484,7 @@
     },
     {
       "name": "br-select-input",
-      "description": "Subcomponente especializado de `br-select` responsável pelo campo de acionamento, entrada de texto e controle de expansão do popup.\n\n### Papel na composição\n- Exibe o rótulo (`label`), texto de espaço reservado (`placeholder`) e o resumo dos itens atualmente selecionados.\n- Atua como campo de entrada textual para digitação de filtros e termos de busca local ou remota.\n- Contém o botão de ação para abrir ou recolher a lista de opções (`br-select-list`), controlando a rotação do ícone indicador.\n\n### Regra de uso e relacionamento\nNa quase totalidade das aplicações, este componente é instanciado e gerenciado internamente pelo orquestrador `br-select`. Ele não fornece nem renderiza a coleção de opções: recebe do pai o valor exibido, o termo de busca e os estados de abertura e desabilitação. Não deve ser declarado manualmente na página, pois depende da coordenação do pai para foco, ARIA, eventos e sincronização com formulários. Use isoladamente apenas em composições arquiteturais altamente customizadas onde a aplicação assumir explicitamente toda a orquestração de foco e estado.\n\nPara a documentação completa de design, consulte o [Design System do GovBR](https://www.gov.br/ds/components/select?tab=designer).\n---\n\n\n### **Events:**\n - **brSelectInputFocus** - Evento emitido quando o campo interno recebe foco.\n- **brSelectInputValueChange** - Evento emitido quando o valor digitado no campo de busca muda.\n- **brSelectInputActionClick** - Evento emitido quando o usuário aciona o ícone de abertura/fechamento.\n- **brSelectInputClick** - Evento emitido quando o usuário clica no campo do select.\n\n### **Methods:**\n - **flipUp(): _Promise<void>_** - Atualiza o ícone para o estado visual de lista aberta.\n- **flipDown(): _Promise<void>_** - Atualiza o ícone para o estado visual de lista fechada.\n- **setFocus(): _Promise<void>_** - Reaplica o foco no input nativo encapsulado por `br-input`.\n\n### **CSS Parts:**\n - **container** - Contêiner visual do campo.\n- **input** - Campo input nativo.\n- **label** - Rótulo do campo.\n- **group** - Grupo visual do campo.\n- **icon** - Ícone do campo.\n- **action** - Botão de ação.\n- **action-button** - Botão interno da ação.",
+      "description": "Campo de texto e acionamento interno do `br-select`.\n\nÉ gerenciado automaticamente pelo `br-select` para exibir o valor selecionado, receber termos de busca e abrir ou fechar a lista suspensa. Não é necessário utilizá-lo de forma avulsa.\n---\n\n\n### **Events:**\n - **brSelectInputFocus** - Evento emitido quando o campo interno recebe foco.\n- **brSelectInputValueChange** - Evento emitido quando o valor digitado no campo de busca muda.\n- **brSelectInputActionClick** - Evento emitido quando o usuário aciona o ícone de abertura/fechamento.\n- **brSelectInputClick** - Evento emitido quando o usuário clica no campo do select.\n\n### **Methods:**\n - **syncCombobox(state: _SelectComboboxState_): _Promise<void>_** - Sincroniza o estado acessível do campo com o select orquestrador.\n- **flipUp(): _Promise<void>_** - Atualiza o ícone para o estado visual de lista aberta.\n- **flipDown(): _Promise<void>_** - Atualiza o ícone para o estado visual de lista fechada.\n- **setFocus(): _Promise<void>_** - Reaplica o foco no input nativo encapsulado por `br-input`.\n\n### **CSS Parts:**\n - **container** - Contêiner visual do campo.\n- **input** - Campo input nativo.\n- **label** - Rótulo do campo.\n- **group** - Grupo visual do campo.\n- **icon** - Ícone do campo.\n- **action** - Botão de ação.\n- **action-button** - Botão interno da ação.\n- **clear** - Botão de limpar o texto digitado.",
       "attributes": [
         {
           "name": "borderless",
@@ -3533,7 +3543,12 @@
         },
         {
           "name": "show-search-icon",
-          "description": "Exibe a lupa mesmo quando o campo não é filtrável.\nQuando filterable é true, a lupa é exibida automaticamente.",
+          "description": "Exibe a lupa mesmo quando o campo não é filtrável.\nQuando filterable é true, a lupa é exibida automaticamente.\nEm campos com menos de 128px, a lupa é omitida para preservar valor e seta.",
+          "values": []
+        },
+        {
+          "name": "clearable",
+          "description": "Exibe o botão de limpar enquanto houver texto no campo editável.\nO `br-select` o ativa somente durante a busca, para limpar o termo digitado\nsem alterar a seleção.",
           "values": []
         },
         {
@@ -3546,7 +3561,7 @@
     },
     {
       "name": "br-select-list",
-      "description": "Subcomponente de lista virtualizada de opções, projetado para renderizar o conjunto de escolhas do `br-select`.\n\n### Papel na composição\n- Atua como o painel suspenso (popup `listbox`) que exibe os itens `br-select-option`.\n- Implementa virtualização de itens para oferecer alta performance mesmo em listas extensas com centenas ou milhares de opções.\n- Mantém o posicionamento flutuante e controla a rolagem de visualização do item ativo em navegação por teclado.\n\n### Regra de uso e relacionamento\nGerenciado exclusivamente pelo componente pai `br-select`, que injeta a coleção normalizada em `options`, controla o estado de exibição (aberto/fechado), a seleção múltipla e o índice ativo. A prop `options` desta lista é um contrato interno de composição e não substitui a API de opções do `br-select`. A lista cria internamente elementos `br-select-option` para a janela virtualizada, em vez de exibir diretamente os filhos declarados no slot do pai. Não utilize `br-select-list` como controle autônomo de formulário, pois ele não possui associação nativa com formulários (`formAssociated`) nem campo de acionamento próprio.\n\nPara a documentação completa de design, consulte o [Design System do GovBR](https://www.gov.br/ds/components/select?tab=designer).\n---\n\n\n### **Methods:**\n - **open(): _Promise<void>_** - Abre a lista e agenda a medição das opções quando necessário.\n- **close(): _Promise<void>_** - Fecha a lista de opções.\n- **setOptions(options: _SelectOptionData[]_): _Promise<void>_** - Substitui todas as opções renderizadas pela lista.\n- **setOption(option: _SelectOptionData_): _Promise<void>_** - Adiciona ou atualiza uma única opção na coleção atual.\n- **setSearchTerm(term: _string_): _Promise<void>_** - Atualiza o termo de busca e reinicia a janela virtual no topo.\n- **setMultiple(isMultiple: _boolean_): _Promise<void>_** - Alterna a lista entre modo simples e múltiplo.\n- **getOptions(): _Promise<SelectOptionData[]>_** - Retorna uma cópia das opções atualmente controladas pela lista.\n- **scrollOptionToTop(index: _number_): _Promise<boolean>_** - Posiciona uma opção no topo da viewport virtual, respeitando o limite final da lista.\n- **scrollFirstSelectedOptionToTop(): _Promise<boolean>_** - Posiciona no topo a primeira opção selecionada na ordem visual da lista.\nA opção auxiliar de selecionar tudo não participa dessa escolha.\n- **focusOption(index: _number_): _Promise<boolean>_** - Garante visibilidade e foco para uma opção específica.\n- **revealOption(index: _number_): _Promise<boolean>_** - Torna o item ativo visível sem retirar o foco do campo.\n- **setOptionSelected(index: _number_, selected: _boolean_): _Promise<boolean>_** - Aciona a seleção programática de uma opção específica.\n\n### **Slots:**\n - **loading** - Indicador exibido enquanto resultados remotos são carregados.\n\n### **CSS Parts:**\n - **list** - Contêiner visual da lista virtualizada.\n- **loading** - Área do indicador de carregamento.\n- **option-group** - Cabeçalho visual de um grupo de opções.",
+      "description": "Painel suspenso com lista virtualizada do `br-select`.\n\nÉ gerenciado internamente pelo `br-select` para exibir as opções com alta performance, mesmo em listas grandes. Não é necessário utilizá-lo de forma avulsa.\n---\n\n\n### **Methods:**\n - **open(): _Promise<void>_** - Abre a lista e agenda a medição das opções quando necessário.\n- **close(): _Promise<void>_** - Fecha a lista de opções.\n- **setOptions(options: _SelectOptionData[]_): _Promise<void>_** - Substitui todas as opções renderizadas pela lista.\n- **setOption(option: _SelectOptionData_): _Promise<void>_** - Adiciona ou atualiza uma única opção na coleção atual.\n- **setSearchTerm(term: _string_): _Promise<void>_** - Atualiza o termo de busca e reinicia a janela virtual no topo.\n- **setMultiple(isMultiple: _boolean_): _Promise<void>_** - Alterna a lista entre modo simples e múltiplo.\n- **getOptions(): _Promise<SelectOptionData[]>_** - Retorna uma cópia das opções atualmente controladas pela lista.\n- **scrollOptionToTop(index: _number_): _Promise<boolean>_** - Posiciona uma opção no topo da viewport virtual, respeitando o limite final da lista.\n- **scrollFirstSelectedOptionToTop(): _Promise<boolean>_** - Posiciona no topo a primeira opção selecionada na ordem visual da lista.\nA opção auxiliar de selecionar tudo não participa dessa escolha.\n- **focusOption(index: _number_): _Promise<boolean>_** - Garante visibilidade e foco para uma opção específica.\n- **revealOption(index: _number_): _Promise<boolean>_** - Torna o item ativo visível sem retirar o foco do campo.\n- **setOptionSelected(index: _number_, selected: _boolean_): _Promise<boolean>_** - Aciona a seleção programática de uma opção específica.\n\n### **Slots:**\n - **loading** - Indicador exibido enquanto resultados remotos são carregados. Padrão: spinner com o texto \"Pesquisando…\".\n\n### **CSS Parts:**\n - **list** - Contêiner visual da lista virtualizada.\n- **loading** - Área do indicador de carregamento.\n- **option-group** - Cabeçalho visual de um grupo de opções.",
       "attributes": [
         {
           "name": "density",
@@ -3563,6 +3578,11 @@
           "description": "Termo usado para filtrar opções por rótulo ou valor.",
           "values": []
         },
+        {
+          "name": "search-mode",
+          "description": "Define se `searchTerm` filtra as opções (`local`) ou se as opções já chegam\nfiltradas pelo servidor (`remote`). Nos dois modos, um termo sem resultados\nexibe a mensagem de lista vazia. Valores inválidos usam `local`.",
+          "values": [{ "name": "SelectSearchMode" }]
+        },
         {
           "name": "loading",
           "description": "Indica que os resultados remotos estão sendo carregados.",
@@ -3608,7 +3628,7 @@
     },
     {
       "name": "br-select-option",
-      "description": "Subcomponente que representa uma opção individual dentro de um `br-select`.\n\n### Papel na composição\n- Define o valor de submissão (`value`) e o rótulo legível exibido para o usuário.\n- Identifica opcionalmente o grupo visual e semântico ao qual a opção pertence.\n- Exibe os estados de seleção (`selected`), desativação (`disabled`) e, no modo de seleção múltipla, o checkbox correspondente.\n- Suporta marcação com destaque textual correspondente aos filtros de busca aplicados.\n\n### Regra de uso e relacionamento\nDeve ser declarado no slot padrão do `br-select` (ou projetado pela lista). É a forma declarativa canônica de fornecer opções em código novo, inclusive quando um framework repete o elemento a partir de uma coleção. O `br-select` lê seus atributos e conteúdo, transforma-os em dados e entrega uma janela virtualizada à lista; portanto, o elemento declarado no slot é a fonte declarativa, não o item visual final da lista. Evite misturá-lo com a prop legada `options` ou com `setOptions()` sem necessidade, pois a coleção imperativa passa a ter precedência depois de ser utilizada. O item comunica suas mudanças de estado ao `br-select` pai, que por sua vez atualiza o valor geral do formulário e o resumo no campo de entrada. O `br-select-option` não deve ser utilizado fora do contexto de seleção.\n\nPara a documentação completa de design, consulte o [Design System do GovBR](https://www.gov.br/ds/components/select?tab=designer).\n---\n\n\n### **Events:**\n - **brSelectOptionStateChange** - Evento emitido quando o estado da opção muda.\n- **brSelectOptionPropsChange** - Evento legado emitido quando as propriedades da opção são alteradas.\n\n### **Methods:**\n - **getItemHeight(): _Promise<number>_** - Retorna a altura efetiva da opção para cálculo de virtual scroll.\n- **setFocus(): _Promise<void>_** - Encaminha o foco para o elemento interativo interno da opção.\n- **setSelectedState(selected: _boolean_): _Promise<void>_** - Atualiza programaticamente o estado selecionado da opção.\n\n### **Slots:**\n - **default** - Conteúdo ou rótulo visual da opção.\n\n### **CSS Parts:**\n - **option** - Item visual da opção.\n- **checkbox** - Checkbox exibido no modo múltiplo.",
+      "description": "Representa uma opção dentro do `br-select`. Use no slot padrão do componente.\n\nDefina `value` para o valor de formulário e `label` para o texto exibido. Use `selected` para marcar a opção como selecionada inicialmente e `disabled` para desabilitá-la. Para agrupamento, utilize `group`.\n\n```html\n<br-select-option value=\"df\" label=\"Distrito Federal\"></br-select-option>\n```\n---\n\n\n### **Events:**\n - **brSelectOptionStateChange** - Evento emitido ao ativar a opção por clique, teclado ou `setSelectedState()`.\nFora de `br-select`, também informa alterações de `selected` e `disabled`.\nDentro de `br-select`, a sincronização dessas props não é uma nova interação.\n- **brSelectOptionPropsChange** - Evento legado emitido quando as propriedades da opção são alteradas.\n\n### **Methods:**\n - **getItemHeight(): _Promise<number>_** - Retorna a altura efetiva da opção para cálculo de virtual scroll.\n- **setFocus(): _Promise<void>_** - Encaminha o foco para o elemento interativo interno da opção.\n- **setSelectedState(selected: _boolean_): _Promise<void>_** - Atualiza programaticamente o estado selecionado da opção.\n\n### **Slots:**\n - **default** - Conteúdo ou rótulo visual da opção.\n\n### **CSS Parts:**\n - **option** - Item visual da opção.\n- **checkbox** - Checkbox exibido no modo múltiplo.",
       "attributes": [
         {
           "name": "density",
@@ -3660,7 +3680,7 @@
     },
     {
       "name": "br-sign-in",
-      "description": "O componente `br-sign-in` é o controle oficial de autenticação e identificação unificada do GovBR-DS, padronizado para representar o acesso via conta Gov.BR (\"Entrar com gov.br\").\n\n### Para que serve\n\n- **Identificação oficial do cidadão:** Ponto de entrada padrão para os serviços públicos digitais federais integrados ao provedor de identidade Gov.BR.\n- **Padronização visual obrigatória:** Aplica tipografia, cores institucionais, ícone da marca gov.br e dimensões em estrita conformidade com o Manual de Identidade Visual do Governo Federal.\n- **Estados de carregamento e desativação:** Suporta indicação de espera durante o redirecionamento de login.\n\n### Quando utilizar\n\n- **Utilize quando:**\n  - O sistema exigir login e autenticação através da plataforma gov.br.\n- **Evite e prefira outro componente quando:**\n  - O botão executar uma ação genérica do sistema que não seja login via gov.br (prefira `br-button`).\n  - O usuário já estiver autenticado e a intenção for apenas exibir o perfil (prefira `br-avatar`).\n\n### Estrutura e Slots\n\nO `br-sign-in` é um botão de autenticação estilizado com a marca oficial do Governo Federal, recebendo propriedades de rótulo e variantes institucionais.\n\nPara a documentação completa de design, incluindo diretrizes de acessibilidade e especificações visuais, consulte o [Design System do GovBR](https://www.gov.br/ds/components/signin?tab=designer).\n---\n\n\n### **Events:**\n - **brNavigate** - Evento cancelável emitido em `navigation-mode=\"event\"` para cliques primários sem modificadores em links `_self`.\nChame `event.preventDefault()` no listener para impedir a navegação nativa e entregar `event.detail.href` ao roteador da SPA.\n\n### **Slots:**\n - **default** - Slot para o texto do sign-in.\n- **icon** - Slot para ícone personalizado; em `shape=\"circle\"`, o padrão é um SVG local de usuário.\n- **image** - Slot para imagem ou ícone ao lado do texto.\n\n### **CSS Parts:**\n - **content** - Parte para a área de conteúdo/texto do sign-in, usada para estilização via ::part().\n- **image** - Parte para a área da imagem/ícone, usada para controle de tamanho via CSS e ::part().",
+      "description": "O `br-sign-in` padroniza o botão oficial de autenticação da conta gov.br.\n\nPode ser exibido no formato padrão (bloco com texto) ou no formato circular compacto com `shape=\"circle\"`. Use a propriedade `density` para ajustar a densidade visual.\n\n```html\n<br-sign-in label=\"Entrar com gov.br\"></br-sign-in>\n<br-sign-in shape=\"circle\" aria-label=\"Entrar com gov.br\"></br-sign-in>\n```\n\n### Quando usar\n\n- Ponto de acesso ou login único com a conta Gov.br em serviços públicos federais.\n\n### Quando evitar\n\n- Ações gerais de formulário (salvar, enviar, cancelar): use `br-button`.\n\nConsulte as [diretrizes de design do GovBR](https://www.gov.br/ds/components/signin?tab=designer).\n---\n\n\n### **Events:**\n - **brNavigate** - Evento cancelável emitido em `navigation-mode=\"event\"` para cliques primários sem modificadores em links `_self`.\nChame `event.preventDefault()` no listener para impedir a navegação nativa e entregar `event.detail.href` ao roteador da SPA.\n\n### **Slots:**\n - **default** - Slot para o texto do sign-in.\n- **icon** - Slot para ícone personalizado; em `shape=\"circle\"`, o padrão é um SVG local de usuário.\n- **image** - Slot para imagem ou ícone ao lado do texto.\n\n### **CSS Parts:**\n - **content** - Parte para a área de conteúdo/texto do sign-in, usada para estilização via ::part().\n- **image** - Parte para a área da imagem/ícone, usada para controle de tamanho via CSS e ::part().",
       "attributes": [
         {
           "name": "custom-id",
@@ -3717,7 +3737,7 @@
     },
     {
       "name": "br-skip-link",
-      "description": "O componente `br-skip-link` é o bloco essencial de acessibilidade posicionado no topo da página, permitindo que pessoas que utilizam teclado ou tecnologias assistivas saltem blocos repetitivos e acessem diretamente áreas principais da aplicação.\n\n### Para que serve\n\n- **Atalho de teclado imediato:** Fornece links diretos (\"Ir para o conteúdo principal\", \"Ir para o menu\", \"Ir para a busca\", \"Ir para o rodapé\") logo no primeiro acionamento da tecla Tab.\n- **Conformidade WCAG obrigatória:** Atende ao critério de sucesso 2.4.1 (Bypass Blocks) da WCAG 2.1, essencial para portais e serviços públicos.\n- **Comportamento visual discreto:** Permanece oculto visualmente por padrão, tornando-se visível imediatamente assim que recebe o foco do teclado.\n\n### Quando utilizar\n\n- **Utilize quando:**\n  - Obrigatoriamente em todas as páginas e aplicações do GovBR-DS, posicionado como o primeiro elemento interativo do corpo do documento.\n- **Evite e prefira outro componente quando:**\n  - O link tiver a intenção de navegação comum no corpo do texto (use `br-link`).\n\n### Composição e Subcomponentes\n\n| Subcomponente | Papel | Regra de uso |\n| --- | --- | --- |\n| `br-skip-link` | **Orquestrador de atalhos.** Agrupa a lista de links rápidos e gerencia visibilidade no foco. | Deve ser o primeiro elemento interativo no topo da página. |\n| `br-skip-link-item` | **Item individual de atalho.** Especifica o destino e o texto do salto. | Declarado no slot padrão do `br-skip-link`. |\n\n### Como os subcomponentes se relacionam\n\nO `br-skip-link` atua como contêiner que abriga múltiplos elementos `br-skip-link-item`. Cada item referencia o `id` do elemento de destino na página (ex.: `#main-content`), conduzindo o foco imediatamente para a região desejada.\n\nPara a documentação completa de design, incluindo diretrizes de acessibilidade e especificações visuais, consulte o [Design System do GovBR](https://www.gov.br/ds/components/skip-link?tab=designer).\n---\n\n\n### **Events:**\n - **brSkiplinkNavigation** - Evento emitido quando um item do skiplink é ativado.\nO evento contém informações sobre o item acionado e o elemento target.\n- **brSkipLinkNavigate** - Evento canônico emitido quando um destino é ativado.\n- **brDidShow** - Evento emitido quando o skiplink se torna visível.\n- **brSkipLinkShow** - Evento canônico emitido ao exibir o componente.\n- **brDidHide** - Evento emitido quando o skiplink se torna oculto.\n- **brSkipLinkHide** - Evento canônico emitido ao ocultar o componente.\n\n### **Methods:**\n - **watchModeChanges()** - Observa mudanças nos estados que afetam o modo efetivo (simple/compound)\ne atualiza as contagens dos itens quando necessário.\n- **handleItemNavigation(event: _CustomEvent<{ itemId: string; target: string }>_)** - Listener para eventos de navegação dos itens filhos.\n- **handleFocusIn(event: _FocusEvent_)** - Listener para evento de foco no componente.\n- **handleFocusOut(event: _FocusEvent_)** - Listener para evento de perda de foco no componente.\n- **handleKeyDown(event: _KeyboardEvent_)** - Listener para a tecla Escape.\n- **hide(): _Promise<void>_** - Oculta o componente programaticamente.\n- **show(): _Promise<void>_** - Exibe o componente programaticamente.\n\n### **Slots:**\n - **default** - Slot para inserir os itens de navegação rápida (br-skip-link-item). A tag br-skiplink-item é aceita por compatibilidade.\n\n### **CSS Parts:**\n - **container** - Parte para o contêiner principal do componente skip-link, usada para estilização via ::part().",
+      "description": "O `br-skip-link` fornece atalhos acessíveis de teclado no topo da página para saltar blocos repetitivos de conteúdo.\n\nPosicione no início da página. Declare os atalhos usando elementos `br-skip-link-item` no slot padrão, apontando cada destino em `target`.\n\n```html\n<br-skip-link>\n  <br-skip-link-item target=\"#conteudo-principal\">Ir para o conteúdo</br-skip-link-item>\n  <br-skip-link-item target=\"#menu-navegacao\">Ir para o menu</br-skip-link-item>\n</br-skip-link>\n```\n\nO componente permanece oculto e se torna visível automaticamente assim que recebe o foco do teclado (Tab).\n\n### Quando usar\n\n- No topo de todas as páginas para cumprir as diretrizes de acessibilidade (WCAG 2.4.1).\n\n### Quando evitar\n\n- Links de navegação comuns no corpo do texto: use `br-link`.\n\nConsulte as [diretrizes de design do GovBR](https://www.gov.br/ds/components/skip-link?tab=designer).\n---\n\n\n### **Events:**\n - **brSkiplinkNavigation** - Evento emitido quando um item do skiplink é ativado.\nO evento contém informações sobre o item acionado e o elemento target.\n- **brSkipLinkNavigate** - Evento emitido quando um destino é ativado.\n- **brDidShow** - Evento emitido quando o skiplink se torna visível.\n- **brSkipLinkShow** - Evento emitido ao exibir o componente.\n- **brDidHide** - Evento emitido quando o skiplink se torna oculto.\n- **brSkipLinkHide** - Evento emitido ao ocultar o componente.\n\n### **Methods:**\n - **watchModeChanges()** - Observa mudanças nos estados que afetam o modo efetivo (simple/compound)\ne atualiza as contagens dos itens quando necessário.\n- **handleItemNavigation(event: _CustomEvent<{ itemId: string; target: string }>_)** - Listener para eventos de navegação dos itens filhos.\n- **handleFocusIn(event: _FocusEvent_)** - Listener para evento de foco no componente.\n- **handleFocusOut(event: _FocusEvent_)** - Listener para evento de perda de foco no componente.\n- **handleKeyDown(event: _KeyboardEvent_)** - Listener para a tecla Escape.\n- **hide(): _Promise<void>_** - Oculta o componente programaticamente.\n- **show(): _Promise<void>_** - Exibe o componente programaticamente.\n\n### **Slots:**\n - **default** - Slot para inserir os itens de navegação rápida (br-skip-link-item). A tag br-skiplink-item é aceita por compatibilidade.\n\n### **CSS Parts:**\n - **container** - Parte para o contêiner principal do componente skip-link, usada para estilização via ::part().",
       "attributes": [
         {
           "name": "custom-id",
@@ -3754,7 +3774,7 @@
     },
     {
       "name": "br-skip-link-item",
-      "description": "Nome canônico de `br-skip-link-item`, usado como cada atalho dentro de `br-skip-link`.\nInforme em `target` o `id` ou seletor existente para onde o foco deve ser levado.\nUse um item por região importante da página. A tag `br-skiplink-item` é legada e não deve ser combinada com esta para o mesmo destino.\n---\n\n\n### **Methods:**\n - **itemFocus(): _Promise<void>_** - Encaminha o foco para o item legado sem expor seu Shadow DOM ao pai.\n- **navigateToTarget(): _Promise<void>_** - Encaminha a navegação para o item legado sem expor seu Shadow DOM ao pai.\n\n### **Slots:**\n - **default** - Texto do link de navegação rápida.\n- **tag** - Conteúdo da indicação do atalho.",
+      "description": "Representa um atalho de salto dentro do `br-skip-link`.\n\nAponte em `target` o seletor ou `id` do elemento de destino (ex.: `#conteudo`). Coloque o texto no slot padrão.\n\n```html\n<br-skip-link-item target=\"#conteudo\">Ir para o conteúdo principal</br-skip-link-item>\n```\n---\n\n\n### **Methods:**\n - **itemFocus(): _Promise<void>_** - Encaminha o foco para o item legado sem expor seu Shadow DOM ao pai.\n- **navigateToTarget(): _Promise<void>_** - Encaminha a navegação para o item legado sem expor seu Shadow DOM ao pai.\n\n### **Slots:**\n - **default** - Texto do link de navegação rápida.\n- **tag** - Conteúdo da indicação do atalho.",
       "attributes": [
         {
           "name": "target",
@@ -3781,7 +3801,7 @@
     },
     {
       "name": "br-skiplink-item",
-      "description": "@deprecated Use `br-skip-link-item`.\n\nSubcomponente individual de `br-skip-link`, utilizado para declarar cada atalho específico de salto de bloco acessível.\n\n### Papel na composição\n\n- Define o texto descritivo do atalho (ex.: \"Ir para o conteúdo\") e o identificador do alvo na página (`targetId` ou `href`).\n- Transfere o foco programático e visual diretamente para o elemento alvo ao ser acionado com Enter ou espaço.\n\n### Regra de uso e relacionamento\n\nDeve ser declarado no slot padrão do orquestrador `br-skip-link`. Cada item deve apontar para um elemento existente na página dotado de `id` e foco acessível (`tabindex=\"-1\"`). Não deve ser usado fora do contexto do skip-link.\n\nPara a documentação completa de design, consulte o [Design System do GovBR](https://www.gov.br/ds/components/skip-link?tab=designer).\n---\n\n\n### **Events:**\n - **brSkiplinkItemClick** - Evento emitido quando o item é clicado/ativado.\nO evento contém informações sobre o item e o target.\n- **brSkipLinkItemActivate** - Evento canônico emitido quando o item é ativado.\n- **brSkiplinkItemFocus** - Evento emitido quando o item recebe foco.\n- **brSkipLinkItemFocus** - Evento canônico emitido quando o item recebe foco.\n\n### **Methods:**\n - **handleClick(_event: _MouseEvent_)** - Listener para cliques no item.\n- **handleKeyDown(event: _KeyboardEvent_)** - Listener para teclas Enter, Space e atalho Alt+[keyNumber].\n- **handleFocus()** - Listener para foco no item.\n- **itemFocus(): _Promise<void>_** - Move o foco para este item.\n- **navigateToTarget(): _Promise<void>_** - Navega para o target definido.\nMove o foco para o elemento alvo e ajusta a rolagem da página se necessário.\n\n### **Slots:**\n - **default** - Slot para o texto do link de navegação rápida.\n- **tag** - Slot para personalizar a tag numérica do atalho de teclado, exibindo o valor de key-number por padrão.",
+      "description": "@deprecated Use `br-skip-link-item`.\n\nItem legado de atalho do `br-skip-link`. Em código novo, utilize `br-skip-link-item`.\n\nDefina o destino em `target` e o texto do link no slot padrão.\n---\n\n\n### **Events:**\n - **brSkiplinkItemClick** - Evento emitido quando o item é clicado/ativado.\nO evento contém informações sobre o item e o target.\n- **brSkipLinkItemActivate** - Evento emitido quando o item é ativado.\n- **brSkiplinkItemFocus** - Evento emitido quando o item recebe foco.\n- **brSkipLinkItemFocus** - Evento emitido quando o item recebe foco.\n\n### **Methods:**\n - **handleClick(_event: _MouseEvent_)** - Listener para cliques no item.\n- **handleKeyDown(event: _KeyboardEvent_)** - Listener para teclas Enter, Space e atalho Alt+[keyNumber].\n- **handleFocus()** - Listener para foco no item.\n- **itemFocus(): _Promise<void>_** - Move o foco para este item.\n- **navigateToTarget(): _Promise<void>_** - Navega para o target definido.\nMove o foco para o elemento alvo e ajusta a rolagem da página se necessário.\n\n### **Slots:**\n - **default** - Slot para o texto do link de navegação rápida.\n- **tag** - Slot para personalizar a tag numérica do atalho de teclado, exibindo o valor de key-number por padrão.",
       "attributes": [
         {
           "name": "target",
@@ -3808,7 +3828,7 @@
     },
     {
       "name": "br-slider",
-      "description": "O componente `br-slider` é o controle deslizante do GovBR-DS, desenvolvido para permitir que a pessoa usuária selecione um valor numérico único ou uma faixa contínua de valores dentro de um intervalo delimitado.\n\n### Para que serve\n\n- **Seleção numérica fluida:** Permite escolher valores deslizando uma alça (thumb) ao longo de uma trilha graduada, com atualização em tempo real.\n- **Modo simples e composto (faixa / range):** Suporta uma única alça para valor individual ou duas alças para delimitação de intervalo mínimo e máximo (ex.: faixa de preços, período de anos).\n- **Entrada numérica sincronizada:** Oferece campo de entrada numérico integrado opcional para digitação exata com sincronização bidirecional.\n- **Acessibilidade WAI-ARIA:** Suporta controle total por teclado (setas direcionais, Page Up, Page Down, Home e End) e comunica valores atuais via `aria-valuenow`.\n\n### Quando utilizar\n\n- **Utilize quando:**\n  - O usuário precisar definir grandezas graduais onde a exploração intuitiva seja mais conveniente do que a digitação manual isolada.\n  - Para filtros de faixa de valores (ex.: \"De R$ 100 até R$ 500\").\n- **Evite e prefira outro componente quando:**\n  - A precisão exata for estritamente necessária e o intervalo for arbitrário (prefira `br-input` numérico).\n  - O valor for uma escolha categórica sem escala quantitativa (prefira `br-select` ou `br-radio`).\n\n### Estrutura e Slots\n\nO `br-slider` possui estrutura rica com slots de referência, validação e customização da alça:\n- `ref-start`: Slot para customização do rótulo de início da trilha.\n- `ref-end`: Slot para customização do rótulo de fim da trilha.\n- `feedback`: Slot para mensagens de validação (como `br-message`).\n- `thumb-icon`: Slot para ícone personalizado na alça de controle em modo simples.\n- `thumb-start-icon`: Slot para ícone na alça inicial em modo composto (`range`).\n- `thumb-end-icon`: Slot para ícone na alça final em modo composto (`range`).\n\nPara a documentação completa de design, incluindo diretrizes de acessibilidade e especificações visuais, consulte o [Design System do GovBR](https://www.gov.br/ds/components/slider?tab=designer).\n---\n\n\n### **Events:**\n - **brDidChangeValue** - Disparado após alteração do valor da alça inicial.\n- **brDidChangeValueEnd** - Disparado após alteração do valor da alça final (modo composto).\n- **brSliderValidationChange** - Emitido ao iniciar e concluir a validação customizada.\n\n### **Methods:**\n - **checkValidity(): _Promise<boolean>_** - Retorna se o slider atende às constraints configuradas.\n- **reportValidity(): _Promise<boolean>_** - Valida e solicita ao navegador a apresentação do erro atual.\n- **setCustomValidity(message: _string_): _Promise<void>_** - Define ou limpa uma mensagem de validade customizada.\n- **validate(): _Promise<boolean>_** - Executa o validator do slider e retorna se o valor atual é válido.\n- **getValidationState(): _Promise<FormValidationState>_** - Retorna um snapshot serializável da Constraint Validation API.\n\n### **Slots:**\n - **ref-start** - Conteúdo exibido como referência inicial abaixo da trilha.\n- **ref-end** - Conteúdo exibido como referência final abaixo da trilha.\n- **feedback** - Mensagem de validação, normalmente um `br-message`.\n- **thumb-icon** - Ícone customizado na alça de controle em modo simples.\n- **thumb-start-icon** - Ícone customizado na alça inicial em modo composto.\n- **thumb-end-icon** - Ícone customizado na alça final em modo composto.\n\n### **CSS Parts:**\n - **base** - Contêiner principal do slider.\n- **layout** - Contêiner de layout do slider.\n- **body** - Área que agrupa trilha e referências.\n- **track** - Área interativa da trilha.\n- **track-visual** - Trilha visual do slider.\n- **tick-labels** - Contêiner das etiquetas das marcações.\n- **tick-label** - Etiqueta de uma marcação intermediária.\n- **filled-track** - Trecho preenchido da trilha.\n- **value-label** - Etiqueta com o valor da alça.\n- **value-label-arrow** - Seta da etiqueta de valor.\n- **thumb** - Alça de controle do slider.\n- **thumb-start** - Alça inicial do slider.\n- **thumb-end** - Alça final do slider em modo composto.\n- **references** - Contêiner das referências inicial e final.\n- **reference-start** - Referência inicial.\n- **reference-end** - Referência final.\n- **reference-bound** - Valor fixo de limite renderizado por `show-bounds`.\n- **input-wrapper** - Contêiner do campo numérico.\n- **input** - Campo numérico sincronizado com o slider.\n- **feedback** - Contêiner da mensagem de validação.\n- **steps** - Contêiner das marcações de passos customizados.\n- **step** - Botão indicador de passo customizado individual.",
+      "description": "O `br-slider` seleciona um valor ou uma faixa de valores numéricos em uma trilha graduada.\n\nUse `min`, `max`, `step` e `value` para definir os limites e o valor. Para selecionar um intervalo (faixa com duas alças), use `range` e `range-value`.\n\n```html\n<br-slider min=\"0\" max=\"100\" value=\"50\" label=\"Volume\"></br-slider>\n<br-slider min=\"0\" max=\"1000\" range range-value=\"[200, 800]\" label=\"Faixa de preço\"></br-slider>\n```\n\n### Quando usar\n\n- Ajuste gradual de quantidades contínuas (volume, brilho, zoom).\n- Filtros de intervalos numéricos ou de preços.\n\n### Quando evitar\n\n- Entrada numérica exata arbitrária: use `br-input` com `type=\"number\"`.\n- Poucas escolhas fixas discretas: use `br-radio` ou `br-select`.\n\nConsulte as [diretrizes de design do GovBR](https://www.gov.br/ds/components/slider?tab=designer).\n---\n\n\n### **Events:**\n - **brDidChangeValue** - Disparado após alteração do valor da alça inicial.\n- **brDidChangeValueEnd** - Disparado após alteração do valor da alça final (modo composto).\n- **brSliderValidationChange** - Emitido ao iniciar e concluir a validação customizada.\n\n### **Methods:**\n - **checkValidity(): _Promise<boolean>_** - Retorna se o slider atende às constraints configuradas.\n- **reportValidity(): _Promise<boolean>_** - Valida e solicita ao navegador a apresentação do erro atual.\n- **setCustomValidity(message: _string_): _Promise<void>_** - Define ou limpa uma mensagem de validade customizada.\n- **validate(): _Promise<boolean>_** - Executa o validator do slider e retorna se o valor atual é válido.\n- **getValidationState(): _Promise<FormValidationState>_** - Retorna um snapshot serializável da Constraint Validation API.\n\n### **Slots:**\n - **ref-start** - Conteúdo exibido como referência inicial abaixo da trilha.\n- **ref-end** - Conteúdo exibido como referência final abaixo da trilha.\n- **feedback** - Mensagem de validação, normalmente um `br-message`.\n- **thumb-icon** - Ícone customizado na alça de controle em modo simples.\n- **thumb-start-icon** - Ícone customizado na alça inicial em modo composto.\n- **thumb-end-icon** - Ícone customizado na alça final em modo composto.\n\n### **CSS Parts:**\n - **base** - Contêiner principal do slider.\n- **layout** - Contêiner de layout do slider.\n- **body** - Área que agrupa trilha e referências.\n- **track** - Área interativa da trilha.\n- **track-visual** - Trilha visual do slider.\n- **tick-labels** - Contêiner das etiquetas das marcações.\n- **tick-label** - Etiqueta de uma marcação intermediária.\n- **filled-track** - Trecho preenchido da trilha.\n- **value-label** - Etiqueta com o valor da alça.\n- **value-label-arrow** - Seta da etiqueta de valor.\n- **thumb** - Alça de controle do slider.\n- **thumb-start** - Alça inicial do slider.\n- **thumb-end** - Alça final do slider em modo composto.\n- **references** - Contêiner das referências inicial e final.\n- **reference-start** - Referência inicial.\n- **reference-end** - Referência final.\n- **reference-bound** - Valor fixo de limite renderizado por `show-bounds`.\n- **input-wrapper** - Contêiner do campo numérico.\n- **input** - Campo numérico sincronizado com o slider.\n- **feedback** - Contêiner da mensagem de validação.\n- **steps** - Contêiner das marcações de passos customizados.\n- **step** - Botão indicador de passo customizado individual.",
       "attributes": [
         {
           "name": "custom-id",
@@ -3872,7 +3892,7 @@
         },
         {
           "name": "orientation",
-          "description": "Orientação canônica. Quando informada, tem precedência sobre `vertical`; valores inválidos usam `horizontal`.",
+          "description": "Orientação padrão. Quando informada, tem precedência sobre `vertical`; valores inválidos usam `horizontal`.",
           "values": [{ "name": "horizontal" }, { "name": "vertical" }]
         },
         {
@@ -3912,7 +3932,7 @@
         },
         {
           "name": "thumb-icon",
-          "description": "Nome do ícone a ser exibido no interior da alça de controle (thumb).\nNo modo `range`, aplica-se a ambas as alças caso `thumbStartIcon` ou `thumbEndIcon` não sejam especificados.\nExemplo: 'fa-solid:arrows-left-right', 'fa-solid:circle'.",
+          "description": "Nome do ícone a ser exibido no interior da alça de controle (thumb).\nNo modo `range`, aplica-se a ambas as alças caso `thumbStartIcon` ou `thumbEndIcon` não sejam especificados.\nExemplo: 'fa-solid:arrows-alt-h', 'fa-solid:circle'.",
           "values": []
         },
         {
@@ -3940,7 +3960,7 @@
     },
     {
       "name": "br-step",
-      "description": "O componente `br-step` é o indicador visual de etapas e progresso do GovBR-DS, desenvolvido para orientar a pessoa usuária ao longo de fluxos sequenciais e processos com múltiplos passos.\n\n### Para que serve\n\n- **Visualização de progresso:** Informa claramente em qual etapa do processo o usuário se encontra, quais já foram concluídas e quais ainda estão pendentes.\n- **Orientação flexível:** Suporta leiaute horizontal (ideal para telas amplas) e vertical (ideal para fluxos em barra lateral ou dispositivos móveis).\n- **Semântica e acessibilidade WAI-ARIA:** Comunica o passo ativo através de `aria-current=\"step\"` e indica etapas concluídas ou bloqueadas.\n\n### Quando utilizar\n\n- **Utilize quando:**\n  - O fluxo tiver entre 2 e 5 etapas lógicas com uma sequência recomendada de execução (ex.: Identificação > Dados > Pagamento > Confirmação).\n- **Evite e prefira outro componente quando:**\n  - A pessoa usuária puder alternar livremente entre as seções em qualquer ordem sem dependência de progresso (prefira `br-tab`).\n  - For necessário um contêiner completo que gerencie também os painéis de formulário e botões de avançar/voltar (prefira `br-wizard`).\n\n### Composição e Subcomponentes\n\n| Subcomponente | Papel | Regra de uso |\n| --- | --- | --- |\n| `br-step` | **Orquestrador de progresso.** Gerencia a orientação, conecta as linhas de fluxo e calcula os estados das etapas. | Contêiner raiz da barra de progresso. |\n| `br-step-item` | **Etapa individual.** Representa cada passo com número, rótulo e estado. | Declarado dentro do slot padrão do `br-step`. |\n\n### Como os subcomponentes se relacionam\n\nO componente pai `br-step` recebe múltiplos elementos `br-step-item` em seu slot padrão:\n1. Com base na propriedade `current` ou nos índices declarados, o pai calcula as linhas conectoras visuais entre as etapas.\n2. Sincroniza os estados de cada etapa: concluída (`completed`), ativa (`active`) ou desabilitada (`disabled`).\n\nPara a documentação completa de design, incluindo diretrizes de acessibilidade e especificações visuais, consulte o [Design System do GovBR](https://www.gov.br/ds/components/step?tab=designer).\n---\n\n\n### **Events:**\n - **brStepChange** - Emite um evento quando o step ativo muda.\nO evento carrega o índice do novo step ativo (0-based).\n\n### **Methods:**\n - **activeStepChanged(newValue: _number_, oldValue: _number_)** - Observa mudanças na etapa ativa e sincroniza os itens filhos.\n- **initialStepChanged(newValue: _string | number_, oldValue: _string | number_)** - Observa mudanças no passo inicial e atualiza a etapa ativa.\n- **labelPositionChanged()** - Observa mudanças na posição do label e propaga aos itens.\n- **contentTypeChanged()** - Observa mudanças no tipo de conteúdo e propaga aos itens.\n- **modeChanged(_newValue: _StepMode_)** - Observa mudanças no modo e propaga aos itens.\n- **layoutChanged()** - Observa mudanças no layout e atualiza a linha do tempo dos itens.\n- **progressionTypeChanged()** - Observa mudanças no tipo de progressão e atualiza itens desabilitados.\n- **verticalContentPlacementChanged()** - Observa mudanças na posição do conteúdo vertical e propaga aos itens.\n- **handleClick(event: _MouseEvent_)** - listener para ouvir o evento de click no componente step\nAtravés desse listener o componente define qual será o proximo passo do step que terá o estado ativo\n- **ProceedToNextStep()** - @deprecated Use `next`. - \nMétodo disponibilizado via API do elemento que controla o componente Step, responsável por avançar para o próximo passo e atualizar o valor do estado activeStep\n- **next(): _Promise<void>_** - Avança para o próximo passo.\n- **BackToPreviousStep()** - @deprecated Use `previous`. - \nMétodo disponibilizado via API do elemento que controla o componente Step, responsável por retornar ao passo anterior e atualizar o valor do estado activeStep\n- **previous(): _Promise<void>_** - Retorna ao passo anterior.\n- **StepValidation(validationStatus: _StepValidationStatus_)** - @deprecated Use `setCurrentValidation`. - \nMétodo disponibilizado via API do elemento que integra um componente externo ao componente Step, permitindo sinalizar validações ou destacar a etapa com estado ativo.\n- **setCurrentValidation(validationStatus: _StepValidationStatus_): _Promise<void>_** - Define o estado de validação do passo ativo.\n- **GetActiveStep()** - \nMétodo disponibilizado via API do elemento que permite a um componente externo obter a etapa com o estado ativo do componente Step.\n\n### **Slots:**\n - **default** - Slot para os itens do step (br-step-item), aceitando apenas esse componente.\n\n### **CSS Parts:**\n - **container** - Parte para o contêiner principal envolvendo todos os step-items, usada para estilizar layout geral via ::part().",
+      "description": "O `br-step` exibe o progresso visual de um fluxo dividido em etapas consecutivas.\n\nDeclare cada etapa com `br-step-item` no slot padrão. Controle a etapa ativa pela propriedade `current`. Suporta orientação horizontal e vertical via `direction`.\n\n```html\n<br-step current=\"2\">\n  <br-step-item step-number=\"1\" label=\"Identificação\"></br-step-item>\n  <br-step-item step-number=\"2\" label=\"Dados Pessoais\"></br-step-item>\n  <br-step-item step-number=\"3\" label=\"Confirmação\"></br-step-item>\n</br-step>\n```\n\n### Quando usar\n\n- Processos lineares com 3 ou mais etapas bem delimitadas.\n\n### Quando evitar\n\n- Formulários de múltiplas páginas onde o próprio componente gerencia as telas: use `br-wizard`.\n- Navegação plana entre abas da mesma tela: use `br-tab`.\n\nConsulte as [diretrizes de design do GovBR](https://www.gov.br/ds/components/step?tab=designer).\n---\n\n\n### **Events:**\n - **brStepChange** - Emite um evento quando o step ativo muda.\nO evento carrega o índice do novo step ativo (0-based).\n\n### **Methods:**\n - **activeStepChanged(newValue: _number_, oldValue: _number_)** - Observa mudanças na etapa ativa e sincroniza os itens filhos.\n- **initialStepChanged(newValue: _string | number_, oldValue: _string | number_)** - Observa mudanças no passo inicial e atualiza a etapa ativa.\n- **labelPositionChanged()** - Observa mudanças na posição do label e propaga aos itens.\n- **contentTypeChanged()** - Observa mudanças no tipo de conteúdo e propaga aos itens.\n- **modeChanged(_newValue: _StepMode_)** - Observa mudanças no modo e propaga aos itens.\n- **layoutChanged()** - Observa mudanças no layout e atualiza a linha do tempo dos itens.\n- **progressionTypeChanged()** - Observa mudanças no tipo de progressão e atualiza itens desabilitados.\n- **verticalContentPlacementChanged()** - Observa mudanças na posição do conteúdo vertical e propaga aos itens.\n- **handleClick(event: _MouseEvent_)** - listener para ouvir o evento de click no componente step\nAtravés desse listener o componente define qual será o proximo passo do step que terá o estado ativo\n- **ProceedToNextStep()** - @deprecated Use `next`. - \nMétodo disponibilizado via API do elemento que controla o componente Step, responsável por avançar para o próximo passo e atualizar o valor do estado activeStep\n- **next(): _Promise<void>_** - Avança para o próximo passo.\n- **BackToPreviousStep()** - @deprecated Use `previous`. - \nMétodo disponibilizado via API do elemento que controla o componente Step, responsável por retornar ao passo anterior e atualizar o valor do estado activeStep\n- **previous(): _Promise<void>_** - Retorna ao passo anterior.\n- **StepValidation(validationStatus: _StepValidationStatus_)** - @deprecated Use `setCurrentValidation`. - \nMétodo disponibilizado via API do elemento que integra um componente externo ao componente Step, permitindo sinalizar validações ou destacar a etapa com estado ativo.\n- **setCurrentValidation(validationStatus: _StepValidationStatus_): _Promise<void>_** - Define o estado de validação do passo ativo.\n- **GetActiveStep()** - \nMétodo disponibilizado via API do elemento que permite a um componente externo obter a etapa com o estado ativo do componente Step.\n\n### **Slots:**\n - **default** - Slot para os itens do step (br-step-item), aceitando apenas esse componente.\n\n### **CSS Parts:**\n - **container** - Parte para o contêiner principal envolvendo todos os step-items, usada para estilizar layout geral via ::part().",
       "attributes": [
         {
           "name": "layout",
@@ -3992,7 +4012,7 @@
     },
     {
       "name": "br-step-item",
-      "description": "Subcomponente individual de `br-step`, responsável por representar visualmente e semanticamente uma etapa específica do fluxo.\n\n### Papel na composição\n\n- Exibe o indicador numérico ou ícone da etapa, o rótulo descritivo e o estado de conclusão.\n- Permite navegação interativa opcional caso etapas anteriores possam ser revisitadas diretamente com clique.\n\n### Regra de uso e relacionamento\n\nDeve ser declarado no slot padrão do orquestrador `br-step`. O componente pai calcula a orientação (horizontal ou vertical), as linhas de conexão intermediárias e aplica os atributos de acessibilidade da etapa atual. Não deve ser usado fora de um `br-step`.\n\nPara a documentação completa de design, consulte o [Design System do GovBR](https://www.gov.br/ds/components/step?tab=designer).\n---\n\n\n### **Methods:**\n - **setStepItemPositionStatus(value: _StepItemPositionStatus_)** - \nMétodo disponibilizado via api do elemento que indica a posição do step item, ele serve para setar o state stepItemPositionStatus do componente\n- **handleShowTimeLine(value: _boolean_, layout: _StepItemLayout_)** - Método que define a orientação do stepItem e controla a exibição da linha do tempo após o componente.\n- **setLabelPosition(value: _StepItemLabelPosition_)** - \nMétodo disponibilizado via api do elemento que atribui o valor ao estado que define onde o label, o texto de destaque, irá ficar localizado\n- **setContentType(value: _StepItemContentType_)** - \nMétodo disponibilizado via api do elemento que atribui o valor que irá definir o tipo de conteúdo apresentado dentro do componente stepItem\n- **setMode(value: _StepItemMode_)** - \nMétodo disponibilizado via api do elemento que atribui o valor que irá definir o modo como o componente irá se comportar e exibir seu estilo.\n- **setItemRole(value: _StepItemRole_)** - Define o role ARIA do botão interno.\nChamado pelo componente pai quando o contexto semântico exige um role\ndiferente do padrão `option` (ex.: `tab` em contexto de tablist).\n- **setContent(value: _string_)** - \nMétodo disponibilizado via api do elemento que atribui o valor que irá ser exibido dentro do componente stepItem\n- **setVerticalContentPlacement(value: _StepItemVerticalContentPlacement_)** - Método que define a posição do conteúdo no layout vertical.\n\n### **Slots:**\n - **content-area** - Slot para conteúdo customizado dentro do botão do item do step.\n- **step-content** - Slot para conteúdo da etapa exibido no layout vertical (texto, formulário, etc.).\n\n### **CSS Parts:**\n - **label** - Parte para o contêiner do texto da etapa, usada para estilizar tipografia e cor via ::part().",
+      "description": "Representa uma etapa individual dentro do `br-step`.\n\nDefina o número da etapa em `step-number` e o texto em `label`. Use `status` (`done`, `active`, `pending`) para indicar o estado da etapa.\n---\n\n\n### **Methods:**\n - **setStepItemPositionStatus(value: _StepItemPositionStatus_)** - \nMétodo disponibilizado via api do elemento que indica a posição do step item, ele serve para setar o state stepItemPositionStatus do componente\n- **handleShowTimeLine(value: _boolean_, layout: _StepItemLayout_)** - Método que define a orientação do stepItem e controla a exibição da linha do tempo após o componente.\n- **setLabelPosition(value: _StepItemLabelPosition_)** - \nMétodo disponibilizado via api do elemento que atribui o valor ao estado que define onde o label, o texto de destaque, irá ficar localizado\n- **setContentType(value: _StepItemContentType_)** - \nMétodo disponibilizado via api do elemento que atribui o valor que irá definir o tipo de conteúdo apresentado dentro do componente stepItem\n- **setMode(value: _StepItemMode_)** - \nMétodo disponibilizado via api do elemento que atribui o valor que irá definir o modo como o componente irá se comportar e exibir seu estilo.\n- **setItemRole(value: _StepItemRole_)** - Define o role ARIA do botão interno.\nChamado pelo componente pai quando o contexto semântico exige um role\ndiferente do padrão `option` (ex.: `tab` em contexto de tablist).\n- **setContent(value: _string_)** - \nMétodo disponibilizado via api do elemento que atribui o valor que irá ser exibido dentro do componente stepItem\n- **setVerticalContentPlacement(value: _StepItemVerticalContentPlacement_)** - Método que define a posição do conteúdo no layout vertical.\n\n### **Slots:**\n - **content-area** - Slot para conteúdo customizado dentro do botão do item do step.\n- **step-content** - Slot para conteúdo da etapa exibido no layout vertical (texto, formulário, etc.).\n\n### **CSS Parts:**\n - **label** - Parte para o contêiner do texto da etapa, usada para estilizar tipografia e cor via ::part().",
       "attributes": [
         {
           "name": "label",
@@ -4039,7 +4059,7 @@
     },
     {
       "name": "br-switch",
-      "description": "O componente `br-switch` é o interruptor de alternância do GovBR-DS, desenvolvido para ativar ou desativar instantaneamente um recurso, modo ou configuração na interface.\n\n### Para que serve\n\n- **Alternância binária imediata:** Alterna entre dois estados mutuamente exclusivos (ligado/desligado, ativo/inativo, habilitado/desabilitado) com efeito imediato na aplicação.\n- **Rótulo contextual dinâmico:** Suporta textos explicativos de estado (ex.: \"Ativado\" / \"Desativado\") e ícones de apoio.\n- **Acessibilidade nativa WAI-ARIA:** Utiliza internamente o papel semântico `role=\"switch\"` com o atributo `aria-checked`, garantindo anúncio claro de estado para leitores de tela.\n\n### Quando utilizar\n\n- **Utilize quando:**\n  - A alteração de estado entrar em vigor imediatamente após a interação, sem depender de um botão \"Salvar\" ou submissão de formulário.\n  - Para preferências do sistema (ex.: \"Tema escuro\", \"Notificações ativas\", \"Wi-Fi ligado\").\n- **Evite e prefira outro componente quando:**\n  - A escolha fizer parte de um formulário com múltiplos campos que serão submetidos juntos (prefira `br-checkbox`).\n  - A escolha for entre duas opções com nomes explícitos diferentes de ligado/desligado (prefira `br-radio`).\n\n### Estrutura e Slots\n\nO `br-switch` é um controle direto:\n- `default`: Slot para personalização do rótulo descritivo do switch (com prioridade sobre a propriedade `label`).\n- `feedback`: Slot para mensagens de validação contextual (como `br-message`).\n\nPara a documentação completa de design, incluindo diretrizes de acessibilidade e especificações visuais, consulte o [Design System do GovBR](https://www.gov.br/ds/components/switch?tab=designer).\n---\n\n\n### **Events:**\n - **checkedChange** - Disparado depois que o valor do `checked` foi alterado.\n- **brSwitchValidationChange** - Emitido ao iniciar e concluir a validação customizada.\n\n### **Methods:**\n - **checkValidity(): _Promise<boolean>_** - Retorna `true` se o valor do switch for válido, caso contrário `false`.\nSe o switch for inválido, dispara um evento 'invalid'.\n- **reportValidity(): _Promise<boolean>_** - Retorna `true` se o valor do componente for válido, caso contrário `false`.\nSe for inválido, exibe a mensagem de erro padrão do navegador.\n- **setCustomValidity(message: _string_): _Promise<void>_** - Define uma mensagem de validação customizada para o switch.\nSe a mensagem for uma string vazia, o erro customizado é limpo.\n- **validate(): _Promise<boolean>_** - Executa o validator do switch e retorna se o valor atual é válido.\n- **getValidationState(): _Promise<FormValidationState>_** - Retorna um snapshot serializável da Constraint Validation API.\n- **toggleChecked()** - @deprecated Atualize a propriedade `checked` diretamente. - Inverte o valor da prop `checked`\n\n### **Slots:**\n - **default** - Slot para o rótulo do switch, com prioridade sobre a propriedade label.\n- **feedback** - Mensagem de validação, normalmente um `br-message`.\n\n### **CSS Parts:**\n - **container** - Contêiner visual do switch.\n- **input** - Elemento input nativo com role switch.\n- **label** - Rótulo do switch.\n- **data** - Elemento com textos de estado ligado/desligado.\n- **feedback** - Contêiner da mensagem de validação.",
+      "description": "O `br-switch` alterna instantaneamente entre os estados ligado e desligado.\n\nDefina o estado em `checked`. Opcionalmente configure os rótulos de estado em `label-on` e `label-off`.\n\n```html\n<br-switch label=\"Receber notificações por e-mail\" checked></br-switch>\n<br-switch label=\"Modo escuro\" label-on=\"Ligado\" label-off=\"Desligado\"></br-switch>\n```\n\nEm formulários HTML, o componente integra-se via `ElementInternals`, participando do submit nativo.\n\n### Quando usar\n\n- Ativar ou desativar uma funcionalidade com efeito imediato na tela ou configuração.\n\n### Quando evitar\n\n- Confirmação de termos em formulários (ex.: \"Li e concordo\"): use `br-checkbox`.\n- Escolha entre alternativas mutuamente exclusivas: use `br-radio`.\n\nConsulte as [diretrizes de design do GovBR](https://www.gov.br/ds/components/switch?tab=designer).\n---\n\n\n### **Events:**\n - **checkedChange** - Disparado depois que o valor do `checked` foi alterado.\n- **brSwitchValidationChange** - Emitido ao iniciar e concluir a validação customizada.\n\n### **Methods:**\n - **checkValidity(): _Promise<boolean>_** - Retorna `true` se o valor do switch for válido, caso contrário `false`.\nSe o switch for inválido, dispara um evento 'invalid'.\n- **reportValidity(): _Promise<boolean>_** - Retorna `true` se o valor do componente for válido, caso contrário `false`.\nSe for inválido, exibe a mensagem de erro padrão do navegador.\n- **setCustomValidity(message: _string_): _Promise<void>_** - Define uma mensagem de validação customizada para o switch.\nSe a mensagem for uma string vazia, o erro customizado é limpo.\n- **validate(): _Promise<boolean>_** - Executa o validator do switch e retorna se o valor atual é válido.\n- **getValidationState(): _Promise<FormValidationState>_** - Retorna um snapshot serializável da Constraint Validation API.\n- **toggleChecked()** - @deprecated Atualize a propriedade `checked` diretamente. - Inverte o valor da prop `checked`\n\n### **Slots:**\n - **default** - Slot para o rótulo do switch, com prioridade sobre a propriedade label.\n- **feedback** - Mensagem de validação, normalmente um `br-message`.\n\n### **CSS Parts:**\n - **container** - Contêiner visual do switch.\n- **input** - Elemento input nativo com role switch.\n- **label** - Rótulo do switch.\n- **data** - Elemento com textos de estado ligado/desligado.\n- **feedback** - Contêiner da mensagem de validação.",
       "attributes": [
         {
           "name": "disabled",
@@ -4120,7 +4140,7 @@
     },
     {
       "name": "br-tab",
-      "description": "O componente `br-tab` é o organizador de navegação por abas do GovBR-DS, desenvolvido para permitir que a pessoa usuária alterne entre diferentes visões ou painéis de conteúdo correlacionados sem sair da mesma página.\n\n### Para que serve\n\n- **Segmentação de conteúdo em mesmo nível:** Agrupa informações que compartilham o mesmo contexto geral (ex.: \"Visão Geral\", \"Especificações\", \"Histórico\", \"Anexos\").\n- **Economia de espaço vertical:** Evita rolagens excessivas na página mantendo apenas o painel selecionado visível no momento.\n- **Navegação acessível WAI-ARIA Tablist:** Implementa o padrão oficial de abas acessíveis: papéis semânticos `tablist`, `tab` e `tabpanel`, com controle total por setas do teclado e foco cíclico.\n\n### Quando utilizar\n\n- **Utilize quando:**\n  - Houver conjuntos equivalentes de informação entre os quais a pessoa usuária pode navegar livremente e em qualquer ordem.\n- **Evite e prefira outro componente quando:**\n  - O conteúdo for sequencial com dependência de avanço ou conclusão de etapas anteriores (prefira `br-step` ou `br-wizard`).\n  - As abas tiverem a função de navegar para rotas e URLs distintas da aplicação (prefira uma barra de links com `br-link` ou `br-header`).\n\n### Composição e Subcomponentes\n\n| Subcomponente | Papel | Regra de uso |\n| --- | --- | --- |\n| `br-tab` | **Orquestrador de abas.** Constrói a barra de navegação acessível (`tablist`), controla a aba ativa e gerencia o teclado. | Contêiner raiz obrigatório declarado no template. |\n| `br-tab-item` | **Aba e painel associado.** Define simultaneamente o rótulo do botão da aba e o conteúdo do painel correspondente. | Declarado no slot padrão do `br-tab`. |\n\n### Como os subcomponentes se relacionam\n\nO `br-tab` adota uma arquitetura declarativa prática:\n1. A aplicação declara os elementos `br-tab-item` dentro do slot padrão do `br-tab`.\n2. O componente pai extrai os rótulos e ícones de cada item para renderizar a barra superior de abas (`role=\"tab\"`).\n3. O pai controla a visibilidade dos painéis (`role=\"tabpanel\"`), exibindo exclusivamente o conteúdo da aba selecionada e garantindo a correlação de IDs acessíveis (`aria-controls`, `aria-labelledby`).\n\nPara a documentação completa de design, incluindo diretrizes de acessibilidade e especificações visuais, consulte o [Design System do GovBR](https://www.gov.br/ds/components/tab?tab=designer).\n---\n\n\n### **Events:**\n - **brTabChange** - Evento disparado quando um tab é ativado.\n\n### **Methods:**\n - **activeTabChanged(newId: _string_)** - Observa mudanças no tab ativo para atualizar os estados\n- **colorModeChanged(_newValue: _string_)** - Observa mudanças no color mode para propagar aos filhos\n- **handleTabItemPropsChange()** - Escuta evento de mudança de propriedades dos tab-items filhos.\nEste listener garante que o componente pai seja re-renderizado quando\npropriedades mudam dinamicamente, sincronizando o painel ativo.\n- **setActiveTab(tabId: _string_): _Promise<void>_** - Ativa programaticamente uma aba a partir do seu identificador.\n- **getActiveTab(): _Promise<string | undefined>_** - Retorna o identificador da aba ativa atual.\n- **render(): __** - Renderiza o componente.\n\n### **Slots:**\n - **default** - Slot para inserir os itens das abas (br-tab-item)\n- **icon-{id}** - Ícone da aba cujo `br-tab-item` tem o `id` informado (ex.: `<i slot=\"icon-avisos\" class=\"fas fa-bell\" aria-hidden=\"true\"></i>`). Forma preferida para ícones por classe CSS, como Font Awesome: o elemento fica em light DOM e recebe os estilos globais da página. Tem precedência sobre a prop `icon` do item.\n\n### **CSS Parts:**\n - **container** - Contêiner principal que envolve toda a estrutura do componente (navegação e conteúdo). Expõe o elemento para customizações de fundo, bordas e espaçamentos globais.\n- **nav** - Área de navegação (`tablist`) onde os botões das abas estão localizados. Permite customizar o alinhamento, espaçamento e plano de fundo da barra de abas.\n- **button** - Botão individual de cada aba.\n- **indicator** - Indicador visual da aba ativa.\n- **content** - Área de conteúdo das abas.",
+      "description": "O `br-tab` organiza diferentes visões ou painéis de conteúdo na mesma página através de abas navegáveis.\n\nDeclare os itens usando `br-tab-item` no slot padrão. O componente gera automaticamente os botões da barra de navegação e controla a exibição do painel correspondente.\n\n```html\n<br-tab>\n  <br-tab-item label=\"Dados Cadastrais\">\n    <p>Conteúdo da primeira aba.</p>\n  </br-tab-item>\n  <br-tab-item label=\"Documentos\">\n    <p>Conteúdo da segunda aba.</p>\n  </br-tab-item>\n</br-tab>\n```\n\n### Quando usar\n\n- Alternar entre conjuntos equivalentes de informação sem sair da página e sem ordem fixa de leitura.\n\n### Quando evitar\n\n- Processos com etapas sequenciais que dependem de preenchimento prévio: use `br-wizard` ou `br-step`.\n- Links para páginas ou rotas distintas: use `br-link` ou `br-header`.\n\nConsulte as [diretrizes de design do GovBR](https://www.gov.br/ds/components/tab?tab=designer).\n---\n\n\n### **Events:**\n - **brTabChange** - Evento disparado quando um tab é ativado.\n\n### **Methods:**\n - **activeTabChanged(newId: _string_)** - Observa mudanças no tab ativo para atualizar os estados\n- **colorModeChanged(_newValue: _string_)** - Observa mudanças no color mode para propagar aos filhos\n- **handleTabItemPropsChange()** - Escuta evento de mudança de propriedades dos tab-items filhos.\nEste listener garante que o componente pai seja re-renderizado quando\npropriedades mudam dinamicamente, sincronizando o painel ativo.\n- **setActiveTab(tabId: _string_): _Promise<void>_** - Ativa programaticamente uma aba a partir do seu identificador.\n- **getActiveTab(): _Promise<string | undefined>_** - Retorna o identificador da aba ativa atual.\n- **render(): __** - Renderiza o componente.\n\n### **Slots:**\n - **default** - Slot para inserir os itens das abas (br-tab-item)\n- **icon-{id}** - Ícone da aba cujo `br-tab-item` tem o `id` informado (ex.: `<i slot=\"icon-avisos\" class=\"fas fa-bell\" aria-hidden=\"true\"></i>`). Forma preferida para ícones por classe CSS, como Font Awesome: o elemento fica em light DOM e recebe os estilos globais da página. Tem precedência sobre a prop `icon` do item.\n\n### **CSS Parts:**\n - **container** - Contêiner principal que envolve toda a estrutura do componente (navegação e conteúdo). Expõe o elemento para customizações de fundo, bordas e espaçamentos globais.\n- **nav** - Área de navegação (`tablist`) onde os botões das abas estão localizados. Permite customizar o alinhamento, espaçamento e plano de fundo da barra de abas.\n- **button** - Botão individual de cada aba.\n- **indicator** - Indicador visual da aba ativa.\n- **content** - Área de conteúdo das abas.",
       "attributes": [
         {
           "name": "active-tab-id",
@@ -4154,7 +4174,7 @@
         },
         {
           "name": "alignment",
-          "description": "Alinhamento horizontal canônico. Quando informado, tem precedência sobre `alignItemsTab`; valores inválidos usam `start`.",
+          "description": "Alinhamento horizontal. Quando informado, tem precedência sobre `alignItemsTab`; valores inválidos usam `start`.",
           "values": [{ "name": "TabAlignItems" }]
         },
         {
@@ -4177,7 +4197,7 @@
     },
     {
       "name": "br-tab-item",
-      "description": "Subcomponente individual de `br-tab`, responsável por representar conjuntamente a aba de seleção e o respectivo painel de conteúdo associado.\n\n### Papel na composição\n\n- Define o título ou rótulo da aba (propriedade `label` ou slot `label`), ícones de apoio e o estado de seleção (`active`) ou desativação (`disabled`).\n- Contém o corpo de elementos que compõem o painel renderizado quando a aba é selecionada.\n\n### Regra de uso e relacionamento\n\nDeve ser declarado dentro do slot padrão do orquestrador `br-tab`. O componente pai é responsável por montar a barra de botões acessíveis, sincronizar os atributos WAI-ARIA e controlar a alternância de visibilidade do painel. Não deve ser usado isoladamente sem o `br-tab` pai.\n\nPara a documentação completa de design, consulte o [Design System do GovBR](https://www.gov.br/ds/components/tab?tab=designer).\n---\n\n\n### **Events:**\n - **brTabItemPropsChange** - Evento disparado quando as propriedades do tab-item mudam.\nO componente pai (br-tab) escuta este evento para atualizar a navegação.\n\n### **Methods:**\n - **tabItemTitleChanged()** - Observa mudanças no título e notifica o pai\n- **iconChanged()** - Observa mudanças no ícone e notifica o pai\n- **counterChanged()** - Observa mudanças no contador e notifica o pai\n- **onlyIconChanged()** - Observa mudanças em onlyIcon e notifica o pai\n- **isActiveChanged()** - Observa mudanças no estado ativo (alterações via JS/DOM direto) e notifica o pai\n\n### **Slots:**\n - **default** - Slot para o conteúdo do item da aba.",
+      "description": "Define uma aba e seu respectivo painel de conteúdo dentro do `br-tab`.\n\nDefina o título da aba em `label` ou no slot `label`, e insira o conteúdo do painel no slot padrão. Use `active` para iniciar a aba selecionada e `disabled` para desabilitá-la.\n---\n\n\n### **Events:**\n - **brTabItemPropsChange** - Evento disparado quando as propriedades do tab-item mudam.\nO componente pai (br-tab) escuta este evento para atualizar a navegação.\n\n### **Methods:**\n - **tabItemTitleChanged()** - Observa mudanças no título e notifica o pai\n- **iconChanged()** - Observa mudanças no ícone e notifica o pai\n- **counterChanged()** - Observa mudanças no contador e notifica o pai\n- **onlyIconChanged()** - Observa mudanças em onlyIcon e notifica o pai\n- **isActiveChanged()** - Observa mudanças no estado ativo (alterações via JS/DOM direto) e notifica o pai\n\n### **Slots:**\n - **default** - Slot para o conteúdo do item da aba.",
       "attributes": [
         {
           "name": "tab-item-id",
@@ -4191,12 +4211,12 @@
         },
         {
           "name": "label",
-          "description": "Texto canônico do item. Quando informado, tem precedência sobre `tabItemTitle`.",
+          "description": "Texto do item. Quando informado, tem precedência sobre `tabItemTitle`.",
           "values": []
         },
         {
           "name": "icon",
-          "description": "Ícone da aba como identificador Iconify (ex.: `fa6-solid:bell`), renderizado em SVG pelo `br-icon`.\nPara ícones por classe CSS (ex.: Font Awesome), use o slot `icon-{id}` do `br-tab`, a forma\npreferida: `<i slot=\"icon-avisos\" class=\"fas fa-bell\" aria-hidden=\"true\"></i>`.\nO slot tem precedência sobre esta prop.\nUso descontinuado: classes CSS nesta prop (ex.: `fas fa-bell`) não são exibidas no Shadow DOM,\ngeram aviso e devem migrar para o slot `icon-{id}`. Identificadores Iconify continuam suportados.",
+          "description": "Ícone da aba como identificador Font Awesome 5 Free presente no cache local (ex.: `fa-solid:bell`), renderizado pelo `br-icon`.\nPara ícones por classe CSS (ex.: Font Awesome), use o slot `icon-{id}` do `br-tab`, a forma\npreferida: `<i slot=\"icon-avisos\" class=\"fas fa-bell\" aria-hidden=\"true\"></i>`.\nO slot tem precedência sobre esta prop.\nUso descontinuado: classes CSS nesta prop (ex.: `fas fa-bell`) não são exibidas no Shadow DOM,\ngeram aviso e devem migrar para o slot `icon-{id}`. Nomes fora do cache local não são carregados remotamente.",
           "values": []
         },
         {
@@ -4216,7 +4236,7 @@
         },
         {
           "name": "active",
-          "description": "Estado ativo canônico. Quando informado, tem precedência sobre `isActive`.",
+          "description": "Estado ativo atual. Quando informado, tem precedência sobre `isActive`.",
           "values": []
         },
         {
@@ -4234,192 +4254,498 @@
     },
     {
       "name": "br-table",
-      "description": "O componente `br-table` é o elemento oficial do GovBR-DS para exibição e gerenciamento de dados tabulares estruturados em linhas e colunas, desenvolvido com suporte a CSS Grid, responsividade e alta flexibilidade de composição.\n\n### Para que serve\n\n- **Apresentação de conjuntos de dados relacionais:** Organiza registros com múltiplos atributos comparáveis (ex.: relatórios, tabelas de processos, listagens financeiras).\n- **Recursos interativos avançados:** Suporta ordenação por coluna, seleção simples ou múltipla de linhas, densidades variadas (alta, média, baixa) e paginação integrada com `br-pagination`.\n- **Acessibilidade WAI-ARIA:** Preserva a semântica de tabela acessível (`role=\"table\"`, `role=\"columnheader\"`, `role=\"row\"`, `role=\"cell\"`) mesmo em leiautes baseados em CSS Grid.\n\n### Quando utilizar\n\n- **Utilize quando:**\n  - As informações compartilharem campos e atributos fixos que justifiquem a comparação lado a lado em colunas.\n  - A pessoa usuária precisar ordenar, filtrar ou selecionar múltiplos registros da lista.\n- **Evite e prefira outro componente quando:**\n  - Os itens forem heterogêneos com estruturas visuais distintas (prefira `br-card`).\n  - Houver apenas um texto linear simples por item (prefira `br-list`).\n\n### Composição e Subcomponentes\n\nO ecossistema da Tabela segue a hierarquia semântica modular:\n\n| Subcomponente | Papel | Regra de uso |\n| --- | --- | --- |\n| `br-table` | **Orquestrador principal.** Gerencia o grid de colunas, ordenação, seleção de linhas e densidade. | Contêiner raiz da tabela. |\n| `br-table-header` | **Seção de cabeçalho.** Agrupa as linhas de títulos das colunas. | Declarado no slot `header` da tabela. |\n| `br-table-body` | **Corpo de dados.** Agrupa as linhas de registros de conteúdo. | Declarado no slot `body` (ou padrão) da tabela. |\n| `br-table-row` | **Linha.** Representa uma linha de cabeçalho ou de registro de dados. | Declarado dentro de `br-table-header` ou `br-table-body`. |\n| `br-table-header-cell` | **Célula de título.** Célula de cabeçalho com suporte a botão de ordenação. | Declarado dentro de `br-table-row` no cabeçalho. |\n| `br-table-cell` | **Célula de dados.** Célula de conteúdo individual de uma coluna. | Declarado dentro de `br-table-row` no corpo de dados. |\n\n### Como os subcomponentes se relacionam\n\nA arquitetura de `br-table` reflete a semântica nativa de tabelas HTML de forma modular:\n`br-table` → `br-table-header` / `br-table-body` → `br-table-row` → `br-table-header-cell` / `br-table-cell`.\nO componente pai orquestra o alinhamento das colunas via tokens de Grid, distribuindo automaticamente os estados de seleção e foco para as linhas filhas.\n\nPara a documentação completa de design, incluindo diretrizes de acessibilidade e especificações visuais, consulte o [Design System do GovBR](https://www.gov.br/ds/components/table?tab=designer).\n---\n\n\n### **Methods:**\n \n\n\n\n\n- **startLoading(): _Promise<void>_** - Inicia o estado de carregamento da tabela.\n- **stopLoading(): _Promise<void>_** - Interrompe o estado de carregamento da tabela.\n- **render(): __** - Renderiza o host do componente.\n\n### **Slots:**\n - **loading** - Indicador exibido enquanto as linhas são atualizadas.\n\n### **CSS Parts:**\n - **container** - Wrapper principal da tabela.\n- **content** - Área de conteúdo que contém header e body.\n- **loading** - Área do indicador de carregamento.",
+      "description": "## Design System\n\nPara a documentação completa de design, incluindo diretrizes de uso, acessibilidade e exemplos visuais, consulte o [Design System do GovBR](https://www.gov.br/ds/components/table?tab=designer).\n\nApresenta e permite interagir com dados tabulares; não deve ser usada para\norganizar layout ou conteúdo que não seja tabular. Recebe o cabeçalho e o corpo\npelos slots `header` e `body`, compostos por `br-table-header` e\n`br-table-header-cell`, e por `br-table-body`, `br-table-row` e `br-table-cell`.\nOrquestra a grade, a acessibilidade, a ordenação, a seleção e a expansão das\nlinhas. A barra de ações é gerenciada pela tabela; `br-table-footer` é\nrenderizado quando a paginação está habilitada. As propriedades de célula\nseguem, quando aplicável, a precedência: célula, linha, coluna, tabela e valor\npadrão. Cabeçalhos multinível usam várias linhas em `br-table-header` com\n`colSpan`/`rowSpan`. Linhas contíguas com `rowGroup` formam unidades de ordenação,\npaginação e virtualização; a seleção permanece individual. Células com `rowSpan`\nnão atravessam os limites do grupo. Prefira tabelas simples quando possível.\n---\n\n\n### **Events:**\n - **brTableActionClick** - Quando uma ação pública é acionada.\n- **brTableSelectionChange** - Quando o conjunto selecionado muda.\n- **brTableRowExpansionChange** - Quando uma linha expande ou recolhe.\n- **brTableSortRequest** - Antes de aplicar uma solicitação de ordenação.\n- **brTableSortChange** - Quando os critérios de ordenação mudam.\n- **brTablePageChange** - Quando o consumidor solicita outra página pela paginação do rodapé.\n- **brTablePageSizeChange** - Quando o consumidor solicita outra quantidade de itens por página.\n- **brTableSearch** - Quando a busca é enviada ou fechada.\n- **brTableActionClick** - Reemite ações globais, contextuais e de linha para o consumidor.\n- **brTableSelectionChange** - Emitido quando o conjunto de linhas selecionadas muda.\n- **brTableRowExpansionChange** - Emitido quando uma linha é expandida ou recolhida.\n- **brTableSortChange** - Emitido sempre que o conjunto de critérios de ordenação muda.\n- **brTableSortRequest** - Emitido antes de aplicar uma solicitação de ordenação; `preventDefault()` cancela a mudança local.\n- **brTablePageChange** - Emitido quando o consumidor solicita outra página pela paginação do rodapé.\n- **brTablePageSizeChange** - Emitido quando o consumidor solicita outra quantidade de itens por página; atualize `visibleRows` ao tratar.\n- **brTableSearch** - Evento customizado originado em `br-table-bar` e propagado pela tabela,\nsem reemissão. Envia `{ term }` por Enter ou botão e `{ term: '' }` ao fechar.\nDigitação, inicialização e alterações programáticas não emitem o evento.\nPropaga, atravessa Shadow DOM e é cancelável.\n\n### **Methods:**\n \n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n- **startLoading(): _Promise<void>_** - Inicia o estado visual de carregamento sem alterar os dados da tabela.\n- **stopLoading(): _Promise<void>_** - Interrompe o estado visual de carregamento sem alterar os dados da tabela.\n- **setData(data: _TableData_): _Promise<void>_** - Substitui os dados lógicos da tabela e reconstrói seus subcomponentes.\n- **getSelectedRows(): _Promise<HTMLBrTableRowElement[]>_** - Retorna as linhas atualmente selecionadas.\n- **selectAllRows(): _Promise<void>_** - Seleciona todas as linhas elegíveis.\n- **clearSelection(): _Promise<void>_** - Limpa a seleção de todas as linhas elegíveis.\n- **getSorting(): _Promise<TableSortState[]>_** - Retorna o estado atual de ordenação aplicado na tabela.\n- **expandRow(rowIndex: _number_): _Promise<void>_** - Expande uma linha elegível do corpo.\n- **collapseRow(rowIndex: _number_): _Promise<void>_** - Recolhe uma linha do corpo.\n- **collapseAllRows(): _Promise<void>_** - Recolhe todas as linhas que estiverem expandidas.\n- **render()** - Renderiza o componente com semântica ARIA de grid.\n\n### **Slots:**\n - **header** - Componente `br-table-header` que define as colunas.\n- **body** - Componente `br-table-body` que contém as linhas de dados.\n- **global-actions** - Ações aplicadas ao conjunto completo de dados.\n- **contextual-actions** - Ações aplicadas às linhas selecionadas.\n- **loading** - Indicador exibido enquanto as linhas são atualizadas.\n\n### **CSS Properties:**\n - **--br-table-loading-opacity** - Opacidade do conteúdo durante o carregamento. Padrão: 0.5. _(default: undefined)_\n\n### **CSS Parts:**\n - **container** - Contêiner visual principal.\n- **scroll-container** - Área com rolagem que contém apenas os dados da tabela.\n- **content** - Grid que contém cabeçalho e corpo.\n- **footer** - Contêiner do rodapé, exibido abaixo do corpo da tabela.\n- **loading** - Scrim local e área do painel de carregamento sobre a tabela inteira.",
       "attributes": [
         {
           "name": "column-width",
-          "description": "Largura global aplicada a todas as colunas.",
+          "description": "Largura padrão utilizada pelas colunas sem configuração própria.",
           "values": [{ "name": "ColumnWidth" }]
         },
         {
           "name": "density",
-          "description": "Define a densidade visual do componente.\n\n- `small`: Alta densidade (componente menor, mais compacto e com menos espaçamento).\n- `medium`: Densidade intermediária, padrão recomendado para a maioria dos casos.\n- `large`: Baixa densidade (componente maior, mais espaçamento e altura).\n\nValores inválidos usam `medium`. Quando omitida, a densidade média é aplicada ao token.",
+          "description": "Densidade visual aplicada aos espaçamentos da tabela.",
           "values": [{ "name": "TableDensity" }]
         },
         {
           "name": "divider-style",
-          "description": "Define o estilo visual dos divisores.",
+          "description": "Estilo aplicado aos divisores habilitados.",
           "values": [{ "name": "TableDividerStyle" }]
         },
         {
           "name": "has-column-divider",
-          "description": "Ativa divisores verticais entre colunas.",
+          "description": "Habilita divisores entre colunas quando `columnDivider` não é informado.",
           "values": []
         },
         {
           "name": "column-divider",
-          "description": "Ativa divisores verticais. Quando informada, tem precedência sobre `hasColumnDivider`.",
+          "description": "Habilita divisores entre colunas.",
           "values": []
         },
         {
           "name": "has-row-divider",
-          "description": "Ativa divisores horizontais entre linhas.",
+          "description": "Habilita divisores entre linhas quando `rowDivider` não é informado.",
           "values": []
         },
         {
           "name": "row-divider",
-          "description": "Ativa divisores horizontais. Quando informada, tem precedência sobre `hasRowDivider`.",
+          "description": "Habilita divisores entre linhas.",
+          "values": []
+        },
+        {
+          "name": "has-row-hover",
+          "description": "Habilita o realce visual das linhas ao passar o ponteiro.",
+          "values": []
+        },
+        {
+          "name": "loading",
+          "description": "Indica que as linhas estão sendo atualizadas pelo consumidor.",
+          "values": []
+        },
+        {
+          "name": "heading",
+          "description": "Título apresentado na barra principal.",
+          "values": []
+        },
+        {
+          "name": "show-contextual-bar",
+          "description": "Força a apresentação da barra contextual.",
+          "values": []
+        },
+        {
+          "name": "heading-actions-limit",
+          "description": "Limite usado para decidir quando agrupar ações globais em um menu.\nQuando o número de ações excede esse valor, as ações são agrupadas no\ndropdown (atualmente todas são movidas para o menu colapsado).",
+          "values": []
+        },
+        {
+          "name": "contextual-actions-limit",
+          "description": "Limite usado para decidir quando agrupar ações contextuais em um menu.\nQuando o número de ações excede esse valor, as ações são agrupadas no\ndropdown (atualmente todas são movidas para o menu colapsado).",
+          "values": []
+        },
+        {
+          "name": "more-actions-heading-label",
+          "description": "Texto do tooltip do botão de ações agrupadas na barra de título.\nQuando vazio ou composto apenas por espaços, usa \"Mais ações\".\nNão altera o nome acessível do botão nem os rótulos do menu.",
+          "values": []
+        },
+        {
+          "name": "more-actions-contextual-label",
+          "description": "Texto do tooltip do botão de ações agrupadas da barra contextual.\nQuando vazio ou composto apenas por espaços, usa \"Mais ações\".\nNão altera o nome acessível do botão nem os rótulos do menu.",
+          "values": []
+        },
+        {
+          "name": "more-actions-label",
+          "description": "Texto completo do tooltip dos botões de ações agrupadas nas células.\nQuando informado, prevalece sobre `moreActionsLabel` de cada célula.\nQuando omitido, a célula usa seu valor local ou \"Mais ações\".\nValores vazios ou compostos apenas por espaços usam \"Mais ações\".\nAceita texto simples por atributo ou propriedade.\nReflete o valor no atributo `more-actions-label` para sincronizar as células.",
+          "values": []
+        },
+        {
+          "name": "cell-actions-limit",
+          "description": "Limite padrão de ações exibidas em cada célula.",
+          "values": []
+        },
+        {
+          "name": "has-row-selection",
+          "description": "Habilita a coluna de seleção de linhas.",
+          "values": []
+        },
+        {
+          "name": "has-row-expansion",
+          "description": "Habilita a coluna de expansão de linhas.",
+          "values": []
+        },
+        {
+          "name": "has-search",
+          "description": "Disponibiliza a interface de busca, sem filtrar ou destacar o conteúdo.\nA aplicação recebe `brTableSearch` e atualiza os dados local ou remotamente.",
+          "values": []
+        },
+        {
+          "name": "has-pagination",
+          "description": "Habilita a paginação da tabela, renderizando `br-table-footer` internamente.",
+          "values": []
+        },
+        {
+          "name": "current-page",
+          "description": "Página atual exibida pela paginação (1-indexada).",
+          "values": []
+        },
+        {
+          "name": "page-size",
+          "description": "Quantidade de itens pertencentes a cada página (linhas independentes ou grupos completos).",
+          "values": []
+        },
+        {
+          "name": "page-size-options",
+          "description": "Opções disponíveis de itens por página no seletor da paginação.",
+          "values": [{ "name": "number[]" }]
+        },
+        {
+          "name": "total-items",
+          "description": "Quantidade total de itens do conjunto de dados.",
+          "values": []
+        },
+        {
+          "name": "sort-mode",
+          "description": "Define se a tabela aceita uma única coluna ordenada ou múltiplas colunas.\nNo modo `multi`, a prioridade é sempre a ordem visual da esquerda para a direita.",
+          "values": [{ "name": "TableSortMode" }]
+        },
+        {
+          "name": "sort-strategy",
+          "description": "Define se a tabela ordena as linhas localmente ou deixa a aplicação aplicar\na ordenação solicitada. Em `manual`, a tabela mantém os indicadores e emite\n`brTableSortChange`, mas não reordena as linhas; use `setData()` para fornecer\nos resultados customizados ou remotos. Valores não reconhecidos usam a\nestratégia local.",
+          "values": [{ "name": "TableSortStrategy" }]
+        },
+        {
+          "name": "visible-rows",
+          "description": "Quantidade de linhas de dados visíveis simultaneamente na viewport.",
+          "values": []
+        },
+        {
+          "name": "height-rows",
+          "description": "Quantidade de itens lógicos usada somente para calcular a altura da viewport.\nCada grupo contíguo conta como um item; a altura inclui todas as linhas\nfísicas que compõem os grupos reservados. Não altera paginação, rolagem ou\nvirtualização. Quando omitida, acompanha `visibleRows`.",
+          "values": []
+        },
+        {
+          "name": "virtual-expanded-content-height",
+          "description": "Altura adicional estimada para conteúdo expandido ainda não medido.",
           "values": []
         },
         {
           "name": "horizontal-alignment",
-          "description": "Define o alinhamento horizontal do conteúdo das células.",
+          "description": "Alinhamento horizontal padrão da tabela.",
           "values": [{ "name": "TableAlignment" }]
         },
         {
           "name": "vertical-alignment",
-          "description": "Define o alinhamento vertical do conteúdo das células.",
+          "description": "Alinhamento vertical padrão da tabela.",
           "values": [{ "name": "TableAlignment" }]
         },
         {
           "name": "overflow",
-          "description": "Define o comportamento de overflow para as células.",
+          "description": "Estratégia padrão para conteúdos que excedem a célula.",
           "values": [{ "name": "TableOverflow" }]
         },
         {
           "name": "tooltip-state",
-          "description": "Define o estado semântico do tooltip nas células da tabela.",
+          "description": "Estado visual padrão dos tooltips.",
           "values": [{ "name": "TableTooltipState" }]
         },
         {
           "name": "tooltip-mode",
           "description": "Define o modo de resolução do tooltip nas células da tabela.",
           "values": [{ "name": "TableTooltipMode" }]
+        }
+      ],
+      "references": []
+    },
+    {
+      "name": "br-table-action",
+      "description": "## Design System\n\nPara a documentação completa de design, incluindo diretrizes de uso, acessibilidade e exemplos visuais, consulte o [Design System do GovBR](https://www.gov.br/ds/components/table?tab=designer).\n\nRepresenta uma ação global, contextual ou associada a uma linha da tabela.\nO contexto é inferido pelo slot e pela posição do componente na árvore.\n\nPara executar funções a partir das ações, ouça o evento `brTableActionClick`:\n\n```html\n<!-- 1. Ouvindo diretamente na ação -->\n<br-table-action id=\"btn-filtro\" label=\"Filtros\" icon-name=\"fa-solid:filter\"></br-table-action>\n<script>\n  document.getElementById('btn-filtro').addEventListener('brTableActionClick', () => {\n    executarFiltros();\n  });\n</script>\n\n<!-- 2. Ouvindo na tabela (recomendado para ações diretas e colapsadas em menu) -->\n<script>\n  table.addEventListener('brTableActionClick', (event) => {\n    const { type, label, rowIndex } = event.detail;\n    if (type === 'row') executarAcaoLinha(label, rowIndex);\n    else if (type === 'global') executarAcaoGlobal(label);\n  });\n</script>\n```\n---\n\n\n### **Events:**\n - **brTableActionClick** - Quando o usuário aciona o botão.\n- **brTableActionClick** - Emitido quando o usuário aciona o botão.\n\n### **Methods:**\n - **render()** - Renderiza a ação e adiciona tooltip quando o botão é circular.",
+      "attributes": [
+        {
+          "name": "label",
+          "description": "Texto visível e identificação semântica da ação.",
+          "values": []
         },
         {
-          "name": "loading",
-          "description": "Indica que as linhas estão sendo atualizadas pelo consumidor.\nO componente mantém o conteúdo anterior, aplica `aria-busy=\"true\"` e\nexibe o slot `loading` sobre os dados; transporte, erro e substituição das\nlinhas ficam sob responsabilidade da aplicação.\nA prop pode ser alterada diretamente ou pelos métodos `startLoading()` e\n`stopLoading()`.",
+          "name": "icon-name",
+          "description": "Nome do ícone exibido pelo botão.",
           "values": []
+        },
+        {
+          "name": "aria-label",
+          "description": "Rótulo acessível. Quando omitido, utiliza `label`.",
+          "values": []
+        },
+        {
+          "name": "density",
+          "description": "Densidade visual aplicada ao botão interno da ação.",
+          "values": [{ "name": "TableDensity" }]
+        }
+      ],
+      "references": []
+    },
+    {
+      "name": "br-table-bar",
+      "description": "## Design System\n\nPara a documentação completa de design, incluindo diretrizes de uso, acessibilidade e exemplos visuais, consulte o [Design System do GovBR](https://www.gov.br/ds/components/table?tab=designer).\n\nExibe o título, as ações globais e as ações contextuais da tabela.\nAções excedentes são agrupadas automaticamente em um menu.\nCompõe `br-table`, que configura a barra automaticamente. Também pode ser usada\ndiretamente para compor uma barra de ações. Quando `hasSearch` está ativo,\nsolicita a busca à aplicação, sem filtrar ou destacar os dados.\n---\n\n\n### **Events:**\n - **brTableSearch** - Evento customizado emitido pela barra ao enviar a busca por Enter ou pelo\nbotão, com `{ term }`, e ao fechar, com `{ term: '' }`. Propaga até `br-table`\ne atravessa Shadow DOM; é cancelável. Digitação, inicialização e alterações\nprogramáticas não emitem o evento.\n\n### **Methods:**\n - **render()** - Renderiza somente as barras necessárias ao estado atual.\n\n### **Slots:**\n - **global-actions** - Ações relacionadas ao conjunto completo de dados.\n- **contextual-actions** - Ações aplicadas às linhas selecionadas.",
+      "attributes": [
+        {
+          "name": "heading",
+          "description": "Título apresentado na barra principal.",
+          "values": []
+        },
+        {
+          "name": "heading-actions-limit",
+          "description": "Limite usado para decidir quando agrupar ações em um menu. Quando o\nnúmero de ações excede esse valor, as ações são agrupadas no dropdown\n(atualmente todas são movidas para o menu colapsado).",
+          "values": []
+        },
+        {
+          "name": "contextual-actions-limit",
+          "description": "Limite usado para decidir quando agrupar ações contextuais em um menu.\nQuando o número de ações excede esse valor, as ações são agrupadas no\ndropdown (atualmente todas são movidas para o menu colapsado).",
+          "values": []
+        },
+        {
+          "name": "show-contextual-bar",
+          "description": "Força a apresentação da barra contextual mesmo sem seleção.",
+          "values": []
+        },
+        {
+          "name": "selected-rows-count",
+          "description": "Número de linhas atualmente selecionadas.",
+          "values": []
+        },
+        {
+          "name": "has-global-actions-content",
+          "description": "Indica se o slot de ações globais possui conteúdo.",
+          "values": []
+        },
+        {
+          "name": "has-contextual-actions-content",
+          "description": "Indica se o slot de ações contextuais possui conteúdo.",
+          "values": []
+        },
+        {
+          "name": "has-search",
+          "description": "Disponibiliza a interface de busca controlada pela aplicação.",
+          "values": []
+        },
+        {
+          "name": "density",
+          "description": "Densidade visual aplicada aos controles internos da barra.",
+          "values": [{ "name": "TableDensity" }]
         }
       ],
       "references": []
     },
     {
       "name": "br-table-body",
-      "description": "Subcomponente de corpo de dados de `br-table`, responsável por agrupar as linhas de registros de conteúdo.\n\n### Papel na composição\n\n- Define a região principal da tabela com a semântica de `rowgroup` de conteúdo.\n- Recebe as linhas de dados `br-table-row` preenchidas com as células de valor `br-table-cell`.\n\n### Regra de uso e relacionamento\n\nDeve ser declarado dentro do slot `body` (ou padrão) de `br-table`. Ele organiza o fluxo vertical de registros coordenado pelo pai. Não deve ser usado fora de uma tabela.\n\nPara a documentação completa de design, consulte o [Design System do GovBR](https://www.gov.br/ds/components/table?tab=designer).\n---\n\n\n### **Methods:**\n - **render(): __** - Renderiza o host do componente.\n\n### **CSS Parts:**\n - **body** - Wrapper do corpo da tabela.",
+      "description": "## Design System\n\nPara a documentação completa de design, incluindo diretrizes de uso, acessibilidade e exemplos visuais, consulte o [Design System do GovBR](https://www.gov.br/ds/components/table?tab=designer).\n\nAgrupa semanticamente as linhas que compõem o corpo de `br-table`.\nÉ uma peça declarativa do slot `body`; recebe `br-table-row` e entrega ao\norquestrador a seleção, ordenação e materialização virtual. Os contêineres\nvisuais dos grupos são internos, montados pela tabela e não devem ser\ninstanciados pelo consumidor. Use o componente na composição de `br-table`.\n---\n\n\n### **Methods:**\n - **render()** - Renderiza o agrupamento de linhas com semântica acessível.\n\n### **Slots:**\n - **default** - Linhas `br-table-row` pertencentes ao corpo.\n\n### **CSS Parts:**\n - **body** - Contêiner estrutural do corpo.",
       "attributes": [],
       "references": []
     },
     {
       "name": "br-table-cell",
-      "description": "Subcomponente de célula de dados de `br-table`, utilizado para renderizar o valor ou conteúdo de um registro em uma coluna específica.\n\n### Papel na composição\n\n- Exibe o dado pontual da coluna (`role=\"cell\"`), podendo conter texto, badges, ícones, botões de ação ou links.\n\n### Regra de uso e relacionamento\n\nDeve ser declarado dentro de um `br-table-row` situado no `br-table-body`. O dimensionamento e posicionamento são calculados pelas regras de CSS Grid da tabela pai.\n\nPara a documentação completa de design, consulte o [Design System do GovBR](https://www.gov.br/ds/components/table?tab=designer).\n---\n\n\n### **Events:**\n - **brAlignmentChange** - Evento customizado emitido quando o alinhamento é alterado, permitindo que a célula reaja dinamicamente a mudanças nos tokens de alinhamento.\n- **brOverflowChange** - Evento customizado emitido quando a configuração de overflow é alterada, permitindo que a célula reaja dinamicamente a mudanças no token de overflow.\n\n### **Methods:**\n \n\n- **render(): __** - Renderiza o host do componente.\n\n### **CSS Parts:**\n - **cell** - Wrapper da célula.\n- **content** - Área de conteúdo da célula.",
+      "description": "## Design System\n\nPara a documentação completa de design, incluindo diretrizes de uso, acessibilidade e exemplos visuais, consulte o [Design System do GovBR](https://www.gov.br/ds/components/table?tab=designer).\n\nRepresenta uma célula de dados, com suporte a alinhamento, overflow,\ntooltip e agrupamento automático de ações excedentes. Compõe `br-table-row`\ndentro do corpo de `br-table`, que coordena posição, interação e herança.\nUse `rowSpan` dentro de um grupo contíguo de linhas e `rowHeader` para seu\nrótulo compartilhado; evite uso avulso fora da composição da tabela.\n---\n\n\n### **Events:**\n - **brAlignmentChange** - Quando um alinhamento específico muda.\n- **brOverflowChange** - Quando a estratégia de overflow muda.\n- **brAlignmentChange** - Emitido quando um alinhamento específico da célula muda.\n- **brOverflowChange** - Emitido quando a estratégia de overflow da célula muda.\n\n### **Methods:**\n - **getMeasuredHeight(): _Promise<number>_** - Retorna a altura renderizada da superfície visual desta célula, em pixels.\n\n\n- **render()** - Renderiza o conteúdo, as ações e o tooltip opcional.\n\n### **Slots:**\n - **default** - Conteúdo ou ações da célula.\n\n### **CSS Parts:**\n - **cell** - Superfície visual da célula.\n- **content** - Contêiner responsável pelo alinhamento.",
       "attributes": [
+        {
+          "name": "col-span",
+          "description": "Quantidade de colunas ocupadas. Inteiro entre 1 e 1000; valores inválidos usam 1.",
+          "values": []
+        },
+        {
+          "name": "row-span",
+          "description": "Quantidade de linhas ocupadas no cabeçalho ou grupo. Limitada às linhas\ndisponíveis; aceita inteiros de 1 a 1000 e valores inválidos usam 1.",
+          "values": []
+        },
+        {
+          "name": "row-header",
+          "description": "Identifica um cabeçalho de linha, inclusive rótulos compartilhados por um grupo.",
+          "values": []
+        },
         {
           "name": "horizontal-alignment",
-          "description": "Define o alinhamento horizontal do conteúdo dentro da célula.",
+          "description": "Alinhamento horizontal específico da célula. Quando omitido, herda da\nlinha, coluna ou tabela, nessa ordem.",
           "values": [{ "name": "TableAlignment" }]
         },
         {
           "name": "vertical-alignment",
-          "description": "Define o alinhamento vertical do conteúdo dentro da célula.",
+          "description": "Alinhamento vertical específico da célula. Quando omitido, herda da\nlinha, coluna ou tabela, nessa ordem.",
           "values": [{ "name": "TableAlignment" }]
         },
         {
           "name": "overflow",
-          "description": "Define se o conteúdo dentro da célula deve ser truncado, permitindo a herança dessa configuração para as células filhas com base no valor definido.",
+          "description": "Estratégia de overflow específica da célula. Quando omitida, herda da\nlinha, coluna ou tabela, nessa ordem.",
           "values": [{ "name": "TableOverflow" }]
         },
+        {
+          "name": "cell-actions-limit",
+          "description": "Limite local de ações exibidas diretamente.",
+          "values": []
+        },
+        {
+          "name": "more-actions-label",
+          "description": "Texto completo do tooltip do botão de ações agrupadas desta célula.\nA propriedade `moreActionsLabel` de `br-table` prevalece quando\ninformada. Valores vazios ou compostos apenas por espaços usam \"Mais ações\".\nNão altera o nome acessível do botão nem os rótulos das ações.\nAceita texto simples por atributo ou propriedade, sem reflexão.",
+          "values": []
+        },
+        {
+          "name": "sort-value",
+          "description": "Valor utilizado pela ordenação da coluna. Quando omitido, a tabela usa o\ntexto renderizado da célula.",
+          "values": []
+        },
         {
           "name": "tooltip-state",
-          "description": "Define o estado semântico do tooltip nesta célula.",
+          "description": "Estado visual do tooltip da célula. Quando omitido, herda da linha,\ncoluna ou tabela, nessa ordem.",
           "values": [{ "name": "TableTooltipState" }]
         },
         {
           "name": "tooltip-mode",
-          "description": "Define o modo de resolução do tooltip nesta célula.",
+          "description": "Modo de exibição do tooltip da célula. Quando omitido, herda da linha,\ncoluna ou tabela, nessa ordem. No modo `enabled`, exibe o conteúdo\nsomente quando estiver truncado na largura disponível.",
           "values": [{ "name": "TableTooltipMode" }]
+        },
+        {
+          "name": "action-density",
+          "description": "Densidade visual aplicada ao trigger de ações agrupadas.",
+          "values": [{ "name": "TableDensity" }]
+        }
+      ],
+      "references": []
+    },
+    {
+      "name": "br-table-footer",
+      "description": "Para a documentação completa, incluindo diretrizes de uso, acessibilidade e exemplos visuais, consulte o [Design System do GovBR](https://www.gov.br/ds/components/table?tab=designer).\n\nRenderiza a paginação da tabela quando `hasPagination` está habilitado em `br-table`.\nOrquestrado internamente pela tabela; não deve ser inserido diretamente pelo consumidor.\n---\n\n\n### **CSS Parts:**\n - **container** - Contêiner do rodapé.",
+      "attributes": [
+        {
+          "name": "current-page",
+          "description": "Página atual exibida pela paginação (1-indexada).",
+          "values": []
+        },
+        {
+          "name": "page-size",
+          "description": "Quantidade de itens exibidos por página.",
+          "values": []
+        },
+        {
+          "name": "page-size-options",
+          "description": "Opções disponíveis de itens por página.",
+          "values": [{ "name": "number[]" }]
+        },
+        {
+          "name": "total-items",
+          "description": "Quantidade total de itens do conjunto de dados.",
+          "values": []
+        },
+        {
+          "name": "density",
+          "description": "Densidade visual herdada da tabela.",
+          "values": [{ "name": "TableFooterDensity" }]
+        },
+        {
+          "name": "has-scroll",
+          "description": "Indica que a área de dados da tabela possui rolagem.",
+          "values": []
         }
       ],
       "references": []
     },
     {
       "name": "br-table-header",
-      "description": "Subcomponente de cabeçalho de `br-table`, utilizado para agrupar as linhas de títulos das colunas.\n\n### Papel na composição\n\n- Define a região superior da tabela com a semântica de `rowgroup` de cabeçalho.\n- Recebe uma ou mais linhas `br-table-row` que contêm as células de título `br-table-header-cell`.\n\n### Regra de uso e relacionamento\n\nDeve ser declarado dentro do slot `header` do componente pai `br-table`. O orquestrador da tabela aplica a configuração de colunas e espaçamentos sobre o cabeçalho. Não deve ser usado isoladamente.\n\nPara a documentação completa de design, consulte o [Design System do GovBR](https://www.gov.br/ds/components/table?tab=designer).\n---\n\n\n### **Methods:**\n - **render(): __** - Renderiza o host do componente.\n\n### **CSS Parts:**\n - **header** - Wrapper do cabeçalho da tabela.",
+      "description": "## Design System\n\nPara a documentação completa de design, incluindo diretrizes de uso, acessibilidade e exemplos visuais, consulte o [Design System do GovBR](https://www.gov.br/ds/components/table?tab=designer).\n\nAgrupa as linhas de cabeçalho de `br-table`, que as posiciona em uma grade.\nUse uma linha para tabelas simples e múltiplas linhas com `colSpan`/`rowSpan`\nem `br-table-header-cell` para hierarquias de colunas. É uma peça declarativa\ndo slot `header`, usada com o orquestrador; não realiza ordenação avulsa.\n---\n\n\n### **Methods:**\n - **render()** - Renderiza o cabeçalho com papel ARIA de grupo de linhas.\n\n### **Slots:**\n - **default** - Linhas contendo células `br-table-header-cell`.\n\n### **CSS Parts:**\n - **header** - Contêiner estrutural do cabeçalho.",
       "attributes": [],
       "references": []
     },
     {
       "name": "br-table-header-cell",
-      "description": "Subcomponente de célula de cabeçalho de `br-table`, responsável por nomear uma coluna e oferecer controles opcionais de ordenação.\n\n### Papel na composição\n\n- Define o rótulo da coluna com `role=\"columnheader\"`.\n- Suporta gatilho interativo de ordenação crescente e decrescente (`sortable`), emitindo eventos para reordenação de dados.\n\n### Regra de uso e relacionamento\n\nDeve ser declarado dentro de um `br-table-row` situado no `br-table-header`. O alinhamento horizontal segue a definição da coluna na tabela pai.\n\nPara a documentação completa de design, consulte o [Design System do GovBR](https://www.gov.br/ds/components/table?tab=designer).\n---\n\n\n### **Events:**\n - **brColumnWidthChange** - Evento customizado emitido quando a largura da coluna é alterada, permitindo que as células reajam dinamicamente a mudanças no layout.\n- **brAlignmentChange** - Evento customizado emitido quando o alinhamento é alterado, permitindo que a célula de cabeçalho reaja dinamicamente a mudanças nos tokens de alinhamento.\n- **brOverflowChange** - Evento customizado emitido quando a configuração de overflow é alterada, permitindo que a célula de cabeçalho reaja dinamicamente a mudanças no token de overflow.\n\n### **Methods:**\n \n\n\n- **render(): __** - Renderiza o host do componente.\n\n### **CSS Parts:**\n - **cell** - Wrapper da célula de cabeçalho.\n- **content** - Área de conteúdo da célula de cabeçalho.",
+      "description": "## Design System\n\nPara a documentação completa de design, incluindo diretrizes de uso, acessibilidade e exemplos visuais, consulte o [Design System do GovBR](https://www.gov.br/ds/components/table?tab=designer).\n\nDefine o conteúdo e as propriedades herdáveis de uma coluna de `br-table`.\nCompõe as linhas de `br-table-header` no slot `header`; não deve ser usada\navulsa. `colSpan` e `rowSpan` representam grupos e níveis do cabeçalho.\nSomente folhas que ocupam uma coluna podem ordenar os dados.\nTambém exibe tooltip quando o conteúdo truncado requer informação adicional.\n---\n\n\n### **Events:**\n - **brColumnWidthChange** - Quando a largura declarada muda.\n- **brAlignmentChange** - Quando um alinhamento da coluna muda.\n- **brOverflowChange** - Quando a estratégia de overflow muda.\n- **brColumnWidthChange** - Emitido quando a largura declarada para a coluna muda.\n- **brAlignmentChange** - Emitido quando um alinhamento da coluna muda.\n- **brOverflowChange** - Emitido quando a estratégia de overflow muda.\n\n### **Methods:**\n \n\n\n- **render()** - Renderiza o cabeçalho, seu conteúdo e o tooltip opcional.\n\n### **Slots:**\n - **default** - Conteúdo do cabeçalho da coluna.\n\n### **CSS Parts:**\n - **cell** - Superfície visual da célula.\n- **content** - Contêiner responsável pelo alinhamento.",
       "attributes": [
+        {
+          "name": "col-span",
+          "description": "Quantidade de colunas ocupadas. Inteiro entre 1 e 1000; valores inválidos usam 1.",
+          "values": []
+        },
+        {
+          "name": "row-span",
+          "description": "Quantidade de linhas ocupadas no cabeçalho ou grupo. Limitada às linhas\ndisponíveis; aceita inteiros de 1 a 1000 e valores inválidos usam 1.",
+          "values": []
+        },
         {
           "name": "column-width",
-          "description": "Define a largura da coluna.\nAceita `fill`, `content`, larguras positivas em `px` ou frações positivas em `fr`.\nValores inválidos usam o fallback da tabela.",
+          "description": "Largura semântica ou CSS aplicada à coluna. Quando omitida, herda da tabela.",
           "values": [{ "name": "ColumnWidth" }]
         },
         {
           "name": "horizontal-alignment",
-          "description": "Define o alinhamento horizontal do conteúdo dentro da célula de cabeçalho, permitindo a herança de alinhamento para as células filhas com base no valor definido.",
+          "description": "Alinhamento horizontal herdado pelas células da coluna. Quando omitido,\no cabeçalho herda da linha ou tabela, nessa ordem.",
           "values": [{ "name": "TableAlignment" }]
         },
         {
           "name": "vertical-alignment",
-          "description": "Define o alinhamento vertical do conteúdo dentro da célula de cabeçalho, permitindo a herança de alinhamento para as células filhas com base no valor definido.",
+          "description": "Alinhamento vertical herdado pelas células da coluna. Quando omitido,\no cabeçalho herda da linha ou tabela, nessa ordem.",
           "values": [{ "name": "TableAlignment" }]
         },
         {
           "name": "overflow",
-          "description": "Define se o conteúdo dentro da célula de cabeçalho deve ser truncado, permitindo a herança dessa configuração para as células filhas com base no valor definido.",
+          "description": "Estratégia de overflow herdada pelas células da coluna. Quando omitida,\no cabeçalho herda da linha ou tabela, nessa ordem.",
           "values": [{ "name": "TableOverflow" }]
         },
         {
           "name": "tooltip-state",
-          "description": "Define o estado semântico do tooltip nesta coluna/célula de cabeçalho.",
+          "description": "Estado visual herdado pelos tooltips da coluna. Quando omitido,\no cabeçalho herda da linha ou tabela, nessa ordem.",
           "values": [{ "name": "TableTooltipState" }]
         },
         {
           "name": "tooltip-mode",
-          "description": "Define o modo de resolução do tooltip nesta coluna/célula de cabeçalho.",
+          "description": "Modo de exibição herdado pelos tooltips da coluna. Quando omitido ou\ndefinido como inherit, o cabeçalho herda da linha ou tabela, nessa ordem.",
           "values": [{ "name": "TableTooltipMode" }]
+        },
+        {
+          "name": "sortable",
+          "description": "Habilita a ordenação desta coluna.",
+          "values": []
+        },
+        {
+          "name": "sort-direction",
+          "description": "Estado atual de ordenação controlado por `br-table`.",
+          "values": [{ "name": "TableSortDirection" }]
         }
       ],
       "references": []
     },
     {
       "name": "br-table-row",
-      "description": "Subcomponente de linha de `br-table`, utilizado tanto no cabeçalho quanto no corpo de dados para agrupar uma sequência horizontal de células.\n\n### Papel na composição\n\n- Representa uma linha de registro (`role=\"row\"`).\n- Suporta estados de seleção (`selected`), foco e hover coordenados com o pai.\n\n### Regra de uso e relacionamento\n\nDeclarado dentro de `br-table-header` (quando contiver `br-table-header-cell`) ou dentro de `br-table-body` (quando contiver `br-table-cell`). Não deve ser usado isoladamente.\n\nPara a documentação completa de design, consulte o [Design System do GovBR](https://www.gov.br/ds/components/table?tab=designer).\n---\n\n\n### **Events:**\n - **brAlignmentChange** - Evento customizado emitido quando o alinhamento é alterado, permitindo que as células reajam dinamicamente a mudanças nos tokens de alinhamento.\n- **brOverflowChange** - Evento customizado emitido quando a configuração de overflow é alterada, permitindo que as células reajam dinamicamente a mudanças no token de overflow.\n\n### **Methods:**\n \n\n- **render(): __** - Renderiza o host do componente.\n\n### **CSS Parts:**\n - **row** - Wrapper da linha da tabela.",
+      "description": "## Design System\n\nPara a documentação completa de design, incluindo diretrizes de uso, acessibilidade e exemplos visuais, consulte o [Design System do GovBR](https://www.gov.br/ds/components/table?tab=designer).\n\nRepresenta uma linha de dados e sua área opcional de conteúdo expandido.\nÉ uma peça declarativa de `br-table-body` ou `br-table-header`, coordenada por\n`br-table`. Recebe células de dados ou cabeçalho conforme o pai. `rowGroup`\nidentifica linhas contíguas que devem permanecer juntas; use-o apenas no corpo.\nEm grupos, os detalhes expandidos são apresentados após as linhas do grupo.\n---\n\n\n### **Events:**\n - **brAlignmentChange** - Quando um alinhamento herdável muda.\n- **brOverflowChange** - Quando a estratégia de overflow muda.\n- **brAlignmentChange** - Emitido quando uma propriedade de alinhamento da linha muda.\n- **brOverflowChange** - Emitido quando a estratégia de overflow da linha muda.\n\n### **Methods:**\n - **getMeasuredHeight(): _Promise<number>_** - Retorna a maior altura das células desta linha somada à área de expansão, em pixels.\n\n\n\n- **render()** - Renderiza as células e, quando expandida, o conteúdo adicional.\n\n### **Slots:**\n - **default** - Células de dados da linha.\n- **expanded-content** - Conteúdo arbitrário exibido abaixo da linha.\n\n### **CSS Parts:**\n - **row** - Contêiner estrutural da linha.\n- **expanded-content** - Área de conteúdo expandido.",
       "attributes": [
+        {
+          "name": "row-group",
+          "description": "Identifica um grupo contíguo de linhas com chave exclusiva, preservado como unidade na ordenação,\npaginação e virtualização. Vazio ou omitido mantém a linha independente.\nA seleção continua sendo individual por linha.",
+          "values": []
+        },
         {
           "name": "horizontal-alignment",
-          "description": "Define o alinhamento horizontal das células dentro da linha, permitindo a herança de alinhamento para as células filhas com base no valor definido.",
+          "description": "Alinhamento horizontal herdado pelas células da linha.",
           "values": [{ "name": "TableAlignment" }]
         },
         {
           "name": "vertical-alignment",
-          "description": "Define o alinhamento vertical das células dentro da linha, permitindo a herança de alinhamento para as células filhas com base no valor definido.",
+          "description": "Alinhamento vertical herdado pelas células da linha.",
           "values": [{ "name": "TableAlignment" }]
         },
         {
           "name": "overflow",
-          "description": "Define se o conteúdo dentro das células da linha deve ser truncado, permitindo a herança dessa configuração para as células filhas com base no valor definido.",
+          "description": "Estratégia de overflow herdada pelas células da linha.",
           "values": [{ "name": "TableOverflow" }]
         },
         {
           "name": "tooltip-state",
-          "description": "Define o estado semântico do tooltip nas células desta linha.",
+          "description": "Estado visual herdado pelos tooltips da linha.",
           "values": [{ "name": "TableTooltipState" }]
         },
         {
           "name": "tooltip-mode",
-          "description": "Define o modo de resolução do tooltip nas células desta linha.",
+          "description": "Modo de exibição herdado pelos tooltips da linha.",
           "values": [{ "name": "TableTooltipMode" }]
+        },
+        {
+          "name": "selected",
+          "description": "Indica se a linha está selecionada.",
+          "values": []
+        },
+        {
+          "name": "row-expansion",
+          "description": "Controla se a expansão é habilitada, desabilitada ou herdada da tabela.",
+          "values": [{ "name": "TableRowExpansion" }]
+        },
+        {
+          "name": "virtual-expanded-content-height",
+          "description": "Altura visível da área expandida desta linha, em pixels.",
+          "values": []
+        },
+        {
+          "name": "expanded",
+          "description": "Indica se o conteúdo adicional da linha está visível.",
+          "values": []
         }
       ],
       "references": []
     },
     {
       "name": "br-tag",
-      "description": "O componente `br-tag` é o elemento visual compacto do GovBR-DS utilizado para rotular, categorizar, exibir metadados ou aplicar filtros rápidos na interface.\n\n### Para que serve\n\n- **Categorização e metadados:** Identifica o tipo, categoria ou atributos de um item (ex.: \"Educação\", \"Tecnologia\", \"Urgente\").\n- **Sinalização de status:** Exibe estados operacionais de processos ou documentos através de cores semânticas e ícones (ex.: \"Aprovado\", \"Pendente\", \"Cancelado\").\n- **Filtros interativos dispensáveis:** Suporta botão de fechamento (`closable`), permitindo remover filtros dinamicamente.\n- **Tags de seleção:** Suporta modo interativo selecionável com integração nativa a formulários (`formAssociated`).\n\n### Quando utilizar\n\n- **Utilize quando:**\n  - Exibir palavras-chave associadas a um conteúdo ou cartão.\n  - Exibir status sucinto de registros em tabelas (`br-table`) ou cabeçalhos.\n  - Oferecer filtros aplicados que podem ser removidos com um clique.\n- **Evite e prefira outro componente quando:**\n  - O elemento for a ação primária ou um comando executável (prefira `br-button`).\n  - O texto for extenso e exigir explicações detalhadas (prefira `br-message`).\n\n### Estrutura e Slots\n\nO `br-tag` oferece flexibilidade estrutural:\n- `default`: Slot principal para texto ou conteúdo livre da tag.\n- `label`: Slot para rótulo customizado.\n- `icon`: Slot para inserção de ícone auxiliar (`br-icon`).\n- `close-button`: Slot para customizar o botão de remoção.\n- `feedback`: Slot para mensagem de validação contextual.\n\nPara a documentação completa de design, incluindo diretrizes de acessibilidade e especificações visuais, consulte o [Design System do GovBR](https://www.gov.br/ds/components/tag?tab=designer).\n---\n\n\n### **Events:**\n - **radioSelected** - Evento emitido quando a tag é selecionada.\n- **brTagValidationChange** - Emitido ao iniciar e concluir a validação customizada.\n\n### **Methods:**\n - **checkValidity(): _Promise<boolean>_** - Retorna se a tag selecionável atende às constraints configuradas.\n- **reportValidity(): _Promise<boolean>_** - Valida e solicita ao navegador a apresentação do erro atual.\n- **setCustomValidity(message: _string_): _Promise<void>_** - Define ou limpa uma mensagem de validade customizada.\n- **validate(): _Promise<boolean>_** - Executa o validator da tag e retorna se o valor atual é válido.\n- **getValidationState(): _Promise<FormValidationState>_** - Retorna um snapshot serializável da Constraint Validation API.\n\n### **Slots:**\n - **default** - Slot para inserir o conteúdo da tag, como rótulo ou ícone.\n- **label** - Rótulo customizado da tag. Quando utilizado, a prop `label` é ignorada.\n- **icon** - Ícone customizado da tag. Quando utilizado, a prop `icon` é ignorada.\n- **close-button** - Botão de fechar customizado. Quando utilizado, o botão padrão é substituído.\n- **feedback** - Mensagem de validação, normalmente um `br-message`.\n\n### **CSS Parts:**\n - **tag** - Elemento principal da tag.\n- **input** - Elemento input da tag de seleção.\n- **label** - Rótulo da tag de seleção.\n- **feedback** - Contêiner da mensagem de validação.",
+      "description": "O `br-tag` categoriza, rotula ou destaca informações curtas e metadados.\n\nSuporta modo estático informativo, modo interativo clicável com `action`, modo com botão de fechar (`closable`) e modo selecionável com `selectable`.\n\n```html\n<br-tag>Pendente</br-tag>\n<br-tag status=\"success\">Concluído</br-tag>\n<br-tag closable>Filtro: Brasília</br-tag>\n```\n\n### Quando usar\n\n- Rótulos de estado, tags de categorias ou palavras-chave.\n- Filtros aplicados que podem ser removidos individualmente.\n\n### Quando evitar\n\n- Ações primárias ou envio de formulário: use `br-button`.\n- Contagem numérica pura: use `br-avatar` ou texto de badge.\n\nConsulte as [diretrizes de design do GovBR](https://www.gov.br/ds/components/tag?tab=designer).\n---\n\n\n### **Events:**\n - **radioSelected** - Evento emitido quando a tag é selecionada.\n- **brTagValidationChange** - Emitido ao iniciar e concluir a validação customizada.\n\n### **Methods:**\n - **checkValidity(): _Promise<boolean>_** - Retorna se a tag selecionável atende às constraints configuradas.\n- **reportValidity(): _Promise<boolean>_** - Valida e solicita ao navegador a apresentação do erro atual.\n- **setCustomValidity(message: _string_): _Promise<void>_** - Define ou limpa uma mensagem de validade customizada.\n- **validate(): _Promise<boolean>_** - Executa o validator da tag e retorna se o valor atual é válido.\n- **getValidationState(): _Promise<FormValidationState>_** - Retorna um snapshot serializável da Constraint Validation API.\n\n### **Slots:**\n - **default** - Slot para inserir o conteúdo da tag, como rótulo ou ícone.\n- **label** - Rótulo customizado da tag. Quando utilizado, a prop `label` é ignorada.\n- **icon** - Ícone customizado da tag. Quando utilizado, a prop `icon` é ignorada.\n- **close-button** - Botão de fechar customizado. Quando utilizado, o botão padrão é substituído.\n- **feedback** - Mensagem de validação, normalmente um `br-message`.\n\n### **CSS Parts:**\n - **tag** - Elemento principal da tag.\n- **input** - Elemento input da tag de seleção.\n- **label** - Rótulo da tag de seleção.\n- **feedback** - Contêiner da mensagem de validação.",
       "attributes": [
         {
           "name": "label",
@@ -4483,7 +4809,7 @@
         },
         {
           "name": "variant",
-          "description": "Variante funcional canônica. Aceita `default`, `status`, `action` ou `selectable`.\nValores inválidos são ignorados; nesse caso, os aliases booleanos legados\ncontinuam disponíveis para manter a compatibilidade.",
+          "description": "Variante funcional padrão. Aceita `default`, `status`, `action` ou `selectable`.\nValores inválidos são ignorados; nesse caso, os aliases booleanos legados\ncontinuam disponíveis para manter a compatibilidade.",
           "values": [{ "name": "TagVariant" }]
         },
         {
@@ -4536,7 +4862,7 @@
     },
     {
       "name": "br-textarea",
-      "description": "O componente `br-textarea` é o controle oficial do GovBR-DS para entrada de dados textuais em múltiplas linhas, projetado para capturar textos longos, justificativas, descrições ou observações em formulários.\n\n### Para que serve\n\n- **Entrada de texto extenso:** Permite que a pessoa usuária digite parágrafos de texto livre com quebra de linha e rolagem vertical.\n- **Contador regressivo de caracteres:** Exibe a quantidade de caracteres restantes em tempo real com base no limite máximo (`maxlength`), alertando visualmente quando o limite é atingido.\n- **Integração com formulários:** É associado nativamente a formulários HTML (`formAssociated`), sincronizando valor, estado de validação e foco acessível.\n- **Redimensionamento controlado:** Oferece opções de redimensionamento vertical, horizontal ou fixo.\n\n### Quando utilizar\n\n- **Utilize quando:**\n  - A entrada esperada tiver mais de uma frase ou exigir formatação multilinha (comentários, manifestações, relatórios, justificativas).\n  - Houver restrição estrita de caracteres com necessidade de feedback quantitativo dinâmico.\n- **Evite e prefira outro componente quando:**\n  - O dado for curto e couber em uma única linha (como nomes, e-mails, títulos, documentos): prefira `br-input`.\n  - For necessário um editor rico WYSIWYG com formatação em negrito, tabelas e links.\n\n### Estrutura e Slots\n\nO `br-textarea` é composto pelo campo e slots de apoio:\n- `default`: Slot para instruções adicionais ou textos de ajuda.\n- `feedback`: Slot para mensagens de validação contextual (como `br-message`).\n- `validation-loading`: Slot para indicador de carregamento durante validações assíncronas.\n\nPara a documentação completa de design, incluindo diretrizes de acessibilidade e especificações visuais, consulte o [Design System do GovBR](https://www.gov.br/ds/components/textarea?tab=designer).\n---\n\n\n### **Events:**\n - **valueChange** - Valor atualizado do textarea\n- **brTextareaValidationChange** - Informa o início e o resultado do validator; o `detail` contém\n`validating`, `valid` e `message`.\n\n### **Methods:**\n - **checkValidity(): _Promise<boolean>_** - Retorna `true` se o valor do textarea for válido, caso contrário `false`.\nSe o textarea for inválido, dispara um evento 'invalid'.\n- **reportValidity(): _Promise<boolean>_** - Retorna `true` se o valor do textarea for válido, caso contrário `false`.\nSe for inválido, exibe a mensagem de erro padrão do navegador.\n- **setCustomValidity(message: _string_): _Promise<void>_** - Define uma mensagem de validação customizada para o textarea.\nSe a mensagem for uma string vazia, o erro customizado é limpo.\n- **validate(): _Promise<boolean>_** - Executa o validator customizado e retorna se o textarea está válido.\n- **getValidationState(): _Promise<FormValidationState>_** - Retorna um snapshot serializável da Constraint Validation API.\n- **select(): _Promise<void>_** - Seleciona todo o texto do controle nativo, conforme HTMLTextAreaElement.select().\n- **setRangeText(replacement: _string_, start: _number_, end: _number_, selectionMode: _SelectionMode_): _Promise<void>_** - Substitui um intervalo de texto usando a API nativa do textarea.\n- **setSelectionRange(start: _number_, end: _number_, direction: _'forward' | 'backward' | 'none'_): _Promise<void>_** - Define o intervalo selecionado no controle nativo.\n- **setValue(newValue: _string_)** - Define um novo valor para o textarea.\n\n### **Slots:**\n - **default** - Slot para texto adicional ou instruções a serem exibidos junto ao textarea.\n- **feedback** - Mensagem de validação, normalmente um `br-message`.\n- **validation-loading** - Indicador exibido durante validação assíncrona.\n\n### **CSS Parts:**\n - **container** - Contêiner visual principal.\n- **label** - Rótulo do textarea.\n- **textarea** - Elemento textarea nativo.\n- **counter** - Contêiner do contador.\n- **counter-text** - Texto do contador.\n- **helper** - Contêiner do conteúdo auxiliar do slot default.\n- **feedback** - Contêiner da mensagem de validação.",
+      "description": "O `br-textarea` captura textos longos em múltiplas linhas em formulários.\n\nConfigure `label`, `placeholder`, `maxlength` e `state` para validação. Use `show-counter` para exibir o contador de caracteres restantes.\n\n```html\n<br-textarea label=\"Observações\" placeholder=\"Digite sua mensagem\" maxlength=\"500\" show-counter></br-textarea>\n```\n\nEm formulários HTML, o componente integra-se via `ElementInternals`, participando da validação nativa com `required`.\n\n### Quando usar\n\n- Mensagens, comentários, justificativas, descrições ou textos extensos.\n\n### Quando evitar\n\n- Dados curtos de linha única (nome, CPF, e-mail): use `br-input`.\n\nConsulte as [diretrizes de design do GovBR](https://www.gov.br/ds/components/textarea?tab=designer).\n---\n\n\n### **Events:**\n - **valueChange** - Valor atualizado do textarea\n- **brTextareaValidationChange** - Informa o início e o resultado do validator; o `detail` contém\n`validating`, `valid` e `message`.\n\n### **Methods:**\n - **checkValidity(): _Promise<boolean>_** - Retorna `true` se o valor do textarea for válido, caso contrário `false`.\nSe o textarea for inválido, dispara um evento 'invalid'.\n- **reportValidity(): _Promise<boolean>_** - Retorna `true` se o valor do textarea for válido, caso contrário `false`.\nSe for inválido, exibe a mensagem de erro padrão do navegador.\n- **setCustomValidity(message: _string_): _Promise<void>_** - Define uma mensagem de validação customizada para o textarea.\nSe a mensagem for uma string vazia, o erro customizado é limpo.\n- **validate(): _Promise<boolean>_** - Executa o validator customizado e retorna se o textarea está válido.\n- **getValidationState(): _Promise<FormValidationState>_** - Retorna um snapshot serializável da Constraint Validation API.\n- **select(): _Promise<void>_** - Seleciona todo o texto do controle nativo, conforme HTMLTextAreaElement.select().\n- **setRangeText(replacement: _string_, start: _number_, end: _number_, selectionMode: _SelectionMode_): _Promise<void>_** - Substitui um intervalo de texto usando a API nativa do textarea.\n- **setSelectionRange(start: _number_, end: _number_, direction: _'forward' | 'backward' | 'none'_): _Promise<void>_** - Define o intervalo selecionado no controle nativo.\n- **setValue(newValue: _string_)** - Define um novo valor para o textarea.\n\n### **Slots:**\n - **default** - Slot para texto adicional ou instruções a serem exibidos junto ao textarea.\n- **feedback** - Mensagem de validação, normalmente um `br-message`.\n- **validation-loading** - Indicador exibido durante validação assíncrona.\n\n### **CSS Parts:**\n - **container** - Contêiner visual principal.\n- **label** - Rótulo do textarea.\n- **textarea** - Elemento textarea nativo.\n- **counter** - Contêiner do contador.\n- **counter-text** - Texto do contador.\n- **helper** - Contêiner do conteúdo auxiliar do slot default.\n- **feedback** - Contêiner da mensagem de validação.",
       "attributes": [
         {
           "name": "value",
@@ -4609,7 +4935,7 @@
         },
         {
           "name": "feedback-state",
-          "description": "Estado de feedback canônico. Quando informado, tem precedência sobre `state`; valores inválidos não aplicam estado.",
+          "description": "Estado de feedback. Quando informado, tem precedência sobre `state`; valores inválidos não aplicam estado.",
           "values": [
             { "name": "danger" },
             { "name": "success" },
@@ -4670,7 +4996,7 @@
     },
     {
       "name": "br-tooltip",
-      "description": "O componente `br-tooltip` é a sobreposição informativa flutuante do GovBR-DS, desenvolvida para fornecer dicas breves e esclarecimentos contextuais quando o usuário foca ou posiciona o cursor sobre um elemento da interface.\n\n### Para que serve\n\n- **Esclarecimento contextual imediato:** Revela descrições sucintas para botões de ícone, termos técnicos, siglas ou campos que necessitem de auxílio extra.\n- **Posicionamento automático:** Posiciona o balão informativo em relação ao elemento de acionamento (topo, direita, baixo, esquerda) ajustando-se dinamicamente ao espaço da tela.\n- **Acessibilidade WAI-ARIA:** Associa o acionador ao balão com `role=\"tooltip\"` e `aria-describedby`, exibindo-se automaticamente no foco por teclado e fechando com a tecla Escape.\n\n### Quando utilizar\n\n- **Utilize quando:**\n  - Fornecer o rótulo descritivo de um botão que contenha apenas ícone.\n  - Explicar uma sigla ou termo abreviado na interface.\n- **Evite e prefira outro componente quando:**\n  - O conteúdo for extenso, contiver botões interativos ou links navegáveis (prefira `br-dropdown`, `br-modal` ou texto inline fixo, pois tooltips desaparecem ao mover o ponteiro).\n  - A informação for indispensável para a conclusão de uma tarefa crítica (ela deve estar sempre visível na tela).\n\n### Estrutura e Slots\n\nO `br-tooltip` é composto por acionador e conteúdo:\n- `trigger`: Slot obrigatório onde a aplicação declara o elemento de controle gatilho (ex.: um `br-button` de ícone).\n- `content`: Slot onde é inserido o texto ou balão de conteúdo exibido pelo tooltip.\n\nPara a documentação completa de design, incluindo diretrizes de acessibilidade e especificações visuais, consulte o [Design System do GovBR](https://www.gov.br/ds/components/tooltip?tab=designer).\n---\n\n\n### **Events:**\n - **brDidOpen** - Emitido quando o tooltip abre.\n- **brDidClose** - Emitido quando o tooltip fecha.\n\n### **Methods:**\n - **handleVisibilityChange(visible: _boolean_): __** - Watcher para monitorar alterações na propriedade `isVisible`.\n- **handleMatchTriggerWidthChange()** - Recalcula a superfície visível quando a política de largura muda.\n- **handleFocusIn()** - Exibe o tooltip quando o acionador recebe foco.\n- **handleFocusOut()** - Oculta o tooltip quando o acionador perde foco.\n- **handleKeyDown(event: _KeyboardEvent_)** - Fecha com Escape enquanto o tooltip estiver visível.\n- **setTriggerElement(element: _HTMLElement | null_)** - Define um trigger externo para o tooltip.\n- **showTooltip()** - Exibe o tooltip programaticamente.\n- **hideTooltip()** - Oculta o tooltip programaticamente.\n- **show()** - Exibe o tooltip programaticamente (alias para `showTooltip`).\n- **hide()** - Oculta o tooltip programaticamente (alias para `hideTooltip`).\n- **render(): __** - Renderiza o componente.\nEste método é responsável por gerar o conteúdo HTML do componente.\nEle utiliza a função `h` do Stencil para criar elementos JSX.\n\n### **Slots:**\n - **trigger** - Slot para o elemento que aciona a exibição do tooltip.\n- **content** - Slot para o conteúdo exibido no tooltip.\n\n### **CSS Parts:**\n - **container** - Wrapper principal do tooltip.\n- **trigger** - Área do acionador do tooltip.\n- **content** - Área de conteúdo do tooltip.\n- **arrow** - Seta indicativa do tooltip.",
+      "description": "O `br-tooltip` exibe uma dica rápida e contextual quando o usuário foca ou passa o mouse sobre um elemento.\n\nColoque o texto da dica em `text` ou no slot padrão, e vincule-o ao elemento acionador através de `target` ou colocando o acionador no slot `trigger`.\n\n```html\n<br-button id=\"btn-ajuda\" shape=\"circle\" aria-label=\"Ajuda\">?</br-button>\n<br-tooltip target=\"#btn-ajuda\" text=\"Clique para obter informações\"></br-tooltip>\n```\n\n### Quando usar\n\n- Esclarecer o significado de botões que usam apenas ícones ou rótulos abreviados.\n\n### Quando evitar\n\n- Informações essenciais que todos os usuários precisam ler imediatamente: exiba como texto visível na página.\n- Conteúdos longos com links clicáveis: use `br-message` ou diálogo.\n\nConsulte as [diretrizes de design do GovBR](https://www.gov.br/ds/components/tooltip?tab=designer).\n---\n\n\n### **Events:**\n - **brDidOpen** - Emitido quando o tooltip abre.\n- **brDidClose** - Emitido quando o tooltip fecha.\n\n### **Methods:**\n - **handleVisibilityChange(visible: _boolean_): __** - Watcher para monitorar alterações na propriedade `isVisible`.\n- **handleMatchTriggerWidthChange()** - Recalcula a superfície visível quando a política de largura muda.\n- **handleFocusIn()** - Exibe o tooltip quando o acionador recebe foco.\n- **handleFocusOut()** - Oculta o tooltip quando o acionador perde foco.\n- **handleKeyDown(event: _KeyboardEvent_)** - Fecha com Escape enquanto o tooltip estiver visível.\n- **setTriggerElement(element: _HTMLElement | null_)** - Define um trigger externo para o tooltip.\n- **showTooltip()** - Exibe o tooltip programaticamente.\n- **hideTooltip()** - Oculta o tooltip programaticamente.\n- **show()** - Exibe o tooltip programaticamente (alias para `showTooltip`).\n- **hide()** - Oculta o tooltip programaticamente (alias para `hideTooltip`).\n- **render(): __** - Renderiza o componente.\nEste método é responsável por gerar o conteúdo HTML do componente.\nEle utiliza a função `h` do Stencil para criar elementos JSX.\n\n### **Slots:**\n - **trigger** - Slot para o elemento que aciona a exibição do tooltip.\n- **content** - Slot para o conteúdo exibido no tooltip.\n\n### **CSS Parts:**\n - **container** - Wrapper principal do tooltip.\n- **trigger** - Área do acionador do tooltip.\n- **content** - Área de conteúdo do tooltip.\n- **arrow** - Seta indicativa do tooltip.",
       "attributes": [
         {
           "name": "custom-id",
@@ -4732,7 +5058,7 @@
     },
     {
       "name": "br-upload",
-      "description": "O componente `br-upload` é o elemento oficial do GovBR-DS para seleção, anexação e envio de arquivos em formulários, com suporte a seleção múltipla, área de arrastar-e-soltar (drag-and-drop) e acompanhamento de progresso.\n\n### Para que serve\n\n- **Seleção e anexação de arquivos:** Permite anexar documentos, planilhas, imagens ou outros formatos através do seletor nativo do sistema operacional ou por arrastar e soltar.\n- **Validação de tipos e tamanhos:** Valida extensões permitidas (`accept`) e tamanho máximo por arquivo (`max-file-size`), informando erros de validação de forma acessível.\n- **Listagem visual e remoção:** Exibe a lista de arquivos selecionados com nome, tamanho formatado (KB/MB), barra de progresso individual e botão de exclusão.\n- **Integração com formulários:** Integrado nativamente via `formAssociated`, permitindo submissão tradicional de formulários ou upload assíncrono programático.\n\n### Quando utilizar\n\n- **Utilize quando:**\n  - A pessoa usuária precisar enviar comprovantes, relatórios, fotografias ou documentos digitais.\n  - For necessário limitar e validar os tipos de arquivo e o tamanho máximo antes do envio ao servidor.\n- **Evite e prefira outro componente quando:**\n  - A captura for exclusivamente de texto ou URLs externas (prefira `br-input`).\n\n### Estrutura e Slots\n\nO `br-upload` possui estrutura rica com múltiplos slots:\n- `default`: Slot para texto personalizado do botão de upload (padrão: \"Selecione o arquivo\").\n- `upload-list`: Slot opcional para substituição da área padrão de listagem de arquivos.\n- `label`: Slot para personalização do rótulo do campo.\n- `helper`: Slot para instruções ou restrições de formato/tamanho exibidas abaixo do campo.\n- `feedback`: Slot para mensagens de validação e erro (como `br-message`).\n- `loading`: Slot para indicador exibido durante o envio assíncrono dos arquivos.\n\nPara a documentação completa de design, incluindo diretrizes de acessibilidade e especificações visuais, consulte o [Design System do GovBR](https://www.gov.br/ds/components/upload?tab=designer).\n---\n\n\n### **Events:**\n - **selectedFilesChange** - Emitido quando a lista de arquivos selecionados muda.\n- **brRemove** - Evento emitido quando um arquivo da lista `uploadFiles` (externos) é removido pelo usuário.\nO objeto emitido contém os dados do arquivo removido.\n- **brUploadRemove** - Evento canônico emitido quando um arquivo existente é removido.\n- **brUploadCancel** - Emitido quando o usuário fecha a caixa de seleção de arquivos sem escolher nada.\n- **brUploadValidationChange** - Emitido ao iniciar e concluir a validação customizada.\nO `detail` contém `validating`, `valid` e `message`.\n- **brUploadStart** - Emitido antes de o `uploadHandler` processar um arquivo.\n- **brUploadProgress** - Emitido quando o `uploadHandler` informa o progresso de um arquivo.\n- **brUploadSuccess** - Emitido quando o `uploadHandler` conclui um arquivo.\n- **brUploadError** - Emitido quando o `uploadHandler` falha ao enviar um arquivo.\n\n### **Methods:**\n - **checkValidity(): _Promise<boolean>_** - Retorna `true` se o valor do componente for válido, caso contrário `false`.\nSe o componente for inválido, dispara um evento 'invalid'.\n- **reportValidity(): _Promise<boolean>_** - Retorna `true` se o valor do componente for válido, caso contrário `false`.\nSe for inválido, exibe a mensagem de erro padrão do navegador.\n- **setCustomValidity(message: _string_): _Promise<void>_** - Define uma mensagem de validação customizada para o upload.\nSe a mensagem for uma string vazia, o erro customizado é limpo.\n- **validate(): _Promise<boolean>_** - Executa o validator do upload e retorna se a lista atual é válida.\n- **getValidationState(): _Promise<FormValidationState>_** - Retorna um snapshot serializável da Constraint Validation API.\n- **cancelUpload(): _Promise<void>_** - Cancela o envio atual iniciado pelo `uploadHandler`.\n\n### **Slots:**\n - **default** - Texto personalizado para o botão de upload. Se não fornecido, será exibido \"Selecione o arquivo\" como texto padrão. Use este slot para personalizar o texto do botão de acordo com o contexto do upload, por exemplo: \"Anexar documentos\", \"Enviar imagens\", etc.\n- **upload-list** - Permite customizar a área de listagem de arquivos. Se utilizado, substitui a lista padrão gerada pelo componente.\n- **label** - Rótulo customizado do upload. Quando utilizado, a prop `label` é ignorada.\n- **helper** - Texto auxiliar exibido abaixo da superfície de seleção.\n- **feedback** - Mensagem de validação, normalmente um `br-message`.\n- **loading** - Conteúdo exibido enquanto o handler fornecido pela aplicação envia um arquivo.\n\n### **CSS Parts:**\n - **container** - Wrapper principal do upload.\n- **label** - Rótulo do campo de upload.\n- **input** - Elemento input de arquivo.\n- **button** - Botão de seleção de arquivo.\n- **helper** - Texto auxiliar do upload.\n- **remove-button** - Botão de remoção de arquivo.\n- **file-list** - Lista de arquivos selecionados.\n- **feedback** - Contêiner da mensagem de validação.\n- **loading** - Estado e progresso do envio assíncrono.",
+      "description": "O `br-upload` gerencia a seleção e envio de arquivos em formulários, com suporte a arrastar e soltar (drag and drop).\n\nDefina os tipos aceitos em `accept` e permita múltiplos arquivos com `multiple`. Use a lista de arquivos para exibir o progresso e o botão de exclusão.\n\n```html\n<br-upload label=\"Enviar documento\" accept=\".pdf,.png,.jpg\" multiple></br-upload>\n```\n\nEm formulários HTML, o componente integra-se via `ElementInternals`, enviando a lista de arquivos no submit nativo.\n\n### Quando usar\n\n- Anexar comprovantes, fotos ou documentos em formulários.\n\n### Quando evitar\n\n- Campo de texto ou URL de arquivo remoto: use `br-input`.\n\nConsulte as [diretrizes de design do GovBR](https://www.gov.br/ds/components/upload?tab=designer).\n---\n\n\n### **Events:**\n - **selectedFilesChange** - Emitido quando a lista de arquivos selecionados muda.\n- **brRemove** - Evento emitido quando um arquivo da lista `uploadFiles` (externos) é removido pelo usuário.\nO objeto emitido contém os dados do arquivo removido.\n- **brUploadRemove** - Evento emitido quando um arquivo existente é removido.\n- **brUploadCancel** - Emitido quando o usuário fecha a caixa de seleção de arquivos sem escolher nada.\n- **brUploadValidationChange** - Emitido ao iniciar e concluir a validação customizada.\nO `detail` contém `validating`, `valid` e `message`.\n- **brUploadStart** - Emitido antes de o `uploadHandler` processar um arquivo.\n- **brUploadProgress** - Emitido quando o `uploadHandler` informa o progresso de um arquivo.\n- **brUploadSuccess** - Emitido quando o `uploadHandler` conclui um arquivo.\n- **brUploadError** - Emitido quando o `uploadHandler` falha ao enviar um arquivo.\n\n### **Methods:**\n - **checkValidity(): _Promise<boolean>_** - Retorna `true` se o valor do componente for válido, caso contrário `false`.\nSe o componente for inválido, dispara um evento 'invalid'.\n- **reportValidity(): _Promise<boolean>_** - Retorna `true` se o valor do componente for válido, caso contrário `false`.\nSe for inválido, exibe a mensagem de erro padrão do navegador.\n- **setCustomValidity(message: _string_): _Promise<void>_** - Define uma mensagem de validação customizada para o upload.\nSe a mensagem for uma string vazia, o erro customizado é limpo.\n- **validate(): _Promise<boolean>_** - Executa o validator do upload e retorna se a lista atual é válida.\n- **getValidationState(): _Promise<FormValidationState>_** - Retorna um snapshot serializável da Constraint Validation API.\n- **cancelUpload(): _Promise<void>_** - Cancela o envio atual iniciado pelo `uploadHandler`.\n\n### **Slots:**\n - **default** - Conteúdo personalizado do botão de upload, com precedência sobre `buttonLabel` (use a prop para texto simples).\n- **upload-list** - Permite customizar a área de listagem de arquivos. Se utilizado, substitui a lista padrão gerada pelo componente.\n- **label** - Rótulo customizado do upload. Quando utilizado, a prop `label` é ignorada.\n- **helper** - Texto auxiliar exibido abaixo da superfície de seleção.\n- **feedback** - Mensagem de validação, normalmente um `br-message`.\n- **loading** - Conteúdo exibido enquanto o handler fornecido pela aplicação envia um arquivo.\n\n### **CSS Parts:**\n - **container** - Wrapper principal do upload.\n- **label** - Rótulo do campo de upload.\n- **input** - Elemento input de arquivo.\n- **button** - Botão de seleção de arquivo.\n- **helper** - Texto auxiliar do upload.\n- **remove-button** - Botão de remoção de arquivo.\n- **file-list** - Lista de arquivos selecionados.\n- **feedback** - Contêiner da mensagem de validação.\n- **loading** - Estado e progresso do envio assíncrono.",
       "attributes": [
         {
           "name": "custom-id",
@@ -4763,6 +5089,11 @@
           "description": "Rótulo exibido acima do botão de upload.",
           "values": []
         },
+        {
+          "name": "button-label",
+          "description": "Texto do botão de seleção. Quando omitido, usa \"Selecione o arquivo\" ou,\ncom `multiple`, \"Selecione o(s) arquivo(s)\". O slot padrão tem precedência.",
+          "values": []
+        },
         {
           "name": "upload-files",
           "description": "Lista de arquivos já enviados (para edição ou pré-visualização).\nPode ser uma string JSON ou um array de objetos IUploadFile. Cada item deve ter `name` não vazio e `size` numérico não negativo opcional; itens inválidos são ignorados.",
@@ -4790,7 +5121,7 @@
         },
         {
           "name": "feedback-state",
-          "description": "Estado de feedback canônico. Quando informado, tem precedência sobre `state`.",
+          "description": "Estado de feedback. Quando informado, tem precedência sobre `state`.",
           "values": [{ "name": "BrFeedbackState" }]
         },
         {
@@ -4833,7 +5164,7 @@
     },
     {
       "name": "br-wizard",
-      "description": "O componente `br-wizard` é o orquestrador completo de fluxos passo a passo do GovBR-DS, desenvolvido para guiar a pessoa usuária através de formulários e tarefas complexas distribuídas em etapas consecutivas.\n\n### Para que serve\n\n- **Condução guiada de processos:** Apresenta um formulário longo dividido em etapas menores e focadas, reduzindo a carga cognitiva e o índice de abandono.\n- **Barra de progresso e navegação integradas:** Combina o indicador visual de etapas (`step`), os painéis de conteúdo de cada etapa (`br-wizard-panel`) e a barra de ações com botões de \"Voltar\", \"Avançar\", \"Concluir\" e \"Cancelar\".\n- **Validação por etapa:** Permite interceptar o avanço de cada passo para validação antes de liberar o próximo painel.\n\n### Quando utilizar\n\n- **Utilize quando:**\n  - Houver um processo de cadastro, requerimento, compra ou configuração estruturado em etapas com dependência de sequência.\n  - For essencial oferecer navegação pré-programada de retorno e avanço com controle de estado.\n- **Evite e prefira outro componente quando:**\n  - O objetivo for apenas mostrar o status de um pedido já concluído (use `br-step` simples).\n  - O usuário puder navegar em qualquer ordem entre as seções da tela (use `br-tab`).\n\n### Composição e Subcomponentes\n\n| Subcomponente | Papel | Regra de uso |\n| --- | --- | --- |\n| `br-wizard` | **Orquestrador principal.** Gerencia a barra de progresso, ações de navegação (voltar/avançar), botões de rodapé e controle do painel ativo. | Deve ser o contêiner raiz do fluxo. |\n| `br-wizard-panel` | **Painel de etapa individual.** Contém os campos e formulários de uma etapa específica. | Declarado dentro do slot padrão do `br-wizard`. |\n\n### Como os subcomponentes se relacionam\n\nO `br-wizard` gerencia ativamente os elementos `br-wizard-panel` declarados em seu interior:\n1. O pai exibe apenas o painel correspondente à etapa atual (`activeStep`), mantendo os demais ocultos.\n2. Ao avançar ou retroceder, o `br-wizard` dispara eventos de validação e troca de etapa (`brStepChange`), atualizando simultaneamente o cabeçalho de progresso e as ações do rodapé.\n\nPara a documentação completa de design, incluindo diretrizes de acessibilidade e especificações visuais, consulte o [Design System do GovBR](https://www.gov.br/ds/components/wizard?tab=designer).\n---\n\n\n### **Events:**\n - **brWizardStepChange** - Evento emitido APÓS mudar de etapa com sucesso.\n\nEste evento é disparado independente da origem da navegação:\n- Botões \"Avançar\" ou \"Voltar\"\n- Click direto em um step do indicador de progresso\n- Chamadas programáticas via métodos públicos (goToStep, nextStep, etc)\n- **brWizardBeforeStepChange** - Evento emitido ANTES de mudar de etapa (permite validação e cancelamento).\n\nComportamento:\n- Disparado apenas ao AVANÇAR (targetStep > currentStep)\n- Não é disparado ao VOLTAR (targetStep < currentStep)\n- Funciona tanto para cliques nos botões quanto para cliques diretos nos steps\n- Pode ser cancelado com `event.preventDefault()` para bloquear a navegação\n- **brWizardComplete** - Evento emitido ao concluir o wizard (última etapa).\n- **brWizardCancel** - Evento emitido ao cancelar o wizard.\n- **brWizardNavigationBlocked** - Evento emitido quando uma ação é bloqueada (validação falha, progressão linear impedida).\nEmite uma string indicando o motivo: 'linear-progression' ou 'validation-failed'.\nUse getCurrentStepIndex() para obter o contexto da etapa atual.\n\n### **Methods:**\n - **handleProgressionTypeChange()** - Observa mudanças no tipo de progressão.\nAtualiza a navegação dos painéis quando muda entre linear/nonlinear.\n- **handleInitialStepChange()** - Observa mudanças na etapa inicial.\nReinicializa o wizard quando a prop initialStep é alterada externamente.\n- **handleCurrentStepChange(newStep: _number_, oldStep: _number_)** - Observa mudanças na etapa atual (fonte única de verdade).\nSincroniza com br-step, atualiza painéis, anuncia mudança e move foco.\n- **handleSlotChange(event: _Event_)** - Detecta quando o slot muda (painéis adicionados/removidos dinamicamente).\nRedescobre os painéis e ressincroniza o estado.\n- **handleStepChange(event: _CustomEvent<{ activeStep: number }>_)** - Detecta quando o br-step muda de etapa ativa.\nValida e sincroniza a navegação com o componente interno br-step.\n- **nextStep(): _Promise<boolean>_** - Avança para a próxima etapa.\nExecuta validação via evento `brWizardBeforeStepChange` antes de navegar.\n- **next(): _Promise<boolean>_** - Avança para a próxima etapa.\n- **previousStep(): _Promise<boolean>_** - Volta para a etapa anterior.\nNão executa validação ao retornar.\n- **previous(): _Promise<boolean>_** - Retorna para a etapa anterior.\n- **goToStep(stepNumber: _number_): _Promise<boolean>_** - Navega para uma etapa específica.\nExecuta validação se estiver avançando (etapa alvo > etapa atual).\n- **reset(): _Promise<void>_** - Retorna à primeira etapa do wizard.\nNão executa validação (útil para reiniciar o fluxo).\n- **getCurrentStep(): _Promise<HTMLElement | null>_** - Retorna o elemento HTML do painel ativo no momento.\n- **getAllSteps(): _Promise<HTMLElement[]>_** - Retorna todos os painéis do wizard.\n- **getStepByIndex(stepNumber: _number_): _Promise<HTMLElement | null>_** - Retorna um painel específico pelo índice.\n- **getCurrentStepIndex(): _Promise<number>_** - Retorna o índice (número) da etapa atual.\nA numeração começa em 1 (primeira etapa = 1, segunda = 2, etc).\n- **getTotalSteps(): _Promise<number>_** - Retorna o número total de etapas do wizard.\n- **render(): __** - Método de renderização principal do componente.\nMonta a estrutura completa do wizard com acessibilidade integrada.\n\n### **Slots:**\n - **default** - Slot para os painéis de etapa (br-wizard-panel) do wizard.\n- **cancel-button** - Conteúdo customizado do botão de cancelar. Quando utilizado, o texto padrão \"Cancelar\" é substituído.\n- **next-button** - Conteúdo customizado do botão de avançar/concluir. Quando utilizado, os textos padrão \"Avançar\" e \"Concluir\" são substituídos.\n- **previous-button** - Conteúdo customizado do botão de voltar. Quando utilizado, o texto padrão \"Voltar\" é substituído.\n\n### **CSS Parts:**\n - **form** - Área do formulário do wizard.\n- **panel** - Painel ativo do wizard.\n- **progress** - Área de progresso do wizard.\n- **content** - Conteúdo do painel ativo.\n- **buttons** - Área de botões de navegação.",
+      "description": "O `br-wizard` conduz fluxos passo a passo divididos em telas sequenciais com botões de navegação e barra de progresso.\n\nInsira cada tela com `br-wizard-panel` no slot padrão. Acompanhe a mudança de etapas pelo evento `brStepChange`.\n\n```html\n<br-wizard>\n  <br-wizard-panel title-text=\"Identificação\">\n    <p>Primeira etapa do cadastro.</p>\n  </br-wizard-panel>\n  <br-wizard-panel title-text=\"Endereço\">\n    <p>Segunda etapa do cadastro.</p>\n  </br-wizard-panel>\n  <br-wizard-panel title-text=\"Confirmação\">\n    <p>Revise os dados antes de enviar.</p>\n  </br-wizard-panel>\n</br-wizard>\n```\n\n### Quando usar\n\n- Formulários extensos com dependência lógica entre etapas.\n\n### Quando evitar\n\n- Apenas indicar o status de um pedido já realizado: use `br-step`.\n- Conteúdos independentes onde a ordem de preenchimento é livre: use `br-tab`.\n\nConsulte as [diretrizes de design do GovBR](https://www.gov.br/ds/components/wizard?tab=designer).\n---\n\n\n### **Events:**\n - **brWizardStepChange** - Evento emitido APÓS mudar de etapa com sucesso.\n\nEste evento é disparado independente da origem da navegação:\n- Botões \"Avançar\" ou \"Voltar\"\n- Click direto em um step do indicador de progresso\n- Chamadas programáticas via métodos públicos (goToStep, nextStep, etc)\n- **brWizardBeforeStepChange** - Evento emitido ANTES de mudar de etapa (permite validação e cancelamento).\n\nComportamento:\n- Disparado apenas ao AVANÇAR (targetStep > currentStep)\n- Não é disparado ao VOLTAR (targetStep < currentStep)\n- Funciona tanto para cliques nos botões quanto para cliques diretos nos steps\n- Pode ser cancelado com `event.preventDefault()` para bloquear a navegação\n- **brWizardComplete** - Evento emitido ao concluir o wizard (última etapa).\n- **brWizardCancel** - Evento emitido ao cancelar o wizard.\n- **brWizardNavigationBlocked** - Evento emitido quando uma ação é bloqueada (validação falha, progressão linear impedida).\nEmite uma string indicando o motivo: 'linear-progression' ou 'validation-failed'.\nUse getCurrentStepIndex() para obter o contexto da etapa atual.\n\n### **Methods:**\n - **handleProgressionTypeChange()** - Observa mudanças no tipo de progressão.\nAtualiza a navegação dos painéis quando muda entre linear/nonlinear.\n- **handleInitialStepChange()** - Observa mudanças na etapa inicial.\nReinicializa o wizard quando a prop initialStep é alterada externamente.\n- **handleCurrentStepChange(newStep: _number_, oldStep: _number_)** - Observa mudanças na etapa atual (fonte única de verdade).\nSincroniza com br-step, atualiza painéis, anuncia mudança e move foco.\n- **handleSlotChange(event: _Event_)** - Detecta quando o slot muda (painéis adicionados/removidos dinamicamente).\nRedescobre os painéis e ressincroniza o estado.\n- **handleStepChange(event: _CustomEvent<{ activeStep: number }>_)** - Detecta quando o br-step muda de etapa ativa.\nValida e sincroniza a navegação com o componente interno br-step.\n- **nextStep(): _Promise<boolean>_** - Avança para a próxima etapa.\nExecuta validação via evento `brWizardBeforeStepChange` antes de navegar.\n- **next(): _Promise<boolean>_** - Avança para a próxima etapa.\n- **previousStep(): _Promise<boolean>_** - Volta para a etapa anterior.\nNão executa validação ao retornar.\n- **previous(): _Promise<boolean>_** - Retorna para a etapa anterior.\n- **goToStep(stepNumber: _number_): _Promise<boolean>_** - Navega para uma etapa específica.\nExecuta validação se estiver avançando (etapa alvo > etapa atual).\n- **reset(): _Promise<void>_** - Retorna à primeira etapa do wizard.\nNão executa validação (útil para reiniciar o fluxo).\n- **getCurrentStep(): _Promise<HTMLElement | null>_** - Retorna o elemento HTML do painel ativo no momento.\n- **getAllSteps(): _Promise<HTMLElement[]>_** - Retorna todos os painéis do wizard.\n- **getStepByIndex(stepNumber: _number_): _Promise<HTMLElement | null>_** - Retorna um painel específico pelo índice.\n- **getCurrentStepIndex(): _Promise<number>_** - Retorna o índice (número) da etapa atual.\nA numeração começa em 1 (primeira etapa = 1, segunda = 2, etc).\n- **getTotalSteps(): _Promise<number>_** - Retorna o número total de etapas do wizard.\n- **render(): __** - Método de renderização principal do componente.\nMonta a estrutura completa do wizard com acessibilidade integrada.\n\n### **Slots:**\n - **default** - Slot para os painéis de etapa (br-wizard-panel) do wizard.\n- **cancel-button** - Conteúdo customizado do botão de cancelar. Quando utilizado, o texto padrão \"Cancelar\" é substituído.\n- **next-button** - Conteúdo customizado do botão de avançar/concluir. Quando utilizado, os textos padrão \"Avançar\" e \"Concluir\" são substituídos.\n- **previous-button** - Conteúdo customizado do botão de voltar. Quando utilizado, o texto padrão \"Voltar\" é substituído.\n\n### **CSS Parts:**\n - **form** - Área do formulário do wizard.\n- **panel** - Painel ativo do wizard.\n- **progress** - Área de progresso do wizard.\n- **content** - Conteúdo do painel ativo.\n- **buttons** - Área de botões de navegação.",
       "attributes": [
         {
           "name": "step",
@@ -4875,7 +5206,7 @@
     },
     {
       "name": "br-wizard-panel",
-      "description": "Subcomponente individual de `br-wizard`, responsável por encapsular o formulário, campos de entrada ou informações pertencentes a uma etapa específica do fluxo guiado.\n\n### Papel na composição\n\n- Agrupa todos os campos de formulário e conteúdos daquela etapa.\n- Informa o título e subtítulo da etapa que serão refletidos na barra de progresso do wizard.\n\n### Regra de uso e relacionamento\n\nDeve ser declarado no slot padrão do orquestrador `br-wizard`. O componente pai é quem decide qual painel deve estar visível com base na etapa corrente, coordenando os botões de avançar e voltar. Não deve ser instanciado de forma autônoma fora de um `br-wizard`.\n\nPara a documentação completa de design, consulte o [Design System do GovBR](https://www.gov.br/ds/components/wizard?tab=designer).\n---\n\n\n### **Slots:**\n - **default** - Slot para o conteúdo da etapa (formulários, campos ou informações da fase atual).\n\n### **CSS Parts:**\n - **panel** - Wrapper do painel.\n- **content** - Área de conteúdo do painel.",
+      "description": "Painel de conteúdo de uma etapa individual do `br-wizard`.\n\nDefina o título da etapa em `title-text`. Insira os campos e conteúdos dessa fase no slot padrão.\n---\n\n\n### **Slots:**\n - **default** - Slot para o conteúdo da etapa (formulários, campos ou informações da fase atual).\n\n### **CSS Parts:**\n - **panel** - Wrapper do painel.\n- **content** - Área de conteúdo do painel.",
       "attributes": [
         {
           "name": "label",