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

package/dist/custom-elements.json

@@ -868,6 +868,10 @@
             }
           ],
           "tagName": "br-button",
+          "csspart": {
+            "name": "slot-content",
+            "description": "Espaço de conteúdo do botão. Geralmente usado para incluir o rótulo."
+          },
           "events": [],
           "customElement": true
         }
@@ -8727,6 +8731,498 @@
         }
       ]
     },
+    {
+      "kind": "javascript-module",
+      "path": "components/tooltip.js",
+      "declarations": [
+        {
+          "kind": "class",
+          "description": "Para uma descrição detalhada, consulte a [documentação do GovBR-DS](https:",
+          "name": "Tooltip",
+          "slots": [
+            {
+              "description": "Área para o elemento acionador do tooltip.",
+              "name": "trigger"
+            },
+            {
+              "description": "Área para o conteúdo do tooltip.",
+              "name": "content"
+            }
+          ],
+          "members": [
+            {
+              "kind": "field",
+              "name": "el",
+              "type": {
+                "text": "HTMLBrTooltipElement"
+              },
+              "description": "Referência ao elemento host do componente.\nUtilize esta propriedade para acessar e manipular o elemento do DOM associado ao componente."
+            },
+            {
+              "kind": "field",
+              "name": "elementInternals",
+              "type": {
+                "text": "ElementInternals"
+              },
+              "description": "Referência ao elemento Internals do componente.\nO elemento Internals fornece uma interface para acessar e manipular o estado interno do componente.\nIsso é útil para componentes que precisam se integrar com o sistema de formulários nativo do navegador."
+            },
+            {
+              "kind": "field",
+              "name": "customId",
+              "type": {
+                "text": "string"
+              },
+              "description": "Identificador único.\nCaso não seja fornecido, um ID gerado automaticamente será usado."
+            },
+            {
+              "kind": "field",
+              "name": "position",
+              "type": {
+                "text": "TooltipPosition"
+              },
+              "default": "'top'",
+              "description": "Define a posição do tooltip em relação ao elemento acionador.\nAs opções disponíveis são: 'top', 'bottom', 'left' e 'right'.",
+              "expandedType": {
+                "text": "'top' | 'bottom' | 'left' | 'right'"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "type",
+              "type": {
+                "text": "TooltipType"
+              },
+              "default": "'standard'",
+              "description": "Define o tipo de tooltip a ser exibido.\nAs opções disponíveis são: 'standard' e 'popover'.\nO tipo 'standard' exibe um tooltip simples, enquanto o tipo 'popover' exibe um tooltip com mais informações e fechamento por interação.",
+              "expandedType": {
+                "text": "'standard' | 'popover'"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "density",
+              "type": {
+                "text": "TooltipDensity"
+              },
+              "default": "'medium'",
+              "description": "Define a densidade do tooltip.\nAs opções disponíveis são: 'large', 'medium' e 'small'.\nA densidade 'small' exibe um tooltip mais compacto, enquanto a densidade 'large' exibe um tooltip mais espaçado.",
+              "expandedType": {
+                "text": "'large' | 'medium' | 'small'"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "state",
+              "type": {
+                "text": "TooltipState"
+              },
+              "default": "'info'",
+              "description": "Define o estado do tooltip.\nOs estados disponíveis são: 'info', 'warning', 'error' e 'success'.",
+              "expandedType": {
+                "text": "'info' | 'warning' | 'error' | 'success'"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "isAutoVisible",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Define se o tooltip deve ser exibido automaticamente.\nQuando definido como true, o tooltip será exibido automaticamente.\nQuando definido como false, o tooltip será exibido apenas quando acionado pelo usuário."
+            },
+            {
+              "kind": "field",
+              "name": "showDelay",
+              "type": {
+                "text": "number"
+              },
+              "default": "null",
+              "description": "Define o atraso em milissegundos para exibir o tooltip."
+            },
+            {
+              "kind": "field",
+              "name": "hideDelay",
+              "type": {
+                "text": "number"
+              },
+              "default": "null",
+              "description": "Define o atraso em milissegundos para ocultar o tooltip."
+            },
+            {
+              "kind": "field",
+              "name": "isVisible",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Define a visibilidade do tooltip.\nQuando definido como true, o tooltip será exibido.\nQuando definido como false, o tooltip será ocultado."
+            },
+            {
+              "kind": "method",
+              "name": "handleVisibilityChange",
+              "parameters": [
+                {
+                  "name": "visible",
+                  "type": {
+                    "text": "boolean"
+                  },
+                  "description": "boolean"
+                }
+              ],
+              "description": "Watcher para monitorar alterações na propriedade `isVisible`.",
+              "return": {
+                "type": {
+                  "text": ""
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "handleFocusIn",
+              "description": "Listener para o evento de foco no elemento acionador.\nEste evento é utilizado para exibir o tooltip quando o elemento acionador recebe foco."
+            },
+            {
+              "kind": "method",
+              "name": "handleFocusOut",
+              "description": "Listener para o evento de desfoque no elemento acionador.\nEste evento é utilizado para ocultar o tooltip quando o elemento acionador perde o foco."
+            },
+            {
+              "kind": "method",
+              "name": "handleKeyDown",
+              "parameters": [
+                {
+                  "name": "event",
+                  "type": {
+                    "text": "KeyboardEvent"
+                  },
+                  "description": "KeyboardEvent"
+                }
+              ],
+              "description": "Listener para o evento de teclado no documento.\nEste evento é utilizado para fechar o tooltip quando a tecla Escape é pressionada."
+            },
+            {
+              "kind": "field",
+              "name": "floatingManager",
+              "type": {
+                "text": "FloatingUIManager"
+              },
+              "privacy": "private"
+            },
+            {
+              "kind": "field",
+              "name": "triggerElement",
+              "type": {
+                "text": "HTMLDivElement"
+              },
+              "privacy": "private",
+              "description": "Elemento que aciona a exibição do tooltip.\nEste elemento é referenciado para garantir que o tooltip seja posicionado corretamente em relação a ele."
+            },
+            {
+              "kind": "field",
+              "name": "contentElement",
+              "type": {
+                "text": "HTMLDivElement"
+              },
+              "privacy": "private",
+              "description": "Elemento que contém o conteúdo do tooltip.\nEste elemento é referenciado para garantir que o tooltip seja posicionado corretamente em relação a ele."
+            },
+            {
+              "kind": "field",
+              "name": "arrowElement",
+              "type": {
+                "text": "HTMLDivElement"
+              },
+              "privacy": "private",
+              "description": "Elemento que representa a seta do tooltip.\nEste elemento é utilizado para indicar a direção do tooltip em relação ao elemento acionador."
+            },
+            {
+              "kind": "field",
+              "name": "clearAutoUpdate",
+              "type": {
+                "text": "() => void"
+              },
+              "privacy": "private",
+              "description": "Função de limpeza para atualizar a posição do tooltip automaticamente.\nEsta função é chamada quando o tooltip não está mais visível ou quando o componente é desconectado.\nIsso garante que o tooltip não consuma recursos desnecessários quando não estiver em uso."
+            },
+            {
+              "kind": "field",
+              "name": "showTimer",
+              "type": {
+                "text": "ReturnType<typeof setTimeout>"
+              },
+              "privacy": "private",
+              "description": "Tempo limite para exibir o tooltip automaticamente."
+            },
+            {
+              "kind": "field",
+              "name": "hideTimer",
+              "type": {
+                "text": "ReturnType<typeof setTimeout>"
+              },
+              "privacy": "private",
+              "description": "Tempo limite para ocultar o tooltip."
+            },
+            {
+              "kind": "field",
+              "name": "fromPointerDown",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "default": "false",
+              "description": "Indica se o tooltip foi acionado por um clique do mouse.\nIsso é utilizado para evitar conflito com o acionamento por foco."
+            },
+            {
+              "kind": "method",
+              "name": "positionTooltip",
+              "privacy": "private",
+              "description": "Controla a exibição do tooltip.\nQuando o tooltip é exibido, ele é posicionado em relação ao elemento acionador.\nIsso é feito utilizando a biblioteca Floating UI, que calcula a posição ideal do tooltip com base no espaço disponível na tela.\nA função `autoUpdate` é utilizada para atualizar automaticamente a posição do tooltip quando o elemento acionador é movido ou redimensionado."
+            },
+            {
+              "kind": "method",
+              "name": "cleanupPositioning",
+              "privacy": "private"
+            },
+            {
+              "kind": "method",
+              "name": "setupInteractions",
+              "privacy": "private",
+              "description": "Define os eventos de interação do tooltip.\nOs eventos de interação incluem mouseenter, mouseleave, focus e blur.",
+              "return": {
+                "type": {
+                  "text": ""
+                }
+              }
+            },
+            {
+              "kind": "field",
+              "name": "toggleContent",
+              "privacy": "private",
+              "description": "Alterna a exibição do tooltip.\nSe o tooltip estiver visível, ele será ocultado.\nSe o tooltip estiver oculto, ele será exibido."
+            },
+            {
+              "kind": "field",
+              "name": "showContent",
+              "privacy": "private",
+              "description": "Processa as ações relacionadas à exibição do tooltip.\nIsso inclui exibir o tooltip e iniciar o tempo limite de ocultação automática.",
+              "return": {
+                "type": {
+                  "text": ""
+                }
+              }
+            },
+            {
+              "kind": "field",
+              "name": "hideContent",
+              "privacy": "private",
+              "description": "Processa as ações relacionadas ao fechamento do tooltip.\nIsso inclui ocultar o tooltip e limpar o tempo limite de ocultação automática.",
+              "return": {
+                "type": {
+                  "text": ""
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "setShowTimer",
+              "privacy": "private",
+              "description": "Configura o tempo limite para exibir o tooltip automaticamente.\nO tempo limite é definido pelo valor da propriedade `showDelay`."
+            },
+            {
+              "kind": "method",
+              "name": "clearShowTimer",
+              "privacy": "private",
+              "description": "Limpa o tempo limite de exibição automática do tooltip."
+            },
+            {
+              "kind": "method",
+              "name": "setHideTimer",
+              "privacy": "private",
+              "description": "Configura o tempo limite para ocultar o tooltip automaticamente.\nO tempo limite é definido pelo valor da propriedade `hideDelay`."
+            },
+            {
+              "kind": "method",
+              "name": "clearHideTimer",
+              "privacy": "private",
+              "description": "Limpa o tempo limite de ocultação automática do tooltip."
+            },
+            {
+              "kind": "field",
+              "name": "handleOutsideClick",
+              "privacy": "private",
+              "description": "Lida com cliques fora do tooltip.\nÉ utilizado para o tooltip do tipo 'popover'.",
+              "parameters": [
+                {
+                  "description": "MouseEvent",
+                  "name": "event"
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "getCssClassMap",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": ""
+                }
+              },
+              "description": "Determina o mapeamento de classes CSS do componente."
+            },
+            {
+              "kind": "method",
+              "name": "getTriggerCssClassMap",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": ""
+                }
+              },
+              "description": "Determina o mapeamento de classes CSS do trigger."
+            },
+            {
+              "kind": "method",
+              "name": "getContentCssClassMap",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": ""
+                }
+              },
+              "description": "Determina o mapeamento de classes CSS do conteúdo."
+            },
+            {
+              "kind": "method",
+              "name": "getArrowCssClassMap",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": ""
+                }
+              },
+              "description": "Determina o mapeamento de classes CSS da seta."
+            },
+            {
+              "kind": "method",
+              "name": "render",
+              "description": "Renderiza o componente.\nEste método é responsável por gerar o conteúdo HTML do componente.\nEle utiliza a função `h` do Stencil para criar elementos JSX.",
+              "return": {
+                "type": {
+                  "text": ""
+                }
+              }
+            }
+          ],
+          "attributes": [
+            {
+              "name": "custom-id",
+              "fieldName": "customId",
+              "type": {
+                "text": "string"
+              }
+            },
+            {
+              "name": "position",
+              "fieldName": "position",
+              "type": {
+                "text": "TooltipPosition"
+              },
+              "expandedType": {
+                "text": "'top' | 'bottom' | 'left' | 'right'"
+              }
+            },
+            {
+              "name": "type",
+              "fieldName": "type",
+              "type": {
+                "text": "TooltipType"
+              },
+              "expandedType": {
+                "text": "'standard' | 'popover'"
+              }
+            },
+            {
+              "name": "density",
+              "fieldName": "density",
+              "type": {
+                "text": "TooltipDensity"
+              },
+              "expandedType": {
+                "text": "'large' | 'medium' | 'small'"
+              }
+            },
+            {
+              "name": "state",
+              "fieldName": "state",
+              "type": {
+                "text": "TooltipState"
+              },
+              "expandedType": {
+                "text": "'info' | 'warning' | 'error' | 'success'"
+              }
+            },
+            {
+              "name": "is-auto-visible",
+              "fieldName": "isAutoVisible",
+              "type": {
+                "text": "boolean"
+              }
+            },
+            {
+              "name": "show-delay",
+              "fieldName": "showDelay",
+              "type": {
+                "text": "number"
+              }
+            },
+            {
+              "name": "hide-delay",
+              "fieldName": "hideDelay",
+              "type": {
+                "text": "number"
+              }
+            }
+          ],
+          "tagName": "br-tooltip",
+          "events": [
+            {
+              "name": "brDidOpen",
+              "type": {
+                "text": "EventEmitter<void>"
+              },
+              "description": "Evento emitido quando o tooltip é aberto."
+            },
+            {
+              "name": "brDidClose",
+              "type": {
+                "text": "EventEmitter<void>"
+              },
+              "description": "Evento emitido quando o tooltip é fechado."
+            }
+          ],
+          "customElement": true
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "Tooltip",
+          "declaration": {
+            "name": "Tooltip",
+            "module": "components/tooltip.js"
+          }
+        },
+        {
+          "kind": "custom-element-definition",
+          "name": "br-tooltip",
+          "declaration": {
+            "name": "Tooltip",
+            "module": "components/tooltip.js"
+          }
+        }
+      ]
+    },
     {
       "kind": "javascript-module",
       "path": "components/upload.js",
@@ -9112,6 +9608,12 @@
       "path": "components/_tests/tag.spec.js",
       "declarations": [],
       "exports": []
+    },
+    {
+      "kind": "javascript-module",
+      "path": "components/_tests/tooltip.spec.js",
+      "declarations": [],
+      "exports": []
     }
   ]
 }