@sankhyalabs/ezui 7.3.4 → 7.3.5-dev.1

package/dist/collection/components/ez-filter/ez-filter.js

@@ -0,0 +1,1076 @@
+import { Action, DataType, DataUnit, ElementIDUtils, KeyboardManager, } from "@sankhyalabs/core";
+import { Host, h, } from "@stencil/core";
+import DataBinder from "../../utils/form/DataBinder";
+import { buildFormMetadata } from "../../utils/form/FormMetadata";
+import initI18n from "../../utils/i18n";
+/**
+ * Painel lateral de filtros, agnóstico ao contexto de negócio.
+ *
+ * Gera os campos automaticamente a partir da metadata do core (`UnitMetadata` via `DataUnit`),
+ * reutilizando o mesmo motor de dados do formulário (`buildFormMetadata` + `ez-form-view` + `DataBinder`).
+ *
+ * O componente é responsável apenas por estrutura, comportamento e coleta/validação de valores:
+ * ele **emite eventos** de aplicação/remoção/limpeza, deixando a tradução para `Filter`/`QuickFilter`
+ * e a aplicação efetiva (ex.: `dataUnit.loadData(...)`) por conta do consumidor.
+ */
+export class EzFilter {
+  constructor() {
+    this._bound = false;
+    this._loaded = false;
+    this._customFields = new Map();
+    this._pendingEditors = new Map();
+    this.stopInternalChange = (event) => {
+      event.stopPropagation();
+    };
+    this.opened = false;
+    this.interactionMode = "overlay";
+    this.dataUnit = undefined;
+    this.metadata = undefined;
+    this.fields = undefined;
+    this.initialValues = undefined;
+    this.panelTitle = undefined;
+    this.recordValidator = undefined;
+    this.showScrim = true;
+    this.closeOnScrimClick = true;
+    this.closeOnEsc = true;
+    this.applyOnEnter = true;
+    this.clearButtonLabel = undefined;
+    this.applyButtonLabel = undefined;
+    this._viewFields = [];
+  }
+  /**
+   * Abre o painel de filtros.
+   */
+  async open() {
+    this.opened = true;
+  }
+  /**
+   * Fecha o painel de filtros.
+   */
+  async close() {
+    this.opened = false;
+  }
+  /**
+   * Alterna o estado de abertura do painel.
+   */
+  async toggle() {
+    this.opened = !this.opened;
+  }
+  /**
+   * Altera o valor de um filtro.
+   * @param fieldName - Nome do campo.
+   * @param value - Novo valor.
+   */
+  async setFieldValue(fieldName, value) {
+    var _a;
+    await this.ensureRecord();
+    (_a = this.dataUnit) === null || _a === void 0 ? void 0 : _a.setFieldValue(fieldName, value);
+  }
+  /**
+   * Retorna os valores atuais dos filtros preenchidos.
+   * @returns Mapa `nomeDoCampo` → `valor`.
+   */
+  async getValues() {
+    return this.collectValues();
+  }
+  /**
+   * Limpa todos os filtros (esvazia o valor de cada campo) e emite `ezClearFilter`.
+   */
+  async clear() {
+    const dataUnit = this.dataUnit;
+    if (dataUnit) {
+      await this.ensureRecord();
+      this.getFieldNames().forEach((name) => dataUnit.setFieldValue(name, null));
+    }
+    this.ezClearFilter.emit();
+  }
+  /**
+   * Remove um filtro específico (limpa seu valor) e emite `ezRemoveFilter`.
+   * @param fieldName - Nome do campo a remover.
+   */
+  async removeFilter(fieldName) {
+    await this.setFieldValue(fieldName, null);
+    this.ezRemoveFilter.emit({ fieldName });
+  }
+  /**
+   * Valida os filtros (campos obrigatórios e validador customizado).
+   * @returns `true` quando válido; `false` caso contrário.
+   */
+  async validate() {
+    if (!this._bound || !this._dataBinder) {
+      return true;
+    }
+    try {
+      await this._dataBinder.validate();
+      return true;
+    }
+    catch (_a) {
+      return false;
+    }
+  }
+  /**
+   * Valida e, quando válido, emite `ezApplyFilter` com os valores atuais.
+   * @returns `true` quando aplicado; `false` quando bloqueado pela validação.
+   */
+  async apply() {
+    const isValid = await this.validate();
+    if (!isValid) {
+      return false;
+    }
+    this.ezApplyFilter.emit({ values: this.collectValues() });
+    return true;
+  }
+  /**
+   * Registra um editor customizado para um campo já existente na metadata.
+   * @param fieldName - Nome do campo.
+   * @param editor - Editor customizado.
+   */
+  async addCustomEditor(fieldName, editor) {
+    if (this._formView) {
+      await this._formView.addCustomEditor(fieldName, editor);
+      return;
+    }
+    this._pendingEditors.set(fieldName, editor);
+  }
+  /**
+   * Adiciona um campo customizado que não existe na metadata padrão do core.
+   * @param field - Definição do campo customizado.
+   */
+  async registerCustomField(field) {
+    var _a;
+    this._customFields.set(field.name, field);
+    if (this.dataUnit && !this.dataUnit.getField(field.name)) {
+      this.dataUnit.addField({
+        name: field.name,
+        label: field.label,
+        dataType: (_a = field.dataType) !== null && _a !== void 0 ? _a : DataType.TEXT,
+        userInterface: field.userInterface,
+        required: field.required,
+      });
+    }
+    if (field.editor) {
+      this._pendingEditors.set(field.name, field.editor);
+    }
+    this.rebuildMetadata();
+    if (field.defaultValue !== undefined) {
+      await this.setFieldValue(field.name, field.defaultValue);
+    }
+  }
+  watchMetadata() {
+    if (!this.dataUnit) {
+      return;
+    }
+    if (this.metadata) {
+      this.dataUnit.metadata = this.metadata;
+    }
+    this.rebuildMetadata();
+  }
+  async watchInitialValues() {
+    await this.applyInitialValues();
+  }
+  async watchDataUnit(newDataUnit, oldDataUnit) {
+    var _a;
+    // Durante o load inicial o wiring é feito por componentWillLoad; evita init duplo.
+    if (!this._loaded || newDataUnit === oldDataUnit) {
+      return;
+    }
+    if (this._duObserver && oldDataUnit) {
+      oldDataUnit.unsubscribe(this._duObserver);
+    }
+    (_a = this._dataBinder) === null || _a === void 0 ? void 0 : _a.onDisconnectedCallback();
+    this._dataBinder = undefined;
+    this._bound = false;
+    if (!newDataUnit) {
+      this._viewFields = [];
+      return;
+    }
+    if (this.metadata && !newDataUnit.metadata) {
+      newDataUnit.metadata = this.metadata;
+    }
+    await this.ensureRecord();
+    this._dataBinder = new DataBinder(newDataUnit);
+    this.subscribeDataUnit();
+    this.rebuildMetadata();
+    await this.applyInitialValues();
+  }
+  watchOpened(opened) {
+    if (opened) {
+      this._previousFocus = document.activeElement;
+      this.lockScroll(true);
+      this.ezOpen.emit();
+      requestAnimationFrame(() => this.focusPanel());
+    }
+    else {
+      this.lockScroll(false);
+      this.ezClose.emit();
+      this.restoreFocus();
+    }
+  }
+  async componentWillLoad() {
+    this._i18n = await initI18n();
+    await this.ensureDataUnit();
+    this._dataBinder = new DataBinder(this.dataUnit);
+    this.subscribeDataUnit();
+    this.rebuildMetadata();
+    await this.applyInitialValues();
+  }
+  componentDidLoad() {
+    var _a;
+    this._loaded = true;
+    // Os inputs internos emitem `ezChange` (composed + bubbles). Como o ez-filter tem um
+    // evento público de mesmo nome, o evento interno vazaria do Shadow DOM e chegaria ao
+    // consumidor como um segundo `ezChange` com detalhe inválido. Barramos a propagação no
+    // corpo do painel; o DataBinder ouve no próprio campo (fase de destino), então continua
+    // capturando, e o ez-filter re-emite `ezChange` a partir do host com o detalhe correto.
+    (_a = this._bodyElement) === null || _a === void 0 ? void 0 : _a.addEventListener("ezChange", this.stopInternalChange);
+    this.initKeyboardManager();
+    this.addInfoId();
+    if (this.opened) {
+      this.lockScroll(true);
+    }
+  }
+  disconnectedCallback() {
+    var _a, _b, _c, _d;
+    if (this._duObserver) {
+      (_a = this.dataUnit) === null || _a === void 0 ? void 0 : _a.unsubscribe(this._duObserver);
+    }
+    (_b = this._bodyElement) === null || _b === void 0 ? void 0 : _b.removeEventListener("ezChange", this.stopInternalChange);
+    (_c = this._dataBinder) === null || _c === void 0 ? void 0 : _c.onDisconnectedCallback();
+    (_d = this._keyboardManager) === null || _d === void 0 ? void 0 : _d.unbindAllShortcutKeys();
+    this.lockScroll(false);
+  }
+  async ensureDataUnit() {
+    if (!this.dataUnit) {
+      this.dataUnit = new DataUnit("ez-filter");
+    }
+    if (this.metadata && !this.dataUnit.metadata) {
+      this.dataUnit.metadata = this.metadata;
+    }
+    await this.ensureRecord();
+  }
+  async ensureRecord() {
+    var _a, _b;
+    if (this.dataUnit && ((_b = (_a = this.dataUnit.records) === null || _a === void 0 ? void 0 : _a.length) !== null && _b !== void 0 ? _b : 0) === 0) {
+      await this.dataUnit.addRecord();
+      this.dataUnit.selectFirst();
+    }
+  }
+  subscribeDataUnit() {
+    var _a;
+    this._duObserver = (action) => {
+      var _a, _b;
+      if ((action === null || action === void 0 ? void 0 : action.type) === Action.DATA_CHANGED) {
+        const fieldName = Object.keys((_a = action.payload) !== null && _a !== void 0 ? _a : {})[0];
+        if (fieldName) {
+          this.ezChange.emit({ fieldName, value: (_b = this.dataUnit) === null || _b === void 0 ? void 0 : _b.getFieldValue(fieldName) });
+        }
+      }
+      else if ((action === null || action === void 0 ? void 0 : action.type) === Action.METADATA_LOADED) {
+        // `addField` (com interceptor ativo) e carregamentos assíncronos de metadata
+        // aplicam a mudança de forma deferida, emitindo METADATA_LOADED. Reconstruímos
+        // os campos aqui para que campos customizados/assíncronos apareçam no mesmo ciclo.
+        this.rebuildMetadata();
+      }
+    };
+    (_a = this.dataUnit) === null || _a === void 0 ? void 0 : _a.subscribe(this._duObserver);
+  }
+  rebuildMetadata() {
+    var _a;
+    if (!((_a = this.dataUnit) === null || _a === void 0 ? void 0 : _a.metadata)) {
+      this._viewFields = [];
+      return;
+    }
+    const config = this.fields
+      ? { emptyConfig: false, fields: this.fields }
+      : { emptyConfig: true, fields: [] };
+    this._formMetadata = buildFormMetadata(config, this.dataUnit);
+    this._viewFields = this.flattenFields(this._formMetadata);
+  }
+  flattenFields(metadata) {
+    const result = [];
+    metadata.getAllSheets().forEach((sheet) => {
+      if (sheet.fields) {
+        result.push(...sheet.fields);
+      }
+    });
+    return result;
+  }
+  async applyInitialValues() {
+    if (!this.initialValues || !this.dataUnit) {
+      return;
+    }
+    await this.ensureRecord();
+    Object.entries(this.initialValues).forEach(([fieldName, value]) => {
+      var _a;
+      (_a = this.dataUnit) === null || _a === void 0 ? void 0 : _a.setFieldValue(fieldName, value);
+    });
+  }
+  onContentReady(fieldElements) {
+    if (!this._dataBinder || !this._formMetadata || !this.dataUnit) {
+      return;
+    }
+    this._dataBinder.bind(fieldElements, this.dataUnit.dataUnitId, this._formMetadata, this.recordValidator);
+    this._bound = true;
+    this.flushPendingEditors();
+  }
+  flushPendingEditors() {
+    if (!this._formView) {
+      return;
+    }
+    this._pendingEditors.forEach((editor, fieldName) => {
+      var _a;
+      (_a = this._formView) === null || _a === void 0 ? void 0 : _a.addCustomEditor(fieldName, editor);
+      this._pendingEditors.delete(fieldName);
+    });
+  }
+  getFieldNames() {
+    const names = new Set();
+    this._viewFields.forEach((field) => names.add(field.name));
+    this._customFields.forEach((_field, name) => names.add(name));
+    return Array.from(names);
+  }
+  collectValues() {
+    const values = {};
+    if (!this.dataUnit) {
+      return values;
+    }
+    this.getFieldNames().forEach((name) => {
+      var _a;
+      const value = (_a = this.dataUnit) === null || _a === void 0 ? void 0 : _a.getFieldValue(name);
+      if (value !== undefined && value !== null && value !== "") {
+        values[name] = value;
+      }
+    });
+    return values;
+  }
+  onScrimClick() {
+    if (this.closeOnScrimClick) {
+      this.close();
+    }
+  }
+  lockScroll(lock) {
+    if (this.interactionMode !== "overlay") {
+      return;
+    }
+    document.body.style.overflow = lock ? "hidden" : "";
+  }
+  focusPanel() {
+    var _a, _b;
+    (_b = (_a = this._element.shadowRoot) === null || _a === void 0 ? void 0 : _a.querySelector(".ez-filter__panel")) === null || _b === void 0 ? void 0 : _b.focus();
+  }
+  restoreFocus() {
+    var _a;
+    if (typeof ((_a = this._previousFocus) === null || _a === void 0 ? void 0 : _a.focus) === "function") {
+      this._previousFocus.focus();
+    }
+    this._previousFocus = undefined;
+  }
+  initKeyboardManager() {
+    this._keyboardManager = new KeyboardManager({
+      propagate: false,
+      element: this._element,
+      enableShadowDom: true,
+    })
+      .bind("Escape", () => this.onEscape())
+      .bind("Esc", () => this.onEscape());
+    if (this.applyOnEnter) {
+      this._keyboardManager.bind("Enter", () => {
+        if (this.opened) {
+          this.apply();
+        }
+      });
+    }
+  }
+  onEscape() {
+    if (this.opened && this.closeOnEsc) {
+      this.close();
+    }
+  }
+  addInfoId() {
+    if (this._element) {
+      ElementIDUtils.addIDInfo(this._element);
+    }
+  }
+  getTitle() {
+    var _a, _b, _c;
+    return (_c = (_a = this.panelTitle) !== null && _a !== void 0 ? _a : (_b = this._i18n) === null || _b === void 0 ? void 0 : _b.call(this, "ez-filter.title")) !== null && _c !== void 0 ? _c : "";
+  }
+  render() {
+    var _a, _b, _c, _d, _e, _f, _g;
+    const title = this.getTitle();
+    const isOverlay = this.interactionMode === "overlay";
+    return (h(Host, null, isOverlay && this.showScrim && this.opened && (h("div", { class: "ez-filter__scrim", part: "scrim", onClick: () => this.onScrimClick() })), h("aside", { class: {
+        "ez-filter__panel": true,
+        "ez-filter__panel--overlay": isOverlay,
+        "ez-filter__panel--push": !isOverlay,
+        "ez-filter__panel--opened": this.opened,
+      }, part: "panel", role: "complementary", "aria-label": title, "aria-hidden": (!this.opened).toString(), tabindex: "-1" }, h("header", { class: "ez-filter__header", part: "header" }, h("h2", { class: "ez-filter__title", part: "title" }, title), h("ez-button", { class: "ez-filter__close", mode: "icon", iconName: "close", "aria-label": (_a = this._i18n) === null || _a === void 0 ? void 0 : _a.call(this, "app.close"), onClick: () => this.close() })), h("div", { class: "ez-filter__body", part: "body", ref: (el) => (this._bodyElement = el) }, h("ez-form-view", { ref: (element) => (this._formView = element), fields: this._viewFields, singleColumn: true, selectedRecord: (_c = (_b = this.dataUnit) === null || _b === void 0 ? void 0 : _b.getSelectedRecord) === null || _c === void 0 ? void 0 : _c.call(_b), onEzContentReady: (evt) => this.onContentReady(evt.detail) }), h("slot", { name: "custom-fields" })), h("footer", { class: "ez-filter__footer", part: "footer" }, h("ez-button", { class: "ez-filter__clear", variant: "tertiary", label: (_d = this.clearButtonLabel) !== null && _d !== void 0 ? _d : (_e = this._i18n) === null || _e === void 0 ? void 0 : _e.call(this, "ez-filter.clear"), onClick: () => this.clear() }), h("ez-button", { class: "ez-filter__apply", variant: "primary", label: (_f = this.applyButtonLabel) !== null && _f !== void 0 ? _f : (_g = this._i18n) === null || _g === void 0 ? void 0 : _g.call(this, "ez-filter.apply"), onClick: () => this.apply() })))));
+  }
+  static get is() { return "ez-filter"; }
+  static get encapsulation() { return "shadow"; }
+  static get originalStyleUrls() {
+    return {
+      "$": ["ez-filter.css"]
+    };
+  }
+  static get styleUrls() {
+    return {
+      "$": ["ez-filter.css"]
+    };
+  }
+  static get properties() {
+    return {
+      "opened": {
+        "type": "boolean",
+        "mutable": true,
+        "complexType": {
+          "original": "boolean",
+          "resolved": "boolean",
+          "references": {}
+        },
+        "required": false,
+        "optional": false,
+        "docs": {
+          "tags": [{
+              "name": "default",
+              "text": "false"
+            }],
+          "text": "Define se o painel est\u00E1 aberto."
+        },
+        "attribute": "opened",
+        "reflect": true,
+        "defaultValue": "false"
+      },
+      "interactionMode": {
+        "type": "string",
+        "mutable": false,
+        "complexType": {
+          "original": "\"overlay\" | \"push\"",
+          "resolved": "\"overlay\" | \"push\"",
+          "references": {}
+        },
+        "required": false,
+        "optional": false,
+        "docs": {
+          "tags": [{
+              "name": "default",
+              "text": "'overlay'"
+            }],
+          "text": "Define como o painel interage com o conte\u00FAdo principal.\n- `overlay`: sobrep\u00F5e o conte\u00FAdo, sem alterar o layout da p\u00E1gina.\n- `push`: ocupa espa\u00E7o no fluxo, deslocando (empurrando) o conte\u00FAdo irm\u00E3o."
+        },
+        "attribute": "interaction-mode",
+        "reflect": true,
+        "defaultValue": "\"overlay\""
+      },
+      "dataUnit": {
+        "type": "unknown",
+        "mutable": true,
+        "complexType": {
+          "original": "DataUnit",
+          "resolved": "DataUnit",
+          "references": {
+            "DataUnit": {
+              "location": "import",
+              "path": "@sankhyalabs/core"
+            }
+          }
+        },
+        "required": false,
+        "optional": true,
+        "docs": {
+          "tags": [],
+          "text": "Unidade de dados que controla os valores e a metadata dos filtros.\nQuando ausente, o componente cria uma inst\u00E2ncia interna."
+        }
+      },
+      "metadata": {
+        "type": "unknown",
+        "mutable": false,
+        "complexType": {
+          "original": "UnitMetadata",
+          "resolved": "UnitMetadata",
+          "references": {
+            "UnitMetadata": {
+              "location": "import",
+              "path": "@sankhyalabs/core"
+            }
+          }
+        },
+        "required": false,
+        "optional": true,
+        "docs": {
+          "tags": [],
+          "text": "Metadata do core usada para gerar os campos. Alternativa a fornecer um `dataUnit` j\u00E1 carregado."
+        }
+      },
+      "fields": {
+        "type": "unknown",
+        "mutable": false,
+        "complexType": {
+          "original": "Array<IFieldConfig>",
+          "resolved": "IFieldConfig[]",
+          "references": {
+            "Array": {
+              "location": "global"
+            },
+            "IFieldConfig": {
+              "location": "import",
+              "path": "../../utils/form/interfaces"
+            }
+          }
+        },
+        "required": false,
+        "optional": true,
+        "docs": {
+          "tags": [],
+          "text": "Sele\u00E7\u00E3o, ordem e sobrescrita (label, obrigatoriedade, valor padr\u00E3o) dos campos.\nQuando ausente, todos os campos vis\u00EDveis da metadata s\u00E3o apresentados."
+        }
+      },
+      "initialValues": {
+        "type": "unknown",
+        "mutable": false,
+        "complexType": {
+          "original": "{ [fieldName: string]: any }",
+          "resolved": "{ [fieldName: string]: any; }",
+          "references": {}
+        },
+        "required": false,
+        "optional": true,
+        "docs": {
+          "tags": [],
+          "text": "Valores iniciais dos filtros, no formato `{ nomeDoCampo: valor }`."
+        }
+      },
+      "panelTitle": {
+        "type": "string",
+        "mutable": false,
+        "complexType": {
+          "original": "string",
+          "resolved": "string",
+          "references": {}
+        },
+        "required": false,
+        "optional": true,
+        "docs": {
+          "tags": [{
+              "name": "default",
+              "text": "i18n('ez-filter.title')"
+            }],
+          "text": "T\u00EDtulo exibido no cabe\u00E7alho do painel."
+        },
+        "attribute": "panel-title",
+        "reflect": false
+      },
+      "recordValidator": {
+        "type": "unknown",
+        "mutable": false,
+        "complexType": {
+          "original": "IRecordValidator",
+          "resolved": "IRecordValidator",
+          "references": {
+            "IRecordValidator": {
+              "location": "import",
+              "path": "../../utils/form/interfaces"
+            }
+          }
+        },
+        "required": false,
+        "optional": true,
+        "docs": {
+          "tags": [],
+          "text": "Validador customizado respons\u00E1vel pela integridade dos filtros."
+        }
+      },
+      "showScrim": {
+        "type": "boolean",
+        "mutable": false,
+        "complexType": {
+          "original": "boolean",
+          "resolved": "boolean",
+          "references": {}
+        },
+        "required": false,
+        "optional": false,
+        "docs": {
+          "tags": [{
+              "name": "default",
+              "text": "true"
+            }],
+          "text": "Exibe o backdrop (scrim) no modo `overlay`."
+        },
+        "attribute": "show-scrim",
+        "reflect": false,
+        "defaultValue": "true"
+      },
+      "closeOnScrimClick": {
+        "type": "boolean",
+        "mutable": false,
+        "complexType": {
+          "original": "boolean",
+          "resolved": "boolean",
+          "references": {}
+        },
+        "required": false,
+        "optional": false,
+        "docs": {
+          "tags": [{
+              "name": "default",
+              "text": "true"
+            }],
+          "text": "Fecha o painel ao clicar no backdrop (modo `overlay`)."
+        },
+        "attribute": "close-on-scrim-click",
+        "reflect": false,
+        "defaultValue": "true"
+      },
+      "closeOnEsc": {
+        "type": "boolean",
+        "mutable": false,
+        "complexType": {
+          "original": "boolean",
+          "resolved": "boolean",
+          "references": {}
+        },
+        "required": false,
+        "optional": false,
+        "docs": {
+          "tags": [{
+              "name": "default",
+              "text": "true"
+            }],
+          "text": "Fecha o painel ao pressionar `Esc`."
+        },
+        "attribute": "close-on-esc",
+        "reflect": false,
+        "defaultValue": "true"
+      },
+      "applyOnEnter": {
+        "type": "boolean",
+        "mutable": false,
+        "complexType": {
+          "original": "boolean",
+          "resolved": "boolean",
+          "references": {}
+        },
+        "required": false,
+        "optional": false,
+        "docs": {
+          "tags": [{
+              "name": "default",
+              "text": "true"
+            }],
+          "text": "Aplica os filtros ao pressionar `Enter` com o painel aberto."
+        },
+        "attribute": "apply-on-enter",
+        "reflect": false,
+        "defaultValue": "true"
+      },
+      "clearButtonLabel": {
+        "type": "string",
+        "mutable": false,
+        "complexType": {
+          "original": "string",
+          "resolved": "string",
+          "references": {}
+        },
+        "required": false,
+        "optional": true,
+        "docs": {
+          "tags": [],
+          "text": "R\u00F3tulo do bot\u00E3o de limpar filtros."
+        },
+        "attribute": "clear-button-label",
+        "reflect": false
+      },
+      "applyButtonLabel": {
+        "type": "string",
+        "mutable": false,
+        "complexType": {
+          "original": "string",
+          "resolved": "string",
+          "references": {}
+        },
+        "required": false,
+        "optional": true,
+        "docs": {
+          "tags": [],
+          "text": "R\u00F3tulo do bot\u00E3o de aplicar filtros."
+        },
+        "attribute": "apply-button-label",
+        "reflect": false
+      }
+    };
+  }
+  static get states() {
+    return {
+      "_viewFields": {}
+    };
+  }
+  static get events() {
+    return [{
+        "method": "ezApplyFilter",
+        "name": "ezApplyFilter",
+        "bubbles": true,
+        "cancelable": true,
+        "composed": true,
+        "docs": {
+          "tags": [],
+          "text": "Emitido ao aplicar os filtros (ap\u00F3s a valida\u00E7\u00E3o)."
+        },
+        "complexType": {
+          "original": "IFilterChange",
+          "resolved": "IFilterChange",
+          "references": {
+            "IFilterChange": {
+              "location": "import",
+              "path": "./interfaces"
+            }
+          }
+        }
+      }, {
+        "method": "ezClearFilter",
+        "name": "ezClearFilter",
+        "bubbles": true,
+        "cancelable": true,
+        "composed": true,
+        "docs": {
+          "tags": [],
+          "text": "Emitido ao limpar todos os filtros."
+        },
+        "complexType": {
+          "original": "void",
+          "resolved": "void",
+          "references": {}
+        }
+      }, {
+        "method": "ezRemoveFilter",
+        "name": "ezRemoveFilter",
+        "bubbles": true,
+        "cancelable": true,
+        "composed": true,
+        "docs": {
+          "tags": [],
+          "text": "Emitido ao remover um filtro espec\u00EDfico."
+        },
+        "complexType": {
+          "original": "{ fieldName: string }",
+          "resolved": "{ fieldName: string; }",
+          "references": {}
+        }
+      }, {
+        "method": "ezChange",
+        "name": "ezChange",
+        "bubbles": true,
+        "cancelable": true,
+        "composed": true,
+        "docs": {
+          "tags": [],
+          "text": "Emitido quando o valor de um campo do filtro \u00E9 alterado."
+        },
+        "complexType": {
+          "original": "{ fieldName: string; value: any }",
+          "resolved": "{ fieldName: string; value: any; }",
+          "references": {}
+        }
+      }, {
+        "method": "ezOpen",
+        "name": "ezOpen",
+        "bubbles": true,
+        "cancelable": true,
+        "composed": true,
+        "docs": {
+          "tags": [],
+          "text": "Emitido quando o painel \u00E9 aberto."
+        },
+        "complexType": {
+          "original": "void",
+          "resolved": "void",
+          "references": {}
+        }
+      }, {
+        "method": "ezClose",
+        "name": "ezClose",
+        "bubbles": true,
+        "cancelable": true,
+        "composed": true,
+        "docs": {
+          "tags": [],
+          "text": "Emitido quando o painel \u00E9 fechado."
+        },
+        "complexType": {
+          "original": "void",
+          "resolved": "void",
+          "references": {}
+        }
+      }];
+  }
+  static get methods() {
+    return {
+      "open": {
+        "complexType": {
+          "signature": "() => Promise<void>",
+          "parameters": [],
+          "references": {
+            "Promise": {
+              "location": "global"
+            }
+          },
+          "return": "Promise<void>"
+        },
+        "docs": {
+          "text": "Abre o painel de filtros.",
+          "tags": []
+        }
+      },
+      "close": {
+        "complexType": {
+          "signature": "() => Promise<void>",
+          "parameters": [],
+          "references": {
+            "Promise": {
+              "location": "global"
+            }
+          },
+          "return": "Promise<void>"
+        },
+        "docs": {
+          "text": "Fecha o painel de filtros.",
+          "tags": []
+        }
+      },
+      "toggle": {
+        "complexType": {
+          "signature": "() => Promise<void>",
+          "parameters": [],
+          "references": {
+            "Promise": {
+              "location": "global"
+            }
+          },
+          "return": "Promise<void>"
+        },
+        "docs": {
+          "text": "Alterna o estado de abertura do painel.",
+          "tags": []
+        }
+      },
+      "setFieldValue": {
+        "complexType": {
+          "signature": "(fieldName: string, value: any) => Promise<void>",
+          "parameters": [{
+              "tags": [{
+                  "name": "param",
+                  "text": "fieldName - Nome do campo."
+                }],
+              "text": "- Nome do campo."
+            }, {
+              "tags": [{
+                  "name": "param",
+                  "text": "value - Novo valor."
+                }],
+              "text": "- Novo valor."
+            }],
+          "references": {
+            "Promise": {
+              "location": "global"
+            }
+          },
+          "return": "Promise<void>"
+        },
+        "docs": {
+          "text": "Altera o valor de um filtro.",
+          "tags": [{
+              "name": "param",
+              "text": "fieldName - Nome do campo."
+            }, {
+              "name": "param",
+              "text": "value - Novo valor."
+            }]
+        }
+      },
+      "getValues": {
+        "complexType": {
+          "signature": "() => Promise<{ [fieldName: string]: any; }>",
+          "parameters": [],
+          "references": {
+            "Promise": {
+              "location": "global"
+            }
+          },
+          "return": "Promise<{ [fieldName: string]: any; }>"
+        },
+        "docs": {
+          "text": "Retorna os valores atuais dos filtros preenchidos.",
+          "tags": [{
+              "name": "returns",
+              "text": "Mapa `nomeDoCampo` \u2192 `valor`."
+            }]
+        }
+      },
+      "clear": {
+        "complexType": {
+          "signature": "() => Promise<void>",
+          "parameters": [],
+          "references": {
+            "Promise": {
+              "location": "global"
+            }
+          },
+          "return": "Promise<void>"
+        },
+        "docs": {
+          "text": "Limpa todos os filtros (esvazia o valor de cada campo) e emite `ezClearFilter`.",
+          "tags": []
+        }
+      },
+      "removeFilter": {
+        "complexType": {
+          "signature": "(fieldName: string) => Promise<void>",
+          "parameters": [{
+              "tags": [{
+                  "name": "param",
+                  "text": "fieldName - Nome do campo a remover."
+                }],
+              "text": "- Nome do campo a remover."
+            }],
+          "references": {
+            "Promise": {
+              "location": "global"
+            }
+          },
+          "return": "Promise<void>"
+        },
+        "docs": {
+          "text": "Remove um filtro espec\u00EDfico (limpa seu valor) e emite `ezRemoveFilter`.",
+          "tags": [{
+              "name": "param",
+              "text": "fieldName - Nome do campo a remover."
+            }]
+        }
+      },
+      "validate": {
+        "complexType": {
+          "signature": "() => Promise<boolean>",
+          "parameters": [],
+          "references": {
+            "Promise": {
+              "location": "global"
+            }
+          },
+          "return": "Promise<boolean>"
+        },
+        "docs": {
+          "text": "Valida os filtros (campos obrigat\u00F3rios e validador customizado).",
+          "tags": [{
+              "name": "returns",
+              "text": "`true` quando v\u00E1lido; `false` caso contr\u00E1rio."
+            }]
+        }
+      },
+      "apply": {
+        "complexType": {
+          "signature": "() => Promise<boolean>",
+          "parameters": [],
+          "references": {
+            "Promise": {
+              "location": "global"
+            }
+          },
+          "return": "Promise<boolean>"
+        },
+        "docs": {
+          "text": "Valida e, quando v\u00E1lido, emite `ezApplyFilter` com os valores atuais.",
+          "tags": [{
+              "name": "returns",
+              "text": "`true` quando aplicado; `false` quando bloqueado pela valida\u00E7\u00E3o."
+            }]
+        }
+      },
+      "addCustomEditor": {
+        "complexType": {
+          "signature": "(fieldName: string, editor: ICustomEditor) => Promise<void>",
+          "parameters": [{
+              "tags": [{
+                  "name": "param",
+                  "text": "fieldName - Nome do campo."
+                }],
+              "text": "- Nome do campo."
+            }, {
+              "tags": [{
+                  "name": "param",
+                  "text": "editor - Editor customizado."
+                }],
+              "text": "- Editor customizado."
+            }],
+          "references": {
+            "Promise": {
+              "location": "global"
+            },
+            "ICustomEditor": {
+              "location": "import",
+              "path": "../../utils/customEditor/interfaces/ICustomEditor"
+            }
+          },
+          "return": "Promise<void>"
+        },
+        "docs": {
+          "text": "Registra um editor customizado para um campo j\u00E1 existente na metadata.",
+          "tags": [{
+              "name": "param",
+              "text": "fieldName - Nome do campo."
+            }, {
+              "name": "param",
+              "text": "editor - Editor customizado."
+            }]
+        }
+      },
+      "registerCustomField": {
+        "complexType": {
+          "signature": "(field: IFilterCustomField) => Promise<void>",
+          "parameters": [{
+              "tags": [{
+                  "name": "param",
+                  "text": "field - Defini\u00E7\u00E3o do campo customizado."
+                }],
+              "text": "- Defini\u00E7\u00E3o do campo customizado."
+            }],
+          "references": {
+            "Promise": {
+              "location": "global"
+            },
+            "IFilterCustomField": {
+              "location": "import",
+              "path": "./interfaces"
+            }
+          },
+          "return": "Promise<void>"
+        },
+        "docs": {
+          "text": "Adiciona um campo customizado que n\u00E3o existe na metadata padr\u00E3o do core.",
+          "tags": [{
+              "name": "param",
+              "text": "field - Defini\u00E7\u00E3o do campo customizado."
+            }]
+        }
+      }
+    };
+  }
+  static get elementRef() { return "_element"; }
+  static get watchers() {
+    return [{
+        "propName": "metadata",
+        "methodName": "watchMetadata"
+      }, {
+        "propName": "fields",
+        "methodName": "watchMetadata"
+      }, {
+        "propName": "initialValues",
+        "methodName": "watchInitialValues"
+      }, {
+        "propName": "dataUnit",
+        "methodName": "watchDataUnit"
+      }, {
+        "propName": "opened",
+        "methodName": "watchOpened"
+      }];
+  }
+}