@sankhyalabs/ezui 2.3.0 → 2.3.2

package/dist/types/components.d.ts

@@ -7,7 +7,8 @@
 import { HTMLStencilElement, JSXBase } from "./stencil-public-runtime";
 import { IAction } from "./components/ez-actions-button/ez-actions-button";
 import { CardItem } from "./components/ez-card-item/ez-card-item";
-import { IOption } from "./components/ez-combo-box/ez-combo-box";
+import { CheckMode } from "./components/ez-check/CheckMode";
+import { IOption, ISearchArgument } from "./components/ez-combo-box/ez-combo-box";
 import { DataUnit, Record, WaitingChange } from "@sankhyalabs/core";
 import { DialogType } from "./components/ez-dialog/DialogType";
 import { IFormConfig, IRecordValidator, IValidationResult } from "./components/ez-form/ez-form";
@@ -15,54 +16,54 @@ import { EzGridColumn, EzGridColumnConfig, EzGridColumStateEvent, IGridConfig, I
 import { ListGroup, ListItem } from "./components/ez-list/ez-list";
 import { Radio } from "./components/ez-radio-button/ez-radio-button";
 import { EzScrollDirection } from "./components/ez-scroller/EzScrollDirection";
-import { IOption as IOption1 } from "./components/ez-combo-box/ez-combo-box";
+import { IOption as IOption1, ISearchArgument as ISearchArgument1 } from "./components/ez-combo-box/ez-combo-box";
 import { Tab } from "./components/ez-tabselector/ez-tabselector";
 import { IStyled } from "./components/ez-text-edit/ez-text-edit";
 import { EzFile } from "./components/ez-upload/ez-upload";
 export namespace Components {
     interface EzActionsButton {
         /**
-          * . Array no formato "{value: string, label: string, iconName: string}" que alimenta a lista de ações.
+          * Define a lista de ações. Os elementos devem obedecer o formato: `{value: string, label: string}`.
          */
         "actions": Array<IAction>;
         /**
-          * Define se o elemento contará com a seta de orientação.
+          * Se true a seta de ordenação será apresentada.
          */
         "arrowActive": boolean;
         /**
-          * Define se na opção selecionada apresentará um ícone de check.
+          * Se true o check será apresentado para os itens.
          */
         "checkOption": boolean;
         /**
-          * Nome do ícone que será apresentado no display do componente.
+          * Define o ícone do componente.
          */
         "displayIcon": string;
         /**
-          * Deixa o campo disponível ou não para interação com usuário.
+          * Se false o usuário não pode interagir com o componente.
          */
         "enabled": boolean;
         /**
-          * Oculta a lista de ações
+          * Oculta a lista de ações.
          */
         "hideActions": () => Promise<void>;
         /**
-          * Verifica se a lista de ações está oculta
+          * Verifica se a lista de ações está aberta.
          */
         "isOpened": () => Promise<boolean>;
         /**
-          * Define se o background do botão será transparent.
+          * Se true o background será transparent.
          */
         "isTransparent": boolean;
         /**
-          * Define se o label será apresentado no display do componente.
+          * Se true o label será apresentado.
          */
         "showLabel": boolean;
         /**
-          * É possível escolher entre [small,medium,large].
+          * Determina o tamanho do ez-action-button.
          */
-        "size": "small" | "medium" | "large" | undefined;
+        "size": "small" | "medium" | "large";
         /**
-          * Define qual o value que será selecionado na lista.
+          * Define o valor do componente.
          */
         "value": string;
     }
@@ -70,138 +71,141 @@ export namespace Components {
     }
     interface EzButton {
         /**
-          * Deixa o botão disponível ou não para interação com o usuário.
+          * Se false o usuário não pode interagir com o botão.
          */
         "enabled": boolean;
         /**
-          * Nome do icone disponível no pacote de fontes [ez-icons](https://sankhyalabs-storybook.herokuapp.com/themes/default/icons/fonts/index.html)
+          * Define o ícone a ser usado da biblioteca de ícones: [ez-icons](https://sankhyalabs-storybook.herokuapp.com/themes/default/icons/fonts/index.html)
          */
         "iconName": string;
         /**
-          * Define o icone svg que será utilizado no botão. Esta propriedade só é utilizada caso o componente esteja no modo "icon"
+          * Define o caminho usado nos modos `icon` e `label-icon` para imagens não contempladas na biblioteca de ícones.
          */
         "image": string;
         /**
-          * Texto indicativo da ação do botão.
+          * Texto a ser apresentado como título do botão.
          */
         "label": string;
         /**
-          * Define o modo de uso do botão; opções: icon, link e regular
+          * Define o modo de uso do botão.
          */
-        "mode": string;
+        "mode": "regular" | "icon" | "link" | "label-icon";
         /**
-          * Remove o foco no botão
+          * Remove o foco do botão.
          */
         "setBlur": () => Promise<void>;
         /**
-          * Realiza o foco no botão
+          * Aplica o foco no botão.
          */
         "setFocus": () => Promise<void>;
         /**
-          * É possível escolher entre [small,medium,large] (somente para os modos "icon" e "link")
+          * Define o tamanho do ez-button.
          */
         "size": "small" | "medium" | "large" | undefined;
     }
     interface EzCalendar {
         /**
-          * Método necessário para ajustar o posicionamento do calendar acima ou abaixo do ez-date-input conforme a disponibilidade de espaço.
+          * Ajusta o posicionamento do ez-calendar conforme a disponibilidade de espaço.
          */
         "fitVertical": (topOffset: number, bottomOffset: number) => Promise<void>;
         /**
-          * No modo floating o calendário só se tornará visível quando o método show() for acionado.
+          * Define se a exibição do ez-calendar será feita pelos métodos `show()` e `hide()`.
          */
         "floating": boolean;
         /**
-          * Usado no modo floating. Faz com que o componente seja ocultado.
+          * Oculta o ez-calendar.
          */
         "hide": () => Promise<void>;
         /**
-          * Usado no modo floating. Faz com que o componente seja exibido. É possível determinar ajustes de posicionamento através dos parâmetros top, left, bottom e right. Esses parâmetros devem ser informados como strings no formato css.
+          * Exibe o ez-calendar em uma posição determinada. É possível determinar o posicionamento através dos parâmetros, no formato css.
          */
         "show": (top?: string, left?: string, bottom?: string, right?: string) => Promise<void>;
         /**
-          * Exibe ou não os segundos no calendario
+          * Se true a data considera segundos. Deve ser usado em conjunto com a propriedade `time`.
          */
         "showSeconds": boolean;
         /**
-          * Exibe ou não as horas e minutos no calendario
+          * Se true a data considera horas e minutos.
          */
         "time": boolean;
         /**
-          * A data selecionada no calendário
+          * Define o valor do calendário.
          */
         "value": Date;
     }
     interface EzCardItem {
+        /**
+          * Determina o conteúdo do card. Deve conter um objeto no formato: `{title: string, key: string, details: any}`.
+         */
         "item": CardItem;
     }
     interface EzCheck {
         /**
-          * Deixa o campo disponível ou não para interação com o usuário.
+          * Se false o usuário não pode interagir com o campo.
          */
         "enabled": boolean;
         /**
-          * Devolve o modo escolhido para o componente
+          * Obtém o modo escolhido.
          */
-        "getMode": () => Promise<string>;
+        "getMode": () => Promise<CheckMode>;
         /**
-          * Deixa o campo em um estado indeterminado, nem marcado nem desmarcado (não disponível em modo "switch").
+          * Se true ativa o estado indeterminado, nem marcado nem desmarcado (não disponível em modo `switch`).
          */
         "indeterminate": boolean;
         /**
-          * Título do campo
+          * Texto a ser apresentado como título do campo.
          */
         "label": string;
         /**
-          * Existem dois modos de visualização: regular e switch. Se esta propriedade for omitida, o componete assume o formato "regular". No modo "regular" a visualização é a tradicional de uma caixinha marcada/desmarcada. No modo "switch" o campo tem uma interface em formato de um pino liga/desliga.
+          * Define o modo de visualização do ez-check.
          */
-        "mode": string;
+        "mode": CheckMode;
         /**
-          * Faz o foco no componente de input
+          * Aplica o foco no campo.
          */
         "setFocus": () => Promise<void>;
         /**
-          * Como se trata de um componente binário, o valor alterna entre true e false (marcado / desmarcado)
+          * Define o valor do campo.
          */
         "value": boolean;
     }
     interface EzChip {
         /**
-          * Deixa o componente disponível ou não para seleção.
+          * Se false o usuário não pode interagir com o ez-chip.
          */
         "enabled": boolean;
         /**
-          * Título exibido no componente.
+          * Texto a ser apresentado como título do ez-chip.
          */
         "label": string;
         /**
-          * Define o modo de uso do cjip: label ou action
+          * Define o modo de uso do ez-chip.
          */
         "mode": "label" | "action";
         /**
-          * Indica se o componente terá a opção de ser removido e qual sua posição: left ou right.
+          * Determina o posicionamento do botão de remover (não disponível no modo `action`).  Se não informado, não exibe o botão.
          */
-        "removePosition": "left" | "right";
+        "removePosition": "left" | "right" | undefined;
         /**
-          * Remove o foco no componente de input
+          * Remove o foco do ez-chip.
          */
         "setBlur": () => Promise<void>;
         /**
-          * Faz o foco no componente de input
+          * Aplica o foco no ez-chip.
          */
         "setFocus": () => Promise<void>;
         /**
-          * Indica se o componente está ou não ativado.
+          * Define o valor do ez-chip.
          */
         "value": boolean;
     }
     interface EzCollapsibleBox {
         /**
-          * Aplica focus no campo de edição de título.
+          * Aplica o foco no campo de edição de título.
          */
         "applyFocusTextEdit": () => Promise<void>;
         /**
-          * Fecha a edição de título.
+          * Cancela a edição de título.
          */
         "cancelEdition": () => Promise<void>;
         /**
@@ -209,390 +213,389 @@ export namespace Components {
          */
         "conditionalSave": Function;
         /**
-          * Ativa o ícone para edição do componente.
+          * Se true mostra o ícone para edição do componente.
          */
         "editable": boolean;
         /**
-          * Define o tamanho do texto e do ícone do componente.
+          * Define o tamanho do texto e do ícone.
          */
         "headerSize": "x-small" | "small" | "medium" | "large" | "x-large" | undefined;
         /**
-          * Define o local onde o ícone será renderizado.
+          * Define o posicionamento do ícone.
          */
         "iconPlacement": "left" | "right";
         /**
-          * Título do campo
+          * Texto a ser apresentado como título do componente.
          */
         "label": string;
         /**
-          * Ativa o ícone para remoção do componente.
+          * Se true mostra o ícone para remoção do componente.
          */
         "removable": boolean;
         /**
-          * Esconde ou revela o conteúdo do componente.
+          * Oculta/mostra o conteúdo do ez-collapsible-box.
          */
         "showHide": () => Promise<void>;
         /**
-          * Define se o titulo irá ocupar toda a largura do componente.
+          * Se true o título irá ocupar toda a largura do componente.
          */
         "stretchTitle": boolean;
         /**
-          * Valor externalizado que garante a exibição ou não do componente.
+          * Define o valor do componente.
          */
         "value": boolean;
     }
     interface EzComboBox {
         /**
-          * Permite exibir a mensagem de erro.
+          * Se false deixa de exibir a mensagem de erro dentro do campo.
          */
         "canShowError": boolean;
         /**
-          * Deixa o campo disponível ou não para interação com usuário.
+          * Se false o usuário não pode interagir com o campo.
          */
         "enabled": boolean;
         /**
-          * Quando há um problema de validação, serve como orientação ao usuário
+          * Define uma mensagem de orientação ao usuário, colocando o campo em modo inválido.
          */
         "errorMessage": string;
         /**
-          * Retorna informando se o campo está inválido (true | false)
+          * Retorna se o conteúdo é inválido.
          */
         "isInvalid": () => Promise<boolean>;
         /**
-          * Título do campo
+          * Texto a ser apresentado como título do campo.
          */
         "label": string;
         /**
-          * Define o modo do tamanho do campo; opções: slim e regular.
+          * Define o tamanho do campo.
          */
-        "mode": string;
+        "mode": "slim" | "regular";
         /**
-          * Função responsável por carregar as opções dinamicamente
+          * Carrega as opções dinamicamente.
          */
-        "optionLoader": Function;
+        "optionLoader": (argument: ISearchArgument) => Promise<Array<IOption>> | Array<IOption> | IOption;
         /**
-          * Array no formato "{value: string, label: string}" que alimenta as opções do Combobox
+          * Array com as opções do ez-combo-box. Os elementos devem obedecer o formato: `{value: string, label: string}`.
          */
         "options": Array<IOption>;
         /**
-          * Ativa o modo pesquisa do combobox
+          * Se true ativa o modo pesquisa do ez-combo-box.
          */
         "searchMode": boolean;
         /**
-          * Remove o foco no componente de seleção
+          * Remove o foco do campo.
          */
         "setBlur": () => Promise<void>;
         /**
-          * Realiza o foco no componente de seleção
+          * Aplica o foco no campo.
          */
         "setFocus": () => Promise<void>;
         /**
-          * Ajusta a opção de mostrar o "value" para cada opção. Por padrão não mostra
+          * Se true cada opção na lista exibe o `value` junto com `label`.
          */
         "showOptionValue": boolean;
         /**
-          * Ajusta a opção de mostrar o "value" ao selecionar uma opção. Por padrão não mostra.
+          * Se true a opção selecionada exibe o `value` junto com `label`.
          */
         "showSelectedValue": boolean;
         /**
-          * Remove a opção vazia da lista de opções
+          * Se true remove a opção vazia da lista.
          */
         "suppressEmptyOption": boolean;
         /**
-          * Desabilita a digitação dentro do componente.
+          * Se true desabilita a digitação dentro do componente.
          */
         "suppressSearch": boolean;
         /**
-          * Valor selecionado no campo
+          * Define o valor do campo.
          */
         "value": IOption | string;
     }
     interface EzDateInput {
         /**
-          * Deixa o campo disponível ou não para uso.
+          * Se false o usuário não pode interagir com o campo.
          */
         "enabled": boolean;
         /**
-          * Quando há um problema de validação, serve como orientação ao usuário
+          * Define uma mensagem de orientação ao usuário, colocando o campo em modo inválido.
          */
         "errorMessage": string;
         /**
-          * Retorna informando se o campo está inválido (true | false)
+          * Retorna se o conteúdo é inválido.
          */
         "isInvalid": () => Promise<boolean>;
         /**
-          * Título do campo
+          * Texto a ser apresentado como título do campo.
          */
         "label": string;
         /**
-          * Define o modo do tamanho do campo; opções: slim e regular.
+          * Define o tamanho do campo.
          */
-        "mode": string;
+        "mode": "slim" | "regular";
         /**
-          * Remove o foco no componente de data
+          * Remove o foco do campo.
          */
         "setBlur": () => Promise<void>;
         /**
-          * Realiza o foco no componente de data
+          * Aplica o foco no campo.
          */
         "setFocus": () => Promise<void>;
         /**
-          * A data informada pelo usuário
+          * Define o valor do campo.
          */
         "value": Date;
     }
     interface EzDateTimeInput {
         /**
-          * Deixa o campo disponível ou não para uso.
+          * Se false o usuário não pode interagir com o campo.
          */
         "enabled": boolean;
         /**
-          * Quando há um problema de validação, serve como orientação ao usuário
+          * Define uma mensagem de orientação ao usuário, colocando o campo em modo inválido.
          */
         "errorMessage": string;
         /**
-          * Retorna informando se o campo está inválido (true | false)
+          * Retorna se o conteúdo é inválido.
          */
         "isInvalid": () => Promise<boolean>;
         /**
-          * Título do campo
+          * Texto a ser apresentado como título do campo.
          */
         "label": string;
         /**
-          * Define o modo do tamanho do campo; opções: slim e regular.
+          * Define o tamanho do campo.
          */
-        "mode": string;
+        "mode": "slim" | "regular";
         /**
-          * Remove o foco no componente de datetime
+          * Remove o foco do campo.
          */
         "setBlur": () => Promise<void>;
         /**
-          * Realiza o foco no componente de datetime
+          * Aplica o foco no campo.
          */
         "setFocus": () => Promise<void>;
         /**
-          * Exibe ou não os segundos no input
+          * Se true considera segundos.
          */
         "showSeconds": boolean;
         /**
-          * A data informada pelo usuário
+          * Define o valor do campo.
          */
         "value": Date;
     }
     interface EzDialog {
         /**
-          * Define se o componente será utilizado no modo de confirmação.
+          * Define se o ez-dialog será utilizado no modo de confirmação.
          */
         "confirm": boolean;
         /**
-          * Define se o componente terá o visual padrão, de erro ou de aviso
+          * Define aparência do ez-dialog.
          */
         "dialogType": DialogType;
         /**
-          * Define o título do componente.
+          * Texto a ser apresentado como título do campo.
          */
         "ezTitle": string;
         /**
-          * Lida com o clique nos botões de dentro do componente.
-         */
-        "handleButtonClick": (selectedOption: boolean) => Promise<void>;
-        /**
-          * Menssagem exibida dentro do Dialog
+          * Define a menssagem exibida no ez-dialog.
          */
         "message": string;
         /**
-          * Controla a exibição do componente
+          * Define se o ez-dialog está aberto.
          */
         "opened": boolean;
         /**
-          * Define o ícone a ser exibido ao lado do título do componente
+          * Define o ícone a ser exibido.
          */
         "personalizedIconPath": string;
         /**
-          * Faz com que o componente seja exibido.
+          * Exibe o ez-dialog.
          */
         "show": (title: string, message: string, dialogType: DialogType, confirm: boolean, icon: string, labelCancel: string, labelConfirm: string, btnConfirmDanger: boolean) => Promise<boolean>;
     }
     interface EzFilterInput {
         /**
-          * Deixa o campo disponível ou não para uso.
+          * Se false o usuário não pode interagir com o campo.
          */
         "enabled": boolean;
         /**
-          * Quando há um problema de validação, serve como orientação ao usuário
+          * Define uma mensagem de orientação ao usuário, colocando o campo em modo inválido.
          */
         "errorMessage": string;
         /**
-          * Retorna informando se o campo está inválido (true | false)
+          * Retorna se o conteúdo é inválido.
          */
         "isInvalid": () => Promise<boolean>;
         /**
-          * Título do campo
+          * Texto a ser apresentado como título do campo.
          */
         "label": string;
         /**
-          * Deixa o componente em modo "carregando".
-         */
-        "loading": boolean;
-        /**
-          * Define o modo do tamanho do campo; opções: slim e regular.
+          * Define o tamanho do campo.
          */
-        "mode": string;
+        "mode": "slim" | "regular";
         /**
-          * Restringe o que o usuário pode digitar. Cada caractere digitado será testado e deve estar contido nessa string ou será descartado.
+          * Restringe o que o usuário pode digitar.
          */
         "restrict": string;
         /**
-          * Remove o foco no componente de input
+          * Remove o foco do campo.
          */
         "setBlur": () => Promise<void>;
         /**
-          * Realiza o foco no componente de input
+          * Aplica o foco no campo.
          */
         "setFocus": () => Promise<void>;
         /**
-          * O valor informado pelo usuário
+          * Define o valor do campo.
          */
         "value": string;
     }
     interface EzForm {
-        "cancel": () => Promise<void>;
         /**
-          * Configuração dos campos.
+          * Configuração do formulário.
          */
         "config": IFormConfig;
         /**
-          * Repositório de dados, controla a manipulação dos dados
+          * Unidade de dados. Responsável pelo controle de edição de registros e  informações pertinentes aos campos.
          */
         "dataUnit": DataUnit;
         /**
-          * Validador responsável por checar a integridade das informações do registro
+          * Define um validador responsável pela integridade dos registros.
          */
         "recordsValidator": IRecordValidator;
-        "submit": () => Promise<void>;
+        /**
+          * Realiza validação no conteúdo de todos os campos.
+         */
         "validate": () => Promise<void>;
     }
     interface EzGrid {
         /**
           * Adiciona item de menu nas colunas.
          */
-        "addColumnMenuItem": (label: string, name: string, action: Function) => Promise<any>;
+        "addColumnMenuItem": (label: string, name: string, action: Function) => Promise<void>;
         /**
           * Configuração de exibição da grade.
          */
         "config": IGridConfig;
         /**
-          * Repositório de dados, controla a manipulação dos dados.
+          * Unidade de dados. Responsável pelo controle de edição de registros e  informações pertinentes aos campos.
          */
         "dataUnit": DataUnit;
         /**
-          * Método retornar o estado atual das colunas do grid.
+          * Obtém a lista de definição de colunas.
          */
         "getColumns": () => Promise<Array<EzGridColumn>>;
         /**
-          * Método retornar o estado atual das colunas do grid.
+          * Obtém o estado atual das colunas.
          */
         "getColumnsState": () => Promise<Array<EzGridColumn>>;
         /**
-          * Retorna as linhas selecionadas na grade.
+          * Obtém as linhas selecionadas.
          */
         "getSelection": () => Promise<Array<any>>;
         /**
-          * Habilita a seleção de várias linhas
+          * Habilita a seleção de várias linhas.
          */
         "multipleSelection": boolean;
         /**
-          * Método para fazer um filtro rápido na grid.
+          * Aplica um filtro rápido.
          */
-        "quickFilter": (term: string) => Promise<any>;
+        "quickFilter": (term: string) => Promise<void>;
         /**
-          * Endereço do servidor. Se informado, o próprio datagrid controlará a obtenção dos dados, anulando a necessidade de acionar o método "setData(data)"
+          * Endereço do servidor para obtenção dos dados.
          */
         "serverUrl": string;
         /**
-          * Método responsável por receber a definição das colunas
+          * Aplica a definição de colunas.
          */
-        "setColumnsDef": (cols: Array<EzGridColumn>) => Promise<any>;
+        "setColumnsDef": (cols: Array<EzGridColumn>) => Promise<void>;
         /**
-          * Método responsável por aplicar estado pré-existente nas colunas do grid.
+          * Aplica o estado das colunas.
          */
-        "setColumnsState": (state: Array<EzGridColumnConfig>) => Promise<any>;
+        "setColumnsState": (state: Array<EzGridColumnConfig>) => Promise<void>;
         /**
-          * Método de carga dos registros. Os objetos deste array devem conter atributos para as colunas desejadas.
+          * Insere os registros no ez-grid.
          */
-        "setData": (data: Array<any>) => Promise<any>;
+        "setData": (data: Array<any>) => Promise<void>;
         /**
-          * Configuração do valor da coluna de status. Exemplo: { "RECDESP": { "-1" : "#BD0025", "1" : "#157A00" } }
+          * Define um `IStatusResolver` responsável pelo estado da coluna de status.
          */
         "statusResolver": IStatusResolver;
     }
     interface EzIcon {
         /**
-          * Path da imagem
+          * Define o endereço da imagem quando não contempladas na biblioteca de ícones.
          */
         "href": string;
         /**
-          * Nome do icone disponível no pacote de fontes [ez-icons](https://sankhyalabs-storybook.herokuapp.com/themes/default/icons/fonts/index.html)
+          * Define o ícone a ser usado da biblioteca de ícones: [ez-icons](https://sankhyalabs-storybook.herokuapp.com/themes/default/icons/fonts/index.html)
          */
         "iconName": string;
         /**
-          * Tamanho do ícone
+          * Define o tamanho do ícone.
          */
-        "size": string;
+        "size": "x-small" | "small"| "medium" | "large" | "x-large";
     }
     interface EzList {
         /**
-          * Responsável por limpar a lista de histórico do componente.
+          * Limpa o histórico da lista.
          */
         "clearHistory": () => Promise<void>;
         /**
           * Define a lista inicial do componente.
          */
-        "dataSource": any[];
+        "dataSource": Array<ListGroup | ListItem>;
         /**
-          * Define se o componente terá o comportamento de arrasto de linhas.
+          * Se true habilita `drag and drop` para os itens.
          */
         "ezDraggable": boolean;
         /**
-          * Define se os items da lista serão selecionáveis.
+          * Se true os itens serão selecionáveis.
          */
         "ezSelectable": boolean;
         /**
-          * Retorna   a lista de items conforme o modo de uso.
+          * Obtém a lista de items ou grupos.
          */
-        "getList": () => Promise<ListItem[] | ListGroup[]>;
+        "getList": () => Promise<Array<ListItem | ListGroup>>;
         /**
-          * Retorna   o item selecionado.
+          * Obtém o item selecionado.
          */
-        "getSelection": () => Promise<any>;
+        "getSelection": () => Promise<ListItem>;
         /**
-          * Define se é possível selecionar mais de um registro.  /** Função responsável por renderizar um conteúdo dentro do item da lista.
+          * Define um `builder` para construir o `HTMLElement` do item da lista.
          */
         "itemSlotBuilder": (item: any, group?: any) => HTMLElement;
         /**
-          * Responsável por dar um scroll top no componente da lista.
+          * Traz o conteúdo da lista para a área visível.
          */
         "scrollToTop": () => Promise<void>;
         /**
-          * Recebe   como argumento um ListItem {label: string} e um booleano que define se o componente deve fazer scroll para exibir o item específico (opcional).
+          * Aplica seleção nas linhas da lista.
          */
         "setSelection": (selectedItem: ListItem, scrollToOption?: boolean) => Promise<void>;
         /**
-          * Define se o componente renderizará os itens separados em grupos..
+          * Se true os grupos serão exibidos.
          */
         "useGroups": boolean;
     }
     interface EzLoadingBar {
+        /**
+          * Oculta o ez-loading-bar.
+         */
         "hide": () => Promise<void>;
+        /**
+          * Exibe o ez-loading-bar.
+         */
         "show": () => Promise<void>;
     }
     interface EzModal {
         /**
-          * Define o alinhamento do modal. Seus valores podem ser "right" ou "left"
+          * Define o alinhamento do ez-modal.
          */
-        "align": string;
+        "align": "right" | "left";
         /**
-          * Define se o modal será fechado ao clicar ESC
+          * Define se o ez-modal será fechado ao clicar `ESC`.
          */
         "closeEsc": boolean;
         /**
@@ -600,165 +603,165 @@ export namespace Components {
          */
         "closeOutsideClick": boolean;
         /**
-          * Define o tamanho do modal. Devem ser utilizados os tamanhos definidos de colunas como "col-sd-3"
+          * Define o tamanho do ez-modal. Devem ser definidas seguindo grid-layout. Exemplo: `col-sd-3`.
          */
         "modalSize": string;
         /**
-          * Controle de exibição do Modal
+          * Define se o ez-modal está aberto.
          */
         "opened": boolean;
     }
     interface EzModalContainer {
         /**
-          * Determina o texto do botão de cancelar
+          * Define o texto do botão de cancelamento.
          */
         "cancelButtonLabel": string;
         /**
-          * Variação de estado do botão de cancelar: [HIDDEN|ENABLED|DISABLED]
+          * Define o estado do botão de cancelamento.
          */
-        "cancelButtonStatus": string;
+        "cancelButtonStatus": "HIDDEN"|"ENABLED"|"DISABLED";
         /**
-          * Subtítulo (opcional), geralmente usado para orientação do usuário
+          * Texto do subtítulo, geralmente usado para orientação do usuário.
          */
         "modalSubTitle": string;
         /**
-          * Título do modal
+          * Texto a ser apresentado como título do modal.
          */
         "modalTitle": string;
         /**
-          * Determina o texto do botão de Ok
+          * Determina o texto do botão de confirmação.
          */
         "okButtonLabel": string;
         /**
-          * Variação de estado do botão de ok: [HIDDEN|ENABLED|DISABLED]
+          * Define o estado do botão de confirmação.
          */
-        "okButtonStatus": string;
+        "okButtonStatus": "HIDDEN"|"ENABLED"|"DISABLED";
         /**
-          * Determina se o cabeçalho com o título deverá ser mostrado
+          * Define se o cabeçalho será mostrado.
          */
         "showTitleBar": boolean;
     }
     interface EzNumberInput {
         /**
-          * Deixa o campo disponível ou não para uso.
+          * Se false, o usuário não pode interagir com o campo.
          */
         "enabled": boolean;
         /**
-          * Quando há um problema de validação, serve como orientação ao usuário
+          * Define uma mensagem de orientação ao usuário, colocando o campo em modo inválido.
          */
         "errorMessage": string;
         /**
-          * Retorna informando se o campo está inválido (true | false)
+          * Retorna se o conteúdo é inválido.
          */
         "isInvalid": () => Promise<boolean>;
         /**
-          * Título do campo
+          * Texto a ser apresentado como título do campo.
          */
         "label": string;
         /**
-          * Define o modo do tamanho do campo; opções: slim e regular.
+          * Define o tamanho do campo.
          */
-        "mode": string;
+        "mode": "slim" | "regular";
         /**
-          * Precisão decimal, ou seja, quantas casas decimais podem ser exibidas. Caso a quantidade de casas decimais do valor seja maior que precision, haverá arredondamento
+          * Define quantas casas decimais serão exibidas. Caso haja mais casas haverá arredondamento.
          */
         "precision": number;
         /**
-          * Esse atributo determina qual é o número mínimo de casas depois da vírgula. Exemplo: Digamos que a precision seja igual a 4, assim qualquer número será  representado com 4 casas decimais mesmo que iguais a zero: 1,0100. Se prettiprecision igual a 2, como não há necessidade de mais de duas casas decimais o valor exibido será 1,01. Por outro lado, até a quarta casa não haverá arredondamento (1,1234 = 1,1234) mas a partir da quinta casa sim (1,12345 = 1,1235).
+          * Define qual é o mínimo de casas depois da vírgula. Exemplo: 1,1 será exibido como 1,1000 quando `prettyPrecision = 4`.
          */
         "prettyPrecision": number;
         /**
-          * Remove o foco no componente de input
+          * Remove o foco do campo.
          */
         "setBlur": () => Promise<void>;
         /**
-          * Realiza o foco no componente de input
+          * Aplica o foco no campo.
          */
         "setFocus": () => Promise<void>;
         /**
-          * O valor informado pelo usuário
+          * Define o valor do campo.
          */
         "value": number;
     }
     interface EzPopover {
         /**
-          * No modo floating = false o popover só se tornará visível quando o método show() for acionado.
+          * Define que será fechado automaticamente quando o usuário clicar fora do conteúdo.
          */
         "autoClose": boolean;
         /**
-          * Offset bottom do popover em relação ao componente pai
+          * Define a distância de baixo. Devem ser usados valores válidos de CSS.
          */
         "bottom": string;
         /**
-          * Ajusta o comportamento da largura do popover. Opções: "100% e "fit-content" (default)
+          * Ajusta o comportamento da largura do popover.
          */
-        "boxWidth": string;
+        "boxWidth": "full-width" | "fit-content";
         /**
-          * Usado no modo floating. Faz com que o componente seja ocultado.
+          * Oculta o ez-popover.
          */
         "hide": () => Promise<void>;
         /**
-          * Array de componente(s) que irá(ão) abrir o popover.
+          * Define as tags que serão consideradas conteúdo.
          */
         "innerElement": Array<string> | string;
         /**
-          * Offset left do popover em relação ao componente pai
+          * Define a distância do lado esquerdo. Devem ser usados valores válidos de CSS.
          */
         "left": string;
         /**
-          * Externaliza estado atual do componente.
+          * Define se o ez-popover está aberto.
          */
         "opened": boolean;
         /**
-          * Offset right do popover em relação ao componente pai
+          * Define a distância do lado direito. Devem ser usados valores válidos de CSS.
          */
         "right": string;
         /**
-          * Faz com que o popover seja renderizado na DOM.
+          * Exibe o ez-popover.
          */
         "show": (top?: string, left?: string, bottom?: string, right?: string) => Promise<void>;
         /**
-          * Offset top do popover em relação ao componente pai
+          * Define a distância do topo. Devem ser usados valores válidos de CSS.
          */
         "top": string;
         /**
-          * Atualiza a posição do popover em relação ao componente pai.
+          * Atualiza a posição do popover.
          */
         "updatePosition": (top?: string, left?: string, bottom?: string, right?: string) => Promise<void>;
     }
     interface EzPopup {
         /**
-          * Título do componente.
+          * Texto a ser apresentado como título do componente.
          */
         "ezTitle": string;
         /**
-          * Define se o componente utilizará um cabeçalho com botão de fechamento.
+          * Define altura do componente.
          */
-        "heightMode": string;
+        "heightMode": "auto" | "full";
         /**
-          * Controla a exibição do componente.
+          * Define se o ez-popover está aberto.
          */
         "opened": boolean;
         /**
-          * Define o width que o componente deve ter, seguindo o grid system. Os valores devem estar compreendidos em [x-small | small | medium | large | x-large].
+          * Define a largura do ez-popup.
          */
-        "size": string;
+        "size": "x-small" | "small" | "medium" | "large" | "x-large";
         /**
-          * Define se o componente utilizará um cabeçalho com botão de fechamento.
+          * Define se o componente utilizará cabeçalho.
          */
         "useHeader": boolean;
     }
     interface EzRadioButton {
         /**
-          * Define a direção em que os itens são apresentadoss, podendo ser horizontal ou vertical.
+          * Define a direção dos itens.
          */
         "direction": "vertical" | "horizontal";
         /**
-          * Define se o componente está habilitado ou desabilitado
+          * Se false o usuário não pode interagir com o campo.
          */
         "enabled": boolean;
         /**
-          * Determina a descrição do grupo
+          * Texto a ser apresentado como título do campo.
          */
         "label": string;
         /**
@@ -766,71 +769,71 @@ export namespace Components {
          */
         "options": Array<Radio>;
         /**
-          * Representa o valor atualmente selecionado entre as opções
+          * Define o valor do campo.
          */
         "value": any;
     }
     interface EzScroller {
         /**
-          * Determina de o efeito de sombreado está ativo.
+          * Define se haverá efeito de sombreado.
          */
         "activeShadow": boolean;
         /**
-          * Determina se haverá scroll na direção Vertical, Horizontal ou Ambos. Por padrão, a direção é "Ambos".
+          * Define a direção em que haverá scroll.
          */
         "direction": EzScrollDirection;
         /**
-          * Determina se o scroll estará bloqueado quando necessário.
+          * Define se o `scroll` estará bloqueado.
          */
         "locked": boolean;
     }
     interface EzSearch {
         /**
-          * Deixa o campo disponível ou não.
+          * Se false o usuário não pode interagir com o campo.
          */
         "enabled": boolean;
         /**
-          * Quando há um problema de validação, serve como orientação ao usuário
+          * Define uma mensagem de orientação ao usuário, colocando o campo em modo inválido.
          */
         "errorMessage": string;
         /**
-          * Retorna informando se o campo está inválido (true | false)
+          * Retorna se o conteúdo é inválido.
          */
         "isInvalid": () => Promise<boolean>;
         /**
-          * Título do campo
+          * Texto a ser apresentado como título do campo.
          */
         "label": string;
         /**
-          * Define o modo do tamanho do campo; opções: slim e regular.
+          * Define o tamanho do campo.
          */
-        "mode": string;
+        "mode": "slim" | "regular";
         /**
-          * Função responsável por carregar as opções dinamicamente
+          * Carrega as opções dinamicamente.
          */
-        "optionLoader": Function;
+        "optionLoader": (argument: ISearchArgument) => Promise<Array<IOption>> | Array<IOption> | IOption;
         /**
-          * Remove o foco no componente de pesquisa
+          * Remove o foco do campo.
          */
         "setBlur": () => Promise<void>;
         /**
-          * Realiza o foco no componente de pesquisa
+          * Aplica o foco no campo.
          */
         "setFocus": () => Promise<void>;
         /**
-          * Ajusta a opção de mostrar o "value" para cada opção.
+          * Se false cada opção na lista deve exibir somente o `label`.
          */
         "showOptionValue": boolean;
         /**
-          * Ajusta a opção de mostrar o "value" ao selecionar uma opção.
+          * Se false a opção selecionada deve exibir somente o `label`.
          */
         "showSelectedValue": boolean;
         /**
-          * Remove a opção vazia da lista de opções
+          * Se true remove a opção vazia da lista.
          */
         "suppressEmptyOption": boolean;
         /**
-          * Código do registro selecionado
+          * Define o valor do campo.
          */
         "value": IOption | string;
     }
@@ -844,195 +847,187 @@ export namespace Components {
          */
         "selectedTab": string;
         /**
-          * Define o nome das abas do componente, separadas por vírgulas ",". Opcionalmente pode-se construir um array de objetos do tipo Tab, nesse caso o tabKey e o índice serão respeitados.
+          * Define o nome das abas do componente. Podendo serem separadas por vírgula "," ou em um Array de configuração.
          */
         "tabs": string | Array<Tab>;
     }
     interface EzTextArea {
         /**
-          * Permite exibir a mensagem de erro.
+          * Se false deixa de exibir a mensagem de erro dentro do campo.
          */
         "canShowError": boolean;
         /**
-          * Deixa o campo disponível ou não para digitação.
+          * Se false o usuário não pode interagir com o campo.
          */
         "enabled": boolean;
         /**
-          * Quando há um problema de validação, serve como orientação ao usuário
+          * Define uma mensagem de orientação ao usuário, colocando o campo em modo inválido.
          */
         "errorMessage": string;
         /**
-          * Retorna informando se o campo está inválido (true | false)
+          * Retorna se o conteúdo é inválido.
          */
         "isInvalid": () => Promise<boolean>;
         /**
-          * Título do campo
+          * Texto a ser apresentado como título do campo.
          */
         "label": string;
         /**
-          * Deixa o componente em modo "carregando".
-         */
-        "loading": boolean;
-        /**
-          * Define o modo do tamanho do campo; opções: slim e regular.
+          * Define o tamanho do campo.
          */
-        "mode": string;
+        "mode": "slim" | "regular";
         /**
-          * Ajusta o número de linhas e consequentemente o height do textarea. Valor default: 4
+          * Define o número de linhas.
          */
         "rows": number;
         /**
-          * Remove o foco no componente de input
+          * Remove o foco do campo.
          */
         "setBlur": () => Promise<void>;
         /**
-          * Faz o foco no componente de input
+          * Aplica o foco no campo.
          */
         "setFocus": () => Promise<void>;
         /**
-          * Valor digitado pelo usuário. Este valor é o que fica visível no campo.
+          * Define o valor do campo.
          */
         "value": string;
     }
     interface EzTextEdit {
         /**
-          * Aplica focus no campo.
+          * Aplica foco no campo.
          */
         "applyFocusSelect": () => Promise<void>;
         /**
-          * Define atributos do estilo
+          * Define atributos do estilo.
          */
         "styled": IStyled;
         /**
-          * Valor manipulado pelo componente através do input
+          * Define o valor do campo.
          */
         "value": string;
     }
     interface EzTextInput {
         /**
-          * Permite exibir a mensagem de erro.
+          * Se false deixa de exibir a mensagem de erro dentro do campo.
          */
         "canShowError": boolean;
         /**
-          * Deixa o campo disponível ou não para digitação.
+          * Se false o usuário não pode interagir com o campo.
          */
         "enabled": boolean;
         /**
-          * Quando há um problema de validação, serve como orientação ao usuário
+          * Define uma mensagem de orientação ao usuário, colocando o campo em modo inválido.
          */
         "errorMessage": string;
         /**
-          * Retorna informando se o campo está inválido (true | false)
+          * Retorna se o conteúdo é inválido.
          */
         "isInvalid": () => Promise<boolean>;
         /**
-          * Título do campo
+          * Texto a ser apresentado como título do campo.
          */
         "label": string;
-        /**
-          * Deixa o componente em modo "carregando".
-         */
-        "loading": boolean;
         /**
           * Aplica uma máscara no conteúdo conforme o padrão estabelecido
          */
         "mask": string;
         /**
-          * Define o modo do tamanho do campo; opções: slim e regular.
+          * Define o tamanho do campo.
          */
-        "mode": string;
+        "mode": "slim" | "regular";
         /**
-          * Define se o campo contará com bordas ou não
+          * Se true o campo não terá bordas.
          */
         "noBorder": boolean;
         /**
-          * Restringe o que o usuário pode digitar. Cada caractere digitado será testado e deve estar contido nessa string ou será descartado.
+          * Restringe o que o usuário pode digitar.
          */
         "restrict": string;
         /**
-          * Remove o foco no componente de input
+          * Remove o foco do campo.
          */
         "setBlur": () => Promise<void>;
         /**
-          * Faz o foco no componente de input
+          * Aplica o foco no campo.
          */
         "setFocus": () => Promise<void>;
         /**
-          * Valor digitado pelo usuário. Este valor é o que fica visível no campo.
+          * Define o valor do campo.
          */
         "value": string;
     }
     interface EzTimeInput {
         /**
-          * Deixa o campo disponível ou não para digitação.
+          * Se false o usuário não pode interagir com o campo.
          */
         "enabled": boolean;
         /**
-          * Quando há um problema de validação, serve como orientação ao usuário.
+          * Define uma mensagem de orientação ao usuário, colocando o campo em modo inválido.
          */
         "errorMessage": string;
         /**
-          * Retorna informando se o campo está inválido (true | false)
+          * Retorna se o conteúdo é inválido.
          */
         "isInvalid": () => Promise<boolean>;
         /**
-          * Título do campo
+          * Texto a ser apresentado como título do campo.
          */
         "label": string;
         /**
-          * Define o modo do tamanho do campo; opções: slim e regular.
+          * Define o tamanho do campo.
          */
-        "mode": string;
+        "mode": "slim" | "regular";
         /**
-          * Remove o foco no componente de input
+          * Remove o foco do campo.
          */
         "setBlur": () => Promise<void>;
         /**
-          * Faz o foco no componente de input
+          * Aplica o foco no campo.
          */
         "setFocus": () => Promise<void>;
         /**
-          * Define se o componente irá ou não considerar os segundos.
+          * Se true considera segundos.
          */
         "showSeconds": boolean;
         /**
-          * Valor que será transmitido para o back-end.
+          * Define o valor do campo.
          */
         "value": number;
     }
     interface EzToast {
         /**
-          * Controla o uso do icone de fechar o toast.
+          * Se false, o usuário não consegue fechar.
          */
         "canClose": boolean;
         /**
-          * Controla o tempo de exibição do componente em milissegundos.
+          * Define o tempo de exibição em milissegundos.
          */
         "fadeTime": number;
         /**
-          * Mensagem exibida no componente.
+          * Mensagem a ser exibida no componente.
          */
         "message": string;
         /**
-          * Exibe o componente na tela.
+          * Exibe o ez-toast.
          */
-        "show": (message: string, fadeTime: number, useIcon: boolean, canClose?: boolean) => Promise<unknown>;
+        "show": (message: string, fadeTime: number, useIcon: boolean, canClose?: boolean) => Promise<void>;
         /**
-          * Adiciona ícone de check no componente.
+          * Se true permite a utilização do slot de ícone.
          */
         "useIcon": boolean;
     }
     interface EzUpload {
         /**
-          * Método responsável por adicionar um ou mais arquivos ao componente.
+          * Adiciona arquivos.
          */
         "addFiles": (files: Array<File>) => Promise<void>;
         /**
-          * Deixa o campo disponível ou não para digitação.
+          * Se false o usuário não pode interagir com o campo.
          */
         "enabled": boolean;
         /**
-          * Título do campo
+          * Texto a ser apresentado como título do campo.
          */
         "label": string;
         /**
@@ -1048,11 +1043,11 @@ export namespace Components {
          */
         "requestHeaders": any;
         /**
-          * Remove o foco no componente de upload
+          * Remove o foco do campo.
          */
         "setBlur": () => Promise<void>;
         /**
-          * Realiza o foco no componente de upload
+          * Aplica o foco no campo.
          */
         "setFocus": () => Promise<void>;
         /**
@@ -1064,17 +1059,17 @@ export namespace Components {
          */
         "urlUpload": string;
         /**
-          * Lista de arquivos que será trafegada entre cliente e servidor
+          * Define o valor do campo.
          */
         "value": Array<EzFile>;
     }
     interface EzViewStack {
         /**
-          * Retorna o index que está atualmente ativo e sendo exibido.
+          * Obtem o índice selecionado.
          */
         "getSelectedIndex": () => Promise<number>;
         /**
-          * Exibe a aba desejada de acordo com o index passado na tela fazendo com a ativa atual seja removida ou oculta dependendo da hidePolicy.
+          * Exibe a visão de acordo com o índice.
          */
         "show": (index: number) => Promise<void>;
     }
@@ -1324,43 +1319,43 @@ declare global {
 declare namespace LocalJSX {
     interface EzActionsButton {
         /**
-          * . Array no formato "{value: string, label: string, iconName: string}" que alimenta a lista de ações.
+          * Define a lista de ações. Os elementos devem obedecer o formato: `{value: string, label: string}`.
          */
         "actions"?: Array<IAction>;
         /**
-          * Define se o elemento contará com a seta de orientação.
+          * Se true a seta de ordenação será apresentada.
          */
         "arrowActive"?: boolean;
         /**
-          * Define se na opção selecionada apresentará um ícone de check.
+          * Se true o check será apresentado para os itens.
          */
         "checkOption"?: boolean;
         /**
-          * Nome do ícone que será apresentado no display do componente.
+          * Define o ícone do componente.
          */
         "displayIcon"?: string;
         /**
-          * Deixa o campo disponível ou não para interação com usuário.
+          * Se false o usuário não pode interagir com o componente.
          */
         "enabled"?: boolean;
         /**
-          * Define se o background do botão será transparent.
+          * Se true o background será transparent.
          */
         "isTransparent"?: boolean;
         /**
-          * Evento que é disparado ao acionar uma ação.
+          * Emitido ao acionar uma ação.
          */
         "onEzAction"?: (event: CustomEvent<IAction>) => void;
         /**
-          * Define se o label será apresentado no display do componente.
+          * Se true o label será apresentado.
          */
         "showLabel"?: boolean;
         /**
-          * É possível escolher entre [small,medium,large].
+          * Determina o tamanho do ez-action-button.
          */
-        "size"?: "small" | "medium" | "large" | undefined;
+        "size"?: "small" | "medium" | "large";
         /**
-          * Define qual o value que será selecionado na lista.
+          * Define o valor do componente.
          */
         "value"?: string;
     }
@@ -1372,113 +1367,119 @@ declare namespace LocalJSX {
     }
     interface EzButton {
         /**
-          * Deixa o botão disponível ou não para interação com o usuário.
+          * Se false o usuário não pode interagir com o botão.
          */
         "enabled"?: boolean;
         /**
-          * Nome do icone disponível no pacote de fontes [ez-icons](https://sankhyalabs-storybook.herokuapp.com/themes/default/icons/fonts/index.html)
+          * Define o ícone a ser usado da biblioteca de ícones: [ez-icons](https://sankhyalabs-storybook.herokuapp.com/themes/default/icons/fonts/index.html)
          */
         "iconName"?: string;
         /**
-          * Define o icone svg que será utilizado no botão. Esta propriedade só é utilizada caso o componente esteja no modo "icon"
+          * Define o caminho usado nos modos `icon` e `label-icon` para imagens não contempladas na biblioteca de ícones.
          */
         "image"?: string;
         /**
-          * Texto indicativo da ação do botão.
+          * Texto a ser apresentado como título do botão.
          */
         "label"?: string;
         /**
-          * Define o modo de uso do botão; opções: icon, link e regular
+          * Define o modo de uso do botão.
          */
-        "mode"?: string;
+        "mode"?: "regular" | "icon" | "link" | "label-icon";
         /**
-          * É possível escolher entre [small,medium,large] (somente para os modos "icon" e "link")
+          * Define o tamanho do ez-button.
          */
         "size"?: "small" | "medium" | "large" | undefined;
     }
     interface EzCalendar {
         /**
-          * No modo floating o calendário só se tornará visível quando o método show() for acionado.
+          * Define se a exibição do ez-calendar será feita pelos métodos `show()` e `hide()`.
          */
         "floating"?: boolean;
         /**
-          * Quando o usuário escolhe uma data, esse evento é emitido.
+          * Emitido quando acontece a alteração de valor do calendário.
          */
         "onEzChange"?: (event: CustomEvent<Date>) => void;
         /**
-          * Exibe ou não os segundos no calendario
+          * Se true a data considera segundos. Deve ser usado em conjunto com a propriedade `time`.
          */
         "showSeconds"?: boolean;
         /**
-          * Exibe ou não as horas e minutos no calendario
+          * Se true a data considera horas e minutos.
          */
         "time"?: boolean;
         /**
-          * A data selecionada no calendário
+          * Define o valor do calendário.
          */
         "value"?: Date;
     }
     interface EzCardItem {
+        /**
+          * Determina o conteúdo do card. Deve conter um objeto no formato: `{title: string, key: string, details: any}`.
+         */
         "item"?: CardItem;
+        /**
+          * Emitido sempre que o ez-card é clicado.
+         */
         "onEzClick"?: (event: CustomEvent<CardItem>) => void;
     }
     interface EzCheck {
         /**
-          * Deixa o campo disponível ou não para interação com o usuário.
+          * Se false o usuário não pode interagir com o campo.
          */
         "enabled"?: boolean;
         /**
-          * Deixa o campo em um estado indeterminado, nem marcado nem desmarcado (não disponível em modo "switch").
+          * Se true ativa o estado indeterminado, nem marcado nem desmarcado (não disponível em modo `switch`).
          */
         "indeterminate"?: boolean;
         /**
-          * Título do campo
+          * Texto a ser apresentado como título do campo.
          */
         "label"?: string;
         /**
-          * Existem dois modos de visualização: regular e switch. Se esta propriedade for omitida, o componete assume o formato "regular". No modo "regular" a visualização é a tradicional de uma caixinha marcada/desmarcada. No modo "switch" o campo tem uma interface em formato de um pino liga/desliga.
+          * Define o modo de visualização do ez-check.
          */
-        "mode"?: string;
+        "mode"?: CheckMode;
         /**
-          * Evento disparado ao mudar o estado do check(onEzChange).
+          * Emitido quando acontece a alteração de valor do campo.
          */
         "onEzChange"?: (event: CustomEvent<any>) => void;
         /**
-          * Como se trata de um componente binário, o valor alterna entre true e false (marcado / desmarcado)
+          * Define o valor do campo.
          */
         "value"?: boolean;
     }
     interface EzChip {
         /**
-          * Deixa o componente disponível ou não para seleção.
+          * Se false o usuário não pode interagir com o ez-chip.
          */
         "enabled"?: boolean;
         /**
-          * Título exibido no componente.
+          * Texto a ser apresentado como título do ez-chip.
          */
         "label"?: string;
         /**
-          * Define o modo de uso do cjip: label ou action
+          * Define o modo de uso do ez-chip.
          */
         "mode"?: "label" | "action";
         /**
-          * Evento disparado ao clicar no chip usando o modo "action" (onActionClick).
+          * Emitido no modo "action" quando o usuário clica no ez-chip.
          */
         "onActionClick"?: (event: CustomEvent<void>) => void;
         /**
-          * Evento disparado ao clicar no botão de remoção (onRemoveChip).
+          * Emitido quando o botão de remoção é acionado.
          */
         "onRemoveChip"?: (event: CustomEvent<void>) => void;
         /**
-          * Evento disparado quando o estado do componente mudar (onValueChange).
+          * Emitido quando acontece a alteração de valor do ez-chip.
          */
         "onValueChange"?: (event: CustomEvent<boolean>) => void;
         /**
-          * Indica se o componente terá a opção de ser removido e qual sua posição: left ou right.
+          * Determina o posicionamento do botão de remover (não disponível no modo `action`).  Se não informado, não exibe o botão.
          */
-        "removePosition"?: "left" | "right";
+        "removePosition"?: "left" | "right" | undefined;
         /**
-          * Indica se o componente está ou não ativado.
+          * Define o valor do ez-chip.
          */
         "value"?: boolean;
     }
@@ -1488,255 +1489,251 @@ declare namespace LocalJSX {
          */
         "conditionalSave"?: Function;
         /**
-          * Ativa o ícone para edição do componente.
+          * Se true mostra o ícone para edição do componente.
          */
         "editable"?: boolean;
         /**
-          * Define o tamanho do texto e do ícone do componente.
+          * Define o tamanho do texto e do ícone.
          */
         "headerSize"?: "x-small" | "small" | "medium" | "large" | "x-large" | undefined;
         /**
-          * Define o local onde o ícone será renderizado.
+          * Define o posicionamento do ícone.
          */
         "iconPlacement"?: "left" | "right";
         /**
-          * Título do campo
+          * Texto a ser apresentado como título do componente.
          */
         "label"?: string;
         /**
-          * Evento disparado ao mudar o estado do componente (onEzChange).
+          * Emitido quando acontece a alteração de valor do componente.
          */
         "onEzChange"?: (event: CustomEvent<boolean>) => void;
         /**
-          * Evento disparado quando o modo de edição da label for aberto e fechado (onEzEditLabelMode).
+          * Emitido quando o modo de edição da label for aberto e fechado (onEzEditLabelMode).
          */
         "onEzEditLabelMode"?: (event: CustomEvent<boolean>) => void;
         /**
-          * Evento disparado ao remover o componente (onEzRemove).
+          * Emitido ao remover o componente (onEzRemove).
          */
         "onEzRemove"?: (event: CustomEvent<EzCollapsibleBox>) => void;
         /**
-          * Evento disparado ao concluir edição da label (onEzSaveEditLabel).
+          * Emitido ao concluir edição da label (onEzSaveEditLabel).
          */
         "onEzSaveEditLabel"?: (event: CustomEvent<CustomEvent>) => void;
         /**
-          * Ativa o ícone para remoção do componente.
+          * Se true mostra o ícone para remoção do componente.
          */
         "removable"?: boolean;
         /**
-          * Define se o titulo irá ocupar toda a largura do componente.
+          * Se true o título irá ocupar toda a largura do componente.
          */
         "stretchTitle"?: boolean;
         /**
-          * Valor externalizado que garante a exibição ou não do componente.
+          * Define o valor do componente.
          */
         "value"?: boolean;
     }
     interface EzComboBox {
         /**
-          * Permite exibir a mensagem de erro.
+          * Se false deixa de exibir a mensagem de erro dentro do campo.
          */
         "canShowError"?: boolean;
         /**
-          * Deixa o campo disponível ou não para interação com usuário.
+          * Se false o usuário não pode interagir com o campo.
          */
         "enabled"?: boolean;
         /**
-          * Quando há um problema de validação, serve como orientação ao usuário
+          * Define uma mensagem de orientação ao usuário, colocando o campo em modo inválido.
          */
         "errorMessage"?: string;
         /**
-          * Título do campo
+          * Texto a ser apresentado como título do campo.
          */
         "label"?: string;
         /**
-          * Define o modo do tamanho do campo; opções: slim e regular.
+          * Define o tamanho do campo.
          */
-        "mode"?: string;
+        "mode"?: "slim" | "regular";
         /**
-          * Evento que é disparado ao alterar o valor do componente
+          * Emitido quando acontece a alteração de valor do campo.
          */
         "onEzChange"?: (event: CustomEvent<IOption>) => void;
         /**
-          * Função responsável por carregar as opções dinamicamente
+          * Carrega as opções dinamicamente.
          */
-        "optionLoader"?: Function;
+        "optionLoader"?: (argument: ISearchArgument) => Promise<Array<IOption>> | Array<IOption> | IOption;
         /**
-          * Array no formato "{value: string, label: string}" que alimenta as opções do Combobox
+          * Array com as opções do ez-combo-box. Os elementos devem obedecer o formato: `{value: string, label: string}`.
          */
         "options"?: Array<IOption>;
         /**
-          * Ativa o modo pesquisa do combobox
+          * Se true ativa o modo pesquisa do ez-combo-box.
          */
         "searchMode"?: boolean;
         /**
-          * Ajusta a opção de mostrar o "value" para cada opção. Por padrão não mostra
+          * Se true cada opção na lista exibe o `value` junto com `label`.
          */
         "showOptionValue"?: boolean;
         /**
-          * Ajusta a opção de mostrar o "value" ao selecionar uma opção. Por padrão não mostra.
+          * Se true a opção selecionada exibe o `value` junto com `label`.
          */
         "showSelectedValue"?: boolean;
         /**
-          * Remove a opção vazia da lista de opções
+          * Se true remove a opção vazia da lista.
          */
         "suppressEmptyOption"?: boolean;
         /**
-          * Desabilita a digitação dentro do componente.
+          * Se true desabilita a digitação dentro do componente.
          */
         "suppressSearch"?: boolean;
         /**
-          * Valor selecionado no campo
+          * Define o valor do campo.
          */
         "value"?: IOption | string;
     }
     interface EzDateInput {
         /**
-          * Deixa o campo disponível ou não para uso.
+          * Se false o usuário não pode interagir com o campo.
          */
         "enabled"?: boolean;
         /**
-          * Quando há um problema de validação, serve como orientação ao usuário
+          * Define uma mensagem de orientação ao usuário, colocando o campo em modo inválido.
          */
         "errorMessage"?: string;
         /**
-          * Título do campo
+          * Texto a ser apresentado como título do campo.
          */
         "label"?: string;
         /**
-          * Define o modo do tamanho do campo; opções: slim e regular.
+          * Define o tamanho do campo.
          */
-        "mode"?: string;
+        "mode"?: "slim" | "regular";
         /**
-          * Entre o evento ezStartChange e ezChange, se por algum motivo não foi possível completar a alteração, esse evento é disparado.
+          * Emitido quando não foi possível completar a alteração entre o evento ezStartChange e ezChange.
          */
         "onEzCancelWaitingChange"?: (event: CustomEvent<void>) => void;
         /**
-          * Evento disparado ao mudar o estado do componente(onEzChange).
+          * Emitido quando acontece a alteração de valor do campo.
          */
         "onEzChange"?: (event: CustomEvent<Date>) => void;
         /**
-          * Evento emitido ao iniciar a alteração (remover ou adicionar um arquivo).
+          * Emitido ao iniciar a alteração (digitação incompleta).
          */
         "onEzStartChange"?: (event: CustomEvent<WaitingChange>) => void;
         /**
-          * A data informada pelo usuário
+          * Define o valor do campo.
          */
         "value"?: Date;
     }
     interface EzDateTimeInput {
         /**
-          * Deixa o campo disponível ou não para uso.
+          * Se false o usuário não pode interagir com o campo.
          */
         "enabled"?: boolean;
         /**
-          * Quando há um problema de validação, serve como orientação ao usuário
+          * Define uma mensagem de orientação ao usuário, colocando o campo em modo inválido.
          */
         "errorMessage"?: string;
         /**
-          * Título do campo
+          * Texto a ser apresentado como título do campo.
          */
         "label"?: string;
         /**
-          * Define o modo do tamanho do campo; opções: slim e regular.
+          * Define o tamanho do campo.
          */
-        "mode"?: string;
+        "mode"?: "slim" | "regular";
         /**
-          * Entre o evento ezStartChange e ezChange, se por algum motivo não foi possível completar a alteração, esse evento é disparado.
+          * Emitido quando não foi possível completar a alteração entre o evento ezStartChange e ezChange.
          */
         "onEzCancelWaitingChange"?: (event: CustomEvent<void>) => void;
         /**
-          * Evento disparado ao mudar o estado do componente(onEzChange).
+          * Emitido quando acontece a alteração de valor do campo.
          */
         "onEzChange"?: (event: CustomEvent<Date>) => void;
         /**
-          * Evento emitido ao iniciar a alteração (remover ou adicionar um arquivo).
+          * Emitido ao iniciar a alteração (digitação incompleta).
          */
         "onEzStartChange"?: (event: CustomEvent<WaitingChange>) => void;
         /**
-          * Exibe ou não os segundos no input
+          * Se true considera segundos.
          */
         "showSeconds"?: boolean;
         /**
-          * A data informada pelo usuário
+          * Define o valor do campo.
          */
         "value"?: Date;
     }
     interface EzDialog {
         /**
-          * Define se o componente será utilizado no modo de confirmação.
+          * Define se o ez-dialog será utilizado no modo de confirmação.
          */
         "confirm"?: boolean;
         /**
-          * Define se o componente terá o visual padrão, de erro ou de aviso
+          * Define aparência do ez-dialog.
          */
         "dialogType"?: DialogType;
         /**
-          * Define o título do componente.
+          * Texto a ser apresentado como título do campo.
          */
         "ezTitle"?: string;
         /**
-          * Menssagem exibida dentro do Dialog
+          * Define a menssagem exibida no ez-dialog.
          */
         "message"?: string;
         /**
-          * Evento disparado ao clicar no botão de aceitação.
+          * Emitido ao confirmar o ez-dialog.
          */
         "onEzAccept"?: (event: CustomEvent<boolean>) => void;
         /**
-          * Evento disparado ao clicar tanto no botão de negação quanto no X.
+          * Emitido ao cancelar o ez-dialog.
          */
         "onEzCancel"?: (event: CustomEvent<boolean>) => void;
         /**
-          * Controla a exibição do componente
+          * Define se o ez-dialog está aberto.
          */
         "opened"?: boolean;
         /**
-          * Define o ícone a ser exibido ao lado do título do componente
+          * Define o ícone a ser exibido.
          */
         "personalizedIconPath"?: string;
     }
     interface EzFilterInput {
         /**
-          * Deixa o campo disponível ou não para uso.
+          * Se false o usuário não pode interagir com o campo.
          */
         "enabled"?: boolean;
         /**
-          * Quando há um problema de validação, serve como orientação ao usuário
+          * Define uma mensagem de orientação ao usuário, colocando o campo em modo inválido.
          */
         "errorMessage"?: string;
         /**
-          * Título do campo
+          * Texto a ser apresentado como título do campo.
          */
         "label"?: string;
         /**
-          * Deixa o componente em modo "carregando".
+          * Define o tamanho do campo.
          */
-        "loading"?: boolean;
+        "mode"?: "slim" | "regular";
         /**
-          * Define o modo do tamanho do campo; opções: slim e regular.
-         */
-        "mode"?: string;
-        /**
-          * Evento disparado quando o estado do componente é alterado (onEzChange).
+          * Emitido quando acontece a alteração de valor do campo.
          */
         "onEzChange"?: (event: CustomEvent<string>) => void;
         /**
-          * Restringe o que o usuário pode digitar. Cada caractere digitado será testado e deve estar contido nessa string ou será descartado.
+          * Restringe o que o usuário pode digitar.
          */
         "restrict"?: string;
         /**
-          * O valor informado pelo usuário
+          * Define o valor do campo.
          */
         "value"?: string;
     }
     interface EzForm {
         /**
-          * Configuração dos campos.
+          * Configuração do formulário.
          */
         "config"?: IFormConfig;
         /**
-          * Repositório de dados, controla a manipulação dos dados
+          * Unidade de dados. Responsável pelo controle de edição de registros e  informações pertinentes aos campos.
          */
         "dataUnit"?: DataUnit;
         /**
@@ -1744,7 +1741,7 @@ declare namespace LocalJSX {
          */
         "onEzReady"?: (event: CustomEvent<void>) => void;
         /**
-          * Validador responsável por checar a integridade das informações do registro
+          * Define um validador responsável pela integridade dos registros.
          */
         "recordsValidator"?: IRecordValidator;
     }
@@ -1754,75 +1751,75 @@ declare namespace LocalJSX {
          */
         "config"?: IGridConfig;
         /**
-          * Repositório de dados, controla a manipulação dos dados.
+          * Unidade de dados. Responsável pelo controle de edição de registros e  informações pertinentes aos campos.
          */
         "dataUnit"?: DataUnit;
         /**
-          * Habilita a seleção de várias linhas
+          * Habilita a seleção de várias linhas.
          */
         "multipleSelection"?: boolean;
         /**
-          * Evento disparado ao realizar alguma modificação na configuração da grid.
+          * Emitido quando acontece a alteração de configuração do grade.
          */
         "onConfigChange"?: (event: CustomEvent<IGridConfig>) => void;
         /**
-          * Evento disparado ao mudar o estado das colunas do grid. Ordenação, largura, etc.
+          * Emitido quando acontece a alteração de estado das colunas do grid: Ordenação, largura, etc.
          */
         "onEzColumnStateChange"?: (event: CustomEvent<EzGridColumStateEvent>) => void;
         /**
-          * Evento disparado com o duplo clique de uma linha
+          * Emitido com o duplo clique de uma linha
          */
         "onEzDoubleClick"?: (event: CustomEvent<any>) => void;
         /**
-          * Evento disparado ao selecionar linhas da grade.
+          * Emitido quando acontece a alteração de seleção de linhas.
          */
         "onEzSelectionChange"?: (event: CustomEvent<Array<any>>) => void;
         /**
-          * Endereço do servidor. Se informado, o próprio datagrid controlará a obtenção dos dados, anulando a necessidade de acionar o método "setData(data)"
+          * Endereço do servidor para obtenção dos dados.
          */
         "serverUrl"?: string;
         /**
-          * Configuração do valor da coluna de status. Exemplo: { "RECDESP": { "-1" : "#BD0025", "1" : "#157A00" } }
+          * Define um `IStatusResolver` responsável pelo estado da coluna de status.
          */
         "statusResolver"?: IStatusResolver;
     }
     interface EzIcon {
         /**
-          * Path da imagem
+          * Define o endereço da imagem quando não contempladas na biblioteca de ícones.
          */
         "href"?: string;
         /**
-          * Nome do icone disponível no pacote de fontes [ez-icons](https://sankhyalabs-storybook.herokuapp.com/themes/default/icons/fonts/index.html)
+          * Define o ícone a ser usado da biblioteca de ícones: [ez-icons](https://sankhyalabs-storybook.herokuapp.com/themes/default/icons/fonts/index.html)
          */
         "iconName"?: string;
         /**
-          * Tamanho do ícone
+          * Define o tamanho do ícone.
          */
-        "size"?: string;
+        "size"?: "x-small" | "small"| "medium" | "large" | "x-large";
     }
     interface EzList {
         /**
           * Define a lista inicial do componente.
          */
-        "dataSource"?: any[];
+        "dataSource"?: Array<ListGroup | ListItem>;
         /**
-          * Define se o componente terá o comportamento de arrasto de linhas.
+          * Se true habilita `drag and drop` para os itens.
          */
         "ezDraggable"?: boolean;
         /**
-          * Define se os items da lista serão selecionáveis.
+          * Se true os itens serão selecionáveis.
          */
         "ezSelectable"?: boolean;
         /**
-          * Define se é possível selecionar mais de um registro.  /** Função responsável por renderizar um conteúdo dentro do item da lista.
+          * Define um `builder` para construir o `HTMLElement` do item da lista.
          */
         "itemSlotBuilder"?: (item: any, group?: any) => HTMLElement;
         /**
-          * Evento disparado ao modificar ordenação nas linhas da grade.
+          * Emitido quando acontece a alteração de estado da lista.
          */
-        "onEzChange"?: (event: CustomEvent<ListItem[] | ListGroup[]>) => void;
+        "onEzChange"?: (event: CustomEvent<Array<ListItem|ListGroup>>) => void;
         /**
-          * Define se o componente renderizará os itens separados em grupos..
+          * Se true os grupos serão exibidos.
          */
         "useGroups"?: boolean;
     }
@@ -1830,11 +1827,11 @@ declare namespace LocalJSX {
     }
     interface EzModal {
         /**
-          * Define o alinhamento do modal. Seus valores podem ser "right" ou "left"
+          * Define o alinhamento do ez-modal.
          */
-        "align"?: string;
+        "align"?: "right" | "left";
         /**
-          * Define se o modal será fechado ao clicar ESC
+          * Define se o ez-modal será fechado ao clicar `ESC`.
          */
         "closeEsc"?: boolean;
         /**
@@ -1842,177 +1839,177 @@ declare namespace LocalJSX {
          */
         "closeOutsideClick"?: boolean;
         /**
-          * Define o tamanho do modal. Devem ser utilizados os tamanhos definidos de colunas como "col-sd-3"
+          * Define o tamanho do ez-modal. Devem ser definidas seguindo grid-layout. Exemplo: `col-sd-3`.
          */
         "modalSize"?: string;
         /**
-          * Um evento disparado quando o modal é fechado (onEzCloseModal).
+          * Emitido quando o modal é fechado.
          */
         "onEzCloseModal"?: (event: CustomEvent<boolean>) => void;
         /**
-          * Um evento disparado quando o modal é aberto (onEzOpenModal).
+          * Emitido quando o modal é aberto.
          */
         "onEzOpenModal"?: (event: CustomEvent<any>) => void;
         /**
-          * Controle de exibição do Modal
+          * Define se o ez-modal está aberto.
          */
         "opened"?: boolean;
     }
     interface EzModalContainer {
         /**
-          * Determina o texto do botão de cancelar
+          * Define o texto do botão de cancelamento.
          */
         "cancelButtonLabel"?: string;
         /**
-          * Variação de estado do botão de cancelar: [HIDDEN|ENABLED|DISABLED]
+          * Define o estado do botão de cancelamento.
          */
-        "cancelButtonStatus"?: string;
+        "cancelButtonStatus"?: "HIDDEN"|"ENABLED"|"DISABLED";
         /**
-          * Subtítulo (opcional), geralmente usado para orientação do usuário
+          * Texto do subtítulo, geralmente usado para orientação do usuário.
          */
         "modalSubTitle"?: string;
         /**
-          * Título do modal
+          * Texto a ser apresentado como título do modal.
          */
         "modalTitle"?: string;
         /**
-          * Determina o texto do botão de Ok
+          * Determina o texto do botão de confirmação.
          */
         "okButtonLabel"?: string;
         /**
-          * Variação de estado do botão de ok: [HIDDEN|ENABLED|DISABLED]
+          * Define o estado do botão de confirmação.
          */
-        "okButtonStatus"?: string;
+        "okButtonStatus"?: "HIDDEN"|"ENABLED"|"DISABLED";
         /**
           * Representa a interação com o usuário. OK - Quando o botão é acionado CANCEL - Quando o botão de cancelar é acionado CLOSE - Quando o botão de fechar é acionado. LOAD - Quando o modal é carregado (eventualmente pode ser usado para dar foco a um elemento específico)
          */
         "onEzModalAction"?: (event: CustomEvent<string>) => void;
         /**
-          * Determina se o cabeçalho com o título deverá ser mostrado
+          * Define se o cabeçalho será mostrado.
          */
         "showTitleBar"?: boolean;
     }
     interface EzNumberInput {
         /**
-          * Deixa o campo disponível ou não para uso.
+          * Se false, o usuário não pode interagir com o campo.
          */
         "enabled"?: boolean;
         /**
-          * Quando há um problema de validação, serve como orientação ao usuário
+          * Define uma mensagem de orientação ao usuário, colocando o campo em modo inválido.
          */
         "errorMessage"?: string;
         /**
-          * Título do campo
+          * Texto a ser apresentado como título do campo.
          */
         "label"?: string;
         /**
-          * Define o modo do tamanho do campo; opções: slim e regular.
+          * Define o tamanho do campo.
          */
-        "mode"?: string;
+        "mode"?: "slim" | "regular";
         /**
-          * Entre o evento ezStartChange e ezChange, se por algum motivo não foi possível completar a alteração, esse evento é disparado.
+          * Emitido quando não foi possível completar a alteração entre o evento ezStartChange e ezChange.
          */
         "onEzCancelWaitingChange"?: (event: CustomEvent<void>) => void;
         /**
-          * Evento disparado quando o estado do componente é alterado (onEzChange).
+          * Emitido quando acontece a alteração de valor do campo.
          */
         "onEzChange"?: (event: CustomEvent<number>) => void;
         /**
-          * Evento emitido ao iniciar a alteração (remover ou adicionar um arquivo).
+          * Emitido ao iniciar a alteração (digitação incompleta).
          */
         "onEzStartChange"?: (event: CustomEvent<WaitingChange>) => void;
         /**
-          * Precisão decimal, ou seja, quantas casas decimais podem ser exibidas. Caso a quantidade de casas decimais do valor seja maior que precision, haverá arredondamento
+          * Define quantas casas decimais serão exibidas. Caso haja mais casas haverá arredondamento.
          */
         "precision"?: number;
         /**
-          * Esse atributo determina qual é o número mínimo de casas depois da vírgula. Exemplo: Digamos que a precision seja igual a 4, assim qualquer número será  representado com 4 casas decimais mesmo que iguais a zero: 1,0100. Se prettiprecision igual a 2, como não há necessidade de mais de duas casas decimais o valor exibido será 1,01. Por outro lado, até a quarta casa não haverá arredondamento (1,1234 = 1,1234) mas a partir da quinta casa sim (1,12345 = 1,1235).
+          * Define qual é o mínimo de casas depois da vírgula. Exemplo: 1,1 será exibido como 1,1000 quando `prettyPrecision = 4`.
          */
         "prettyPrecision"?: number;
         /**
-          * O valor informado pelo usuário
+          * Define o valor do campo.
          */
         "value"?: number;
     }
     interface EzPopover {
         /**
-          * No modo floating = false o popover só se tornará visível quando o método show() for acionado.
+          * Define que será fechado automaticamente quando o usuário clicar fora do conteúdo.
          */
         "autoClose"?: boolean;
         /**
-          * Offset bottom do popover em relação ao componente pai
+          * Define a distância de baixo. Devem ser usados valores válidos de CSS.
          */
         "bottom"?: string;
         /**
-          * Ajusta o comportamento da largura do popover. Opções: "100% e "fit-content" (default)
+          * Ajusta o comportamento da largura do popover.
          */
-        "boxWidth"?: string;
+        "boxWidth"?: "full-width" | "fit-content";
         /**
-          * Array de componente(s) que irá(ão) abrir o popover.
+          * Define as tags que serão consideradas conteúdo.
          */
         "innerElement"?: Array<string> | string;
         /**
-          * Offset left do popover em relação ao componente pai
+          * Define a distância do lado esquerdo. Devem ser usados valores válidos de CSS.
          */
         "left"?: string;
         /**
-          * Evento disparado ao exibir/ocultar o componente.
+          * Emitido quando acontece a alteração de estado do componente.
          */
         "onEzVisibilityChange"?: (event: CustomEvent<boolean>) => void;
         /**
-          * Externaliza estado atual do componente.
+          * Define se o ez-popover está aberto.
          */
         "opened"?: boolean;
         /**
-          * Offset right do popover em relação ao componente pai
+          * Define a distância do lado direito. Devem ser usados valores válidos de CSS.
          */
         "right"?: string;
         /**
-          * Offset top do popover em relação ao componente pai
+          * Define a distância do topo. Devem ser usados valores válidos de CSS.
          */
         "top"?: string;
     }
     interface EzPopup {
         /**
-          * Título do componente.
+          * Texto a ser apresentado como título do componente.
          */
         "ezTitle"?: string;
         /**
-          * Define se o componente utilizará um cabeçalho com botão de fechamento.
+          * Define altura do componente.
          */
-        "heightMode"?: string;
+        "heightMode"?: "auto" | "full";
         /**
-          * Evento disparado ao clicar no botão de fechar (onEzClosePopup).
+          * Emitido ao clicar no botão de fechar (onEzClosePopup).
          */
         "onEzClosePopup"?: (event: CustomEvent<any>) => void;
         /**
-          * Controla a exibição do componente.
+          * Define se o ez-popover está aberto.
          */
         "opened"?: boolean;
         /**
-          * Define o width que o componente deve ter, seguindo o grid system. Os valores devem estar compreendidos em [x-small | small | medium | large | x-large].
+          * Define a largura do ez-popup.
          */
-        "size"?: string;
+        "size"?: "x-small" | "small" | "medium" | "large" | "x-large";
         /**
-          * Define se o componente utilizará um cabeçalho com botão de fechamento.
+          * Define se o componente utilizará cabeçalho.
          */
         "useHeader"?: boolean;
     }
     interface EzRadioButton {
         /**
-          * Define a direção em que os itens são apresentadoss, podendo ser horizontal ou vertical.
+          * Define a direção dos itens.
          */
         "direction"?: "vertical" | "horizontal";
         /**
-          * Define se o componente está habilitado ou desabilitado
+          * Se false o usuário não pode interagir com o campo.
          */
         "enabled"?: boolean;
         /**
-          * Determina a descrição do grupo
+          * Texto a ser apresentado como título do campo.
          */
         "label"?: string;
         /**
-          * Evento disparado quando uma opção for selecionada
+          * Emitido quando acontece a alteração de valor do campo.
          */
         "onEzChange"?: (event: CustomEvent<any>) => void;
         /**
@@ -2020,73 +2017,69 @@ declare namespace LocalJSX {
          */
         "options"?: Array<Radio>;
         /**
-          * Representa o valor atualmente selecionado entre as opções
+          * Define o valor do campo.
          */
         "value"?: any;
     }
     interface EzScroller {
         /**
-          * Determina de o efeito de sombreado está ativo.
+          * Define se haverá efeito de sombreado.
          */
         "activeShadow"?: boolean;
         /**
-          * Determina se haverá scroll na direção Vertical, Horizontal ou Ambos. Por padrão, a direção é "Ambos".
+          * Define a direção em que haverá scroll.
          */
         "direction"?: EzScrollDirection;
         /**
-          * Determina se o scroll estará bloqueado quando necessário.
+          * Define se o `scroll` estará bloqueado.
          */
         "locked"?: boolean;
     }
     interface EzSearch {
         /**
-          * Deixa o campo disponível ou não.
+          * Se false o usuário não pode interagir com o campo.
          */
         "enabled"?: boolean;
         /**
-          * Quando há um problema de validação, serve como orientação ao usuário
+          * Define uma mensagem de orientação ao usuário, colocando o campo em modo inválido.
          */
         "errorMessage"?: string;
         /**
-          * Título do campo
+          * Texto a ser apresentado como título do campo.
          */
         "label"?: string;
         /**
-          * Define o modo do tamanho do campo; opções: slim e regular.
+          * Define o tamanho do campo.
          */
-        "mode"?: string;
+        "mode"?: "slim" | "regular";
         /**
-          * Um evento disparado quando o estado do componente é alterado (onEzChange).
+          * Emitido quando acontece a alteração de valor do campo.
          */
         "onEzChange"?: (event: CustomEvent<IOption>) => void;
         /**
-          * Evento emitido ao clicar para abrir o popup
-         */
-        "onShowPopup"?: (event: CustomEvent<any>) => void;
-        /**
-          * Função responsável por carregar as opções dinamicamente
+          * Carrega as opções dinamicamente.
          */
-        "optionLoader"?: Function;
+        "optionLoader"?: (argument: ISearchArgument) => Promise<Array<IOption>> | Array<IOption> | IOption;
         /**
-          * Ajusta a opção de mostrar o "value" para cada opção.
+          * Se false cada opção na lista deve exibir somente o `label`.
          */
         "showOptionValue"?: boolean;
         /**
-          * Ajusta a opção de mostrar o "value" ao selecionar uma opção.
+          * Se false a opção selecionada deve exibir somente o `label`.
          */
         "showSelectedValue"?: boolean;
         /**
-          * Remove a opção vazia da lista de opções
+          * Se true remove a opção vazia da lista.
          */
         "suppressEmptyOption"?: boolean;
         /**
-          * Código do registro selecionado
+          * Define o valor do campo.
          */
         "value"?: IOption | string;
     }
     interface EzTabselector {
         /**
-          * Evento emitido ao clicar para abrir o popup (ezChange). O detail desse evento carrega tanto o tabKey quanto o index da aba selecionada.
+          * Emitido quando acontece a alteração de valor do componente.
          */
         "onEzChange"?: (event: CustomEvent<Tab>) => void;
         /**
@@ -2098,175 +2091,167 @@ declare namespace LocalJSX {
          */
         "selectedTab"?: string;
         /**
-          * Define o nome das abas do componente, separadas por vírgulas ",". Opcionalmente pode-se construir um array de objetos do tipo Tab, nesse caso o tabKey e o índice serão respeitados.
+          * Define o nome das abas do componente. Podendo serem separadas por vírgula "," ou em um Array de configuração.
          */
         "tabs"?: string | Array<Tab>;
     }
     interface EzTextArea {
         /**
-          * Permite exibir a mensagem de erro.
+          * Se false deixa de exibir a mensagem de erro dentro do campo.
          */
         "canShowError"?: boolean;
         /**
-          * Deixa o campo disponível ou não para digitação.
+          * Se false o usuário não pode interagir com o campo.
          */
         "enabled"?: boolean;
         /**
-          * Quando há um problema de validação, serve como orientação ao usuário
+          * Define uma mensagem de orientação ao usuário, colocando o campo em modo inválido.
          */
         "errorMessage"?: string;
         /**
-          * Título do campo
+          * Texto a ser apresentado como título do campo.
          */
         "label"?: string;
         /**
-          * Deixa o componente em modo "carregando".
+          * Define o tamanho do campo.
          */
-        "loading"?: boolean;
+        "mode"?: "slim" | "regular";
         /**
-          * Define o modo do tamanho do campo; opções: slim e regular.
-         */
-        "mode"?: string;
-        /**
-          * Evento disparado quando o estado do componente é alterado (onEzChange).
+          * Emitido quando acontece a alteração de valor do campo.
          */
         "onEzChange"?: (event: CustomEvent<string>) => void;
         /**
-          * Ajusta o número de linhas e consequentemente o height do textarea. Valor default: 4
+          * Define o número de linhas.
          */
         "rows"?: number;
         /**
-          * Valor digitado pelo usuário. Este valor é o que fica visível no campo.
+          * Define o valor do campo.
          */
         "value"?: string;
     }
     interface EzTextEdit {
         /**
-          * Disparado ao cancelar uma edição
+          * Emitido ao cancelar uma edição
          */
         "onCancelEdition"?: (event: CustomEvent<any>) => void;
         /**
-          * Evento emitido ao salvar uma edição
+          * Emitido ao salvar uma edição
          */
         "onSaveEdition"?: (event: CustomEvent<any>) => void;
         /**
-          * Define atributos do estilo
+          * Define atributos do estilo.
          */
         "styled"?: IStyled;
         /**
-          * Valor manipulado pelo componente através do input
+          * Define o valor do campo.
          */
         "value"?: string;
     }
     interface EzTextInput {
         /**
-          * Permite exibir a mensagem de erro.
+          * Se false deixa de exibir a mensagem de erro dentro do campo.
          */
         "canShowError"?: boolean;
         /**
-          * Deixa o campo disponível ou não para digitação.
+          * Se false o usuário não pode interagir com o campo.
          */
         "enabled"?: boolean;
         /**
-          * Quando há um problema de validação, serve como orientação ao usuário
+          * Define uma mensagem de orientação ao usuário, colocando o campo em modo inválido.
          */
         "errorMessage"?: string;
         /**
-          * Título do campo
+          * Texto a ser apresentado como título do campo.
          */
         "label"?: string;
-        /**
-          * Deixa o componente em modo "carregando".
-         */
-        "loading"?: boolean;
         /**
           * Aplica uma máscara no conteúdo conforme o padrão estabelecido
          */
         "mask"?: string;
         /**
-          * Define o modo do tamanho do campo; opções: slim e regular.
+          * Define o tamanho do campo.
          */
-        "mode"?: string;
+        "mode"?: "slim" | "regular";
         /**
-          * Define se o campo contará com bordas ou não
+          * Se true o campo não terá bordas.
          */
         "noBorder"?: boolean;
         /**
-          * Evento disparado quando o estado do componente é alterado (onEzChange).
+          * Emitido quando acontece a alteração de valor do campo.
          */
         "onEzChange"?: (event: CustomEvent<string>) => void;
         /**
-          * Restringe o que o usuário pode digitar. Cada caractere digitado será testado e deve estar contido nessa string ou será descartado.
+          * Restringe o que o usuário pode digitar.
          */
         "restrict"?: string;
         /**
-          * Valor digitado pelo usuário. Este valor é o que fica visível no campo.
+          * Define o valor do campo.
          */
         "value"?: string;
     }
     interface EzTimeInput {
         /**
-          * Deixa o campo disponível ou não para digitação.
+          * Se false o usuário não pode interagir com o campo.
          */
         "enabled"?: boolean;
         /**
-          * Quando há um problema de validação, serve como orientação ao usuário.
+          * Define uma mensagem de orientação ao usuário, colocando o campo em modo inválido.
          */
         "errorMessage"?: string;
         /**
-          * Título do campo
+          * Texto a ser apresentado como título do campo.
          */
         "label"?: string;
         /**
-          * Define o modo do tamanho do campo; opções: slim e regular.
+          * Define o tamanho do campo.
          */
-        "mode"?: string;
+        "mode"?: "slim" | "regular";
         /**
-          * Entre o evento ezStartChange e ezChange, se por algum motivo não foi possível completar a alteração, esse evento é disparado.
+          * Emitido quando não foi possível completar a alteração entre o evento ezStartChange e ezChange.
          */
         "onEzCancelWaitingChange"?: (event: CustomEvent<void>) => void;
         /**
-          * Evento disparado quando o estado do componente é alterado (onEzChange).
+          * Emitido quando acontece a alteração de valor do campo.
          */
         "onEzChange"?: (event: CustomEvent<number>) => void;
         /**
-          * Evento emitido ao iniciar a alteração (remover ou adicionar um arquivo).
+          * Emitido ao iniciar a alteração (digitação incompleta).
          */
         "onEzStartChange"?: (event: CustomEvent<WaitingChange>) => void;
         /**
-          * Define se o componente irá ou não considerar os segundos.
+          * Se true considera segundos.
          */
         "showSeconds"?: boolean;
         /**
-          * Valor que será transmitido para o back-end.
+          * Define o valor do campo.
          */
         "value"?: number;
     }
     interface EzToast {
         /**
-          * Controla o uso do icone de fechar o toast.
+          * Se false, o usuário não consegue fechar.
          */
         "canClose"?: boolean;
         /**
-          * Controla o tempo de exibição do componente em milissegundos.
+          * Define o tempo de exibição em milissegundos.
          */
         "fadeTime"?: number;
         /**
-          * Mensagem exibida no componente.
+          * Mensagem a ser exibida no componente.
          */
         "message"?: string;
         /**
-          * Adiciona ícone de check no componente.
+          * Se true permite a utilização do slot de ícone.
          */
         "useIcon"?: boolean;
     }
     interface EzUpload {
         /**
-          * Deixa o campo disponível ou não para digitação.
+          * Se false o usuário não pode interagir com o campo.
          */
         "enabled"?: boolean;
         /**
-          * Título do campo
+          * Texto a ser apresentado como título do campo.
          */
         "label"?: string;
         /**
@@ -2278,15 +2263,15 @@ declare namespace LocalJSX {
          */
         "maxFiles"?: number;
         /**
-          * Entre o evento ezStartChange e ezChange, se por algum motivo não foi possível completar a alteração, esse evento é disparado.
+          * Emitido quando não foi possível completar a alteração entre o evento ezStartChange e ezChange.
          */
         "onEzCancelWaitingChange"?: (event: CustomEvent<void>) => void;
         /**
-          * Evento emitido ao finalizar o upload de um arquivo (onEzChange).
+          * Emitido quando acontece a alteração de valor do campo.
          */
         "onEzChange"?: (event: CustomEvent<Array<EzFile>>) => void;
         /**
-          * Evento emitido ao iniciar a alteração (remover ou adicionar um arquivo).
+          * Emitido ao iniciar a alteração (remover ou adicionar um arquivo).
          */
         "onEzStartChange"?: (event: CustomEvent<WaitingChange>) => void;
         /**
@@ -2302,7 +2287,7 @@ declare namespace LocalJSX {
          */
         "urlUpload"?: string;
         /**
-          * Lista de arquivos que será trafegada entre cliente e servidor
+          * Define o valor do campo.
          */
         "value"?: Array<EzFile>;
     }