@datum-cloud/datum-ui 0.3.0-alpha.3670fb2 → 0.3.0-alpha.4702cdb

package/dist/data-table/index.mjs

@@ -12,11 +12,12 @@ import { t as Label } from "../label-_ste_Re3.mjs";
 import { i as DropdownMenuItem, l as DropdownMenuTrigger, r as DropdownMenuContent, t as DropdownMenu } from "../dropdown-menu-DAFyO-qD.mjs";
 import { i as PopoverTrigger, r as PopoverContent, t as Popover } from "../popover-Ds9624qY.mjs";
 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 "../skeleton-CkE23wsL.mjs";
+import { t as Skeleton } from "../skeleton-DZ31pU4B.mjs";
+import { c as TableRow, i as TableCell, n as TableBody, o as TableHead, s as TableHeader, t as Table } from "../table-Dpzh0VPK.mjs";
+import { t as CalendarDatePicker } from "../calendar-date-picker-Bw6Mrr-P.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 +158,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 +211,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) => {
@@ -240,10 +250,12 @@ function createDataTableStore(options) {
 		rowSelection: {},
 		pageIndex: 0,
 		pageSize: options.pageSize ?? DEFAULT_PAGE_SIZE,
+		columnCount: options.columnCount ?? 0,
 		mode: options.mode,
-		isLoading: false,
+		isLoading: options.isLoading ?? false,
 		error: null,
-		inlineContents: []
+		inlineContents: [],
+		_version: 0
 	};
 	if (options.defaultFilters && Object.keys(options.defaultFilters).length > 0) state = {
 		...state,
@@ -253,7 +265,10 @@ function createDataTableStore(options) {
 		for (const listener of listeners) listener();
 	}
 	function setState(next) {
-		state = next;
+		state = {
+			...next,
+			_version: state._version + 1
+		};
 		notify();
 	}
 	return {
@@ -281,7 +296,6 @@ function createDataTableStore(options) {
 				filteredData: data
 			});
 		},
-		setTable: (_t) => {},
 		setSorting: (sorting) => {
 			setState({
 				...state,
@@ -442,16 +456,34 @@ 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);
 	if (!store) throw new Error("useDataTableStore must be used within a <DataTable.Client> or <DataTable.Server> provider");
 	return store;
 }
-function useTableInstance() {
-	const table = use(TableInstanceContext);
-	if (!table) throw new Error("useTableInstance must be used within a <DataTable.Client> or <DataTable.Server> provider");
-	return table;
+/**
+* Returns the table instance or null if not yet available.
+* Used by hooks that need to handle the null-table window during SSR.
+*/
+function useTableInstanceOrNull() {
+	return use(TableInstanceContext);
 }
 
 //#endregion
@@ -482,7 +514,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,49 +543,64 @@ function useDataTableSorting() {
 	}), [store]));
 }
 function useDataTableSelection() {
+	useRenderKey();
 	const store = useDataTableStore();
-	const table = useTableInstance();
-	return useSliceSelector(useCallback((state) => ({
-		rowSelection: state.rowSelection,
+	const table = useTableInstanceOrNull();
+	return {
+		rowSelection: store.getSnapshot().rowSelection,
 		setRowSelection: store.setRowSelection,
-		selectedRows: table.getFilteredSelectedRowModel().rows.map((r) => r.original)
-	}), [store, table]));
+		selectedRows: table ? table.getFilteredSelectedRowModel().rows.map((r) => r.original) : []
+	};
 }
 function useDataTablePagination() {
+	useRenderKey();
 	const store = useDataTableStore();
-	const table = useTableInstance();
-	const nextPage = useCallback(() => table.nextPage(), [table]);
-	const prevPage = useCallback(() => table.previousPage(), [table]);
-	return useSliceSelector(useCallback((state) => ({
+	const table = useTableInstanceOrNull();
+	const state = store.getSnapshot();
+	if (!table) return {
+		canNextPage: false,
+		canPrevPage: false,
+		nextPage: () => {},
+		prevPage: () => {},
+		pageIndex: state.pageIndex,
+		pageCount: 0,
+		setPageIndex: store.setPageIndex,
+		pageSize: state.pageSize,
+		setPageSize: store.setPageSize,
+		totalRows: 0
+	};
+	return {
 		canNextPage: table.getCanNextPage(),
 		canPrevPage: table.getCanPreviousPage(),
-		nextPage,
-		prevPage,
+		nextPage: () => table.nextPage(),
+		prevPage: () => table.previousPage(),
 		pageIndex: state.pageIndex,
 		pageCount: table.getPageCount(),
 		setPageIndex: store.setPageIndex,
 		pageSize: state.pageSize,
 		setPageSize: store.setPageSize,
 		totalRows: state.filteredData.length
-	}), [
-		store,
-		table,
-		nextPage,
-		prevPage
-	]));
+	};
 }
 function useDataTableRows() {
-	const table = useTableInstance();
-	return useSliceSelector(useCallback((_state) => ({
+	useRenderKey();
+	const table = useTableInstanceOrNull();
+	if (!table) return {
+		rows: [],
+		headerGroups: [],
+		totalColumns: 0
+	};
+	return {
 		rows: table.getRowModel().rows,
 		headerGroups: table.getHeaderGroups(),
 		totalColumns: table.getAllColumns().length
-	}), [table]));
+	};
 }
 function useDataTableLoading() {
 	return useSliceSelector(useCallback((state) => ({
 		isLoading: state.isLoading,
-		error: state.error
+		error: state.error,
+		columnCount: state.columnCount
 	}), []));
 }
 function useDataTableInlineContents() {
@@ -564,49 +611,12 @@ 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
-function formatValue(column, value, formatter) {
-	if (formatter) {
-		const result = formatter(column, value);
-		if (result !== void 0) return result;
-	}
+function formatValue(column, value, formatters) {
+	const fn = formatters?.[column];
+	if (fn) return fn(value);
 	return String(value);
 }
 function FilterGroup({ label, children, className }) {
@@ -621,14 +631,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: formatters, 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 +647,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 +660,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, {
@@ -678,10 +689,10 @@ function ActiveFiltersInner({ label = "Selected Filters", filterLabels = EMPTY_L
 						type: "muted",
 						theme: "solid",
 						className: badgeCn,
-						children: [/* @__PURE__ */ jsx("span", { children: formatValue(column, item, formatter) }), /* @__PURE__ */ jsx(Button, {
+						children: [/* @__PURE__ */ jsx("span", { children: formatValue(column, item, formatters) }), /* @__PURE__ */ jsx(Button, {
 							theme: "borderless",
 							size: "small",
-							"aria-label": `Remove ${formatValue(column, item, formatter)} from ${groupLabel}`,
+							"aria-label": `Remove ${formatValue(column, item, formatters)} from ${groupLabel}`,
 							className: "h-auto p-0 text-muted-foreground hover:text-foreground",
 							onClick: () => removeArrayItem(column, value, item),
 							children: /* @__PURE__ */ jsx(X, {
@@ -698,7 +709,7 @@ function ActiveFiltersInner({ label = "Selected Filters", filterLabels = EMPTY_L
 						type: "muted",
 						theme: "solid",
 						className: badgeCn,
-						children: [/* @__PURE__ */ jsx("span", { children: formatValue(column, value, formatter) }), /* @__PURE__ */ jsx(Button, {
+						children: [/* @__PURE__ */ jsx("span", { children: formatValue(column, value, formatters) }), /* @__PURE__ */ jsx(Button, {
 							theme: "borderless",
 							size: "small",
 							"aria-label": `Clear ${groupLabel} filter`,
@@ -804,9 +815,12 @@ function renderInlineContentRow(entry, colSpan, rows) {
 }
 function DataTableContent({ emptyMessage, className, tableClassName, headerClassName, headerRowClassName, headerCellClassName, bodyClassName, rowClassName, cellClassName }) {
 	const { rows, headerGroups, totalColumns } = useDataTableRows();
+	const { isLoading, columnCount } = useDataTableLoading();
+	const { pageSize } = useDataTablePagination();
 	const { inlineContents } = useDataTableInlineContents();
 	const openInlineContents = useMemo(() => inlineContents.filter((e) => e.open), [inlineContents]);
 	const colSpan = totalColumns;
+	const skeletonColumns = totalColumns || columnCount || DEFAULT_LOADING_ROWS;
 	return /* @__PURE__ */ jsx("div", {
 		className: cn("datum-ui-data-table", className),
 		"data-slot": "dt",
@@ -843,7 +857,13 @@ function DataTableContent({ emptyMessage, className, tableClassName, headerClass
 							children: flexRender(cell.column.columnDef.cell, cell.getContext())
 						}, cell.id))
 					}, row.id);
-				}) : /* @__PURE__ */ jsx(TableRow, {
+				}) : isLoading ? Array.from({ length: pageSize }, (_, i) => /* @__PURE__ */ jsx(TableRow, {
+					"data-slot": "dt-skeleton-row",
+					children: Array.from({ length: skeletonColumns }, (_, j) => /* @__PURE__ */ jsx(TableCell, {
+						"data-slot": "dt-skeleton-cell",
+						children: /* @__PURE__ */ jsx(Skeleton, { className: "h-4 w-full" })
+					}, j))
+				}, i)) : /* @__PURE__ */ jsx(TableRow, {
 					"data-slot": "dt-row",
 					children: /* @__PURE__ */ jsx(TableCell, {
 						colSpan,
@@ -914,19 +934,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 +1034,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 +1100,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,18 +1122,105 @@ 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/hooks/use-data-table-client.ts
+/**
+* Creates a TanStack Table instance from an existing store.
+* Does NOT create the store or sync data — the caller is responsible for that.
+*/
+function useClientTable(store, options) {
+	const { columns, getRowId, enableRowSelection = false, stateAdapter } = options;
+	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 { table };
+}
+
 //#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,
+/**
+* Inner component that calls useClientTable.
+* Only rendered after hydration (gated by tableReady).
+*/
+function ClientProviderInner({ store, className, children, ...options }) {
+	const { table } = useClientTable(store, options);
+	return /* @__PURE__ */ jsx(TableInstanceContext, {
+		value: table,
+		children: /* @__PURE__ */ jsx(DataTableRenderKeyContext, {
+			value: store.getSnapshot()._version,
 			children: /* @__PURE__ */ jsx("div", {
 				className,
 				children
@@ -1132,57 +1228,290 @@ function ClientProvider({ store, table, className, children }) {
 		})
 	});
 }
-
-//#endregion
-//#region src/components/features/data-table/core/server-provider.tsx
-function ServerProvider({ store, table, className, children }) {
+function ClientProvider(props) {
+	const { data, columns, loading, pageSize, getRowId, enableRowSelection, defaultSort, defaultFilters, searchableColumns, searchFn, filterFns, stateAdapter, className, children } = props;
+	const store = useMemo(() => createDataTableStore({
+		data,
+		mode: "client",
+		isLoading: true,
+		defaultSort,
+		defaultFilters,
+		pageSize,
+		columnCount: columns.length,
+		searchableColumns,
+		searchFn,
+		filterFns
+	}), []);
+	const isInitialRender = useRef(true);
+	useEffect(() => {
+		if (isInitialRender.current) {
+			isInitialRender.current = false;
+			return;
+		}
+		store.setData(data);
+	}, [data, store]);
+	const [tableReady, setTableReady] = useState(false);
+	useEffect(() => setTableReady(true), []);
+	useEffect(() => {
+		if (!tableReady) return;
+		store.setLoading(loading ?? false);
+	}, [
+		loading,
+		tableReady,
+		store
+	]);
 	return /* @__PURE__ */ jsx(DataTableStoreContext, {
 		value: store,
-		children: /* @__PURE__ */ jsx(TableInstanceContext, {
-			value: table,
-			children: /* @__PURE__ */ jsx("div", {
-				className,
-				children
+		children: tableReady ? /* @__PURE__ */ jsx(ClientProviderInner, {
+			store,
+			columns,
+			getRowId,
+			enableRowSelection,
+			stateAdapter,
+			className,
+			children
+		}) : /* @__PURE__ */ jsx(TableInstanceContext, {
+			value: null,
+			children: /* @__PURE__ */ jsx(DataTableRenderKeyContext, {
+				value: 0,
+				children: /* @__PURE__ */ jsx("div", {
+					className,
+					children
+				})
 			})
 		})
 	});
 }
 
 //#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
+/**
+* Creates a TanStack Table instance from an existing store.
+* Handles fetch-on-query-change, cursor pagination, and state adapter sync.
+* Does NOT create the store — the caller is responsible for that.
+*/
+function useServerTable(store, options) {
+	const { columns, fetchFn, transform, getRowId, enableRowSelection = false, 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 { 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;
-	return /* @__PURE__ */ jsxs(Popover, {
-		open,
-		onOpenChange: setOpen,
+	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 { table };
+}
+
+//#endregion
+//#region src/components/features/data-table/core/server-provider.tsx
+/**
+* Inner component that calls useServerTable.
+* Only rendered after hydration (gated by tableReady).
+*/
+function ServerProviderInner({ store, className, children, ...options }) {
+	const { table } = useServerTable(store, options);
+	return /* @__PURE__ */ jsx(TableInstanceContext, {
+		value: table,
+		children: /* @__PURE__ */ jsx(DataTableRenderKeyContext, {
+			value: store.getSnapshot()._version,
+			children: /* @__PURE__ */ jsx("div", {
+				className,
+				children
+			})
+		})
+	});
+}
+function ServerProvider(props) {
+	const { columns, fetchFn, transform, limit = 20, getRowId, enableRowSelection, defaultSort, defaultFilters, stateAdapter, className, children } = props;
+	const store = useMemo(() => createDataTableStore({
+		data: [],
+		mode: "server",
+		isLoading: true,
+		defaultSort,
+		defaultFilters,
+		pageSize: limit,
+		columnCount: columns.length
+	}), []);
+	const [tableReady, setTableReady] = useState(false);
+	useEffect(() => setTableReady(true), []);
+	return /* @__PURE__ */ jsx(DataTableStoreContext, {
+		value: store,
+		children: tableReady ? /* @__PURE__ */ jsx(ServerProviderInner, {
+			store,
+			columns,
+			fetchFn,
+			transform,
+			limit,
+			getRowId,
+			enableRowSelection,
+			stateAdapter,
+			className,
+			children
+		}) : /* @__PURE__ */ jsx(TableInstanceContext, {
+			value: null,
+			children: /* @__PURE__ */ jsx(DataTableRenderKeyContext, {
+				value: 0,
+				children: /* @__PURE__ */ jsx("div", {
+					className,
+					children
+				})
+			})
+		})
+	});
+}
+
+//#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,
 		children: [/* @__PURE__ */ jsx(PopoverTrigger, {
 			asChild: true,
 			children: /* @__PURE__ */ jsxs(Button, {
 				theme: "outline",
-				className: cn("justify-between gap-1", className),
+				disabled,
+				className: cn("h-10 justify-between gap-1", className),
 				"data-slot": "dt-filter",
 				"data-testid": "dt-filter-trigger",
 				children: [selectedValues.length > 0 ? /* @__PURE__ */ jsxs("div", {
@@ -1261,7 +1590,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(() => {
@@ -1286,8 +1615,9 @@ function DatePickerFilter({ column, label, className, datePickerPopoverClassName
 			numberOfMonths: 1,
 			closeOnSelect: true,
 			placeholder: label,
-			triggerClassName: className,
+			triggerClassName: cn("h-10", className),
 			variant: "outline",
+			disabled,
 			disableFuture,
 			disablePast,
 			minDate,
@@ -1303,7 +1633,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,7 +1655,8 @@ function SelectFilter({ column, label, options, placeholder, searchable = true,
 				theme: "outline",
 				role: "combobox",
 				"aria-expanded": open,
-				className: cn("justify-between", className),
+				disabled,
+				className: cn("h-10 justify-between", className),
 				"data-slot": "dt-filter",
 				"data-testid": "dt-filter-trigger",
 				children: [/* @__PURE__ */ jsx("span", {
@@ -1388,242 +1719,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 };