@mono-lit/helper 0.0.7 → 0.0.9

package/dist/{data-source-options-CS0w0wlO.js → data-source-options-BM4r4PRw.js}

@@ -1,6 +1,6 @@
 import { n as isPath, r as mergePatch, t as getFieldValue } from "./field-path-BabiMrrA.js";
 import { D as compileFilterPredicate, E as andPredicates, T as andFilters, f as mergeSearchFields } from "./normalize-error-BmLbgANw.js";
-import { i as searchFilterOf, s as flattenLeaves, t as isDataSourceLike } from "./data-source-read-DTJ_Mnez.js";
+import { i as searchFilterOf, s as flattenLeaves, t as isDataSourceLike } from "./data-source-read-HyBCRg1t.js";
 import { t as resolveMaybeReactive } from "./reactive-Dtd-esHO.js";
 import { s as odataStringToArray, t as arrayToODataString } from "./filter-odata-Bi27XUpQ.js";
 

package/dist/{data-source-options-lDR-g9Eb.js → data-source-options-fxT5QIX4.js}

@@ -1,5 +1,5 @@
 import { n as isPath, r as mergePatch, t as getFieldValue } from "./field-path-BabiMrrA.js";
-import { i as searchFilterOf, s as flattenLeaves, t as isDataSourceLike } from "./data-source-read-Cp_h7NIf.js";
+import { i as searchFilterOf, s as flattenLeaves, t as isDataSourceLike } from "./data-source-read-BL266IW0.js";
 import { n as andPredicates, r as compileFilterPredicate, t as andFilters } from "./filter-eval-ChDSaAUH.js";
 import { h as mergeSearchFields } from "./normalize-error-D93O4q8g.js";
 import { t as resolveMaybeReactive } from "./reactive-Dtd-esHO.js";

package/dist/{data-source-read-Cp_h7NIf.js → data-source-read-BL266IW0.js}

@@ -98,6 +98,21 @@ function collectGroupPaths(nodes) {
 * the same DataSource is usually bound to a live grid, so paging state must
 * either be left alone (the store path) or restored exactly (the array path).
 */
+/**
+* Store-level load options a DataSource sends on every request that have no accessor and are not
+* composed by the drain itself (filter / search / sort / select are). Whitelisted, not copied
+* wholesale: `_storeLoadOptions` also carries `group`, paging and total-count state, which would
+* turn a flat chunked read into something else.
+*/
+const INHERITED_LOAD_OPTIONS = ["expand", "customQueryParams"];
+/** The {@link INHERITED_LOAD_OPTIONS} the source currently carries. */
+function inheritedLoadOptionsOf(source) {
+	const lo = typeof source.loadOptions === "function" ? source.loadOptions() : null;
+	const out = {};
+	if (!lo || typeof lo !== "object") return out;
+	for (const k of INHERITED_LOAD_OPTIONS) if (lo[k] !== void 0 && lo[k] !== null) out[k] = lo[k];
+	return out;
+}
 /** Stop runaway loops if a backend keeps returning full chunks forever. */
 const MAX_SKIP = 1e7;
 /** A devextreme DataSource: it both loads and holds a current page. */
@@ -162,12 +177,16 @@ async function readAllRows(source, options = {}) {
 			const filter = andFilters(andFilters(src.filter?.() ?? null, searchFilterOf(src) ?? null), options.filter ?? null);
 			const sort = options.sort ?? src.sort?.() ?? null;
 			const select = options.select ?? src.select?.() ?? null;
+			const loadOptions = {
+				...inheritedLoadOptionsOf(src),
+				...options.loadOptions ?? {}
+			};
 			return drainStore(store, {
 				chunkSize,
 				...select ? { select } : {},
 				...filter ? { filter } : {},
 				...sort ? { sort } : {},
-				...options.loadOptions ? { loadOptions: options.loadOptions } : {}
+				...Object.keys(loadOptions).length ? { loadOptions } : {}
 			});
 		}
 		return readArrayDataSource(src);

package/dist/{data-source-read-DTJ_Mnez.js → data-source-read-HyBCRg1t.js}

@@ -98,6 +98,21 @@ function collectGroupPaths(nodes) {
 * the same DataSource is usually bound to a live grid, so paging state must
 * either be left alone (the store path) or restored exactly (the array path).
 */
+/**
+* Store-level load options a DataSource sends on every request that have no accessor and are not
+* composed by the drain itself (filter / search / sort / select are). Whitelisted, not copied
+* wholesale: `_storeLoadOptions` also carries `group`, paging and total-count state, which would
+* turn a flat chunked read into something else.
+*/
+const INHERITED_LOAD_OPTIONS = ["expand", "customQueryParams"];
+/** The {@link INHERITED_LOAD_OPTIONS} the source currently carries. */
+function inheritedLoadOptionsOf(source) {
+	const lo = typeof source.loadOptions === "function" ? source.loadOptions() : null;
+	const out = {};
+	if (!lo || typeof lo !== "object") return out;
+	for (const k of INHERITED_LOAD_OPTIONS) if (lo[k] !== void 0 && lo[k] !== null) out[k] = lo[k];
+	return out;
+}
 /** Stop runaway loops if a backend keeps returning full chunks forever. */
 const MAX_SKIP = 1e7;
 /** A devextreme DataSource: it both loads and holds a current page. */
@@ -162,12 +177,16 @@ async function readAllRows(source, options = {}) {
 			const filter = andFilters(andFilters(src.filter?.() ?? null, searchFilterOf(src) ?? null), options.filter ?? null);
 			const sort = options.sort ?? src.sort?.() ?? null;
 			const select = options.select ?? src.select?.() ?? null;
+			const loadOptions = {
+				...inheritedLoadOptionsOf(src),
+				...options.loadOptions ?? {}
+			};
 			return drainStore(store, {
 				chunkSize,
 				...select ? { select } : {},
 				...filter ? { filter } : {},
 				...sort ? { sort } : {},
-				...options.loadOptions ? { loadOptions: options.loadOptions } : {}
+				...Object.keys(loadOptions).length ? { loadOptions } : {}
 			});
 		}
 		return readArrayDataSource(src);

package/dist/{export-D27RJa1w.js → export-ixRdCS2y.js}

@@ -1,5 +1,5 @@
 import { a as stripDirectives, i as escapeCellText, n as parseMarkdown, o as __commonJSMin, r as encodeDirective, s as __toESM } from "./markdown-uGlE_OfJ.js";
-import { n as isReadableSource, r as readAllRows } from "./data-source-read-DTJ_Mnez.js";
+import { n as isReadableSource, r as readAllRows } from "./data-source-read-HyBCRg1t.js";
 import { n as unwrapReactive } from "./reactive-Dtd-esHO.js";
 import { t as DEFAULT_STYLES } from "./excel-BXzr3uI1.js";
 

package/dist/export.js

@@ -1,5 +1,5 @@
 import { c as escapeCellText, d as __toESM, l as stripDirectives, o as parseMarkdown, s as encodeDirective, t as DEFAULT_STYLES, u as __commonJSMin } from "./styles-D-ergrfR.js";
-import { n as isReadableSource, r as readAllRows } from "./data-source-read-Cp_h7NIf.js";
+import { n as isReadableSource, r as readAllRows } from "./data-source-read-BL266IW0.js";
 import { n as unwrapReactive } from "./reactive-Dtd-esHO.js";
 
 //#region src/export/download.ts

package/dist/index.js

@@ -1,18 +1,18 @@
 import { a as parseFieldPath, c as toODataClause, l as toODataSelector, n as isPath, r as mergePatch, s as setFieldValue, t as getFieldValue } from "./field-path-BabiMrrA.js";
-import { a as buildGroups, c as isGroupNode, o as collectGroupPaths, s as flattenLeaves } from "./data-source-read-Cp_h7NIf.js";
+import { a as buildGroups, c as isGroupNode, o as collectGroupPaths, s as flattenLeaves } from "./data-source-read-BL266IW0.js";
 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-lDR-g9Eb.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-kV4jYu2g.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-BAH9Zb3p.js";
-import { t as monoDataDropdown } from "./mono-data-dropdown-BsY5IuIo.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-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-Mg0Snp0t.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-Mg0Snp0t.js → index.node-DTqDBca7.js}

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

package/dist/index.node.js

@@ -1,18 +1,18 @@
 import { a as parseFieldPath, c as toODataClause, l as toODataSelector, n as isPath, r as mergePatch, s as setFieldValue, t as getFieldValue } from "./field-path-BabiMrrA.js";
-import { a as buildGroups, c as isGroupNode, o as collectGroupPaths, s as flattenLeaves } from "./data-source-read-Cp_h7NIf.js";
+import { a as buildGroups, c as isGroupNode, o as collectGroupPaths, s as flattenLeaves } from "./data-source-read-BL266IW0.js";
 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-lDR-g9Eb.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-kV4jYu2g.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-BAH9Zb3p.js";
-import { t as monoDataDropdown } from "./mono-data-dropdown-BsY5IuIo.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-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-Mg0Snp0t.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-chart-BAH9Zb3p.js → mono-data-chart-NKPdAgVq.js}

@@ -1,8 +1,8 @@
 import { n as isPath, t as getFieldValue } from "./field-path-BabiMrrA.js";
-import { r as readAllRows } from "./data-source-read-Cp_h7NIf.js";
+import { r as readAllRows } from "./data-source-read-BL266IW0.js";
 import { n as andPredicates, r as compileFilterPredicate, t as andFilters } from "./filter-eval-ChDSaAUH.js";
 import { n as describeError, o as isCanceled } from "./normalize-error-D93O4q8g.js";
-import { a as resolveDataSourceOptions, d as createApplyGate, f as isRolledUp, h as monoArraySource, i as normalizeSortList, n as extraLoadOptions, o as toList, p as loadApply, r as mergeDataSourceOptions, u as summaryFilterOf } from "./data-source-options-lDR-g9Eb.js";
+import { a as resolveDataSourceOptions, d as createApplyGate, f as isRolledUp, h as monoArraySource, i as normalizeSortList, n as extraLoadOptions, o as toList, p as loadApply, r as mergeDataSourceOptions, u as summaryFilterOf } from "./data-source-options-fxT5QIX4.js";
 import { t as arrayToODataString } from "./filter-odata-Bi27XUpQ.js";
 import { t as createNotifier } from "./notifier-BIrqUzRh.js";
 

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

@@ -1,4 +1,4 @@
-import { t as monoDataGrid } from "./mono-data-grid-kV4jYu2g.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-CZFjpnOD.js → mono-data-grid-e9ZVBlNN.js}

@@ -1,8 +1,8 @@
 import { t as createNotifier } from "./notifier-BIrqUzRh.js";
 import { a as parseFieldPath, c as toODataClause, l as toODataSelector, n as isPath, o as projectFields, r as mergePatch, s as setFieldValue, t as getFieldValue } from "./field-path-BabiMrrA.js";
 import { C as resolveSearchEntries, D as compileFilterPredicate, E as andPredicates, O as joinFilters, S as plainSearchColumns, T as andFilters, f as mergeSearchFields, g as customRemoteClause, h as customPredicate, n as describeError, o as isCanceled, u as DEFAULT_SEARCH_FIELDS, v as hasCustomSearch, w as searchEntryFor, y as hasWildcardSearch } from "./normalize-error-BmLbgANw.js";
-import { a as buildGroups, c as isGroupNode, i as searchFilterOf, o as collectGroupPaths, r as readAllRows, s as flattenLeaves } from "./data-source-read-DTJ_Mnez.js";
-import { a as resolveDataSourceOptions, c as composeSummaryApply, d as createApplyGate, f as isRolledUp, h as monoArraySource, i as normalizeSortList, l as summaryAliases, m as storeRows, n as extraLoadOptions, o as toList, p as loadApply, s as buildSummaryApply, t as dataSourceOptionsKey, u as summaryFilterOf } from "./data-source-options-CS0w0wlO.js";
+import { a as buildGroups, c as isGroupNode, i as searchFilterOf, o as collectGroupPaths, r as readAllRows, s as flattenLeaves } from "./data-source-read-HyBCRg1t.js";
+import { a as resolveDataSourceOptions, c as composeSummaryApply, d as createApplyGate, f as isRolledUp, h as monoArraySource, i as normalizeSortList, l as summaryAliases, m as storeRows, n as extraLoadOptions, o as toList, p as loadApply, s as buildSummaryApply, t as dataSourceOptionsKey, u as summaryFilterOf } from "./data-source-options-BM4r4PRw.js";
 import { n as unwrapReactive } from "./reactive-Dtd-esHO.js";
 import { t as arrayToODataString } from "./filter-odata-Bi27XUpQ.js";
 import { t as monoFilterBuilder } from "./filter-builder-B6Y2mmbM.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,14 +4166,23 @@ 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 = {};
+		if (resolvedOpts.expand !== void 0) loadOptions.expand = resolvedOpts.expand;
+		if (resolvedOpts.customQueryParams !== void 0) loadOptions.customQueryParams = resolvedOpts.customQueryParams;
 		suppressSync = true;
 		try {
 			return await readAllRows(s, {
 				chunkSize,
 				select: opts.select ?? toList(resolvedOpts.select),
-				sort: mergedSort()
+				sort: mergedSort(),
+				...Object.keys(loadOptions).length ? { loadOptions } : {}
 			});
 		} finally {
 			suppressSync = false;
@@ -4015,7 +4216,7 @@ function monoDataGrid(ds = null, opts = {}) {
 		});
 	}
 	async function exportReport(options) {
-		const { exportTable } = await import("./export-D27RJa1w.js");
+		const { exportTable } = await import("./export-ixRdCS2y.js");
 		return exportTable(options);
 	}
 	function subscribe(cb) {