@govbr-ds/webcomponents 2.4.0 → 2.5.0

package/cem/custom-elements.json

@@ -8,7 +8,7 @@
       "declarations": [
         {
           "kind": "class",
-          "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).",
+          "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).",
           "name": "Avatar",
           "cssParts": [
             {
@@ -477,7 +477,7 @@
       "declarations": [
         {
           "kind": "class",
-          "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).",
+          "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).",
           "name": "Breadcrumb",
           "cssParts": [
             {
@@ -599,7 +599,7 @@
               "type": {
                 "text": "string | undefined"
               },
-              "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`.",
               "parsedType": {
                 "text": "string"
               }
@@ -1175,7 +1175,7 @@
             {
               "name": "home-href",
               "fieldName": "homeHref",
-              "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`.",
               "type": {
                 "text": "string"
               }
@@ -1265,7 +1265,7 @@
       "declarations": [
         {
           "kind": "class",
-          "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).",
+          "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`.",
           "name": "BreadcrumbItem",
           "slots": [
             {
@@ -1409,7 +1409,7 @@
       "declarations": [
         {
           "kind": "class",
-          "description": "Subcomponente 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).",
+          "description": "Nome antigo do `br-breadcrumb-item`, mantido para compatibilidade. Funciona da mesma forma; em código novo, use `br-breadcrumb-item`.",
           "name": "Crumb",
           "slots": [
             {
@@ -1559,7 +1559,7 @@
       "declarations": [
         {
           "kind": "class",
-          "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).",
+          "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).",
           "name": "Button",
           "cssParts": [
             {
@@ -1685,7 +1685,7 @@
               "type": {
                 "text": "boolean | undefined"
               },
-              "description": "Estado ativo canônico. Quando informado, tem precedência sobre `isActive`.",
+              "description": "Estado ativo atual. Quando informado, tem precedência sobre `isActive`.",
               "parsedType": {
                 "text": "boolean"
               }
@@ -1706,7 +1706,7 @@
               "type": {
                 "text": "boolean | undefined"
               },
-              "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`.",
               "parsedType": {
                 "text": "boolean"
               }
@@ -1971,7 +1971,7 @@
             {
               "name": "active",
               "fieldName": "active",
-              "description": "Estado ativo canônico. Quando informado, tem precedência sobre `isActive`.",
+              "description": "Estado ativo atual. Quando informado, tem precedência sobre `isActive`.",
               "type": {
                 "text": "boolean"
               }
@@ -1985,7 +1985,7 @@
             {
               "name": "loading",
               "fieldName": "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`.",
               "type": {
                 "text": "boolean"
               }
@@ -2129,7 +2129,7 @@
       "declarations": [
         {
           "kind": "class",
-          "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).",
+          "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).",
           "name": "BrCard",
           "cssParts": [
             {
@@ -2404,7 +2404,7 @@
       "declarations": [
         {
           "kind": "class",
-          "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).",
+          "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).",
           "name": "Carousel",
           "cssParts": [
             {
@@ -3498,7 +3498,7 @@
               "type": {
                 "text": "EventEmitter<CarouselPageChangeDetail>"
               },
-              "description": "Evento canônico emitido quando o slide ativo muda."
+              "description": "Evento emitido quando o slide ativo muda."
             },
             {
               "name": "brDidAutoPlayStart",
@@ -3512,7 +3512,7 @@
               "type": {
                 "text": "EventEmitter<void>"
               },
-              "description": "Evento canônico emitido quando a reprodução automática começa."
+              "description": "Evento emitido quando a reprodução automática começa."
             },
             {
               "name": "brDidAutoPlayPause",
@@ -3526,7 +3526,7 @@
               "type": {
                 "text": "EventEmitter<void>"
               },
-              "description": "Evento canônico emitido quando a reprodução automática é pausada."
+              "description": "Evento emitido quando a reprodução automática é pausada."
             }
           ],
           "customElement": true,
@@ -3562,7 +3562,7 @@
       "declarations": [
         {
           "kind": "class",
-          "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).",
+          "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.",
           "name": "CarouselPage",
           "cssParts": [
             {
@@ -3749,7 +3749,7 @@
       "declarations": [
         {
           "kind": "class",
-          "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).",
+          "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).",
           "name": "Checkbox",
           "cssParts": [
             {
@@ -4015,7 +4015,7 @@
                 "text": "'valid' | 'invalid' | undefined"
               },
               "readonly": true,
-              "description": "Estado de feedback canônico. Quando informado, tem precedência sobre `state`.",
+              "description": "Estado de feedback. Quando informado, tem precedência sobre `state`.",
               "parsedType": {
                 "text": "'valid' | 'invalid'"
               }
@@ -4429,7 +4429,7 @@
             {
               "name": "feedback-state",
               "fieldName": "feedbackState",
-              "description": "Estado de feedback canônico. Quando informado, tem precedência sobre `state`.",
+              "description": "Estado de feedback. Quando informado, tem precedência sobre `state`.",
               "type": {
                 "text": "'valid' | 'invalid'"
               },
@@ -4535,7 +4535,7 @@
       "declarations": [
         {
           "kind": "class",
-          "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).",
+          "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).",
           "name": "CheckboxGroup",
           "slots": [
             {
@@ -5018,7 +5018,7 @@
       "declarations": [
         {
           "kind": "class",
-          "description": "O 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).",
+          "description": "Nome antigo do `br-checkbox-group`, mantido para compatibilidade. Em código novo, use `br-checkbox-group`.",
           "name": "Checkgroup",
           "slots": [
             {
@@ -5235,7 +5235,7 @@
       "declarations": [
         {
           "kind": "class",
-          "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).",
+          "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).",
           "name": "Collapse",
           "cssParts": [
             {
@@ -5663,7 +5663,7 @@
               "type": {
                 "text": "EventEmitter<CollapseChangeDetail>"
               },
-              "description": "Evento canônico emitido ao expandir."
+              "description": "Evento emitido ao expandir."
             },
             {
               "name": "brDidClose",
@@ -5678,7 +5678,7 @@
               "type": {
                 "text": "EventEmitter<CollapseChangeDetail>"
               },
-              "description": "Evento canônico emitido ao recolher."
+              "description": "Evento emitido ao recolher."
             }
           ],
           "customElement": true,
@@ -5714,7 +5714,7 @@
       "declarations": [
         {
           "kind": "class",
-          "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).",
+          "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).",
           "name": "Cookiebar",
           "cssParts": [
             {
@@ -6883,7 +6883,7 @@
       "declarations": [
         {
           "kind": "class",
-          "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.",
+          "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.",
           "name": "CookiebarCookie",
           "cssParts": [
             {
@@ -7408,7 +7408,7 @@
       "declarations": [
         {
           "kind": "class",
-          "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`.",
+          "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\".",
           "name": "CookiebarGroup",
           "cssParts": [
             {
@@ -7946,7 +7946,7 @@
       "declarations": [
         {
           "kind": "class",
-          "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.",
+          "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.",
           "name": "CookiebarHeader",
           "cssParts": [
             {
@@ -8136,7 +8136,7 @@
       "declarations": [
         {
           "kind": "class",
-          "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`.",
+          "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`.",
           "name": "CookiebarLink",
           "cssParts": [
             {
@@ -8338,7 +8338,7 @@
       "declarations": [
         {
           "kind": "class",
-          "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`.",
+          "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`.",
           "name": "CookiebarNote",
           "cssParts": [
             {
@@ -8467,7 +8467,7 @@
       "declarations": [
         {
           "kind": "class",
-          "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`.",
+          "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.",
           "name": "CookiebarNoteGroup",
           "cssParts": [
             {
@@ -8653,7 +8653,7 @@
       "declarations": [
         {
           "kind": "class",
-          "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).",
+          "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).",
           "name": "DatetimePicker",
           "cssParts": [
             {
@@ -9686,7 +9686,7 @@
               "kind": "method",
               "name": "syncCanonicalValues",
               "privacy": "private",
-              "description": "Atualiza os nomes canônicos sem emitir eventos adicionais ou criar ciclos de watchers."
+              "description": "Atualiza os nomes padrão sem emitir eventos adicionais ou criar ciclos de watchers."
             },
             {
               "kind": "method",
@@ -10300,7 +10300,7 @@
               "type": {
                 "text": "CustomEvent<DatetimePickerChangeDetail>"
               },
-              "description": "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."
+              "description": "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."
             },
             {
               "name": "valueChange",
@@ -10392,7 +10392,7 @@
       "declarations": [
         {
           "kind": "class",
-          "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).",
+          "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`.",
           "name": "DatePicker",
           "cssParts": [
             {
@@ -10564,6 +10564,12 @@
                     "text": "Date | null"
                   },
                   "description": "Novo valor recebido via prop."
+                },
+                {
+                  "name": "oldValue",
+                  "type": {
+                    "text": "Date | null"
+                  }
                 }
               ],
               "description": "Sincroniza `focusedDate` quando o valor selecionado muda externamente."
@@ -10784,7 +10790,7 @@
       "declarations": [
         {
           "kind": "class",
-          "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).",
+          "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`.",
           "name": "DatetimeInput",
           "cssParts": [
             {
@@ -11709,7 +11715,7 @@
       "declarations": [
         {
           "kind": "class",
-          "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).",
+          "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.",
           "name": "TimePicker",
           "cssParts": [
             {
@@ -11758,7 +11764,7 @@
                 "text": "Date | null"
               },
               "default": "null",
-              "description": "Valor canônico selecionado pelo usuário."
+              "description": "Valor selecionado pelo usuário."
             },
             {
               "kind": "field",
@@ -12213,7 +12219,7 @@
               "name": "value",
               "fieldName": "value",
               "default": "null",
-              "description": "Valor canônico selecionado pelo usuário.",
+              "description": "Valor selecionado pelo usuário.",
               "type": {
                 "text": "Date | null"
               }
@@ -12288,7 +12294,7 @@
       "declarations": [
         {
           "kind": "class",
-          "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).",
+          "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).",
           "name": "Divider",
           "cssParts": [
             {
@@ -12383,7 +12389,7 @@
               "type": {
                 "text": "'light' | 'dark' | undefined"
               },
-              "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`.",
               "parsedType": {
                 "text": "'dark' | 'light'"
               }
@@ -12709,7 +12715,7 @@
             {
               "name": "color-mode",
               "fieldName": "colorMode",
-              "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`.",
               "type": {
                 "text": "'light' | 'dark'"
               },
@@ -12823,7 +12829,7 @@
       "declarations": [
         {
           "kind": "class",
-          "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).",
+          "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).",
           "name": "Dropdown",
           "cssParts": [
             {
@@ -13514,7 +13520,7 @@
               "type": {
                 "text": "EventEmitter<DropdownOpenChangeDetail>"
               },
-              "description": "Evento canônico emitido quando o estado aberto muda."
+              "description": "Evento emitido quando o estado aberto muda."
             }
           ],
           "customElement": true,
@@ -13550,7 +13556,7 @@
       "declarations": [
         {
           "kind": "class",
-          "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).",
+          "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).",
           "name": "Footer",
           "cssParts": [
             {
@@ -13628,7 +13634,7 @@
               "type": {
                 "text": "FooterTheme | undefined"
               },
-              "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`.",
               "parsedType": {
                 "text": "'dark' | 'light'"
               }
@@ -13769,7 +13775,7 @@
             {
               "name": "color-mode",
               "fieldName": "colorMode",
-              "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`.",
               "type": {
                 "text": "FooterTheme"
               },
@@ -13850,7 +13856,7 @@
       "declarations": [
         {
           "kind": "class",
-          "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.",
+          "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.",
           "name": "FooterCategory",
           "slots": [
             {
@@ -14017,7 +14023,7 @@
       "declarations": [
         {
           "kind": "class",
-          "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é.",
+          "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`.",
           "name": "FooterItem",
           "slots": [
             {
@@ -14170,7 +14176,7 @@
       "declarations": [
         {
           "kind": "class",
-          "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`.",
+          "description": "Informações legais do `br-footer`, como licença de uso e direitos autorais. Use no slot `legal`.",
           "name": "FooterLegal",
           "cssParts": [
             {
@@ -14269,7 +14275,7 @@
       "declarations": [
         {
           "kind": "class",
-          "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é.",
+          "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.",
           "name": "FooterLogo",
           "cssParts": [
             {
@@ -14590,7 +14596,7 @@
       "declarations": [
         {
           "kind": "class",
-          "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`.",
+          "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`.",
           "name": "FooterSocial",
           "slots": [
             {
@@ -14816,7 +14822,7 @@
       "declarations": [
         {
           "kind": "class",
-          "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).",
+          "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).",
           "name": "Header",
           "cssParts": [
             {
@@ -14865,6 +14871,10 @@
               "description": "Slot para botões de ação no cabeçalho.",
               "name": "functions"
             },
+            {
+              "description": "Botão que mostra o campo de busca em telas menores e no modo compacto.",
+              "name": "search-icon"
+            },
             {
               "description": "Slot para o campo de busca.",
               "name": "search"
@@ -14999,7 +15009,7 @@
               "type": {
                 "text": "boolean | undefined"
               },
-              "description": "Estado compacto canônico. Quando informado, tem precedência sobre `isCompact`.",
+              "description": "Estado compacto. Quando informado, tem precedência sobre `isCompact`.",
               "parsedType": {
                 "text": "boolean"
               }
@@ -15750,7 +15760,7 @@
             {
               "name": "compact",
               "fieldName": "compact",
-              "description": "Estado compacto canônico. Quando informado, tem precedência sobre `isCompact`.",
+              "description": "Estado compacto. Quando informado, tem precedência sobre `isCompact`.",
               "type": {
                 "text": "boolean"
               }
@@ -15878,7 +15888,7 @@
               "type": {
                 "text": "EventEmitter<HeaderCompactChangeDetail>"
               },
-              "description": "Evento canônico emitido quando o modo compacto muda."
+              "description": "Evento emitido quando o modo compacto muda."
             },
             {
               "name": "headerWidthChange",
@@ -15936,7 +15946,7 @@
       "declarations": [
         {
           "kind": "class",
-          "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`).",
+          "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.",
           "name": "HeaderFunction",
           "slots": [
             {
@@ -16240,7 +16250,7 @@
       "declarations": [
         {
           "kind": "class",
-          "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.",
+          "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`.",
           "name": "HeaderLink",
           "slots": [
             {
@@ -16448,7 +16458,7 @@
       "declarations": [
         {
           "kind": "class",
-          "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`.",
+          "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`.",
           "name": "HeaderList",
           "slots": [
             {
@@ -16807,7 +16817,7 @@
       "declarations": [
         {
           "kind": "class",
-          "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.",
+          "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`.",
           "name": "HeaderLogo",
           "cssParts": [
             {
@@ -17186,7 +17196,7 @@
       "declarations": [
         {
           "kind": "class",
-          "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).",
+          "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).",
           "name": "Icon",
           "cssParts": [
             {
@@ -17813,7 +17823,7 @@
       "declarations": [
         {
           "kind": "class",
-          "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).",
+          "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).",
           "name": "Input",
           "cssParts": [
             {
@@ -17844,6 +17854,10 @@
               "description": "Botão interno reexportado do br-button da ação.",
               "name": "action-button"
             },
+            {
+              "description": "Botão de limpar exibido com `clearable` enquanto há texto editável.",
+              "name": "clear"
+            },
             {
               "description": "Texto de ajuda ou slot de ajuda.",
               "name": "help-text"
@@ -18109,7 +18123,7 @@
                 "text": "InputState | undefined"
               },
               "readonly": true,
-              "description": "Estado de feedback canônico. Quando informado, tem precedência sobre `state`.",
+              "description": "Estado de feedback. Quando informado, tem precedência sobre `state`.",
               "parsedType": {
                 "text": "'info' | 'warning' | 'danger' | 'success'"
               }
@@ -18381,6 +18395,16 @@
                 "text": "number"
               }
             },
+            {
+              "kind": "field",
+              "name": "clearable",
+              "type": {
+                "text": "boolean"
+              },
+              "readonly": true,
+              "default": "false",
+              "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`."
+            },
             {
               "kind": "method",
               "name": "handleValueChange",
@@ -18990,6 +19014,40 @@
                 }
               }
             },
+            {
+              "kind": "method",
+              "name": "isClearButtonVisible",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "boolean"
+                }
+              }
+            },
+            {
+              "kind": "field",
+              "name": "keepInputFocus",
+              "privacy": "private",
+              "readonly": true,
+              "description": "Mantém o foco no campo ao clicar no botão de limpar, como o \"x\" de um campo de busca nativo."
+            },
+            {
+              "kind": "field",
+              "name": "handleClearClick",
+              "privacy": "private",
+              "readonly": true
+            },
+            {
+              "kind": "method",
+              "name": "renderClearButton",
+              "privacy": "private",
+              "description": "Renderiza o botão de limpar quando `clearable` está ativo e há texto editável.",
+              "return": {
+                "type": {
+                  "text": ""
+                }
+              }
+            },
             {
               "kind": "field",
               "name": "handleActionClick",
@@ -19211,7 +19269,7 @@
             {
               "name": "feedback-state",
               "fieldName": "feedbackState",
-              "description": "Estado de feedback canônico. Quando informado, tem precedência sobre `state`.",
+              "description": "Estado de feedback. Quando informado, tem precedência sobre `state`.",
               "type": {
                 "text": "InputState"
               },
@@ -19415,6 +19473,15 @@
               "type": {
                 "text": "number"
               }
+            },
+            {
+              "name": "clearable",
+              "fieldName": "clearable",
+              "default": "false",
+              "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`.",
+              "type": {
+                "text": "boolean"
+              }
             }
           ],
           "tagName": "br-input",
@@ -19448,6 +19515,10 @@
               "name": "action-button",
               "description": "Botão interno reexportado do br-button da ação."
             },
+            {
+              "name": "clear",
+              "description": "Botão de limpar exibido com `clearable` enquanto há texto editável."
+            },
             {
               "name": "help-text",
               "description": "Texto de ajuda ou slot de ajuda."
@@ -19471,7 +19542,7 @@
               "type": {
                 "text": "EventEmitter<void>"
               },
-              "description": "Emitted when the input clear button action is triggered."
+              "description": "Emitido quando o usuário aciona o botão de limpar (`clearable`), depois que o\nvalor foi limpo e o evento `input` foi disparado."
             },
             {
               "name": "brInputActionClick",
@@ -19526,7 +19597,7 @@
       "declarations": [
         {
           "kind": "class",
-          "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).",
+          "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).",
           "name": "Item",
           "cssParts": [
             {
@@ -19634,7 +19705,7 @@
               "type": {
                 "text": "boolean | undefined"
               },
-              "description": "Estado ativo canônico. Quando informado, tem precedência sobre `isActive`.",
+              "description": "Estado ativo atual. Quando informado, tem precedência sobre `isActive`.",
               "parsedType": {
                 "text": "boolean"
               }
@@ -19655,7 +19726,7 @@
               "type": {
                 "text": "boolean | undefined"
               },
-              "description": "Estado selecionado canônico. Em itens interativos, também é atualizado pelo acionamento.",
+              "description": "Estado selecionado. Em itens interativos, também é atualizado pelo acionamento.",
               "parsedType": {
                 "text": "boolean"
               }
@@ -20133,7 +20204,7 @@
             {
               "name": "active",
               "fieldName": "active",
-              "description": "Estado ativo canônico. Quando informado, tem precedência sobre `isActive`.",
+              "description": "Estado ativo atual. Quando informado, tem precedência sobre `isActive`.",
               "type": {
                 "text": "boolean"
               }
@@ -20147,7 +20218,7 @@
             {
               "name": "selected",
               "fieldName": "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.",
               "type": {
                 "text": "boolean"
               }
@@ -20263,7 +20334,7 @@
               "type": {
                 "text": "EventEmitter<void>"
               },
-              "description": "Evento canônico emitido quando o item com comportamento de botão é acionado."
+              "description": "Evento emitido quando o item com comportamento de botão é acionado."
             },
             {
               "name": "brDidSelect",
@@ -20278,7 +20349,7 @@
               "type": {
                 "text": "EventEmitter<ItemSelectDetail>"
               },
-              "description": "Evento canônico emitido quando a seleção muda."
+              "description": "Evento emitido quando a seleção muda."
             },
             {
               "name": "brNavigate",
@@ -20327,7 +20398,7 @@
       "declarations": [
         {
           "kind": "class",
-          "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).",
+          "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).",
           "name": "Link",
           "cssParts": [
             {
@@ -20510,7 +20581,7 @@
               },
               "readonly": true,
               "default": "null",
-              "description": "Valor canônico de `aria-expanded`.",
+              "description": "Valor de `aria-expanded`.",
               "parsedType": {
                 "text": "string"
               }
@@ -20536,7 +20607,7 @@
               },
               "readonly": true,
               "default": "null",
-              "description": "Valor canônico de `aria-selected`.",
+              "description": "Valor de `aria-selected`.",
               "parsedType": {
                 "text": "string"
               }
@@ -20562,7 +20633,7 @@
               },
               "readonly": true,
               "default": "null",
-              "description": "Valor canônico de `aria-haspopup`.",
+              "description": "Valor de `aria-haspopup`.",
               "parsedType": {
                 "text": "string"
               }
@@ -20588,7 +20659,7 @@
               },
               "readonly": true,
               "default": "null",
-              "description": "Valor canônico de `aria-current`.",
+              "description": "Valor de `aria-current`.",
               "parsedType": {
                 "text": "string"
               }
@@ -20614,7 +20685,7 @@
               },
               "readonly": true,
               "default": "null",
-              "description": "Valor canônico de `aria-label`.",
+              "description": "Valor de `aria-label`.",
               "parsedType": {
                 "text": "string"
               }
@@ -20640,7 +20711,7 @@
               },
               "readonly": true,
               "default": "null",
-              "description": "Valor canônico de `aria-describedby`.",
+              "description": "Valor de `aria-describedby`.",
               "parsedType": {
                 "text": "string"
               }
@@ -20828,7 +20899,7 @@
               "name": "aria-expanded",
               "fieldName": "ariaExpanded",
               "default": "null",
-              "description": "Valor canônico de `aria-expanded`.",
+              "description": "Valor de `aria-expanded`.",
               "type": {
                 "text": "string | null"
               },
@@ -20848,7 +20919,7 @@
               "name": "aria-selected",
               "fieldName": "ariaSelected",
               "default": "null",
-              "description": "Valor canônico de `aria-selected`.",
+              "description": "Valor de `aria-selected`.",
               "type": {
                 "text": "string | null"
               },
@@ -20868,7 +20939,7 @@
               "name": "aria-haspopup",
               "fieldName": "ariaHasPopup",
               "default": "null",
-              "description": "Valor canônico de `aria-haspopup`.",
+              "description": "Valor de `aria-haspopup`.",
               "type": {
                 "text": "string | null"
               },
@@ -20888,7 +20959,7 @@
               "name": "aria-current",
               "fieldName": "ariaCurrent",
               "default": "null",
-              "description": "Valor canônico de `aria-current`.",
+              "description": "Valor de `aria-current`.",
               "type": {
                 "text": "string | null"
               },
@@ -20908,7 +20979,7 @@
               "name": "aria-label",
               "fieldName": "ariaLabel",
               "default": "null",
-              "description": "Valor canônico de `aria-label`.",
+              "description": "Valor de `aria-label`.",
               "type": {
                 "text": "string | null"
               },
@@ -20928,7 +20999,7 @@
               "name": "aria-describedby",
               "fieldName": "ariaDescribedBy",
               "default": "null",
-              "description": "Valor canônico de `aria-describedby`.",
+              "description": "Valor de `aria-describedby`.",
               "type": {
                 "text": "string | null"
               },
@@ -20992,7 +21063,7 @@
       "declarations": [
         {
           "kind": "class",
-          "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).",
+          "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).",
           "name": "List",
           "cssParts": [
             {
@@ -21044,7 +21115,7 @@
               "type": {
                 "text": "'horizontal' | 'vertical' | undefined"
               },
-              "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`.",
               "parsedType": {
                 "text": "'horizontal' | 'vertical'"
               }
@@ -21534,7 +21605,7 @@
             {
               "name": "orientation",
               "fieldName": "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`.",
               "type": {
                 "text": "'horizontal' | 'vertical'"
               },
@@ -21646,7 +21717,7 @@
       "declarations": [
         {
           "kind": "class",
-          "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).",
+          "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).",
           "name": "Loading",
           "cssParts": [
             {
@@ -21757,7 +21828,7 @@
               "type": {
                 "text": "LoadingSize | undefined"
               },
-              "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`.",
               "parsedType": {
                 "text": "'small' | 'medium' | 'large'"
               }
@@ -22358,7 +22429,7 @@
             {
               "name": "density",
               "fieldName": "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`.",
               "type": {
                 "text": "LoadingSize"
               },
@@ -22503,7 +22574,7 @@
               "type": {
                 "text": "EventEmitter<void>"
               },
-              "description": "Evento canônico emitido quando o loading é exibido."
+              "description": "Evento emitido quando o loading é exibido."
             },
             {
               "name": "brDidHide",
@@ -22517,7 +22588,7 @@
               "type": {
                 "text": "EventEmitter<void>"
               },
-              "description": "Evento canônico emitido quando o loading é ocultado."
+              "description": "Evento emitido quando o loading é ocultado."
             }
           ],
           "customElement": true,
@@ -22553,7 +22624,7 @@
       "declarations": [
         {
           "kind": "class",
-          "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).",
+          "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=\"fa6-solid:plus\" aria-label=\"Novo item\"></br-magic-button>\n<br-magic-button icon=\"fa6-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).",
           "name": "MagicButton",
           "cssParts": [
             {
@@ -22787,7 +22858,7 @@
       "declarations": [
         {
           "kind": "class",
-          "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).",
+          "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).",
           "name": "Menu",
           "cssParts": [
             {
@@ -23771,7 +23842,7 @@
               "type": {
                 "text": "EventEmitter<MenuOpenChangeDetail>"
               },
-              "description": "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`."
+              "description": "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`."
             }
           ],
           "customElement": true,
@@ -23807,7 +23878,7 @@
       "declarations": [
         {
           "kind": "class",
-          "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`.",
+          "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.",
           "name": "MenuGroup",
           "cssParts": [
             {
@@ -23926,7 +23997,7 @@
       "declarations": [
         {
           "kind": "class",
-          "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.",
+          "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.",
           "name": "MenuHeader",
           "cssParts": [
             {
@@ -24124,7 +24195,7 @@
       "declarations": [
         {
           "kind": "class",
-          "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`.",
+          "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`.",
           "name": "MenuInfo",
           "slots": [
             {
@@ -24225,7 +24296,7 @@
       "declarations": [
         {
           "kind": "class",
-          "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.",
+          "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.",
           "name": "MenuItem",
           "cssParts": [
             {
@@ -24522,7 +24593,7 @@
       "declarations": [
         {
           "kind": "class",
-          "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`.",
+          "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\"`.",
           "name": "MenuLink",
           "cssParts": [
             {
@@ -24628,7 +24699,7 @@
               "type": {
                 "text": "string | undefined"
               },
-              "description": "Texto canônico do link. Quando informado, tem precedência sobre `titulo`.",
+              "description": "Texto do link. Quando informado, tem precedência sobre `titulo`.",
               "parsedType": {
                 "text": "string"
               }
@@ -24695,7 +24766,7 @@
             {
               "name": "label",
               "fieldName": "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`.",
               "type": {
                 "text": "string"
               }
@@ -24720,7 +24791,7 @@
               "type": {
                 "text": "EventEmitter<void>"
               },
-              "description": "Evento canônico emitido quando o link externo é clicado."
+              "description": "Evento emitido quando o link externo é clicado."
             },
             {
               "name": "brNavigate",
@@ -24761,7 +24832,7 @@
       "declarations": [
         {
           "kind": "class",
-          "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`.",
+          "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.",
           "name": "MenuList",
           "cssParts": [
             {
@@ -25081,7 +25152,7 @@
       "declarations": [
         {
           "kind": "class",
-          "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`.",
+          "description": "Exibe o logotipo institucional no interior do `br-menu`. Use no cabeçalho ou rodapé do menu.",
           "name": "MenuLogo",
           "cssParts": [
             {
@@ -25326,7 +25397,7 @@
       "declarations": [
         {
           "kind": "class",
-          "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`.",
+          "description": "Bloco de canais e redes sociais institucionais dentro do `br-menu`. Use no slot `social` ou rodapé do menu.",
           "name": "MenuSocial",
           "slots": [
             {
@@ -25506,7 +25577,7 @@
               "type": {
                 "text": "EventEmitter<void>"
               },
-              "description": "Evento canônico emitido quando o link de rede social é clicado."
+              "description": "Evento emitido quando o link de rede social é clicado."
             },
             {
               "name": "brNavigate",
@@ -25547,7 +25618,7 @@
       "declarations": [
         {
           "kind": "class",
-          "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).",
+          "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).",
           "name": "Message",
           "cssParts": [
             {
@@ -25721,7 +25792,7 @@
               "type": {
                 "text": "BrFeedbackState | undefined"
               },
-              "description": "Estado de feedback canônico. Quando informado, tem precedência sobre `state`.",
+              "description": "Estado de feedback. Quando informado, tem precedência sobre `state`.",
               "parsedType": {
                 "text": "'info' | 'warning' | 'danger' | 'success'"
               }
@@ -25927,7 +25998,7 @@
             {
               "name": "feedback-state",
               "fieldName": "feedbackState",
-              "description": "Estado de feedback canônico. Quando informado, tem precedência sobre `state`.",
+              "description": "Estado de feedback. Quando informado, tem precedência sobre `state`.",
               "type": {
                 "text": "BrFeedbackState"
               },
@@ -25978,7 +26049,7 @@
               "type": {
                 "text": "EventEmitter<void>"
               },
-              "description": "Evento canônico emitido quando a mensagem é fechada."
+              "description": "Evento emitido quando a mensagem é fechada."
             }
           ],
           "customElement": true,
@@ -26014,7 +26085,7 @@
       "declarations": [
         {
           "kind": "class",
-          "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).",
+          "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).",
           "name": "Modal",
           "cssParts": [
             {
@@ -26638,7 +26709,7 @@
       "declarations": [
         {
           "kind": "class",
-          "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).",
+          "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).",
           "name": "Notification",
           "cssParts": [
             {
@@ -27259,7 +27330,7 @@
       "declarations": [
         {
           "kind": "class",
-          "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).",
+          "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.",
           "name": "NotificationBody",
           "slots": [
             {
@@ -27409,13 +27480,9 @@
       "declarations": [
         {
           "kind": "class",
-          "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).",
+          "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.",
           "name": "NotificationHeader",
           "slots": [
-            {
-              "description": "Área para avatar ou elemento visual do usuário.",
-              "name": "avatar"
-            },
             {
               "description": "Conteúdo customizado do título.",
               "name": "title"
@@ -27585,21 +27652,9 @@
       "declarations": [
         {
           "kind": "class",
-          "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).",
+          "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.",
           "name": "NotificationItem",
           "slots": [
-            {
-              "description": "Região para tag, badge ou marcador visual de status.",
-              "name": "status"
-            },
-            {
-              "description": "Conteúdo customizado do título.",
-              "name": "title"
-            },
-            {
-              "description": "Região para informação cronológica ou metadados.",
-              "name": "meta"
-            },
             {
               "description": "Conteúdo principal da notificação.",
               "name": "default"
@@ -27851,7 +27906,7 @@
       "declarations": [
         {
           "kind": "class",
-          "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).",
+          "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).",
           "name": "Pagination",
           "cssParts": [
             {
@@ -29416,7 +29471,7 @@
               "type": {
                 "text": "EventEmitter<PaginationPageChangeDetail>"
               },
-              "description": "Evento canônico para iniciar o carregamento de uma página.\nO `detail` contém `{ page }`; o evento não é cancelável."
+              "description": "Evento para iniciar o carregamento de uma página.\nO `detail` contém `{ page }`; o evento não é cancelável."
             },
             {
               "name": "perPageChange",
@@ -29430,7 +29485,7 @@
               "type": {
                 "text": "EventEmitter<PaginationPerPageChangeDetail>"
               },
-              "description": "Evento canônico para iniciar o carregamento de uma nova quantidade de\nitens. O `detail` contém `{ perPage }`; o evento não é cancelável."
+              "description": "Evento para iniciar o carregamento de uma nova quantidade de\nitens. O `detail` contém `{ perPage }`; o evento não é cancelável."
             }
           ],
           "customElement": true,
@@ -29473,7 +29528,7 @@
       "declarations": [
         {
           "kind": "class",
-          "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).",
+          "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).",
           "name": "Radio",
           "cssParts": [
             {
@@ -29713,7 +29768,7 @@
                 "text": "'valid' | 'invalid' | undefined"
               },
               "readonly": true,
-              "description": "Estado de feedback canônico. Quando informado, tem precedência sobre `state`.",
+              "description": "Estado de feedback. Quando informado, tem precedência sobre `state`.",
               "parsedType": {
                 "text": "'valid' | 'invalid'"
               }
@@ -30154,7 +30209,7 @@
             {
               "name": "feedback-state",
               "fieldName": "feedbackState",
-              "description": "Estado de feedback canônico. Quando informado, tem precedência sobre `state`.",
+              "description": "Estado de feedback. Quando informado, tem precedência sobre `state`.",
               "type": {
                 "text": "'valid' | 'invalid'"
               },
@@ -30285,7 +30340,7 @@
       "declarations": [
         {
           "kind": "class",
-          "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).",
+          "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).",
           "name": "RadioGroup",
           "cssParts": [
             {
@@ -31251,7 +31306,7 @@
       "declarations": [
         {
           "kind": "class",
-          "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).",
+          "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).",
           "name": "Scrim",
           "slots": [
             {
@@ -32724,7 +32779,7 @@
       "declarations": [
         {
           "kind": "class",
-          "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).",
+          "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).",
           "name": "Select",
           "cssParts": [
             {
@@ -32763,6 +32818,10 @@
               "description": "Botão interno da ação.",
               "name": "input-action-button"
             },
+            {
+              "description": "Botão de limpar o termo digitado durante a busca.",
+              "name": "input-clear"
+            },
             {
               "description": "Lista de opções.",
               "name": "list"
@@ -32818,7 +32877,7 @@
               "name": "validation-loading"
             },
             {
-              "description": "Indicador exibido durante a busca remota de opções.",
+              "description": "Indicador exibido na lista enquanto `loading` está ativo. Padrão: spinner com o texto \"Pesquisando…\"; aceita texto, imagem ou qualquer HTML.",
               "name": "loading"
             }
           ],
@@ -33163,11 +33222,21 @@
                 "text": "SelectSearchMode"
               },
               "default": "'local'",
-              "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.",
               "parsedType": {
                 "text": "'local' | 'remote'"
               }
             },
+            {
+              "kind": "field",
+              "name": "listSearchTerm",
+              "type": {
+                "text": "string"
+              },
+              "privacy": "private",
+              "description": "Termo repassado à lista. Ela só filtra no modo local; no remoto, usa o termo\napenas para exibir a mensagem de lista vazia.",
+              "readonly": true
+            },
             {
               "kind": "field",
               "name": "effectiveSearchMode",
@@ -33187,7 +33256,7 @@
                 "text": "boolean"
               },
               "default": "false",
-              "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."
             },
             {
               "kind": "field",
@@ -33196,7 +33265,16 @@
                 "text": "boolean"
               },
               "default": "false",
-              "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."
+            },
+            {
+              "kind": "field",
+              "name": "hideSearchIcon",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "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."
             },
             {
               "kind": "field",
@@ -35256,7 +35334,7 @@
               "name": "search-mode",
               "fieldName": "searchMode",
               "default": "'local'",
-              "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.",
               "type": {
                 "text": "SelectSearchMode"
               },
@@ -35268,7 +35346,7 @@
               "name": "loading",
               "fieldName": "loading",
               "default": "false",
-              "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.",
               "type": {
                 "text": "boolean"
               }
@@ -35277,7 +35355,16 @@
               "name": "show-search-icon",
               "fieldName": "showSearchIcon",
               "default": "false",
-              "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.",
+              "type": {
+                "text": "boolean"
+              }
+            },
+            {
+              "name": "hide-search-icon",
+              "fieldName": "hideSearchIcon",
+              "default": "false",
+              "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.",
               "type": {
                 "text": "boolean"
               }
@@ -35391,6 +35478,10 @@
               "name": "input-action-button",
               "description": "Botão interno da ação."
             },
+            {
+              "name": "input-clear",
+              "description": "Botão de limpar o termo digitado durante a busca."
+            },
             {
               "name": "list",
               "description": "Lista de opções."
@@ -35530,7 +35621,7 @@
       "declarations": [
         {
           "kind": "class",
-          "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).",
+          "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.",
           "name": "SelectInput",
           "cssParts": [
             {
@@ -35560,6 +35651,10 @@
             {
               "description": "Botão interno da ação.",
               "name": "action-button"
+            },
+            {
+              "description": "Botão de limpar o texto digitado.",
+              "name": "clear"
             }
           ],
           "members": [
@@ -35697,11 +35792,20 @@
               "type": {
                 "text": "boolean | undefined"
               },
-              "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.",
               "parsedType": {
                 "text": "boolean"
               }
             },
+            {
+              "kind": "field",
+              "name": "clearable",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "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."
+            },
             {
               "kind": "field",
               "name": "value",
@@ -35990,7 +36094,16 @@
             {
               "name": "show-search-icon",
               "fieldName": "showSearchIcon",
-              "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.",
+              "type": {
+                "text": "boolean"
+              }
+            },
+            {
+              "name": "clearable",
+              "fieldName": "clearable",
+              "default": "false",
+              "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.",
               "type": {
                 "text": "boolean"
               }
@@ -36034,6 +36147,10 @@
             {
               "name": "action-button",
               "description": "Botão interno da ação."
+            },
+            {
+              "name": "clear",
+              "description": "Botão de limpar o texto digitado."
             }
           ],
           "events": [
@@ -36099,7 +36216,7 @@
       "declarations": [
         {
           "kind": "class",
-          "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).",
+          "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.",
           "name": "SelectList",
           "cssParts": [
             {
@@ -36117,7 +36234,7 @@
           ],
           "slots": [
             {
-              "description": "Indicador exibido enquanto resultados remotos são carregados.",
+              "description": "Indicador exibido enquanto resultados remotos são carregados. Padrão: spinner com o texto \"Pesquisando…\".",
               "name": "loading"
             }
           ],
@@ -36212,6 +36329,30 @@
               "default": "''",
               "description": "Termo usado para filtrar opções por rótulo ou valor."
             },
+            {
+              "kind": "field",
+              "name": "searchMode",
+              "type": {
+                "text": "SelectSearchMode"
+              },
+              "default": "'local'",
+              "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`.",
+              "parsedType": {
+                "text": "'local' | 'remote'"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "effectiveSearchMode",
+              "type": {
+                "text": "SelectSearchMode"
+              },
+              "privacy": "private",
+              "readonly": true,
+              "parsedType": {
+                "text": "'local' | 'remote'"
+              }
+            },
             {
               "kind": "field",
               "name": "loading",
@@ -37242,6 +37383,18 @@
                 "text": "string"
               }
             },
+            {
+              "name": "search-mode",
+              "fieldName": "searchMode",
+              "default": "'local'",
+              "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`.",
+              "type": {
+                "text": "SelectSearchMode"
+              },
+              "parsedType": {
+                "text": "'local' | 'remote'"
+              }
+            },
             {
               "name": "loading",
               "fieldName": "loading",
@@ -37365,7 +37518,7 @@
       "declarations": [
         {
           "kind": "class",
-          "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).",
+          "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```",
           "name": "SelectOption",
           "cssParts": [
             {
@@ -37891,7 +38044,7 @@
       "declarations": [
         {
           "kind": "class",
-          "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).",
+          "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).",
           "name": "SignIn",
           "cssParts": [
             {
@@ -38306,7 +38459,7 @@
       "declarations": [
         {
           "kind": "class",
-          "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).",
+          "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).",
           "name": "SkipLink",
           "cssParts": [
             {
@@ -38763,7 +38916,7 @@
               "type": {
                 "text": "EventEmitter<SkipLinkNavigateDetail>"
               },
-              "description": "Evento canônico emitido quando um destino é ativado."
+              "description": "Evento emitido quando um destino é ativado."
             },
             {
               "name": "brDidShow",
@@ -38778,7 +38931,7 @@
               "type": {
                 "text": "EventEmitter<void>"
               },
-              "description": "Evento canônico emitido ao exibir o componente."
+              "description": "Evento emitido ao exibir o componente."
             },
             {
               "name": "brDidHide",
@@ -38793,7 +38946,7 @@
               "type": {
                 "text": "EventEmitter<void>"
               },
-              "description": "Evento canônico emitido ao ocultar o componente."
+              "description": "Evento emitido ao ocultar o componente."
             }
           ],
           "customElement": true,
@@ -38828,7 +38981,7 @@
       "declarations": [
         {
           "kind": "class",
-          "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.",
+          "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```",
           "name": "SkipLinkItemAlias",
           "slots": [
             {
@@ -38990,7 +39143,7 @@
       "declarations": [
         {
           "kind": "class",
-          "description": "Subcomponente 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).",
+          "description": "Item 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.",
           "name": "SkipLinkItem",
           "slots": [
             {
@@ -39220,7 +39373,7 @@
               "type": {
                 "text": "EventEmitter<SkipLinkNavigateDetail>"
               },
-              "description": "Evento canônico emitido quando o item é ativado."
+              "description": "Evento emitido quando o item é ativado."
             },
             {
               "name": "brSkiplinkItemFocus",
@@ -39235,7 +39388,7 @@
               "type": {
                 "text": "EventEmitter<SkipLinkItemFocusDetail>"
               },
-              "description": "Evento canônico emitido quando o item recebe foco."
+              "description": "Evento emitido quando o item recebe foco."
             }
           ],
           "customElement": true,
@@ -39268,7 +39421,7 @@
       "declarations": [
         {
           "kind": "class",
-          "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).",
+          "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).",
           "name": "Slider",
           "cssParts": [
             {
@@ -39663,7 +39816,7 @@
                 "text": "'horizontal' | 'vertical' | undefined"
               },
               "readonly": true,
-              "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`.",
               "parsedType": {
                 "text": "'horizontal' | 'vertical'"
               }
@@ -40933,7 +41086,7 @@
             {
               "name": "orientation",
               "fieldName": "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`.",
               "type": {
                 "text": "'horizontal' | 'vertical'"
               },
@@ -41208,7 +41361,7 @@
       "declarations": [
         {
           "kind": "class",
-          "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).",
+          "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).",
           "name": "Step",
           "cssParts": [
             {
@@ -41929,7 +42082,7 @@
       "declarations": [
         {
           "kind": "class",
-          "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).",
+          "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.",
           "name": "StepItem",
           "cssParts": [
             {
@@ -42452,7 +42605,7 @@
       "declarations": [
         {
           "kind": "class",
-          "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).",
+          "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).",
           "name": "Switch",
           "cssParts": [
             {
@@ -43127,7 +43280,7 @@
       "declarations": [
         {
           "kind": "class",
-          "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).",
+          "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).",
           "name": "Tab",
           "cssParts": [
             {
@@ -43248,7 +43401,7 @@
               "type": {
                 "text": "TabAlignItems | undefined"
               },
-              "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`.",
               "parsedType": {
                 "text": "'start' | 'center' | 'end'"
               }
@@ -43688,7 +43841,7 @@
             {
               "name": "alignment",
               "fieldName": "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`.",
               "type": {
                 "text": "TabAlignItems"
               },
@@ -43792,7 +43945,7 @@
       "declarations": [
         {
           "kind": "class",
-          "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).",
+          "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.",
           "name": "TabItem",
           "slots": [
             {
@@ -43843,7 +43996,7 @@
               "type": {
                 "text": "string | undefined"
               },
-              "description": "Texto canônico do item. Quando informado, tem precedência sobre `tabItemTitle`.",
+              "description": "Texto do item. Quando informado, tem precedência sobre `tabItemTitle`.",
               "parsedType": {
                 "text": "string"
               }
@@ -43893,7 +44046,7 @@
               "type": {
                 "text": "boolean | undefined"
               },
-              "description": "Estado ativo canônico. Quando informado, tem precedência sobre `isActive`.",
+              "description": "Estado ativo atual. Quando informado, tem precedência sobre `isActive`.",
               "parsedType": {
                 "text": "boolean"
               }
@@ -44062,7 +44215,7 @@
             {
               "name": "label",
               "fieldName": "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`.",
               "type": {
                 "text": "string"
               }
@@ -44098,7 +44251,7 @@
             {
               "name": "active",
               "fieldName": "active",
-              "description": "Estado ativo canônico. Quando informado, tem precedência sobre `isActive`.",
+              "description": "Estado ativo atual. Quando informado, tem precedência sobre `isActive`.",
               "type": {
                 "text": "boolean"
               }
@@ -44164,7 +44317,7 @@
       "declarations": [
         {
           "kind": "class",
-          "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).",
+          "description": "O `br-table` estrutura e exibe conjuntos de dados organizados em linhas e colunas.\n\nEstruture a tabela usando os subcomponentes `br-table-header`, `br-table-body`, `br-table-row` e `br-table-cell`. Para exibir um indicador de carregamento durante atualizações assíncronas, use a propriedade `loading`.\n\n```html\n<br-table>\n  <br-table-header slot=\"header\">\n    <br-table-row>\n      <br-table-header-cell>Nome</br-table-header-cell>\n      <br-table-header-cell>Cargo</br-table-header-cell>\n    </br-table-row>\n  </br-table-header>\n  <br-table-body slot=\"body\">\n    <br-table-row>\n      <br-table-cell>Maria Silva</br-table-cell>\n      <br-table-cell>Analista</br-table-cell>\n    </br-table-row>\n  </br-table-body>\n</br-table>\n```\n\n### Quando usar\n\n- Dados bidimensionais com cabeçalhos de coluna e necessidades de ordenação ou comparação.\n\n### Quando evitar\n\n- Listas simples de itens lineares: use `br-list`.\n- Agrupamento de informações de um único registro: use `br-card`.\n\nConsulte as [diretrizes de design do GovBR](https://www.gov.br/ds/components/table?tab=designer).",
           "name": "Table",
           "cssParts": [
             {
@@ -45257,7 +45410,7 @@
       "declarations": [
         {
           "kind": "class",
-          "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).",
+          "description": "Corpo de dados (`<tbody>`) da tabela. Use no slot `body` do `br-table`.\n\nAgrupa as linhas `br-table-row` contendo as células de dados `br-table-cell`.",
           "name": "TableBody",
           "cssParts": [
             {
@@ -45333,7 +45486,7 @@
       "declarations": [
         {
           "kind": "class",
-          "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).",
+          "description": "Célula de dados (`<td>`) da tabela. Use dentro de um `br-table-row` no corpo da tabela.\n\nColoque o conteúdo do registro no slot padrão.",
           "name": "TableCell",
           "cssParts": [
             {
@@ -45670,7 +45823,7 @@
       "declarations": [
         {
           "kind": "class",
-          "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).",
+          "description": "Cabeçalho da tabela (`br-table`). Use no slot `header`.\n\nAgrupa as linhas `br-table-row` com as células de cabeçalho `br-table-header-cell`.",
           "name": "TableHeader",
           "cssParts": [
             {
@@ -45746,7 +45899,7 @@
       "declarations": [
         {
           "kind": "class",
-          "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).",
+          "description": "Célula de cabeçalho (`<th>`) da tabela. Use dentro de um `br-table-row` no cabeçalho.\n\nColoque o título da coluna no slot padrão. Para habilitar ordenação, ative `sortable`.",
           "name": "TableHeaderCell",
           "cssParts": [
             {
@@ -46115,7 +46268,7 @@
       "declarations": [
         {
           "kind": "class",
-          "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).",
+          "description": "Linha horizontal (`<tr>`) da tabela. Use dentro de `br-table-header` ou `br-table-body`.\n\nUse `selected` para indicar que a linha está selecionada.",
           "name": "TableRow",
           "cssParts": [
             {
@@ -46347,7 +46500,7 @@
       "declarations": [
         {
           "kind": "class",
-          "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).",
+          "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).",
           "name": "Tag",
           "cssParts": [
             {
@@ -46618,7 +46771,7 @@
               "type": {
                 "text": "TagVariant | undefined"
               },
-              "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.",
               "parsedType": {
                 "text": "'default' | 'status' | 'action' | 'selectable'"
               }
@@ -47269,7 +47422,7 @@
             {
               "name": "variant",
               "fieldName": "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.",
               "type": {
                 "text": "TagVariant"
               },
@@ -47413,7 +47566,7 @@
       "declarations": [
         {
           "kind": "class",
-          "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).",
+          "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).",
           "name": "Textarea",
           "cssParts": [
             {
@@ -47697,7 +47850,7 @@
                 "text": "'danger' | 'success' | 'warning' | undefined"
               },
               "readonly": true,
-              "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.",
               "parsedType": {
                 "text": "'warning' | 'danger' | 'success'"
               }
@@ -48355,7 +48508,7 @@
             {
               "name": "feedback-state",
               "fieldName": "feedbackState",
-              "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.",
               "type": {
                 "text": "'danger' | 'success' | 'warning'"
               },
@@ -48532,7 +48685,7 @@
       "declarations": [
         {
           "kind": "class",
-          "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).",
+          "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).",
           "name": "Tooltip",
           "cssParts": [
             {
@@ -49427,7 +49580,7 @@
       "declarations": [
         {
           "kind": "class",
-          "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).",
+          "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).",
           "name": "Upload",
           "cssParts": [
             {
@@ -49469,7 +49622,7 @@
           ],
           "slots": [
             {
-              "description": "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.",
+              "description": "Conteúdo personalizado do botão de upload, com precedência sobre `buttonLabel` (use a prop para texto simples).",
               "name": "default"
             },
             {
@@ -49707,6 +49860,17 @@
               "default": "'Envio de arquivo'",
               "description": "Rótulo exibido acima do botão de upload."
             },
+            {
+              "kind": "field",
+              "name": "buttonLabel",
+              "type": {
+                "text": "string | undefined"
+              },
+              "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.",
+              "parsedType": {
+                "text": "string"
+              }
+            },
             {
               "kind": "field",
               "name": "uploadFiles",
@@ -49769,7 +49933,7 @@
               "type": {
                 "text": "BrFeedbackState | undefined"
               },
-              "description": "Estado de feedback canônico. Quando informado, tem precedência sobre `state`.",
+              "description": "Estado de feedback. Quando informado, tem precedência sobre `state`.",
               "parsedType": {
                 "text": "'info' | 'warning' | 'danger' | 'success'"
               }
@@ -50366,6 +50530,14 @@
               "default": "'Envio de arquivo'",
               "description": "Rótulo exibido acima do botão de upload."
             },
+            {
+              "name": "button-label",
+              "fieldName": "buttonLabel",
+              "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.",
+              "type": {
+                "text": "string"
+              }
+            },
             {
               "name": "upload-files",
               "fieldName": "uploadFiles",
@@ -50418,7 +50590,7 @@
             {
               "name": "feedback-state",
               "fieldName": "feedbackState",
-              "description": "Estado de feedback canônico. Quando informado, tem precedência sobre `state`.",
+              "description": "Estado de feedback. Quando informado, tem precedência sobre `state`.",
               "type": {
                 "text": "BrFeedbackState"
               },
@@ -50556,7 +50728,7 @@
               "type": {
                 "text": "EventEmitter<IUploadFile>"
               },
-              "description": "Evento canônico emitido quando um arquivo existente é removido."
+              "description": "Evento emitido quando um arquivo existente é removido."
             },
             {
               "name": "brUploadCancel",
@@ -50634,7 +50806,7 @@
       "declarations": [
         {
           "kind": "class",
-          "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).",
+          "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).",
           "name": "Wizard",
           "cssParts": [
             {
@@ -51548,7 +51720,7 @@
       "declarations": [
         {
           "kind": "class",
-          "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).",
+          "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.",
           "name": "WizardPanel",
           "cssParts": [
             {