@toolbox-web/grid 0.6.0 → 1.0.0

package/lib/plugins/context-menu/index.d.ts

@@ -1,7 +1,9 @@
 /**
  * Context Menu Plugin Entry Point
  * Re-exports plugin class and types for tree-shakeable imports.
+ *
+ * @module Plugins/Context Menu
  */
 export { ContextMenuPlugin } from './ContextMenuPlugin';
-export type { ContextMenuItem, ContextMenuConfig, ContextMenuParams } from './types';
+export type { ContextMenuConfig, ContextMenuItem, ContextMenuParams } from './types';
 //# sourceMappingURL=index.d.ts.map

package/lib/plugins/context-menu/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../libs/grid/src/lib/plugins/context-menu/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,YAAY,EAAE,eAAe,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../libs/grid/src/lib/plugins/context-menu/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,YAAY,EAAE,iBAAiB,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC"}

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

@@ -184,23 +184,6 @@ class I {
   get gridElement() {
     return this.grid;
   }
-  /**
-   * Get the render root of the grid for DOM queries.
-   * @deprecated Use `gridElement` instead. This getter exists only for backward compatibility.
-   *
-   * With Shadow DOM removed, the grid element itself is the render root.
-   * All new code should use `this.gridElement` for DOM queries.
-   *
-   * @example
-   * // OLD (deprecated)
-   * const rows = this.shadowRoot?.querySelector('.rows');
-   *
-   * // NEW (preferred)
-   * const rows = this.gridElement.querySelector('.rows');
-   */
-  get shadowRoot() {
-    return this.gridElement;
-  }
   /**
    * Get the disconnect signal for event listener cleanup.
    * This signal is aborted when the grid disconnects from the DOM.
@@ -335,7 +318,7 @@ function x(r, e, t, n = C.submenuArrow) {
       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 h = v(o.subMenu, e), c = x(h, e, t, n);
+        const f = v(o.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");
@@ -354,7 +337,7 @@ function y(r, e, t) {
   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";
 }
-let f = null, b = null, m = null, p = 0;
+let h = null, b = null, m = null, p = 0;
 const w = [
   {
     id: "copy",
@@ -374,7 +357,9 @@ const w = [
   }
 ];
 class H extends I {
+  /** @internal */
   name = "contextMenu";
+  /** @internal */
   get defaultConfig() {
     return {
       items: w
@@ -387,18 +372,20 @@ class H extends I {
   menuElement = null;
   // #endregion
   // #region Lifecycle
+  /** @internal */
   attach(e) {
     super.attach(e), this.installGlobalHandlers(), p++;
   }
+  /** @internal */
   detach() {
     this.menuElement && (this.menuElement.remove(), this.menuElement = null), this.isOpen = !1, this.params = null, this.uninstallGlobalHandlers();
   }
   // #endregion
   // #region Private Methods
   installGlobalHandlers() {
-    !m && typeof document < "u" && typeof g == "string" && g && (m = document.createElement("style"), m.id = "tbw-context-menu-styles", m.textContent = g, document.head.appendChild(m)), f || (f = () => {
+    !m && typeof document < "u" && typeof g == "string" && g && (m = document.createElement("style"), m.id = "tbw-context-menu-styles", m.textContent = g, document.head.appendChild(m)), h || (h = () => {
       document.querySelectorAll(".tbw-context-menu").forEach((t) => t.remove());
-    }, document.addEventListener("click", f)), b || (b = (e) => {
+    }, document.addEventListener("click", h)), b || (b = (e) => {
       e.key === "Escape" && document.querySelectorAll(".tbw-context-menu").forEach((n) => n.remove());
     }, document.addEventListener("keydown", b));
   }
@@ -407,10 +394,11 @@ class H extends I {
    * Uses reference counting to ensure handlers persist while any grid uses the plugin.
    */
   uninstallGlobalHandlers() {
-    p--, !(p > 0) && (f && (document.removeEventListener("click", f), f = null), b && (document.removeEventListener("keydown", b), b = null), m && (m.remove(), m = null));
+    p--, !(p > 0) && (h && (document.removeEventListener("click", h), h = null), b && (document.removeEventListener("keydown", b), b = null), m && (m.remove(), m = null));
   }
   // #endregion
   // #region Hooks
+  /** @internal */
   afterRender() {
     const e = this.gridElement;
     if (!e) return;
@@ -421,25 +409,25 @@ class H extends I {
       const o = l.target, i = o.closest("[data-row][data-col]"), d = o.closest(".header-cell");
       let a;
       if (i) {
-        const u = parseInt(i.getAttribute("data-row") ?? "-1", 10), h = parseInt(i.getAttribute("data-col") ?? "-1", 10), c = this.columns[h], E = this.rows[u];
+        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 = {
           row: E,
           rowIndex: u,
           column: c,
-          columnIndex: h,
+          columnIndex: f,
           field: c?.field ?? "",
           value: E?.[c?.field] ?? null,
           isHeader: !1,
           event: l
         };
       } else if (d) {
-        const u = parseInt(d.getAttribute("data-col") ?? "-1", 10), h = this.columns[u];
+        const u = parseInt(d.getAttribute("data-col") ?? "-1", 10), f = this.columns[u];
         a = {
           row: null,
           rowIndex: -1,
-          column: h,
+          column: f,
           columnIndex: u,
-          field: h?.field ?? "",
+          field: f?.field ?? "",
           value: null,
           isHeader: !0,
           event: l