@govbr-ds/webcomponents 2.5.0 → 2.6.0

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

@@ -597,12 +597,12 @@
         },
         {
           "name": "icon-to-show",
-          "description": "Identificador Iconify do ícone exibido quando o conteúdo está oculto. O valor padrão usa o registro SVG local.\nPara ícones por classe CSS, use o slot `icon-to-show`.",
+          "description": "Identificador de ícone Font Awesome 5 Free presente no cache local, exibido quando o conteúdo está oculto.\nPara ícones por classe CSS, use o slot `icon-to-show`.",
           "values": []
         },
         {
           "name": "icon-to-hide",
-          "description": "Identificador Iconify do ícone exibido quando o conteúdo está visível. O valor padrão usa o registro SVG local.\nPara ícones por classe CSS, use o slot `icon-to-hide`.",
+          "description": "Identificador de ícone Font Awesome 5 Free presente no cache local, exibido quando o conteúdo está visível.\nPara ícones por classe CSS, use o slot `icon-to-hide`.",
           "values": []
         },
         {
@@ -1518,7 +1518,7 @@
         },
         {
           "name": "icon",
-          "description": "Identificador da rede social. Os ícones oficiais mais comuns são\nrenderizados pelo registro SVG local; use o slot `icon` para uma fonte\ndiferente ou uma classe Font Awesome personalizada.",
+          "description": "Nome do ícone Font Awesome 5 Free presente no cache local, sem o prefixo\n`fa-brands:` (ex.: `instagram`). Use o slot `icon` para conteúdo próprio.",
           "values": []
         },
         {
@@ -1740,7 +1740,7 @@
         },
         {
           "name": "icon-name",
-          "description": "Identificador legado do ícone. Identificadores que pertencem ao registro local são\nrenderizados como SVG empacotado; nomes desconhecidos continuam disponíveis via Iconify\nsomente para compatibilidade.",
+          "description": "Identificador legado do ícone. Nomes no cache local são renderizados como SVG empacotado;\nem `source=\"auto\"`, nomes ausentes usam Iconify como fallback. `source=\"iconify\"` força essa origem.",
           "values": []
         },
         {
@@ -1755,7 +1755,7 @@
         },
         {
           "name": "source",
-          "description": "Define explicitamente a origem do ícone.\nQuando `auto`, o componente prioriza slot, SVG inline e imagem por URL.\nIconify fica apenas como fallback de compatibilidade quando nenhuma fonte própria foi informada.\nAceita `auto`, `iconify`, `image`, `svg` ou `slot`; valores inválidos usam `auto`.",
+          "description": "Define explicitamente a origem do ícone.\nQuando `auto`, o componente prioriza slot, SVG inline, imagem por URL e o cache local Font Awesome 5 Free.\nSe `iconName` não estiver no cache, usa Iconify como fallback. `iconify` força essa origem mesmo para nomes presentes no cache.\nAceita `auto`, `iconify`, `image`, `svg` ou `slot`; valores inválidos usam `auto`.",
           "values": [{ "name": "IconSource" }]
         },
         {
@@ -1810,7 +1810,7 @@
         },
         {
           "name": "lazy",
-          "description": "Controla o comportamento de carregamento do ícone.\n\nComportamento:\n- Padrão (propriedade não definida): carregamento imediato aplicando `noobserver` para evitar problemas de layout shift\n- `lazy={true}`: ativa o carregamento tardio nativo para imagens em `src` e o observer do Iconify no fallback legado\n- `lazy={false}`: carregamento imediato\n\n**Nota**: O padrão foi alterado para carregamento imediato para resolver problemas de deslocamento de layout\nque ocorriam quando ícones eram carregados depois do conteúdo inicial.\n\nSVG inline e conteúdo em slot não precisam de carregamento tardio, pois já estão disponíveis no DOM.",
+          "description": "Controla o comportamento de carregamento do ícone.\n\nComportamento:\n- Padrão (propriedade não definida): carregamento imediato aplicando `noobserver` para evitar problemas de layout shift\n- `lazy={true}`: ativa o carregamento tardio nativo para imagens em `src`\n- `lazy={false}`: carregamento imediato\n\n**Nota**: O padrão foi alterado para carregamento imediato para resolver problemas de deslocamento de layout\nque ocorriam quando ícones eram carregados depois do conteúdo inicial.\n\nSVG inline e conteúdo em slot não precisam de carregamento tardio, pois já estão disponíveis no DOM.",
           "values": []
         }
       ],
@@ -2342,7 +2342,7 @@
     },
     {
       "name": "br-magic-button",
-      "description": "O `br-magic-button` é o botão de ação flutuante (FAB) que destaca a ação primária ou mais frequente da tela.\n\nPode ser exibido apenas com ícone (formato circular) ou expandido com texto descritivo.\n\n```html\n<br-magic-button icon=\"fa6-solid:plus\" aria-label=\"Novo item\"></br-magic-button>\n<br-magic-button icon=\"fa6-solid:plus\">Criar documento</br-magic-button>\n```\n\n### Quando usar\n\n- Ação principal e dominante da tela em dispositivos móveis ou interfaces focadas em uma tarefa única.\n\n### Quando evitar\n\n- Múltiplas ações de mesma importância: use `br-button`.\n- Ações secundárias ou destrutivas.\n\nConsulte as [diretrizes de design do GovBR](https://www.gov.br/ds/components/magic-button?tab=designer).\n---\n\n\n### **Methods:**\n - **render()** - Renderiza o componente.\n\n### **Slots:**\n - **default** - Conteúdo interno do botão (texto ou ícone).\n- **icon** - Ícone customizado do botão. Quando utilizado, a prop `icon` é ignorada.\n\n### **CSS Parts:**\n - **container** - Wrapper principal do magic-button.\n- **button** - Elemento button interno.",
+      "description": "O `br-magic-button` é o botão de ação flutuante (FAB) que destaca a ação primária ou mais frequente da tela.\n\nPode ser exibido apenas com ícone (formato circular) ou expandido com texto descritivo.\n\n```html\n<br-magic-button icon=\"fa-solid:plus\" aria-label=\"Novo item\"></br-magic-button>\n<br-magic-button icon=\"fa-solid:plus\">Criar documento</br-magic-button>\n```\n\n### Quando usar\n\n- Ação principal e dominante da tela em dispositivos móveis ou interfaces focadas em uma tarefa única.\n\n### Quando evitar\n\n- Múltiplas ações de mesma importância: use `br-button`.\n- Ações secundárias ou destrutivas.\n\nConsulte as [diretrizes de design do GovBR](https://www.gov.br/ds/components/magic-button?tab=designer).\n---\n\n\n### **Methods:**\n - **render()** - Renderiza o componente.\n\n### **Slots:**\n - **default** - Conteúdo interno do botão (texto ou ícone).\n- **icon** - Ícone customizado do botão. Quando utilizado, a prop `icon` é ignorada.\n\n### **CSS Parts:**\n - **container** - Wrapper principal do magic-button.\n- **button** - Elemento button interno.",
       "attributes": [
         {
           "name": "custom-id",
@@ -2356,7 +2356,7 @@
         },
         {
           "name": "icon",
-          "description": "Ícone como identificador Iconify (ex.: `fa6-solid:star`) ou nome simples (ex.: `question`,\nresolvido como `fa6-solid:question` no registro SVG local), renderizado pelo `br-icon`.\nPara classes CSS (ex.: Font Awesome) ou SVGs personalizados, use o slot `icon`, a forma preferida.\nUso descontinuado: classes CSS nesta prop (ex.: `fas fa-star`) não são exibidas no Shadow DOM\ne geram aviso.",
+          "description": "Ícone como identificador Font Awesome 5 Free do cache local (ex.: `fa-solid:star`) ou nome simples\n(ex.: `question`, resolvido como `fa-solid:question`), renderizado pelo `br-icon`.\nPara classes CSS (ex.: Font Awesome) ou SVGs personalizados, use o slot `icon`, a forma preferida.\nUso descontinuado: classes CSS nesta prop (ex.: `fas fa-star`) não são exibidas no Shadow DOM\ne geram aviso.",
           "values": []
         },
         {
@@ -2658,7 +2658,7 @@
         },
         {
           "name": "icon",
-          "description": "Identificador da rede social. Os ícones oficiais mais comuns são\nrenderizados pelo registro SVG local; use o slot `icon` para uma fonte\ndiferente ou uma classe Font Awesome personalizada.",
+          "description": "Nome do ícone Font Awesome 5 Free presente no cache local, sem o prefixo\n`fa-brands:` (ex.: `facebook-f`). Use o slot `icon` para conteúdo próprio.",
           "values": []
         }
       ],
@@ -3484,7 +3484,7 @@
     },
     {
       "name": "br-select-input",
-      "description": "Campo de texto e acionamento interno do `br-select`.\n\nÉ gerenciado automaticamente pelo `br-select` para exibir o valor selecionado, receber termos de busca e abrir ou fechar a lista suspensa. Não é necessário utilizá-lo de forma avulsa.\n---\n\n\n### **Events:**\n - **brSelectInputFocus** - Evento emitido quando o campo interno recebe foco.\n- **brSelectInputValueChange** - Evento emitido quando o valor digitado no campo de busca muda.\n- **brSelectInputActionClick** - Evento emitido quando o usuário aciona o ícone de abertura/fechamento.\n- **brSelectInputClick** - Evento emitido quando o usuário clica no campo do select.\n\n### **Methods:**\n - **flipUp(): _Promise<void>_** - Atualiza o ícone para o estado visual de lista aberta.\n- **flipDown(): _Promise<void>_** - Atualiza o ícone para o estado visual de lista fechada.\n- **setFocus(): _Promise<void>_** - Reaplica o foco no input nativo encapsulado por `br-input`.\n\n### **CSS Parts:**\n - **container** - Contêiner visual do campo.\n- **input** - Campo input nativo.\n- **label** - Rótulo do campo.\n- **group** - Grupo visual do campo.\n- **icon** - Ícone do campo.\n- **action** - Botão de ação.\n- **action-button** - Botão interno da ação.\n- **clear** - Botão de limpar o texto digitado.",
+      "description": "Campo de texto e acionamento interno do `br-select`.\n\nÉ gerenciado automaticamente pelo `br-select` para exibir o valor selecionado, receber termos de busca e abrir ou fechar a lista suspensa. Não é necessário utilizá-lo de forma avulsa.\n---\n\n\n### **Events:**\n - **brSelectInputFocus** - Evento emitido quando o campo interno recebe foco.\n- **brSelectInputValueChange** - Evento emitido quando o valor digitado no campo de busca muda.\n- **brSelectInputActionClick** - Evento emitido quando o usuário aciona o ícone de abertura/fechamento.\n- **brSelectInputClick** - Evento emitido quando o usuário clica no campo do select.\n\n### **Methods:**\n - **syncCombobox(state: _SelectComboboxState_): _Promise<void>_** - Sincroniza o estado acessível do campo com o select orquestrador.\n- **flipUp(): _Promise<void>_** - Atualiza o ícone para o estado visual de lista aberta.\n- **flipDown(): _Promise<void>_** - Atualiza o ícone para o estado visual de lista fechada.\n- **setFocus(): _Promise<void>_** - Reaplica o foco no input nativo encapsulado por `br-input`.\n\n### **CSS Parts:**\n - **container** - Contêiner visual do campo.\n- **input** - Campo input nativo.\n- **label** - Rótulo do campo.\n- **group** - Grupo visual do campo.\n- **icon** - Ícone do campo.\n- **action** - Botão de ação.\n- **action-button** - Botão interno da ação.\n- **clear** - Botão de limpar o texto digitado.",
       "attributes": [
         {
           "name": "borderless",
@@ -3628,7 +3628,7 @@
     },
     {
       "name": "br-select-option",
-      "description": "Representa uma opção dentro do `br-select`. Use no slot padrão do componente.\n\nDefina `value` para o valor de formulário e `label` para o texto exibido. Use `selected` para marcar a opção como selecionada inicialmente e `disabled` para desabilitá-la. Para agrupamento, utilize `group`.\n\n```html\n<br-select-option value=\"df\" label=\"Distrito Federal\"></br-select-option>\n```\n---\n\n\n### **Events:**\n - **brSelectOptionStateChange** - Evento emitido quando o estado da opção muda.\n- **brSelectOptionPropsChange** - Evento legado emitido quando as propriedades da opção são alteradas.\n\n### **Methods:**\n - **getItemHeight(): _Promise<number>_** - Retorna a altura efetiva da opção para cálculo de virtual scroll.\n- **setFocus(): _Promise<void>_** - Encaminha o foco para o elemento interativo interno da opção.\n- **setSelectedState(selected: _boolean_): _Promise<void>_** - Atualiza programaticamente o estado selecionado da opção.\n\n### **Slots:**\n - **default** - Conteúdo ou rótulo visual da opção.\n\n### **CSS Parts:**\n - **option** - Item visual da opção.\n- **checkbox** - Checkbox exibido no modo múltiplo.",
+      "description": "Representa uma opção dentro do `br-select`. Use no slot padrão do componente.\n\nDefina `value` para o valor de formulário e `label` para o texto exibido. Use `selected` para marcar a opção como selecionada inicialmente e `disabled` para desabilitá-la. Para agrupamento, utilize `group`.\n\n```html\n<br-select-option value=\"df\" label=\"Distrito Federal\"></br-select-option>\n```\n---\n\n\n### **Events:**\n - **brSelectOptionStateChange** - Evento emitido ao ativar a opção por clique, teclado ou `setSelectedState()`.\nFora de `br-select`, também informa alterações de `selected` e `disabled`.\nDentro de `br-select`, a sincronização dessas props não é uma nova interação.\n- **brSelectOptionPropsChange** - Evento legado emitido quando as propriedades da opção são alteradas.\n\n### **Methods:**\n - **getItemHeight(): _Promise<number>_** - Retorna a altura efetiva da opção para cálculo de virtual scroll.\n- **setFocus(): _Promise<void>_** - Encaminha o foco para o elemento interativo interno da opção.\n- **setSelectedState(selected: _boolean_): _Promise<void>_** - Atualiza programaticamente o estado selecionado da opção.\n\n### **Slots:**\n - **default** - Conteúdo ou rótulo visual da opção.\n\n### **CSS Parts:**\n - **option** - Item visual da opção.\n- **checkbox** - Checkbox exibido no modo múltiplo.",
       "attributes": [
         {
           "name": "density",
@@ -3932,7 +3932,7 @@
         },
         {
           "name": "thumb-icon",
-          "description": "Nome do ícone a ser exibido no interior da alça de controle (thumb).\nNo modo `range`, aplica-se a ambas as alças caso `thumbStartIcon` ou `thumbEndIcon` não sejam especificados.\nExemplo: 'fa-solid:arrows-left-right', 'fa-solid:circle'.",
+          "description": "Nome do ícone a ser exibido no interior da alça de controle (thumb).\nNo modo `range`, aplica-se a ambas as alças caso `thumbStartIcon` ou `thumbEndIcon` não sejam especificados.\nExemplo: 'fa-solid:arrows-alt-h', 'fa-solid:circle'.",
           "values": []
         },
         {
@@ -4216,7 +4216,7 @@
         },
         {
           "name": "icon",
-          "description": "Ícone da aba como identificador Iconify (ex.: `fa6-solid:bell`), renderizado em SVG pelo `br-icon`.\nPara ícones por classe CSS (ex.: Font Awesome), use o slot `icon-{id}` do `br-tab`, a forma\npreferida: `<i slot=\"icon-avisos\" class=\"fas fa-bell\" aria-hidden=\"true\"></i>`.\nO slot tem precedência sobre esta prop.\nUso descontinuado: classes CSS nesta prop (ex.: `fas fa-bell`) não são exibidas no Shadow DOM,\ngeram aviso e devem migrar para o slot `icon-{id}`. Identificadores Iconify continuam suportados.",
+          "description": "Ícone da aba como identificador Font Awesome 5 Free presente no cache local (ex.: `fa-solid:bell`), renderizado pelo `br-icon`.\nPara ícones por classe CSS (ex.: Font Awesome), use o slot `icon-{id}` do `br-tab`, a forma\npreferida: `<i slot=\"icon-avisos\" class=\"fas fa-bell\" aria-hidden=\"true\"></i>`.\nO slot tem precedência sobre esta prop.\nUso descontinuado: classes CSS nesta prop (ex.: `fas fa-bell`) não são exibidas no Shadow DOM,\ngeram aviso e devem migrar para o slot `icon-{id}`. Nomes fora do cache local não são carregados remotamente.",
           "values": []
         },
         {
@@ -4254,185 +4254,491 @@
     },
     {
       "name": "br-table",
-      "description": "O `br-table` estrutura e exibe conjuntos de dados organizados em linhas e colunas.\n\nEstruture a tabela usando os subcomponentes `br-table-header`, `br-table-body`, `br-table-row` e `br-table-cell`. Para exibir um indicador de carregamento durante atualizações assíncronas, use a propriedade `loading`.\n\n```html\n<br-table>\n  <br-table-header slot=\"header\">\n    <br-table-row>\n      <br-table-header-cell>Nome</br-table-header-cell>\n      <br-table-header-cell>Cargo</br-table-header-cell>\n    </br-table-row>\n  </br-table-header>\n  <br-table-body slot=\"body\">\n    <br-table-row>\n      <br-table-cell>Maria Silva</br-table-cell>\n      <br-table-cell>Analista</br-table-cell>\n    </br-table-row>\n  </br-table-body>\n</br-table>\n```\n\n### Quando usar\n\n- Dados bidimensionais com cabeçalhos de coluna e necessidades de ordenação ou comparação.\n\n### Quando evitar\n\n- Listas simples de itens lineares: use `br-list`.\n- Agrupamento de informações de um único registro: use `br-card`.\n\nConsulte as [diretrizes de design do GovBR](https://www.gov.br/ds/components/table?tab=designer).\n---\n\n\n### **Methods:**\n \n\n\n\n\n- **startLoading(): _Promise<void>_** - Inicia o estado de carregamento da tabela.\n- **stopLoading(): _Promise<void>_** - Interrompe o estado de carregamento da tabela.\n- **render(): __** - Renderiza o host do componente.\n\n### **Slots:**\n - **loading** - Indicador exibido enquanto as linhas são atualizadas.\n\n### **CSS Parts:**\n - **container** - Wrapper principal da tabela.\n- **content** - Área de conteúdo que contém header e body.\n- **loading** - Área do indicador de carregamento.",
+      "description": "## Design System\n\nPara a documentação completa de design, incluindo diretrizes de uso, acessibilidade e exemplos visuais, consulte o [Design System do GovBR](https://www.gov.br/ds/components/table?tab=designer).\n\nApresenta e permite interagir com dados tabulares; não deve ser usada para\norganizar layout ou conteúdo que não seja tabular. Recebe o cabeçalho e o corpo\npelos slots `header` e `body`, compostos por `br-table-header` e\n`br-table-header-cell`, e por `br-table-body`, `br-table-row` e `br-table-cell`.\nOrquestra a grade, a acessibilidade, a ordenação, a seleção e a expansão das\nlinhas. A barra de ações é gerenciada pela tabela; `br-table-footer` é\nrenderizado quando a paginação está habilitada. As propriedades de célula\nseguem, quando aplicável, a precedência: célula, linha, coluna, tabela e valor\npadrão. Cabeçalhos multinível usam várias linhas em `br-table-header` com\n`colSpan`/`rowSpan`. Linhas contíguas com `rowGroup` formam unidades de ordenação,\npaginação e virtualização; a seleção permanece individual. Células com `rowSpan`\nnão atravessam os limites do grupo. Prefira tabelas simples quando possível.\n---\n\n\n### **Events:**\n - **brTableActionClick** - Quando uma ação pública é acionada.\n- **brTableSelectionChange** - Quando o conjunto selecionado muda.\n- **brTableRowExpansionChange** - Quando uma linha expande ou recolhe.\n- **brTableSortRequest** - Antes de aplicar uma solicitação de ordenação.\n- **brTableSortChange** - Quando os critérios de ordenação mudam.\n- **brTablePageChange** - Quando o consumidor solicita outra página pela paginação do rodapé.\n- **brTablePageSizeChange** - Quando o consumidor solicita outra quantidade de itens por página.\n- **brTableSearch** - Quando a busca é enviada ou fechada.\n- **brTableActionClick** - Reemite ações globais, contextuais e de linha para o consumidor.\n- **brTableSelectionChange** - Emitido quando o conjunto de linhas selecionadas muda.\n- **brTableRowExpansionChange** - Emitido quando uma linha é expandida ou recolhida.\n- **brTableSortChange** - Emitido sempre que o conjunto de critérios de ordenação muda.\n- **brTableSortRequest** - Emitido antes de aplicar uma solicitação de ordenação; `preventDefault()` cancela a mudança local.\n- **brTablePageChange** - Emitido quando o consumidor solicita outra página pela paginação do rodapé.\n- **brTablePageSizeChange** - Emitido quando o consumidor solicita outra quantidade de itens por página; atualize `visibleRows` ao tratar.\n- **brTableSearch** - Evento customizado originado em `br-table-bar` e propagado pela tabela,\nsem reemissão. Envia `{ term }` por Enter ou botão e `{ term: '' }` ao fechar.\nDigitação, inicialização e alterações programáticas não emitem o evento.\nPropaga, atravessa Shadow DOM e é cancelável.\n\n### **Methods:**\n \n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n- **startLoading(): _Promise<void>_** - Inicia o estado visual de carregamento sem alterar os dados da tabela.\n- **stopLoading(): _Promise<void>_** - Interrompe o estado visual de carregamento sem alterar os dados da tabela.\n- **setData(data: _TableData_): _Promise<void>_** - Substitui os dados lógicos da tabela e reconstrói seus subcomponentes.\n- **getSelectedRows(): _Promise<HTMLBrTableRowElement[]>_** - Retorna as linhas atualmente selecionadas.\n- **selectAllRows(): _Promise<void>_** - Seleciona todas as linhas elegíveis.\n- **clearSelection(): _Promise<void>_** - Limpa a seleção de todas as linhas elegíveis.\n- **getSorting(): _Promise<TableSortState[]>_** - Retorna o estado atual de ordenação aplicado na tabela.\n- **expandRow(rowIndex: _number_): _Promise<void>_** - Expande uma linha elegível do corpo.\n- **collapseRow(rowIndex: _number_): _Promise<void>_** - Recolhe uma linha do corpo.\n- **collapseAllRows(): _Promise<void>_** - Recolhe todas as linhas que estiverem expandidas.\n- **render()** - Renderiza o componente com semântica ARIA de grid.\n\n### **Slots:**\n - **header** - Componente `br-table-header` que define as colunas.\n- **body** - Componente `br-table-body` que contém as linhas de dados.\n- **global-actions** - Ações aplicadas ao conjunto completo de dados.\n- **contextual-actions** - Ações aplicadas às linhas selecionadas.\n- **loading** - Indicador exibido enquanto as linhas são atualizadas.\n\n### **CSS Properties:**\n - **--br-table-loading-opacity** - Opacidade do conteúdo durante o carregamento. Padrão: 0.5. _(default: undefined)_\n\n### **CSS Parts:**\n - **container** - Contêiner visual principal.\n- **scroll-container** - Área com rolagem que contém apenas os dados da tabela.\n- **content** - Grid que contém cabeçalho e corpo.\n- **footer** - Contêiner do rodapé, exibido abaixo do corpo da tabela.\n- **loading** - Scrim local e área do painel de carregamento sobre a tabela inteira.",
       "attributes": [
         {
           "name": "column-width",
-          "description": "Largura global aplicada a todas as colunas.",
+          "description": "Largura padrão utilizada pelas colunas sem configuração própria.",
           "values": [{ "name": "ColumnWidth" }]
         },
         {
           "name": "density",
-          "description": "Define a densidade visual do componente.\n\n- `small`: Alta densidade (componente menor, mais compacto e com menos espaçamento).\n- `medium`: Densidade intermediária, padrão recomendado para a maioria dos casos.\n- `large`: Baixa densidade (componente maior, mais espaçamento e altura).\n\nValores inválidos usam `medium`. Quando omitida, a densidade média é aplicada ao token.",
+          "description": "Densidade visual aplicada aos espaçamentos da tabela.",
           "values": [{ "name": "TableDensity" }]
         },
         {
           "name": "divider-style",
-          "description": "Define o estilo visual dos divisores.",
+          "description": "Estilo aplicado aos divisores habilitados.",
           "values": [{ "name": "TableDividerStyle" }]
         },
         {
           "name": "has-column-divider",
-          "description": "Ativa divisores verticais entre colunas.",
+          "description": "Habilita divisores entre colunas quando `columnDivider` não é informado.",
           "values": []
         },
         {
           "name": "column-divider",
-          "description": "Ativa divisores verticais. Quando informada, tem precedência sobre `hasColumnDivider`.",
+          "description": "Habilita divisores entre colunas.",
           "values": []
         },
         {
           "name": "has-row-divider",
-          "description": "Ativa divisores horizontais entre linhas.",
+          "description": "Habilita divisores entre linhas quando `rowDivider` não é informado.",
           "values": []
         },
         {
           "name": "row-divider",
-          "description": "Ativa divisores horizontais. Quando informada, tem precedência sobre `hasRowDivider`.",
+          "description": "Habilita divisores entre linhas.",
+          "values": []
+        },
+        {
+          "name": "has-row-hover",
+          "description": "Habilita o realce visual das linhas ao passar o ponteiro.",
+          "values": []
+        },
+        {
+          "name": "loading",
+          "description": "Indica que as linhas estão sendo atualizadas pelo consumidor.",
+          "values": []
+        },
+        {
+          "name": "heading",
+          "description": "Título apresentado na barra principal.",
+          "values": []
+        },
+        {
+          "name": "show-contextual-bar",
+          "description": "Força a apresentação da barra contextual.",
+          "values": []
+        },
+        {
+          "name": "heading-actions-limit",
+          "description": "Limite usado para decidir quando agrupar ações globais em um menu.\nQuando o número de ações excede esse valor, as ações são agrupadas no\ndropdown (atualmente todas são movidas para o menu colapsado).",
+          "values": []
+        },
+        {
+          "name": "contextual-actions-limit",
+          "description": "Limite usado para decidir quando agrupar ações contextuais em um menu.\nQuando o número de ações excede esse valor, as ações são agrupadas no\ndropdown (atualmente todas são movidas para o menu colapsado).",
+          "values": []
+        },
+        {
+          "name": "more-actions-heading-label",
+          "description": "Texto do tooltip do botão de ações agrupadas na barra de título.\nQuando vazio ou composto apenas por espaços, usa \"Mais ações\".\nNão altera o nome acessível do botão nem os rótulos do menu.",
+          "values": []
+        },
+        {
+          "name": "more-actions-contextual-label",
+          "description": "Texto do tooltip do botão de ações agrupadas da barra contextual.\nQuando vazio ou composto apenas por espaços, usa \"Mais ações\".\nNão altera o nome acessível do botão nem os rótulos do menu.",
+          "values": []
+        },
+        {
+          "name": "more-actions-label",
+          "description": "Texto completo do tooltip dos botões de ações agrupadas nas células.\nQuando informado, prevalece sobre `moreActionsLabel` de cada célula.\nQuando omitido, a célula usa seu valor local ou \"Mais ações\".\nValores vazios ou compostos apenas por espaços usam \"Mais ações\".\nAceita texto simples por atributo ou propriedade.\nReflete o valor no atributo `more-actions-label` para sincronizar as células.",
+          "values": []
+        },
+        {
+          "name": "cell-actions-limit",
+          "description": "Limite padrão de ações exibidas em cada célula.",
+          "values": []
+        },
+        {
+          "name": "has-row-selection",
+          "description": "Habilita a coluna de seleção de linhas.",
+          "values": []
+        },
+        {
+          "name": "has-row-expansion",
+          "description": "Habilita a coluna de expansão de linhas.",
+          "values": []
+        },
+        {
+          "name": "has-search",
+          "description": "Disponibiliza a interface de busca, sem filtrar ou destacar o conteúdo.\nA aplicação recebe `brTableSearch` e atualiza os dados local ou remotamente.",
+          "values": []
+        },
+        {
+          "name": "has-pagination",
+          "description": "Habilita a paginação da tabela, renderizando `br-table-footer` internamente.",
+          "values": []
+        },
+        {
+          "name": "current-page",
+          "description": "Página atual exibida pela paginação (1-indexada).",
+          "values": []
+        },
+        {
+          "name": "page-size",
+          "description": "Quantidade de itens pertencentes a cada página (linhas independentes ou grupos completos).",
+          "values": []
+        },
+        {
+          "name": "page-size-options",
+          "description": "Opções disponíveis de itens por página no seletor da paginação.",
+          "values": [{ "name": "number[]" }]
+        },
+        {
+          "name": "total-items",
+          "description": "Quantidade total de itens do conjunto de dados.",
+          "values": []
+        },
+        {
+          "name": "sort-mode",
+          "description": "Define se a tabela aceita uma única coluna ordenada ou múltiplas colunas.\nNo modo `multi`, a prioridade é sempre a ordem visual da esquerda para a direita.",
+          "values": [{ "name": "TableSortMode" }]
+        },
+        {
+          "name": "sort-strategy",
+          "description": "Define se a tabela ordena as linhas localmente ou deixa a aplicação aplicar\na ordenação solicitada. Em `manual`, a tabela mantém os indicadores e emite\n`brTableSortChange`, mas não reordena as linhas; use `setData()` para fornecer\nos resultados customizados ou remotos. Valores não reconhecidos usam a\nestratégia local.",
+          "values": [{ "name": "TableSortStrategy" }]
+        },
+        {
+          "name": "visible-rows",
+          "description": "Quantidade de linhas de dados visíveis simultaneamente na viewport.",
+          "values": []
+        },
+        {
+          "name": "height-rows",
+          "description": "Quantidade de itens lógicos usada somente para calcular a altura da viewport.\nCada grupo contíguo conta como um item; a altura inclui todas as linhas\nfísicas que compõem os grupos reservados. Não altera paginação, rolagem ou\nvirtualização. Quando omitida, acompanha `visibleRows`.",
+          "values": []
+        },
+        {
+          "name": "virtual-expanded-content-height",
+          "description": "Altura adicional estimada para conteúdo expandido ainda não medido.",
           "values": []
         },
         {
           "name": "horizontal-alignment",
-          "description": "Define o alinhamento horizontal do conteúdo das células.",
+          "description": "Alinhamento horizontal padrão da tabela.",
           "values": [{ "name": "TableAlignment" }]
         },
         {
           "name": "vertical-alignment",
-          "description": "Define o alinhamento vertical do conteúdo das células.",
+          "description": "Alinhamento vertical padrão da tabela.",
           "values": [{ "name": "TableAlignment" }]
         },
         {
           "name": "overflow",
-          "description": "Define o comportamento de overflow para as células.",
+          "description": "Estratégia padrão para conteúdos que excedem a célula.",
           "values": [{ "name": "TableOverflow" }]
         },
         {
           "name": "tooltip-state",
-          "description": "Define o estado semântico do tooltip nas células da tabela.",
+          "description": "Estado visual padrão dos tooltips.",
           "values": [{ "name": "TableTooltipState" }]
         },
         {
           "name": "tooltip-mode",
           "description": "Define o modo de resolução do tooltip nas células da tabela.",
           "values": [{ "name": "TableTooltipMode" }]
+        }
+      ],
+      "references": []
+    },
+    {
+      "name": "br-table-action",
+      "description": "## Design System\n\nPara a documentação completa de design, incluindo diretrizes de uso, acessibilidade e exemplos visuais, consulte o [Design System do GovBR](https://www.gov.br/ds/components/table?tab=designer).\n\nRepresenta uma ação global, contextual ou associada a uma linha da tabela.\nO contexto é inferido pelo slot e pela posição do componente na árvore.\n\nPara executar funções a partir das ações, ouça o evento `brTableActionClick`:\n\n```html\n<!-- 1. Ouvindo diretamente na ação -->\n<br-table-action id=\"btn-filtro\" label=\"Filtros\" icon-name=\"fa-solid:filter\"></br-table-action>\n<script>\n  document.getElementById('btn-filtro').addEventListener('brTableActionClick', () => {\n    executarFiltros();\n  });\n</script>\n\n<!-- 2. Ouvindo na tabela (recomendado para ações diretas e colapsadas em menu) -->\n<script>\n  table.addEventListener('brTableActionClick', (event) => {\n    const { type, label, rowIndex } = event.detail;\n    if (type === 'row') executarAcaoLinha(label, rowIndex);\n    else if (type === 'global') executarAcaoGlobal(label);\n  });\n</script>\n```\n---\n\n\n### **Events:**\n - **brTableActionClick** - Quando o usuário aciona o botão.\n- **brTableActionClick** - Emitido quando o usuário aciona o botão.\n\n### **Methods:**\n - **render()** - Renderiza a ação e adiciona tooltip quando o botão é circular.",
+      "attributes": [
+        {
+          "name": "label",
+          "description": "Texto visível e identificação semântica da ação.",
+          "values": []
         },
         {
-          "name": "loading",
-          "description": "Indica que as linhas estão sendo atualizadas pelo consumidor.\nO componente mantém o conteúdo anterior, aplica `aria-busy=\"true\"` e\nexibe o slot `loading` sobre os dados; transporte, erro e substituição das\nlinhas ficam sob responsabilidade da aplicação.\nA prop pode ser alterada diretamente ou pelos métodos `startLoading()` e\n`stopLoading()`.",
+          "name": "icon-name",
+          "description": "Nome do ícone exibido pelo botão.",
+          "values": []
+        },
+        {
+          "name": "aria-label",
+          "description": "Rótulo acessível. Quando omitido, utiliza `label`.",
           "values": []
+        },
+        {
+          "name": "density",
+          "description": "Densidade visual aplicada ao botão interno da ação.",
+          "values": [{ "name": "TableDensity" }]
+        }
+      ],
+      "references": []
+    },
+    {
+      "name": "br-table-bar",
+      "description": "## Design System\n\nPara a documentação completa de design, incluindo diretrizes de uso, acessibilidade e exemplos visuais, consulte o [Design System do GovBR](https://www.gov.br/ds/components/table?tab=designer).\n\nExibe o título, as ações globais e as ações contextuais da tabela.\nAções excedentes são agrupadas automaticamente em um menu.\nCompõe `br-table`, que configura a barra automaticamente. Também pode ser usada\ndiretamente para compor uma barra de ações. Quando `hasSearch` está ativo,\nsolicita a busca à aplicação, sem filtrar ou destacar os dados.\n---\n\n\n### **Events:**\n - **brTableSearch** - Evento customizado emitido pela barra ao enviar a busca por Enter ou pelo\nbotão, com `{ term }`, e ao fechar, com `{ term: '' }`. Propaga até `br-table`\ne atravessa Shadow DOM; é cancelável. Digitação, inicialização e alterações\nprogramáticas não emitem o evento.\n\n### **Methods:**\n - **render()** - Renderiza somente as barras necessárias ao estado atual.\n\n### **Slots:**\n - **global-actions** - Ações relacionadas ao conjunto completo de dados.\n- **contextual-actions** - Ações aplicadas às linhas selecionadas.",
+      "attributes": [
+        {
+          "name": "heading",
+          "description": "Título apresentado na barra principal.",
+          "values": []
+        },
+        {
+          "name": "heading-actions-limit",
+          "description": "Limite usado para decidir quando agrupar ações em um menu. Quando o\nnúmero de ações excede esse valor, as ações são agrupadas no dropdown\n(atualmente todas são movidas para o menu colapsado).",
+          "values": []
+        },
+        {
+          "name": "contextual-actions-limit",
+          "description": "Limite usado para decidir quando agrupar ações contextuais em um menu.\nQuando o número de ações excede esse valor, as ações são agrupadas no\ndropdown (atualmente todas são movidas para o menu colapsado).",
+          "values": []
+        },
+        {
+          "name": "show-contextual-bar",
+          "description": "Força a apresentação da barra contextual mesmo sem seleção.",
+          "values": []
+        },
+        {
+          "name": "selected-rows-count",
+          "description": "Número de linhas atualmente selecionadas.",
+          "values": []
+        },
+        {
+          "name": "has-global-actions-content",
+          "description": "Indica se o slot de ações globais possui conteúdo.",
+          "values": []
+        },
+        {
+          "name": "has-contextual-actions-content",
+          "description": "Indica se o slot de ações contextuais possui conteúdo.",
+          "values": []
+        },
+        {
+          "name": "has-search",
+          "description": "Disponibiliza a interface de busca controlada pela aplicação.",
+          "values": []
+        },
+        {
+          "name": "density",
+          "description": "Densidade visual aplicada aos controles internos da barra.",
+          "values": [{ "name": "TableDensity" }]
         }
       ],
       "references": []
     },
     {
       "name": "br-table-body",
-      "description": "Corpo de dados (`<tbody>`) da tabela. Use no slot `body` do `br-table`.\n\nAgrupa as linhas `br-table-row` contendo as células de dados `br-table-cell`.\n---\n\n\n### **Methods:**\n - **render(): __** - Renderiza o host do componente.\n\n### **CSS Parts:**\n - **body** - Wrapper do corpo da tabela.",
+      "description": "## Design System\n\nPara a documentação completa de design, incluindo diretrizes de uso, acessibilidade e exemplos visuais, consulte o [Design System do GovBR](https://www.gov.br/ds/components/table?tab=designer).\n\nAgrupa semanticamente as linhas que compõem o corpo de `br-table`.\nÉ uma peça declarativa do slot `body`; recebe `br-table-row` e entrega ao\norquestrador a seleção, ordenação e materialização virtual. Os contêineres\nvisuais dos grupos são internos, montados pela tabela e não devem ser\ninstanciados pelo consumidor. Use o componente na composição de `br-table`.\n---\n\n\n### **Methods:**\n - **render()** - Renderiza o agrupamento de linhas com semântica acessível.\n\n### **Slots:**\n - **default** - Linhas `br-table-row` pertencentes ao corpo.\n\n### **CSS Parts:**\n - **body** - Contêiner estrutural do corpo.",
       "attributes": [],
       "references": []
     },
     {
       "name": "br-table-cell",
-      "description": "Célula de dados (`<td>`) da tabela. Use dentro de um `br-table-row` no corpo da tabela.\n\nColoque o conteúdo do registro no slot padrão.\n---\n\n\n### **Events:**\n - **brAlignmentChange** - Evento customizado emitido quando o alinhamento é alterado, permitindo que a célula reaja dinamicamente a mudanças nos tokens de alinhamento.\n- **brOverflowChange** - Evento customizado emitido quando a configuração de overflow é alterada, permitindo que a célula reaja dinamicamente a mudanças no token de overflow.\n\n### **Methods:**\n \n\n- **render(): __** - Renderiza o host do componente.\n\n### **CSS Parts:**\n - **cell** - Wrapper da célula.\n- **content** - Área de conteúdo da célula.",
+      "description": "## Design System\n\nPara a documentação completa de design, incluindo diretrizes de uso, acessibilidade e exemplos visuais, consulte o [Design System do GovBR](https://www.gov.br/ds/components/table?tab=designer).\n\nRepresenta uma célula de dados, com suporte a alinhamento, overflow,\ntooltip e agrupamento automático de ações excedentes. Compõe `br-table-row`\ndentro do corpo de `br-table`, que coordena posição, interação e herança.\nUse `rowSpan` dentro de um grupo contíguo de linhas e `rowHeader` para seu\nrótulo compartilhado; evite uso avulso fora da composição da tabela.\n---\n\n\n### **Events:**\n - **brAlignmentChange** - Quando um alinhamento específico muda.\n- **brOverflowChange** - Quando a estratégia de overflow muda.\n- **brAlignmentChange** - Emitido quando um alinhamento específico da célula muda.\n- **brOverflowChange** - Emitido quando a estratégia de overflow da célula muda.\n\n### **Methods:**\n - **getMeasuredHeight(): _Promise<number>_** - Retorna a altura renderizada da superfície visual desta célula, em pixels.\n\n\n- **render()** - Renderiza o conteúdo, as ações e o tooltip opcional.\n\n### **Slots:**\n - **default** - Conteúdo ou ações da célula.\n\n### **CSS Parts:**\n - **cell** - Superfície visual da célula.\n- **content** - Contêiner responsável pelo alinhamento.",
       "attributes": [
+        {
+          "name": "col-span",
+          "description": "Quantidade de colunas ocupadas. Inteiro entre 1 e 1000; valores inválidos usam 1.",
+          "values": []
+        },
+        {
+          "name": "row-span",
+          "description": "Quantidade de linhas ocupadas no cabeçalho ou grupo. Limitada às linhas\ndisponíveis; aceita inteiros de 1 a 1000 e valores inválidos usam 1.",
+          "values": []
+        },
+        {
+          "name": "row-header",
+          "description": "Identifica um cabeçalho de linha, inclusive rótulos compartilhados por um grupo.",
+          "values": []
+        },
         {
           "name": "horizontal-alignment",
-          "description": "Define o alinhamento horizontal do conteúdo dentro da célula.",
+          "description": "Alinhamento horizontal específico da célula. Quando omitido, herda da\nlinha, coluna ou tabela, nessa ordem.",
           "values": [{ "name": "TableAlignment" }]
         },
         {
           "name": "vertical-alignment",
-          "description": "Define o alinhamento vertical do conteúdo dentro da célula.",
+          "description": "Alinhamento vertical específico da célula. Quando omitido, herda da\nlinha, coluna ou tabela, nessa ordem.",
           "values": [{ "name": "TableAlignment" }]
         },
         {
           "name": "overflow",
-          "description": "Define se o conteúdo dentro da célula deve ser truncado, permitindo a herança dessa configuração para as células filhas com base no valor definido.",
+          "description": "Estratégia de overflow específica da célula. Quando omitida, herda da\nlinha, coluna ou tabela, nessa ordem.",
           "values": [{ "name": "TableOverflow" }]
         },
+        {
+          "name": "cell-actions-limit",
+          "description": "Limite local de ações exibidas diretamente.",
+          "values": []
+        },
+        {
+          "name": "more-actions-label",
+          "description": "Texto completo do tooltip do botão de ações agrupadas desta célula.\nA propriedade `moreActionsLabel` de `br-table` prevalece quando\ninformada. Valores vazios ou compostos apenas por espaços usam \"Mais ações\".\nNão altera o nome acessível do botão nem os rótulos das ações.\nAceita texto simples por atributo ou propriedade, sem reflexão.",
+          "values": []
+        },
+        {
+          "name": "sort-value",
+          "description": "Valor utilizado pela ordenação da coluna. Quando omitido, a tabela usa o\ntexto renderizado da célula.",
+          "values": []
+        },
         {
           "name": "tooltip-state",
-          "description": "Define o estado semântico do tooltip nesta célula.",
+          "description": "Estado visual do tooltip da célula. Quando omitido, herda da linha,\ncoluna ou tabela, nessa ordem.",
           "values": [{ "name": "TableTooltipState" }]
         },
         {
           "name": "tooltip-mode",
-          "description": "Define o modo de resolução do tooltip nesta célula.",
+          "description": "Modo de exibição do tooltip da célula. Quando omitido, herda da linha,\ncoluna ou tabela, nessa ordem. No modo `enabled`, exibe o conteúdo\nsomente quando estiver truncado na largura disponível.",
           "values": [{ "name": "TableTooltipMode" }]
+        },
+        {
+          "name": "action-density",
+          "description": "Densidade visual aplicada ao trigger de ações agrupadas.",
+          "values": [{ "name": "TableDensity" }]
+        }
+      ],
+      "references": []
+    },
+    {
+      "name": "br-table-footer",
+      "description": "Para a documentação completa, incluindo diretrizes de uso, acessibilidade e exemplos visuais, consulte o [Design System do GovBR](https://www.gov.br/ds/components/table?tab=designer).\n\nRenderiza a paginação da tabela quando `hasPagination` está habilitado em `br-table`.\nOrquestrado internamente pela tabela; não deve ser inserido diretamente pelo consumidor.\n---\n\n\n### **CSS Parts:**\n - **container** - Contêiner do rodapé.",
+      "attributes": [
+        {
+          "name": "current-page",
+          "description": "Página atual exibida pela paginação (1-indexada).",
+          "values": []
+        },
+        {
+          "name": "page-size",
+          "description": "Quantidade de itens exibidos por página.",
+          "values": []
+        },
+        {
+          "name": "page-size-options",
+          "description": "Opções disponíveis de itens por página.",
+          "values": [{ "name": "number[]" }]
+        },
+        {
+          "name": "total-items",
+          "description": "Quantidade total de itens do conjunto de dados.",
+          "values": []
+        },
+        {
+          "name": "density",
+          "description": "Densidade visual herdada da tabela.",
+          "values": [{ "name": "TableFooterDensity" }]
+        },
+        {
+          "name": "has-scroll",
+          "description": "Indica que a área de dados da tabela possui rolagem.",
+          "values": []
         }
       ],
       "references": []
     },
     {
       "name": "br-table-header",
-      "description": "Cabeçalho da tabela (`br-table`). Use no slot `header`.\n\nAgrupa as linhas `br-table-row` com as células de cabeçalho `br-table-header-cell`.\n---\n\n\n### **Methods:**\n - **render(): __** - Renderiza o host do componente.\n\n### **CSS Parts:**\n - **header** - Wrapper do cabeçalho da tabela.",
+      "description": "## Design System\n\nPara a documentação completa de design, incluindo diretrizes de uso, acessibilidade e exemplos visuais, consulte o [Design System do GovBR](https://www.gov.br/ds/components/table?tab=designer).\n\nAgrupa as linhas de cabeçalho de `br-table`, que as posiciona em uma grade.\nUse uma linha para tabelas simples e múltiplas linhas com `colSpan`/`rowSpan`\nem `br-table-header-cell` para hierarquias de colunas. É uma peça declarativa\ndo slot `header`, usada com o orquestrador; não realiza ordenação avulsa.\n---\n\n\n### **Methods:**\n - **render()** - Renderiza o cabeçalho com papel ARIA de grupo de linhas.\n\n### **Slots:**\n - **default** - Linhas contendo células `br-table-header-cell`.\n\n### **CSS Parts:**\n - **header** - Contêiner estrutural do cabeçalho.",
       "attributes": [],
       "references": []
     },
     {
       "name": "br-table-header-cell",
-      "description": "Célula de cabeçalho (`<th>`) da tabela. Use dentro de um `br-table-row` no cabeçalho.\n\nColoque o título da coluna no slot padrão. Para habilitar ordenação, ative `sortable`.\n---\n\n\n### **Events:**\n - **brColumnWidthChange** - Evento customizado emitido quando a largura da coluna é alterada, permitindo que as células reajam dinamicamente a mudanças no layout.\n- **brAlignmentChange** - Evento customizado emitido quando o alinhamento é alterado, permitindo que a célula de cabeçalho reaja dinamicamente a mudanças nos tokens de alinhamento.\n- **brOverflowChange** - Evento customizado emitido quando a configuração de overflow é alterada, permitindo que a célula de cabeçalho reaja dinamicamente a mudanças no token de overflow.\n\n### **Methods:**\n \n\n\n- **render(): __** - Renderiza o host do componente.\n\n### **CSS Parts:**\n - **cell** - Wrapper da célula de cabeçalho.\n- **content** - Área de conteúdo da célula de cabeçalho.",
+      "description": "## Design System\n\nPara a documentação completa de design, incluindo diretrizes de uso, acessibilidade e exemplos visuais, consulte o [Design System do GovBR](https://www.gov.br/ds/components/table?tab=designer).\n\nDefine o conteúdo e as propriedades herdáveis de uma coluna de `br-table`.\nCompõe as linhas de `br-table-header` no slot `header`; não deve ser usada\navulsa. `colSpan` e `rowSpan` representam grupos e níveis do cabeçalho.\nSomente folhas que ocupam uma coluna podem ordenar os dados.\nTambém exibe tooltip quando o conteúdo truncado requer informação adicional.\n---\n\n\n### **Events:**\n - **brColumnWidthChange** - Quando a largura declarada muda.\n- **brAlignmentChange** - Quando um alinhamento da coluna muda.\n- **brOverflowChange** - Quando a estratégia de overflow muda.\n- **brColumnWidthChange** - Emitido quando a largura declarada para a coluna muda.\n- **brAlignmentChange** - Emitido quando um alinhamento da coluna muda.\n- **brOverflowChange** - Emitido quando a estratégia de overflow muda.\n\n### **Methods:**\n \n\n\n- **render()** - Renderiza o cabeçalho, seu conteúdo e o tooltip opcional.\n\n### **Slots:**\n - **default** - Conteúdo do cabeçalho da coluna.\n\n### **CSS Parts:**\n - **cell** - Superfície visual da célula.\n- **content** - Contêiner responsável pelo alinhamento.",
       "attributes": [
+        {
+          "name": "col-span",
+          "description": "Quantidade de colunas ocupadas. Inteiro entre 1 e 1000; valores inválidos usam 1.",
+          "values": []
+        },
+        {
+          "name": "row-span",
+          "description": "Quantidade de linhas ocupadas no cabeçalho ou grupo. Limitada às linhas\ndisponíveis; aceita inteiros de 1 a 1000 e valores inválidos usam 1.",
+          "values": []
+        },
         {
           "name": "column-width",
-          "description": "Define a largura da coluna.\nAceita `fill`, `content`, larguras positivas em `px` ou frações positivas em `fr`.\nValores inválidos usam o fallback da tabela.",
+          "description": "Largura semântica ou CSS aplicada à coluna. Quando omitida, herda da tabela.",
           "values": [{ "name": "ColumnWidth" }]
         },
         {
           "name": "horizontal-alignment",
-          "description": "Define o alinhamento horizontal do conteúdo dentro da célula de cabeçalho, permitindo a herança de alinhamento para as células filhas com base no valor definido.",
+          "description": "Alinhamento horizontal herdado pelas células da coluna. Quando omitido,\no cabeçalho herda da linha ou tabela, nessa ordem.",
           "values": [{ "name": "TableAlignment" }]
         },
         {
           "name": "vertical-alignment",
-          "description": "Define o alinhamento vertical do conteúdo dentro da célula de cabeçalho, permitindo a herança de alinhamento para as células filhas com base no valor definido.",
+          "description": "Alinhamento vertical herdado pelas células da coluna. Quando omitido,\no cabeçalho herda da linha ou tabela, nessa ordem.",
           "values": [{ "name": "TableAlignment" }]
         },
         {
           "name": "overflow",
-          "description": "Define se o conteúdo dentro da célula de cabeçalho deve ser truncado, permitindo a herança dessa configuração para as células filhas com base no valor definido.",
+          "description": "Estratégia de overflow herdada pelas células da coluna. Quando omitida,\no cabeçalho herda da linha ou tabela, nessa ordem.",
           "values": [{ "name": "TableOverflow" }]
         },
         {
           "name": "tooltip-state",
-          "description": "Define o estado semântico do tooltip nesta coluna/célula de cabeçalho.",
+          "description": "Estado visual herdado pelos tooltips da coluna. Quando omitido,\no cabeçalho herda da linha ou tabela, nessa ordem.",
           "values": [{ "name": "TableTooltipState" }]
         },
         {
           "name": "tooltip-mode",
-          "description": "Define o modo de resolução do tooltip nesta coluna/célula de cabeçalho.",
+          "description": "Modo de exibição herdado pelos tooltips da coluna. Quando omitido ou\ndefinido como inherit, o cabeçalho herda da linha ou tabela, nessa ordem.",
           "values": [{ "name": "TableTooltipMode" }]
+        },
+        {
+          "name": "sortable",
+          "description": "Habilita a ordenação desta coluna.",
+          "values": []
+        },
+        {
+          "name": "sort-direction",
+          "description": "Estado atual de ordenação controlado por `br-table`.",
+          "values": [{ "name": "TableSortDirection" }]
         }
       ],
       "references": []
     },
     {
       "name": "br-table-row",
-      "description": "Linha horizontal (`<tr>`) da tabela. Use dentro de `br-table-header` ou `br-table-body`.\n\nUse `selected` para indicar que a linha está selecionada.\n---\n\n\n### **Events:**\n - **brAlignmentChange** - Evento customizado emitido quando o alinhamento é alterado, permitindo que as células reajam dinamicamente a mudanças nos tokens de alinhamento.\n- **brOverflowChange** - Evento customizado emitido quando a configuração de overflow é alterada, permitindo que as células reajam dinamicamente a mudanças no token de overflow.\n\n### **Methods:**\n \n\n- **render(): __** - Renderiza o host do componente.\n\n### **CSS Parts:**\n - **row** - Wrapper da linha da tabela.",
+      "description": "## Design System\n\nPara a documentação completa de design, incluindo diretrizes de uso, acessibilidade e exemplos visuais, consulte o [Design System do GovBR](https://www.gov.br/ds/components/table?tab=designer).\n\nRepresenta uma linha de dados e sua área opcional de conteúdo expandido.\nÉ uma peça declarativa de `br-table-body` ou `br-table-header`, coordenada por\n`br-table`. Recebe células de dados ou cabeçalho conforme o pai. `rowGroup`\nidentifica linhas contíguas que devem permanecer juntas; use-o apenas no corpo.\nEm grupos, os detalhes expandidos são apresentados após as linhas do grupo.\n---\n\n\n### **Events:**\n - **brAlignmentChange** - Quando um alinhamento herdável muda.\n- **brOverflowChange** - Quando a estratégia de overflow muda.\n- **brAlignmentChange** - Emitido quando uma propriedade de alinhamento da linha muda.\n- **brOverflowChange** - Emitido quando a estratégia de overflow da linha muda.\n\n### **Methods:**\n - **getMeasuredHeight(): _Promise<number>_** - Retorna a maior altura das células desta linha somada à área de expansão, em pixels.\n\n\n\n- **render()** - Renderiza as células e, quando expandida, o conteúdo adicional.\n\n### **Slots:**\n - **default** - Células de dados da linha.\n- **expanded-content** - Conteúdo arbitrário exibido abaixo da linha.\n\n### **CSS Parts:**\n - **row** - Contêiner estrutural da linha.\n- **expanded-content** - Área de conteúdo expandido.",
       "attributes": [
+        {
+          "name": "row-group",
+          "description": "Identifica um grupo contíguo de linhas com chave exclusiva, preservado como unidade na ordenação,\npaginação e virtualização. Vazio ou omitido mantém a linha independente.\nA seleção continua sendo individual por linha.",
+          "values": []
+        },
         {
           "name": "horizontal-alignment",
-          "description": "Define o alinhamento horizontal das células dentro da linha, permitindo a herança de alinhamento para as células filhas com base no valor definido.",
+          "description": "Alinhamento horizontal herdado pelas células da linha.",
           "values": [{ "name": "TableAlignment" }]
         },
         {
           "name": "vertical-alignment",
-          "description": "Define o alinhamento vertical das células dentro da linha, permitindo a herança de alinhamento para as células filhas com base no valor definido.",
+          "description": "Alinhamento vertical herdado pelas células da linha.",
           "values": [{ "name": "TableAlignment" }]
         },
         {
           "name": "overflow",
-          "description": "Define se o conteúdo dentro das células da linha deve ser truncado, permitindo a herança dessa configuração para as células filhas com base no valor definido.",
+          "description": "Estratégia de overflow herdada pelas células da linha.",
           "values": [{ "name": "TableOverflow" }]
         },
         {
           "name": "tooltip-state",
-          "description": "Define o estado semântico do tooltip nas células desta linha.",
+          "description": "Estado visual herdado pelos tooltips da linha.",
           "values": [{ "name": "TableTooltipState" }]
         },
         {
           "name": "tooltip-mode",
-          "description": "Define o modo de resolução do tooltip nas células desta linha.",
+          "description": "Modo de exibição herdado pelos tooltips da linha.",
           "values": [{ "name": "TableTooltipMode" }]
+        },
+        {
+          "name": "selected",
+          "description": "Indica se a linha está selecionada.",
+          "values": []
+        },
+        {
+          "name": "row-expansion",
+          "description": "Controla se a expansão é habilitada, desabilitada ou herdada da tabela.",
+          "values": [{ "name": "TableRowExpansion" }]
+        },
+        {
+          "name": "virtual-expanded-content-height",
+          "description": "Altura visível da área expandida desta linha, em pixels.",
+          "values": []
+        },
+        {
+          "name": "expanded",
+          "description": "Indica se o conteúdo adicional da linha está visível.",
+          "values": []
         }
       ],
       "references": []