@mono-lit/helper 0.0.8 → 0.0.9

package/dist/index.js

@@ -3,16 +3,16 @@ import { a as buildGroups, c as isGroupNode, o as collectGroupPaths, s as flatte
 import { _ as plainSearchFields, b as searchRemoteFilter, c as resolveErrorMessages, d as DEFAULT_SEARCH_OPERATION, f as MonoSourceSearch, g as parseSearchValue, h as mergeSearchFields, l as setErrorMessages, m as isFoldableSearch, n as describeError, p as SEARCH_FIELDS_KEYS, r as errorStatus, s as normalizeError, t as DEFAULT_ERROR_MESSAGES, v as readSearchField, x as searchRowPredicate, y as resolveSearchFields } from "./normalize-error-D93O4q8g.js";
 import { h as monoArraySource } from "./data-source-options-fxT5QIX4.js";
 import { t as resolveMaybeReactive } from "./reactive-Dtd-esHO.js";
-import { t as monoDataGrid } from "./mono-data-grid-Bb00QM72.js";
+import { t as monoDataGrid } from "./mono-data-grid-llJCX9MC.js";
 import { d as OPERATOR_ARITY, l as treeToArray, m as operatorsFor, n as arrayToTree, s as odataStringToArray, t as arrayToODataString, u as DEFAULT_TEXTS } from "./filter-odata-Bi27XUpQ.js";
 import { t as monoFilterBuilder } from "./filter-builder-C0T3pMx2.js";
 import { C as resetMonoSkeleton, a as resetMonoUI, c as stopMonoSizeAttributes, i as getMonoUIStatus, m as isMonoSsrApp, n as createMonoUI, o as applyMonoSizeAttributes, p as getMonoSkeletonStatus, r as getMonoUI, s as startMonoSizeAttributes } from "./mono-ui-kvLVIf1V.js";
 import { t as monoForm } from "./mono-form-controller-BrA10erm.js";
 import { t as monoModal } from "./mono-modal-controller-ClObbHUs.js";
 import { i as composeApply, n as buildChartApply, r as buildChartOdataRequest, t as monoChart } from "./mono-data-chart-NKPdAgVq.js";
-import { t as monoDataDropdown } from "./mono-data-dropdown-DUXo_jxd.js";
+import { t as monoDataDropdown } from "./mono-data-dropdown-B2iRpJuI.js";
 import { a as monoTooltip, c as getMonoTooltipGlobal, t as controlMonoTooltip } from "./control-tooltip-CoPD37_h.js";
 import { a as resetMonoTooltip, n as createMonoTooltip, r as destroyAllMonoTooltips } from "./tooltip-Cu5IrDS9.js";
-import { _ as DEFAULT_FLAVOR, a as flavors, b as themePresets, c as getCurrentFlavor, d as getThemeData, f as isValidFlavor, g as themes, h as resetTheme, i as createThemeClass, l as getCurrentTheme, m as resetFlavor, n as applyTheme, o as getAllFlavors, p as isValidTheme, r as createFlavorClass, s as getAllThemes, t as applyFlavor, u as getFlavorData, v as DEFAULT_THEME, y as flavorPresets } from "./index.node-CLqE8F8P.js";
+import { _ as DEFAULT_FLAVOR, a as flavors, b as themePresets, c as getCurrentFlavor, d as getThemeData, f as isValidFlavor, g as themes, h as resetTheme, i as createThemeClass, l as getCurrentTheme, m as resetFlavor, n as applyTheme, o as getAllFlavors, p as isValidTheme, r as createFlavorClass, s as getAllThemes, t as applyFlavor, u as getFlavorData, v as DEFAULT_THEME, y as flavorPresets } from "./index.node-DTqDBca7.js";
 
 export { DEFAULT_ERROR_MESSAGES, DEFAULT_FLAVOR, DEFAULT_SEARCH_OPERATION, DEFAULT_THEME, OPERATOR_ARITY as MONO_FILTER_OPERATOR_ARITY, DEFAULT_TEXTS as MONO_FILTER_TEXTS, MonoSourceSearch, SEARCH_FIELDS_KEYS, applyFlavor, applyMonoSizeAttributes, applyTheme, arrayToODataString, arrayToTree, buildChartApply, buildChartOdataRequest, buildGroups, collectGroupPaths, composeApply, monoChart as controlMonoChart, monoChart, monoDataDropdown as controlMonoDataDropdown, monoDataDropdown, monoFilterBuilder as controlMonoFilterBuilder, monoFilterBuilder, monoForm as controlMonoForm, monoForm, monoModal as controlMonoModal, monoModal, monoDataGrid as controlMonoTable, monoDataGrid, controlMonoTooltip, createFlavorClass, createMonoTooltip, createMonoUI, createThemeClass, describeError, destroyAllMonoTooltips, errorStatus, flattenLeaves, flavorPresets, flavors, getAllFlavors, getAllThemes, getCurrentFlavor, getCurrentTheme, getFieldValue, getFlavorData, getMonoSkeletonStatus, getMonoTooltipGlobal, getMonoUI, getMonoUIStatus, getThemeData, isFoldableSearch, isGroupNode, isMonoSsrApp, isPath, isValidFlavor, isValidTheme, mergePatch, mergeSearchFields, monoArraySource, operatorsFor as monoFilterOperatorsFor, monoTooltip, normalizeError, odataStringToArray, parseFieldPath, parseSearchValue, plainSearchFields, readSearchField, resetFlavor, resetMonoSkeleton, resetMonoTooltip, resetMonoUI, resetTheme, resolveErrorMessages, resolveMaybeReactive, resolveSearchFields, searchRemoteFilter, searchRowPredicate, setErrorMessages, setFieldValue, startMonoSizeAttributes, stopMonoSizeAttributes, themePresets, themes, toODataClause, toODataSelector, treeToArray };

package/dist/{index.node-CLqE8F8P.js → index.node-DTqDBca7.js}

@@ -1,8 +1,8 @@
 import "./normalize-error-D93O4q8g.js";
-import "./mono-data-grid-Bb00QM72.js";
+import "./mono-data-grid-llJCX9MC.js";
 import "./mono-ui-kvLVIf1V.js";
 import "./mono-data-chart-NKPdAgVq.js";
-import "./mono-data-dropdown-DUXo_jxd.js";
+import "./mono-data-dropdown-B2iRpJuI.js";
 import "./tooltip-Cu5IrDS9.js";
 
 //#region src/data/theme/presets.json

package/dist/index.node.js

@@ -3,16 +3,16 @@ import { a as buildGroups, c as isGroupNode, o as collectGroupPaths, s as flatte
 import { _ as plainSearchFields, b as searchRemoteFilter, c as resolveErrorMessages, d as DEFAULT_SEARCH_OPERATION, f as MonoSourceSearch, g as parseSearchValue, h as mergeSearchFields, l as setErrorMessages, m as isFoldableSearch, n as describeError, p as SEARCH_FIELDS_KEYS, r as errorStatus, s as normalizeError, t as DEFAULT_ERROR_MESSAGES, v as readSearchField, x as searchRowPredicate, y as resolveSearchFields } from "./normalize-error-D93O4q8g.js";
 import { h as monoArraySource } from "./data-source-options-fxT5QIX4.js";
 import { t as resolveMaybeReactive } from "./reactive-Dtd-esHO.js";
-import { t as monoDataGrid } from "./mono-data-grid-Bb00QM72.js";
+import { t as monoDataGrid } from "./mono-data-grid-llJCX9MC.js";
 import { d as OPERATOR_ARITY, l as treeToArray, m as operatorsFor, n as arrayToTree, s as odataStringToArray, t as arrayToODataString, u as DEFAULT_TEXTS } from "./filter-odata-Bi27XUpQ.js";
 import { t as monoFilterBuilder } from "./filter-builder-C0T3pMx2.js";
 import { C as resetMonoSkeleton, a as resetMonoUI, c as stopMonoSizeAttributes, i as getMonoUIStatus, m as isMonoSsrApp, n as createMonoUI, o as applyMonoSizeAttributes, p as getMonoSkeletonStatus, r as getMonoUI, s as startMonoSizeAttributes } from "./mono-ui-kvLVIf1V.js";
 import { t as monoForm } from "./mono-form-controller-BrA10erm.js";
 import { t as monoModal } from "./mono-modal-controller-ClObbHUs.js";
 import { i as composeApply, n as buildChartApply, r as buildChartOdataRequest, t as monoChart } from "./mono-data-chart-NKPdAgVq.js";
-import { t as monoDataDropdown } from "./mono-data-dropdown-DUXo_jxd.js";
+import { t as monoDataDropdown } from "./mono-data-dropdown-B2iRpJuI.js";
 import { a as monoTooltip, c as getMonoTooltipGlobal, t as controlMonoTooltip } from "./control-tooltip-CoPD37_h.js";
 import { a as resetMonoTooltip, n as createMonoTooltip, r as destroyAllMonoTooltips } from "./tooltip-Cu5IrDS9.js";
-import { _ as DEFAULT_FLAVOR, a as flavors, b as themePresets, c as getCurrentFlavor, d as getThemeData, f as isValidFlavor, g as themes, h as resetTheme, i as createThemeClass, l as getCurrentTheme, m as resetFlavor, n as applyTheme, o as getAllFlavors, p as isValidTheme, r as createFlavorClass, s as getAllThemes, t as applyFlavor, u as getFlavorData, v as DEFAULT_THEME, y as flavorPresets } from "./index.node-CLqE8F8P.js";
+import { _ as DEFAULT_FLAVOR, a as flavors, b as themePresets, c as getCurrentFlavor, d as getThemeData, f as isValidFlavor, g as themes, h as resetTheme, i as createThemeClass, l as getCurrentTheme, m as resetFlavor, n as applyTheme, o as getAllFlavors, p as isValidTheme, r as createFlavorClass, s as getAllThemes, t as applyFlavor, u as getFlavorData, v as DEFAULT_THEME, y as flavorPresets } from "./index.node-DTqDBca7.js";
 
 export { DEFAULT_ERROR_MESSAGES, DEFAULT_FLAVOR, DEFAULT_SEARCH_OPERATION, DEFAULT_THEME, OPERATOR_ARITY as MONO_FILTER_OPERATOR_ARITY, DEFAULT_TEXTS as MONO_FILTER_TEXTS, MonoSourceSearch, SEARCH_FIELDS_KEYS, applyFlavor, applyMonoSizeAttributes, applyTheme, arrayToODataString, arrayToTree, buildChartApply, buildChartOdataRequest, buildGroups, collectGroupPaths, composeApply, monoChart as controlMonoChart, monoChart, monoDataDropdown as controlMonoDataDropdown, monoDataDropdown, monoFilterBuilder as controlMonoFilterBuilder, monoFilterBuilder, monoForm as controlMonoForm, monoForm, monoModal as controlMonoModal, monoModal, monoDataGrid as controlMonoTable, monoDataGrid, controlMonoTooltip, createFlavorClass, createMonoTooltip, createMonoUI, createThemeClass, describeError, destroyAllMonoTooltips, errorStatus, flattenLeaves, flavorPresets, flavors, getAllFlavors, getAllThemes, getCurrentFlavor, getCurrentTheme, getFieldValue, getFlavorData, getMonoSkeletonStatus, getMonoTooltipGlobal, getMonoUI, getMonoUIStatus, getThemeData, isFoldableSearch, isGroupNode, isMonoSsrApp, isPath, isValidFlavor, isValidTheme, mergePatch, mergeSearchFields, monoArraySource, operatorsFor as monoFilterOperatorsFor, monoTooltip, normalizeError, odataStringToArray, parseFieldPath, parseSearchValue, plainSearchFields, readSearchField, resetFlavor, resetMonoSkeleton, resetMonoTooltip, resetMonoUI, resetTheme, resolveErrorMessages, resolveMaybeReactive, resolveSearchFields, searchRemoteFilter, searchRowPredicate, setErrorMessages, setFieldValue, startMonoSizeAttributes, stopMonoSizeAttributes, themePresets, themes, toODataClause, toODataSelector, treeToArray };

package/dist/{mono-data-dropdown-DUXo_jxd.js → mono-data-dropdown-B2iRpJuI.js}

@@ -1,4 +1,4 @@
-import { t as monoDataGrid } from "./mono-data-grid-Bb00QM72.js";
+import { t as monoDataGrid } from "./mono-data-grid-llJCX9MC.js";
 import { t as createNotifier } from "./notifier-BIrqUzRh.js";
 
 //#region src/components/dropdown-table/mono-data-dropdown.ts

package/dist/{mono-data-grid-Bkr-e1-i.js → mono-data-grid-e9ZVBlNN.js}

@@ -444,6 +444,9 @@ function monoDataGrid(ds = null, opts = {}) {
 	const chunkSize = Math.max(1, opts.chunkSize ?? 100);
 	let suppressSync = false;
 	let allRows = [];
+	let browserRows = null;
+	let browserPageIndex = 0;
+	let browserPageSize = 0;
 	let scrollMode = "off";
 	let accumulated = [];
 	let scrollNextPage = 0;
@@ -2147,16 +2150,21 @@ function monoDataGrid(ds = null, opts = {}) {
 	* column sort follows — applied to the group field itself if it is one.
 	*/
 	function effectiveSort() {
-		const keys = ctrl.sorts.map((s) => ({
-			selector: s.field,
+		const keys = ctrl.sorts.filter((s) => !isBrowserSortKey(s.field)).map((s) => ({
+			field: s.field,
+			selector: declaredSortSelector(s.field) ?? s.field,
 			desc: s.order === "desc"
 		}));
-		if (!groupFields.length) return keys.length ? keys : null;
+		const entry = (k) => ({
+			selector: k.selector,
+			desc: k.desc
+		});
+		if (!groupFields.length) return keys.length ? keys.map(entry) : null;
 		const list = groupFields.map((f) => ({
 			selector: f,
-			desc: keys.find((k) => k.selector === f)?.desc ?? false
+			desc: keys.find((k) => k.field === f)?.desc ?? false
 		}));
-		for (const k of keys) if (!groupFields.includes(k.selector)) list.push(k);
+		for (const k of keys) if (!groupFields.includes(k.field)) list.push(entry(k));
 		return list;
 	}
 	/**
@@ -2571,6 +2579,10 @@ function monoDataGrid(ds = null, opts = {}) {
 			syncScroll();
 			return;
 		}
+		if (browserRows && browserSortActive()) {
+			syncBrowser();
+			return;
+		}
 		if (pageSizeAll) {
 			ctrl.grouped = false;
 			ctrl.items = allRows;
@@ -2734,6 +2746,11 @@ function monoDataGrid(ds = null, opts = {}) {
 			await loadScrollPage(true);
 			return;
 		}
+		if (browserSortActive()) {
+			await loadBrowserSorted();
+			return;
+		}
+		browserRows = null;
 		if (pageSizeAll && !isGrouped()) {
 			await loadAllChunked();
 			return;
@@ -2755,6 +2772,11 @@ function monoDataGrid(ds = null, opts = {}) {
 			await loadScrollPage(true);
 			return;
 		}
+		if (browserSortActive()) {
+			await loadBrowserSorted();
+			return;
+		}
+		browserRows = null;
 		if (pageSizeAll && !isGrouped()) {
 			await loadAllChunked();
 			return;
@@ -2791,6 +2813,11 @@ function monoDataGrid(ds = null, opts = {}) {
 			if (serverMode()) await fetchVisibleRows();
 			return;
 		}
+		if (browserRows && browserSortActive()) {
+			browserPageIndex = Math.max(0, pageIndex);
+			syncBrowser();
+			return;
+		}
 		const s = bound;
 		if (!s) return;
 		s.pageIndex?.(Math.max(0, pageIndex));
@@ -2808,6 +2835,15 @@ function monoDataGrid(ds = null, opts = {}) {
 		}
 		const s = bound;
 		if (!s) return;
+		if (browserRows && browserSortActive()) {
+			if (!all) {
+				browserPageSize = Math.max(1, pageSize);
+				s.pageSize?.(browserPageSize);
+			}
+			browserPageIndex = 0;
+			syncBrowser();
+			return;
+		}
 		if (all) {
 			await loadAllChunked();
 			return;
@@ -2854,6 +2890,127 @@ function monoDataGrid(ds = null, opts = {}) {
 		ctrl.loading = bound?.isLoading?.() ?? false;
 		sync();
 	}
+	const BROWSER_SORT_MAX_ROWS = 5e3;
+	/** The active sort keys when ANY of them sorts in the browser, else `null`. */
+	function browserSortKeys() {
+		if (!ctrl.sorts.some((s) => isBrowserSortKey(s.field))) return null;
+		return ctrl.sorts.map((s) => {
+			const browser = isBrowserSortKey(s.field);
+			return {
+				field: s.field,
+				selector: declaredSortSelector(s.field) ?? s.field,
+				desc: s.order === "desc",
+				aggregate: browser ? declaredSortConfig(s.field).aggregate ?? "sum" : null
+			};
+		});
+	}
+	/** Browser sort applies: a browser-sorted column is active on a flat, paged, bound table. */
+	function browserSortActive() {
+		return !!bound && !isGrouped() && !serverMode() && !scrollActive() && !!browserSortKeys();
+	}
+	/** The smallest `maxRows` any active browser-sorted column declares (default 5000). */
+	function browserSortCap() {
+		const caps = ctrl.sorts.filter((s) => isBrowserSortKey(s.field)).map((s) => Number(declaredSortConfig(s.field).maxRows)).filter((n) => Number.isFinite(n) && n > 0);
+		return caps.length ? Math.min(...caps) : BROWSER_SORT_MAX_ROWS;
+	}
+	/** A row's matches for `selector` reduced to one sortable value. */
+	function browserSortValue(row, selector, aggregate) {
+		const raw = getFieldValue(row, selector);
+		if (!aggregate) return raw;
+		const list = Array.isArray(raw) ? raw : raw == null ? [] : [raw];
+		if (aggregate === "count") return list.length;
+		const nums = list.map(Number).filter((n) => Number.isFinite(n));
+		if (!nums.length) return aggregate === "sum" ? 0 : null;
+		if (aggregate === "min") return Math.min(...nums);
+		if (aggregate === "max") return Math.max(...nums);
+		const sum = nums.reduce((a, b) => a + b, 0);
+		return aggregate === "avg" ? sum / nums.length : sum;
+	}
+	/** Empties last in either direction; numbers numerically; text numeric-aware. */
+	function compareBrowserValues(a, b) {
+		const ea = a == null || a === "";
+		const eb = b == null || b === "";
+		if (ea || eb) return ea === eb ? 0 : ea ? 1 : -1;
+		if (typeof a === "number" && typeof b === "number") return a - b;
+		if (a instanceof Date && b instanceof Date) return a.getTime() - b.getTime();
+		return String(a).localeCompare(String(b), void 0, { numeric: true });
+	}
+	/** Every matching row, sorted by the active keys (stable). */
+	function sortBrowserRows(rows) {
+		const keys = browserSortKeys() ?? [];
+		const decorated = rows.map((row, i) => ({
+			row,
+			i,
+			v: keys.map((k) => browserSortValue(row, k.selector, k.aggregate))
+		}));
+		decorated.sort((x, y) => {
+			for (let k = 0; k < keys.length; k++) {
+				const ex = x.v[k] == null || x.v[k] === "";
+				const ey = y.v[k] == null || y.v[k] === "";
+				const c = compareBrowserValues(x.v[k], y.v[k]);
+				if (c) return ex || ey ? c : keys[k].desc ? -c : c;
+			}
+			return x.i - y.i;
+		});
+		return decorated.map((d) => d.row);
+	}
+	/** Too many rows to sort in the browser: drop those keys, warn, load normally. */
+	async function refuseBrowserSort(count, cap) {
+		const fields = ctrl.sorts.filter((s) => isBrowserSortKey(s.field)).map((s) => s.field);
+		console.warn(`[monoDataGrid] sort: "${fields.join("\", \"")}" sorts in the browser and needs every row, but ${count} match (maxRows ${cap}) — sort cleared.`);
+		ctrl.sorts = ctrl.sorts.filter((s) => !isBrowserSortKey(s.field));
+		syncPrimarySort();
+		browserRows = null;
+		applySourceSort();
+		notify();
+		await load();
+	}
+	/** Read every matching row, sort it in memory, show the first page. */
+	async function loadBrowserSorted() {
+		const s = bound;
+		if (!s) return;
+		const cap = browserSortCap();
+		const known = s.totalCount?.();
+		if (typeof known === "number" && known > cap) {
+			await refuseBrowserSort(known, cap);
+			return;
+		}
+		if (!browserPageSize) browserPageSize = Math.max(1, s.pageSize?.() || ctrl.pageSize || 20);
+		ctrl.loading = true;
+		notify();
+		let rows = [];
+		try {
+			await runLoad(async () => {
+				rows = await readAllFromSource();
+			});
+		} finally {
+			ctrl.loading = false;
+		}
+		if (rows.length > cap) {
+			await refuseBrowserSort(rows.length, cap);
+			return;
+		}
+		browserRows = sortBrowserRows(rows);
+		browserPageIndex = 0;
+		sync();
+		recomputeSummaries();
+	}
+	/** Map the in-memory sorted rows (current page, or all) onto `ctrl`. */
+	function syncBrowser() {
+		const rows = browserRows ?? [];
+		const size = pageSizeAll ? Math.max(1, rows.length) : Math.max(1, browserPageSize);
+		const pageCount = Math.max(1, Math.ceil(rows.length / size));
+		browserPageIndex = Math.min(Math.max(0, browserPageIndex), pageCount - 1);
+		const start = browserPageIndex * size;
+		ctrl.grouped = false;
+		ctrl.items = rows.slice(start, start + size);
+		ctrl.pageIndex = browserPageIndex;
+		ctrl.pageSize = size;
+		ctrl.pageSizeAll = pageSizeAll;
+		ctrl.totalCount = rows.length;
+		ctrl.pageCount = pageCount;
+		render();
+	}
 	/** Scroll modes only apply to a flat (ungrouped, non-server) grid. */
 	function scrollActive() {
 		return scrollMode !== "off" && !isGrouped() && !serverMode();
@@ -3786,6 +3943,41 @@ function monoDataGrid(ds = null, opts = {}) {
 		});
 		ctrl.sorts = marked.map((m) => m.s);
 	}
+	/**
+	* The source selector a column DECLARED via `sort.selector`, if any — what the
+	* DataSource / array source orders by in place of the field. Resolved like
+	* `declaredSortIndex`: central `props.th` config first, then the element's own
+	* `:sort.prop`. A blank string counts as not declared.
+	*/
+	function declaredSortSelector(field) {
+		const sel = declaredSortConfig(field).selector;
+		return typeof sel === "string" && sel.trim() ? sel.trim() : void 0;
+	}
+	/**
+	* A column's declared sort OBJECT — the element's `:sort.prop` with central
+	* `props.th` config merged over it (props win key by key, as everywhere). `{}`
+	* for `sort: true` / no config.
+	*/
+	function declaredSortConfig(field) {
+		const asObj = (sort) => typeof sort === "object" && sort ? sort : {};
+		let fromEl = {};
+		for (const el of columnEls) if (el.field === field && typeof el.sort === "object" && el.sort) {
+			fromEl = asObj(el.sort);
+			break;
+		}
+		return {
+			...fromEl,
+			...asObj((elementProps.th ?? []).find((c) => c?.field === field)?.sort)
+		};
+	}
+	/**
+	* Whether a sorted column is sorted IN THE BROWSER — its selector fans out over a
+	* collection (`[*]`, which no source can order by) or it declares an `aggregate`.
+	*/
+	function isBrowserSortKey(field) {
+		const sel = declaredSortSelector(field);
+		return !!sel && parseFieldPath(sel).hasWildcard || !!declaredSortConfig(field).aggregate;
+	}
 	/** Keep the single-value mirrors pointing at the primary key. */
 	function syncPrimarySort() {
 		ctrl.sortField = ctrl.sorts[0]?.field ?? null;
@@ -3974,6 +4166,11 @@ function monoDataGrid(ds = null, opts = {}) {
 	* see the intermediate full-list state.
 	*/
 	async function getData() {
+		if (browserRows && browserSortActive()) return [...browserRows];
+		return readAllFromSource();
+	}
+	/** `getData`'s read — every matching row from the source, in its own order. */
+	async function readAllFromSource() {
 		const s = bound;
 		if (!s) return [];
 		const loadOptions = {};

package/dist/{mono-data-grid-Bb00QM72.js → mono-data-grid-llJCX9MC.js}

@@ -445,6 +445,9 @@ function monoDataGrid(ds = null, opts = {}) {
 	const chunkSize = Math.max(1, opts.chunkSize ?? 100);
 	let suppressSync = false;
 	let allRows = [];
+	let browserRows = null;
+	let browserPageIndex = 0;
+	let browserPageSize = 0;
 	let scrollMode = "off";
 	let accumulated = [];
 	let scrollNextPage = 0;
@@ -2148,16 +2151,21 @@ function monoDataGrid(ds = null, opts = {}) {
 	* column sort follows — applied to the group field itself if it is one.
 	*/
 	function effectiveSort() {
-		const keys = ctrl.sorts.map((s) => ({
-			selector: s.field,
+		const keys = ctrl.sorts.filter((s) => !isBrowserSortKey(s.field)).map((s) => ({
+			field: s.field,
+			selector: declaredSortSelector(s.field) ?? s.field,
 			desc: s.order === "desc"
 		}));
-		if (!groupFields.length) return keys.length ? keys : null;
+		const entry = (k) => ({
+			selector: k.selector,
+			desc: k.desc
+		});
+		if (!groupFields.length) return keys.length ? keys.map(entry) : null;
 		const list = groupFields.map((f) => ({
 			selector: f,
-			desc: keys.find((k) => k.selector === f)?.desc ?? false
+			desc: keys.find((k) => k.field === f)?.desc ?? false
 		}));
-		for (const k of keys) if (!groupFields.includes(k.selector)) list.push(k);
+		for (const k of keys) if (!groupFields.includes(k.field)) list.push(entry(k));
 		return list;
 	}
 	/**
@@ -2572,6 +2580,10 @@ function monoDataGrid(ds = null, opts = {}) {
 			syncScroll();
 			return;
 		}
+		if (browserRows && browserSortActive()) {
+			syncBrowser();
+			return;
+		}
 		if (pageSizeAll) {
 			ctrl.grouped = false;
 			ctrl.items = allRows;
@@ -2735,6 +2747,11 @@ function monoDataGrid(ds = null, opts = {}) {
 			await loadScrollPage(true);
 			return;
 		}
+		if (browserSortActive()) {
+			await loadBrowserSorted();
+			return;
+		}
+		browserRows = null;
 		if (pageSizeAll && !isGrouped()) {
 			await loadAllChunked();
 			return;
@@ -2756,6 +2773,11 @@ function monoDataGrid(ds = null, opts = {}) {
 			await loadScrollPage(true);
 			return;
 		}
+		if (browserSortActive()) {
+			await loadBrowserSorted();
+			return;
+		}
+		browserRows = null;
 		if (pageSizeAll && !isGrouped()) {
 			await loadAllChunked();
 			return;
@@ -2792,6 +2814,11 @@ function monoDataGrid(ds = null, opts = {}) {
 			if (serverMode()) await fetchVisibleRows();
 			return;
 		}
+		if (browserRows && browserSortActive()) {
+			browserPageIndex = Math.max(0, pageIndex);
+			syncBrowser();
+			return;
+		}
 		const s = bound;
 		if (!s) return;
 		s.pageIndex?.(Math.max(0, pageIndex));
@@ -2809,6 +2836,15 @@ function monoDataGrid(ds = null, opts = {}) {
 		}
 		const s = bound;
 		if (!s) return;
+		if (browserRows && browserSortActive()) {
+			if (!all) {
+				browserPageSize = Math.max(1, pageSize);
+				s.pageSize?.(browserPageSize);
+			}
+			browserPageIndex = 0;
+			syncBrowser();
+			return;
+		}
 		if (all) {
 			await loadAllChunked();
 			return;
@@ -2855,6 +2891,127 @@ function monoDataGrid(ds = null, opts = {}) {
 		ctrl.loading = bound?.isLoading?.() ?? false;
 		sync();
 	}
+	const BROWSER_SORT_MAX_ROWS = 5e3;
+	/** The active sort keys when ANY of them sorts in the browser, else `null`. */
+	function browserSortKeys() {
+		if (!ctrl.sorts.some((s) => isBrowserSortKey(s.field))) return null;
+		return ctrl.sorts.map((s) => {
+			const browser = isBrowserSortKey(s.field);
+			return {
+				field: s.field,
+				selector: declaredSortSelector(s.field) ?? s.field,
+				desc: s.order === "desc",
+				aggregate: browser ? declaredSortConfig(s.field).aggregate ?? "sum" : null
+			};
+		});
+	}
+	/** Browser sort applies: a browser-sorted column is active on a flat, paged, bound table. */
+	function browserSortActive() {
+		return !!bound && !isGrouped() && !serverMode() && !scrollActive() && !!browserSortKeys();
+	}
+	/** The smallest `maxRows` any active browser-sorted column declares (default 5000). */
+	function browserSortCap() {
+		const caps = ctrl.sorts.filter((s) => isBrowserSortKey(s.field)).map((s) => Number(declaredSortConfig(s.field).maxRows)).filter((n) => Number.isFinite(n) && n > 0);
+		return caps.length ? Math.min(...caps) : BROWSER_SORT_MAX_ROWS;
+	}
+	/** A row's matches for `selector` reduced to one sortable value. */
+	function browserSortValue(row, selector, aggregate) {
+		const raw = getFieldValue(row, selector);
+		if (!aggregate) return raw;
+		const list = Array.isArray(raw) ? raw : raw == null ? [] : [raw];
+		if (aggregate === "count") return list.length;
+		const nums = list.map(Number).filter((n) => Number.isFinite(n));
+		if (!nums.length) return aggregate === "sum" ? 0 : null;
+		if (aggregate === "min") return Math.min(...nums);
+		if (aggregate === "max") return Math.max(...nums);
+		const sum = nums.reduce((a, b) => a + b, 0);
+		return aggregate === "avg" ? sum / nums.length : sum;
+	}
+	/** Empties last in either direction; numbers numerically; text numeric-aware. */
+	function compareBrowserValues(a, b) {
+		const ea = a == null || a === "";
+		const eb = b == null || b === "";
+		if (ea || eb) return ea === eb ? 0 : ea ? 1 : -1;
+		if (typeof a === "number" && typeof b === "number") return a - b;
+		if (a instanceof Date && b instanceof Date) return a.getTime() - b.getTime();
+		return String(a).localeCompare(String(b), void 0, { numeric: true });
+	}
+	/** Every matching row, sorted by the active keys (stable). */
+	function sortBrowserRows(rows) {
+		const keys = browserSortKeys() ?? [];
+		const decorated = rows.map((row, i) => ({
+			row,
+			i,
+			v: keys.map((k) => browserSortValue(row, k.selector, k.aggregate))
+		}));
+		decorated.sort((x, y) => {
+			for (let k = 0; k < keys.length; k++) {
+				const ex = x.v[k] == null || x.v[k] === "";
+				const ey = y.v[k] == null || y.v[k] === "";
+				const c = compareBrowserValues(x.v[k], y.v[k]);
+				if (c) return ex || ey ? c : keys[k].desc ? -c : c;
+			}
+			return x.i - y.i;
+		});
+		return decorated.map((d) => d.row);
+	}
+	/** Too many rows to sort in the browser: drop those keys, warn, load normally. */
+	async function refuseBrowserSort(count, cap) {
+		const fields = ctrl.sorts.filter((s) => isBrowserSortKey(s.field)).map((s) => s.field);
+		console.warn(`[monoDataGrid] sort: "${fields.join("\", \"")}" sorts in the browser and needs every row, but ${count} match (maxRows ${cap}) — sort cleared.`);
+		ctrl.sorts = ctrl.sorts.filter((s) => !isBrowserSortKey(s.field));
+		syncPrimarySort();
+		browserRows = null;
+		applySourceSort();
+		notify();
+		await load();
+	}
+	/** Read every matching row, sort it in memory, show the first page. */
+	async function loadBrowserSorted() {
+		const s = bound;
+		if (!s) return;
+		const cap = browserSortCap();
+		const known = s.totalCount?.();
+		if (typeof known === "number" && known > cap) {
+			await refuseBrowserSort(known, cap);
+			return;
+		}
+		if (!browserPageSize) browserPageSize = Math.max(1, s.pageSize?.() || ctrl.pageSize || 20);
+		ctrl.loading = true;
+		notify();
+		let rows = [];
+		try {
+			await runLoad(async () => {
+				rows = await readAllFromSource();
+			});
+		} finally {
+			ctrl.loading = false;
+		}
+		if (rows.length > cap) {
+			await refuseBrowserSort(rows.length, cap);
+			return;
+		}
+		browserRows = sortBrowserRows(rows);
+		browserPageIndex = 0;
+		sync();
+		recomputeSummaries();
+	}
+	/** Map the in-memory sorted rows (current page, or all) onto `ctrl`. */
+	function syncBrowser() {
+		const rows = browserRows ?? [];
+		const size = pageSizeAll ? Math.max(1, rows.length) : Math.max(1, browserPageSize);
+		const pageCount = Math.max(1, Math.ceil(rows.length / size));
+		browserPageIndex = Math.min(Math.max(0, browserPageIndex), pageCount - 1);
+		const start = browserPageIndex * size;
+		ctrl.grouped = false;
+		ctrl.items = rows.slice(start, start + size);
+		ctrl.pageIndex = browserPageIndex;
+		ctrl.pageSize = size;
+		ctrl.pageSizeAll = pageSizeAll;
+		ctrl.totalCount = rows.length;
+		ctrl.pageCount = pageCount;
+		render();
+	}
 	/** Scroll modes only apply to a flat (ungrouped, non-server) grid. */
 	function scrollActive() {
 		return scrollMode !== "off" && !isGrouped() && !serverMode();
@@ -3787,6 +3944,41 @@ function monoDataGrid(ds = null, opts = {}) {
 		});
 		ctrl.sorts = marked.map((m) => m.s);
 	}
+	/**
+	* The source selector a column DECLARED via `sort.selector`, if any — what the
+	* DataSource / array source orders by in place of the field. Resolved like
+	* `declaredSortIndex`: central `props.th` config first, then the element's own
+	* `:sort.prop`. A blank string counts as not declared.
+	*/
+	function declaredSortSelector(field) {
+		const sel = declaredSortConfig(field).selector;
+		return typeof sel === "string" && sel.trim() ? sel.trim() : void 0;
+	}
+	/**
+	* A column's declared sort OBJECT — the element's `:sort.prop` with central
+	* `props.th` config merged over it (props win key by key, as everywhere). `{}`
+	* for `sort: true` / no config.
+	*/
+	function declaredSortConfig(field) {
+		const asObj = (sort) => typeof sort === "object" && sort ? sort : {};
+		let fromEl = {};
+		for (const el of columnEls) if (el.field === field && typeof el.sort === "object" && el.sort) {
+			fromEl = asObj(el.sort);
+			break;
+		}
+		return {
+			...fromEl,
+			...asObj((elementProps.th ?? []).find((c) => c?.field === field)?.sort)
+		};
+	}
+	/**
+	* Whether a sorted column is sorted IN THE BROWSER — its selector fans out over a
+	* collection (`[*]`, which no source can order by) or it declares an `aggregate`.
+	*/
+	function isBrowserSortKey(field) {
+		const sel = declaredSortSelector(field);
+		return !!sel && parseFieldPath(sel).hasWildcard || !!declaredSortConfig(field).aggregate;
+	}
 	/** Keep the single-value mirrors pointing at the primary key. */
 	function syncPrimarySort() {
 		ctrl.sortField = ctrl.sorts[0]?.field ?? null;
@@ -3975,6 +4167,11 @@ function monoDataGrid(ds = null, opts = {}) {
 	* see the intermediate full-list state.
 	*/
 	async function getData() {
+		if (browserRows && browserSortActive()) return [...browserRows];
+		return readAllFromSource();
+	}
+	/** `getData`'s read — every matching row from the source, in its own order. */
+	async function readAllFromSource() {
 		const s = bound;
 		if (!s) return [];
 		const loadOptions = {};

package/dist/src/components/table/mono-data-grid.d.ts

@@ -110,6 +110,8 @@ export interface MonoSetSortOptions {
    */
   sticky?: boolean;
 }
+/** How a browser-sorted column reduces a row's `[*]` matches — see `MonoColumnSort.aggregate`. */
+export type MonoSortAggregate = 'sum' | 'min' | 'max' | 'avg' | 'count';
 export interface MonoColumnSort {
   /**
    * Whether the column is sortable at all. Defaults to `true` when a `sort` object
@@ -138,6 +140,40 @@ export interface MonoColumnSort {
   index?: number;
   /** Cycle `asc ↔ desc` only (never clears). */
   noClear?: boolean;
+  /**
+   * What the SOURCE sorts by when this column is sorted — instead of the column's
+   * `field`. The column keeps its identity (`field`: the arrow, precedence badge,
+   * `sorts`, `setSort(field)` and the header menu all still name it); only the
+   * selector handed to the DataSource / array source changes.
+   *
+   * For a column whose `field` is not a property the server knows — a value
+   * derived in the browser (`_Total`), or one whose display field differs from
+   * the one to order by — point it at one that is: a plain property
+   * (`'TotalBudget'`) or a navigation path (`'Brand.Nama'` → `$orderby=Brand/Nama`
+   * on a remote source, resolved per row on an array source).
+   *
+   * A plain selector must be something the source can order by. A selector with a
+   * `[*]` WILDCARD — `'Lines.[*].Amount'` — is the one OData cannot (no `$orderby`
+   * over a child collection), so it is sorted IN THE BROWSER instead: while such a
+   * column is sorted, the grid reads every row the current filter / search matches
+   * (with the source's `expand`), reduces each row's matches with `aggregate`
+   * (default `'sum'`), sorts, and pages in memory — see `aggregate` / `maxRows`.
+   * Flat paged tables only (not grouped, not scroll modes).
+   */
+  selector?: string;
+  /**
+   * How a browser-sorted column (a `[*]` `selector`, or any `selector` when this
+   * is set) reduces a row's matches to the value it sorts by. Default `'sum'`.
+   * Non-numeric matches are skipped by `sum` / `min` / `max` / `avg`; `count`
+   * counts every match.
+   */
+  aggregate?: MonoSortAggregate;
+  /**
+   * Browser-sorted columns only: the most rows the grid will read to sort. Above
+   * it the sort is refused (cleared, with a console warning) instead of pulling
+   * the whole table. Default `5000`.
+   */
+  maxRows?: number;
   /** Sortable UI is shown but inert. */
   disabled?: boolean;
   /**