@govbr-ds/webcomponents 2.0.0-next.63 → 2.0.0-next.65

package/dist/custom-elements.json

@@ -640,19 +640,38 @@
     },
     {
       "kind": "javascript-module",
-      "path": "components/breadcrumb.js",
+      "path": "components/card.js",
       "declarations": [
         {
           "kind": "class",
-          "description": "## Design System\n\nPara a documentação completa de design, incluindo diretrizes de uso, acessibilidade e exemplos visuais, consulte o [Design System do GovBR](https://www.gov.br/ds/components/breadcrumb?tab=designer).",
-          "name": "Breadcrumb",
+          "description": "## Design System\n\nPara a documentação completa de design, incluindo diretrizes de uso, acessibilidade e exemplos visuais, consulte o [Design System do GovBR](https://www.gov.br/ds/components/card?tab=designer).",
+          "name": "BrCard",
+          "slots": [
+            {
+              "description": "Slot para conteúdo livre do card, quando não usar a estrutura de slots nomeados.",
+              "name": "default"
+            },
+            {
+              "description": "Slot para o conteúdo do cabeçalho do card.",
+              "name": "header"
+            },
+            {
+              "description": "Slot para o corpo principal do card ao usar a estrutura de slots.",
+              "name": "content"
+            },
+            {
+              "description": "Slot para o conteúdo do rodapé do card.",
+              "name": "footer"
+            }
+          ],
           "members": [
             {
               "kind": "field",
               "name": "el",
               "type": {
-                "text": "HTMLBrBreadcrumbElement"
-              }
+                "text": "HTMLBrCardElement"
+              },
+              "description": "Referência ao elemento host do componente.\nUtilize esta propriedade para acessar e manipular o elemento do DOM associado ao componente."
             },
             {
               "kind": "field",
@@ -670,6 +689,178 @@
               "readonly": true,
               "description": "Identificador único; gerado automaticamente quando omitido."
             },
+            {
+              "kind": "field",
+              "name": "disabled",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Define se o card está desabilitado.\nQuando true, o card fica com opacidade reduzida e não responde a interações."
+            },
+            {
+              "kind": "field",
+              "name": "hover",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Define se o card tem hover interativo.\nQuando true, o card terá efeitos visuais ao passar o mouse."
+            },
+            {
+              "kind": "field",
+              "name": "hasHeader",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "default": "false"
+            },
+            {
+              "kind": "field",
+              "name": "hasContent",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "default": "false"
+            },
+            {
+              "kind": "field",
+              "name": "hasFooter",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "default": "false"
+            },
+            {
+              "kind": "method",
+              "name": "checkSlots",
+              "privacy": "private"
+            },
+            {
+              "kind": "method",
+              "name": "getCssClassMap",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "CssClassMap"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "getHeaderClassMap",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "CssClassMap"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "getContentClassMap",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "CssClassMap"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "getFooterClassMap",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "CssClassMap"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "render"
+            }
+          ],
+          "attributes": [
+            {
+              "name": "custom-id",
+              "fieldName": "customId",
+              "description": "Identificador único; gerado automaticamente quando omitido.",
+              "type": {
+                "text": "string"
+              }
+            },
+            {
+              "name": "disabled",
+              "fieldName": "disabled",
+              "default": "false",
+              "description": "Define se o card está desabilitado.\nQuando true, o card fica com opacidade reduzida e não responde a interações.",
+              "type": {
+                "text": "boolean"
+              }
+            },
+            {
+              "name": "hover",
+              "fieldName": "hover",
+              "default": "false",
+              "description": "Define se o card tem hover interativo.\nQuando true, o card terá efeitos visuais ao passar o mouse.",
+              "type": {
+                "text": "boolean"
+              }
+            }
+          ],
+          "tagName": "br-card",
+          "events": [],
+          "customElement": true
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "BrCard",
+          "declaration": {
+            "name": "BrCard",
+            "module": "components/card.js"
+          }
+        },
+        {
+          "kind": "custom-element-definition",
+          "name": "br-card",
+          "declaration": {
+            "name": "BrCard",
+            "module": "components/card.js"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "components/breadcrumb.js",
+      "declarations": [
+        {
+          "kind": "class",
+          "description": "## Design System\n\nPara a documentação completa de design, incluindo diretrizes de uso, acessibilidade e exemplos visuais, consulte o [Design System do GovBR](https://www.gov.br/ds/components/breadcrumb?tab=designer).",
+          "name": "Breadcrumb",
+          "members": [
+            {
+              "kind": "field",
+              "name": "el",
+              "type": {
+                "text": "HTMLBrBreadcrumbElement"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "customId",
+              "type": {
+                "text": "string"
+              },
+              "readonly": true,
+              "description": "Identificador único; gerado automaticamente quando omitido."
+            },
             {
               "kind": "field",
               "name": "homeUrl",
@@ -687,6 +878,59 @@
               },
               "description": "Define o array de objetos que receberá os nomes e links do breadcrumb.\nDefine valor padrão do breadcrumb 'defaultCrumbs'."
             },
+            {
+              "kind": "field",
+              "name": "innerCrumbs",
+              "type": {
+                "text": "BreadcrumbItem[]"
+              },
+              "default": "[]"
+            },
+            {
+              "kind": "field",
+              "name": "slotElement",
+              "type": {
+                "text": "HTMLSlotElement"
+              },
+              "privacy": "private"
+            },
+            {
+              "kind": "field",
+              "name": "hasLoaded",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "default": "false"
+            },
+            {
+              "kind": "method",
+              "name": "handleCrumbPropsChange"
+            },
+            {
+              "kind": "method",
+              "name": "normalizeTarget",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "BreadcrumbTarget | undefined"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "target",
+                  "optional": true,
+                  "type": {
+                    "text": "string | null"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "field",
+              "name": "registerCrumbItems",
+              "privacy": "private"
+            },
             {
               "kind": "field",
               "name": "defaultCrumbs",
@@ -707,21 +951,44 @@
             },
             {
               "kind": "field",
-              "name": "tooltipPosition",
+              "name": "tooltipText",
               "type": {
-                "text": "{ x: number; y: number }"
+                "text": "string"
               },
-              "default": "{ x: 0, y: 0 }",
+              "default": "''",
               "description": "Define o posicionamento do tooltip na tela."
             },
             {
               "kind": "field",
-              "name": "tooltipText",
+              "name": "floatingManager",
               "type": {
-                "text": "string"
+                "text": "FloatingUIManager | undefined"
               },
-              "default": "''",
-              "description": "Define o texto do tooltip."
+              "privacy": "private"
+            },
+            {
+              "kind": "field",
+              "name": "hoveredElement",
+              "type": {
+                "text": "HTMLElement | undefined"
+              },
+              "privacy": "private"
+            },
+            {
+              "kind": "field",
+              "name": "tooltipElement",
+              "type": {
+                "text": "HTMLDivElement | undefined"
+              },
+              "privacy": "private"
+            },
+            {
+              "kind": "field",
+              "name": "tooltipArrowElement",
+              "type": {
+                "text": "HTMLDivElement | undefined"
+              },
+              "privacy": "private"
             },
             {
               "kind": "field",
@@ -743,7 +1010,7 @@
             },
             {
               "kind": "field",
-              "name": "larguraInterna",
+              "name": "contentWidth",
               "type": {
                 "text": "number"
               },
@@ -752,7 +1019,7 @@
             },
             {
               "kind": "field",
-              "name": "larguraPai",
+              "name": "parentWidth",
               "type": {
                 "text": "number"
               },
@@ -770,7 +1037,7 @@
             },
             {
               "kind": "method",
-              "name": "trunc",
+              "name": "truncateText",
               "privacy": "private",
               "parameters": [
                 {
@@ -780,7 +1047,20 @@
                   }
                 }
               ],
-              "description": "Verifica se o texto do link contém mais de 20 caracteres e realiza o truncamento deste caso positivo.\nO número de caracteres pode ser configurado na variável 'charactersNumberTruncate'."
+              "description": "Verifica se o texto do link contém mais de 20 caracteres e realiza o truncamento deste caso positivo.\nO número de caracteres pode ser configurado na variável 'truncateCharactersLimit'."
+            },
+            {
+              "kind": "method",
+              "name": "isTruncatedLabel",
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "text",
+                  "type": {
+                    "text": "string"
+                  }
+                }
+              ]
             },
             {
               "kind": "method",
@@ -790,7 +1070,7 @@
                 {
                   "name": "event",
                   "type": {
-                    "text": "MouseEvent"
+                    "text": "MouseEvent | FocusEvent"
                   }
                 },
                 {
@@ -808,6 +1088,16 @@
               "privacy": "private",
               "description": "Esconde o tooltip caso o usuário realize o 'mouse out'."
             },
+            {
+              "kind": "method",
+              "name": "positionTooltip",
+              "privacy": "private"
+            },
+            {
+              "kind": "method",
+              "name": "cleanupTooltipPosition",
+              "privacy": "private"
+            },
             {
               "kind": "method",
               "name": "getParsedItems",
@@ -837,7 +1127,7 @@
               "privacy": "private",
               "return": {
                 "type": {
-                  "text": "{ [key: string]: boolean }"
+                  "text": "CssClassMap"
                 }
               },
               "description": "Define as classes CSS usadas no breadcrumb."
@@ -859,7 +1149,7 @@
             },
             {
               "kind": "method",
-              "name": "calcularLarguraItens",
+              "name": "calculateItemsWidth",
               "privacy": "private",
               "description": "Calcula a largura total dos itens do breadcrumb para determinar se precisa de truncamento."
             },
@@ -907,7 +1197,7 @@
                   }
                 }
               ],
-              "description": "Renderiza Lista dropdown contendo os itens do Breadcrumb"
+              "description": "Renderiza lista dropdown contendo os itens do Breadcrumb"
             },
             {
               "kind": "method",
@@ -1013,204 +1303,6 @@
         }
       ]
     },
-    {
-      "kind": "javascript-module",
-      "path": "components/card.js",
-      "declarations": [
-        {
-          "kind": "class",
-          "description": "## Design System\n\nPara a documentação completa de design, incluindo diretrizes de uso, acessibilidade e exemplos visuais, consulte o [Design System do GovBR](https://www.gov.br/ds/components/card?tab=designer).",
-          "name": "BrCard",
-          "slots": [
-            {
-              "description": "Slot para conteúdo livre do card, quando não usar a estrutura de slots nomeados.",
-              "name": "default"
-            },
-            {
-              "description": "Slot para o conteúdo do cabeçalho do card.",
-              "name": "header"
-            },
-            {
-              "description": "Slot para o corpo principal do card ao usar a estrutura de slots.",
-              "name": "content"
-            },
-            {
-              "description": "Slot para o conteúdo do rodapé do card.",
-              "name": "footer"
-            }
-          ],
-          "members": [
-            {
-              "kind": "field",
-              "name": "el",
-              "type": {
-                "text": "HTMLBrCardElement"
-              },
-              "description": "Referência ao elemento host do componente.\nUtilize esta propriedade para acessar e manipular o elemento do DOM associado ao componente."
-            },
-            {
-              "kind": "field",
-              "name": "elementInternals",
-              "type": {
-                "text": "ElementInternals"
-              }
-            },
-            {
-              "kind": "field",
-              "name": "customId",
-              "type": {
-                "text": "string"
-              },
-              "readonly": true,
-              "description": "Identificador único; gerado automaticamente quando omitido."
-            },
-            {
-              "kind": "field",
-              "name": "disabled",
-              "type": {
-                "text": "boolean"
-              },
-              "default": "false",
-              "description": "Define se o card está desabilitado.\nQuando true, o card fica com opacidade reduzida e não responde a interações."
-            },
-            {
-              "kind": "field",
-              "name": "hover",
-              "type": {
-                "text": "boolean"
-              },
-              "default": "false",
-              "description": "Define se o card tem hover interativo.\nQuando true, o card terá efeitos visuais ao passar o mouse."
-            },
-            {
-              "kind": "field",
-              "name": "hasHeader",
-              "type": {
-                "text": "boolean"
-              },
-              "privacy": "private",
-              "default": "false"
-            },
-            {
-              "kind": "field",
-              "name": "hasContent",
-              "type": {
-                "text": "boolean"
-              },
-              "privacy": "private",
-              "default": "false"
-            },
-            {
-              "kind": "field",
-              "name": "hasFooter",
-              "type": {
-                "text": "boolean"
-              },
-              "privacy": "private",
-              "default": "false"
-            },
-            {
-              "kind": "method",
-              "name": "checkSlots",
-              "privacy": "private"
-            },
-            {
-              "kind": "method",
-              "name": "getCssClassMap",
-              "privacy": "private",
-              "return": {
-                "type": {
-                  "text": "CssClassMap"
-                }
-              }
-            },
-            {
-              "kind": "method",
-              "name": "getHeaderClassMap",
-              "privacy": "private",
-              "return": {
-                "type": {
-                  "text": "CssClassMap"
-                }
-              }
-            },
-            {
-              "kind": "method",
-              "name": "getContentClassMap",
-              "privacy": "private",
-              "return": {
-                "type": {
-                  "text": "CssClassMap"
-                }
-              }
-            },
-            {
-              "kind": "method",
-              "name": "getFooterClassMap",
-              "privacy": "private",
-              "return": {
-                "type": {
-                  "text": "CssClassMap"
-                }
-              }
-            },
-            {
-              "kind": "method",
-              "name": "render"
-            }
-          ],
-          "attributes": [
-            {
-              "name": "custom-id",
-              "fieldName": "customId",
-              "description": "Identificador único; gerado automaticamente quando omitido.",
-              "type": {
-                "text": "string"
-              }
-            },
-            {
-              "name": "disabled",
-              "fieldName": "disabled",
-              "default": "false",
-              "description": "Define se o card está desabilitado.\nQuando true, o card fica com opacidade reduzida e não responde a interações.",
-              "type": {
-                "text": "boolean"
-              }
-            },
-            {
-              "name": "hover",
-              "fieldName": "hover",
-              "default": "false",
-              "description": "Define se o card tem hover interativo.\nQuando true, o card terá efeitos visuais ao passar o mouse.",
-              "type": {
-                "text": "boolean"
-              }
-            }
-          ],
-          "tagName": "br-card",
-          "events": [],
-          "customElement": true
-        }
-      ],
-      "exports": [
-        {
-          "kind": "js",
-          "name": "BrCard",
-          "declaration": {
-            "name": "BrCard",
-            "module": "components/card.js"
-          }
-        },
-        {
-          "kind": "custom-element-definition",
-          "name": "br-card",
-          "declaration": {
-            "name": "BrCard",
-            "module": "components/card.js"
-          }
-        }
-      ]
-    },
     {
       "kind": "javascript-module",
       "path": "components/checkbox.js",
@@ -8038,7 +8130,7 @@
                 "text": "string"
               },
               "readonly": true,
-              "description": "Seletor CSS para o elemento que deve receber foco quando o modal é aberto."
+              "description": "Seletor CSS do elemento que deve receber foco quando o modal é aberto (ex: `\"#meu-elemento\"`)."
             },
             {
               "kind": "field",
@@ -8079,6 +8171,31 @@
               "privacy": "private",
               "default": "false"
             },
+            {
+              "kind": "field",
+              "name": "triggerElement",
+              "type": {
+                "text": "HTMLElement | null"
+              },
+              "privacy": "private",
+              "default": "null"
+            },
+            {
+              "kind": "field",
+              "name": "pendingFocus",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "default": "false"
+            },
+            {
+              "kind": "field",
+              "name": "FOCUSABLE_SELECTORS",
+              "privacy": "private",
+              "static": true,
+              "readonly": true
+            },
             {
               "kind": "method",
               "name": "handleShowChange",
@@ -8097,10 +8214,119 @@
                 }
               ]
             },
+            {
+              "kind": "method",
+              "name": "moveFocusIntoModal",
+              "privacy": "private",
+              "description": "GERENCIAMENTO DE FOCO\n\nMétodos responsáveis por mover o foco para dentro do modal, estabilizar o\nfoco em elementos iniciais e localizar elementos nativos focáveis dentro\nde web components que utilizam Shadow DOM."
+            },
+            {
+              "kind": "method",
+              "name": "findDeepNativeFocusable",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": ""
+                }
+              },
+              "parameters": [
+                {
+                  "name": "el",
+                  "type": {
+                    "text": "HTMLElement"
+                  }
+                }
+              ],
+              "description": "Encontra recursivamente o primeiro elemento nativo focusável dentro de um elemento,\nperfurando shadow roots aninhados em qualquer profundidade (ex: br-select → br-input → <input>)."
+            },
+            {
+              "kind": "method",
+              "name": "waitForElement",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "Promise<HTMLElement | null>"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "selector",
+                  "type": {
+                    "text": "string"
+                  }
+                },
+                {
+                  "name": "retries",
+                  "default": "10"
+                },
+                {
+                  "name": "interval",
+                  "default": "50"
+                }
+              ],
+              "description": "Aguarda o elemento aparecer no DOM e estar pronto para receber foco.\nTenta por até 10 vezes com intervalos de 50ms (500ms total)."
+            },
+            {
+              "kind": "field",
+              "name": "handleKeyDown",
+              "privacy": "private",
+              "description": "TECLADO\n\nManipuladores e utilitários relacionados à interação por teclado,\nincluindo tratamento de `Escape` para fechar o modal e navegação por\n`Tab`/`Shift+Tab` para manter o foco preso (focus trap) dentro do modal."
+            },
+            {
+              "kind": "method",
+              "name": "handleTabNavigation",
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "event",
+                  "type": {
+                    "text": "KeyboardEvent"
+                  }
+                }
+              ],
+              "description": "Implementa o focus trap circular dentro da modal.\nQuando Tab é pressionado no último elemento focalizável, o foco vai para o primeiro.\nQuando Shift+Tab é pressionado no primeiro, o foco vai para o último.\n\nUsa `composedPath()[0]` para obter o elemento real com foco, pois web components\ncom shadow DOM retornam o host via `document.activeElement`, não o elemento nativo interno.\n\nUsa `findDeepNativeFocusable` no wrap porque `host.focus()` é no-op em web components\nsem `delegatesFocus` — focar o elemento nativo mais profundo garante que o wrap aconteça."
+            },
+            {
+              "kind": "method",
+              "name": "isOrInsideElement",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "boolean"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "target",
+                  "type": {
+                    "text": "HTMLElement"
+                  }
+                },
+                {
+                  "name": "container",
+                  "type": {
+                    "text": "HTMLElement"
+                  }
+                }
+              ],
+              "description": "Verifica se `target` é igual a `container` ou está dentro dele,\nperfurando shadow roots na subida (getRootNode().host)."
+            },
+            {
+              "kind": "method",
+              "name": "getFocusableElements",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "HTMLElement[]"
+                }
+              },
+              "description": "Coleta todos os elementos focalizáveis dentro da modal,\nperfurando o shadow DOM: inclui elementos do shadow root (ex: botão fechar)\ne dos slots (conteúdo fornecido pelo usuário nos slots header, default, footer e close-button)."
+            },
             {
               "kind": "method",
               "name": "closeParentScrim",
-              "privacy": "private"
+              "privacy": "private",
+              "description": "INTEGRAÇÃO COM BR-SCRIM\n\nMétodos para integrar o comportamento do modal com um `br-scrim` pai,\nincluindo abertura/fechamento sincronizados e listeners para eventos do\nscrim."
             },
             {
               "kind": "method",
@@ -8135,6 +8361,7 @@
               "kind": "field",
               "name": "titleId",
               "privacy": "private",
+              "description": "UTILITÁRIOS\n\nGetters e helpers utilitários usados internamente pelo componente,\ncomo geração de IDs e mapeamento de classes CSS.",
               "readonly": true
             },
             {
@@ -8205,7 +8432,7 @@
             {
               "name": "initial-focus-selector",
               "fieldName": "initialFocusSelector",
-              "description": "Seletor CSS para o elemento que deve receber foco quando o modal é aberto.",
+              "description": "Seletor CSS do elemento que deve receber foco quando o modal é aberto (ex: `\"#meu-elemento\"`).",
               "type": {
                 "text": "string"
               }
@@ -8257,6 +8484,13 @@
                 "text": "EventEmitter<void>"
               },
               "description": "Evento emitido antes do fechamento do modal (quando o botão X é clicado).\nSe autoClose está desativado, o desenvolvedor deve fechar manualmente o modal após este evento.\nSe autoClose está ativado, o modal fecha automaticamente após este evento."
+            },
+            {
+              "name": "brModalOpened",
+              "type": {
+                "text": "EventEmitter<void>"
+              },
+              "description": "Evento emitido após o modal estar completamente aberto e com o foco estabilizado\ndentro dele. Complementa `brModalOpen` (que dispara imediatamente ao abrir):\nuse `brModalOpened` quando precisar interagir com o modal já pronto."
             }
           ],
           "customElement": true
@@ -9490,6 +9724,25 @@
               "privacy": "private",
               "default": "null"
             },
+            {
+              "kind": "field",
+              "name": "isModalFocusing",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "default": "false",
+              "description": "Flag que suprime handleGlobalFocus enquanto a modal filha está\ngerenciando ativamente sua própria sequência de foco (moveFocusIntoModal)."
+            },
+            {
+              "kind": "field",
+              "name": "modalFocusSuppressId",
+              "type": {
+                "text": "NodeJS.Timeout | null"
+              },
+              "privacy": "private",
+              "default": "null"
+            },
             {
               "kind": "field",
               "name": "FOCUSABLE_SELECTORS",
@@ -9523,6 +9776,27 @@
               "privacy": "private",
               "description": "Adiciona event listener ao contentRef para capturar eventos de teclado\ne gerenciar a navegação por teclado dentro do scrim."
             },
+            {
+              "kind": "method",
+              "name": "suppressFocusGuard",
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "safetyMs",
+                  "default": "1000",
+                  "type": {
+                    "text": "number"
+                  }
+                }
+              ],
+              "description": "Ativa o guard que suprime `handleGlobalFocus` enquanto a modal filha executa\nsua sequência assíncrona de foco (`moveFocusIntoModal`).\n\nO guard é desativado assim que o evento `brModalFocusReady` chega (via\n`handleModalFocusReady`). O timeout é apenas um safety net para o caso de\no evento nunca chegar (ex: erro interno na modal)."
+            },
+            {
+              "kind": "field",
+              "name": "handleModalFocusReady",
+              "privacy": "private",
+              "description": "Handler para o evento `brModalFocusReady` emitido pela modal filha.\nDesativa o guard imediatamente assim que o foco está estabilizado,\ncancelando o timeout de segurança do `suppressFocusGuard`."
+            },
             {
               "kind": "field",
               "name": "handleModalOpen",
@@ -9558,7 +9832,7 @@
               "kind": "method",
               "name": "listenToModalEvents",
               "privacy": "private",
-              "description": "Adiciona listeners para eventos brModalOpen e brModalClose das modais filhas"
+              "description": "Adiciona listeners para eventos brModalOpen, brModalClose e brModalFocusReady das modais filhas"
             },
             {
               "kind": "method",
@@ -9733,7 +10007,8 @@
             {
               "kind": "field",
               "name": "handleGlobalKeyDown",
-              "privacy": "private"
+              "privacy": "private",
+              "description": "Intercepta todos os eventos de teclado globalmente quando o scrim está ativo.\n\nUsa `composedPath()[0]` para obter o elemento real com foco, mesmo dentro de shadow roots.\n`event.target` é retargetado ao cruzar shadow boundaries e não reflete o elemento concreto\nquando o foco está dentro do shadow DOM de componentes filhos como `br-modal`."
             },
             {
               "kind": "field",
@@ -9809,6 +10084,13 @@
                   "type": {
                     "text": "HTMLElement"
                   }
+                },
+                {
+                  "name": "event",
+                  "optional": true,
+                  "type": {
+                    "text": "KeyboardEvent"
+                  }
                 }
               ]
             },
@@ -9859,7 +10141,7 @@
                   }
                 }
               ],
-              "description": "Verifica se um elemento está dentro do scrim"
+              "description": "Verifica se um elemento está dentro do scrim.\nFunciona com shadow DOM: aceita tanto o host (br-modal) quanto elementos\ndentro de shadow roots filhos — verifica o host mais próximo via getRootNode."
             },
             {
               "kind": "method",
@@ -10092,6 +10374,23 @@
                 "text": "ElementInternals"
               }
             },
+            {
+              "kind": "field",
+              "name": "slotElement",
+              "type": {
+                "text": "HTMLSlotElement | undefined"
+              },
+              "privacy": "private"
+            },
+            {
+              "kind": "field",
+              "name": "isSyncingOptionElements",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "default": "false"
+            },
             {
               "kind": "field",
               "name": "label",
@@ -10118,6 +10417,15 @@
               "default": "false",
               "description": "Habilita o modo múltiplo para selecionar várias opções."
             },
+            {
+              "kind": "field",
+              "name": "keepOpenOnSelect",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Controla se o dropdown permanece aberto após selecionar opções.\nQuando `true`, permite seleção sequencial sem reabrir a lista."
+            },
             {
               "kind": "field",
               "name": "options",
@@ -10215,7 +10523,7 @@
               "kind": "field",
               "name": "parsedOptions",
               "type": {
-                "text": "{ label: string; value: string; selected?: boolean }[]"
+                "text": "SelectOptionItem[]"
               },
               "default": "[]"
             },
@@ -10223,7 +10531,7 @@
               "kind": "field",
               "name": "filteredOptions",
               "type": {
-                "text": "{ label: string; value: string; selected?: boolean }[]"
+                "text": "SelectOptionItem[]"
               },
               "default": "[]"
             },
@@ -10290,6 +10598,14 @@
               },
               "default": "-1"
             },
+            {
+              "kind": "field",
+              "name": "optionElements",
+              "type": {
+                "text": "BrSelectOptionElement[]"
+              },
+              "default": "[]"
+            },
             {
               "kind": "method",
               "name": "synchronizeSelect"
@@ -10306,6 +10622,10 @@
                 }
               ]
             },
+            {
+              "kind": "method",
+              "name": "handleSelectOptionPropsChange"
+            },
             {
               "kind": "method",
               "name": "handleExpandedChange",
@@ -10318,6 +10638,69 @@
                 }
               ]
             },
+            {
+              "kind": "field",
+              "name": "registerOptionItems",
+              "privacy": "private"
+            },
+            {
+              "kind": "method",
+              "name": "getOptionElements",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "BrSelectOptionElement[]"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "getSourceOptions",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "SelectOptionItem[]"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "getOptionsFromProp",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "SelectOptionItem[]"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "getOptionElementLabel",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "string"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "optionElement",
+                  "type": {
+                    "text": "BrSelectOptionElement"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "updateSelectedValueFromParsedOptions",
+              "privacy": "private"
+            },
+            {
+              "kind": "method",
+              "name": "syncOptionElementsFromParsedOptions",
+              "privacy": "private"
+            },
             {
               "kind": "field",
               "name": "handleClickOutside",
@@ -10509,7 +10892,7 @@
                 {
                   "name": "options",
                   "type": {
-                    "text": "{ label: string; value: string; selected?: boolean }[]"
+                    "text": "SelectOptionItem[]"
                   }
                 }
               ]
@@ -10561,26 +10944,41 @@
             {
               "kind": "method",
               "name": "toggleOpen",
+              "return": {
+                "type": {
+                  "text": "Promise<void>"
+                }
+              },
               "description": "Inverte o valor da prop `isOpen`"
             },
             {
               "kind": "method",
               "name": "clear",
+              "return": {
+                "type": {
+                  "text": "Promise<void>"
+                }
+              },
               "description": "Limpa todas as opções selecionadas."
             },
             {
               "kind": "method",
               "name": "getValue",
-              "description": "Retorna o valor selecionado.",
               "return": {
                 "type": {
                   "text": "Promise<string | string[]>"
                 }
-              }
+              },
+              "description": "Retorna o valor selecionado."
             },
             {
               "kind": "method",
               "name": "setValue",
+              "return": {
+                "type": {
+                  "text": "Promise<void>"
+                }
+              },
               "parameters": [
                 {
                   "name": "newValue",
@@ -10665,6 +11063,15 @@
                 "text": "boolean"
               }
             },
+            {
+              "name": "keep-open-on-select",
+              "fieldName": "keepOpenOnSelect",
+              "default": "false",
+              "description": "Controla se o dropdown permanece aberto após selecionar opções.\nQuando `true`, permite seleção sequencial sem reabrir a lista.",
+              "type": {
+                "text": "boolean"
+              }
+            },
             {
               "name": "options",
               "fieldName": "options",
@@ -12258,20 +12665,26 @@
               "kind": "field",
               "name": "density",
               "type": {
-                "text": "'small' | 'medium' | 'large'"
+                "text": "TabDensity"
               },
               "readonly": true,
               "default": "'medium'",
-              "description": "A propriedade 'density' define a densidade do componente."
+              "description": "A propriedade 'density' define a densidade do componente.",
+              "parsedType": {
+                "text": "'small' | 'medium' | 'large'"
+              }
             },
             {
               "kind": "field",
               "name": "colorMode",
               "type": {
-                "text": "'dark'"
+                "text": "TabColorMode | undefined"
               },
               "readonly": true,
-              "description": "Define se o Tab usará um esquema de cores escuro."
+              "description": "Define se o Tab usará um esquema de cores escuro.",
+              "parsedType": {
+                "text": "'dark' | undefined"
+              }
             },
             {
               "kind": "field",
@@ -12287,11 +12700,33 @@
               "kind": "field",
               "name": "alignItemsTab",
               "type": {
-                "text": "'start' | 'center' | 'end'"
+                "text": "TabAlignItems"
               },
               "readonly": true,
               "default": "'start'",
-              "description": "Define o alinhamento horizontal dos itens da tab na barra de navegação.\n- 'start': Alinha à esquerda\n- 'center': Centraliza\n- 'end': Alinha à direita"
+              "description": "Define o alinhamento horizontal dos itens da tab na barra de navegação.",
+              "parsedType": {
+                "text": "'start' | 'center' | 'end'"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "scrollDisabled",
+              "type": {
+                "text": "boolean"
+              },
+              "readonly": true,
+              "default": "false",
+              "description": "Desabilita o scroll automático da área de conteúdo.\nPor padrão, o scroll vertical fica apenas na região de conteúdo."
+            },
+            {
+              "kind": "field",
+              "name": "height",
+              "type": {
+                "text": "string | undefined"
+              },
+              "readonly": true,
+              "description": "Define a altura máxima da área de conteúdo, ativando o scroll interno quando o conteúdo ultrapassa essa altura."
             },
             {
               "kind": "field",
@@ -12310,6 +12745,7 @@
                 "text": "string"
               },
               "privacy": "private",
+              "default": "''",
               "description": "ID do tab atualmente ativo"
             },
             {
@@ -12326,17 +12762,19 @@
               "kind": "field",
               "name": "slotElement",
               "type": {
-                "text": "HTMLSlotElement"
+                "text": "HTMLSlotElement | undefined"
               },
-              "privacy": "private"
+              "privacy": "private",
+              "description": "Referência ao elemento de slot para monitorar mudanças nos tab items filhos."
             },
             {
               "kind": "field",
               "name": "mutationObserver",
               "type": {
-                "text": "MutationObserver"
+                "text": "MutationObserver | undefined"
               },
-              "privacy": "private"
+              "privacy": "private",
+              "description": "Observador de mutação para detectar mudanças nos tab items filhos"
             },
             {
               "kind": "method",
@@ -12372,7 +12810,13 @@
             {
               "kind": "field",
               "name": "registerTabItems",
-              "privacy": "private"
+              "privacy": "private",
+              "description": "Registra os tab items filhos e garante que cada um tenha um ID único.\nTambém propaga o color mode para os tab items.",
+              "return": {
+                "type": {
+                  "text": ""
+                }
+              }
             },
             {
               "kind": "method",
@@ -12397,12 +12841,20 @@
             {
               "kind": "field",
               "name": "handleTabButtonClick",
-              "privacy": "private"
+              "privacy": "private",
+              "description": "Manipula a navegação por teclado nos botões de tab para melhorar a acessibilidade"
             },
             {
               "kind": "field",
               "name": "handleTabButtonKeyDown",
-              "privacy": "private"
+              "privacy": "private",
+              "description": "Manipula o evento de pressionamento de tecla nos botões de tab para melhorar a acessibilidade",
+              "parameters": [
+                {
+                  "description": "Evento de teclado",
+                  "name": "event"
+                }
+              ]
             },
             {
               "kind": "method",
@@ -12467,7 +12919,45 @@
             },
             {
               "kind": "method",
-              "name": "render"
+              "name": "isValidHeight",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": ""
+                }
+              },
+              "parameters": [
+                {
+                  "name": "value",
+                  "optional": true,
+                  "type": {
+                    "text": "string"
+                  },
+                  "description": "Valor a ser verificado"
+                }
+              ],
+              "description": "Verifica se o valor fornecido é uma altura válida para o componente, aceitando unidades CSS modernas e a palavra-chave 'auto'."
+            },
+            {
+              "kind": "method",
+              "name": "getResolvedHeight",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": ""
+                }
+              },
+              "description": "Retorna a altura resolvida do componente, considerando valores válidos e emitindo um aviso para valores inválidos."
+            },
+            {
+              "kind": "method",
+              "name": "render",
+              "description": "Renderiza o componente.",
+              "return": {
+                "type": {
+                  "text": ""
+                }
+              }
             }
           ],
           "attributes": [
@@ -12485,6 +12975,9 @@
               "default": "'medium'",
               "description": "A propriedade 'density' define a densidade do componente.",
               "type": {
+                "text": "TabDensity"
+              },
+              "parsedType": {
                 "text": "'small' | 'medium' | 'large'"
               }
             },
@@ -12493,6 +12986,9 @@
               "fieldName": "colorMode",
               "description": "Define se o Tab usará um esquema de cores escuro.",
               "type": {
+                "text": "TabColorMode"
+              },
+              "parsedType": {
                 "text": "'dark'"
               }
             },
@@ -12509,10 +13005,30 @@
               "name": "align-items-tab",
               "fieldName": "alignItemsTab",
               "default": "'start'",
-              "description": "Define o alinhamento horizontal dos itens da tab na barra de navegação.\n- 'start': Alinha à esquerda\n- 'center': Centraliza\n- 'end': Alinha à direita",
+              "description": "Define o alinhamento horizontal dos itens da tab na barra de navegação.",
               "type": {
+                "text": "TabAlignItems"
+              },
+              "parsedType": {
                 "text": "'start' | 'center' | 'end'"
               }
+            },
+            {
+              "name": "scroll-disabled",
+              "fieldName": "scrollDisabled",
+              "default": "false",
+              "description": "Desabilita o scroll automático da área de conteúdo.\nPor padrão, o scroll vertical fica apenas na região de conteúdo.",
+              "type": {
+                "text": "boolean"
+              }
+            },
+            {
+              "name": "height",
+              "fieldName": "height",
+              "description": "Define a altura máxima da área de conteúdo, ativando o scroll interno quando o conteúdo ultrapassa essa altura.",
+              "type": {
+                "text": "string"
+              }
             }
           ],
           "tagName": "br-tab",
@@ -15125,68 +15641,209 @@
               }
             },
             {
-              "name": "orientation",
-              "fieldName": "orientation",
-              "default": "'horizontal'",
-              "description": "Orientação visual do wizard.\nDefine se os indicadores de progresso serão exibidos horizontalmente ou verticalmente.",
+              "name": "orientation",
+              "fieldName": "orientation",
+              "default": "'horizontal'",
+              "description": "Orientação visual do wizard.\nDefine se os indicadores de progresso serão exibidos horizontalmente ou verticalmente.",
+              "type": {
+                "text": "'horizontal' | 'vertical'"
+              }
+            },
+            {
+              "name": "progression-type",
+              "fieldName": "progressionType",
+              "default": "'nonlinear'",
+              "description": "Tipo de progressão entre etapas.\n- `linear`: O usuário deve completar cada etapa sequencialmente. Não é possível pular etapas futuras.\n- `nonlinear`: O usuário pode navegar livremente entre qualquer etapa.",
+              "type": {
+                "text": "'linear' | 'nonlinear'"
+              }
+            },
+            {
+              "name": "custom-id",
+              "fieldName": "customId",
+              "description": "ID customizado para o componente.\nSe não fornecido, um ID único será gerado automaticamente.",
+              "type": {
+                "text": "string"
+              }
+            }
+          ],
+          "tagName": "br-wizard",
+          "events": [
+            {
+              "name": "brWizardStepChange",
+              "type": {
+                "text": "EventEmitter<number>"
+              },
+              "description": "Evento emitido APÓS mudar de etapa com sucesso.\n\nEste evento é disparado independente da origem da navegação:\n- Botões \"Avançar\" ou \"Voltar\"\n- Click direto em um step do indicador de progresso\n- Chamadas programáticas via métodos públicos (goToStep, nextStep, etc)"
+            },
+            {
+              "name": "brWizardBeforeStepChange",
+              "type": {
+                "text": "EventEmitter<number>"
+              },
+              "description": "Evento emitido ANTES de mudar de etapa (permite validação e cancelamento).\n\nComportamento:\n- Disparado apenas ao AVANÇAR (targetStep > currentStep)\n- Não é disparado ao VOLTAR (targetStep < currentStep)\n- Funciona tanto para cliques nos botões quanto para cliques diretos nos steps\n- Pode ser cancelado com `event.preventDefault()` para bloquear a navegação"
+            },
+            {
+              "name": "brWizardComplete",
+              "type": {
+                "text": "EventEmitter<void>"
+              },
+              "description": "Evento emitido ao concluir o wizard (última etapa)."
+            },
+            {
+              "name": "brWizardCancel",
+              "type": {
+                "text": "EventEmitter<void>"
+              },
+              "description": "Evento emitido ao cancelar o wizard."
+            },
+            {
+              "name": "brWizardNavigationBlocked",
+              "type": {
+                "text": "EventEmitter<string>"
+              },
+              "description": "Evento emitido quando uma ação é bloqueada (validação falha, progressão linear impedida).\nEmite uma string indicando o motivo: 'linear-progression' ou 'validation-failed'.\nUse getCurrentStepIndex() para obter o contexto da etapa atual."
+            }
+          ],
+          "customElement": true
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "Wizard",
+          "declaration": {
+            "name": "Wizard",
+            "module": "components/wizard.js"
+          }
+        },
+        {
+          "kind": "custom-element-definition",
+          "name": "br-wizard",
+          "declaration": {
+            "name": "Wizard",
+            "module": "components/wizard.js"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "components/crumb/crumb.js",
+      "declarations": [
+        {
+          "kind": "class",
+          "description": "## Design System\n\nPara a documentação completa de design, incluindo diretrizes de uso, acessibilidade e exemplos visuais, consulte o [Design System do GovBR](https://www.gov.br/ds/components/breadcrumb?tab=designer).",
+          "name": "Crumb",
+          "members": [
+            {
+              "kind": "field",
+              "name": "label",
+              "type": {
+                "text": "string"
+              },
+              "readonly": true,
+              "description": "Rótulo (texto) do crumb."
+            },
+            {
+              "kind": "field",
+              "name": "url",
+              "type": {
+                "text": "string | undefined"
+              },
+              "readonly": true,
+              "description": "URL ou caminho para o qual o usuário será direcionado ao clicar no crumb."
+            },
+            {
+              "kind": "field",
+              "name": "target",
+              "type": {
+                "text": "string | undefined"
+              },
+              "readonly": true,
+              "description": "Define o alvo do link quando `url` está presente. (ex: _blank, _self)."
+            },
+            {
+              "kind": "field",
+              "name": "home",
+              "type": {
+                "text": "boolean"
+              },
+              "readonly": true,
+              "default": "false",
+              "description": "Define se o crumb é o item inicial (Home)."
+            },
+            {
+              "kind": "field",
+              "name": "active",
+              "type": {
+                "text": "boolean"
+              },
+              "readonly": true,
+              "default": "false",
+              "description": "Define se o crumb é a página atual ativa no breadcrumb."
+            },
+            {
+              "kind": "method",
+              "name": "handlePropsChange"
+            },
+            {
+              "kind": "method",
+              "name": "render"
+            }
+          ],
+          "attributes": [
+            {
+              "name": "label",
+              "fieldName": "label",
+              "description": "Rótulo (texto) do crumb.",
               "type": {
-                "text": "'horizontal' | 'vertical'"
+                "text": "string"
               }
             },
             {
-              "name": "progression-type",
-              "fieldName": "progressionType",
-              "default": "'nonlinear'",
-              "description": "Tipo de progressão entre etapas.\n- `linear`: O usuário deve completar cada etapa sequencialmente. Não é possível pular etapas futuras.\n- `nonlinear`: O usuário pode navegar livremente entre qualquer etapa.",
+              "name": "url",
+              "fieldName": "url",
+              "description": "URL ou caminho para o qual o usuário será direcionado ao clicar no crumb.",
               "type": {
-                "text": "'linear' | 'nonlinear'"
+                "text": "string"
               }
             },
             {
-              "name": "custom-id",
-              "fieldName": "customId",
-              "description": "ID customizado para o componente.\nSe não fornecido, um ID único será gerado automaticamente.",
+              "name": "target",
+              "fieldName": "target",
+              "description": "Define o alvo do link quando `url` está presente. (ex: _blank, _self).",
               "type": {
                 "text": "string"
               }
-            }
-          ],
-          "tagName": "br-wizard",
-          "events": [
-            {
-              "name": "brWizardStepChange",
-              "type": {
-                "text": "EventEmitter<number>"
-              },
-              "description": "Evento emitido APÓS mudar de etapa com sucesso.\n\nEste evento é disparado independente da origem da navegação:\n- Botões \"Avançar\" ou \"Voltar\"\n- Click direto em um step do indicador de progresso\n- Chamadas programáticas via métodos públicos (goToStep, nextStep, etc)"
             },
             {
-              "name": "brWizardBeforeStepChange",
+              "name": "home",
+              "fieldName": "home",
+              "default": "false",
+              "description": "Define se o crumb é o item inicial (Home).",
               "type": {
-                "text": "EventEmitter<number>"
-              },
-              "description": "Evento emitido ANTES de mudar de etapa (permite validação e cancelamento).\n\nComportamento:\n- Disparado apenas ao AVANÇAR (targetStep > currentStep)\n- Não é disparado ao VOLTAR (targetStep < currentStep)\n- Funciona tanto para cliques nos botões quanto para cliques diretos nos steps\n- Pode ser cancelado com `event.preventDefault()` para bloquear a navegação"
+                "text": "boolean"
+              }
             },
             {
-              "name": "brWizardComplete",
+              "name": "active",
+              "fieldName": "active",
+              "default": "false",
+              "description": "Define se o crumb é a página atual ativa no breadcrumb.",
               "type": {
-                "text": "EventEmitter<void>"
-              },
-              "description": "Evento emitido ao concluir o wizard (última etapa)."
-            },
+                "text": "boolean"
+              }
+            }
+          ],
+          "tagName": "br-crumb",
+          "events": [
             {
-              "name": "brWizardCancel",
+              "name": "brCrumbPropsChange",
               "type": {
                 "text": "EventEmitter<void>"
               },
-              "description": "Evento emitido ao cancelar o wizard."
-            },
-            {
-              "name": "brWizardNavigationBlocked",
-              "type": {
-                "text": "EventEmitter<string>"
-              },
-              "description": "Evento emitido quando uma ação é bloqueada (validação falha, progressão linear impedida).\nEmite uma string indicando o motivo: 'linear-progression' ou 'validation-failed'.\nUse getCurrentStepIndex() para obter o contexto da etapa atual."
+              "description": "Evento disparado quando as propriedades do crumb mudam.\nO componente pai (br-breadcrumb) escuta este evento para se atualizar."
             }
           ],
           "customElement": true
@@ -15195,18 +15852,18 @@
       "exports": [
         {
           "kind": "js",
-          "name": "Wizard",
+          "name": "Crumb",
           "declaration": {
-            "name": "Wizard",
-            "module": "components/wizard.js"
+            "name": "Crumb",
+            "module": "components/crumb/crumb.js"
           }
         },
         {
           "kind": "custom-element-definition",
-          "name": "br-wizard",
+          "name": "br-crumb",
           "declaration": {
-            "name": "Wizard",
-            "module": "components/wizard.js"
+            "name": "Crumb",
+            "module": "components/crumb/crumb.js"
           }
         }
       ]
@@ -17065,59 +17722,74 @@
     },
     {
       "kind": "javascript-module",
-      "path": "components/menu-info/menu-info.js",
+      "path": "components/menu-item/menu-item.js",
       "declarations": [
         {
           "kind": "class",
-          "description": "## Design System\n\nPara a documentação completa de design, incluindo diretrizes de uso, acessibilidade e exemplos visuais, consulte o [Design System do GovBR](https://www.gov.br/ds/components/menu-info?tab=designer).",
-          "name": "MenuInfo",
-          "slots": [
-            {
-              "description": "Slot para conteúdo personalizado no lugar do texto padrão de informações.",
-              "name": "default"
-            }
-          ],
+          "description": "## Design System\n\nPara a documentação completa de design, incluindo diretrizes de uso, acessibilidade e exemplos visuais, consulte o [Design System do GovBR](https://www.gov.br/ds/components/menu?tab=designer).",
+          "name": "MenuItem",
           "members": [
             {
               "kind": "field",
-              "name": "el",
+              "name": "icon",
               "type": {
-                "text": "HTMLBrMenuInfoElement"
+                "text": "string"
               },
-              "description": "Referência ao elemento host do componente.\nUtilize esta propriedade para acessar e manipular o elemento do DOM associado ao componente."
+              "description": "Ícone exibido no item do menu.\nUtilize esta propriedade para definir o ícone que será mostrado ao lado do conteúdo do item."
             },
             {
               "kind": "field",
-              "name": "elementInternals",
+              "name": "href",
               "type": {
-                "text": "ElementInternals"
-              }
+                "text": "string"
+              },
+              "default": "'#'",
+              "description": "URL de destino do link do item do menu.\nUtilize esta propriedade para definir o endereço para onde o usuário será direcionado ao clicar no item."
             },
             {
               "kind": "field",
-              "name": "customId",
+              "name": "target",
               "type": {
-                "text": "string"
+                "text": "'_self' | '_blank' | '_parent' | '_top' | undefined"
               },
-              "readonly": true,
-              "default": "`br-menu-info-${MenuInfoId++}`",
-              "description": "Identificador único.\nCaso não seja fornecido, um ID gerado automaticamente será usado."
+              "default": "'_blank'",
+              "description": "Define como o link será aberto.\n- `_self`: abre no mesmo contexto de navegação (padrão)\n- `_blank`: abre em nova aba ou janela\n- `_parent`: abre no contexto pai\n- `_top`: abre no contexto de nível superior"
             },
             {
               "kind": "field",
-              "name": "info",
+              "name": "divider",
               "type": {
-                "text": "string | undefined"
+                "text": "boolean"
               },
-              "description": "Informações adicionais em formato de texto"
+              "default": "false",
+              "description": "Define se o item deve exibir um divisor visual.\nQuando ativado, adiciona uma linha separadora para organizar visualmente os itens do menu."
             },
             {
               "kind": "field",
-              "name": "hasSlotContent",
+              "name": "active",
               "type": {
                 "text": "boolean"
               },
-              "default": "false"
+              "default": "false",
+              "description": "Define se o item do menu está ativo/selecionado.\nQuando ativado, aplica estilos visuais para destacar o item como atual ou selecionado."
+            },
+            {
+              "kind": "field",
+              "name": "displayMode",
+              "type": {
+                "text": "'accordion' | 'drill-down' | 'none'"
+              },
+              "default": "'none'",
+              "description": "Define o modo de exibição do item, controlando os ícones de expansão.\n- `accordion`: exibe setas para cima/baixo (usado em menus de nível 0).\n- `drill-down`: exibe seta para a direita (usado em menus de níveis 1+).\n- `none`: não exibe ícones de expansão."
+            },
+            {
+              "kind": "field",
+              "name": "expanded",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Indica se o item está expandido para fins de acessibilidade (ARIA).\nEste estado é controlado externamente (por exemplo, por br-menu-list).\nNão altera o estado visual de \"active\"."
             },
             {
               "kind": "method",
@@ -17126,24 +17798,69 @@
           ],
           "attributes": [
             {
-              "name": "custom-id",
-              "fieldName": "customId",
-              "default": "`br-menu-info-${MenuInfoId++}`",
-              "description": "Identificador único.\nCaso não seja fornecido, um ID gerado automaticamente será usado.",
+              "name": "icon",
+              "fieldName": "icon",
+              "description": "Ícone exibido no item do menu.\nUtilize esta propriedade para definir o ícone que será mostrado ao lado do conteúdo do item.",
               "type": {
                 "text": "string"
               }
             },
             {
-              "name": "info",
-              "fieldName": "info",
-              "description": "Informações adicionais em formato de texto",
+              "name": "href",
+              "fieldName": "href",
+              "default": "'#'",
+              "description": "URL de destino do link do item do menu.\nUtilize esta propriedade para definir o endereço para onde o usuário será direcionado ao clicar no item.",
               "type": {
                 "text": "string"
               }
+            },
+            {
+              "name": "target",
+              "fieldName": "target",
+              "default": "'_blank'",
+              "description": "Define como o link será aberto.\n- `_self`: abre no mesmo contexto de navegação (padrão)\n- `_blank`: abre em nova aba ou janela\n- `_parent`: abre no contexto pai\n- `_top`: abre no contexto de nível superior",
+              "type": {
+                "text": "'_self' | '_blank' | '_parent' | '_top'"
+              }
+            },
+            {
+              "name": "divider",
+              "fieldName": "divider",
+              "default": "false",
+              "description": "Define se o item deve exibir um divisor visual.\nQuando ativado, adiciona uma linha separadora para organizar visualmente os itens do menu.",
+              "type": {
+                "text": "boolean"
+              }
+            },
+            {
+              "name": "active",
+              "fieldName": "active",
+              "default": "false",
+              "description": "Define se o item do menu está ativo/selecionado.\nQuando ativado, aplica estilos visuais para destacar o item como atual ou selecionado.",
+              "type": {
+                "text": "boolean"
+              }
+            },
+            {
+              "name": "display-mode",
+              "fieldName": "displayMode",
+              "default": "'none'",
+              "description": "Define o modo de exibição do item, controlando os ícones de expansão.\n- `accordion`: exibe setas para cima/baixo (usado em menus de nível 0).\n- `drill-down`: exibe seta para a direita (usado em menus de níveis 1+).\n- `none`: não exibe ícones de expansão.",
+              "type": {
+                "text": "'accordion' | 'drill-down' | 'none'"
+              }
+            },
+            {
+              "name": "expanded",
+              "fieldName": "expanded",
+              "default": "false",
+              "description": "Indica se o item está expandido para fins de acessibilidade (ARIA).\nEste estado é controlado externamente (por exemplo, por br-menu-list).\nNão altera o estado visual de \"active\".",
+              "type": {
+                "text": "boolean"
+              }
             }
           ],
-          "tagName": "br-menu-info",
+          "tagName": "br-menu-item",
           "events": [],
           "customElement": true
         }
@@ -17151,92 +17868,77 @@
       "exports": [
         {
           "kind": "js",
-          "name": "MenuInfo",
+          "name": "MenuItem",
           "declaration": {
-            "name": "MenuInfo",
-            "module": "components/menu-info/menu-info.js"
+            "name": "MenuItem",
+            "module": "components/menu-item/menu-item.js"
           }
         },
         {
           "kind": "custom-element-definition",
-          "name": "br-menu-info",
+          "name": "br-menu-item",
           "declaration": {
-            "name": "MenuInfo",
-            "module": "components/menu-info/menu-info.js"
+            "name": "MenuItem",
+            "module": "components/menu-item/menu-item.js"
           }
         }
       ]
     },
     {
       "kind": "javascript-module",
-      "path": "components/menu-item/menu-item.js",
+      "path": "components/menu-info/menu-info.js",
       "declarations": [
         {
           "kind": "class",
-          "description": "## Design System\n\nPara a documentação completa de design, incluindo diretrizes de uso, acessibilidade e exemplos visuais, consulte o [Design System do GovBR](https://www.gov.br/ds/components/menu?tab=designer).",
-          "name": "MenuItem",
-          "members": [
-            {
-              "kind": "field",
-              "name": "icon",
-              "type": {
-                "text": "string"
-              },
-              "description": "Ícone exibido no item do menu.\nUtilize esta propriedade para definir o ícone que será mostrado ao lado do conteúdo do item."
-            },
+          "description": "## Design System\n\nPara a documentação completa de design, incluindo diretrizes de uso, acessibilidade e exemplos visuais, consulte o [Design System do GovBR](https://www.gov.br/ds/components/menu-info?tab=designer).",
+          "name": "MenuInfo",
+          "slots": [
             {
-              "kind": "field",
-              "name": "href",
-              "type": {
-                "text": "string"
-              },
-              "default": "'#'",
-              "description": "URL de destino do link do item do menu.\nUtilize esta propriedade para definir o endereço para onde o usuário será direcionado ao clicar no item."
-            },
+              "description": "Slot para conteúdo personalizado no lugar do texto padrão de informações.",
+              "name": "default"
+            }
+          ],
+          "members": [
             {
               "kind": "field",
-              "name": "target",
+              "name": "el",
               "type": {
-                "text": "'_self' | '_blank' | '_parent' | '_top' | undefined"
+                "text": "HTMLBrMenuInfoElement"
               },
-              "default": "'_blank'",
-              "description": "Define como o link será aberto.\n- `_self`: abre no mesmo contexto de navegação (padrão)\n- `_blank`: abre em nova aba ou janela\n- `_parent`: abre no contexto pai\n- `_top`: abre no contexto de nível superior"
+              "description": "Referência ao elemento host do componente.\nUtilize esta propriedade para acessar e manipular o elemento do DOM associado ao componente."
             },
             {
               "kind": "field",
-              "name": "divider",
+              "name": "elementInternals",
               "type": {
-                "text": "boolean"
-              },
-              "default": "false",
-              "description": "Define se o item deve exibir um divisor visual.\nQuando ativado, adiciona uma linha separadora para organizar visualmente os itens do menu."
+                "text": "ElementInternals"
+              }
             },
             {
               "kind": "field",
-              "name": "active",
+              "name": "customId",
               "type": {
-                "text": "boolean"
+                "text": "string"
               },
-              "default": "false",
-              "description": "Define se o item do menu está ativo/selecionado.\nQuando ativado, aplica estilos visuais para destacar o item como atual ou selecionado."
+              "readonly": true,
+              "default": "`br-menu-info-${MenuInfoId++}`",
+              "description": "Identificador único.\nCaso não seja fornecido, um ID gerado automaticamente será usado."
             },
             {
               "kind": "field",
-              "name": "displayMode",
+              "name": "info",
               "type": {
-                "text": "'accordion' | 'drill-down' | 'none'"
+                "text": "string | undefined"
               },
-              "default": "'none'",
-              "description": "Define o modo de exibição do item, controlando os ícones de expansão.\n- `accordion`: exibe setas para cima/baixo (usado em menus de nível 0).\n- `drill-down`: exibe seta para a direita (usado em menus de níveis 1+).\n- `none`: não exibe ícones de expansão."
+              "description": "Informações adicionais em formato de texto"
             },
             {
               "kind": "field",
-              "name": "expanded",
+              "name": "hasSlotContent",
               "type": {
                 "text": "boolean"
               },
-              "default": "false",
-              "description": "Indica se o item está expandido para fins de acessibilidade (ARIA).\nEste estado é controlado externamente (por exemplo, por br-menu-list).\nNão altera o estado visual de \"active\"."
+              "default": "false"
             },
             {
               "kind": "method",
@@ -17245,69 +17947,24 @@
           ],
           "attributes": [
             {
-              "name": "icon",
-              "fieldName": "icon",
-              "description": "Ícone exibido no item do menu.\nUtilize esta propriedade para definir o ícone que será mostrado ao lado do conteúdo do item.",
+              "name": "custom-id",
+              "fieldName": "customId",
+              "default": "`br-menu-info-${MenuInfoId++}`",
+              "description": "Identificador único.\nCaso não seja fornecido, um ID gerado automaticamente será usado.",
               "type": {
                 "text": "string"
               }
             },
             {
-              "name": "href",
-              "fieldName": "href",
-              "default": "'#'",
-              "description": "URL de destino do link do item do menu.\nUtilize esta propriedade para definir o endereço para onde o usuário será direcionado ao clicar no item.",
+              "name": "info",
+              "fieldName": "info",
+              "description": "Informações adicionais em formato de texto",
               "type": {
                 "text": "string"
               }
-            },
-            {
-              "name": "target",
-              "fieldName": "target",
-              "default": "'_blank'",
-              "description": "Define como o link será aberto.\n- `_self`: abre no mesmo contexto de navegação (padrão)\n- `_blank`: abre em nova aba ou janela\n- `_parent`: abre no contexto pai\n- `_top`: abre no contexto de nível superior",
-              "type": {
-                "text": "'_self' | '_blank' | '_parent' | '_top'"
-              }
-            },
-            {
-              "name": "divider",
-              "fieldName": "divider",
-              "default": "false",
-              "description": "Define se o item deve exibir um divisor visual.\nQuando ativado, adiciona uma linha separadora para organizar visualmente os itens do menu.",
-              "type": {
-                "text": "boolean"
-              }
-            },
-            {
-              "name": "active",
-              "fieldName": "active",
-              "default": "false",
-              "description": "Define se o item do menu está ativo/selecionado.\nQuando ativado, aplica estilos visuais para destacar o item como atual ou selecionado.",
-              "type": {
-                "text": "boolean"
-              }
-            },
-            {
-              "name": "display-mode",
-              "fieldName": "displayMode",
-              "default": "'none'",
-              "description": "Define o modo de exibição do item, controlando os ícones de expansão.\n- `accordion`: exibe setas para cima/baixo (usado em menus de nível 0).\n- `drill-down`: exibe seta para a direita (usado em menus de níveis 1+).\n- `none`: não exibe ícones de expansão.",
-              "type": {
-                "text": "'accordion' | 'drill-down' | 'none'"
-              }
-            },
-            {
-              "name": "expanded",
-              "fieldName": "expanded",
-              "default": "false",
-              "description": "Indica se o item está expandido para fins de acessibilidade (ARIA).\nEste estado é controlado externamente (por exemplo, por br-menu-list).\nNão altera o estado visual de \"active\".",
-              "type": {
-                "text": "boolean"
-              }
             }
           ],
-          "tagName": "br-menu-item",
+          "tagName": "br-menu-info",
           "events": [],
           "customElement": true
         }
@@ -17315,18 +17972,18 @@
       "exports": [
         {
           "kind": "js",
-          "name": "MenuItem",
+          "name": "MenuInfo",
           "declaration": {
-            "name": "MenuItem",
-            "module": "components/menu-item/menu-item.js"
+            "name": "MenuInfo",
+            "module": "components/menu-info/menu-info.js"
           }
         },
         {
           "kind": "custom-element-definition",
-          "name": "br-menu-item",
+          "name": "br-menu-info",
           "declaration": {
-            "name": "MenuItem",
-            "module": "components/menu-item/menu-item.js"
+            "name": "MenuInfo",
+            "module": "components/menu-info/menu-info.js"
           }
         }
       ]
@@ -17979,6 +18636,114 @@
         }
       ]
     },
+    {
+      "kind": "javascript-module",
+      "path": "components/select-option/select-option.js",
+      "declarations": [
+        {
+          "kind": "class",
+          "description": "## Design System\n\nO `br-select-option` é um subcomponente lógico de `br-select`, usado para\ndeclarar opções de forma declarativa no HTML.",
+          "name": "SelectOption",
+          "slots": [
+            {
+              "description": "Texto opcional da opção. Usado como fallback para `label`.",
+              "name": "default"
+            }
+          ],
+          "members": [
+            {
+              "kind": "field",
+              "name": "label",
+              "type": {
+                "text": "string | undefined"
+              },
+              "description": "Rótulo da opção. Quando omitido, o texto do slot é usado."
+            },
+            {
+              "kind": "field",
+              "name": "value",
+              "type": {
+                "text": "string | undefined"
+              },
+              "description": "Valor da opção."
+            },
+            {
+              "kind": "field",
+              "name": "selected",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Indica se a opção está selecionada."
+            },
+            {
+              "kind": "method",
+              "name": "handlePropsChange"
+            },
+            {
+              "kind": "method",
+              "name": "render"
+            }
+          ],
+          "attributes": [
+            {
+              "name": "label",
+              "fieldName": "label",
+              "description": "Rótulo da opção. Quando omitido, o texto do slot é usado.",
+              "type": {
+                "text": "string"
+              }
+            },
+            {
+              "name": "value",
+              "fieldName": "value",
+              "description": "Valor da opção.",
+              "type": {
+                "text": "string"
+              }
+            },
+            {
+              "name": "selected",
+              "fieldName": "selected",
+              "default": "false",
+              "description": "Indica se a opção está selecionada.",
+              "type": {
+                "text": "boolean"
+              }
+            }
+          ],
+          "tagName": "br-select-option",
+          "events": [
+            {
+              "name": "brSelectOptionPropsChange",
+              "type": {
+                "text": "EventEmitter<void>"
+              },
+              "description": "Notifica o componente pai sobre mudanças de props ou conteúdo."
+            }
+          ],
+          "customElement": true
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "SelectOption",
+          "declaration": {
+            "name": "SelectOption",
+            "module": "components/select-option/select-option.js"
+          }
+        },
+        {
+          "kind": "custom-element-definition",
+          "name": "br-select-option",
+          "declaration": {
+            "name": "SelectOption",
+            "module": "components/select-option/select-option.js"
+          }
+        }
+      ]
+    },
     {
       "kind": "javascript-module",
       "path": "components/skip-link-item/skip-link-item.js",
@@ -18236,14 +19001,6 @@
           "description": "## Design System\n\nPara a documentação completa de design, incluindo diretrizes de uso, acessibilidade e exemplos visuais, consulte o [Design System do GovBR](https://www.gov.br/ds/components/step?tab=designer).",
           "name": "StepItem",
           "cssParts": [
-            {
-              "description": "Parte para o contêiner externo do item do step, usada para estilizar posicionamento e espaçamento via ::part().",
-              "name": "item-container"
-            },
-            {
-              "description": "Parte para o contêiner interno com indicador visual e label, usada para estilizar conteúdo via ::part().",
-              "name": "item-content"
-            },
             {
               "description": "Parte para o contêiner do texto da etapa, usada para estilizar tipografia e cor via ::part().",
               "name": "label"
@@ -18252,7 +19009,7 @@
           "slots": [
             {
               "description": "Slot para conteúdo customizado dentro do botão do item do step.",
-              "name": "label-area"
+              "name": "content-area"
             }
           ],
           "members": [
@@ -18304,7 +19061,7 @@
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Propriedade que define se o item Step está com estado desativado.."
+              "description": "Propriedade que define se o item Step está com estado desativado."
             },
             {
               "kind": "field",
@@ -18388,25 +19145,6 @@
               },
               "default": "''"
             },
-            {
-              "kind": "method",
-              "name": "watchItemIsActive",
-              "parameters": [
-                {
-                  "name": "newValue",
-                  "type": {
-                    "text": "boolean"
-                  }
-                },
-                {
-                  "name": "oldValue",
-                  "type": {
-                    "text": "boolean"
-                  }
-                }
-              ],
-              "description": "Watch que observa o valor da propriedade active, e ao alterar seu valor este método altera o valor do campo de acessibilidade aria-selected"
-            },
             {
               "kind": "method",
               "name": "setStepItemPositionStatus",
@@ -18490,57 +19228,7 @@
             },
             {
               "kind": "method",
-              "name": "getStepContainerClassMap",
-              "privacy": "private",
-              "return": {
-                "type": {
-                  "text": "CssClassMap"
-                }
-              }
-            },
-            {
-              "kind": "method",
-              "name": "getStepItemContentClassMap",
-              "privacy": "private",
-              "return": {
-                "type": {
-                  "text": "CssClassMap"
-                }
-              }
-            },
-            {
-              "kind": "method",
-              "name": "getStepItemIndicatorAreaClassMap",
-              "privacy": "private",
-              "return": {
-                "type": {
-                  "text": "CssClassMap"
-                }
-              }
-            },
-            {
-              "kind": "method",
-              "name": "getStepItemLabelAreaClassMap",
-              "privacy": "private",
-              "return": {
-                "type": {
-                  "text": "CssClassMap"
-                }
-              }
-            },
-            {
-              "kind": "method",
-              "name": "getHighlightClass",
-              "privacy": "private",
-              "return": {
-                "type": {
-                  "text": "CssClassMap"
-                }
-              }
-            },
-            {
-              "kind": "method",
-              "name": "getStepItemIndicatorClass",
+              "name": "getAlertClass",
               "privacy": "private",
               "return": {
                 "type": {
@@ -18602,7 +19290,7 @@
               "name": "disabled",
               "fieldName": "disabled",
               "default": "false",
-              "description": "Propriedade que define se o item Step está com estado desativado..",
+              "description": "Propriedade que define se o item Step está com estado desativado.",
               "type": {
                 "text": "boolean"
               }
@@ -18627,20 +19315,10 @@
             }
           ],
           "tagName": "br-step-item",
-          "csspart": [
-            {
-              "name": "item-container",
-              "description": "Parte para o contêiner externo do item do step, usada para estilizar posicionamento e espaçamento via ::part()."
-            },
-            {
-              "name": "item-content",
-              "description": "Parte para o contêiner interno com indicador visual e label, usada para estilizar conteúdo via ::part()."
-            },
-            {
-              "name": "label",
-              "description": "Parte para o contêiner do texto da etapa, usada para estilizar tipografia e cor via ::part()."
-            }
-          ],
+          "csspart": {
+            "name": "label",
+            "description": "Parte para o contêiner do texto da etapa, usada para estilizar tipografia e cor via ::part()."
+          },
           "events": [
             {
               "name": "brWillRender",