@govbr-ds/webcomponents 2.4.0 → 2.5.0

package/dist/collection/components/link/link.js

@@ -6,30 +6,26 @@ import { Host, h } from "@stencil/core";
 import { handleNavigationClick } from "../../shared/utils/navigation";
 import { resolveAllowedPropValue } from "../../shared/utils/props";
 /**
- * O componente `br-link` é o controle oficial de hiperlink do GovBR-DS, projetado para orientar e conduzir a pessoa usuária em navegações internas entre páginas ou encaminhamentos para destinos externos.
+ * O `br-link` conduz a pessoa usuária a outra página, arquivo para download ou seção externa.
  *
- * ### Para que serve
+ * Coloque o texto ou ícone no slot padrão e aponte o destino em `href`. Para destinos externos ou abas novas, use `target="_blank"`. Para integração com roteadores de SPA, use `navigation-mode="event"` e ouça o evento `brNavigate`.
  *
- * - **Navegação estruturada:** Conduz o usuário para novas URLs, rotas de aplicação, âncoras dentro da mesma página ou arquivos para download.
- * - **Identificação de links externos:** Permite sinalizar visualmente que o link aponta para um domínio externo ou abre em nova aba/janela, adicionando os atributos de segurança e acessibilidade necessários (`target="_blank"`, `rel="noopener noreferrer"`).
- * - **Estilos inline e de bloco:** Adapta-se ao fluxo de leitura textual em parágrafos ou como elemento de navegação isolado com suporte a ícones.
+ * ```html
+ * <br-link href="/servicos">Serviços disponíveis</br-link>
+ * <br-link href="https://www.gov.br" target="_blank">Portal Gov.br</br-link>
+ * ```
  *
- * ### Quando utilizar
+ * ### Quando usar
  *
- * - **Utilize quando:**
- *   - A ação resultar na alteração da URL do navegador, navegação para outra página ou download de arquivo.
- * - **Evite e prefira outro componente quando:**
- *   - A ação disparar um comportamento na interface sem alterar a URL (como abrir modal, submeter formulário ou acionar filtro): prefira `br-button`.
+ * - Navegar para outra página, rota ou domínio.
+ * - Fazer download de arquivos ou saltar para âncoras na mesma página.
  *
- * ### Estrutura e Slots
+ * ### Quando evitar
  *
- * O `br-link` é um componente autônomo:
- * - `default`: Slot para o texto do link, ícones auxiliares ou elementos combinados.
+ * - Executar uma ação na página atual (salvar, abrir diálogo): use `br-button`.
  *
- * 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/link?tab=designer).
+ * Consulte as [diretrizes de design do GovBR](https://www.gov.br/ds/components/link?tab=designer).
  *
-
-
  * @category Navegação, Ações
  * @status stable
  * @slot default - Conteúdo do link (texto, ícones ou outros elementos).
@@ -69,17 +65,17 @@ export class Link {
          * Exibe o link com o mesmo visual do componente `br-button`.
          */
         this.button = false;
-        /** Valor canônico de `aria-expanded`. */
+        /** Valor de `aria-expanded`. */
         this.ariaExpanded = null;
-        /** Valor canônico de `aria-selected`. */
+        /** Valor de `aria-selected`. */
         this.ariaSelected = null;
-        /** Valor canônico de `aria-haspopup`. */
+        /** Valor de `aria-haspopup`. */
         this.ariaHasPopup = null;
-        /** Valor canônico de `aria-current`. */
+        /** Valor de `aria-current`. */
         this.ariaCurrent = null;
-        /** Valor canônico de `aria-label`. */
+        /** Valor de `aria-label`. */
         this.ariaLabel = null;
-        /** Valor canônico de `aria-describedby`. */
+        /** Valor de `aria-describedby`. */
         this.ariaDescribedBy = null;
         this.handleClick = (event) => {
             if (this.disabled) {
@@ -153,7 +149,7 @@ export class Link {
         }
     }
     render() {
-        return (h(Host, { key: '735d6e0d48cb55199a14f32c3d0d86c234e4cd61' }, h("a", { key: '54b489e59820264b3a5367af6195b6bd06e06712', part: "anchor", class: { 'br-button': this.button }, href: this.disabled ? undefined : this.href, target: this.effectiveTarget, rel: this.getRel(), download: this.download, hreflang: this.hreflang, referrerPolicy: this.referrerPolicy, type: this.type, "aria-disabled": this.disabled ? 'true' : null, onClick: this.handleClick, ...this.getAnchorAttrs() }, h("slot", { key: 'c1e47475dd6c47eba68bfe97ce77a08594d3800a' }))));
+        return (h(Host, { key: '3d629ad7a36367d8ca77e67c4510466bf48d9349' }, h("a", { key: '40e5e4490316e8508950cb4c58cd4546461bf12c', part: "anchor", class: { 'br-button': this.button }, href: this.disabled ? undefined : this.href, target: this.effectiveTarget, rel: this.getRel(), download: this.download, hreflang: this.hreflang, referrerPolicy: this.referrerPolicy, type: this.type, "aria-disabled": this.disabled ? 'true' : null, onClick: this.handleClick, ...this.getAnchorAttrs() }, h("slot", { key: 'e46377f568fff85bc2b578fee167efe2911971bd' }))));
     }
     static get is() { return "br-link"; }
     static get encapsulation() { return "shadow"; }
@@ -452,7 +448,7 @@ export class Link {
                 "optional": false,
                 "docs": {
                     "tags": [],
-                    "text": "Valor can\u00F4nico de `aria-expanded`."
+                    "text": "Valor de `aria-expanded`."
                 },
                 "getter": false,
                 "setter": false,
@@ -494,7 +490,7 @@ export class Link {
                 "optional": false,
                 "docs": {
                     "tags": [],
-                    "text": "Valor can\u00F4nico de `aria-selected`."
+                    "text": "Valor de `aria-selected`."
                 },
                 "getter": false,
                 "setter": false,
@@ -536,7 +532,7 @@ export class Link {
                 "optional": false,
                 "docs": {
                     "tags": [],
-                    "text": "Valor can\u00F4nico de `aria-haspopup`."
+                    "text": "Valor de `aria-haspopup`."
                 },
                 "getter": false,
                 "setter": false,
@@ -578,7 +574,7 @@ export class Link {
                 "optional": false,
                 "docs": {
                     "tags": [],
-                    "text": "Valor can\u00F4nico de `aria-current`."
+                    "text": "Valor de `aria-current`."
                 },
                 "getter": false,
                 "setter": false,
@@ -620,7 +616,7 @@ export class Link {
                 "optional": false,
                 "docs": {
                     "tags": [],
-                    "text": "Valor can\u00F4nico de `aria-label`."
+                    "text": "Valor de `aria-label`."
                 },
                 "getter": false,
                 "setter": false,
@@ -662,7 +658,7 @@ export class Link {
                 "optional": false,
                 "docs": {
                     "tags": [],
-                    "text": "Valor can\u00F4nico de `aria-describedby`."
+                    "text": "Valor de `aria-describedby`."
                 },
                 "getter": false,
                 "setter": false,

package/dist/collection/components/list/list.js

@@ -11,33 +11,29 @@ import { hasNamedLightDomSlot } from "../../shared/utils/slot";
 const LIST_ORIENTATIONS = ['horizontal', 'vertical'];
 const LIST_ROLES = ['list', 'group'];
 /**
- * O componente `br-list` é o contêiner estrutural do GovBR-DS desenvolvido para apresentar coleções verticais de itens homogêneos ou relacionados de forma organizada, fácil de percorrer visualmente e acessível.
+ * O `br-list` organiza coleções verticais de itens homogêneos ou relacionados, como listas de contatos, tarefas ou configurações.
  *
- * ### Para que serve
+ * Adicione os itens (como `br-item`) no slot padrão. Se precisar de um título ou ações no topo da lista, use o slot `header` ou a propriedade `title`.
  *
- * - **Apresentação sequencial de informações:** Organiza listagens de dados, tarefas, configurações, opções de navegação ou mensagens.
- * - **Cabeçalho e ações integradas:** Suporta cabeçalho contextual (`header`) para exibição de título da lista, contadores de itens ou botões de ação em lote.
- * - **Composição com itens padronizados:** Integra-se perfeitamente com elementos `br-item` e divisores `br-divider`, mantendo ritmo visual e alinhamento consistentes.
+ * ```html
+ * <br-list title="Configurações">
+ *   <br-item interactive>Notificações</br-item>
+ *   <br-item interactive>Segurança</br-item>
+ * </br-list>
+ * ```
  *
- * ### Quando utilizar
+ * ### Quando usar
  *
- * - **Utilize quando:**
- *   - Desejar exibir uma sequência vertical de itens que compartilham a mesma estrutura ou propósito.
- *   - O conteúdo favorecer leitura linear ou seleção de uma linha e precisar ser percorrido visualmente com rapidez.
- * - **Evite e prefira outro componente quando:**
- *   - As informações forem tabulares com múltiplas colunas e necessidade de ordenação por coluna (prefira `br-table`).
- *   - A lista representar o menu principal de navegação do sistema (prefira `br-menu`).
+ * - Sequências verticais de itens com leitura linear.
+ * - Listas de opções simples ou links agrupados.
  *
- * ### Estrutura e Slots
+ * ### Quando evitar
  *
- * O `br-list` atua como contêiner de itens:
- * - `header`: Slot opcional para cabeçalho da lista (título, filtros ou ações globais).
- * - `default`: Slot principal onde são inseridos os elementos filhos (como `br-item` ou divs semânticas).
+ * - Dados em linhas e colunas com ordenação: use `br-table`.
+ * - Menu lateral de navegação da página: use `br-menu`.
  *
- * 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/list?tab=designer).
+ * Consulte as [diretrizes de design do GovBR](https://www.gov.br/ds/components/list?tab=designer).
  *
-
-
  * @category Conteúdo, Layout
  * @status stable
  * @see br-item
@@ -555,7 +551,7 @@ export class List {
         return [this.renderHeader(), this.renderDivider(), h("slot", null)];
     }
     render() {
-        return (h(Host, { key: 'cc9de9b5db371139fd6e2ddbdb4007ba32a31942', role: this.effectiveListRole, "aria-label": this.header || null }, h("div", { key: 'ccfc7fbe6fc4342e8450d65fcaf9534a19ef38cd', class: this.getCssClassMap(), id: this.customId, part: "container" }, this.accordion || this.collapse ? (h("br-collapse", { "accordion-group": this.accordion || null, divider: this.divider }, this.renderListBody())) : (this.renderListBody()))));
+        return (h(Host, { key: 'ed998f239564afe0626531396c2810307afc017b', role: this.effectiveListRole, "aria-label": this.header || null }, h("div", { key: 'c1bb19969e4f58e87a73ba99906748127b44cb68', class: this.getCssClassMap(), id: this.customId, part: "container" }, this.accordion || this.collapse ? (h("br-collapse", { "accordion-group": this.accordion || null, divider: this.divider }, this.renderListBody())) : (this.renderListBody()))));
     }
     static get is() { return "br-list"; }
     static get encapsulation() { return "shadow"; }
@@ -626,7 +622,7 @@ export class List {
                 "optional": true,
                 "docs": {
                     "tags": [],
-                    "text": "Orienta\u00E7\u00E3o can\u00F4nica. Quando informada, tem preced\u00EAncia sobre `isHorizontal`; valores inv\u00E1lidos usam `vertical`."
+                    "text": "Orienta\u00E7\u00E3o padr\u00E3o. Quando informada, tem preced\u00EAncia sobre `isHorizontal`; valores inv\u00E1lidos usam `vertical`."
                 },
                 "getter": false,
                 "setter": false,

package/dist/collection/components/loading/loading.js

@@ -59,34 +59,27 @@ const LOADING_MODES = ['spinner', 'progress'];
 const LOADING_SPEEDS = ['slow', 'normal', 'fast'];
 const LOADING_COMPLETIONS = ['persist', 'reset', 'hide'];
 /**
- * O componente `br-loading` é o indicador de carregamento e progresso do GovBR-DS, utilizado para informar visualmente e de forma acessível que uma operação assíncrona está em execução no sistema.
+ * O `br-loading` indica visualmente que uma operação assíncrona está em andamento.
  *
- * ### Para que serve
+ * Suporta o modo circular padrão (indeterminado) ou o modo determinístico com barra e percentual via `progress`. Para adicionar uma mensagem explicativa, informe `label`.
  *
- * - **Feedback de processamento:** Alerta a pessoa usuária de que uma requisição, cálculo ou carregamento de dados está ocorrendo, evitando múltiplos cliques acidentais.
- * - **Modo spinner (indeterminado):** Indicador circular contínuo para operações de duração imprevisível.
- * - **Modo progress (determinado):** Indicador com percentual explícito (0 a 100%) para downloads, uploads ou tarefas com progresso mensurável, suportando ação de cancelamento.
- * - **Acessibilidade para tecnologias assistivas:** Comunica o estado de carregamento através de regiões acessíveis (`aria-live="polite"` e papéis `progressbar` ou `status`).
+ * ```html
+ * <br-loading label="Carregando dados..."></br-loading>
+ * <br-loading progress="60" label="Enviando arquivo..."></br-loading>
+ * ```
  *
- * ### Quando utilizar
+ * ### Quando usar
  *
- * - **Utilize quando:**
- *   - Uma operação assíncrona demorar mais de 300 a 500 milissegundos para responder.
- *   - Durante o envio de formulários volumosos, processamento de arquivos ou transição de telas pesadas.
- * - **Evite e prefira outro componente quando:**
- *   - A resposta for quase instantânea (menos de 300ms), para evitar piscamento rápido de tela que cause desconforto visual.
- *   - A espera ocorrer dentro de um botão durante o clique (use a prop `loading` do próprio `br-button`).
+ * - Operações que demoram mais de 300 ms (carregamento de dados, envio de formulário).
+ * - Downloads ou uploads com percentual de progresso mensurável.
  *
- * ### Estrutura e Slots
+ * ### Quando evitar
  *
- * O `br-loading` oferece slots para personalização:
- * - `label`: Slot para rótulo ou mensagem descritiva do carregamento (substitui a prop `label`).
- * - `cancel-button`: Slot para botão customizado de cancelamento no modo `progress`.
+ * - Operações instantâneas (menos de 300 ms).
+ * - Carregamento interno em botão: use a propriedade `loading` do `br-button`.
  *
- * 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/loading?tab=designer).
+ * Consulte as [diretrizes de design do GovBR](https://www.gov.br/ds/components/loading?tab=designer).
  *
-
-
  * @category Feedback, Progresso
  * @status stable
  * @slot label - Rótulo customizado do loading. Quando utilizado, a prop `label` é ignorada.
@@ -576,7 +569,7 @@ export class Loading {
      * @returns Estrutura JSX final.
      */
     render() {
-        return (h(Host, { key: 'aa70c7caa83b88743f6e6d4273921b12b85212ec' }, h("div", { key: 'a30e7880733355cccb1febe6391f194a01c8c9dc', class: this.getCssClassMap(), part: "container" }, this.effectiveMode === 'spinner' ? this.renderIndeterminate() : this.renderDeterminate())));
+        return (h(Host, { key: 'e4c9196da0b7f07f82d3f9302ee86fb611aa537a' }, h("div", { key: '9cb95ff4956953e0b8d969cc2aca2f6084520442', class: this.getCssClassMap(), part: "container" }, this.effectiveMode === 'spinner' ? this.renderIndeterminate() : this.renderDeterminate())));
     }
     static get is() { return "br-loading"; }
     static get encapsulation() { return "shadow"; }
@@ -724,7 +717,7 @@ export class Loading {
                 "optional": true,
                 "docs": {
                     "tags": [],
-                    "text": "Densidade visual can\u00F4nica. Quando informada, tem preced\u00EAncia sobre `size`.\nAceita `small`, `medium` ou `large`. Valores inv\u00E1lidos usam `medium`."
+                    "text": "Densidade visual. Quando informada, tem preced\u00EAncia sobre `size`.\nAceita `small`, `medium` ou `large`. Valores inv\u00E1lidos usam `medium`."
                 },
                 "getter": false,
                 "setter": false,
@@ -1064,7 +1057,7 @@ export class Loading {
                 "composed": true,
                 "docs": {
                     "tags": [],
-                    "text": "Evento can\u00F4nico emitido quando o loading \u00E9 exibido."
+                    "text": "Evento emitido quando o loading \u00E9 exibido."
                 },
                 "complexType": {
                     "original": "void",
@@ -1097,7 +1090,7 @@ export class Loading {
                 "composed": true,
                 "docs": {
                     "tags": [],
-                    "text": "Evento can\u00F4nico emitido quando o loading \u00E9 ocultado."
+                    "text": "Evento emitido quando o loading \u00E9 ocultado."
                 },
                 "complexType": {
                     "original": "void",

package/dist/collection/components/magic-button/magic-button.js

@@ -8,33 +8,26 @@ import { reportInvalidPropValue } from "../../shared/utils/prop-warning";
 import { resolveDensity } from "../../shared/utils/props";
 import { isIconClassList } from "../icon/icon.utils";
 /**
- * O componente `br-magic-button` é o botão de ação flutuante (Floating Action Button - FAB) do GovBR-DS, projetado para destacar a ação primária ou mais relevante da tela, mantendo-se acessível e visível durante a navegação.
+ * O `br-magic-button` é o botão de ação flutuante (FAB) que destaca a ação primária ou mais frequente da tela.
  *
- * ### Para que serve
+ * Pode ser exibido apenas com ícone (formato circular) ou expandido com texto descritivo.
  *
- * - **Destaque da ação principal:** Cria um ponto focal imediato para a ação central de uma tela (ex.: "Nova mensagem", "Criar solicitação", "Adicionar item").
- * - **Posicionamento persistente ou integrado:** Pode ser fixado em um canto da tela (em dispositivos móveis) ou posicionado no fluxo de leitura de painéis e tabelas.
- * - **Modos circular e expandido:** Suporta visual circular compacto com ícone ou versão expandida com texto explicativo.
+ * ```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>
+ * ```
  *
- * ### Quando utilizar
+ * ### Quando usar
  *
- * - **Utilize quando:**
- *   - Houver uma única ação dominante que represente o principal objetivo da pessoa usuária naquela tela.
- *   - Em aplicações móveis ou responsivas que necessitem de um atalho de fácil alcance para os polegares.
- * - **Evite e prefira outro componente quando:**
- *   - Houver múltiplas ações de importância equivalente (prefira uma barra de botões com `br-button`).
- *   - A ação for secundária, destrutiva ou de cancelamento.
+ * - Ação principal e dominante da tela em dispositivos móveis ou interfaces focadas em uma tarefa única.
  *
- * ### Estrutura e Slots
+ * ### Quando evitar
  *
- * O `br-magic-button` é um controle direto:
- * - `default`: Slot para rótulo de texto ou conteúdo interno do botão.
- * - `icon`: Slot para personalização do ícone de ação (como `br-icon`).
+ * - Múltiplas ações de mesma importância: use `br-button`.
+ * - Ações secundárias ou destrutivas.
  *
- * 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/magic-button?tab=designer).
+ * Consulte as [diretrizes de design do GovBR](https://www.gov.br/ds/components/magic-button?tab=designer).
  *
-
-
  * @category Ações
  * @status stable
  * @slot default - Conteúdo interno do botão (texto ou ícone).
@@ -144,7 +137,7 @@ export class MagicButton {
      */
     render() {
         const effectiveAriaLabel = this.ariaLabel || this.label || (this.icon ? `Botão com ícone ${this.icon}` : 'Botão');
-        return (h(Host, { key: '0e7b5bd88a96e5a44ceceae05bad6aa543fdf51f', id: this.customId }, h("div", { key: 'c3c6ade2e79cb51d307ea3c239c1b3937fa2590b', class: this.getCssClassMap(), part: "container" }, h("button", { key: 'd6cde1c5337049987892417270a07293b4aa32a3', class: { 'br-button': true, ...this.getCircleClass() }, type: "button", "aria-label": effectiveAriaLabel, part: "button" }, h("slot", { key: '805e6d6fe57c0378b9a26a93a90e70a2eedee8d7', name: "icon" }, this.renderIconFallback()), this.label || h("slot", { key: '43572cc0e0cfce4d8a4a7cfaedb920d4d4e8c63e' })))));
+        return (h(Host, { key: 'd2a8fe42c2871c7feaae91ffe60a99ec9a138d68', id: this.customId }, h("div", { key: '13bb6f25739caa0f919ba9da4b4b1e5cdd23e04d', class: this.getCssClassMap(), part: "container" }, h("button", { key: '8acc5cd9a021c12279f023c7feaae7d3076d59f9', class: { 'br-button': true, ...this.getCircleClass() }, type: "button", "aria-label": effectiveAriaLabel, part: "button" }, h("slot", { key: 'b258430fe39e6285eef0b4f69ccc9c029173f6e1', name: "icon" }, this.renderIconFallback()), this.label || h("slot", { key: '33e2eac372b497b22b5fdd2cf71d86e997b5fc7f' })))));
     }
     static get is() { return "br-magic-button"; }
     static get encapsulation() { return "shadow"; }

package/dist/collection/components/menu/menu-group/menu-group.js

@@ -4,23 +4,10 @@
  */
 import { Host, h } from "@stencil/core";
 /**
- * O componente `br-menu-group` é o subcomponente do GovBR-DS que divide os itens de navegação em blocos ou agrupamentos temáticos com subtítulos.
+ * Agrupa itens de menu sob um título ou categoria comum. Use dentro do `br-menu`.
  *
- * ### Para que serve
+ * Defina o título do grupo pelo slot `label` ou pela propriedade `label`. Insira a lista de itens (`br-menu-list`) no slot padrão.
  *
- * - **Segmentação visual:** Separa blocos de links afins para facilitar a leitura.
- * - **Hierarquia clara:** Estabelece grupos com rótulos descritivos.
- *
- * ### Papel na composição
- *
- * Atua como agrupador intermediário dentro do corpo do `br-menu`.
- *
- * ### Regra de uso e relacionamento
- *
- * - Deve ser utilizado no interior do componente `br-menu`.
- * - Contém instâncias de `br-menu-list` ou `br-menu-item`.
- *
-
  * @slot default - Itens do grupo.
  * @part container - Contêiner do agrupamento.
  * @part label - Rótulo visual do agrupamento.
@@ -42,7 +29,7 @@ export class MenuGroup {
         return false;
     }
     render() {
-        return (h(Host, { key: 'c8844c98c7690a850daa04b5b2df6f9d76042015', role: "group", "aria-label": this.label || null }, h("div", { key: 'f9239193980be462cb16ab1ccfab7358b0d2d18e', class: { container: true, divider: this.divider }, part: "container" }, this.label ? h("div", { part: "label" }, this.label) : null, h("div", { key: '5ed7cab819cf09a6052e2e7c3d6c79bb404a9d2d', part: "list" }, h("slot", { key: 'a929ebfb9cacd5445db4a72b77fb1e40ccf818ab' })))));
+        return (h(Host, { key: '9f3fe61013ba20ff1442284ec00ab2f7779b6c67', role: "group", "aria-label": this.label || null }, h("div", { key: '531b3a6e4b5ae006b2c84a1fbd6f0bac013b5932', class: { container: true, divider: this.divider }, part: "container" }, this.label ? h("div", { part: "label" }, this.label) : null, h("div", { key: 'f3249d995f57c4a29237764cd043b923427e9fec', part: "list" }, h("slot", { key: '8df9ce387a0459244125d0e04790d3da9c503101' })))));
     }
     static get is() { return "br-menu-group"; }
     static get encapsulation() { return "shadow"; }

package/dist/collection/components/menu/menu-header/menu-header.js

@@ -5,23 +5,10 @@
 import { Host, h } from "@stencil/core";
 import { generateUniqueId } from "../../../shared/utils/id";
 /**
- * O componente `br-menu-header` é o subcomponente do GovBR-DS que fornece o cabeçalho superior do menu lateral, contendo o título da área e o botão de fechamento.
+ * Cabeçalho do menu lateral com título e botão de fechar. Use no slot `header` do `br-menu`.
  *
- * ### Para que serve
+ * Defina o título da área em `title-text`. O botão de fechar emite o fechamento para o `br-menu` pai.
  *
- * - **Identificação da navegação:** Exibe o título do menu ou seção atual.
- * - **Controle de fechamento:** Fornece o botão de fechar acessível que recolhe o menu.
- *
- * ### Papel na composição
- *
- * Atua como cabeçalho funcional e acessível no topo do `br-menu`.
- *
- * ### Regra de uso e relacionamento
- *
- * - Deve ser posicionado no início do orquestrador `br-menu`.
- * - Dispara a ação de fechamento gerenciada pelo componente pai.
- *
-
  * @slot logo - Slot para logo personalizado no cabeçalho.
  * @slot signature - Slot para a assinatura personalizada do sistema.
  *
@@ -58,7 +45,7 @@ export class MenuHeader {
         };
     }
     render() {
-        return (h(Host, { key: 'c987185807ad6fe6255fbd21a9b590aa5d4a3802' }, h("div", { key: '4e0b242dd4fd8691c5370db6fe31da4e91613f08', class: this.getCssClassMap(), part: "container" }, h("div", { key: '5f2532a98c079159474654adac94a87576851801', class: "menu-title", part: "title" }, h("slot", { key: 'db73561d08525f4ba5ef90dfffa268e4a665eb73', name: "logo" }, this.logoSrc && h("img", { key: '588714f2574f2758e2633aa4018ff82acbe39e7f', src: this.logoSrc, alt: this.logoAlt, part: "logo" })), h("slot", { key: 'd9099d9ecd5a4b8a3a9e8a8afcaf9298ccc37934', name: "signature" }, this.signature && h("span", { key: '9b9e24eadc1da501c50989e06e17745f541bb3ff', part: "signature" }, this.signature))), h("div", { key: 'ead5671c0d19831971c5f2de0cd5356ddaa9042a', class: "menu-close", part: "close" }, h("br-button", { key: '34cc3e6f2ecf7d79674b149697ddbf4a5b42d230', "prop:ariaLabel": "Fechar o menu", shape: "circle", onClick: this.handleCloseClick, "data-dismiss": "menu" }, h("br-icon", { key: '696a6910348bd4a21abadac95f4d1157341bb570', iconName: "fa6-solid:xmark", width: "16", height: "16" }))))));
+        return (h(Host, { key: '915009c3021237bbf165e141449285451419757b' }, h("div", { key: 'b768d67ba1f3298d2cc1f2f4ef53b54bf934d3a3', class: this.getCssClassMap(), part: "container" }, h("div", { key: 'f75fad5f65fa3afe6edbbc8d57026fcefa027689', class: "menu-title", part: "title" }, h("slot", { key: 'fba1e60e85ed764b25d6e9dfea38e2be035d5618', name: "logo" }, this.logoSrc && h("img", { key: '4ae018becdfff7d95895cb51f41755c963788331', src: this.logoSrc, alt: this.logoAlt, part: "logo" })), h("slot", { key: 'dbc7c7f4ce255dabc716d21be95ed413665e9752', name: "signature" }, this.signature && h("span", { key: '74a6b177a2547adbfe8ef3e6812e84d1c71a0aa3', part: "signature" }, this.signature))), h("div", { key: '24ece513f0a2c95a06a8a5628b16c7c1faba76be', class: "menu-close", part: "close" }, h("br-button", { key: 'b40a57c40d8b78e77641ab1dd74c93a4a9b0edf0', "prop:ariaLabel": "Fechar o menu", shape: "circle", onClick: this.handleCloseClick, "data-dismiss": "menu" }, h("br-icon", { key: '9183bbdb3f34db21dd4912eb3c5bfcc1bb2723c0', iconName: "fa6-solid:xmark", width: "16", height: "16" }))))));
     }
     static get is() { return "br-menu-header"; }
     static get encapsulation() { return "shadow"; }

package/dist/collection/components/menu/menu-info/menu-info.js

@@ -5,21 +5,8 @@
 import { Host, h } from "@stencil/core";
 import { generateUniqueId } from "../../../shared/utils/id";
 /**
- * O componente `br-menu-info` é o subcomponente do GovBR-DS destinado a exibir textos informativos, versão do sistema, status da aplicação ou informações de usuário no menu.
+ * Exibe informações de apoio (versão do sistema, dados do usuário ou licença) no menu. Use no slot `info` ou no rodapé do `br-menu`.
  *
- * ### Para que serve
- *
- * - **Informações contextuais:** Apresenta dados de apoio ao usuário sem poluir o fluxo de links.
- *
- * ### Papel na composição
- *
- * Atua como área informativa complementar no menu.
- *
- * ### Regra de uso e relacionamento
- *
- * - Posiciona-se geralmente no rodapé ou na área superior do `br-menu`.
- *
-
  * @slot default - Slot para conteúdo personalizado no lugar do texto padrão de informações.
  */
 export class MenuInfo {
@@ -41,7 +28,7 @@ export class MenuInfo {
         this.hasSlotContent = this.el.innerHTML.trim() !== '';
     }
     render() {
-        return (h(Host, { key: '1d0b3382a38af37024cfc75973cb9fe8632e1c6b' }, h("slot", { key: '6c9581e8edda33b566199e900f89accb44dec161' }, !this.hasSlotContent && this.info && h("div", { key: '2b3995fe084d4c112bcc4df939cca901b2c3b44d', class: "text-center text-down-01" }, this.info))));
+        return (h(Host, { key: 'd0f104a77c18a9deb7e02bef221a65494ddc845e' }, h("slot", { key: '5665a0e17a58786c71aae62b877828334e430194' }, !this.hasSlotContent && this.info && h("div", { key: '12cb60aa0640598bc15a2ea2edf41bc1140cd05c', class: "text-center text-down-01" }, this.info))));
     }
     static get is() { return "br-menu-info"; }
     static get encapsulation() { return "shadow"; }

package/dist/collection/components/menu/menu-item/menu-item.js

@@ -5,23 +5,10 @@
 import { Host, h } from "@stencil/core";
 import { resolveAllowedPropValue } from "../../../shared/utils/props";
 /**
- * O componente `br-menu-item` é o subcomponente interativo do GovBR-DS que representa uma opção de navegação ou gatilho para submenu na árvore de menu.
+ * Representa uma linha de navegação ou botão de submenu dentro do `br-menu-list`.
  *
- * ### Para que serve
+ * Coloque um `br-menu-link` ou texto no slot padrão. Para submenus multiníveis, adicione a lista filha no interior do item.
  *
- * - **Opção de rota ou submenu:** Funciona como link direto para uma página ou como nó que abre um próximo nível hierárquico.
- * - **Estados visuais de navegação:** Reflete estados ativo, focado, hover e selecionado.
- *
- * ### Papel na composição
- *
- * Atua como item interativo central da navegação.
- *
- * ### Regra de uso e relacionamento
- *
- * - Deve ser utilizado exclusivamente dentro de um `br-menu-list`.
- * - Quando contiver subníveis, comunica-se com o orquestrador `br-menu` para ativar a transição entre telas.
- *
-
  * @slot default - Conteúdo textual principal exibido no item de menu.
  * @slot icon - Ícone personalizado. Quando preenchido, substitui o ícone definido por `icon`.
  *
@@ -110,7 +97,7 @@ export class MenuItem {
         const ariaExpanded = isExpandable ? String(this.expanded) : undefined;
         const ariaHaspopup = isExpandable ? 'true' : undefined;
         const targetAttr = !isExpandable ? this.effectiveTarget : undefined;
-        return (h(Host, { key: '94565a1e30513c6efb52e814c69f70becdba8b89' }, h("br-link", { key: 'd64c192e16f9469641cff2e77fc697870f4ed9c3', class: classes, href: this.href, target: targetAttr, navigationMode: this.effectiveNavigationMode, linkAriaLabel: this.el.textContent?.trim() || undefined, linkAriaCurrent: this.active ? 'page' : undefined, linkAriaExpanded: ariaExpanded, linkAriaHaspopup: ariaHaspopup, exportparts: "anchor: link" }, (this.icon || this.hasIconSlot) && (h("span", { key: '1a9879d94043441f9da5df3c3f843594daa1bd15', class: "icon", part: "icon" }, h("slot", { key: '4a354fc33e02b1094a90aeb908bc882625f35a58', name: "icon" }, this.icon && (h("br-icon", { key: '59c648cb6fb7cf1de9eb1c0e645f70277127aa67', iconName: `fa6-solid:${this.icon}`, width: "16", height: "16", "aria-hidden": "true" }))))), h("span", { key: '57b0a71a2bb7501247e338ea606f2e1c74ebf6ea', class: "content", part: "content" }, h("slot", { key: '10ee72f0cd4656c3dce6159b76eab7eadd26d0d6' })), this.effectiveDisplayMode === 'accordion' && (h("span", { key: '882340ff3227a0cffe7872bb6c9c4c79986d797a', class: { support: true, expanded: this.expanded }, part: "support" }, h("br-icon", { key: '5bab399f0d6276b212340df8c635492dc9d3adb9', iconName: `fa6-solid:${this.expanded ? 'chevron-up' : 'chevron-down'}`, width: "16", height: "16", "aria-hidden": "true" }))), this.effectiveDisplayMode === 'drill-down' && (h("span", { key: '41baa1429c8e10daf939c12b1fdd2ef7eaf702ff', class: "support", part: "support" }, h("br-icon", { key: '51af450f467b473aae0676222a85f68d59791b42', iconName: `fa6-solid:angle-right`, width: "12", height: "12", "aria-hidden": "true" }))))));
+        return (h(Host, { key: '20a267bb7b94f032f8496da4efdc8662001d4f63' }, h("br-link", { key: 'd1fb268162cc7c17b5576a1659885cdfd466bf09', class: classes, href: this.href, target: targetAttr, navigationMode: this.effectiveNavigationMode, linkAriaLabel: this.el.textContent?.trim() || undefined, linkAriaCurrent: this.active ? 'page' : undefined, linkAriaExpanded: ariaExpanded, linkAriaHaspopup: ariaHaspopup, exportparts: "anchor: link" }, (this.icon || this.hasIconSlot) && (h("span", { key: 'bc3e692c49b192db7e39b5c8ff524b7f4f3cabcd', class: "icon", part: "icon" }, h("slot", { key: 'f393ba22dbbbc0f783a8c4030ec5633e1a4dc9cb', name: "icon" }, this.icon && (h("br-icon", { key: '29192f57ef4f759bc9eb4bb110e8f3f70ee72cd8', iconName: `fa6-solid:${this.icon}`, width: "16", height: "16", "aria-hidden": "true" }))))), h("span", { key: 'a140d1202805cb64e154fae1ad6be03a9b7a4b0d', class: "content", part: "content" }, h("slot", { key: 'edcd05451fc2ab0173b787bf9d7f124751dc9596' })), this.effectiveDisplayMode === 'accordion' && (h("span", { key: '63c80b3f1f3c4557e0bc248ab2c261a931f8a43c', class: { support: true, expanded: this.expanded }, part: "support" }, h("br-icon", { key: 'f43317e800dccec52bf533e2d94dd5bc4d7d4c60', iconName: `fa6-solid:${this.expanded ? 'chevron-up' : 'chevron-down'}`, width: "16", height: "16", "aria-hidden": "true" }))), this.effectiveDisplayMode === 'drill-down' && (h("span", { key: '5fd78743721e54b9bac1a5e3cea9d189d4c80fd7', class: "support", part: "support" }, h("br-icon", { key: '4595680e003046d3a6dfc07a9c79ae7fbcdd5825', iconName: `fa6-solid:angle-right`, width: "12", height: "12", "aria-hidden": "true" }))))));
     }
     static get is() { return "br-menu-item"; }
     static get encapsulation() { return "shadow"; }

package/dist/collection/components/menu/menu-link/menu-link.js

@@ -7,22 +7,10 @@ import { generateUniqueId } from "../../../shared/utils/id";
 import { handleNavigationClick } from "../../../shared/utils/navigation";
 import { resolveAllowedPropValue } from "../../../shared/utils/props";
 /**
- * O componente `br-menu-link` é o subcomponente do GovBR-DS que renderiza um hiperlink textual acessível dentro da estrutura de menu.
+ * Hiperlink de navegação dentro do `br-menu`. Use dentro de um `br-menu-item` ou no rodapé do menu.
  *
- * ### Para que serve
+ * Aponte o destino em `href`. Para destinos externos, use `target="_blank"`.
  *
- * - **Navegação direta:** Oferece link textual para destinos internos ou externos.
- * - **Estilo GovBR-DS:** Aplica a tipografia e cores padronizadas de links de menu.
- *
- * ### Papel na composição
- *
- * Atua como elemento folha de navegação.
- *
- * ### Regra de uso e relacionamento
- *
- * - Utilizado dentro de `br-menu-item` ou seções de apoio do `br-menu`.
- *
-
  * @slot icon - Slot para ícone personalizado do link.
  * @slot url - Slot para o texto exibido no link.
  *
@@ -66,7 +54,7 @@ export class MenuLink {
         return resolveAllowedPropValue(this.el, 'navigationMode', this.navigationMode, ['native', 'event'], 'native');
     }
     render() {
-        return (h(Host, { key: 'd22e6fb85cd335aecccbe47c331eb55fc91ac641' }, h("a", { key: '5fff97b8f3072e96e33371da1495ce06488a9db3', href: this.href, target: this.effectiveTarget, rel: this.effectiveTarget === '_blank' ? 'noopener noreferrer' : undefined, onClick: this.handleClick, part: "link" }, h("slot", { key: 'b58db04d4a8b896fc2702885ac20628970662ab6', name: "url" }, h("span", { key: 'f9a3ce202252b568fa72ec0ce1745bb6a85cde3d', class: "mr-1" }, this.label ?? this.titulo)), h("slot", { key: 'cd5d66b6d7b67ef23d7106f7ff562ed5fb85b598', name: "icon" }, h("br-icon", { key: 'affe1cf0a726242c73e37ac9cf0abb3f63c1464e', iconName: "fa6-solid:square-arrow-up-right", width: "12", height: "12", "aria-hidden": "true" })))));
+        return (h(Host, { key: '080823eb820c178ef741e5194e19104f09d6340a' }, h("a", { key: '09ee356f5bfd1465f60bb0c472f9a873469f399b', href: this.href, target: this.effectiveTarget, rel: this.effectiveTarget === '_blank' ? 'noopener noreferrer' : undefined, onClick: this.handleClick, part: "link" }, h("slot", { key: '2ff83b8af9dc5e0f555f7b040a8973399de6ecb1', name: "url" }, h("span", { key: 'c227d219c459d2d3eec4c51de4e5af767149c8be', class: "mr-1" }, this.label ?? this.titulo)), h("slot", { key: '88d29ed66f58de042a752e0d49c2154d00f1adff', name: "icon" }, h("br-icon", { key: '202ebc854cab0e9360da89c2559bc94547f89982', iconName: "fa6-solid:square-arrow-up-right", width: "12", height: "12", "aria-hidden": "true" })))));
     }
     static get is() { return "br-menu-link"; }
     static get encapsulation() { return "shadow"; }
@@ -210,7 +198,7 @@ export class MenuLink {
                 "optional": true,
                 "docs": {
                     "tags": [],
-                    "text": "Texto can\u00F4nico do link. Quando informado, tem preced\u00EAncia sobre `titulo`."
+                    "text": "Texto do link. Quando informado, tem preced\u00EAncia sobre `titulo`."
                 },
                 "getter": false,
                 "setter": false,
@@ -246,7 +234,7 @@ export class MenuLink {
                 "composed": true,
                 "docs": {
                     "tags": [],
-                    "text": "Evento can\u00F4nico emitido quando o link externo \u00E9 clicado."
+                    "text": "Evento emitido quando o link externo \u00E9 clicado."
                 },
                 "complexType": {
                     "original": "void",

package/dist/collection/components/menu/menu-list/menu-list.js

@@ -4,23 +4,10 @@
  */
 import { h, } from "@stencil/core";
 /**
- * O componente `br-menu-list` é o subcomponente do GovBR-DS que fornece a estrutura semântica de lista de navegação para acomodar os itens interativos do menu.
+ * Lista de itens de navegação dentro do `br-menu` ou `br-menu-group`.
  *
- * ### Para que serve
+ * Insira os elementos `br-menu-item` no slot padrão para compor a lista navegável.
  *
- * - **Semântica de lista:** Garante marcação acessível (`<ul>`) para tecnologias assistivas.
- * - **Alinhamento e ordenação:** Organiza os itens verticalmente com espaçamentos padronizados.
- *
- * ### Papel na composição
- *
- * Atua como contêiner semântico de itens dentro de `br-menu` ou `br-menu-group`.
- *
- * ### Regra de uso e relacionamento
- *
- * - Deve ser inserido no interior de `br-menu` ou `br-menu-group`.
- * - Acomoda múltiplos subcomponentes `br-menu-item`.
- *
-
  * @slot default - Itens filhos renderizados no conteúdo do grupo.
  * @slot icon - Ícone personalizado do item principal. Quando preenchido, substitui `icon`.
  *

package/dist/collection/components/menu/menu-logo/menu-logo.js

@@ -5,21 +5,8 @@
 import { Host, h } from "@stencil/core";
 import { generateUniqueId } from "../../../shared/utils/id";
 /**
- * O componente `br-menu-logo` é o subcomponente do GovBR-DS que renderiza a logomarca do sistema ou do Governo Federal no menu lateral.
+ * Exibe o logotipo institucional no interior do `br-menu`. Use no cabeçalho ou rodapé do menu.
  *
- * ### Para que serve
- *
- * - **Identidade no menu:** Reforça a marca da aplicação na navegação lateral móvel ou desktop.
- *
- * ### Papel na composição
- *
- * Atua como identificador visual institucional no menu.
- *
- * ### Regra de uso e relacionamento
- *
- * - Posiciona-se preferencialmente no topo ou no cabeçalho do `br-menu`.
- *
-
  * @slot default - Slot para logo ou conteúdo que substitui a imagem padrão.
  * @event brMenuLogoError - Emitido quando a imagem principal e o fallback falham.
  *
@@ -75,7 +62,7 @@ export class MenuLogo {
             width: this.width,
             height: this.height,
         };
-        return (h(Host, { key: 'ce155d53702095dd7883c66333084a872dcc9a17' }, h("div", { key: 'ec5e2e3e500f0cdcd8819e4e27dc62bff1bc5945', class: "br-menu-logo", id: this.customId, part: "container" }, h("slot", { key: 'efe04cfffe4e5f354763c3cf3096944278eab307' }, this.src && (h("img", { key: '9af3c94e050e93dd7f7eedf26c1536c72f209684', src: this.currentSrc || this.src, alt: this.alt || 'Logo', style: imageStyle, onError: this.handleError, onLoad: this.handleLoad }))))));
+        return (h(Host, { key: '4a4d91a97ed9f32863df25fe8a5ee5f6e6b8ad00' }, h("div", { key: '53f6193800f1b693c6edd01b2faac6135fd444cb', class: "br-menu-logo", id: this.customId, part: "container" }, h("slot", { key: 'efadae98d7d023e6ddd5ff61953b1d825ba25b8a' }, this.src && (h("img", { key: 'fb66a0c08576f4046d8eaa1d8ecd732a83df9df8', src: this.currentSrc || this.src, alt: this.alt || 'Logo', style: imageStyle, onError: this.handleError, onLoad: this.handleLoad }))))));
     }
     static get is() { return "br-menu-logo"; }
     static get encapsulation() { return "shadow"; }