@govbr-ds/webcomponents 2.0.0-next.13 → 2.0.0-next.15

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

@@ -9,7 +9,7 @@ export declare class Checkbox {
      * Referência ao elemento host do componente.
      * Utilize esta propriedade para acessar e manipular o elemento do DOM associado ao componente.
      */
-    el: HTMLElement;
+    el: HTMLBrCheckboxElement;
     elementInternals: ElementInternals;
     /**
      * Define o estado intermediário do checkbox.
@@ -161,7 +161,7 @@ export declare class Checkbox {
      * Disparado depois que o valor do `checked` foi alterado
      */
     brDidCheckedChange: EventEmitter<boolean>;
-    private handleCheckedChange;
+    private readonly handleCheckedChange;
     /**
      * Inverte o valor da prop `checked`
      */

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

@@ -0,0 +1,154 @@
+import { EventEmitter } from '../../stencil-public-runtime';
+/**
+ * Para uma descrição detalhada, consulte a [documentação do GovBR-DS](https://www.gov.br/ds/components/dropdown?tab=designer).
+ *
+ * @slot trigger - Slot que recebe o elemento acionador
+ * @slot target - Slot que recebe o elemento alvo
+ */
+export declare class Dropdown {
+    /**
+     * Referência ao elemento host do componente.
+     * Utilize esta propriedade para acessar e manipular o elemento do DOM associado ao componente.
+     */
+    el: HTMLBrDropdownElement;
+    elementInternals: ElementInternals;
+    /**
+     * Indica se o dropdown está aberto ou fechado.
+     * Esta propriedade é refletida no DOM e pode ser alterada externamente.
+     * O valor padrão é falso (fechado).
+     */
+    isOpen: boolean;
+    /**
+     * Método chamado sempre que a propriedade `isOpen` muda.
+     * Emite um evento com o novo estado do dropdown.
+     */
+    isOpenChanged(): void;
+    /**
+     * Emite um evento quando o componente é conectado ao DOM.
+     * Consulte a documentação do [Stencil](https://stenciljs.com/docs/component-lifecycle#connectedcallback) para mais detalhes.
+     */
+    brDidConnect: EventEmitter<void>;
+    connectedCallback(): void;
+    /**
+     * Emite um evento antes que o componente seja carregado pela primeira vez.
+     * Utilize este evento para realizar tarefas de inicialização antes do componente ser exibido.
+     * Consulte a documentação do [Stencil](https://stenciljs.com/docs/component-lifecycle#componentwillload) para mais detalhes.
+     */
+    brWillLoad: EventEmitter<void>;
+    componentWillLoad(): void;
+    /**
+     * Emite um evento após o componente ter sido carregado pela primeira vez.
+     * Utilize este evento para realizar ações que devem ocorrer depois que o componente foi totalmente carregado.
+     * Consulte a documentação do [Stencil](https://stenciljs.com/docs/component-lifecycle#componentdidload) para mais detalhes.
+     */
+    brDidLoad: EventEmitter<void>;
+    componentDidLoad(): void;
+    /**
+     * Emite um evento antes do componente ser renderizado.
+     * Utilize este evento para preparar o componente antes de sua renderização.
+     * Consulte a documentação do [Stencil](https://stenciljs.com/docs/component-lifecycle#componentwillrender) para mais detalhes.
+     */
+    brWillRender: EventEmitter<void>;
+    componentWillRender(): void;
+    /**
+     * Emite um evento após o componente ter sido renderizado.
+     * Utilize este evento para executar ações que devem ocorrer após a renderização do componente.
+     * Consulte a documentação do [Stencil](https://stenciljs.com/docs/component-lifecycle#componentdidrender) para mais detalhes.
+     */
+    brDidRender: EventEmitter<void>;
+    componentDidRender(): void;
+    /**
+     * Emite um evento para indicar se o componente deve ser atualizado ou não.
+     * Este evento é chamado antes de qualquer atualização do componente para decidir se a atualização deve prosseguir.
+     * Consulte a documentação do [Stencil](https://stenciljs.com/docs/component-lifecycle#componentshouldupdate) para mais detalhes.
+     */
+    brShouldUpdate: EventEmitter<void>;
+    componentShouldUpdate(): void;
+    /**
+     * Emite um evento antes de o componente ser atualizado.
+     * Utilize este evento para realizar ações preparatórias antes da atualização do componente.
+     * Consulte a documentação do [Stencil](https://stenciljs.com/docs/component-lifecycle#componentwillupdate) para mais detalhes.
+     */
+    brWillUpdate: EventEmitter<void>;
+    componentWillUpdate(): void;
+    /**
+     * Emite um evento após o componente ter sido atualizado.
+     * Utilize este evento para realizar ações após a atualização do componente.
+     * Consulte a documentação do [Stencil](https://stenciljs.com/docs/component-lifecycle#componentdidupdate) para mais detalhes.
+     */
+    brDidUpdate: EventEmitter<void>;
+    componentDidUpdate(): void;
+    /**
+     * Emite um evento quando o componente é desconectado do DOM.
+     * Utilize este evento para realizar a limpeza ou outras ações necessárias quando o componente é removido.
+     * Consulte a documentação do [Stencil](https://stenciljs.com/docs/component-lifecycle#disconnectedcallback) para mais detalhes.
+     */
+    brDidDisconnect: EventEmitter<void>;
+    disconnectedCallback(): void;
+    /**
+     * Emite um evento quando o componente é associado ou removido de um `<form>`.
+     * Consulte a documentação do [Stencil](https://stenciljs.com/docs/form-associated#formassociatedcallback) para mais detalhes.
+     *
+     * @param form - Dados do formulário associado.
+     */
+    brFormAssociatedCallback: EventEmitter<FormData>;
+    formAssociatedCallback(form: FormData): void;
+    /**
+     * Emite um evento quando o estado `disabled` do componente muda dentro de um `<form>`.
+     * Consulte a documentação do [Stencil](https://stenciljs.com/docs/form-associated#formdisabledcallback) para mais informações.
+     *
+     * @param disabled - Novo estado `disabled` do componente dentro do formulário.
+     */
+    brFormDisabledCallback: EventEmitter<boolean>;
+    formDisabledCallback(disabled: boolean): void;
+    /**
+     * Emite um evento quando um `<form>` é resetado.
+     * Consulte a documentação do [Stencil](https://stenciljs.com/docs/form-associated#formresetcallback) para mais detalhes.
+     */
+    brFormResetCallback: EventEmitter<void>;
+    formResetCallback(): void;
+    /**
+     * Emite um evento quando o navegador preenche automaticamente os campos de um `<form>`.
+     * Consulte a documentação do [Stencil](https://stenciljs.com/docs/form-associated#formstaterestorecallback) para mais informações.
+     *
+     * @param state - Estado restaurado do formulário.
+     * @param _mode - Modo de preenchimento automático do navegador.
+     */
+    brFormStateRestoreCallback: EventEmitter<[state: string, _mode: string]>;
+    formStateRestoreCallback(state: string, _mode: string): void;
+    /**
+     * Evento emitido quando o estado do dropdown muda.
+     */
+    brDropdownChange: EventEmitter<{
+        'is-opened': boolean;
+    }>;
+    private getCssClassMap;
+    /**
+     * Alterna o estado do dropdown entre aberto e fechado.
+     */
+    private readonly toggle;
+    /**
+     * Método que lida com cliques fora do dropdown.
+     *
+     * @param {MouseEvent} event - O evento de clique que ocorreu.
+     */
+    private onClickOutside;
+    /**
+     * Abre o dropdown.
+     * Define a propriedade `isOpen` como verdadeira e retorna o novo estado.
+     * Este método é marcado com @Method() para que possa ser chamado externamente.
+     */
+    open(): Promise<{
+        isOpen: boolean;
+    }>;
+    /**
+     * Esconde o dropdown.
+     * Define a propriedade `isOpen` como falsa e retorna o novo estado.
+     * Este método é marcado com @Method() para que possa ser chamado externamente.
+     */
+    hide(): Promise<{
+        isOpen: boolean;
+    }>;
+    private inheritedAttributes;
+    render(): any;
+}

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

@@ -16,7 +16,7 @@ export declare class Icon {
      * Referência ao elemento host do componente.
      * Utilize esta propriedade para acessar e manipular o elemento do DOM associado ao componente.
      */
-    el: HTMLElement;
+    el: HTMLBrIconElement;
     /**
      * 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.
@@ -36,7 +36,7 @@ export declare class Icon {
      * Permite adicionar classes CSS adicionais ao ícone.
      * Use esta propriedade para aplicar estilos personalizados ao ícone, além dos estilos padrão.
      */
-    class?: string;
+    CssClasses?: string;
     /**
      * 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.

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

@@ -12,7 +12,7 @@ export declare class Input {
      * Referência ao elemento host do componente.
      * Utilize esta propriedade para acessar e manipular o elemento do DOM associado ao componente.
      */
-    el: HTMLElement;
+    el: HTMLBrInputElement;
     elementInternals: ElementInternals;
     /**
      * Identificador único do campo de entrada.
@@ -37,10 +37,6 @@ export declare class Input {
      * Controla o comportamento de preenchimento automático do navegador para o input.
      */
     autocomplete: 'on' | 'off';
-    /**
-     * Se definido como verdadeiro, o input receberá foco automaticamente ao ser renderizado.
-     */
-    autofocus: boolean;
     /**
      * Ajusta a densidade, alterando o espaçamento interno para um visual mais compacto ou mais expandido.
      */
@@ -204,14 +200,14 @@ export declare class Input {
      * Valor atualizado do input
      */
     valueChange: EventEmitter<string>;
-    private handleInput;
-    renderLabel: () => any;
-    togglePasswordVisibility: () => void;
+    private readonly handleInput;
+    private readonly renderLabel;
+    private readonly togglePasswordVisibility;
     private hasSlotContent;
-    renderInput: () => any;
-    renderHelpText: () => any;
-    renderIconPassword: () => any;
-    renderIconSlot(): any;
-    renderButton(): any;
+    private readonly renderInput;
+    private readonly renderHelpText;
+    private readonly renderIconPassword;
+    private renderIconSlot;
+    private renderButton;
     render(): any;
 }

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

@@ -13,7 +13,7 @@ export declare class Item {
      * Referência ao elemento host do componente.
      * Utilize esta propriedade para acessar e manipular o elemento do DOM associado ao componente.
      */
-    el: HTMLElement;
+    el: HTMLBrItemElement;
     elementInternals: ElementInternals;
     /**
      * Desativa o item, tornando-o não interativo.
@@ -176,12 +176,12 @@ export declare class Item {
     private hasSlotContentDefault;
     private hasSlotContent;
     private getCssClassMap;
-    private inheritedAttributes;
+    private readonly inheritedAttributes;
     private getTagType;
     private getAttributes;
-    updateItemSelectionState(): void;
+    private updateItemSelectionState;
     private isClickInsideInteractiveElement;
     private updateCheckboxes;
-    private handleClick;
+    private readonly handleClick;
     render(): any;
 }

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

@@ -1,28 +1,28 @@
 import { EventEmitter } from '../../stencil-public-runtime';
 /**
-* Para uma descrição detalhada, consulte a [documentação do GovBR-DS](https://www.gov.br/ds/components/list?tab=designer).
-*
-* @slot default - Slot padrão para inclusão dos itens da lista.
-* @slot header - Slot nomeado para inclusão de ações relacionadas ao cabeçalho do list (uso de botões por exemplo).
-*/
+ * Para uma descrição detalhada, consulte a [documentação do GovBR-DS](https://www.gov.br/ds/components/list?tab=designer).
+ *
+ * @slot default - Slot padrão para inclusão dos itens da lista.
+ * @slot header - Slot nomeado para inclusão de ações relacionadas ao cabeçalho do list (uso de botões por exemplo).
+ */
 export declare class List {
     /**
-    * Referência ao elemento host do componente.
-    * Utilize esta propriedade para acessar e manipular o elemento do DOM associado ao componente.
-    */
-    el: HTMLElement;
+     * Referência ao elemento host do componente.
+     * Utilize esta propriedade para acessar e manipular o elemento do DOM associado ao componente.
+     */
+    el: HTMLBrListElement;
     elementInternals: ElementInternals;
     /**
-    * Define o título para a lista.
-    */
+     * Define o título para a lista.
+     */
     listTitle: string;
     /**
-    * Indica se a lista será horizontal. Por padrão, a lista é vertical.
-    */
+     * Indica se a lista será horizontal. Por padrão, a lista é vertical.
+     */
     isHorizontal: boolean;
     /**
-    * Indica que o divider para o título da lista estará oculto.
-    */
+     * Indica que o divider para o título da lista estará oculto.
+     */
     hideHeaderDivider: boolean;
     /**
      * Emite um evento quando o componente é conectado ao DOM.
@@ -120,7 +120,7 @@ export declare class List {
     private getCssClassMap;
     private inheritedAttributes;
     private hasSlotContent;
-    renderHeader: () => any;
-    renderDivider(): any;
+    private readonly renderHeader;
+    private renderDivider;
     render(): any;
 }

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

@@ -7,7 +7,7 @@ export declare class Loading {
      * Referência ao elemento host do componente.
      * Utilize esta propriedade para acessar e manipular o elemento do DOM associado ao componente.
      */
-    el: HTMLElement;
+    el: HTMLBrLoadingElement;
     /**
      * Determina o tipo de indicador a ser exibido:
      * - Se verdadeiro, exibirá uma barra de progresso com a porcentagem de progresso.

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

@@ -9,7 +9,7 @@ export declare class Message {
      * Referência ao elemento host do componente.
      * Utilize esta propriedade para acessar e manipular o elemento do DOM associado ao componente.
      */
-    el: HTMLElement;
+    el: HTMLBrMessageElement;
     elementInternals: ElementInternals;
     /**
      * Define o título da mensagem, que é exibido no início, acima da mensagem principal.
@@ -115,7 +115,7 @@ export declare class Message {
     disconnectedCallback(): void;
     /** Evento emitido quando o usuário fecha a mensagem, se closable for true. */
     brDidClose: EventEmitter;
-    dismissHandler(): void;
+    private readonly dismissHandler;
     private checkIconState;
     private getCssClassMap;
     private inheritedAttributes;

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

@@ -9,7 +9,7 @@ export declare class Radio {
      * Referência ao elemento host do componente.
      * Utilize esta propriedade para acessar e manipular o elemento do DOM associado ao componente.
      */
-    el: HTMLInputElement;
+    el: HTMLBrRadioElement;
     elementInternals: ElementInternals;
     /**
      * Define o estado de seleção do radio.
@@ -166,15 +166,16 @@ export declare class Radio {
         value: boolean;
         checked: boolean;
     }>;
-    handleClick(): Promise<void>;
-    handleKeyDown(event: KeyboardEvent): Promise<void>;
+    private readonly handleClick;
+    private readonly handleKeyDown;
     /**
      * Controla o comportamento de alternar o estado checked.
      */
-    private toggleChecked;
+    private readonly toggleChecked;
     /**
      * Determina um id para o radio.
      */
     private getComputedId;
+    private readonly stopPropagation;
     render(): any;
 }

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

@@ -9,13 +9,13 @@ export declare class Switch {
      * Referência ao elemento host do componente.
      * Utilize esta propriedade para acessar e manipular o elemento do DOM associado ao componente.
      */
-    el: HTMLElement;
+    el: HTMLBrSwitchElement;
     elementInternals: ElementInternals;
     /**
      * Identificador único do campo de entrada.
      * Caso não seja fornecido, um ID gerado automaticamente será usado.
      */
-    _idDefault: string;
+    private readonly _idDefault;
     /**
      * Desativa o switch, tornando-o não interativo.
      */
@@ -164,7 +164,7 @@ export declare class Switch {
      */
     brDidCheckedChange: EventEmitter<boolean>;
     private _hasSlotContentDefault;
-    private _handleCheckedChange;
+    private readonly handleCheckedChange;
     /**
      * Inverte o valor da prop `checked`
      */

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

@@ -0,0 +1,157 @@
+import { EventEmitter } from '../../stencil-public-runtime';
+/**
+ * Para uma descrição detalhada, consulte a [documentação do GovBR-DS](https://www.gov.br/ds/components/textarea?tab=designer).
+ *
+ * @slot default - Espaço de conteúdo do textarea. Geralmente usado para incluir texto adicional ou instruções para o usuário.
+ */
+export declare class Textarea {
+    el: HTMLElement;
+    /**
+     * Valor atual do textarea. Este valor pode ser alterado programaticamente.
+     */
+    value: string;
+    /**
+     * Texto do rótulo associado ao textarea. Este rótulo é exibido acima do campo de entrada.
+     */
+    label: string;
+    /**
+     * Texto exibido quando o textarea está vazio. Ajuda a guiar o usuário sobre o que deve ser inserido.
+     */
+    placeholder: string;
+    /**
+     * Indica se o textarea está desabilitado. Quando verdadeiro, o usuário não pode interagir com o campo.
+     */
+    disabled: boolean;
+    /**
+     * Número máximo de caracteres permitidos no textarea. Se definido como 0, não há limite.
+     */
+    maxlength: number;
+    /**
+     * Define o estado visual do componente, podendo ser 'danger', 'success' ou 'warning'.
+     */
+    states: string;
+    /**
+     * Ajusta a densidade do componente, podendo ser 'small', 'medium' ou 'large'.
+     */
+    density: string;
+    /**
+     * Ativa o modo escuro para o componente. Quando verdadeiro, o componente será exibido em um tema escuro.
+     */
+    isDarkMode: boolean;
+    /**
+     * Define se o rótulo deve ser exibido à esquerda do textarea. Quando verdadeiro, o rótulo é posicionado à esquerda.
+     */
+    isLabelLeft: boolean;
+    /**
+     * Comprimento atual do texto no textarea. É atualizado sempre que o valor do textarea muda.
+     */
+    currentLength: number;
+    elementInternals: ElementInternals;
+    /**
+     * Identificador único do textarea, gerado automaticamente.
+     * Este ID é utilizado para associar o textarea a outros elementos, como rótulos,
+     * e garantir que cada instância do componente tenha um identificador distinto.
+     */
+    defaultId: string;
+    /**
+     * Emite um evento quando o componente é conectado ao DOM.
+     * Consulte a documentação do [Stencil](https://stenciljs.com/docs/component-lifecycle#connectedcallback) para mais detalhes.
+     */
+    brDidConnect: EventEmitter<void>;
+    connectedCallback(): void;
+    /**
+     * Emite um evento antes que o componente seja carregado pela primeira vez.
+     * Utilize este evento para realizar tarefas de inicialização antes do componente ser exibido.
+     * Consulte a documentação do [Stencil](https://stenciljs.com/docs/component-lifecycle#componentwillload) para mais detalhes.
+     */
+    brWillLoad: EventEmitter<void>;
+    componentWillLoad(): void;
+    /**
+     * Emite um evento após o componente ter sido carregado pela primeira vez.
+     * Utilize este evento para realizar ações que devem ocorrer depois que o componente foi totalmente carregado.
+     * Consulte a documentação do [Stencil](https://stenciljs.com/docs/component-lifecycle#componentdidload) para mais detalhes.
+     */
+    brDidLoad: EventEmitter<void>;
+    componentDidLoad(): void;
+    /**
+     * Emite um evento antes do componente ser renderizado.
+     * Utilize este evento para preparar o componente antes de sua renderização.
+     * Consulte a documentação do [Stencil](https://stenciljs.com/docs/component-lifecycle#componentwillrender) para mais detalhes.
+     */
+    brWillRender: EventEmitter<void>;
+    componentWillRender(): void;
+    /**
+     * Emite um evento após o componente ter sido renderizado.
+     * Utilize este evento para executar ações que devem ocorrer após a renderização do componente.
+     * Consulte a documentação do [Stencil](https://stenciljs.com/docs/component-lifecycle#componentdidrender) para mais detalhes.
+     */
+    brDidRender: EventEmitter<void>;
+    componentDidRender(): void;
+    /**
+     * Emite um evento para indicar se o componente deve ser atualizado ou não.
+     * Este evento é chamado antes de qualquer atualização do componente para decidir se a atualização deve prosseguir.
+     * Consulte a documentação do [Stencil](https://stenciljs.com/docs/component-lifecycle#componentshouldupdate) para mais detalhes.
+     */
+    brShouldUpdate: EventEmitter<void>;
+    componentShouldUpdate(): void;
+    /**
+     * Emite um evento antes de o componente ser atualizado.
+     * Utilize este evento para realizar ações preparatórias antes da atualização do componente.
+     * Consulte a documentação do [Stencil](https://stenciljs.com/docs/component-lifecycle#componentwillupdate) para mais detalhes.
+     */
+    brWillUpdate: EventEmitter<void>;
+    componentWillUpdate(): void;
+    /**
+     * Emite um evento após o componente ter sido atualizado.
+     * Utilize este evento para realizar ações após a atualização do componente.
+     * Consulte a documentação do [Stencil](https://stenciljs.com/docs/component-lifecycle#componentdidupdate) para mais detalhes.
+     */
+    brDidUpdate: EventEmitter<void>;
+    componentDidUpdate(): void;
+    /**
+     * Emite um evento quando o componente é desconectado do DOM.
+     * Utilize este evento para realizar a limpeza ou outras ações necessárias quando o componente é removido.
+     * Consulte a documentação do [Stencil](https://stenciljs.com/docs/component-lifecycle#disconnectedcallback) para mais detalhes.
+     */
+    brDidDisconnect: EventEmitter<void>;
+    disconnectedCallback(): void;
+    /**
+     * Emite um evento quando o formulário associado é enviado.
+     * Utilize este evento para realizar ações quando o formulário é enviado.
+     */
+    brFormAssociatedCallback: EventEmitter<FormData>;
+    formAssociatedCallback(form: FormData): void;
+    /**
+     * Emite um evento quando o estado do formulário é alterado para desabilitado.
+     * Utilize este evento para realizar ações quando o formulário é desabilitado.
+     */
+    brFormDisabledCallback: EventEmitter<boolean>;
+    formDisabledCallback(disabled: boolean): void;
+    /**
+     * Emite um evento quando o formulário é redefinido.
+     * Utilize este evento para realizar ações quando o formulário é redefinido.
+     */
+    brFormResetCallback: EventEmitter<void>;
+    formResetCallback(): void;
+    /**
+     * Emite um evento para restaurar o estado do formulário.
+     * Utilize este evento para realizar ações quando o estado do formulário é restaurado.
+     */
+    brFormStateRestoreCallback: EventEmitter<[state: string, _mode: string]>;
+    formStateRestoreCallback(state: string, _mode: string): void;
+    valueChanged(): void;
+    /**
+     * Manipula a mudança de valor do textarea. Atualiza o valor e emite um evento de mudança.
+     * @param event - O evento de entrada do textarea.
+     */
+    handleChange(event: Event): void;
+    /**
+     * Define um novo valor para o textarea.
+     * @param newValue - O novo valor a ser definido.
+     */
+    setValue(newValue: string): Promise<void>;
+    private emitValueChange;
+    private getCssClassMap;
+    private inheritedAttributes;
+    render(): any;
+}