@datum-cloud/datum-ui 0.3.0-alpha.3670fb2 → 0.3.0-alpha.919cfab

package/dist/data-table/index.mjs

@@ -14,9 +14,9 @@ import { i as PopoverTrigger, r as PopoverContent, t as Popover } from "../popov
 import { i as SelectItem, l as SelectTrigger, n as SelectContent, t as Select, u as SelectValue } from "../select-CwVIFWFO.mjs";
 import { t as Skeleton } from "../skeleton-Cs6Q5GQc.mjs";
 import { c as TableRow, i as TableCell, n as TableBody, o as TableHead, s as TableHeader, t as Table } from "../table-Dc3HfbM4.mjs";
-import { t as CalendarDatePicker } from "../calendar-date-picker-mlbzp3xR.mjs";
+import { t as CalendarDatePicker } from "../calendar-date-picker-BMzLl1Yn.mjs";
 import { ArrowDown, ArrowUp, ArrowUpDown, Check, ChevronDown, ChevronLeft, ChevronRight, MoreHorizontal, X } from "lucide-react";
-import { createContext, memo, use, useCallback, useEffect, useId, useMemo, useRef, useState, useSyncExternalStore } from "react";
+import { createContext, memo, use, useCallback, useContext, useEffect, useId, useMemo, useRef, useState, useSyncExternalStore } from "react";
 import { Fragment as Fragment$1, jsx, jsxs } from "react/jsx-runtime";
 import { parseAsInteger, parseAsString, useQueryStates } from "nuqs";
 import { flexRender, getCoreRowModel, getPaginationRowModel, getSortedRowModel, useReactTable } from "@tanstack/react-table";
@@ -157,6 +157,16 @@ function withSelectionColumn(columns, options = {}) {
 
 //#endregion
 //#region src/components/features/data-table/core/filter-engine.ts
+/**
+* Resolve a dot-path on an object (e.g. "status.registrationApproval").
+* Falls back to a flat key lookup when the path has no dots.
+*/
+function resolvePath(obj, path) {
+	if (obj == null) return void 0;
+	const record = obj;
+	if (!path.includes(".")) return record[path];
+	return path.split(".").reduce((acc, key) => acc != null ? acc[key] : void 0, record);
+}
 const FILTER_STRATEGIES = {
 	"checkbox": (cellValue, filterValue) => {
 		if (filterValue == null) return true;
@@ -200,14 +210,13 @@ function applyFilters(data, filters, search, registeredFilters, customFilterFns,
 				console.warn(`[DataTable] No filter strategy registered for column "${column}". Filter ignored.`);
 				continue;
 			}
-			const cellValue = row[column];
-			if (!fn(cellValue, value)) return false;
+			if (!fn(resolvePath(row, column), value)) return false;
 		}
 		if (hasSearch) {
 			const query = search.toLowerCase();
 			if (searchConfig.searchFn) return searchConfig.searchFn(row, search);
 			if (searchConfig.searchableColumns && searchConfig.searchableColumns.length > 0) return searchConfig.searchableColumns.some((col) => {
-				const cellValue = row[col];
+				const cellValue = resolvePath(row, col);
 				return cellValue != null && String(cellValue).toLowerCase().includes(query);
 			});
 			return Object.values(row).some((val) => {
@@ -243,7 +252,8 @@ function createDataTableStore(options) {
 		mode: options.mode,
 		isLoading: false,
 		error: null,
-		inlineContents: []
+		inlineContents: [],
+		_version: 0
 	};
 	if (options.defaultFilters && Object.keys(options.defaultFilters).length > 0) state = {
 		...state,
@@ -253,7 +263,10 @@ function createDataTableStore(options) {
 		for (const listener of listeners) listener();
 	}
 	function setState(next) {
-		state = next;
+		state = {
+			...next,
+			_version: state._version + 1
+		};
 		notify();
 	}
 	return {
@@ -442,6 +455,22 @@ function createDataTableStore(options) {
 //#region src/components/features/data-table/core/data-table-context.tsx
 const DataTableStoreContext = createContext(null);
 const TableInstanceContext = createContext(null);
+/**
+* Monotonic counter that increments on every store mutation.
+* Table-dependent hooks consume this context to force re-renders
+* through React's {children} composition boundary, since the
+* mutable table singleton (stable ref) cannot trigger context updates.
+*/
+const DataTableRenderKeyContext = createContext(0);
+/**
+* Forces a re-render when the store changes. Used by table-dependent hooks.
+* Uses useContext (not use()) because use() does not reliably register
+* context subscriptions in SSR/hydration scenarios (React Router SSR),
+* preventing re-renders when the context value changes.
+*/
+function useRenderKey() {
+	return useContext(DataTableRenderKeyContext);
+}
 const DataTableContext = createContext(null);
 function useDataTableStore() {
 	const store = use(DataTableStoreContext);
@@ -482,7 +511,7 @@ function useSliceSelector(selector) {
 		cachedRef.current = next;
 		return next;
 	}, [store, selector]);
-	return useSyncExternalStore(store.subscribe, getSnapshot);
+	return useSyncExternalStore(store.subscribe, getSnapshot, getSnapshot);
 }
 function useDataTableFilters() {
 	const store = useDataTableStore();
@@ -511,20 +540,23 @@ function useDataTableSorting() {
 	}), [store]));
 }
 function useDataTableSelection() {
+	useRenderKey();
 	const store = useDataTableStore();
 	const table = useTableInstance();
-	return useSliceSelector(useCallback((state) => ({
-		rowSelection: state.rowSelection,
+	return {
+		rowSelection: store.getSnapshot().rowSelection,
 		setRowSelection: store.setRowSelection,
 		selectedRows: table.getFilteredSelectedRowModel().rows.map((r) => r.original)
-	}), [store, table]));
+	};
 }
 function useDataTablePagination() {
+	useRenderKey();
 	const store = useDataTableStore();
 	const table = useTableInstance();
+	const state = store.getSnapshot();
 	const nextPage = useCallback(() => table.nextPage(), [table]);
 	const prevPage = useCallback(() => table.previousPage(), [table]);
-	return useSliceSelector(useCallback((state) => ({
+	return {
 		canNextPage: table.getCanNextPage(),
 		canPrevPage: table.getCanPreviousPage(),
 		nextPage,
@@ -535,20 +567,16 @@ function useDataTablePagination() {
 		pageSize: state.pageSize,
 		setPageSize: store.setPageSize,
 		totalRows: state.filteredData.length
-	}), [
-		store,
-		table,
-		nextPage,
-		prevPage
-	]));
+	};
 }
 function useDataTableRows() {
+	useRenderKey();
 	const table = useTableInstance();
-	return useSliceSelector(useCallback((_state) => ({
+	return {
 		rows: table.getRowModel().rows,
 		headerGroups: table.getHeaderGroups(),
 		totalColumns: table.getAllColumns().length
-	}), [table]));
+	};
 }
 function useDataTableLoading() {
 	return useSliceSelector(useCallback((state) => ({
@@ -564,41 +592,6 @@ function useDataTableInlineContents() {
 		unregisterInlineContent: store.unregisterInlineContent
 	}), [store]));
 }
-function useDataTableContext() {
-	const store = useDataTableStore();
-	const table = useTableInstance();
-	const state = useSyncExternalStore(store.subscribe, store.getSnapshot);
-	return {
-		table,
-		mode: state.mode,
-		sorting: state.sorting,
-		filters: state.filters,
-		search: state.search,
-		rowSelection: state.rowSelection,
-		isLoading: state.isLoading,
-		setSorting: store.setSorting,
-		setFilter: store.setFilter,
-		clearFilter: store.clearFilter,
-		clearAllFilters: store.clearAllFilters,
-		setSearch: store.setSearch,
-		clearSearch: store.clearSearch,
-		setRowSelection: store.setRowSelection,
-		pagination: {
-			canNextPage: table.getCanNextPage(),
-			canPrevPage: table.getCanPreviousPage(),
-			nextPage: () => table.nextPage(),
-			prevPage: () => table.previousPage(),
-			pageIndex: state.pageIndex,
-			pageCount: table.getPageCount(),
-			setPageIndex: store.setPageIndex,
-			pageSize: state.pageSize,
-			setPageSize: store.setPageSize
-		},
-		inlineContents: state.inlineContents,
-		registerInlineContent: store.registerInlineContent,
-		unregisterInlineContent: store.unregisterInlineContent
-	};
-}
 
 //#endregion
 //#region src/components/features/data-table/components/active-filters.tsx
@@ -621,14 +614,15 @@ function FilterGroup({ label, children, className }) {
 	});
 }
 const EMPTY_LABELS = {};
-function ActiveFiltersInner({ label = "Selected Filters", filterLabels = EMPTY_LABELS, formatFilterValue: formatter, clearAll = "icon", clearAllLabel = "Clear all", className, groupClassName, badgeClassName }) {
+function ActiveFiltersInner({ label = "Selected Filters", excludeFilters, filterLabels = EMPTY_LABELS, formatFilterValue: formatter, clearAll = "icon", clearAllLabel = "Clear all", className, groupClassName, badgeClassName }) {
 	const { filters, setFilter, clearFilter, clearAllFilters } = useDataTableFilters();
 	const { search, clearSearch } = useDataTableSearch();
-	const activeFilterEntries = Object.entries(filters).filter(([, value]) => value != null && value !== "" && !(Array.isArray(value) && value.length === 0));
-	const hasSearch = search.length > 0;
+	const excludeSet = useMemo(() => new Set(excludeFilters ?? []), [excludeFilters]);
+	const activeFilterEntries = Object.entries(filters).filter(([key, value]) => !excludeSet.has(key) && value != null && value !== "" && !(Array.isArray(value) && value.length === 0));
+	const showSearch = search.length > 0 && !excludeSet.has("search");
 	const hasFilters = activeFilterEntries.length > 0;
-	if (!hasSearch && !hasFilters) return null;
-	const totalGroups = activeFilterEntries.length + (hasSearch ? 1 : 0);
+	if (!showSearch && !hasFilters) return null;
+	const totalGroups = activeFilterEntries.length + (showSearch ? 1 : 0);
 	const removeArrayItem = (column, items, item) => {
 		const remaining = items.filter((v) => v !== item);
 		if (remaining.length > 0) setFilter(column, remaining);
@@ -636,7 +630,7 @@ function ActiveFiltersInner({ label = "Selected Filters", filterLabels = EMPTY_L
 	};
 	const handleClearAll = () => {
 		clearAllFilters();
-		if (hasSearch) clearSearch();
+		if (search.length > 0) clearSearch();
 	};
 	const badgeCn = cn("flex items-center gap-1.5 px-2 py-0.5 text-xs", badgeClassName);
 	return /* @__PURE__ */ jsxs("div", {
@@ -649,7 +643,7 @@ function ActiveFiltersInner({ label = "Selected Filters", filterLabels = EMPTY_L
 				"data-slot": "dt-active-filters-label",
 				children: label
 			}),
-			hasSearch && /* @__PURE__ */ jsx(FilterGroup, {
+			showSearch && /* @__PURE__ */ jsx(FilterGroup, {
 				label: "Search",
 				className: groupClassName,
 				children: /* @__PURE__ */ jsxs(Badge, {
@@ -914,19 +908,8 @@ function DataTableLoading({ rows = DEFAULT_LOADING_ROWS, columns = 4, className
 	return /* @__PURE__ */ jsx("div", {
 		className,
 		"data-slot": "dt-loading",
-		children: /* @__PURE__ */ jsxs("div", {
-			className: "rounded-md border",
-			children: [/* @__PURE__ */ jsx("div", {
-				className: "border-b",
-				children: /* @__PURE__ */ jsx("div", {
-					className: "flex gap-4 p-4",
-					children: Array.from({ length: columns }, (_, i) => /* @__PURE__ */ jsx(Skeleton, { className: "h-4 flex-1" }, i))
-				})
-			}), Array.from({ length: rows }, (_, rowIndex) => /* @__PURE__ */ jsx("div", {
-				className: "flex gap-4 border-b p-4 last:border-b-0",
-				children: Array.from({ length: columns }, (_, colIndex) => /* @__PURE__ */ jsx(Skeleton, { className: "h-4 flex-1" }, colIndex))
-			}, rowIndex))]
-		})
+		style: { overflowX: "auto" },
+		children: /* @__PURE__ */ jsxs(Table, { children: [/* @__PURE__ */ jsx(TableHeader, { children: /* @__PURE__ */ jsx(TableRow, { children: Array.from({ length: columns }, (_, i) => /* @__PURE__ */ jsx(TableHead, { children: /* @__PURE__ */ jsx(Skeleton, { className: "h-4 w-24" }) }, i)) }) }), /* @__PURE__ */ jsx(TableBody, { children: Array.from({ length: rows }, (_, rowIndex) => /* @__PURE__ */ jsx(TableRow, { children: Array.from({ length: columns }, (_, colIndex) => /* @__PURE__ */ jsx(TableCell, { children: /* @__PURE__ */ jsx(Skeleton, { className: "h-4 w-full" }) }, colIndex)) }, rowIndex)) })] })
 	});
 }
 
@@ -1025,9 +1008,9 @@ function DataTablePagination({ pageSizes = DEFAULT_PAGE_SIZES, className }) {
 					return /* @__PURE__ */ jsx(Button, {
 						theme: isActive ? "solid" : "outline",
 						size: "small",
-						className: cn("h-8 min-w-8 px-2", isActive && "font-semibold"),
+						className: cn("h-8 min-w-8 px-2", isActive && "pointer-events-none font-semibold"),
 						onClick: () => setPageIndex(page - 1),
-						disabled: isActive,
+						"aria-disabled": isActive || void 0,
 						"aria-label": `Page ${page}`,
 						"aria-current": isActive ? "page" : void 0,
 						children: page
@@ -1091,7 +1074,7 @@ function DataTableRowActions({ row, actions, isLoading = false, className }) {
 
 //#endregion
 //#region src/components/features/data-table/components/search.tsx
-function DataTableSearch({ placeholder = "Search...", debounceMs = DEFAULT_DEBOUNCE_MS, className }) {
+function DataTableSearch({ placeholder = "Search...", debounceMs = DEFAULT_DEBOUNCE_MS, className, disabled }) {
 	const { search, setSearch } = useDataTableSearch();
 	const [inputValue, setInputValue] = useState(search);
 	useEffect(() => {
@@ -1113,68 +1096,345 @@ function DataTableSearch({ placeholder = "Search...", debounceMs = DEFAULT_DEBOU
 		value: inputValue,
 		onChange: (e) => setInputValue(e.target.value),
 		className,
+		disabled,
 		"aria-label": placeholder,
 		"data-slot": "dt-search"
 	});
 }
 
 //#endregion
-//#region src/components/features/data-table/core/client-provider.tsx
-function ClientProvider({ store, table, className, children }) {
-	return /* @__PURE__ */ jsx(DataTableStoreContext, {
-		value: store,
-		children: /* @__PURE__ */ jsx(TableInstanceContext, {
-			value: table,
-			children: /* @__PURE__ */ jsx("div", {
-				className,
-				children
-			})
-		})
+//#region src/components/features/data-table/hooks/use-data-table-client.ts
+function useDataTableClient(options) {
+	const { data, columns, pageSize, getRowId, enableRowSelection = false, defaultSort, defaultFilters, searchableColumns, searchFn, filterFns, stateAdapter } = options;
+	const store = useMemo(() => createDataTableStore({
+		data,
+		mode: "client",
+		defaultSort,
+		defaultFilters,
+		pageSize,
+		searchableColumns,
+		searchFn,
+		filterFns
+	}), []);
+	const isInitialRender = useRef(true);
+	useEffect(() => {
+		if (isInitialRender.current) {
+			isInitialRender.current = false;
+			return;
+		}
+		store.setData(data);
+	}, [data, store]);
+	const resolvedColumns = useMemo(() => enableRowSelection ? withSelectionColumn(columns, typeof enableRowSelection === "object" ? enableRowSelection : {}) : columns, [columns, enableRowSelection]);
+	const { filteredData, sorting, rowSelection, pageIndex, pageSize: storePageSize, filters, search } = useSyncExternalStore(store.subscribe, store.getSnapshot, store.getSnapshot);
+	const table = useReactTable({
+		data: filteredData,
+		columns: resolvedColumns,
+		state: {
+			sorting,
+			rowSelection,
+			pagination: {
+				pageIndex,
+				pageSize: storePageSize
+			}
+		},
+		onSortingChange: (updater) => {
+			const next = typeof updater === "function" ? updater(sorting) : updater;
+			store.setSorting(next);
+		},
+		onRowSelectionChange: (updater) => {
+			const next = typeof updater === "function" ? updater(rowSelection) : updater;
+			store.setRowSelection(next);
+		},
+		onPaginationChange: (updater) => {
+			const next = typeof updater === "function" ? updater({
+				pageIndex,
+				pageSize: storePageSize
+			}) : updater;
+			store.setPagination(next.pageIndex, next.pageSize);
+		},
+		getCoreRowModel: getCoreRowModel(),
+		getSortedRowModel: getSortedRowModel(),
+		getPaginationRowModel: getPaginationRowModel(),
+		getRowId,
+		enableRowSelection: !!enableRowSelection
 	});
+	const hydratedRef = useRef(false);
+	useEffect(() => {
+		if (stateAdapter && !hydratedRef.current) {
+			hydratedRef.current = true;
+			const persisted = stateAdapter.read();
+			if (persisted.sorting && persisted.sorting.length > 0) store.setSorting(persisted.sorting);
+			if (persisted.filters) {
+				for (const [key, value] of Object.entries(persisted.filters)) if (value != null) store.setFilter(key, value);
+			}
+			if (persisted.search) store.setSearch(persisted.search);
+			if (persisted.pageIndex != null && persisted.pageIndex > 0) store.setPageIndex(persisted.pageIndex);
+			if (persisted.pageSize != null) store.setPageSize(persisted.pageSize);
+		}
+	}, []);
+	const isFirstWrite = useRef(true);
+	useEffect(() => {
+		if (!stateAdapter) return;
+		if (isFirstWrite.current) {
+			isFirstWrite.current = false;
+			return;
+		}
+		stateAdapter.write({
+			sorting,
+			filters,
+			search,
+			pageIndex,
+			pageSize: storePageSize
+		});
+	}, [
+		sorting,
+		filters,
+		search,
+		pageIndex,
+		storePageSize,
+		stateAdapter
+	]);
+	return {
+		store,
+		table
+	};
 }
 
 //#endregion
-//#region src/components/features/data-table/core/server-provider.tsx
-function ServerProvider({ store, table, className, children }) {
+//#region src/components/features/data-table/hooks/use-is-client.ts
+/**
+* Returns `false` during SSR and `true` after hydration.
+* Used to gate components that depend on client-only APIs
+* (e.g. TanStack Table's internal useSyncExternalStore call
+* which omits the getServerSnapshot argument).
+*/
+function useIsClient() {
+	const [isClient, setIsClient] = useState(false);
+	useEffect(() => setIsClient(true), []);
+	return isClient;
+}
+
+//#endregion
+//#region src/components/features/data-table/core/client-provider.tsx
+/**
+* Inner component that calls useDataTableClient.
+* Only rendered on the client (gated by ClientProvider).
+*/
+function ClientProviderInner({ className, children, ssrFallback: _ssrFallback, ...options }) {
+	const { store, table } = useDataTableClient(options);
 	return /* @__PURE__ */ jsx(DataTableStoreContext, {
 		value: store,
 		children: /* @__PURE__ */ jsx(TableInstanceContext, {
 			value: table,
-			children: /* @__PURE__ */ jsx("div", {
-				className,
-				children
+			children: /* @__PURE__ */ jsx(DataTableRenderKeyContext, {
+				value: store.getSnapshot()._version,
+				children: /* @__PURE__ */ jsx("div", {
+					className,
+					children
+				})
 			})
 		})
 	});
 }
+function ClientProvider(props) {
+	if (!useIsClient()) return /* @__PURE__ */ jsx(Fragment$1, { children: props.ssrFallback === void 0 ? /* @__PURE__ */ jsx(DataTableLoading, { columns: props.columns.length }) : props.ssrFallback });
+	return /* @__PURE__ */ jsx(ClientProviderInner, { ...props });
+}
 
 //#endregion
-//#region src/components/features/data-table/filters/checkbox-filter.tsx
-const MAX_VISIBLE_BADGES = 2;
-function CheckboxFilter({ column, label, options, className, checkboxPopoverClassName }) {
-	const { filters, setFilter, clearFilter, registerFilter, unregisterFilter } = useDataTableFilters();
-	const [open, setOpen] = useState(false);
+//#region src/components/features/data-table/hooks/use-data-table-server.ts
+function useDataTableServer(options) {
+	const { columns, fetchFn, transform, limit = 20, getRowId, enableRowSelection = false, defaultSort, defaultFilters, stateAdapter } = options;
+	const fetchRef = useRef(fetchFn);
+	const transformRef = useRef(transform);
 	useEffect(() => {
-		registerFilter(column, "checkbox");
-		return () => unregisterFilter(column);
+		fetchRef.current = fetchFn;
+	}, [fetchFn]);
+	useEffect(() => {
+		transformRef.current = transform;
+	}, [transform]);
+	const cursorMapRef = useRef(/* @__PURE__ */ new Map());
+	const hasNextPageRef = useRef(false);
+	const store = useMemo(() => createDataTableStore({
+		data: [],
+		mode: "server",
+		defaultSort,
+		defaultFilters,
+		pageSize: limit
+	}), []);
+	const { sorting, filters, search, rowSelection, pageSize, pageIndex } = useSyncExternalStore(store.subscribe, store.getSnapshot, store.getSnapshot);
+	const prevQueryRef = useRef({
+		sorting,
+		filters,
+		search,
+		pageSize
+	});
+	useEffect(() => {
+		const prev = prevQueryRef.current;
+		if (prev.sorting !== sorting || prev.filters !== filters || prev.search !== search || prev.pageSize !== pageSize) {
+			cursorMapRef.current = /* @__PURE__ */ new Map();
+			hasNextPageRef.current = false;
+			if (pageIndex !== 0) {
+				prevQueryRef.current = {
+					sorting,
+					filters,
+					search,
+					pageSize
+				};
+				store.setPageIndex(0);
+				return;
+			}
+		}
+		prevQueryRef.current = {
+			sorting,
+			filters,
+			search,
+			pageSize
+		};
+		let cancelled = false;
+		store.setLoading(true);
+		const cursor = cursorMapRef.current.get(pageIndex);
+		fetchRef.current({
+			sorting,
+			filters,
+			search,
+			cursor,
+			limit: pageSize
+		}).then((response) => {
+			if (cancelled) return;
+			const result = transformRef.current(response);
+			store.setServerData(result.data);
+			store.setError(null);
+			if (result.cursor) cursorMapRef.current.set(pageIndex + 1, result.cursor);
+			hasNextPageRef.current = result.hasNextPage;
+		}).catch((error) => {
+			if (cancelled) return;
+			store.setServerData([]);
+			store.setError(error instanceof Error ? error : new Error(String(error)));
+			hasNextPageRef.current = false;
+		}).finally(() => {
+			if (!cancelled) store.setLoading(false);
+		});
+		return () => {
+			cancelled = true;
+		};
 	}, [
-		column,
-		registerFilter,
-		unregisterFilter
+		sorting,
+		filters,
+		search,
+		pageSize,
+		pageIndex,
+		store
 	]);
-	const selectedValues = filters[column] ?? [];
-	const updateValues = (newValues) => {
-		if (newValues.length > 0) setFilter(column, newValues);
-		else clearFilter(column);
-	};
-	const handleToggle = (optionValue, checked) => {
-		updateValues(checked ? [...selectedValues, optionValue] : selectedValues.filter((v) => v !== optionValue));
-	};
-	const removeValue = (optionValue) => {
-		updateValues(selectedValues.filter((v) => v !== optionValue));
-	};
-	const visibleBadges = selectedValues.slice(0, MAX_VISIBLE_BADGES);
-	const remainingCount = selectedValues.length - MAX_VISIBLE_BADGES;
+	const resolvedColumns = useMemo(() => enableRowSelection ? withSelectionColumn(columns, typeof enableRowSelection === "object" ? enableRowSelection : {}) : columns, [columns, enableRowSelection]);
+	const table = useReactTable({
+		data: store.getSnapshot().data,
+		columns: resolvedColumns,
+		state: {
+			sorting,
+			rowSelection,
+			pagination: {
+				pageIndex,
+				pageSize
+			}
+		},
+		manualPagination: true,
+		manualSorting: true,
+		manualFiltering: true,
+		pageCount: hasNextPageRef.current ? pageIndex + 2 : pageIndex + 1,
+		getCoreRowModel: getCoreRowModel(),
+		getRowId,
+		enableRowSelection: !!enableRowSelection,
+		onSortingChange: (updater) => {
+			const next = typeof updater === "function" ? updater(sorting) : updater;
+			store.setSorting(next);
+		},
+		onRowSelectionChange: (updater) => {
+			const next = typeof updater === "function" ? updater(rowSelection) : updater;
+			store.setRowSelection(next);
+		},
+		onPaginationChange: (updater) => {
+			const next = typeof updater === "function" ? updater({
+				pageIndex,
+				pageSize
+			}) : updater;
+			store.setPagination(next.pageIndex, next.pageSize);
+		}
+	});
+	useEffect(() => {
+		if (stateAdapter) stateAdapter.write({
+			sorting,
+			filters,
+			search,
+			pageSize
+		});
+	}, [
+		sorting,
+		filters,
+		search,
+		pageSize,
+		stateAdapter
+	]);
+	return {
+		store,
+		table
+	};
+}
+
+//#endregion
+//#region src/components/features/data-table/core/server-provider.tsx
+/**
+* Inner component that calls useDataTableServer.
+* Only rendered on the client (gated by ServerProvider).
+*/
+function ServerProviderInner({ className, children, ssrFallback: _ssrFallback, ...options }) {
+	const { store, table } = useDataTableServer(options);
+	return /* @__PURE__ */ jsx(DataTableStoreContext, {
+		value: store,
+		children: /* @__PURE__ */ jsx(TableInstanceContext, {
+			value: table,
+			children: /* @__PURE__ */ jsx(DataTableRenderKeyContext, {
+				value: store.getSnapshot()._version,
+				children: /* @__PURE__ */ jsx("div", {
+					className,
+					children
+				})
+			})
+		})
+	});
+}
+function ServerProvider(props) {
+	if (!useIsClient()) return /* @__PURE__ */ jsx(Fragment$1, { children: props.ssrFallback === void 0 ? /* @__PURE__ */ jsx(DataTableLoading, { columns: props.columns.length }) : props.ssrFallback });
+	return /* @__PURE__ */ jsx(ServerProviderInner, { ...props });
+}
+
+//#endregion
+//#region src/components/features/data-table/filters/checkbox-filter.tsx
+const MAX_VISIBLE_BADGES = 2;
+function CheckboxFilter({ column, label, options, className, checkboxPopoverClassName, disabled }) {
+	const { filters, setFilter, clearFilter, registerFilter, unregisterFilter } = useDataTableFilters();
+	const [open, setOpen] = useState(false);
+	useEffect(() => {
+		registerFilter(column, "checkbox");
+		return () => unregisterFilter(column);
+	}, [
+		column,
+		registerFilter,
+		unregisterFilter
+	]);
+	const selectedValues = filters[column] ?? [];
+	const updateValues = (newValues) => {
+		if (newValues.length > 0) setFilter(column, newValues);
+		else clearFilter(column);
+	};
+	const handleToggle = (optionValue, checked) => {
+		updateValues(checked ? [...selectedValues, optionValue] : selectedValues.filter((v) => v !== optionValue));
+	};
+	const removeValue = (optionValue) => {
+		updateValues(selectedValues.filter((v) => v !== optionValue));
+	};
+	const visibleBadges = selectedValues.slice(0, MAX_VISIBLE_BADGES);
+	const remainingCount = selectedValues.length - MAX_VISIBLE_BADGES;
 	return /* @__PURE__ */ jsxs(Popover, {
 		open,
 		onOpenChange: setOpen,
@@ -1182,6 +1442,7 @@ function CheckboxFilter({ column, label, options, className, checkboxPopoverClas
 			asChild: true,
 			children: /* @__PURE__ */ jsxs(Button, {
 				theme: "outline",
+				disabled,
 				className: cn("justify-between gap-1", className),
 				"data-slot": "dt-filter",
 				"data-testid": "dt-filter-trigger",
@@ -1261,7 +1522,7 @@ function CheckboxFilter({ column, label, options, className, checkboxPopoverClas
 
 //#endregion
 //#region src/components/features/data-table/filters/date-picker-filter.tsx
-function DatePickerFilter({ column, label, className, datePickerPopoverClassName, disableFuture, disablePast, minDate, maxDate }) {
+function DatePickerFilter({ column, label, className, datePickerPopoverClassName, disableFuture, disablePast, minDate, maxDate, disabled }) {
 	const { filters, setFilter, clearFilter, registerFilter, unregisterFilter } = useDataTableFilters();
 	const rawValue = filters[column];
 	useEffect(() => {
@@ -1288,6 +1549,7 @@ function DatePickerFilter({ column, label, className, datePickerPopoverClassName
 			placeholder: label,
 			triggerClassName: className,
 			variant: "outline",
+			disabled,
 			disableFuture,
 			disablePast,
 			minDate,
@@ -1303,7 +1565,7 @@ function DatePickerFilter({ column, label, className, datePickerPopoverClassName
 
 //#endregion
 //#region src/components/features/data-table/filters/select-filter.tsx
-function SelectFilter({ column, label, options, placeholder, searchable = true, className, selectPopoverClassName }) {
+function SelectFilter({ column, label, options, placeholder, searchable = true, className, selectPopoverClassName, disabled }) {
 	const { filters, setFilter, clearFilter, registerFilter, unregisterFilter } = useDataTableFilters();
 	const [open, setOpen] = useState(false);
 	const value = filters[column];
@@ -1325,6 +1587,7 @@ function SelectFilter({ column, label, options, placeholder, searchable = true,
 				theme: "outline",
 				role: "combobox",
 				"aria-expanded": open,
+				disabled,
 				className: cn("justify-between", className),
 				"data-slot": "dt-filter",
 				"data-testid": "dt-filter-trigger",
@@ -1388,242 +1651,4 @@ const DataTable = {
 };
 
 //#endregion
-//#region src/components/features/data-table/hooks/use-data-table-client.ts
-function useDataTableClient(options) {
-	const { data, columns, pageSize, getRowId, enableRowSelection = false, defaultSort, defaultFilters, searchableColumns, searchFn, filterFns, stateAdapter } = options;
-	const store = useMemo(() => createDataTableStore({
-		data,
-		mode: "client",
-		defaultSort,
-		defaultFilters,
-		pageSize,
-		searchableColumns,
-		searchFn,
-		filterFns
-	}), []);
-	const isInitialRender = useRef(true);
-	useEffect(() => {
-		if (isInitialRender.current) {
-			isInitialRender.current = false;
-			return;
-		}
-		store.setData(data);
-	}, [data, store]);
-	const resolvedColumns = useMemo(() => enableRowSelection ? withSelectionColumn(columns, typeof enableRowSelection === "object" ? enableRowSelection : {}) : columns, [columns, enableRowSelection]);
-	const { filteredData, sorting, rowSelection, pageIndex, pageSize: storePageSize, filters, search } = useSyncExternalStore(store.subscribe, store.getSnapshot);
-	const table = useReactTable({
-		data: filteredData,
-		columns: resolvedColumns,
-		state: {
-			sorting,
-			rowSelection,
-			pagination: {
-				pageIndex,
-				pageSize: storePageSize
-			}
-		},
-		onSortingChange: (updater) => {
-			const next = typeof updater === "function" ? updater(sorting) : updater;
-			store.setSorting(next);
-		},
-		onRowSelectionChange: (updater) => {
-			const next = typeof updater === "function" ? updater(rowSelection) : updater;
-			store.setRowSelection(next);
-		},
-		onPaginationChange: (updater) => {
-			const next = typeof updater === "function" ? updater({
-				pageIndex,
-				pageSize: storePageSize
-			}) : updater;
-			store.setPagination(next.pageIndex, next.pageSize);
-		},
-		getCoreRowModel: getCoreRowModel(),
-		getSortedRowModel: getSortedRowModel(),
-		getPaginationRowModel: getPaginationRowModel(),
-		getRowId,
-		enableRowSelection: !!enableRowSelection
-	});
-	const hydratedRef = useRef(false);
-	useEffect(() => {
-		if (stateAdapter && !hydratedRef.current) {
-			hydratedRef.current = true;
-			const persisted = stateAdapter.read();
-			if (persisted.sorting && persisted.sorting.length > 0) store.setSorting(persisted.sorting);
-			if (persisted.filters) {
-				for (const [key, value] of Object.entries(persisted.filters)) if (value != null) store.setFilter(key, value);
-			}
-			if (persisted.search) store.setSearch(persisted.search);
-			if (persisted.pageIndex != null && persisted.pageIndex > 0) store.setPageIndex(persisted.pageIndex);
-			if (persisted.pageSize != null) store.setPageSize(persisted.pageSize);
-		}
-	}, []);
-	const isFirstWrite = useRef(true);
-	useEffect(() => {
-		if (!stateAdapter) return;
-		if (isFirstWrite.current) {
-			isFirstWrite.current = false;
-			return;
-		}
-		stateAdapter.write({
-			sorting,
-			filters,
-			search,
-			pageIndex,
-			pageSize: storePageSize
-		});
-	}, [
-		sorting,
-		filters,
-		search,
-		pageIndex,
-		storePageSize,
-		stateAdapter
-	]);
-	return {
-		store,
-		table
-	};
-}
-
-//#endregion
-//#region src/components/features/data-table/hooks/use-data-table-server.ts
-function useDataTableServer(options) {
-	const { columns, fetchFn, transform, limit = 20, getRowId, enableRowSelection = false, defaultSort, defaultFilters, stateAdapter } = options;
-	const fetchRef = useRef(fetchFn);
-	const transformRef = useRef(transform);
-	useEffect(() => {
-		fetchRef.current = fetchFn;
-	}, [fetchFn]);
-	useEffect(() => {
-		transformRef.current = transform;
-	}, [transform]);
-	const cursorMapRef = useRef(/* @__PURE__ */ new Map());
-	const hasNextPageRef = useRef(false);
-	const store = useMemo(() => createDataTableStore({
-		data: [],
-		mode: "server",
-		defaultSort,
-		defaultFilters,
-		pageSize: limit
-	}), []);
-	const { sorting, filters, search, rowSelection, pageSize, pageIndex } = useSyncExternalStore(store.subscribe, store.getSnapshot);
-	const prevQueryRef = useRef({
-		sorting,
-		filters,
-		search,
-		pageSize
-	});
-	useEffect(() => {
-		const prev = prevQueryRef.current;
-		if (prev.sorting !== sorting || prev.filters !== filters || prev.search !== search || prev.pageSize !== pageSize) {
-			cursorMapRef.current = /* @__PURE__ */ new Map();
-			hasNextPageRef.current = false;
-			if (pageIndex !== 0) {
-				prevQueryRef.current = {
-					sorting,
-					filters,
-					search,
-					pageSize
-				};
-				store.setPageIndex(0);
-				return;
-			}
-		}
-		prevQueryRef.current = {
-			sorting,
-			filters,
-			search,
-			pageSize
-		};
-		let cancelled = false;
-		store.setLoading(true);
-		const cursor = cursorMapRef.current.get(pageIndex);
-		fetchRef.current({
-			sorting,
-			filters,
-			search,
-			cursor,
-			limit: pageSize
-		}).then((response) => {
-			if (cancelled) return;
-			const result = transformRef.current(response);
-			store.setServerData(result.data);
-			store.setError(null);
-			if (result.nextCursor) cursorMapRef.current.set(pageIndex + 1, result.nextCursor);
-			hasNextPageRef.current = result.hasNextPage;
-		}).catch((error) => {
-			if (cancelled) return;
-			store.setServerData([]);
-			store.setError(error instanceof Error ? error : new Error(String(error)));
-			hasNextPageRef.current = false;
-		}).finally(() => {
-			if (!cancelled) store.setLoading(false);
-		});
-		return () => {
-			cancelled = true;
-		};
-	}, [
-		sorting,
-		filters,
-		search,
-		pageSize,
-		pageIndex,
-		store
-	]);
-	const resolvedColumns = useMemo(() => enableRowSelection ? withSelectionColumn(columns, typeof enableRowSelection === "object" ? enableRowSelection : {}) : columns, [columns, enableRowSelection]);
-	const table = useReactTable({
-		data: store.getSnapshot().data,
-		columns: resolvedColumns,
-		state: {
-			sorting,
-			rowSelection,
-			pagination: {
-				pageIndex,
-				pageSize
-			}
-		},
-		manualPagination: true,
-		manualSorting: true,
-		manualFiltering: true,
-		pageCount: hasNextPageRef.current ? pageIndex + 2 : pageIndex + 1,
-		getCoreRowModel: getCoreRowModel(),
-		getRowId,
-		enableRowSelection: !!enableRowSelection,
-		onSortingChange: (updater) => {
-			const next = typeof updater === "function" ? updater(sorting) : updater;
-			store.setSorting(next);
-		},
-		onRowSelectionChange: (updater) => {
-			const next = typeof updater === "function" ? updater(rowSelection) : updater;
-			store.setRowSelection(next);
-		},
-		onPaginationChange: (updater) => {
-			const next = typeof updater === "function" ? updater({
-				pageIndex,
-				pageSize
-			}) : updater;
-			store.setPagination(next.pageIndex, next.pageSize);
-		}
-	});
-	useEffect(() => {
-		if (stateAdapter) stateAdapter.write({
-			sorting,
-			filters,
-			search,
-			pageSize
-		});
-	}, [
-		sorting,
-		filters,
-		search,
-		pageSize,
-		stateAdapter
-	]);
-	return {
-		store,
-		table
-	};
-}
-
-//#endregion
-export { DEFAULT_DEBOUNCE_MS, DEFAULT_LOADING_ROWS, DEFAULT_PAGE_SIZE, DEFAULT_PAGE_SIZES, DataTable, createDataTableStore, createSelectionColumn, useDataTableClient, useDataTableContext, useDataTableFilters, useDataTableInlineContents, useDataTableLoading, useDataTablePagination, useDataTableRows, useDataTableSearch, useDataTableSelection, useDataTableServer, useDataTableSorting, useNuqsAdapter };
+export { DEFAULT_DEBOUNCE_MS, DEFAULT_LOADING_ROWS, DEFAULT_PAGE_SIZE, DEFAULT_PAGE_SIZES, DataTable, createDataTableStore, createSelectionColumn, useDataTableFilters, useDataTableInlineContents, useDataTableLoading, useDataTablePagination, useDataTableRows, useDataTableSearch, useDataTableSelection, useDataTableSorting, useNuqsAdapter };