@sankhyalabs/sankhyablocks 9.2.0-dev.2 → 9.2.0-dev.21

package/dist/collection/components/snk-grid/snk-grid.js

@@ -1,49 +1,53 @@
-import { h, Fragment, } from '@stencil/core';
-import { Action as DUAction, ApplicationContext, ElementIDUtils, StringUtils, KeyboardManager } from '@sankhyalabs/core';
-import { TaskbarElement } from '../snk-taskbar/elements/taskbar-elements';
-import { ConfigStorage } from '../../lib/configs/ConfigStorage';
-import { ExporterStrategy, PresentationMode } from '../../lib/@types';
-import TaskbarProcessor from '../snk-taskbar/processor/taskbar-processor';
-import store from "../../lib/store";
-import SnkMultiSelectionListDataSource from './filtercolumn/SnkMultiSelectionListDataSource';
+import { ApplicationContext, Action as DUAction, ElementIDUtils, KeyboardManager, StringUtils } from '@sankhyalabs/core';
 import { SelectionMode } from '@sankhyalabs/core/dist/dataunit/DataUnit';
+import { buildFieldSearch } from '@sankhyalabs/ezui/dist/collection/utils';
+import { Fragment, h, } from '@stencil/core';
 import { CrudUtils } from '../../lib';
+import { ExporterStrategy, PresentationMode } from '../../lib/@types';
+import { ConfigStorage } from '../../lib/configs/ConfigStorage';
 import RmPrecisionCustomValueFormatter from '../../lib/DefaultCustomFormatters/RmPrecisionCustomValueFormatter';
-import ServerSideExporterProvider from '../snk-data-exporter/providers/ServerSideExporterProvider';
+import store from "../../lib/store";
 import { ContinuousInsertUtils } from '../../lib/utils/ContinuousInsertUtils';
 import ClientSideExporterProvider from '../snk-data-exporter/providers/ClientSideExporterProvider';
-import { buildFieldSearch } from '@sankhyalabs/ezui/dist/collection/utils';
+import ServerSideExporterProvider from '../snk-data-exporter/providers/ServerSideExporterProvider';
+import { validateFilters } from '../snk-filter-bar/utils/filter-validate';
+import { TaskbarElement } from '../snk-taskbar/elements/taskbar-elements';
+import TaskbarProcessor from '../snk-taskbar/processor/taskbar-processor';
+import SnkMultiSelectionListDataSource from './filtercolumn/SnkMultiSelectionListDataSource';
 export class SnkGrid {
   constructor() {
     this._customEditors = new Map();
     this._customRenders = new Map();
     this._keyboardManager = new KeyboardManager();
     this._topTaskbarProcessor = new TaskbarProcessor({
-      "snkGridTopTaskbar.regular": ["FORM_MODE", "CONFIGURATOR", "INSERT"],
-      "snkGridTopTaskbar.regular.secondary": ["FORM_MODE", "CONFIGURATOR", "INSERT"],
-      "snkGridTopTaskbar.regular.singleTaskbar": [],
-      "snkGridTopTaskbar.finish_edition": ["CANCEL", "SAVE", this.handleAddFormMode()],
-      "snkGridTopTaskbar.finish_edition.secondary": [],
-      "snkGridTopTaskbar.finish_edition.singleTaskbar": [],
+      'snkGridTopTaskbar.regular': ['FORM_MODE', 'CONFIGURATOR', 'INSERT'],
+      'snkGridTopTaskbar.regular.secondary': ['FORM_MODE', 'CONFIGURATOR', 'INSERT'],
+      'snkGridTopTaskbar.regular.singleTaskbar': [],
+      'snkGridTopTaskbar.finish_edition': ['CANCEL', 'SAVE', this.handleAddFormMode()],
+      'snkGridTopTaskbar.finish_edition.secondary': [],
+      'snkGridTopTaskbar.finish_edition.singleTaskbar': [],
     });
     this._headerTaskbarProcessor = new TaskbarProcessor({
-      "snkGridHeaderTaskbar.unselected": ["REFRESH", "DATA_EXPORTER", "ACTIONS_BUTTON", "MORE_OPTIONS"],
-      "snkGridHeaderTaskbar.selected": this.getGridHeaderSelectedBtns(),
-      "snkGridHeaderTaskbar.detail.unselected": ["REFRESH", "MORE_OPTIONS"],
-      "snkGridHeaderTaskbar.detail.selected": ["UPDATE", "ATTACH", "CLONE", "REMOVE", "MORE_OPTIONS", "DIVIDER", "REFRESH"],
-      "snkGridHeaderTaskbar.singleTaskbar.unselected": ["INSERT", "FORM_MODE", "CONFIGURATOR", "REFRESH", "DATA_EXPORTER", "ACTIONS_BUTTON", "MORE_OPTIONS"],
-      "snkGridHeaderTaskbar.singleTaskbar.selected": ["UPDATE", "CLONE", "REMOVE", "MORE_OPTIONS", "DIVIDER", "ATTACH", "FORM_MODE", "CONFIGURATOR", "REFRESH", "DATA_EXPORTER", "ACTIONS_BUTTON"],
-      "snkGridHeaderTaskbar.singleTaskbar.detail.unselected": ["INSERT", "FORM_MODE", "CONFIGURATOR", "REFRESH", "MORE_OPTIONS"],
-      "snkGridHeaderTaskbar.singleTaskbar.detail.selected": ["UPDATE", "ATTACH", "CLONE", "REMOVE", "MORE_OPTIONS", "DIVIDER", "FORM_MODE", "CONFIGURATOR", "REFRESH"],
-      "snkGridHeaderTaskbar.singleTaskbar.finish_edition": ["CANCEL", "SAVE", this.handleAddFormMode()]
+      'snkGridHeaderTaskbar.unselected': ['REFRESH', 'DATA_EXPORTER', 'ACTIONS_BUTTON', 'MORE_OPTIONS'],
+      'snkGridHeaderTaskbar.selected': this.getGridHeaderSelectedBtns(),
+      'snkGridHeaderTaskbar.detail.unselected': ['REFRESH', 'MORE_OPTIONS'],
+      'snkGridHeaderTaskbar.detail.selected': ['UPDATE', 'ATTACH', 'CLONE', 'REMOVE', 'MORE_OPTIONS', 'DIVIDER', 'REFRESH'],
+      'snkGridHeaderTaskbar.singleTaskbar.unselected': ['INSERT', 'FORM_MODE', 'CONFIGURATOR', 'REFRESH', 'DATA_EXPORTER', 'ACTIONS_BUTTON', 'MORE_OPTIONS'],
+      'snkGridHeaderTaskbar.singleTaskbar.selected': ['UPDATE', 'CLONE', 'REMOVE', 'MORE_OPTIONS', 'DIVIDER', 'ATTACH', 'FORM_MODE', 'CONFIGURATOR', 'REFRESH', 'DATA_EXPORTER', 'ACTIONS_BUTTON'],
+      'snkGridHeaderTaskbar.singleTaskbar.detail.unselected': ['INSERT', 'FORM_MODE', 'CONFIGURATOR', 'REFRESH', 'MORE_OPTIONS'],
+      'snkGridHeaderTaskbar.singleTaskbar.detail.selected': ['UPDATE', 'ATTACH', 'CLONE', 'REMOVE', 'MORE_OPTIONS', 'DIVIDER', 'FORM_MODE', 'CONFIGURATOR', 'REFRESH'],
+      'snkGridHeaderTaskbar.singleTaskbar.finish_edition': ['CANCEL', 'SAVE', this.handleAddFormMode()],
     });
     this.dataUnitInterceptor = {
       interceptAction: async (action) => {
         if (action.type === DUAction.METADATA_LOADED) {
           return await this.interceptMetadataLoaded(action);
         }
+        if (action.type === DUAction.LOADING_DATA) {
+          return await this.interceptLoadData(action);
+        }
         return action;
-      }
+      },
     };
     this._dataUnit = undefined;
     this._dataState = undefined;
@@ -84,23 +88,36 @@ export class SnkGrid {
     this.multipleEditionEnabled = true;
     this.paginationCounterMode = 'auto';
     this.suppressCheckboxColumn = undefined;
+    this.suppressFilterColumn = false;
     this.compact = undefined;
+    this.filterCustomConfig = undefined;
+    this.filterCustomConfigInterceptor = undefined;
   }
   getGridHeaderSelectedBtns() {
     const btns = [
       TaskbarElement.UPDATE, TaskbarElement.CLONE, TaskbarElement.REMOVE,
       TaskbarElement.MORE_OPTIONS, TaskbarElement.DIVIDER, TaskbarElement.ATTACH, TaskbarElement.FORM_MODE,
-      TaskbarElement.CONFIGURATOR, TaskbarElement.REFRESH, TaskbarElement.DATA_EXPORTER, TaskbarElement.ACTIONS_BUTTON
+      TaskbarElement.CONFIGURATOR, TaskbarElement.REFRESH, TaskbarElement.DATA_EXPORTER, TaskbarElement.ACTIONS_BUTTON,
     ];
     if (this.multipleEditionEnabled)
       btns.unshift(TaskbarElement.UPDATE_MULTIPLE);
     return btns;
   }
+  async refreshColumnFilterDataSource() {
+    await this._grid.refreshColumnFilterDataSource();
+  }
+  /**
+   * 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() {
     this.loadConfig();
   }
   /**
    * 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 {Promise<void>} Uma promessa que é resolvida quando a janela de configuração é exibida.
    */
   async showConfig() {
     if (this._grid == undefined) {
@@ -110,6 +127,9 @@ export class SnkGrid {
   }
   /**
    * 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 {Promise<void>} Uma promessa que é resolvida quando a janela de configuração é fechada.
    */
   async hideConfig() {
     if (this._grid == undefined) {
@@ -118,26 +138,42 @@ export class SnkGrid {
     this.closeGridConfig();
   }
   /**
-   * Atribui o valor da configuração da grade.
+   * Define a configuração da grade.
+   * @async
+   * @description Aplica uma nova configuração de colunas e ordenação à grade.
+   * @param {IGridConfig} config O objeto de configuração a ser aplicado na grade.
+   * @returns {Promise<void>} Uma promessa que é resolvida quando a configuração é aplicada.
    */
   async setConfig(config) {
     this.setGridConfig(config);
   }
   /**
-   * Faz o recarregamento da filter-bar da grade buscando o state no servidor.
+   * 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 {Promise<void>} Uma promessa que é resolvida quando a barra de filtros é recarregada.
    */
   async reloadFilterBar() {
     var _a;
     (_a = this._snkFilterBar) === null || _a === void 0 ? void 0 : _a.reload();
   }
   /**
-   * Retorna o elemento da filter-bar da grade.
+   * 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 {Promise<HTMLSnkFilterBarElement>} O elemento da barra de filtros.
    */
   async getFilterBar() {
     return this._snkFilterBar;
   }
   /**
-   * Registra um editor customizado para campos da grade e formulário
+   * 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 {string} fieldName O nome do campo que receberá o editor customizado.
+   * @param {ICustomEditor} customEditor A instância do editor customizado.
+   * @param {string} [detailContext] O contexto de detalhe onde o editor será aplicado (opcional).
+   * @returns {Promise<void>} Uma promessa que é resolvida quando o editor é registrado.
    */
   async addCustomEditor(fieldName, customEditor, detailContext) {
     if (this._grid) {
@@ -149,7 +185,13 @@ export class SnkGrid {
     this._customEditors = newCustomEditors;
   }
   /**
-   * Registra um render customizado para colunas da grid.
+   * 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 {string} fieldName O nome do campo (coluna) que receberá o renderizador customizado.
+   * @param {ICustomRender} customRender A instância do renderizador customizado.
+   * @param {string} [detailContext] O contexto de detalhe onde o renderizador será aplicado (opcional).
+   * @returns {Promise<void>} Uma promessa que é resolvida quando o renderizador é registrado.
    */
   async addGridCustomRender(fieldName, customRender, detailContext) {
     if (this._grid) {
@@ -161,19 +203,31 @@ export class SnkGrid {
     this._customRenders = newCustomRenders;
   }
   /**
-   * Registra um formatador de valores para uma coluna da grid.
+   * 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 {string} columnName O nome da coluna que receberá o formatador.
+   * @param {ICustomFormatter} customFormatter A instância do formatador de valor.
+   * @returns {Promise<void>} Uma promessa que é resolvida quando o formatador é registrado.
    */
   async addCustomValueFormatter(columnName, customFormatter) {
     this._grid.addCustomValueFormatter(columnName, customFormatter);
   }
   /**
-   * Remove o formatador de valores de uma coluna da grid.
+   * 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 {string} columnName O nome da coluna da qual o formatador será removido.
+   * @returns {Promise<void>} Uma promessa que é resolvida quando o formatador é removido.
    */
   async removeCustomValueFormatter(columnName) {
     this._grid.removeCustomValueFormatter(columnName);
   }
   /**
    * 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 {Promise<void>} Uma promessa que é resolvida quando o foco é atribuído.
    */
   async setFocus() {
     this._grid.setFocus();
@@ -207,7 +261,7 @@ export class SnkGrid {
     this.loadConfig();
   }
   handleAddFormMode() {
-    return this.enableGridInsert ? TaskbarElement.FORM_MODE : "";
+    return this.enableGridInsert ? TaskbarElement.FORM_MODE : '';
   }
   openGridConfig() {
     this._grid.getColumnsState()
@@ -251,6 +305,17 @@ export class SnkGrid {
       ConfigStorage.addGridLegacyConfig(this.configName, this.gridLegacyConfigName);
     }
   }
+  hasCalculatedFields(columnNames) {
+    let hasCalculatedFields = false;
+    columnNames.forEach(name => {
+      var _a;
+      const field = this._dataUnit.getField(name);
+      if (((_a = field.properties) === null || _a === void 0 ? void 0 : _a.calculated) === 'true') {
+        hasCalculatedFields = true;
+      }
+    });
+    return hasCalculatedFields;
+  }
   gridConfigChangeHandler(evt) {
     const config = this.normalizeGridConfig(evt.detail);
     ConfigStorage.saveGridConfig(config, this.configName, this.resourceID);
@@ -266,11 +331,25 @@ export class SnkGrid {
     });
     evt.stopPropagation();
   }
+  async hasToForceClientSideExporter() {
+    if (!this._grid) {
+      return false;
+    }
+    const filters = await this._grid.getAppliedColumnFilters();
+    const columnNames = filters.map(filter => filter.name.replace('FILTRO_COLUNA_', ''));
+    return this.hasCalculatedFields(columnNames);
+  }
   async dataExporterProviderStore() {
-    const dataExporterProvider = this.strategyExporter === ExporterStrategy.SERVER_SIDE
-      ? new ServerSideExporterProvider(this._dataUnit, this._grid)
-      : new ClientSideExporterProvider(this._dataUnit, this._grid);
-    store.set("exporterProviders", Object.assign(Object.assign({}, store.get("exporterProviders")), { [this.configName]: dataExporterProvider }));
+    /**
+     * O ServerSideExporterProvider do SankhyaOm não suporta a filtragem de campos calculados.
+     * Por esse motivo, precisamos verificar os filtros aplicados no momento e recriar o dataExporterProvider conforme necessário.
+     * Se houver campos calculados, forçamos o uso do clientSide, caso contrário é seguido o fluxo padrão.
+     */
+    const forceClientSide = await this.hasToForceClientSideExporter();
+    const dataExporterProvider = (forceClientSide || this.strategyExporter === ExporterStrategy.CLIENT_SIDE)
+      ? new ClientSideExporterProvider(this._dataUnit, this._grid)
+      : new ServerSideExporterProvider(this._dataUnit, this._grid);
+    store.set('exporterProviders', Object.assign(Object.assign({}, store.get('exporterProviders')), { [this.configName]: dataExporterProvider }));
   }
   addElementID() {
     const dataInfo = { dataUnit: this._dataUnit };
@@ -291,6 +370,17 @@ export class SnkGrid {
     this.loadGridCustomFormatters(action.payload.fields);
     return action;
   }
+  async interceptLoadData(action) {
+    var _a;
+    const hasInvalidFilters = !validateFilters((_a = this._snkFilterBar) === null || _a === void 0 ? void 0 : _a.filterConfig);
+    if (hasInvalidFilters) {
+      const errorTitle = this.messagesBuilder.getMessage("snkGrid.requiredFiltersNotFilled.title", {});
+      const errorMessage = this.messagesBuilder.getMessage("snkGrid.requiredFiltersNotFilled.message", {});
+      await this._application.error(errorTitle, errorMessage);
+      return;
+    }
+    return action;
+  }
   finishLoading() {
     this._dataUnit.addInterceptor(this.dataUnitInterceptor);
     CrudUtils.assertDefaultSorting(this._gridConfig, this._dataUnit);
@@ -319,15 +409,15 @@ export class SnkGrid {
     }
   }
   componentWillLoad() {
-    this._application = ApplicationContext.getContextValue("__SNK__APPLICATION__");
+    this._application = ApplicationContext.getContextValue('__SNK__APPLICATION__');
     //TODO: substituir pelo metodo nativo closest
     let parent = this._element.parentElement;
     while (parent) {
-      if (parent.tagName.toUpperCase() === "SNK-DATA-UNIT") {
+      if (parent.tagName.toUpperCase() === 'SNK-DATA-UNIT') {
         this._snkDataUnit = parent;
         this._dataUnit = this._snkDataUnit.dataUnit;
         if (!this._dataUnit) {
-          this._snkDataUnit.addEventListener("dataUnitReady", (evt) => {
+          this._snkDataUnit.addEventListener('dataUnitReady', (evt) => {
             this._dataUnit = evt.detail;
             this.finishLoading();
           });
@@ -337,8 +427,8 @@ export class SnkGrid {
         }
         if (!this.messagesBuilder)
           this.messagesBuilder = this._snkDataUnit.messagesBuilder;
-        this._snkDataUnit.addEventListener("dataStateChange", this.handleDataStateChange.bind(this));
-        this._snkDataUnit.addEventListener("cancelEdition", () => {
+        this._snkDataUnit.addEventListener('dataStateChange', this.handleDataStateChange.bind(this));
+        this._snkDataUnit.addEventListener('cancelEdition', () => {
           var _a;
           if ((_a = this._dataState) === null || _a === void 0 ? void 0 : _a.recordsIsEmpty) {
             this._dataUnit.clearSelection();
@@ -401,23 +491,23 @@ export class SnkGrid {
     var _a, _b;
     const hasSelectedRecord = this._dataState && !!((_a = this._dataState.selectionInfo) === null || _a === void 0 ? void 0 : _a.length);
     const taskbarIdPrefixLookup = {
-      primary: this.isDetail ? "snkGridHeaderTaskbar.detail" : "snkGridHeaderTaskbar",
-      secondary: this.isDetail ? "snkGridHeaderTaskbar.detail" : "snkGridHeaderTaskbar",
-      singleTaskbar: this.isDetail ? "snkGridHeaderTaskbar.singleTaskbar.detail" : "snkGridHeaderTaskbar.singleTaskbar"
+      primary: this.isDetail ? 'snkGridHeaderTaskbar.detail' : 'snkGridHeaderTaskbar',
+      secondary: this.isDetail ? 'snkGridHeaderTaskbar.detail' : 'snkGridHeaderTaskbar',
+      singleTaskbar: this.isDetail ? 'snkGridHeaderTaskbar.singleTaskbar.detail' : 'snkGridHeaderTaskbar.singleTaskbar',
     };
     const taskbarIdPrefix = taskbarIdPrefixLookup[this.presentationMode];
     let headerTaskbarId = hasSelectedRecord ? `${taskbarIdPrefix}.selected` : `${taskbarIdPrefix}.unselected`;
     if (((_b = this._dataState) === null || _b === void 0 ? void 0 : _b.isDirty) && this.presentationMode === PresentationMode.SINGLE_TASKBAR) {
-      headerTaskbarId = "snkGridHeaderTaskbar.singleTaskbar.finish_edition";
+      headerTaskbarId = 'snkGridHeaderTaskbar.singleTaskbar.finish_edition';
     }
     return headerTaskbarId;
   }
   getTopTaskBarId() {
     var _a;
     const suffixLookup = {
-      primary: "",
-      secondary: ".secondary",
-      singleTaskbar: ".singleTaskbar"
+      primary: '',
+      secondary: '.secondary',
+      singleTaskbar: '.singleTaskbar',
     };
     const sufix = suffixLookup[this.presentationMode];
     if ((_a = this._dataState) === null || _a === void 0 ? void 0 : _a.isDirty) {
@@ -427,9 +517,9 @@ export class SnkGrid {
   }
   getPrimaryButton() {
     const primaryButtonLookup = {
-      primary: "INSERT",
-      secondary: "",
-      singleTaskbar: "INSERT"
+      primary: 'INSERT',
+      secondary: '',
+      singleTaskbar: 'INSERT',
     };
     return primaryButtonLookup[this.presentationMode];
   }
@@ -469,10 +559,10 @@ export class SnkGrid {
   getActionsSettingsList() {
     const hardList = [{
         value: StringUtils.generateUUID(),
-        label: this.messagesBuilder.getMessage("snkGrid.findColumn", {}),
+        label: this.messagesBuilder.getMessage('snkGrid.findColumn', {}),
         disableCloseOnSelect: true,
         eagerInitialize: true,
-        itemBuilder: (_, item) => this.getColumnSearch(item)
+        itemBuilder: (_, item) => this.getColumnSearch(item),
       }];
     return hardList;
   }
@@ -500,7 +590,9 @@ export class SnkGrid {
       return undefined;
     }
     return (h("div", { class: "snk-grid__container ez-flex ez-flex--column ez-flex-item--auto ez-padding--large ez-box--no-outline", tabindex: "0" }, h("div", { class: "snk-grid__header ez-margin-bottom--extra-small" }, this._showSnkFilterBar &&
-      h(Fragment, null, h("snk-filter-bar", { ref: (ref) => this._snkFilterBar = ref, title: this.filterBarTitle, dataUnit: this._dataUnit, "data-element-id": "gridFilter", class: "snk-grid__filter-bar ez-align--top", configName: this.configName, messagesBuilder: this.messagesBuilder, resourceID: this.resourceID, onConfigUpdated: evt => this.handleFilterConfigUpdated(evt.detail), disablePersonalizedFilter: this.disablePersonalizedFilter, filterBarLegacyConfigName: this.filterBarLegacyConfigName, autoLoad: this.autoLoad, enableLockManagerLoadingComp: this.enableLockManagerLoadingComp }), h("hr", { class: "ez-divider-vertical ez-divider--dark ez-margin-left--medium snk-grid__header-divider" })), h("snk-taskbar", { class: "ez-padding-left--medium ez-padding-top--extra-small", "data-element-id": "grid_top", key: "topTaskbar", configName: this.configName, dataUnit: this._dataUnit, messagesBuilder: this.messagesBuilder, buttons: this._topTaskbarProcessor.buttons, disabledButtons: this._topTaskbarProcessor.disabledButtons, customButtons: this._topTaskbarProcessor.customButtons, primaryButton: this.getPrimaryButton(), resourceID: this.resourceID, customContainerId: this.taskbarCustomContainerId, customSlotId: this.topTaskbarCustomSlotId, overflowStrategy: 'none', actionsSettingsList: this.getActionsSettingsList() }, h("slot", { name: this.topTaskbarCustomSlotId }))), h("ez-grid", { ref: ref => this._grid = ref, class: (this.presentationMode === PresentationMode.SECONDARY ? "snk-grid-container__without-shadow " : "") + "snk-grid__table", "data-element-id": "embedded", dataUnit: this._dataUnit, key: "grid-" + this._snkDataUnit.entityName, config: this._gridConfig, onConfigChange: (evt) => { this.gridConfigChangeHandler(evt); }, onEzDoubleClick: (evt) => this.gridDoubleClick.emit(evt.detail), statusResolver: this.statusResolver, multipleSelection: this.multipleSelection, columnfilterDataSource: this.columnFilterDataSource, selectionToastConfig: this.selectionToastConfig, useEnterLikeTab: this.useEnterLikeTab, recordsValidator: this.recordsValidator, canEdit: this.canEdit, autoFocus: this.autoFocus, enableGridInsert: this.enableGridInsert, enableContinuousInsert: this._enableContinuousInsert, enableLockManagerTaskbarClick: this.enableLockManagerTaskbarClick, enableLockManagerLoadingComp: this.enableLockManagerLoadingComp, outlineMode: this.outlineMode, useSearchColumn: this.useSearchColumn, suppressHorizontalScroll: this.suppressHorizontalScroll, paginationCounterMode: this.paginationCounterMode, suppressCheckboxColumn: this.suppressCheckboxColumn, compact: this.compact }, h("snk-taskbar", { id: 'teste', dataUnit: this._dataUnit, configName: this.configName, messagesBuilder: this.messagesBuilder, "data-element-id": "grid_left", buttons: this.getGridHeaderButtons(), presentationMode: this.presentationMode, disabledButtons: this._headerTaskbarProcessor.disabledButtons, customButtons: this._headerTaskbarProcessor.customButtons, slot: "leftButtons", actionsList: this.getActionsList(), primaryButton: this.getPrimaryButton(), resourceID: this.resourceID, customContainerId: this.taskbarCustomContainerId, customSlotId: this.gridHeaderCustomSlotId, actionsSettingsList: this.getActionsSettingsList() }, h("slot", { name: this.gridHeaderCustomSlotId }))), h("div", { class: "ez-col ez-col--sd-12 snk-grid-container__footer" }, h("slot", { name: "SnkGridFooter" })), h("ez-popup", { size: "medium", heightMode: "auto", useHeader: false, opened: this._popUpGridConfig, onEzClosePopup: () => this.closeGridConfig() }, h("snk-grid-config", { ref: ref => this._snkGridConfig = ref, config: this._gridConfig, "data-element-id": this._element.getAttribute(ElementIDUtils.DATA_ELEMENT_ID_ATTRIBUTE_NAME), selectedIndex: 0, configName: this.configName, onConfigChange: (evt) => this.modalConfigChangeHandler(evt), onConfigCancel: () => this.closeGridConfig(), resourceID: this.resourceID }))));
+      h(Fragment, null, h("snk-filter-bar", { ref: (ref) => this._snkFilterBar = ref, title: this.filterBarTitle, dataUnit: this._dataUnit, "data-element-id": "gridFilter", class: "snk-grid__filter-bar ez-align--top", configName: this.configName, messagesBuilder: this.messagesBuilder, resourceID: this.resourceID, onConfigUpdated: evt => this.handleFilterConfigUpdated(evt.detail), disablePersonalizedFilter: this.disablePersonalizedFilter, filterBarLegacyConfigName: this.filterBarLegacyConfigName, autoLoad: this.autoLoad, enableLockManagerLoadingComp: this.enableLockManagerLoadingComp, filterCustomConfig: this.filterCustomConfig, filterCustomConfigInterceptor: this.filterCustomConfigInterceptor }), h("hr", { class: "ez-divider-vertical ez-divider--dark ez-margin-left--medium snk-grid__header-divider" })), h("snk-taskbar", { class: "ez-padding-left--medium ez-padding-top--extra-small", "data-element-id": "grid_top", key: "topTaskbar", configName: this.configName, dataUnit: this._dataUnit, messagesBuilder: this.messagesBuilder, buttons: this._topTaskbarProcessor.buttons, disabledButtons: this._topTaskbarProcessor.disabledButtons, customButtons: this._topTaskbarProcessor.customButtons, primaryButton: this.getPrimaryButton(), resourceID: this.resourceID, customContainerId: this.taskbarCustomContainerId, customSlotId: this.topTaskbarCustomSlotId, overflowStrategy: 'none', actionsSettingsList: this.getActionsSettingsList() }, h("slot", { name: this.topTaskbarCustomSlotId }))), h("ez-grid", { ref: ref => this._grid = ref, class: (this.presentationMode === PresentationMode.SECONDARY ? 'snk-grid-container__without-shadow ' : '') + 'snk-grid__table', "data-element-id": "embedded", dataUnit: this._dataUnit, key: 'grid-' + this._snkDataUnit.entityName, config: this._gridConfig, onConfigChange: (evt) => {
+        this.gridConfigChangeHandler(evt);
+      }, onEzColumnFilterChanged: async () => await this.dataExporterProviderStore(), onEzDoubleClick: (evt) => this.gridDoubleClick.emit(evt.detail), statusResolver: this.statusResolver, multipleSelection: this.multipleSelection, columnfilterDataSource: this.columnFilterDataSource, selectionToastConfig: this.selectionToastConfig, useEnterLikeTab: this.useEnterLikeTab, recordsValidator: this.recordsValidator, canEdit: this.canEdit, autoFocus: this.autoFocus, enableGridInsert: this.enableGridInsert, enableContinuousInsert: this._enableContinuousInsert, enableLockManagerTaskbarClick: this.enableLockManagerTaskbarClick, enableLockManagerLoadingComp: this.enableLockManagerLoadingComp, outlineMode: this.outlineMode, useSearchColumn: this.useSearchColumn, suppressHorizontalScroll: this.suppressHorizontalScroll, paginationCounterMode: this.paginationCounterMode, suppressCheckboxColumn: this.suppressCheckboxColumn, suppressFilterColumn: this.suppressFilterColumn, compact: this.compact }, h("snk-taskbar", { id: 'teste', dataUnit: this._dataUnit, configName: this.configName, messagesBuilder: this.messagesBuilder, "data-element-id": "grid_left", buttons: this.getGridHeaderButtons(), presentationMode: this.presentationMode, disabledButtons: this._headerTaskbarProcessor.disabledButtons, customButtons: this._headerTaskbarProcessor.customButtons, slot: "leftButtons", actionsList: this.getActionsList(), primaryButton: this.getPrimaryButton(), resourceID: this.resourceID, customContainerId: this.taskbarCustomContainerId, customSlotId: this.gridHeaderCustomSlotId, actionsSettingsList: this.getActionsSettingsList() }, h("slot", { name: this.gridHeaderCustomSlotId }))), h("div", { class: "ez-col ez-col--sd-12 snk-grid-container__footer" }, h("slot", { name: "SnkGridFooter" })), h("ez-popup", { size: "medium", heightMode: "auto", useHeader: false, opened: this._popUpGridConfig, onEzClosePopup: () => this.closeGridConfig() }, h("snk-grid-config", { ref: ref => this._snkGridConfig = ref, config: this._gridConfig, "data-element-id": this._element.getAttribute(ElementIDUtils.DATA_ELEMENT_ID_ATTRIBUTE_NAME), selectedIndex: 0, configName: this.configName, onConfigChange: (evt) => this.modalConfigChangeHandler(evt), onConfigCancel: () => this.closeGridConfig(), resourceID: this.resourceID }))));
   }
   static get is() { return "snk-grid"; }
   static get encapsulation() { return "scoped"; }
@@ -533,7 +625,7 @@ export class SnkGrid {
         "optional": false,
         "docs": {
           "tags": [],
-          "text": ""
+          "text": "Define o data source para o filtro de colunas."
         },
         "defaultValue": "new SnkMultiSelectionListDataSource()"
       },
@@ -549,7 +641,7 @@ export class SnkGrid {
         "optional": true,
         "docs": {
           "tags": [],
-          "text": "Define se o componente deve usar o LockManager para controle de carregamento da aplica\u00E7\u00E3o"
+          "text": "Define se o componente deve usar o LockManager para controle de carregamento da aplica\u00E7\u00E3o."
         },
         "attribute": "enable-lock-manager-loading-comp",
         "reflect": false,
@@ -585,7 +677,7 @@ export class SnkGrid {
         "optional": false,
         "docs": {
           "tags": [],
-          "text": "Nome usado para salvar/recuperar a configura\u00E7\u00E3o."
+          "text": "Nome usado para salvar e recuperar a configura\u00E7\u00E3o da grade."
         },
         "attribute": "config-name",
         "reflect": false
@@ -602,7 +694,7 @@ export class SnkGrid {
         "optional": false,
         "docs": {
           "tags": [],
-          "text": "T\u00EDtulo que ser\u00E1 apresentado na barra de filtros"
+          "text": "T\u00EDtulo que ser\u00E1 apresentado na barra de filtros."
         },
         "attribute": "filter-bar-title",
         "reflect": false
@@ -619,7 +711,7 @@ export class SnkGrid {
         "optional": false,
         "docs": {
           "tags": [],
-          "text": "Identificador de recursos como configura\u00E7\u00F5es e acesso."
+          "text": "Identificador de recursos, como configura\u00E7\u00F5es e permiss\u00F5es de acesso."
         },
         "attribute": "resource-i-d",
         "reflect": false
@@ -641,7 +733,7 @@ export class SnkGrid {
         "optional": false,
         "docs": {
           "tags": [],
-          "text": "Configura\u00E7\u00E3o da sele\u00E7\u00E3o de grade no toast."
+          "text": "Configura\u00E7\u00E3o do toast de sele\u00E7\u00E3o da grade."
         }
       },
       "actionsList": {
@@ -664,7 +756,7 @@ export class SnkGrid {
         "optional": false,
         "docs": {
           "tags": [],
-          "text": "Lista de a\u00E7\u00F5es que devem ser usadas no bot\u00E3o \"Mais op\u00E7\u00F5es\" do componente snk-taskbar."
+          "text": "Lista de a\u00E7\u00F5es que devem ser usadas no bot\u00E3o \"Mais op\u00E7\u00F5es\" do `snk-taskbar`."
         }
       },
       "isDetail": {
@@ -679,7 +771,7 @@ export class SnkGrid {
         "optional": false,
         "docs": {
           "tags": [],
-          "text": "Determina se a grade est\u00E1 vinculada a um detalhe."
+          "text": "Determina se a grade est\u00E1 vinculada a um detalhe de outra tela."
         },
         "attribute": "is-detail",
         "reflect": false
@@ -701,7 +793,7 @@ export class SnkGrid {
         "optional": false,
         "docs": {
           "tags": [],
-          "text": "Gerenciador das barras de tarefas. \u00C9 poss\u00EDvel determinar bot\u00F5es espec\u00EDficos\nou mesmo gerenciar o estado dos bot\u00F5es."
+          "text": "Gerenciador das barras de tarefas. Permite determinar bot\u00F5es espec\u00EDficos\nou gerenciar o estado dos bot\u00F5es."
         }
       },
       "statusResolver": {
@@ -724,8 +816,11 @@ export class SnkGrid {
         "required": false,
         "optional": false,
         "docs": {
-          "tags": [],
-          "text": "Configura\u00E7\u00E3o do valor da coluna de status.\nExemplo: '{ \"RECDESP\": { \"-1\" : \"#BD0025\", \"1\" : \"#157A00\" } }'"
+          "tags": [{
+              "name": "example",
+              "text": "```json\n'{ \"RECDESP\": { \"-1\" : \"#BD0025\", \"1\" : \"#157A00\" } }'\n```"
+            }],
+          "text": "Define a configura\u00E7\u00E3o de cores para a coluna de status."
         }
       },
       "multipleSelection": {
@@ -740,7 +835,7 @@ export class SnkGrid {
         "optional": false,
         "docs": {
           "tags": [],
-          "text": "Determina se pode haver mais de uma linha selecionada."
+          "text": "Determina se a sele\u00E7\u00E3o de m\u00FAltiplas linhas \u00E9 permitida."
         },
         "attribute": "multiple-selection",
         "reflect": false
@@ -762,7 +857,7 @@ export class SnkGrid {
         "optional": false,
         "docs": {
           "tags": [],
-          "text": "Altera o modo de apresenta\u00E7\u00E3o dos bot\u00F5es do snk-taskbar."
+          "text": "Altera o modo de apresenta\u00E7\u00E3o dos bot\u00F5es do `snk-taskbar`."
         },
         "attribute": "presentation-mode",
         "reflect": false,
@@ -800,7 +895,7 @@ export class SnkGrid {
         "optional": false,
         "docs": {
           "tags": [],
-          "text": "Quando verdadeiro, o ENTER far\u00E1 a navega\u00E7\u00E3o como se fosse a tecla TAB na grade."
+          "text": "Quando `true`, a tecla ENTER navega entre as c\u00E9lulas como a tecla TAB."
         },
         "attribute": "use-enter-like-tab",
         "reflect": false,
@@ -823,7 +918,7 @@ export class SnkGrid {
         "optional": false,
         "docs": {
           "tags": [],
-          "text": "Validador respons\u00E1vel por checar a integridade das informa\u00E7\u00F5es do registro."
+          "text": "Validador respons\u00E1vel por verificar a integridade dos dados de um registro."
         }
       },
       "canEdit": {
@@ -838,7 +933,7 @@ export class SnkGrid {
         "optional": false,
         "docs": {
           "tags": [],
-          "text": "Define se a edi\u00E7\u00E3o est\u00E1 habilitada na grid."
+          "text": "Define se a edi\u00E7\u00E3o de dados na grade est\u00E1 habilitada."
         },
         "attribute": "can-edit",
         "reflect": false,
@@ -856,7 +951,7 @@ export class SnkGrid {
         "optional": false,
         "docs": {
           "tags": [],
-          "text": "Define o identificador do container de elementos customizados da Taskbar."
+          "text": "Define o identificador do cont\u00EAiner de elementos customizados da `Taskbar`."
         },
         "attribute": "taskbar-custom-container-id",
         "reflect": false
@@ -873,7 +968,7 @@ export class SnkGrid {
         "optional": false,
         "docs": {
           "tags": [],
-          "text": "Nome do slot de elementos customizados da Taskbar do cabe\u00E7alho da grade."
+          "text": "Define o nome do slot para elementos customizados na `Taskbar` do cabe\u00E7alho da grade."
         },
         "attribute": "grid-header-custom-slot-id",
         "reflect": false,
@@ -891,7 +986,7 @@ export class SnkGrid {
         "optional": false,
         "docs": {
           "tags": [],
-          "text": "Nome do slot de elementos customizados da Taskbar principal do componente."
+          "text": "Define o nome do slot para elementos customizados na `Taskbar` principal do componente."
         },
         "attribute": "top-taskbar-custom-slot-id",
         "reflect": false,
@@ -909,7 +1004,7 @@ export class SnkGrid {
         "optional": false,
         "docs": {
           "tags": [],
-          "text": "Desabilita a apresenta\u00E7\u00E3o da op\u00E7\u00E3o de filtros personalizados na filter bar (chip de filtros)\ne no modal lateral de filtros (container de filtros personalizados)."
+          "text": "Desabilita a apresenta\u00E7\u00E3o da op\u00E7\u00E3o de filtros personalizados na barra de filtros (chip de filtros)\ne no modal lateral de filtros (cont\u00EAiner de filtros personalizados)."
         },
         "attribute": "disable-personalized-filter",
         "reflect": false
@@ -926,7 +1021,7 @@ export class SnkGrid {
         "optional": false,
         "docs": {
           "tags": [],
-          "text": "Chave da configura\u00E7\u00E3o legado da grade."
+          "text": "Chave da configura\u00E7\u00E3o legada da grade."
         },
         "attribute": "grid-legacy-config-name",
         "reflect": false
@@ -943,7 +1038,7 @@ export class SnkGrid {
         "optional": false,
         "docs": {
           "tags": [],
-          "text": "Chave da configura\u00E7\u00E3o legado da barra de filtros."
+          "text": "Chave da configura\u00E7\u00E3o legada da barra de filtros."
         },
         "attribute": "filter-bar-legacy-config-name",
         "reflect": false
@@ -960,7 +1055,7 @@ export class SnkGrid {
         "optional": true,
         "docs": {
           "tags": [],
-          "text": "Define se a carga dos dados ser\u00E1 feita assim que o componente for carregado."
+          "text": "Define se os dados ser\u00E3o carregados automaticamente na inicializa\u00E7\u00E3o do componente."
         },
         "attribute": "auto-load",
         "reflect": false
@@ -977,7 +1072,7 @@ export class SnkGrid {
         "optional": true,
         "docs": {
           "tags": [],
-          "text": "Define se a grid ser\u00E1 focada ao ser carregada."
+          "text": "Define se a grade receber\u00E1 o foco automaticamente ao ser carregada."
         },
         "attribute": "auto-focus",
         "reflect": false,
@@ -995,7 +1090,7 @@ export class SnkGrid {
         "optional": true,
         "docs": {
           "tags": [],
-          "text": "Ativa inser\u00E7\u00E3o de registros no modo grade."
+          "text": "Habilita a inser\u00E7\u00E3o de registros diretamente na grade."
         },
         "attribute": "enable-grid-insert",
         "reflect": false,
@@ -1013,7 +1108,7 @@ export class SnkGrid {
         "optional": true,
         "docs": {
           "tags": [],
-          "text": "Altera visualmente as sombras e bordas do componente\nQuando false, aplica o padr\u00E3o de sombras ao componente (Utilizar quando for o elemento principal do layout)\nQuando true, aplica o padr\u00E3o de outline ao componente (Utilizar quando estiver contido em outro elemento como um painel ou pop-up)"
+          "text": "Altera a apar\u00EAncia das bordas e sombras do componente.\nSe `false`, aplica o padr\u00E3o de sombras (ideal para o elemento principal do layout).\nSe `true`, aplica um contorno (ideal para quando o componente est\u00E1 dentro de outro, como um painel ou pop-up)."
         },
         "attribute": "outline-mode",
         "reflect": false,
@@ -1031,7 +1126,7 @@ export class SnkGrid {
         "optional": false,
         "docs": {
           "tags": [],
-          "text": "Define se a grade deve suprimir o scroll horizontal."
+          "text": "Define se a grade deve suprimir a barra de rolagem horizontal."
         },
         "attribute": "suppress-horizontal-scroll",
         "reflect": false,
@@ -1054,7 +1149,7 @@ export class SnkGrid {
         "optional": false,
         "docs": {
           "tags": [],
-          "text": "Modo de exporta\u00E7\u00E3o dos dados."
+          "text": "Define o modo de exporta\u00E7\u00E3o dos dados."
         },
         "attribute": "strategy-exporter",
         "reflect": false,
@@ -1072,7 +1167,7 @@ export class SnkGrid {
         "optional": false,
         "docs": {
           "tags": [],
-          "text": "Define se a grade deve exibir um buscador de coluna com uso do Ctrl+F"
+          "text": "Define se a grade deve exibir um buscador de colunas ao pressionar `Ctrl+F`."
         },
         "attribute": "use-search-column",
         "reflect": false,
@@ -1090,7 +1185,7 @@ export class SnkGrid {
         "optional": false,
         "docs": {
           "tags": [],
-          "text": "Habilita a edi\u00E7\u00E3o de m\u00FAltiplos registros simult\u00E2neos."
+          "text": "Habilita a edi\u00E7\u00E3o de m\u00FAltiplos registros simultaneamente."
         },
         "attribute": "multiple-edition-enabled",
         "reflect": false,
@@ -1108,7 +1203,7 @@ export class SnkGrid {
         "optional": true,
         "docs": {
           "tags": [],
-          "text": "Define se a grid ser\u00E1 focada ao ser carregada."
+          "text": "Define o modo de exibi\u00E7\u00E3o do contador de pagina\u00E7\u00E3o."
         },
         "attribute": "pagination-counter-mode",
         "reflect": false,
@@ -1126,11 +1221,29 @@ export class SnkGrid {
         "optional": false,
         "docs": {
           "tags": [],
-          "text": "Informa se a coluna de chechbox deve ser suprimida"
+          "text": "Informa se a coluna de checkbox deve ser suprimida."
         },
         "attribute": "suppress-checkbox-column",
         "reflect": false
       },
+      "suppressFilterColumn": {
+        "type": "boolean",
+        "mutable": true,
+        "complexType": {
+          "original": "boolean",
+          "resolved": "boolean",
+          "references": {}
+        },
+        "required": false,
+        "optional": true,
+        "docs": {
+          "tags": [],
+          "text": "Informa se a grade deve suprimir o filtro de coluna."
+        },
+        "attribute": "suppress-filter-column",
+        "reflect": false,
+        "defaultValue": "false"
+      },
       "compact": {
         "type": "boolean",
         "mutable": false,
@@ -1143,10 +1256,71 @@ export class SnkGrid {
         "optional": false,
         "docs": {
           "tags": [],
-          "text": "Define se a grade deve ser exibida em modo compacto"
+          "text": "Define se a grade deve ser exibida em modo compacto."
         },
         "attribute": "compact",
         "reflect": false
+      },
+      "filterCustomConfig": {
+        "type": "unknown",
+        "mutable": false,
+        "complexType": {
+          "original": "Array<SnkFilterItemConfig>",
+          "resolved": "SnkFilterItemConfig[]",
+          "references": {
+            "Array": {
+              "location": "global"
+            },
+            "SnkFilterItemConfig": {
+              "location": "import",
+              "path": "../snk-filter-bar/filter-item/snk-filter-item"
+            }
+          }
+        },
+        "required": false,
+        "optional": true,
+        "docs": {
+          "tags": [{
+              "name": "description",
+              "text": "Configura\u00E7\u00E3o customizada dos filtros."
+            }, {
+              "name": "param",
+              "text": "config - Lista de configura\u00E7\u00F5es de filtros."
+            }],
+          "text": ""
+        }
+      },
+      "filterCustomConfigInterceptor": {
+        "type": "unknown",
+        "mutable": false,
+        "complexType": {
+          "original": "(config: Array<SnkFilterItemConfig>) => Array<SnkFilterItemConfig>",
+          "resolved": "(config: SnkFilterItemConfig[]) => SnkFilterItemConfig[]",
+          "references": {
+            "Array": {
+              "location": "global"
+            },
+            "SnkFilterItemConfig": {
+              "location": "import",
+              "path": "../snk-filter-bar/filter-item/snk-filter-item"
+            }
+          }
+        },
+        "required": false,
+        "optional": true,
+        "docs": {
+          "tags": [{
+              "name": "description",
+              "text": "Intercepta a configura\u00E7\u00E3o dos filtros antes de serem aplicadas."
+            }, {
+              "name": "param",
+              "text": "config - Lista de configura\u00E7\u00F5es de filtros."
+            }, {
+              "name": "returns",
+              "text": "Retorna a lista de configura\u00E7\u00F5es de filtros."
+            }],
+          "text": ""
+        }
       }
     };
   }
@@ -1168,8 +1342,14 @@ export class SnkGrid {
         "cancelable": true,
         "composed": true,
         "docs": {
-          "tags": [],
-          "text": "Emitido sempre que houver click de bot\u00E3o ou a\u00E7\u00E3o."
+          "tags": [{
+              "name": "description",
+              "text": "Este evento \u00E9 acionado quando o usu\u00E1rio clica em um bot\u00E3o de a\u00E7\u00E3o ou item de menu na grade, permitindo a execu\u00E7\u00E3o de a\u00E7\u00F5es espec\u00EDficas."
+            }, {
+              "name": "param",
+              "text": "detail - O identificador da a\u00E7\u00E3o clicada, que pode ser usado para determinar qual a\u00E7\u00E3o executar."
+            }],
+          "text": "Emitido ao clicar em um bot\u00E3o de a\u00E7\u00E3o ou item de menu."
         },
         "complexType": {
           "original": "string",
@@ -1183,8 +1363,14 @@ export class SnkGrid {
         "cancelable": true,
         "composed": true,
         "docs": {
-          "tags": [],
-          "text": "Emitido sempre que houver duplo click na grade."
+          "tags": [{
+              "name": "description",
+              "text": "Este evento \u00E9 acionado quando o usu\u00E1rio clica duas vezes em uma linha da grade, permitindo a\u00E7\u00F5es como edi\u00E7\u00E3o r\u00E1pida ou visualiza\u00E7\u00E3o de detalhes."
+            }, {
+              "name": "param",
+              "text": "detail - Detalhes do evento, contendo a linha clicada."
+            }],
+          "text": "Emitido ao realizar um duplo clique em uma linha da grade."
         },
         "complexType": {
           "original": "any",
@@ -1210,11 +1396,15 @@ export class SnkGrid {
   }
   static get methods() {
     return {
-      "reloadConfig": {
+      "refreshColumnFilterDataSource": {
         "complexType": {
           "signature": "() => Promise<void>",
           "parameters": [],
-          "references": {},
+          "references": {
+            "Promise": {
+              "location": "global"
+            }
+          },
           "return": "Promise<void>"
         },
         "docs": {
@@ -1222,6 +1412,21 @@ export class SnkGrid {
           "tags": []
         }
       },
+      "reloadConfig": {
+        "complexType": {
+          "signature": "() => Promise<void>",
+          "parameters": [],
+          "references": {},
+          "return": "Promise<void>"
+        },
+        "docs": {
+          "text": "Recarrega a configura\u00E7\u00E3o da grade.",
+          "tags": [{
+              "name": "description",
+              "text": "Este m\u00E9todo for\u00E7a o recarregamento da configura\u00E7\u00E3o da grade a partir do `ConfigStorage`. A opera\u00E7\u00E3o \u00E9 ass\u00EDncrona, mas o m\u00E9todo n\u00E3o aguarda sua conclus\u00E3o."
+            }]
+        }
+      },
       "showConfig": {
         "complexType": {
           "signature": "() => Promise<void>",
@@ -1235,7 +1440,16 @@ export class SnkGrid {
         },
         "docs": {
           "text": "Exibe a janela de configura\u00E7\u00F5es da grade.",
-          "tags": []
+          "tags": [{
+              "name": "async",
+              "text": undefined
+            }, {
+              "name": "description",
+              "text": "Este m\u00E9todo abre o pop-up de configura\u00E7\u00E3o de colunas da grade, permitindo ao usu\u00E1rio ajustar a visibilidade, ordem e largura das colunas."
+            }, {
+              "name": "returns",
+              "text": "Uma promessa que \u00E9 resolvida quando a janela de configura\u00E7\u00E3o \u00E9 exibida."
+            }]
         }
       },
       "hideConfig": {
@@ -1251,15 +1465,27 @@ export class SnkGrid {
         },
         "docs": {
           "text": "Fecha a janela de configura\u00E7\u00F5es da grade.",
-          "tags": []
+          "tags": [{
+              "name": "async",
+              "text": undefined
+            }, {
+              "name": "description",
+              "text": "Este m\u00E9todo fecha o pop-up de configura\u00E7\u00E3o de colunas da grade."
+            }, {
+              "name": "returns",
+              "text": "Uma promessa que \u00E9 resolvida quando a janela de configura\u00E7\u00E3o \u00E9 fechada."
+            }]
         }
       },
       "setConfig": {
         "complexType": {
           "signature": "(config: IGridConfig) => Promise<void>",
           "parameters": [{
-              "tags": [],
-              "text": ""
+              "tags": [{
+                  "name": "param",
+                  "text": "config O objeto de configura\u00E7\u00E3o a ser aplicado na grade."
+                }],
+              "text": "O objeto de configura\u00E7\u00E3o a ser aplicado na grade."
             }],
           "references": {
             "Promise": {
@@ -1273,8 +1499,20 @@ export class SnkGrid {
           "return": "Promise<void>"
         },
         "docs": {
-          "text": "Atribui o valor da configura\u00E7\u00E3o da grade.",
-          "tags": []
+          "text": "Define a configura\u00E7\u00E3o da grade.",
+          "tags": [{
+              "name": "async",
+              "text": undefined
+            }, {
+              "name": "description",
+              "text": "Aplica uma nova configura\u00E7\u00E3o de colunas e ordena\u00E7\u00E3o \u00E0 grade."
+            }, {
+              "name": "param",
+              "text": "config O objeto de configura\u00E7\u00E3o a ser aplicado na grade."
+            }, {
+              "name": "returns",
+              "text": "Uma promessa que \u00E9 resolvida quando a configura\u00E7\u00E3o \u00E9 aplicada."
+            }]
         }
       },
       "reloadFilterBar": {
@@ -1289,8 +1527,17 @@ export class SnkGrid {
           "return": "Promise<void>"
         },
         "docs": {
-          "text": "Faz o recarregamento da filter-bar da grade buscando o state no servidor.",
-          "tags": []
+          "text": "Recarrega a barra de filtros da grade, buscando o estado do servidor.",
+          "tags": [{
+              "name": "async",
+              "text": undefined
+            }, {
+              "name": "description",
+              "text": "For\u00E7a o recarregamento da barra de filtros, atualizando suas configura\u00E7\u00F5es e filtros a partir do servidor."
+            }, {
+              "name": "returns",
+              "text": "Uma promessa que \u00E9 resolvida quando a barra de filtros \u00E9 recarregada."
+            }]
         }
       },
       "getFilterBar": {
@@ -1308,22 +1555,40 @@ export class SnkGrid {
           "return": "Promise<HTMLSnkFilterBarElement>"
         },
         "docs": {
-          "text": "Retorna o elemento da filter-bar da grade.",
-          "tags": []
+          "text": "Retorna o elemento da barra de filtros da grade.",
+          "tags": [{
+              "name": "async",
+              "text": undefined
+            }, {
+              "name": "description",
+              "text": "Este m\u00E9todo permite acessar o elemento da barra de filtros, que pode ser \u00FAtil para manipula\u00E7\u00F5es adicionais ou para obter o estado atual dos filtros aplicados."
+            }, {
+              "name": "returns",
+              "text": "O elemento da barra de filtros."
+            }]
         }
       },
       "addCustomEditor": {
         "complexType": {
           "signature": "(fieldName: string, customEditor: ICustomEditor, detailContext?: string) => Promise<void>",
           "parameters": [{
-              "tags": [],
-              "text": ""
+              "tags": [{
+                  "name": "param",
+                  "text": "fieldName O nome do campo que receber\u00E1 o editor customizado."
+                }],
+              "text": "O nome do campo que receber\u00E1 o editor customizado."
             }, {
-              "tags": [],
-              "text": ""
+              "tags": [{
+                  "name": "param",
+                  "text": "customEditor A inst\u00E2ncia do editor customizado."
+                }],
+              "text": "A inst\u00E2ncia do editor customizado."
             }, {
-              "tags": [],
-              "text": ""
+              "tags": [{
+                  "name": "param",
+                  "text": "detailContext O contexto de detalhe onde o editor ser\u00E1 aplicado (opcional)."
+                }],
+              "text": "O contexto de detalhe onde o editor ser\u00E1 aplicado (opcional)."
             }],
           "references": {
             "Promise": {
@@ -1337,22 +1602,49 @@ export class SnkGrid {
           "return": "Promise<void>"
         },
         "docs": {
-          "text": "Registra um editor customizado para campos da grade e formul\u00E1rio",
-          "tags": []
+          "text": "Registra um editor customizado para um campo da grade ou formul\u00E1rio.",
+          "tags": [{
+              "name": "async",
+              "text": undefined
+            }, {
+              "name": "description",
+              "text": "Adiciona um componente de edi\u00E7\u00E3o personalizado para um campo espec\u00EDfico. Este editor ser\u00E1 usado tanto na edi\u00E7\u00E3o em linha na grade quanto em formul\u00E1rios de detalhe."
+            }, {
+              "name": "param",
+              "text": "fieldName O nome do campo que receber\u00E1 o editor customizado."
+            }, {
+              "name": "param",
+              "text": "customEditor A inst\u00E2ncia do editor customizado."
+            }, {
+              "name": "param",
+              "text": "detailContext O contexto de detalhe onde o editor ser\u00E1 aplicado (opcional)."
+            }, {
+              "name": "returns",
+              "text": "Uma promessa que \u00E9 resolvida quando o editor \u00E9 registrado."
+            }]
         }
       },
       "addGridCustomRender": {
         "complexType": {
           "signature": "(fieldName: string, customRender: ICustomRender, detailContext?: string) => Promise<void>",
           "parameters": [{
-              "tags": [],
-              "text": ""
+              "tags": [{
+                  "name": "param",
+                  "text": "fieldName O nome do campo (coluna) que receber\u00E1 o renderizador customizado."
+                }],
+              "text": "O nome do campo (coluna) que receber\u00E1 o renderizador customizado."
             }, {
-              "tags": [],
-              "text": ""
+              "tags": [{
+                  "name": "param",
+                  "text": "customRender A inst\u00E2ncia do renderizador customizado."
+                }],
+              "text": "A inst\u00E2ncia do renderizador customizado."
             }, {
-              "tags": [],
-              "text": ""
+              "tags": [{
+                  "name": "param",
+                  "text": "detailContext O contexto de detalhe onde o renderizador ser\u00E1 aplicado (opcional)."
+                }],
+              "text": "O contexto de detalhe onde o renderizador ser\u00E1 aplicado (opcional)."
             }],
           "references": {
             "Promise": {
@@ -1366,19 +1658,43 @@ export class SnkGrid {
           "return": "Promise<void>"
         },
         "docs": {
-          "text": "Registra um render customizado para colunas da grid.",
-          "tags": []
+          "text": "Registra um renderizador customizado para uma coluna da grade.",
+          "tags": [{
+              "name": "async",
+              "text": undefined
+            }, {
+              "name": "description",
+              "text": "Adiciona um componente de renderiza\u00E7\u00E3o personalizado para uma coluna espec\u00EDfica, permitindo a exibi\u00E7\u00E3o de conte\u00FAdo customizado nas c\u00E9lulas."
+            }, {
+              "name": "param",
+              "text": "fieldName O nome do campo (coluna) que receber\u00E1 o renderizador customizado."
+            }, {
+              "name": "param",
+              "text": "customRender A inst\u00E2ncia do renderizador customizado."
+            }, {
+              "name": "param",
+              "text": "detailContext O contexto de detalhe onde o renderizador ser\u00E1 aplicado (opcional)."
+            }, {
+              "name": "returns",
+              "text": "Uma promessa que \u00E9 resolvida quando o renderizador \u00E9 registrado."
+            }]
         }
       },
       "addCustomValueFormatter": {
         "complexType": {
           "signature": "(columnName: string, customFormatter: ICustomFormatter) => Promise<void>",
           "parameters": [{
-              "tags": [],
-              "text": ""
+              "tags": [{
+                  "name": "param",
+                  "text": "columnName O nome da coluna que receber\u00E1 o formatador."
+                }],
+              "text": "O nome da coluna que receber\u00E1 o formatador."
             }, {
-              "tags": [],
-              "text": ""
+              "tags": [{
+                  "name": "param",
+                  "text": "customFormatter A inst\u00E2ncia do formatador de valor."
+                }],
+              "text": "A inst\u00E2ncia do formatador de valor."
             }],
           "references": {
             "Promise": {
@@ -1392,16 +1708,34 @@ export class SnkGrid {
           "return": "Promise<void>"
         },
         "docs": {
-          "text": "Registra um formatador de valores para uma coluna da grid.",
-          "tags": []
+          "text": "Registra um formatador de valor customizado para uma coluna da grade.",
+          "tags": [{
+              "name": "async",
+              "text": undefined
+            }, {
+              "name": "description",
+              "text": "Adiciona uma fun\u00E7\u00E3o de formata\u00E7\u00E3o personalizada para os valores de uma coluna espec\u00EDfica, afetando como os dados s\u00E3o exibidos."
+            }, {
+              "name": "param",
+              "text": "columnName O nome da coluna que receber\u00E1 o formatador."
+            }, {
+              "name": "param",
+              "text": "customFormatter A inst\u00E2ncia do formatador de valor."
+            }, {
+              "name": "returns",
+              "text": "Uma promessa que \u00E9 resolvida quando o formatador \u00E9 registrado."
+            }]
         }
       },
       "removeCustomValueFormatter": {
         "complexType": {
           "signature": "(columnName: string) => Promise<void>",
           "parameters": [{
-              "tags": [],
-              "text": ""
+              "tags": [{
+                  "name": "param",
+                  "text": "columnName O nome da coluna da qual o formatador ser\u00E1 removido."
+                }],
+              "text": "O nome da coluna da qual o formatador ser\u00E1 removido."
             }],
           "references": {
             "Promise": {
@@ -1411,8 +1745,20 @@ export class SnkGrid {
           "return": "Promise<void>"
         },
         "docs": {
-          "text": "Remove o formatador de valores de uma coluna da grid.",
-          "tags": []
+          "text": "Remove um formatador de valor customizado de uma coluna da grade.",
+          "tags": [{
+              "name": "async",
+              "text": undefined
+            }, {
+              "name": "description",
+              "text": "Remove uma fun\u00E7\u00E3o de formata\u00E7\u00E3o personalizada previamente registrada para uma coluna."
+            }, {
+              "name": "param",
+              "text": "columnName O nome da coluna da qual o formatador ser\u00E1 removido."
+            }, {
+              "name": "returns",
+              "text": "Uma promessa que \u00E9 resolvida quando o formatador \u00E9 removido."
+            }]
         }
       },
       "setFocus": {
@@ -1428,7 +1774,16 @@ export class SnkGrid {
         },
         "docs": {
           "text": "Atribui o foco para a grade.",
-          "tags": []
+          "tags": [{
+              "name": "async",
+              "text": undefined
+            }, {
+              "name": "description",
+              "text": "Move o foco do navegador para o componente da grade, permitindo a navega\u00E7\u00E3o por teclado."
+            }, {
+              "name": "returns",
+              "text": "Uma promessa que \u00E9 resolvida quando o foco \u00E9 atribu\u00EDdo."
+            }]
         }
       }
     };