@govbr-ds/webcomponents 2.1.0 → 2.1.2

package/dist/collection/components/tooltip/tooltip.js

@@ -0,0 +1,1024 @@
+/*!
+ * Construído por SERPRO
+ * © https://serpro.gov.br/ - MIT License.
+ */
+import { Host, h, } from "@stencil/core";
+import { isEventTargetOutside } from "../../shared/utils/event";
+import { listenForExternalBlockingSurface } from "../../shared/utils/floating-surface-dismiss";
+import { FloatingUIManager } from "../../shared/utils/floating-ui";
+import { generateUniqueId } from "../../shared/utils/id";
+const visibilityRegistries = new WeakMap();
+const attachVisibilityListener = (tooltip) => {
+    const ownerDocument = tooltip.el.ownerDocument;
+    let registry = visibilityRegistries.get(ownerDocument);
+    if (!registry) {
+        const tooltips = new Set();
+        const listener = (event) => {
+            for (const current of [...tooltips])
+                current.handleKeyDown(event);
+        };
+        registry = { tooltips, listener };
+        visibilityRegistries.set(ownerDocument, registry);
+        ownerDocument.addEventListener('keydown', listener);
+    }
+    registry.tooltips.add(tooltip);
+};
+const detachVisibilityListener = (tooltip) => {
+    const ownerDocument = tooltip.el.ownerDocument;
+    const registry = visibilityRegistries.get(ownerDocument);
+    if (!registry)
+        return;
+    registry.tooltips.delete(tooltip);
+    if (registry.tooltips.size === 0) {
+        ownerDocument.removeEventListener('keydown', registry.listener);
+        visibilityRegistries.delete(ownerDocument);
+    }
+};
+/**
+ * Para a documentação completa, incluindo diretrizes de uso, acessibilidade e exemplos visuais, consulte o [Design System do GovBR](https://www.gov.br/ds/components/tooltip?tab=designer).
+ *
+ * @category Feedback
+ * @status stable
+ * @slot trigger - Slot para o elemento que aciona a exibição do tooltip.
+ * @slot content - Slot para o conteúdo exibido no tooltip.
+ *
+ * @part container - Wrapper principal do tooltip.
+ * @part trigger - Área do acionador do tooltip.
+ * @part content - Área de conteúdo do tooltip.
+ * @part arrow - Seta indicativa do tooltip.
+ */
+export class Tooltip {
+    constructor() {
+        /**
+         * Indica se o conteúdo do trigger é focável.
+         * Se for false, o wrapper do trigger receberá tabindex="0".
+         */
+        this.hasFocusableTrigger = false;
+        /**
+         * Estado interno de visibilidade do tooltip.
+         */
+        this.isVisible = false;
+        /**
+         * Identificador único do componente.
+         * Quando omitido, um valor é gerado automaticamente.
+         *
+         * > **Padrão:** valor único gerado por generateUniqueId().
+         *
+         */
+        this.customId = generateUniqueId();
+        /**
+         * Nome acessível do popover. Quando omitido, usa o rótulo derivado do estado visual.
+         */
+        this.ariaLabel = null;
+        /**
+         * Posição do tooltip em relação ao acionador.
+         */
+        this.position = 'top';
+        /**
+         * Tipo do tooltip: 'standard' (simples) ou 'popover' (mais rico, com fechamento por interação).
+         */
+        this.type = 'standard';
+        /**
+         * Modo de interação para exibição do tooltip: 'hover' ou 'click'.
+         */
+        this.interaction = 'hover';
+        /**
+         * Define a densidade visual do componente.
+         *
+         * - `small`: Alta densidade (componente menor, mais compacto e com menos espaçamento).
+         * - `medium`: Densidade intermediária, padrão recomendado para a maioria dos casos.
+         * - `large`: Baixa densidade (componente maior, mais espaçamento e altura).
+         *
+         */
+        this.density = 'medium';
+        /**
+         * Estado visual do tooltip: 'info', 'warning', 'error', 'danger' ou 'success'.
+         */
+        this.state = 'info';
+        /**
+         * Exibe automaticamente sem interação quando true; caso contrário, depende do acionador.
+         */
+        this.isAutoVisible = false;
+        /**
+         * Atraso em milissegundos antes de exibir.
+         */
+        this.showDelay = null;
+        /**
+         * Atraso em milissegundos antes de ocultar.
+         */
+        this.hideDelay = null;
+        this.visibilityKeydownAttached = false;
+        /**
+         * Elemento que aciona a exibição do tooltip.
+         * Este elemento é referenciado para garantir que o tooltip seja posicionado corretamente em relação a ele.
+         */
+        this.triggerElement = null;
+        /**
+         * Trigger externo opcional para posicionamento e interações.
+         */
+        this.externalTriggerElement = null;
+        /**
+         * Elemento que atualmente possui os listeners de interação.
+         */
+        this.interactionTarget = null;
+        /**
+         * Elemento que contém o conteúdo do tooltip.
+         * Este elemento é referenciado para garantir que o tooltip seja posicionado corretamente em relação a ele.
+         */
+        this.contentElement = null;
+        /**
+         * Elemento que representa a seta do tooltip.
+         * Este elemento é utilizado para indicar a direção do tooltip em relação ao elemento acionador.
+         */
+        this.arrowElement = null;
+        /** Indica se o browser suporta renderização na top layer via Popover API. */
+        this.supportsNativePopover = false;
+        /**
+         * Tempo limite para exibir o tooltip automaticamente.
+         */
+        this.showTimer = null;
+        /**
+         * Tempo limite para ocultar o tooltip.
+         */
+        this.hideTimer = null;
+        this.outsideClickTimer = null;
+        /**
+         * Indica se o tooltip foi acionado por um clique do mouse.
+         * Isso é utilizado para evitar conflito com o acionamento por foco.
+         */
+        this.fromPointerDown = false;
+        /**
+         * Manipula a mudança no slot do trigger para verificar se há conteúdo focável.
+         * @param event Evento de mudança do slot
+         */
+        this.handleTriggerSlotChange = (event) => {
+            const slot = event.target;
+            const assignedNodes = slot.assignedNodes({ flatten: true });
+            this.hasFocusableTrigger = assignedNodes.some((node) => {
+                return node.nodeType === 1 && this.isFocusable(node);
+            });
+        };
+        /**
+         * Alterna a exibição do tooltip.
+         * Se o tooltip estiver visível, ele será ocultado.
+         * Se o tooltip estiver oculto, ele será exibido.
+         */
+        this.toggleContent = () => {
+            this.fromPointerDown = true;
+            if (this.isVisible) {
+                this.hideContent();
+            }
+            else {
+                this.showContent();
+            }
+        };
+        /**
+         * Processa as ações relacionadas à exibição do tooltip.
+         * Isso inclui exibir o tooltip e iniciar o tempo limite de ocultação automática.
+         * @returns void
+         */
+        this.showContent = () => {
+            if (this.contentElement == null)
+                return;
+            this.isVisible = true;
+            if (this.isAutoVisible) {
+                if (this.hideDelay !== null) {
+                    this.clearHideTimer();
+                    this.setHideTimer();
+                }
+            }
+            if (this.type === 'popover') {
+                this.clearOutsideClickTimer();
+                this.outsideClickTimer = setTimeout(() => {
+                    this.outsideClickTimer = null;
+                    if (this.isVisible) {
+                        document.addEventListener('click', this.handleOutsideClick);
+                    }
+                }, 0);
+            }
+        };
+        /**
+         * Processa as ações relacionadas ao fechamento do tooltip.
+         * Isso inclui ocultar o tooltip e limpar o tempo limite de ocultação automática.
+         * @returns void
+         */
+        this.hideContent = () => {
+            if (this.contentElement == null)
+                return;
+            this.isVisible = false;
+            if (this.type === 'popover') {
+                this.clearOutsideClickTimer();
+                document.removeEventListener('click', this.handleOutsideClick);
+                requestAnimationFrame(() => this.contentElement?.focus());
+            }
+        };
+        /**
+         * Lida com cliques fora do tooltip.
+         * É utilizado para o tooltip do tipo 'popover'.
+         * @param event MouseEvent
+         */
+        this.handleOutsideClick = (event) => {
+            const trigger = this.getPositionReferenceElement();
+            if (this.isVisible &&
+                this.type === 'popover' &&
+                this.contentElement !== null &&
+                isEventTargetOutside(event, this.contentElement, trigger, this.el)) {
+                this.hideContent();
+            }
+        };
+    }
+    /**
+     * Watcher para monitorar alterações na propriedade `isVisible`.
+     * @param visible boolean
+     * @returns void
+     */
+    handleVisibilityChange(visible) {
+        this.syncVisibilityListeners(visible);
+        if (this.contentElement == null)
+            return;
+        if (visible) {
+            this.brDidOpen.emit({ id: this.customId, visible: true });
+        }
+        else {
+            this.cleanupPositioning();
+            this.brDidClose.emit({ id: this.customId, visible: false });
+        }
+    }
+    /**
+     * Método do ciclo de vida do componente.
+     * Este método é chamado quando o componente é desconectado do DOM.
+     */
+    disconnectedCallback() {
+        this.removeTriggerInteractions(this.interactionTarget);
+        if (this.type === 'popover') {
+            document.removeEventListener('click', this.handleOutsideClick);
+        }
+        this.cleanupPositioning();
+        this.detachVisibilityListeners();
+        this.clearShowTimer();
+        this.clearHideTimer();
+        this.clearOutsideClickTimer();
+    }
+    /**
+     * Método do ciclo de vida do componente.
+     * Este método é chamado uma única vez após o componente ser montado no DOM.
+     */
+    componentDidLoad() {
+        if (typeof window === 'undefined')
+            return;
+        this.setupInteractions();
+        this.syncVisibilityListeners(this.isVisible);
+    }
+    /**
+     * Exibe o tooltip quando o acionador recebe foco.
+     */
+    handleFocusIn() {
+        if (this.type === 'popover')
+            return;
+        if (!this.fromPointerDown) {
+            this.showContent();
+        }
+        this.fromPointerDown = false;
+    }
+    /**
+     * Oculta o tooltip quando o acionador perde foco.
+     */
+    handleFocusOut() {
+        this.hideContent();
+    }
+    /** Fecha com Escape enquanto o tooltip estiver visível. */
+    handleKeyDown(event) {
+        if (event.key === 'Escape') {
+            event.preventDefault();
+            this.hideContent();
+            this.getPositionReferenceElement()?.focus();
+        }
+    }
+    /**
+     * Define um trigger externo para o tooltip.
+     */
+    async setTriggerElement(element) {
+        this.removeTriggerInteractions(this.interactionTarget);
+        this.externalTriggerElement = element;
+        this.setupInteractions();
+        if (this.isVisible) {
+            this.positionTooltip();
+        }
+    }
+    /**
+     * Exibe o tooltip programaticamente.
+     */
+    async showTooltip() {
+        this.showContent();
+    }
+    /**
+     * Oculta o tooltip programaticamente.
+     */
+    async hideTooltip() {
+        this.hideContent();
+    }
+    /**
+     * Exibe o tooltip programaticamente (alias para `showTooltip`).
+     */
+    async show() {
+        this.showContent();
+    }
+    /**
+     * Oculta o tooltip programaticamente (alias para `hideTooltip`).
+     */
+    async hide() {
+        this.hideContent();
+    }
+    syncVisibilityListeners(visible) {
+        if (visible) {
+            if (!this.visibilityKeydownAttached) {
+                attachVisibilityListener(this);
+                this.visibilityKeydownAttached = true;
+            }
+            if (this.cleanupBlockingSurfaceDismissal === undefined) {
+                this.cleanupBlockingSurfaceDismissal = listenForExternalBlockingSurface(this.el, this.hideContent);
+            }
+            return;
+        }
+        this.detachVisibilityListeners();
+    }
+    detachVisibilityListeners() {
+        if (this.visibilityKeydownAttached) {
+            detachVisibilityListener(this);
+            this.visibilityKeydownAttached = false;
+        }
+        this.cleanupBlockingSurfaceDismissal?.();
+        this.cleanupBlockingSurfaceDismissal = undefined;
+    }
+    componentDidRender() {
+        this.syncPopoverState();
+    }
+    /**
+     * Retorna o elemento de referência atual para posicionamento.
+     */
+    getPositionReferenceElement() {
+        if (this.externalTriggerElement !== null) {
+            return this.externalTriggerElement;
+        }
+        return this.triggerElement;
+    }
+    /**
+     * Remove listeners de interação do elemento de trigger atual.
+     */
+    removeTriggerInteractions(target) {
+        if (target === null)
+            return;
+        target.removeEventListener('mouseenter', this.showContent);
+        target.removeEventListener('mouseleave', this.hideContent);
+        target.removeEventListener('pointerdown', this.toggleContent);
+        target.removeEventListener('click', this.toggleContent);
+    }
+    /**
+     * Adiciona listeners de interação ao elemento de trigger atual.
+     */
+    addTriggerInteractions(target) {
+        if (this.type === 'standard' && this.interaction !== 'click') {
+            target.addEventListener('mouseenter', this.showContent);
+            target.addEventListener('mouseleave', this.hideContent);
+        }
+        if (this.type === 'popover' || this.interaction === 'click') {
+            target.addEventListener('click', this.toggleContent);
+        }
+    }
+    /**
+     * Verifica se um elemento HTML é focável.
+     * @param element HTMLElement a ser verificado
+     * @returns boolean
+     */
+    isFocusable(element) {
+        if (element.nodeType !== 1)
+            return false;
+        // Verifica o atributo tabindex
+        if (element.hasAttribute('tabindex')) {
+            const tabIndex = element.getAttribute('tabindex');
+            if (tabIndex === null) {
+                return false;
+            }
+            const index = parseInt(tabIndex, 10);
+            return !Number.isNaN(index) && index >= 0;
+        }
+        // Verifica elementos interativos padrão
+        const tag = element.tagName.toLowerCase();
+        const interactiveTags = ['button', 'input', 'select', 'textarea', 'a'];
+        if (interactiveTags.includes(tag)) {
+            if (tag === 'a')
+                return element.hasAttribute('href');
+            if (element instanceof HTMLButtonElement ||
+                element instanceof HTMLInputElement ||
+                element instanceof HTMLSelectElement ||
+                element instanceof HTMLTextAreaElement) {
+                return !element.disabled;
+            }
+            return false;
+        }
+        return false;
+    }
+    /**
+     * Controla a exibição do tooltip.
+     * Quando o tooltip é exibido, ele é posicionado em relação ao elemento acionador.
+     * Isso é feito utilizando a biblioteca Floating UI, que calcula a posição ideal do tooltip com base no espaço disponível na tela.
+     * A função `autoUpdate` é utilizada para atualizar automaticamente a posição do tooltip quando o elemento acionador é movido ou redimensionado.
+     */
+    positionTooltip() {
+        const trigger = this.getPositionReferenceElement();
+        if (trigger == null || this.contentElement == null)
+            return;
+        this.cleanupPositioning();
+        this.floatingManager = new FloatingUIManager({
+            triggerElement: trigger,
+            contentElement: this.contentElement,
+            arrowElement: this.arrowElement ?? undefined,
+            placement: this.position,
+            strategy: 'fixed',
+            boundary: trigger.ownerDocument.documentElement,
+        });
+        this.floatingManager.start();
+    }
+    cleanupPositioning() {
+        this.floatingManager?.stop();
+        this.floatingManager = undefined;
+    }
+    /** Mantém a top layer nativa e o posicionamento sincronizados com isVisible. */
+    syncPopoverState() {
+        if (this.contentElement == null)
+            return;
+        this.supportsNativePopover = 'showPopover' in this.contentElement;
+        if (!this.supportsNativePopover) {
+            if (this.isVisible && this.floatingManager == null)
+                this.positionTooltip();
+            return;
+        }
+        const content = this.contentElement;
+        content.setAttribute('popover', 'manual');
+        const isOpen = content.matches(':popover-open');
+        if (this.isVisible) {
+            if (!isOpen)
+                content.showPopover();
+            if (this.floatingManager == null)
+                this.positionTooltip();
+        }
+        else {
+            this.cleanupPositioning();
+            if (isOpen)
+                content.hidePopover();
+        }
+    }
+    /**
+     * Define os eventos de interação do tooltip.
+     * Os eventos de interação incluem mouseenter, mouseleave, focus e blur.
+     * @returns void
+     */
+    setupInteractions() {
+        const trigger = this.getPositionReferenceElement();
+        if (trigger == null || this.contentElement == null)
+            return;
+        this.removeTriggerInteractions(this.interactionTarget);
+        this.addTriggerInteractions(trigger);
+        this.interactionTarget = trigger;
+        if (this.isAutoVisible) {
+            requestAnimationFrame(() => {
+                this.clearShowTimer();
+                this.setShowTimer();
+            });
+        }
+        // Verifica inicialmente se o slot já tem elementos (caso slotchange não dispare no load inicial dependendo do framework)
+        // Pequeno delay para garantir que o DOM light foi projetado
+        requestAnimationFrame(() => {
+            if (this.externalTriggerElement === null && this.triggerElement !== null) {
+                const slot = this.triggerElement.querySelector('slot[name="trigger"]');
+                if (slot !== null) {
+                    // Dispara manualmente a verificação inicial
+                    this.handleTriggerSlotChange({ target: slot });
+                }
+            }
+            else {
+                this.hasFocusableTrigger = true;
+            }
+        });
+    }
+    /**
+     * Configura o tempo limite para exibir o tooltip automaticamente.
+     * O tempo limite é definido pelo valor da propriedade `showDelay`.
+     */
+    setShowTimer() {
+        this.showTimer = setTimeout(() => {
+            this.showContent();
+        }, this.showDelay || 0);
+    }
+    /**
+     * Limpa o tempo limite de exibição automática do tooltip.
+     */
+    clearShowTimer() {
+        if (this.showTimer !== null) {
+            clearTimeout(this.showTimer);
+            this.showTimer = null;
+        }
+    }
+    /**
+     * Configura o tempo limite para ocultar o tooltip automaticamente.
+     * O tempo limite é definido pelo valor da propriedade `hideDelay`.
+     */
+    setHideTimer() {
+        this.hideTimer = setTimeout(() => {
+            this.hideContent();
+        }, this.hideDelay ?? 0);
+    }
+    /**
+     * Limpa o tempo limite de ocultação automática do tooltip.
+     */
+    clearHideTimer() {
+        if (this.hideTimer !== null) {
+            clearTimeout(this.hideTimer);
+            this.hideTimer = null;
+        }
+    }
+    clearOutsideClickTimer() {
+        if (this.outsideClickTimer !== null) {
+            clearTimeout(this.outsideClickTimer);
+            this.outsideClickTimer = null;
+        }
+    }
+    /**
+     * Determina o mapeamento de classes CSS do componente.
+     * @returns Um objeto que representa o mapeamento de classes CSS do componente.
+     */
+    getCssClassMap() {
+        return {
+            'br-tooltip': true,
+        };
+    }
+    /**
+     * Determina o mapeamento de classes CSS do trigger.
+     * @returns Um objeto que representa o mapeamento de classes CSS do trigger.
+     */
+    getTriggerCssClassMap() {
+        return {
+            trigger: true,
+        };
+    }
+    /**
+     * Determina o mapeamento de classes CSS do conteúdo.
+     * @returns Um objeto que representa o mapeamento de classes CSS do conteúdo.
+     */
+    getContentCssClassMap() {
+        return {
+            'is-visible': this.isVisible,
+            content: true,
+            popover: this.type === 'popover',
+            large: this.density === 'large',
+            medium: this.density === 'medium',
+            small: this.density === 'small',
+            info: this.state === 'info',
+            warning: this.state === 'warning',
+            error: this.state === 'error' || this.state === 'danger',
+            danger: this.state === 'danger',
+            success: this.state === 'success',
+        };
+    }
+    /**
+     * Determina o mapeamento de classes CSS da seta.
+     * @returns Um objeto que representa o mapeamento de classes CSS da seta.
+     */
+    getArrowCssClassMap() {
+        return {
+            arrow: true,
+            large: this.density === 'large',
+            medium: this.density === 'medium',
+            small: this.density === 'small',
+            info: this.state === 'info',
+            warning: this.state === 'warning',
+            error: this.state === 'error' || this.state === 'danger',
+            danger: this.state === 'danger',
+            success: this.state === 'success',
+        };
+    }
+    /**
+     * Determina o texto de acessibilidade baseado no estado do tooltip.
+     */
+    getAccessibilityLabel() {
+        const labels = {
+            info: 'Informação:',
+            warning: 'Aviso:',
+            error: 'Erro:',
+            danger: 'Erro:',
+            success: 'Sucesso:',
+        };
+        return labels[this.state] || '';
+    }
+    /**
+     * Renderiza o componente.
+     * Este método é responsável por gerar o conteúdo HTML do componente.
+     * Ele utiliza a função `h` do Stencil para criar elementos JSX.
+     * @returns JSX.Element
+     */
+    render() {
+        return (h(Host, { key: 'a4d5d1e786e12f696a92a387ed762f830d014a4a' }, h("div", { key: '5bb4382b375497c8f1a7a4cae2183db4ebad1586', id: this.customId, class: this.getCssClassMap(), part: "container" }, h("div", { key: '64fb7d3094b29ee8364a00cb9760195a06864adb', class: this.getTriggerCssClassMap(), ref: (el) => (this.triggerElement = el), "aria-describedby": `${this.customId}-content`, "aria-controls": `${this.customId}-content`, tabindex: this.externalTriggerElement !== null || this.hasFocusableTrigger ? -1 : 0, part: "trigger" }, h("slot", { key: '0db70e887c9bd2ed5e1d39de72152d993e2c6e49', name: "trigger", onSlotchange: this.handleTriggerSlotChange })), h("div", { key: '606becc56bf87c55c35fd69b93db705f21c8234b', id: `${this.customId}-content`, class: this.getContentCssClassMap(), ref: (el) => (this.contentElement = el), role: this.type === 'popover' ? 'dialog' : 'tooltip', "aria-label": this.type === 'popover' ? this.ariaLabel || this.getAccessibilityLabel() : undefined, tabindex: "-1", part: "content" }, h("span", { key: '7a425385e65028d5a24b8ee1d70459f891ad0100', class: "sr-only" }, this.getAccessibilityLabel()), h("slot", { key: '6fbbf125ec630575c705fc20558b73fa216919a5', name: "content" }), this.type === 'popover' && (h("br-button", { key: 'ab0eb2355530830dbd81a3cb32e79ae4aeb63e42', class: "close", shape: "circle", density: "small", onClick: this.hideContent, "prop:ariaLabel": "Fechar popover" }, h("br-icon", { key: 'a75d2991868f20a89cb2c5f631814b3cfcabc479', iconName: "fa6-solid:xmark", width: "8", height: "8" }))), h("div", { key: '42fbb5632049d0f238374fde458dac8df7bbc354', class: this.getArrowCssClassMap(), ref: (el) => (this.arrowElement = el), part: "arrow" })))));
+    }
+    static get is() { return "br-tooltip"; }
+    static get encapsulation() { return "shadow"; }
+    static get originalStyleUrls() {
+        return {
+            "$": ["tooltip.scss"]
+        };
+    }
+    static get styleUrls() {
+        return {
+            "$": ["tooltip.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()"
+            },
+            "ariaLabel": {
+                "type": "string",
+                "mutable": false,
+                "complexType": {
+                    "original": "string | null",
+                    "resolved": "string",
+                    "references": {}
+                },
+                "required": false,
+                "optional": false,
+                "docs": {
+                    "tags": [],
+                    "text": "Nome acess\u00EDvel do popover. Quando omitido, usa o r\u00F3tulo derivado do estado visual."
+                },
+                "getter": false,
+                "setter": false,
+                "reflect": true,
+                "attribute": "aria-label",
+                "defaultValue": "null"
+            },
+            "position": {
+                "type": "string",
+                "mutable": false,
+                "complexType": {
+                    "original": "TooltipPosition",
+                    "resolved": "\"bottom\" | \"left\" | \"right\" | \"top\"",
+                    "references": {
+                        "TooltipPosition": {
+                            "location": "import",
+                            "path": "./tooltip.types",
+                            "id": "src/components/tooltip/tooltip.types.ts::TooltipPosition",
+                            "referenceLocation": "TooltipPosition"
+                        }
+                    }
+                },
+                "required": false,
+                "optional": false,
+                "docs": {
+                    "tags": [],
+                    "text": "Posi\u00E7\u00E3o do tooltip em rela\u00E7\u00E3o ao acionador."
+                },
+                "getter": false,
+                "setter": false,
+                "reflect": true,
+                "attribute": "position",
+                "defaultValue": "'top'"
+            },
+            "type": {
+                "type": "string",
+                "mutable": false,
+                "complexType": {
+                    "original": "TooltipType",
+                    "resolved": "\"popover\" | \"standard\"",
+                    "references": {
+                        "TooltipType": {
+                            "location": "import",
+                            "path": "./tooltip.types",
+                            "id": "src/components/tooltip/tooltip.types.ts::TooltipType",
+                            "referenceLocation": "TooltipType"
+                        }
+                    }
+                },
+                "required": false,
+                "optional": false,
+                "docs": {
+                    "tags": [],
+                    "text": "Tipo do tooltip: 'standard' (simples) ou 'popover' (mais rico, com fechamento por intera\u00E7\u00E3o)."
+                },
+                "getter": false,
+                "setter": false,
+                "reflect": true,
+                "attribute": "type",
+                "defaultValue": "'standard'"
+            },
+            "interaction": {
+                "type": "string",
+                "mutable": false,
+                "complexType": {
+                    "original": "'hover' | 'click'",
+                    "resolved": "\"click\" | \"hover\"",
+                    "references": {}
+                },
+                "required": false,
+                "optional": false,
+                "docs": {
+                    "tags": [],
+                    "text": "Modo de intera\u00E7\u00E3o para exibi\u00E7\u00E3o do tooltip: 'hover' ou 'click'."
+                },
+                "getter": false,
+                "setter": false,
+                "reflect": true,
+                "attribute": "interaction",
+                "defaultValue": "'hover'"
+            },
+            "density": {
+                "type": "string",
+                "mutable": false,
+                "complexType": {
+                    "original": "TooltipDensity",
+                    "resolved": "\"large\" | \"medium\" | \"small\"",
+                    "references": {
+                        "TooltipDensity": {
+                            "location": "import",
+                            "path": "./tooltip.types",
+                            "id": "src/components/tooltip/tooltip.types.ts::TooltipDensity",
+                            "referenceLocation": "TooltipDensity"
+                        }
+                    }
+                },
+                "required": false,
+                "optional": false,
+                "docs": {
+                    "tags": [],
+                    "text": "Define a densidade visual do componente.\n\n- `small`: Alta densidade (componente menor, mais compacto e com menos espa\u00E7amento).\n- `medium`: Densidade intermedi\u00E1ria, padr\u00E3o recomendado para a maioria dos casos.\n- `large`: Baixa densidade (componente maior, mais espa\u00E7amento e altura)."
+                },
+                "getter": false,
+                "setter": false,
+                "reflect": true,
+                "attribute": "density",
+                "defaultValue": "'medium'"
+            },
+            "state": {
+                "type": "string",
+                "mutable": false,
+                "complexType": {
+                    "original": "TooltipState",
+                    "resolved": "\"danger\" | \"error\" | \"info\" | \"success\" | \"warning\"",
+                    "references": {
+                        "TooltipState": {
+                            "location": "import",
+                            "path": "./tooltip.types",
+                            "id": "src/components/tooltip/tooltip.types.ts::TooltipState",
+                            "referenceLocation": "TooltipState"
+                        }
+                    }
+                },
+                "required": false,
+                "optional": false,
+                "docs": {
+                    "tags": [],
+                    "text": "Estado visual do tooltip: 'info', 'warning', 'error', 'danger' ou 'success'."
+                },
+                "getter": false,
+                "setter": false,
+                "reflect": true,
+                "attribute": "state",
+                "defaultValue": "'info'"
+            },
+            "isAutoVisible": {
+                "type": "boolean",
+                "mutable": false,
+                "complexType": {
+                    "original": "boolean",
+                    "resolved": "boolean",
+                    "references": {}
+                },
+                "required": false,
+                "optional": false,
+                "docs": {
+                    "tags": [],
+                    "text": "Exibe automaticamente sem intera\u00E7\u00E3o quando true; caso contr\u00E1rio, depende do acionador."
+                },
+                "getter": false,
+                "setter": false,
+                "reflect": true,
+                "attribute": "is-auto-visible",
+                "defaultValue": "false"
+            },
+            "showDelay": {
+                "type": "number",
+                "mutable": false,
+                "complexType": {
+                    "original": "number | null",
+                    "resolved": "number",
+                    "references": {}
+                },
+                "required": false,
+                "optional": false,
+                "docs": {
+                    "tags": [],
+                    "text": "Atraso em milissegundos antes de exibir."
+                },
+                "getter": false,
+                "setter": false,
+                "reflect": true,
+                "attribute": "show-delay",
+                "defaultValue": "null"
+            },
+            "hideDelay": {
+                "type": "number",
+                "mutable": false,
+                "complexType": {
+                    "original": "number | null",
+                    "resolved": "number",
+                    "references": {}
+                },
+                "required": false,
+                "optional": false,
+                "docs": {
+                    "tags": [],
+                    "text": "Atraso em milissegundos antes de ocultar."
+                },
+                "getter": false,
+                "setter": false,
+                "reflect": true,
+                "attribute": "hide-delay",
+                "defaultValue": "null"
+            }
+        };
+    }
+    static get states() {
+        return {
+            "hasFocusableTrigger": {},
+            "isVisible": {}
+        };
+    }
+    static get events() {
+        return [{
+                "method": "brDidOpen",
+                "name": "brDidOpen",
+                "bubbles": true,
+                "cancelable": false,
+                "composed": true,
+                "docs": {
+                    "tags": [],
+                    "text": "Emitido quando o tooltip abre."
+                },
+                "complexType": {
+                    "original": "{ id: string; visible: boolean }",
+                    "resolved": "{ id: string; visible: boolean; }",
+                    "references": {}
+                }
+            }, {
+                "method": "brDidClose",
+                "name": "brDidClose",
+                "bubbles": true,
+                "cancelable": false,
+                "composed": true,
+                "docs": {
+                    "tags": [],
+                    "text": "Emitido quando o tooltip fecha."
+                },
+                "complexType": {
+                    "original": "{ id: string; visible: boolean }",
+                    "resolved": "{ id: string; visible: boolean; }",
+                    "references": {}
+                }
+            }];
+    }
+    static get methods() {
+        return {
+            "setTriggerElement": {
+                "complexType": {
+                    "signature": "(element: HTMLElement | null) => Promise<void>",
+                    "parameters": [{
+                            "name": "element",
+                            "type": "HTMLElement",
+                            "docs": ""
+                        }],
+                    "references": {
+                        "Promise": {
+                            "location": "global",
+                            "id": "global::Promise"
+                        },
+                        "HTMLElement": {
+                            "location": "global",
+                            "id": "global::HTMLElement"
+                        }
+                    },
+                    "return": "Promise<void>"
+                },
+                "docs": {
+                    "text": "Define um trigger externo para o tooltip.",
+                    "tags": []
+                }
+            },
+            "showTooltip": {
+                "complexType": {
+                    "signature": "() => Promise<void>",
+                    "parameters": [],
+                    "references": {
+                        "Promise": {
+                            "location": "global",
+                            "id": "global::Promise"
+                        }
+                    },
+                    "return": "Promise<void>"
+                },
+                "docs": {
+                    "text": "Exibe o tooltip programaticamente.",
+                    "tags": []
+                }
+            },
+            "hideTooltip": {
+                "complexType": {
+                    "signature": "() => Promise<void>",
+                    "parameters": [],
+                    "references": {
+                        "Promise": {
+                            "location": "global",
+                            "id": "global::Promise"
+                        }
+                    },
+                    "return": "Promise<void>"
+                },
+                "docs": {
+                    "text": "Oculta o tooltip programaticamente.",
+                    "tags": []
+                }
+            },
+            "show": {
+                "complexType": {
+                    "signature": "() => Promise<void>",
+                    "parameters": [],
+                    "references": {
+                        "Promise": {
+                            "location": "global",
+                            "id": "global::Promise"
+                        }
+                    },
+                    "return": "Promise<void>"
+                },
+                "docs": {
+                    "text": "Exibe o tooltip programaticamente (alias para `showTooltip`).",
+                    "tags": []
+                }
+            },
+            "hide": {
+                "complexType": {
+                    "signature": "() => Promise<void>",
+                    "parameters": [],
+                    "references": {
+                        "Promise": {
+                            "location": "global",
+                            "id": "global::Promise"
+                        }
+                    },
+                    "return": "Promise<void>"
+                },
+                "docs": {
+                    "text": "Oculta o tooltip programaticamente (alias para `hideTooltip`).",
+                    "tags": []
+                }
+            }
+        };
+    }
+    static get elementRef() { return "el"; }
+    static get watchers() {
+        return [{
+                "propName": "isVisible",
+                "methodName": "handleVisibilityChange"
+            }];
+    }
+    static get listeners() {
+        return [{
+                "name": "focusin",
+                "method": "handleFocusIn",
+                "target": undefined,
+                "capture": false,
+                "passive": false
+            }, {
+                "name": "focusout",
+                "method": "handleFocusOut",
+                "target": undefined,
+                "capture": false,
+                "passive": false
+            }];
+    }
+}