@govbr-ds/webcomponents 2.1.2 → 2.2.0

package/dist/types/components/footer/footer-legal/footer-legal.d.ts

@@ -1,6 +1,20 @@
 /**
- * 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/footer?tab=designer).
+ * O componente `br-footer-legal` é o subcomponente do GovBR-DS que apresenta as informações de licenciamento aberto de conteúdo (como Creative Commons) e termos legais obrigatórios.
  *
+ * ### Para que serve
+ *
+ * - **Transparência jurídica:** Comunica a licença de uso dos dados e conteúdos do portal público.
+ * - **Fechamento de conformidade:** Atende às normas governamentais de publicação de páginas federais.
+ *
+ * ### Papel na composição
+ *
+ * Atua como elemento informativo legal no rodapé.
+ *
+ * ### Regra de uso e relacionamento
+ *
+ * - Deve ser posicionado na área base de menções legais do `br-footer`.
+ *
+
  * @slot default - Slot para informações legais no rodapé, como direitos autorais ou termos de uso.
  *
  * @part container - Wrapper principal do footer-legal.

package/dist/types/components/footer/footer-logo/footer-logo.d.ts

@@ -2,8 +2,23 @@ import { type EventEmitter } from '../../../stencil-public-runtime';
 import type { BrLinkTarget, BrNavigateDetail, BrNavigationMode } from '../../global.types';
 import type { FooterLogoPosition } from './footer-logo.types';
 /**
- * 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/footer?tab=designer).
+ * O componente `br-footer-logo` é o subcomponente do GovBR-DS responsável por renderizar a marca oficial do órgão ou a marca unificada do Governo Federal no rodapé.
  *
+ * ### Para que serve
+ *
+ * - **Assinatura institucional:** Reforça a autenticidade governamental no fechamento da página.
+ * - **Link oficial:** Permite redirecionar a pessoa usuária para o portal principal do Governo Federal ou do órgão.
+ *
+ * ### Papel na composição
+ *
+ * Atua como elemento de identidade institucional no rodapé.
+ *
+ * ### Regra de uso e relacionamento
+ *
+ * - Deve ser inserido na área ou slot de logotipo do `br-footer`.
+ * - Não deve ser utilizado fora do ecossistema de rodapé.
+ *
+
  * @part container - Wrapper principal do footer-logo.
  */
 export declare class FooterLogo {
@@ -34,8 +49,9 @@ export declare class FooterLogo {
     position: FooterLogoPosition;
     /**
      * Define se a logo é de um parceiro.
+     *
+     * @deprecated Use `partner`.
      */
-    /** @deprecated Use `partner`. */
     isPartner: boolean;
     /** Identifica logo de parceiro. Quando informada, tem precedência sobre `isPartner`. */
     partner?: boolean;
@@ -55,6 +71,9 @@ export declare class FooterLogo {
      * Cliques com modificadores, botão do meio ou `target` diferente de `_self` permanecem nativos.
      */
     navigationMode: BrNavigationMode;
+    private get effectivePosition();
+    private get effectiveTarget();
+    private get effectiveNavigationMode();
     /**
      * Evento cancelável emitido em `navigation-mode="event"` para cliques primários sem modificadores em links `_self`.
      * Chame `event.preventDefault()` no listener para impedir a navegação nativa e entregar `event.detail.href` ao roteador da SPA.

package/dist/types/components/footer/footer-social/footer-social.d.ts

@@ -1,9 +1,22 @@
 import { type EventEmitter } from '../../../stencil-public-runtime';
 import type { BrLinkTarget, BrNavigateDetail, BrNavigationMode } from '../../global.types';
 /**
- * O subcomponente `br-footer-social` representa os ícones de redes sociais no rodapé do site, de acordo com a documentação de design do GovBR.
- * Ele deve ser utilizado como filho direto do componente [`br-footer`](/docs/components/footer).
+ * O componente `br-footer-social` é o subcomponente do GovBR-DS que agrupa e renderiza atalhos e ícones para os canais oficiais de redes sociais da organização pública.
  *
+ * ### Para que serve
+ *
+ * - **Canais oficiais:** Facilita o acesso do cidadão às mídias sociais e de comunicação do órgão.
+ * - **Acessibilidade nos atalhos:** Fornece rótulos acessíveis e abertura segura de links externos.
+ *
+ * ### Papel na composição
+ *
+ * Atua como bloco de engajamento social no rodapé.
+ *
+ * ### Regra de uso e relacionamento
+ *
+ * - Deve ser inserido na área ou slot destinado a redes sociais do `br-footer`.
+ *
+
  * @slot icon - Ícone personalizado. Quando preenchido, substitui o ícone definido por `icon`.
  */
 export declare class FooterSocial {
@@ -21,7 +34,9 @@ export declare class FooterSocial {
      */
     customId: string;
     /**
-     * Ícone da rede social
+     * 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.
      */
     icon: string;
     /**
@@ -43,6 +58,8 @@ export declare class FooterSocial {
      * Cliques com modificadores, botão do meio ou `target` diferente de `_self` permanecem nativos.
      */
     navigationMode: BrNavigationMode;
+    private get effectiveTarget();
+    private get effectiveNavigationMode();
     /**
      * Evento cancelável emitido em `navigation-mode="event"` para cliques primários sem modificadores em links `_self`.
      * Chame `event.preventDefault()` no listener para impedir a navegação nativa e entregar `event.detail.href` ao roteador da SPA.

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

@@ -1,8 +1,41 @@
 import type { FooterLayoutWidth, FooterTheme } from './footer.types';
 /**
- * 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/footer?tab=designer).
+ * O componente `br-footer` é o orquestrador completo de rodapé institucional do GovBR-DS. Fornece o fechamento estrutural da página, centralizando links de navegação categorizados, canais de redes sociais, menção legal de licenciamento aberto e a marca do Governo Federal.
  *
- * @category Estrutura
+ * ### Para que serve
+ *
+ * - **Fechamento e navegação secundária:** Agrupa em categorias os links úteis de apoio, mapas do site e serviços da entidade pública.
+ * - **Conformidade legal e transparência:** Apresenta a nota de licenciamento de conteúdo (ex.: Creative Commons) e termos legais obrigatórios.
+ * - **Redes sociais institucionais:** Exibe links oficiais de comunicação pública com a sociedade.
+ * - **Responsividade integrada:** Converte categorias de links em painéis expansíveis (sanfona) automaticamente no modo mobile.
+ *
+ * ### Quando utilizar
+ *
+ * - **Utilize quando:**
+ *   - Finalizar a estrutura da página em portais e sistemas governamentais alinhados ao padrão GovBR-DS.
+ *   - Oferecer navegação complementar, canais sociais e declarações de direitos autorais.
+ * - **Evite e prefira outro componente quando:**
+ *   - A interface for um diálogo modal ou painel isolado que não representa uma página completa do portal.
+ *
+ * ### Composição e Subcomponentes
+ *
+ * | Subcomponente | Papel | Regra de uso |
+ * | --- | --- | --- |
+ * | `br-footer` | **Orquestrador principal.** Gerencia a distribuição visual em colunas/linhas e o comportamento sanfona em telas menores. | Deve ser declarado como elemento de rodapé ao final da página. |
+ * | `br-footer-category` | **Categoria de links.** Agrupa links temáticos sob um título expansível. | Deve ser inserido no contêiner de categorias do `br-footer`. |
+ * | `br-footer-item` | **Item de link.** Link individual dentro de uma categoria de rodapé. | Deve ser utilizado dentro de um `br-footer-category`. |
+ * | `br-footer-logo` | **Logotipo.** Exibe a logomarca do órgão ou do Governo Federal. | Posicionado na área designada de logotipo do `br-footer`. |
+ * | `br-footer-social` | **Redes sociais.** Reúne links e ícones para canais sociais oficiais. | Posicionado no slot ou área de mídias sociais do `br-footer`. |
+ * | `br-footer-legal` | **Texto legal.** Exibe termos de licenciamento aberto e direitos autorais. | Posicionado na base legal do `br-footer`. |
+ *
+ * ### Como os subcomponentes se relacionam
+ *
+ * O `br-footer` atua como contêiner estrutural orquestrador. Ele organiza as categorias (`br-footer-category`) em colunas no desktop e alterna para comportamento de acordeão no mobile. Os itens (`br-footer-item`) herdam o contexto da categoria correspondente, enquanto as áreas de logotipo, redes sociais e notas legais completam o fechamento padronizado.
+ *
+ * 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/footer?tab=designer).
+ *
+
+ * @category Estrutura, Navegação
  * @status stable
  * @slot logo - Slot para o logo do rodapé, utilizando o componente br-logo.
  * @slot default - Slot para o mapa do site, utilizando br-footer-category e br-footer-item.
@@ -31,8 +64,9 @@ export declare class Footer {
     customId: string;
     /**
      * Indica o tema do rodapé.
+     *
+     * @deprecated Use `colorMode`.
      */
-    /** @deprecated Use `colorMode`. */
     theme: FooterTheme;
     /** Esquema de cor canônico. Quando informado, tem precedência sobre `theme`. */
     colorMode?: FooterTheme;
@@ -46,6 +80,8 @@ export declare class Footer {
      * - `full`: sempre ocupa 100% da largura disponível (`container-fluid`).
      */
     layoutWidth: FooterLayoutWidth;
+    private get effectiveColorMode();
+    private get effectiveLayoutWidth();
     private hasSocialNetwork;
     private hasPartnerLogo;
     private hasLegal;

package/dist/types/components/header/header-context.d.ts

@@ -0,0 +1 @@
+export declare function isCompactHeaderWithoutBrand(element: HTMLElement): boolean;

package/dist/types/components/header/header-function/header-function.d.ts

@@ -2,8 +2,23 @@ import { type EventEmitter } from '../../../stencil-public-runtime';
 import { type Breakpoint } from '../../../shared/utils/breakpoint-observer';
 import type { BrLinkTarget, BrNavigateDetail, BrNavigationMode } from '../../global.types';
 /**
- * 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/header?tab=designer).
+ * O componente `br-header-function` é o subcomponente do GovBR-DS que representa uma ação funcional ou utilitária rápida no cabeçalho (como alto contraste, atalhos de acessibilidade, suporte ou configurações).
  *
+ * ### Para que serve
+ *
+ * - **Ações utilitárias rápidas:** Permite disparar funcionalidades auxiliares com ícone e rótulo sem sair do fluxo da página.
+ * - **Feedback interativo:** Oferece estados visuais consistentes de foco, hover e ativação.
+ *
+ * ### Papel na composição
+ *
+ * Atua como controle interativo de utilidade dentro do cabeçalho.
+ *
+ * ### Regra de uso e relacionamento
+ *
+ * - Deve ser utilizado dentro de um `br-header-list` posicionado no slot `functions` do `br-header`.
+ * - Não deve ser utilizado como botão genérico de formulário ou ação primária de conteúdo (para esses casos, utilize `br-button`).
+ *
+
  * @slot default - Slot para o nome ou rótulo da funcionalidade.
  * @slot icon - Slot para ícone que representa a funcionalidade.
  */
@@ -21,6 +36,7 @@ export declare class HeaderFunction {
      * Indica se a lista está encolhido.
      */
     isShrunk: boolean;
+    private compactHeaderWithoutBrand;
     /**
      * Identificador único do componente.
      * Quando omitido, um valor é gerado automaticamente.
@@ -34,7 +50,9 @@ export declare class HeaderFunction {
      */
     href?: string;
     /**
-     * Nome Iconify do ícone exibido.
+     * Identificador legado do ícone exibido. Nomes conhecidos são resolvidos pelo
+     * registro SVG local; para novos usos, prefira o slot `icon` com um SVG, asset
+     * local ou elemento de ícone controlado pela aplicação.
      * @deprecated Use o slot `icon` com um SVG, asset ou elemento de ícone controlado pela aplicação.
      */
     iconName: string;
@@ -53,11 +71,15 @@ export declare class HeaderFunction {
      * Cliques com modificadores, botão do meio ou `target` diferente de `_self` permanecem nativos.
      */
     navigationMode: BrNavigationMode;
+    private get effectiveTarget();
+    private get effectiveNavigationMode();
     /**
      * Evento cancelável emitido em `navigation-mode="event"` para cliques primários sem modificadores em links `_self`.
      * Chame `event.preventDefault()` no listener para impedir a navegação nativa e entregar `event.detail.href` ao roteador da SPA.
      */
     brNavigate: EventEmitter<BrNavigateDetail>;
+    private handleHeaderCompactChange;
+    private syncHeaderLayout;
     /**
      * Ciclo de vida do componente.
      * Executado quando o componente é conectado ao DOM.

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

@@ -1,8 +1,23 @@
 import { type EventEmitter } from '../../../stencil-public-runtime';
 import type { BrLinkTarget, BrNavigateDetail, BrNavigationMode } from '../../global.types';
 /**
- * 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/header?tab=designer).
+ * O componente `br-header-link` é o subcomponente de navegação do GovBR-DS que representa um atalho ou hiperlink de navegação institucional no cabeçalho.
  *
+ * ### Para que serve
+ *
+ * - **Navegação institucional:** Oferece acesso direto a páginas de serviços, portais correlatos ou áreas centrais do órgão.
+ * - **Integração SPA:** Suporta navegação web padrão via atributo `href` ou integração com roteadores SPA via eventos de navegação.
+ *
+ * ### Papel na composição
+ *
+ * Atua como item folha de navegação dentro do cabeçalho.
+ *
+ * ### Regra de uso e relacionamento
+ *
+ * - Deve ser utilizado dentro de um `br-header-list` posicionado no slot `links` do `br-header`.
+ * - Não deve ser utilizado de forma avulsa fora do ecossistema de cabeçalho.
+ *
+
  * @slot default - Slot para o conteúdo do link exibido no cabeçalho.
  */
 export declare class HeaderLink {
@@ -11,6 +26,7 @@ export declare class HeaderLink {
      * Utilize esta propriedade para acessar e manipular o elemento do DOM associado ao componente.
      */
     el: HTMLBrHeaderLinkElement;
+    private compactHeaderWithoutBrand;
     /**
      * Identificador único do componente.
      * Quando omitido, um valor é gerado automaticamente.
@@ -38,11 +54,16 @@ export declare class HeaderLink {
      * Cliques com modificadores, botão do meio ou `target` diferente de `_self` permanecem nativos.
      */
     navigationMode: BrNavigationMode;
+    connectedCallback(): void;
+    private get effectiveTarget();
+    private get effectiveNavigationMode();
     /**
      * Evento cancelável emitido em `navigation-mode="event"` para cliques primários sem modificadores em links `_self`.
      * Chame `event.preventDefault()` no listener para impedir a navegação nativa e entregar `event.detail.href` ao roteador da SPA.
      */
     brNavigate: EventEmitter<BrNavigateDetail>;
+    private handleHeaderCompactChange;
+    private syncHeaderLayout;
     /**
      * Mapeia os nomes das classes CSS a serem aplicadas ao componente.
      * @returns Objeto com os nomes das classes CSS a serem aplicadas ao componente.

package/dist/types/components/header/header-list/header-list.d.ts

@@ -1,8 +1,23 @@
 import { type EventEmitter } from '../../../stencil-public-runtime';
 import { type Breakpoint } from '../../../shared/utils/breakpoint-observer';
 /**
- * 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/header?tab=designer).
+ * O componente `br-header-list` é o subcomponente contêiner do GovBR-DS que organiza links de navegação ou botões funcionais em uma estrutura de lista horizontal acessível.
  *
+ * ### Para que serve
+ *
+ * - **Agrupamento semântico:** Estrutura itens navegáveis ou funcionais em elementos de lista semânticos.
+ * - **Distribuição e espaçamento:** Garante o alinhamento horizontal padronizado de itens no cabeçalho.
+ *
+ * ### Papel na composição
+ *
+ * Atua como elo intermediário entre o orquestrador `br-header` e os itens filhos individuais (`br-header-link` ou `br-header-function`).
+ *
+ * ### Regra de uso e relacionamento
+ *
+ * - Deve ser inserido nos slots `links` ou `functions` do orquestrador `br-header`.
+ * - Serve de contêiner direto para subcomponentes `br-header-link` ou `br-header-function`.
+ *
+
  * @slot default - Slot para o conteúdo da lista de navegação no cabeçalho.
  */
 export declare class HeaderList {
@@ -84,13 +99,6 @@ export declare class HeaderList {
      * @param event O evento customizado contendo o ID do pai e o nome da lista.
      */
     private handleHeaderWidthChange;
-    /**
-     * Listener para o evento 'headerListFocused', disparado por outras listas.
-     * O evento contém o ID da lista que recebeu foco.
-     * Se o ID não corresponder ao ID da lista atual, a lista será ocultada.
-     * @param event O evento customizado contendo o ID da lista que recebeu foco.
-     */
-    private handleHeaderListFocused;
     /**
      * Fecha a lista.
      */

package/dist/types/components/header/header-logo/header-logo.d.ts

@@ -1,8 +1,23 @@
 import { type EventEmitter } from '../../../stencil-public-runtime';
 import type { BrLinkTarget, BrNavigateDetail, BrNavigationMode } from '../../global.types';
 /**
- * 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/header?tab=designer).
+ * O componente `br-header-logo` é o subcomponente do GovBR-DS responsável por renderizar a marca visual oficial ou a assinatura do órgão dentro do cabeçalho.
  *
+ * ### Para que serve
+ *
+ * - **Exibição de marca:** Apresenta a imagem ou logotipo institucional no topo da página.
+ * - **Link de retorno:** Permite associar um link à marca, direcionando a pessoa usuária à página inicial do portal ou sistema.
+ *
+ * ### Papel na composição
+ *
+ * Atua como elemento de identidade visual no cabeçalho. Não gerencia a estrutura do topo nem as ações utilitárias, papel reservado ao orquestrador `br-header`.
+ *
+ * ### Regra de uso e relacionamento
+ *
+ * - Deve ser utilizado posicionado preferencialmente no slot `logo` ou `signature` do componente orquestrador `br-header`.
+ * - Não deve ser utilizado isoladamente fora do contexto de cabeçalho institucional.
+ *
+
  * @slot default - Slot para a logo personalizada exibida no cabeçalho.
  *
  * @part container - Wrapper da logo do header.
@@ -36,6 +51,7 @@ export declare class HeaderLogo {
     isCompact: boolean;
     /**
      * Target do link quando href é fornecido.
+     * Aceita `_self`, `_blank`, `_parent` ou `_top`. Valores inválidos usam `_self`.
      */
     target?: BrLinkTarget;
     /**
@@ -43,6 +59,7 @@ export declare class HeaderLogo {
      * - `native` (padrão): preserva o comportamento do navegador, conforme HTML/W3C.
      * - `event`: emite `brNavigate`; se o evento for cancelado, bloqueia a navegação nativa para a SPA assumir.
      * Cliques com modificadores, botão do meio ou `target` diferente de `_self` permanecem nativos.
+     * Valores inválidos usam `native`.
      */
     navigationMode: BrNavigationMode;
     /**
@@ -57,6 +74,8 @@ export declare class HeaderLogo {
      * Altura da imagem.
      */
     height: string;
+    private get effectiveTarget();
+    private get effectiveNavigationMode();
     /**
      * Evento cancelável emitido em `navigation-mode="event"` para cliques primários sem modificadores em links `_self`.
      * Chame `event.preventDefault()` no listener para impedir a navegação nativa e entregar `event.detail.href` ao roteador da SPA.

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

@@ -2,16 +2,41 @@ import { type EventEmitter } from '../../stencil-public-runtime';
 import type { BrNavigateDetail, BrNavigationMode } from '../global.types';
 import type { HeaderArea, HeaderCompactChangeDetail, HeaderDensity, HeaderLayoutWidth, HeaderShrinkFirst } from './header.types';
 /**
- * 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/header?tab=designer).
+ * O componente `br-header` é o orquestrador principal de cabeçalho do GovBR-DS. Centraliza a identidade visual do órgão ou sistema público, links de navegação hierárquica, atalhos de funcionalidades, mecanismo de busca e botão de acesso ou autenticação.
  *
- * ### Acionamento de Menu Associado
- * Para integrar o cabeçalho com um menu (`br-menu`), passe um botão no slot `menu-trigger` com os seguintes atributos:
- * - `data-toggle="menu"`
- * - `data-target="#id-do-menu"` (substitua pelo ID ou `customId` do seu `br-menu`)
+ * ### Para que serve
  *
- * O componente `br-menu` escuta a esses atributos no escopo do documento e controlará automaticamente sua visibilidade.
+ * - **Identidade institucional unificada:** Apresenta a marca e assinatura visual oficial do Governo Federal e da entidade pública.
+ * - **Navegação e atalhos rápidos:** Reúne links para áreas centrais e botões funcionais (como contraste, acessibilidade e suporte).
+ * - **Busca e autenticação integradas:** Fornece áreas reservadas e slots para barra de busca rápida e gatilho de login/acesso.
+ * - **Comportamento responsivo e densidades:** Adapta-se automaticamente a diferentes telas com suporte a densidades padrão, compacta, pequena e grande.
  *
- * @category Estrutura
+ * ### Quando utilizar
+ *
+ * - **Utilize quando:**
+ *   - Desenvolver páginas, portais e sistemas públicos federais que requerem a barra superior padronizada do GovBR-DS.
+ *   - For necessário integrar identidade visual, navegação rápida, busca e acesso em uma estrutura consistente.
+ * - **Evite e prefira outro componente quando:**
+ *   - A navegação for exclusivamente lateral ou contextual interna de uma ferramenta gráfica (prefira `br-menu` ou barras de ferramentas específicas).
+ *
+ * ### Composição e Subcomponentes
+ *
+ * | Subcomponente | Papel | Regra de uso |
+ * | --- | --- | --- |
+ * | `br-header` | **Orquestrador principal.** Estrutura as áreas superior e inferior, gerencia responsividade e densidade. | Deve ser declarado como elemento raiz do topo da página. |
+ * | `br-header-logo` | **Identidade visual.** Exibe o logotipo ou brasão institucional. | Posicionado nos slots `logo` ou `signature` do `br-header`. |
+ * | `br-header-list` | **Agrupador de lista.** Contêiner semântico horizontal para links ou funções. | Encaixa-se nos slots `links` ou `functions` do `br-header`. |
+ * | `br-header-link` | **Item de link.** Atalho ou hiperlink de navegação institucional. | Deve ser inserido dentro de um `br-header-list` no slot `links`. |
+ * | `br-header-function` | **Ação funcional.** Botão de utilidade rápida (contraste, ajuda, etc.). | Deve ser inserido dentro de um `br-header-list` no slot `functions`. |
+ *
+ * ### Como os subcomponentes se relacionam
+ *
+ * O `br-header` orquestra as áreas da barra através de slots nomeados (`logo`, `signature`, `links`, `functions`, `search`, `access`, `menu-trigger`, `caption`, `subcaption`). Ele observa o tamanho de tela e a densidade configurada, reorganizando os blocos e delegando a exibição correta aos subcomponentes filhos.
+ *
+ * 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/header?tab=designer).
+ *
+
+ * @category Estrutura, Navegação, Identidade
  * @status stable
  * @slot logo - Slot para a logo do cabeçalho.
  * @slot signature - Slot para a assinatura visual da organização.
@@ -68,6 +93,7 @@ export declare class Header {
      * - `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`.
      */
     density: HeaderDensity;
     /**
@@ -79,6 +105,9 @@ export declare class Header {
     compact?: boolean;
     /**
      * Fixa o cabeçalho no topo durante a rolagem.
+     * Quando `compact` ou `is-compact` é definido explicitamente, o modo visual
+     * permanece fixo durante a rolagem. Sem essa configuração, o header sticky
+     * alterna automaticamente entre os modos compacto e expandido.
      * @deprecated Use `sticky`.
      */
     isSticky: boolean;
@@ -112,6 +141,13 @@ export declare class Header {
      * - `full`: sempre ocupa 100% da largura disponível (`container-fluid`).
      */
     layoutWidth: HeaderLayoutWidth;
+    private get effectiveShrinkFirst();
+    private get effectiveNavigationMode();
+    private get effectiveLayoutWidth();
+    private get effectiveCompact();
+    private getOwnedHeaderChildren;
+    private dispatchHeaderEvent;
+    private get hasBrandContent();
     /**
      * Observa mudanças na propriedade isCompact.
      * @param newValue O novo valor de isCompact.
@@ -177,6 +213,7 @@ export declare class Header {
      * O evento contém o ID do componente pai e o nome da lista.
      */
     private handleHeaderListUpdate;
+    private handleHeaderListFocused;
     private handleListResize;
     /**
      * Reinicializa o estado das listas do cabeçalho, disparando o evento de redimensionamento.
@@ -199,6 +236,7 @@ export declare class Header {
     private compactFromScroll;
     private headerResizeObserver?;
     private readonly headerResizeBatcher;
+    private emitHeaderWidthChange;
     private handleNavigation;
     /**
      * Manipula as mudanças de breakpoint.

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

@@ -1,14 +1,29 @@
 import type { IconFlip, IconRotate, IconSource } from './icon.types';
 /**
- * O componente `br-icon` fornece uma maneira flexível e dinâmica de incorporar ícones nas aplicações.
- * Ele aceita arquivos de imagem da aplicação por URL, SVG inline e conteúdo via slot.
- * Nomes Iconify por `iconName` continuam disponíveis somente para compatibilidade legada.
+ * O componente `br-icon` é o elemento oficial do GovBR-DS para renderização dinâmica e padronizada de ícones vetoriais. Ele suporta a família tipográfica Font Awesome e ícones utilitários do governo, garantindo contraste, escalabilidade e acessibilidade visual.
  *
- * Com opções para especificar a altura e largura, adicionar classes CSS personalizadas, e definir como o ícone
- * deve ser rotacionado ou espelhado, o `br-icon` oferece aos desenvolvedores as ferramentas necessárias para
- * integrar ícones de forma consistente com o estilo e design de suas aplicações, melhorando a experiência do usuário
- * e a clareza das interfaces.
+ * ### Para que serve
  *
+ * - **Comunicação visual imediata:** Fornece apoio gráfico rápido para ações em botões, links, cartões, menus e alertas contextuais.
+ * - **Acessibilidade nativa:** Gerencia automaticamente a visibilidade para leitores de tela: ícones decorativos recebem `aria-hidden="true"`, enquanto ícones informativos recebem nome acessível via `aria-label`.
+ * - **Flexibilidade dimensional e cromática:** Permite personalizar tamanho, cor através de tokens CSS do GovBR-DS, rotação e efeitos de espelhamento.
+ *
+ * ### Quando utilizar
+ *
+ * - **Utilize quando:**
+ *   - For necessário reforçar o significado de um texto ou ação com uma representação gráfica familiar.
+ *   - Criar controles compactos com ícone acompanhado de descrição acessível.
+ * - **Evite e prefira outro componente quando:**
+ *   - For necessária uma imagem fotográfica ou ilustração visual ampla com detalhes cromáticos complexos (prefira tags HTML `<img>` ou SVG ilustrativo).
+ *
+ * ### Estrutura e Slots
+ *
+ * O `br-icon` renderiza um elemento vetorial direto com base no atributo `name` informado ou através de classes utilitárias.
+ *
+ * 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/icon?tab=designer).
+ *
+
+
  * @category Identidade
  * @status stable
  * @slot - Conteúdo customizado do ícone. Pode receber elementos como `<i>`, `<svg>` ou componentes de outras bibliotecas.
@@ -17,6 +32,7 @@ import type { IconFlip, IconRotate, IconSource } from './icon.types';
  * @part image - Elemento img interno quando `src` é usado.
  * @part svg - Elemento interno que recebe SVG inline quando `svg` é usado.
  * @part slot - Elemento interno que recebe conteúdo via slot.
+ *
  */
 export declare class Icon {
     /**
@@ -27,12 +43,12 @@ export declare class Icon {
     /** Texto alternativo para ícones informativos. Sem label, o ícone é decorativo. */
     label?: string;
     /**
-     * Nome do ícone a ser exibido utilizando a biblioteca Iconify.
+     * 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.
      *
-     * @deprecated O Iconify não é mais a fonte prioritária. Use `src` com um asset
-     * controlado pela aplicação, `svg` ou o slot padrão.
+     * @deprecated Use `src` com um asset controlado pela aplicação, `svg` ou o slot padrão.
      */
-    /** @deprecated Use `src`, `svg` ou o slot padrão. */
     iconName?: string;
     /**
      * URL ou caminho local para um arquivo de imagem que será usado como ícone.
@@ -46,12 +62,20 @@ export declare class Icon {
      * Conteúdo SVG inline a ser renderizado como ícone.
      *
      * Use apenas SVGs confiáveis e sanitizados pela aplicação.
+     * Passe o conteúdo por property binding para evitar serialização no atributo.
+     *
+     * @example
+     * ```js
+     * const icon = document.querySelector('br-icon');
+     * icon.svg = '<svg viewBox="0 0 24 24" aria-hidden="true"><path d="M12 2 22 22H2Z" /></svg>';
+     * ```
      */
     svg?: string;
     /**
      * 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`.
      */
     source: IconSource;
     /**
@@ -80,25 +104,28 @@ export declare class Icon {
     /**
      * Exibe o rótulo e o controle na mesma linha.
      *
+     * @deprecated Use `inline`.
      */
-    /** @deprecated Use `inline`. */
     isInline?: boolean;
     /** Renderiza o ícone inline. Quando informada, tem precedência sobre `isInline`. */
     inline?: boolean;
     /**
      * Define o ângulo de rotação do ícone.
+     * Aceita `90deg`, `180deg` ou `270deg`; valores inválidos são ignorados.
      */
     rotate?: IconRotate;
     /**
      * Define o tipo de espelhamento do ícone.
+     * Aceita `horizontal` ou `vertical`; valores inválidos são ignorados.
      */
     flip?: IconFlip;
     /**
      * Determina se o ícone pode receber foco.
      * Se definido como verdadeiro, o ícone pode ser navegado usando Tab.
      * O valor padrão é `false`.
+     *
+     * @deprecated Use `focusable`.
      */
-    /** @deprecated Use `focusable`. */
     isFocusable?: boolean;
     /** Torna o ícone focável. Quando informada, tem precedência sobre `isFocusable`. */
     focusable?: boolean;
@@ -117,6 +144,9 @@ export declare class Icon {
      */
     lazy?: boolean;
     private hasDefaultSlot;
+    private get effectiveSource();
+    private get effectiveRotate();
+    private get effectiveFlip();
     private cachedSvgMarkup;
     private cachedSvgKey;
     private iconifyReady?;
@@ -143,6 +173,7 @@ export declare class Icon {
     private get mediaStyleSize();
     private get accessibilityAttributes();
     private updateDefaultSlot;
+    private renderCachedIcon;
     private renderIconifyIcon;
     private renderImageIcon;
     private renderSvgIcon;