@toolbox-web/grid-react 2.4.0 → 2.5.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Øystein Amundsen
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,7 +1,7 @@
 # @toolbox-web/grid-react
 
 [![npm](https://img.shields.io/npm/v/@toolbox-web/grid-react.svg)](https://www.npmjs.com/package/@toolbox-web/grid-react)
-[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](../../LICENSE)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](./LICENSE)
 [![GitHub Sponsors](https://img.shields.io/badge/Sponsor-❤-ea4aaa?logo=github)](https://github.com/sponsors/OysteinAmundsen)
 
 React adapter for `@toolbox-web/grid` data grid component. Provides components and hooks for declarative React integration with custom cell renderers and editors.

package/chunks/feature-registry-DKPyd2rV.js

@@ -0,0 +1,2 @@
+import { clearFeatureRegistry as e, createPluginFromFeature as t, getFeatureFactory as n, getRegisteredFeatures as r, isFeatureRegistered as i, registerFeature as a } from "@toolbox-web/grid/features/registry";
+export { i as a, r as i, t as n, a as o, n as r, e as t };

package/chunks/{react-column-config-Cto2WHGC.js → react-column-config-CkBIwx2L.js}

@@ -123,4 +123,4 @@ function g(e) {
 	return n[a] = !0, n;
 }
 //#endregion
-export { r as a, i, l as n, g as r, s as t };
+export { f as a, p as i, l as n, i as o, g as r, r as s, s as t };

package/chunks/{react-grid-adapter-C_TSA5_P.js → react-grid-adapter-DP9A9ytc.js}

@@ -1,19 +1,19 @@
 import { a as e, i as t, r as n, t as r } from "./portal-bridge-zxgm_jwK.js";
-import { i, r as a, t as o } from "./react-column-config-Cto2WHGC.js";
-import { Children as s, isValidElement as c, useCallback as l, useEffect as u, useRef as d } from "react";
-import { jsx as f } from "react/jsx-runtime";
+import { a as i, i as a, o, r as s, t as c } from "./react-column-config-CkBIwx2L.js";
+import { Children as l, isValidElement as u, useCallback as d, useEffect as f, useRef as p } from "react";
+import { jsx as m } from "react/jsx-runtime";
 //#region libs/grid-react/src/lib/child-feature-detector.ts
-var p = /* @__PURE__ */ new Map();
-function m(e, t) {
-	p.set(e, t);
+var h = /* @__PURE__ */ new Map();
+function g(e, t) {
+	h.set(e, t);
 }
-function h(e) {
+function _(e) {
 	let t = {};
-	return p.size === 0 || s.forEach(e, (e) => {
-		if (!c(e)) return;
+	return h.size === 0 || l.forEach(e, (e) => {
+		if (!u(e)) return;
 		let n = e.type, r = typeof n == "string" ? void 0 : n?.displayName;
 		if (typeof r != "string") return;
-		let i = p.get(r);
+		let i = h.get(r);
 		if (!i) return;
 		let a = i(e);
 		a && Object.assign(t, a);
@@ -21,12 +21,12 @@ function h(e) {
 }
 //#endregion
 //#region libs/grid-react/src/lib/feature-prop-keys.ts
-var g = /* @__PURE__ */ new Set(), _ = null;
-function v(e) {
-	g.has(e) || (g.add(e), _ = null);
+var v = /* @__PURE__ */ new Set(), y = null;
+function b(e) {
+	v.has(e) || (v.add(e), y = null);
 }
-function y() {
-	return _ === null && (_ = Object.freeze(Array.from(g))), _;
+function x() {
+	return y === null && (y = Object.freeze(Array.from(v))), y;
 }
 for (let e of [
 	"selection",
@@ -53,24 +53,24 @@ for (let e of [
 	"pivot",
 	"serverSide",
 	"tooltip"
-]) v(e);
+]) b(e);
 //#endregion
 //#region libs/grid-react/src/lib/grid-tool-panel.tsx
-var b = /* @__PURE__ */ new WeakMap(), x = /* @__PURE__ */ new Map();
-function S(e) {
-	let t = b.get(e);
+var S = /* @__PURE__ */ new WeakMap(), C = /* @__PURE__ */ new Map();
+function w(e) {
+	let t = S.get(e);
 	if (t) return t;
 	let n = e.id;
-	if (n) return x.get(n);
+	if (n) return C.get(n);
 }
-function C(e) {
-	let { id: t, title: n, icon: r, tooltip: i, order: a = 100, children: o } = e, s = d(null), c = l((e) => {
-		s.current = e, e && (b.set(e, o), t && x.set(t, o));
+function T(e) {
+	let { id: t, title: n, icon: r, tooltip: i, order: a = 100, children: o } = e, s = p(null), c = d((e) => {
+		s.current = e, e && (S.set(e, o), t && C.set(t, o));
 	}, [o, t]);
-	return u(() => () => {
+	return f(() => () => {
 		let e = s.current;
-		e && (b.delete(e), t && x.delete(t));
-	}, [t]), /* @__PURE__ */ f("tbw-grid-tool-panel", {
+		e && (S.delete(e), t && C.delete(t));
+	}, [t]), /* @__PURE__ */ m("tbw-grid-tool-panel", {
 		ref: c,
 		id: t,
 		title: n,
@@ -81,86 +81,116 @@ function C(e) {
 }
 //#endregion
 //#region libs/grid-react/src/lib/react-grid-adapter.ts
-var w = null, T = null, E = null;
-function D(e) {
-	w = e;
-}
-function O(e) {
-	T = e;
-}
+var E = null, D = null, O = null;
 function k(e) {
 	E = e;
 }
-var A = /* @__PURE__ */ new WeakMap(), j = /* @__PURE__ */ new Map(), M = /* @__PURE__ */ new WeakMap(), N = /* @__PURE__ */ new Map(), P = /* @__PURE__ */ new Set();
-function F(e) {
+function A(e) {
+	D = e;
+}
+function j(e) {
+	O = e;
+}
+var M = /* @__PURE__ */ new WeakMap(), N = /* @__PURE__ */ new Map(), P = /* @__PURE__ */ new WeakMap(), F = /* @__PURE__ */ new Map(), I = /* @__PURE__ */ new Set();
+function L(e) {
 	return e.closest("tbw-grid, [data-tbw-grid]") ?? void 0;
 }
-function I(e, t) {
-	let n = F(e);
-	if (!n) return N;
-	let r = M.get(n);
+function R(e, t) {
+	let n = L(e);
+	if (!n) return F;
+	let r = P.get(n);
 	if (r || !t) return r;
 	let i = /* @__PURE__ */ new Map();
-	return M.set(n, i), i;
+	return P.set(n, i), i;
 }
-function L(e) {
+function z(e) {
 	return e.tagName.toLowerCase() === "tbw-grid-type" ? e.getAttribute("name") : e.closest("tbw-grid-type")?.getAttribute("name") ?? null;
 }
-function R(e, t) {
-	let n = e.getAttribute("field"), r = A.get(e) ?? {};
-	if (r.renderer = t, A.set(e, r), n) {
-		let e = j.get(n) ?? {};
-		e.renderer = t, j.set(n, e);
+function B(e, t) {
+	let n = e.getAttribute("field"), r = M.get(e) ?? {};
+	if (r.renderer = t, M.set(e, r), n) {
+		let e = N.get(n) ?? {};
+		e.renderer = t, N.set(n, e);
+	}
+}
+function V(e, t) {
+	let n = e.getAttribute("field"), r = M.get(e) ?? {};
+	if (r.editor = t, M.set(e, r), n) {
+		let e = N.get(n) ?? {};
+		e.editor = t, N.set(n, e);
+	}
+}
+function H(e, t) {
+	let n = e.getAttribute("field"), r = M.get(e) ?? {};
+	if (r.headerRenderer = t, M.set(e, r), n) {
+		let e = N.get(n) ?? {};
+		e.headerRenderer = t, N.set(n, e);
 	}
 }
-function z(e, t) {
-	let n = e.getAttribute("field"), r = A.get(e) ?? {};
-	if (r.editor = t, A.set(e, r), n) {
-		let e = j.get(n) ?? {};
-		e.editor = t, j.set(n, e);
+function U(e, t) {
+	let n = e.getAttribute("field"), r = M.get(e) ?? {};
+	if (r.headerLabelRenderer = t, M.set(e, r), n) {
+		let e = N.get(n) ?? {};
+		e.headerLabelRenderer = t, N.set(n, e);
 	}
 }
-function B(e) {
-	let t = A.get(e)?.renderer;
+function W(e) {
+	let t = M.get(e)?.headerRenderer;
 	if (!t) {
 		let n = e.getAttribute("field");
-		n && (t = j.get(n)?.renderer);
+		n && (t = N.get(n)?.headerRenderer);
 	}
 	return t;
 }
-function V(e) {
-	let t = A.get(e)?.editor;
+function G(e) {
+	let t = M.get(e)?.headerLabelRenderer;
 	if (!t) {
 		let n = e.getAttribute("field");
-		n && (t = j.get(n)?.editor);
+		n && (t = N.get(n)?.headerLabelRenderer);
 	}
 	return t;
 }
-function H(e, t) {
-	let n = L(e);
+function K(e) {
+	let t = M.get(e)?.renderer;
+	if (!t) {
+		let n = e.getAttribute("field");
+		n && (t = N.get(n)?.renderer);
+	}
+	return t;
+}
+function q(e) {
+	let t = M.get(e)?.editor;
+	if (!t) {
+		let n = e.getAttribute("field");
+		n && (t = N.get(n)?.editor);
+	}
+	return t;
+}
+function J(e, t) {
+	let n = z(e);
 	if (!n) return;
-	let r = I(e, !0);
+	let r = R(e, !0);
 	if (!r) return;
 	let i = r.get(n) ?? {};
-	i.renderer = t, r.set(n, i), P.add(n);
+	i.renderer = t, r.set(n, i), I.add(n);
 }
-function U(e) {
-	let t = L(e);
-	if (t) return I(e, !1)?.get(t)?.renderer;
+function Y(e) {
+	let t = z(e);
+	if (t) return R(e, !1)?.get(t)?.renderer;
 }
-function W(e, t) {
-	let n = L(e);
+function X(e, t) {
+	let n = z(e);
 	if (!n) return;
-	let r = I(e, !0);
+	let r = R(e, !0);
 	if (!r) return;
 	let i = r.get(n) ?? {};
-	i.editor = t, r.set(n, i), P.add(n);
+	i.editor = t, r.set(n, i), I.add(n);
 }
-function G(e) {
-	let t = L(e);
-	if (t) return I(e, !1)?.get(t)?.editor;
+function Z(e) {
+	let t = z(e);
+	if (t) return R(e, !1)?.get(t)?.editor;
 }
-var K = class {
+var Q = class {
 	allPortalKeys = /* @__PURE__ */ new Set();
 	editorPortalKeys = /* @__PURE__ */ new Set();
 	keyToContainer = /* @__PURE__ */ new Map();
@@ -171,21 +201,21 @@ var K = class {
 		this.typeDefaults = e;
 	}
 	processConfig(e) {
-		return a(e) ?? e;
+		return s(e) ?? e;
 	}
 	canHandle(e) {
-		let t = e.getAttribute("field"), n = A.get(e);
+		let t = e.getAttribute("field"), n = M.get(e);
 		if (!n && t) {
-			let r = j.get(t);
-			r && (r.renderer || r.editor) && (n = r, A.set(e, n));
+			let r = N.get(t);
+			r && (r.renderer || r.editor || r.headerRenderer || r.headerLabelRenderer) && (n = r, M.set(e, n));
 		}
-		let r = n?.renderer !== void 0, i = n?.editor !== void 0;
-		if (n !== void 0 && (r || i)) return !0;
-		let a = L(e), o = a ? I(e, !1)?.get(a) : void 0;
-		return !!o && (o.renderer !== void 0 || o.editor !== void 0);
+		let r = n?.renderer !== void 0, i = n?.editor !== void 0, a = n?.headerRenderer !== void 0, o = n?.headerLabelRenderer !== void 0;
+		if (n !== void 0 && (r || i || a || o)) return !0;
+		let s = z(e), c = s ? R(e, !1)?.get(s) : void 0;
+		return !!c && (c.renderer !== void 0 || c.editor !== void 0);
 	}
 	createRenderer(n) {
-		let r = B(n) ?? U(n);
+		let r = K(n) ?? Y(n);
 		if (!r) return;
 		let i = n.closest("tbw-grid, [data-tbw-grid]"), a = /* @__PURE__ */ new WeakMap();
 		return (n) => {
@@ -211,32 +241,40 @@ var K = class {
 		};
 	}
 	createEditor(t) {
-		let n = V(t) ?? G(t);
+		let n = q(t) ?? Z(t);
 		if (!n) return () => document.createElement("div");
 		let r = t.closest("tbw-grid, [data-tbw-grid]") ?? void 0;
 		return (t) => {
-			let a = document.createElement("div");
-			a.className = "react-cell-editor", a.style.display = "contents";
-			let o = e(a, n(t), void 0, r);
-			return this.trackPortal(o, a, !0), r && this.editorBeforeCloseUnsubs.set(o, i(a, r)), a;
+			let i = document.createElement("div");
+			i.className = "react-cell-editor", i.style.display = "contents";
+			let a = e(i, n(t), void 0, r);
+			return this.trackPortal(a, i, !0), r && this.editorBeforeCloseUnsubs.set(a, o(i, r)), i;
 		};
 	}
+	createHeaderRenderer(e) {
+		let t = W(e);
+		if (t) return i(t);
+	}
+	createHeaderLabelRenderer(e) {
+		let t = G(e);
+		if (t) return a(t);
+	}
 	createDetailRenderer(e) {
-		return w?.(e, this.bridgeContext);
+		return E?.(e, this.bridgeContext);
 	}
 	parseDetailElement(e) {
 		let t = e.closest("tbw-grid, [data-tbw-grid]");
 		if (t) return this.createDetailRenderer(t);
 	}
 	createResponsiveCardRenderer(e) {
-		return T?.(e, this.bridgeContext);
+		return D?.(e, this.bridgeContext);
 	}
 	parseResponsiveCardElement(e) {
 		let t = e.closest("tbw-grid, [data-tbw-grid]");
 		if (t) return this.createResponsiveCardRenderer(t);
 	}
 	createToolPanelRenderer(n) {
-		let r = S(n);
+		let r = w(n);
 		if (!r) return;
 		let i = n.closest("tbw-grid, [data-tbw-grid]");
 		return (n) => {
@@ -251,7 +289,7 @@ var K = class {
 		let n = this.typeDefaults[e];
 		if (!n) return;
 		let r = { editorParams: n.editorParams };
-		return n.renderer && (r.renderer = this.createTypeRenderer(n.renderer, t)), n.editor && (r.editor = this.createTypeEditor(n.editor, t)), n.filterPanelRenderer && E && (r.filterPanelRenderer = E(n.filterPanelRenderer, t, this.bridgeContext)), r;
+		return n.renderer && (r.renderer = this.createTypeRenderer(n.renderer, t)), n.editor && (r.editor = this.createTypeEditor(n.editor, t)), n.filterPanelRenderer && O && (r.filterPanelRenderer = O(n.filterPanelRenderer, t, this.bridgeContext)), r;
 	}
 	createTypeRenderer(t, n) {
 		return (r) => {
@@ -284,7 +322,7 @@ var K = class {
 		for (let e of this.allPortalKeys) t(e);
 		this.allPortalKeys.clear(), this.editorPortalKeys.clear(), this.keyToContainer.clear();
 		for (let e of this.editorBeforeCloseUnsubs.values()) e();
-		this.editorBeforeCloseUnsubs.clear(), j.clear();
+		this.editorBeforeCloseUnsubs.clear(), N.clear();
 	}
 	releaseCell(e) {
 		let n = e.querySelectorAll(".react-cell-renderer, .react-cell-editor");
@@ -292,7 +330,7 @@ var K = class {
 			let n = this.containerToKey.get(e);
 			n && (t(n, { sync: !0 }), this.untrackPortal(n));
 		}
-		o(e);
+		c(e);
 	}
 	unmount(e) {
 		let n = this.containerToKey.get(e);
@@ -306,4 +344,4 @@ var K = class {
 	}
 };
 //#endregion
-export { k as a, H as c, v as d, h as f, D as i, C as l, z as n, O as o, m as p, R as r, W as s, K as t, y as u };
+export { B as a, A as c, T as d, x as f, g as h, H as i, X as l, _ as m, V as n, k as o, b as p, U as r, j as s, Q as t, J as u };

package/chunks/use-grid-is-ready-Baa67cu3.js

@@ -0,0 +1,15 @@
+import { useEffect as e, useState as t } from "react";
+//#region libs/grid-react/src/lib/use-grid-is-ready.ts
+function n(n) {
+	let [r, i] = t(!1);
+	return e(() => {
+		let e = !1, t = n();
+		if (t) return Promise.resolve(t.ready?.()).then(() => {
+			e || i(!0);
+		}), () => {
+			e = !0;
+		};
+	}, [n]), r;
+}
+//#endregion
+export { n as t };

package/features/editing.js

@@ -1,8 +1,8 @@
-import { a as e, n as t } from "../chunks/react-column-config-Cto2WHGC.js";
+import { n as e, s as t } from "../chunks/react-column-config-CkBIwx2L.js";
 import "@toolbox-web/grid/features/editing";
 //#region libs/grid-react/src/features/editing.ts
-e(({ container: e, gridEl: n }) => {
-	let r = t(e);
+t(({ container: t, gridEl: n }) => {
+	let r = e(t);
 	return n.addEventListener("before-edit-close", r), () => n.removeEventListener("before-edit-close", r);
 });
 //#endregion

package/features/export.d.ts

@@ -33,6 +33,12 @@ export interface ExportMethods {
         format: ExportFormat;
         timestamp: Date;
     } | null;
+    /**
+     * Whether the grid has finished its first render.
+     *
+     * @since 2.5.0
+     */
+    isReady: boolean;
 }
 /**
  * Hook for programmatic export control.

package/features/export.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"export.d.ts","sourceRoot":"","sources":["../../../../libs/grid-react/src/features/export.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAGH,OAAO,EAAE,KAAK,YAAY,EAAE,KAAK,YAAY,EAAqB,MAAM,kCAAkC,CAAC;AAK3G,OAAO,mCAAmC,CAAC;AAI3C,YAAY,EAAE,aAAa,IAAI,mBAAmB,EAAE,MAAM,mCAAmC,CAAC;AAE9F;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B;;;;OAIG;IACH,WAAW,EAAE,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,KAAK,IAAI,CAAC;IAEzE;;;;OAIG;IACH,aAAa,EAAE,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,KAAK,IAAI,CAAC;IAE3E;;;;OAIG;IACH,YAAY,EAAE,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,KAAK,IAAI,CAAC;IAE1E;;OAEG;IACH,WAAW,EAAE,MAAM,OAAO,CAAC;IAE3B;;OAEG;IACH,aAAa,EAAE,MAAM;QAAE,MAAM,EAAE,YAAY,CAAC;QAAC,SAAS,EAAE,IAAI,CAAA;KAAE,GAAG,IAAI,CAAC;CACvE;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,aAAa,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,aAAa,CAuE9D"}
+{"version":3,"file":"export.d.ts","sourceRoot":"","sources":["../../../../libs/grid-react/src/features/export.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAGH,OAAO,EAAE,KAAK,YAAY,EAAE,KAAK,YAAY,EAAqB,MAAM,kCAAkC,CAAC;AAM3G,OAAO,mCAAmC,CAAC;AAI3C,YAAY,EAAE,aAAa,IAAI,mBAAmB,EAAE,MAAM,mCAAmC,CAAC;AAE9F;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B;;;;OAIG;IACH,WAAW,EAAE,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,KAAK,IAAI,CAAC;IAEzE;;;;OAIG;IACH,aAAa,EAAE,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,KAAK,IAAI,CAAC;IAE3E;;;;OAIG;IACH,YAAY,EAAE,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,KAAK,IAAI,CAAC;IAE1E;;OAEG;IACH,WAAW,EAAE,MAAM,OAAO,CAAC;IAE3B;;OAEG;IACH,aAAa,EAAE,MAAM;QAAE,MAAM,EAAE,YAAY,CAAC;QAAC,SAAS,EAAE,IAAI,CAAA;KAAE,GAAG,IAAI,CAAC;IAEtE;;;;OAIG;IACH,OAAO,EAAE,OAAO,CAAC;CAClB;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,aAAa,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,aAAa,CA6E9D"}

package/features/export.js

@@ -1,12 +1,13 @@
 import { t as e } from "../chunks/grid-element-context-DpuQsoie.js";
-import { useCallback as t, useContext as n } from "react";
+import { t } from "../chunks/use-grid-is-ready-Baa67cu3.js";
+import { useCallback as n, useContext as r } from "react";
 import "@toolbox-web/grid/features/export";
 //#region libs/grid-react/src/features/export.ts
-function r(r) {
-	let i = n(e), a = t(() => (r ? document.querySelector(r) : i?.current)?.getPluginByName("export"), [i, r]);
+function i(i) {
+	let a = r(e), o = n(() => i ? document.querySelector(i) : a?.current, [a, i]), s = n(() => o()?.getPluginByName("export"), [o]), c = t(o);
 	return {
-		exportToCsv: t((e, t) => {
-			let n = a();
+		exportToCsv: n((e, t) => {
+			let n = s();
 			if (!n) {
 				console.warn("[tbw-grid:export] ExportPlugin not found.\n\n  → Enable export on the grid:\n    <DataGrid export />");
 				return;
@@ -15,9 +16,9 @@ function r(r) {
 				...t,
 				fileName: e ?? t?.fileName ?? "export.csv"
 			});
-		}, [a]),
-		exportToExcel: t((e, t) => {
-			let n = a();
+		}, [s]),
+		exportToExcel: n((e, t) => {
+			let n = s();
 			if (!n) {
 				console.warn("[tbw-grid:export] ExportPlugin not found.\n\n  → Enable export on the grid:\n    <DataGrid export />");
 				return;
@@ -26,9 +27,9 @@ function r(r) {
 				...t,
 				fileName: e ?? t?.fileName ?? "export.xlsx"
 			});
-		}, [a]),
-		exportToJson: t((e, t) => {
-			let n = a();
+		}, [s]),
+		exportToJson: n((e, t) => {
+			let n = s();
 			if (!n) {
 				console.warn("[tbw-grid:export] ExportPlugin not found.\n\n  → Enable export on the grid:\n    <DataGrid export />");
 				return;
@@ -37,10 +38,11 @@ function r(r) {
 				...t,
 				fileName: e ?? t?.fileName ?? "export.json"
 			});
-		}, [a]),
-		isExporting: t(() => a()?.isExporting() ?? !1, [a]),
-		getLastExport: t(() => a()?.getLastExport() ?? null, [a])
+		}, [s]),
+		isExporting: n(() => s()?.isExporting() ?? !1, [s]),
+		getLastExport: n(() => s()?.getLastExport() ?? null, [s]),
+		isReady: c
 	};
 }
 //#endregion
-export { r as useGridExport };
+export { i as useGridExport };

package/features/filtering.d.ts

@@ -66,6 +66,12 @@ export interface FilteringMethods {
      * Toggle blank filter mode for a field.
      */
     toggleBlankFilter: (field: string, mode: BlankMode) => void;
+    /**
+     * Whether the grid has finished its first render.
+     *
+     * @since 2.5.0
+     */
+    isReady: boolean;
 }
 /**
  * Hook for programmatic filter control.

package/features/filtering.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"filtering.d.ts","sourceRoot":"","sources":["../../../../libs/grid-react/src/features/filtering.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAGH,OAAO,EAEL,KAAK,SAAS,EAEd,KAAK,WAAW,EAEjB,MAAM,qCAAqC,CAAC;AAiB7C,YAAY,EAAE,aAAa,IAAI,sBAAsB,EAAE,MAAM,sCAAsC,CAAC;AAuDpG;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;;;;OAKG;IACH,SAAS,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,WAAW,EAAE,OAAO,CAAC,GAAG,IAAI,EAAE,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,OAAO,CAAA;KAAE,KAAK,IAAI,CAAC;IAE9G;;OAEG;IACH,SAAS,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,WAAW,GAAG,SAAS,CAAC;IAEtD;;OAEG;IACH,UAAU,EAAE,MAAM,WAAW,EAAE,CAAC;IAEhC;;;OAGG;IACH,cAAc,EAAE,CAAC,OAAO,EAAE,WAAW,EAAE,EAAE,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,OAAO,CAAA;KAAE,KAAK,IAAI,CAAC;IAEjF;;;OAGG;IACH,eAAe,EAAE,CAAC,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,OAAO,CAAA;KAAE,KAAK,IAAI,CAAC;IAE1D;;;OAGG;IACH,gBAAgB,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,OAAO,CAAA;KAAE,KAAK,IAAI,CAAC;IAE1E;;OAEG;IACH,eAAe,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC;IAE5C;;OAEG;IACH,mBAAmB,EAAE,MAAM,MAAM,CAAC;IAElC;;OAEG;IACH,eAAe,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,EAAE,CAAC;IAE9C;;OAEG;IACH,eAAe,EAAE,MAAM,WAAW,EAAE,CAAC;IAErC;;OAEG;IACH,YAAY,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,SAAS,CAAC;IAE3C;;OAEG;IACH,iBAAiB,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,KAAK,IAAI,CAAC;CAC7D;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,gBAAgB,CAuHpE"}
+{"version":3,"file":"filtering.d.ts","sourceRoot":"","sources":["../../../../libs/grid-react/src/features/filtering.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAGH,OAAO,EAEL,KAAK,SAAS,EAEd,KAAK,WAAW,EAEjB,MAAM,qCAAqC,CAAC;AAkB7C,YAAY,EAAE,aAAa,IAAI,sBAAsB,EAAE,MAAM,sCAAsC,CAAC;AAuDpG;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;;;;OAKG;IACH,SAAS,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,WAAW,EAAE,OAAO,CAAC,GAAG,IAAI,EAAE,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,OAAO,CAAA;KAAE,KAAK,IAAI,CAAC;IAE9G;;OAEG;IACH,SAAS,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,WAAW,GAAG,SAAS,CAAC;IAEtD;;OAEG;IACH,UAAU,EAAE,MAAM,WAAW,EAAE,CAAC;IAEhC;;;OAGG;IACH,cAAc,EAAE,CAAC,OAAO,EAAE,WAAW,EAAE,EAAE,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,OAAO,CAAA;KAAE,KAAK,IAAI,CAAC;IAEjF;;;OAGG;IACH,eAAe,EAAE,CAAC,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,OAAO,CAAA;KAAE,KAAK,IAAI,CAAC;IAE1D;;;OAGG;IACH,gBAAgB,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,OAAO,CAAA;KAAE,KAAK,IAAI,CAAC;IAE1E;;OAEG;IACH,eAAe,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC;IAE5C;;OAEG;IACH,mBAAmB,EAAE,MAAM,MAAM,CAAC;IAElC;;OAEG;IACH,eAAe,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,EAAE,CAAC;IAE9C;;OAEG;IACH,eAAe,EAAE,MAAM,WAAW,EAAE,CAAC;IAErC;;OAEG;IACH,YAAY,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,SAAS,CAAC;IAE3C;;OAEG;IACH,iBAAiB,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,KAAK,IAAI,CAAC;IAE5D;;;;OAIG;IACH,OAAO,EAAE,OAAO,CAAC;CAClB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,gBAAgB,CA6HpE"}

package/features/filtering.js

@@ -1,11 +1,12 @@
-import { a as e } from "../chunks/react-grid-adapter-C_TSA5_P.js";
+import { s as e } from "../chunks/react-grid-adapter-DP9A9ytc.js";
 import { a as t, i as n } from "../chunks/portal-bridge-zxgm_jwK.js";
-import { t as r } from "../chunks/feature-registry-8K2rOVnC.js";
+import { o as r } from "../chunks/feature-registry-DKPyd2rV.js";
 import { t as i } from "../chunks/grid-element-context-DpuQsoie.js";
-import { useCallback as a, useContext as o } from "react";
-import { FilteringPlugin as s } from "@toolbox-web/grid/plugins/filtering";
+import { t as a } from "../chunks/use-grid-is-ready-Baa67cu3.js";
+import { useCallback as o, useContext as s } from "react";
+import { FilteringPlugin as c } from "@toolbox-web/grid/plugins/filtering";
 r("filtering", (e) => {
-	if (typeof e == "boolean" || !e) return new s();
+	if (typeof e == "boolean" || !e) return new c();
 	let r = e, i = { ...r };
 	if (typeof r.filterPanelRenderer == "function" && r.filterPanelRenderer.length <= 1) {
 		let e = r.filterPanelRenderer, a = /* @__PURE__ */ new WeakMap();
@@ -18,7 +19,7 @@ r("filtering", (e) => {
 			a.set(r, c), r.appendChild(s);
 		};
 	}
-	return new s(i);
+	return new c(i);
 }, { override: !0 }), e((e, n, { trackPortal: r }) => {
 	let i = e;
 	return (e, a) => {
@@ -28,57 +29,58 @@ r("filtering", (e) => {
 		r(t(o, i(a), void 0, s), o, !1), e.appendChild(o);
 	};
 });
-function c(e) {
-	let t = o(i), n = a(() => (e ? document.querySelector(e) : t?.current)?.getPluginByName("filtering"), [t, e]);
+function l(e) {
+	let t = s(i), n = o(() => e ? document.querySelector(e) : t?.current, [t, e]), r = o(() => n()?.getPluginByName("filtering"), [n]), c = a(n);
 	return {
-		setFilter: a((e, t, r) => {
-			let i = n();
+		setFilter: o((e, t, n) => {
+			let i = r();
 			if (!i) {
 				console.warn("[tbw-grid:filtering] FilteringPlugin not found.\n\n  → Enable filtering on the grid:\n    <DataGrid filtering />");
 				return;
 			}
-			i.setFilter(e, t, r);
-		}, [n]),
-		getFilter: a((e) => n()?.getFilter(e), [n]),
-		getFilters: a(() => n()?.getFilters() ?? [], [n]),
-		setFilterModel: a((e, t) => {
-			let r = n();
-			if (!r) {
+			i.setFilter(e, t, n);
+		}, [r]),
+		getFilter: o((e) => r()?.getFilter(e), [r]),
+		getFilters: o(() => r()?.getFilters() ?? [], [r]),
+		setFilterModel: o((e, t) => {
+			let n = r();
+			if (!n) {
 				console.warn("[tbw-grid:filtering] FilteringPlugin not found.\n\n  → Enable filtering on the grid:\n    <DataGrid filtering />");
 				return;
 			}
-			r.setFilterModel(e, t);
-		}, [n]),
-		clearAllFilters: a((e) => {
-			let t = n();
+			n.setFilterModel(e, t);
+		}, [r]),
+		clearAllFilters: o((e) => {
+			let t = r();
 			if (!t) {
 				console.warn("[tbw-grid:filtering] FilteringPlugin not found.\n\n  → Enable filtering on the grid:\n    <DataGrid filtering />");
 				return;
 			}
 			t.clearAllFilters(e);
-		}, [n]),
-		clearFieldFilter: a((e, t) => {
-			let r = n();
-			if (!r) {
+		}, [r]),
+		clearFieldFilter: o((e, t) => {
+			let n = r();
+			if (!n) {
 				console.warn("[tbw-grid:filtering] FilteringPlugin not found.\n\n  → Enable filtering on the grid:\n    <DataGrid filtering />");
 				return;
 			}
-			r.clearFieldFilter(e, t);
-		}, [n]),
-		isFieldFiltered: a((e) => n()?.isFieldFiltered(e) ?? !1, [n]),
-		getFilteredRowCount: a(() => n()?.getFilteredRowCount() ?? 0, [n]),
-		getUniqueValues: a((e) => n()?.getUniqueValues(e) ?? [], [n]),
-		getStaleFilters: a(() => n()?.getStaleFilters() ?? [], [n]),
-		getBlankMode: a((e) => n()?.getBlankMode(e) ?? "all", [n]),
-		toggleBlankFilter: a((e, t) => {
-			let r = n();
-			if (!r) {
+			n.clearFieldFilter(e, t);
+		}, [r]),
+		isFieldFiltered: o((e) => r()?.isFieldFiltered(e) ?? !1, [r]),
+		getFilteredRowCount: o(() => r()?.getFilteredRowCount() ?? 0, [r]),
+		getUniqueValues: o((e) => r()?.getUniqueValues(e) ?? [], [r]),
+		getStaleFilters: o(() => r()?.getStaleFilters() ?? [], [r]),
+		getBlankMode: o((e) => r()?.getBlankMode(e) ?? "all", [r]),
+		toggleBlankFilter: o((e, t) => {
+			let n = r();
+			if (!n) {
 				console.warn("[tbw-grid:filtering] FilteringPlugin not found.\n\n  → Enable filtering on the grid:\n    <DataGrid filtering />");
 				return;
 			}
-			r.toggleBlankFilter(e, t);
-		}, [n])
+			n.toggleBlankFilter(e, t);
+		}, [r]),
+		isReady: c
 	};
 }
 //#endregion
-export { c as useGridFiltering };
+export { l as useGridFiltering };