@govbr-ds/webcomponents 2.1.0 → 2.1.1

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

@@ -0,0 +1,1372 @@
+/*!
+ * Construído por SERPRO
+ * © https://serpro.gov.br/ - MIT License.
+ */
+import { Host, h, } from "@stencil/core";
+import { getEventPath, isEventTargetInside } from "../../shared/utils/event";
+import { captureFocus, getDeepActiveElement, restoreFocus } from "../../shared/utils/focus";
+import { getNextEnabledElement } from "../../shared/utils/getNextElement";
+import { generateUniqueId } from "../../shared/utils/id";
+import { supportsNativeModalDialog, syncNativeModalDialog } from "../../shared/utils/native-dialog";
+/**
+ * ## Design System
+ *
+ * Para a documentação completa de design, incluindo diretrizes de uso, acessibilidade e exemplos visuais, consulte o [Design System do GovBR](https://www.gov.br/ds/components/menu?tab=designer).
+ *
+ * ### Comportamento de Acionamento Automático
+ * O menu monitora eventos de clique globais no documento. Qualquer elemento que possua o atributo `data-toggle="menu"`
+ * e cujo `data-target` coincida com o ID ou `customId` do menu (ou seja omitido) irá alternar automaticamente o estado do menu (`isOpen`).
+ *
+ * @category Navegação
+ * @status stable
+ * @slot default - Slot para o conteúdo principal do menu (menu-list, menu-group e menu-item).
+ * @slot header - Slot para o cabeçalho do menu, exibido apenas em modo não contextual e não push.
+ * @slot logo - Slot para logotipos de parceiros no rodapé.
+ * @slot link - Slot para links externos no rodapé (use br-menu-link).
+ * @slot social - Slot para ícones de redes sociais no rodapé.
+ * @slot info - Slot para informações adicionais no rodapé.
+ *
+ * @part footer - Parte para o contêiner principal do rodapé do menu, agrupando logos, links, redes sociais e informações.
+ * @part logo - Parte para a área de logotipos de parceiros no rodapé.
+ * @part link - Parte para links úteis ou navegação secundária no rodapé.
+ * @part social - Parte para ícones de redes sociais no rodapé.
+ * @part info - Parte para informações adicionais, como licença ou direitos autorais.
+ * @part container - Parte para o container externo que envolve o menu inteiro.
+ * @part panel - Parte para o painel de navegação do menu (o menu propriamente dito).
+ * @part body - Parte principal onde ficam os links e grupos de navegação.
+ * @part trigger - Botão de acionamento do menu (hambúrguer ou contextual).
+ * @part back-btn - Botão de voltar do menu de navegação drill-down.
+ */
+export class Menu {
+    constructor() {
+        // Representa o nível atual de navegação no drill-down (0 para o nível raiz)
+        this.currentLevel = 0;
+        // Controla quais menus drop-down estão expandidos no modo acordeão
+        this.expandedDropMenus = {};
+        // Indica se o menu está exibindo um submenu (drill-down ativo)
+        this.isInSubmenu = false;
+        // Pilha de navegação para controle do drill-down e navegação de volta
+        this.navigationStack = [];
+        /**
+         * Identificador único do componente.
+         * Quando omitido, um valor é gerado automaticamente.
+         *
+         * > **Padrão:** valor único gerado por generateUniqueId().
+         */
+        this.customId = generateUniqueId();
+        /**
+         * Classes CSS para definir breakpoints responsivos do menu.
+         * Utilize esta propriedade para controlar a largura do menu em diferentes tamanhos de tela.
+         * Por padrão não aplica colunas; quando contextual e sem valor definido, usa `col-sm-4 col-lg-3`.
+         */
+        this.breakpoints = '';
+        /**
+         * Define se o menu deve usar comportamento push.
+         * Quando ativado, o menu permanece fixo na lateral e empurra o conteúdo principal.
+         */
+        this.push = false;
+        /**
+         * Mantém o menu como uma barra lateral fixa quando estiver aberto.
+         * O menu continua podendo ser ocultado alterando `isOpen` ou chamando `close()`.
+         * A largura padrão é `20rem`, limitada à viewport, e pode ser sobrescrita
+         * pela variável CSS `--menu-fixed-width`.
+         */
+        this.fixed = false;
+        /**
+         * Define se o painel do menu está aberto/visível.
+         * Em modo push, esta propriedade permite controle externo da visibilidade.
+         * O nome permanece porque o método público `open()` já ocupa a propriedade `open` no host.
+         */
+        this.isOpen = false;
+        /**
+         * Define se o menu deve usar comportamento contextual (aparece na parte inferior).
+         * Quando ativado, o menu é posicionado na parte inferior da tela em dispositivos móveis.
+         */
+        this.contextual = false;
+        /**
+         * Define a densidade dos itens do menu, alterando o espaçamento interno.
+         * - `small` (densidade alta): itens mais compactos
+         * - `medium` (padrão): equilíbrio entre economia de espaço e separação
+         * - `large` (densidade baixa): maior espaçamento (recomendado em touch)
+         */
+        this.density = 'medium';
+        /**
+         * Título da seção de redes sociais exibida no rodapé do menu.
+         * Utilize esta propriedade para personalizar o texto que aparece acima dos ícones sociais.
+         */
+        this.socialTitle = 'Redes Sociais';
+        /**
+         * Rótulo do botão trigger do menu contextual.
+         * Exibido apenas em modo contextual e em telas menores (mobile).
+         */
+        this.contextualLabel = 'Menu Contextual';
+        // Armazena o elemento que tinha foco antes do menu abrir (para restaurar o foco ao fechar)
+        this.previouslyFocusedElement = null;
+        // IDs dos requestAnimationFrame para cancelamento no cleanup
+        this.rafIds = [];
+        this.scrimRef = null;
+        this.nativeDialogRef = null;
+        this.activeMenuItem = null;
+        this.handleNativeCancel = (event) => {
+            event.preventDefault();
+            this.applyOpenState(false);
+        };
+        this.onToggleClick = () => {
+            this.applyOpenState(!this.isOpen);
+        };
+        this.onGoBackClick = () => {
+            this.goBack();
+        };
+    }
+    // O @Watch dispara após isOpen já ter sido atualizado pelo Stencil.
+    // Por isso, aqui ficam apenas os side effects (foco, reset de navegação) — não há loop.
+    onOpenChange(isOpening) {
+        this.brMenuStateChange.emit({ isOpen: isOpening });
+        this.brMenuOpenChange.emit({ open: isOpening, sourceId: this.el.id || this.customId });
+        if (isOpening) {
+            this.previouslyFocusedElement = captureFocus(this.el.ownerDocument);
+            const rafId = requestAnimationFrame(() => this.focusFirstVisibleTarget());
+            this.rafIds.push(rafId);
+            return;
+        }
+        this.isInSubmenu = false;
+        this.resetNavigation();
+        if (this.previouslyFocusedElement) {
+            restoreFocus(this.previouslyFocusedElement);
+            this.previouslyFocusedElement = null;
+        }
+    }
+    /**
+     * Método do ciclo de vida do componente.
+     * Este método é chamado quando o componente é desconectado do DOM.
+     * Realiza limpeza de recursos para evitar vazamento de memória.
+     */
+    disconnectedCallback() {
+        // Cancela todos os requestAnimationFrame pendentes
+        this.rafIds.forEach((id) => {
+            cancelAnimationFrame(id);
+        });
+        this.rafIds = [];
+    }
+    componentDidLoad() {
+        // Garante que apenas um item tenha active no carregamento inicial
+        this.ensureSingleActiveItem();
+        this.syncNativeDialog();
+    }
+    componentDidRender() {
+        this.syncNativeDialog();
+    }
+    onMenuItemClick(ev) {
+        // Busca o menu-item mais próximo do alvo do clique
+        const path = getEventPath(ev);
+        let menuItemHost = null;
+        // Percorre o caminho do evento para encontrar o br-menu-item
+        for (const element of path) {
+            if (element instanceof HTMLElement && element.tagName === 'BR-MENU-ITEM') {
+                menuItemHost = element;
+                break;
+            }
+            // Para quando chegar no host do menu
+            if (element === this.el)
+                break;
+        }
+        if (!menuItemHost || !this.el.contains(menuItemHost))
+            return;
+        // Ignora se for um header de menu-list (folder/dropdown que tem filhos)
+        // Menus que expandem/têm submenus não devem receber classe active
+        const parentMenuList = menuItemHost.parentElement;
+        if (parentMenuList?.tagName === 'BR-MENU-LIST') {
+            // Se é filho direto de br-menu-list, verifica se é o header (primeiro br-menu-item)
+            const header = parentMenuList.shadowRoot?.querySelector('br-menu-item');
+            if (header === menuItemHost) {
+                // É um header de folder, não deve receber active
+                return;
+            }
+        }
+        // Também verifica via atributo display-mode
+        const displayMode = menuItemHost.getAttribute('display-mode');
+        if (displayMode && displayMode !== 'none') {
+            return;
+        }
+        if (this.activeMenuItem !== null && this.activeMenuItem !== menuItemHost) {
+            this.activeMenuItem.active = false;
+        }
+        this.activeMenuItem = menuItemHost;
+        this.activeMenuItem.active = true;
+    }
+    // biome-ignore lint/complexity/noExcessiveCognitiveComplexity: fluxo de teclado centraliza múltiplos modos de navegação e armadilha de foco.
+    onKeyDown(ev) {
+        // Permite ativar o botão contextual com Enter ou Espaço quando o menu está fechado
+        if (!this.isOpen && this.contextual && (ev.key === 'Enter' || ev.key === ' ')) {
+            const target = ev.target;
+            const isContextualButton = target?.closest?.('#contextual-trigger') || target?.id === 'contextual-trigger';
+            if (isContextualButton) {
+                ev.preventDefault();
+                this.applyOpenState(!this.isOpen);
+                return;
+            }
+        }
+        if (!this.isOpen)
+            return;
+        if (this.usesNativeDialog && supportsNativeModalDialog() && !isEventTargetInside(ev, this.el))
+            return;
+        const targetEl = ev.target;
+        const isFormField = targetEl &&
+            (targetEl.tagName === 'INPUT' ||
+                targetEl.tagName === 'TEXTAREA' ||
+                targetEl.tagName === 'SELECT' ||
+                targetEl.isContentEditable);
+        // Focus trap: gerencia Tab/Shift+Tab para manter o foco dentro do menu
+        if (ev.key === 'Tab') {
+            const focusableElements = this.getFocusableElements();
+            if (focusableElements.length === 0)
+                return;
+            const firstElement = focusableElements[0];
+            const lastElement = focusableElements[focusableElements.length - 1];
+            const deepActive = getDeepActiveElement(this.el.getRootNode());
+            // Se Tab sem Shift e está no último elemento, volta para o primeiro
+            if (!ev.shiftKey && deepActive === lastElement) {
+                ev.preventDefault();
+                firstElement.focus();
+                return;
+            }
+            // Se Shift+Tab e está no primeiro elemento, vai para o último
+            if (ev.shiftKey && deepActive === firstElement) {
+                ev.preventDefault();
+                lastElement.focus();
+                return;
+            }
+        }
+        // Voltar/fechar
+        if (this.isInSubmenu && (ev.key === 'ArrowLeft' || ev.key === 'Backspace' || ev.key === 'Escape')) {
+            ev.preventDefault();
+            this.goBack();
+            return;
+        }
+        if (!this.isInSubmenu && ev.key === 'Escape') {
+            ev.preventDefault();
+            if (!this.push && !this.fixed)
+                this.applyOpenState(false);
+            return;
+        }
+        // Navegação global por setas (fallback para todos os tipos de menu)
+        if (!isFormField && (ev.key === 'ArrowDown' || ev.key === 'ArrowUp')) {
+            const deepActive = getDeepActiveElement(this.el.getRootNode());
+            if (deepActive == null || !this.isNodeWithinHost(deepActive))
+                return;
+            ev.preventDefault();
+            ev.stopPropagation();
+            // No modo contextual ou quando não há drill-down ativo, navega por todos os itens visíveis
+            const useGlobalNavigation = this.contextual || !this.isInSubmenu;
+            const targets = useGlobalNavigation ? this.getAllVisibleTargets() : this.getScopedTargets(deepActive);
+            if (targets.length === 0)
+                return;
+            let index = targets.findIndex((t) => t === deepActive || (deepActive instanceof Node && t.contains(deepActive)));
+            if (index === -1)
+                index = 0;
+            const nextTarget = getNextEnabledElement(targets, targets[index], ev.key === 'ArrowDown' ? 'forward' : 'backward');
+            nextTarget?.focus();
+        }
+    }
+    /**
+     * Escuta cliques no documento para alternar o estado do menu automaticamente
+     * quando um elemento com o atributo `data-toggle="menu"` é clicado.
+     * Utiliza o caminho completo do evento (composedPath) para permitir o funcionamento
+     * correto quando o botão acionador está dentro de outros componentes com Shadow DOM (ex: br-header).
+     */
+    onDocumentClick(ev) {
+        const path = getEventPath(ev);
+        let toggleBtn = null;
+        for (const target of path) {
+            if (target instanceof HTMLElement &&
+                target.hasAttribute('data-toggle') &&
+                target.getAttribute('data-toggle') === 'menu') {
+                toggleBtn = target;
+                break;
+            }
+        }
+        if (toggleBtn) {
+            const targetId = toggleBtn.getAttribute('data-target');
+            if (!targetId || targetId === `#${this.el.id}` || targetId === this.el.id || targetId === this.customId) {
+                this.applyOpenState(!this.isOpen);
+            }
+        }
+    }
+    onNavigateToSubmenu(ev) {
+        const { element, label } = ev.detail;
+        const itemId = element.getAttribute('data-menu-id') || `menu-${Date.now()}`;
+        // Obter o nível real do menu do elemento
+        const menuLevel = parseInt(element.getAttribute('menu-level') || '0', 10);
+        // Aplicar a regra principal: comportamento por nível
+        if (menuLevel === 0 && !this.push && !this.fixed) {
+            // Camada 1: Comportamento de acordeão
+            this.toggleDropMenu(itemId);
+        }
+        else {
+            // Modo push e camadas 2+: comportamento drill-down
+            this.navigateToLevel({ element, label, id: itemId });
+        }
+    }
+    onFolderToggled(ev) {
+        const element = ev.target;
+        const itemId = element.getAttribute('data-menu-id') || `menu-${Date.now()}`;
+        if (ev.detail) {
+            // Se o folder foi expandido, fecha todos os outros no nível 0
+            this.collapseOtherFolders(itemId);
+        }
+    }
+    onMenuToggle(ev) {
+        const targetId = ev.detail?.target;
+        if (targetId) {
+            if (targetId === `#${this.el.id}` || targetId === this.el.id || targetId === this.customId) {
+                this.applyOpenState(!this.isOpen);
+            }
+        }
+        else {
+            if (isEventTargetInside(ev, this.el) || !this.isEventTargetInsideAnyMenu(ev)) {
+                this.applyOpenState(!this.isOpen);
+            }
+        }
+    }
+    isEventTargetInsideAnyMenu(ev) {
+        return getEventPath(ev).some((target) => target instanceof HTMLElement && target.tagName === 'BR-MENU');
+    }
+    onScrimClose(ev) {
+        if (this.scrimRef === null || !isEventTargetInside(ev, this.scrimRef))
+            return;
+        if (!this.push && !this.fixed && !this.contextual) {
+            this.applyOpenState(false);
+        }
+    }
+    onMenuGoBack() {
+        this.goBack();
+    }
+    /**
+     * Abre o painel do menu.
+     * Pode ser chamado externamente: `menuEl.open()`.
+     */
+    async open() {
+        this.applyOpenState(true);
+    }
+    /**
+     * Fecha o painel do menu.
+     * Pode ser chamado externamente: `menuEl.close()`.
+     */
+    async close() {
+        this.applyOpenState(false);
+    }
+    /**
+     * Alterna o estado do painel do menu (abre se fechado, fecha se aberto).
+     * Pode ser chamado externamente: `menuEl.toggle()`.
+     */
+    async toggle() {
+        this.applyOpenState(!this.isOpen);
+    }
+    get usesNativeDialog() {
+        return !this.push && !this.fixed && !this.contextual;
+    }
+    syncNativeDialog() {
+        syncNativeModalDialog(this.nativeDialogRef, this.isOpen && this.usesNativeDialog);
+    }
+    ensureSingleActiveItem() {
+        const allMenuItems = this.el.querySelectorAll('br-menu-item');
+        let firstActiveItem = null;
+        this.activeMenuItem = null;
+        // Encontra o primeiro item com active e remove dos demais
+        for (let i = 0; i < allMenuItems.length; i++) {
+            const item = allMenuItems[i];
+            // Verifica se o item tem active
+            if (item.active || item.hasAttribute('active')) {
+                // Se é um header de menu-list (folder), remove o active
+                const displayMode = item.getAttribute('display-mode');
+                if (displayMode && displayMode !== 'none') {
+                    item.active = false;
+                    item.removeAttribute('active');
+                    continue;
+                }
+                // Se já encontramos um item ativo antes, remove deste
+                if (firstActiveItem) {
+                    item.active = false;
+                    item.removeAttribute('active');
+                }
+                else {
+                    // É o primeiro item ativo válido
+                    firstActiveItem = item;
+                    item.active = true;
+                    this.activeMenuItem = item;
+                }
+            }
+        }
+    }
+    /**
+     * Alterna o estado expandido de um menu drop-down no modo acordeão.
+     *
+     * Este método recebe o identificador único (`itemId`) de um menu do tipo drop-down (nível 0)
+     * e inverte o seu estado de expansão dentro do objeto `expandedDropMenus`.
+     *
+     * Se o menu estiver atualmente expandido, ele será recolhido; se estiver recolhido, será expandido.
+     * O spread operator (`...this.expandedDropMenus`) garante que os estados dos outros menus sejam preservados.
+     *
+     * @param itemId - Identificador único do menu drop-down a ser alternado.
+     */
+    toggleDropMenu(itemId) {
+        this.expandedDropMenus = {
+            ...this.expandedDropMenus,
+            [itemId]: !this.expandedDropMenus[itemId],
+        };
+    }
+    /**
+     * Recolhe todos os folders do nível 0, exceto o especificado.
+     * Garante que apenas um folder possa estar expandido por vez no comportamento acordeão.
+     *
+     * @param activeItemId - ID do folder que deve permanecer expandido
+     */
+    collapseOtherFolders(activeItemId) {
+        // Encontra todos os menu-list no nível 0
+        const level0MenuLists = this.el.querySelectorAll('br-menu-list[menu-level="0"]');
+        level0MenuLists.forEach((menuList) => {
+            const element = menuList;
+            const itemId = element.getAttribute('data-menu-id');
+            // Se é um folder diferente do ativo, força o recolhimento
+            if (itemId && itemId !== activeItemId) {
+                // Força o estado recolhido no menu-list
+                element.expanded = false;
+                // Remove do estado de expandedDropMenus
+                if (this.expandedDropMenus[itemId]) {
+                    this.expandedDropMenus = {
+                        ...this.expandedDropMenus,
+                        [itemId]: false,
+                    };
+                }
+            }
+        });
+    }
+    /**
+     * Navega para um nível específico do menu (drill-down).
+     *
+     * Este método é chamado quando o usuário interage com um item de menu de nível 2 ou superior,
+     * ou seja, quando o comportamento esperado é de drill-down (aprofundamento em submenus).
+     *
+     * Funcionamento:
+     * 1. Adiciona o item atual à pilha de navegação (`navigationStack`), permitindo que o usuário volte para níveis anteriores.
+     * 2. Obtém o nível do menu a partir do atributo `menu-level` do elemento clicado.
+     * 3. Atualiza o estado `currentLevel` para refletir o novo nível de profundidade (sempre um nível abaixo do atual).
+     * 4. Define `inSubmenu` como `true`, indicando que o usuário está navegando em um submenu.
+     * 5. Oculta todos os itens do menu, exceto o submenu selecionado, para garantir foco e clareza na navegação.
+     * 6. Marca o elemento ativo como "drill active" para controle visual e de acessibilidade.
+     *
+     * @param item - Objeto contendo o elemento do menu, seu rótulo e identificador único.
+     */
+    navigateToLevel(item) {
+        // Adiciona o item à pilha de navegação para possibilitar o retorno (back)
+        this.navigationStack = [...this.navigationStack, item];
+        // Obtém o nível do menu a partir do atributo do elemento
+        const menuLevel = parseInt(item.element.getAttribute('menu-level') || '0', 10);
+        // Atualiza o nível atual para o próximo nível após o elemento clicado
+        this.currentLevel = menuLevel + 1;
+        // Indica que estamos em um submenu (drill-down ativo)
+        this.isInSubmenu = true;
+        // Oculta todos os menus, exceto o submenu selecionado
+        this.hideAllExcept(item.element);
+        // Marca o submenu como ativo para controle visual e de acessibilidade
+        this.setDrillActive(item.element, true);
+        // Após entrar no submenu, foca no primeiro item visível
+        const rafId = requestAnimationFrame(() => this.focusFirstChildOfList(item.element));
+        this.rafIds.push(rafId);
+    }
+    focusFirstChildOfList(listEl) {
+        const slotEl = listEl.shadowRoot?.querySelector('ul slot');
+        const assigned = slotEl?.assignedElements?.() || [];
+        for (const el of assigned) {
+            if (el.tagName === 'BR-MENU-ITEM') {
+                const anchor = el.shadowRoot?.querySelector('a');
+                if (this.isVisibleElement(el) && this.isVisibleElement(anchor)) {
+                    anchor.focus();
+                    return;
+                }
+            }
+            else if (el.tagName === 'BR-MENU-LIST') {
+                const header = el.shadowRoot?.querySelector('br-menu-item');
+                const anchor = header?.shadowRoot?.querySelector('a');
+                if (this.isVisibleElement(el) && this.isVisibleElement(anchor)) {
+                    anchor.focus();
+                    return;
+                }
+            }
+        }
+    }
+    // Ponto de mutação de isOpen: faz o guard e seta a prop.
+    // A mudança em isOpen dispara o @Watch, que executa os side effects.
+    applyOpenState(nextOpen) {
+        if (this.isOpen === nextOpen)
+            return;
+        this.isOpen = nextOpen;
+    }
+    resetNavigation() {
+        if (this.navigationStack.length > 0)
+            this.navigationStack = [];
+        if (this.currentLevel !== 0)
+            this.currentLevel = 0;
+        if (Object.keys(this.expandedDropMenus).length > 0)
+            this.expandedDropMenus = {};
+        this.clearAllDrillMarkers();
+        this.showAllMenuItems();
+    }
+    isVisibleElement(el) {
+        if (el == null)
+            return false;
+        const htmlEl = el;
+        if (!htmlEl.isConnected)
+            return false;
+        if (htmlEl.hasAttribute('hidden'))
+            return false;
+        const rects = htmlEl.getClientRects?.();
+        return rects != null && rects.length > 0;
+    }
+    // biome-ignore lint/complexity/noExcessiveCognitiveComplexity: montagem de foco precisa tratar tipos heterogêneos de itens no topo.
+    getTopLevelTargets() {
+        const targets = [];
+        const bodySlot = this.el.shadowRoot?.querySelector('nav.menu-body slot:not([name])');
+        const children = bodySlot?.assignedElements?.() || [];
+        for (const child of children) {
+            if (child.tagName === 'BR-MENU-ITEM') {
+                if (!this.isVisibleElement(child))
+                    continue;
+                const anchor = child.shadowRoot?.querySelector('a');
+                if (this.isVisibleElement(anchor))
+                    targets.push(anchor);
+            }
+            else if (child.tagName === 'BR-MENU-LIST') {
+                if (!this.isVisibleElement(child))
+                    continue;
+                const header = child.shadowRoot?.querySelector('br-menu-item');
+                const anchor = header?.shadowRoot?.querySelector('a');
+                if (this.isVisibleElement(anchor))
+                    targets.push(anchor);
+            }
+            else if (child.tagName === 'BR-MENU-GROUP') {
+                this.collectTopLevelGroupTargets(child, targets);
+            }
+        }
+        return targets;
+    }
+    // biome-ignore lint/complexity/noExcessiveCognitiveComplexity: grupos estáticos são transparentes e podem conter pastas aninhadas.
+    collectTopLevelGroupTargets(group, targets) {
+        if (!this.isVisibleElement(group))
+            return;
+        for (const child of Array.from(group.children)) {
+            if (child.tagName === 'BR-MENU-ITEM') {
+                const anchor = child.shadowRoot?.querySelector('a');
+                if (this.isVisibleElement(child) && this.isVisibleElement(anchor))
+                    targets.push(anchor);
+            }
+            else if (child.tagName === 'BR-MENU-LIST') {
+                const header = child.shadowRoot?.querySelector('br-menu-item');
+                const anchor = header?.shadowRoot?.querySelector('a');
+                if (this.isVisibleElement(child) && this.isVisibleElement(anchor))
+                    targets.push(anchor);
+            }
+            else if (child.tagName === 'BR-MENU-GROUP') {
+                this.collectTopLevelGroupTargets(child, targets);
+            }
+        }
+    }
+    /**
+     * Obtém todos os elementos navegáveis visíveis no menu, incluindo itens dentro de agrupamentos expandidos.
+     * Utilizado para navegação global por setas no modo contextual.
+     */
+    getAllVisibleTargets() {
+        const targets = [];
+        const bodySlot = this.el.shadowRoot?.querySelector('nav.menu-body slot:not([name])');
+        const children = bodySlot?.assignedElements?.() || [];
+        for (const child of children) {
+            this.collectVisibleTargetsFrom(child, targets);
+        }
+        return targets;
+    }
+    /**
+     * Coleta recursivamente todos os targets visíveis de um elemento e seus descendentes.
+     * Respeita o estado expandido/recolhido dos agrupamentos.
+     */
+    // biome-ignore lint/complexity/noExcessiveCognitiveComplexity: travessia recursiva respeita visibilidade, slots e estado expandido dos agrupamentos.
+    collectVisibleTargetsFrom(element, targets) {
+        if (element.tagName === 'BR-MENU-ITEM') {
+            if (!this.isVisibleElement(element))
+                return;
+            const anchor = element.shadowRoot?.querySelector('a');
+            if (this.isVisibleElement(anchor)) {
+                targets.push(anchor);
+            }
+        }
+        else if (element.tagName === 'BR-MENU-LIST') {
+            if (!this.isVisibleElement(element))
+                return;
+            // Adiciona o header do menu-list
+            const header = element.shadowRoot?.querySelector('br-menu-item');
+            const headerAnchor = header?.shadowRoot?.querySelector('a');
+            if (this.isVisibleElement(headerAnchor)) {
+                targets.push(headerAnchor);
+            }
+            // Verifica se o menu-list está expandido antes de processar os filhos
+            const menuListEl = element;
+            const isExpanded = menuListEl.expanded || menuListEl.hasAttribute('expanded');
+            if (isExpanded) {
+                // Verifica também se o <ul> está realmente visível (para nível 0 que usa display:none)
+                const ulElement = element.shadowRoot?.querySelector('ul');
+                const isUlVisible = ulElement ? this.isVisibleElement(ulElement) : false;
+                if (isUlVisible) {
+                    // Coleta os filhos do slot do menu-list
+                    const slotEl = ulElement?.querySelector('slot');
+                    const assigned = slotEl?.assignedElements?.() || [];
+                    for (const child of assigned) {
+                        this.collectVisibleTargetsFrom(child, targets);
+                    }
+                }
+            }
+        }
+        else if (element.tagName === 'BR-MENU-GROUP') {
+            if (!this.isVisibleElement(element))
+                return;
+            for (const child of Array.from(element.children)) {
+                this.collectVisibleTargetsFrom(child, targets);
+            }
+        }
+    }
+    /**
+     * Obtém targets com escopo limitado ao menu-list mais próximo (usado em drill-down).
+     */
+    getScopedTargets(deepActive) {
+        const listScope = this.findClosestMenuListFrom(deepActive);
+        return listScope ? this.getTargetsForMenuList(listScope) : this.getTopLevelTargets();
+    }
+    isNodeWithinHost(node) {
+        let current = node;
+        while (current != null) {
+            if (current === this.el)
+                return true;
+            if (current instanceof Element && current.parentElement != null) {
+                current = current.parentElement;
+            }
+            else {
+                const rootNode = (current instanceof Element ? current.getRootNode() : current);
+                current = rootNode != null && 'host' in rootNode ? rootNode.host : null;
+            }
+        }
+        return false;
+    }
+    findClosestMenuListFrom(node) {
+        let current = node;
+        while (current != null) {
+            if (current instanceof Element && current.tagName === 'BR-MENU-LIST')
+                return current;
+            if (current instanceof Element && current.parentElement != null) {
+                current = current.parentElement;
+            }
+            else {
+                const rootNode = (current instanceof Element ? current.getRootNode() : current);
+                current = rootNode != null && 'host' in rootNode ? rootNode.host : null;
+            }
+        }
+        return null;
+    }
+    // biome-ignore lint/complexity/noExcessiveCognitiveComplexity: coleta focável depende de cabeçalho, itens diretos e listas internas atribuídas por slot.
+    getTargetsForMenuList(listEl) {
+        const targets = [];
+        const header = listEl.shadowRoot?.querySelector('br-menu-item');
+        const headerAnchor = header?.shadowRoot?.querySelector('a');
+        if (this.isVisibleElement(header) && this.isVisibleElement(headerAnchor))
+            targets.push(headerAnchor);
+        const slotEl = listEl.shadowRoot?.querySelector('ul slot');
+        const assigned = slotEl?.assignedElements?.() || [];
+        for (const el of assigned) {
+            if (el.tagName === 'BR-MENU-ITEM') {
+                const anchor = el.shadowRoot?.querySelector('a');
+                if (this.isVisibleElement(el) && this.isVisibleElement(anchor))
+                    targets.push(anchor);
+            }
+            else if (el.tagName === 'BR-MENU-LIST') {
+                const subHeader = el.shadowRoot?.querySelector('br-menu-item');
+                const subAnchor = subHeader?.shadowRoot?.querySelector('a');
+                if (this.isVisibleElement(el) && this.isVisibleElement(subAnchor))
+                    targets.push(subAnchor);
+            }
+        }
+        return targets;
+    }
+    focusFirstVisibleTarget() {
+        const targets = this.getTopLevelTargets();
+        if (targets.length > 0)
+            targets[0].focus();
+    }
+    /**
+     * Coleta recursivamente os elementos focáveis no modo drill-down.
+     * Respeita a ordem do DOM e a hierarquia dos elementos.
+     * Apenas coleta elementos que não têm o atributo 'hidden'.
+     */
+    // biome-ignore lint/complexity/noExcessiveCognitiveComplexity: algoritmo recursivo lida com menu-item, menu-list e contêineres auxiliares.
+    collectDrillDownTargets(element, targets) {
+        const children = Array.from(element.children);
+        for (const child of children) {
+            if (child.hasAttribute('hidden'))
+                continue;
+            if (!this.isVisibleElement(child))
+                continue;
+            if (child.tagName === 'BR-MENU-ITEM') {
+                const anchor = child.shadowRoot?.querySelector('a');
+                if (anchor && this.isVisibleElement(anchor)) {
+                    targets.push(anchor);
+                }
+            }
+            else if (child.tagName === 'BR-MENU-LIST') {
+                // Adiciona o header do menu-list
+                const header = child.shadowRoot?.querySelector('br-menu-item');
+                const headerAnchor = header?.shadowRoot?.querySelector('a');
+                if (headerAnchor && this.isVisibleElement(headerAnchor)) {
+                    targets.push(headerAnchor);
+                }
+                // Coleta recursivamente os filhos do menu-list
+                this.collectDrillDownTargets(child, targets);
+            }
+            else {
+                // Para outros elementos, continua a busca recursiva
+                this.collectDrillDownTargets(child, targets);
+            }
+        }
+    }
+    /**
+     * Obtém todos os elementos focáveis dentro do menu que estão visíveis.
+     * Inclui botões, links e outros elementos interativos.
+     * No modo contextual, inclui itens dentro de agrupamentos expandidos.
+     */
+    getFocusableElements() {
+        const focusable = [];
+        const menuPanel = this.el.shadowRoot?.querySelector('.menu-panel');
+        if (!menuPanel)
+            return focusable;
+        // Adiciona o botão trigger (toggle/contextual) como primeiro elemento com foco
+        const triggerButton = this.contextual
+            ? this.el.shadowRoot?.querySelector('#contextual-trigger')
+            : this.el.shadowRoot?.querySelector('#toggle-menu');
+        if (triggerButton) {
+            const button = triggerButton.shadowRoot?.querySelector('button');
+            if (button && this.isVisibleElement(button)) {
+                focusable.push(button);
+            }
+        }
+        // Busca o botão de voltar se estiver em submenu
+        const backButton = this.el.shadowRoot?.querySelector('.back-btn');
+        if (backButton && this.isVisibleElement(backButton)) {
+            focusable.push(backButton);
+        }
+        // No modo contextual ou quando não há drill-down, usa navegação global que respeita estado expandido
+        if (this.contextual || !this.isInSubmenu) {
+            const targets = this.getAllVisibleTargets();
+            focusable.push(...targets);
+        }
+        else {
+            // Em drill-down, coleta elementos na ordem do DOM respeitando a hierarquia
+            // O método hideAllExcept() já controla a visibilidade via atributo 'hidden'
+            this.collectDrillDownTargets(this.el, focusable);
+        }
+        return focusable;
+    }
+    // Eventos compostos dos itens projetados chegam ao host do menu.
+    /**
+     * Oculta todos os elementos do menu, exceto o elemento ativo e sua cadeia de ancestrais,
+     * garantindo que apenas o submenu relevante esteja visível durante a navegação drill-down.
+     *
+     * Funcionamento detalhado:
+     * 1. Oculta todos os elementos <br-menu-list> e <br-menu-item> do menu, aplicando o atributo 'hidden'.
+     *    Isso garante que nada além do caminho de navegação atual fique visível.
+     * 2. Remove o atributo 'drill-ancestor' de quaisquer listas marcadas anteriormente, limpando o estado visual.
+     * 3. Remove o atributo 'hidden' do elemento ativo (o submenu ou item selecionado), tornando-o visível.
+     * 4. Percorre a cadeia de ancestrais do elemento ativo:
+     *    - Para cada ancestral do tipo <br-menu-list> ou <br-menu-item>, remove o 'hidden' para garantir visibilidade.
+     *    - Para ancestrais <br-menu-list> (exceto o próprio ativo), adiciona o atributo 'drill-ancestor' para permitir
+     *      estilização diferenciada (por exemplo, ocultar cabeçalhos mas manter o conteúdo visível).
+     *    - Interrompe o loop ao chegar no elemento host do componente.
+     * 5. Exibe todos os filhos diretos do elemento ativo que sejam <br-menu-list> ou <br-menu-item>,
+     *    removendo o 'hidden' para mostrar as opções do submenu.
+     * 6. Exibe também filhos que estejam dentro de um <ul> (estrutura comum em subníveis),
+     *    garantindo que todos os itens relevantes do submenu estejam visíveis.
+     *
+     * Este método é fundamental para a experiência de navegação drill-down, pois controla
+     * exatamente quais partes do menu são exibidas ao usuário em cada etapa da navegação.
+     *
+     * @param activeElement O elemento <br-menu-list> ou <br-menu-item> que representa o submenu/item atualmente ativo.
+     */
+    hideAllExcept(activeElement) {
+        // 1. Oculta todos os elementos do menu
+        const allMenuElements = this.el.querySelectorAll('br-menu-list, br-menu-item');
+        allMenuElements.forEach((element) => {
+            element.setAttribute('hidden', '');
+        });
+        // 2. Limpa marcadores de ancestrais anteriores
+        this.el.querySelectorAll('br-menu-list[drill-ancestor]').forEach((e) => {
+            e.removeAttribute('drill-ancestor');
+        });
+        // 3. Garante que o elemento ativo esteja visível
+        activeElement.removeAttribute('hidden');
+        // 4. Exibe a cadeia de ancestrais do elemento ativo
+        let ancestor = activeElement.parentElement;
+        while (ancestor !== null) {
+            const tag = ancestor.tagName;
+            if (tag === 'BR-MENU-LIST' || tag === 'BR-MENU-ITEM') {
+                ancestor.removeAttribute('hidden');
+            }
+            if (tag === 'BR-MENU-LIST' && ancestor !== activeElement) {
+                ancestor.setAttribute('drill-ancestor', '');
+            }
+            if (ancestor === this.el)
+                break;
+            ancestor = ancestor.parentElement;
+        }
+        this.getDirectMenuChildren(activeElement).forEach((child) => {
+            child.removeAttribute('hidden');
+        });
+    }
+    getDirectMenuChildren(element) {
+        const children = [];
+        Array.from(element.children).forEach((child) => {
+            const childElement = child;
+            if (childElement.tagName === 'BR-MENU-GROUP' ||
+                childElement.tagName === 'BR-MENU-LIST' ||
+                childElement.tagName === 'BR-MENU-ITEM') {
+                if (childElement.tagName === 'BR-MENU-GROUP') {
+                    children.push(...this.getDirectMenuChildren(childElement));
+                    return;
+                }
+                children.push(childElement);
+            }
+            if (childElement.tagName === 'UL') {
+                Array.from(childElement.children).forEach((listItem) => {
+                    Array.from(listItem.children).forEach((listChild) => {
+                        const menuChild = listChild;
+                        if (menuChild.tagName === 'BR-MENU-LIST' || menuChild.tagName === 'BR-MENU-ITEM') {
+                            children.push(menuChild);
+                        }
+                    });
+                });
+            }
+        });
+        return children;
+    }
+    /**
+     * Exibe todos os itens e listas do menu, removendo o atributo 'hidden' de cada um.
+     *
+     * Esta função é utilizada para restaurar a visualização completa do menu,
+     * normalmente após uma navegação drill-down ou ao retornar ao nível raiz.
+     *
+     * O método percorre todos os elementos <br-menu-list> e <br-menu-item> dentro do componente
+     * e garante que estejam visíveis, removendo o atributo 'hidden' que pode ter sido
+     * adicionado durante a navegação entre submenus.
+     */
+    showAllMenuItems() {
+        const allMenuLists = this.el.querySelectorAll('br-menu-list');
+        const allMenuItems = this.el.querySelectorAll('br-menu-item');
+        allMenuLists.forEach((menuList) => {
+            menuList.removeAttribute('hidden');
+        });
+        allMenuItems.forEach((menuItem) => {
+            menuItem.removeAttribute('hidden');
+        });
+    }
+    /**
+     * Marca ou desmarca um elemento <br-menu-list> como ativo no contexto de navegação drill-down.
+     *
+     * Quando 'active' é true, adiciona o atributo 'drill-active' ao elemento, indicando que
+     * ele está no foco da navegação. Quando 'active' é false, remove esse atributo.
+     *
+     * Esse atributo pode ser utilizado para aplicar estilos visuais ou lógica condicional
+     * durante a navegação entre níveis do menu.
+     *
+     * @param element Elemento <br-menu-list> a ser marcado/desmarcado
+     * @param active Boolean indicando se o elemento deve ser marcado como ativo
+     */
+    setDrillActive(element, active) {
+        if (active) {
+            element.setAttribute('drill-active', '');
+        }
+        else {
+            element.removeAttribute('drill-active');
+        }
+    }
+    /**
+     * Remove todos os marcadores de navegação drill-down do menu.
+     *
+     * Esta função percorre todos os elementos <br-menu-list> que possuem os atributos
+     * 'drill-active' ou 'drill-ancestor' e remove esses atributos. Isso é necessário
+     * para garantir que, ao retornar ao nível raiz ou reiniciar a navegação, nenhum
+     * marcador visual ou lógico de navegação anterior permaneça ativo.
+     */
+    clearAllDrillMarkers() {
+        // Remove o atributo 'drill-active' de todos os <br-menu-list>
+        this.el.querySelectorAll('br-menu-list[drill-active]').forEach((e) => {
+            e.removeAttribute('drill-active');
+        });
+        // Remove o atributo 'drill-ancestor' de todos os <br-menu-list>
+        this.el.querySelectorAll('br-menu-list[drill-ancestor]').forEach((e) => {
+            e.removeAttribute('drill-ancestor');
+        });
+    }
+    /**
+     * Realiza a navegação de retorno (voltar) em menus do tipo drill-down.
+     *
+     * Esta função é chamada quando o usuário deseja voltar um nível na navegação do menu.
+     * Ela utiliza uma pilha de navegação (navigationStack) para controlar o histórico de navegação.
+     *
+     * - Se houver elementos na pilha, remove o elemento do topo (nível atual) e desmarca como ativo.
+     * - Se, após a remoção, a pilha estiver vazia, significa que o usuário retornou ao nível raiz:
+     *   - Restaura o estado inicial do menu, mostrando todos os itens e limpando marcadores de navegação.
+     * - Caso contrário, ativa o elemento do nível anterior e oculta os demais, mantendo o contexto do drill-down.
+     */
+    goBack() {
+        if (this.navigationStack.length > 0) {
+            // Remove o elemento do topo da pilha (nível atual)
+            const removed = this.navigationStack[this.navigationStack.length - 1];
+            this.navigationStack = this.navigationStack.slice(0, -1);
+            if (removed !== undefined)
+                this.setDrillActive(removed.element, false);
+            if (this.navigationStack.length === 0) {
+                // Se a pilha está vazia, voltamos ao nível raiz do menu
+                this.currentLevel = 0;
+                this.isInSubmenu = false;
+                this.clearAllDrillMarkers();
+                this.showAllMenuItems();
+            }
+            else {
+                // Caso ainda haja elementos na pilha, voltamos ao nível anterior do drill-down
+                const previousElement = this.navigationStack[this.navigationStack.length - 1].element;
+                const previousLevel = parseInt(previousElement.getAttribute('menu-level') || '0', 10);
+                // Atualiza o nível atual para refletir o contexto correto
+                this.currentLevel = previousLevel + 1;
+                // Marca o elemento anterior como ativo
+                this.setDrillActive(previousElement, true);
+                // Oculta todos os itens, exceto o submenu ativo
+                this.hideAllExcept(previousElement);
+            }
+        }
+    }
+    /**
+     * Verifica se um slot específico possui conteúdo.
+     */
+    hasSlotContent(slotName) {
+        return this.el.querySelector(`[slot="${slotName}"]`) !== null;
+    }
+    getEffectiveBreakpoints() {
+        return this.breakpoints.trim();
+    }
+    getCssClassMap() {
+        return {
+            'br-menu': true,
+            active: this.isOpen,
+            push: this.push || this.fixed,
+            fixed: this.fixed,
+            contextual: this.contextual,
+            large: this.density === 'large',
+            small: this.density === 'small',
+            ...Object.fromEntries(this.getEffectiveBreakpoints()
+                .split(/\s+/)
+                .filter(Boolean)
+                .map((className) => [className, true])),
+        };
+    }
+    /**
+     * Retorna as classes CSS para o painel do menu.
+     * Aplica breakpoints apenas quando o menu NÃO está no modo push ou contextual.
+     */
+    getMenuPanelClasses() {
+        const baseClass = 'menu-panel';
+        // No modo push ou contextual, não aplica breakpoints
+        if (this.push || this.fixed || this.contextual) {
+            return baseClass;
+        }
+        // Nos outros modos, aplica os breakpoints responsivos
+        const breakpoints = this.getEffectiveBreakpoints();
+        return breakpoints ? `${baseClass} ${breakpoints}` : baseClass;
+    }
+    /**
+     * Renderiza o scrim do menu (backdrop)
+     */
+    renderScrim() {
+        if (this.push || this.fixed || this.contextual)
+            return null;
+        return (h("br-scrim", { ref: (el) => (this.scrimRef = el), "prop:positionContent": "center", "prop:scrollStrategy": "block", "content-layout": "none", "is-open": this.isOpen, "display-mode": "fullscreen", zIndex: 0 }));
+    }
+    // biome-ignore lint/complexity/noExcessiveCognitiveComplexity: render combina três modos de menu, gatilhos distintos e estrutura de painel responsivo.
+    render() {
+        const MenuContainer = this.usesNativeDialog ? 'dialog' : 'div';
+        return (h(Host, { key: 'b347a13ea63f42519f7a0963525b0a6aff0f6af7' }, h("div", { key: '265e99476d7345fb86a62e6cd45cfccf7b8bf470', class: this.getCssClassMap() }, this.contextual && (h("div", { key: '65605230b67cfd1e260987f15df639fab83db389', class: "menu-trigger" }, h("br-button", { key: '442a9293f17601a9250591872ee4574cf62b87ac', id: "contextual-trigger", emphasis: "primary", shape: "block", "aria-label": this.contextualLabel, "prop:ariaExpanded": String(this.isOpen), onClick: this.onToggleClick, part: "trigger" }, h("span", { key: 'd1a513a21b51d95d268cbe0d96f68f489d168037', class: "trigger-label" }, this.contextualLabel), h("br-icon", { key: '5f2b245450b57d4cdf259643643cb5d624dd2e5d', iconName: `fa6-solid:chevron-${this.isOpen ? 'down' : 'up'}`, width: "16", height: "16", class: "trigger-icon", "aria-hidden": "true" })))), h(MenuContainer, { key: 'e36d4dec672153b914a2ad55a76edc94dceb2c6c', ref: (el) => (this.nativeDialogRef = this.usesNativeDialog ? el : null), class: 'menu-container', part: "container", role: this.usesNativeDialog ? 'dialog' : undefined, "aria-modal": this.usesNativeDialog ? 'true' : undefined, "aria-label": this.usesNativeDialog ? 'Menu' : undefined, onCancel: this.usesNativeDialog ? this.handleNativeCancel : undefined }, this.renderScrim(), h("div", { key: 'aebf7d1cfec10bd17ba659a368fe58afe03e9059', id: this.contextual ? 'contextual-menu-panel' : 'menu-panel', class: this.getMenuPanelClasses(), ...(this.usesNativeDialog
+                ? {}
+                : { role: 'dialog', 'aria-label': this.contextual ? this.contextualLabel : 'Menu' }), part: "panel" }, !this.contextual && !this.push && this.hasSlotContent('header') && h("slot", { key: '9389d96a7640b20cf36b2ea07233e26c8181a336', name: "header" }), h("nav", { key: '2db383fc5c82352087c5cc90cb588cf8f38cd530', class: "menu-body", part: "body" }, this.isInSubmenu && this.currentLevel > 0 && (h("div", { key: '3eff15e0eee7cfa52a24e8f30ac24fd0d363ed9d', class: "menu-back-button" }, h("button", { key: 'a6771daed780dceae084669c11ed37fbf517cbf0', type: "button", class: "back-btn", onClick: this.onGoBackClick, "aria-label": "Voltar ao n\u00EDvel anterior", part: "back-btn" }, h("br-icon", { key: '793ee144aed32934168db6c615533b670a4ca4c3', class: "back-icon", iconName: "fa6-solid:angle-left", width: "16", height: "16", "aria-hidden": "true" }), h("span", { key: 'fc8f995c6c7814b278a692fb9745f21cb321461d', class: "back-title" }, this.navigationStack.length > 0
+            ? `${this.navigationStack[this.navigationStack.length - 1].label}`
+            : '')))), h("slot", { key: '6d5fd58167e2f49554f6c0cd0bf5c8e57b0c397a' })), !this.contextual && (h("div", { key: '17cac62b8c06a99b56b31344188dead4e7b9363a', class: "menu-footer", part: "footer" }, this.hasSlotContent('logo') && (h("div", { key: '2792cca656bb5be52d1aeae69bdad5b45a365e09', class: "menu-logos", part: "logo" }, h("slot", { key: '9d3c01dbc021bdf226f9fc91aa1d41010fd17359', name: "logo" }))), this.hasSlotContent('link') && (h("div", { key: 'c320910795ef26bd878596157421181de7d14bda', class: "menu-links", part: "link" }, h("slot", { key: 'b84e004dc71c535b99b8d7e1db8461eb714e0fb1', name: "link" }))), this.hasSlotContent('social') && (h("div", { key: '498b5cef3f4d60c0445f4a656e40686e65a8db6e', class: "social-network", part: "social" }, this.socialTitle && h("div", { key: '9a1f6a0d2c84bbe37b993e13aa59b5664f10d1e8', class: "social-network-title" }, this.socialTitle), h("div", { key: '4e9af99c0b2e69804dcc1bdda22b1ede0df03df5', class: "sharegroup" }, h("slot", { key: 'd82cc15374a4c3816c362a1ea025b6998ee1a169', name: "social" })))), this.hasSlotContent('info') && (h("div", { key: '886085ae30123f61221e3fa58976f3850e735085', class: "menu-info", part: "info" }, h("slot", { key: 'acb5fc8e6a4de3e6cde3ad8c61944969413e2f2f', name: "info" }))))))))));
+    }
+    static get is() { return "br-menu"; }
+    static get encapsulation() { return "shadow"; }
+    static get originalStyleUrls() {
+        return {
+            "$": ["menu.scss"]
+        };
+    }
+    static get styleUrls() {
+        return {
+            "$": ["menu.css"]
+        };
+    }
+    static get properties() {
+        return {
+            "customId": {
+                "type": "string",
+                "mutable": false,
+                "complexType": {
+                    "original": "string",
+                    "resolved": "string",
+                    "references": {}
+                },
+                "required": false,
+                "optional": false,
+                "docs": {
+                    "tags": [],
+                    "text": "Identificador \u00FAnico do componente.\nQuando omitido, um valor \u00E9 gerado automaticamente.\n\n> **Padr\u00E3o:** valor \u00FAnico gerado por generateUniqueId()."
+                },
+                "getter": false,
+                "setter": false,
+                "reflect": true,
+                "attribute": "custom-id",
+                "defaultValue": "generateUniqueId()"
+            },
+            "breakpoints": {
+                "type": "string",
+                "mutable": false,
+                "complexType": {
+                    "original": "string",
+                    "resolved": "string",
+                    "references": {}
+                },
+                "required": false,
+                "optional": false,
+                "docs": {
+                    "tags": [],
+                    "text": "Classes CSS para definir breakpoints responsivos do menu.\nUtilize esta propriedade para controlar a largura do menu em diferentes tamanhos de tela.\nPor padr\u00E3o n\u00E3o aplica colunas; quando contextual e sem valor definido, usa `col-sm-4 col-lg-3`."
+                },
+                "getter": false,
+                "setter": false,
+                "reflect": false,
+                "attribute": "breakpoints",
+                "defaultValue": "''"
+            },
+            "push": {
+                "type": "boolean",
+                "mutable": false,
+                "complexType": {
+                    "original": "boolean",
+                    "resolved": "boolean",
+                    "references": {}
+                },
+                "required": false,
+                "optional": false,
+                "docs": {
+                    "tags": [],
+                    "text": "Define se o menu deve usar comportamento push.\nQuando ativado, o menu permanece fixo na lateral e empurra o conte\u00FAdo principal."
+                },
+                "getter": false,
+                "setter": false,
+                "reflect": true,
+                "attribute": "push",
+                "defaultValue": "false"
+            },
+            "fixed": {
+                "type": "boolean",
+                "mutable": false,
+                "complexType": {
+                    "original": "boolean",
+                    "resolved": "boolean",
+                    "references": {}
+                },
+                "required": false,
+                "optional": false,
+                "docs": {
+                    "tags": [],
+                    "text": "Mant\u00E9m o menu como uma barra lateral fixa quando estiver aberto.\nO menu continua podendo ser ocultado alterando `isOpen` ou chamando `close()`.\nA largura padr\u00E3o \u00E9 `20rem`, limitada \u00E0 viewport, e pode ser sobrescrita\npela vari\u00E1vel CSS `--menu-fixed-width`."
+                },
+                "getter": false,
+                "setter": false,
+                "reflect": true,
+                "attribute": "fixed",
+                "defaultValue": "false"
+            },
+            "isOpen": {
+                "type": "boolean",
+                "mutable": true,
+                "complexType": {
+                    "original": "boolean",
+                    "resolved": "boolean",
+                    "references": {}
+                },
+                "required": false,
+                "optional": false,
+                "docs": {
+                    "tags": [],
+                    "text": "Define se o painel do menu est\u00E1 aberto/vis\u00EDvel.\nEm modo push, esta propriedade permite controle externo da visibilidade.\nO nome permanece porque o m\u00E9todo p\u00FAblico `open()` j\u00E1 ocupa a propriedade `open` no host."
+                },
+                "getter": false,
+                "setter": false,
+                "reflect": true,
+                "attribute": "is-open",
+                "defaultValue": "false"
+            },
+            "contextual": {
+                "type": "boolean",
+                "mutable": false,
+                "complexType": {
+                    "original": "boolean",
+                    "resolved": "boolean",
+                    "references": {}
+                },
+                "required": false,
+                "optional": false,
+                "docs": {
+                    "tags": [],
+                    "text": "Define se o menu deve usar comportamento contextual (aparece na parte inferior).\nQuando ativado, o menu \u00E9 posicionado na parte inferior da tela em dispositivos m\u00F3veis."
+                },
+                "getter": false,
+                "setter": false,
+                "reflect": false,
+                "attribute": "contextual",
+                "defaultValue": "false"
+            },
+            "density": {
+                "type": "string",
+                "mutable": false,
+                "complexType": {
+                    "original": "MenuDensity",
+                    "resolved": "\"large\" | \"medium\" | \"small\"",
+                    "references": {
+                        "MenuDensity": {
+                            "location": "import",
+                            "path": "./menu.types",
+                            "id": "src/components/menu/menu.types.ts::MenuDensity",
+                            "referenceLocation": "MenuDensity"
+                        }
+                    }
+                },
+                "required": false,
+                "optional": false,
+                "docs": {
+                    "tags": [],
+                    "text": "Define a densidade dos itens do menu, alterando o espa\u00E7amento interno.\n- `small` (densidade alta): itens mais compactos\n- `medium` (padr\u00E3o): equil\u00EDbrio entre economia de espa\u00E7o e separa\u00E7\u00E3o\n- `large` (densidade baixa): maior espa\u00E7amento (recomendado em touch)"
+                },
+                "getter": false,
+                "setter": false,
+                "reflect": true,
+                "attribute": "density",
+                "defaultValue": "'medium'"
+            },
+            "socialTitle": {
+                "type": "string",
+                "mutable": false,
+                "complexType": {
+                    "original": "string",
+                    "resolved": "string",
+                    "references": {}
+                },
+                "required": false,
+                "optional": false,
+                "docs": {
+                    "tags": [],
+                    "text": "T\u00EDtulo da se\u00E7\u00E3o de redes sociais exibida no rodap\u00E9 do menu.\nUtilize esta propriedade para personalizar o texto que aparece acima dos \u00EDcones sociais."
+                },
+                "getter": false,
+                "setter": false,
+                "reflect": true,
+                "attribute": "social-title",
+                "defaultValue": "'Redes Sociais'"
+            },
+            "contextualLabel": {
+                "type": "string",
+                "mutable": false,
+                "complexType": {
+                    "original": "string",
+                    "resolved": "string",
+                    "references": {}
+                },
+                "required": false,
+                "optional": false,
+                "docs": {
+                    "tags": [],
+                    "text": "R\u00F3tulo do bot\u00E3o trigger do menu contextual.\nExibido apenas em modo contextual e em telas menores (mobile)."
+                },
+                "getter": false,
+                "setter": false,
+                "reflect": false,
+                "attribute": "contextual-label",
+                "defaultValue": "'Menu Contextual'"
+            }
+        };
+    }
+    static get states() {
+        return {
+            "currentLevel": {},
+            "expandedDropMenus": {},
+            "isInSubmenu": {},
+            "navigationStack": {}
+        };
+    }
+    static get events() {
+        return [{
+                "method": "brMenuStateChange",
+                "name": "brMenuStateChange",
+                "bubbles": true,
+                "cancelable": false,
+                "composed": true,
+                "docs": {
+                    "tags": [{
+                            "name": "deprecated",
+                            "text": "Use `brMenuOpenChange`."
+                        }],
+                    "text": "Evento emitido quando o menu abre ou fecha."
+                },
+                "complexType": {
+                    "original": "{ isOpen: boolean }",
+                    "resolved": "{ isOpen: boolean; }",
+                    "references": {}
+                }
+            }, {
+                "method": "brMenuOpenChange",
+                "name": "brMenuOpenChange",
+                "bubbles": true,
+                "cancelable": false,
+                "composed": true,
+                "docs": {
+                    "tags": [],
+                    "text": "Evento can\u00F4nico emitido quando o menu abre ou fecha.\n`detail.open` cont\u00E9m o estado conclu\u00EDdo e `detail.sourceId` identifica a inst\u00E2ncia pelo `id` ou `customId`."
+                },
+                "complexType": {
+                    "original": "MenuOpenChangeDetail",
+                    "resolved": "MenuOpenChangeDetail",
+                    "references": {
+                        "MenuOpenChangeDetail": {
+                            "location": "import",
+                            "path": "./menu.types",
+                            "id": "src/components/menu/menu.types.ts::MenuOpenChangeDetail",
+                            "referenceLocation": "MenuOpenChangeDetail"
+                        }
+                    }
+                }
+            }];
+    }
+    static get methods() {
+        return {
+            "open": {
+                "complexType": {
+                    "signature": "() => Promise<void>",
+                    "parameters": [],
+                    "references": {
+                        "Promise": {
+                            "location": "global",
+                            "id": "global::Promise"
+                        }
+                    },
+                    "return": "Promise<void>"
+                },
+                "docs": {
+                    "text": "Abre o painel do menu.\nPode ser chamado externamente: `menuEl.open()`.",
+                    "tags": []
+                }
+            },
+            "close": {
+                "complexType": {
+                    "signature": "() => Promise<void>",
+                    "parameters": [],
+                    "references": {
+                        "Promise": {
+                            "location": "global",
+                            "id": "global::Promise"
+                        }
+                    },
+                    "return": "Promise<void>"
+                },
+                "docs": {
+                    "text": "Fecha o painel do menu.\nPode ser chamado externamente: `menuEl.close()`.",
+                    "tags": []
+                }
+            },
+            "toggle": {
+                "complexType": {
+                    "signature": "() => Promise<void>",
+                    "parameters": [],
+                    "references": {
+                        "Promise": {
+                            "location": "global",
+                            "id": "global::Promise"
+                        }
+                    },
+                    "return": "Promise<void>"
+                },
+                "docs": {
+                    "text": "Alterna o estado do painel do menu (abre se fechado, fecha se aberto).\nPode ser chamado externamente: `menuEl.toggle()`.",
+                    "tags": []
+                }
+            }
+        };
+    }
+    static get elementRef() { return "el"; }
+    static get watchers() {
+        return [{
+                "propName": "isOpen",
+                "methodName": "onOpenChange"
+            }];
+    }
+    static get listeners() {
+        return [{
+                "name": "click",
+                "method": "onMenuItemClick",
+                "target": undefined,
+                "capture": true,
+                "passive": false
+            }, {
+                "name": "keydown",
+                "method": "onKeyDown",
+                "target": undefined,
+                "capture": false,
+                "passive": false
+            }, {
+                "name": "click",
+                "method": "onDocumentClick",
+                "target": "document",
+                "capture": false,
+                "passive": false
+            }, {
+                "name": "navigateToSubmenu",
+                "method": "onNavigateToSubmenu",
+                "target": undefined,
+                "capture": false,
+                "passive": false
+            }, {
+                "name": "folderToggled",
+                "method": "onFolderToggled",
+                "target": undefined,
+                "capture": false,
+                "passive": false
+            }, {
+                "name": "brMenuToggle",
+                "method": "onMenuToggle",
+                "target": "document",
+                "capture": false,
+                "passive": false
+            }, {
+                "name": "brScrimClose",
+                "method": "onScrimClose",
+                "target": undefined,
+                "capture": false,
+                "passive": false
+            }, {
+                "name": "brMenuGoBack",
+                "method": "onMenuGoBack",
+                "target": undefined,
+                "capture": false,
+                "passive": false
+            }];
+    }
+}