@toolbox-web/grid 1.6.2 → 1.8.0

package/lib/plugins/filtering/index.js

@@ -1,13 +1,13 @@
 function Y(N) {
-  const { totalRows: e, viewportHeight: t, scrollTop: r, rowHeight: a, overscan: l } = N, c = Math.ceil(t / a);
-  let d = Math.floor(r / a) - l;
+  const { totalRows: e, viewportHeight: t, scrollTop: r, rowHeight: i, overscan: l } = N, c = Math.ceil(t / i);
+  let d = Math.floor(r / i) - l;
   d < 0 && (d = 0);
-  let i = d + c + l * 2;
-  return i > e && (i = e), i === e && d > 0 && (d = Math.max(0, i - c - l * 2)), {
+  let a = d + c + l * 2;
+  return a > e && (a = e), a === e && d > 0 && (d = Math.max(0, a - c - l * 2)), {
     start: d,
-    end: i,
-    offsetY: d * a,
-    totalHeight: e * a
+    end: a,
+    offsetY: d * i,
+    totalHeight: e * i
   };
 }
 function G(N, e) {
@@ -164,6 +164,63 @@ class K {
     const r = new CustomEvent(e, { detail: t, bubbles: !0, cancelable: !0 });
     return this.grid?.dispatchEvent?.(r), r.defaultPrevented;
   }
+  // =========================================================================
+  // Event Bus - Plugin-to-Plugin Communication
+  // =========================================================================
+  /**
+   * Subscribe to an event from another plugin.
+   * The subscription is automatically cleaned up when this plugin is detached.
+   *
+   * @category Plugin Development
+   * @param eventType - The event type to listen for (e.g., 'filter-change')
+   * @param callback - The callback to invoke when the event is emitted
+   *
+   * @example
+   * ```typescript
+   * // In attach() or other initialization
+   * this.on('filter-change', (detail) => {
+   *   console.log('Filter changed:', detail);
+   * });
+   * ```
+   */
+  on(e, t) {
+    this.grid?._pluginManager?.subscribe(this, e, t);
+  }
+  /**
+   * Unsubscribe from a plugin event.
+   *
+   * @category Plugin Development
+   * @param eventType - The event type to stop listening for
+   *
+   * @example
+   * ```typescript
+   * this.off('filter-change');
+   * ```
+   */
+  off(e) {
+    this.grid?._pluginManager?.unsubscribe(this, e);
+  }
+  /**
+   * Emit an event to other plugins via the Event Bus.
+   * This is for inter-plugin communication only; it does NOT dispatch DOM events.
+   * Use `emit()` to dispatch DOM events that external consumers can listen to.
+   *
+   * @category Plugin Development
+   * @param eventType - The event type to emit (should be declared in manifest.events)
+   * @param detail - The event payload
+   *
+   * @example
+   * ```typescript
+   * // Emit to other plugins (not DOM)
+   * this.emitPluginEvent('filter-change', { field: 'name', value: 'Alice' });
+   *
+   * // For DOM events that consumers can addEventListener to:
+   * this.emit('filter-change', { field: 'name', value: 'Alice' });
+   * ```
+   */
+  emitPluginEvent(e, t) {
+    this.grid?._pluginManager?.emitPluginEvent(e, t);
+  }
   /**
    * Request a re-render of the grid.
    */
@@ -336,7 +393,7 @@ function j(N, e, t = !1) {
   if (e.operator === "notBlank")
     return r != null && r !== "";
   if (r == null) return !1;
-  const a = String(r), l = t ? a : a.toLowerCase(), c = t ? String(e.value) : String(e.value).toLowerCase();
+  const i = String(r), l = t ? i : i.toLowerCase(), c = t ? String(e.value) : String(e.value).toLowerCase();
   switch (e.operator) {
     // Text operators
     case "contains":
@@ -372,7 +429,7 @@ function j(N, e, t = !1) {
   }
 }
 function U(N, e, t = !1) {
-  return e.length ? N.filter((r) => e.every((a) => j(r, a, t))) : N;
+  return e.length ? N.filter((r) => e.every((i) => j(r, i, t))) : N;
 }
 function J(N) {
   return JSON.stringify(
@@ -387,13 +444,25 @@ function J(N) {
 function B(N, e) {
   const t = /* @__PURE__ */ new Set();
   for (const r of N) {
-    const a = r[e];
-    a != null && t.add(a);
+    const i = r[e];
+    i != null && t.add(i);
   }
-  return [...t].sort((r, a) => typeof r == "number" && typeof a == "number" ? r - a : String(r).localeCompare(String(a)));
+  return [...t].sort((r, i) => typeof r == "number" && typeof i == "number" ? r - i : String(r).localeCompare(String(i)));
 }
 const Q = '@layer tbw-plugins{tbw-grid .tbw-quick-filter-input{flex:1;max-width:300px;height:var(--tbw-input-height, 1.75rem);padding:var(--tbw-input-padding, 0 .5rem);border:1px solid var(--tbw-color-border);border-radius:var(--tbw-border-radius);background:var(--tbw-color-bg);color:var(--tbw-color-fg);font-size:var(--tbw-font-size-sm, .8125rem)}tbw-grid .tbw-quick-filter-input:focus{outline:none;border-color:var(--tbw-color-accent)}tbw-grid .header-cell.filtered:before{content:"";position:absolute;top:var(--tbw-spacing-xs, .25rem);right:var(--tbw-spacing-xs, .25rem);width:var(--tbw-indicator-size, .375rem);height:var(--tbw-indicator-size, .375rem);background:var(--tbw-filter-accent, var(--tbw-color-accent, #3b82f6));border-radius:50%}tbw-grid .tbw-filter-btn{display:var(--tbw-filter-btn-display, inline-flex);visibility:var(--tbw-filter-btn-visibility, visible);align-items:center;justify-content:center;background:transparent;border:none;cursor:pointer;padding:2px;margin-left:var(--tbw-spacing-xs, .25rem);opacity:.4;transition:opacity .15s,visibility 0s,display 0s allow-discrete;color:inherit;vertical-align:middle;transition-behavior:allow-discrete}tbw-grid .tbw-filter-btn:hover,tbw-grid .tbw-filter-btn.active{opacity:1;visibility:visible;display:inline-flex}tbw-grid .tbw-filter-btn.active{color:var(--tbw-filter-accent, var(--tbw-color-accent, #3b82f6))}tbw-grid .header-row .cell:hover .tbw-filter-btn,tbw-grid .header-row .cell.filtered .tbw-filter-btn{display:inline-flex;visibility:visible}}', X = "@layer tbw-plugins{.tbw-filter-panel{position:fixed;background:var(--tbw-filter-panel-bg, var(--tbw-color-panel-bg, light-dark(#eeeeee, #222222)));color:var(--tbw-filter-panel-fg, var(--tbw-color-fg, light-dark(#222222, #eeeeee)));border:1px solid var(--tbw-filter-panel-border, var(--tbw-color-border, light-dark(#d0d0d4, #454545)));border-radius:var(--tbw-filter-panel-radius, var(--tbw-border-radius, .25rem));box-shadow:0 4px 16px var(--tbw-filter-panel-shadow, var(--tbw-color-shadow, light-dark(rgba(0, 0, 0, .1), rgba(0, 0, 0, .3))));padding:var(--tbw-panel-padding, var(--tbw-spacing-lg, .75rem));z-index:10000;min-width:200px;max-width:280px;max-height:350px;display:flex;flex-direction:column;font-family:var(--tbw-font-family, system-ui, sans-serif);font-size:var(--tbw-font-size, .8125rem);transform-origin:top center}.tbw-filter-panel.tbw-filter-panel-above{transform-origin:bottom center}.tbw-filter-panel.tbw-filter-panel-animated{animation:tbw-filter-panel-enter var(--tbw-animation-duration, .15s) var(--tbw-animation-easing, ease-out)}.tbw-filter-panel.tbw-filter-panel-above.tbw-filter-panel-animated{animation:tbw-filter-panel-enter-above var(--tbw-animation-duration, .15s) var(--tbw-animation-easing, ease-out)}@keyframes tbw-filter-panel-enter{0%{opacity:0;transform:scaleY(.3) translateY(-10px)}to{opacity:1;transform:scaleY(1) translateY(0)}}@keyframes tbw-filter-panel-enter-above{0%{opacity:0;transform:scaleY(.3) translateY(10px)}to{opacity:1;transform:scaleY(1) translateY(0)}}@supports (anchor-name: --test){.tbw-filter-panel{position-anchor:--tbw-filter-anchor;top:anchor(bottom);left:anchor(left);margin-top:4px;position-try-fallbacks:flip-inline,flip-block,flip-block flip-inline}}.tbw-filter-search{margin-bottom:var(--tbw-panel-gap, var(--tbw-spacing-md, .5rem));min-height:var(--tbw-filter-item-height, 28px)}.tbw-filter-search-input{height:var(--tbw-filter-item-height, 28px);width:100%;padding:var(--tbw-filter-search-padding, var(--tbw-spacing-sm, .375rem) var(--tbw-spacing-md, .5rem));background:var(--tbw-filter-input-bg, var(--tbw-color-bg, transparent));color:inherit;border:1px solid var(--tbw-filter-input-border, var(--tbw-color-border, light-dark(#d0d0d4, #454545)));border-radius:var(--tbw-filter-input-radius, var(--tbw-border-radius, .25rem));font-size:inherit;box-sizing:border-box}.tbw-filter-search-input:focus{outline:none;border-color:var(--tbw-filter-accent, var(--tbw-color-accent, #3b82f6));box-shadow:0 0 0 2px rgba(from var(--tbw-filter-accent, var(--tbw-color-accent, #3b82f6)) r g b / 15%)}.tbw-filter-actions{display:flex;padding:var(--tbw-button-padding-sm, .25rem .125rem);margin-bottom:var(--tbw-panel-gap, var(--tbw-spacing-md, .5rem));border-bottom:1px solid var(--tbw-filter-divider, var(--tbw-color-border, light-dark(#d0d0d4, #454545)));min-height:var(--tbw-filter-item-height, 28px)}.tbw-filter-action-btn{background:transparent;border:none;color:var(--tbw-filter-accent, var(--tbw-color-accent, #3b82f6));cursor:pointer;font-size:var(--tbw-font-size-xs, .75rem);padding:2px 0}.tbw-filter-action-btn:hover{text-decoration:underline}.tbw-filter-values{flex:1;overflow-y:auto;margin-bottom:var(--tbw-panel-gap, var(--tbw-spacing-md, .5rem));max-height:180px;position:relative}.tbw-filter-values-spacer{width:1px}.tbw-filter-values-content{position:absolute;top:0;left:0;right:0}.tbw-filter-value-item{display:flex;align-items:center;gap:var(--tbw-panel-gap, var(--tbw-spacing-md, .5rem));padding:var(--tbw-button-padding-sm, .25rem .125rem);cursor:pointer;border-radius:3px;height:var(--tbw-filter-item-height, 28px)}.tbw-filter-value-item:hover{background:var(--tbw-filter-hover, var(--tbw-color-row-hover, light-dark(#f0f6ff, #1c1c1c)))}.tbw-filter-checkbox{margin:0;cursor:pointer;accent-color:var(--tbw-filter-accent, var(--tbw-color-accent, #3b82f6))}.tbw-filter-no-match{color:var(--tbw-filter-muted, var(--tbw-color-fg-muted, light-dark(#555555, #aaaaaa)));padding:var(--tbw-panel-gap, var(--tbw-spacing-md, .5rem)) 0;text-align:center;font-style:italic}.tbw-filter-buttons{display:flex;gap:var(--tbw-panel-gap, var(--tbw-spacing-md, .5rem));padding-top:var(--tbw-panel-gap, var(--tbw-spacing-md, .5rem));border-top:1px solid var(--tbw-filter-divider, var(--tbw-color-border, light-dark(#d0d0d4, #454545)))}.tbw-filter-apply-btn{flex:1;padding:var(--tbw-filter-btn-padding, var(--tbw-button-padding, .375rem .75rem));background:var(--tbw-filter-accent, var(--tbw-color-accent, #3b82f6));color:var(--tbw-filter-accent-fg, var(--tbw-color-accent-fg, light-dark(#ffffff, #000000)));border:none;border-radius:var(--tbw-border-radius, .25rem);cursor:pointer;font-size:var(--tbw-font-size-sm, .8125rem);font-weight:var(--tbw-filter-btn-font-weight, 500);min-height:var(--tbw-filter-btn-min-height, auto)}.tbw-filter-apply-btn:hover{filter:brightness(.9)}.tbw-filter-clear-btn{flex:1;padding:var(--tbw-filter-btn-padding, var(--tbw-button-padding, .375rem .75rem));background:transparent;color:var(--tbw-filter-muted, var(--tbw-color-fg-muted, light-dark(#555555, #aaaaaa)));border:1px solid var(--tbw-filter-input-border, var(--tbw-color-border, light-dark(#d0d0d4, #454545)));border-radius:var(--tbw-border-radius, .25rem);cursor:pointer;font-size:var(--tbw-font-size-sm, .8125rem);font-weight:var(--tbw-filter-btn-font-weight, 500);min-height:var(--tbw-filter-btn-min-height, auto)}.tbw-filter-clear-btn:hover{background:var(--tbw-filter-hover, var(--tbw-color-row-hover, light-dark(#f0f6ff, #1c1c1c)))}.tbw-filter-range-inputs,.tbw-filter-date-range{display:flex;align-items:flex-end;gap:var(--tbw-spacing-sm, .375rem);margin-bottom:var(--tbw-panel-gap, var(--tbw-spacing-md, .5rem))}.tbw-filter-range-group,.tbw-filter-date-group{display:flex;flex-direction:column;gap:var(--tbw-spacing-xs, .25rem);flex:1}.tbw-filter-range-label{font-size:var(--tbw-font-size-xs, .75rem);color:var(--tbw-filter-muted, var(--tbw-color-fg-muted, light-dark(#555555, #aaaaaa)))}.tbw-filter-range-input,.tbw-filter-date-input{width:100%;height:var(--tbw-filter-item-height, 28px);padding:var(--tbw-spacing-xs, .25rem) var(--tbw-spacing-sm, .375rem);background:var(--tbw-filter-input-bg, var(--tbw-color-bg, transparent));color:inherit;border:1px solid var(--tbw-filter-input-border, var(--tbw-color-border, light-dark(#d0d0d4, #454545)));border-radius:var(--tbw-filter-input-radius, var(--tbw-border-radius, .25rem));font-size:inherit;box-sizing:border-box}.tbw-filter-range-input:focus,.tbw-filter-date-input:focus{outline:none;border-color:var(--tbw-filter-accent, var(--tbw-color-accent, #3b82f6));box-shadow:0 0 0 2px rgba(from var(--tbw-filter-accent, var(--tbw-color-accent, #3b82f6)) r g b / 15%)}.tbw-filter-range-separator{color:var(--tbw-filter-muted, var(--tbw-color-fg-muted, light-dark(#555555, #aaaaaa)));padding-bottom:var(--tbw-spacing-xs, .25rem)}.tbw-filter-range-slider{position:relative;height:24px;margin:var(--tbw-spacing-md, .5rem) 0 var(--tbw-panel-gap, var(--tbw-spacing-md, .5rem))}.tbw-filter-range-track{position:absolute;top:50%;left:0;right:0;height:4px;background:var(--tbw-filter-input-border, var(--tbw-color-border, light-dark(#d0d0d4, #454545)));border-radius:2px;transform:translateY(-50%)}.tbw-filter-range-fill{position:absolute;top:50%;height:4px;background:var(--tbw-filter-accent, var(--tbw-color-accent, #3b82f6));border-radius:2px;transform:translateY(-50%)}.tbw-filter-range-thumb{position:absolute;top:0;width:100%;height:100%;background:none;pointer-events:none;-webkit-appearance:none;appearance:none}.tbw-filter-range-thumb::-webkit-slider-thumb{-webkit-appearance:none;appearance:none;width:16px;height:16px;background:var(--tbw-filter-accent, var(--tbw-color-accent, #3b82f6));border:2px solid var(--tbw-filter-panel-bg, var(--tbw-color-panel-bg, light-dark(#eeeeee, #222222)));border-radius:50%;cursor:pointer;pointer-events:all;box-shadow:0 1px 3px #0003}.tbw-filter-range-thumb::-moz-range-thumb{width:16px;height:16px;background:var(--tbw-filter-accent, var(--tbw-color-accent, #3b82f6));border:2px solid var(--tbw-filter-panel-bg, var(--tbw-color-panel-bg, light-dark(#eeeeee, #222222)));border-radius:50%;cursor:pointer;pointer-events:all;box-shadow:0 1px 3px #0003}.tbw-filter-range-thumb::-webkit-slider-thumb:hover{transform:scale(1.1)}.tbw-filter-range-thumb::-moz-range-thumb:hover{transform:scale(1.1)}}";
 class I extends K {
+  /**
+   * Plugin manifest - declares events emitted by this plugin.
+   * @internal
+   */
+  static manifest = {
+    events: [
+      {
+        type: "filter-applied",
+        description: "Emitted when filter criteria change. Subscribers can react to row visibility changes."
+      }
+    ]
+  };
   /** @internal */
   name = "filtering";
   /** @internal */
@@ -482,37 +551,37 @@ class I extends K {
     const r = J(t);
     if (this.cacheKey === r && this.cachedResult)
       return this.cachedResult;
-    const a = U([...e], t, this.config.caseSensitive);
-    return this.cachedResult = a, this.cacheKey = r, a;
+    const i = U([...e], t, this.config.caseSensitive);
+    return this.cachedResult = i, this.cacheKey = r, i;
   }
   /** @internal */
   afterRender() {
     const e = this.gridElement;
     if (!e) return;
     e.querySelectorAll('[part~="header-cell"]').forEach((r) => {
-      const a = r.getAttribute("data-col");
-      if (a === null) return;
-      const l = this.visibleColumns[parseInt(a, 10)];
+      const i = r.getAttribute("data-col");
+      if (i === null) return;
+      const l = this.visibleColumns[parseInt(i, 10)];
       if (!l || !this.isColumnFilterable(l) || W(l)) return;
       const c = l.field;
       if (!c) return;
       const d = this.filters.has(c);
-      let i = r.querySelector(".tbw-filter-btn");
-      if (i) {
-        const w = i.classList.contains("active");
-        if (i.classList.toggle("active", d), r.classList.toggle("filtered", d), w !== d) {
+      let a = r.querySelector(".tbw-filter-btn");
+      if (a) {
+        const w = a.classList.contains("active");
+        if (a.classList.toggle("active", d), r.classList.toggle("filtered", d), w !== d) {
           const u = d ? "filterActive" : "filter";
-          this.setIcon(i, this.resolveIcon(u));
+          this.setIcon(a, this.resolveIcon(u));
         }
         return;
       }
-      i = document.createElement("button"), i.className = "tbw-filter-btn", i.setAttribute("aria-label", `Filter ${l.header ?? c}`);
+      a = document.createElement("button"), a.className = "tbw-filter-btn", a.setAttribute("aria-label", `Filter ${l.header ?? c}`);
       const m = d ? "filterActive" : "filter";
-      this.setIcon(i, this.resolveIcon(m)), d && (i.classList.add("active"), r.classList.add("filtered")), i.addEventListener("click", (w) => {
-        w.stopPropagation(), this.toggleFilterPanel(c, l, i);
+      this.setIcon(a, this.resolveIcon(m)), d && (a.classList.add("active"), r.classList.add("filtered")), a.addEventListener("click", (w) => {
+        w.stopPropagation(), this.toggleFilterPanel(c, l, a);
       });
       const k = r.querySelector(".resize-handle");
-      k ? r.insertBefore(i, k) : r.appendChild(i);
+      k ? r.insertBefore(a, k) : r.appendChild(a);
     });
   }
   // #endregion
@@ -532,7 +601,7 @@ class I extends K {
       filters: [...this.filters.values()],
       filteredRowCount: 0
       // Will be accurate after processRows
-    }), this.requestRender();
+    }), this.emitPluginEvent("filter-applied", { filters: [...this.filters.values()] }), this.requestRender();
   }
   /**
    * Get the current filter for a field.
@@ -562,7 +631,7 @@ class I extends K {
     this.cachedResult = null, this.cacheKey = null, this.emit("filter-change", {
       filters: [...this.filters.values()],
       filteredRowCount: 0
-    }), this.requestRender();
+    }), this.emitPluginEvent("filter-applied", { filters: [...this.filters.values()] }), this.requestRender();
   }
   /**
    * Clear all filters.
@@ -610,8 +679,8 @@ class I extends K {
   copyGridThemeContext(e) {
     const t = this.gridElement;
     if (!t) return;
-    for (const a of t.classList)
-      a.startsWith("tbw-") || a === "selecting" || e.classList.add(a);
+    for (const i of t.classList)
+      i.startsWith("tbw-") || i === "selecting" || e.classList.add(i);
     const r = t.dataset.theme;
     r && (e.dataset.theme = r);
   }
@@ -636,26 +705,26 @@ class I extends K {
       return;
     }
     this.closeFilterPanel();
-    const a = document.createElement("div");
-    if (a.className = "tbw-filter-panel", this.copyGridThemeContext(a), this.isAnimationEnabled && a.classList.add("tbw-filter-panel-animated"), this.panelElement = a, this.openPanelField = e, this.config.valuesHandler) {
-      a.innerHTML = '<div class="tbw-filter-loading">Loading...</div>', document.body.appendChild(a), this.positionPanel(a, r), this.setupPanelCloseHandler(a, r), this.config.valuesHandler(e, t).then((c) => {
-        this.openPanelField !== e || !this.panelElement || (a.innerHTML = "", this.renderPanelContent(e, t, a, c));
+    const i = document.createElement("div");
+    if (i.className = "tbw-filter-panel", this.copyGridThemeContext(i), this.isAnimationEnabled && i.classList.add("tbw-filter-panel-animated"), this.panelElement = i, this.openPanelField = e, this.config.valuesHandler) {
+      i.innerHTML = '<div class="tbw-filter-loading">Loading...</div>', document.body.appendChild(i), this.positionPanel(i, r), this.setupPanelCloseHandler(i, r), this.config.valuesHandler(e, t).then((c) => {
+        this.openPanelField !== e || !this.panelElement || (i.innerHTML = "", this.renderPanelContent(e, t, i, c));
       });
       return;
     }
     const l = B(this.sourceRows, e);
-    document.body.appendChild(a), this.positionPanel(a, r), this.renderPanelContent(e, t, a, l), this.setupPanelCloseHandler(a, r);
+    document.body.appendChild(i), this.positionPanel(i, r), this.renderPanelContent(e, t, i, l), this.setupPanelCloseHandler(i, r);
   }
   /**
    * Render filter panel content with given values
    */
-  renderPanelContent(e, t, r, a) {
+  renderPanelContent(e, t, r, i) {
     let l = this.excludedValues.get(e);
     l || (l = /* @__PURE__ */ new Set(), this.excludedValues.set(e, l));
     const c = this.searchText.get(e) ?? "", d = {
       field: e,
       column: t,
-      uniqueValues: a,
+      uniqueValues: i,
       excludedValues: l,
       searchText: c,
       applySetFilter: (m) => {
@@ -669,14 +738,14 @@ class I extends K {
       },
       closePanel: () => this.closeFilterPanel()
     };
-    let i = !1;
-    if (this.config.filterPanelRenderer && (this.config.filterPanelRenderer(r, d), i = r.children.length > 0), !i && t.type) {
+    let a = !1;
+    if (this.config.filterPanelRenderer && (this.config.filterPanelRenderer(r, d), a = r.children.length > 0), !a && t.type) {
       const m = this.grid.effectiveConfig.typeDefaults?.[t.type];
-      m?.filterPanelRenderer && (m.filterPanelRenderer(r, d), i = r.children.length > 0);
+      m?.filterPanelRenderer && (m.filterPanelRenderer(r, d), a = r.children.length > 0);
     }
-    if (!i) {
+    if (!a) {
       const m = t.type;
-      m === "number" ? this.renderNumberFilterPanel(r, d, a) : m === "date" ? this.renderDateFilterPanel(r, d, a) : this.renderDefaultFilterPanel(r, d, a, l);
+      m === "number" ? this.renderNumberFilterPanel(r, d, i) : m === "date" ? this.renderDateFilterPanel(r, d, i) : this.renderDefaultFilterPanel(r, d, i, l);
     }
   }
   /**
@@ -713,15 +782,15 @@ class I extends K {
    * Uses CSS Anchor Positioning if supported, falls back to JS positioning
    */
   positionPanel(e, t) {
-    const a = t.closest(".cell") ?? t;
-    if (a.style.anchorName = "--tbw-filter-anchor", this.panelAnchorElement = a, I.checkAnchorPositioningSupport()) {
+    const i = t.closest(".cell") ?? t;
+    if (i.style.anchorName = "--tbw-filter-anchor", this.panelAnchorElement = i, I.checkAnchorPositioningSupport()) {
       requestAnimationFrame(() => {
-        const c = e.getBoundingClientRect(), d = a.getBoundingClientRect();
+        const c = e.getBoundingClientRect(), d = i.getBoundingClientRect();
         c.top < d.top && e.classList.add("tbw-filter-panel-above");
       });
       return;
     }
-    const l = a.getBoundingClientRect();
+    const l = i.getBoundingClientRect();
     e.style.position = "fixed", e.style.top = `${l.bottom + 4}px`, e.style.left = `${l.left}px`, requestAnimationFrame(() => {
       const c = e.getBoundingClientRect();
       c.right > window.innerWidth - 8 && (e.style.left = `${l.right - c.width}px`), c.bottom > window.innerHeight - 8 && (e.style.top = `${l.top - c.height - 4}px`, e.classList.add("tbw-filter-panel-above"));
@@ -730,11 +799,11 @@ class I extends K {
   /**
    * Render the default filter panel content
    */
-  renderDefaultFilterPanel(e, t, r, a) {
+  renderDefaultFilterPanel(e, t, r, i) {
     const { field: l } = t, c = this.getListItemHeight(), d = document.createElement("div");
     d.className = "tbw-filter-search";
-    const i = document.createElement("input");
-    i.type = "text", i.placeholder = "Search...", i.className = "tbw-filter-search-input", i.value = this.searchText.get(l) ?? "", d.appendChild(i), e.appendChild(d);
+    const a = document.createElement("input");
+    a.type = "text", a.placeholder = "Search...", a.className = "tbw-filter-search-input", a.value = this.searchText.get(l) ?? "", d.appendChild(a), e.appendChild(d);
     const m = document.createElement("div");
     m.className = "tbw-filter-actions";
     const k = document.createElement("label");
@@ -744,14 +813,14 @@ class I extends K {
     const u = document.createElement("span");
     u.textContent = "Select All", k.appendChild(w), k.appendChild(u), m.appendChild(k);
     const v = () => {
-      const o = [...S.values()], b = o.every((n) => n), y = o.every((n) => !n);
-      w.checked = b, w.indeterminate = !b && !y;
+      const o = [...S.values()], h = o.every((n) => n), y = o.every((n) => !n);
+      w.checked = h, w.indeterminate = !h && !y;
     };
     w.addEventListener("change", () => {
       const o = w.checked;
-      for (const b of S.keys())
-        S.set(b, o);
-      v(), L();
+      for (const h of S.keys())
+        S.set(h, o);
+      v(), A();
     }), e.appendChild(m);
     const E = document.createElement("div");
     E.className = "tbw-filter-values";
@@ -761,21 +830,21 @@ class I extends K {
     x.className = "tbw-filter-values-content", E.appendChild(x);
     const S = /* @__PURE__ */ new Map();
     r.forEach((o) => {
-      const b = o == null ? "__null__" : String(o);
-      S.set(b, !a.has(o));
+      const h = o == null ? "__null__" : String(o);
+      S.set(h, !i.has(o));
     }), v();
     let C = [];
-    const R = (o, b) => {
+    const R = (o, h) => {
       const y = o == null ? "(Blank)" : String(o), n = o == null ? "__null__" : String(o), s = document.createElement("label");
-      s.className = "tbw-filter-value-item", s.style.position = "absolute", s.style.top = `calc(var(--tbw-filter-item-height, 28px) * ${b})`, s.style.left = "0", s.style.right = "0", s.style.boxSizing = "border-box";
+      s.className = "tbw-filter-value-item", s.style.position = "absolute", s.style.top = `calc(var(--tbw-filter-item-height, 28px) * ${h})`, s.style.left = "0", s.style.right = "0", s.style.boxSizing = "border-box";
       const F = document.createElement("input");
       F.type = "checkbox", F.className = "tbw-filter-checkbox", F.checked = S.get(n) ?? !0, F.dataset.value = n, F.addEventListener("change", () => {
         S.set(n, F.checked), v();
       });
       const M = document.createElement("span");
       return M.textContent = y, s.appendChild(F), s.appendChild(M), s;
-    }, L = () => {
-      const o = C.length, b = E.clientHeight, y = E.scrollTop;
+    }, A = () => {
+      const o = C.length, h = E.clientHeight, y = E.scrollTop;
       if (g.style.height = `${o * c}px`, G(o, I.LIST_BYPASS_THRESHOLD / 3)) {
         x.innerHTML = "", x.style.transform = "translateY(0px)", C.forEach((s, F) => {
           x.appendChild(R(s, F));
@@ -784,7 +853,7 @@ class I extends K {
       }
       const n = Y({
         totalRows: o,
-        viewportHeight: b,
+        viewportHeight: h,
         scrollTop: y,
         rowHeight: c,
         overscan: I.LIST_OVERSCAN
@@ -793,9 +862,9 @@ class I extends K {
       for (let s = n.start; s < n.end; s++)
         x.appendChild(R(C[s], s - n.start));
     }, f = (o) => {
-      const b = this.config.caseSensitive ?? !1, y = b ? o : o.toLowerCase();
+      const h = this.config.caseSensitive ?? !1, y = h ? o : o.toLowerCase();
       if (C = r.filter((n) => {
-        const s = n == null ? "(Blank)" : String(n), F = b ? s : s.toLowerCase();
+        const s = n == null ? "(Blank)" : String(n), F = h ? s : s.toLowerCase();
         return !o || F.includes(y);
       }), C.length === 0) {
         g.style.height = "0px", x.innerHTML = "";
@@ -803,36 +872,36 @@ class I extends K {
         n.className = "tbw-filter-no-match", n.textContent = "No matching values", x.appendChild(n);
         return;
       }
-      L();
+      A();
     };
     E.addEventListener(
       "scroll",
       () => {
-        C.length > 0 && L();
+        C.length > 0 && A();
       },
       { passive: !0 }
-    ), f(i.value), e.appendChild(E);
-    let P;
-    i.addEventListener("input", () => {
-      clearTimeout(P), P = setTimeout(() => {
-        this.searchText.set(l, i.value), f(i.value);
+    ), f(a.value), e.appendChild(E);
+    let L;
+    a.addEventListener("input", () => {
+      clearTimeout(L), L = setTimeout(() => {
+        this.searchText.set(l, a.value), f(a.value);
       }, this.config.debounceMs ?? 150);
     });
     const T = document.createElement("div");
     T.className = "tbw-filter-buttons";
-    const A = document.createElement("button");
-    A.className = "tbw-filter-apply-btn", A.textContent = "Apply", A.addEventListener("click", () => {
+    const P = document.createElement("button");
+    P.className = "tbw-filter-apply-btn", P.textContent = "Apply", P.addEventListener("click", () => {
       const o = [];
-      for (const [b, y] of S)
+      for (const [h, y] of S)
         if (!y)
-          if (b === "__null__")
+          if (h === "__null__")
             o.push(null);
           else {
-            const n = r.find((s) => String(s) === b);
-            o.push(n !== void 0 ? n : b);
+            const n = r.find((s) => String(s) === h);
+            o.push(n !== void 0 ? n : h);
           }
       t.applySetFilter(o);
-    }), T.appendChild(A);
+    }), T.appendChild(P);
     const p = document.createElement("button");
     p.className = "tbw-filter-clear-btn", p.textContent = "Clear Filter", p.addEventListener("click", () => {
       t.clearFilter();
@@ -842,65 +911,65 @@ class I extends K {
    * Render a number range filter panel with min/max inputs and slider
    */
   renderNumberFilterPanel(e, t, r) {
-    const { field: a, column: l } = t, c = l.filterParams, d = l.editorParams, i = (h, V) => {
-      if (typeof h == "number") return h;
-      if (typeof h == "string") {
-        const H = parseFloat(h);
+    const { field: i, column: l } = t, c = l.filterParams, d = l.editorParams, a = (b, V) => {
+      if (typeof b == "number") return b;
+      if (typeof b == "string") {
+        const H = parseFloat(b);
         return isNaN(H) ? V : H;
       }
       return V;
-    }, m = r.filter((h) => typeof h == "number" && !isNaN(h)), k = m.length > 0 ? Math.min(...m) : 0, w = m.length > 0 ? Math.max(...m) : 100, u = i(c?.min ?? d?.min, k), v = i(c?.max ?? d?.max, w), E = c?.step ?? d?.step ?? 1, g = this.filters.get(a);
+    }, m = r.filter((b) => typeof b == "number" && !isNaN(b)), k = m.length > 0 ? Math.min(...m) : 0, w = m.length > 0 ? Math.max(...m) : 100, u = a(c?.min ?? d?.min, k), v = a(c?.max ?? d?.max, w), E = c?.step ?? d?.step ?? 1, g = this.filters.get(i);
     let x = u, S = v;
-    g?.operator === "between" ? (x = i(g.value, u), S = i(g.valueTo, v)) : g?.operator === "greaterThanOrEqual" ? x = i(g.value, u) : g?.operator === "lessThanOrEqual" && (S = i(g.value, v));
+    g?.operator === "between" ? (x = a(g.value, u), S = a(g.valueTo, v)) : g?.operator === "greaterThanOrEqual" ? x = a(g.value, u) : g?.operator === "lessThanOrEqual" && (S = a(g.value, v));
     const C = document.createElement("div");
     C.className = "tbw-filter-range-inputs";
     const R = document.createElement("div");
     R.className = "tbw-filter-range-group";
-    const L = document.createElement("label");
-    L.textContent = "Min", L.className = "tbw-filter-range-label";
+    const A = document.createElement("label");
+    A.textContent = "Min", A.className = "tbw-filter-range-label";
     const f = document.createElement("input");
-    f.type = "number", f.className = "tbw-filter-range-input", f.min = String(u), f.max = String(v), f.step = String(E), f.value = String(x), R.appendChild(L), R.appendChild(f), C.appendChild(R);
-    const P = document.createElement("span");
-    P.className = "tbw-filter-range-separator", P.textContent = "–", C.appendChild(P);
+    f.type = "number", f.className = "tbw-filter-range-input", f.min = String(u), f.max = String(v), f.step = String(E), f.value = String(x), R.appendChild(A), R.appendChild(f), C.appendChild(R);
+    const L = document.createElement("span");
+    L.className = "tbw-filter-range-separator", L.textContent = "–", C.appendChild(L);
     const T = document.createElement("div");
     T.className = "tbw-filter-range-group";
-    const A = document.createElement("label");
-    A.textContent = "Max", A.className = "tbw-filter-range-label";
+    const P = document.createElement("label");
+    P.textContent = "Max", P.className = "tbw-filter-range-label";
     const p = document.createElement("input");
-    p.type = "number", p.className = "tbw-filter-range-input", p.min = String(u), p.max = String(v), p.step = String(E), p.value = String(S), T.appendChild(A), T.appendChild(p), C.appendChild(T), e.appendChild(C);
+    p.type = "number", p.className = "tbw-filter-range-input", p.min = String(u), p.max = String(v), p.step = String(E), p.value = String(S), T.appendChild(P), T.appendChild(p), C.appendChild(T), e.appendChild(C);
     const o = document.createElement("div");
     o.className = "tbw-filter-range-slider";
-    const b = document.createElement("div");
-    b.className = "tbw-filter-range-track";
+    const h = document.createElement("div");
+    h.className = "tbw-filter-range-track";
     const y = document.createElement("div");
     y.className = "tbw-filter-range-fill";
     const n = document.createElement("input");
     n.type = "range", n.className = "tbw-filter-range-thumb tbw-filter-range-thumb-min", n.min = String(u), n.max = String(v), n.step = String(E), n.value = String(x);
     const s = document.createElement("input");
-    s.type = "range", s.className = "tbw-filter-range-thumb tbw-filter-range-thumb-max", s.min = String(u), s.max = String(v), s.step = String(E), s.value = String(S), o.appendChild(b), o.appendChild(y), o.appendChild(n), o.appendChild(s), e.appendChild(o);
+    s.type = "range", s.className = "tbw-filter-range-thumb tbw-filter-range-thumb-max", s.min = String(u), s.max = String(v), s.step = String(E), s.value = String(S), o.appendChild(h), o.appendChild(y), o.appendChild(n), o.appendChild(s), e.appendChild(o);
     const F = () => {
-      const h = parseFloat(n.value), V = parseFloat(s.value), H = v - u, D = (h - u) / H * 100, O = (V - u) / H * 100;
+      const b = parseFloat(n.value), V = parseFloat(s.value), H = v - u, D = (b - u) / H * 100, O = (V - u) / H * 100;
       y.style.left = `${D}%`, y.style.width = `${O - D}%`;
     };
     n.addEventListener("input", () => {
-      const h = Math.min(parseFloat(n.value), parseFloat(s.value));
-      n.value = String(h), f.value = String(h), F();
+      const b = Math.min(parseFloat(n.value), parseFloat(s.value));
+      n.value = String(b), f.value = String(b), F();
     }), s.addEventListener("input", () => {
-      const h = Math.max(parseFloat(s.value), parseFloat(n.value));
-      s.value = String(h), p.value = String(h), F();
+      const b = Math.max(parseFloat(s.value), parseFloat(n.value));
+      s.value = String(b), p.value = String(b), F();
     }), f.addEventListener("input", () => {
-      let h = parseFloat(f.value) || u;
-      h = Math.max(u, Math.min(h, parseFloat(p.value))), n.value = String(h), F();
+      let b = parseFloat(f.value) || u;
+      b = Math.max(u, Math.min(b, parseFloat(p.value))), n.value = String(b), F();
     }), p.addEventListener("input", () => {
-      let h = parseFloat(p.value) || v;
-      h = Math.min(v, Math.max(h, parseFloat(f.value))), s.value = String(h), F();
+      let b = parseFloat(p.value) || v;
+      b = Math.min(v, Math.max(b, parseFloat(f.value))), s.value = String(b), F();
     }), F();
     const M = document.createElement("div");
     M.className = "tbw-filter-buttons";
     const _ = document.createElement("button");
     _.className = "tbw-filter-apply-btn", _.textContent = "Apply", _.addEventListener("click", () => {
-      const h = parseFloat(f.value), V = parseFloat(p.value);
-      t.applyTextFilter("between", h, V);
+      const b = parseFloat(f.value), V = parseFloat(p.value);
+      t.applyTextFilter("between", b, V);
     }), M.appendChild(_);
     const z = document.createElement("button");
     z.className = "tbw-filter-clear-btn", z.textContent = "Clear Filter", z.addEventListener("click", () => {
@@ -911,32 +980,32 @@ class I extends K {
    * Render a date range filter panel with from/to date inputs
    */
   renderDateFilterPanel(e, t, r) {
-    const { field: a, column: l } = t, c = l.filterParams, d = l.editorParams, i = r.filter((n) => n instanceof Date || typeof n == "string" && !isNaN(Date.parse(n))).map((n) => n instanceof Date ? n : new Date(n)).filter((n) => !isNaN(n.getTime())), m = i.length > 0 ? new Date(Math.min(...i.map((n) => n.getTime()))) : null, k = i.length > 0 ? new Date(Math.max(...i.map((n) => n.getTime()))) : null, w = (n) => n ? n.toISOString().split("T")[0] : "", u = (n) => n ? typeof n == "string" ? n : typeof n == "number" ? w(new Date(n)) : "" : "", v = u(c?.min) || u(d?.min) || w(m), E = u(c?.max) || u(d?.max) || w(k), g = this.filters.get(a);
+    const { field: i, column: l } = t, c = l.filterParams, d = l.editorParams, a = r.filter((n) => n instanceof Date || typeof n == "string" && !isNaN(Date.parse(n))).map((n) => n instanceof Date ? n : new Date(n)).filter((n) => !isNaN(n.getTime())), m = a.length > 0 ? new Date(Math.min(...a.map((n) => n.getTime()))) : null, k = a.length > 0 ? new Date(Math.max(...a.map((n) => n.getTime()))) : null, w = (n) => n ? n.toISOString().split("T")[0] : "", u = (n) => n ? typeof n == "string" ? n : typeof n == "number" ? w(new Date(n)) : "" : "", v = u(c?.min) || u(d?.min) || w(m), E = u(c?.max) || u(d?.max) || w(k), g = this.filters.get(i);
     let x = "", S = "";
     g?.operator === "between" ? (x = u(g.value) || "", S = u(g.valueTo) || "") : g?.operator === "greaterThanOrEqual" ? x = u(g.value) || "" : g?.operator === "lessThanOrEqual" && (S = u(g.value) || "");
     const C = document.createElement("div");
     C.className = "tbw-filter-date-range";
     const R = document.createElement("div");
     R.className = "tbw-filter-date-group";
-    const L = document.createElement("label");
-    L.textContent = "From", L.className = "tbw-filter-range-label";
+    const A = document.createElement("label");
+    A.textContent = "From", A.className = "tbw-filter-range-label";
     const f = document.createElement("input");
-    f.type = "date", f.className = "tbw-filter-date-input", v && (f.min = v), E && (f.max = E), f.value = x, R.appendChild(L), R.appendChild(f), C.appendChild(R);
-    const P = document.createElement("span");
-    P.className = "tbw-filter-range-separator", P.textContent = "–", C.appendChild(P);
+    f.type = "date", f.className = "tbw-filter-date-input", v && (f.min = v), E && (f.max = E), f.value = x, R.appendChild(A), R.appendChild(f), C.appendChild(R);
+    const L = document.createElement("span");
+    L.className = "tbw-filter-range-separator", L.textContent = "–", C.appendChild(L);
     const T = document.createElement("div");
     T.className = "tbw-filter-date-group";
-    const A = document.createElement("label");
-    A.textContent = "To", A.className = "tbw-filter-range-label";
+    const P = document.createElement("label");
+    P.textContent = "To", P.className = "tbw-filter-range-label";
     const p = document.createElement("input");
-    p.type = "date", p.className = "tbw-filter-date-input", v && (p.min = v), E && (p.max = E), p.value = S, T.appendChild(A), T.appendChild(p), C.appendChild(T), e.appendChild(C);
+    p.type = "date", p.className = "tbw-filter-date-input", v && (p.min = v), E && (p.max = E), p.value = S, T.appendChild(P), T.appendChild(p), C.appendChild(T), e.appendChild(C);
     const o = document.createElement("div");
     o.className = "tbw-filter-buttons";
-    const b = document.createElement("button");
-    b.className = "tbw-filter-apply-btn", b.textContent = "Apply", b.addEventListener("click", () => {
+    const h = document.createElement("button");
+    h.className = "tbw-filter-apply-btn", h.textContent = "Apply", h.addEventListener("click", () => {
       const n = f.value, s = p.value;
       n && s ? t.applyTextFilter("between", n, s) : n ? t.applyTextFilter("greaterThanOrEqual", n) : s ? t.applyTextFilter("lessThanOrEqual", s) : t.clearFilter();
-    }), o.appendChild(b);
+    }), o.appendChild(h);
     const y = document.createElement("button");
     y.className = "tbw-filter-clear-btn", y.textContent = "Clear Filter", y.addEventListener("click", () => {
       t.clearFilter();
@@ -956,13 +1025,13 @@ class I extends K {
   /**
    * Apply a text/number/date filter
    */
-  applyTextFilter(e, t, r, a) {
+  applyTextFilter(e, t, r, i) {
     this.filters.set(e, {
       field: e,
       type: "text",
       operator: t,
       value: r,
-      valueTo: a
+      valueTo: i
     }), this.applyFiltersInternal();
   }
   /**
@@ -974,19 +1043,19 @@ class I extends K {
     if (this.config.filterHandler) {
       const t = this.grid;
       t.setAttribute("aria-busy", "true");
-      const r = this.config.filterHandler(e, this.sourceRows), a = (l) => {
+      const r = this.config.filterHandler(e, this.sourceRows), i = (l) => {
         t.removeAttribute("aria-busy"), this.cachedResult = l, this.grid.rows = l, this.emit("filter-change", {
           filters: e,
           filteredRowCount: l.length
-        }), this.requestRender();
+        }), this.emitPluginEvent("filter-applied", { filters: e }), this.requestRender();
       };
-      r && typeof r.then == "function" ? r.then(a) : a(r);
+      r && typeof r.then == "function" ? r.then(i) : i(r);
       return;
     }
     this.emit("filter-change", {
       filters: e,
       filteredRowCount: 0
-    }), this.requestRender();
+    }), this.emitPluginEvent("filter-applied", { filters: e }), this.requestRender();
   }
   // #endregion
   // #region Column State Hooks