@toolbox-web/grid 1.0.0 → 1.1.0

package/lib/plugins/context-menu/index.js

@@ -25,6 +25,28 @@ class I {
    * ```
    */
   static dependencies;
+  /**
+   * Plugin manifest - declares owned properties, config rules, and hook priorities.
+   *
+   * This is read by the configuration validator to:
+   * - Validate that required plugins are loaded when their properties are used
+   * - Execute configRules to detect invalid/conflicting settings
+   * - Order hook execution based on priority
+   *
+   * @example
+   * ```typescript
+   * static override readonly manifest: PluginManifest<MyConfig> = {
+   *   ownedProperties: [
+   *     { property: 'myProp', level: 'column', description: 'the "myProp" column property' },
+   *   ],
+   *   configRules: [
+   *     { id: 'myPlugin/conflict', severity: 'warn', message: '...', check: (c) => c.a && c.b },
+   *   ],
+   * };
+   * ```
+   */
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  static manifest;
   /**
    * Plugin version - defaults to grid version for built-in plugins.
    * Third-party plugins can override with their own semver.
@@ -296,46 +318,46 @@ function M(r, e) {
 function x(r, e, t, n = C.submenuArrow) {
   const l = document.createElement("div");
   l.className = "tbw-context-menu", l.setAttribute("role", "menu");
-  for (const o of r) {
-    if (o.separator) {
-      const s = document.createElement("div");
-      s.className = "tbw-context-menu-separator", s.setAttribute("role", "separator"), l.appendChild(s);
+  for (const s of r) {
+    if (s.separator) {
+      const o = document.createElement("div");
+      o.className = "tbw-context-menu-separator", o.setAttribute("role", "separator"), l.appendChild(o);
       continue;
     }
     const i = document.createElement("div");
-    i.className = "tbw-context-menu-item", o.cssClass && i.classList.add(o.cssClass), i.setAttribute("role", "menuitem"), i.setAttribute("data-id", o.id);
-    const d = M(o, e);
-    if (d && (i.classList.add("disabled"), i.setAttribute("aria-disabled", "true")), o.icon) {
-      const s = document.createElement("span");
-      s.className = "tbw-context-menu-icon", s.innerHTML = o.icon, i.appendChild(s);
+    i.className = "tbw-context-menu-item", s.cssClass && i.classList.add(s.cssClass), i.setAttribute("role", "menuitem"), i.setAttribute("data-id", s.id);
+    const d = M(s, e);
+    if (d && (i.classList.add("disabled"), i.setAttribute("aria-disabled", "true")), s.icon) {
+      const o = document.createElement("span");
+      o.className = "tbw-context-menu-icon", o.innerHTML = s.icon, i.appendChild(o);
     }
-    const a = document.createElement("span");
-    if (a.className = "tbw-context-menu-label", a.textContent = o.name, i.appendChild(a), o.shortcut) {
-      const s = document.createElement("span");
-      s.className = "tbw-context-menu-shortcut", s.textContent = o.shortcut, i.appendChild(s);
+    const u = document.createElement("span");
+    if (u.className = "tbw-context-menu-label", u.textContent = s.name, i.appendChild(u), s.shortcut) {
+      const o = document.createElement("span");
+      o.className = "tbw-context-menu-shortcut", o.textContent = s.shortcut, i.appendChild(o);
     }
-    if (o.subMenu?.length) {
-      const s = document.createElement("span");
-      s.className = "tbw-context-menu-arrow", typeof n == "string" ? s.innerHTML = n : n instanceof HTMLElement && s.appendChild(n.cloneNode(!0)), i.appendChild(s), i.addEventListener("mouseenter", () => {
-        if (i.querySelector(".tbw-context-menu") || !o.subMenu) return;
-        const f = v(o.subMenu, e), c = x(f, e, t, n);
+    if (s.subMenu?.length) {
+      const o = document.createElement("span");
+      o.className = "tbw-context-menu-arrow", typeof n == "string" ? o.innerHTML = n : n instanceof HTMLElement && o.appendChild(n.cloneNode(!0)), i.appendChild(o), i.addEventListener("mouseenter", () => {
+        if (i.querySelector(".tbw-context-menu") || !s.subMenu) return;
+        const f = v(s.subMenu, e), c = x(f, e, t, n);
         c.classList.add("tbw-context-submenu"), c.style.position = "absolute", c.style.left = "100%", c.style.top = "0", i.style.position = "relative", i.appendChild(c);
       }), i.addEventListener("mouseleave", () => {
-        const u = i.querySelector(".tbw-context-menu");
-        u && u.remove();
+        const a = i.querySelector(".tbw-context-menu");
+        a && a.remove();
       });
     }
-    !d && o.action && !o.subMenu && i.addEventListener("click", (s) => {
-      s.stopPropagation(), t(o);
+    !d && s.action && !s.subMenu && i.addEventListener("click", (o) => {
+      o.stopPropagation(), t(s);
     }), l.appendChild(i);
   }
   return l;
 }
 function y(r, e, t) {
   r.style.position = "fixed", r.style.left = `${e}px`, r.style.top = `${t}px`, r.style.visibility = "hidden", r.style.zIndex = "10000";
-  const n = r.getBoundingClientRect(), l = window.innerWidth, o = window.innerHeight;
+  const n = r.getBoundingClientRect(), l = window.innerWidth, s = window.innerHeight;
   let i = e, d = t;
-  e + n.width > l && (i = e - n.width), t + n.height > o && (d = t - n.height), i = Math.max(0, i), d = Math.max(0, d), r.style.left = `${i}px`, r.style.top = `${d}px`, r.style.visibility = "visible";
+  e + n.width > l && (i = e - n.width), t + n.height > s && (d = t - n.height), i = Math.max(0, i), d = Math.max(0, d), r.style.left = `${i}px`, r.style.top = `${d}px`, r.style.visibility = "visible";
 }
 let h = null, b = null, m = null, p = 0;
 const w = [
@@ -406,13 +428,13 @@ class H extends I {
     t && t.getAttribute("data-context-menu-bound") !== "true" && (t.setAttribute("data-context-menu-bound", "true"), t.addEventListener("contextmenu", (n) => {
       const l = n;
       l.preventDefault();
-      const o = l.target, i = o.closest("[data-row][data-col]"), d = o.closest(".header-cell");
-      let a;
+      const s = l.target, i = s.closest("[data-row][data-col]"), d = s.closest(".header-cell");
+      let u;
       if (i) {
-        const u = parseInt(i.getAttribute("data-row") ?? "-1", 10), f = parseInt(i.getAttribute("data-col") ?? "-1", 10), c = this.columns[f], E = this.rows[u];
-        a = {
+        const a = parseInt(i.getAttribute("data-row") ?? "-1", 10), f = parseInt(i.getAttribute("data-col") ?? "-1", 10), c = this.columns[f], E = this.rows[a];
+        u = {
           row: E,
-          rowIndex: u,
+          rowIndex: a,
           column: c,
           columnIndex: f,
           field: c?.field ?? "",
@@ -421,12 +443,12 @@ class H extends I {
           event: l
         };
       } else if (d) {
-        const u = parseInt(d.getAttribute("data-col") ?? "-1", 10), f = this.columns[u];
-        a = {
+        const a = parseInt(d.getAttribute("data-col") ?? "-1", 10), f = this.columns[a];
+        u = {
           row: null,
           rowIndex: -1,
           column: f,
-          columnIndex: u,
+          columnIndex: a,
           field: f?.field ?? "",
           value: null,
           isHeader: !0,
@@ -434,16 +456,16 @@ class H extends I {
         };
       } else
         return;
-      this.params = a, this.position = { x: l.clientX, y: l.clientY };
-      const s = v(this.config.items ?? w, a);
-      s.length && (this.menuElement && this.menuElement.remove(), this.menuElement = x(
-        s,
-        a,
-        (u) => {
-          u.action && u.action(a), this.menuElement?.remove(), this.menuElement = null, this.isOpen = !1;
+      this.params = u, this.position = { x: l.clientX, y: l.clientY };
+      const o = v(this.config.items ?? w, u);
+      o.length && (this.menuElement && this.menuElement.remove(), this.menuElement = x(
+        o,
+        u,
+        (a) => {
+          a.action && a.action(u), this.menuElement?.remove(), this.menuElement = null, this.isOpen = !1;
         },
         this.gridIcons.submenuArrow
-      ), document.body.appendChild(this.menuElement), y(this.menuElement, l.clientX, l.clientY), this.isOpen = !0, this.emit("context-menu-open", { params: a, items: s }));
+      ), document.body.appendChild(this.menuElement), y(this.menuElement, l.clientX, l.clientY), this.isOpen = !0, this.emit("context-menu-open", { params: u, items: o }));
     }));
   }
   // #endregion
@@ -464,9 +486,9 @@ class H extends I {
       value: n.value ?? null,
       isHeader: n.isHeader ?? !1,
       event: n.event ?? new MouseEvent("contextmenu")
-    }, o = v(this.config.items ?? w, l);
+    }, s = v(this.config.items ?? w, l);
     this.menuElement && this.menuElement.remove(), this.menuElement = x(
-      o,
+      s,
       l,
       (i) => {
         i.action && i.action(l), this.menuElement?.remove(), this.menuElement = null, this.isOpen = !1;