@govbr-ds/webcomponents 2.4.0 → 2.6.0

package/dist/types/components/skip-link/skip-link-item/skip-link-item.d.ts

@@ -1,20 +1,10 @@
 import { type EventEmitter } from '../../../stencil-public-runtime';
 import type { SkipLinkItemFocusDetail, SkipLinkNavigateDetail } from '../skip-link.types';
 /**
- * Subcomponente individual de `br-skip-link`, utilizado para declarar cada atalho específico de salto de bloco acessível.
+ * Item legado de atalho do `br-skip-link`. Em código novo, utilize `br-skip-link-item`.
  *
- * ### Papel na composição
+ * Defina o destino em `target` e o texto do link no slot padrão.
  *
- * - Define o texto descritivo do atalho (ex.: "Ir para o conteúdo") e o identificador do alvo na página (`targetId` ou `href`).
- * - Transfere o foco programático e visual diretamente para o elemento alvo ao ser acionado com Enter ou espaço.
- *
- * ### Regra de uso e relacionamento
- *
- * Deve ser declarado no slot padrão do orquestrador `br-skip-link`. Cada item deve apontar para um elemento existente na página dotado de `id` e foco acessível (`tabindex="-1"`). Não deve ser usado fora do contexto do skip-link.
- *
- * Para a documentação completa de design, consulte o [Design System do GovBR](https://www.gov.br/ds/components/skip-link?tab=designer).
- *
-
  * @slot default - Slot para o texto do link de navegação rápida.
  * @slot tag - Slot para personalizar a tag numérica do atalho de teclado, exibindo o valor de key-number por padrão.
  * @status deprecated
@@ -72,14 +62,14 @@ export declare class SkipLinkItem {
      */
     /** @deprecated Use `brSkipLinkItemActivate`. */
     brSkiplinkItemClick: EventEmitter<SkipLinkNavigateDetail>;
-    /** Evento canônico emitido quando o item é ativado. */
+    /** Evento emitido quando o item é ativado. */
     brSkipLinkItemActivate: EventEmitter<SkipLinkNavigateDetail>;
     /**
      * Evento emitido quando o item recebe foco.
      */
     /** @deprecated Use `brSkipLinkItemFocus`. */
     brSkiplinkItemFocus: EventEmitter<SkipLinkItemFocusDetail>;
-    /** Evento canônico emitido quando o item recebe foco. */
+    /** Evento emitido quando o item recebe foco. */
     brSkipLinkItemFocus: EventEmitter<SkipLinkItemFocusDetail>;
     disconnectedCallback(): void;
     componentWillLoad(): void;

package/dist/types/components/skip-link/skip-link.d.ts

@@ -1,35 +1,29 @@
 import { type EventEmitter } from '../../stencil-public-runtime';
 import type { SkipLinkNavigateDetail, SkipLinkPosition, SkipLinkVariant } from './skip-link.types';
 /**
- * O componente `br-skip-link` é o bloco essencial de acessibilidade posicionado no topo da página, permitindo que pessoas que utilizam teclado ou tecnologias assistivas saltem blocos repetitivos e acessem diretamente áreas principais da aplicação.
+ * O `br-skip-link` fornece atalhos acessíveis de teclado no topo da página para saltar blocos repetitivos de conteúdo.
  *
- * ### Para que serve
+ * Posicione no início da página. Declare os atalhos usando elementos `br-skip-link-item` no slot padrão, apontando cada destino em `target`.
  *
- * - **Atalho de teclado imediato:** Fornece links diretos ("Ir para o conteúdo principal", "Ir para o menu", "Ir para a busca", "Ir para o rodapé") logo no primeiro acionamento da tecla Tab.
- * - **Conformidade WCAG obrigatória:** Atende ao critério de sucesso 2.4.1 (Bypass Blocks) da WCAG 2.1, essencial para portais e serviços públicos.
- * - **Comportamento visual discreto:** Permanece oculto visualmente por padrão, tornando-se visível imediatamente assim que recebe o foco do teclado.
+ * ```html
+ * <br-skip-link>
+ *   <br-skip-link-item target="#conteudo-principal">Ir para o conteúdo</br-skip-link-item>
+ *   <br-skip-link-item target="#menu-navegacao">Ir para o menu</br-skip-link-item>
+ * </br-skip-link>
+ * ```
  *
- * ### Quando utilizar
+ * O componente permanece oculto e se torna visível automaticamente assim que recebe o foco do teclado (Tab).
  *
- * - **Utilize quando:**
- *   - Obrigatoriamente em todas as páginas e aplicações do GovBR-DS, posicionado como o primeiro elemento interativo do corpo do documento.
- * - **Evite e prefira outro componente quando:**
- *   - O link tiver a intenção de navegação comum no corpo do texto (use `br-link`).
+ * ### Quando usar
  *
- * ### Composição e Subcomponentes
+ * - No topo de todas as páginas para cumprir as diretrizes de acessibilidade (WCAG 2.4.1).
  *
- * | Subcomponente | Papel | Regra de uso |
- * | --- | --- | --- |
- * | `br-skip-link` | **Orquestrador de atalhos.** Agrupa a lista de links rápidos e gerencia visibilidade no foco. | Deve ser o primeiro elemento interativo no topo da página. |
- * | `br-skip-link-item` | **Item individual de atalho.** Especifica o destino e o texto do salto. | Declarado no slot padrão do `br-skip-link`. |
+ * ### Quando evitar
  *
- * ### Como os subcomponentes se relacionam
+ * - Links de navegação comuns no corpo do texto: use `br-link`.
  *
- * O `br-skip-link` atua como contêiner que abriga múltiplos elementos `br-skip-link-item`. Cada item referencia o `id` do elemento de destino na página (ex.: `#main-content`), conduzindo o foco imediatamente para a região desejada.
+ * Consulte as [diretrizes de design do GovBR](https://www.gov.br/ds/components/skip-link?tab=designer).
  *
- * Para a documentação completa de design, incluindo diretrizes de acessibilidade e especificações visuais, consulte o [Design System do GovBR](https://www.gov.br/ds/components/skip-link?tab=designer).
- *
-
  * @category Navegação
  * @status stable
  * @slot default - Slot para inserir os itens de navegação rápida (br-skip-link-item). A tag br-skiplink-item é aceita por compatibilidade.
@@ -113,21 +107,21 @@ export declare class SkipLink {
      */
     /** @deprecated Use `brSkipLinkNavigate`. */
     brSkiplinkNavigation: EventEmitter<SkipLinkNavigateDetail>;
-    /** Evento canônico emitido quando um destino é ativado. */
+    /** Evento emitido quando um destino é ativado. */
     brSkipLinkNavigate: EventEmitter<SkipLinkNavigateDetail>;
     /**
      * Evento emitido quando o skiplink se torna visível.
      */
     /** @deprecated Use `brSkipLinkShow`. */
     brDidShow: EventEmitter<void>;
-    /** Evento canônico emitido ao exibir o componente. */
+    /** Evento emitido ao exibir o componente. */
     brSkipLinkShow: EventEmitter<void>;
     /**
      * Evento emitido quando o skiplink se torna oculto.
      */
     /** @deprecated Use `brSkipLinkHide`. */
     brDidHide: EventEmitter<void>;
-    /** Evento canônico emitido ao ocultar o componente. */
+    /** Evento emitido ao ocultar o componente. */
     brSkipLinkHide: EventEmitter<void>;
     connectedCallback(): void;
     disconnectedCallback(): void;

package/dist/types/components/slider/slider.d.ts

@@ -3,37 +3,27 @@ import { type FormValidationState } from '../../shared/utils/form';
 import { type FormValidationChangeDetail } from '../../shared/utils/validator';
 import type { SliderDensity, SliderRangeValue, SliderStep, SliderValidator } from './slider.types';
 /**
- * O componente `br-slider` é o controle deslizante do GovBR-DS, desenvolvido para permitir que a pessoa usuária selecione um valor numérico único ou uma faixa contínua de valores dentro de um intervalo delimitado.
+ * O `br-slider` seleciona um valor ou uma faixa de valores numéricos em uma trilha graduada.
  *
- * ### Para que serve
+ * Use `min`, `max`, `step` e `value` para definir os limites e o valor. Para selecionar um intervalo (faixa com duas alças), use `range` e `range-value`.
  *
- * - **Seleção numérica fluida:** Permite escolher valores deslizando uma alça (thumb) ao longo de uma trilha graduada, com atualização em tempo real.
- * - **Modo simples e composto (faixa / range):** Suporta uma única alça para valor individual ou duas alças para delimitação de intervalo mínimo e máximo (ex.: faixa de preços, período de anos).
- * - **Entrada numérica sincronizada:** Oferece campo de entrada numérico integrado opcional para digitação exata com sincronização bidirecional.
- * - **Acessibilidade WAI-ARIA:** Suporta controle total por teclado (setas direcionais, Page Up, Page Down, Home e End) e comunica valores atuais via `aria-valuenow`.
+ * ```html
+ * <br-slider min="0" max="100" value="50" label="Volume"></br-slider>
+ * <br-slider min="0" max="1000" range range-value="[200, 800]" label="Faixa de preço"></br-slider>
+ * ```
  *
- * ### Quando utilizar
+ * ### Quando usar
  *
- * - **Utilize quando:**
- *   - O usuário precisar definir grandezas graduais onde a exploração intuitiva seja mais conveniente do que a digitação manual isolada.
- *   - Para filtros de faixa de valores (ex.: "De R$ 100 até R$ 500").
- * - **Evite e prefira outro componente quando:**
- *   - A precisão exata for estritamente necessária e o intervalo for arbitrário (prefira `br-input` numérico).
- *   - O valor for uma escolha categórica sem escala quantitativa (prefira `br-select` ou `br-radio`).
+ * - Ajuste gradual de quantidades contínuas (volume, brilho, zoom).
+ * - Filtros de intervalos numéricos ou de preços.
  *
- * ### Estrutura e Slots
+ * ### Quando evitar
  *
- * O `br-slider` possui estrutura rica com slots de referência, validação e customização da alça:
- * - `ref-start`: Slot para customização do rótulo de início da trilha.
- * - `ref-end`: Slot para customização do rótulo de fim da trilha.
- * - `feedback`: Slot para mensagens de validação (como `br-message`).
- * - `thumb-icon`: Slot para ícone personalizado na alça de controle em modo simples.
- * - `thumb-start-icon`: Slot para ícone na alça inicial em modo composto (`range`).
- * - `thumb-end-icon`: Slot para ícone na alça final em modo composto (`range`).
+ * - Entrada numérica exata arbitrária: use `br-input` com `type="number"`.
+ * - Poucas escolhas fixas discretas: use `br-radio` ou `br-select`.
  *
- * Para a documentação completa de design, incluindo diretrizes de acessibilidade e especificações visuais, consulte o [Design System do GovBR](https://www.gov.br/ds/components/slider?tab=designer).
+ * Consulte as [diretrizes de design do GovBR](https://www.gov.br/ds/components/slider?tab=designer).
  *
-
  * @category Formulários, Seleção
  * @status stable
  * @slot ref-start - Conteúdo exibido como referência inicial abaixo da trilha.
@@ -165,7 +155,7 @@ export declare class Slider {
      * @deprecated Use `orientation`.
      */
     readonly vertical: boolean;
-    /** Orientação canônica. Quando informada, tem precedência sobre `vertical`; valores inválidos usam `horizontal`. */
+    /** Orientação padrão. Quando informada, tem precedência sobre `vertical`; valores inválidos usam `horizontal`. */
     readonly orientation?: 'horizontal' | 'vertical';
     /**
      * Ativa o modo composto com duas alças para seleção de faixa.
@@ -209,7 +199,7 @@ export declare class Slider {
     /**
      * 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'.
+     * Exemplo: 'fa-solid:arrows-alt-h', 'fa-solid:circle'.
      */
     readonly thumbIcon?: string;
     /**
@@ -236,15 +226,15 @@ export declare class Slider {
      * @example
      * ```html
      * <br-slider
-     *   steps='[{"value": 1, "label": "Péssimo", "icon": "fa-solid:face-frown"}, {"value": 5, "label": "Excelente", "icon": "fa-solid:face-laugh"}]'
+     *   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:face-frown' },
-     *   { value: 5, label: 'Excelente', icon: 'fa-solid:face-laugh' },
+     *   { value: 1, label: 'Péssimo', icon: 'fa-solid:frown' },
+     *   { value: 5, label: 'Excelente', icon: 'fa-solid:laugh' },
      * ];
      * ```
      */

package/dist/types/components/step/step-item/step-item.d.ts

@@ -1,19 +1,9 @@
 import type { StepItemContentType, StepItemHighlight, StepItemLabelPosition, StepItemLayout, StepItemMode, StepItemPositionStatus, StepItemRole, StepItemVerticalContentPlacement } from './step-item.types';
 /**
- * Subcomponente individual de `br-step`, responsável por representar visualmente e semanticamente uma etapa específica do fluxo.
+ * Representa uma etapa individual dentro do `br-step`.
  *
- * ### Papel na composição
+ * Defina o número da etapa em `step-number` e o texto em `label`. Use `status` (`done`, `active`, `pending`) para indicar o estado da etapa.
  *
- * - Exibe o indicador numérico ou ícone da etapa, o rótulo descritivo e o estado de conclusão.
- * - Permite navegação interativa opcional caso etapas anteriores possam ser revisitadas diretamente com clique.
- *
- * ### Regra de uso e relacionamento
- *
- * Deve ser declarado no slot padrão do orquestrador `br-step`. O componente pai calcula a orientação (horizontal ou vertical), as linhas de conexão intermediárias e aplica os atributos de acessibilidade da etapa atual. Não deve ser usado fora de um `br-step`.
- *
- * Para a documentação completa de design, consulte o [Design System do GovBR](https://www.gov.br/ds/components/step?tab=designer).
- *
-
  * @slot content-area - Slot para conteúdo customizado dentro do botão do item do step.
  * @slot step-content - Slot para conteúdo da etapa exibido no layout vertical (texto, formulário, etc.).
  *

package/dist/types/components/step/step.d.ts

@@ -2,38 +2,29 @@ import { type EventEmitter } from '../../stencil-public-runtime';
 import type { BrOrientation, BrProgressionType } from '../global.types';
 import type { StepChangeDetail, StepContentType, StepLabelPosition, StepMode, StepValidationStatus, StepVerticalContentPlacement } from './step.types';
 /**
- * O componente `br-step` é o indicador visual de etapas e progresso do GovBR-DS, desenvolvido para orientar a pessoa usuária ao longo de fluxos sequenciais e processos com múltiplos passos.
+ * O `br-step` exibe o progresso visual de um fluxo dividido em etapas consecutivas.
  *
- * ### Para que serve
+ * Declare cada etapa com `br-step-item` no slot padrão. Controle a etapa ativa pela propriedade `current`. Suporta orientação horizontal e vertical via `direction`.
  *
- * - **Visualização de progresso:** Informa claramente em qual etapa do processo o usuário se encontra, quais já foram concluídas e quais ainda estão pendentes.
- * - **Orientação flexível:** Suporta leiaute horizontal (ideal para telas amplas) e vertical (ideal para fluxos em barra lateral ou dispositivos móveis).
- * - **Semântica e acessibilidade WAI-ARIA:** Comunica o passo ativo através de `aria-current="step"` e indica etapas concluídas ou bloqueadas.
+ * ```html
+ * <br-step current="2">
+ *   <br-step-item step-number="1" label="Identificação"></br-step-item>
+ *   <br-step-item step-number="2" label="Dados Pessoais"></br-step-item>
+ *   <br-step-item step-number="3" label="Confirmação"></br-step-item>
+ * </br-step>
+ * ```
  *
- * ### Quando utilizar
+ * ### Quando usar
  *
- * - **Utilize quando:**
- *   - O fluxo tiver entre 2 e 5 etapas lógicas com uma sequência recomendada de execução (ex.: Identificação > Dados > Pagamento > Confirmação).
- * - **Evite e prefira outro componente quando:**
- *   - A pessoa usuária puder alternar livremente entre as seções em qualquer ordem sem dependência de progresso (prefira `br-tab`).
- *   - For necessário um contêiner completo que gerencie também os painéis de formulário e botões de avançar/voltar (prefira `br-wizard`).
+ * - Processos lineares com 3 ou mais etapas bem delimitadas.
  *
- * ### Composição e Subcomponentes
+ * ### Quando evitar
  *
- * | Subcomponente | Papel | Regra de uso |
- * | --- | --- | --- |
- * | `br-step` | **Orquestrador de progresso.** Gerencia a orientação, conecta as linhas de fluxo e calcula os estados das etapas. | Contêiner raiz da barra de progresso. |
- * | `br-step-item` | **Etapa individual.** Representa cada passo com número, rótulo e estado. | Declarado dentro do slot padrão do `br-step`. |
+ * - Formulários de múltiplas páginas onde o próprio componente gerencia as telas: use `br-wizard`.
+ * - Navegação plana entre abas da mesma tela: use `br-tab`.
  *
- * ### Como os subcomponentes se relacionam
+ * Consulte as [diretrizes de design do GovBR](https://www.gov.br/ds/components/step?tab=designer).
  *
- * O componente pai `br-step` recebe múltiplos elementos `br-step-item` em seu slot padrão:
- * 1. Com base na propriedade `current` ou nos índices declarados, o pai calcula as linhas conectoras visuais entre as etapas.
- * 2. Sincroniza os estados de cada etapa: concluída (`completed`), ativa (`active`) ou desabilitada (`disabled`).
- *
- * Para a documentação completa de design, incluindo diretrizes de acessibilidade e especificações visuais, consulte o [Design System do GovBR](https://www.gov.br/ds/components/step?tab=designer).
- *
-
  * @category Navegação, Progresso
  * @status stable
  * @slot default - Slot para os itens do step (br-step-item), aceitando apenas esse componente.

package/dist/types/components/switch/switch.d.ts

@@ -3,32 +3,28 @@ import { type FormValidationState } from '../../shared/utils/form';
 import { type FormValidationChangeDetail } from '../../shared/utils/validator';
 import type { SwitchValidator } from './switch.types';
 /**
- * O componente `br-switch` é o interruptor de alternância do GovBR-DS, desenvolvido para ativar ou desativar instantaneamente um recurso, modo ou configuração na interface.
+ * O `br-switch` alterna instantaneamente entre os estados ligado e desligado.
  *
- * ### Para que serve
+ * Defina o estado em `checked`. Opcionalmente configure os rótulos de estado em `label-on` e `label-off`.
  *
- * - **Alternância binária imediata:** Alterna entre dois estados mutuamente exclusivos (ligado/desligado, ativo/inativo, habilitado/desabilitado) com efeito imediato na aplicação.
- * - **Rótulo contextual dinâmico:** Suporta textos explicativos de estado (ex.: "Ativado" / "Desativado") e ícones de apoio.
- * - **Acessibilidade nativa WAI-ARIA:** Utiliza internamente o papel semântico `role="switch"` com o atributo `aria-checked`, garantindo anúncio claro de estado para leitores de tela.
+ * ```html
+ * <br-switch label="Receber notificações por e-mail" checked></br-switch>
+ * <br-switch label="Modo escuro" label-on="Ligado" label-off="Desligado"></br-switch>
+ * ```
  *
- * ### Quando utilizar
+ * Em formulários HTML, o componente integra-se via `ElementInternals`, participando do submit nativo.
  *
- * - **Utilize quando:**
- *   - A alteração de estado entrar em vigor imediatamente após a interação, sem depender de um botão "Salvar" ou submissão de formulário.
- *   - Para preferências do sistema (ex.: "Tema escuro", "Notificações ativas", "Wi-Fi ligado").
- * - **Evite e prefira outro componente quando:**
- *   - A escolha fizer parte de um formulário com múltiplos campos que serão submetidos juntos (prefira `br-checkbox`).
- *   - A escolha for entre duas opções com nomes explícitos diferentes de ligado/desligado (prefira `br-radio`).
+ * ### Quando usar
  *
- * ### Estrutura e Slots
+ * - Ativar ou desativar uma funcionalidade com efeito imediato na tela ou configuração.
  *
- * O `br-switch` é um controle direto:
- * - `default`: Slot para personalização do rótulo descritivo do switch (com prioridade sobre a propriedade `label`).
- * - `feedback`: Slot para mensagens de validação contextual (como `br-message`).
+ * ### Quando evitar
  *
- * Para a documentação completa de design, incluindo diretrizes de acessibilidade e especificações visuais, consulte o [Design System do GovBR](https://www.gov.br/ds/components/switch?tab=designer).
+ * - Confirmação de termos em formulários (ex.: "Li e concordo"): use `br-checkbox`.
+ * - Escolha entre alternativas mutuamente exclusivas: use `br-radio`.
+ *
+ * Consulte as [diretrizes de design do GovBR](https://www.gov.br/ds/components/switch?tab=designer).
  *
-
  * @category Formulários, Seleção, Ações
  * @status stable
  * @slot default - Slot para o rótulo do switch, com prioridade sobre a propriedade label.

package/dist/types/components/tab/tab-item/tab-item.d.ts

@@ -1,19 +1,9 @@
 import { type EventEmitter } from '../../../stencil-public-runtime';
 /**
- * Subcomponente individual de `br-tab`, responsável por representar conjuntamente a aba de seleção e o respectivo painel de conteúdo associado.
+ * Define uma aba e seu respectivo painel de conteúdo dentro do `br-tab`.
  *
- * ### Papel na composição
+ * Defina o título da aba em `label` ou no slot `label`, e insira o conteúdo do painel no slot padrão. Use `active` para iniciar a aba selecionada e `disabled` para desabilitá-la.
  *
- * - Define o título ou rótulo da aba (propriedade `label` ou slot `label`), ícones de apoio e o estado de seleção (`active`) ou desativação (`disabled`).
- * - Contém o corpo de elementos que compõem o painel renderizado quando a aba é selecionada.
- *
- * ### Regra de uso e relacionamento
- *
- * Deve ser declarado dentro do slot padrão do orquestrador `br-tab`. O componente pai é responsável por montar a barra de botões acessíveis, sincronizar os atributos WAI-ARIA e controlar a alternância de visibilidade do painel. Não deve ser usado isoladamente sem o `br-tab` pai.
- *
- * Para a documentação completa de design, consulte o [Design System do GovBR](https://www.gov.br/ds/components/tab?tab=designer).
- *
-
  * @slot default - Slot para o conteúdo do item da aba.
  */
 export declare class TabItem {
@@ -37,15 +27,15 @@ export declare class TabItem {
      * @deprecated Use `label`.
      */
     tabItemTitle: string;
-    /** Texto canônico do item. Quando informado, tem precedência sobre `tabItemTitle`. */
+    /** Texto do item. Quando informado, tem precedência sobre `tabItemTitle`. */
     label?: string;
     /**
-     * Ícone da aba como identificador Iconify (ex.: `fa6-solid:bell`), renderizado em SVG pelo `br-icon`.
+     * Í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}`. Identificadores Iconify continuam suportados.
+     * geram aviso e devem migrar para o slot `icon-{id}`. Nomes fora do cache local não são carregados remotamente.
      */
     icon: string;
     /**
@@ -61,7 +51,7 @@ export declare class TabItem {
      * @deprecated Use `active`.
      */
     isActive: boolean;
-    /** Estado ativo canônico. Quando informado, tem precedência sobre `isActive`. */
+    /** Estado ativo atual. Quando informado, tem precedência sobre `isActive`. */
     active?: boolean;
     /**
      * Define contador do item de tab (exibido abaixo do botão)

package/dist/types/components/tab/tab.d.ts

@@ -1,39 +1,32 @@
 import { type EventEmitter } from '../../stencil-public-runtime';
 import type { TabAlignItems, TabColorMode, TabDensity } from './tab.types';
 /**
- * O componente `br-tab` é o organizador de navegação por abas do GovBR-DS, desenvolvido para permitir que a pessoa usuária alterne entre diferentes visões ou painéis de conteúdo correlacionados sem sair da mesma página.
+ * O `br-tab` organiza diferentes visões ou painéis de conteúdo na mesma página através de abas navegáveis.
  *
- * ### Para que serve
+ * Declare os itens usando `br-tab-item` no slot padrão. O componente gera automaticamente os botões da barra de navegação e controla a exibição do painel correspondente.
  *
- * - **Segmentação de conteúdo em mesmo nível:** Agrupa informações que compartilham o mesmo contexto geral (ex.: "Visão Geral", "Especificações", "Histórico", "Anexos").
- * - **Economia de espaço vertical:** Evita rolagens excessivas na página mantendo apenas o painel selecionado visível no momento.
- * - **Navegação acessível WAI-ARIA Tablist:** Implementa o padrão oficial de abas acessíveis: papéis semânticos `tablist`, `tab` e `tabpanel`, com controle total por setas do teclado e foco cíclico.
+ * ```html
+ * <br-tab>
+ *   <br-tab-item label="Dados Cadastrais">
+ *     <p>Conteúdo da primeira aba.</p>
+ *   </br-tab-item>
+ *   <br-tab-item label="Documentos">
+ *     <p>Conteúdo da segunda aba.</p>
+ *   </br-tab-item>
+ * </br-tab>
+ * ```
  *
- * ### Quando utilizar
+ * ### Quando usar
  *
- * - **Utilize quando:**
- *   - Houver conjuntos equivalentes de informação entre os quais a pessoa usuária pode navegar livremente e em qualquer ordem.
- * - **Evite e prefira outro componente quando:**
- *   - O conteúdo for sequencial com dependência de avanço ou conclusão de etapas anteriores (prefira `br-step` ou `br-wizard`).
- *   - As abas tiverem a função de navegar para rotas e URLs distintas da aplicação (prefira uma barra de links com `br-link` ou `br-header`).
+ * - Alternar entre conjuntos equivalentes de informação sem sair da página e sem ordem fixa de leitura.
  *
- * ### Composição e Subcomponentes
+ * ### Quando evitar
  *
- * | Subcomponente | Papel | Regra de uso |
- * | --- | --- | --- |
- * | `br-tab` | **Orquestrador de abas.** Constrói a barra de navegação acessível (`tablist`), controla a aba ativa e gerencia o teclado. | Contêiner raiz obrigatório declarado no template. |
- * | `br-tab-item` | **Aba e painel associado.** Define simultaneamente o rótulo do botão da aba e o conteúdo do painel correspondente. | Declarado no slot padrão do `br-tab`. |
+ * - Processos com etapas sequenciais que dependem de preenchimento prévio: use `br-wizard` ou `br-step`.
+ * - Links para páginas ou rotas distintas: use `br-link` ou `br-header`.
  *
- * ### Como os subcomponentes se relacionam
+ * Consulte as [diretrizes de design do GovBR](https://www.gov.br/ds/components/tab?tab=designer).
  *
- * O `br-tab` adota uma arquitetura declarativa prática:
- * 1. A aplicação declara os elementos `br-tab-item` dentro do slot padrão do `br-tab`.
- * 2. O componente pai extrai os rótulos e ícones de cada item para renderizar a barra superior de abas (`role="tab"`).
- * 3. O pai controla a visibilidade dos painéis (`role="tabpanel"`), exibindo exclusivamente o conteúdo da aba selecionada e garantindo a correlação de IDs acessíveis (`aria-controls`, `aria-labelledby`).
- *
- * Para a documentação completa de design, incluindo diretrizes de acessibilidade e especificações visuais, consulte o [Design System do GovBR](https://www.gov.br/ds/components/tab?tab=designer).
- *
-
  * @category Navegação, Seleção, Conteúdo
  * @status stable
  * @slot default - Slot para inserir os itens das abas (br-tab-item)
@@ -89,7 +82,7 @@ export declare class Tab {
      * @deprecated Use `alignment`.
      */
     alignItemsTab: TabAlignItems;
-    /** Alinhamento horizontal canônico. Quando informado, tem precedência sobre `alignItemsTab`; valores inválidos usam `start`. */
+    /** Alinhamento horizontal. Quando informado, tem precedência sobre `alignItemsTab`; valores inválidos usam `start`. */
     alignment?: TabAlignItems;
     /**
      * Desabilita o scroll automático da área de conteúdo.
@@ -196,7 +189,7 @@ export declare class Tab {
     private hasSlottedIcon;
     /**
      * Ícone da aba: o slot `icon-{id}` tem precedência; a prop `icon` do item é o fallback e
-     * aceita identificadores Iconify. Classes CSS na prop não funcionam no Shadow DOM e são ignoradas.
+     * aceita identificadores Font Awesome 5 Free presentes no cache local. Classes CSS na prop não funcionam no Shadow DOM e são ignoradas.
      */
     private renderTabIcon;
     private handleIconSlotChange;

package/dist/types/components/table/table-action/table-action.d.ts

@@ -0,0 +1,107 @@
+import { type EventEmitter } from '../../../stencil-public-runtime';
+import type { TableActionClickDetail, TableDensity } from '../table.types';
+/**
+ * ## 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.
+ */
+export declare class TableAction {
+    el: HTMLBrTableActionElement;
+    private readonly fallbackAriaLabel;
+    /**
+     * Texto visível e identificação semântica da ação.
+     *
+     * @default null
+     */
+    label: string | null;
+    /**
+     * Nome do ícone exibido pelo botão.
+     *
+     * @default null
+     */
+    iconName: string | null;
+    /**
+     * 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;
+    private buttonDensity;
+    private buttonDisabled;
+    /**
+     * Emitido quando o usuário aciona o botão.
+     *
+     * @remarks O `detail` utiliza `TableActionClickDetail`
+     */
+    brTableActionClick: EventEmitter<TableActionClickDetail>;
+    private stateObserver;
+    connectedCallback(): void;
+    componentWillLoad(): void;
+    componentDidLoad(): void;
+    protected handleDensityChange(): void;
+    disconnectedCallback(): void;
+    /**
+     * Informa se a ação pertence a uma célula de dados.
+     */
+    private isInsideTableCell;
+    private getDensitySource;
+    private syncButtonState;
+    private observeStateSources;
+    /**
+     * Resolve o contexto da ação a partir do slot e da posição na tabela.
+     */
+    private getActionType;
+    /**
+     * Define o formato visual adequado ao contexto da ação.
+     */
+    private getButtonShape;
+    /**
+     * Define a ênfase visual adequada ao contexto da ação.
+     */
+    private getButtonEmphasis;
+    /**
+     * Resolve o melhor texto disponível para tecnologias assistivas.
+     */
+    private getButtonAriaLabel;
+    private getTooltipLabel;
+    /**
+     * Interrompe o clique nativo e publica o evento normalizado da tabela.
+     */
+    private handleActionClick;
+    /**
+     * Renderiza o botão compartilhado pelas variações circular e pill.
+     */
+    private renderActionButton;
+    /**
+     * Renderiza a ação e adiciona tooltip quando o botão é circular.
+     */
+    render(): any;
+}