@govbr-ds/webcomponents 2.2.0 → 2.3.0

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

@@ -95,7 +95,8 @@ export declare class Button {
      */
     shape?: ButtonShape;
     /**
-     * Define o tipo de botão, especificando seu comportamento padrão. Valores inválidos usam `button`.
+     * Define o tipo de botão, especificando seu comportamento padrão.
+     * Quando omitido, usa `button`; valores inválidos também usam `button` e geram aviso no console.
      */
     type?: ButtonType;
     /**

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

@@ -32,6 +32,8 @@ import type { CollapseChangeDetail, CollapseColorMode, CollapseExpansionDirectio
  * @see br-list
  * @slot default - Slot para o conteúdo expansível exibido ao abrir o collapse.
  * @slot trigger - Slot para personalizar o acionador (texto, ícones, imagens, etc.).
+ * @slot icon-to-show - Ícone exibido quando o conteúdo está oculto (ex.: `<i slot="icon-to-show" class="fas fa-plus"></i>`). Forma preferida para ícones por classe CSS; tem precedência sobre a prop `iconToShow`.
+ * @slot icon-to-hide - Ícone exibido quando o conteúdo está visível. Forma preferida para ícones por classe CSS; tem precedência sobre a prop `iconToHide`.
  *
  * @part details - Elemento details nativo do collapse.
  * @part trigger - Acionador (summary) do collapse.
@@ -67,11 +69,13 @@ export declare class Collapse {
      */
     accordionGroup?: string;
     /**
-     * Identificador do ícone exibido quando o conteúdo está oculto. O valor padrão usa o registro SVG local.
+     * Identificador Iconify do ícone exibido quando o conteúdo está oculto. O valor padrão usa o registro SVG local.
+     * Para ícones por classe CSS, use o slot `icon-to-show`.
      */
     iconToShow: string;
     /**
-     * Identificador do ícone exibido quando o conteúdo está visível. O valor padrão usa o registro SVG local.
+     * Identificador Iconify do ícone exibido quando o conteúdo está visível. O valor padrão usa o registro SVG local.
+     * Para ícones por classe CSS, use o slot `icon-to-hide`.
      */
     iconToHide: string;
     /**

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

@@ -207,6 +207,13 @@ export declare class Dropdown {
      * Foca em um elemento específico com suporte a componentes personalizados
      * @param targetElement Elemento a receber o foco
      */
+    /**
+     * Links e demais itens focáveis do target na ordem do documento. O Tab percorre
+     * esta sequência única para que listas mistas (links e botões) sejam alcançáveis.
+     */
+    private getTabCycle;
+    /** Move o foco para o próximo (ou anterior, com Shift) elemento do ciclo de Tab. */
+    private cycleTabFocus;
     private focusOnElement;
     /**
      * Foca no elemento interativo dentro do slot trigger
@@ -221,12 +228,13 @@ export declare class Dropdown {
     private syncTriggerAccessibilityAfterHydration;
     private getCssClassMap;
     /**
-     * Handler para eventos de keydown nos itens não-link
-     * Implementa navegação completa por setas, Tab não navega entre estes itens
+     * Handler para eventos de keydown nos itens não-link.
+     * Setas, Home e End navegam entre estes itens; Tab percorre o ciclo único
+     * (links e itens na ordem do documento).
      */
     private handleItemKeydown;
     /**
-     * Handler específico para links
+     * Handler específico para links. Tab percorre o ciclo único (links e itens).
      */
     private handleLinkKeydown;
     /**
@@ -235,7 +243,7 @@ export declare class Dropdown {
     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
+     * separando links e demais itens (setas navegam entre itens; Tab percorre ambos na ordem do documento)
      */
     private initializeDropdownItems;
     /**

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

@@ -235,6 +235,8 @@ export declare class Header {
     /** Indica que o estado compacto atual foi derivado da rolagem. */
     private compactFromScroll;
     private headerResizeObserver?;
+    /** Última largura do host vista pelo `ResizeObserver`. */
+    private observedHostWidth?;
     private readonly headerResizeBatcher;
     private emitHeaderWidthChange;
     private handleNavigation;

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

@@ -1 +1,7 @@
 export declare function sanitizeSvgMarkup(markup: string): string;
+/**
+ * Indica se um valor de ícone é uma lista de classes CSS (ex.: `fas fa-bell`), e não um
+ * identificador Iconify (`fa6-solid:bell`). Classes CSS não funcionam dentro do Shadow DOM,
+ * porque os estilos globais do Font Awesome não o atravessam; nesses casos use um slot.
+ */
+export declare function isIconClassList(value: string | null | undefined): boolean;

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

@@ -362,6 +362,15 @@ export declare class Input {
     private readonly handleSlotChange;
     private syncFormState;
     private nativeValueUpdate;
+    /**
+     * Reproduz a submissão implícita do `<input>` nativo: o campo interno fica no
+     * Shadow DOM e não pertence ao `<form>` do documento. Segue o botão padrão do
+     * formulário (o primeiro com `type="submit"`, inclusive `br-button`): se ele
+     * estiver desabilitado, não há envio. A submissão ocorre depois do despacho da
+     * tecla, para respeitar `preventDefault()` do consumidor e não ativar o elemento
+     * que receber o foco durante o envio.
+     */
+    private handleKeyDown;
     private readonly renderInput;
     /**
      * Renderiza o texto de ajuda do input, considerando se está definido como string ou slot.

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

@@ -121,7 +121,12 @@ export declare class Item {
      * @deprecated Use `button`.
      */
     isButton: boolean;
-    /** Renderiza o item como botão. Quando informado, tem precedência sobre `isButton`. */
+    /**
+     * Renderiza o item como botão de alternância: o acionamento alterna `selected`, emite
+     * `brItemSelect` e expõe o estado em `aria-pressed`. Para uma ação sem estado (ex.: "Sair"),
+     * use `href` com `navigation-mode="event"` ou um `br-button`.
+     * Quando informado, tem precedência sobre `isButton`.
+     */
     button?: boolean;
     /**
      * Tipo do botão, aplicável apenas se `isButton` for `true`. Pode ser:

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

@@ -56,9 +56,11 @@ export declare class MagicButton {
      */
     label: string;
     /**
-     * Identificador legado do ícone a ser exibido.
-     * Nomes simples (por exemplo, `question`) são resolvidos pelo registro SVG local.
-     * Para classes CSS ou SVGs personalizados, prefira o slot `icon`.
+     * Ícone como identificador Iconify (ex.: `fa6-solid:star`) ou nome simples (ex.: `question`,
+     * resolvido como `fa6-solid:question` no registro SVG local), renderizado pelo `br-icon`.
+     * Para classes CSS (ex.: Font Awesome) ou SVGs personalizados, use o slot `icon`, a forma preferida.
+     * Uso descontinuado: classes CSS nesta prop (ex.: `fas fa-star`) não são exibidas no Shadow DOM
+     * e geram aviso.
      */
     icon: string;
     /**
@@ -102,6 +104,8 @@ export declare class MagicButton {
      * registro local Font Awesome 6; valores já qualificados continuam intactos.
      */
     private getIconName;
+    /** Fallback do slot `icon`: somente identificadores Iconify; classes CSS geram aviso. */
+    private renderIconFallback;
     /**
      * Renderiza o componente.
      */

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

@@ -86,6 +86,12 @@ export declare class Modal {
      */
     alignFooter: ModalFooterAlign;
     handleShowChange(newValue: boolean, oldValue: boolean): void;
+    /**
+     * Devolve o foco ao elemento que abriu o modal. Sem esse alvo (ex.: modal aberto por
+     * `show` inicial ou foco anterior no body), libera o foco que ainda estiver no conteúdo
+     * sendo ocultado, para que a digitação não continue num campo invisível.
+     */
+    private returnFocusOnClose;
     /**
      * Evento emitido quando o modal é aberto (quando `show` muda de `false` para `true`).
      */

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

@@ -42,10 +42,12 @@ import type { PaginationColorMode, PaginationDensity, PaginationPageChangeDetail
  * @part per-page - Parte para o seletor de itens por página na variante contextual.
  * @part per-page-container - Contêiner encaminhado do seletor de itens por página.
  * @part per-page-input - Campo encaminhado do seletor de itens por página.
+ * @part per-page-input-label - Rótulo encaminhado do seletor de itens por página.
  * @part per-page-list - Lista encaminhada do seletor de itens por página.
  * @part go-to - Parte para o seletor de navegação direta na variante contextual.
  * @part go-to-container - Contêiner encaminhado do seletor de navegação direta.
  * @part go-to-input - Campo encaminhado do seletor de navegação direta.
+ * @part go-to-input-label - Rótulo encaminhado do seletor de navegação direta.
  * @part go-to-list - Lista encaminhada do seletor de navegação direta.
  * @part prev-button - Parte para o botão de página anterior, usada para estilização via ::part().
  * @part prev-button-inner - Botão interno encaminhado da página anterior.

package/dist/types/components/sign-in/sign-in.d.ts

@@ -22,7 +22,7 @@ import type { SignInEmphasis, SignInShape } from './sign-in.types';
  *
  * O `br-sign-in` é um botão de autenticação estilizado com a marca oficial do Governo Federal, recebendo propriedades de rótulo e variantes institucionais.
  *
- * Para a documentação completa de design, incluindo diretrizes de acessibilidade e especificações visuais, consulte o [Design System do GovBR](https://www.gov.br/ds/components/sign-in?tab=designer).
+ * Para a documentação completa de design, incluindo diretrizes de acessibilidade e especificações visuais, consulte o [Design System do GovBR](https://www.gov.br/ds/components/signin?tab=designer).
  *
 
  * @category Identidade, Ações, Formulários
@@ -49,7 +49,8 @@ export declare class SignIn {
      */
     customId: string;
     /**
-     * Define se o sign-in usará um esquema de cores escuro.
+     * Define se o sign-in usará um esquema de cores escuro, para fundos escuros.
+     * Quando omitido, ou com valor diferente de `dark`, usa o esquema claro.
      */
     colorMode: 'dark';
     /**

package/dist/types/components/tab/tab-item/tab-item.d.ts

@@ -40,8 +40,12 @@ export declare class TabItem {
     /** Texto canônico do item. Quando informado, tem precedência sobre `tabItemTitle`. */
     label?: string;
     /**
-     * Define o ícone do item de tab usando classes CSS do Font Awesome 5, como `fas fa-bell`.
-     * O formato Iconify é aceito apenas para compatibilidade legada e não deve ser usado em novos códigos.
+     * Ícone da aba como identificador Iconify (ex.: `fa6-solid:bell`), renderizado em SVG pelo `br-icon`.
+     * Para ícones por classe CSS (ex.: Font Awesome), use o slot `icon-{id}` do `br-tab`, a forma
+     * preferida: `<i slot="icon-avisos" class="fas fa-bell" aria-hidden="true"></i>`.
+     * O slot tem precedência sobre esta prop.
+     * Uso descontinuado: classes CSS nesta prop (ex.: `fas fa-bell`) não são exibidas no Shadow DOM,
+     * geram aviso e devem migrar para o slot `icon-{id}`. Identificadores Iconify continuam suportados.
      */
     icon: string;
     /**

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

@@ -37,6 +37,7 @@ import type { TabAlignItems, TabColorMode, TabDensity } from './tab.types';
  * @category Navegação, Seleção, Conteúdo
  * @status stable
  * @slot default - Slot para inserir os itens das abas (br-tab-item)
+ * @slot icon-{id} - Ícone da aba cujo `br-tab-item` tem o `id` informado (ex.: `<i slot="icon-avisos" class="fas fa-bell" aria-hidden="true"></i>`). Forma preferida para ícones por classe CSS, como Font Awesome: o elemento fica em light DOM e recebe os estilos globais da página. Tem precedência sobre a prop `icon` do item.
  *
  * @part container - Contêiner principal que envolve toda a estrutura do componente (navegação e conteúdo). Expõe o elemento para customizações de fundo, bordas e espaçamentos globais.
  * @part nav - Área de navegação (`tablist`) onde os botões das abas estão localizados. Permite customizar o alinhamento, espaçamento e plano de fundo da barra de abas.
@@ -192,7 +193,13 @@ export declare class Tab {
      * Retorna o mapeamento de classes CSS para cada item de navegação
      */
     private getTabItemCssClassMap;
+    private hasSlottedIcon;
+    /**
+     * Ícone da aba: o slot `icon-{id}` tem precedência; a prop `icon` do item é o fallback e
+     * aceita identificadores Iconify. Classes CSS na prop não funcionam no Shadow DOM e são ignoradas.
+     */
     private renderTabIcon;
+    private handleIconSlotChange;
     /**
      * Retorna o alinhamento em formato flexbox
      */

package/dist/types/components.d.ts

@@ -384,7 +384,7 @@ export namespace Components {
          */
         "shape"?: ButtonShape;
         /**
-          * Define o tipo de botão, especificando seu comportamento padrão. Valores inválidos usam `button`.
+          * Define o tipo de botão, especificando seu comportamento padrão. Quando omitido, usa `button`; valores inválidos também usam `button` e geram aviso no console.
          */
         "type"?: ButtonType;
         /**
@@ -901,12 +901,12 @@ export namespace Components {
          */
         "iconPosition": CollapseIconPosition;
         /**
-          * Identificador do ícone exibido quando o conteúdo está visível. O valor padrão usa o registro SVG local.
+          * Identificador Iconify do ícone exibido quando o conteúdo está visível. O valor padrão usa o registro SVG local. Para ícones por classe CSS, use o slot `icon-to-hide`.
           * @default 'fa6-solid:chevron-up'
          */
         "iconToHide": string;
         /**
-          * Identificador do ícone exibido quando o conteúdo está oculto. O valor padrão usa o registro SVG local.
+          * Identificador Iconify do ícone exibido quando o conteúdo está oculto. O valor padrão usa o registro SVG local. Para ícones por classe CSS, use o slot `icon-to-show`.
           * @default 'fa6-solid:chevron-down'
          */
         "iconToShow": string;
@@ -2745,7 +2745,7 @@ export namespace Components {
          */
         "active"?: boolean;
         /**
-          * Renderiza o item como botão. Quando informado, tem precedência sobre `isButton`.
+          * Renderiza o item como botão de alternância: o acionamento alterna `selected`, emite `brItemSelect` e expõe o estado em `aria-pressed`. Para uma ação sem estado (ex.: "Sair"), use `href` com `navigation-mode="event"` ou um `br-button`. Quando informado, tem precedência sobre `isButton`.
          */
         "button"?: boolean;
         /**
@@ -3197,7 +3197,7 @@ export namespace Components {
          */
         "density": BrDensity;
         /**
-          * Identificador legado do ícone a ser exibido. Nomes simples (por exemplo, `question`) são resolvidos pelo registro SVG local. Para classes CSS ou SVGs personalizados, prefira o slot `icon`.
+          * Ícone como identificador Iconify (ex.: `fa6-solid:star`) ou nome simples (ex.: `question`, resolvido como `fa6-solid:question` no registro SVG local), renderizado pelo `br-icon`. Para classes CSS (ex.: Font Awesome) ou SVGs personalizados, use o slot `icon`, a forma preferida. Uso descontinuado: classes CSS nesta prop (ex.: `fas fa-star`) não são exibidas no Shadow DOM e geram aviso.
           * @default ''
          */
         "icon": string;
@@ -5060,7 +5060,7 @@ export namespace Components {
      *   - O usuário já estiver autenticado e a intenção for apenas exibir o perfil (prefira `br-avatar`).
      * ### Estrutura e Slots
      * O `br-sign-in` é um botão de autenticação estilizado com a marca oficial do Governo Federal, recebendo propriedades de rótulo e variantes institucionais.
-     * Para a documentação completa de design, incluindo diretrizes de acessibilidade e especificações visuais, consulte o [Design System do GovBR](https://www.gov.br/ds/components/sign-in?tab=designer).
+     * Para a documentação completa de design, incluindo diretrizes de acessibilidade e especificações visuais, consulte o [Design System do GovBR](https://www.gov.br/ds/components/signin?tab=designer).
      * @category Identidade, Ações, Formulários
      * @status stable
      */
@@ -5070,7 +5070,7 @@ export namespace Components {
          */
         "ariaLabel": string;
         /**
-          * Define se o sign-in usará um esquema de cores escuro.
+          * Define se o sign-in usará um esquema de cores escuro, para fundos escuros. Quando omitido, ou com valor diferente de `dark`, usa o esquema claro.
          */
         "colorMode": 'dark';
         /**
@@ -5830,7 +5830,7 @@ export namespace Components {
          */
         "counter": string;
         /**
-          * Define o ícone do item de tab usando classes CSS do Font Awesome 5, como `fas fa-bell`. O formato Iconify é aceito apenas para compatibilidade legada e não deve ser usado em novos códigos.
+          * Ícone da aba como identificador Iconify (ex.: `fa6-solid:bell`), renderizado em SVG pelo `br-icon`. Para ícones por classe CSS (ex.: Font Awesome), use o slot `icon-{id}` do `br-tab`, a forma preferida: `<i slot="icon-avisos" class="fas fa-bell" aria-hidden="true"></i>`. O slot tem precedência sobre esta prop. Uso descontinuado: classes CSS nesta prop (ex.: `fas fa-bell`) não são exibidas no Shadow DOM, geram aviso e devem migrar para o slot `icon-{id}`. Identificadores Iconify continuam suportados.
          */
         "icon": string;
         /**
@@ -9191,7 +9191,7 @@ declare global {
      *   - O usuário já estiver autenticado e a intenção for apenas exibir o perfil (prefira `br-avatar`).
      * ### Estrutura e Slots
      * O `br-sign-in` é um botão de autenticação estilizado com a marca oficial do Governo Federal, recebendo propriedades de rótulo e variantes institucionais.
-     * Para a documentação completa de design, incluindo diretrizes de acessibilidade e especificações visuais, consulte o [Design System do GovBR](https://www.gov.br/ds/components/sign-in?tab=designer).
+     * Para a documentação completa de design, incluindo diretrizes de acessibilidade e especificações visuais, consulte o [Design System do GovBR](https://www.gov.br/ds/components/signin?tab=designer).
      * @category Identidade, Ações, Formulários
      * @status stable
      */
@@ -10318,7 +10318,7 @@ declare namespace LocalJSX {
          */
         "shape"?: ButtonShape;
         /**
-          * Define o tipo de botão, especificando seu comportamento padrão. Valores inválidos usam `button`.
+          * Define o tipo de botão, especificando seu comportamento padrão. Quando omitido, usa `button`; valores inválidos também usam `button` e geram aviso no console.
          */
         "type"?: ButtonType;
         /**
@@ -10799,12 +10799,12 @@ declare namespace LocalJSX {
          */
         "iconPosition"?: CollapseIconPosition;
         /**
-          * Identificador do ícone exibido quando o conteúdo está visível. O valor padrão usa o registro SVG local.
+          * Identificador Iconify do ícone exibido quando o conteúdo está visível. O valor padrão usa o registro SVG local. Para ícones por classe CSS, use o slot `icon-to-hide`.
           * @default 'fa6-solid:chevron-up'
          */
         "iconToHide"?: string;
         /**
-          * Identificador do ícone exibido quando o conteúdo está oculto. O valor padrão usa o registro SVG local.
+          * Identificador Iconify do ícone exibido quando o conteúdo está oculto. O valor padrão usa o registro SVG local. Para ícones por classe CSS, use o slot `icon-to-show`.
           * @default 'fa6-solid:chevron-down'
          */
         "iconToShow"?: string;
@@ -12646,7 +12646,7 @@ declare namespace LocalJSX {
          */
         "active"?: boolean;
         /**
-          * Renderiza o item como botão. Quando informado, tem precedência sobre `isButton`.
+          * Renderiza o item como botão de alternância: o acionamento alterna `selected`, emite `brItemSelect` e expõe o estado em `aria-pressed`. Para uma ação sem estado (ex.: "Sair"), use `href` com `navigation-mode="event"` ou um `br-button`. Quando informado, tem precedência sobre `isButton`.
          */
         "button"?: boolean;
         /**
@@ -13125,7 +13125,7 @@ declare namespace LocalJSX {
          */
         "density"?: BrDensity;
         /**
-          * Identificador legado do ícone a ser exibido. Nomes simples (por exemplo, `question`) são resolvidos pelo registro SVG local. Para classes CSS ou SVGs personalizados, prefira o slot `icon`.
+          * Ícone como identificador Iconify (ex.: `fa6-solid:star`) ou nome simples (ex.: `question`, resolvido como `fa6-solid:question` no registro SVG local), renderizado pelo `br-icon`. Para classes CSS (ex.: Font Awesome) ou SVGs personalizados, use o slot `icon`, a forma preferida. Uso descontinuado: classes CSS nesta prop (ex.: `fas fa-star`) não são exibidas no Shadow DOM e geram aviso.
           * @default ''
          */
         "icon"?: string;
@@ -14927,7 +14927,7 @@ declare namespace LocalJSX {
      *   - O usuário já estiver autenticado e a intenção for apenas exibir o perfil (prefira `br-avatar`).
      * ### Estrutura e Slots
      * O `br-sign-in` é um botão de autenticação estilizado com a marca oficial do Governo Federal, recebendo propriedades de rótulo e variantes institucionais.
-     * Para a documentação completa de design, incluindo diretrizes de acessibilidade e especificações visuais, consulte o [Design System do GovBR](https://www.gov.br/ds/components/sign-in?tab=designer).
+     * Para a documentação completa de design, incluindo diretrizes de acessibilidade e especificações visuais, consulte o [Design System do GovBR](https://www.gov.br/ds/components/signin?tab=designer).
      * @category Identidade, Ações, Formulários
      * @status stable
      */
@@ -14937,7 +14937,7 @@ declare namespace LocalJSX {
          */
         "ariaLabel"?: string;
         /**
-          * Define se o sign-in usará um esquema de cores escuro.
+          * Define se o sign-in usará um esquema de cores escuro, para fundos escuros. Quando omitido, ou com valor diferente de `dark`, usa o esquema claro.
          */
         "colorMode"?: 'dark';
         /**
@@ -15631,7 +15631,7 @@ declare namespace LocalJSX {
          */
         "counter"?: string;
         /**
-          * Define o ícone do item de tab usando classes CSS do Font Awesome 5, como `fas fa-bell`. O formato Iconify é aceito apenas para compatibilidade legada e não deve ser usado em novos códigos.
+          * Ícone da aba como identificador Iconify (ex.: `fa6-solid:bell`), renderizado em SVG pelo `br-icon`. Para ícones por classe CSS (ex.: Font Awesome), use o slot `icon-{id}` do `br-tab`, a forma preferida: `<i slot="icon-avisos" class="fas fa-bell" aria-hidden="true"></i>`. O slot tem precedência sobre esta prop. Uso descontinuado: classes CSS nesta prop (ex.: `fas fa-bell`) não são exibidas no Shadow DOM, geram aviso e devem migrar para o slot `icon-{id}`. Identificadores Iconify continuam suportados.
          */
         "icon"?: string;
         /**
@@ -18875,7 +18875,7 @@ declare module "@stencil/core" {
              *   - O usuário já estiver autenticado e a intenção for apenas exibir o perfil (prefira `br-avatar`).
              * ### Estrutura e Slots
              * O `br-sign-in` é um botão de autenticação estilizado com a marca oficial do Governo Federal, recebendo propriedades de rótulo e variantes institucionais.
-             * Para a documentação completa de design, incluindo diretrizes de acessibilidade e especificações visuais, consulte o [Design System do GovBR](https://www.gov.br/ds/components/sign-in?tab=designer).
+             * Para a documentação completa de design, incluindo diretrizes de acessibilidade e especificações visuais, consulte o [Design System do GovBR](https://www.gov.br/ds/components/signin?tab=designer).
              * @category Identidade, Ações, Formulários
              * @status stable
              */

package/dist/types/shared/utils/form.d.ts

@@ -54,3 +54,11 @@ export declare const setFormValidity: (internals: ElementInternals | undefined,
 export declare const isFormControlDisabled: (disabled: boolean, formDisabled: boolean) => boolean;
 export declare const getCheckableFormValue: (checked: boolean, value?: string, fallback?: string) => string | null;
 export declare const getCheckableRestoreState: (checked: boolean) => "checked" | "unchecked";
+/**
+ * Submissão implícita (Enter em campo de texto) conforme a especificação HTML,
+ * para controles cujo campo nativo fica no Shadow DOM e não pertence ao `<form>`.
+ * O botão padrão é o primeiro elemento do formulário com `type="submit"`
+ * (nativo ou `br-button`); se estiver desabilitado, não há envio. Botões nativos
+ * são acionados para preservar o `submitter`; nos demais casos usa `requestSubmit()`.
+ */
+export declare function submitImplicitly(form: HTMLFormElement): void;