@toolbox-web/grid 1.6.2 → 1.8.0

package/lib/plugins/multi-sort/index.js

@@ -11,7 +11,7 @@ const h = '<svg viewBox="0 0 16 16" width="12" height="12"><path fill="currentCo
   filterActive: h,
   print: "🖨️"
 };
-class C {
+class v {
   /**
    * Plugin dependencies - declare other plugins this one requires.
    *
@@ -149,6 +149,63 @@ class C {
     const o = new CustomEvent(t, { detail: e, bubbles: !0, cancelable: !0 });
     return this.grid?.dispatchEvent?.(o), o.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(t, e) {
+    this.grid?._pluginManager?.subscribe(this, t, e);
+  }
+  /**
+   * Unsubscribe from a plugin event.
+   *
+   * @category Plugin Development
+   * @param eventType - The event type to stop listening for
+   *
+   * @example
+   * ```typescript
+   * this.off('filter-change');
+   * ```
+   */
+  off(t) {
+    this.grid?._pluginManager?.unsubscribe(this, t);
+  }
+  /**
+   * 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(t, e) {
+    this.grid?._pluginManager?.emitPluginEvent(t, e);
+  }
   /**
    * Request a re-render of the grid.
    */
@@ -311,20 +368,20 @@ class C {
   }
   // #endregion
 }
-function S(r, t, e) {
+function C(r, t, e) {
   return t.length ? [...r].sort((o, i) => {
     for (const n of t) {
-      const d = e.find((c) => c.field === n.field)?.sortComparator ?? v, u = o[n.field], f = i[n.field], s = d(u, f, o, i);
+      const d = e.find((c) => c.field === n.field)?.sortComparator ?? M, u = o[n.field], g = i[n.field], s = d(u, g, o, i);
       if (s !== 0)
         return n.direction === "asc" ? s : -s;
     }
     return 0;
   }) : [...r];
 }
-function v(r, t) {
+function M(r, t) {
   return r == null && t == null ? 0 : r == null ? 1 : t == null ? -1 : typeof r == "number" && typeof t == "number" ? r - t : r instanceof Date && t instanceof Date ? r.getTime() - t.getTime() : typeof r == "boolean" && typeof t == "boolean" ? r === t ? 0 : r ? -1 : 1 : String(r).localeCompare(String(t));
 }
-function w(r, t, e, o) {
+function S(r, t, e, o) {
   const i = r.find((n) => n.field === t);
   return e ? i ? i.direction === "asc" ? r.map((n) => n.field === t ? { ...n, direction: "desc" } : n) : r.filter((n) => n.field !== t) : r.length < o ? [...r, { field: t, direction: "asc" }] : r : i?.direction === "asc" ? [{ field: t, direction: "desc" }] : i?.direction === "desc" ? [] : [{ field: t, direction: "asc" }];
 }
@@ -335,12 +392,12 @@ function m(r, t) {
 function p(r, t) {
   return r.find((e) => e.field === t)?.direction;
 }
-const y = '@layer tbw-plugins{.header-cell[data-sort=asc]:after{content:"↑";margin-left:var(--tbw-spacing-xs, .25em);opacity:.8}.header-cell[data-sort=desc]:after{content:"↓";margin-left:var(--tbw-spacing-xs, .25em);opacity:.8}.sort-indicator{margin-left:var(--tbw-spacing-xs, .25em);opacity:.8}.sort-index{font-size:var(--tbw-font-size-2xs, .7em);background:var(--tbw-multi-sort-badge-bg, var(--tbw-color-panel-bg));color:var(--tbw-multi-sort-badge-color, var(--tbw-color-fg));border-radius:50%;width:var(--tbw-multi-sort-badge-size, 1em);height:var(--tbw-multi-sort-badge-size, 1em);display:inline-flex;align-items:center;justify-content:center;margin-left:var(--tbw-spacing-xs, .125em);font-weight:600}}';
-class M extends C {
+const w = '@layer tbw-plugins{.header-cell[data-sort=asc]:after{content:"↑";margin-left:var(--tbw-spacing-xs, .25em);opacity:.8}.header-cell[data-sort=desc]:after{content:"↓";margin-left:var(--tbw-spacing-xs, .25em);opacity:.8}.sort-indicator{margin-left:var(--tbw-spacing-xs, .25em);opacity:.8}.sort-index{font-size:var(--tbw-font-size-2xs, .7em);background:var(--tbw-multi-sort-badge-bg, var(--tbw-color-panel-bg));color:var(--tbw-multi-sort-badge-color, var(--tbw-color-fg));border-radius:50%;width:var(--tbw-multi-sort-badge-size, 1em);height:var(--tbw-multi-sort-badge-size, 1em);display:inline-flex;align-items:center;justify-content:center;margin-left:var(--tbw-spacing-xs, .125em);font-weight:600}}';
+class y extends v {
   /** @internal */
   name = "multiSort";
   /** @internal */
-  styles = y;
+  styles = w;
   /** @internal */
   get defaultConfig() {
     return {
@@ -360,13 +417,13 @@ class M extends C {
   // #region Hooks
   /** @internal */
   processRows(t) {
-    return this.sortModel.length === 0 ? [...t] : S([...t], this.sortModel, [...this.columns]);
+    return this.sortModel.length === 0 ? [...t] : C([...t], this.sortModel, [...this.columns]);
   }
   /** @internal */
   onHeaderClick(t) {
     if (!this.columns.find((n) => n.field === t.field)?.sortable) return !1;
     const o = t.originalEvent.shiftKey, i = this.config.maxSortColumns ?? 3;
-    return this.sortModel = w(this.sortModel, t.field, o, i), this.emit("sort-change", { sortModel: [...this.sortModel] }), this.requestRender(), !0;
+    return this.sortModel = S(this.sortModel, t.field, o, i), this.emit("sort-change", { sortModel: [...this.sortModel] }), this.requestRender(), !0;
   }
   /** @internal */
   afterRender() {
@@ -381,8 +438,8 @@ class M extends C {
         i.querySelector('[part~="sort-indicator"], .sort-indicator')?.remove(), i.setAttribute("data-sort", d);
         const s = document.createElement("span");
         s.className = "sort-indicator", this.setIcon(s, this.resolveIcon(d === "asc" ? "sortAsc" : "sortDesc"));
-        const c = i.querySelector(".tbw-filter-btn"), b = i.querySelector(".resize-handle"), g = c ?? b;
-        if (g ? i.insertBefore(s, g) : i.appendChild(s), e && this.sortModel.length > 1 && a !== void 0) {
+        const c = i.querySelector(".tbw-filter-btn"), b = i.querySelector(".resize-handle"), f = c ?? b;
+        if (f ? i.insertBefore(s, f) : i.appendChild(s), e && this.sortModel.length > 1 && a !== void 0) {
           const l = document.createElement("span");
           l.className = "sort-index", l.textContent = String(a), s.nextSibling ? i.insertBefore(l, s.nextSibling) : i.appendChild(l);
         }
@@ -462,6 +519,6 @@ class M extends C {
   // #endregion
 }
 export {
-  M as MultiSortPlugin
+  y as MultiSortPlugin
 };
 //# sourceMappingURL=index.js.map