@govbr-ds/webcomponents 2.5.0 → 2.6.0

package/dist/types/components.d.ts

@@ -42,7 +42,8 @@ import { StepChangeDetail, StepContentType, StepLabelPosition, StepMode, StepVal
 import { StepItemContentType, StepItemHighlight, StepItemLabelPosition, StepItemLayout, StepItemMode, StepItemPositionStatus, StepItemRole, StepItemVerticalContentPlacement } from "./components/step/step-item/step-item.types";
 import { SwitchValidator } from "./components/switch/switch.types";
 import { TabAlignItems, TabColorMode, TabDensity } from "./components/tab/tab.types";
-import { ColumnWidth, TableAlignment, TableDensity, TableDividerStyle, TableOverflow, TableTooltipMode, TableTooltipState } from "./components/table/table-types";
+import { ColumnWidth, TableActionClickDetail, TableAlignment, TableData, TableDensity, TableDividerStyle, TableOverflow, TablePageChangeDetail, TablePageSizeChangeDetail, TableRowExpansion, TableRowExpansionChangeDetail, TableSearchDetail, TableSelectionChangeDetail, TableSortChangeDetail, TableSortDirection, TableSortMode, TableSortRequestDetail, TableSortState, TableSortStrategy, TableTooltipMode, TableTooltipState } from "./components/table/table.types";
+import { TableFooterDensity, TableFooterPageChangeDetail, TableFooterPerPageChangeDetail } from "./components/table/table-footer/table-footer.types";
 import { TagShape, TagValidator, TagVariant } from "./components/tag/tag.types";
 import { TextareaResize, TextareaWrap } from "./components/textarea/textarea.types";
 import { TooltipDensity, TooltipPosition, TooltipState, TooltipType } from "./components/tooltip/tooltip.types";
@@ -85,7 +86,8 @@ export { StepChangeDetail, StepContentType, StepLabelPosition, StepMode, StepVal
 export { StepItemContentType, StepItemHighlight, StepItemLabelPosition, StepItemLayout, StepItemMode, StepItemPositionStatus, StepItemRole, StepItemVerticalContentPlacement } from "./components/step/step-item/step-item.types";
 export { SwitchValidator } from "./components/switch/switch.types";
 export { TabAlignItems, TabColorMode, TabDensity } from "./components/tab/tab.types";
-export { ColumnWidth, TableAlignment, TableDensity, TableDividerStyle, TableOverflow, TableTooltipMode, TableTooltipState } from "./components/table/table-types";
+export { ColumnWidth, TableActionClickDetail, TableAlignment, TableData, TableDensity, TableDividerStyle, TableOverflow, TablePageChangeDetail, TablePageSizeChangeDetail, TableRowExpansion, TableRowExpansionChangeDetail, TableSearchDetail, TableSelectionChangeDetail, TableSortChangeDetail, TableSortDirection, TableSortMode, TableSortRequestDetail, TableSortState, TableSortStrategy, TableTooltipMode, TableTooltipState } from "./components/table/table.types";
+export { TableFooterDensity, TableFooterPageChangeDetail, TableFooterPerPageChangeDetail } from "./components/table/table-footer/table-footer.types";
 export { TagShape, TagValidator, TagVariant } from "./components/tag/tag.types";
 export { TextareaResize, TextareaWrap } from "./components/textarea/textarea.types";
 export { TooltipDensity, TooltipPosition, TooltipState, TooltipType } from "./components/tooltip/tooltip.types";
@@ -878,13 +880,13 @@ export namespace Components {
          */
         "iconPosition": CollapseIconPosition;
         /**
-          * Identificador Iconify do ícone exibido quando o conteúdo está visível. O valor padrão usa o registro SVG local. Para ícones por classe CSS, use o slot `icon-to-hide`.
-          * @default 'fa6-solid:chevron-up'
+          * Identificador de ícone Font Awesome 5 Free presente no cache local, exibido quando o conteúdo está visível. Para ícones por classe CSS, use o slot `icon-to-hide`.
+          * @default 'fa-solid:chevron-up'
          */
         "iconToHide": string;
         /**
-          * Identificador Iconify do ícone exibido quando o conteúdo está oculto. O valor padrão usa o registro SVG local. Para ícones por classe CSS, use o slot `icon-to-show`.
-          * @default 'fa6-solid:chevron-down'
+          * Identificador de ícone Font Awesome 5 Free presente no cache local, exibido quando o conteúdo está oculto. Para ícones por classe CSS, use o slot `icon-to-show`.
+          * @default 'fa-solid:chevron-down'
          */
         "iconToShow": string;
         /**
@@ -2023,7 +2025,7 @@ export namespace Components {
          */
         "href"?: string;
         /**
-          * Identificador da rede social. Os ícones oficiais mais comuns são renderizados pelo registro SVG local; use o slot `icon` para uma fonte diferente ou uma classe Font Awesome personalizada.
+          * Nome do ícone Font Awesome 5 Free presente no cache local, sem o prefixo `fa-brands:` (ex.: `instagram`). Use o slot `icon` para conteúdo próprio.
          */
         "icon": string;
         /**
@@ -2331,7 +2333,7 @@ export namespace Components {
          */
         "height": string;
         /**
-          * Identificador legado do ícone. Identificadores que pertencem ao registro local são renderizados como SVG empacotado; nomes desconhecidos continuam disponíveis via Iconify somente para compatibilidade.
+          * Identificador legado do ícone. Nomes no cache local são renderizados como SVG empacotado; em `source="auto"`, nomes ausentes usam Iconify como fallback. `source="iconify"` força essa origem.
           * @deprecated Use `src` com um asset controlado pela aplicação, `svg` ou o slot padrão.
          */
         "iconName"?: string;
@@ -2356,7 +2358,7 @@ export namespace Components {
          */
         "label"?: string;
         /**
-          * Controla o comportamento de carregamento do ícone.  Comportamento: - Padrão (propriedade não definida): carregamento imediato aplicando `noobserver` para evitar problemas de layout shift - `lazy={true}`: ativa o carregamento tardio nativo para imagens em `src` e o observer do Iconify no fallback legado - `lazy={false}`: carregamento imediato  **Nota**: O padrão foi alterado para carregamento imediato para resolver problemas de deslocamento de layout que ocorriam quando ícones eram carregados depois do conteúdo inicial.  SVG inline e conteúdo em slot não precisam de carregamento tardio, pois já estão disponíveis no DOM.
+          * Controla o comportamento de carregamento do ícone.  Comportamento: - Padrão (propriedade não definida): carregamento imediato aplicando `noobserver` para evitar problemas de layout shift - `lazy={true}`: ativa o carregamento tardio nativo para imagens em `src` - `lazy={false}`: carregamento imediato  **Nota**: O padrão foi alterado para carregamento imediato para resolver problemas de deslocamento de layout que ocorriam quando ícones eram carregados depois do conteúdo inicial.  SVG inline e conteúdo em slot não precisam de carregamento tardio, pois já estão disponíveis no DOM.
          */
         "lazy"?: boolean;
         /**
@@ -2364,7 +2366,8 @@ export namespace Components {
          */
         "rotate"?: IconRotate;
         /**
-          * Define explicitamente a origem do ícone. Quando `auto`, o componente prioriza slot, SVG inline e imagem por URL. Iconify fica apenas como fallback de compatibilidade quando nenhuma fonte própria foi informada. Aceita `auto`, `iconify`, `image`, `svg` ou `slot`; valores inválidos usam `auto`.
+          * Define explicitamente a origem do ícone. Quando `auto`, o componente prioriza slot, SVG inline, imagem por URL e o cache local Font Awesome 5 Free. Se `iconName` não estiver no cache, usa Iconify como fallback. `iconify` força essa origem mesmo para nomes presentes no cache. Aceita `auto`, `iconify`, `image`, `svg` ou `slot`; valores inválidos usam `auto`.
+          * @remarks Os componentes do Design System usam identificadores presentes no cache local; Iconify atende nomes ausentes e usos explícitos.
           * @default 'auto'
          */
         "source": IconSource;
@@ -3036,8 +3039,8 @@ export namespace Components {
      * O `br-magic-button` é o botão de ação flutuante (FAB) que destaca a ação primária ou mais frequente da tela.
      * Pode ser exibido apenas com ícone (formato circular) ou expandido com texto descritivo.
      * ```html
-     * <br-magic-button icon="fa6-solid:plus" aria-label="Novo item"></br-magic-button>
-     * <br-magic-button icon="fa6-solid:plus">Criar documento</br-magic-button>
+     * <br-magic-button icon="fa-solid:plus" aria-label="Novo item"></br-magic-button>
+     * <br-magic-button icon="fa-solid:plus">Criar documento</br-magic-button>
      * ```
      * ### Quando usar
      * - Ação principal e dominante da tela em dispositivos móveis ou interfaces focadas em uma tarefa única.
@@ -3070,7 +3073,7 @@ export namespace Components {
          */
         "density": BrDensity;
         /**
-          * Ícone como identificador Iconify (ex.: `fa6-solid:star`) ou nome simples (ex.: `question`, resolvido como `fa6-solid:question` no registro SVG local), renderizado pelo `br-icon`. Para classes CSS (ex.: Font Awesome) ou SVGs personalizados, use o slot `icon`, a forma preferida. Uso descontinuado: classes CSS nesta prop (ex.: `fas fa-star`) não são exibidas no Shadow DOM e geram aviso.
+          * Ícone como identificador Font Awesome 5 Free do cache local (ex.: `fa-solid:star`) ou nome simples (ex.: `question`, resolvido como `fa-solid:question`), renderizado pelo `br-icon`. Para classes CSS (ex.: Font Awesome) ou SVGs personalizados, use o slot `icon`, a forma preferida. Uso descontinuado: classes CSS nesta prop (ex.: `fas fa-star`) não são exibidas no Shadow DOM e geram aviso.
           * @default ''
          */
         "icon": string;
@@ -3389,7 +3392,7 @@ export namespace Components {
          */
         "href": string;
         /**
-          * Identificador da rede social. Os ícones oficiais mais comuns são renderizados pelo registro SVG local; use o slot `icon` para uma fonte diferente ou uma classe Font Awesome personalizada.
+          * Nome do ícone Font Awesome 5 Free presente no cache local, sem o prefixo `fa-brands:` (ex.: `facebook-f`). Use o slot `icon` para conteúdo próprio.
          */
         "icon": string;
         /**
@@ -4588,6 +4591,9 @@ export namespace Components {
           * @type {boolean | undefined}
          */
         "showSearchIcon"?: boolean;
+        /**
+          * Sincroniza o estado acessível do campo com o select orquestrador.
+         */
         "syncCombobox": (state: SelectComboboxState) => Promise<void>;
         /**
           * Valor textual apresentado no input.
@@ -5119,8 +5125,8 @@ export namespace Components {
         "step": number;
         /**
           * Lista de passos customizados para o slider. Cada passo pode definir `value`, `label` (texto exibido no tooltip e/ou abaixo da trilha) e `icon` (nome do ícone exibido abaixo da marcação do passo). Aceita array de objetos `SliderStep[]`, array de strings `string[]`, ou string JSON.
-          * @example ```html <br-slider   steps='[{"value": 1, "label": "Péssimo", "icon": "fa-solid:face-frown"}, {"value": 5, "label": "Excelente", "icon": "fa-solid:face-laugh"}]' ></br-slider> ```
-          * @example ```js const slider = document.querySelector('br-slider'); slider.steps = [   { value: 1, label: 'Péssimo', icon: 'fa-solid:face-frown' },   { value: 5, label: 'Excelente', icon: 'fa-solid:face-laugh' }, ]; ```
+          * @example ```html <br-slider   steps='[{"value": 1, "label": "Péssimo", "icon": "fa-solid:frown"}, {"value": 5, "label": "Excelente", "icon": "fa-solid:laugh"}]' ></br-slider> ```
+          * @example ```js const slider = document.querySelector('br-slider'); slider.steps = [   { value: 1, label: 'Péssimo', icon: 'fa-solid:frown' },   { value: 5, label: 'Excelente', icon: 'fa-solid:laugh' }, ]; ```
          */
         "steps"?: SliderStep[] | string;
         /**
@@ -5128,7 +5134,7 @@ export namespace Components {
          */
         "thumbEndIcon"?: string;
         /**
-          * Nome do ícone a ser exibido no interior da alça de controle (thumb). No modo `range`, aplica-se a ambas as alças caso `thumbStartIcon` ou `thumbEndIcon` não sejam especificados. Exemplo: 'fa-solid:arrows-left-right', 'fa-solid:circle'.
+          * Nome do ícone a ser exibido no interior da alça de controle (thumb). No modo `range`, aplica-se a ambas as alças caso `thumbStartIcon` ou `thumbEndIcon` não sejam especificados. Exemplo: 'fa-solid:arrows-alt-h', 'fa-solid:circle'.
          */
         "thumbIcon"?: string;
         /**
@@ -5545,7 +5551,7 @@ export namespace Components {
          */
         "counter": string;
         /**
-          * Ícone da aba como identificador Iconify (ex.: `fa6-solid:bell`), renderizado em SVG pelo `br-icon`. Para ícones por classe CSS (ex.: Font Awesome), use o slot `icon-{id}` do `br-tab`, a forma preferida: `<i slot="icon-avisos" class="fas fa-bell" aria-hidden="true"></i>`. O slot tem precedência sobre esta prop. Uso descontinuado: classes CSS nesta prop (ex.: `fas fa-bell`) não são exibidas no Shadow DOM, geram aviso e devem migrar para o slot `icon-{id}`. Identificadores Iconify continuam suportados.
+          * Ícone da aba como identificador Font Awesome 5 Free presente no cache local (ex.: `fa-solid:bell`), renderizado pelo `br-icon`. Para ícones por classe CSS (ex.: Font Awesome), use o slot `icon-{id}` do `br-tab`, a forma preferida: `<i slot="icon-avisos" class="fas fa-bell" aria-hidden="true"></i>`. O slot tem precedência sobre esta prop. Uso descontinuado: classes CSS nesta prop (ex.: `fas fa-bell`) não são exibidas no Shadow DOM, geram aviso e devem migrar para o slot `icon-{id}`. Nomes fora do cache local não são carregados remotamente.
          */
         "icon": string;
         /**
@@ -5581,211 +5587,627 @@ export namespace Components {
         "tabItemTitle": string;
     }
     /**
-     * O `br-table` estrutura e exibe conjuntos de dados organizados em linhas e colunas.
-     * Estruture 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`.
-     * ```html
-     * <br-table>
-     *   <br-table-header slot="header">
-     *     <br-table-row>
-     *       <br-table-header-cell>Nome</br-table-header-cell>
-     *       <br-table-header-cell>Cargo</br-table-header-cell>
-     *     </br-table-row>
-     *   </br-table-header>
-     *   <br-table-body slot="body">
-     *     <br-table-row>
-     *       <br-table-cell>Maria Silva</br-table-cell>
-     *       <br-table-cell>Analista</br-table-cell>
-     *     </br-table-row>
-     *   </br-table-body>
-     * </br-table>
-     * ```
-     * ### Quando usar
-     * - Dados bidimensionais com cabeçalhos de coluna e necessidades de ordenação ou comparação.
-     * ### Quando evitar
-     * - Listas simples de itens lineares: use `br-list`.
-     * - Agrupamento de informações de um único registro: use `br-card`.
-     * Consulte as [diretrizes de design do GovBR](https://www.gov.br/ds/components/table?tab=designer).
-     * @category Dados, Conteúdo
-     * @status stable
-     * @Slot header: Área para inclusão do subcomponente br-table-header
-     * @Slot body: Área para inclusão do subcomponente br-table-body
+     * ## Design System
+     * Para 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).
+     * Apresenta e permite interagir com dados tabulares; não deve ser usada para
+     * organizar layout ou conteúdo que não seja tabular. Recebe o cabeçalho e o corpo
+     * pelos slots `header` e `body`, compostos por `br-table-header` e
+     * `br-table-header-cell`, e por `br-table-body`, `br-table-row` e `br-table-cell`.
+     * Orquestra a grade, a acessibilidade, a ordenação, a seleção e a expansão das
+     * linhas. A barra de ações é gerenciada pela tabela; `br-table-footer` é
+     * renderizado quando a paginação está habilitada. As propriedades de célula
+     * seguem, quando aplicável, a precedência: célula, linha, coluna, tabela e valor
+     * padrão. Cabeçalhos multinível usam várias linhas em `br-table-header` com
+     * `colSpan`/`rowSpan`. Linhas contíguas com `rowGroup` formam unidades de ordenação,
+     * paginação e virtualização; a seleção permanece individual. Células com `rowSpan`
+     * não atravessam os limites do grupo. Prefira tabelas simples quando possível.
+     * @cssprop --br-table-loading-opacity - Opacidade do conteúdo durante o carregamento. Padrão: 0.5.
+     * @fires brTableActionClick - Quando uma ação pública é acionada.
+     * @fires brTableSelectionChange - Quando o conjunto selecionado muda.
+     * @fires brTableRowExpansionChange - Quando uma linha expande ou recolhe.
+     * @fires brTableSortRequest - Antes de aplicar uma solicitação de ordenação.
+     * @fires brTableSortChange - Quando os critérios de ordenação mudam.
+     * @fires brTablePageChange - Quando o consumidor solicita outra página pela paginação do rodapé.
+     * @fires brTablePageSizeChange - Quando o consumidor solicita outra quantidade de itens por página.
+     * @fires brTableSearch - Quando a busca é enviada ou fechada.
      */
     interface BrTable {
         /**
-          * Ativa divisores verticais. Quando informada, tem precedência sobre `hasColumnDivider`.
+          * Limite padrão de ações exibidas em cada célula.
+          * @default 4
+         */
+        "cellActionsLimit": number;
+        /**
+          * Limpa a seleção de todas as linhas elegíveis.
+         */
+        "clearSelection": () => Promise<void>;
+        /**
+          * Recolhe todas as linhas que estiverem expandidas.
+         */
+        "collapseAllRows": () => Promise<void>;
+        /**
+          * Recolhe uma linha do corpo.
+          * @param rowIndex Índice da linha, começando em zero.
+         */
+        "collapseRow": (rowIndex: number) => Promise<void>;
+        /**
+          * Habilita divisores entre colunas.
+          * @remarks Quando informado, tem precedência sobre `hasColumnDivider`, inclusive quando `false`. Na ausência de ambos, os divisores ficam desabilitados.
          */
         "columnDivider"?: boolean;
         /**
-          * Largura global aplicada a todas as colunas.
-          * @remarks Valores aceitos: - fill - content - ${number}px - ${number}fr  Observação: - `columnWidth` não define o comportamento de `overflow`, mas pode interferir na sua percepção ao alterar o espaço disponível da coluna. - `content` (`max-content`) tende a expandir a coluna e reduzir casos visíveis de truncagem. - `fill` (`1fr`) tende a evidenciar truncagem quando o espaço horizontal é insuficiente.
+          * Largura padrão utilizada pelas colunas sem configuração própria.
           * @default fill
-          * @example ```html <br-table column-width="160px"></br-table> ```
          */
         "columnWidth"?: ColumnWidth;
         /**
-          * Define a densidade visual do componente.  - `small`: Alta densidade (componente menor, mais compacto e com menos espaçamento). - `medium`: Densidade intermediária, padrão recomendado para a maioria dos casos. - `large`: Baixa densidade (componente maior, mais espaçamento e altura).  Valores inválidos usam `medium`. Quando omitida, a densidade média é aplicada ao token.
+          * Limite usado para decidir quando agrupar ações contextuais em um menu. Quando o número de ações excede esse valor, as ações são agrupadas no dropdown (atualmente todas são movidas para o menu colapsado).
+          * @default 4
+         */
+        "contextualActionsLimit": number;
+        /**
+          * Página atual exibida pela paginação (1-indexada).
+          * @remarks Atualizada internamente quando `TableDataStore` já cobre a página solicitada. Utilize como valor inicial ou para navegar programaticamente para outra página.
+          * @default 1
+         */
+        "currentPage": number;
+        /**
+          * Densidade visual aplicada aos espaçamentos da tabela.
+          * @remarks Quando omitida, a propriedade permanece `undefined` e a densidade visual média é aplicada aos tokens da tabela.
+          * @default undefined
          */
         "density"?: TableDensity;
         /**
-          * Define o estilo visual dos divisores.
-          * @remarks Valores aceitos: - solid - dashed
+          * Estilo aplicado aos divisores habilitados.
           * @default solid
          */
         "dividerStyle"?: TableDividerStyle;
         /**
-          * Ativa divisores verticais entre colunas.
+          * Expande uma linha elegível do corpo.
+          * @param rowIndex Índice da linha, começando em zero.
+         */
+        "expandRow": (rowIndex: number) => Promise<void>;
+        /**
+          * Retorna as linhas atualmente selecionadas.
+          * @returns Elementos `br-table-row` selecionados no corpo.
+         */
+        "getSelectedRows": () => Promise<HTMLBrTableRowElement[]>;
+        /**
+          * Retorna o estado atual de ordenação aplicado na tabela.
+         */
+        "getSorting": () => Promise<TableSortState[]>;
+        /**
+          * Habilita divisores entre colunas quando `columnDivider` não é informado.
+          * @deprecated Use `columnDivider` instead.
           * @default false
-          * @deprecated Use `columnDivider`.
          */
         "hasColumnDivider"?: boolean;
         /**
-          * Ativa divisores horizontais entre linhas.
+          * Habilita a paginação da tabela, renderizando `br-table-footer` internamente.
+          * @remarks A paginação define o subconjunto lógico disponível para a lista virtual. `pageSize` conta linhas independentes ou grupos completos, e `visibleRows` controla quantas delas cabem simultaneamente na viewport. Quando os dados completos ainda não estão disponíveis localmente (paginação por API), informe `totalItems` e forneça o subconjunto correspondente após `brTablePageChange`.
+          * @default false
+         */
+        "hasPagination": boolean;
+        /**
+          * Habilita divisores entre linhas quando `rowDivider` não é informado.
+          * @deprecated Use `rowDivider` instead.
           * @default false
-          * @deprecated Use `rowDivider`.
          */
         "hasRowDivider"?: boolean;
         /**
-          * Define o alinhamento horizontal do conteúdo das células.
-          * @remarks Valores aceitos: - start - center - end
+          * Habilita a coluna de expansão de linhas.
+          * @default false
+         */
+        "hasRowExpansion": boolean;
+        /**
+          * Habilita o realce visual das linhas ao passar o ponteiro.
+          * @default false
+         */
+        "hasRowHover": boolean;
+        /**
+          * Habilita a coluna de seleção de linhas.
+          * @default false
+         */
+        "hasRowSelection": boolean;
+        /**
+          * Disponibiliza a interface de busca, sem filtrar ou destacar o conteúdo. A aplicação recebe `brTableSearch` e atualiza os dados local ou remotamente.
+          * @default false
+         */
+        "hasSearch": boolean;
+        /**
+          * Título apresentado na barra principal.
+          * @default null
+         */
+        "heading"?: string;
+        /**
+          * Limite usado para decidir quando agrupar ações globais em um menu. Quando o número de ações excede esse valor, as ações são agrupadas no dropdown (atualmente todas são movidas para o menu colapsado).
+          * @default 4
+         */
+        "headingActionsLimit": number;
+        /**
+          * Quantidade de itens lógicos usada somente para calcular a altura da viewport. Cada grupo contíguo conta como um item; a altura inclui todas as linhas físicas que compõem os grupos reservados. Não altera paginação, rolagem ou virtualização. Quando omitida, acompanha `visibleRows`.
+          * @default visibleRows
+         */
+        "heightRows"?: number;
+        /**
+          * Alinhamento horizontal padrão da tabela.
           * @default start
          */
         "horizontalAlignment"?: TableAlignment;
         /**
-          * Indica que as linhas estão sendo atualizadas pelo consumidor. O componente mantém o conteúdo anterior, aplica `aria-busy="true"` e exibe o slot `loading` sobre os dados; transporte, erro e substituição das linhas ficam sob responsabilidade da aplicação. A prop pode ser alterada diretamente ou pelos métodos `startLoading()` e `stopLoading()`.
+          * Indica que as linhas estão sendo atualizadas pelo consumidor.
+          * @remarks Mantém os dados anteriores, reduz sua opacidade e exibe o slot `loading` em um painel central com scrim sobre toda a tabela, incluindo barra de ações e paginação. O scrim fica limitado ao componente. Reflete o atributo `loading` e pode ser alterada diretamente ou pelos métodos `startLoading()` e `stopLoading()`. Não bloqueia o teclado nem gerencia requisições, erros ou substituição dos dados.
           * @default false
          */
         "loading": boolean;
         /**
-          * Define o comportamento de overflow para as células.
-          * @remarks Valores aceitos: - truncate - wrap  Observação: - O overflow é independente de `columnWidth`. - Com `columnWidth="content"`, a coluna tende a crescer com o conteúdo (`max-content`), o que pode reduzir casos visíveis de truncagem. - Com `columnWidth="fill"`, a coluna ocupa o espaço disponível (`1fr`), então a truncagem tende a ficar mais evidente quando não há espaço suficiente.
+          * Texto do tooltip do botão de ações agrupadas da barra contextual. Quando vazio ou composto apenas por espaços, usa "Mais ações". Não altera o nome acessível do botão nem os rótulos do menu.
+          * @default 'Mais ações'
+         */
+        "moreActionsContextualLabel": string;
+        /**
+          * Texto do tooltip do botão de ações agrupadas na barra de título. Quando vazio ou composto apenas por espaços, usa "Mais ações". Não altera o nome acessível do botão nem os rótulos do menu.
+          * @default 'Mais ações'
+         */
+        "moreActionsHeadingLabel": string;
+        /**
+          * Texto completo do tooltip dos botões de ações agrupadas nas células. Quando informado, prevalece sobre `moreActionsLabel` de cada célula. Quando omitido, a célula usa seu valor local ou "Mais ações". Valores vazios ou compostos apenas por espaços usam "Mais ações". Aceita texto simples por atributo ou propriedade. Reflete o valor no atributo `more-actions-label` para sincronizar as células.
+          * @default undefined
+         */
+        "moreActionsLabel"?: string;
+        /**
+          * Estratégia padrão para conteúdos que excedem a célula.
           * @default wrap
          */
         "overflow"?: TableOverflow;
         /**
-          * Ativa divisores horizontais. Quando informada, tem precedência sobre `hasRowDivider`.
+          * Quantidade de itens pertencentes a cada página (linhas independentes ou grupos completos).
+          * @remarks Quando omitida, utiliza `visibleRows` como fallback para manter compatibilidade com a API anterior. Defina um valor maior que `visibleRows` para que paginação e virtualização operem simultaneamente.
+         */
+        "pageSize"?: number;
+        /**
+          * Opções disponíveis de itens por página no seletor da paginação.
+          * @default [10, 20, 30]
+         */
+        "pageSizeOptions": number[];
+        /**
+          * Habilita divisores entre linhas.
+          * @remarks Quando informado, tem precedência sobre `hasRowDivider`, inclusive quando `false`. Na ausência de ambos, os divisores ficam desabilitados.
          */
         "rowDivider"?: boolean;
         /**
-          * Inicia o estado de carregamento da tabela.
+          * Seleciona todas as linhas elegíveis.
+         */
+        "selectAllRows": () => Promise<void>;
+        /**
+          * Substitui os dados lógicos da tabela e reconstrói seus subcomponentes.
+          * @remarks Esta é a mesma estrutura interna utilizada após a ingestão dos slots.
+          * @param data Colunas, linhas e ações que formarão a tabela.
+          * @example ```js const table = document.querySelector('br-table'); await table.setData({   columns: [],   headerRows: [     [{ content: 'Unidade', rowSpan: 2 }, { content: 'Equipe', colSpan: 2 }],     [{ content: 'Nome', sortable: true }, { content: 'Cargo', sortable: true }],   ],   rows: [     { rowGroup: 'brasilia', cells: [       { content: 'Brasília', rowSpan: 2, rowHeader: true },       { content: 'Ana' }, { content: 'Analista' },     ] },     { rowGroup: 'brasilia', cells: [{ content: 'Carlos' }, { content: 'Técnico' }] },   ], }); ```
+         */
+        "setData": (data: TableData) => Promise<void>;
+        /**
+          * Força a apresentação da barra contextual.
+          * @default false
+         */
+        "showContextualBar": boolean;
+        /**
+          * Define se a tabela aceita uma única coluna ordenada ou múltiplas colunas. No modo `multi`, a prioridade é sempre a ordem visual da esquerda para a direita.
+          * @default single
+         */
+        "sortMode": TableSortMode;
+        /**
+          * Define se a tabela ordena as linhas localmente ou deixa a aplicação aplicar a ordenação solicitada. Em `manual`, a tabela mantém os indicadores e emite `brTableSortChange`, mas não reordena as linhas; use `setData()` para fornecer os resultados customizados ou remotos. Valores não reconhecidos usam a estratégia local.
+          * @default local
+         */
+        "sortStrategy": TableSortStrategy;
+        /**
+          * Inicia o estado visual de carregamento sem alterar os dados da tabela.
          */
         "startLoading": () => Promise<void>;
         /**
-          * Interrompe o estado de carregamento da tabela.
+          * Interrompe o estado visual de carregamento sem alterar os dados da tabela.
          */
         "stopLoading": () => Promise<void>;
         /**
           * Define o modo de resolução do tooltip nas células da tabela.
-          * @remarks Valores aceitos: - inherit - enabled - disabled
           * @default disabled (valor efetivo)
          */
         "tooltipMode"?: TableTooltipMode;
         /**
-          * Define o estado semântico do tooltip nas células da tabela.
-          * @remarks Valores aceitos: - info - warning - danger - success
+          * Estado visual padrão dos tooltips.
           * @default info
          */
         "tooltipState"?: TableTooltipState;
         /**
-          * Define o alinhamento vertical do conteúdo das células.
-          * @remarks Valores aceitos: - start - center - end
+          * Quantidade total de itens do conjunto de dados.
+          * @remarks Necessário apenas quando `TableDataStore` não contém o conjunto completo (paginação por API). Quando omitido, é derivado automaticamente da quantidade de linhas independentes e grupos já presentes na tabela.
+         */
+        "totalItems"?: number;
+        /**
+          * Alinhamento vertical padrão da tabela.
           * @default start
          */
         "verticalAlignment"?: TableAlignment;
+        /**
+          * Altura adicional estimada para conteúdo expandido ainda não medido.
+          * @default 240
+         */
+        "virtualExpandedContentHeight": number;
+        /**
+          * Quantidade de linhas de dados visíveis simultaneamente na viewport.
+          * @remarks Não limita o conjunto de dados nem realiza paginação. A altura da região de scroll é derivada desta quantidade e da densidade atual. Mesmo com `hasPagination` habilitado, esta propriedade continua definindo apenas a capacidade visual da viewport; `pageSize` define o tamanho lógico da página.
+          * @default 10
+         */
+        "visibleRows": number;
+    }
+    /**
+     * ## Design System
+     * Para 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).
+     * Representa uma ação global, contextual ou associada a uma linha da tabela.
+     * O contexto é inferido pelo slot e pela posição do componente na árvore.
+     * Para executar funções a partir das ações, ouça o evento `brTableActionClick`:
+     * ```html
+     * <!-- 1. Ouvindo diretamente na ação -->
+     * <br-table-action id="btn-filtro" label="Filtros" icon-name="fa-solid:filter"></br-table-action>
+     * <script>
+     *   document.getElementById('btn-filtro').addEventListener('brTableActionClick', () => {
+     *     executarFiltros();
+     *   });
+     * </script>
+     * <!-- 2. Ouvindo na tabela (recomendado para ações diretas e colapsadas em menu) -->
+     * <script>
+     *   table.addEventListener('brTableActionClick', (event) => {
+     *     const { type, label, rowIndex } = event.detail;
+     *     if (type === 'row') executarAcaoLinha(label, rowIndex);
+     *     else if (type === 'global') executarAcaoGlobal(label);
+     *   });
+     * </script>
+     * ```
+     * @fires brTableActionClick - Quando o usuário aciona o botão.
+     */
+    interface BrTableAction {
+        /**
+          * Rótulo acessível. Quando omitido, utiliza `label`.
+          * @default null
+         */
+        "ariaLabel": string | null;
+        /**
+          * Densidade visual aplicada ao botão interno da ação.
+         */
+        "density"?: TableDensity;
+        /**
+          * Nome do ícone exibido pelo botão.
+          * @default null
+         */
+        "iconName": string | null;
+        /**
+          * Texto visível e identificação semântica da ação.
+          * @default null
+         */
+        "label": string | null;
+    }
+    /**
+     * ## Design System
+     * Para 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).
+     * Exibe o título, as ações globais e as ações contextuais da tabela.
+     * Ações excedentes são agrupadas automaticamente em um menu.
+     * Compõe `br-table`, que configura a barra automaticamente. Também pode ser usada
+     * diretamente para compor uma barra de ações. Quando `hasSearch` está ativo,
+     * solicita a busca à aplicação, sem filtrar ou destacar os dados.
+     */
+    interface BrTableBar {
+        /**
+          * Limite usado para decidir quando agrupar ações contextuais em um menu. Quando o número de ações excede esse valor, as ações são agrupadas no dropdown (atualmente todas são movidas para o menu colapsado).
+          * @default 4
+         */
+        "contextualActionsLimit": number;
+        /**
+          * Densidade visual aplicada aos controles internos da barra.
+         */
+        "density"?: TableDensity;
+        /**
+          * Indica se o slot de ações contextuais possui conteúdo.
+          * @default false
+         */
+        "hasContextualActionsContent": boolean;
+        /**
+          * Indica se o slot de ações globais possui conteúdo.
+          * @default false
+         */
+        "hasGlobalActionsContent": boolean;
+        /**
+          * Disponibiliza a interface de busca controlada pela aplicação.
+          * @default false
+         */
+        "hasSearch": boolean;
+        /**
+          * Título apresentado na barra principal.
+          * @default ''
+         */
+        "heading": string;
+        /**
+          * Limite usado para decidir quando agrupar ações em um menu. Quando o número de ações excede esse valor, as ações são agrupadas no dropdown (atualmente todas são movidas para o menu colapsado).
+          * @default 4
+         */
+        "headingActionsLimit": number;
+        /**
+          * Número de linhas atualmente selecionadas.
+          * @default 0
+         */
+        "selectedRowsCount": number;
+        /**
+          * Força a apresentação da barra contextual mesmo sem seleção.
+          * @default false
+         */
+        "showContextualBar": boolean;
     }
     /**
-     * Corpo de dados (`<tbody>`) da tabela. Use no slot `body` do `br-table`.
-     * Agrupa as linhas `br-table-row` contendo as células de dados `br-table-cell`.
+     * ## Design System
+     * Para 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).
+     * Agrupa semanticamente as linhas que compõem o corpo de `br-table`.
+     * É uma peça declarativa do slot `body`; recebe `br-table-row` e entrega ao
+     * orquestrador a seleção, ordenação e materialização virtual. Os contêineres
+     * visuais dos grupos são internos, montados pela tabela e não devem ser
+     * instanciados pelo consumidor. Use o componente na composição de `br-table`.
      */
     interface BrTableBody {
     }
     /**
-     * Célula de dados (`<td>`) da tabela. Use dentro de um `br-table-row` no corpo da tabela.
-     * Coloque o conteúdo do registro no slot padrão.
+     * ## Design System
+     * Para 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).
+     * Representa uma célula de dados, com suporte a alinhamento, overflow,
+     * tooltip e agrupamento automático de ações excedentes. Compõe `br-table-row`
+     * dentro do corpo de `br-table`, que coordena posição, interação e herança.
+     * Use `rowSpan` dentro de um grupo contíguo de linhas e `rowHeader` para seu
+     * rótulo compartilhado; evite uso avulso fora da composição da tabela.
+     * @fires brAlignmentChange - Quando um alinhamento específico muda.
+     * @fires brOverflowChange - Quando a estratégia de overflow muda.
      */
     interface BrTableCell {
         /**
-          * Define o alinhamento horizontal do conteúdo dentro da célula.
+          * Densidade visual aplicada ao trigger de ações agrupadas.
+         */
+        "actionDensity"?: TableDensity;
+        /**
+          * Limite local de ações exibidas diretamente.
+          * @default null
+         */
+        "cellActionsLimit"?: number;
+        /**
+          * Quantidade de colunas ocupadas. Inteiro entre 1 e 1000; valores inválidos usam 1.
+          * @default 1
+         */
+        "colSpan": number;
+        /**
+          * Retorna a altura renderizada da superfície visual desta célula, em pixels.
+          * @returns Altura da superfície da célula; zero se ela ainda não estiver renderizada.
+         */
+        "getMeasuredHeight": () => Promise<number>;
+        /**
+          * Alinhamento horizontal específico da célula. Quando omitido, herda da linha, coluna ou tabela, nessa ordem.
+          * @default undefined
          */
         "horizontalAlignment"?: TableAlignment;
         /**
-          * 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.
+          * Texto completo do tooltip do botão de ações agrupadas desta célula. A propriedade `moreActionsLabel` de `br-table` prevalece quando informada. Valores vazios ou compostos apenas por espaços usam "Mais ações". Não altera o nome acessível do botão nem os rótulos das ações. Aceita texto simples por atributo ou propriedade, sem reflexão.
+          * @default 'Mais ações'
+         */
+        "moreActionsLabel": string;
+        /**
+          * Estratégia de overflow específica da célula. Quando omitida, herda da linha, coluna ou tabela, nessa ordem.
+          * @default undefined
          */
         "overflow"?: TableOverflow;
         /**
-          * Define o modo de resolução do tooltip nesta célula.
+          * Identifica um cabeçalho de linha, inclusive rótulos compartilhados por um grupo.
+          * @default false
+         */
+        "rowHeader": boolean;
+        /**
+          * Quantidade de linhas ocupadas no cabeçalho ou grupo. Limitada às linhas disponíveis; aceita inteiros de 1 a 1000 e valores inválidos usam 1.
+          * @default 1
+         */
+        "rowSpan": number;
+        /**
+          * Valor utilizado pela ordenação da coluna. Quando omitido, a tabela usa o texto renderizado da célula.
+          * @default null
+         */
+        "sortValue"?: string | number;
+        /**
+          * Modo de exibição do tooltip da célula. Quando omitido, herda da linha, coluna ou tabela, nessa ordem. No modo `enabled`, exibe o conteúdo somente quando estiver truncado na largura disponível.
+          * @default undefined
          */
         "tooltipMode"?: TableTooltipMode;
         /**
-          * Define o estado semântico do tooltip nesta célula.
+          * Estado visual do tooltip da célula. Quando omitido, herda da linha, coluna ou tabela, nessa ordem.
+          * @default undefined
          */
         "tooltipState"?: TableTooltipState;
         /**
-          * Define o alinhamento vertical do conteúdo dentro da célula.
+          * Alinhamento vertical específico da célula. Quando omitido, herda da linha, coluna ou tabela, nessa ordem.
+          * @default undefined
          */
         "verticalAlignment"?: TableAlignment;
     }
     /**
-     * Cabeçalho da tabela (`br-table`). Use no slot `header`.
-     * Agrupa as linhas `br-table-row` com as células de cabeçalho `br-table-header-cell`.
+     * 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).
+     * Renderiza a paginação da tabela quando `hasPagination` está habilitado em `br-table`.
+     * Orquestrado internamente pela tabela; não deve ser inserido diretamente pelo consumidor.
+     */
+    interface BrTableFooter {
+        /**
+          * Página atual exibida pela paginação (1-indexada).
+          * @default 1
+         */
+        "currentPage": number;
+        /**
+          * Densidade visual herdada da tabela.
+          * @default 'medium'
+         */
+        "density": TableFooterDensity;
+        /**
+          * Indica que a área de dados da tabela possui rolagem.
+          * @default false
+         */
+        "hasScroll": boolean;
+        /**
+          * Quantidade de itens exibidos por página.
+          * @default 10
+         */
+        "pageSize": number;
+        /**
+          * Opções disponíveis de itens por página.
+          * @default [10, 20, 30]
+         */
+        "pageSizeOptions": number[];
+        /**
+          * Quantidade total de itens do conjunto de dados.
+          * @default 0
+         */
+        "totalItems": number;
+    }
+    /**
+     * ## Design System
+     * Para 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).
+     * Agrupa as linhas de cabeçalho de `br-table`, que as posiciona em uma grade.
+     * Use uma linha para tabelas simples e múltiplas linhas com `colSpan`/`rowSpan`
+     * em `br-table-header-cell` para hierarquias de colunas. É uma peça declarativa
+     * do slot `header`, usada com o orquestrador; não realiza ordenação avulsa.
      */
     interface BrTableHeader {
     }
     /**
-     * Célula de cabeçalho (`<th>`) da tabela. Use dentro de um `br-table-row` no cabeçalho.
-     * Coloque o título da coluna no slot padrão. Para habilitar ordenação, ative `sortable`.
+     * ## Design System
+     * Para 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).
+     * Define o conteúdo e as propriedades herdáveis de uma coluna de `br-table`.
+     * Compõe as linhas de `br-table-header` no slot `header`; não deve ser usada
+     * avulsa. `colSpan` e `rowSpan` representam grupos e níveis do cabeçalho.
+     * Somente folhas que ocupam uma coluna podem ordenar os dados.
+     * Também exibe tooltip quando o conteúdo truncado requer informação adicional.
+     * @fires brColumnWidthChange - Quando a largura declarada muda.
+     * @fires brAlignmentChange - Quando um alinhamento da coluna muda.
+     * @fires brOverflowChange - Quando a estratégia de overflow muda.
      */
     interface BrTableHeaderCell {
         /**
-          * Define a largura da coluna. Aceita `fill`, `content`, larguras positivas em `px` ou frações positivas em `fr`. Valores inválidos usam o fallback da tabela.
-          * @example ```html <br-table-header-cell column-width="2fr">Descrição</br-table-header-cell> ```
+          * Quantidade de colunas ocupadas. Inteiro entre 1 e 1000; valores inválidos usam 1.
+          * @default 1
+         */
+        "colSpan": number;
+        /**
+          * Largura semântica ou CSS aplicada à coluna. Quando omitida, herda da tabela.
+          * @default undefined
          */
         "columnWidth"?: ColumnWidth;
         /**
-          * 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.
+          * Alinhamento horizontal herdado pelas células da coluna. Quando omitido, o cabeçalho herda da linha ou tabela, nessa ordem.
+          * @default undefined
          */
         "horizontalAlignment"?: TableAlignment;
         /**
-          * 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.
+          * Estratégia de overflow herdada pelas células da coluna. Quando omitida, o cabeçalho herda da linha ou tabela, nessa ordem.
+          * @default undefined
          */
         "overflow"?: TableOverflow;
         /**
-          * Define o modo de resolução do tooltip nesta coluna/célula de cabeçalho.
+          * Quantidade de linhas ocupadas no cabeçalho ou grupo. Limitada às linhas disponíveis; aceita inteiros de 1 a 1000 e valores inválidos usam 1.
+          * @default 1
+         */
+        "rowSpan": number;
+        /**
+          * Estado atual de ordenação controlado por `br-table`.
+         */
+        "sortDirection"?: TableSortDirection;
+        /**
+          * Habilita a ordenação desta coluna.
+          * @default false
+         */
+        "sortable": boolean;
+        /**
+          * Modo de exibição herdado pelos tooltips da coluna. Quando omitido ou definido como inherit, o cabeçalho herda da linha ou tabela, nessa ordem.
+          * @default undefined
          */
         "tooltipMode"?: TableTooltipMode;
         /**
-          * Define o estado semântico do tooltip nesta coluna/célula de cabeçalho.
+          * Estado visual herdado pelos tooltips da coluna. Quando omitido, o cabeçalho herda da linha ou tabela, nessa ordem.
+          * @default undefined
          */
         "tooltipState"?: TableTooltipState;
         /**
-          * 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.
+          * Alinhamento vertical herdado pelas células da coluna. Quando omitido, o cabeçalho herda da linha ou tabela, nessa ordem.
+          * @default undefined
          */
         "verticalAlignment"?: TableAlignment;
     }
     /**
-     * Linha horizontal (`<tr>`) da tabela. Use dentro de `br-table-header` ou `br-table-body`.
-     * Use `selected` para indicar que a linha está selecionada.
+     * ## Design System
+     * Para 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).
+     * Representa uma linha de dados e sua área opcional de conteúdo expandido.
+     * É uma peça declarativa de `br-table-body` ou `br-table-header`, coordenada por
+     * `br-table`. Recebe células de dados ou cabeçalho conforme o pai. `rowGroup`
+     * identifica linhas contíguas que devem permanecer juntas; use-o apenas no corpo.
+     * Em grupos, os detalhes expandidos são apresentados após as linhas do grupo.
+     * @fires brAlignmentChange - Quando um alinhamento herdável muda.
+     * @fires brOverflowChange - Quando a estratégia de overflow muda.
      */
     interface BrTableRow {
         /**
-          * 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.
+          * Indica se o conteúdo adicional da linha está visível.
+          * @default false
+         */
+        "expanded": boolean;
+        /**
+          * Retorna a maior altura das células desta linha somada à área de expansão, em pixels.
+          * @returns Altura medida das células diretamente pertencentes à linha e do conteúdo expandido renderizado.
+         */
+        "getMeasuredHeight": () => Promise<number>;
+        /**
+          * Alinhamento horizontal herdado pelas células da linha.
+          * @default undefined
          */
         "horizontalAlignment"?: TableAlignment;
         /**
-          * 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.
+          * Estratégia de overflow herdada pelas células da linha.
+          * @default undefined
          */
         "overflow"?: TableOverflow;
         /**
-          * Define o modo de resolução do tooltip nas células desta linha.
+          * Controla se a expansão é habilitada, desabilitada ou herdada da tabela.
+          * @default 'inherit'
+         */
+        "rowExpansion": TableRowExpansion;
+        /**
+          * Identifica um grupo contíguo de linhas com chave exclusiva, preservado como unidade na ordenação, paginação e virtualização. Vazio ou omitido mantém a linha independente. A seleção continua sendo individual por linha.
+          * @default undefined
+         */
+        "rowGroup"?: string;
+        /**
+          * Indica se a linha está selecionada.
+          * @default false
+         */
+        "selected": boolean;
+        /**
+          * Modo de exibição herdado pelos tooltips da linha.
+          * @default undefined
          */
         "tooltipMode"?: TableTooltipMode;
         /**
-          * Define o estado semântico do tooltip nas células desta linha.
+          * Estado visual herdado pelos tooltips da linha.
+          * @default undefined
          */
         "tooltipState"?: TableTooltipState;
         /**
-          * 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.
+          * Alinhamento vertical herdado pelas células da linha.
+          * @default undefined
          */
         "verticalAlignment"?: TableAlignment;
+        /**
+          * Altura visível da área expandida desta linha, em pixels.
+          * @remarks Quando omitida, herda `virtualExpandedContentHeight` de `br-table`.
+          * @default null
+         */
+        "virtualExpandedContentHeight"?: number | null;
     }
     /**
      * O `br-tag` categoriza, rotula ou destaca informações curtas e metadados.
@@ -6706,10 +7128,26 @@ export interface BrTabItemCustomEvent<T> extends CustomEvent<T> {
     detail: T;
     target: HTMLBrTabItemElement;
 }
+export interface BrTableCustomEvent<T> extends CustomEvent<T> {
+    detail: T;
+    target: HTMLBrTableElement;
+}
+export interface BrTableActionCustomEvent<T> extends CustomEvent<T> {
+    detail: T;
+    target: HTMLBrTableActionElement;
+}
+export interface BrTableBarCustomEvent<T> extends CustomEvent<T> {
+    detail: T;
+    target: HTMLBrTableBarElement;
+}
 export interface BrTableCellCustomEvent<T> extends CustomEvent<T> {
     detail: T;
     target: HTMLBrTableCellElement;
 }
+export interface BrTableFooterCustomEvent<T> extends CustomEvent<T> {
+    detail: T;
+    target: HTMLBrTableFooterElement;
+}
 export interface BrTableHeaderCellCustomEvent<T> extends CustomEvent<T> {
     detail: T;
     target: HTMLBrTableHeaderCellElement;
@@ -7893,8 +8331,8 @@ declare global {
      * O `br-magic-button` é o botão de ação flutuante (FAB) que destaca a ação primária ou mais frequente da tela.
      * Pode ser exibido apenas com ícone (formato circular) ou expandido com texto descritivo.
      * ```html
-     * <br-magic-button icon="fa6-solid:plus" aria-label="Novo item"></br-magic-button>
-     * <br-magic-button icon="fa6-solid:plus">Criar documento</br-magic-button>
+     * <br-magic-button icon="fa-solid:plus" aria-label="Novo item"></br-magic-button>
+     * <br-magic-button icon="fa-solid:plus">Criar documento</br-magic-button>
      * ```
      * ### Quando usar
      * - Ação principal e dominante da tela em dispositivos móveis ou interfaces focadas em uma tarefa única.
@@ -8831,45 +9269,131 @@ declare global {
         prototype: HTMLBrTabItemElement;
         new (): HTMLBrTabItemElement;
     };
-    /**
-     * O `br-table` estrutura e exibe conjuntos de dados organizados em linhas e colunas.
-     * Estruture 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`.
-     * ```html
-     * <br-table>
-     *   <br-table-header slot="header">
-     *     <br-table-row>
-     *       <br-table-header-cell>Nome</br-table-header-cell>
-     *       <br-table-header-cell>Cargo</br-table-header-cell>
-     *     </br-table-row>
-     *   </br-table-header>
-     *   <br-table-body slot="body">
-     *     <br-table-row>
-     *       <br-table-cell>Maria Silva</br-table-cell>
-     *       <br-table-cell>Analista</br-table-cell>
-     *     </br-table-row>
-     *   </br-table-body>
-     * </br-table>
-     * ```
-     * ### Quando usar
-     * - Dados bidimensionais com cabeçalhos de coluna e necessidades de ordenação ou comparação.
-     * ### Quando evitar
-     * - Listas simples de itens lineares: use `br-list`.
-     * - Agrupamento de informações de um único registro: use `br-card`.
-     * Consulte as [diretrizes de design do GovBR](https://www.gov.br/ds/components/table?tab=designer).
-     * @category Dados, Conteúdo
-     * @status stable
-     * @Slot header: Área para inclusão do subcomponente br-table-header
-     * @Slot body: Área para inclusão do subcomponente br-table-body
+    interface HTMLBrTableElementEventMap {
+        "brTableActionClick": TableActionClickDetail;
+        "brTableSelectionChange": TableSelectionChangeDetail;
+        "brTableRowExpansionChange": TableRowExpansionChangeDetail;
+        "brTableSortChange": TableSortChangeDetail;
+        "brTableSortRequest": TableSortRequestDetail;
+        "brTablePageChange": TablePageChangeDetail;
+        "brTablePageSizeChange": TablePageSizeChangeDetail;
+        "brTableSearch": TableSearchDetail;
+    }
+    /**
+     * ## Design System
+     * Para 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).
+     * Apresenta e permite interagir com dados tabulares; não deve ser usada para
+     * organizar layout ou conteúdo que não seja tabular. Recebe o cabeçalho e o corpo
+     * pelos slots `header` e `body`, compostos por `br-table-header` e
+     * `br-table-header-cell`, e por `br-table-body`, `br-table-row` e `br-table-cell`.
+     * Orquestra a grade, a acessibilidade, a ordenação, a seleção e a expansão das
+     * linhas. A barra de ações é gerenciada pela tabela; `br-table-footer` é
+     * renderizado quando a paginação está habilitada. As propriedades de célula
+     * seguem, quando aplicável, a precedência: célula, linha, coluna, tabela e valor
+     * padrão. Cabeçalhos multinível usam várias linhas em `br-table-header` com
+     * `colSpan`/`rowSpan`. Linhas contíguas com `rowGroup` formam unidades de ordenação,
+     * paginação e virtualização; a seleção permanece individual. Células com `rowSpan`
+     * não atravessam os limites do grupo. Prefira tabelas simples quando possível.
+     * @cssprop --br-table-loading-opacity - Opacidade do conteúdo durante o carregamento. Padrão: 0.5.
+     * @fires brTableActionClick - Quando uma ação pública é acionada.
+     * @fires brTableSelectionChange - Quando o conjunto selecionado muda.
+     * @fires brTableRowExpansionChange - Quando uma linha expande ou recolhe.
+     * @fires brTableSortRequest - Antes de aplicar uma solicitação de ordenação.
+     * @fires brTableSortChange - Quando os critérios de ordenação mudam.
+     * @fires brTablePageChange - Quando o consumidor solicita outra página pela paginação do rodapé.
+     * @fires brTablePageSizeChange - Quando o consumidor solicita outra quantidade de itens por página.
+     * @fires brTableSearch - Quando a busca é enviada ou fechada.
      */
     interface HTMLBrTableElement extends Components.BrTable, HTMLStencilElement {
+        addEventListener<K extends keyof HTMLBrTableElementEventMap>(type: K, listener: (this: HTMLBrTableElement, ev: BrTableCustomEvent<HTMLBrTableElementEventMap[K]>) => any, options?: boolean | AddEventListenerOptions): void;
+        addEventListener<K extends keyof DocumentEventMap>(type: K, listener: (this: Document, ev: DocumentEventMap[K]) => any, options?: boolean | AddEventListenerOptions): void;
+        addEventListener<K extends keyof HTMLElementEventMap>(type: K, listener: (this: HTMLElement, ev: HTMLElementEventMap[K]) => any, options?: boolean | AddEventListenerOptions): void;
+        addEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | AddEventListenerOptions): void;
+        removeEventListener<K extends keyof HTMLBrTableElementEventMap>(type: K, listener: (this: HTMLBrTableElement, ev: BrTableCustomEvent<HTMLBrTableElementEventMap[K]>) => any, options?: boolean | EventListenerOptions): void;
+        removeEventListener<K extends keyof DocumentEventMap>(type: K, listener: (this: Document, ev: DocumentEventMap[K]) => any, options?: boolean | EventListenerOptions): void;
+        removeEventListener<K extends keyof HTMLElementEventMap>(type: K, listener: (this: HTMLElement, ev: HTMLElementEventMap[K]) => any, options?: boolean | EventListenerOptions): void;
+        removeEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | EventListenerOptions): void;
     }
     var HTMLBrTableElement: {
         prototype: HTMLBrTableElement;
         new (): HTMLBrTableElement;
     };
+    interface HTMLBrTableActionElementEventMap {
+        "brTableActionClick": TableActionClickDetail;
+    }
+    /**
+     * ## Design System
+     * Para 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).
+     * Representa uma ação global, contextual ou associada a uma linha da tabela.
+     * O contexto é inferido pelo slot e pela posição do componente na árvore.
+     * Para executar funções a partir das ações, ouça o evento `brTableActionClick`:
+     * ```html
+     * <!-- 1. Ouvindo diretamente na ação -->
+     * <br-table-action id="btn-filtro" label="Filtros" icon-name="fa-solid:filter"></br-table-action>
+     * <script>
+     *   document.getElementById('btn-filtro').addEventListener('brTableActionClick', () => {
+     *     executarFiltros();
+     *   });
+     * </script>
+     * <!-- 2. Ouvindo na tabela (recomendado para ações diretas e colapsadas em menu) -->
+     * <script>
+     *   table.addEventListener('brTableActionClick', (event) => {
+     *     const { type, label, rowIndex } = event.detail;
+     *     if (type === 'row') executarAcaoLinha(label, rowIndex);
+     *     else if (type === 'global') executarAcaoGlobal(label);
+     *   });
+     * </script>
+     * ```
+     * @fires brTableActionClick - Quando o usuário aciona o botão.
+     */
+    interface HTMLBrTableActionElement extends Components.BrTableAction, HTMLStencilElement {
+        addEventListener<K extends keyof HTMLBrTableActionElementEventMap>(type: K, listener: (this: HTMLBrTableActionElement, ev: BrTableActionCustomEvent<HTMLBrTableActionElementEventMap[K]>) => any, options?: boolean | AddEventListenerOptions): void;
+        addEventListener<K extends keyof DocumentEventMap>(type: K, listener: (this: Document, ev: DocumentEventMap[K]) => any, options?: boolean | AddEventListenerOptions): void;
+        addEventListener<K extends keyof HTMLElementEventMap>(type: K, listener: (this: HTMLElement, ev: HTMLElementEventMap[K]) => any, options?: boolean | AddEventListenerOptions): void;
+        addEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | AddEventListenerOptions): void;
+        removeEventListener<K extends keyof HTMLBrTableActionElementEventMap>(type: K, listener: (this: HTMLBrTableActionElement, ev: BrTableActionCustomEvent<HTMLBrTableActionElementEventMap[K]>) => any, options?: boolean | EventListenerOptions): void;
+        removeEventListener<K extends keyof DocumentEventMap>(type: K, listener: (this: Document, ev: DocumentEventMap[K]) => any, options?: boolean | EventListenerOptions): void;
+        removeEventListener<K extends keyof HTMLElementEventMap>(type: K, listener: (this: HTMLElement, ev: HTMLElementEventMap[K]) => any, options?: boolean | EventListenerOptions): void;
+        removeEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | EventListenerOptions): void;
+    }
+    var HTMLBrTableActionElement: {
+        prototype: HTMLBrTableActionElement;
+        new (): HTMLBrTableActionElement;
+    };
+    interface HTMLBrTableBarElementEventMap {
+        "brTableSearch": TableSearchDetail;
+    }
+    /**
+     * ## Design System
+     * Para 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).
+     * Exibe o título, as ações globais e as ações contextuais da tabela.
+     * Ações excedentes são agrupadas automaticamente em um menu.
+     * Compõe `br-table`, que configura a barra automaticamente. Também pode ser usada
+     * diretamente para compor uma barra de ações. Quando `hasSearch` está ativo,
+     * solicita a busca à aplicação, sem filtrar ou destacar os dados.
+     */
+    interface HTMLBrTableBarElement extends Components.BrTableBar, HTMLStencilElement {
+        addEventListener<K extends keyof HTMLBrTableBarElementEventMap>(type: K, listener: (this: HTMLBrTableBarElement, ev: BrTableBarCustomEvent<HTMLBrTableBarElementEventMap[K]>) => any, options?: boolean | AddEventListenerOptions): void;
+        addEventListener<K extends keyof DocumentEventMap>(type: K, listener: (this: Document, ev: DocumentEventMap[K]) => any, options?: boolean | AddEventListenerOptions): void;
+        addEventListener<K extends keyof HTMLElementEventMap>(type: K, listener: (this: HTMLElement, ev: HTMLElementEventMap[K]) => any, options?: boolean | AddEventListenerOptions): void;
+        addEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | AddEventListenerOptions): void;
+        removeEventListener<K extends keyof HTMLBrTableBarElementEventMap>(type: K, listener: (this: HTMLBrTableBarElement, ev: BrTableBarCustomEvent<HTMLBrTableBarElementEventMap[K]>) => any, options?: boolean | EventListenerOptions): void;
+        removeEventListener<K extends keyof DocumentEventMap>(type: K, listener: (this: Document, ev: DocumentEventMap[K]) => any, options?: boolean | EventListenerOptions): void;
+        removeEventListener<K extends keyof HTMLElementEventMap>(type: K, listener: (this: HTMLElement, ev: HTMLElementEventMap[K]) => any, options?: boolean | EventListenerOptions): void;
+        removeEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | EventListenerOptions): void;
+    }
+    var HTMLBrTableBarElement: {
+        prototype: HTMLBrTableBarElement;
+        new (): HTMLBrTableBarElement;
+    };
     /**
-     * Corpo de dados (`<tbody>`) da tabela. Use no slot `body` do `br-table`.
-     * Agrupa as linhas `br-table-row` contendo as células de dados `br-table-cell`.
+     * ## Design System
+     * Para 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).
+     * Agrupa semanticamente as linhas que compõem o corpo de `br-table`.
+     * É uma peça declarativa do slot `body`; recebe `br-table-row` e entrega ao
+     * orquestrador a seleção, ordenação e materialização virtual. Os contêineres
+     * visuais dos grupos são internos, montados pela tabela e não devem ser
+     * instanciados pelo consumidor. Use o componente na composição de `br-table`.
      */
     interface HTMLBrTableBodyElement extends Components.BrTableBody, HTMLStencilElement {
     }
@@ -8882,8 +9406,15 @@ declare global {
         "brOverflowChange": void;
     }
     /**
-     * Célula de dados (`<td>`) da tabela. Use dentro de um `br-table-row` no corpo da tabela.
-     * Coloque o conteúdo do registro no slot padrão.
+     * ## Design System
+     * Para 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).
+     * Representa uma célula de dados, com suporte a alinhamento, overflow,
+     * tooltip e agrupamento automático de ações excedentes. Compõe `br-table-row`
+     * dentro do corpo de `br-table`, que coordena posição, interação e herança.
+     * Use `rowSpan` dentro de um grupo contíguo de linhas e `rowHeader` para seu
+     * rótulo compartilhado; evite uso avulso fora da composição da tabela.
+     * @fires brAlignmentChange - Quando um alinhamento específico muda.
+     * @fires brOverflowChange - Quando a estratégia de overflow muda.
      */
     interface HTMLBrTableCellElement extends Components.BrTableCell, HTMLStencilElement {
         addEventListener<K extends keyof HTMLBrTableCellElementEventMap>(type: K, listener: (this: HTMLBrTableCellElement, ev: BrTableCellCustomEvent<HTMLBrTableCellElementEventMap[K]>) => any, options?: boolean | AddEventListenerOptions): void;
@@ -8899,9 +9430,36 @@ declare global {
         prototype: HTMLBrTableCellElement;
         new (): HTMLBrTableCellElement;
     };
+    interface HTMLBrTableFooterElementEventMap {
+        "brInternalTableFooterPageChange": TableFooterPageChangeDetail;
+        "brInternalTableFooterPerPageChange": TableFooterPerPageChangeDetail;
+    }
+    /**
+     * 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).
+     * Renderiza a paginação da tabela quando `hasPagination` está habilitado em `br-table`.
+     * Orquestrado internamente pela tabela; não deve ser inserido diretamente pelo consumidor.
+     */
+    interface HTMLBrTableFooterElement extends Components.BrTableFooter, HTMLStencilElement {
+        addEventListener<K extends keyof HTMLBrTableFooterElementEventMap>(type: K, listener: (this: HTMLBrTableFooterElement, ev: BrTableFooterCustomEvent<HTMLBrTableFooterElementEventMap[K]>) => any, options?: boolean | AddEventListenerOptions): void;
+        addEventListener<K extends keyof DocumentEventMap>(type: K, listener: (this: Document, ev: DocumentEventMap[K]) => any, options?: boolean | AddEventListenerOptions): void;
+        addEventListener<K extends keyof HTMLElementEventMap>(type: K, listener: (this: HTMLElement, ev: HTMLElementEventMap[K]) => any, options?: boolean | AddEventListenerOptions): void;
+        addEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | AddEventListenerOptions): void;
+        removeEventListener<K extends keyof HTMLBrTableFooterElementEventMap>(type: K, listener: (this: HTMLBrTableFooterElement, ev: BrTableFooterCustomEvent<HTMLBrTableFooterElementEventMap[K]>) => any, options?: boolean | EventListenerOptions): void;
+        removeEventListener<K extends keyof DocumentEventMap>(type: K, listener: (this: Document, ev: DocumentEventMap[K]) => any, options?: boolean | EventListenerOptions): void;
+        removeEventListener<K extends keyof HTMLElementEventMap>(type: K, listener: (this: HTMLElement, ev: HTMLElementEventMap[K]) => any, options?: boolean | EventListenerOptions): void;
+        removeEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | EventListenerOptions): void;
+    }
+    var HTMLBrTableFooterElement: {
+        prototype: HTMLBrTableFooterElement;
+        new (): HTMLBrTableFooterElement;
+    };
     /**
-     * Cabeçalho da tabela (`br-table`). Use no slot `header`.
-     * Agrupa as linhas `br-table-row` com as células de cabeçalho `br-table-header-cell`.
+     * ## Design System
+     * Para 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).
+     * Agrupa as linhas de cabeçalho de `br-table`, que as posiciona em uma grade.
+     * Use uma linha para tabelas simples e múltiplas linhas com `colSpan`/`rowSpan`
+     * em `br-table-header-cell` para hierarquias de colunas. É uma peça declarativa
+     * do slot `header`, usada com o orquestrador; não realiza ordenação avulsa.
      */
     interface HTMLBrTableHeaderElement extends Components.BrTableHeader, HTMLStencilElement {
     }
@@ -8913,10 +9471,19 @@ declare global {
         "brColumnWidthChange": void;
         "brAlignmentChange": void;
         "brOverflowChange": void;
+        "brInternalTableSortRequest": void;
     }
     /**
-     * Célula de cabeçalho (`<th>`) da tabela. Use dentro de um `br-table-row` no cabeçalho.
-     * Coloque o título da coluna no slot padrão. Para habilitar ordenação, ative `sortable`.
+     * ## Design System
+     * Para 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).
+     * Define o conteúdo e as propriedades herdáveis de uma coluna de `br-table`.
+     * Compõe as linhas de `br-table-header` no slot `header`; não deve ser usada
+     * avulsa. `colSpan` e `rowSpan` representam grupos e níveis do cabeçalho.
+     * Somente folhas que ocupam uma coluna podem ordenar os dados.
+     * Também exibe tooltip quando o conteúdo truncado requer informação adicional.
+     * @fires brColumnWidthChange - Quando a largura declarada muda.
+     * @fires brAlignmentChange - Quando um alinhamento da coluna muda.
+     * @fires brOverflowChange - Quando a estratégia de overflow muda.
      */
     interface HTMLBrTableHeaderCellElement extends Components.BrTableHeaderCell, HTMLStencilElement {
         addEventListener<K extends keyof HTMLBrTableHeaderCellElementEventMap>(type: K, listener: (this: HTMLBrTableHeaderCellElement, ev: BrTableHeaderCellCustomEvent<HTMLBrTableHeaderCellElementEventMap[K]>) => any, options?: boolean | AddEventListenerOptions): void;
@@ -8937,8 +9504,15 @@ declare global {
         "brOverflowChange": void;
     }
     /**
-     * Linha horizontal (`<tr>`) da tabela. Use dentro de `br-table-header` ou `br-table-body`.
-     * Use `selected` para indicar que a linha está selecionada.
+     * ## Design System
+     * Para 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).
+     * Representa uma linha de dados e sua área opcional de conteúdo expandido.
+     * É uma peça declarativa de `br-table-body` ou `br-table-header`, coordenada por
+     * `br-table`. Recebe células de dados ou cabeçalho conforme o pai. `rowGroup`
+     * identifica linhas contíguas que devem permanecer juntas; use-o apenas no corpo.
+     * Em grupos, os detalhes expandidos são apresentados após as linhas do grupo.
+     * @fires brAlignmentChange - Quando um alinhamento herdável muda.
+     * @fires brOverflowChange - Quando a estratégia de overflow muda.
      */
     interface HTMLBrTableRowElement extends Components.BrTableRow, HTMLStencilElement {
         addEventListener<K extends keyof HTMLBrTableRowElementEventMap>(type: K, listener: (this: HTMLBrTableRowElement, ev: BrTableRowCustomEvent<HTMLBrTableRowElementEventMap[K]>) => any, options?: boolean | AddEventListenerOptions): void;
@@ -9251,8 +9825,11 @@ declare global {
         "br-tab": HTMLBrTabElement;
         "br-tab-item": HTMLBrTabItemElement;
         "br-table": HTMLBrTableElement;
+        "br-table-action": HTMLBrTableActionElement;
+        "br-table-bar": HTMLBrTableBarElement;
         "br-table-body": HTMLBrTableBodyElement;
         "br-table-cell": HTMLBrTableCellElement;
+        "br-table-footer": HTMLBrTableFooterElement;
         "br-table-header": HTMLBrTableHeaderElement;
         "br-table-header-cell": HTMLBrTableHeaderCellElement;
         "br-table-row": HTMLBrTableRowElement;
@@ -10030,13 +10607,13 @@ declare namespace LocalJSX {
          */
         "iconPosition"?: CollapseIconPosition;
         /**
-          * Identificador Iconify do ícone exibido quando o conteúdo está visível. O valor padrão usa o registro SVG local. Para ícones por classe CSS, use o slot `icon-to-hide`.
-          * @default 'fa6-solid:chevron-up'
+          * Identificador de ícone Font Awesome 5 Free presente no cache local, exibido quando o conteúdo está visível. Para ícones por classe CSS, use o slot `icon-to-hide`.
+          * @default 'fa-solid:chevron-up'
          */
         "iconToHide"?: string;
         /**
-          * Identificador Iconify do ícone exibido quando o conteúdo está oculto. O valor padrão usa o registro SVG local. Para ícones por classe CSS, use o slot `icon-to-show`.
-          * @default 'fa6-solid:chevron-down'
+          * Identificador de ícone Font Awesome 5 Free presente no cache local, exibido quando o conteúdo está oculto. Para ícones por classe CSS, use o slot `icon-to-show`.
+          * @default 'fa-solid:chevron-down'
          */
         "iconToShow"?: string;
         /**
@@ -11187,7 +11764,7 @@ declare namespace LocalJSX {
          */
         "href"?: string;
         /**
-          * Identificador da rede social. Os ícones oficiais mais comuns são renderizados pelo registro SVG local; use o slot `icon` para uma fonte diferente ou uma classe Font Awesome personalizada.
+          * Nome do ícone Font Awesome 5 Free presente no cache local, sem o prefixo `fa-brands:` (ex.: `instagram`). Use o slot `icon` para conteúdo próprio.
          */
         "icon"?: string;
         /**
@@ -11527,7 +12104,7 @@ declare namespace LocalJSX {
          */
         "height"?: string;
         /**
-          * Identificador legado do ícone. Identificadores que pertencem ao registro local são renderizados como SVG empacotado; nomes desconhecidos continuam disponíveis via Iconify somente para compatibilidade.
+          * Identificador legado do ícone. Nomes no cache local são renderizados como SVG empacotado; em `source="auto"`, nomes ausentes usam Iconify como fallback. `source="iconify"` força essa origem.
           * @deprecated Use `src` com um asset controlado pela aplicação, `svg` ou o slot padrão.
          */
         "iconName"?: string;
@@ -11552,7 +12129,7 @@ declare namespace LocalJSX {
          */
         "label"?: string;
         /**
-          * Controla o comportamento de carregamento do ícone.  Comportamento: - Padrão (propriedade não definida): carregamento imediato aplicando `noobserver` para evitar problemas de layout shift - `lazy={true}`: ativa o carregamento tardio nativo para imagens em `src` e o observer do Iconify no fallback legado - `lazy={false}`: carregamento imediato  **Nota**: O padrão foi alterado para carregamento imediato para resolver problemas de deslocamento de layout que ocorriam quando ícones eram carregados depois do conteúdo inicial.  SVG inline e conteúdo em slot não precisam de carregamento tardio, pois já estão disponíveis no DOM.
+          * Controla o comportamento de carregamento do ícone.  Comportamento: - Padrão (propriedade não definida): carregamento imediato aplicando `noobserver` para evitar problemas de layout shift - `lazy={true}`: ativa o carregamento tardio nativo para imagens em `src` - `lazy={false}`: carregamento imediato  **Nota**: O padrão foi alterado para carregamento imediato para resolver problemas de deslocamento de layout que ocorriam quando ícones eram carregados depois do conteúdo inicial.  SVG inline e conteúdo em slot não precisam de carregamento tardio, pois já estão disponíveis no DOM.
          */
         "lazy"?: boolean;
         /**
@@ -11560,7 +12137,8 @@ declare namespace LocalJSX {
          */
         "rotate"?: IconRotate;
         /**
-          * Define explicitamente a origem do ícone. Quando `auto`, o componente prioriza slot, SVG inline e imagem por URL. Iconify fica apenas como fallback de compatibilidade quando nenhuma fonte própria foi informada. Aceita `auto`, `iconify`, `image`, `svg` ou `slot`; valores inválidos usam `auto`.
+          * Define explicitamente a origem do ícone. Quando `auto`, o componente prioriza slot, SVG inline, imagem por URL e o cache local Font Awesome 5 Free. Se `iconName` não estiver no cache, usa Iconify como fallback. `iconify` força essa origem mesmo para nomes presentes no cache. Aceita `auto`, `iconify`, `image`, `svg` ou `slot`; valores inválidos usam `auto`.
+          * @remarks Os componentes do Design System usam identificadores presentes no cache local; Iconify atende nomes ausentes e usos explícitos.
           * @default 'auto'
          */
         "source"?: IconSource;
@@ -12230,8 +12808,8 @@ declare namespace LocalJSX {
      * O `br-magic-button` é o botão de ação flutuante (FAB) que destaca a ação primária ou mais frequente da tela.
      * Pode ser exibido apenas com ícone (formato circular) ou expandido com texto descritivo.
      * ```html
-     * <br-magic-button icon="fa6-solid:plus" aria-label="Novo item"></br-magic-button>
-     * <br-magic-button icon="fa6-solid:plus">Criar documento</br-magic-button>
+     * <br-magic-button icon="fa-solid:plus" aria-label="Novo item"></br-magic-button>
+     * <br-magic-button icon="fa-solid:plus">Criar documento</br-magic-button>
      * ```
      * ### Quando usar
      * - Ação principal e dominante da tela em dispositivos móveis ou interfaces focadas em uma tarefa única.
@@ -12264,7 +12842,7 @@ declare namespace LocalJSX {
          */
         "density"?: BrDensity;
         /**
-          * Ícone como identificador Iconify (ex.: `fa6-solid:star`) ou nome simples (ex.: `question`, resolvido como `fa6-solid:question` no registro SVG local), renderizado pelo `br-icon`. Para classes CSS (ex.: Font Awesome) ou SVGs personalizados, use o slot `icon`, a forma preferida. Uso descontinuado: classes CSS nesta prop (ex.: `fas fa-star`) não são exibidas no Shadow DOM e geram aviso.
+          * Ícone como identificador Font Awesome 5 Free do cache local (ex.: `fa-solid:star`) ou nome simples (ex.: `question`, resolvido como `fa-solid:question`), renderizado pelo `br-icon`. Para classes CSS (ex.: Font Awesome) ou SVGs personalizados, use o slot `icon`, a forma preferida. Uso descontinuado: classes CSS nesta prop (ex.: `fas fa-star`) não são exibidas no Shadow DOM e geram aviso.
           * @default ''
          */
         "icon"?: string;
@@ -12598,7 +13176,7 @@ declare namespace LocalJSX {
          */
         "href": string;
         /**
-          * Identificador da rede social. Os ícones oficiais mais comuns são renderizados pelo registro SVG local; use o slot `icon` para uma fonte diferente ou uma classe Font Awesome personalizada.
+          * Nome do ícone Font Awesome 5 Free presente no cache local, sem o prefixo `fa-brands:` (ex.: `facebook-f`). Use o slot `icon` para conteúdo próprio.
          */
         "icon"?: string;
         /**
@@ -13909,7 +14487,7 @@ declare namespace LocalJSX {
          */
         "onBrSelectOptionPropsChange"?: (event: BrSelectOptionCustomEvent<void>) => void;
         /**
-          * Evento emitido quando o estado da opção muda.
+          * Evento emitido ao ativar a opção por clique, teclado ou `setSelectedState()`. Fora de `br-select`, também informa alterações de `selected` e `disabled`. Dentro de `br-select`, a sincronização dessas props não é uma nova interação.
           * @event brSelectOptionStateChange
           * @type {EventEmitter<SelectOptionData>}
          */
@@ -14261,8 +14839,8 @@ declare namespace LocalJSX {
         "step"?: number;
         /**
           * Lista de passos customizados para o slider. Cada passo pode definir `value`, `label` (texto exibido no tooltip e/ou abaixo da trilha) e `icon` (nome do ícone exibido abaixo da marcação do passo). Aceita array de objetos `SliderStep[]`, array de strings `string[]`, ou string JSON.
-          * @example ```html <br-slider   steps='[{"value": 1, "label": "Péssimo", "icon": "fa-solid:face-frown"}, {"value": 5, "label": "Excelente", "icon": "fa-solid:face-laugh"}]' ></br-slider> ```
-          * @example ```js const slider = document.querySelector('br-slider'); slider.steps = [   { value: 1, label: 'Péssimo', icon: 'fa-solid:face-frown' },   { value: 5, label: 'Excelente', icon: 'fa-solid:face-laugh' }, ]; ```
+          * @example ```html <br-slider   steps='[{"value": 1, "label": "Péssimo", "icon": "fa-solid:frown"}, {"value": 5, "label": "Excelente", "icon": "fa-solid:laugh"}]' ></br-slider> ```
+          * @example ```js const slider = document.querySelector('br-slider'); slider.steps = [   { value: 1, label: 'Péssimo', icon: 'fa-solid:frown' },   { value: 5, label: 'Excelente', icon: 'fa-solid:laugh' }, ]; ```
          */
         "steps"?: SliderStep[] | string;
         /**
@@ -14270,7 +14848,7 @@ declare namespace LocalJSX {
          */
         "thumbEndIcon"?: string;
         /**
-          * Nome do ícone a ser exibido no interior da alça de controle (thumb). No modo `range`, aplica-se a ambas as alças caso `thumbStartIcon` ou `thumbEndIcon` não sejam especificados. Exemplo: 'fa-solid:arrows-left-right', 'fa-solid:circle'.
+          * Nome do ícone a ser exibido no interior da alça de controle (thumb). No modo `range`, aplica-se a ambas as alças caso `thumbStartIcon` ou `thumbEndIcon` não sejam especificados. Exemplo: 'fa-solid:arrows-alt-h', 'fa-solid:circle'.
          */
         "thumbIcon"?: string;
         /**
@@ -14607,7 +15185,7 @@ declare namespace LocalJSX {
          */
         "counter"?: string;
         /**
-          * Ícone da aba como identificador Iconify (ex.: `fa6-solid:bell`), renderizado em SVG pelo `br-icon`. Para ícones por classe CSS (ex.: Font Awesome), use o slot `icon-{id}` do `br-tab`, a forma preferida: `<i slot="icon-avisos" class="fas fa-bell" aria-hidden="true"></i>`. O slot tem precedência sobre esta prop. Uso descontinuado: classes CSS nesta prop (ex.: `fas fa-bell`) não são exibidas no Shadow DOM, geram aviso e devem migrar para o slot `icon-{id}`. Identificadores Iconify continuam suportados.
+          * Ícone da aba como identificador Font Awesome 5 Free presente no cache local (ex.: `fa-solid:bell`), renderizado pelo `br-icon`. Para ícones por classe CSS (ex.: Font Awesome), use o slot `icon-{id}` do `br-tab`, a forma preferida: `<i slot="icon-avisos" class="fas fa-bell" aria-hidden="true"></i>`. O slot tem precedência sobre esta prop. Uso descontinuado: classes CSS nesta prop (ex.: `fas fa-bell`) não são exibidas no Shadow DOM, geram aviso e devem migrar para o slot `icon-{id}`. Nomes fora do cache local não são carregados remotamente.
          */
         "icon"?: string;
         /**
@@ -14647,231 +15225,643 @@ declare namespace LocalJSX {
         "tabItemTitle"?: string;
     }
     /**
-     * O `br-table` estrutura e exibe conjuntos de dados organizados em linhas e colunas.
-     * Estruture 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`.
-     * ```html
-     * <br-table>
-     *   <br-table-header slot="header">
-     *     <br-table-row>
-     *       <br-table-header-cell>Nome</br-table-header-cell>
-     *       <br-table-header-cell>Cargo</br-table-header-cell>
-     *     </br-table-row>
-     *   </br-table-header>
-     *   <br-table-body slot="body">
-     *     <br-table-row>
-     *       <br-table-cell>Maria Silva</br-table-cell>
-     *       <br-table-cell>Analista</br-table-cell>
-     *     </br-table-row>
-     *   </br-table-body>
-     * </br-table>
-     * ```
-     * ### Quando usar
-     * - Dados bidimensionais com cabeçalhos de coluna e necessidades de ordenação ou comparação.
-     * ### Quando evitar
-     * - Listas simples de itens lineares: use `br-list`.
-     * - Agrupamento de informações de um único registro: use `br-card`.
-     * Consulte as [diretrizes de design do GovBR](https://www.gov.br/ds/components/table?tab=designer).
-     * @category Dados, Conteúdo
-     * @status stable
-     * @Slot header: Área para inclusão do subcomponente br-table-header
-     * @Slot body: Área para inclusão do subcomponente br-table-body
+     * ## Design System
+     * Para 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).
+     * Apresenta e permite interagir com dados tabulares; não deve ser usada para
+     * organizar layout ou conteúdo que não seja tabular. Recebe o cabeçalho e o corpo
+     * pelos slots `header` e `body`, compostos por `br-table-header` e
+     * `br-table-header-cell`, e por `br-table-body`, `br-table-row` e `br-table-cell`.
+     * Orquestra a grade, a acessibilidade, a ordenação, a seleção e a expansão das
+     * linhas. A barra de ações é gerenciada pela tabela; `br-table-footer` é
+     * renderizado quando a paginação está habilitada. As propriedades de célula
+     * seguem, quando aplicável, a precedência: célula, linha, coluna, tabela e valor
+     * padrão. Cabeçalhos multinível usam várias linhas em `br-table-header` com
+     * `colSpan`/`rowSpan`. Linhas contíguas com `rowGroup` formam unidades de ordenação,
+     * paginação e virtualização; a seleção permanece individual. Células com `rowSpan`
+     * não atravessam os limites do grupo. Prefira tabelas simples quando possível.
+     * @cssprop --br-table-loading-opacity - Opacidade do conteúdo durante o carregamento. Padrão: 0.5.
+     * @fires brTableActionClick - Quando uma ação pública é acionada.
+     * @fires brTableSelectionChange - Quando o conjunto selecionado muda.
+     * @fires brTableRowExpansionChange - Quando uma linha expande ou recolhe.
+     * @fires brTableSortRequest - Antes de aplicar uma solicitação de ordenação.
+     * @fires brTableSortChange - Quando os critérios de ordenação mudam.
+     * @fires brTablePageChange - Quando o consumidor solicita outra página pela paginação do rodapé.
+     * @fires brTablePageSizeChange - Quando o consumidor solicita outra quantidade de itens por página.
+     * @fires brTableSearch - Quando a busca é enviada ou fechada.
      */
     interface BrTable {
         /**
-          * Ativa divisores verticais. Quando informada, tem precedência sobre `hasColumnDivider`.
+          * Limite padrão de ações exibidas em cada célula.
+          * @default 4
+         */
+        "cellActionsLimit"?: number;
+        /**
+          * Habilita divisores entre colunas.
+          * @remarks Quando informado, tem precedência sobre `hasColumnDivider`, inclusive quando `false`. Na ausência de ambos, os divisores ficam desabilitados.
          */
         "columnDivider"?: boolean;
         /**
-          * Largura global aplicada a todas as colunas.
-          * @remarks Valores aceitos: - fill - content - ${number}px - ${number}fr  Observação: - `columnWidth` não define o comportamento de `overflow`, mas pode interferir na sua percepção ao alterar o espaço disponível da coluna. - `content` (`max-content`) tende a expandir a coluna e reduzir casos visíveis de truncagem. - `fill` (`1fr`) tende a evidenciar truncagem quando o espaço horizontal é insuficiente.
+          * Largura padrão utilizada pelas colunas sem configuração própria.
           * @default fill
-          * @example ```html <br-table column-width="160px"></br-table> ```
          */
         "columnWidth"?: ColumnWidth;
         /**
-          * Define a densidade visual do componente.  - `small`: Alta densidade (componente menor, mais compacto e com menos espaçamento). - `medium`: Densidade intermediária, padrão recomendado para a maioria dos casos. - `large`: Baixa densidade (componente maior, mais espaçamento e altura).  Valores inválidos usam `medium`. Quando omitida, a densidade média é aplicada ao token.
+          * Limite usado para decidir quando agrupar ações contextuais em um menu. Quando o número de ações excede esse valor, as ações são agrupadas no dropdown (atualmente todas são movidas para o menu colapsado).
+          * @default 4
+         */
+        "contextualActionsLimit"?: number;
+        /**
+          * Página atual exibida pela paginação (1-indexada).
+          * @remarks Atualizada internamente quando `TableDataStore` já cobre a página solicitada. Utilize como valor inicial ou para navegar programaticamente para outra página.
+          * @default 1
+         */
+        "currentPage"?: number;
+        /**
+          * Densidade visual aplicada aos espaçamentos da tabela.
+          * @remarks Quando omitida, a propriedade permanece `undefined` e a densidade visual média é aplicada aos tokens da tabela.
+          * @default undefined
          */
         "density"?: TableDensity;
         /**
-          * Define o estilo visual dos divisores.
-          * @remarks Valores aceitos: - solid - dashed
+          * Estilo aplicado aos divisores habilitados.
           * @default solid
          */
         "dividerStyle"?: TableDividerStyle;
         /**
-          * Ativa divisores verticais entre colunas.
+          * Habilita divisores entre colunas quando `columnDivider` não é informado.
+          * @deprecated Use `columnDivider` instead.
           * @default false
-          * @deprecated Use `columnDivider`.
          */
         "hasColumnDivider"?: boolean;
         /**
-          * Ativa divisores horizontais entre linhas.
+          * Habilita a paginação da tabela, renderizando `br-table-footer` internamente.
+          * @remarks A paginação define o subconjunto lógico disponível para a lista virtual. `pageSize` conta linhas independentes ou grupos completos, e `visibleRows` controla quantas delas cabem simultaneamente na viewport. Quando os dados completos ainda não estão disponíveis localmente (paginação por API), informe `totalItems` e forneça o subconjunto correspondente após `brTablePageChange`.
+          * @default false
+         */
+        "hasPagination"?: boolean;
+        /**
+          * Habilita divisores entre linhas quando `rowDivider` não é informado.
+          * @deprecated Use `rowDivider` instead.
           * @default false
-          * @deprecated Use `rowDivider`.
          */
         "hasRowDivider"?: boolean;
         /**
-          * Define o alinhamento horizontal do conteúdo das células.
-          * @remarks Valores aceitos: - start - center - end
+          * Habilita a coluna de expansão de linhas.
+          * @default false
+         */
+        "hasRowExpansion"?: boolean;
+        /**
+          * Habilita o realce visual das linhas ao passar o ponteiro.
+          * @default false
+         */
+        "hasRowHover"?: boolean;
+        /**
+          * Habilita a coluna de seleção de linhas.
+          * @default false
+         */
+        "hasRowSelection"?: boolean;
+        /**
+          * Disponibiliza a interface de busca, sem filtrar ou destacar o conteúdo. A aplicação recebe `brTableSearch` e atualiza os dados local ou remotamente.
+          * @default false
+         */
+        "hasSearch"?: boolean;
+        /**
+          * Título apresentado na barra principal.
+          * @default null
+         */
+        "heading"?: string;
+        /**
+          * Limite usado para decidir quando agrupar ações globais em um menu. Quando o número de ações excede esse valor, as ações são agrupadas no dropdown (atualmente todas são movidas para o menu colapsado).
+          * @default 4
+         */
+        "headingActionsLimit"?: number;
+        /**
+          * Quantidade de itens lógicos usada somente para calcular a altura da viewport. Cada grupo contíguo conta como um item; a altura inclui todas as linhas físicas que compõem os grupos reservados. Não altera paginação, rolagem ou virtualização. Quando omitida, acompanha `visibleRows`.
+          * @default visibleRows
+         */
+        "heightRows"?: number;
+        /**
+          * Alinhamento horizontal padrão da tabela.
           * @default start
          */
         "horizontalAlignment"?: TableAlignment;
         /**
-          * Indica que as linhas estão sendo atualizadas pelo consumidor. O componente mantém o conteúdo anterior, aplica `aria-busy="true"` e exibe o slot `loading` sobre os dados; transporte, erro e substituição das linhas ficam sob responsabilidade da aplicação. A prop pode ser alterada diretamente ou pelos métodos `startLoading()` e `stopLoading()`.
+          * Indica que as linhas estão sendo atualizadas pelo consumidor.
+          * @remarks Mantém os dados anteriores, reduz sua opacidade e exibe o slot `loading` em um painel central com scrim sobre toda a tabela, incluindo barra de ações e paginação. O scrim fica limitado ao componente. Reflete o atributo `loading` e pode ser alterada diretamente ou pelos métodos `startLoading()` e `stopLoading()`. Não bloqueia o teclado nem gerencia requisições, erros ou substituição dos dados.
           * @default false
          */
         "loading"?: boolean;
         /**
-          * Define o comportamento de overflow para as células.
-          * @remarks Valores aceitos: - truncate - wrap  Observação: - O overflow é independente de `columnWidth`. - Com `columnWidth="content"`, a coluna tende a crescer com o conteúdo (`max-content`), o que pode reduzir casos visíveis de truncagem. - Com `columnWidth="fill"`, a coluna ocupa o espaço disponível (`1fr`), então a truncagem tende a ficar mais evidente quando não há espaço suficiente.
+          * Texto do tooltip do botão de ações agrupadas da barra contextual. Quando vazio ou composto apenas por espaços, usa "Mais ações". Não altera o nome acessível do botão nem os rótulos do menu.
+          * @default 'Mais ações'
+         */
+        "moreActionsContextualLabel"?: string;
+        /**
+          * Texto do tooltip do botão de ações agrupadas na barra de título. Quando vazio ou composto apenas por espaços, usa "Mais ações". Não altera o nome acessível do botão nem os rótulos do menu.
+          * @default 'Mais ações'
+         */
+        "moreActionsHeadingLabel"?: string;
+        /**
+          * Texto completo do tooltip dos botões de ações agrupadas nas células. Quando informado, prevalece sobre `moreActionsLabel` de cada célula. Quando omitido, a célula usa seu valor local ou "Mais ações". Valores vazios ou compostos apenas por espaços usam "Mais ações". Aceita texto simples por atributo ou propriedade. Reflete o valor no atributo `more-actions-label` para sincronizar as células.
+          * @default undefined
+         */
+        "moreActionsLabel"?: string;
+        /**
+          * Reemite ações globais, contextuais e de linha para o consumidor.
+          * @remarks O `detail` utiliza `TableActionClickDetail`.
+         */
+        "onBrTableActionClick"?: (event: BrTableCustomEvent<TableActionClickDetail>) => void;
+        /**
+          * Emitido quando o consumidor solicita outra página pela paginação do rodapé.
+         */
+        "onBrTablePageChange"?: (event: BrTableCustomEvent<TablePageChangeDetail>) => void;
+        /**
+          * Emitido quando o consumidor solicita outra quantidade de itens por página; atualize `visibleRows` ao tratar.
+         */
+        "onBrTablePageSizeChange"?: (event: BrTableCustomEvent<TablePageSizeChangeDetail>) => void;
+        /**
+          * Emitido quando uma linha é expandida ou recolhida.
+          * @remarks O `detail` utiliza `TableRowExpansionChangeDetail`.
+         */
+        "onBrTableRowExpansionChange"?: (event: BrTableCustomEvent<TableRowExpansionChangeDetail>) => void;
+        /**
+          * Evento customizado originado em `br-table-bar` e propagado pela tabela, sem reemissão. Envia `{ term }` por Enter ou botão e `{ term: '' }` ao fechar. Digitação, inicialização e alterações programáticas não emitem o evento. Propaga, atravessa Shadow DOM e é cancelável.
+         */
+        "onBrTableSearch"?: (event: BrTableCustomEvent<TableSearchDetail>) => void;
+        /**
+          * Emitido quando o conjunto de linhas selecionadas muda.
+          * @remarks O `detail` utiliza `TableSelectionChangeDetail`.
+         */
+        "onBrTableSelectionChange"?: (event: BrTableCustomEvent<TableSelectionChangeDetail>) => void;
+        /**
+          * Emitido sempre que o conjunto de critérios de ordenação muda.
+         */
+        "onBrTableSortChange"?: (event: BrTableCustomEvent<TableSortChangeDetail>) => void;
+        /**
+          * Emitido antes de aplicar uma solicitação de ordenação; `preventDefault()` cancela a mudança local.
+         */
+        "onBrTableSortRequest"?: (event: BrTableCustomEvent<TableSortRequestDetail>) => void;
+        /**
+          * Estratégia padrão para conteúdos que excedem a célula.
           * @default wrap
          */
         "overflow"?: TableOverflow;
         /**
-          * Ativa divisores horizontais. Quando informada, tem precedência sobre `hasRowDivider`.
+          * Quantidade de itens pertencentes a cada página (linhas independentes ou grupos completos).
+          * @remarks Quando omitida, utiliza `visibleRows` como fallback para manter compatibilidade com a API anterior. Defina um valor maior que `visibleRows` para que paginação e virtualização operem simultaneamente.
+         */
+        "pageSize"?: number;
+        /**
+          * Opções disponíveis de itens por página no seletor da paginação.
+          * @default [10, 20, 30]
+         */
+        "pageSizeOptions"?: number[];
+        /**
+          * Habilita divisores entre linhas.
+          * @remarks Quando informado, tem precedência sobre `hasRowDivider`, inclusive quando `false`. Na ausência de ambos, os divisores ficam desabilitados.
          */
         "rowDivider"?: boolean;
+        /**
+          * Força a apresentação da barra contextual.
+          * @default false
+         */
+        "showContextualBar"?: boolean;
+        /**
+          * Define se a tabela aceita uma única coluna ordenada ou múltiplas colunas. No modo `multi`, a prioridade é sempre a ordem visual da esquerda para a direita.
+          * @default single
+         */
+        "sortMode"?: TableSortMode;
+        /**
+          * Define se a tabela ordena as linhas localmente ou deixa a aplicação aplicar a ordenação solicitada. Em `manual`, a tabela mantém os indicadores e emite `brTableSortChange`, mas não reordena as linhas; use `setData()` para fornecer os resultados customizados ou remotos. Valores não reconhecidos usam a estratégia local.
+          * @default local
+         */
+        "sortStrategy"?: TableSortStrategy;
         /**
           * Define o modo de resolução do tooltip nas células da tabela.
-          * @remarks Valores aceitos: - inherit - enabled - disabled
           * @default disabled (valor efetivo)
          */
         "tooltipMode"?: TableTooltipMode;
         /**
-          * Define o estado semântico do tooltip nas células da tabela.
-          * @remarks Valores aceitos: - info - warning - danger - success
+          * Estado visual padrão dos tooltips.
           * @default info
          */
         "tooltipState"?: TableTooltipState;
         /**
-          * Define o alinhamento vertical do conteúdo das células.
-          * @remarks Valores aceitos: - start - center - end
+          * Quantidade total de itens do conjunto de dados.
+          * @remarks Necessário apenas quando `TableDataStore` não contém o conjunto completo (paginação por API). Quando omitido, é derivado automaticamente da quantidade de linhas independentes e grupos já presentes na tabela.
+         */
+        "totalItems"?: number;
+        /**
+          * Alinhamento vertical padrão da tabela.
           * @default start
          */
         "verticalAlignment"?: TableAlignment;
+        /**
+          * Altura adicional estimada para conteúdo expandido ainda não medido.
+          * @default 240
+         */
+        "virtualExpandedContentHeight"?: number;
+        /**
+          * Quantidade de linhas de dados visíveis simultaneamente na viewport.
+          * @remarks Não limita o conjunto de dados nem realiza paginação. A altura da região de scroll é derivada desta quantidade e da densidade atual. Mesmo com `hasPagination` habilitado, esta propriedade continua definindo apenas a capacidade visual da viewport; `pageSize` define o tamanho lógico da página.
+          * @default 10
+         */
+        "visibleRows"?: number;
+    }
+    /**
+     * ## Design System
+     * Para 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).
+     * Representa uma ação global, contextual ou associada a uma linha da tabela.
+     * O contexto é inferido pelo slot e pela posição do componente na árvore.
+     * Para executar funções a partir das ações, ouça o evento `brTableActionClick`:
+     * ```html
+     * <!-- 1. Ouvindo diretamente na ação -->
+     * <br-table-action id="btn-filtro" label="Filtros" icon-name="fa-solid:filter"></br-table-action>
+     * <script>
+     *   document.getElementById('btn-filtro').addEventListener('brTableActionClick', () => {
+     *     executarFiltros();
+     *   });
+     * </script>
+     * <!-- 2. Ouvindo na tabela (recomendado para ações diretas e colapsadas em menu) -->
+     * <script>
+     *   table.addEventListener('brTableActionClick', (event) => {
+     *     const { type, label, rowIndex } = event.detail;
+     *     if (type === 'row') executarAcaoLinha(label, rowIndex);
+     *     else if (type === 'global') executarAcaoGlobal(label);
+     *   });
+     * </script>
+     * ```
+     * @fires brTableActionClick - Quando o usuário aciona o botão.
+     */
+    interface BrTableAction {
+        /**
+          * Rótulo acessível. Quando omitido, utiliza `label`.
+          * @default null
+         */
+        "ariaLabel"?: string | null;
+        /**
+          * Densidade visual aplicada ao botão interno da ação.
+         */
+        "density"?: TableDensity;
+        /**
+          * Nome do ícone exibido pelo botão.
+          * @default null
+         */
+        "iconName"?: string | null;
+        /**
+          * Texto visível e identificação semântica da ação.
+          * @default null
+         */
+        "label"?: string | null;
+        /**
+          * Emitido quando o usuário aciona o botão.
+          * @remarks O `detail` utiliza `TableActionClickDetail`
+         */
+        "onBrTableActionClick"?: (event: BrTableActionCustomEvent<TableActionClickDetail>) => void;
     }
     /**
-     * Corpo de dados (`<tbody>`) da tabela. Use no slot `body` do `br-table`.
-     * Agrupa as linhas `br-table-row` contendo as células de dados `br-table-cell`.
+     * ## Design System
+     * Para 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).
+     * Exibe o título, as ações globais e as ações contextuais da tabela.
+     * Ações excedentes são agrupadas automaticamente em um menu.
+     * Compõe `br-table`, que configura a barra automaticamente. Também pode ser usada
+     * diretamente para compor uma barra de ações. Quando `hasSearch` está ativo,
+     * solicita a busca à aplicação, sem filtrar ou destacar os dados.
+     */
+    interface BrTableBar {
+        /**
+          * Limite usado para decidir quando agrupar ações contextuais em um menu. Quando o número de ações excede esse valor, as ações são agrupadas no dropdown (atualmente todas são movidas para o menu colapsado).
+          * @default 4
+         */
+        "contextualActionsLimit"?: number;
+        /**
+          * Densidade visual aplicada aos controles internos da barra.
+         */
+        "density"?: TableDensity;
+        /**
+          * Indica se o slot de ações contextuais possui conteúdo.
+          * @default false
+         */
+        "hasContextualActionsContent"?: boolean;
+        /**
+          * Indica se o slot de ações globais possui conteúdo.
+          * @default false
+         */
+        "hasGlobalActionsContent"?: boolean;
+        /**
+          * Disponibiliza a interface de busca controlada pela aplicação.
+          * @default false
+         */
+        "hasSearch"?: boolean;
+        /**
+          * Título apresentado na barra principal.
+          * @default ''
+         */
+        "heading"?: string;
+        /**
+          * Limite usado para decidir quando agrupar ações em um menu. Quando o número de ações excede esse valor, as ações são agrupadas no dropdown (atualmente todas são movidas para o menu colapsado).
+          * @default 4
+         */
+        "headingActionsLimit"?: number;
+        /**
+          * Evento customizado emitido pela barra ao enviar a busca por Enter ou pelo botão, com `{ term }`, e ao fechar, com `{ term: '' }`. Propaga até `br-table` e atravessa Shadow DOM; é cancelável. Digitação, inicialização e alterações programáticas não emitem o evento.
+         */
+        "onBrTableSearch"?: (event: BrTableBarCustomEvent<TableSearchDetail>) => void;
+        /**
+          * Número de linhas atualmente selecionadas.
+          * @default 0
+         */
+        "selectedRowsCount"?: number;
+        /**
+          * Força a apresentação da barra contextual mesmo sem seleção.
+          * @default false
+         */
+        "showContextualBar"?: boolean;
+    }
+    /**
+     * ## Design System
+     * Para 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).
+     * Agrupa semanticamente as linhas que compõem o corpo de `br-table`.
+     * É uma peça declarativa do slot `body`; recebe `br-table-row` e entrega ao
+     * orquestrador a seleção, ordenação e materialização virtual. Os contêineres
+     * visuais dos grupos são internos, montados pela tabela e não devem ser
+     * instanciados pelo consumidor. Use o componente na composição de `br-table`.
      */
     interface BrTableBody {
     }
     /**
-     * Célula de dados (`<td>`) da tabela. Use dentro de um `br-table-row` no corpo da tabela.
-     * Coloque o conteúdo do registro no slot padrão.
+     * ## Design System
+     * Para 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).
+     * Representa uma célula de dados, com suporte a alinhamento, overflow,
+     * tooltip e agrupamento automático de ações excedentes. Compõe `br-table-row`
+     * dentro do corpo de `br-table`, que coordena posição, interação e herança.
+     * Use `rowSpan` dentro de um grupo contíguo de linhas e `rowHeader` para seu
+     * rótulo compartilhado; evite uso avulso fora da composição da tabela.
+     * @fires brAlignmentChange - Quando um alinhamento específico muda.
+     * @fires brOverflowChange - Quando a estratégia de overflow muda.
      */
     interface BrTableCell {
         /**
-          * Define o alinhamento horizontal do conteúdo dentro da célula.
+          * Densidade visual aplicada ao trigger de ações agrupadas.
+         */
+        "actionDensity"?: TableDensity;
+        /**
+          * Limite local de ações exibidas diretamente.
+          * @default null
+         */
+        "cellActionsLimit"?: number;
+        /**
+          * Quantidade de colunas ocupadas. Inteiro entre 1 e 1000; valores inválidos usam 1.
+          * @default 1
+         */
+        "colSpan"?: number;
+        /**
+          * Alinhamento horizontal específico da célula. Quando omitido, herda da linha, coluna ou tabela, nessa ordem.
+          * @default undefined
          */
         "horizontalAlignment"?: TableAlignment;
         /**
-          * Evento customizado emitido quando o alinhamento é alterado, permitindo que a célula reaja dinamicamente a mudanças nos tokens de alinhamento.
+          * Texto completo do tooltip do botão de ações agrupadas desta célula. A propriedade `moreActionsLabel` de `br-table` prevalece quando informada. Valores vazios ou compostos apenas por espaços usam "Mais ações". Não altera o nome acessível do botão nem os rótulos das ações. Aceita texto simples por atributo ou propriedade, sem reflexão.
+          * @default 'Mais ações'
+         */
+        "moreActionsLabel"?: string;
+        /**
+          * Emitido quando um alinhamento específico da célula muda.
          */
         "onBrAlignmentChange"?: (event: BrTableCellCustomEvent<void>) => void;
         /**
-          * Evento customizado emitido quando a configuração de overflow é alterada, permitindo que a célula reaja dinamicamente a mudanças no token de overflow.
+          * Emitido quando a estratégia de overflow da célula muda.
          */
         "onBrOverflowChange"?: (event: BrTableCellCustomEvent<void>) => void;
         /**
-          * 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.
+          * Estratégia de overflow específica da célula. Quando omitida, herda da linha, coluna ou tabela, nessa ordem.
+          * @default undefined
          */
         "overflow"?: TableOverflow;
         /**
-          * Define o modo de resolução do tooltip nesta célula.
+          * Identifica um cabeçalho de linha, inclusive rótulos compartilhados por um grupo.
+          * @default false
+         */
+        "rowHeader"?: boolean;
+        /**
+          * Quantidade de linhas ocupadas no cabeçalho ou grupo. Limitada às linhas disponíveis; aceita inteiros de 1 a 1000 e valores inválidos usam 1.
+          * @default 1
+         */
+        "rowSpan"?: number;
+        /**
+          * Valor utilizado pela ordenação da coluna. Quando omitido, a tabela usa o texto renderizado da célula.
+          * @default null
+         */
+        "sortValue"?: string | number;
+        /**
+          * Modo de exibição do tooltip da célula. Quando omitido, herda da linha, coluna ou tabela, nessa ordem. No modo `enabled`, exibe o conteúdo somente quando estiver truncado na largura disponível.
+          * @default undefined
          */
         "tooltipMode"?: TableTooltipMode;
         /**
-          * Define o estado semântico do tooltip nesta célula.
+          * Estado visual do tooltip da célula. Quando omitido, herda da linha, coluna ou tabela, nessa ordem.
+          * @default undefined
          */
         "tooltipState"?: TableTooltipState;
         /**
-          * Define o alinhamento vertical do conteúdo dentro da célula.
+          * Alinhamento vertical específico da célula. Quando omitido, herda da linha, coluna ou tabela, nessa ordem.
+          * @default undefined
          */
         "verticalAlignment"?: TableAlignment;
     }
     /**
-     * Cabeçalho da tabela (`br-table`). Use no slot `header`.
-     * Agrupa as linhas `br-table-row` com as células de cabeçalho `br-table-header-cell`.
+     * 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).
+     * Renderiza a paginação da tabela quando `hasPagination` está habilitado em `br-table`.
+     * Orquestrado internamente pela tabela; não deve ser inserido diretamente pelo consumidor.
+     */
+    interface BrTableFooter {
+        /**
+          * Página atual exibida pela paginação (1-indexada).
+          * @default 1
+         */
+        "currentPage"?: number;
+        /**
+          * Densidade visual herdada da tabela.
+          * @default 'medium'
+         */
+        "density"?: TableFooterDensity;
+        /**
+          * Indica que a área de dados da tabela possui rolagem.
+          * @default false
+         */
+        "hasScroll"?: boolean;
+        /**
+          * Quantidade de itens exibidos por página.
+          * @default 10
+         */
+        "pageSize"?: number;
+        /**
+          * Opções disponíveis de itens por página.
+          * @default [10, 20, 30]
+         */
+        "pageSizeOptions"?: number[];
+        /**
+          * Quantidade total de itens do conjunto de dados.
+          * @default 0
+         */
+        "totalItems"?: number;
+    }
+    /**
+     * ## Design System
+     * Para 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).
+     * Agrupa as linhas de cabeçalho de `br-table`, que as posiciona em uma grade.
+     * Use uma linha para tabelas simples e múltiplas linhas com `colSpan`/`rowSpan`
+     * em `br-table-header-cell` para hierarquias de colunas. É uma peça declarativa
+     * do slot `header`, usada com o orquestrador; não realiza ordenação avulsa.
      */
     interface BrTableHeader {
     }
     /**
-     * Célula de cabeçalho (`<th>`) da tabela. Use dentro de um `br-table-row` no cabeçalho.
-     * Coloque o título da coluna no slot padrão. Para habilitar ordenação, ative `sortable`.
+     * ## Design System
+     * Para 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).
+     * Define o conteúdo e as propriedades herdáveis de uma coluna de `br-table`.
+     * Compõe as linhas de `br-table-header` no slot `header`; não deve ser usada
+     * avulsa. `colSpan` e `rowSpan` representam grupos e níveis do cabeçalho.
+     * Somente folhas que ocupam uma coluna podem ordenar os dados.
+     * Também exibe tooltip quando o conteúdo truncado requer informação adicional.
+     * @fires brColumnWidthChange - Quando a largura declarada muda.
+     * @fires brAlignmentChange - Quando um alinhamento da coluna muda.
+     * @fires brOverflowChange - Quando a estratégia de overflow muda.
      */
     interface BrTableHeaderCell {
         /**
-          * Define a largura da coluna. Aceita `fill`, `content`, larguras positivas em `px` ou frações positivas em `fr`. Valores inválidos usam o fallback da tabela.
-          * @example ```html <br-table-header-cell column-width="2fr">Descrição</br-table-header-cell> ```
+          * Quantidade de colunas ocupadas. Inteiro entre 1 e 1000; valores inválidos usam 1.
+          * @default 1
+         */
+        "colSpan"?: number;
+        /**
+          * Largura semântica ou CSS aplicada à coluna. Quando omitida, herda da tabela.
+          * @default undefined
          */
         "columnWidth"?: ColumnWidth;
         /**
-          * 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.
+          * Alinhamento horizontal herdado pelas células da coluna. Quando omitido, o cabeçalho herda da linha ou tabela, nessa ordem.
+          * @default undefined
          */
         "horizontalAlignment"?: TableAlignment;
         /**
-          * Evento customizado emitido quando o alinhamento é alterado, permitindo que a célula de cabeçalho reaja dinamicamente a mudanças nos tokens de alinhamento.
+          * Emitido quando um alinhamento da coluna muda.
          */
         "onBrAlignmentChange"?: (event: BrTableHeaderCellCustomEvent<void>) => void;
         /**
-          * Evento customizado emitido quando a largura da coluna é alterada, permitindo que as células reajam dinamicamente a mudanças no layout.
+          * Emitido quando a largura declarada para a coluna muda.
          */
         "onBrColumnWidthChange"?: (event: BrTableHeaderCellCustomEvent<void>) => void;
         /**
-          * 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.
+          * Emitido quando a estratégia de overflow muda.
          */
         "onBrOverflowChange"?: (event: BrTableHeaderCellCustomEvent<void>) => void;
         /**
-          * 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.
+          * Estratégia de overflow herdada pelas células da coluna. Quando omitida, o cabeçalho herda da linha ou tabela, nessa ordem.
+          * @default undefined
          */
         "overflow"?: TableOverflow;
         /**
-          * Define o modo de resolução do tooltip nesta coluna/célula de cabeçalho.
+          * Quantidade de linhas ocupadas no cabeçalho ou grupo. Limitada às linhas disponíveis; aceita inteiros de 1 a 1000 e valores inválidos usam 1.
+          * @default 1
+         */
+        "rowSpan"?: number;
+        /**
+          * Estado atual de ordenação controlado por `br-table`.
+         */
+        "sortDirection"?: TableSortDirection;
+        /**
+          * Habilita a ordenação desta coluna.
+          * @default false
+         */
+        "sortable"?: boolean;
+        /**
+          * Modo de exibição herdado pelos tooltips da coluna. Quando omitido ou definido como inherit, o cabeçalho herda da linha ou tabela, nessa ordem.
+          * @default undefined
          */
         "tooltipMode"?: TableTooltipMode;
         /**
-          * Define o estado semântico do tooltip nesta coluna/célula de cabeçalho.
+          * Estado visual herdado pelos tooltips da coluna. Quando omitido, o cabeçalho herda da linha ou tabela, nessa ordem.
+          * @default undefined
          */
         "tooltipState"?: TableTooltipState;
         /**
-          * 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.
+          * Alinhamento vertical herdado pelas células da coluna. Quando omitido, o cabeçalho herda da linha ou tabela, nessa ordem.
+          * @default undefined
          */
         "verticalAlignment"?: TableAlignment;
     }
     /**
-     * Linha horizontal (`<tr>`) da tabela. Use dentro de `br-table-header` ou `br-table-body`.
-     * Use `selected` para indicar que a linha está selecionada.
+     * ## Design System
+     * Para 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).
+     * Representa uma linha de dados e sua área opcional de conteúdo expandido.
+     * É uma peça declarativa de `br-table-body` ou `br-table-header`, coordenada por
+     * `br-table`. Recebe células de dados ou cabeçalho conforme o pai. `rowGroup`
+     * identifica linhas contíguas que devem permanecer juntas; use-o apenas no corpo.
+     * Em grupos, os detalhes expandidos são apresentados após as linhas do grupo.
+     * @fires brAlignmentChange - Quando um alinhamento herdável muda.
+     * @fires brOverflowChange - Quando a estratégia de overflow muda.
      */
     interface BrTableRow {
         /**
-          * 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.
+          * Indica se o conteúdo adicional da linha está visível.
+          * @default false
+         */
+        "expanded"?: boolean;
+        /**
+          * Alinhamento horizontal herdado pelas células da linha.
+          * @default undefined
          */
         "horizontalAlignment"?: TableAlignment;
         /**
-          * Evento customizado emitido quando o alinhamento é alterado, permitindo que as células reajam dinamicamente a mudanças nos tokens de alinhamento.
+          * Emitido quando uma propriedade de alinhamento da linha muda.
          */
         "onBrAlignmentChange"?: (event: BrTableRowCustomEvent<void>) => void;
         /**
-          * Evento customizado emitido quando a configuração de overflow é alterada, permitindo que as células reajam dinamicamente a mudanças no token de overflow.
+          * Emitido quando a estratégia de overflow da linha muda.
          */
         "onBrOverflowChange"?: (event: BrTableRowCustomEvent<void>) => void;
         /**
-          * 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.
+          * Estratégia de overflow herdada pelas células da linha.
+          * @default undefined
          */
         "overflow"?: TableOverflow;
         /**
-          * Define o modo de resolução do tooltip nas células desta linha.
+          * Controla se a expansão é habilitada, desabilitada ou herdada da tabela.
+          * @default 'inherit'
+         */
+        "rowExpansion"?: TableRowExpansion;
+        /**
+          * Identifica um grupo contíguo de linhas com chave exclusiva, preservado como unidade na ordenação, paginação e virtualização. Vazio ou omitido mantém a linha independente. A seleção continua sendo individual por linha.
+          * @default undefined
+         */
+        "rowGroup"?: string;
+        /**
+          * Indica se a linha está selecionada.
+          * @default false
+         */
+        "selected"?: boolean;
+        /**
+          * Modo de exibição herdado pelos tooltips da linha.
+          * @default undefined
          */
         "tooltipMode"?: TableTooltipMode;
         /**
-          * Define o estado semântico do tooltip nas células desta linha.
+          * Estado visual herdado pelos tooltips da linha.
+          * @default undefined
          */
         "tooltipState"?: TableTooltipState;
         /**
-          * 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.
+          * Alinhamento vertical herdado pelas células da linha.
+          * @default undefined
          */
         "verticalAlignment"?: TableAlignment;
+        /**
+          * Altura visível da área expandida desta linha, em pixels.
+          * @remarks Quando omitida, herda `virtualExpandedContentHeight` de `br-table`.
+          * @default null
+         */
+        "virtualExpandedContentHeight"?: number | null;
     }
     /**
      * O `br-tag` categoriza, rotula ou destaca informações curtas e metadados.
@@ -16393,34 +17383,95 @@ declare namespace LocalJSX {
         "columnDivider": boolean;
         "hasRowDivider": boolean;
         "rowDivider": boolean;
+        "hasRowHover": boolean;
+        "loading": boolean;
+        "heading": string;
+        "showContextualBar": boolean;
+        "headingActionsLimit": number;
+        "contextualActionsLimit": number;
+        "moreActionsHeadingLabel": string;
+        "moreActionsContextualLabel": string;
+        "moreActionsLabel": string;
+        "cellActionsLimit": number;
+        "hasRowSelection": boolean;
+        "hasRowExpansion": boolean;
+        "hasSearch": boolean;
+        "hasPagination": boolean;
+        "currentPage": number;
+        "pageSize": number;
+        "totalItems": number;
+        "sortMode": TableSortMode;
+        "sortStrategy": TableSortStrategy;
+        "visibleRows": number;
+        "heightRows": number;
+        "virtualExpandedContentHeight": number;
         "horizontalAlignment": TableAlignment;
         "verticalAlignment": TableAlignment;
         "overflow": TableOverflow;
         "tooltipState": TableTooltipState;
         "tooltipMode": TableTooltipMode;
-        "loading": boolean;
+    }
+    interface BrTableActionAttributes {
+        "label": string | null;
+        "iconName": string | null;
+        "ariaLabel": string | null;
+        "density": TableDensity;
+    }
+    interface BrTableBarAttributes {
+        "heading": string;
+        "headingActionsLimit": number;
+        "contextualActionsLimit": number;
+        "showContextualBar": boolean;
+        "selectedRowsCount": number;
+        "hasGlobalActionsContent": boolean;
+        "hasContextualActionsContent": boolean;
+        "hasSearch": boolean;
+        "density": TableDensity;
     }
     interface BrTableCellAttributes {
+        "colSpan": number;
+        "rowSpan": number;
+        "rowHeader": boolean;
         "horizontalAlignment": TableAlignment;
         "verticalAlignment": TableAlignment;
         "overflow": TableOverflow;
+        "cellActionsLimit": number;
+        "moreActionsLabel": string;
+        "sortValue": string;
         "tooltipState": TableTooltipState;
         "tooltipMode": TableTooltipMode;
+        "actionDensity": TableDensity;
+    }
+    interface BrTableFooterAttributes {
+        "currentPage": number;
+        "pageSize": number;
+        "totalItems": number;
+        "density": TableFooterDensity;
+        "hasScroll": boolean;
     }
     interface BrTableHeaderCellAttributes {
+        "colSpan": number;
+        "rowSpan": number;
         "columnWidth": ColumnWidth;
         "horizontalAlignment": TableAlignment;
         "verticalAlignment": TableAlignment;
         "overflow": TableOverflow;
         "tooltipState": TableTooltipState;
         "tooltipMode": TableTooltipMode;
+        "sortable": boolean;
+        "sortDirection": TableSortDirection;
     }
     interface BrTableRowAttributes {
+        "rowGroup": string;
         "horizontalAlignment": TableAlignment;
         "verticalAlignment": TableAlignment;
         "overflow": TableOverflow;
         "tooltipState": TableTooltipState;
         "tooltipMode": TableTooltipMode;
+        "selected": boolean;
+        "rowExpansion": TableRowExpansion;
+        "virtualExpandedContentHeight": number | null;
+        "expanded": boolean;
     }
     interface BrTagAttributes {
         "label": string;
@@ -16594,8 +17645,11 @@ declare namespace LocalJSX {
         "br-tab": Omit<BrTab, keyof BrTabAttributes> & { [K in keyof BrTab & keyof BrTabAttributes]?: BrTab[K] } & { [K in keyof BrTab & keyof BrTabAttributes as `attr:${K}`]?: BrTabAttributes[K] } & { [K in keyof BrTab & keyof BrTabAttributes as `prop:${K}`]?: BrTab[K] };
         "br-tab-item": Omit<BrTabItem, keyof BrTabItemAttributes> & { [K in keyof BrTabItem & keyof BrTabItemAttributes]?: BrTabItem[K] } & { [K in keyof BrTabItem & keyof BrTabItemAttributes as `attr:${K}`]?: BrTabItemAttributes[K] } & { [K in keyof BrTabItem & keyof BrTabItemAttributes as `prop:${K}`]?: BrTabItem[K] };
         "br-table": Omit<BrTable, keyof BrTableAttributes> & { [K in keyof BrTable & keyof BrTableAttributes]?: BrTable[K] } & { [K in keyof BrTable & keyof BrTableAttributes as `attr:${K}`]?: BrTableAttributes[K] } & { [K in keyof BrTable & keyof BrTableAttributes as `prop:${K}`]?: BrTable[K] };
+        "br-table-action": Omit<BrTableAction, keyof BrTableActionAttributes> & { [K in keyof BrTableAction & keyof BrTableActionAttributes]?: BrTableAction[K] } & { [K in keyof BrTableAction & keyof BrTableActionAttributes as `attr:${K}`]?: BrTableActionAttributes[K] } & { [K in keyof BrTableAction & keyof BrTableActionAttributes as `prop:${K}`]?: BrTableAction[K] };
+        "br-table-bar": Omit<BrTableBar, keyof BrTableBarAttributes> & { [K in keyof BrTableBar & keyof BrTableBarAttributes]?: BrTableBar[K] } & { [K in keyof BrTableBar & keyof BrTableBarAttributes as `attr:${K}`]?: BrTableBarAttributes[K] } & { [K in keyof BrTableBar & keyof BrTableBarAttributes as `prop:${K}`]?: BrTableBar[K] };
         "br-table-body": BrTableBody;
         "br-table-cell": Omit<BrTableCell, keyof BrTableCellAttributes> & { [K in keyof BrTableCell & keyof BrTableCellAttributes]?: BrTableCell[K] } & { [K in keyof BrTableCell & keyof BrTableCellAttributes as `attr:${K}`]?: BrTableCellAttributes[K] } & { [K in keyof BrTableCell & keyof BrTableCellAttributes as `prop:${K}`]?: BrTableCell[K] };
+        "br-table-footer": Omit<BrTableFooter, keyof BrTableFooterAttributes> & { [K in keyof BrTableFooter & keyof BrTableFooterAttributes]?: BrTableFooter[K] } & { [K in keyof BrTableFooter & keyof BrTableFooterAttributes as `attr:${K}`]?: BrTableFooterAttributes[K] } & { [K in keyof BrTableFooter & keyof BrTableFooterAttributes as `prop:${K}`]?: BrTableFooter[K] };
         "br-table-header": BrTableHeader;
         "br-table-header-cell": Omit<BrTableHeaderCell, keyof BrTableHeaderCellAttributes> & { [K in keyof BrTableHeaderCell & keyof BrTableHeaderCellAttributes]?: BrTableHeaderCell[K] } & { [K in keyof BrTableHeaderCell & keyof BrTableHeaderCellAttributes as `attr:${K}`]?: BrTableHeaderCellAttributes[K] } & { [K in keyof BrTableHeaderCell & keyof BrTableHeaderCellAttributes as `prop:${K}`]?: BrTableHeaderCell[K] };
         "br-table-row": Omit<BrTableRow, keyof BrTableRowAttributes> & { [K in keyof BrTableRow & keyof BrTableRowAttributes]?: BrTableRow[K] } & { [K in keyof BrTableRow & keyof BrTableRowAttributes as `attr:${K}`]?: BrTableRowAttributes[K] } & { [K in keyof BrTableRow & keyof BrTableRowAttributes as `prop:${K}`]?: BrTableRow[K] };
@@ -17213,8 +18267,8 @@ declare module "@stencil/core" {
              * O `br-magic-button` é o botão de ação flutuante (FAB) que destaca a ação primária ou mais frequente da tela.
              * Pode ser exibido apenas com ícone (formato circular) ou expandido com texto descritivo.
              * ```html
-             * <br-magic-button icon="fa6-solid:plus" aria-label="Novo item"></br-magic-button>
-             * <br-magic-button icon="fa6-solid:plus">Criar documento</br-magic-button>
+             * <br-magic-button icon="fa-solid:plus" aria-label="Novo item"></br-magic-button>
+             * <br-magic-button icon="fa-solid:plus">Criar documento</br-magic-button>
              * ```
              * ### Quando usar
              * - Ação principal e dominante da tela em dispositivos móveis ou interfaces focadas em uma tarefa única.
@@ -17640,59 +18694,127 @@ declare module "@stencil/core" {
              */
             "br-tab-item": LocalJSX.IntrinsicElements["br-tab-item"] & JSXBase.HTMLAttributes<HTMLBrTabItemElement>;
             /**
-             * O `br-table` estrutura e exibe conjuntos de dados organizados em linhas e colunas.
-             * Estruture 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`.
+             * ## Design System
+             * Para 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).
+             * Apresenta e permite interagir com dados tabulares; não deve ser usada para
+             * organizar layout ou conteúdo que não seja tabular. Recebe o cabeçalho e o corpo
+             * pelos slots `header` e `body`, compostos por `br-table-header` e
+             * `br-table-header-cell`, e por `br-table-body`, `br-table-row` e `br-table-cell`.
+             * Orquestra a grade, a acessibilidade, a ordenação, a seleção e a expansão das
+             * linhas. A barra de ações é gerenciada pela tabela; `br-table-footer` é
+             * renderizado quando a paginação está habilitada. As propriedades de célula
+             * seguem, quando aplicável, a precedência: célula, linha, coluna, tabela e valor
+             * padrão. Cabeçalhos multinível usam várias linhas em `br-table-header` com
+             * `colSpan`/`rowSpan`. Linhas contíguas com `rowGroup` formam unidades de ordenação,
+             * paginação e virtualização; a seleção permanece individual. Células com `rowSpan`
+             * não atravessam os limites do grupo. Prefira tabelas simples quando possível.
+             * @cssprop --br-table-loading-opacity - Opacidade do conteúdo durante o carregamento. Padrão: 0.5.
+             * @fires brTableActionClick - Quando uma ação pública é acionada.
+             * @fires brTableSelectionChange - Quando o conjunto selecionado muda.
+             * @fires brTableRowExpansionChange - Quando uma linha expande ou recolhe.
+             * @fires brTableSortRequest - Antes de aplicar uma solicitação de ordenação.
+             * @fires brTableSortChange - Quando os critérios de ordenação mudam.
+             * @fires brTablePageChange - Quando o consumidor solicita outra página pela paginação do rodapé.
+             * @fires brTablePageSizeChange - Quando o consumidor solicita outra quantidade de itens por página.
+             * @fires brTableSearch - Quando a busca é enviada ou fechada.
+             */
+            "br-table": LocalJSX.IntrinsicElements["br-table"] & JSXBase.HTMLAttributes<HTMLBrTableElement>;
+            /**
+             * ## Design System
+             * Para 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).
+             * Representa uma ação global, contextual ou associada a uma linha da tabela.
+             * O contexto é inferido pelo slot e pela posição do componente na árvore.
+             * Para executar funções a partir das ações, ouça o evento `brTableActionClick`:
              * ```html
-             * <br-table>
-             *   <br-table-header slot="header">
-             *     <br-table-row>
-             *       <br-table-header-cell>Nome</br-table-header-cell>
-             *       <br-table-header-cell>Cargo</br-table-header-cell>
-             *     </br-table-row>
-             *   </br-table-header>
-             *   <br-table-body slot="body">
-             *     <br-table-row>
-             *       <br-table-cell>Maria Silva</br-table-cell>
-             *       <br-table-cell>Analista</br-table-cell>
-             *     </br-table-row>
-             *   </br-table-body>
-             * </br-table>
+             * <!-- 1. Ouvindo diretamente na ação -->
+             * <br-table-action id="btn-filtro" label="Filtros" icon-name="fa-solid:filter"></br-table-action>
+             * <script>
+             *   document.getElementById('btn-filtro').addEventListener('brTableActionClick', () => {
+             *     executarFiltros();
+             *   });
+             * </script>
+             * <!-- 2. Ouvindo na tabela (recomendado para ações diretas e colapsadas em menu) -->
+             * <script>
+             *   table.addEventListener('brTableActionClick', (event) => {
+             *     const { type, label, rowIndex } = event.detail;
+             *     if (type === 'row') executarAcaoLinha(label, rowIndex);
+             *     else if (type === 'global') executarAcaoGlobal(label);
+             *   });
+             * </script>
              * ```
-             * ### Quando usar
-             * - Dados bidimensionais com cabeçalhos de coluna e necessidades de ordenação ou comparação.
-             * ### Quando evitar
-             * - Listas simples de itens lineares: use `br-list`.
-             * - Agrupamento de informações de um único registro: use `br-card`.
-             * Consulte as [diretrizes de design do GovBR](https://www.gov.br/ds/components/table?tab=designer).
-             * @category Dados, Conteúdo
-             * @status stable
-             * @Slot header: Área para inclusão do subcomponente br-table-header
-             * @Slot body: Área para inclusão do subcomponente br-table-body
+             * @fires brTableActionClick - Quando o usuário aciona o botão.
              */
-            "br-table": LocalJSX.IntrinsicElements["br-table"] & JSXBase.HTMLAttributes<HTMLBrTableElement>;
+            "br-table-action": LocalJSX.IntrinsicElements["br-table-action"] & JSXBase.HTMLAttributes<HTMLBrTableActionElement>;
             /**
-             * Corpo de dados (`<tbody>`) da tabela. Use no slot `body` do `br-table`.
-             * Agrupa as linhas `br-table-row` contendo as células de dados `br-table-cell`.
+             * ## Design System
+             * Para 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).
+             * Exibe o título, as ações globais e as ações contextuais da tabela.
+             * Ações excedentes são agrupadas automaticamente em um menu.
+             * Compõe `br-table`, que configura a barra automaticamente. Também pode ser usada
+             * diretamente para compor uma barra de ações. Quando `hasSearch` está ativo,
+             * solicita a busca à aplicação, sem filtrar ou destacar os dados.
+             */
+            "br-table-bar": LocalJSX.IntrinsicElements["br-table-bar"] & JSXBase.HTMLAttributes<HTMLBrTableBarElement>;
+            /**
+             * ## Design System
+             * Para 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).
+             * Agrupa semanticamente as linhas que compõem o corpo de `br-table`.
+             * É uma peça declarativa do slot `body`; recebe `br-table-row` e entrega ao
+             * orquestrador a seleção, ordenação e materialização virtual. Os contêineres
+             * visuais dos grupos são internos, montados pela tabela e não devem ser
+             * instanciados pelo consumidor. Use o componente na composição de `br-table`.
              */
             "br-table-body": LocalJSX.IntrinsicElements["br-table-body"] & JSXBase.HTMLAttributes<HTMLBrTableBodyElement>;
             /**
-             * Célula de dados (`<td>`) da tabela. Use dentro de um `br-table-row` no corpo da tabela.
-             * Coloque o conteúdo do registro no slot padrão.
+             * ## Design System
+             * Para 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).
+             * Representa uma célula de dados, com suporte a alinhamento, overflow,
+             * tooltip e agrupamento automático de ações excedentes. Compõe `br-table-row`
+             * dentro do corpo de `br-table`, que coordena posição, interação e herança.
+             * Use `rowSpan` dentro de um grupo contíguo de linhas e `rowHeader` para seu
+             * rótulo compartilhado; evite uso avulso fora da composição da tabela.
+             * @fires brAlignmentChange - Quando um alinhamento específico muda.
+             * @fires brOverflowChange - Quando a estratégia de overflow muda.
              */
             "br-table-cell": LocalJSX.IntrinsicElements["br-table-cell"] & JSXBase.HTMLAttributes<HTMLBrTableCellElement>;
             /**
-             * Cabeçalho da tabela (`br-table`). Use no slot `header`.
-             * Agrupa as linhas `br-table-row` com as células de cabeçalho `br-table-header-cell`.
+             * 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).
+             * Renderiza a paginação da tabela quando `hasPagination` está habilitado em `br-table`.
+             * Orquestrado internamente pela tabela; não deve ser inserido diretamente pelo consumidor.
+             */
+            "br-table-footer": LocalJSX.IntrinsicElements["br-table-footer"] & JSXBase.HTMLAttributes<HTMLBrTableFooterElement>;
+            /**
+             * ## Design System
+             * Para 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).
+             * Agrupa as linhas de cabeçalho de `br-table`, que as posiciona em uma grade.
+             * Use uma linha para tabelas simples e múltiplas linhas com `colSpan`/`rowSpan`
+             * em `br-table-header-cell` para hierarquias de colunas. É uma peça declarativa
+             * do slot `header`, usada com o orquestrador; não realiza ordenação avulsa.
              */
             "br-table-header": LocalJSX.IntrinsicElements["br-table-header"] & JSXBase.HTMLAttributes<HTMLBrTableHeaderElement>;
             /**
-             * Célula de cabeçalho (`<th>`) da tabela. Use dentro de um `br-table-row` no cabeçalho.
-             * Coloque o título da coluna no slot padrão. Para habilitar ordenação, ative `sortable`.
+             * ## Design System
+             * Para 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).
+             * Define o conteúdo e as propriedades herdáveis de uma coluna de `br-table`.
+             * Compõe as linhas de `br-table-header` no slot `header`; não deve ser usada
+             * avulsa. `colSpan` e `rowSpan` representam grupos e níveis do cabeçalho.
+             * Somente folhas que ocupam uma coluna podem ordenar os dados.
+             * Também exibe tooltip quando o conteúdo truncado requer informação adicional.
+             * @fires brColumnWidthChange - Quando a largura declarada muda.
+             * @fires brAlignmentChange - Quando um alinhamento da coluna muda.
+             * @fires brOverflowChange - Quando a estratégia de overflow muda.
              */
             "br-table-header-cell": LocalJSX.IntrinsicElements["br-table-header-cell"] & JSXBase.HTMLAttributes<HTMLBrTableHeaderCellElement>;
             /**
-             * Linha horizontal (`<tr>`) da tabela. Use dentro de `br-table-header` ou `br-table-body`.
-             * Use `selected` para indicar que a linha está selecionada.
+             * ## Design System
+             * Para 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).
+             * Representa uma linha de dados e sua área opcional de conteúdo expandido.
+             * É uma peça declarativa de `br-table-body` ou `br-table-header`, coordenada por
+             * `br-table`. Recebe células de dados ou cabeçalho conforme o pai. `rowGroup`
+             * identifica linhas contíguas que devem permanecer juntas; use-o apenas no corpo.
+             * Em grupos, os detalhes expandidos são apresentados após as linhas do grupo.
+             * @fires brAlignmentChange - Quando um alinhamento herdável muda.
+             * @fires brOverflowChange - Quando a estratégia de overflow muda.
              */
             "br-table-row": LocalJSX.IntrinsicElements["br-table-row"] & JSXBase.HTMLAttributes<HTMLBrTableRowElement>;
             /**