@govbr-ds/webcomponents 2.0.0-next.46 → 2.0.0-next.48

package/dist/custom-elements.json

@@ -6694,6 +6694,278 @@
         }
       ]
     },
+    {
+      "kind": "javascript-module",
+      "path": "components/sign-in.js",
+      "declarations": [
+        {
+          "kind": "class",
+          "description": "Para uma descrição detalhada, consulte a [documentação do GovBR-DS](https://www.gov.br/ds/components/sign-in?tab=designer).\n\nPara acessibilidade adequada, especialmente em formatos circulares, use a propriedade aria-label:\n<br-sign-in shape=\"circle\" aria-label=\"Fazer login com Gov.br\"></br-sign-in>\n\nPara controlar onde o link abre, use a propriedade target:\n<br-sign-in href=\"https://accounts.google.com\" target=\"_self\">Login Google</br-sign-in>\n<br-sign-in href=\"https://help.site.com\" target=\"_blank\">Ajuda</br-sign-in>",
+          "name": "SignIn",
+          "slots": [
+            {
+              "description": "Conteúdo do label/texto do sign-in",
+              "name": "default"
+            },
+            {
+              "description": "Ícone personalizado. Para shape=\"circle\", um ícone padrão (fa6-solid:user) será exibido se nenhum for fornecido",
+              "name": "icon"
+            },
+            {
+              "description": "Imagem ou ícone exibido ao lado da label",
+              "name": "image"
+            }
+          ],
+          "members": [
+            {
+              "kind": "field",
+              "name": "el",
+              "type": {
+                "text": "HTMLBrSignInElement"
+              },
+              "description": "Referência ao elemento host do componente.\nUtilize esta propriedade para acessar e manipular o elemento do DOM associado ao componente."
+            },
+            {
+              "kind": "field",
+              "name": "elementInternals",
+              "type": {
+                "text": "ElementInternals"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "customId",
+              "type": {
+                "text": "string"
+              },
+              "description": "Identificador único.\nCaso não seja fornecido, um ID gerado automaticamente será usado."
+            },
+            {
+              "kind": "field",
+              "name": "colorMode",
+              "type": {
+                "text": "'dark'"
+              },
+              "description": "Define se o sign-in usará um esquema de cores escuro."
+            },
+            {
+              "kind": "field",
+              "name": "density",
+              "type": {
+                "text": "'large' | 'medium' | 'small'"
+              },
+              "default": "'medium'",
+              "description": "Ajusta a densidade, alterando o espaçamento interno para um visual mais compacto ou mais expandido."
+            },
+            {
+              "kind": "field",
+              "name": "disabled",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Desativa o sign-in, tornando-o não interativo."
+            },
+            {
+              "kind": "field",
+              "name": "emphasis",
+              "type": {
+                "text": "'primary' | 'secondary'"
+              },
+              "default": "'secondary'",
+              "description": "Define a ênfase do sign-in, alterando sua aparência para criar hierarquia visual."
+            },
+            {
+              "kind": "field",
+              "name": "shape",
+              "type": {
+                "text": "'block' | 'circle' | 'pill'"
+              },
+              "default": "'pill'",
+              "description": "Define o formato do sign-in."
+            },
+            {
+              "kind": "field",
+              "name": "href",
+              "type": {
+                "text": "string"
+              },
+              "description": "URL para onde o usuário será redirecionado ao clicar. Use para login com provedores externos ou em sites tradicionais."
+            },
+            {
+              "kind": "field",
+              "name": "target",
+              "type": {
+                "text": "'_self' | '_blank' | '_parent' | '_top'"
+              },
+              "default": "'_self'",
+              "description": "Define onde abrir o link quando href é fornecido."
+            },
+            {
+              "kind": "field",
+              "name": "ariaLabel",
+              "type": {
+                "text": "string"
+              },
+              "description": "Define o rótulo acessível do sign-in, especialmente importante para formatos circulares."
+            },
+            {
+              "kind": "field",
+              "name": "handleClick",
+              "privacy": "private"
+            },
+            {
+              "kind": "field",
+              "name": "handleFocus",
+              "privacy": "private"
+            },
+            {
+              "kind": "method",
+              "name": "hasSlotContent",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "boolean"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "slotName",
+                  "type": {
+                    "text": "string"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "getCssClassMap",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "CssClassMap"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "getTagType",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "string"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "getAttributes",
+              "privacy": "private"
+            },
+            {
+              "kind": "method",
+              "name": "render"
+            }
+          ],
+          "attributes": [
+            {
+              "name": "custom-id",
+              "fieldName": "customId",
+              "type": {
+                "text": "string"
+              }
+            },
+            {
+              "name": "color-mode",
+              "fieldName": "colorMode",
+              "type": {
+                "text": "'dark'"
+              }
+            },
+            {
+              "name": "density",
+              "fieldName": "density",
+              "type": {
+                "text": "'large' | 'medium' | 'small'"
+              }
+            },
+            {
+              "name": "disabled",
+              "fieldName": "disabled",
+              "type": {
+                "text": "boolean"
+              }
+            },
+            {
+              "name": "emphasis",
+              "fieldName": "emphasis",
+              "type": {
+                "text": "'primary' | 'secondary'"
+              }
+            },
+            {
+              "name": "shape",
+              "fieldName": "shape",
+              "type": {
+                "text": "'block' | 'circle' | 'pill'"
+              }
+            },
+            {
+              "name": "href",
+              "fieldName": "href",
+              "type": {
+                "text": "string"
+              }
+            },
+            {
+              "name": "target",
+              "fieldName": "target",
+              "type": {
+                "text": "'_self' | '_blank' | '_parent' | '_top'"
+              }
+            },
+            {
+              "name": "aria-label",
+              "fieldName": "ariaLabel",
+              "type": {
+                "text": "string"
+              }
+            }
+          ],
+          "tagName": "br-sign-in",
+          "csspart": [
+            {
+              "name": "content",
+              "description": "Área do conteúdo/texto dentro do sign-in"
+            },
+            {
+              "name": "image",
+              "description": "Área da imagem/ícone (para controle de tamanho via CSS)"
+            }
+          ],
+          "events": [],
+          "customElement": true
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "SignIn",
+          "declaration": {
+            "name": "SignIn",
+            "module": "components/sign-in.js"
+          }
+        },
+        {
+          "kind": "custom-element-definition",
+          "name": "br-sign-in",
+          "declaration": {
+            "name": "SignIn",
+            "module": "components/sign-in.js"
+          }
+        }
+      ]
+    },
     {
       "kind": "javascript-module",
       "path": "components/step.js",
@@ -7570,6 +7842,17 @@
                 }
               }
             },
+            {
+              "kind": "method",
+              "name": "getAccessibilityLabel",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "string"
+                }
+              },
+              "description": "Determina o texto a ser usado para acessibilidade quando não há label visível"
+            },
             {
               "kind": "field",
               "name": "handleCheckedChange",
@@ -7585,6 +7868,17 @@
               "name": "toggleChecked",
               "description": "Inverte o valor da prop `checked`"
             },
+            {
+              "kind": "method",
+              "name": "hasVisibleText",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "boolean"
+                }
+              },
+              "description": "Verifica se o componente tem texto visível (via slot ou label)"
+            },
             {
               "kind": "method",
               "name": "getCssClassMap",
@@ -8859,7 +9153,7 @@
               "type": {
                 "text": "'small' | 'medium' | 'large'"
               },
-              "default": "DENSITY_SMALL",
+              "default": "DENSITY_MEDIUM",
               "description": "A propriedade 'density' permite definir a densidade do componente.\nAceita valores como 'small', 'medium' e 'large', e é refletida no DOM."
             },
             {
@@ -8878,7 +9172,7 @@
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Status deve ser exibido."
+              "description": "Transforma a tag em um indicador de status, com aparência circular.\nÉ flexível podendo ser utilizado com label ou apenas a superfície circular (informação é transmitida por meio de cores)."
             },
             {
               "kind": "field",
@@ -8907,6 +9201,24 @@
               "default": "false",
               "description": "Tag deve estar desabilitado."
             },
+            {
+              "kind": "field",
+              "name": "ariaLabel",
+              "type": {
+                "text": "string"
+              },
+              "default": "null",
+              "description": "Rótulo personalizado para leitores de tela.\nQuando fornecido, substitui completamente o texto visível para usuários de leitores de tela.\nÚtil quando o texto visível não é suficientemente descritivo (ex: ícones, abreviações)."
+            },
+            {
+              "kind": "field",
+              "name": "ariaDescribedby",
+              "type": {
+                "text": "string"
+              },
+              "default": "null",
+              "description": "ID do elemento que fornece descrição adicional da tag.\nReferencia um elemento na página que contém informações complementares sobre a tag.\nA descrição é lida após o conteúdo principal, fornecendo contexto extra aos usuários de leitores de tela.\nExemplo: aria-describedby=\"help-status\" onde existe <div id=\"help-status\">Aguardando aprovação</div>"
+            },
             {
               "kind": "field",
               "name": "selectedClassValue",
@@ -8952,6 +9264,72 @@
                 }
               ]
             },
+            {
+              "kind": "method",
+              "name": "handleCheckedChange",
+              "parameters": [
+                {
+                  "name": "event",
+                  "type": {
+                    "text": "CustomEvent"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "field",
+              "name": "handleKeyDown",
+              "privacy": "private",
+              "description": "Permite navegação por teclado (setas) entre tags do tipo radio (seleção unica).\nFunciona apenas quando 'interactionSelect' é true e 'multiple' é false.\nIgnora tags desabilitadas.",
+              "parameters": [
+                {
+                  "description": "Evento de teclado",
+                  "name": "event"
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "selectNextRadio",
+              "privacy": "private"
+            },
+            {
+              "kind": "method",
+              "name": "selectPreviousRadio",
+              "privacy": "private"
+            },
+            {
+              "kind": "method",
+              "name": "selectRadioByStep",
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "step",
+                  "type": {
+                    "text": "number"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "selectRadioByIndex",
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "radios",
+                  "type": {
+                    "text": "HTMLElement[]"
+                  }
+                },
+                {
+                  "name": "index",
+                  "type": {
+                    "text": "number"
+                  }
+                }
+              ]
+            },
             {
               "kind": "method",
               "name": "getCssClassMap",
@@ -8962,6 +9340,81 @@
                 }
               }
             },
+            {
+              "kind": "method",
+              "name": "getTagAttributes",
+              "privacy": "private"
+            },
+            {
+              "kind": "method",
+              "name": "getAriaDescribedBy",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "string | null"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "hasContent",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "boolean"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "value",
+                  "type": {
+                    "text": "string"
+                  },
+                  "description": "String a ser verificada"
+                }
+              ],
+              "description": "Verifica se uma string possui conteúdo válido (não vazia após remover espaços em branco)."
+            },
+            {
+              "kind": "method",
+              "name": "getAriaLabel",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "string | null"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "getRole",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "string | null"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "getAriaChecked",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "string | null"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "getAriaDisabled",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "string | null"
+                }
+              }
+            },
             {
               "kind": "method",
               "name": "renderIcon",
@@ -8999,16 +9452,32 @@
             },
             {
               "kind": "method",
-              "name": "handleCheckedChange",
+              "name": "renderMainTagContent",
+              "privacy": "private"
+            },
+            {
+              "kind": "method",
+              "name": "renderStatusLayout",
+              "privacy": "private",
               "parameters": [
                 {
-                  "name": "event",
+                  "name": "content",
                   "type": {
-                    "text": "CustomEvent"
+                    "text": "JSX.Element"
                   }
                 }
               ]
             },
+            {
+              "kind": "field",
+              "name": "handleInputChange",
+              "privacy": "private"
+            },
+            {
+              "kind": "method",
+              "name": "renderInteractionSelectTag",
+              "privacy": "private"
+            },
             {
               "kind": "method",
               "name": "render"
@@ -9105,6 +9574,20 @@
               "type": {
                 "text": "boolean"
               }
+            },
+            {
+              "name": "aria-label",
+              "fieldName": "ariaLabel",
+              "type": {
+                "text": "string"
+              }
+            },
+            {
+              "name": "aria-describedby",
+              "fieldName": "ariaDescribedby",
+              "type": {
+                "text": "string"
+              }
             }
           ],
           "tagName": "br-tag",
@@ -9192,6 +9675,14 @@
               },
               "description": "Texto exibido dentro do input quando está vazio, fornecendo uma dica ou sugestão ao usuário."
             },
+            {
+              "kind": "field",
+              "name": "ariaLabel",
+              "type": {
+                "text": "string"
+              },
+              "description": "Texto alternativo para acessibilidade quando não há label visível.\nFornece um rótulo para tecnologias assistivas sem exibir visualmente."
+            },
             {
               "kind": "field",
               "name": "customId",
@@ -9285,6 +9776,28 @@
               ],
               "description": "Define um novo valor para o textarea."
             },
+            {
+              "kind": "method",
+              "name": "getDescribedBy",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "string"
+                }
+              },
+              "description": "Retorna os ids para o atributo aria-describedby do textarea"
+            },
+            {
+              "kind": "method",
+              "name": "getAccessibilityLabel",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "string"
+                }
+              },
+              "description": "Determina o texto a ser usado para acessibilidade quando não há label\nOrdem de prioridade:\n - aria-label do elemento host\n - propriedade ariaLabel do componente\n - placeholder\n - texto padrão (\"Campo de texto\")"
+            },
             {
               "kind": "method",
               "name": "getCssClassMap",
@@ -9322,6 +9835,13 @@
                 "text": "string"
               }
             },
+            {
+              "name": "aria-label",
+              "fieldName": "ariaLabel",
+              "type": {
+                "text": "string"
+              }
+            },
             {
               "name": "custom-id",
               "fieldName": "customId",
@@ -9906,11 +10426,20 @@
           "name": "Upload",
           "slots": [
             {
-              "description": "Descrição do slot",
+              "description": "Texto personalizado para o botão de upload. Se não fornecido, será exibido \"Selecione o arquivo\" como texto padrão. Use este slot para personalizar o texto do botão de acordo com o contexto do upload, por exemplo: \"Anexar documentos\", \"Enviar imagens\", etc.",
               "name": "default"
             }
           ],
           "members": [
+            {
+              "kind": "field",
+              "name": "customId",
+              "type": {
+                "text": "string"
+              },
+              "default": "`br-upload-${uploadId++}`",
+              "description": "Identificador único.\nCaso não seja fornecido, um ID gerado automaticamente será usado."
+            },
             {
               "kind": "field",
               "name": "el",
@@ -9935,7 +10464,7 @@
                 "text": "string"
               },
               "default": "'Envio de arquivo'",
-              "description": "Texto descritivo do campo de upload.\nEste é o texto que é mostrado no label do textarea."
+              "description": "Rótulo principal do campo de upload.\nEste texto ajuda usuários de leitores de tela a identificarem o propósito do upload.\nExemplos: \"Anexar comprovante\", \"Enviar foto do documento\"."
             },
             {
               "kind": "field",
@@ -9968,7 +10497,7 @@
               "kind": "field",
               "name": "state",
               "type": {
-                "text": "string"
+                "text": "'info' | 'warning' | 'danger' | 'success'"
               },
               "description": "Define o estado visual da mensagem.\nOs possíveis valores são:\n- 'info': Mensagem informativa.\n- 'warning': Mensagem de aviso.\n- 'danger': Mensagem de erro ou alerta.\n- 'success': Mensagem de sucesso.\nO valor padrão é 'info'."
             },
@@ -10084,6 +10613,13 @@
             }
           ],
           "attributes": [
+            {
+              "name": "custom-id",
+              "fieldName": "customId",
+              "type": {
+                "text": "string"
+              }
+            },
             {
               "name": "accept",
               "fieldName": "accept",
@@ -10109,7 +10645,7 @@
               "name": "state",
               "fieldName": "state",
               "type": {
-                "text": "string"
+                "text": "'info' | 'warning' | 'danger' | 'success'"
               }
             },
             {
@@ -10234,6 +10770,12 @@
       "declarations": [],
       "exports": []
     },
+    {
+      "kind": "javascript-module",
+      "path": "components/_tests/sign-in.spec.js",
+      "declarations": [],
+      "exports": []
+    },
     {
       "kind": "javascript-module",
       "path": "components/tests/step.spec.js",