@govbr-ds/webcomponents 2.0.0-next.41 → 2.0.0-next.43

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

@@ -2,6 +2,7 @@
  * Para uma descrição detalhada, consulte a [documentação do GovBR-DS](https://www.gov.br/ds/components/button?tab=designer).
  *
  * @slot default - Espaço de conteúdo do button. Geralmente usado para incluir o rótulo.
+ * @part slot-content - Espaço de conteúdo do botão. Geralmente usado para incluir o rótulo.
  */
 export declare class Button {
     /**

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

@@ -23,19 +23,51 @@ export declare class Dropdown {
      * Caso não seja fornecido, um ID gerado automaticamente será usado.
      */
     readonly customId: string;
+    private triggerElement;
+    private targetElement;
+    private dropdownItems;
+    private dropdownLinks;
+    private focusableElement;
+    private clickHandler;
+    private triggerKeydownHandler;
+    private targetKeydownHandler;
     /**
      * Método chamado sempre que a propriedade `isOpen` muda.
      * Emite um evento com o novo estado do dropdown.
      */
-    isOpenChanged(): void;
+    isOpenChanged(newValue: boolean): void;
     connectedCallback(): void;
     disconnectedCallback(): void;
+    private clearDropdownItemListeners;
+    componentDidLoad(): void;
     /**
      * Evento emitido quando o estado do dropdown muda.
      */
     brDropdownChange: EventEmitter<{
         'is-opened': boolean;
     }>;
+    /**
+     * Configura os comportamentos de interação do dropdown
+     */
+    private setBehavior;
+    /**
+     * Lida com o comportamento no trigger
+     */
+    private handleTriggerBehavior;
+    /**
+     * Inicializa os itens do dropdown com comportamentos de navegação com teclado,
+     * separando claramente entre elementos navegáveis por Tab e elementos navegáveis por setas
+     */
+    private initializeDropdownItems;
+    /**
+     * Handler específico para links
+     */
+    private handleLinkKeydown;
+    /**
+     * Handler para eventos de keydown nos itens não-link
+     * Implementa navegação completa por setas, Tab não navega entre estes itens
+     */
+    private handleItemKeydown;
     private getCssClassMap;
     /**
      * Alterna o estado do dropdown entre aberto e fechado.
@@ -63,5 +95,20 @@ export declare class Dropdown {
     hide(): Promise<{
         isOpen: boolean;
     }>;
+    /**
+     * Foca em um elemento específico com suporte a componentes personalizados
+     * @param targetElement Elemento a receber o foco
+     */
+    private focusOnElement;
+    /**
+     * Foca no elemento interativo dentro do slot trigger
+     * Esta função procura pelo elemento dentro do slot trigger e aplica o foco nele
+     */
+    private focusOnTriggerElement;
+    /**
+     * Define o foco no elemento interno do componente.
+     * Este método pode ser chamado externamente para garantir que o foco seja aplicado ao elemento correto.
+     */
+    setFocus(): Promise<void>;
     render(): any;
 }

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

@@ -57,5 +57,12 @@ export declare class Icon {
      * Aceita valores como "horizontal" para espelhar o ícone horizontalmente, "vertical" para espelhar verticalmente, ou ambos.
      */
     readonly flip?: 'horizontal' | 'vertical';
+    /**
+     * Determina se o ícone pode receber foco.
+     * Se definido como verdadeiro, o ícone pode ser navegado usando Tab.
+     * O valor padrão é `false`.
+     */
+    readonly isFocusable?: boolean;
+    componentDidLoad(): void;
     render(): any;
 }

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

@@ -0,0 +1,238 @@
+import { EventEmitter } from '../../stencil-public-runtime';
+type TooltipPosition = 'top' | 'bottom' | 'left' | 'right';
+type TooltipType = 'standard' | 'popover';
+type TooltipDensity = 'large' | 'medium' | 'small';
+type TooltipState = 'info' | 'warning' | 'error' | 'success';
+/**
+ * Para uma descrição detalhada, consulte a [documentação do GovBR-DS](https:
+ *
+ * @slot trigger - Área para o elemento acionador do tooltip.
+ * @slot content - Área para o conteúdo do tooltip.
+ */
+export declare class Tooltip {
+    /**
+     * Referência ao elemento host do componente.
+     * Utilize esta propriedade para acessar e manipular o elemento do DOM associado ao componente.
+     */
+    el: HTMLBrTooltipElement;
+    /**
+     * Referência ao elemento Internals do componente.
+     * O elemento Internals fornece uma interface para acessar e manipular o estado interno do componente.
+     * Isso é útil para componentes que precisam se integrar com o sistema de formulários nativo do navegador.
+     */
+    elementInternals: ElementInternals;
+    /**
+     * Identificador único.
+     * Caso não seja fornecido, um ID gerado automaticamente será usado.
+     */
+    customId: string;
+    /**
+     * Define a posição do tooltip em relação ao elemento acionador.
+     * As opções disponíveis são: 'top', 'bottom', 'left' e 'right'.
+     * @default 'top'
+     */
+    position: TooltipPosition;
+    /**
+     * Define o tipo de tooltip a ser exibido.
+     * As opções disponíveis são: 'standard' e 'popover'.
+     * O tipo 'standard' exibe um tooltip simples, enquanto o tipo 'popover' exibe um tooltip com mais informações e fechamento por interação.
+     * @default 'standard'
+     */
+    type: TooltipType;
+    /**
+     * Define a densidade do tooltip.
+     * As opções disponíveis são: 'large', 'medium' e 'small'.
+     * A densidade 'small' exibe um tooltip mais compacto, enquanto a densidade 'large' exibe um tooltip mais espaçado.
+     * @default 'medium'
+     */
+    density: TooltipDensity;
+    /**
+     * Define o estado do tooltip.
+     * Os estados disponíveis são: 'info', 'warning', 'error' e 'success'.
+     * @default 'info'
+     */
+    state: TooltipState;
+    /**
+     * Define se o tooltip deve ser exibido automaticamente.
+     * Quando definido como true, o tooltip será exibido automaticamente.
+     * Quando definido como false, o tooltip será exibido apenas quando acionado pelo usuário.
+     * @default false
+     */
+    isAutoVisible: boolean;
+    /**
+     * Define o atraso em milissegundos para exibir o tooltip.
+     * @default null
+     */
+    showDelay: number;
+    /**
+     * Define o atraso em milissegundos para ocultar o tooltip.
+     * @default null
+     */
+    hideDelay: number;
+    /**
+     * Define a visibilidade do tooltip.
+     * Quando definido como true, o tooltip será exibido.
+     * Quando definido como false, o tooltip será ocultado.
+     * @default false
+     */
+    isVisible: boolean;
+    /**
+     * Watcher para monitorar alterações na propriedade `isVisible`.
+     * @param visible boolean
+     * @returns void
+     */
+    handleVisibilityChange(visible: boolean): void;
+    /**
+     * Evento emitido quando o tooltip é aberto.
+     */
+    brDidOpen: EventEmitter<void>;
+    /**
+     * Evento emitido quando o tooltip é fechado.
+     */
+    brDidClose: EventEmitter<void>;
+    /**
+     * Listener para o evento de foco no elemento acionador.
+     * Este evento é utilizado para exibir o tooltip quando o elemento acionador recebe foco.
+     */
+    handleFocusIn(): void;
+    /**
+     * Listener para o evento de desfoque no elemento acionador.
+     * Este evento é utilizado para ocultar o tooltip quando o elemento acionador perde o foco.
+     */
+    handleFocusOut(): void;
+    /**
+     * Listener para o evento de teclado no documento.
+     * Este evento é utilizado para fechar o tooltip quando a tecla Escape é pressionada.
+     * @param event KeyboardEvent
+     */
+    handleKeyDown(event: KeyboardEvent): void;
+    private floatingManager;
+    /**
+     * Elemento que aciona a exibição do tooltip.
+     * Este elemento é referenciado para garantir que o tooltip seja posicionado corretamente em relação a ele.
+     */
+    private triggerElement;
+    /**
+     * 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.
+     */
+    private contentElement;
+    /**
+     * Elemento que representa a seta do tooltip.
+     * Este elemento é utilizado para indicar a direção do tooltip em relação ao elemento acionador.
+     */
+    private arrowElement;
+    /**
+     * Função de limpeza para atualizar a posição do tooltip automaticamente.
+     * Esta função é chamada quando o tooltip não está mais visível ou quando o componente é desconectado.
+     * Isso garante que o tooltip não consuma recursos desnecessários quando não estiver em uso.
+     */
+    private clearAutoUpdate;
+    /**
+     * Tempo limite para exibir o tooltip automaticamente.
+     */
+    private showTimer;
+    /**
+     * Tempo limite para ocultar o tooltip.
+     */
+    private hideTimer;
+    /**
+     * Indica se o tooltip foi acionado por um clique do mouse.
+     * Isso é utilizado para evitar conflito com o acionamento por foco.
+     */
+    private fromPointerDown;
+    /**
+     * 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.
+     */
+    private positionTooltip;
+    private cleanupPositioning;
+    /**
+     * Define os eventos de interação do tooltip.
+     * Os eventos de interação incluem mouseenter, mouseleave, focus e blur.
+     * @returns void
+     */
+    private setupInteractions;
+    /**
+     * Alterna a exibição do tooltip.
+     * Se o tooltip estiver visível, ele será ocultado.
+     * Se o tooltip estiver oculto, ele será exibido.
+     */
+    private toggleContent;
+    /**
+     * 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
+     */
+    private showContent;
+    /**
+     * 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
+     */
+    private hideContent;
+    /**
+     * Configura o tempo limite para exibir o tooltip automaticamente.
+     * O tempo limite é definido pelo valor da propriedade `showDelay`.
+     */
+    private setShowTimer;
+    /**
+     * Limpa o tempo limite de exibição automática do tooltip.
+     */
+    private clearShowTimer;
+    /**
+     * Configura o tempo limite para ocultar o tooltip automaticamente.
+     * O tempo limite é definido pelo valor da propriedade `hideDelay`.
+     */
+    private setHideTimer;
+    /**
+     * Limpa o tempo limite de ocultação automática do tooltip.
+     */
+    private clearHideTimer;
+    /**
+     * Lida com cliques fora do tooltip.
+     * É utilizado para o tooltip do tipo 'popover'.
+     * @param event MouseEvent
+     */
+    private handleOutsideClick;
+    /**
+     * Determina o mapeamento de classes CSS do componente.
+     * @returns Um objeto que representa o mapeamento de classes CSS do componente.
+     */
+    private getCssClassMap;
+    /**
+     * Determina o mapeamento de classes CSS do trigger.
+     * @returns Um objeto que representa o mapeamento de classes CSS do trigger.
+     */
+    private getTriggerCssClassMap;
+    /**
+     * Determina o mapeamento de classes CSS do conteúdo.
+     * @returns Um objeto que representa o mapeamento de classes CSS do conteúdo.
+     */
+    private getContentCssClassMap;
+    /**
+     * Determina o mapeamento de classes CSS da seta.
+     * @returns Um objeto que representa o mapeamento de classes CSS da seta.
+     */
+    private getArrowCssClassMap;
+    /**
+     * Método do ciclo de vida do componente.
+     * Este método é chamado uma única vez após o componente ser montado no DOM.
+     */
+    componentDidLoad(): void;
+    /**
+     * Método do ciclo de vida do componente.
+     * Este método é chamado quando o componente é desconectado do DOM.
+     */
+    disconnectedCallback(): void;
+    /**
+     * 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(): any;
+}
+export {};

package/dist/types/components.d.ts

@@ -298,6 +298,10 @@ export namespace Components {
           * @Method () para que possa ser chamado externamente.
          */
         "open": () => Promise<{ isOpen: boolean; }>;
+        /**
+          * Define o foco no elemento interno do componente. Este método pode ser chamado externamente para garantir que o foco seja aplicado ao elemento correto.
+         */
+        "setFocus": () => Promise<void>;
     }
     /**
      * O componente `br-footer` representa o rodapé do site, de acordo com a documentação de design do GovBR.
@@ -445,6 +449,10 @@ export namespace Components {
           * Nome do ícone a ser exibido, utilizando a biblioteca Iconify. Este nome deve corresponder ao nome do ícone definido na biblioteca para que ele seja exibido corretamente.
          */
         "iconName": string;
+        /**
+          * Determina se o ícone pode receber foco. Se definido como verdadeiro, o ícone pode ser navegado usando Tab. O valor padrão é `false`.
+         */
+        "isFocusable"?: boolean;
         /**
           * Se definido como verdadeiro, o ícone será alinhado verticalmente ao texto ao seu redor. Útil quando o ícone é usado em linha com texto para garantir que esteja alinhado corretamente com o texto. O valor padrão é `false`.
          */
@@ -1239,6 +1247,50 @@ export namespace Components {
          */
         "value": string;
     }
+    /**
+     * Para uma descrição detalhada, consulte a [documentação do GovBR-DS](https:
+     */
+    interface BrTooltip {
+        /**
+          * Identificador único. Caso não seja fornecido, um ID gerado automaticamente será usado.
+         */
+        "customId": string;
+        /**
+          * Define a densidade do tooltip. As opções disponíveis são: 'large', 'medium' e 'small'. A densidade 'small' exibe um tooltip mais compacto, enquanto a densidade 'large' exibe um tooltip mais espaçado.
+          * @default 'medium'
+         */
+        "density": TooltipDensity;
+        /**
+          * Define o atraso em milissegundos para ocultar o tooltip.
+          * @default null
+         */
+        "hideDelay": number;
+        /**
+          * Define se o tooltip deve ser exibido automaticamente. Quando definido como true, o tooltip será exibido automaticamente. Quando definido como false, o tooltip será exibido apenas quando acionado pelo usuário.
+          * @default false
+         */
+        "isAutoVisible": boolean;
+        /**
+          * Define a posição do tooltip em relação ao elemento acionador. As opções disponíveis são: 'top', 'bottom', 'left' e 'right'.
+          * @default 'top'
+         */
+        "position": TooltipPosition;
+        /**
+          * Define o atraso em milissegundos para exibir o tooltip.
+          * @default null
+         */
+        "showDelay": number;
+        /**
+          * Define o estado do tooltip. Os estados disponíveis são: 'info', 'warning', 'error' e 'success'.
+          * @default 'info'
+         */
+        "state": TooltipState;
+        /**
+          * Define o tipo de tooltip a ser exibido. As opções disponíveis são: 'standard' e 'popover'. O tipo 'standard' exibe um tooltip simples, enquanto o tipo 'popover' exibe um tooltip com mais informações e fechamento por interação.
+          * @default 'standard'
+         */
+        "type": TooltipType;
+    }
     /**
      * Para uma descrição detalhada, consulte a [documentação do GovBR-DS](https://www.gov.br/ds/components/upload?tab=designer).
      */
@@ -1333,6 +1385,10 @@ export interface BrTextareaCustomEvent<T> extends CustomEvent<T> {
     detail: T;
     target: HTMLBrTextareaElement;
 }
+export interface BrTooltipCustomEvent<T> extends CustomEvent<T> {
+    detail: T;
+    target: HTMLBrTooltipElement;
+}
 declare global {
     /**
      * Para uma descrição detalhada, consulte a [documentação do GovBR-DS](https://www.gov.br/ds/components/avatar?tab=designer).
@@ -1856,6 +1912,27 @@ declare global {
         prototype: HTMLBrTextareaElement;
         new (): HTMLBrTextareaElement;
     };
+    interface HTMLBrTooltipElementEventMap {
+        "brDidOpen": void;
+        "brDidClose": void;
+    }
+    /**
+     * Para uma descrição detalhada, consulte a [documentação do GovBR-DS](https:
+     */
+    interface HTMLBrTooltipElement extends Components.BrTooltip, HTMLStencilElement {
+        addEventListener<K extends keyof HTMLBrTooltipElementEventMap>(type: K, listener: (this: HTMLBrTooltipElement, ev: BrTooltipCustomEvent<HTMLBrTooltipElementEventMap[K]>) => any, options?: boolean | AddEventListenerOptions): void;
+        addEventListener<K extends keyof DocumentEventMap>(type: K, listener: (this: Document, ev: DocumentEventMap[K]) => any, options?: boolean | AddEventListenerOptions): void;
+        addEventListener<K extends keyof HTMLElementEventMap>(type: K, listener: (this: HTMLElement, ev: HTMLElementEventMap[K]) => any, options?: boolean | AddEventListenerOptions): void;
+        addEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | AddEventListenerOptions): void;
+        removeEventListener<K extends keyof HTMLBrTooltipElementEventMap>(type: K, listener: (this: HTMLBrTooltipElement, ev: BrTooltipCustomEvent<HTMLBrTooltipElementEventMap[K]>) => any, options?: boolean | EventListenerOptions): void;
+        removeEventListener<K extends keyof DocumentEventMap>(type: K, listener: (this: Document, ev: DocumentEventMap[K]) => any, options?: boolean | EventListenerOptions): void;
+        removeEventListener<K extends keyof HTMLElementEventMap>(type: K, listener: (this: HTMLElement, ev: HTMLElementEventMap[K]) => any, options?: boolean | EventListenerOptions): void;
+        removeEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | EventListenerOptions): void;
+    }
+    var HTMLBrTooltipElement: {
+        prototype: HTMLBrTooltipElement;
+        new (): HTMLBrTooltipElement;
+    };
     /**
      * Para uma descrição detalhada, consulte a [documentação do GovBR-DS](https://www.gov.br/ds/components/upload?tab=designer).
      */
@@ -1901,6 +1978,7 @@ declare global {
         "br-table-row": HTMLBrTableRowElement;
         "br-tag": HTMLBrTagElement;
         "br-textarea": HTMLBrTextareaElement;
+        "br-tooltip": HTMLBrTooltipElement;
         "br-upload": HTMLBrUploadElement;
     }
 }
@@ -2335,6 +2413,10 @@ declare namespace LocalJSX {
           * Nome do ícone a ser exibido, utilizando a biblioteca Iconify. Este nome deve corresponder ao nome do ícone definido na biblioteca para que ele seja exibido corretamente.
          */
         "iconName"?: string;
+        /**
+          * Determina se o ícone pode receber foco. Se definido como verdadeiro, o ícone pode ser navegado usando Tab. O valor padrão é `false`.
+         */
+        "isFocusable"?: boolean;
         /**
           * Se definido como verdadeiro, o ícone será alinhado verticalmente ao texto ao seu redor. Útil quando o ícone é usado em linha com texto para garantir que esteja alinhado corretamente com o texto. O valor padrão é `false`.
          */
@@ -3122,6 +3204,58 @@ declare namespace LocalJSX {
          */
         "value"?: string;
     }
+    /**
+     * Para uma descrição detalhada, consulte a [documentação do GovBR-DS](https:
+     */
+    interface BrTooltip {
+        /**
+          * Identificador único. Caso não seja fornecido, um ID gerado automaticamente será usado.
+         */
+        "customId"?: string;
+        /**
+          * Define a densidade do tooltip. As opções disponíveis são: 'large', 'medium' e 'small'. A densidade 'small' exibe um tooltip mais compacto, enquanto a densidade 'large' exibe um tooltip mais espaçado.
+          * @default 'medium'
+         */
+        "density"?: TooltipDensity;
+        /**
+          * Define o atraso em milissegundos para ocultar o tooltip.
+          * @default null
+         */
+        "hideDelay"?: number;
+        /**
+          * Define se o tooltip deve ser exibido automaticamente. Quando definido como true, o tooltip será exibido automaticamente. Quando definido como false, o tooltip será exibido apenas quando acionado pelo usuário.
+          * @default false
+         */
+        "isAutoVisible"?: boolean;
+        /**
+          * Evento emitido quando o tooltip é fechado.
+         */
+        "onBrDidClose"?: (event: BrTooltipCustomEvent<void>) => void;
+        /**
+          * Evento emitido quando o tooltip é aberto.
+         */
+        "onBrDidOpen"?: (event: BrTooltipCustomEvent<void>) => void;
+        /**
+          * Define a posição do tooltip em relação ao elemento acionador. As opções disponíveis são: 'top', 'bottom', 'left' e 'right'.
+          * @default 'top'
+         */
+        "position"?: TooltipPosition;
+        /**
+          * Define o atraso em milissegundos para exibir o tooltip.
+          * @default null
+         */
+        "showDelay"?: number;
+        /**
+          * Define o estado do tooltip. Os estados disponíveis são: 'info', 'warning', 'error' e 'success'.
+          * @default 'info'
+         */
+        "state"?: TooltipState;
+        /**
+          * Define o tipo de tooltip a ser exibido. As opções disponíveis são: 'standard' e 'popover'. O tipo 'standard' exibe um tooltip simples, enquanto o tipo 'popover' exibe um tooltip com mais informações e fechamento por interação.
+          * @default 'standard'
+         */
+        "type"?: TooltipType;
+    }
     /**
      * Para uma descrição detalhada, consulte a [documentação do GovBR-DS](https://www.gov.br/ds/components/upload?tab=designer).
      */
@@ -3183,6 +3317,7 @@ declare namespace LocalJSX {
         "br-table-row": BrTableRow;
         "br-tag": BrTag;
         "br-textarea": BrTextarea;
+        "br-tooltip": BrTooltip;
         "br-upload": BrUpload;
     }
 }
@@ -3343,6 +3478,10 @@ declare module "@stencil/core" {
              * Para uma descrição detalhada, consulte a [documentação do GovBR-DS](https://www.gov.br/ds/components/textarea?tab=designer).
              */
             "br-textarea": LocalJSX.BrTextarea & JSXBase.HTMLAttributes<HTMLBrTextareaElement>;
+            /**
+             * Para uma descrição detalhada, consulte a [documentação do GovBR-DS](https:
+             */
+            "br-tooltip": LocalJSX.BrTooltip & JSXBase.HTMLAttributes<HTMLBrTooltipElement>;
             /**
              * Para uma descrição detalhada, consulte a [documentação do GovBR-DS](https://www.gov.br/ds/components/upload?tab=designer).
              */

package/dist/types/utils/floating-ui.d.ts

@@ -0,0 +1,78 @@
+import { Placement } from '@floating-ui/dom';
+/**
+ * FloatingUIManagerOptions define as opções para o FloatingUIManager.
+ */
+export interface FloatingUIManagerOptions {
+    triggerElement: HTMLElement;
+    contentElement: HTMLElement;
+    arrowElement?: HTMLElement;
+    placement?: Placement;
+    onUpdate?: (data: {
+        x: number;
+        y: number;
+        placement: string;
+        middlewareData: import('@floating-ui/dom').MiddlewareData;
+    }) => void;
+}
+/**
+ * FloatingUIManager é uma classe utilitária que gerencia o posicionamento de elementos flutuantes
+ * como tooltips ou popovers em relação a um elemento de disparo (trigger).
+ * Ela utiliza a biblioteca Floating UI para calcular posições e lidar com atualizações.
+ */
+export declare class FloatingUIManager {
+    private triggerElement;
+    private contentElement;
+    private arrowElement?;
+    private placement;
+    private onUpdate?;
+    private cleanupAutoUpdate?;
+    constructor(options: FloatingUIManagerOptions);
+    /**
+     * Inicia o gerenciador Floating UI configurando a atualização automática da posição.
+     */
+    start(): void;
+    /**
+     * Para o gerenciador Floating UI e limpa os recursos utilizados.
+     */
+    stop(): void;
+    /**
+     * Atualiza a posição do elemento flutuante com base no elemento disparador e no elemento de conteúdo.
+     * Esta função é chamada automaticamente quando o gerenciador está ativo.
+     * Ela calcula a nova posição usando a biblioteca Floating UI e aplica as transformações necessárias.
+     * Também atualiza a posição da seta, se fornecida.
+     * Além disso, define o atributo de dados `data-placement` no elemento de conteúdo para refletir a posição atual.
+     * @returns {Promise<void>} Uma promessa que resolve quando a posição é atualizada.
+     */
+    private updatePosition;
+    /**
+     * Constrói os middlewares necessários para o Floating UI.
+     * Esses middlewares são usados para ajustar o posicionamento do elemento flutuante,
+     * incluindo offset, flip, shift e hide. Se uma seta for fornecida, o middleware de seta também é adicionado.
+     * @returns {Middleware[]} Retorna um array de middlewares configurados para o Floating UI.
+     */
+    private buildMiddleware;
+    /**
+     * Adiciona o estilo necessário para posicionar o tooltip com base nas coordenadas fornecidas.
+     * Esta função é chamada após o cálculo da posição do tooltip.
+     * Ela aplica as propriedades CSS `left` e `top` ao elemento de conteúdo do tooltip.
+     * @param data Contém as coordenadas x e y para posicionar o tooltip.
+     */
+    private updateTooltipPosition;
+    /**
+     * Adiciona o estilo necessário para posicionar a seta do tooltip com base nos dados de middleware.
+     * Esta função é chamada após o cálculo da posição do tooltip.
+     * Ela aplica as propriedades CSS `left`, `top`, `right`, `bottom` e a posição estática da seta.
+     * A posição estática é determinada com base na colocação do tooltip (top, right, bottom, left).
+     * Se a seta não estiver presente ou os dados de middleware não contiverem informações sobre a seta, nada será feito.
+     * @param data Contém a posição da seta e os dados de middleware.
+     */
+    private updateArrowPosition;
+    /**
+     * Define o atributo de dados `data-placement` no elemento de conteúdo.
+     * Este atributo é usado para indicar a posição atual do tooltip ou popover.
+     * Ele é útil para fins de acessibilidade e para permitir que estilos CSS sejam aplicados com base na posição.
+     * @param data Objeto contendo a propriedade `placement` que define a posição do tooltip ou popover.
+     *            A propriedade `placement` deve ser uma string representando a posição, como 'top', 'bottom', 'left', 'right', etc.
+     */
+    private setPlacementDataAttribute;
+}