@sankhyalabs/sankhyablocks 9.1.13 → 9.2.0-dev.1

package/dist/types/components.d.ts

@@ -22,7 +22,7 @@ import { IClientEventResponse } from "./lib/http/data-fetcher/interfaces/IClient
 import { IDataFetcherRecaller } from "./lib/http/data-fetcher/recaller/IDataFetcherRecaller";
 import { DialogType, FormLayout, MessageOptions } from "@sankhyalabs/ezui/dist/collection/utils";
 import { IOption as IOption1, ISearchArgument } from "@sankhyalabs/ezui/dist/types/components/ez-search/ez-search";
-import { ISearchCtxOptions } from "./components/snk-application/snk-application";
+import { IPreparedSearchOptions, ISearchCtxOptions } from "./components/snk-application/snk-application";
 import { IRemoveSearchListener, ISearchListener, SearchCriteria } from "./lib/http/data-fetcher/fetchers/pesquisa-fetcher";
 import { SIMPLE_CRUD_MODE, TEMPLATES_SKELETON, VIEW_MODE } from "./lib/utils/constants";
 import { TFetcherType } from "./components/snk-attach/interfaces/TFetcherType";
@@ -52,7 +52,6 @@ import { IExportConfig } from "./components/snk-data-exporter/data/export-config
 import { IExpressionGroup, IExpressionItem } from "./components/snk-personalized-filter/interfaces/IExpressionItem";
 import { IPersonalizedFilter } from "./components/snk-personalized-filter/interfaces/IPersonalizedFilter";
 import { SnkApplication } from "./components/snk-application/snk-application";
-import { Filter as Filter1 } from "@sankhyalabs/core/dist/dataunit/metadata/UnitMetadata";
 import { SnkFilterModalFactoryParams } from "./components/snk-filter-bar/utils/SnkFilterModalFactory";
 import { EPresentationMode } from "./components/snk-filter-bar/filter-item/editors/enum/presentationMode";
 import { FilterFieldsDataSource, IFilterField, IFilterLink } from "./components/snk-filter-field-search/interfaces";
@@ -106,6 +105,7 @@ export namespace Components {
     interface FieldsSelector {
         "availableFields": IFieldConfig[];
         "dataUnit"?: DataUnit;
+        "messagesBuilder": SnkMessageBuilder;
     }
     interface GuidesConfigurator {
         "guidesList": IGuideConfig[];
@@ -148,6 +148,10 @@ export namespace Components {
           * Argumentos que serão usados ao chamar a função treeLoader.
          */
         "argument": string;
+        /**
+          * Responsável por flexibilizar e padronizar o uso de mensagens nos blocos de construção.
+         */
+        "messagesBuilder": SnkMessageBuilder;
         /**
           * Informa se a árvore hierárquica deve ou não ser carregada.
          */
@@ -287,16 +291,11 @@ export namespace Components {
           * @returns Uma lista de opções ou uma única opção.
           * @async
          */
-        "executePreparedSearch": (mode: string, argument: string, options: any) => Promise<Array<IOption1> | IOption1>;
+        "executePreparedSearch": (mode: string, argument: string, options: IPreparedSearchOptions) => Promise<Array<IOption1> | IOption1>;
         /**
           * Realiza a pesquisa de registros Ex.: snk-config-options
-          * @param mode - O modo da pesquisa ("ADVANCED" ou outro).
-          * @param argument - O argumento da pesquisa.
-          * @param options - Opções preparadas para a pesquisa.
-          * @returns Uma lista de opções ou uma única opção.
-          * @async
          */
-        "executePreparedSearchPlus": (mode: string, argument: string, options: any) => Promise<Array<IOption1> | IOption1>;
+        "executePreparedSearchPlus": (mode: string, argument: string, options: IPreparedSearchOptions) => Promise<Array<IOption1> | IOption1>;
         /**
           * Obtém as opções em componentes de pesquisa. Ex.: snk-config-options
           * @param searchArgument - Argumentos da pesquisa.
@@ -474,6 +473,10 @@ export namespace Components {
           * Obtém `true` caso a tela esteja em modo de debug.
          */
         "isDebugMode": () => Promise<boolean>;
+        /**
+          * Retorna se uma feature flag global está ativa ou não.
+         */
+        "isFeatureActive": (featureName: string) => Promise<boolean>;
         /**
           * Obtém a informação se o último carregamento do dataunit foi feito através de um loadByPk.
           * @returns `true` se foi carregado por PK, `false` caso contrário.
@@ -647,6 +650,10 @@ export namespace Components {
           * FetcherType define o tipo de fetcher responsável por carregar os dados do DataUnit.
          */
         "fetcherType": TFetcherType;
+        /**
+          * Chave da configuração legado da grid.
+         */
+        "gridLegacyConfigName": string;
         /**
           * Responsável por flexibilizar e padronizar o uso de mensagens nos blocos de construção.
          */
@@ -889,102 +896,75 @@ export namespace Components {
     interface SnkDataUnit {
         /**
           * Executado após a ação de salvar.
-          * @param dataUnit - A instância do DataUnit.
-          * @returns
          */
         "afterSave": (dataUnit: DataUnit) => void;
         /**
           * Executado imediatamente antes da ação de salvar as alterações. Útil no caso de validações por exemplo. Caso retorne "false" (ou a promessa se resolva como false), cancela a ação.
-          * @param dataUnit - A instância do DataUnit.
-          * @returns `false` para cancelar a ação, `true` para continuar.
          */
         "beforeSave": (dataUnit: DataUnit) => boolean | Promise<boolean>;
         /**
           * Usado para obter configuração de metadados.
-          * @type {string}
          */
         "configName": string;
         /**
           * Controla o estado atual dos dados.
-          * @type {DataState}
          */
         "dataState": DataState;
         /**
           * Uma vez instanciado, pode-se obter o dataUnit por esta propriedade.
-          * @type {DataUnit}
          */
         "dataUnit": DataUnit;
         /**
           * Usado para criar o dataUnit uma única vez. Se omitido, será usado o próprio nome da entidade.
-          * @type {string}
          */
         "dataUnitName": string;
         /**
           * Define a chave customizada para sobrescrever as mensagens (Não pegando pela entidade)
-          * @type {string}
          */
         "domainMessagesBuilder": string;
         /**
           * Determina qual a entidade que representa os dados em questão.
-          * @type {string}
          */
         "entityName": string;
         /**
           * Obtém o dataUnit.
-          * @returns Uma promessa que resolve com a instância do DataUnit.
-          * @async
          */
         "getDataUnit": () => Promise<DataUnit>;
         /**
           * Retorna os campos que possuem a propriedade "rm_precision" (Row Metadata Precision).
-          * @returns Uma promessa que resolve com um array de nomes de campos.
-          * @async
          */
         "getFieldsWithRmPrecision": () => Promise<string[]>;
         /**
           * Retorna os campos que possuem a propriedade "rmp" (Row Metadata Provider).
-          * @returns Uma promessa que resolve com um array de nomes de campos.
-          * @async
          */
         "getFieldsWithRmp": () => Promise<string[]>;
         /**
           * Busca os metadados da linha selecionada.
-          * @param record - O registro ou ID do registro para o qual buscar os metadados. Se omitido, usa o registro selecionado.
-          * @returns Uma promessa que resolve com os metadados da linha.
-          * @async
          */
         "getRowMetadata": (record?: Record | string) => Promise<RowMetadata>;
         /**
           * Método que retorna a lista de IDs dos registros selecionados.
-          * @returns Retorna uma promessa que resolve com a lista de IDs dos registros selecionados.
-          * @async
+          * @returns Retorna a lista de IDs dos registros selecionados.
          */
         "getSelectedRecordsIDsInfo": () => Promise<Array<IRecordID>>;
         /**
           * Responsável por evitar a mensagem de sucesso ao salvar.
-          * @type {boolean}
          */
         "ignoreSaveMessage": boolean;
         /**
           * Responsável por flexibilizar e padronizar o uso de mensagens nos blocos de construção.
-          * @type {SnkMessageBuilder}
          */
         "messagesBuilder": SnkMessageBuilder;
         /**
           * Determina quantas linhas são retornadas por página.
-          * @type {number}
-          * @default 150
          */
         "pageSize": number;
         /**
           * Identificador de recursos como configurações e acesso.
-          * @type {string}
          */
         "resourceID": string;
         /**
           * Determina se será usado mensagem de confirmação padrão na tentativa de cancelar a edição.
-          * @type {boolean}
-          * @default true
          */
         "useCancelConfirm": boolean;
     }
@@ -1187,99 +1167,83 @@ export namespace Components {
     }
     interface SnkFilterBar {
         /**
-          * @description Adiciona um item de filtro.
-          * @async 
-          * @param filterItem - Item a ser adicionado, caso o item já exista com o ID, ele não será adicionado novamente.
-          * @return Retorna uma Promise que resolve quando o item for adicionado.
+          * Adiciona um item de filtro.
+          * @param filterItem - Item a ser adicionado, caso o item já exista com o ID ele não será adicionado novamente
          */
         "addFilterItem": (filterItem: SnkFilterItemConfig) => Promise<void>;
         /**
-          * @description Função chamada depois de aplicar os filtros.
+          * Função chamada depois de aplicar os filtros.
          */
         "afterApplyConfig"?: () => void;
         /**
-          * @description Define se a carga dos dados será feita assim que o componente for carregado.
+          * Define se a carga dos dados será feita assim que o componente for carregado.
          */
         "autoLoad"?: boolean;
         /**
-          * @description Eventualmente poderemos ter mais de uma barra de filtros. Essa propriedade serve para separar a configuração de cada uma.
+          * Eventualmente poderemos ter mais de uma barra de filtros. Essa propriedade serve para separar a configuração de cada uma.
          */
         "configName": string;
         /**
-          * @description Loader customizado para carregar as configurações.
-          * @param configName - Nome da configuração.
-          * @param resourceId - ID do recurso.
-          * @param options - Opções adicionais.
-          * @returns Retorna a configuração dos filtros.
+          * Loader customizado para carregar as configurações
          */
         "customFilterBarConfig"?: (configName: string, resourceId: string, options: any) => Promise<Array<SnkFilterItemConfig>>;
         /**
-          * @description Recebe o DataUnit do ambiente. Se não for informado, procura pela referência do SnkDataUnit. Necessário para se registrar como provedor de filtros.
+          * Recebe o DataUnit do ambiente. Se não for informado, procura pela referência do SnkDataUnit. Necessário para se registrar como provedor de filtros.
          */
         "dataUnit": DataUnit;
         /**
-          * @description Desabilita a apresentação da opção de filtros personalizados na filter bar (chip de filtros) e no modal lateral de filtros (container de filtros personalizados).
+          * Desabilita a apresentação da opção de filtros personalizados na filter bar (chip de filtros) e no modal lateral de filtros (container de filtros personalizados).
          */
         "disablePersonalizedFilter": boolean;
         /**
-          * @description Define se o componente deve usar o LockManager para controle de carregamento.
+          * Define se o componente deve usar o LockManager para controle de carregamento
          */
         "enableLockManagerLoadingComp"?: boolean;
         /**
-          * @description Chave da configuração legada da barra de filtros.
+          * Chave da configuração legado da barra de filtros.
          */
         "filterBarLegacyConfigName": string;
         /**
-          * @description Lista todos os filtros disponíveis ao usuário.
+          * Lista todos os filtros disponíveis ao usuário.
          */
         "filterConfig": Array<SnkFilterItemConfig>;
         /**
-          * @description Retorna um item de filtro pelo ID.
-          * @async 
-          * @param id - ID do item de filtro.
-          * @returns O item de filtro correspondente ou undefined se não for encontrado.
+          * Retorna um item de filtro pelo ID.
          */
         "getFilterItem": (id: string) => Promise<SnkFilterItemConfig | undefined>;
-        "getFilters": () => Promise<Filter1[]>;
         /**
-          * @description Responsável por flexibilizar e padronizar o uso de mensagens nos blocos de construção.
+          * Responsável por flexibilizar e padronizar o uso de mensagens nos blocos de construção.
          */
         "messagesBuilder": SnkMessageBuilder;
         /**
-          * @description Modo de apresentação da barra de filtros.
+          * Modo de apresentação da filterbar.
          */
         "mode": "regular" | "button" | "hidden";
         /**
-          * @description Faz o recarregamento da barra de filtros buscando o state no servidor.
-          * @async 
-          * @return Retorna uma Promise que resolve quando o recarregamento for concluído.
+          * Faz o recarregamento da filterbar buscando o state no servidor.
          */
         "reload": () => Promise<void>;
         /**
-          * @description Remove um item de filtro.
-          * @async 
-          * @param filterID - ID do item a ser removido.
-          * @returns Retorna o item de filtro removido, ou undefined caso não seja encontrado.
+          * Remove um item de filtro.
+          * @param filterID - ID do a ser adicionado
+          * @returns - Retorna o item de filtro removido, ou undefined caso não encontrado.
          */
         "removeFilterItem": (filterID: string) => Promise<SnkFilterItemConfig | undefined>;
         /**
-          * @description Identificador de recursos como configurações e acesso.
+          * Identificador de recursos como configurações e acesso.
          */
         "resourceID": string;
         /**
-          * @description Abre o modal de filtros.
-          * @async
+          * Abre o modal de filtros
          */
         "showFilterModal": () => Promise<void>;
         /**
-          * @description Título que será apresentado na barra de filtros.
+          * Título que será apresentado na barra de filtros
          */
         "title": string;
         /**
-          * @description Atualiza um item do filtro.
-          * @async 
-          * @param newFilterItem - Item com as informações atualizadas, caso o item não seja encontrado no array, ele não será modificado.
-          * @return Retorna uma Promise que resolve quando a atualização for concluída.
+          * Atualiza um item do filtro.
+          * @param filterItem - Item com as informações atualizadas, caso o item não seja encontrado no array ele mão será modificado
          */
         "updateFilterItem": (newFilterItem: SnkFilterItemConfig) => Promise<void>;
     }
@@ -1558,11 +1522,7 @@ export namespace Components {
     }
     interface SnkForm {
         /**
-          * Registra um editor customizado para campos do formulário.
-          * @async 
-          * @param fieldName - Nome do campo.
-          * @param customEditor - Editor customizado.
-          * @returns
+          * Registra um editor customizado para campos da grade e formulário.
          */
         "addCustomEditor": (fieldName: string, customEditor: ICustomEditor) => Promise<void>;
         /**
@@ -1570,13 +1530,11 @@ export namespace Components {
          */
         "configName": string;
         /**
-          * Chave da configuração legada do formulário.
+          * Chave da configuração legado do formulário.
          */
         "formLegacyConfigName": string;
         /**
           * Fecha a janela de configurações do formulário.
-          * @async 
-          * @returns
          */
         "hideConfig": () => Promise<void>;
         /**
@@ -1593,26 +1551,12 @@ export namespace Components {
         "resourceID": string;
         /**
           * Altera/adiciona uma propriedade nos metadados do campo.
-          * @async 
-          * @param fieldName - Nome do campo.
-          * @param propName - Nome da propriedade.
-          * @param value - Valor da propriedade.
-          * @returns
          */
         "setFieldProp": (fieldName: string, propName: string, value: any) => Promise<void>;
         /**
           * Exibe a janela de configurações do formulário.
-          * @async 
-          * @returns
          */
         "showConfig": () => Promise<void>;
-        /**
-          * Valida o formulário.
-          * @async 
-          * @returns 
-          * @description Este método executa a validação do formulário, verificando se todos os campos estão  preenchidos corretamente de acordo com as regras definidas. Se a validação falhar, uma exceção será lançada com os detalhes dos erros encontrados. Caso contrário, o método será resolvido sem erros.
-         */
-        "validate": () => Promise<void>;
     }
     interface SnkFormConfig {
         /**
@@ -1724,72 +1668,52 @@ export namespace Components {
     }
     interface SnkGrid {
         /**
-          * Lista de ações que devem ser usadas no botão "Mais opções" do `snk-taskbar`.
+          * Lista de ações que devem ser usadas no botão "Mais opções" do componente snk-taskbar.
          */
         "actionsList": Array<Action>;
         /**
-          * Registra um editor customizado para um campo da grade ou formulário.
-          * @async 
-          * @description Adiciona um componente de edição personalizado para um campo específico. Este editor será usado tanto na edição em linha na grade quanto em formulários de detalhe.
-          * @param fieldName O nome do campo que receberá o editor customizado.
-          * @param customEditor A instância do editor customizado.
-          * @param detailContext O contexto de detalhe onde o editor será aplicado (opcional).
-          * @returns Uma promessa que é resolvida quando o editor é registrado.
+          * Registra um editor customizado para campos da grade e formulário
          */
         "addCustomEditor": (fieldName: string, customEditor: ICustomEditor, detailContext?: string) => Promise<void>;
         /**
-          * Registra um formatador de valor customizado para uma coluna da grade.
-          * @async 
-          * @description Adiciona uma função de formatação personalizada para os valores de uma coluna específica, afetando como os dados são exibidos.
-          * @param columnName O nome da coluna que receberá o formatador.
-          * @param customFormatter A instância do formatador de valor.
-          * @returns Uma promessa que é resolvida quando o formatador é registrado.
+          * Registra um formatador de valores para uma coluna da grid.
          */
         "addCustomValueFormatter": (columnName: string, customFormatter: ICustomFormatter) => Promise<void>;
         /**
-          * Registra um renderizador customizado para uma coluna da grade.
-          * @async 
-          * @description Adiciona um componente de renderização personalizado para uma coluna específica, permitindo a exibição de conteúdo customizado nas células.
-          * @param fieldName O nome do campo (coluna) que receberá o renderizador customizado.
-          * @param customRender A instância do renderizador customizado.
-          * @param detailContext O contexto de detalhe onde o renderizador será aplicado (opcional).
-          * @returns Uma promessa que é resolvida quando o renderizador é registrado.
+          * Registra um render customizado para colunas da grid.
          */
         "addGridCustomRender": (fieldName: string, customRender: ICustomRender, detailContext?: string) => Promise<void>;
         /**
-          * Define se a grade receberá o foco automaticamente ao ser carregada.
+          * Define se a grid será focada ao ser carregada.
          */
         "autoFocus"?: boolean;
         /**
-          * Define se os dados serão carregados automaticamente na inicialização do componente.
+          * Define se a carga dos dados será feita assim que o componente for carregado.
          */
         "autoLoad"?: boolean;
         /**
-          * Define se a edição de dados na grade está habilitada.
+          * Define se a edição está habilitada na grid.
          */
         "canEdit": boolean;
-        /**
-          * Define o data source para o filtro de colunas.
-         */
         "columnFilterDataSource": IMultiSelectionListDataSource;
         /**
-          * Define se a grade deve ser exibida em modo compacto.
+          * Define se a grade deve ser exibida em modo compacto
          */
         "compact": boolean;
         /**
-          * Nome usado para salvar e recuperar a configuração da grade.
+          * Nome usado para salvar/recuperar a configuração.
          */
         "configName": string;
         /**
-          * Desabilita a apresentação da opção de filtros personalizados na barra de filtros (chip de filtros) e no modal lateral de filtros (contêiner de filtros personalizados).
+          * Desabilita a apresentação da opção de filtros personalizados na filter bar (chip de filtros) e no modal lateral de filtros (container de filtros personalizados).
          */
         "disablePersonalizedFilter": boolean;
         /**
-          * Habilita a inserção de registros diretamente na grade.
+          * Ativa inserção de registros no modo grade.
          */
         "enableGridInsert"?: boolean;
         /**
-          * Define se o componente deve usar o LockManager para controle de carregamento da aplicação.
+          * Define se o componente deve usar o LockManager para controle de carregamento da aplicação
          */
         "enableLockManagerLoadingComp"?: boolean;
         /**
@@ -1797,37 +1721,31 @@ export namespace Components {
          */
         "enableLockManagerTaskbarClick"?: boolean;
         /**
-          * Chave da configuração legada da barra de filtros.
+          * Chave da configuração legado da barra de filtros.
          */
         "filterBarLegacyConfigName": string;
         /**
-          * Título que será apresentado na barra de filtros.
+          * Título que será apresentado na barra de filtros
          */
         "filterBarTitle": string;
         /**
-          * Retorna o elemento da barra de filtros da grade.
-          * @async 
-          * @description Este método permite acessar o elemento da barra de filtros, que pode ser útil para manipulações adicionais ou para obter o estado atual dos filtros aplicados.
-          * @returns O elemento da barra de filtros.
+          * Retorna o elemento da filter-bar da grade.
          */
         "getFilterBar": () => Promise<HTMLSnkFilterBarElement>;
         /**
-          * Define o nome do slot para elementos customizados na `Taskbar` do cabeçalho da grade.
+          * Nome do slot de elementos customizados da Taskbar do cabeçalho da grade.
          */
         "gridHeaderCustomSlotId": string;
         /**
-          * Chave da configuração legada da grade.
+          * Chave da configuração legado da grade.
          */
         "gridLegacyConfigName": string;
         /**
           * Fecha a janela de configurações da grade.
-          * @async 
-          * @description Este método fecha o pop-up de configuração de colunas da grade.
-          * @returns Uma promessa que é resolvida quando a janela de configuração é fechada.
          */
         "hideConfig": () => Promise<void>;
         /**
-          * Determina se a grade está vinculada a um detalhe de outra tela.
+          * Determina se a grade está vinculada a um detalhe.
          */
         "isDetail": boolean;
         /**
@@ -1835,119 +1753,92 @@ export namespace Components {
          */
         "messagesBuilder": SnkMessageBuilder;
         /**
-          * Habilita a edição de múltiplos registros simultaneamente.
+          * Habilita a edição de múltiplos registros simultâneos.
          */
         "multipleEditionEnabled": boolean;
         /**
-          * Determina se a seleção de múltiplas linhas é permitida.
+          * Determina se pode haver mais de uma linha selecionada.
          */
         "multipleSelection": boolean;
         /**
-          * Altera a aparência das bordas e sombras do componente. Se `false`, aplica o padrão de sombras (ideal para o elemento principal do layout). Se `true`, aplica um contorno (ideal para quando o componente está dentro de outro, como um painel ou pop-up).
+          * Altera visualmente as sombras e bordas do componente Quando false, aplica o padrão de sombras ao componente (Utilizar quando for o elemento principal do layout) Quando true, aplica o padrão de outline ao componente (Utilizar quando estiver contido em outro elemento como um painel ou pop-up)
          */
         "outlineMode"?: boolean;
         /**
-          * Define o modo de exibição do contador de paginação.
+          * Define se a grid será focada ao ser carregada.
          */
         "paginationCounterMode"?: 'show' | 'hidden' | 'auto';
         /**
-          * Altera o modo de apresentação dos botões do `snk-taskbar`.
+          * Altera o modo de apresentação dos botões do snk-taskbar.
          */
         "presentationMode": PresentationMode1;
         /**
-          * Validador responsável por verificar a integridade dos dados de um registro.
+          * Validador responsável por checar a integridade das informações do registro.
          */
         "recordsValidator": IRecordValidator;
-        "refreshColumnFilterDataSource": () => Promise<void>;
-        /**
-          * Recarrega a configuração da grade.
-          * @description Este método força o recarregamento da configuração da grade a partir do `ConfigStorage`. A operação é assíncrona, mas o método não aguarda sua conclusão.
-         */
         "reloadConfig": () => Promise<void>;
         /**
-          * Recarrega a barra de filtros da grade, buscando o estado do servidor.
-          * @async 
-          * @description Força o recarregamento da barra de filtros, atualizando suas configurações e filtros a partir do servidor.
-          * @returns Uma promessa que é resolvida quando a barra de filtros é recarregada.
+          * Faz o recarregamento da filter-bar da grade buscando o state no servidor.
          */
         "reloadFilterBar": () => Promise<void>;
         /**
-          * Remove um formatador de valor customizado de uma coluna da grade.
-          * @async 
-          * @description Remove uma função de formatação personalizada previamente registrada para uma coluna.
-          * @param columnName O nome da coluna da qual o formatador será removido.
-          * @returns Uma promessa que é resolvida quando o formatador é removido.
+          * Remove o formatador de valores de uma coluna da grid.
          */
         "removeCustomValueFormatter": (columnName: string) => Promise<void>;
         /**
-          * Identificador de recursos, como configurações e permissões de acesso.
+          * Identificador de recursos como configurações e acesso.
          */
         "resourceID": string;
         /**
-          * Configuração do toast de seleção da grade.
+          * Configuração da seleção de grade no toast.
          */
         "selectionToastConfig": ISelectionToastConfig;
         /**
-          * Define a configuração da grade.
-          * @async 
-          * @description Aplica uma nova configuração de colunas e ordenação à grade.
-          * @param config O objeto de configuração a ser aplicado na grade.
-          * @returns Uma promessa que é resolvida quando a configuração é aplicada.
+          * Atribui o valor da configuração da grade.
          */
         "setConfig": (config: IGridConfig) => Promise<void>;
         /**
           * Atribui o foco para a grade.
-          * @async 
-          * @description Move o foco do navegador para o componente da grade, permitindo a navegação por teclado.
-          * @returns Uma promessa que é resolvida quando o foco é atribuído.
          */
         "setFocus": () => Promise<void>;
         /**
           * Exibe a janela de configurações da grade.
-          * @async 
-          * @description Este método abre o pop-up de configuração de colunas da grade, permitindo ao usuário ajustar a visibilidade, ordem e largura das colunas.
-          * @returns Uma promessa que é resolvida quando a janela de configuração é exibida.
          */
         "showConfig": () => Promise<void>;
         /**
-          * Define a configuração de cores para a coluna de status.
-          * @example ```json '{ "RECDESP": { "-1" : "#BD0025", "1" : "#157A00" } }' ```
+          * Configuração do valor da coluna de status. Exemplo: '{ "RECDESP": { "-1" : "#BD0025", "1" : "#157A00" } }'
          */
         "statusResolver": IStatusResolver | StatusResolverFunction;
         /**
-          * Define o modo de exportação dos dados.
+          * Modo de exportação dos dados.
          */
         "strategyExporter": IExporterStrategyMode;
         /**
-          * Informa se a coluna de checkbox deve ser suprimida.
+          * Informa se a coluna de chechbox deve ser suprimida
          */
         "suppressCheckboxColumn": boolean;
         /**
-          * Informa se a grade deve suprimir o filtro de coluna.
-         */
-        "suppressFilterColumn"?: boolean;
-        /**
-          * Define se a grade deve suprimir a barra de rolagem horizontal.
+          * Define se a grade deve suprimir o scroll horizontal.
          */
         "suppressHorizontalScroll": boolean;
         /**
-          * Define o identificador do contêiner de elementos customizados da `Taskbar`.
+          * Define o identificador do container de elementos customizados da Taskbar.
          */
         "taskbarCustomContainerId": string;
         /**
-          * Gerenciador das barras de tarefas. Permite determinar botões específicos ou gerenciar o estado dos botões.
+          * Gerenciador das barras de tarefas. É possível determinar botões específicos ou mesmo gerenciar o estado dos botões.
          */
         "taskbarManager": TaskbarManager;
         /**
-          * Define o nome do slot para elementos customizados na `Taskbar` principal do componente.
+          * Nome do slot de elementos customizados da Taskbar principal do componente.
          */
         "topTaskbarCustomSlotId": string;
         /**
-          * Quando `true`, a tecla ENTER navega entre as células como a tecla TAB.
+          * Quando verdadeiro, o ENTER fará a navegação como se fosse a tecla TAB na grade.
          */
         "useEnterLikeTab": boolean;
         /**
-          * Define se a grade deve exibir um buscador de colunas ao pressionar `Ctrl+F`.
+          * Define se a grade deve exibir um buscador de coluna com uso do Ctrl+F
          */
         "useSearchColumn": boolean;
     }
@@ -2069,6 +1960,7 @@ export namespace Components {
         "taskbarManager": TaskbarManager;
     }
     interface SnkLayoutFormConfig {
+        "messagesBuilder": SnkMessageBuilder;
         /**
           * Salva o tipo de layout escolhido. Sem retorno.
          */
@@ -2076,40 +1968,28 @@ export namespace Components {
     }
     interface SnkPersonalizedFilter {
         /**
-          * Nome da configuração, utilizado para distinguir múltiplas instâncias do componente.
-          * @property
+          * Nome da configuração. Serve para distinguir várias instâncias do componente.
          */
         "configName": string;
-        /**
-          * Cria um novo filtro personalizado caso não exista nenhum.
-          * @method 
-          * @returns
-         */
         "createPersonalizedFilter": () => Promise<void>;
         /**
-          * URI da entidade utilizada para buscar os campos disponíveis para filtro.
-          * @property
+          * Responsável por receber a URI da entidade.
          */
         "entityUri": string;
         /**
-          * Identificador do filtro a ser carregado.
-          * @property
+          * Id do filtro que será carregado.
          */
         "filterId": string;
         /**
-          * Indica se o filtro é o filtro padrão do sistema.
-          * @property 
-          * @default false
+          * Define se o filtro em questão é um filtro padrão.
          */
         "isDefaultFilter": boolean;
         /**
           * Responsável por flexibilizar e padronizar o uso de mensagens nos blocos de construção.
-          * @property
          */
         "messagesBuilder": SnkMessageBuilder;
         /**
-          * Identificador do recurso utilizado para salvar e recuperar filtros.
-          * @property
+          * Nome da configuração. Serve para distinguir várias instâncias do componente.
          */
         "resourceID": string;
     }
@@ -2169,6 +2049,10 @@ export namespace Components {
         "openPrintSelector": (printJobData: PendingPrintJobData) => Promise<PrintSelectorResponse>;
     }
     interface SnkSelectBox {
+        /**
+          * Se true, impede que o campo de texto receba foco automaticamente ao abrir as opções.
+         */
+        "preventAutoFocus": boolean;
         /**
           * Determina a opção selecionada.
          */
@@ -2176,11 +2060,11 @@ export namespace Components {
     }
     interface SnkSimpleBar {
         /**
-          * Define os itens que serão apresentados no breadcrumb.
+          * Define os itens que serão apresentados pelo breadcrumb
          */
         "breadcrumbItens": Array<IBreadcrumbItem>;
         /**
-          * Define o título do header.
+          * Define o título do header
          */
         "label": string;
         /**
@@ -2190,196 +2074,138 @@ export namespace Components {
     }
     interface SnkSimpleCrud {
         /**
-          * @description Ações a serem colocadas no botão "Mais opções" do componente snk-taskbar.
+          * Ações a serem colocadas no botão "Mais opções" do componente snk-taskbar.
          */
         "actionsList": Array<Action>;
         /**
-          * @description Registra um editor customizado para campos da grade e do formulário.
-          * @param fieldName - O nome do campo.
-          * @param customEditor - A instância do editor customizado.
-          * @returns
+          * Registra um editor customizado para campos da grade e formulário.
          */
         "addCustomEditor": (fieldName: string, customEditor: ICustomEditor) => Promise<void>;
         /**
-          * @description Registra um formatador de valores para uma coluna da grade.
-          * @param columnName - O nome da coluna.
-          * @param customFormatter - A instância do formatador customizado.
-          * @returns
+          * Registra um formatador de valores para uma coluna da grid.
          */
         "addCustomValueFormatter": (columnName: string, customFormatter: ICustomFormatter) => Promise<void>;
         /**
-          * @description Registra um renderizador customizado para colunas da grade.
-          * @param fieldName - O nome do campo.
-          * @param customRender - A instância do renderizador customizado.
-          * @returns
+          * Registra um render customizado para colunas da grid.
          */
         "addGridCustomRender": (fieldName: string, customRender: ICustomRender) => Promise<void>;
         /**
-          * @description Define se a grade será focada ao ser carregada.
+          * Define se a grid será focada ao ser carregada.
          */
         "autoFocus"?: boolean;
         /**
-          * @description Define se a carga dos dados será feita assim que o componente for carregado.
+          * Define se a carga dos dados será feita assim que o componente for carregado.
          */
         "autoLoad"?: boolean;
         /**
-          * @description Usado para fechar o configurador do CRUD.
-          * @returns
+          * Usado para fechar o configurator do CRUD
          */
         "closeConfigurator": () => Promise<void>;
         /**
-          * @description Usado para salvar as configurações dos blocos de construção.
+          * Usado para salvar as configurações dos blocos de construção.
          */
         "configName": string;
-        /**
-          * @description Estado atual dos dados.
-         */
         "dataState": DataState1;
-        /**
-          * @description Instância do DataUnit a ser utilizada pelo componente.
-         */
         "dataUnit": DataUnit;
         /**
-          * @description Define a chave customizada para sobrescrever as mensagens (não pegando pela entidade).
+          * Define a chave customizada para sobrescrever as mensagens (Não pegando pela entidade)
          */
         "domainMessagesBuilder": string;
-        /**
-          * @description Habilita a inserção contínua de registros.
-         */
         "enableContinuousInsert": boolean;
         /**
-          * @description Ativa a inserção de registros no modo grade.
+          * Ativa inserção de registros no modo grade.
          */
         "enableGridInsert"?: boolean;
         /**
-          * @description Define se o componente deve usar o LockManager para controle de carregamento da aplicação.
+          * Define se o componente deve usar o LockManager para controle de carregamento da aplicação
          */
         "enableLockManagerLoadingComp"?: boolean;
         /**
-          * @description Ativa o gerenciamento de locks na grade pela Taskbar.
+          * Ativa o gerenciamento de locks na grade pela Taskbar.
          */
         "enableLockManagerTaskbarClick"?: boolean;
         /**
-          * @description Define o nome da entidade que o componente vai utilizar para fazer as operações de CRUD.
+          * Define o nome da entidade que o componente vai utilizar para fazer as operações de CRUD
          */
         "entityName": string;
-        /**
-          * @description Configuração do formulário.
-         */
         "formConfig": IFormConfig;
         /**
-          * @description Chave da configuração legada do formulário.
+          * Chave da configuração legado do formulário.
          */
         "formLegacyConfigName": string;
-        /**
-          * @description Obtém os registros do DataUnit.
-          * @returns Uma promessa que resolve com a lista de registros.
-         */
         "getRecords": () => Promise<Array<Record>>;
         /**
-          * @description Usado para alternar a visão entre GRID e FORM externamente.
-          * @param view - A visão para a qual navegar.
-          * @returns
+          * Usado para alternar a visão entre GRID e FORM externamente.
          */
         "goToView": (view: VIEW_MODE) => Promise<void>;
-        /**
-          * @description Configuração da grade.
-         */
         "gridConfig": IGridConfig;
         /**
-          * @description Chave da configuração legada da grade.
+          * Chave da configuração legado da grade.
          */
         "gridLegacyConfigName": string;
         /**
-          * @description Ignora os campos "somente leitura" no modo de inserção.
+          * Ignora os campos "somente leitura" no modo de inserção.
          */
         "ignoreReadOnlyFormFields": boolean;
         /**
-          * @description Define se o LayoutFormConfig será exibido no configurador.
+          * Define se o LayoutFormConfig será exibido no configurador.
          */
         "layoutFormConfig": boolean;
         /**
-          * @description Responsável por flexibilizar e padronizar o uso de mensagens nos blocos de construção.
+          * Responsável por flexibilizar e padronizar o uso de mensagens nos blocos de construção.
          */
         "messagesBuilder": SnkMessageBuilder;
-        /**
-          * @description Define o modo de operação do CRUD (servidor ou em memória).
-         */
         "mode": SIMPLE_CRUD_MODE;
         /**
-          * @description Habilita a edição de múltiplos registros simultâneos.
+          * Habilita a edição de múltiplos registros simultâneos.
          */
         "multipleEditionEnabled": boolean;
         /**
-          * @description Determina se pode haver mais de uma linha selecionada na grade.
+          * Determina se pode haver mais de uma linha selecionada na grade.
          */
         "multipleSelection": boolean;
         /**
-          * @description Usado para abrir o configurador do CRUD.
-          * @returns
+          * Usado para abrir o configurator do CRUD
          */
         "openConfigurator": () => Promise<void>;
         /**
-          * @description Altera visualmente as sombras e bordas do componente. Quando `false`, aplica o padrão de sombras ao componente (utilizar quando for o elemento principal do layout). Quando `true`, aplica o padrão de contorno ao componente (utilizar quando estiver contido em outro elemento como um painel ou pop-up).
+          * Altera visualmente as sombras e bordas do componente Quando false, aplica o padrão de sombras ao componente (Utilizar quando for o elemento principal do layout) Quando true, aplica o padrão de outline ao componente (Utilizar quando estiver contido em outro elemento como um painel ou pop-up)
          */
         "outlineMode"?: boolean;
         /**
-          * @description Determina quantas linhas são retornadas por página.
+          * Determina quantas linhas são retornadas por página.
          */
         "pageSize": number;
         /**
-          * @description Define o modo de exibição do contador de paginação.
+          * Define se a grid será focada ao ser carregada.
          */
         "paginationCounterMode"?: 'show' | 'hidden' | 'auto';
         /**
-          * @description Remove o formatador de valores de uma coluna da grade.
-          * @param columnName - O nome da coluna.
-          * @returns
+          * Remove o formatador de valores de uma coluna da grid.
          */
         "removeCustomValueFormatter": (columnName: string) => Promise<void>;
         /**
-          * @description Identificador de recursos como configurações e acesso.
+          * Identificador de recursos como configurações e acesso.
          */
         "resourceID": string;
         /**
-          * @description Altera/adiciona uma propriedade nos metadados do campo.
-          * @param fieldName - O nome do campo.
-          * @param propName - O nome da propriedade.
-          * @param value - O valor da propriedade.
-          * @returns
+          * Altera/adiciona uma propriedade nos metadados do campo.
          */
         "setFieldProp": (fieldName: string, propName: string, value: any) => Promise<void>;
-        /**
-          * @description Define os metadados do DataUnit.
-          * @param metadata - Os metadados a serem definidos.
-          * @returns
-         */
         "setMetadata": (metadata: UnitMetadata) => Promise<void>;
-        /**
-          * @description Define os registros do DataUnit.
-          * @param records - Os registros a serem definidos.
-          * @returns
-         */
         "setRecords": (records: Array<Record>) => Promise<void>;
         /**
-          * @description Usado para exibir os botões de ação do snk-configurator.
+          * Usado para exibir os botões de ação do snk-configurator.
          */
         "showConfiguratorButtons": boolean;
         /**
-          * @description Gerenciador das barras de tarefas. É possível determinar botões específicos ou mesmo gerenciar o estado dos botões.
+          * Gerenciador das barras de tarefas. É possível determinar botões específicos ou mesmo gerenciar o estado dos botões.
          */
         "taskbarManager": TaskbarManager;
-        /**
-          * @description Atualiza a configuração do formulário.
-          * @returns
-         */
         "updateConfig": () => Promise<void>;
-        /**
-          * @description Determina se será usada mensagem de confirmação padrão na tentativa de cancelar a edição.
-         */
         "useCancelConfirm": boolean;
         /**
-          * @description Quando verdadeiro, o ENTER fará a navegação como se fosse a tecla TAB na grade.
+          * Quando verdadeiro, o ENTER fará a navegação como se fosse a tecla TAB na grade.
          */
         "useEnterLikeTab": boolean;
     }
@@ -2392,6 +2218,10 @@ export namespace Components {
           * Data unit responsável pelos campos disponíveis
          */
         "dataUnit": DataUnit;
+        /**
+          * Responsável por flexibilizar e padronizar o uso de mensagens nos blocos de construção.
+         */
+        "messagesBuilder": SnkMessageBuilder;
         /**
           * Responsável por abrir o configurador.
          */
@@ -2399,64 +2229,63 @@ export namespace Components {
     }
     interface SnkTaskbar {
         /**
-          * @description Lista de ações a serem exibidas no botão "Mais opções".
+          * Lista de ações que devem ser usadas no botão "Mais opções" do componente snk-taskbar.
          */
         "actionsList": Array<Action>;
         /**
-          * @description Lista de ações que devem ser usadas no botão "Mais opções" do componente snk-taskbar.
+          * Lista de ações que devem ser usadas no botão "Mais opções" do componente snk-taskbar.
          */
         "actionsSettingsList": Array<Action>;
         /**
-          * @description Define o alinhamento dos itens da barra de tarefas à direita.
+          * Usado para determinar O alinhamento dos items na taskbar.
          */
         "alignRigth": boolean;
         /**
-          * @description Lista de botões, separados por vírgula, que define todos os elementos a serem criados na barra de tarefas.
+          * Lista separada por virgula, contendo todos os elementos a serem criados.
          */
         "buttons": string;
         /**
-          * @description Nome da configuração usada para salvar ou recuperar as configurações do formulário. Também é utilizado como fallback para a chave de armazenamento do exportador de dados.
+          * Usado para guardar ou recuperar as configurações do formulário.
          */
         "configName": string;
         /**
-          * @description Mapa com definições de botões personalizados. A chave do mapa deve ser informada na propriedade `buttons` no local onde o botão deve ser renderizado.
+          * Mapa com definição de botões personalizados. A chave do mapa deve ser passada na lista "buttons" no lugar onde o botão irá aparecer.
          */
         "customButtons": Map<string, CustomButton>;
         /**
-          * @description Define o identificador do contêiner na DOM que é responsável por guardar os elementos personalizados que não podem ser passados por slot.
-          * @example Elementos customizados na Taskbar da aba de detalhes.
+          * Usado para determinar o identificador do container na DOM que é responsavel por guardar os elementos personalizados que não podem ser passados por slot.  Exemplo: Elementos customizados na Taskbar da aba de detalhes.
          */
         "customContainerId": string;
         /**
-          * @description Define o identificador do slot que recebe elementos personalizados.
+          * Usado para determinar o identificador do slot que recebe elementos personalizados.
          */
         "customSlotId": string;
         /**
-          * @description Instância do `DataUnit` com a qual a barra de tarefas irá interagir para realizar operações de dados (ex: salvar, próximo, anterior).
+          * Instância do DataUnit.
          */
         "dataUnit": DataUnit;
         /**
-          * @description Array contendo os identificadores de todos os botões que devem ser desabilitados.
+          * Array contendo todos os botões a serem desabilitados.
          */
         "disabledButtons": Array<string>;
         /**
-          * @description Responsável por flexibilizar e padronizar o uso de mensagens nos blocos de construção.
+          * Responsável por flexibilizar e padronizar o uso de mensagens nos blocos de construção.
          */
         "messagesBuilder": SnkMessageBuilder;
         /**
-          * @description Define como será o comportamento da barra de tarefas quando ocorrer um overflow de itens.
+          * Define como será o comportamento da taskbar quando ocorrer overflow
          */
         "overflowStrategy": 'hiddenItems' | 'none';
         /**
-          * @description Altera o modo de apresentação dos botões da barra de tarefas.
+          * Altera o modo de apresentação dos botões do snk-taskbar.
          */
         "presentationMode": PresentationMode1;
         /**
-          * @description Define qual botão deve ter a aparência de destaque (primário).
+          * Determina qual botão deve ter aparência primária.
          */
         "primaryButton": string;
         /**
-          * @description Identificador de recursos, como configurações e permissões de acesso.
+          * Identificador de recursos como configurações e acesso.
          */
         "resourceID": string;
     }
@@ -3218,6 +3047,7 @@ declare namespace LocalJSX {
     interface FieldsSelector {
         "availableFields"?: IFieldConfig[];
         "dataUnit"?: DataUnit;
+        "messagesBuilder"?: SnkMessageBuilder;
         "onFieldListChanged"?: (event: FieldsSelectorCustomEvent<IFieldConfig[]>) => void;
     }
     interface GuidesConfigurator {
@@ -3265,6 +3095,10 @@ declare namespace LocalJSX {
           * Argumentos que serão usados ao chamar a função treeLoader.
          */
         "argument"?: string;
+        /**
+          * Responsável por flexibilizar e padronizar o uso de mensagens nos blocos de construção.
+         */
+        "messagesBuilder"?: SnkMessageBuilder;
         "onPesquisaTreeSelectItem"?: (event: PesquisaTreeCustomEvent<IOption>) => void;
         /**
           * Informa se a árvore hierárquica deve ou não ser carregada.
@@ -3342,6 +3176,10 @@ declare namespace LocalJSX {
           * FetcherType define o tipo de fetcher responsável por carregar os dados do DataUnit.
          */
         "fetcherType"?: TFetcherType;
+        /**
+          * Chave da configuração legado da grid.
+         */
+        "gridLegacyConfigName"?: string;
         /**
           * Responsável por flexibilizar e padronizar o uso de mensagens nos blocos de construção.
          */
@@ -3573,112 +3411,78 @@ declare namespace LocalJSX {
     interface SnkDataUnit {
         /**
           * Executado após a ação de salvar.
-          * @param dataUnit - A instância do DataUnit.
-          * @returns
          */
         "afterSave"?: (dataUnit: DataUnit) => void;
         /**
           * Executado imediatamente antes da ação de salvar as alterações. Útil no caso de validações por exemplo. Caso retorne "false" (ou a promessa se resolva como false), cancela a ação.
-          * @param dataUnit - A instância do DataUnit.
-          * @returns `false` para cancelar a ação, `true` para continuar.
          */
         "beforeSave"?: (dataUnit: DataUnit) => boolean | Promise<boolean>;
         /**
           * Usado para obter configuração de metadados.
-          * @type {string}
          */
         "configName"?: string;
         /**
           * Controla o estado atual dos dados.
-          * @type {DataState}
          */
         "dataState"?: DataState;
         /**
           * Uma vez instanciado, pode-se obter o dataUnit por esta propriedade.
-          * @type {DataUnit}
          */
         "dataUnit"?: DataUnit;
         /**
           * Usado para criar o dataUnit uma única vez. Se omitido, será usado o próprio nome da entidade.
-          * @type {string}
          */
         "dataUnitName"?: string;
         /**
           * Define a chave customizada para sobrescrever as mensagens (Não pegando pela entidade)
-          * @type {string}
          */
         "domainMessagesBuilder"?: string;
         /**
           * Determina qual a entidade que representa os dados em questão.
-          * @type {string}
          */
         "entityName"?: string;
         /**
           * Responsável por evitar a mensagem de sucesso ao salvar.
-          * @type {boolean}
          */
         "ignoreSaveMessage"?: boolean;
         /**
           * Responsável por flexibilizar e padronizar o uso de mensagens nos blocos de construção.
-          * @type {SnkMessageBuilder}
          */
         "messagesBuilder"?: SnkMessageBuilder;
         /**
           * Emitido quando se cancela uma inserção ou cópia.
-          * @event cancelEdition
-          * @type {CustomEvent<void>}
-          * @bubbles false
          */
         "onCancelEdition"?: (event: SnkDataUnitCustomEvent<void>) => void;
         /**
           * Emitido quando há qualquer mudança de estado no DataUnit.
-          * @event dataStateChange
-          * @type {CustomEvent<DataState>}
-          * @bubbles false
          */
         "onDataStateChange"?: (event: SnkDataUnitCustomEvent<DataState>) => void;
         /**
           * Emitido quando há campos no DataUnit que devem ser ocultados.
-          * @event dataUnitFieldsHidded
-          * @type {CustomEvent<void>}
          */
         "onDataUnitFieldsHidded"?: (event: SnkDataUnitCustomEvent<void>) => void;
         /**
           * Emitido quando o DataUnit está pronto.
-          * @event dataUnitReady
-          * @type {CustomEvent<DataUnit>}
-          * @bubbles false
          */
         "onDataUnitReady"?: (event: SnkDataUnitCustomEvent<DataUnit>) => void;
         /**
           * Emitido quando um registro é adicionado ou copiado.
-          * @event insertionMode
-          * @type {CustomEvent<void>}
-          * @bubbles false
          */
         "onInsertionMode"?: (event: SnkDataUnitCustomEvent<void>) => void;
         /**
-          * Emitido quando o messagesBuilder é atualizado.
-          * @event messagesBuilderUpdated
-          * @type {CustomEvent<SnkMessageBuilder>}
-          * @bubbles false
+          * Emitido quando o DataUnit está pronto.
          */
         "onMessagesBuilderUpdated"?: (event: SnkDataUnitCustomEvent<SnkMessageBuilder>) => void;
         /**
           * Determina quantas linhas são retornadas por página.
-          * @type {number}
-          * @default 150
          */
         "pageSize"?: number;
         /**
           * Identificador de recursos como configurações e acesso.
-          * @type {string}
          */
         "resourceID"?: string;
         /**
           * Determina se será usado mensagem de confirmação padrão na tentativa de cancelar a edição.
-          * @type {boolean}
-          * @default true
          */
         "useCancelConfirm"?: boolean;
     }
@@ -3901,65 +3705,56 @@ declare namespace LocalJSX {
     }
     interface SnkFilterBar {
         /**
-          * @description Função chamada depois de aplicar os filtros.
+          * Função chamada depois de aplicar os filtros.
          */
         "afterApplyConfig"?: () => void;
         /**
-          * @description Define se a carga dos dados será feita assim que o componente for carregado.
+          * Define se a carga dos dados será feita assim que o componente for carregado.
          */
         "autoLoad"?: boolean;
         /**
-          * @description Eventualmente poderemos ter mais de uma barra de filtros. Essa propriedade serve para separar a configuração de cada uma.
+          * Eventualmente poderemos ter mais de uma barra de filtros. Essa propriedade serve para separar a configuração de cada uma.
          */
         "configName"?: string;
         /**
-          * @description Loader customizado para carregar as configurações.
-          * @param configName - Nome da configuração.
-          * @param resourceId - ID do recurso.
-          * @param options - Opções adicionais.
-          * @returns Retorna a configuração dos filtros.
+          * Loader customizado para carregar as configurações
          */
         "customFilterBarConfig"?: (configName: string, resourceId: string, options: any) => Promise<Array<SnkFilterItemConfig>>;
         /**
-          * @description Recebe o DataUnit do ambiente. Se não for informado, procura pela referência do SnkDataUnit. Necessário para se registrar como provedor de filtros.
+          * Recebe o DataUnit do ambiente. Se não for informado, procura pela referência do SnkDataUnit. Necessário para se registrar como provedor de filtros.
          */
         "dataUnit"?: DataUnit;
         /**
-          * @description Desabilita a apresentação da opção de filtros personalizados na filter bar (chip de filtros) e no modal lateral de filtros (container de filtros personalizados).
+          * Desabilita a apresentação da opção de filtros personalizados na filter bar (chip de filtros) e no modal lateral de filtros (container de filtros personalizados).
          */
         "disablePersonalizedFilter"?: boolean;
         /**
-          * @description Define se o componente deve usar o LockManager para controle de carregamento.
+          * Define se o componente deve usar o LockManager para controle de carregamento
          */
         "enableLockManagerLoadingComp"?: boolean;
         /**
-          * @description Chave da configuração legada da barra de filtros.
+          * Chave da configuração legado da barra de filtros.
          */
         "filterBarLegacyConfigName"?: string;
         /**
-          * @description Lista todos os filtros disponíveis ao usuário.
+          * Lista todos os filtros disponíveis ao usuário.
          */
         "filterConfig"?: Array<SnkFilterItemConfig>;
         /**
-          * @description Responsável por flexibilizar e padronizar o uso de mensagens nos blocos de construção.
+          * Responsável por flexibilizar e padronizar o uso de mensagens nos blocos de construção.
          */
         "messagesBuilder"?: SnkMessageBuilder;
         /**
-          * @description Modo de apresentação da barra de filtros.
+          * Modo de apresentação da filterbar.
          */
         "mode"?: "regular" | "button" | "hidden";
-        /**
-          * @description Evento emitido quando a configuração dos filtros é atualizada.
-          * @param configs - Lista de configurações de filtros atualizadas.
-          * @event
-         */
         "onConfigUpdated"?: (event: SnkFilterBarCustomEvent<SnkFilterItemConfig[]>) => void;
         /**
-          * @description Identificador de recursos como configurações e acesso.
+          * Identificador de recursos como configurações e acesso.
          */
         "resourceID"?: string;
         /**
-          * @description Título que será apresentado na barra de filtros.
+          * Título que será apresentado na barra de filtros
          */
         "title"?: string;
     }
@@ -4238,7 +4033,7 @@ declare namespace LocalJSX {
          */
         "configName"?: string;
         /**
-          * Chave da configuração legada do formulário.
+          * Chave da configuração legado do formulário.
          */
         "formLegacyConfigName"?: string;
         /**
@@ -4246,15 +4041,15 @@ declare namespace LocalJSX {
          */
         "messagesBuilder"?: SnkMessageBuilder;
         /**
-          * @deprecated Esta propriedade foi descontinuada. Ela não tem mais efeito sobre o componente.
+          * Emitido sempre que houver click de botão ou ação.
          */
         "onActionClick"?: (event: SnkFormCustomEvent<string>) => void;
         /**
-          * @deprecated Esta propriedade foi descontinuada. Ela não tem mais efeito sobre o componente.
+          * Emitido quando o botão de voltar é acionado.
          */
         "onExit"?: (event: SnkFormCustomEvent<void>) => void;
         /**
-          * Responsável por notificar quando ocorrer a renderização de itens do formulário. OBS: Emitido no subcomponente snk-form-view
+          * Responsável por notificar quando ocorrer a renderização de itens do formulário.
          */
         "onFormItemsReady"?: (event: SnkFormCustomEvent<Array<HTMLElement>>) => void;
         /**
@@ -4383,43 +4178,40 @@ declare namespace LocalJSX {
     }
     interface SnkGrid {
         /**
-          * Lista de ações que devem ser usadas no botão "Mais opções" do `snk-taskbar`.
+          * Lista de ações que devem ser usadas no botão "Mais opções" do componente snk-taskbar.
          */
         "actionsList"?: Array<Action>;
         /**
-          * Define se a grade receberá o foco automaticamente ao ser carregada.
+          * Define se a grid será focada ao ser carregada.
          */
         "autoFocus"?: boolean;
         /**
-          * Define se os dados serão carregados automaticamente na inicialização do componente.
+          * Define se a carga dos dados será feita assim que o componente for carregado.
          */
         "autoLoad"?: boolean;
         /**
-          * Define se a edição de dados na grade está habilitada.
+          * Define se a edição está habilitada na grid.
          */
         "canEdit"?: boolean;
-        /**
-          * Define o data source para o filtro de colunas.
-         */
         "columnFilterDataSource"?: IMultiSelectionListDataSource;
         /**
-          * Define se a grade deve ser exibida em modo compacto.
+          * Define se a grade deve ser exibida em modo compacto
          */
         "compact"?: boolean;
         /**
-          * Nome usado para salvar e recuperar a configuração da grade.
+          * Nome usado para salvar/recuperar a configuração.
          */
         "configName"?: string;
         /**
-          * Desabilita a apresentação da opção de filtros personalizados na barra de filtros (chip de filtros) e no modal lateral de filtros (contêiner de filtros personalizados).
+          * Desabilita a apresentação da opção de filtros personalizados na filter bar (chip de filtros) e no modal lateral de filtros (container de filtros personalizados).
          */
         "disablePersonalizedFilter"?: boolean;
         /**
-          * Habilita a inserção de registros diretamente na grade.
+          * Ativa inserção de registros no modo grade.
          */
         "enableGridInsert"?: boolean;
         /**
-          * Define se o componente deve usar o LockManager para controle de carregamento da aplicação.
+          * Define se o componente deve usar o LockManager para controle de carregamento da aplicação
          */
         "enableLockManagerLoadingComp"?: boolean;
         /**
@@ -4427,23 +4219,23 @@ declare namespace LocalJSX {
          */
         "enableLockManagerTaskbarClick"?: boolean;
         /**
-          * Chave da configuração legada da barra de filtros.
+          * Chave da configuração legado da barra de filtros.
          */
         "filterBarLegacyConfigName"?: string;
         /**
-          * Título que será apresentado na barra de filtros.
+          * Título que será apresentado na barra de filtros
          */
         "filterBarTitle"?: string;
         /**
-          * Define o nome do slot para elementos customizados na `Taskbar` do cabeçalho da grade.
+          * Nome do slot de elementos customizados da Taskbar do cabeçalho da grade.
          */
         "gridHeaderCustomSlotId"?: string;
         /**
-          * Chave da configuração legada da grade.
+          * Chave da configuração legado da grade.
          */
         "gridLegacyConfigName"?: string;
         /**
-          * Determina se a grade está vinculada a um detalhe de outra tela.
+          * Determina se a grade está vinculada a um detalhe.
          */
         "isDetail"?: boolean;
         /**
@@ -4451,92 +4243,83 @@ declare namespace LocalJSX {
          */
         "messagesBuilder"?: SnkMessageBuilder;
         /**
-          * Habilita a edição de múltiplos registros simultaneamente.
+          * Habilita a edição de múltiplos registros simultâneos.
          */
         "multipleEditionEnabled"?: boolean;
         /**
-          * Determina se a seleção de múltiplas linhas é permitida.
+          * Determina se pode haver mais de uma linha selecionada.
          */
         "multipleSelection"?: boolean;
         /**
-          * Emitido ao clicar em um botão de ação ou item de menu.
-          * @description Este evento é acionado quando o usuário clica em um botão de ação ou item de menu na grade, permitindo a execução de ações específicas.
-          * @param detail - O identificador da ação clicada, que pode ser usado para determinar qual ação executar.
+          * Emitido sempre que houver click de botão ou ação.
          */
         "onActionClick"?: (event: SnkGridCustomEvent<string>) => void;
         /**
-          * @deprecated Esta propriedade foi descontinuada. Ela não tem mais efeito sobre o componente.
+          * Emitido quando o componente estiver completamente carregado.
          */
         "onComponentReady"?: (event: SnkGridCustomEvent<void>) => void;
         /**
-          * Emitido ao realizar um duplo clique em uma linha da grade.
-          * @description Este evento é acionado quando o usuário clica duas vezes em uma linha da grade, permitindo ações como edição rápida ou visualização de detalhes.
-          * @param detail - Detalhes do evento, contendo a linha clicada.
+          * Emitido sempre que houver duplo click na grade.
          */
         "onGridDoubleClick"?: (event: SnkGridCustomEvent<any>) => void;
         /**
-          * Altera a aparência das bordas e sombras do componente. Se `false`, aplica o padrão de sombras (ideal para o elemento principal do layout). Se `true`, aplica um contorno (ideal para quando o componente está dentro de outro, como um painel ou pop-up).
+          * Altera visualmente as sombras e bordas do componente Quando false, aplica o padrão de sombras ao componente (Utilizar quando for o elemento principal do layout) Quando true, aplica o padrão de outline ao componente (Utilizar quando estiver contido em outro elemento como um painel ou pop-up)
          */
         "outlineMode"?: boolean;
         /**
-          * Define o modo de exibição do contador de paginação.
+          * Define se a grid será focada ao ser carregada.
          */
         "paginationCounterMode"?: 'show' | 'hidden' | 'auto';
         /**
-          * Altera o modo de apresentação dos botões do `snk-taskbar`.
+          * Altera o modo de apresentação dos botões do snk-taskbar.
          */
         "presentationMode"?: PresentationMode1;
         /**
-          * Validador responsável por verificar a integridade dos dados de um registro.
+          * Validador responsável por checar a integridade das informações do registro.
          */
         "recordsValidator"?: IRecordValidator;
         /**
-          * Identificador de recursos, como configurações e permissões de acesso.
+          * Identificador de recursos como configurações e acesso.
          */
         "resourceID"?: string;
         /**
-          * Configuração do toast de seleção da grade.
+          * Configuração da seleção de grade no toast.
          */
         "selectionToastConfig"?: ISelectionToastConfig;
         /**
-          * Define a configuração de cores para a coluna de status.
-          * @example ```json '{ "RECDESP": { "-1" : "#BD0025", "1" : "#157A00" } }' ```
+          * Configuração do valor da coluna de status. Exemplo: '{ "RECDESP": { "-1" : "#BD0025", "1" : "#157A00" } }'
          */
         "statusResolver"?: IStatusResolver | StatusResolverFunction;
         /**
-          * Define o modo de exportação dos dados.
+          * Modo de exportação dos dados.
          */
         "strategyExporter"?: IExporterStrategyMode;
         /**
-          * Informa se a coluna de checkbox deve ser suprimida.
+          * Informa se a coluna de chechbox deve ser suprimida
          */
         "suppressCheckboxColumn"?: boolean;
         /**
-          * Informa se a grade deve suprimir o filtro de coluna.
-         */
-        "suppressFilterColumn"?: boolean;
-        /**
-          * Define se a grade deve suprimir a barra de rolagem horizontal.
+          * Define se a grade deve suprimir o scroll horizontal.
          */
         "suppressHorizontalScroll"?: boolean;
         /**
-          * Define o identificador do contêiner de elementos customizados da `Taskbar`.
+          * Define o identificador do container de elementos customizados da Taskbar.
          */
         "taskbarCustomContainerId"?: string;
         /**
-          * Gerenciador das barras de tarefas. Permite determinar botões específicos ou gerenciar o estado dos botões.
+          * Gerenciador das barras de tarefas. É possível determinar botões específicos ou mesmo gerenciar o estado dos botões.
          */
         "taskbarManager"?: TaskbarManager;
         /**
-          * Define o nome do slot para elementos customizados na `Taskbar` principal do componente.
+          * Nome do slot de elementos customizados da Taskbar principal do componente.
          */
         "topTaskbarCustomSlotId"?: string;
         /**
-          * Quando `true`, a tecla ENTER navega entre as células como a tecla TAB.
+          * Quando verdadeiro, o ENTER fará a navegação como se fosse a tecla TAB na grade.
          */
         "useEnterLikeTab"?: boolean;
         /**
-          * Define se a grade deve exibir um buscador de colunas ao pressionar `Ctrl+F`.
+          * Define se a grade deve exibir um buscador de coluna com uso do Ctrl+F
          */
         "useSearchColumn"?: boolean;
     }
@@ -4661,52 +4444,34 @@ declare namespace LocalJSX {
         "taskbarManager"?: TaskbarManager;
     }
     interface SnkLayoutFormConfig {
+        "messagesBuilder"?: SnkMessageBuilder;
     }
     interface SnkPersonalizedFilter {
         /**
-          * Nome da configuração, utilizado para distinguir múltiplas instâncias do componente.
-          * @property
+          * Nome da configuração. Serve para distinguir várias instâncias do componente.
          */
         "configName"?: string;
         /**
-          * URI da entidade utilizada para buscar os campos disponíveis para filtro.
-          * @property
+          * Responsável por receber a URI da entidade.
          */
         "entityUri"?: string;
         /**
-          * Identificador do filtro a ser carregado.
-          * @property
+          * Id do filtro que será carregado.
          */
         "filterId"?: string;
         /**
-          * Indica se o filtro é o filtro padrão do sistema.
-          * @property 
-          * @default false
+          * Define se o filtro em questão é um filtro padrão.
          */
         "isDefaultFilter"?: boolean;
         /**
           * Responsável por flexibilizar e padronizar o uso de mensagens nos blocos de construção.
-          * @property
          */
         "messagesBuilder"?: SnkMessageBuilder;
-        /**
-          * Evento emitido após salvar as alterações do filtro personalizado.
-          * @event
-         */
         "onEzAfterSave"?: (event: SnkPersonalizedFilterCustomEvent<void>) => void;
-        /**
-          * Evento emitido ao cancelar a personalização do filtro.
-          * @event
-         */
         "onEzCancel"?: (event: SnkPersonalizedFilterCustomEvent<void>) => void;
-        /**
-          * Evento emitido ao salvar as alterações do filtro personalizado.
-          * @event
-         */
         "onEzSave"?: (event: SnkPersonalizedFilterCustomEvent<string>) => void;
         /**
-          * Identificador do recurso utilizado para salvar e recuperar filtros.
-          * @property
+          * Nome da configuração. Serve para distinguir várias instâncias do componente.
          */
         "resourceID"?: string;
     }
@@ -4772,6 +4537,10 @@ declare namespace LocalJSX {
           * Emitido ao alterar a seleção do componente snk-select-box.
          */
         "onEzChange"?: (event: SnkSelectBoxCustomEvent<string>) => void;
+        /**
+          * Se true, impede que o campo de texto receba foco automaticamente ao abrir as opções.
+         */
+        "preventAutoFocus"?: boolean;
         /**
           * Determina a opção selecionada.
          */
@@ -4779,11 +4548,11 @@ declare namespace LocalJSX {
     }
     interface SnkSimpleBar {
         /**
-          * Define os itens que serão apresentados no breadcrumb.
+          * Define os itens que serão apresentados pelo breadcrumb
          */
         "breadcrumbItens"?: Array<IBreadcrumbItem>;
         /**
-          * Define o título do header.
+          * Define o título do header
          */
         "label"?: string;
         /**
@@ -4791,157 +4560,136 @@ declare namespace LocalJSX {
          */
         "messagesBuilder"?: SnkMessageBuilder;
         /**
-          * Emitido quando algum item do breadcrumb é clicado.
+          * Emitido quando algum item do breadcrumb é clicado
          */
         "onClickBreadcrumbItem"?: (event: SnkSimpleBarCustomEvent<IBreadcrumbItem>) => void;
         /**
-          * Emitido quando o botão "voltar" é acionado.
+          * Emitido quando o botão voltar é acionado
          */
         "onExit"?: (event: SnkSimpleBarCustomEvent<void>) => void;
     }
     interface SnkSimpleCrud {
         /**
-          * @description Ações a serem colocadas no botão "Mais opções" do componente snk-taskbar.
+          * Ações a serem colocadas no botão "Mais opções" do componente snk-taskbar.
          */
         "actionsList"?: Array<Action>;
         /**
-          * @description Define se a grade será focada ao ser carregada.
+          * Define se a grid será focada ao ser carregada.
          */
         "autoFocus"?: boolean;
         /**
-          * @description Define se a carga dos dados será feita assim que o componente for carregado.
+          * Define se a carga dos dados será feita assim que o componente for carregado.
          */
         "autoLoad"?: boolean;
         /**
-          * @description Usado para salvar as configurações dos blocos de construção.
+          * Usado para salvar as configurações dos blocos de construção.
          */
         "configName"?: string;
-        /**
-          * @description Estado atual dos dados.
-         */
         "dataState"?: DataState1;
-        /**
-          * @description Instância do DataUnit a ser utilizada pelo componente.
-         */
         "dataUnit"?: DataUnit;
         /**
-          * @description Define a chave customizada para sobrescrever as mensagens (não pegando pela entidade).
+          * Define a chave customizada para sobrescrever as mensagens (Não pegando pela entidade)
          */
         "domainMessagesBuilder"?: string;
-        /**
-          * @description Habilita a inserção contínua de registros.
-         */
         "enableContinuousInsert"?: boolean;
         /**
-          * @description Ativa a inserção de registros no modo grade.
+          * Ativa inserção de registros no modo grade.
          */
         "enableGridInsert"?: boolean;
         /**
-          * @description Define se o componente deve usar o LockManager para controle de carregamento da aplicação.
+          * Define se o componente deve usar o LockManager para controle de carregamento da aplicação
          */
         "enableLockManagerLoadingComp"?: boolean;
         /**
-          * @description Ativa o gerenciamento de locks na grade pela Taskbar.
+          * Ativa o gerenciamento de locks na grade pela Taskbar.
          */
         "enableLockManagerTaskbarClick"?: boolean;
         /**
-          * @description Define o nome da entidade que o componente vai utilizar para fazer as operações de CRUD.
+          * Define o nome da entidade que o componente vai utilizar para fazer as operações de CRUD
          */
         "entityName"?: string;
-        /**
-          * @description Configuração do formulário.
-         */
         "formConfig"?: IFormConfig;
         /**
-          * @description Chave da configuração legada do formulário.
+          * Chave da configuração legado do formulário.
          */
         "formLegacyConfigName"?: string;
-        /**
-          * @description Configuração da grade.
-         */
         "gridConfig"?: IGridConfig;
         /**
-          * @description Chave da configuração legada da grade.
+          * Chave da configuração legado da grade.
          */
         "gridLegacyConfigName"?: string;
         /**
-          * @description Ignora os campos "somente leitura" no modo de inserção.
+          * Ignora os campos "somente leitura" no modo de inserção.
          */
         "ignoreReadOnlyFormFields"?: boolean;
         /**
-          * @description Define se o LayoutFormConfig será exibido no configurador.
+          * Define se o LayoutFormConfig será exibido no configurador.
          */
         "layoutFormConfig"?: boolean;
         /**
-          * @description Responsável por flexibilizar e padronizar o uso de mensagens nos blocos de construção.
+          * Responsável por flexibilizar e padronizar o uso de mensagens nos blocos de construção.
          */
         "messagesBuilder"?: SnkMessageBuilder;
-        /**
-          * @description Define o modo de operação do CRUD (servidor ou em memória).
-         */
         "mode"?: SIMPLE_CRUD_MODE;
         /**
-          * @description Habilita a edição de múltiplos registros simultâneos.
+          * Habilita a edição de múltiplos registros simultâneos.
          */
         "multipleEditionEnabled"?: boolean;
         /**
-          * @description Determina se pode haver mais de uma linha selecionada na grade.
+          * Determina se pode haver mais de uma linha selecionada na grade.
          */
         "multipleSelection"?: boolean;
         /**
-          * @description Emitido sempre que houver clique de botão ou ação na barra de tarefas.
+          * Emitido sempre que houver click de botão ou ação.
          */
         "onActionClick"?: (event: SnkSimpleCrudCustomEvent<string>) => void;
         /**
-          * @description Emitido quando o salvamento da configuração no configurador do CRUD é cancelado.
+          * Emitido quando cancela o salvamento da configuração no configurator do CRUD.
          */
         "onConfiguratorCancel"?: (event: SnkSimpleCrudCustomEvent<any>) => void;
         /**
-          * @description Emitido quando a configuração no configurador do CRUD é salva.
+          * Emitido quando salva a configuração no configurator do CRUD.
          */
         "onConfiguratorSave"?: (event: SnkSimpleCrudCustomEvent<any>) => void;
         /**
-          * @description Emitido quando há qualquer mudança de estado no DataUnit.
+          * Emitido quando há qualquer mudança de estado no DataUnit.
          */
         "onDataStateChange"?: (event: SnkSimpleCrudCustomEvent<DataState1>) => void;
         /**
-          * @description Emitido quando o DataUnit está pronto.
+          * Emitido quando o DataUnit está pronto.
          */
         "onDataUnitReady"?: (event: SnkSimpleCrudCustomEvent<DataUnit>) => void;
         /**
-          * @description Responsável por notificar quando ocorrer a renderização de itens do formulário.
+          * Responsável por notificar quando ocorrer a renderização de itens do formulário.
          */
         "onFormItemsReady"?: (event: SnkSimpleCrudCustomEvent<Array<HTMLElement>>) => void;
         /**
-          * @description Altera visualmente as sombras e bordas do componente. Quando `false`, aplica o padrão de sombras ao componente (utilizar quando for o elemento principal do layout). Quando `true`, aplica o padrão de contorno ao componente (utilizar quando estiver contido em outro elemento como um painel ou pop-up).
+          * Altera visualmente as sombras e bordas do componente Quando false, aplica o padrão de sombras ao componente (Utilizar quando for o elemento principal do layout) Quando true, aplica o padrão de outline ao componente (Utilizar quando estiver contido em outro elemento como um painel ou pop-up)
          */
         "outlineMode"?: boolean;
         /**
-          * @description Determina quantas linhas são retornadas por página.
+          * Determina quantas linhas são retornadas por página.
          */
         "pageSize"?: number;
         /**
-          * @description Define o modo de exibição do contador de paginação.
+          * Define se a grid será focada ao ser carregada.
          */
         "paginationCounterMode"?: 'show' | 'hidden' | 'auto';
         /**
-          * @description Identificador de recursos como configurações e acesso.
+          * Identificador de recursos como configurações e acesso.
          */
         "resourceID"?: string;
         /**
-          * @description Usado para exibir os botões de ação do snk-configurator.
+          * Usado para exibir os botões de ação do snk-configurator.
          */
         "showConfiguratorButtons"?: boolean;
         /**
-          * @description Gerenciador das barras de tarefas. É possível determinar botões específicos ou mesmo gerenciar o estado dos botões.
+          * Gerenciador das barras de tarefas. É possível determinar botões específicos ou mesmo gerenciar o estado dos botões.
          */
         "taskbarManager"?: TaskbarManager;
-        /**
-          * @description Determina se será usada mensagem de confirmação padrão na tentativa de cancelar a edição.
-         */
         "useCancelConfirm"?: boolean;
         /**
-          * @description Quando verdadeiro, o ENTER fará a navegação como se fosse a tecla TAB na grade.
+          * Quando verdadeiro, o ENTER fará a navegação como se fosse a tecla TAB na grade.
          */
         "useEnterLikeTab"?: boolean;
     }
@@ -4954,83 +4702,83 @@ declare namespace LocalJSX {
           * Data unit responsável pelos campos disponíveis
          */
         "dataUnit"?: DataUnit;
+        /**
+          * Responsável por flexibilizar e padronizar o uso de mensagens nos blocos de construção.
+         */
+        "messagesBuilder"?: SnkMessageBuilder;
         "onSnkConfigSaved"?: (event: SnkSimpleFormConfigCustomEvent<void>) => void;
     }
     interface SnkTaskbar {
         /**
-          * @description Lista de ações a serem exibidas no botão "Mais opções".
+          * Lista de ações que devem ser usadas no botão "Mais opções" do componente snk-taskbar.
          */
         "actionsList"?: Array<Action>;
         /**
-          * @description Lista de ações que devem ser usadas no botão "Mais opções" do componente snk-taskbar.
+          * Lista de ações que devem ser usadas no botão "Mais opções" do componente snk-taskbar.
          */
         "actionsSettingsList"?: Array<Action>;
         /**
-          * @description Define o alinhamento dos itens da barra de tarefas à direita.
+          * Usado para determinar O alinhamento dos items na taskbar.
          */
         "alignRigth"?: boolean;
         /**
-          * @description Lista de botões, separados por vírgula, que define todos os elementos a serem criados na barra de tarefas.
+          * Lista separada por virgula, contendo todos os elementos a serem criados.
          */
         "buttons"?: string;
         /**
-          * @description Nome da configuração usada para salvar ou recuperar as configurações do formulário. Também é utilizado como fallback para a chave de armazenamento do exportador de dados.
+          * Usado para guardar ou recuperar as configurações do formulário.
          */
         "configName"?: string;
         /**
-          * @description Mapa com definições de botões personalizados. A chave do mapa deve ser informada na propriedade `buttons` no local onde o botão deve ser renderizado.
+          * Mapa com definição de botões personalizados. A chave do mapa deve ser passada na lista "buttons" no lugar onde o botão irá aparecer.
          */
         "customButtons"?: Map<string, CustomButton>;
         /**
-          * @description Define o identificador do contêiner na DOM que é responsável por guardar os elementos personalizados que não podem ser passados por slot.
-          * @example Elementos customizados na Taskbar da aba de detalhes.
+          * Usado para determinar o identificador do container na DOM que é responsavel por guardar os elementos personalizados que não podem ser passados por slot.  Exemplo: Elementos customizados na Taskbar da aba de detalhes.
          */
         "customContainerId"?: string;
         /**
-          * @description Define o identificador do slot que recebe elementos personalizados.
+          * Usado para determinar o identificador do slot que recebe elementos personalizados.
          */
         "customSlotId"?: string;
         /**
-          * @description Instância do `DataUnit` com a qual a barra de tarefas irá interagir para realizar operações de dados (ex: salvar, próximo, anterior).
+          * Instância do DataUnit.
          */
         "dataUnit"?: DataUnit;
         /**
-          * @description Array contendo os identificadores de todos os botões que devem ser desabilitados.
+          * Array contendo todos os botões a serem desabilitados.
          */
         "disabledButtons"?: Array<string>;
         /**
-          * @description Responsável por flexibilizar e padronizar o uso de mensagens nos blocos de construção.
+          * Responsável por flexibilizar e padronizar o uso de mensagens nos blocos de construção.
          */
         "messagesBuilder"?: SnkMessageBuilder;
         /**
-          * @description Emitido sempre que um botão ou uma ação da barra de tarefas é clicado.
-          * @eventProperty
+          * Emitido sempre que houver click de botão ou ação.
          */
         "onActionClick"?: (event: SnkTaskbarCustomEvent<string>) => void;
         /**
-          * @description Emitido quando uma ação de salvar é iniciada pela barra de tarefas, indicando um estado de bloqueio para evitar ações concorrentes.
-          * @eventProperty
+          * Emitido sempre que um save é iniciado pela taskbar.
          */
         "onTaskbarSaveLocker"?: (event: SnkTaskbarCustomEvent<void>) => void;
         /**
-          * @description Emitido quando a ação de salvar é concluída ou cancelada, liberando o estado de bloqueio.
-          * @eventProperty
+          * Emitido sempre que o ocorre alguma action que libera o save.
          */
         "onTaskbarSaveUnlocker"?: (event: SnkTaskbarCustomEvent<void>) => void;
         /**
-          * @description Define como será o comportamento da barra de tarefas quando ocorrer um overflow de itens.
+          * Define como será o comportamento da taskbar quando ocorrer overflow
          */
         "overflowStrategy"?: 'hiddenItems' | 'none';
         /**
-          * @description Altera o modo de apresentação dos botões da barra de tarefas.
+          * Altera o modo de apresentação dos botões do snk-taskbar.
          */
         "presentationMode"?: PresentationMode1;
         /**
-          * @description Define qual botão deve ter a aparência de destaque (primário).
+          * Determina qual botão deve ter aparência primária.
          */
         "primaryButton"?: string;
         /**
-          * @description Identificador de recursos, como configurações e permissões de acesso.
+          * Identificador de recursos como configurações e acesso.
          */
         "resourceID"?: string;
     }