@stackframe/dashboard-ui-components 2.8.84 → 2.8.86

package/dist/esm/components/chart-legend.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"chart-legend.d.ts","names":[],"sources":["../../../src/components/chart-legend.tsx"],"mappings":";;;;cAOa,iBAAA,SAAiB,iBAAA,CAAA,MAAA;AAAA,cAEjB,wBAAA,EAAwB,OAAA,CAAA,yBAAA,CAAA,IAAA,CAAA,OAAA,CAAA,eAAA,CAAA,cAAA,IAAA,OAAA,CAAA,cAAA,CAAA,cAAA,IAAA,IAAA,CAAA,iBAAA,CAAA,WAAA"}
+{"version":3,"file":"chart-legend.d.ts","names":[],"sources":["../../../src/components/chart-legend.tsx"],"mappings":";;;;cAOa,wBAAA,EAAwB,OAAA,CAAA,yBAAA,CAAA,IAAA,CAAA,OAAA,CAAA,eAAA,CAAA,cAAA,IAAA,OAAA,CAAA,cAAA,CAAA,cAAA,IAAA,IAAA,CAAA,iBAAA,CAAA,WAAA"}

package/dist/esm/components/chart-legend.js

@@ -3,11 +3,9 @@
 import { cn } from "@stackframe/stack-ui";
 import { jsx, jsxs } from "react/jsx-runtime";
 import * as React$1 from "react";
-import * as RechartsPrimitive from "recharts";
 import { getPayloadConfigFromPayload, useDesignChart } from "./chart-container.js";
 
 //#region src/components/chart-legend.tsx
-const DesignChartLegend = RechartsPrimitive.Legend;
 const DesignChartLegendContent = React$1.forwardRef(({ className, hideIcon = false, payload, verticalAlign = "bottom", nameKey }, ref) => {
 	const { config } = useDesignChart();
 	if (!payload?.length) return null;
@@ -32,5 +30,5 @@ const DesignChartLegendContent = React$1.forwardRef(({ className, hideIcon = fal
 DesignChartLegendContent.displayName = "DesignChartLegendContent";
 
 //#endregion
-export { DesignChartLegend, DesignChartLegendContent };
+export { DesignChartLegendContent };
 //# sourceMappingURL=chart-legend.js.map

package/dist/esm/components/chart-legend.js.map

@@ -1 +1 @@
-{"version":3,"file":"chart-legend.js","names":["React"],"sources":["../../../src/components/chart-legend.tsx"],"sourcesContent":["\"use client\";\n\nimport * as React from \"react\";\nimport * as RechartsPrimitive from \"recharts\";\nimport { cn } from \"@stackframe/stack-ui\";\nimport { useDesignChart, getPayloadConfigFromPayload } from \"./chart-container\";\n\nexport const DesignChartLegend = RechartsPrimitive.Legend;\n\nexport const DesignChartLegendContent = React.forwardRef<\n  HTMLDivElement,\n  React.ComponentProps<\"div\"> &\n    Pick<RechartsPrimitive.LegendProps, \"payload\" | \"verticalAlign\"> & {\n      hideIcon?: boolean,\n      nameKey?: string,\n    }\n>(\n  (\n    { className, hideIcon = false, payload, verticalAlign = \"bottom\", nameKey },\n    ref\n  ) => {\n    const { config } = useDesignChart();\n\n    if (!payload?.length) {\n      return null;\n    }\n\n    return (\n      <div\n        ref={ref}\n        className={cn(\n          \"flex flex-wrap items-center justify-center gap-2\",\n          verticalAlign === \"top\" ? \"pb-3\" : \"pt-3\",\n          className\n        )}\n      >\n        {payload.map((item) => {\n          const key = `${nameKey || item.dataKey || \"value\"}`;\n          const itemConfig = getPayloadConfigFromPayload(config, item, key);\n\n          return (\n            <div\n              key={item.value}\n              className={cn(\n                \"flex items-center gap-1.5 rounded-full bg-foreground/[0.03] ring-1 ring-foreground/[0.06] px-3 py-1.5 text-xs\",\n                \"transition-colors duration-150 hover:transition-none hover:bg-foreground/[0.05]\"\n              )}\n            >\n              {itemConfig?.icon && !hideIcon ? (\n                <itemConfig.icon />\n              ) : (\n                <span\n                  className=\"h-2 w-2 shrink-0 rounded-full\"\n                  style={{ backgroundColor: item.color }}\n                />\n              )}\n              <span className=\"font-medium text-foreground\">\n                {itemConfig?.label || item.value}\n              </span>\n            </div>\n          );\n        })}\n      </div>\n    );\n  }\n);\nDesignChartLegendContent.displayName = \"DesignChartLegendContent\";\n"],"mappings":";;;;;;;;;AAOA,MAAa,oBAAoB,kBAAkB;AAEnD,MAAa,2BAA2BA,QAAM,YAS1C,EAAE,WAAW,WAAW,OAAO,SAAS,gBAAgB,UAAU,WAClE,QACG;CACH,MAAM,EAAE,WAAW,gBAAgB;AAEnC,KAAI,CAAC,SAAS,OACZ,QAAO;AAGT,QACE,oBAAC;EACM;EACL,WAAW,GACT,oDACA,kBAAkB,QAAQ,SAAS,QACnC,UACD;YAEA,QAAQ,KAAK,SAAS;GAErB,MAAM,aAAa,4BAA4B,QAAQ,MAD3C,GAAG,WAAW,KAAK,WAAW,UACuB;AAEjE,UACE,qBAAC;IAEC,WAAW,GACT,iHACA,kFACD;eAEA,YAAY,QAAQ,CAAC,WACpB,oBAAC,WAAW,SAAO,GAEnB,oBAAC;KACC,WAAU;KACV,OAAO,EAAE,iBAAiB,KAAK,OAAO;MACtC,EAEJ,oBAAC;KAAK,WAAU;eACb,YAAY,SAAS,KAAK;MACtB;MAhBF,KAAK,MAiBN;IAER;GACE;EAGX;AACD,yBAAyB,cAAc"}
+{"version":3,"file":"chart-legend.js","names":["React"],"sources":["../../../src/components/chart-legend.tsx"],"sourcesContent":["\"use client\";\n\nimport * as React from \"react\";\nimport * as RechartsPrimitive from \"recharts\";\nimport { cn } from \"@stackframe/stack-ui\";\nimport { useDesignChart, getPayloadConfigFromPayload } from \"./chart-container\";\n\nexport const DesignChartLegendContent = React.forwardRef<\n  HTMLDivElement,\n  React.ComponentProps<\"div\"> &\n    Pick<RechartsPrimitive.LegendProps, \"payload\" | \"verticalAlign\"> & {\n      hideIcon?: boolean,\n      nameKey?: string,\n    }\n>(\n  (\n    { className, hideIcon = false, payload, verticalAlign = \"bottom\", nameKey },\n    ref\n  ) => {\n    const { config } = useDesignChart();\n\n    if (!payload?.length) {\n      return null;\n    }\n\n    return (\n      <div\n        ref={ref}\n        className={cn(\n          \"flex flex-wrap items-center justify-center gap-2\",\n          verticalAlign === \"top\" ? \"pb-3\" : \"pt-3\",\n          className\n        )}\n      >\n        {payload.map((item) => {\n          const key = `${nameKey || item.dataKey || \"value\"}`;\n          const itemConfig = getPayloadConfigFromPayload(config, item, key);\n\n          return (\n            <div\n              key={item.value}\n              className={cn(\n                \"flex items-center gap-1.5 rounded-full bg-foreground/[0.03] ring-1 ring-foreground/[0.06] px-3 py-1.5 text-xs\",\n                \"transition-colors duration-150 hover:transition-none hover:bg-foreground/[0.05]\"\n              )}\n            >\n              {itemConfig?.icon && !hideIcon ? (\n                <itemConfig.icon />\n              ) : (\n                <span\n                  className=\"h-2 w-2 shrink-0 rounded-full\"\n                  style={{ backgroundColor: item.color }}\n                />\n              )}\n              <span className=\"font-medium text-foreground\">\n                {itemConfig?.label || item.value}\n              </span>\n            </div>\n          );\n        })}\n      </div>\n    );\n  }\n);\nDesignChartLegendContent.displayName = \"DesignChartLegendContent\";\n"],"mappings":";;;;;;;;AAOA,MAAa,2BAA2BA,QAAM,YAS1C,EAAE,WAAW,WAAW,OAAO,SAAS,gBAAgB,UAAU,WAClE,QACG;CACH,MAAM,EAAE,WAAW,gBAAgB;AAEnC,KAAI,CAAC,SAAS,OACZ,QAAO;AAGT,QACE,oBAAC;EACM;EACL,WAAW,GACT,oDACA,kBAAkB,QAAQ,SAAS,QACnC,UACD;YAEA,QAAQ,KAAK,SAAS;GAErB,MAAM,aAAa,4BAA4B,QAAQ,MAD3C,GAAG,WAAW,KAAK,WAAW,UACuB;AAEjE,UACE,qBAAC;IAEC,WAAW,GACT,iHACA,kFACD;eAEA,YAAY,QAAQ,CAAC,WACpB,oBAAC,WAAW,SAAO,GAEnB,oBAAC;KACC,WAAU;KACV,OAAO,EAAE,iBAAiB,KAAK,OAAO;MACtC,EAEJ,oBAAC;KAAK,WAAU;eACb,YAAY,SAAS,KAAK;MACtB;MAhBF,KAAK,MAiBN;IAER;GACE;EAGX;AACD,yBAAyB,cAAc"}

package/dist/esm/components/data-grid/data-grid-sizing.d.ts

@@ -0,0 +1,11 @@
+import { CSSProperties } from "react";
+import { DataGridColumnDef } from "./types";
+
+//#region src/components/data-grid/data-grid-sizing.d.ts
+declare function getColumnSizingStyle<TRow>(col: DataGridColumnDef<TRow>): CSSProperties;
+declare function createGridSizingStyle(widths: ReadonlyMap<string, number>, totalWidth: number): Record<string, string>;
+declare function applyDraggedColumnWidth(el: HTMLElement, columnId: string, width: number, totalWidth: number): void;
+declare function clampColumnWidth<TRow>(col: DataGridColumnDef<TRow>, width: number): number;
+//#endregion
+export { applyDraggedColumnWidth, clampColumnWidth, createGridSizingStyle, getColumnSizingStyle };
+//# sourceMappingURL=data-grid-sizing.d.ts.map

package/dist/esm/components/data-grid/data-grid-sizing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-grid-sizing.d.ts","names":[],"sources":["../../../../src/components/data-grid/data-grid-sizing.ts"],"mappings":";;;;iBAWgB,oBAAA,MAAA,CAA2B,GAAA,EAAK,iBAAA,CAAkB,IAAA,IAAQ,aAAA;AAAA,iBAK1D,qBAAA,CACd,MAAA,EAAQ,WAAA,kBACR,UAAA,WACC,MAAA;AAAA,iBAQa,uBAAA,CACd,EAAA,EAAI,WAAA,EACJ,QAAA,UACA,KAAA,UACA,UAAA;AAAA,iBAMc,gBAAA,MAAA,CAAuB,GAAA,EAAK,iBAAA,CAAkB,IAAA,GAAO,KAAA"}

package/dist/esm/components/data-grid/data-grid-sizing.js

@@ -0,0 +1,29 @@
+//#region src/components/data-grid/data-grid-sizing.ts
+function colVar(id) {
+	return `--col-${id}`;
+}
+function getColumnSizingStyle(col) {
+	const w = `var(${colVar(col.id)})`;
+	return {
+		flex: `0 0 ${w}`,
+		width: w,
+		minWidth: col.minWidth ?? 50,
+		maxWidth: col.maxWidth ?? 800
+	};
+}
+function createGridSizingStyle(widths, totalWidth) {
+	const style = { "--grid-total-w": `${totalWidth}px` };
+	for (const [id, w] of widths) style[colVar(id)] = `${w}px`;
+	return style;
+}
+function applyDraggedColumnWidth(el, columnId, width, totalWidth) {
+	el.style.setProperty(colVar(columnId), `${width}px`);
+	el.style.setProperty("--grid-total-w", `${totalWidth}px`);
+}
+function clampColumnWidth(col, width) {
+	return Math.max(col.minWidth ?? 50, Math.min(col.maxWidth ?? 800, width));
+}
+
+//#endregion
+export { applyDraggedColumnWidth, clampColumnWidth, createGridSizingStyle, getColumnSizingStyle };
+//# sourceMappingURL=data-grid-sizing.js.map

package/dist/esm/components/data-grid/data-grid-sizing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-grid-sizing.js","names":[],"sources":["../../../../src/components/data-grid/data-grid-sizing.ts"],"sourcesContent":["import type { CSSProperties } from \"react\";\nimport type { DataGridColumnDef } from \"./types\";\n\n// CSS variable names for column widths set on the grid container.\n// Cells read these via var(...) so a single setProperty during drag\n// resizes every cell in a column with zero React re-renders.\n\nfunction colVar(id: string): `--col-${string}` {\n  return `--col-${id}`;\n}\n\nexport function getColumnSizingStyle<TRow>(col: DataGridColumnDef<TRow>): CSSProperties {\n  const w = `var(${colVar(col.id)})`;\n  return { flex: `0 0 ${w}`, width: w, minWidth: col.minWidth ?? 50, maxWidth: col.maxWidth ?? 800 };\n}\n\nexport function createGridSizingStyle(\n  widths: ReadonlyMap<string, number>,\n  totalWidth: number,\n): Record<string, string> {\n  const style: Record<string, string> = { \"--grid-total-w\": `${totalWidth}px` };\n  for (const [id, w] of widths) {\n    style[colVar(id)] = `${w}px`;\n  }\n  return style;\n}\n\nexport function applyDraggedColumnWidth(\n  el: HTMLElement,\n  columnId: string,\n  width: number,\n  totalWidth: number,\n) {\n  el.style.setProperty(colVar(columnId), `${width}px`);\n  el.style.setProperty(\"--grid-total-w\", `${totalWidth}px`);\n}\n\nexport function clampColumnWidth<TRow>(col: DataGridColumnDef<TRow>, width: number): number {\n  return Math.max(col.minWidth ?? 50, Math.min(col.maxWidth ?? 800, width));\n}\n"],"mappings":";AAOA,SAAS,OAAO,IAA+B;AAC7C,QAAO,SAAS;;AAGlB,SAAgB,qBAA2B,KAA6C;CACtF,MAAM,IAAI,OAAO,OAAO,IAAI,GAAG,CAAC;AAChC,QAAO;EAAE,MAAM,OAAO;EAAK,OAAO;EAAG,UAAU,IAAI,YAAY;EAAI,UAAU,IAAI,YAAY;EAAK;;AAGpG,SAAgB,sBACd,QACA,YACwB;CACxB,MAAM,QAAgC,EAAE,kBAAkB,GAAG,WAAW,KAAK;AAC7E,MAAK,MAAM,CAAC,IAAI,MAAM,OACpB,OAAM,OAAO,GAAG,IAAI,GAAG,EAAE;AAE3B,QAAO;;AAGT,SAAgB,wBACd,IACA,UACA,OACA,YACA;AACA,IAAG,MAAM,YAAY,OAAO,SAAS,EAAE,GAAG,MAAM,IAAI;AACpD,IAAG,MAAM,YAAY,kBAAkB,GAAG,WAAW,IAAI;;AAG3D,SAAgB,iBAAuB,KAA8B,OAAuB;AAC1F,QAAO,KAAK,IAAI,IAAI,YAAY,IAAI,KAAK,IAAI,IAAI,YAAY,KAAK,MAAM,CAAC"}

package/dist/esm/components/data-grid/data-grid-toolbar.d.ts

@@ -0,0 +1,31 @@
+import * as react_jsx_runtime0 from "react/jsx-runtime";
+import React from "react";
+import { DataGridToolbarContext } from "./types";
+
+//#region src/components/data-grid/data-grid-toolbar.d.ts
+declare function DataGridToolbar<TRow>({
+  ctx,
+  extra,
+  extraLeading,
+  hideQuickSearch
+}: {
+  ctx: DataGridToolbarContext<TRow>;
+  /** Extra content rendered inside the toolbar row, to the left of the
+   *  built-in columns / export actions. Use this to add table-specific
+   *  affordances (refresh, custom toggles, row counts) without giving up
+   *  the default actions. */
+  extra?: React.ReactNode;
+  /** Extra content rendered at the START of the toolbar row — occupies
+   *  the same position as the built-in quick search (after it, if the
+   *  quick search is visible). Use this together with `hideQuickSearch`
+   *  to fully replace the quick search with a custom input, e.g. an
+   *  AI-powered search bar. */
+  extraLeading?: React.ReactNode;
+  /** Whether to hide the built-in quick-search input. When `true`,
+   *  callers are expected to provide their own search UI via
+   *  `extraLeading`. */
+  hideQuickSearch?: boolean;
+}): react_jsx_runtime0.JSX.Element;
+//#endregion
+export { DataGridToolbar };
+//# sourceMappingURL=data-grid-toolbar.d.ts.map

package/dist/esm/components/data-grid/data-grid-toolbar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-grid-toolbar.d.ts","names":[],"sources":["../../../../src/components/data-grid/data-grid-toolbar.tsx"],"mappings":";;;;;iBA6QgB,eAAA,MAAA,CAAA;EACd,GAAA;EACA,KAAA;EACA,YAAA;EACA;AAAA;EAEA,GAAA,EAAK,sBAAA,CAAuB,IAAA;;AAN9B;;;EAWE,KAAA,GAAQ,KAAA,CAAM,SAAA;EATd;;;;;EAeA,YAAA,GAAe,KAAA,CAAM,SAAA;EAAN;;;EAIf,eAAA;AAAA,IACD,kBAAA,CAAA,GAAA,CAAA,OAAA"}

package/dist/esm/components/data-grid/data-grid-toolbar.js

@@ -0,0 +1,223 @@
+"use client";
+
+import { Check, DownloadSimple, Eye, EyeSlash, MagnifyingGlass, X } from "@phosphor-icons/react";
+import { cn } from "@stackframe/stack-ui";
+import { jsx, jsxs } from "react/jsx-runtime";
+import React, { useCallback, useMemo, useRef, useState } from "react";
+
+//#region src/components/data-grid/data-grid-toolbar.tsx
+function usePopover() {
+	const [open, setOpen] = useState(false);
+	const ref = useRef(null);
+	React.useEffect(() => {
+		if (!open) return;
+		const handler = (e) => {
+			if (ref.current && !ref.current.contains(e.target)) setOpen(false);
+		};
+		document.addEventListener("mousedown", handler);
+		return () => document.removeEventListener("mousedown", handler);
+	}, [open]);
+	React.useEffect(() => {
+		if (!open) return;
+		const handler = (e) => {
+			if (e.key === "Escape") setOpen(false);
+		};
+		document.addEventListener("keydown", handler);
+		return () => document.removeEventListener("keydown", handler);
+	}, [open]);
+	return {
+		open,
+		setOpen,
+		ref
+	};
+}
+function PopoverPanel({ children, className, popoverRef }) {
+	return /* @__PURE__ */ jsx("div", {
+		ref: popoverRef,
+		className: cn("absolute top-full left-0 mt-1 z-50", "bg-popover text-popover-foreground rounded-xl shadow-lg", "ring-1 ring-black/[0.08] dark:ring-white/[0.1]", "backdrop-blur-xl", className),
+		children
+	});
+}
+function QuickSearch({ value, onChange, placeholder }) {
+	return /* @__PURE__ */ jsxs("div", {
+		className: "relative flex min-w-0 flex-1 items-center sm:flex-initial",
+		children: [
+			/* @__PURE__ */ jsx(MagnifyingGlass, { className: "absolute left-2.5 h-3.5 w-3.5 text-muted-foreground/50 pointer-events-none" }),
+			/* @__PURE__ */ jsx("input", {
+				type: "text",
+				className: cn("h-8 w-full sm:w-52 pl-8 pr-7 rounded-xl text-xs", "bg-background", "border border-black/[0.08] dark:border-white/[0.08]", "placeholder:text-muted-foreground/40", "focus:outline-none focus:ring-1 focus:ring-foreground/[0.1]", "transition-all duration-150"),
+				placeholder,
+				value,
+				onChange: (e) => onChange(e.target.value)
+			}),
+			value && /* @__PURE__ */ jsx("button", {
+				className: "absolute right-2 text-muted-foreground/40 hover:text-muted-foreground",
+				onClick: () => onChange(""),
+				"aria-label": "Clear search",
+				children: /* @__PURE__ */ jsx(X, { className: "h-3 w-3" })
+			})
+		]
+	});
+}
+function ToolbarButton({ children, onClick, active, title, className: extraClassName }) {
+	return /* @__PURE__ */ jsx("button", {
+		className: cn("relative flex items-center justify-center rounded-lg text-xs font-medium", "h-7 w-7", "transition-colors duration-75", active ? "bg-foreground/[0.06] text-foreground" : "text-muted-foreground hover:text-foreground hover:bg-foreground/[0.04]", extraClassName),
+		onClick,
+		title,
+		children
+	});
+}
+function ColumnManager({ columns, visibility, onChange, strings, dateDisplay, onDateDisplayChange, hasDateColumns }) {
+	const hideableColumns = useMemo(() => columns.filter((c) => c.hideable !== false), [columns]);
+	const toggleColumn = (id) => {
+		const current = visibility[id] !== false;
+		onChange({
+			...visibility,
+			[id]: !current
+		});
+	};
+	const showAll = () => {
+		const next = { ...visibility };
+		for (const col of hideableColumns) next[col.id] = true;
+		onChange(next);
+	};
+	const hideAll = () => {
+		const next = { ...visibility };
+		for (const col of hideableColumns) next[col.id] = false;
+		onChange(next);
+	};
+	return /* @__PURE__ */ jsxs("div", {
+		className: "p-2 min-w-[240px] max-w-[300px]",
+		children: [
+			/* @__PURE__ */ jsx("div", {
+				className: "max-h-[280px] overflow-y-auto space-y-0.5",
+				children: hideableColumns.map((col) => {
+					const visible = visibility[col.id] !== false;
+					return /* @__PURE__ */ jsxs("button", {
+						className: cn("flex items-center gap-2 w-full px-2.5 py-1.5 rounded-lg text-xs", "hover:bg-foreground/[0.06] transition-colors duration-75", visible ? "text-foreground" : "text-muted-foreground/50"),
+						onClick: () => toggleColumn(col.id),
+						children: [
+							visible ? /* @__PURE__ */ jsx(Eye, { className: "h-3.5 w-3.5 flex-shrink-0 text-blue-500" }) : /* @__PURE__ */ jsx(EyeSlash, { className: "h-3.5 w-3.5 flex-shrink-0" }),
+							/* @__PURE__ */ jsx("span", {
+								className: "truncate text-left",
+								children: typeof col.header === "string" ? col.header : col.id
+							}),
+							visible && /* @__PURE__ */ jsx(Check, { className: "h-3 w-3 ml-auto flex-shrink-0 text-blue-500" })
+						]
+					}, col.id);
+				})
+			}),
+			/* @__PURE__ */ jsxs("div", {
+				className: "flex items-center gap-2 mt-2 pt-2 border-t border-foreground/[0.06]",
+				children: [
+					/* @__PURE__ */ jsx("button", {
+						className: "text-[10px] text-muted-foreground hover:text-foreground font-medium uppercase tracking-wider transition-colors duration-75",
+						onClick: showAll,
+						children: strings.showAll
+					}),
+					/* @__PURE__ */ jsx("span", {
+						className: "text-muted-foreground/20",
+						children: "|"
+					}),
+					/* @__PURE__ */ jsx("button", {
+						className: "text-[10px] text-muted-foreground hover:text-foreground font-medium uppercase tracking-wider transition-colors duration-75",
+						onClick: hideAll,
+						children: strings.hideAll
+					})
+				]
+			}),
+			hasDateColumns && /* @__PURE__ */ jsx("div", {
+				className: "mt-2 pt-2 border-t border-foreground/[0.06]",
+				children: /* @__PURE__ */ jsxs("div", {
+					className: "flex items-center justify-between gap-2 px-1",
+					children: [/* @__PURE__ */ jsx("span", {
+						className: "text-[10px] font-medium uppercase tracking-wider text-muted-foreground",
+						children: strings.dateFormat
+					}), /* @__PURE__ */ jsxs("div", {
+						className: "inline-flex items-center gap-0.5 rounded-lg bg-foreground/[0.04] p-0.5",
+						children: [/* @__PURE__ */ jsx("button", {
+							className: cn("px-2 py-0.5 rounded-md text-[11px] font-medium transition-colors duration-75", dateDisplay === "relative" ? "bg-background text-foreground shadow-sm ring-1 ring-foreground/[0.06]" : "text-muted-foreground hover:text-foreground"),
+							onClick: () => onDateDisplayChange("relative"),
+							children: strings.dateFormatRelative
+						}), /* @__PURE__ */ jsx("button", {
+							className: cn("px-2 py-0.5 rounded-md text-[11px] font-medium transition-colors duration-75", dateDisplay === "absolute" ? "bg-background text-foreground shadow-sm ring-1 ring-foreground/[0.06]" : "text-muted-foreground hover:text-foreground"),
+							onClick: () => onDateDisplayChange("absolute"),
+							children: strings.dateFormatAbsolute
+						})]
+					})]
+				})
+			})
+		]
+	});
+}
+function DataGridToolbar({ ctx, extra, extraLeading, hideQuickSearch }) {
+	const { state, onChange, columns, strings, exportCsv } = ctx;
+	const columnPopover = usePopover();
+	const updateVisibility = useCallback((visibility) => {
+		onChange((s) => ({
+			...s,
+			columnVisibility: visibility
+		}));
+	}, [onChange]);
+	const updateDateDisplay = useCallback((mode) => {
+		onChange((s) => ({
+			...s,
+			dateDisplay: mode
+		}));
+	}, [onChange]);
+	const updateQuickSearch = useCallback((value) => {
+		onChange((s) => ({
+			...s,
+			quickSearch: value,
+			pagination: {
+				...s.pagination,
+				pageIndex: 0
+			}
+		}));
+	}, [onChange]);
+	const hasDateColumns = useMemo(() => columns.some((c) => c.type === "date" || c.type === "dateTime"), [columns]);
+	return /* @__PURE__ */ jsxs("div", {
+		className: "flex items-center gap-2 px-2.5 py-2.5 border-b border-foreground/[0.06]",
+		children: [
+			!hideQuickSearch && /* @__PURE__ */ jsx(QuickSearch, {
+				value: state.quickSearch,
+				onChange: updateQuickSearch,
+				placeholder: strings.searchPlaceholder
+			}),
+			extraLeading,
+			/* @__PURE__ */ jsx("div", { className: "flex-1 min-w-0" }),
+			extra,
+			/* @__PURE__ */ jsxs("div", {
+				className: "relative shrink-0",
+				ref: columnPopover.ref,
+				children: [/* @__PURE__ */ jsx(ToolbarButton, {
+					onClick: () => columnPopover.setOpen(!columnPopover.open),
+					active: columnPopover.open,
+					title: strings.columns,
+					children: /* @__PURE__ */ jsx(Eye, { className: "h-3.5 w-3.5" })
+				}), columnPopover.open && /* @__PURE__ */ jsx(PopoverPanel, {
+					popoverRef: columnPopover.ref,
+					className: "right-0 left-auto",
+					children: /* @__PURE__ */ jsx(ColumnManager, {
+						columns,
+						visibility: state.columnVisibility,
+						onChange: updateVisibility,
+						strings,
+						dateDisplay: state.dateDisplay,
+						onDateDisplayChange: updateDateDisplay,
+						hasDateColumns
+					})
+				})]
+			}),
+			/* @__PURE__ */ jsx(ToolbarButton, {
+				onClick: exportCsv,
+				title: strings.export,
+				children: /* @__PURE__ */ jsx(DownloadSimple, { className: "h-3.5 w-3.5" })
+			})
+		]
+	});
+}
+
+//#endregion
+export { DataGridToolbar };
+//# sourceMappingURL=data-grid-toolbar.js.map

package/dist/esm/components/data-grid/data-grid-toolbar.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-grid-toolbar.js","names":[],"sources":["../../../../src/components/data-grid/data-grid-toolbar.tsx"],"sourcesContent":["\"use client\";\n\nimport { cn } from \"@stackframe/stack-ui\";\nimport {\n  Check,\n  DownloadSimple,\n  Eye,\n  EyeSlash,\n  MagnifyingGlass,\n  X,\n} from \"@phosphor-icons/react\";\nimport React, { useCallback, useMemo, useRef, useState } from \"react\";\nimport type {\n  DataGridColumnDef,\n  DataGridDateDisplay,\n  DataGridStrings,\n  DataGridToolbarContext,\n} from \"./types\";\n\n// ─── Popover primitive ───────────────────────────────────────────────\n\nfunction usePopover() {\n  const [open, setOpen] = useState(false);\n  const ref = useRef<HTMLDivElement>(null);\n\n  React.useEffect(() => {\n    if (!open) return;\n    const handler = (e: MouseEvent) => {\n      if (ref.current && !ref.current.contains(e.target as Node)) {\n        setOpen(false);\n      }\n    };\n    document.addEventListener(\"mousedown\", handler);\n    return () => document.removeEventListener(\"mousedown\", handler);\n  }, [open]);\n\n  React.useEffect(() => {\n    if (!open) return;\n    const handler = (e: KeyboardEvent) => {\n      if (e.key === \"Escape\") setOpen(false);\n    };\n    document.addEventListener(\"keydown\", handler);\n    return () => document.removeEventListener(\"keydown\", handler);\n  }, [open]);\n\n  return { open, setOpen, ref };\n}\n\nfunction PopoverPanel({\n  children,\n  className,\n  popoverRef,\n}: {\n  children: React.ReactNode;\n  className?: string;\n  popoverRef: React.Ref<HTMLDivElement>;\n}) {\n  return (\n    <div\n      ref={popoverRef}\n      className={cn(\n        \"absolute top-full left-0 mt-1 z-50\",\n        \"bg-popover text-popover-foreground rounded-xl shadow-lg\",\n        \"ring-1 ring-black/[0.08] dark:ring-white/[0.1]\",\n        \"backdrop-blur-xl\",\n        className,\n      )}\n    >\n      {children}\n    </div>\n  );\n}\n\n// ─── Quick search ────────────────────────────────────────────────────\n\nfunction QuickSearch({\n  value,\n  onChange,\n  placeholder,\n}: {\n  value: string;\n  onChange: (value: string) => void;\n  placeholder: string;\n}) {\n  return (\n    <div className=\"relative flex min-w-0 flex-1 items-center sm:flex-initial\">\n      <MagnifyingGlass className=\"absolute left-2.5 h-3.5 w-3.5 text-muted-foreground/50 pointer-events-none\" />\n      <input\n        type=\"text\"\n        className={cn(\n          \"h-8 w-full sm:w-52 pl-8 pr-7 rounded-xl text-xs\",\n          \"bg-background\",\n          \"border border-black/[0.08] dark:border-white/[0.08]\",\n          \"placeholder:text-muted-foreground/40\",\n          \"focus:outline-none focus:ring-1 focus:ring-foreground/[0.1]\",\n          \"transition-all duration-150\",\n        )}\n        placeholder={placeholder}\n        value={value}\n        onChange={(e) => onChange(e.target.value)}\n      />\n      {value && (\n        <button\n          className=\"absolute right-2 text-muted-foreground/40 hover:text-muted-foreground\"\n          onClick={() => onChange(\"\")}\n          aria-label=\"Clear search\"\n        >\n          <X className=\"h-3 w-3\" />\n        </button>\n      )}\n    </div>\n  );\n}\n\n// ─── Toolbar button ──────────────────────────────────────────────────\n\nfunction ToolbarButton({\n  children,\n  onClick,\n  active,\n  title,\n  className: extraClassName,\n}: {\n  children: React.ReactNode;\n  onClick?: () => void;\n  active?: boolean;\n  title?: string;\n  className?: string;\n}) {\n  return (\n    <button\n      className={cn(\n        \"relative flex items-center justify-center rounded-lg text-xs font-medium\",\n        \"h-7 w-7\",\n        \"transition-colors duration-75\",\n        active\n          ? \"bg-foreground/[0.06] text-foreground\"\n          : \"text-muted-foreground hover:text-foreground hover:bg-foreground/[0.04]\",\n        extraClassName,\n      )}\n      onClick={onClick}\n      title={title}\n    >\n      {children}\n    </button>\n  );\n}\n\n// ─── Column manager ──────────────────────────────────────────────────\n\nfunction ColumnManager<TRow>({\n  columns,\n  visibility,\n  onChange,\n  strings,\n  dateDisplay,\n  onDateDisplayChange,\n  hasDateColumns,\n}: {\n  columns: readonly DataGridColumnDef<TRow>[];\n  visibility: Record<string, boolean>;\n  onChange: (visibility: Record<string, boolean>) => void;\n  strings: DataGridStrings;\n  dateDisplay: DataGridDateDisplay;\n  onDateDisplayChange: (mode: DataGridDateDisplay) => void;\n  hasDateColumns: boolean;\n}) {\n  const hideableColumns = useMemo(\n    () => columns.filter((c) => c.hideable !== false),\n    [columns],\n  );\n\n  const toggleColumn = (id: string) => {\n    const current = visibility[id] !== false;\n    onChange({ ...visibility, [id]: !current });\n  };\n\n  const showAll = () => {\n    const next = { ...visibility };\n    for (const col of hideableColumns) next[col.id] = true;\n    onChange(next);\n  };\n\n  const hideAll = () => {\n    const next = { ...visibility };\n    for (const col of hideableColumns) next[col.id] = false;\n    onChange(next);\n  };\n\n  return (\n    <div className=\"p-2 min-w-[240px] max-w-[300px]\">\n      <div className=\"max-h-[280px] overflow-y-auto space-y-0.5\">\n        {hideableColumns.map((col) => {\n          const visible = visibility[col.id] !== false;\n          return (\n            <button\n              key={col.id}\n              className={cn(\n                \"flex items-center gap-2 w-full px-2.5 py-1.5 rounded-lg text-xs\",\n                \"hover:bg-foreground/[0.06] transition-colors duration-75\",\n                visible ? \"text-foreground\" : \"text-muted-foreground/50\",\n              )}\n              onClick={() => toggleColumn(col.id)}\n            >\n              {visible ? (\n                <Eye className=\"h-3.5 w-3.5 flex-shrink-0 text-blue-500\" />\n              ) : (\n                <EyeSlash className=\"h-3.5 w-3.5 flex-shrink-0\" />\n              )}\n              <span className=\"truncate text-left\">\n                {typeof col.header === \"string\" ? col.header : col.id}\n              </span>\n              {visible && <Check className=\"h-3 w-3 ml-auto flex-shrink-0 text-blue-500\" />}\n            </button>\n          );\n        })}\n      </div>\n      <div className=\"flex items-center gap-2 mt-2 pt-2 border-t border-foreground/[0.06]\">\n        <button className=\"text-[10px] text-muted-foreground hover:text-foreground font-medium uppercase tracking-wider transition-colors duration-75\" onClick={showAll}>\n          {strings.showAll}\n        </button>\n        <span className=\"text-muted-foreground/20\">|</span>\n        <button className=\"text-[10px] text-muted-foreground hover:text-foreground font-medium uppercase tracking-wider transition-colors duration-75\" onClick={hideAll}>\n          {strings.hideAll}\n        </button>\n      </div>\n\n      {/* Date format toggle — only rendered when at least one column\n          uses `type: \"date\"` or `\"dateTime\"`. Toggling writes to\n          `state.dateDisplay` and the grid re-renders every date cell. */}\n      {hasDateColumns && (\n        <div className=\"mt-2 pt-2 border-t border-foreground/[0.06]\">\n          <div className=\"flex items-center justify-between gap-2 px-1\">\n            <span className=\"text-[10px] font-medium uppercase tracking-wider text-muted-foreground\">\n              {strings.dateFormat}\n            </span>\n            <div className=\"inline-flex items-center gap-0.5 rounded-lg bg-foreground/[0.04] p-0.5\">\n              <button\n                className={cn(\n                  \"px-2 py-0.5 rounded-md text-[11px] font-medium transition-colors duration-75\",\n                  dateDisplay === \"relative\"\n                    ? \"bg-background text-foreground shadow-sm ring-1 ring-foreground/[0.06]\"\n                    : \"text-muted-foreground hover:text-foreground\",\n                )}\n                onClick={() => onDateDisplayChange(\"relative\")}\n              >\n                {strings.dateFormatRelative}\n              </button>\n              <button\n                className={cn(\n                  \"px-2 py-0.5 rounded-md text-[11px] font-medium transition-colors duration-75\",\n                  dateDisplay === \"absolute\"\n                    ? \"bg-background text-foreground shadow-sm ring-1 ring-foreground/[0.06]\"\n                    : \"text-muted-foreground hover:text-foreground\",\n                )}\n                onClick={() => onDateDisplayChange(\"absolute\")}\n              >\n                {strings.dateFormatAbsolute}\n              </button>\n            </div>\n          </div>\n        </div>\n      )}\n    </div>\n  );\n}\n\n// ─── Main toolbar ────────────────────────────────────────────────────\n\nexport function DataGridToolbar<TRow>({\n  ctx,\n  extra,\n  extraLeading,\n  hideQuickSearch,\n}: {\n  ctx: DataGridToolbarContext<TRow>;\n  /** Extra content rendered inside the toolbar row, to the left of the\n   *  built-in columns / export actions. Use this to add table-specific\n   *  affordances (refresh, custom toggles, row counts) without giving up\n   *  the default actions. */\n  extra?: React.ReactNode;\n  /** Extra content rendered at the START of the toolbar row — occupies\n   *  the same position as the built-in quick search (after it, if the\n   *  quick search is visible). Use this together with `hideQuickSearch`\n   *  to fully replace the quick search with a custom input, e.g. an\n   *  AI-powered search bar. */\n  extraLeading?: React.ReactNode;\n  /** Whether to hide the built-in quick-search input. When `true`,\n   *  callers are expected to provide their own search UI via\n   *  `extraLeading`. */\n  hideQuickSearch?: boolean;\n}) {\n  const { state, onChange, columns, strings, exportCsv } = ctx;\n\n  const columnPopover = usePopover();\n\n  const updateVisibility = useCallback(\n    (visibility: Record<string, boolean>) => {\n      onChange((s) => ({ ...s, columnVisibility: visibility }));\n    },\n    [onChange],\n  );\n\n  const updateDateDisplay = useCallback(\n    (mode: DataGridDateDisplay) => {\n      onChange((s) => ({ ...s, dateDisplay: mode }));\n    },\n    [onChange],\n  );\n\n  const updateQuickSearch = useCallback(\n    (value: string) => {\n      onChange((s) => ({\n        ...s,\n        quickSearch: value,\n        // Reset to first page whenever the search text changes,\n        // otherwise you can end up on a page index that no longer\n        // exists in the filtered / refetched result set.\n        pagination: { ...s.pagination, pageIndex: 0 },\n      }));\n    },\n    [onChange],\n  );\n\n  const hasDateColumns = useMemo(\n    () => columns.some((c) => c.type === \"date\" || c.type === \"dateTime\"),\n    [columns],\n  );\n\n  return (\n    <div className=\"flex items-center gap-2 px-2.5 py-2.5 border-b border-foreground/[0.06]\">\n      {!hideQuickSearch && (\n        <QuickSearch\n          value={state.quickSearch}\n          onChange={updateQuickSearch}\n          placeholder={strings.searchPlaceholder}\n        />\n      )}\n      {extraLeading}\n      <div className=\"flex-1 min-w-0\" />\n\n      {extra}\n\n      <div className=\"relative shrink-0\" ref={columnPopover.ref}>\n        <ToolbarButton\n          onClick={() => columnPopover.setOpen(!columnPopover.open)}\n          active={columnPopover.open}\n          title={strings.columns}\n        >\n          <Eye className=\"h-3.5 w-3.5\" />\n        </ToolbarButton>\n        {columnPopover.open && (\n          <PopoverPanel popoverRef={columnPopover.ref} className=\"right-0 left-auto\">\n            <ColumnManager\n              columns={columns}\n              visibility={state.columnVisibility}\n              onChange={updateVisibility}\n              strings={strings}\n              dateDisplay={state.dateDisplay}\n              onDateDisplayChange={updateDateDisplay}\n              hasDateColumns={hasDateColumns}\n            />\n          </PopoverPanel>\n        )}\n      </div>\n\n      <ToolbarButton onClick={exportCsv} title={strings.export}>\n        <DownloadSimple className=\"h-3.5 w-3.5\" />\n      </ToolbarButton>\n    </div>\n  );\n}\n"],"mappings":"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"}

package/dist/esm/components/data-grid/data-grid.d.ts

@@ -0,0 +1,233 @@
+import * as react_jsx_runtime0 from "react/jsx-runtime";
+import { DataGridProps } from "./types";
+
+//#region src/components/data-grid/data-grid.d.ts
+/**
+ * Interactive table with sorting, quick search, pagination, selection,
+ * and virtualization. Handles 10k+ rows smoothly. Pair with
+ * `useDataSource` for client-side data; use an async `dataSource`
+ * generator for server or infinite-scroll modes.
+ *
+ * ## Mental model (read this first — everything else depends on it)
+ *
+ * DataGrid is a **display** component. It does NOT sort, search, or
+ * paginate your data directly — you own that, but `useDataSource` does
+ * it for you. The `rows` prop is always the already-processed slice to
+ * show. The grid tracks user intent in `state` (sort model, quick
+ * search text, page index). You feed that state into `useDataSource`,
+ * and its output goes back in as `rows`.
+ *
+ * `useDataSource` IS the processor. Given your full dataset and the
+ * grid's state, it returns the searched + sorted + paginated rows
+ * ready to pass to DataGrid. This is the ONLY correct pattern for
+ * client-side data — do NOT pass a raw array to `rows`.
+ *
+ * ## Search (client vs async)
+ *
+ * - **Client mode** (`useDataSource` with `data`): a case-insensitive
+ *   substring match across every column is applied automatically.
+ *   Override the matcher with `matchRow` for fuzzy / weighted search,
+ *   or disable by passing `matchRow: () => true`.
+ * - **Async mode** (`useDataSource` with `dataSource`): `state.quickSearch`
+ *   is forwarded to the generator as `params.quickSearch`. Same
+ *   mechanism as `params.sorting` — a change triggers a refetch, and
+ *   the generator is the "matching logic" (typically a WHERE / ILIKE
+ *   clause in the backend query). The grid does NO client-side
+ *   filtering in async mode.
+ *
+ * ## The canonical pattern
+ *
+ * ```tsx
+ * // 1. Columns — define OUTSIDE the component or inside a useMemo. Must be stable.
+ * const columns = React.useMemo(() => [
+ *   { id: "name", header: "Name", accessor: "name", width: 180, type: "string" },
+ *   { id: "email", header: "Email", accessor: "email", width: 240, type: "string" },
+ *   { id: "role", header: "Role", accessor: "role", width: 120, type: "singleSelect",
+ *     valueOptions: [{ value: "admin", label: "Admin" }, { value: "member", label: "Member" }] },
+ *   { id: "signUps", header: "Sign-ups", accessor: "signUps", width: 120, type: "number", align: "right",
+ *     renderCell: ({ value }) => <span className="tabular-nums">{Number(value).toLocaleString()}</span> },
+ * ], []);
+ *
+ * // 2. Grid state — one hook, initialized from the columns. NEVER build the state object by hand.
+ * const [gridState, setGridState] = React.useState(() => createDefaultDataGridState(columns));
+ *
+ * // 3. Data source — wires your raw array through the grid state. ALWAYS call this
+ * //    hook unconditionally at the top level (no if/return before it).
+ * const gridData = useDataSource({
+ *   data: users,                   // your raw array (can be [] while loading)
+ *   columns,
+ *   getRowId: (row) => row.id,
+ *   sorting: gridState.sorting,
+ *   quickSearch: gridState.quickSearch,
+ *   pagination: gridState.pagination,
+ *   paginationMode: "client",       // "client" | "server" | "infinite"
+ * });
+ *
+ * // 4. Render — `rows` comes from gridData.rows, NOT from your raw array.
+ * <DataGrid
+ *   columns={columns}
+ *   rows={gridData.rows}
+ *   getRowId={(row) => row.id}
+ *   totalRowCount={gridData.totalRowCount}
+ *   isLoading={gridData.isLoading}
+ *   state={gridState}
+ *   onChange={setGridState}
+ *   selectionMode="none"            // "none" | "single" | "multiple"
+ *   maxHeight={480}
+ * />
+ * ```
+ *
+ * ## Iron rules (violating any of these breaks the grid)
+ *
+ * 1. The prop is `rows`, NOT `data`. There is no `data` prop on DataGrid.
+ *    `data` belongs on `useDataSource`.
+ * 2. `rows` is ALWAYS `gridData.rows`. Never pass your raw array to
+ *    `rows` — the grid won't search, sort, or paginate it.
+ * 3. Columns must be stable across renders. Define them outside the
+ *    component or wrap in `React.useMemo`. A fresh columns array every
+ *    render will reset sorting state.
+ * 4. Initialize grid state with `createDefaultDataGridState(columns)`.
+ *    Do NOT spell out the state object manually — you will miss fields
+ *    and crash.
+ * 5. `onChange` takes a `SetStateAction` (the setter you got from
+ *    `useState`). Pass `setGridState` directly. Do NOT wrap it unless
+ *    you know exactly what you're doing.
+ * 6. Call `useDataSource` ONCE per grid, at the top level, before any
+ *    early return. It contains hooks.
+ * 7. `renderCell` is a PURE function of its context. NEVER call React
+ *    hooks inside it (no `useState`, `useMemo`, `useEffect`, nothing).
+ *    If you need derived data per row, compute it BEFORE the render —
+ *    e.g. build a `Map<rowId, sparklineData>` in a `useMemo` and look
+ *    it up in `renderCell`.
+ * 8. `toolbar` accepts `false` (hide it) or a render function
+ *    `(ctx) => ReactNode`. Anything else — `true`, `undefined`, a state
+ *    variable — will either show the default toolbar or crash. If you
+ *    just want the default toolbar, omit the prop entirely.
+ * 9. The toolbar's search input writes to `state.quickSearch`. That
+ *    value is consumed by `useDataSource` — client mode filters
+ *    client-side, async mode forwards to the generator. Do NOT wire
+ *    a separate "controlled" search prop, everything flows through
+ *    grid state.
+ *
+ * ## renderCell — what you can and cannot do inside it
+ *
+ * ```tsx
+ * // OK — pure rendering from ctx:
+ * renderCell: ({ value }) => <span className="tabular-nums">{Number(value).toLocaleString()}</span>
+ * renderCell: ({ row }) => <Badge variant={row.active ? "default" : "outline"}>{row.status}</Badge>
+ *
+ * // OK — looking up pre-computed data by row id:
+ * // BEFORE the return, in the component body:
+ * const sparklinesById = React.useMemo(() => {
+ *   const m = new Map();
+ *   for (const u of users) {
+ *     m.set(u.id, u.recentActivity.map((n, i) => ({ ts: i, values: { primary: n } })));
+ *   }
+ *   return m;
+ * }, [users]);
+ * // Then inside the column def:
+ * renderCell: ({ rowId }) => <MiniSparkline data={sparklinesById.get(rowId) ?? []} />
+ *
+ * // NOT OK — hooks inside renderCell:
+ * renderCell: ({ row }) => {
+ *   const [hovered, setHovered] = React.useState(false);  // ← crashes the grid
+ *   const data = React.useMemo(() => ..., []);             // ← crashes the grid
+ *   return ...;
+ * }
+ *
+ * // NOT OK — embedding AnalyticsChart (or any other controlled, stateful chart) per row:
+ * // AnalyticsChart owns its own state, tooltips, zoom, and virtualized data
+ * // pipeline. Instantiating one per row is expensive and fights the grid's
+ * // virtualizer. Don't do it.
+ * ```
+ *
+ * ## Sparklines and mini-charts in cells — use raw Recharts
+ *
+ * If you want a tiny chart (sparkline, micro bar chart, trend line) inside
+ * a cell, drop down to raw `Recharts.*` components — they are lightweight
+ * and stateless, so they render cleanly per row without owning any state.
+ * Read pre-computed points off the row (or off a `Map<rowId, points>` you
+ * built in a `useMemo` above) and pass them directly to the Recharts
+ * primitive. Do NOT wrap them in `DesignChartContainer` or
+ * `DesignChartCard` inside a cell — those add chrome meant for full-size
+ * charts.
+ *
+ * ```tsx
+ * // OK — raw Recharts sparkline per row:
+ * renderCell: ({ rowId }) => {
+ *   const points = sparklinesById.get(rowId) ?? [];
+ *   return (
+ *     <Recharts.ResponsiveContainer width="100%" height={28}>
+ *       <Recharts.LineChart data={points} margin={{ top: 2, right: 2, bottom: 2, left: 2 }}>
+ *         <Recharts.Line type="monotone" dataKey="v" stroke="currentColor" strokeWidth={1.5} dot={false} isAnimationActive={false} />
+ *       </Recharts.LineChart>
+ *     </Recharts.ResponsiveContainer>
+ *   );
+ * }
+ * ```
+ *
+ * Keep in-cell Recharts configs minimal: no axes, no tooltips, no animation
+ * (`isAnimationActive={false}`), tight margins, fixed height. The goal is a
+ * visual summary, not an interactive chart.
+ *
+ * ## State shape (from `createDefaultDataGridState`)
+ *
+ * ```ts
+ * {
+ *   sorting: [],                                        // { columnId, direction: "asc" | "desc" }[]
+ *   quickSearch: "",                                    // search input text
+ *   dateDisplay: "relative",                            // "relative" | "absolute"
+ *   columnVisibility: {}, columnWidths: {...},
+ *   columnPinning: { left: [], right: [] }, columnOrder: [...],
+ *   pagination: { pageIndex: 0, pageSize: 50 },
+ *   selection: { selectedIds: new Set(), anchorId: null },
+ * }
+ * ```
+ *
+ * Everything is updated through `setGridState` — the toolbar, header,
+ * and footer all call it for you. You do not need to wire any of this
+ * manually.
+ *
+ * ## Height and scrolling
+ *
+ * DataGrid is NOT a card. It has no border, rounded corners, or shadow of
+ * its own. Wrap it in whatever chrome you want — a `DesignCard`, a section,
+ * or just raw layout. The grid itself fills its parent's height via
+ * `h-full`.
+ *
+ * How the grid gets its height (pick ONE):
+ * 1. Bounded parent — put the grid inside a flex/grid container with a
+ *    definite height (e.g. `flex-1 min-h-0` inside a page-filling flex
+ *    column). The grid stretches to that height and scrolls its body.
+ * 2. `maxHeight` prop — pass a number (pixels) or CSS string
+ *    (`"480px"`, `"60vh"`, `"100%"`). The grid caps at that size and
+ *    scrolls its body.
+ * 3. Unbounded — omit `maxHeight` and let the parent grow freely. The
+ *    grid renders at its full content height and the page scrolls. Fine
+ *    for small lists; bad UX for thousands of rows.
+ *
+ * The toolbar, header, and footer are always `shrink-0`; only the body
+ * scrolls. You do NOT need to subtract toolbar/footer heights from
+ * `maxHeight` — the grid's internal flex layout handles that.
+ *
+ * ## When to use what
+ *
+ * - Simple static list, < 20 rows, no interaction → use a plain table component instead.
+ * - Interactive table, sortable + searchable, any size → `DataGrid` +
+ *   `useDataSource` with `paginationMode: "client"`.
+ * - Infinite scroll over a huge dataset you fetch in pages → `dataSource` async
+ *   generator + `paginationMode: "infinite"`. Only reach for this if you actually
+ *   need pagination over a remote source. For anything that fits in memory,
+ *   `"client"` is simpler and faster.
+ *
+ * ## Features you get for free
+ *
+ * Quick search, sortable columns (shift-click for multi-sort), column
+ * visibility toggle, column resize, CSV export, virtualized rendering
+ * for 10k+ rows, keyboard navigation, and a relative/absolute date
+ * toggle for `date` / `dateTime` columns.
+ */
+declare function DataGrid<TRow>(props: DataGridProps<TRow>): react_jsx_runtime0.JSX.Element;
+//#endregion
+export { DataGrid };
+//# sourceMappingURL=data-grid.d.ts.map

package/dist/esm/components/data-grid/data-grid.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-grid.d.ts","names":[],"sources":["../../../../src/components/data-grid/data-grid.tsx"],"mappings":";;;;;;;AA2wBA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAAgB,QAAA,MAAA,CAAe,KAAA,EAAO,aAAA,CAAc,IAAA,IAAK,kBAAA,CAAA,GAAA,CAAA,OAAA"}