@toolbox-web/grid 1.6.2 → 1.8.0

package/lib/plugins/undo-redo/UndoRedoPlugin.d.ts

@@ -1,4 +1,4 @@
-import { BaseGridPlugin, PluginDependency } from '../../core/plugin/base-plugin';
+import { BaseGridPlugin, GridElement, PluginDependency } from '../../core/plugin/base-plugin';
 import { EditAction, UndoRedoConfig } from './types';
 /**
  * Undo/Redo Plugin for tbw-grid
@@ -78,6 +78,11 @@ export declare class UndoRedoPlugin extends BaseGridPlugin<UndoRedoConfig> {
     protected get defaultConfig(): Partial<UndoRedoConfig>;
     private undoStack;
     private redoStack;
+    /**
+     * Subscribe to cell-edit-committed events from EditingPlugin.
+     * @internal
+     */
+    attach(grid: GridElement): void;
     /**
      * Clean up state when plugin is detached.
      * @internal

package/lib/plugins/undo-redo/UndoRedoPlugin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"UndoRedoPlugin.d.ts","sourceRoot":"","sources":["../../../../../../libs/grid/src/lib/plugins/undo-redo/UndoRedoPlugin.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,cAAc,EAAE,KAAK,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAEtF,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAkB,MAAM,SAAS,CAAC;AAE1E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+DG;AACH,qBAAa,cAAe,SAAQ,cAAc,CAAC,cAAc,CAAC;IAChE;;;;;OAKG;IACH,gBAAyB,YAAY,EAAE,gBAAgB,EAAE,CAEvD;IAEF,gBAAgB;IAChB,QAAQ,CAAC,IAAI,cAAc;IAE3B,gBAAgB;IAChB,cAAuB,aAAa,IAAI,OAAO,CAAC,cAAc,CAAC,CAI9D;IAGD,OAAO,CAAC,SAAS,CAAoB;IACrC,OAAO,CAAC,SAAS,CAAoB;IAErC;;;OAGG;IACM,MAAM,IAAI,IAAI;IAKvB;;;;;OAKG;IACM,SAAS,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO;IAuDjD;;;;;;;;OAQG;IACH,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,GAAG,IAAI;IAWvF;;;;OAIG;IACH,IAAI,IAAI,UAAU,GAAG,IAAI;IAczB;;;;OAIG;IACH,IAAI,IAAI,UAAU,GAAG,IAAI;IAczB;;OAEG;IACH,OAAO,IAAI,OAAO;IAIlB;;OAEG;IACH,OAAO,IAAI,OAAO;IAIlB;;OAEG;IACH,YAAY,IAAI,IAAI;IAMpB;;OAEG;IACH,YAAY,IAAI,UAAU,EAAE;IAI5B;;OAEG;IACH,YAAY,IAAI,UAAU,EAAE;CAI7B"}
+{"version":3,"file":"UndoRedoPlugin.d.ts","sourceRoot":"","sources":["../../../../../../libs/grid/src/lib/plugins/undo-redo/UndoRedoPlugin.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,cAAc,EAAE,KAAK,WAAW,EAAE,KAAK,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAExG,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAkB,MAAM,SAAS,CAAC;AAE1E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+DG;AACH,qBAAa,cAAe,SAAQ,cAAc,CAAC,cAAc,CAAC;IAChE;;;;;OAKG;IACH,gBAAyB,YAAY,EAAE,gBAAgB,EAAE,CAEvD;IAEF,gBAAgB;IAChB,QAAQ,CAAC,IAAI,cAAc;IAE3B,gBAAgB;IAChB,cAAuB,aAAa,IAAI,OAAO,CAAC,cAAc,CAAC,CAI9D;IAGD,OAAO,CAAC,SAAS,CAAoB;IACrC,OAAO,CAAC,SAAS,CAAoB;IAErC;;;OAGG;IACM,MAAM,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI;IAWxC;;;OAGG;IACM,MAAM,IAAI,IAAI;IAKvB;;;;;OAKG;IACM,SAAS,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO;IAuDjD;;;;;;;;OAQG;IACH,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,GAAG,IAAI;IAWvF;;;;OAIG;IACH,IAAI,IAAI,UAAU,GAAG,IAAI;IAczB;;;;OAIG;IACH,IAAI,IAAI,UAAU,GAAG,IAAI;IAczB;;OAEG;IACH,OAAO,IAAI,OAAO;IAIlB;;OAEG;IACH,OAAO,IAAI,OAAO;IAIlB;;OAEG;IACH,YAAY,IAAI,IAAI;IAMpB;;OAEG;IACH,YAAY,IAAI,UAAU,EAAE;IAI5B;;OAEG;IACH,YAAY,IAAI,UAAU,EAAE;CAI7B"}

package/lib/plugins/undo-redo/index.js

@@ -11,7 +11,7 @@ const c = '<svg viewBox="0 0 16 16" width="12" height="12"><path fill="currentCo
   filterActive: c,
   print: "🖨️"
 };
-class S {
+class h {
   /**
    * Plugin dependencies - declare other plugins this one requires.
    *
@@ -149,6 +149,63 @@ class S {
     const r = new CustomEvent(t, { detail: e, 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(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,7 +368,7 @@ class S {
   }
   // #endregion
 }
-function h(n, t, e) {
+function l(n, t, e) {
   const r = [...n.undoStack, t];
   for (; r.length > e; )
     r.shift();
@@ -345,13 +402,13 @@ function d(n) {
     action: e
   } : { newState: n, action: null };
 }
-function l(n) {
+function S(n) {
   return n.undoStack.length > 0;
 }
-function k(n) {
+function g(n) {
   return n.redoStack.length > 0;
 }
-function g() {
+function k() {
   return { undoStack: [], redoStack: [] };
 }
 function f(n, t, e, r) {
@@ -364,7 +421,7 @@ function f(n, t, e, r) {
     timestamp: Date.now()
   };
 }
-class w extends S {
+class w extends h {
   /**
    * Plugin dependencies - UndoRedoPlugin requires EditingPlugin to track edits.
    *
@@ -385,6 +442,18 @@ class w extends S {
   // State as class properties
   undoStack = [];
   redoStack = [];
+  /**
+   * Subscribe to cell-edit-committed events from EditingPlugin.
+   * @internal
+   */
+  attach(t) {
+    super.attach(t), this.on(
+      "cell-edit-committed",
+      (e) => {
+        this.recordEdit(e.rowIndex, e.field, e.oldValue, e.newValue);
+      }
+    );
+  }
   /**
    * Clean up state when plugin is detached.
    * @internal
@@ -435,7 +504,7 @@ class w extends S {
    * @param newValue - The value after the edit
    */
   recordEdit(t, e, r, o) {
-    const i = f(t, e, r, o), a = h(
+    const i = f(t, e, r, o), a = l(
       { undoStack: this.undoStack, redoStack: this.redoStack },
       i,
       this.config.maxHistorySize ?? 100
@@ -472,19 +541,19 @@ class w extends S {
    * Check if there are any actions that can be undone.
    */
   canUndo() {
-    return l({ undoStack: this.undoStack, redoStack: this.redoStack });
+    return S({ undoStack: this.undoStack, redoStack: this.redoStack });
   }
   /**
    * Check if there are any actions that can be redone.
    */
   canRedo() {
-    return k({ undoStack: this.undoStack, redoStack: this.redoStack });
+    return g({ undoStack: this.undoStack, redoStack: this.redoStack });
   }
   /**
    * Clear all undo/redo history.
    */
   clearHistory() {
-    const t = g();
+    const t = k();
     this.undoStack = t.undoStack, this.redoStack = t.redoStack;
   }
   /**