impact-nova 2.1.0-alpha.3 → 2.1.0-alpha.5

package/dist/components/data/ag-grid-react/index.js

@@ -1,67 +1,67 @@
-import { jsxs as fe, jsx as v } from "react/jsx-runtime";
-import { lazy as me, useRef as S, useState as w, useCallback as f, useMemo as y, useEffect as ge, Suspense as he } from "react";
-import { ModuleRegistry as Ce, AllCommunityModule as ye, ValidationModule as ve } from "ag-grid-community";
-import { AllEnterpriseModule as be } from "ag-grid-enterprise";
-import { AgGridReact as xe } from "ag-grid-react";
-import { customAgGridTheme as Se } from "./theme.js";
-import { CustomHeader as Fe } from "./headers/custom-header.js";
-import { CustomHeaderGroup as Me } from "./headers/custom-header-group.js";
-import { DefaultTextCellRenderer as Ee } from "./cell-renderers/default-text-cell-renderer.js";
-import { GridHeaderContext as Ae } from "./headers/context/grid-header-context.js";
-import { convertToAgGridFilterModel as Re, getMultiFilterIndices as Ge, convertFromAgGridFilterModel as ke } from "./headers/utils/filter-utils.js";
-import { ColumnSettingsMenu as je } from "./headers/column-menu/column-settings-menu.js";
-import { AG_GRID_VALUE_FORMATTERS as we } from "./value-formatters.js";
-import { useGridAutoSizeStrategyOnResize as Ie } from "./useGridAutoSizeStrategyOnResize.js";
-import { subscribeGridApiEvent as et, subscribeGridApiEvents as tt } from "./grid-api-event-subscription.js";
+import { jsxs as Ce, jsx as v } from "react/jsx-runtime";
+import { lazy as ye, useRef as S, useState as j, useCallback as f, useMemo as y, useEffect as ve, Suspense as be } from "react";
+import { ModuleRegistry as xe, AllCommunityModule as Se, ValidationModule as Fe } from "ag-grid-community";
+import { AllEnterpriseModule as Me } from "ag-grid-enterprise";
+import { AgGridReact as Ee } from "ag-grid-react";
+import { customAgGridTheme as Ae } from "./theme.js";
+import { CustomHeader as Re } from "./headers/custom-header.js";
+import { CustomHeaderGroup as Ge } from "./headers/custom-header-group.js";
+import { DefaultTextCellRenderer as ke } from "./cell-renderers/default-text-cell-renderer.js";
+import { GridHeaderContext as we } from "./headers/context/grid-header-context.js";
+import { convertToAgGridFilterModel as je, getMultiFilterIndices as Te, convertFromAgGridFilterModel as Ie } from "./headers/utils/filter-utils.js";
+import { ColumnSettingsMenu as Oe } from "./headers/column-menu/column-settings-menu.js";
+import { AG_GRID_VALUE_FORMATTERS as Pe } from "./value-formatters.js";
+import { useGridAutoSizeStrategyOnResize as De } from "./useGridAutoSizeStrategyOnResize.js";
+import { subscribeGridApiEvent as ot, subscribeGridApiEvents as lt } from "./grid-api-event-subscription.js";
 /* empty css               */
-const Te = me(
+const He = ye(
   () => import("./headers/advanced-filter/advanced-filter-dialog.js").then((l) => ({
     default: l.AdvancedFilterDialog
   }))
 );
-Ce.registerModules([ye, be, ve]);
-const F = "
", H = "";
-function K(l) {
+xe.registerModules([Se, Me, Fe]);
+const F = "
", N = "";
+function $(l) {
   return l.getColumns()?.some((n) => n.getColDef().headerCheckboxSelection) ?? !1;
 }
-const U = (l) => {
+const q = (l) => {
   if (!l) return;
   const n = l.cellRendererParams?.splits;
   if (Array.isArray(n) && n.length > 0) return n;
   const i = l.cellEditorParams?.splits;
   if (Array.isArray(i) && i.length > 0) return i;
-}, $ = (l, n) => {
+}, z = (l, n) => {
   const i = [];
-  for (const h of n) {
-    const m = h?.field?.split(".").pop();
+  for (const g of n) {
+    const m = g?.field?.split(".").pop();
     if (!m) {
       i.push("");
       continue;
     }
-    const c = l[m];
-    if (c == null) {
+    const a = l[m];
+    if (a == null) {
       i.push("");
       continue;
     }
-    if (typeof c == "object" && "value" in c) {
-      const u = c.value;
+    if (typeof a == "object" && "value" in a) {
+      const u = a.value;
       i.push(u == null ? "" : String(u));
       continue;
     }
-    if (typeof c != "object") {
-      i.push(String(c));
+    if (typeof a != "object") {
+      i.push(String(a));
       continue;
     }
     i.push("");
   }
   return i;
-}, q = (l) => {
+}, B = (l) => {
   if (typeof navigator < "u" && navigator.clipboard?.writeText) {
-    navigator.clipboard.writeText(l).catch(() => z(l));
+    navigator.clipboard.writeText(l).catch(() => J(l));
     return;
   }
-  z(l);
-}, z = (l) => {
+  J(l);
+}, J = (l) => {
   if (typeof document > "u") return;
   const n = document.createElement("textarea");
   n.value = l, n.setAttribute("readonly", ""), n.style.position = "fixed", n.style.top = "0", n.style.left = "0", n.style.opacity = "0", n.style.pointerEvents = "none", document.body.appendChild(n);
@@ -71,24 +71,28 @@ const U = (l) => {
     document.body.removeChild(n);
   }
 };
-function Qe({
+function tt({
   children: l,
   defaultColDef: n,
   defaultColGroupDef: i,
-  columnDefs: h,
+  columnDefs: g,
   valueFormatters: m,
-  onGridReady: c,
+  onGridReady: a,
   onGridPreDestroyed: u,
   onFilterChanged: b,
-  onSelectionChanged: C,
+  onSelectionChanged: h,
   onModelUpdated: M,
-  ensureDomOrder: I = !0,
-  autoSizeStrategy: T,
-  ...g
+  ensureDomOrder: T = !1,
+  autoSizeStrategy: I,
+  tooltipShowMode: O = "whenTruncated",
+  tooltipShowDelay: P = 500,
+  tooltipHideDelay: X = 5e3,
+  tooltipInteraction: Q = !0,
+  ...C
 }) {
-  const a = S(null), O = S(null), [P, L] = w(null);
-  Ie(P, O, T);
-  const [B, N] = w(!1), [J, _] = w(null), [X, V] = w(!1), E = S(null), D = S(null), A = S(null), Q = f(() => [], []), Y = y(() => ({
+  const c = S(null), D = S(null), [H, _] = j(null);
+  De(H, D, I);
+  const [Y, V] = j(!1), [Z, W] = j(null), [ee, K] = j(!1), E = S(null), L = S(null), A = S(null), te = f(() => [], []), re = y(() => ({
     numericColumn: {
       cellClass: "ag-right-aligned-cell",
       headerClass: "ag-right-aligned-header",
@@ -111,31 +115,31 @@ function Qe({
     }
   }), []), R = y(() => ({
     openSearch: (e) => {
-      if (!a.current) return;
-      const t = a.current.getGridOption("context") || {};
-      a.current.setGridOption("context", { ...t, activeSearchColumnId: e }), a.current.refreshHeader();
+      if (!c.current) return;
+      const t = c.current.getGridOption("context") || {};
+      c.current.setGridOption("context", { ...t, activeSearchColumnId: e }), c.current.refreshHeader();
     },
     closeSearch: () => {
-      if (!a.current) return;
-      const e = a.current.getGridOption("context") || {};
-      a.current.setGridOption("context", { ...e, activeSearchColumnId: null }), a.current.refreshHeader();
+      if (!c.current) return;
+      const e = c.current.getGridOption("context") || {};
+      c.current.setGridOption("context", { ...e, activeSearchColumnId: null }), c.current.refreshHeader();
     },
     openAdvancedFilter: (e) => {
-      _(e || null), N(!0);
+      W(e || null), V(!0);
     },
     closeAdvancedFilter: () => {
-      N(!1), _(null);
+      V(!1), W(null);
     },
     applyAdvancedFilter: (e) => {
-      if (!a.current) return;
-      const t = Re(e);
-      a.current.setFilterModel(t), a.current.onFilterChanged(), a.current.refreshHeader();
+      if (!c.current) return;
+      const t = je(e);
+      c.current.setFilterModel(t), c.current.onFilterChanged(), c.current.refreshHeader();
     },
     openMenu: (e, t, o = "column") => {
-      E.current = e, D.current = t, A.current = o, V(!0);
+      E.current = e, L.current = t, A.current = o, K(!0);
     },
     closeMenu: () => {
-      E.current = null, D.current = null, A.current = null, V(!1);
+      E.current = null, L.current = null, A.current = null, K(!1);
     },
     // Getters read from refs - O(1) per header, no memory allocation
     get activeMenuColumnId() {
@@ -144,33 +148,33 @@ function Qe({
     get activeMenuVariant() {
       return A.current;
     }
-  }), []), Z = f((e) => {
-    a.current = e.api, L(e.api);
+  }), []), ne = f((e) => {
+    c.current = e.api, _(e.api);
     const t = e.api.getGridOption("context") || {};
-    e.api.setGridOption("context", { ...t, activeSearchColumnId: null }), c && c(e);
-  }, [c]), ee = f(
+    e.api.setGridOption("context", { ...t, activeSearchColumnId: null }), a && a(e);
+  }, [a]), oe = f(
     (e) => {
-      a.current = null, L(null), u?.(e);
+      c.current = null, _(null), u?.(e);
     },
     [u]
-  ), te = f(
+  ), le = f(
     (e) => {
       e.api.getGridOption("context")?.activeSearchColumnId || e.api.refreshHeader(), b?.(e);
     },
     [b]
-  ), re = f(
+  ), ie = f(
     (e) => {
-      K(e.api) && e.api.refreshHeader(), C?.(e);
+      $(e.api) && e.api.refreshHeader(), h?.(e);
     },
-    [C]
-  ), ne = f(
+    [h]
+  ), se = f(
     (e) => {
-      e.api.getGridOption("rowModelType") !== "serverSide" && K(e.api) && e.api.refreshHeader(), M?.(e);
+      e.api.getGridOption("rowModelType") !== "serverSide" && $(e.api) && e.api.refreshHeader(), M?.(e);
     },
     [M]
   );
-  ge(() => {
-    const e = O.current;
+  ve(() => {
+    const e = D.current;
     if (!e) return;
     const t = (o) => {
       if (o.key !== "Enter" && o.key !== " ") return;
@@ -183,12 +187,12 @@ function Qe({
     };
     return e.addEventListener("keydown", t, !0), () => e.removeEventListener("keydown", t, !0);
   }, []);
-  const oe = y(() => ({
-    headerComponent: Fe,
+  const ae = y(() => ({
+    headerComponent: Re,
     // Default cell renderer wraps text in a span so display:flex centering
     // and text-overflow:ellipsis both work (ellipsis doesn't work on
     // anonymous flex text nodes, but works on flex child elements).
-    cellRenderer: Ee,
+    cellRenderer: ke,
     ...n,
     suppressHeaderKeyboardEvent: (e) => {
       const { event: t } = e, o = t.target;
@@ -207,34 +211,34 @@ function Qe({
     headerComponentParams: {
       ...n?.headerComponentParams
     }
-  }), [n]), le = y(() => ({
-    headerGroupComponent: Me,
+  }), [n]), ce = y(() => ({
+    headerGroupComponent: Ge,
     ...i,
     headerGroupComponentParams: {
       ...i?.headerGroupComponentParams
     }
-  }), [i]), ie = y(() => ({
-    ...we,
+  }), [i]), ue = y(() => ({
+    ...Pe,
     // Always available - value formatters
-    ...g.components,
+    ...C.components,
     // User components override
     ...m
     // Optional custom formatters override defaults
-  }), [m, g.components]), se = f((e) => {
+  }), [m, C.components]), de = f((e) => {
     const t = e.value;
     if (t == null || typeof t != "object") return t;
-    const o = U(e.column?.getColDef());
+    const o = q(e.column?.getColDef());
     if (o && o.length > 0) {
-      const r = $(t, o);
+      const r = z(t, o);
       if (o.length === 1) {
         const d = o[0]?.field?.split(".").pop(), x = d ? t[d] : void 0;
         return x && typeof x == "object" && "value" in x ? x.value ?? "" : r[0];
       }
-      return H + r.join(F);
+      return N + r.join(F);
     }
     const s = Object.entries(t).map(([, r]) => r && typeof r == "object" && "value" in r ? r.value : typeof r != "object" && typeof r < "u" ? r : null).filter((r) => r != null);
     return s.length === 0 ? "" : s.length === 1 ? s[0] : s.join(F);
-  }, []), ae = f((e) => {
+  }, []), pe = f((e) => {
     if (typeof e.value == "string") {
       const t = e.value.trim();
       if (t.startsWith("{") || t.startsWith("["))
@@ -245,10 +249,10 @@ function Qe({
         }
     }
     return e.value;
-  }, []), ce = f((e) => {
+  }, []), fe = f((e) => {
     const t = e?.data ?? "";
-    if (!t.includes(F) && !t.includes(H)) {
-      q(t);
+    if (!t.includes(F) && !t.includes(N)) {
+      B(t);
       return;
     }
     const o = [], s = t.split(`
@@ -259,25 +263,25 @@ function Qe({
         o.push("");
         continue;
       }
-      const k = d.split("	").map((p) => p.startsWith(H) ? { isSplit: !0, slots: p.slice(1).split(F) } : { isSplit: !1, slots: p.split(F) }), W = Math.max(1, ...k.map((p) => p.slots.length));
-      if (W === 1) {
+      const k = d.split("	").map((p) => p.startsWith(N) ? { isSplit: !0, slots: p.slice(1).split(F) } : { isSplit: !1, slots: p.split(F) }), U = Math.max(1, ...k.map((p) => p.slots.length));
+      if (U === 1) {
         o.push(k.map((p) => p.slots[0] ?? "").join("	"));
         continue;
       }
-      for (let p = 0; p < W; p++) {
-        const pe = k.map((j) => !j.isSplit && j.slots.length === 1 ? j.slots[0] : j.slots[p] ?? "");
-        o.push(pe.join("	"));
+      for (let p = 0; p < U; p++) {
+        const he = k.map((w) => !w.isSplit && w.slots.length === 1 ? w.slots[0] : w.slots[p] ?? "");
+        o.push(he.join("	"));
       }
     }
-    q(o.join(`
+    B(o.join(`
 `));
   }, []), G = f((e) => {
     const t = e.value;
     if (t == null) return "";
     if (typeof t != "object") return String(t);
-    const o = U(e.column?.getColDef());
+    const o = q(e.column?.getColDef());
     if (o && o.length > 0) {
-      const r = $(t, o);
+      const r = z(t, o);
       return o.length === 1 ? r[0] : r.join(`
 `);
     }
@@ -293,118 +297,122 @@ function Qe({
     }
     return s.length === 0 ? "" : s.length === 1 ? s[0] : s.join(`
 `);
-  }, []), ue = y(() => ({
+  }, []), me = y(() => ({
     processCellCallback: G,
-    ...g.defaultCsvExportParams ?? {}
-  }), [G, g.defaultCsvExportParams]), de = y(() => ({
+    ...C.defaultCsvExportParams ?? {}
+  }), [G, C.defaultCsvExportParams]), ge = y(() => ({
     processCellCallback: G,
-    ...g.defaultExcelExportParams ?? {}
-  }), [G, g.defaultExcelExportParams]);
-  return /* @__PURE__ */ fe(Ae.Provider, { value: R, children: [
-    /* @__PURE__ */ v("div", { ref: O, "data-component": "ag-grid-react", style: { width: "100%", height: "100%" }, children: /* @__PURE__ */ v(
-      xe,
+    ...C.defaultExcelExportParams ?? {}
+  }), [G, C.defaultExcelExportParams]);
+  return /* @__PURE__ */ Ce(we.Provider, { value: R, children: [
+    /* @__PURE__ */ v("div", { ref: D, "data-component": "ag-grid-react", style: { width: "100%", height: "100%" }, children: /* @__PURE__ */ v(
+      Ee,
       {
-        theme: Se,
-        defaultColDef: oe,
-        columnDefs: h,
+        theme: Ae,
+        defaultColDef: ae,
+        columnDefs: g,
         cellSelection: !0,
-        defaultColGroupDef: le,
-        onGridReady: Z,
-        onGridPreDestroyed: ee,
-        onFilterChanged: te,
-        onSelectionChanged: re,
-        onModelUpdated: ne,
-        components: ie,
-        processCellForClipboard: se,
-        processCellFromClipboard: ae,
-        sendToClipboard: ce,
-        ensureDomOrder: I,
+        defaultColGroupDef: ce,
+        onGridReady: ne,
+        onGridPreDestroyed: oe,
+        onFilterChanged: le,
+        onSelectionChanged: ie,
+        onModelUpdated: se,
+        components: ue,
+        tooltipShowMode: O,
+        tooltipShowDelay: P,
+        tooltipHideDelay: X,
+        tooltipInteraction: Q,
+        processCellForClipboard: de,
+        processCellFromClipboard: pe,
+        sendToClipboard: fe,
+        ensureDomOrder: T,
         suppressHeaderFocus: !1,
         suppressFocusAfterRefresh: !0,
         suppressGroupRowsSticky: !0,
         hidePaddedHeaderRows: !0,
         suppressServerSideFullWidthLoadingRow: !0,
-        columnTypes: Y,
-        autoSizeStrategy: T,
-        ...g,
-        defaultCsvExportParams: ue,
-        defaultExcelExportParams: de,
-        getMainMenuItems: Q
+        columnTypes: re,
+        autoSizeStrategy: I,
+        ...C,
+        defaultCsvExportParams: me,
+        defaultExcelExportParams: ge,
+        getMainMenuItems: te
       }
     ) }),
     l,
     /* @__PURE__ */ v(
-      Oe,
+      Le,
       {
-        isOpen: B,
-        columnId: J,
-        gridApi: P,
+        isOpen: Y,
+        columnId: Z,
+        gridApi: H,
         onClose: R.closeAdvancedFilter,
         onApply: R.applyAdvancedFilter
       }
     ),
     /* @__PURE__ */ v(
-      Pe,
+      Ne,
       {
-        isOpen: X,
+        isOpen: ee,
         columnId: E.current,
-        gridApi: P,
-        anchor: D.current,
+        gridApi: H,
+        anchor: L.current,
         variant: A.current,
         onClose: R.closeMenu
       }
     )
   ] });
 }
-function Oe({
+function Le({
   isOpen: l,
   columnId: n,
   gridApi: i,
-  onClose: h,
+  onClose: g,
   onApply: m
 }) {
   if (!l || !n || !i) return null;
-  const c = i.getColumn(n);
-  if (!c) return null;
-  const u = c.getColDef(), b = u.headerComponentParams, C = Ge(u), M = C.text !== -1 || C.number !== -1 || C.date !== -1, I = C.set !== -1, g = u.filter === "agMultiColumnFilter" && (M || I) ? "multi" : u.filter === "agNumberColumnFilter" ? "number" : u.filter === "agDateColumnFilter" ? "date" : u.filter === "agSetColumnFilter" || b?.selectOptions ? "select" : "text", a = ke(i.getFilterModel());
-  return /* @__PURE__ */ v(he, { fallback: null, children: /* @__PURE__ */ v(
-    Te,
+  const a = i.getColumn(n);
+  if (!a) return null;
+  const u = a.getColDef(), b = u.headerComponentParams, h = Te(u), M = h.text !== -1 || h.number !== -1 || h.date !== -1, T = h.set !== -1, O = u.filter === "agMultiColumnFilter" && (M || T) ? "multi" : u.filter === "agNumberColumnFilter" ? "number" : u.filter === "agDateColumnFilter" ? "date" : u.filter === "agSetColumnFilter" || b?.selectOptions ? "select" : "text", P = Ie(i.getFilterModel());
+  return /* @__PURE__ */ v(be, { fallback: null, children: /* @__PURE__ */ v(
+    He,
     {
       isOpen: l,
-      onClose: h,
+      onClose: g,
       onApply: m,
       columnId: n,
       columnLabel: u.headerName || n,
-      columnType: g,
+      columnType: O,
       selectOptions: b?.selectOptions,
       isMultiSelect: b?.isMultiSelect,
-      initialModel: a,
+      initialModel: P,
       api: i
     }
   ) });
 }
-function Pe({
+function Ne({
   isOpen: l,
   columnId: n,
   gridApi: i,
-  anchor: h,
+  anchor: g,
   variant: m,
-  onClose: c
+  onClose: a
 }) {
   return !l || !n || !i ? null : /* @__PURE__ */ v(
-    je,
+    Oe,
     {
       isOpen: l,
       columnId: n,
       gridApi: i,
-      anchor: h,
+      anchor: g,
       variant: m || "column",
-      onClose: c
+      onClose: a
     }
   );
 }
 export {
-  Qe as AgGridWrapper,
-  et as subscribeGridApiEvent,
-  tt as subscribeGridApiEvents
+  tt as AgGridWrapper,
+  ot as subscribeGridApiEvent,
+  lt as subscribeGridApiEvents
 };

package/dist/components/data/ag-grid-react/theme.js

@@ -40,6 +40,9 @@ const d = e.withPart(r).withParams({
   menuBorder: !1,
   menuShadow: "#00000040 0px 0px 2px 0px",
   menuTextColor: "#1F2B4D",
+  tooltipBackgroundColor: "#1F2B4D",
+  tooltipTextColor: "#FFFFFF",
+  tooltipBorder: !1,
   pinnedRowBackgroundColor: "#F4F1F9",
   pinnedSourceRowBackgroundColor: "#F4F1F9",
   pinnedRowBorder: !1

package/dist/components/data/ag-grid-react/use-ag-grid-truncation-tooltip.d.ts

@@ -0,0 +1,5 @@
+import { RefObject } from 'react';
+import { AgGridTooltipOverflowMode } from './ag-grid-tooltip-overflow';
+type AgGridSetTooltip = (value: string, shouldDisplayTooltip?: () => boolean) => void;
+export declare function useAgGridTruncationTooltip(setTooltip: AgGridSetTooltip | undefined, text: string, elementRef: RefObject<HTMLElement | null>, mode?: AgGridTooltipOverflowMode): void;
+export {};

package/dist/components/data/ag-grid-react/use-ag-grid-truncation-tooltip.js

@@ -0,0 +1,13 @@
+import { useEffect as c } from "react";
+import { isAgGridTextOverflowing as e } from "./ag-grid-tooltip-overflow.js";
+function m(r, i, n, f = "line-clamp") {
+  c(() => {
+    !r || !i.trim() || r(i, () => {
+      const u = n.current;
+      return u ? e(u, f) : !1;
+    });
+  }, [r, i, n, f]);
+}
+export {
+  m as useAgGridTruncationTooltip
+};

package/dist/components/data/ag-grid-react/useGridAutoSizeStrategyOnResize.js

@@ -1,6 +1,6 @@
 import { useEffect as a } from "react";
-import { subscribeGridApiEvents as l } from "./grid-api-event-subscription.js";
-import { refreshGridAutoSizeStrategy as f } from "./refreshGridAutoSizeStrategy.js";
+import { subscribeGridApiEvents as f } from "./grid-api-event-subscription.js";
+import { refreshGridAutoSizeStrategy as l } from "./refreshGridAutoSizeStrategy.js";
 function v(e, s, o) {
   a(() => {
     if (!e || !o)
@@ -11,16 +11,19 @@ function v(e, s, o) {
     let n = 0, r = 0;
     const c = () => {
       cancelAnimationFrame(r), r = requestAnimationFrame(() => {
-        e.isDestroyed() || f(e);
+        e.isDestroyed() || l(e);
       });
     }, m = new ResizeObserver(() => {
       const i = t.clientWidth;
       i <= 0 || i === n || (n = i, c());
     });
     n = t.clientWidth, m.observe(t);
-    const u = l(
+    const u = f(
       e,
-      ["columnVisible", "displayedColumnsChanged"],
+      // columnVisible: user toggled column visibility in settings.
+      // Do NOT subscribe to displayedColumnsChanged — it fires during horizontal
+      // scroll when column virtualization swaps cells and would re-run autoSize.
+      ["columnVisible"],
       c
     );
     return () => {

package/dist/components/data/data-table/data-table-column-apply.d.ts

@@ -0,0 +1,16 @@
+import { ColumnPinnedType, GridApi } from 'ag-grid-community';
+/** Debounce window for coalescing external grid column events into one UI sync. */
+export declare const EXTERNAL_SYNC_DEBOUNCE_MS = 150;
+/**
+ * Fallback when AG Grid may asynchronously reject a new pin (pinned viewport full).
+ * Event-driven detection is primary; this only covers the "no rejection fired" path.
+ */
+export declare const GRID_AUTO_UNPIN_WAIT_MS = 300;
+export type NormalizedColumnPin = 'left' | 'right' | null;
+export declare function normalizeColumnPinned(pinned: ColumnPinnedType | boolean | null | undefined): NormalizedColumnPin;
+export declare function readGridColumnPinned(gridApi: GridApi, columnId: string): NormalizedColumnPin;
+/**
+ * Run after `applyColumnState` returns. AG Grid applies pin/order/hide synchronously;
+ * `queueMicrotask` lets any same-turn grid events finish before we release the panel lock.
+ */
+export declare function afterSynchronousColumnApply(onSettled: () => void): void;

package/dist/components/data/data-table/data-table-column-apply.js

@@ -0,0 +1,18 @@
+const e = 150, o = 300;
+function u(n) {
+  return n === "left" || n === !0 ? "left" : n === "right" ? "right" : null;
+}
+function l(n, r) {
+  const t = n.getColumn(r);
+  return t ? u(t.getPinned()) : null;
+}
+function i(n) {
+  queueMicrotask(n);
+}
+export {
+  e as EXTERNAL_SYNC_DEBOUNCE_MS,
+  o as GRID_AUTO_UNPIN_WAIT_MS,
+  i as afterSynchronousColumnApply,
+  u as normalizeColumnPinned,
+  l as readGridColumnPinned
+};

package/dist/components/data/data-table/data-table-column-list.d.ts

@@ -1,8 +1,18 @@
-interface DataTableColumnListProps {
+/**
+ * Column visibility, order, and pin picker backed by AG Grid `gridApi`.
+ * Must render inside `DataTable` (reads `useDataTable().gridApi`).
+ */
+export type DataTableColumnListProps = {
+    /**
+     * When `true`, column changes stay staged until the user clicks Apply (Discard resets).
+     * When `false` (default), visibility, order, and pin updates apply to the grid immediately.
+     */
     enableApplyDiscard?: boolean;
+    /** Show the search field that filters the column tree. Default `true`. */
     showSearch?: boolean;
+    /** Show the select-all control for column visibility. Default `true`. */
     showSelectAll?: boolean;
+    /** Show collapse/expand controls on nested column group headers. Default `true`. */
     showCollapse?: boolean;
-}
+};
 export declare const DataTableColumnList: ({ enableApplyDiscard, showSearch, showSelectAll, showCollapse }: DataTableColumnListProps) => import("react/jsx-runtime").JSX.Element;
-export {};