@govbr-ds/webcomponents 2.3.0 → 2.4.0

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

@@ -1020,21 +1020,21 @@
     },
     {
       "name": "br-datetime-picker",
-      "description": "O componente `br-datetime-picker` é o orquestrador completo do GovBR-DS para seleção e digitação de datas, horários ou intervalos combinados. Ele integra-se nativamente a formulários HTML via `formAssociated` e oferece suporte WAI-ARIA para diálogos e calendários.\n\n### Para que serve\n\n- **Seleção completa de data e horário:** Reúne em um único controle o campo de entrada com máscara formatada (`br-datetime-input`), o calendário de seleção de datas (`br-date-picker`) e o seletor de horários (`br-time-picker`).\n- **Múltiplos modos operacionais:** Suporta data simples, intervalo de datas (`range`), apenas hora (`time`), data e hora combinadas (`datetime`) e datas múltiplas.\n- **Validação e formulários nativos:** Valida datas mínimas (`min`), máximas (`max`), formatos permitidos e comunica valores estruturados diretamente ao formulário pai.\n\n### Quando utilizar\n\n- **Utilize quando:**\n  - O formulário exigir preenchimento de datas ou horários onde tanto a digitação manual rápida quanto a exploração visual no calendário agreguem valor à experiência.\n  - For necessário selecionar um período com data de início e fim.\n- **Evite e prefira outro componente quando:**\n  - A data for estritamente de nascimento ou emissão de documento onde a pessoa usuária sabe os dígitos de cor e prefere digitar apenas números (prefira `br-input` com máscara numérica).\n\n### Composição e Subcomponentes\n\n| Subcomponente | Papel | Regra de uso |\n| --- | --- | --- |\n| `br-datetime-picker` | **Orquestrador principal.** Gerencia valor consolidado, validação, abertura do popup e sincronização entre input e calendário. | Deve ser o único controle declarado no template da aplicação na quase totalidade dos casos. |\n| `br-datetime-input` | **Campo com máscara.** Exibe o valor formatado e permite digitação manual. | Coordenado automaticamente pelo pai; use avulso apenas em composições customizadas. |\n| `br-date-picker` | **Calendário de datas.** Painel visual com grade de dias, meses e anos. | Coordenado pelo pai; use avulso se precisar de calendário estático embutido. |\n| `br-time-picker` | **Seletor de horário.** Controle de escolha de horas e minutos. | Coordenado pelo pai; use avulso se precisar apenas de seletor de hora sem data. |\n\n### Como os subcomponentes se relacionam\n\nO `br-datetime-picker` funciona como o modelo pronto: ele instancia e sincroniza internamente o campo textual (`br-datetime-input`) e os seletores visuais suspensos (`br-date-picker` e/ou `br-time-picker`). A aplicação consome os eventos unificados emitidos diretamente pelo orquestrador pai (`change`, `input`).\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/datetime-picker?tab=designer).\n---\n\n\n### **Events:**\n - **dateStateChange** - Evento público emitido quando a data de referência ou a seleção mudam.\n- **valueChange** - Evento emitido quando o valor selecionado muda.\n- **brDatetimePickerValidationChange** - Emitido ao iniciar e concluir a validação customizada.\n\n### **Methods:**\n - **formResetCallback()** - API nativa de reset de form-associated custom elements.\n- **formStateRestoreCallback(state: _string | File | FormData | null_)** - API nativa de restauração de estado (histórico/autofill) do formulário.\n- **handleModeChange(newValue: _string_)** - Revalida o modo sempre que a prop mudar.\n- **handleRequiredChange()** - Revalida o estado do formulário quando required mudar.\n- **handleDisabledChange()** - Exclui o valor do FormData enquanto o componente estiver desabilitado.\n- **handleSelectionModeChange(newValue: _DatetimePickerSelectionMode_)** - Reage a mudanças no modo de seleção e limpa intervalo quando necessário.\n- **handleWeekStartsOnChange(newValue: _DatetimePickerWeekDayIndex_)** - Revalida o dia inicial da semana sempre que a prop mudar.\n- **handleInitialMomentChange(newValue: _DatetimePickerInitialMoment_)** - Aplica ou limpa a seleção da data atual conforme o novo valor da prop.\n- **handleValueChange(newValue: _Date | null_)** - Sincroniza alterações externas do valor com o estado visual e o formulário nativo.\n- **handleSerializedValueChange(newValue: _string_)** - Converte alterações externas no valor serializado sem mudar o tipo da prop legada `value`.\n- **handleValueAsDateChange(newValue: _Date | null_)** - Mantém `valueAsDate` e a prop legada `value` apontando para o mesmo estado observável.\n- **handleDisabledDatesChange(newValue: _DatetimePickerDisabledDates_)** - Recalcula a lista de datas desabilitadas quando a prop mudar.\n- **setDisabledDates(dates: _DatetimePickerDisabledDate[] | null_): _Promise<void>_** - Define programaticamente as datas desabilitadas por meio de array.\n\nÚtil quando o componente é usado via HTML e o consumidor precisa enviar\numa lista tipada em runtime.\n- **setValue(value: _Date | string | null_): _Promise<void>_** - Define o valor atual de forma imperativa aceitando Date, string serializada ou null.\n- **getValue(): _Promise<Date | null>_** - Retorna uma cópia do valor selecionado atualmente.\n- **clear(): _Promise<void>_** - Limpa valor e intervalo selecionados.\n- **open(): _Promise<void>_** - Abre o picker quando o componente estiver habilitado.\n- **close(): _Promise<void>_** - Fecha o picker.\n- **toggle(): _Promise<void>_** - Alterna o estado de abertura do picker.\n- **focusInput(): _Promise<void>_** - Move o foco para o input nativo interno.\n- **setRange(start: _Date | string | null_, end: _Date | string | null_): _Promise<void>_** - Define intervalo de datas de forma imperativa, forçando modo date e selectionMode range.\n- **getRange(): __** - Retorna o intervalo de datas selecionado quando em modo `selectionMode=\"range\"`.\n- **isOpen(): __** - Consulta se o picker está atualmente aberto.\n- **resetToInitial(): _Promise<void>_** - Restaura o estado inicial atualmente registrado para reset.\n- **checkValidity(): _Promise<boolean>_** - Permite que consumidores acionem validação nativa do formulário via host.\n- **reportValidity(): _Promise<boolean>_** - Permite exibir mensagens nativas de validação no host.\n- **setCustomValidity(message: _string_): _Promise<void>_** - Define ou limpa uma mensagem de validade customizada.\n- **validate(): _Promise<boolean>_** - Executa o validator do picker e retorna se a seleção atual é válida.\n- **getValidationState(): _Promise<FormValidationState>_** - Retorna um snapshot serializável da Constraint Validation API.\n- **render()** - Renderização principal do componente.\n\n### **Slots:**\n - **feedback** - Mensagem de validação, normalmente um `br-message`.\n\n### **CSS Parts:**\n - **container** - Parte para o container base do seletor.\n- **panel** - Parte para o painel em forma de card que engloba o seletor.\n- **input-container** - Container base do campo de entrada interno.\n- **input-field** - Campo textual interno.\n- **input-icon** - Ícone de ação (calendário/relógio).\n- **feedback** - Contêiner da mensagem de validação.",
+      "description": "O `br-datetime-picker` é o controle completo do GovBR-DS para digitação e seleção visual de datas e horários. Orquestra o campo textual e os seletores internos, consolidando valor, validação e integração com formulários HTML.\n\n### Para que serve\n\n- Oferece os modos `date`, `time` e `datetime`, com seleção única (`single`) ou de intervalo (`range`).\n- Combina edição textual com máscara, calendário e ajuste de horas e minutos conforme o modo escolhido.\n- Centraliza restrições de seleção, validação e submissão do valor por meio de `formAssociated`.\n\n### Quando utilizar\n\n- Utilize quando o formulário precisar de um controle completo de data ou horário com digitação e seleção visual.\n- Utilize para períodos com início e fim, inclusive com horários nos modos `time` e `datetime`.\n- Evite quando precisar apenas apresentar uma data: prefira texto formatado.\n- Para um calendário permanentemente visível sem o campo textual, considere `br-date-picker`; a aplicação assume a integração com o restante do formulário.\n- A seleção não oferece uma coleção de datas independentes: use `single` para um valor ou `range` para um intervalo.\n\n### Composição e Subcomponentes\n\n| Componente | Papel | Regra de uso |\n| --- | --- | --- |\n| `br-datetime-picker` | Orquestrador do valor consolidado, validação, formulário e abertura do painel. | Declare este controle no template para obter a composição completa. |\n| `br-datetime-input` | Campo textual com máscara, interpretação da entrada e ação de abertura do painel. | Instanciado internamente pelo pai; não deve ser fornecido em slot. |\n| `br-date-picker` | Calendário para navegação e seleção de data única ou intervalo. | Criado pelo pai nos modos `date` e `datetime`; pode ser usado isoladamente como calendário embutido. |\n| `br-time-picker` | Controles de hora e minuto. | Criado pelo pai nos modos `time` e `datetime`, com uma instância por limite quando a seleção é `range`. |\n\nO slot `feedback` recebe conteúdo declarativo de validação, normalmente um `br-message`; não substitui os seletores internos.\n\n### Como os subcomponentes se relacionam\n\nO pai fornece valores e configurações aos filhos por propriedades e consolida suas alterações por eventos DOM. O campo textual solicita a abertura do painel; o calendário e os controles de horário atualizam a seleção compartilhada, sem coordenar diretamente uns aos outros.\n\n`referenceDate` representa a referência de navegação visual, distinta da seleção efetiva. O orquestrador mantém o campo textual, os seletores e o valor de formulário sincronizados. A aplicação consome o valor e os eventos do pai, incluindo `brDatetimePickerChange` para a seleção completa e tipada.\n\nO uso isolado dos filhos exige que a aplicação assuma a coordenação de estado, validação e formulário; eles não herdam a associação nativa ao formulário do `br-datetime-picker`.\n\nPara a documentação completa de design, incluindo diretrizes de uso, acessibilidade e exemplos visuais, consulte o [Design System do GovBR](https://www.gov.br/ds/components/datetimepicker?tab=designer).\n---\n\n\n### **Events:**\n - **dateStateChange** - Evento público emitido quando a data de referência ou a seleção mudam.\n\nPayload (`DatetimePickerDateState`):\n- `referenceDate`: Date — data usada para navegação visual (mês/semana exibidos).\n- `value`: Date | null — valor selecionado atualmente.\n- **brDatetimePickerChange** - Evento público canônico emitido quando a seleção muda.\n\nPayload (`DatetimePickerChangeDetail`):\n- `mode`: DatetimePickerMode — modo atual do componente (`date` | `time` | `datetime`).\n- `selectionMode`: DatetimePickerSelectionMode — `single` ou `range`.\n- `value`: Date | null | DatetimePickerDateRange — seleção atual (tipo depende de `selectionMode`).\n- `serializedValue`: string | undefined — representação serializada para integração com formulários.\n- **valueChange** - Evento emitido quando o valor selecionado muda.\n- **brDatetimePickerValidationChange** - Emitido ao iniciar e concluir a validação customizada.\n\nPayload (`FormValidationChangeDetail`):\n- `validating`: boolean — indica se a validação está em execução.\n- `valid`: boolean | null — resultado da validação (`null` enquanto valida).\n- `message`: string | null — mensagem de validação associada.\n\n### **Methods:**\n - **handleModeChange(newValue: _string_)** - Revalida o modo sempre que a prop mudar.\n- **handleRequiredChange()** - Revalida o estado do formulário quando required mudar.\n- **handleDisabledChange()** - Exclui o valor do FormData enquanto o componente estiver desabilitado.\n- **handleSelectionModeChange(newValue: _DatetimePickerSelectionMode_)** - Reage a mudanças no modo de seleção e limpa intervalo quando necessário.\n- **handleWeekStartsOnChange(newValue: _DatetimePickerWeekDayIndex_)** - Revalida o dia inicial da semana sempre que a prop mudar.\n- **handleInitialMomentChange(newValue: _DatetimePickerInitialMoment_)** - Aplica ou limpa a seleção da data atual conforme o novo valor da prop.\n- **handleValueChange(newValue: _Date | null_)** - Sincroniza alterações externas do valor com o estado visual e o formulário nativo.\n- **handleSerializedValueChange(newValue: _string_)** - Converte alterações externas no valor serializado sem mudar o tipo da prop legada `value`.\n- **handleValueAsDateChange(newValue: _Date | null_)** - Mantém `valueAsDate` e a prop legada `value` apontando para o mesmo estado observável.\n- **handleDisabledDatesChange(newValue: _DatetimePickerDisabledDates_)** - Recalcula a lista de datas desabilitadas quando a prop mudar.\n- **formResetCallback()** - Restaura o estado do componente quando o formulário é restaurado.\n- **formStateRestoreCallback(state: _string | File | FormData | null_)** - Restaura o estado do formulário (autofill / histórico).\n- **setDisabledDates(dates: _DatetimePickerDisabledDate[] | null_): _Promise<void>_** - Define programaticamente as datas desabilitadas.\n\nUse quando scripts externos precisam fornecer uma lista tipada de\ndatas a bloquear no calendário. Substitui a prop `disabledDates` para\natualizações imperativas.\n- **setValue(value: _Date | string | null_): _Promise<void>_** - Define o valor do componente de forma imperativa.\n\nAceita `Date`, string compatível com o `mode`, ou `null` para limpar a seleção.\nValidação de datas desabilitadas é aplicada antes da atribuição.\n- **getValue(): _Promise<Date | null>_** - Retorna uma cópia do valor selecionado atualmente.\n- **clear(): _Promise<void>_** - Limpa valor e intervalo selecionados.\n\nRemove seleção atual e restaura a referência de navegação para a data atual.\n- **open(): _Promise<void>_** - Abre o picker quando o componente estiver habilitado.\n- **close(): _Promise<void>_** - Fecha o picker.\n- **toggle(): _Promise<void>_** - Alterna o estado de abertura do picker.\n- **focusInput(): _Promise<void>_** - Move o foco para o input nativo interno.\n- **setRange(start: _Date | string | null_, end: _Date | string | null_): _Promise<void>_** - Define um intervalo no modo atual e ativa `selectionMode=\"range\"`.\n\nValida datas contra bloqueios e sincroniza estado visual e de formulário.\nEm `datetime`, mantém os limites informados e sinaliza intervalo inválido\nquando o término precede o início, sem ajustar datas automaticamente.\n- **getRange(): _Promise<{ start: Date | null; end: Date | null } | null>_** - Retorna o intervalo de datas selecionado quando em modo `selectionMode=\"range\"`.\n- **isOpen(): _Promise<boolean>_** - Consulta se o picker está atualmente aberto.\n- **resetToInitial(): _Promise<void>_** - Restaura o estado inicial atualmente registrado para reset.\n- **checkValidity(): _Promise<boolean>_** - Permite que consumidores acionem validação nativa do formulário via host.\n- **reportValidity(): _Promise<boolean>_** - Permite exibir mensagens nativas de validação no host.\n- **setCustomValidity(message: _string_): _Promise<void>_** - Define ou limpa uma mensagem de validade customizada.\n- **validate(): _Promise<boolean>_** - Executa o validator customizado (se houver) e valida o controle.\n\nEmite eventos de início/conclusão da validação e atualiza mensagens internas.\n- **getValidationState(): _Promise<FormValidationState>_** - Retorna um snapshot serializável da Constraint Validation API.\n- **render()** - Renderização principal do componente.\n\n### **Slots:**\n - **feedback** - Mensagem de validação, normalmente um `br-message`.\n\n### **CSS Parts:**\n - **container** - Parte para o container base do seletor.\n- **panel** - Parte para o painel em forma de card que engloba o seletor.\n- **input-container** - Container base do campo de entrada interno.\n- **input-field** - Campo textual interno.\n- **input-icon** - Ícone de ação (calendário/relógio).\n- **feedback** - Contêiner da mensagem de validação.",
       "attributes": [
         {
           "name": "mode",
-          "description": "Define o modo de seleção exibido pelo componente: data, horário ou ambos.\n\nValores aceitos: `date`, `time` ou `datetime`.\nValores inválidos são corrigidos automaticamente para o valor padrão,\nmantendo o atributo refletido sempre consistente com o modo exibido.",
+          "description": "Modo exibido pelo componente.\n\nValores: `date` | `time` | `datetime`.\nValores inválidos são normalizados para o padrão.",
           "values": [{ "name": "DatetimePickerMode" }]
         },
         {
           "name": "locale",
-          "description": "Define o locale usado pelos subcomponentes para formatar datas e rótulos.",
+          "description": "Locale usado para formatação e rótulos.",
           "values": [{ "name": "DatetimePickerLocale" }]
         },
         {
           "name": "placeholder",
-          "description": "Define o placeholder exibido no campo de entrada do datetime picker.",
+          "description": "Texto placeholder exibido no input.",
           "values": []
         },
         {
@@ -1044,72 +1044,68 @@
         },
         {
           "name": "required",
-          "description": "Indica se o campo deve ter valor antes do envio do formulário.",
+          "description": "Indica se o campo é requerido para submissão do formulário.",
           "values": []
         },
         {
           "name": "min",
-          "description": "Menor data/horário aceito, interpretado conforme `mode`. Valores inválidos são ignorados.\nAceita texto no atributo HTML ou uma instância de `Date` por property binding.",
+          "description": "Menor data/hora aceito (Date | string | null).",
           "values": [{ "name": "Date" }]
         },
         {
           "name": "max",
-          "description": "Maior data/horário aceito, interpretado conforme `mode`. Valores inválidos são ignorados.\nAceita texto no atributo HTML ou uma instância de `Date` por property binding.",
+          "description": "Maior data/hora aceito (Date | string | null).",
           "values": [{ "name": "Date" }]
         },
         {
           "name": "validator",
-          "description": "Regra síncrona ou assíncrona aplicada à data ou intervalo selecionado.\nRetorne uma mensagem para invalidar ou `null` para aceitar o valor.",
+          "description": "Validador customizado (síncrono ou assíncrono) para a seleção.\n\nRecebe `Date | DatetimePickerDateRange | null` como valor.",
           "values": [{ "name": "DatetimePickerValidator" }]
         },
         {
           "name": "selection-mode",
-          "description": "Define o tipo de seleção de datas para o calendário: única ou intervalo.\n\n`range` só funciona em conjunto com `mode=\"date\"`.\nSe `selectionMode=\"range\"` for informado, o componente ajusta automaticamente\n`mode` para `date`. Se `mode` mudar para `time` ou `datetime`, o componente\nnormaliza `selectionMode` para `single` quando necessário.\nValores inválidos usam `single`.",
+          "description": "Tipo de seleção: `single` ou `range`.",
           "values": [{ "name": "DatetimePickerSelectionMode" }]
         },
         {
           "name": "week-starts-on",
-          "description": "Define o dia inicial da semana exibida no calendário.\n\nValores suportados: 0 (domingo) a 6 (sábado).",
+          "description": "Dia inicial da semana exibido no calendário (0 = Dom, 6 = Sáb).",
           "values": [{ "name": "DatetimePickerWeekDayIndex" }]
         },
         {
           "name": "initial-moment",
-          "description": "Define a seleção inicial do componente.\n\nAceita:\n- `'now'`: seleciona o momento atual.\n- `Date` ou `string`: seleciona uma data arbitrária.\n- `null`: inicia sem seleção.\n\nReativo em runtime: mudanças na prop atualizam estado e subcomponentes.",
+          "description": "Valor inicial da seleção: `'now' | Date | string | null`.",
           "values": [{ "name": "DatetimePickerInitialMoment" }]
         },
         {
           "name": "value",
-          "description": "Instância de `Date` selecionada pelo usuário no modo simples.\nPode ser controlada por property binding e é atualizada pelo evento `valueChange`.\nPara formulários e atributos textuais, use `serializedValue`.",
+          "description": "Valor selecionado pelo usuário (Date | null).\n\nPode ser controlado externamente e é refletido internamente.",
           "values": [{ "name": "Date" }]
         },
         {
           "name": "serialized-value",
-          "description": "Representação serializada compatível com os formatos de controles HTML (`YYYY-MM-DD`, `HH:mm`\nou ISO local, conforme `mode`). Em intervalos, usa `início/fim`.\n\nNa inicialização, tem precedência sobre `valueAsDate`, `value` e `initialMoment`.\nUma string vazia inicia sem seleção, mesmo quando outra prop fornece uma data.",
+          "description": "Representação serializada compatível com controles HTML.\n\nFormatos variam conforme `mode`. Em intervalos, usa `início/fim`.",
           "values": []
         },
-        {
-          "name": "value-as-date",
-          "description": "Espelho tipado da seleção atual, equivalente ao padrão `valueAsDate` dos controles HTML.\nDiferentemente de `serializedValue`, recebe e retorna uma instância de `Date`.\nNa inicialização, tem precedência sobre `value` e `initialMoment` quando `serializedValue`\nnão é informado. `null` inicia sem seleção; `undefined` permite usar as outras props.",
-          "values": [{ "name": "Date" }]
-        },
+        { "name": "value-as-date", "values": [{ "name": "Date" }] },
         {
           "name": "range-value",
-          "description": "Intervalo controlado quando `selectionMode=\"range\"`.\nDeve conter datas válidas ou `null` em `start` e `end`; valores inválidos mantêm o último intervalo efetivo.\nPasse o objeto por property binding; atributos HTML não representam objetos com `Date`.",
+          "description": "Intervalo controlado quando `selectionMode=\"range\"`.\n\nEm `datetime`, preserva as datas e horários informados; término anterior ao\ninício torna o controle inválido, sem reordenar ou avançar datas.",
           "values": [{ "name": "DatetimePickerDateRange" }]
         },
         {
           "name": "disabled",
-          "description": "Desabilita toda a interação do componente.\n\nQuando `true`, impede abrir o picker, alterar valores e navegar entre datas/horários.",
+          "description": "Desabilita toda a interação do componente.",
           "values": []
         },
         {
           "name": "disabled-dates",
-          "description": "Define um conjunto de datas indisponíveis para seleção.\n\nAceita uma lista de `Date` e/ou strings analisáveis, ou uma string com datas\nseparadas por espaço em branco. Datas inválidas são ignoradas com warning.\nA comparação considera apenas o dia (ano/mês/dia), ignorando hora.",
+          "description": "Datas indisponíveis para seleção. Aceita `Date[]`, `string` ou `null`.\n\nDatas inválidas são ignoradas. A comparação considera apenas o dia.",
           "values": [{ "name": "DatetimePickerDisabledDates" }]
         },
         {
           "name": "fixed-row-count",
-          "description": "Define se o calendário deve manter um número fixo de linhas (6 semanas = 42 dias)\nou variar conforme o mês.\n\nQuando `true`, o calendário sempre exibe 6 semanas completas.\nQuando `false`, o calendário adapta-se ao mês, exibindo apenas as semanas necessárias.",
+          "description": "Mantém número fixo de linhas no calendário (6 semanas) quando `true`.",
           "values": []
         }
       ],
@@ -1117,26 +1113,26 @@
     },
     {
       "name": "br-date-picker",
-      "description": "Subcomponente de calendário visual do GovBR-DS, projetado para seleção interativa de datas individuais ou intervalos.\n\n### Papel na composição\n\n- Exibe a grade mensal navegável com suporte a seleção de dia, navegação entre meses e anos, e destaque para a data atual e intervalos.\n- Implementa navegação acessível por teclado WAI-ARIA Grid (setas direcionais para dias e semanas).\n\n### Regra de uso e relacionamento\n\nGeralmente exibido dentro da superfície suspensa coordenada pelo `br-datetime-picker`. Pode ser declarado isoladamente quando a interface demandar um calendário estático permanentemente embutido na página (inline calendar).\n\nPara a documentação completa de design, consulte o [Design System do GovBR](https://www.gov.br/ds/components/datetime-picker?tab=designer).\n---\n\n\n### **Events:**\n - **dateStateChange** - Evento emitido quando a data de referência ou a seleção mudam.\n\n### **Methods:**\n - **handleValueChange(newValue: _Date | null_)** - Sincroniza `focusedDate` quando o valor selecionado muda externamente.\n- **handleWeekStartsOnChange(newValue: _number_)** - Revalida a configuração quando o início da semana muda.\n- **handleLocaleChange(newValue: _string_)** - Revalida o locale quando a prop muda.\n\n### **CSS Parts:**\n - **container** - Parte para o container base do calendário.\n- **header** - Cabeçalho do calendário (contendo navegação e seleção de mês/ano).\n- **month-select** - Elemento de seleção do mês.\n- **year-input** - Elemento de entrada do ano.\n- **calendar** - Grade geral do calendário.\n- **weekdays** - Container para os rótulos dos dias da semana.\n- **weekday** - Rótulo individual do dia da semana.\n- **grid** - Grade de dias do mês.\n- **day** - Célula individual do dia no calendário.",
+      "description": "O `br-date-picker` é o subcomponente de calendário do `br-datetime-picker`, responsável pela seleção visual de uma data ou de um intervalo.\n\n### Papel na composição\n\nExibe a grade mensal, a navegação entre meses e anos e os estados de seleção e bloqueio dos dias. `referenceDate` determina o período exibido, enquanto `value` e os limites do intervalo representam a seleção.\n\n### Regra de uso e relacionamento\n\nO `br-datetime-picker` instancia e configura este calendário internamente nos modos `date` e `datetime`, recebendo suas alterações pelo evento `dateStateChange`. Não declare o calendário em um slot do pai.\n\nUse diretamente quando precisar de um calendário embutido e permanentemente visível. Nesse caso, a aplicação deve coordenar valores e eventos e implementar a integração com formulários e a validação do fluxo completo. O calendário isolado não fornece o campo textual, o seletor de horários nem a associação ao formulário do orquestrador.\n\nPara a documentação completa de design, incluindo diretrizes de uso, acessibilidade e exemplos visuais, consulte o [Design System do GovBR](https://www.gov.br/ds/components/date-picker?tab=designer).\n---\n\n\n### **Events:**\n - **dateStateChange** - Emite o estado consolidado do componente quando há mudança de referência/seleção.\n\nPayload (DatetimePickerDateState):\n\n### **Methods:**\n - **handleValueChange(newValue: _Date | null_)** - Sincroniza `focusedDate` quando o valor selecionado muda externamente.\n- **handleWeekStartsOnChange(newValue: _number_)** - Revalida a configuração quando o início da semana muda.\n- **handleLocaleChange(newValue: _string_)** - Revalida o locale quando a prop muda.\n\n### **CSS Parts:**\n - **container** - Parte para o container base do calendário.\n- **header** - Cabeçalho do calendário (contendo navegação e seleção de mês/ano).\n- **month-select** - Elemento de seleção do mês.\n- **year-input** - Elemento de entrada do ano.\n- **calendar** - Grade geral do calendário.\n- **weekdays** - Container para os rótulos dos dias da semana.\n- **weekday** - Rótulo individual do dia da semana.\n- **grid** - Grade de dias do mês.\n- **day** - Célula individual do dia no calendário.",
       "attributes": [
         {
           "name": "week-starts-on",
-          "description": "Define o índice do dia em que a semana começa na interface do calendário.",
+          "description": "Índice do dia em que a semana começa na interface do calendário.",
           "values": [{ "name": "WeekDayIndex" }]
         },
         {
           "name": "reference-date",
-          "description": "Data usada como base visual para o mês atualmente exibido, sem alterar a seleção.\nRecebe uma instância de `Date` por property binding; valores inválidos usam a data atual.",
+          "description": "Data usada como base visual para o mês atualmente exibido.",
           "values": [{ "name": "Date" }]
         },
         {
           "name": "value",
-          "description": "Data efetivamente selecionada, ou `null` quando não há seleção; é diferente de `referenceDate`, que controla apenas o mês visível.\nRecebe uma instância de `Date` por property binding; datas inválidas usam `null`.",
+          "description": "Data atualmente selecionada pelo usuário, ou `null` quando não há seleção.",
           "values": [{ "name": "Date" }]
         },
         {
           "name": "selection-mode",
-          "description": "Define se a seleção ocorre por data única ou por intervalo. Valores inválidos usam `single`.",
+          "description": "Define se a seleção ocorre por data única ou por intervalo.",
           "values": [{ "name": "DatetimePickerSelectionMode" }]
         },
         {
@@ -1151,17 +1147,17 @@
         },
         {
           "name": "range-value",
-          "description": "Intervalo controlado no modo `range`, reunindo `rangeStart` e `rangeEnd` em uma atualização.\nDeve conter datas válidas ou `null`; valores inválidos são ignorados. Passe o objeto por property binding.",
+          "description": "Intervalo controlado no modo `range`.\nQuando definido, mantém `rangeStart` e `rangeEnd` sincronizados.",
           "values": [{ "name": "DatetimePickerDateRange" }]
         },
         {
           "name": "disabled",
-          "description": "Desabilita a interação do calendário quando ativo.",
+          "description": "Desabilita a interação do calendário quando `true`.",
           "values": []
         },
         {
           "name": "disabled-dates",
-          "description": "Lista de datas indisponíveis para seleção no calendário.\nRecebe instâncias de `Date` por property binding; datas inválidas são ignoradas.",
+          "description": "Lista de datas indisponíveis para seleção no calendário.",
           "values": [{ "name": "Date[]" }]
         },
         {
@@ -1171,7 +1167,7 @@
         },
         {
           "name": "fixed-row-count",
-          "description": "Define se o calendário deve manter um número fixo de linhas (6 semanas = 42 dias)\nou variar conforme o mês.\n\nQuando `true`, o calendário sempre exibe 6 semanas completas.\nQuando `false`, o calendário adapta-se ao mês, exibindo apenas as semanas necessárias.",
+          "description": "Se `true`, o calendário sempre exibe 6 semanas (42 dias); caso contrário, adapta-se ao mês.",
           "values": []
         }
       ],
@@ -1179,51 +1175,51 @@
     },
     {
       "name": "br-datetime-input",
-      "description": "Subcomponente especializado do ecossistema de datas do GovBR-DS, responsável pela digitação e formatação de datas e horários via teclado.\n\n### Papel na composição\n\n- Aplica máscaras automáticas de digitação conforme o formato configurado (ex.: `DD/MM/AAAA`, `HH:mm`, `DD/MM/AAAA HH:mm`).\n- Contém o botão de acionamento para expandir ou recolher o popup do calendário.\n\n### Regra de uso e relacionamento\n\nNo fluxo usual da aplicação, é instanciado e coordenado automaticamente pelo orquestrador `br-datetime-picker`. Pode ser utilizado de forma autônoma apenas quando o leiaute exigir somente o campo de digitação textual sem o painel flutuante de calendário.\n\nPara a documentação completa de design, consulte o [Design System do GovBR](https://www.gov.br/ds/components/datetime-picker?tab=designer).\n---\n\n\n### **Events:**\n - **dateStateChange** - Emite quando o valor é alterado via input ou parsing.\n- **togglePicker** - Solicita ao componente pai a alternância da abertura do picker.\n\n### **Methods:**\n - **handleValueChange(newValue: _Date | null_)** - Revalida e reflete no input mudanças externas em `value`.\n- **handleModeChange(newValue: _string_)** - Garante modo suportado e ajusta máscara/valor textual exibido.\n- **handleReferenceDateChange(newValue: _Date_)** - Valida a data de referência e sincroniza o campo quando não há seleção.\n- **handleRangeStartChange(newValue)** - Sincroniza o input quando o início do range muda.\n- **handleRangeEndChange(newValue)** - Sincroniza o input quando o fim do range muda.\n- **render()** - Renderização principal do componente.\n\n### **CSS Parts:**\n - **container** - Parte para o container base do campo.\n- **input** - Parte para o campo textual interno.\n- **icon** - Parte para o ícone de ação (calendário/relógio).",
+      "description": "O `br-datetime-input` é o subcomponente de edição textual do `br-datetime-picker`, com máscara, interpretação de datas e horários e validação local sobre um `br-input` interno.\n\n### Papel na composição\n\nExibe e permite editar a seleção única ou os limites de um intervalo nos modos `date`, `time` e `datetime`. Comunica alterações por `dateStateChange`, informa a validação local por `inputValidationChange` e solicita a abertura ou o fechamento do painel por `togglePicker`.\n\n### Regra de uso e relacionamento\n\nO `br-datetime-picker` instancia este campo internamente e fornece valores e configurações por propriedades. O pai coordena a seleção com o calendário e os controles de horário; o campo não abre esses seletores por conta própria nem deve ser fornecido em slot.\n\nPrefira o `br-datetime-picker` para o controle completo. Use o campo isoladamente apenas em composições personalizadas nas quais a aplicação assuma a sincronização de estado, o tratamento dos eventos e a integração com formulários. Este subcomponente não possui a associação nativa ao formulário do orquestrador.\n\nConsulte também as [diretrizes de design do GovBR](https://www.gov.br/ds/components/datetime?tab=designer).\n---\n\n\n### **Events:**\n - **dateStateChange** - Evento emitido quando o estado de data/hora muda (após commit ou parsing).\n\nPayload (`detail`):\n- **togglePicker** - Emite uma solicitação ao componente pai para alternar a abertura do picker.\nEmite sem payload.\n- **inputValidationChange** - Emite validação do texto digitado sem alterar o valor selecionado.\n\nPayload (`detail`):\n\n### **Methods:**\n - **handleRangeValueChange(newValue: _DatetimePickerDateRange | undefined_): _void_** - Watcher: sincroniza `rangeStart`/`rangeEnd` a partir de `rangeValue` controlado.\n- **handleValueChange(newValue: _Date | null_): _void_** - Watcher: reage a mudanças externas em `value`, normalizando e sincronizando\no texto exibido no input.\n- **handleModeChange(newValue: _string_): _void_** - Watcher: aplica normalização do `mode` e atualiza a máscara/valor exibido.\n- **handleReferenceDateChange(newValue: _Date_): _void_** - Watcher: valida `referenceDate` e resina o input quando não há seleção.\n- **handleRangeStartChange(newValue): _void_** - Watcher: atualiza a representação textual quando o início do range muda.\n- **handleRangeEndChange(newValue): _void_** - Watcher: atualiza a representação textual quando o fim do range muda.\n- **render()** - Renderização principal do componente.\n\n### **CSS Parts:**\n - **container** - Container do campo.\n- **input** - Elemento de entrada textual interno.\n- **icon** - Ícone de ação (calendário/relógio).",
       "attributes": [
         {
           "name": "placeholder",
-          "description": "Define o placeholder do campo de entrada.",
+          "description": "Texto de placeholder exibido quando o campo estiver vazio.",
           "values": []
         },
         {
           "name": "mode",
-          "description": "Define o modo de entrada: `date`, `time` ou `datetime`.",
+          "description": "Modo de entrada que controla máscara, parser e formato exibido.",
           "values": [{ "name": "DatetimePickerMode" }]
         },
         {
           "name": "reference-date",
-          "description": "Data de referência que orienta a navegação visual do calendário sem alterar a seleção.\nRecebe uma instância de `Date` por property binding.",
+          "description": "Data de referência usada para navegação e preenchimento de valores parciais.",
           "values": [{ "name": "Date" }]
         },
         {
           "name": "value",
-          "description": "Data efetivamente selecionada, ou `null` quando nada foi escolhido; é diferente\nde `referenceDate`, que controla apenas a referência visual.\nRecebe uma instância de `Date` por property binding.",
+          "description": "Valor atualmente selecionado pelo componente.",
           "values": [{ "name": "Date" }]
         },
         {
           "name": "disabled",
-          "description": "Desabilita digitação e abertura do picker quando ativo.",
+          "description": "Controla os estados de read-only ou bloqueio de formulário.",
           "values": []
         },
         {
           "name": "selection-mode",
-          "description": "Define se a seleção ocorre por data única ou por intervalo.\nAceita `single` ou `range`; valores inválidos usam `single`.",
+          "description": "Define o modo de seleção: `single` (valor único) ou `range` (intervalo).",
           "values": [{ "name": "DatetimePickerSelectionMode" }]
         },
         {
           "name": "range-start",
-          "description": "Data inicial do intervalo quando em modo range.",
+          "description": "Início do intervalo em `selectionMode === 'range'`.",
           "values": [{ "name": "Date" }]
         },
         {
           "name": "range-end",
-          "description": "Data final do intervalo quando em modo range.",
+          "description": "Fim do intervalo em `selectionMode === 'range'`.",
           "values": [{ "name": "Date" }]
         },
         {
           "name": "range-value",
-          "description": "Intervalo controlado no modo `range`, reunindo `rangeStart` e `rangeEnd` em uma atualização.\nDeve conter datas válidas ou `null`; valores inválidos são ignorados. Passe o objeto por property binding.",
+          "description": "Intervalo controlado no modo `range` como objeto `{ start, end }`.",
           "values": [{ "name": "DatetimePickerDateRange" }]
         }
       ],
@@ -1231,21 +1227,21 @@
     },
     {
       "name": "br-time-picker",
-      "description": "Subcomponente de seleção de horários do GovBR-DS, desenvolvido para permitir a escolha intuitiva de horas e minutos.\n\n### Papel na composição\n\n- Apresenta colunas ou controles de incremento/decremento para seleção de horas e minutos com validação de limites.\n- Sincroniza o horário escolhido com o campo textual associado.\n\n### Regra de uso e relacionamento\n\nCoordenado pelo componente pai `br-datetime-picker` no modo de horário ou composto. Pode ser utilizado avulso quando a aplicação demandar exclusivamente a captura de hora sem necessidade de calendário de datas.\n\nPara a documentação completa de design, consulte o [Design System do GovBR](https://www.gov.br/ds/components/datetime-picker?tab=designer).\n---\n\n\n### **Events:**\n - **dateStateChange** - Evento emitido quando a data de referência ou o valor selecionado mudam.\n\n### **CSS Parts:**\n - **container** - Parte para o container base do seletor de horários.\n- **timer** - Container para o grupo de hora e minuto.\n- **field** - Campo individual de entrada de tempo (com botões de ajuste).\n- **separator** - Separador visual de hora e minuto.\n- **input** - Campo de entrada textual interno do tempo.",
+      "description": "O `br-time-picker` é o subcomponente de ajuste de horas e minutos do `br-datetime-picker`.\n\n### Papel na composição\n\nOferece campos textuais e botões de incremento e decremento para hora e minuto. Usa uma data de referência e comunica alterações por `dateStateChange`; não coordena diretamente o calendário nem o campo textual principal.\n\n### Regra de uso e relacionamento\n\nO `br-datetime-picker` instancia e sincroniza este seletor nos modos `time` e `datetime`. Na seleção de intervalo, o pai cria dois seletores, um para o início e outro para o fim, e consolida os respectivos valores. Não forneça seletores de horário em slots do pai.\n\nPrefira o orquestrador para um controle completo de horário com campo textual e formulário. Use diretamente apenas quando precisar dos controles de hora e minuto em uma composição personalizada e assumir a sincronização de estado, a validação e a integração com formulários. O uso isolado não herda a associação nativa ao formulário do pai.\n\nConsulte também as [diretrizes de design do GovBR](https://www.gov.br/ds/components/time-picker?tab=designer).\n---\n\n\n### **Events:**\n - **dateStateChange** - Evento emitido sempre que `referenceDate` ou `value` são atualizados.\n\nO `detail` segue a forma de `DatetimePickerDateState` e contém o estado\ncompartilhado entre subcomponentes de data e horário.\n\nPayload (`detail`):\n\n### **Methods:**\n - **handleValueChange(newValue: _Date | null_): _void_** - Sincroniza `referenceDate` quando a prop `value` muda.\n\nNormaliza segundos/milissegundos e restaura rascunhos locais.\n- **render(): _JSX.Element_** - Render principal do componente.\n\n### **CSS Parts:**\n - **container** - Container base do seletor de horários.\n- **timer** - Grupo que contém os campos de hora e minuto.\n- **field** - Campo de tempo com botões de ajuste.\n- **separator** - Separador visual entre hora e minuto.\n- **input** - Campo de entrada textual interno do tempo.",
       "attributes": [
         {
           "name": "reference-date",
-          "description": "Data usada como referência para a navegação de hora e minuto, sem representar necessariamente a seleção.\nRecebe uma instância de `Date` por property binding; valores inválidos usam a data atual.",
+          "description": "Data de referência usada para exibir e ajustar hora e minuto.",
           "values": [{ "name": "Date" }]
         },
         {
           "name": "value",
-          "description": "Data que contém a hora e o minuto efetivamente selecionados, ou `null` quando vazio.\nRecebe uma instância de `Date` por property binding; datas inválidas usam `null`.",
+          "description": "Valor canônico selecionado pelo usuário.",
           "values": [{ "name": "Date" }]
         },
         {
           "name": "disabled",
-          "description": "Desabilita todos os controles de navegação e edição de hora/minuto.",
+          "description": "Indica se os controles do seletor estão desabilitados.",
           "values": []
         }
       ],
@@ -1678,7 +1674,7 @@
     },
     {
       "name": "br-header-list",
-      "description": "O componente `br-header-list` é o subcomponente contêiner do GovBR-DS que organiza links de navegação ou botões funcionais em uma estrutura de lista horizontal acessível.\n\n### Para que serve\n\n- **Agrupamento semântico:** Estrutura itens navegáveis ou funcionais em elementos de lista semânticos.\n- **Distribuição e espaçamento:** Garante o alinhamento horizontal padronizado de itens no cabeçalho.\n\n### Papel na composição\n\nAtua como elo intermediário entre o orquestrador `br-header` e os itens filhos individuais (`br-header-link` ou `br-header-function`).\n\n### Regra de uso e relacionamento\n\n- Deve ser inserido nos slots `links` ou `functions` do orquestrador `br-header`.\n- Serve de contêiner direto para subcomponentes `br-header-link` ou `br-header-function`.\n---\n\n\n### **Events:**\n - **headerListUpdate** - Evento disparado para indicar qual lista deve encolher primeiro.\nO evento envia o ID do componente pai e o nome da lista.\n- **headerListFocused** - Evento disparado quando a lista recebe foco.\nO evento envia o ID do componente.\n\n### **Methods:**\n - **closeList()** - Fecha a lista.\n- **isListOpen(): __** - Verifica se a lista está aberta.\n- **openList(): _Promise<void>_** - Abre a lista.\n- **render(): __** - Renderiza o componente.\n\n### **Slots:**\n - **default** - Slot para o conteúdo da lista de navegação no cabeçalho.",
+      "description": "O componente `br-header-list` é o subcomponente contêiner do GovBR-DS que organiza links de navegação ou botões funcionais em uma estrutura de lista horizontal acessível.\n\n### Para que serve\n\n- **Agrupamento semântico:** Estrutura itens navegáveis ou funcionais em elementos de lista semânticos.\n- **Distribuição e espaçamento:** Garante o alinhamento horizontal padronizado de itens no cabeçalho.\n\n### Papel na composição\n\nAtua como elo intermediário entre o orquestrador `br-header` e os itens filhos individuais (`br-header-link` ou `br-header-function`).\n\n### Regra de uso e relacionamento\n\n- Deve ser inserido nos slots `links` ou `functions` do orquestrador `br-header`.\n- Serve de contêiner direto para subcomponentes `br-header-link` ou `br-header-function`.\n---\n\n\n### **Events:**\n - **headerListUpdate** - Evento disparado para indicar qual lista deve encolher primeiro.\nO evento envia o ID do componente pai e o nome da lista.\n- **headerListFocused** - Evento disparado quando a lista recebe foco.\nO evento envia o ID do componente.\n\n### **Methods:**\n - **closeList()** - Fecha a lista.\n- **isListOpen(): _Promise<boolean>_** - Verifica se a lista está aberta.\n- **openList(): _Promise<void>_** - Abre a lista.\n- **render(): __** - Renderiza o componente.\n\n### **Slots:**\n - **default** - Slot para o conteúdo da lista de navegação no cabeçalho.",
       "attributes": [
         {
           "name": "custom-id",
@@ -1822,7 +1818,7 @@
     },
     {
       "name": "br-input",
-      "description": "O componente `br-input` é o controle padrão do GovBR-DS para entrada de dados textuais em linha única. Totalmente integrado à validação nativa de formulários HTML via `ElementInternals` (`formAssociated`), ele suporta múltiplos tipos de entrada, máscaras e formatação.\n\n### Para que serve\n\n- **Captura de dados curtos em formulários:** Entrada de textos, senhas, endereços de e-mail, números, telefones, documentos e termos de busca.\n- **Alternância de visualização de senha:** No tipo `type=\"password\"`, oferece botão embutido para alternar entre texto visível e caracteres mascarados com feedback acessível.\n- **Validação e mensagens contextuais:** Comunica valor, validade e mensagens de erro ou orientação diretamente ao formulário HTML e leitores de tela.\n- **Densidade e ícones de apoio:** Suporta diferentes densidades visuais (alta, média e baixa) e ícones prefixados ou sufixados para enriquecer a experiência.\n\n### Quando utilizar\n\n- **Utilize quando:**\n  - A informação digitada couber em uma única linha (ex.: nome, CPF, e-mail, valor monetário, busca).\n- **Evite e prefira outro componente quando:**\n  - O texto for extenso ou exigir múltiplas linhas (prefira `br-textarea`).\n  - A escolha for feita a partir de uma lista pré-determinada de opções (prefira `br-select`, `br-radio` ou `br-checkbox`).\n  - O valor for uma data ou hora estruturada (prefira `br-datetime-picker`).\n\n### Estrutura e Slots\n\nO `br-input` é composto pelo campo de entrada e slots de apoio:\n- `icon`: Slot para ícone de apoio visual (prefixado ou sufixado ao campo de digitação).\n- `feedback`: Slot para exibição de mensagens de validação contextual (como `br-message`).\n\nPara a documentação completa de design, incluindo diretrizes de acessibilidade e especificações visuais, consulte o [Design System do GovBR](https://www.gov.br/ds/components/input?tab=designer).\n---\n\n\n### **Events:**\n - **valueChange** - Valor atualizado do input\n- **brClear** - Emitted when the input clear button action is triggered.\n- **brInputValidationChange** - Informa o início e o resultado do validator, inclusive quando ele consulta\num serviço remoto. O `detail` contém `validating`, `valid` e `message`;\nescrita programática e reset não representam interação do usuário.\n\n### **Methods:**\n - **reportValidity(): _Promise<boolean>_** - Retorna `true` se o valor do input for válido, caso contrário `false`.\nSe o input for inválido, exibe uma mensagem de erro padrão do navegador.\n- **setCustomValidity(message: _string_): _Promise<void>_** - Define uma mensagem de validação customizada para o input.\nSe a mensagem for uma string vazia, o erro customizado é limpo.\n- **validate(): _Promise<boolean>_** - Executa a regra customizada e retorna se o campo está válido.\nSe o validator for assíncrono, aguarda a resposta e ignora resultados\nantigos quando uma execução posterior já começou.\n- **checkValidity(): _Promise<boolean>_** - Retorna `true` se o valor do input for válido, caso contrário `false`.\nSe o input for inválido, dispara um evento 'invalid'.\n- **getValidationState(): _Promise<FormValidationState>_** - Retorna um snapshot serializável da Constraint Validation API.\n- **select(): _Promise<void>_** - Seleciona todo o texto do controle nativo, conforme HTMLInputElement.select().\n- **setRangeText(replacement: _string_, start: _number_, end: _number_, selectionMode: _SelectionMode_): _Promise<void>_** - Substitui um intervalo de texto usando a API nativa do input.\n- **setSelectionRange(start: _number_, end: _number_, direction: _'forward' | 'backward' | 'none'_): _Promise<void>_** - Define o intervalo selecionado no controle nativo.\n- **stepUp(n: _number_): _Promise<void>_** - Incrementa o valor numérico pelo step nativo.\n- **stepDown(n: _number_): _Promise<void>_** - Decrementa o valor numérico pelo step nativo.\n- **showPicker(): _Promise<void>_** - Abre o picker nativo quando o navegador e o tipo do input oferecem essa API.\n- **render(): __** - Renderiza o componente de input.\n\n### **Slots:**\n - **action** - Botão à direita do input.\n- **icon** - Ícone à esquerda do input.\n- **help-text** - Personalização do texto de ajuda.\n- **feedback** - Mensagem de feedback como resposta específica a uma interação do usuário com o input. Pode ser feedback de erro, aviso, sucesso ou informação.\n- **validation-loading** - Indicador exibido enquanto o validator assíncrono está pendente.\n\n### **CSS Parts:**\n - **container** - Contêiner visual principal do input.\n- **label** - Rótulo do input.\n- **input** - Elemento input nativo.\n- **group** - Grupo que contém ícone, input, botão e ajuda.\n- **icon** - Contêiner do slot de ícone.\n- **action** - Botão de ação lateral.\n- **action-button** - Botão interno reexportado do br-button da ação.\n- **help-text** - Texto de ajuda ou slot de ajuda.\n- **feedback** - Slot de feedback.",
+      "description": "O componente `br-input` é o controle padrão do GovBR-DS para entrada de dados textuais em linha única. Totalmente integrado à validação nativa de formulários HTML via `ElementInternals` (`formAssociated`), ele suporta múltiplos tipos de entrada, máscaras e formatação.\n\n### Para que serve\n\n- **Captura de dados curtos em formulários:** Entrada de textos, senhas, endereços de e-mail, números, telefones, documentos e termos de busca.\n- **Alternância de visualização de senha:** No tipo `type=\"password\"`, oferece botão embutido para alternar entre texto visível e caracteres mascarados com feedback acessível.\n- **Validação e mensagens contextuais:** Comunica valor, validade e mensagens de erro ou orientação diretamente ao formulário HTML e leitores de tela.\n- **Densidade e ícones de apoio:** Suporta diferentes densidades visuais (alta, média e baixa) e ícones prefixados ou sufixados para enriquecer a experiência.\n\n### Quando utilizar\n\n- **Utilize quando:**\n  - A informação digitada couber em uma única linha (ex.: nome, CPF, e-mail, valor monetário, busca).\n- **Evite e prefira outro componente quando:**\n  - O texto for extenso ou exigir múltiplas linhas (prefira `br-textarea`).\n  - A escolha for feita a partir de uma lista pré-determinada de opções (prefira `br-select`, `br-radio` ou `br-checkbox`).\n  - O valor for uma data ou hora estruturada (prefira `br-datetime-picker`).\n\n### Estrutura e Slots\n\nO `br-input` é composto pelo campo de entrada e slots de apoio:\n- `icon`: Slot para ícone de apoio visual (prefixado ou sufixado ao campo de digitação).\n- `feedback`: Slot para exibição de mensagens de validação contextual (como `br-message`).\n\nPara a documentação completa de design, incluindo diretrizes de acessibilidade e especificações visuais, consulte o [Design System do GovBR](https://www.gov.br/ds/components/input?tab=designer).\n---\n\n\n### **Events:**\n - **valueChange** - Valor atualizado do input\n- **brClear** - Emitted when the input clear button action is triggered.\n- **brInputActionClick** - Notifica a ativação do botão do slot `action` por clique ou teclado.\nEmitido no host com `detail.originalEvent` contendo o clique original.\nPropaga e atravessa Shadow DOM; não é cancelável nem altera o clique nativo.\nNão emite para o campo textual, botão de senha, inicialização ou controle desabilitado.\n- **brInputValidationChange** - Informa o início e o resultado do validator, inclusive quando ele consulta\num serviço remoto. O `detail` contém `validating`, `valid` e `message`;\nescrita programática e reset não representam interação do usuário.\n\n### **Methods:**\n - **reportValidity(): _Promise<boolean>_** - Retorna `true` se o valor do input for válido, caso contrário `false`.\nSe o input for inválido, exibe uma mensagem de erro padrão do navegador.\n- **setCustomValidity(message: _string_): _Promise<void>_** - Define uma mensagem de validação customizada para o input.\nSe a mensagem for uma string vazia, o erro customizado é limpo.\n- **validate(): _Promise<boolean>_** - Executa a regra customizada e retorna se o campo está válido.\nSe o validator for assíncrono, aguarda a resposta e ignora resultados\nantigos quando uma execução posterior já começou.\n- **checkValidity(): _Promise<boolean>_** - Retorna `true` se o valor do input for válido, caso contrário `false`.\nSe o input for inválido, dispara um evento 'invalid'.\n- **getValidationState(): _Promise<FormValidationState>_** - Retorna um snapshot serializável da Constraint Validation API.\n- **select(): _Promise<void>_** - Seleciona todo o texto do controle nativo, conforme HTMLInputElement.select().\n- **setRangeText(replacement: _string_, start: _number_, end: _number_, selectionMode: _SelectionMode_): _Promise<void>_** - Substitui um intervalo de texto usando a API nativa do input.\n- **setSelectionRange(start: _number_, end: _number_, direction: _'forward' | 'backward' | 'none'_): _Promise<void>_** - Define o intervalo selecionado no controle nativo.\n- **stepUp(n: _number_): _Promise<void>_** - Incrementa o valor numérico pelo step nativo.\n- **stepDown(n: _number_): _Promise<void>_** - Decrementa o valor numérico pelo step nativo.\n- **showPicker(): _Promise<void>_** - Abre o picker nativo quando o navegador e o tipo do input oferecem essa API.\n- **render(): __** - Renderiza o componente de input.\n\n### **Slots:**\n - **action** - Botão à direita do input.\n- **icon** - Ícone à esquerda do input.\n- **help-text** - Personalização do texto de ajuda.\n- **feedback** - Mensagem de feedback como resposta específica a uma interação do usuário com o input. Pode ser feedback de erro, aviso, sucesso ou informação.\n- **validation-loading** - Indicador exibido enquanto o validator assíncrono está pendente.\n\n### **CSS Parts:**\n - **container** - Contêiner visual principal do input.\n- **label** - Rótulo do input.\n- **input** - Elemento input nativo.\n- **group** - Grupo que contém ícone, input, botão e ajuda.\n- **icon** - Contêiner do slot de ícone.\n- **action** - Botão de ação lateral.\n- **action-button** - Botão interno reexportado do br-button da ação.\n- **help-text** - Texto de ajuda ou slot de ajuda.\n- **feedback** - Slot de feedback.",
       "attributes": [
         {
           "name": "type",
@@ -2274,7 +2270,7 @@
     },
     {
       "name": "br-loading",
-      "description": "O componente `br-loading` é o indicador de carregamento e progresso do GovBR-DS, utilizado para informar visualmente e de forma acessível que uma operação assíncrona está em execução no sistema.\n\n### Para que serve\n\n- **Feedback de processamento:** Alerta a pessoa usuária de que uma requisição, cálculo ou carregamento de dados está ocorrendo, evitando múltiplos cliques acidentais.\n- **Modo spinner (indeterminado):** Indicador circular contínuo para operações de duração imprevisível.\n- **Modo progress (determinado):** Indicador com percentual explícito (0 a 100%) para downloads, uploads ou tarefas com progresso mensurável, suportando ação de cancelamento.\n- **Acessibilidade para tecnologias assistivas:** Comunica o estado de carregamento através de regiões acessíveis (`aria-live=\"polite\"` e papéis `progressbar` ou `status`).\n\n### Quando utilizar\n\n- **Utilize quando:**\n  - Uma operação assíncrona demorar mais de 300 a 500 milissegundos para responder.\n  - Durante o envio de formulários volumosos, processamento de arquivos ou transição de telas pesadas.\n- **Evite e prefira outro componente quando:**\n  - A resposta for quase instantânea (menos de 300ms), para evitar piscamento rápido de tela que cause desconforto visual.\n  - A espera ocorrer dentro de um botão durante o clique (use a prop `loading` do próprio `br-button`).\n\n### Estrutura e Slots\n\nO `br-loading` oferece slots para personalização:\n- `label`: Slot para rótulo ou mensagem descritiva do carregamento (substitui a prop `label`).\n- `cancel-button`: Slot para botão customizado de cancelamento no modo `progress`.\n\nPara a documentação completa de design, incluindo diretrizes de acessibilidade e especificações visuais, consulte o [Design System do GovBR](https://www.gov.br/ds/components/loading?tab=designer).\n---\n\n\n### **Events:**\n - **brLoadingChange** - Notifica mudança de progresso no modo `progress`.\n- **brLoadingComplete** - Notifica conclusão do progresso no modo `progress`.\n- **brLoadingReset** - Notifica reinício do progresso no modo `progress`.\n- **brLoadingCancel** - Notifica clique no botão de cancelamento no modo `progress`.\nEste evento não altera o progresso automaticamente.\nA aplicação consumidora define a ação após o cancelamento (ex.: limpar ou ocultar).\n- **brIndeterminateStateChange** - Notifica mudança do estado lógico no modo `spinner`.\n- **brDidShow** - Notifica que o componente foi exibido.\n- **brLoadingShow** - Evento canônico emitido quando o loading é exibido.\n- **brDidHide** - Notifica que o componente foi ocultado.\n- **brLoadingHide** - Evento canônico emitido quando o loading é ocultado.\n\n### **Methods:**\n - **handleCompletion(newValue: _number_)** - Reage a mudanças em `value` no modo `progress`.\n- **handleModeChange()** - Reage a mudanças em `mode` e atualiza o estado lógico de atividade.\n- **setValue(value: _number_): __** - Define o valor do progresso.\n- **incrementValue(step): __** - Soma um valor ao progresso atual.\n- **complete(): __** - Define o progresso como concluído.\n- **reset(): __** - Reinicia o progresso e exibe o componente.\n- **show(): __** - Exibe o componente.\n- **hide(): __** - Oculta o componente.\n- **render(): __** - Renderiza o componente conforme o modo atual.\n\n### **Slots:**\n - **label** - Rótulo customizado do loading. Quando utilizado, a prop `label` é ignorada.\n- **cancel-button** - Conteúdo customizado do botão de cancelar. Quando utilizado, a prop `cancelLabel` é ignorada.\n\n### **CSS Parts:**\n - **container** - Wrapper principal do loading.\n- **wrapper** - Wrapper do conteúdo do spinner/progress.\n- **svg** - Elemento SVG principal do loading.\n- **percentage** - Texto de percentual no modo `progress`.\n- **label-wrapper** - Wrapper do rótulo no modo `spinner`.\n- **cancel-button** - Botão de cancelamento no modo `progress` cancelável.",
+      "description": "O componente `br-loading` é o indicador de carregamento e progresso do GovBR-DS, utilizado para informar visualmente e de forma acessível que uma operação assíncrona está em execução no sistema.\n\n### Para que serve\n\n- **Feedback de processamento:** Alerta a pessoa usuária de que uma requisição, cálculo ou carregamento de dados está ocorrendo, evitando múltiplos cliques acidentais.\n- **Modo spinner (indeterminado):** Indicador circular contínuo para operações de duração imprevisível.\n- **Modo progress (determinado):** Indicador com percentual explícito (0 a 100%) para downloads, uploads ou tarefas com progresso mensurável, suportando ação de cancelamento.\n- **Acessibilidade para tecnologias assistivas:** Comunica o estado de carregamento através de regiões acessíveis (`aria-live=\"polite\"` e papéis `progressbar` ou `status`).\n\n### Quando utilizar\n\n- **Utilize quando:**\n  - Uma operação assíncrona demorar mais de 300 a 500 milissegundos para responder.\n  - Durante o envio de formulários volumosos, processamento de arquivos ou transição de telas pesadas.\n- **Evite e prefira outro componente quando:**\n  - A resposta for quase instantânea (menos de 300ms), para evitar piscamento rápido de tela que cause desconforto visual.\n  - A espera ocorrer dentro de um botão durante o clique (use a prop `loading` do próprio `br-button`).\n\n### Estrutura e Slots\n\nO `br-loading` oferece slots para personalização:\n- `label`: Slot para rótulo ou mensagem descritiva do carregamento (substitui a prop `label`).\n- `cancel-button`: Slot para botão customizado de cancelamento no modo `progress`.\n\nPara a documentação completa de design, incluindo diretrizes de acessibilidade e especificações visuais, consulte o [Design System do GovBR](https://www.gov.br/ds/components/loading?tab=designer).\n---\n\n\n### **Events:**\n - **brLoadingChange** - Notifica mudança de progresso no modo `progress`.\n- **brLoadingComplete** - Notifica conclusão do progresso no modo `progress`.\n- **brLoadingReset** - Notifica reinício do progresso no modo `progress`.\n- **brLoadingCancel** - Notifica clique no botão de cancelamento no modo `progress`.\nEste evento não altera o progresso automaticamente.\nA aplicação consumidora define a ação após o cancelamento (ex.: limpar ou ocultar).\n- **brIndeterminateStateChange** - Notifica mudança do estado lógico no modo `spinner`.\n- **brDidShow** - Notifica que o componente foi exibido.\n- **brLoadingShow** - Evento canônico emitido quando o loading é exibido.\n- **brDidHide** - Notifica que o componente foi ocultado.\n- **brLoadingHide** - Evento canônico emitido quando o loading é ocultado.\n\n### **Methods:**\n - **handleCompletion(newValue: _number_)** - Reage a mudanças em `value` no modo `progress`.\n- **handleModeChange()** - Reage a mudanças em `mode` e atualiza o estado lógico de atividade.\n- **setValue(value: _number_): _Promise<{ value: number }>_** - Define o valor do progresso.\n- **incrementValue(step): _Promise<{ value: number }>_** - Soma um valor ao progresso atual.\n- **complete(): _Promise<{ value: number }>_** - Define o progresso como concluído.\n- **reset(): _Promise<{ value: number }>_** - Reinicia o progresso e exibe o componente.\n- **show(): _Promise<{ visible: boolean }>_** - Exibe o componente.\n- **hide(): _Promise<{ visible: boolean }>_** - Oculta o componente.\n- **render(): __** - Renderiza o componente conforme o modo atual.\n\n### **Slots:**\n - **label** - Rótulo customizado do loading. Quando utilizado, a prop `label` é ignorada.\n- **cancel-button** - Conteúdo customizado do botão de cancelar. Quando utilizado, a prop `cancelLabel` é ignorada.\n\n### **CSS Parts:**\n - **container** - Wrapper principal do loading.\n- **wrapper** - Wrapper do conteúdo do spinner/progress.\n- **svg** - Elemento SVG principal do loading.\n- **percentage** - Texto de percentual no modo `progress`.\n- **label-wrapper** - Wrapper do rótulo no modo `spinner`.\n- **cancel-button** - Botão de cancelamento no modo `progress` cancelável.",
       "attributes": [
         {
           "name": "label-position",
@@ -3305,7 +3301,7 @@
     },
     {
       "name": "br-select",
-      "description": "O componente `br-select` é o controle oficial de seleção do GovBR-DS, desenvolvido para permitir que o usuário escolha uma ou múltiplas opções a partir de uma lista expansível. Compatível com o padrão WAI-ARIA Combobox, ele reúne em um único componente acessível o campo de acionamento/digitação, a lista suspensa e as opções selecionáveis, integrando-se nativamente a formulários HTML e frameworks modernos.\n\n### Para que serve\n\nO `br-select` gerencia todo o fluxo de interação de seleção:\n- **Seleção simples e múltipla:** Permite selecionar uma única opção ou múltiplas opções (`multiple`), incluindo a opção de selecionar ou desmarcar todas em lote.\n- **Busca e filtragem:** Oferece filtro local integrado (conforme o usuário digita) e suporte a busca remota assíncrona (`search-mode=\"remote\"`), disparando eventos para carregamento sob demanda via API.\n- **Agrupamento de opções:** Organiza opções contíguas por categoria, preservando virtualização, busca local e semântica nativa de formulário.\n- **Integração com formulários:** É associado a formulários nativos (`formAssociated`), comunicando seu valor, estado de validação (válido/inválido), mensagens de erro contextuais e eventos padrão (`change`, `input`).\n- **Navegação acessível:** Suporta controle total via teclado (setas para cima/baixo, Enter, Escape, Home, End), foco gerenciado e anúncios para leitores de tela.\n\n### Quando utilizar\n\n- **Utilize quando:**\n  - O número de opções for moderado a grande (mais de 5 a 7 itens), onde listar todas diretamente na tela consumiria muito espaço visual.\n  - For necessário filtrar opções por texto (digitação em lista longa).\n  - As opções forem carregadas dinamicamente de uma API externa (busca remota/paginada).\n  - O espaço no leiaute for restrito e exigir um controle compacto e expansível.\n- **Evite e prefira outro componente quando:**\n  - Houver poucas opções fixas (de 2 a 4 opções mutuamente exclusivas): prefira `br-radio` ou `br-radio-group` para manter as alternativas imediatamente visíveis.\n  - Houver uma escolha binária (sim/não, ativo/inativo): prefira `br-switch` ou `br-checkbox`.\n  - Houver seleção múltipla com até 4 alternativas: prefira `br-checkbox` ou um grupo de checkboxes visíveis.\n\n### Composição e Subcomponentes\n\nO ecossistema do Select é composto pelo elemento principal orquestrador e três subcomponentes especializados:\n\n| Subcomponente | Papel | Regra de uso |\n| --- | --- | --- |\n| `br-select` | **Orquestrador principal.** Gerencia o valor, ciclo de vida, acessibilidade, busca, formulário e renderização dos elementos internos. | Deve ser o único componente diretamente instanciado no template da aplicação. |\n| `br-select-input` | **Campo de acionamento.** Exibe o valor selecionado, o rótulo (`label`), o campo de busca/digitação e o botão de expandir/recolher. | Coordenado automaticamente pelo `br-select`; utilize isoladamente apenas em composições arquiteturais avançadas. |\n| `br-select-list` | **Lista suspensa virtualizada.** Contêiner flutuante que renderiza as opções de forma otimizada com suporte a rolagem e virtualização. | Gerenciada exclusivamente pelo `br-select`; não deve ser usada como controle autônomo. |\n| `br-select-option` | **Item individual de opção.** Representa um valor selecionável, exibindo texto, estado de seleção e checkbox/radio associado. | Deve ser declarado dentro do slot padrão do `br-select` para cada opção desejada. |\n\nAlém dos subcomponentes, o `br-select` oferece slots dedicados:\n- `default`: Slot principal onde são passados os elementos `br-select-option`.\n- `feedback`: Slot para exibição de mensagens de validação (ex.: `br-message`).\n- `loading`: Slot para indicador de carregamento durante busca remota.\n- `validation-loading`: Slot para indicador visual durante validação assíncrona.\n\n### Como fornecer opções\n\nO `br-select` possui uma API declarativa canônica e uma API imperativa para atualizações dinâmicas:\n\n1. **Slot com `br-select-option`:** é a forma declarativa canônica para código novo. O pai lê os atributos e o conteúdo de cada opção e os transforma em dados para a lista. Em frameworks, a coleção também pode ser renderizada como vários elementos `br-select-option`.\n2. **Método `setOptions()`:** substitui a coleção de forma imperativa e deve ser reservado para dados dinâmicos, especialmente respostas de busca remota. A lista recebe os objetos e cria internamente somente a janela visível de opções.\n\n`br-select-input` e `br-select-list` não substituem essas fontes. Eles são peças internas da composição: o primeiro controla o campo de acionamento e busca; o segundo recebe a coleção normalizada e renderiza a lista virtualizada.\n\nEvite misturar slot e dados imperativos sem necessidade. Na inicialização, opções declaradas no slot têm precedência quando existem. Depois que `options` é alterada ou `setOptions()` é chamado, a coleção imperativa passa a ser a fonte de dados e alterações posteriores no slot não são sincronizadas.\n\nA prop `options` é uma API legada e está depreciada. Ela continua funcionando apenas para preservar compatibilidade: no HTML, recebe uma string JSON; em JavaScript e frameworks, recebe um array por property binding. Não a adote em código novo; use `br-select-option` ou, para respostas dinâmicas/remotas, `setOptions()`.\n\nCada objeto deve conter `value` string e pode conter `label`, `selected`, `disabled`, `indeterminate` e `content`. `content` é renderizado como HTML na lista; não use esse campo com conteúdo não confiável.\n\n### O Conceito \"Lego\" e a Diferença entre os Componentes {#conceito-lego}\n\nO ecossistema de seleção do GovBR-DS foi projetado seguindo o **conceito de peças de Lego**: modular, flexível e combinável:\n\n1. **`br-select` (Componente Principal / Modelo Pronto):**\n   É o **componente principal**. Já vem montado com todas as peças essenciais integradas: o acionador (`br-select-input`), a lista flutuante virtualizada (`br-select-list`), a navegação por teclado e a integração nativa com formulários (`formAssociated`). Na quase totalidade das aplicações (99% dos casos), você deve usar apenas `<br-select>`.\n\n2. **`br-select-option` (Peça de Conteúdo):**\n   É a peça de Lego que você encaixa diretamente no slot padrão do `<br-select>` para definir cada valor selecionável.\n\n3. **`br-select-input` e `br-select-list` (Subcomponentes Internos):**\n   São as peças internas que formam a estrutura do `br-select`. No uso comum, **não devem ser declarados manualmente**, pois o `br-select` já os instancia e os sincroniza automaticamente.\n\n#### Quando usar apenas `<br-select>`?\nUse apenas `<br-select>` em quase todos os fluxos. Para opções fixas, declare os itens `<br-select-option>` no slot padrão; para opções dinâmicas, alimente a coleção com `setOptions()`. A prop `options` permanece disponível somente para compatibilidade legada.\n\n#### Quando montar os componentes separadamente?\nA montagem separada das peças avulsas de Lego (`br-select-input` + `br-select-list` + `br-select-option`) destina-se exclusivamente a **composições arquiteturais avançadas**, onde o leiaute exige desacoplar fisicamente o campo de acionamento da lista suspensa (ex.: campo de busca fixo na barra superior e a lista exibida dentro de um drawer ou modal lateral). Nesse caso, a aplicação precisa implementar manualmente a sincronização de foco, abertura, navegação por teclado e repasse de valor ao formulário.\n\n### Como os subcomponentes se relacionam\n\nA arquitetura do `br-select` segue o padrão de **orquestrador centralizado**:\n1. **O componente pai coordena o estado:** A aplicação declara o `<br-select>` com múltiplos `<br-select-option>` filhos ou usa `setOptions()` para dados dinâmicos. O `br-select` projeta internamente o `<br-select-input>` e a `<br-select-list>`, garantindo sincronia total de foco, estados de abertura, termos pesquisados e eventos. A prop `options` não é uma alternativa para código novo; existe somente para compatibilidade legada.\n2. **Evite montagem manual desarticulada:** Tentar declarar manualmente `br-select-input` e `br-select-list` fora do `br-select` quebra as relações de acessibilidade WAI-ARIA (combobox, controles expandidos, aria-activedescendant) e desvincula o controle da validação nativa de formulários (`ElementInternals`).\n3. **Comunicação por eventos:** Para busca remota ou resposta a seleção, a aplicação escuta os eventos disparados diretamente pelo `br-select` (`brSearch`, `change`, `input`), sem precisar interceptar nós internos da lista ou do campo de texto.\n\nPara a documentação completa de design, incluindo diretrizes de acessibilidade e especificações visuais, consulte o [Design System do GovBR](https://www.gov.br/ds/components/select?tab=designer).\n---\n\n\n### **Events:**\n - **brSelectStateChange** - Evento emitido quando o estado público do select muda.\n- **valueChange** - Evento emitido quando o valor público do select é alterado.\n- **optionHover** - Emite a opção que recebeu foco ou hover.\n- **brSelectSearch** - Emitido uma vez por edição do campo de busca, inclusive ao limpar a consulta.\nO `detail` contém `{ query }`; o evento é informativo e não cancelável.\nA aplicação deve controlar debounce, transporte e ciclo de vida da busca.\n- **opened** - Emitido quando a lista é aberta.\n- **closed** - Emitido quando a lista é fechada.\n- **brSelectValidationChange** - Informa o início e o resultado de uma validação síncrona ou assíncrona.\nO `detail` contém `validating`, `valid` e `message`.\n\n### **Methods:**\n - **handleSelectOptionPropsChange(event: _Event_)** - Recalcula a coleção quando uma opção projetada muda por atribuição direta\nde `selected`, `disabled`, `label`, `group` ou `value`. A lista virtualizada em\nShadow DOM não é uma fonte independente; ela recebe o snapshot pelo seu\ncontrato público `options`.\n- **enable(): __** - Habilita o select para interação do usuário.\n- **disable(): __** - Desabilita o select e impede novas interações.\n- **show(): __** - Abre a lista de opções quando o componente está habilitado.\n- **close(): __** - Fecha a lista de opções quando o componente está habilitado.\n- **toggleOpen(): _Promise<void>_** - Alterna entre os estados aberto e fechado do select.\n- **clear(): _Promise<void>_** - @deprecated Use `setValue('')` ou a API de formulário. - Limpa a seleção atual.\n- **getValue(): _Promise<string | string[]>_** - @deprecated Leia a propriedade `value` diretamente. - Retorna o valor público atual.\n- **setValue(value: _string | string[]_): _Promise<void>_** - @deprecated Atribua a propriedade `value` diretamente. - Define o valor público do select.\n- **setFocus(): _Promise<void>_** - @deprecated Use o foco nativo do componente quando possível. - Move o foco para o campo interno.\n- **setOptions(options: _SelectOptionData[]_): __** - Substitui a coleção atual de opções por uma nova lista.\n- **setOption(option: _SelectOptionData_): __** - Adiciona ou atualiza uma única opção na coleção interna.\n\n### **Slots:**\n - **default** - Opções declaradas com elementos br-select-option.\n- **feedback** - Mensagem de validação, normalmente um br-message.\n- **validation-loading** - Indicador exibido durante validação assíncrona.\n- **loading** - Indicador exibido durante a busca remota de opções.\n\n### **CSS Parts:**\n - **container** - Contêiner visual principal do select.\n- **input** - Campo de seleção e busca.\n- **input-container** - Contêiner visual do campo.\n- **input-label** - Rótulo do campo.\n- **input-field** - Campo input nativo.\n- **input-group** - Grupo visual do campo.\n- **input-icon** - Ícone do campo.\n- **input-action** - Botão de abertura e fechamento.\n- **input-action-button** - Botão interno da ação.\n- **list** - Lista de opções.\n- **option** - Opção individual.\n- **option-group** - Cabeçalho visual de um grupo de opções.\n- **select-all** - Alias legado para a opção de selecionar todos.\n- **empty-option** - Alias legado para a opção vazia da lista.\n- **option-checkbox** - Alias legado para o checkbox da opção.\n- **option-radio** - Alias legado para o radio da opção.\n- **hidden-select** - Select nativo invisível usado na integração com formulários.\n- **feedback** - Área de mensagem de validação.\n- **validation-loading** - Área do indicador de validação assíncrona.",
+      "description": "O componente `br-select` é o controle oficial de seleção do GovBR-DS, desenvolvido para permitir que o usuário escolha uma ou múltiplas opções a partir de uma lista expansível. Compatível com o padrão WAI-ARIA Combobox, ele reúne em um único componente acessível o campo de acionamento/digitação, a lista suspensa e as opções selecionáveis, integrando-se nativamente a formulários HTML e frameworks modernos.\n\n### Para que serve\n\nO `br-select` gerencia todo o fluxo de interação de seleção:\n- **Seleção simples e múltipla:** Permite selecionar uma única opção ou múltiplas opções (`multiple`), incluindo a opção de selecionar ou desmarcar todas em lote.\n- **Busca e filtragem:** Oferece filtro local integrado (conforme o usuário digita) e suporte a busca remota assíncrona (`search-mode=\"remote\"`), disparando eventos para carregamento sob demanda via API.\n- **Agrupamento de opções:** Organiza opções contíguas por categoria, preservando virtualização, busca local e semântica nativa de formulário.\n- **Integração com formulários:** É associado a formulários nativos (`formAssociated`), comunicando seu valor, estado de validação (válido/inválido), mensagens de erro contextuais e eventos padrão (`change`, `input`).\n- **Navegação acessível:** Suporta controle total via teclado (setas para cima/baixo, Enter, Escape, Home, End), foco gerenciado e anúncios para leitores de tela.\n\n### Navegação por teclado\n\nO foco permanece no campo `combobox` enquanto a lista está aberta; a opção em destaque é comunicada por `aria-activedescendant`.\nAo receber foco, o campo abre a lista sem alterar a seleção atual.\n\n- **ArrowDown / ArrowUp:** abre a lista e destaca a próxima opção na direção pressionada; com a lista aberta, move o destaque sem mover o foco físico.\n- **Home / End:** em modo não filtrável, destaca a primeira ou a última opção habilitada; em modo filtrável, preserva o movimento do cursor no texto.\n- **Enter:** abre a lista quando fechada e confirma a opção destacada quando aberta.\n- **Espaço:** confirma a opção destacada em modo não filtrável; em modo filtrável, insere um espaço no campo de busca.\n- **Escape:** fecha a lista, remove o destaque e devolve o foco ao campo.\n- **Tab:** fecha a lista e deixa o navegador mover o foco para o próximo controle, sem alterar a seleção implicitamente.\n- **Busca incremental:** em modo não filtrável, caracteres consecutivos destacam a primeira opção habilitada correspondente; em modo filtrável, a digitação filtra a lista.\n- **Alt+ArrowDown / Alt+ArrowUp:** abre ou fecha a lista sem alterar a seleção.\n\n### Quando utilizar\n\n- **Utilize quando:**\n  - O número de opções for moderado a grande (mais de 5 a 7 itens), onde listar todas diretamente na tela consumiria muito espaço visual.\n  - For necessário filtrar opções por texto (digitação em lista longa).\n  - As opções forem carregadas dinamicamente de uma API externa (busca remota/paginada).\n  - O espaço no leiaute for restrito e exigir um controle compacto e expansível.\n- **Evite e prefira outro componente quando:**\n  - Houver poucas opções fixas (de 2 a 4 opções mutuamente exclusivas): prefira `br-radio` ou `br-radio-group` para manter as alternativas imediatamente visíveis.\n  - Houver uma escolha binária (sim/não, ativo/inativo): prefira `br-switch` ou `br-checkbox`.\n  - Houver seleção múltipla com até 4 alternativas: prefira `br-checkbox` ou um grupo de checkboxes visíveis.\n\n### Composição e Subcomponentes\n\nO ecossistema do Select é composto pelo elemento principal orquestrador e três subcomponentes especializados:\n\n| Subcomponente | Papel | Regra de uso |\n| --- | --- | --- |\n| `br-select` | **Orquestrador principal.** Gerencia o valor, ciclo de vida, acessibilidade, busca, formulário e renderização dos elementos internos. | Deve ser o único componente diretamente instanciado no template da aplicação. |\n| `br-select-input` | **Campo de acionamento.** Exibe o valor selecionado, o rótulo (`label`), o campo de busca/digitação e o botão de expandir/recolher. | Coordenado automaticamente pelo `br-select`; utilize isoladamente apenas em composições arquiteturais avançadas. |\n| `br-select-list` | **Lista suspensa virtualizada.** Contêiner flutuante que renderiza as opções de forma otimizada com suporte a rolagem e virtualização. | Gerenciada exclusivamente pelo `br-select`; não deve ser usada como controle autônomo. |\n| `br-select-option` | **Item individual de opção.** Representa um valor selecionável, exibindo texto, estado de seleção e checkbox/radio associado. | Deve ser declarado dentro do slot padrão do `br-select` para cada opção desejada. |\n\nAlém dos subcomponentes, o `br-select` oferece slots dedicados:\n- `default`: Slot principal onde são passados os elementos `br-select-option`.\n- `feedback`: Slot para exibição de mensagens de validação (ex.: `br-message`).\n- `loading`: Slot para indicador de carregamento durante busca remota.\n- `validation-loading`: Slot para indicador visual durante validação assíncrona.\n\n### Como fornecer opções\n\nO `br-select` possui uma API declarativa canônica e uma API imperativa para atualizações dinâmicas:\n\n1. **Slot com `br-select-option`:** é a forma declarativa canônica para código novo. O pai lê os atributos e o conteúdo de cada opção e os transforma em dados para a lista. Em frameworks, a coleção também pode ser renderizada como vários elementos `br-select-option`.\n2. **Método `setOptions()`:** substitui a coleção de forma imperativa e deve ser reservado para dados dinâmicos, especialmente respostas de busca remota. A lista recebe os objetos e cria internamente somente a janela visível de opções.\n\n`br-select-input` e `br-select-list` não substituem essas fontes. Eles são peças internas da composição: o primeiro controla o campo de acionamento e busca; o segundo recebe a coleção normalizada e renderiza a lista virtualizada.\n\nEvite misturar slot e dados imperativos sem necessidade. Na inicialização, opções declaradas no slot têm precedência quando existem. Depois que `options` é alterada ou `setOptions()` é chamado, a coleção imperativa passa a ser a fonte de dados e alterações posteriores no slot não são sincronizadas.\n\nA prop `options` é uma API legada e está depreciada. Ela continua funcionando apenas para preservar compatibilidade: no HTML, recebe uma string JSON; em JavaScript e frameworks, recebe um array por property binding. Não a adote em código novo; use `br-select-option` ou, para respostas dinâmicas/remotas, `setOptions()`.\n\nCada objeto deve conter `value` string e pode conter `label`, `selected`, `disabled`, `indeterminate` e `content`. `content` é renderizado como HTML na lista; não use esse campo com conteúdo não confiável.\n\n### O Conceito \"Lego\" e a Diferença entre os Componentes {#conceito-lego}\n\nO ecossistema de seleção do GovBR-DS foi projetado seguindo o **conceito de peças de Lego**: modular, flexível e combinável:\n\n1. **`br-select` (Componente Principal / Modelo Pronto):**\n   É o **componente principal**. Já vem montado com todas as peças essenciais integradas: o acionador (`br-select-input`), a lista flutuante virtualizada (`br-select-list`), a navegação por teclado e a integração nativa com formulários (`formAssociated`). Na quase totalidade das aplicações (99% dos casos), você deve usar apenas `<br-select>`.\n\n2. **`br-select-option` (Peça de Conteúdo):**\n   É a peça de Lego que você encaixa diretamente no slot padrão do `<br-select>` para definir cada valor selecionável.\n\n3. **`br-select-input` e `br-select-list` (Subcomponentes Internos):**\n   São as peças internas que formam a estrutura do `br-select`. No uso comum, **não devem ser declarados manualmente**, pois o `br-select` já os instancia e os sincroniza automaticamente.\n\n#### Quando usar apenas `<br-select>`?\nUse apenas `<br-select>` em quase todos os fluxos. Para opções fixas, declare os itens `<br-select-option>` no slot padrão; para opções dinâmicas, alimente a coleção com `setOptions()`. A prop `options` permanece disponível somente para compatibilidade legada.\n\n#### Quando montar os componentes separadamente?\nA montagem separada das peças avulsas de Lego (`br-select-input` + `br-select-list` + `br-select-option`) destina-se exclusivamente a **composições arquiteturais avançadas**, onde o leiaute exige desacoplar fisicamente o campo de acionamento da lista suspensa (ex.: campo de busca fixo na barra superior e a lista exibida dentro de um drawer ou modal lateral). Nesse caso, a aplicação precisa implementar manualmente a sincronização de foco, abertura, navegação por teclado e repasse de valor ao formulário.\n\n### Como os subcomponentes se relacionam\n\nA arquitetura do `br-select` segue o padrão de **orquestrador centralizado**:\n1. **O componente pai coordena o estado:** A aplicação declara o `<br-select>` com múltiplos `<br-select-option>` filhos ou usa `setOptions()` para dados dinâmicos. O `br-select` projeta internamente o `<br-select-input>` e a `<br-select-list>`, garantindo sincronia total de foco, estados de abertura, termos pesquisados e eventos. A prop `options` não é uma alternativa para código novo; existe somente para compatibilidade legada.\n2. **Evite montagem manual desarticulada:** Tentar declarar manualmente `br-select-input` e `br-select-list` fora do `br-select` quebra as relações de acessibilidade WAI-ARIA (combobox, controles expandidos, aria-activedescendant) e desvincula o controle da validação nativa de formulários (`ElementInternals`).\n3. **Comunicação por eventos:** Para busca remota ou resposta a seleção, a aplicação escuta os eventos disparados diretamente pelo `br-select` (`brSearch`, `change`, `input`), sem precisar interceptar nós internos da lista ou do campo de texto.\n\nPara a documentação completa de design, incluindo diretrizes de acessibilidade e especificações visuais, consulte o [Design System do GovBR](https://www.gov.br/ds/components/select?tab=designer).\n---\n\n\n### **Events:**\n - **brSelectStateChange** - Evento emitido quando o estado público do select muda.\n- **valueChange** - Evento emitido quando o valor público do select é alterado.\n- **optionHover** - Emite a opção que recebeu foco ou hover.\n- **brSelectSearch** - Emitido uma vez por edição do campo de busca, inclusive ao limpar a consulta.\nO `detail` contém `{ query }`; o evento é informativo e não cancelável.\nA aplicação deve controlar debounce, transporte e ciclo de vida da busca.\n- **opened** - Emitido quando a lista é aberta.\n- **closed** - Emitido quando a lista é fechada.\n- **brSelectValidationChange** - Informa o início e o resultado de uma validação síncrona ou assíncrona.\nO `detail` contém `validating`, `valid` e `message`.\n\n### **Methods:**\n - **handleSelectOptionPropsChange(event: _Event_)** - Recalcula a coleção quando uma opção projetada muda por atribuição direta\nde `selected`, `disabled`, `label`, `group` ou `value`. A lista virtualizada em\nShadow DOM não é uma fonte independente; ela recebe o snapshot pelo seu\ncontrato público `options`.\n- **enable(): _Promise<void>_** - Habilita o select para interação do usuário.\n- **disable(): _Promise<void>_** - Desabilita o select e impede novas interações.\n- **show(): _Promise<void>_** - Abre a lista de opções quando o componente está habilitado.\n- **close(): _Promise<void>_** - Fecha a lista de opções quando o componente está habilitado.\n- **toggleOpen(): _Promise<void>_** - Alterna entre os estados aberto e fechado do select.\n- **clear(): _Promise<void>_** - @deprecated Use `setValue('')` ou a API de formulário. - Limpa a seleção atual.\n- **getValue(): _Promise<string | string[]>_** - @deprecated Leia a propriedade `value` diretamente. - Retorna o valor público atual.\n- **setValue(value: _string | string[]_): _Promise<void>_** - @deprecated Atribua a propriedade `value` diretamente. - Define o valor público do select.\n- **setFocus(): _Promise<void>_** - @deprecated Use o foco nativo do componente quando possível. - Move o foco para o campo interno.\n- **setOptions(options: _SelectOptionData[]_): _Promise<void>_** - Substitui a coleção atual de opções por uma nova lista.\n- **setOption(option: _SelectOptionData_): _Promise<void>_** - Adiciona ou atualiza uma única opção na coleção interna.\n\n### **Slots:**\n - **default** - Opções declaradas com elementos br-select-option.\n- **feedback** - Mensagem de validação, normalmente um br-message.\n- **validation-loading** - Indicador exibido durante validação assíncrona.\n- **loading** - Indicador exibido durante a busca remota de opções.\n\n### **CSS Parts:**\n - **container** - Contêiner visual principal do select.\n- **input** - Campo de seleção e busca.\n- **input-container** - Contêiner visual do campo.\n- **input-label** - Rótulo do campo.\n- **input-field** - Campo input nativo.\n- **input-group** - Grupo visual do campo.\n- **input-icon** - Ícone do campo.\n- **input-action** - Botão de abertura e fechamento.\n- **input-action-button** - Botão interno da ação.\n- **list** - Lista de opções.\n- **option** - Opção individual.\n- **option-group** - Cabeçalho visual de um grupo de opções.\n- **select-all** - Alias legado para a opção de selecionar todos.\n- **empty-option** - Alias legado para a opção vazia da lista.\n- **option-checkbox** - Alias legado para o checkbox da opção.\n- **option-radio** - Alias legado para o radio da opção.\n- **hidden-select** - Select nativo invisível usado na integração com formulários.\n- **feedback** - Área de mensagem de validação.\n- **validation-loading** - Área do indicador de validação assíncrona.",
       "attributes": [
         {
           "name": "borderless",
@@ -3319,7 +3315,7 @@
         },
         {
           "name": "density",
-          "description": "Define a densidade visual compartilhada pelo campo e pela lista de opções.\nAceita `small`, `medium` ou `large`. Valores inválidos usam `medium`.",
+          "description": "Define a densidade visual compartilhada pelo campo e pela lista de opções.\nAceita `small`, `medium` ou `large`. Valores inválidos usam `medium`.\nA opção sintética de selecionar todos permanece com densidade `small`.",
           "values": [{ "name": "BrDensity" }]
         },
         {
@@ -3367,6 +3363,11 @@
           "description": "Define quantas opções extras são renderizadas antes e depois da área visível no virtual scroll.\nDeve ser um inteiro não negativo; valores inválidos usam 1.",
           "values": []
         },
+        {
+          "name": "hide-dividers",
+          "description": "Oculta os divisores entre opções consecutivas, sem alterar a altura das linhas.",
+          "values": []
+        },
         {
           "name": "is-open",
           "description": "Controla o estado aberto/fechado da lista.",
@@ -3473,7 +3474,7 @@
     },
     {
       "name": "br-select-input",
-      "description": "Subcomponente especializado de `br-select` responsável pelo campo de acionamento, entrada de texto e controle de expansão do popup.\n\n### Papel na composição\n- Exibe o rótulo (`label`), texto de espaço reservado (`placeholder`) e o resumo dos itens atualmente selecionados.\n- Atua como campo de entrada textual para digitação de filtros e termos de busca local ou remota.\n- Contém o botão de ação para abrir ou recolher a lista de opções (`br-select-list`), controlando a rotação do ícone indicador.\n\n### Regra de uso e relacionamento\nNa quase totalidade das aplicações, este componente é instanciado e gerenciado internamente pelo orquestrador `br-select`. Ele não fornece nem renderiza a coleção de opções: recebe do pai o valor exibido, o termo de busca e os estados de abertura e desabilitação. Não deve ser declarado manualmente na página, pois depende da coordenação do pai para foco, ARIA, eventos e sincronização com formulários. Use isoladamente apenas em composições arquiteturais altamente customizadas onde a aplicação assumir explicitamente toda a orquestração de foco e estado.\n\nPara a documentação completa de design, consulte o [Design System do GovBR](https://www.gov.br/ds/components/select?tab=designer).\n---\n\n\n### **Events:**\n - **brSelectInputFocus** - Evento emitido quando o campo interno recebe foco.\n- **brSelectInputValueChange** - Evento emitido quando o valor digitado no campo de busca muda.\n- **brSelectInputActionClick** - Evento emitido quando o usuário aciona o ícone de abertura/fechamento.\n- **brSelectInputClick** - Evento emitido quando o usuário clica no campo do select.\n\n### **Methods:**\n - **flipUp(): __** - Atualiza o ícone para o estado visual de lista aberta.\n- **flipDown(): __** - Atualiza o ícone para o estado visual de lista fechada.\n- **setFocus(): __** - Reaplica o foco no input nativo encapsulado por `br-input`.\n\n### **CSS Parts:**\n - **container** - Contêiner visual do campo.\n- **input** - Campo input nativo.\n- **label** - Rótulo do campo.\n- **group** - Grupo visual do campo.\n- **icon** - Ícone do campo.\n- **action** - Botão de ação.\n- **action-button** - Botão interno da ação.",
+      "description": "Subcomponente especializado de `br-select` responsável pelo campo de acionamento, entrada de texto e controle de expansão do popup.\n\n### Papel na composição\n- Exibe o rótulo (`label`), texto de espaço reservado (`placeholder`) e o resumo dos itens atualmente selecionados.\n- Atua como campo de entrada textual para digitação de filtros e termos de busca local ou remota.\n- Contém o botão de ação para abrir ou recolher a lista de opções (`br-select-list`), controlando a rotação do ícone indicador.\n\n### Regra de uso e relacionamento\nNa quase totalidade das aplicações, este componente é instanciado e gerenciado internamente pelo orquestrador `br-select`. Ele não fornece nem renderiza a coleção de opções: recebe do pai o valor exibido, o termo de busca e os estados de abertura e desabilitação. Não deve ser declarado manualmente na página, pois depende da coordenação do pai para foco, ARIA, eventos e sincronização com formulários. Use isoladamente apenas em composições arquiteturais altamente customizadas onde a aplicação assumir explicitamente toda a orquestração de foco e estado.\n\nPara a documentação completa de design, consulte o [Design System do GovBR](https://www.gov.br/ds/components/select?tab=designer).\n---\n\n\n### **Events:**\n - **brSelectInputFocus** - Evento emitido quando o campo interno recebe foco.\n- **brSelectInputValueChange** - Evento emitido quando o valor digitado no campo de busca muda.\n- **brSelectInputActionClick** - Evento emitido quando o usuário aciona o ícone de abertura/fechamento.\n- **brSelectInputClick** - Evento emitido quando o usuário clica no campo do select.\n\n### **Methods:**\n - **flipUp(): _Promise<void>_** - Atualiza o ícone para o estado visual de lista aberta.\n- **flipDown(): _Promise<void>_** - Atualiza o ícone para o estado visual de lista fechada.\n- **setFocus(): _Promise<void>_** - Reaplica o foco no input nativo encapsulado por `br-input`.\n\n### **CSS Parts:**\n - **container** - Contêiner visual do campo.\n- **input** - Campo input nativo.\n- **label** - Rótulo do campo.\n- **group** - Grupo visual do campo.\n- **icon** - Ícone do campo.\n- **action** - Botão de ação.\n- **action-button** - Botão interno da ação.",
       "attributes": [
         {
           "name": "borderless",
@@ -3532,7 +3533,7 @@
         },
         {
           "name": "show-search-icon",
-          "description": "Exibe o ícone de busca dentro do campo.",
+          "description": "Exibe a lupa mesmo quando o campo não é filtrável.\nQuando filterable é true, a lupa é exibida automaticamente.",
           "values": []
         },
         {
@@ -3545,11 +3546,11 @@
     },
     {
       "name": "br-select-list",
-      "description": "Subcomponente de lista virtualizada de opções, projetado para renderizar o conjunto de escolhas do `br-select`.\n\n### Papel na composição\n- Atua como o painel suspenso (popup `listbox`) que exibe os itens `br-select-option`.\n- Implementa virtualização de itens para oferecer alta performance mesmo em listas extensas com centenas ou milhares de opções.\n- Mantém o posicionamento flutuante e controla a rolagem de visualização do item ativo em navegação por teclado.\n\n### Regra de uso e relacionamento\nGerenciado exclusivamente pelo componente pai `br-select`, que injeta a coleção normalizada em `options`, controla o estado de exibição (aberto/fechado), a seleção múltipla e o índice ativo. A prop `options` desta lista é um contrato interno de composição e não substitui a API de opções do `br-select`. A lista cria internamente elementos `br-select-option` para a janela virtualizada, em vez de exibir diretamente os filhos declarados no slot do pai. Não utilize `br-select-list` como controle autônomo de formulário, pois ele não possui associação nativa com formulários (`formAssociated`) nem campo de acionamento próprio.\n\nPara a documentação completa de design, consulte o [Design System do GovBR](https://www.gov.br/ds/components/select?tab=designer).\n---\n\n\n### **Methods:**\n - **open(): __** - Abre a lista e agenda a medição das opções quando necessário.\n- **close(): __** - Fecha a lista de opções.\n- **setOptions(options: _SelectOptionData[]_): __** - Substitui todas as opções renderizadas pela lista.\n- **setOption(option: _SelectOptionData_): __** - Adiciona ou atualiza uma única opção na coleção atual.\n- **setSearchTerm(term: _string_): _Promise<void>_** - Atualiza o termo de busca e reinicia a janela virtual no topo.\n- **setMultiple(isMultiple: _boolean_): __** - Alterna a lista entre modo simples e múltiplo.\n- **getOptions(): __** - Retorna uma cópia das opções atualmente controladas pela lista.\n- **scrollOptionToTop(index: _number_): __** - Posiciona uma opção no topo da viewport virtual, respeitando o limite final da lista.\n- **scrollFirstSelectedOptionToTop(): __** - Posiciona no topo a primeira opção selecionada na ordem visual da lista.\nA opção auxiliar de selecionar tudo não participa dessa escolha.\n- **focusOption(index: _number_): __** - Garante visibilidade e foco para uma opção específica.\n- **setOptionSelected(index: _number_, selected: _boolean_): __** - Aciona a seleção programática de uma opção específica.\n\n### **Slots:**\n - **loading** - Indicador exibido enquanto resultados remotos são carregados.\n\n### **CSS Parts:**\n - **list** - Contêiner visual da lista virtualizada.\n- **loading** - Área do indicador de carregamento.\n- **option-group** - Cabeçalho visual de um grupo de opções.",
+      "description": "Subcomponente de lista virtualizada de opções, projetado para renderizar o conjunto de escolhas do `br-select`.\n\n### Papel na composição\n- Atua como o painel suspenso (popup `listbox`) que exibe os itens `br-select-option`.\n- Implementa virtualização de itens para oferecer alta performance mesmo em listas extensas com centenas ou milhares de opções.\n- Mantém o posicionamento flutuante e controla a rolagem de visualização do item ativo em navegação por teclado.\n\n### Regra de uso e relacionamento\nGerenciado exclusivamente pelo componente pai `br-select`, que injeta a coleção normalizada em `options`, controla o estado de exibição (aberto/fechado), a seleção múltipla e o índice ativo. A prop `options` desta lista é um contrato interno de composição e não substitui a API de opções do `br-select`. A lista cria internamente elementos `br-select-option` para a janela virtualizada, em vez de exibir diretamente os filhos declarados no slot do pai. Não utilize `br-select-list` como controle autônomo de formulário, pois ele não possui associação nativa com formulários (`formAssociated`) nem campo de acionamento próprio.\n\nPara a documentação completa de design, consulte o [Design System do GovBR](https://www.gov.br/ds/components/select?tab=designer).\n---\n\n\n### **Methods:**\n - **open(): _Promise<void>_** - Abre a lista e agenda a medição das opções quando necessário.\n- **close(): _Promise<void>_** - Fecha a lista de opções.\n- **setOptions(options: _SelectOptionData[]_): _Promise<void>_** - Substitui todas as opções renderizadas pela lista.\n- **setOption(option: _SelectOptionData_): _Promise<void>_** - Adiciona ou atualiza uma única opção na coleção atual.\n- **setSearchTerm(term: _string_): _Promise<void>_** - Atualiza o termo de busca e reinicia a janela virtual no topo.\n- **setMultiple(isMultiple: _boolean_): _Promise<void>_** - Alterna a lista entre modo simples e múltiplo.\n- **getOptions(): _Promise<SelectOptionData[]>_** - Retorna uma cópia das opções atualmente controladas pela lista.\n- **scrollOptionToTop(index: _number_): _Promise<boolean>_** - Posiciona uma opção no topo da viewport virtual, respeitando o limite final da lista.\n- **scrollFirstSelectedOptionToTop(): _Promise<boolean>_** - Posiciona no topo a primeira opção selecionada na ordem visual da lista.\nA opção auxiliar de selecionar tudo não participa dessa escolha.\n- **focusOption(index: _number_): _Promise<boolean>_** - Garante visibilidade e foco para uma opção específica.\n- **revealOption(index: _number_): _Promise<boolean>_** - Torna o item ativo visível sem retirar o foco do campo.\n- **setOptionSelected(index: _number_, selected: _boolean_): _Promise<boolean>_** - Aciona a seleção programática de uma opção específica.\n\n### **Slots:**\n - **loading** - Indicador exibido enquanto resultados remotos são carregados.\n\n### **CSS Parts:**\n - **list** - Contêiner visual da lista virtualizada.\n- **loading** - Área do indicador de carregamento.\n- **option-group** - Cabeçalho visual de um grupo de opções.",
       "attributes": [
         {
           "name": "density",
-          "description": "Define a densidade visual da lista, das opções e do indicador de carregamento.\nAceita `small`, `medium` ou `large`. Valores inválidos usam `medium`.",
+          "description": "Define a densidade visual da lista, das opções regulares e do indicador de carregamento.\nA opção sintética de selecionar todos permanece com densidade `small`.\nAceita `small`, `medium` ou `large`. Valores inválidos usam `medium`.",
           "values": [{ "name": "BrDensity" }]
         },
         {
@@ -3582,6 +3583,11 @@
           "description": "Define quantas opções extras são renderizadas fora da viewport quando o virtual scroll está ativo.\nDeve ser um inteiro não negativo; valores inválidos usam 0.",
           "values": []
         },
+        {
+          "name": "hide-dividers",
+          "description": "Oculta os divisores entre opções consecutivas, sem alterar a altura das linhas.",
+          "values": []
+        },
         {
           "name": "select-all-label",
           "description": "Rótulo apresentado para a ação de selecionar todos no modo múltiplo.",
@@ -3602,7 +3608,7 @@
     },
     {
       "name": "br-select-option",
-      "description": "Subcomponente que representa uma opção individual dentro de um `br-select`.\n\n### Papel na composição\n- Define o valor de submissão (`value`) e o rótulo legível exibido para o usuário.\n- Identifica opcionalmente o grupo visual e semântico ao qual a opção pertence.\n- Exibe os estados de seleção (`selected`), desativação (`disabled`) e, no modo de seleção múltipla, o checkbox correspondente.\n- Suporta marcação com destaque textual correspondente aos filtros de busca aplicados.\n\n### Regra de uso e relacionamento\nDeve ser declarado no slot padrão do `br-select` (ou projetado pela lista). É a forma declarativa canônica de fornecer opções em código novo, inclusive quando um framework repete o elemento a partir de uma coleção. O `br-select` lê seus atributos e conteúdo, transforma-os em dados e entrega uma janela virtualizada à lista; portanto, o elemento declarado no slot é a fonte declarativa, não o item visual final da lista. Evite misturá-lo com a prop legada `options` ou com `setOptions()` sem necessidade, pois a coleção imperativa passa a ter precedência depois de ser utilizada. O item comunica suas mudanças de estado ao `br-select` pai, que por sua vez atualiza o valor geral do formulário e o resumo no campo de entrada. O `br-select-option` não deve ser utilizado fora do contexto de seleção.\n\nPara a documentação completa de design, consulte o [Design System do GovBR](https://www.gov.br/ds/components/select?tab=designer).\n---\n\n\n### **Events:**\n - **brSelectOptionStateChange** - Evento emitido quando o estado da opção muda.\n- **brSelectOptionPropsChange** - Evento legado emitido quando as propriedades da opção são alteradas.\n\n### **Methods:**\n - **getItemHeight(): __** - Retorna a altura efetiva da opção para cálculo de virtual scroll.\n- **setFocus(): __** - Encaminha o foco para o elemento interativo interno da opção.\n- **setSelectedState(selected: _boolean_): _Promise<void>_** - Atualiza programaticamente o estado selecionado da opção.\n\n### **Slots:**\n - **default** - Conteúdo ou rótulo visual da opção.\n\n### **CSS Parts:**\n - **option** - Item visual da opção.\n- **checkbox** - Checkbox exibido no modo múltiplo.",
+      "description": "Subcomponente que representa uma opção individual dentro de um `br-select`.\n\n### Papel na composição\n- Define o valor de submissão (`value`) e o rótulo legível exibido para o usuário.\n- Identifica opcionalmente o grupo visual e semântico ao qual a opção pertence.\n- Exibe os estados de seleção (`selected`), desativação (`disabled`) e, no modo de seleção múltipla, o checkbox correspondente.\n- Suporta marcação com destaque textual correspondente aos filtros de busca aplicados.\n\n### Regra de uso e relacionamento\nDeve ser declarado no slot padrão do `br-select` (ou projetado pela lista). É a forma declarativa canônica de fornecer opções em código novo, inclusive quando um framework repete o elemento a partir de uma coleção. O `br-select` lê seus atributos e conteúdo, transforma-os em dados e entrega uma janela virtualizada à lista; portanto, o elemento declarado no slot é a fonte declarativa, não o item visual final da lista. Evite misturá-lo com a prop legada `options` ou com `setOptions()` sem necessidade, pois a coleção imperativa passa a ter precedência depois de ser utilizada. O item comunica suas mudanças de estado ao `br-select` pai, que por sua vez atualiza o valor geral do formulário e o resumo no campo de entrada. O `br-select-option` não deve ser utilizado fora do contexto de seleção.\n\nPara a documentação completa de design, consulte o [Design System do GovBR](https://www.gov.br/ds/components/select?tab=designer).\n---\n\n\n### **Events:**\n - **brSelectOptionStateChange** - Evento emitido quando o estado da opção muda.\n- **brSelectOptionPropsChange** - Evento legado emitido quando as propriedades da opção são alteradas.\n\n### **Methods:**\n - **getItemHeight(): _Promise<number>_** - Retorna a altura efetiva da opção para cálculo de virtual scroll.\n- **setFocus(): _Promise<void>_** - Encaminha o foco para o elemento interativo interno da opção.\n- **setSelectedState(selected: _boolean_): _Promise<void>_** - Atualiza programaticamente o estado selecionado da opção.\n\n### **Slots:**\n - **default** - Conteúdo ou rótulo visual da opção.\n\n### **CSS Parts:**\n - **option** - Item visual da opção.\n- **checkbox** - Checkbox exibido no modo múltiplo.",
       "attributes": [
         {
           "name": "density",
@@ -4827,7 +4833,7 @@
     },
     {
       "name": "br-wizard",
-      "description": "O componente `br-wizard` é o orquestrador completo de fluxos passo a passo do GovBR-DS, desenvolvido para guiar a pessoa usuária através de formulários e tarefas complexas distribuídas em etapas consecutivas.\n\n### Para que serve\n\n- **Condução guiada de processos:** Apresenta um formulário longo dividido em etapas menores e focadas, reduzindo a carga cognitiva e o índice de abandono.\n- **Barra de progresso e navegação integradas:** Combina o indicador visual de etapas (`step`), os painéis de conteúdo de cada etapa (`br-wizard-panel`) e a barra de ações com botões de \"Voltar\", \"Avançar\", \"Concluir\" e \"Cancelar\".\n- **Validação por etapa:** Permite interceptar o avanço de cada passo para validação antes de liberar o próximo painel.\n\n### Quando utilizar\n\n- **Utilize quando:**\n  - Houver um processo de cadastro, requerimento, compra ou configuração estruturado em etapas com dependência de sequência.\n  - For essencial oferecer navegação pré-programada de retorno e avanço com controle de estado.\n- **Evite e prefira outro componente quando:**\n  - O objetivo for apenas mostrar o status de um pedido já concluído (use `br-step` simples).\n  - O usuário puder navegar em qualquer ordem entre as seções da tela (use `br-tab`).\n\n### Composição e Subcomponentes\n\n| Subcomponente | Papel | Regra de uso |\n| --- | --- | --- |\n| `br-wizard` | **Orquestrador principal.** Gerencia a barra de progresso, ações de navegação (voltar/avançar), botões de rodapé e controle do painel ativo. | Deve ser o contêiner raiz do fluxo. |\n| `br-wizard-panel` | **Painel de etapa individual.** Contém os campos e formulários de uma etapa específica. | Declarado dentro do slot padrão do `br-wizard`. |\n\n### Como os subcomponentes se relacionam\n\nO `br-wizard` gerencia ativamente os elementos `br-wizard-panel` declarados em seu interior:\n1. O pai exibe apenas o painel correspondente à etapa atual (`activeStep`), mantendo os demais ocultos.\n2. Ao avançar ou retroceder, o `br-wizard` dispara eventos de validação e troca de etapa (`brStepChange`), atualizando simultaneamente o cabeçalho de progresso e as ações do rodapé.\n\nPara a documentação completa de design, incluindo diretrizes de acessibilidade e especificações visuais, consulte o [Design System do GovBR](https://www.gov.br/ds/components/wizard?tab=designer).\n---\n\n\n### **Events:**\n - **brWizardStepChange** - Evento emitido APÓS mudar de etapa com sucesso.\n\nEste evento é disparado independente da origem da navegação:\n- Botões \"Avançar\" ou \"Voltar\"\n- Click direto em um step do indicador de progresso\n- Chamadas programáticas via métodos públicos (goToStep, nextStep, etc)\n- **brWizardBeforeStepChange** - Evento emitido ANTES de mudar de etapa (permite validação e cancelamento).\n\nComportamento:\n- Disparado apenas ao AVANÇAR (targetStep > currentStep)\n- Não é disparado ao VOLTAR (targetStep < currentStep)\n- Funciona tanto para cliques nos botões quanto para cliques diretos nos steps\n- Pode ser cancelado com `event.preventDefault()` para bloquear a navegação\n- **brWizardComplete** - Evento emitido ao concluir o wizard (última etapa).\n- **brWizardCancel** - Evento emitido ao cancelar o wizard.\n- **brWizardNavigationBlocked** - Evento emitido quando uma ação é bloqueada (validação falha, progressão linear impedida).\nEmite uma string indicando o motivo: 'linear-progression' ou 'validation-failed'.\nUse getCurrentStepIndex() para obter o contexto da etapa atual.\n\n### **Methods:**\n - **handleProgressionTypeChange()** - Observa mudanças no tipo de progressão.\nAtualiza a navegação dos painéis quando muda entre linear/nonlinear.\n- **handleInitialStepChange()** - Observa mudanças na etapa inicial.\nReinicializa o wizard quando a prop initialStep é alterada externamente.\n- **handleCurrentStepChange(newStep: _number_, oldStep: _number_)** - Observa mudanças na etapa atual (fonte única de verdade).\nSincroniza com br-step, atualiza painéis, anuncia mudança e move foco.\n- **handleSlotChange(event: _Event_)** - Detecta quando o slot muda (painéis adicionados/removidos dinamicamente).\nRedescobre os painéis e ressincroniza o estado.\n- **handleStepChange(event: _CustomEvent<{ activeStep: number }>_)** - Detecta quando o br-step muda de etapa ativa.\nValida e sincroniza a navegação com o componente interno br-step.\n- **nextStep(): __** - Avança para a próxima etapa.\nExecuta validação via evento `brWizardBeforeStepChange` antes de navegar.\n- **next(): _Promise<boolean>_** - Avança para a próxima etapa.\n- **previousStep(): __** - Volta para a etapa anterior.\nNão executa validação ao retornar.\n- **previous(): _Promise<boolean>_** - Retorna para a etapa anterior.\n- **goToStep(stepNumber: _number_): __** - Navega para uma etapa específica.\nExecuta validação se estiver avançando (etapa alvo > etapa atual).\n- **reset(): __** - Retorna à primeira etapa do wizard.\nNão executa validação (útil para reiniciar o fluxo).\n- **getCurrentStep(): __** - Retorna o elemento HTML do painel ativo no momento.\n- **getAllSteps(): __** - Retorna todos os painéis do wizard.\n- **getStepByIndex(stepNumber: _number_): __** - Retorna um painel específico pelo índice.\n- **getCurrentStepIndex(): __** - Retorna o índice (número) da etapa atual.\nA numeração começa em 1 (primeira etapa = 1, segunda = 2, etc).\n- **getTotalSteps(): __** - Retorna o número total de etapas do wizard.\n- **render(): __** - Método de renderização principal do componente.\nMonta a estrutura completa do wizard com acessibilidade integrada.\n\n### **Slots:**\n - **default** - Slot para os painéis de etapa (br-wizard-panel) do wizard.\n- **cancel-button** - Conteúdo customizado do botão de cancelar. Quando utilizado, o texto padrão \"Cancelar\" é substituído.\n- **next-button** - Conteúdo customizado do botão de avançar/concluir. Quando utilizado, os textos padrão \"Avançar\" e \"Concluir\" são substituídos.\n- **previous-button** - Conteúdo customizado do botão de voltar. Quando utilizado, o texto padrão \"Voltar\" é substituído.\n\n### **CSS Parts:**\n - **form** - Área do formulário do wizard.\n- **panel** - Painel ativo do wizard.\n- **progress** - Área de progresso do wizard.\n- **content** - Conteúdo do painel ativo.\n- **buttons** - Área de botões de navegação.",
+      "description": "O componente `br-wizard` é o orquestrador completo de fluxos passo a passo do GovBR-DS, desenvolvido para guiar a pessoa usuária através de formulários e tarefas complexas distribuídas em etapas consecutivas.\n\n### Para que serve\n\n- **Condução guiada de processos:** Apresenta um formulário longo dividido em etapas menores e focadas, reduzindo a carga cognitiva e o índice de abandono.\n- **Barra de progresso e navegação integradas:** Combina o indicador visual de etapas (`step`), os painéis de conteúdo de cada etapa (`br-wizard-panel`) e a barra de ações com botões de \"Voltar\", \"Avançar\", \"Concluir\" e \"Cancelar\".\n- **Validação por etapa:** Permite interceptar o avanço de cada passo para validação antes de liberar o próximo painel.\n\n### Quando utilizar\n\n- **Utilize quando:**\n  - Houver um processo de cadastro, requerimento, compra ou configuração estruturado em etapas com dependência de sequência.\n  - For essencial oferecer navegação pré-programada de retorno e avanço com controle de estado.\n- **Evite e prefira outro componente quando:**\n  - O objetivo for apenas mostrar o status de um pedido já concluído (use `br-step` simples).\n  - O usuário puder navegar em qualquer ordem entre as seções da tela (use `br-tab`).\n\n### Composição e Subcomponentes\n\n| Subcomponente | Papel | Regra de uso |\n| --- | --- | --- |\n| `br-wizard` | **Orquestrador principal.** Gerencia a barra de progresso, ações de navegação (voltar/avançar), botões de rodapé e controle do painel ativo. | Deve ser o contêiner raiz do fluxo. |\n| `br-wizard-panel` | **Painel de etapa individual.** Contém os campos e formulários de uma etapa específica. | Declarado dentro do slot padrão do `br-wizard`. |\n\n### Como os subcomponentes se relacionam\n\nO `br-wizard` gerencia ativamente os elementos `br-wizard-panel` declarados em seu interior:\n1. O pai exibe apenas o painel correspondente à etapa atual (`activeStep`), mantendo os demais ocultos.\n2. Ao avançar ou retroceder, o `br-wizard` dispara eventos de validação e troca de etapa (`brStepChange`), atualizando simultaneamente o cabeçalho de progresso e as ações do rodapé.\n\nPara a documentação completa de design, incluindo diretrizes de acessibilidade e especificações visuais, consulte o [Design System do GovBR](https://www.gov.br/ds/components/wizard?tab=designer).\n---\n\n\n### **Events:**\n - **brWizardStepChange** - Evento emitido APÓS mudar de etapa com sucesso.\n\nEste evento é disparado independente da origem da navegação:\n- Botões \"Avançar\" ou \"Voltar\"\n- Click direto em um step do indicador de progresso\n- Chamadas programáticas via métodos públicos (goToStep, nextStep, etc)\n- **brWizardBeforeStepChange** - Evento emitido ANTES de mudar de etapa (permite validação e cancelamento).\n\nComportamento:\n- Disparado apenas ao AVANÇAR (targetStep > currentStep)\n- Não é disparado ao VOLTAR (targetStep < currentStep)\n- Funciona tanto para cliques nos botões quanto para cliques diretos nos steps\n- Pode ser cancelado com `event.preventDefault()` para bloquear a navegação\n- **brWizardComplete** - Evento emitido ao concluir o wizard (última etapa).\n- **brWizardCancel** - Evento emitido ao cancelar o wizard.\n- **brWizardNavigationBlocked** - Evento emitido quando uma ação é bloqueada (validação falha, progressão linear impedida).\nEmite uma string indicando o motivo: 'linear-progression' ou 'validation-failed'.\nUse getCurrentStepIndex() para obter o contexto da etapa atual.\n\n### **Methods:**\n - **handleProgressionTypeChange()** - Observa mudanças no tipo de progressão.\nAtualiza a navegação dos painéis quando muda entre linear/nonlinear.\n- **handleInitialStepChange()** - Observa mudanças na etapa inicial.\nReinicializa o wizard quando a prop initialStep é alterada externamente.\n- **handleCurrentStepChange(newStep: _number_, oldStep: _number_)** - Observa mudanças na etapa atual (fonte única de verdade).\nSincroniza com br-step, atualiza painéis, anuncia mudança e move foco.\n- **handleSlotChange(event: _Event_)** - Detecta quando o slot muda (painéis adicionados/removidos dinamicamente).\nRedescobre os painéis e ressincroniza o estado.\n- **handleStepChange(event: _CustomEvent<{ activeStep: number }>_)** - Detecta quando o br-step muda de etapa ativa.\nValida e sincroniza a navegação com o componente interno br-step.\n- **nextStep(): _Promise<boolean>_** - Avança para a próxima etapa.\nExecuta validação via evento `brWizardBeforeStepChange` antes de navegar.\n- **next(): _Promise<boolean>_** - Avança para a próxima etapa.\n- **previousStep(): _Promise<boolean>_** - Volta para a etapa anterior.\nNão executa validação ao retornar.\n- **previous(): _Promise<boolean>_** - Retorna para a etapa anterior.\n- **goToStep(stepNumber: _number_): _Promise<boolean>_** - Navega para uma etapa específica.\nExecuta validação se estiver avançando (etapa alvo > etapa atual).\n- **reset(): _Promise<void>_** - Retorna à primeira etapa do wizard.\nNão executa validação (útil para reiniciar o fluxo).\n- **getCurrentStep(): _Promise<HTMLElement | null>_** - Retorna o elemento HTML do painel ativo no momento.\n- **getAllSteps(): _Promise<HTMLElement[]>_** - Retorna todos os painéis do wizard.\n- **getStepByIndex(stepNumber: _number_): _Promise<HTMLElement | null>_** - Retorna um painel específico pelo índice.\n- **getCurrentStepIndex(): _Promise<number>_** - Retorna o índice (número) da etapa atual.\nA numeração começa em 1 (primeira etapa = 1, segunda = 2, etc).\n- **getTotalSteps(): _Promise<number>_** - Retorna o número total de etapas do wizard.\n- **render(): __** - Método de renderização principal do componente.\nMonta a estrutura completa do wizard com acessibilidade integrada.\n\n### **Slots:**\n - **default** - Slot para os painéis de etapa (br-wizard-panel) do wizard.\n- **cancel-button** - Conteúdo customizado do botão de cancelar. Quando utilizado, o texto padrão \"Cancelar\" é substituído.\n- **next-button** - Conteúdo customizado do botão de avançar/concluir. Quando utilizado, os textos padrão \"Avançar\" e \"Concluir\" são substituídos.\n- **previous-button** - Conteúdo customizado do botão de voltar. Quando utilizado, o texto padrão \"Voltar\" é substituído.\n\n### **CSS Parts:**\n - **form** - Área do formulário do wizard.\n- **panel** - Painel ativo do wizard.\n- **progress** - Área de progresso do wizard.\n- **content** - Conteúdo do painel ativo.\n- **buttons** - Área de botões de navegação.",
       "attributes": [
         {
           "name": "step",