@revolist/revogrid 4.22.1 → 4.23.0

package/dist/esm/{column.drag.plugin-Dy5ztusn.js → column.drag.plugin-BsfhsfmB.js}

@@ -1,14 +1,30 @@
 /*!
  * Built by Revolist OU ❤️
  */
-import { J as reduce, g as getRange, K as baseEach, C as getColumnType, c as columnTypes, L as toInteger, u as isGrouping, t as getGroupingName, r as rowTypes, B as getCellDataParsed, A as getCellRaw, I as getColumnByProp, h as GROUP_EXPANDED, x as getParsedGroup, y as isSameGroup, G as GROUP_DEPTH, e as PSEUDO_GROUP_ITEM_VALUE, d as PSEUDO_GROUP_ITEM_ID, o as GROUPING_ROW_TYPE, p as getSource, f as PSEUDO_GROUP_COLUMN, s as gatherGrouping, m as GROUP_EXPAND_EVENT, v as isGroupingColumn, q as getExpanded, E as isColGrouping } from './column.service-CCvAi5l4.js';
-import { W as createStore, w as setStore, i as calculateDimensionData, X as identity, Y as isArray, b as getSourceItem, o as getScrollbarSize, u as timeout, Z as baseProperty, _ as isArrayLike, $ as getTag, a0 as baseKeys, g as getPhysical, e as setItems, j as getItemByPosition } from './dimension.helpers-DmIvjIa7.js';
-import { f as calculateRowHeaderSize } from './viewport.store-CFjDW-3l.js';
+import { J as reduce, g as getRange, K as baseEach, C as getColumnType, c as columnTypes, L as toInteger, u as isGrouping, t as getGroupingName, r as rowTypes, B as getCellDataParsed, A as getCellRaw, j as GROUP_COLUMN_PROP, I as getColumnByProp, h as GROUP_EXPANDED, x as getParsedGroup, y as isSameGroup, G as GROUP_DEPTH, e as PSEUDO_GROUP_ITEM_VALUE, d as PSEUDO_GROUP_ITEM_ID, o as GROUPING_ROW_TYPE, p as getSource, f as PSEUDO_GROUP_COLUMN, s as gatherGrouping, m as GROUP_EXPAND_EVENT, v as isGroupingColumn, q as getExpanded, E as isColGrouping } from './column.service-DbpulTog.js';
+import { K as createStore, l as setStore, i as calculateDimensionData, L as identity, N as isArray, b as getSourceItem, g as getPhysical, e as setItems, j as getItemByPosition } from './dimension.helpers-CGKwSvw6.js';
+import { j as calculateRowHeaderSize } from './viewport.store-COAfzAyu.js';
+import { g as getScrollbarSize, t as timeout } from './index-Db3qZoW5.js';
 import { h } from './index-Chp_81rd.js';
 import { b as FILTER_PROP, i as isFilterBtn } from './filter.button-C8XTWPU2.js';
-import { i as isObjectLike, b as baseGetTag, d as debounce } from './debounce-BfO9dz9v.js';
-import { O as ON_COLUMN_CLICK, d as dispatch } from './header-cell-renderer-DU8wKAbg.js';
+import { d as debounce } from './debounce-PCRWZliA.js';
+import { O as ON_COLUMN_CLICK, d as dispatch } from './header-cell-renderer-DGI2FAD8.js';
 
+function calculateRealSize({ count, originItemSize, sizes, }) {
+    const safeCount = Math.max(0, count);
+    let realSize = safeCount * originItemSize;
+    for (let index in sizes) {
+        const itemIndex = Number(index);
+        if (!Number.isInteger(itemIndex) ||
+            itemIndex < 0 ||
+            itemIndex >= safeCount ||
+            String(itemIndex) !== index) {
+            continue;
+        }
+        realSize += sizes[index] - originItemSize;
+    }
+    return realSize;
+}
 /**
  * Plugin which recalculates realSize on changes of sizes, originItemSize and count
  */
@@ -21,20 +37,18 @@ const recalculateRealSizePlugin = (storeService) => {
          * Reacts on changes of count, sizes and originItemSize
          */
         set(k) {
-            var _a;
             switch (k) {
                 case 'count':
                 case 'sizes':
                 case 'originItemSize': {
                     // recalculate realSize
-                    let realSize = 0;
-                    const count = storeService.store.get('count');
-                    const sizes = storeService.store.get('sizes');
-                    const originItemSize = storeService.store.get('originItemSize');
-                    for (let i = 0; i < count; i++) {
-                        realSize += (_a = sizes[i]) !== null && _a !== void 0 ? _a : originItemSize;
-                    }
-                    storeService.setStore({ realSize });
+                    storeService.setStore({
+                        realSize: calculateRealSize({
+                            count: storeService.store.get('count'),
+                            sizes: storeService.store.get('sizes'),
+                            originItemSize: storeService.store.get('originItemSize'),
+                        }),
+                    });
                     break;
                 }
             }
@@ -124,7 +138,9 @@ function initialState() {
         // size which all items can take
         realSize: 0,
         // initial item size if it wasn't changed
-        originItemSize: 0
+        originItemSize: 0,
+        // logical-to-physical render offset used when scroll space is compressed
+        renderOffset: 0
     });
 }
 class DimensionStore {
@@ -156,7 +172,7 @@ class DimensionStore {
         setStore(this.store, data);
     }
     drop() {
-        setStore(this.store, initialBase());
+        setStore(this.store, Object.assign(Object.assign({}, initialBase()), { renderOffset: 0 }));
     }
     /**
      * Set custom dimension sizes and overwrite old
@@ -1358,17 +1374,24 @@ class FilterPlugin extends BasePlugin {
             }
         }
         if (config.collection) {
-            const filtersWithFilterFunctionPresent = Object.entries(config.collection).filter(([, item]) => this.filterFunctionsIndexedByType[item.type]);
-            this.filterCollection = Object.fromEntries(filtersWithFilterFunctionPresent);
+            const filterCollection = {};
+            for (const prop of Object.keys(config.collection)) {
+                const item = config.collection[prop];
+                if (this.filterFunctionsIndexedByType[item.type]) {
+                    filterCollection[prop] = item;
+                }
+            }
+            this.filterCollection = filterCollection;
         }
         else {
             this.filterCollection = {};
         }
         if (config.localization) {
             if (config.localization.filterNames) {
-                Object.entries(config.localization.filterNames).forEach(([k, v]) => {
+                const filterNames = config.localization.filterNames;
+                Object.keys(filterNames).forEach((k) => {
                     if (this.filterNameIndexByType[k] != void 0) {
-                        this.filterNameIndexByType[k] = v;
+                        this.filterNameIndexByType[k] = filterNames[k];
                     }
                 });
             }
@@ -1598,165 +1621,174 @@ function allAndConditionsSatisfied(pendingResults) {
     return !pendingResults.includes(true);
 }
 
-/** `Object#toString` result references. */
-var stringTag = '[object String]';
-
 /**
- * Checks if `value` is classified as a `String` primitive or object.
- *
- * @static
- * @since 0.1.0
- * @memberOf _
- * @category Lang
- * @param {*} value The value to check.
- * @returns {boolean} Returns `true` if `value` is a string, else `false`.
- * @example
- *
- * _.isString('abc');
- * // => true
+ * Checks whether a sorting map contains at least one active order.
  *
- * _.isString(1);
- * // => false
+ * Empty maps and properties with `undefined` order are treated as inactive.
  */
-function isString(value) {
-  return typeof value == 'string' ||
-    (!isArray(value) && isObjectLike(value) && baseGetTag(value) == stringTag);
+function hasActiveSorting(sorting) {
+    for (const prop of Object.keys(sorting || {})) {
+        if (sorting === null || sorting === void 0 ? void 0 : sorting[prop]) {
+            return true;
+        }
+    }
+    return false;
 }
-
 /**
- * Gets the size of an ASCII `string`.
- *
- * @private
- * @param {string} string The string inspect.
- * @returns {number} Returns the string size.
+ * Compares column properties after object-key coercion.
  */
-var asciiSize = baseProperty('length');
-
-/** Used to compose unicode character classes. */
-var rsAstralRange$1 = '\\ud800-\\udfff',
-    rsComboMarksRange$1 = '\\u0300-\\u036f',
-    reComboHalfMarksRange$1 = '\\ufe20-\\ufe2f',
-    rsComboSymbolsRange$1 = '\\u20d0-\\u20ff',
-    rsComboRange$1 = rsComboMarksRange$1 + reComboHalfMarksRange$1 + rsComboSymbolsRange$1,
-    rsVarRange$1 = '\\ufe0e\\ufe0f';
-
-/** Used to compose unicode capture groups. */
-var rsZWJ$1 = '\\u200d';
-
-/** Used to detect strings with [zero-width joiners or code points from the astral planes](http://eev.ee/blog/2015/09/12/dark-corners-of-unicode/). */
-var reHasUnicode = RegExp('[' + rsZWJ$1 + rsAstralRange$1  + rsComboRange$1 + rsVarRange$1 + ']');
-
+function isSameColumnProp(a, b) {
+    return String(a) === String(b);
+}
 /**
- * Checks if `string` contains Unicode symbols.
- *
- * @private
- * @param {string} string The string to inspect.
- * @returns {boolean} Returns `true` if a symbol is found, else `false`.
+ * Returns active sorting properties in explicit priority order.
  */
-function hasUnicode(string) {
-  return reHasUnicode.test(string);
+function getActiveSortingProps(sorting, sortingOrder) {
+    const activeProps = [];
+    const add = (prop) => {
+        if ((sorting === null || sorting === void 0 ? void 0 : sorting[prop]) && !activeProps.some(active => isSameColumnProp(active, prop))) {
+            activeProps.push(prop);
+        }
+    };
+    sortingOrder === null || sortingOrder === void 0 ? void 0 : sortingOrder.forEach(add);
+    Object.keys(sorting || {}).forEach(add);
+    return activeProps;
 }
-
-/** Used to compose unicode character classes. */
-var rsAstralRange = '\\ud800-\\udfff',
-    rsComboMarksRange = '\\u0300-\\u036f',
-    reComboHalfMarksRange = '\\ufe20-\\ufe2f',
-    rsComboSymbolsRange = '\\u20d0-\\u20ff',
-    rsComboRange = rsComboMarksRange + reComboHalfMarksRange + rsComboSymbolsRange,
-    rsVarRange = '\\ufe0e\\ufe0f';
-
-/** Used to compose unicode capture groups. */
-var rsAstral = '[' + rsAstralRange + ']',
-    rsCombo = '[' + rsComboRange + ']',
-    rsFitz = '\\ud83c[\\udffb-\\udfff]',
-    rsModifier = '(?:' + rsCombo + '|' + rsFitz + ')',
-    rsNonAstral = '[^' + rsAstralRange + ']',
-    rsRegional = '(?:\\ud83c[\\udde6-\\uddff]){2}',
-    rsSurrPair = '[\\ud800-\\udbff][\\udc00-\\udfff]',
-    rsZWJ = '\\u200d';
-
-/** Used to compose unicode regexes. */
-var reOptMod = rsModifier + '?',
-    rsOptVar = '[' + rsVarRange + ']?',
-    rsOptJoin = '(?:' + rsZWJ + '(?:' + [rsNonAstral, rsRegional, rsSurrPair].join('|') + ')' + rsOptVar + reOptMod + ')*',
-    rsSeq = rsOptVar + reOptMod + rsOptJoin,
-    rsSymbol = '(?:' + [rsNonAstral + rsCombo + '?', rsCombo, rsRegional, rsSurrPair, rsAstral].join('|') + ')';
-
-/** Used to match [string symbols](https://mathiasbynens.be/notes/javascript-unicode). */
-var reUnicode = RegExp(rsFitz + '(?=' + rsFitz + ')|' + rsSymbol + rsSeq, 'g');
-
 /**
- * Gets the size of a Unicode `string`.
+ * Returns one-based additive sorting rank for a column.
  *
- * @private
- * @param {string} string The string inspect.
- * @returns {number} Returns the string size.
+ * A single active sort does not need a visible rank, so it returns undefined.
  */
-function unicodeSize(string) {
-  var result = reUnicode.lastIndex = 0;
-  while (reUnicode.test(string)) {
-    ++result;
-  }
-  return result;
+function getSortingIndex(sorting, prop, sortingOrder) {
+    const activeProps = getActiveSortingProps(sorting, sortingOrder);
+    if (activeProps.length <= 1) {
+        return undefined;
+    }
+    const index = activeProps.findIndex(active => isSameColumnProp(active, prop));
+    return index >= 0 ? index + 1 : undefined;
 }
-
 /**
- * Gets the number of symbols in `string`.
+ * Collects only active comparator functions from a sorting function map.
  *
- * @private
- * @param {string} string The string to inspect.
- * @returns {number} Returns the string size.
+ * This keeps undefined comparator entries from triggering sorting work.
+ */
+function activeSortingEntries(sortingFunc = {}, sortingOrder) {
+    const entries = [];
+    const add = (prop) => {
+        const cmp = sortingFunc[prop];
+        if (typeof cmp === 'function' && !entries.some(([active]) => isSameColumnProp(active, prop))) {
+            entries.push([prop, cmp]);
+        }
+    };
+    sortingOrder === null || sortingOrder === void 0 ? void 0 : sortingOrder.forEach(add);
+    Object.keys(sortingFunc).forEach(add);
+    return entries;
+}
+/**
+ * Reads and normalizes a value for the built-in default comparer.
  */
-function stringSize(string) {
-  return hasUnicode(string)
-    ? unicodeSize(string)
-    : asciiSize(string);
+function getDefaultCompareValue(item, prop, column) {
+    const aRaw = column ? getCellRaw(item, column) : item === null || item === void 0 ? void 0 : item[prop];
+    return typeof aRaw === 'number' ? aRaw : aRaw === null || aRaw === void 0 ? void 0 : aRaw.toString().toLowerCase();
+}
+function isEmptyCompareValue(value) {
+    return value === '' || value === null || value === undefined;
 }
-
-/** `Object#toString` result references. */
-var mapTag = '[object Map]',
-    setTag = '[object Set]';
-
 /**
- * Gets the size of `collection` by returning its length for array-like
- * values or the number of own enumerable string keyed properties for objects.
- *
- * @static
- * @memberOf _
- * @since 0.1.0
- * @category Collection
- * @param {Array|Object|string} collection The collection to inspect.
- * @returns {number} Returns the collection size.
- * @example
- *
- * _.size([1, 2, 3]);
- * // => 3
+ * Compares two already-normalized default comparer values.
+ */
+function compareValues(av, bv) {
+    if (av === bv) {
+        return 0;
+    }
+    const aEmpty = isEmptyCompareValue(av);
+    const bEmpty = isEmptyCompareValue(bv);
+    if (aEmpty || bEmpty) {
+        if (aEmpty && bEmpty) {
+            return 0;
+        }
+        return aEmpty ? -1 : 1;
+    }
+    if (av > bv) {
+        return 1;
+    }
+    return -1;
+}
+/**
+ * Sorts indexes by precomputed values for default column comparers.
  *
- * _.size({ 'a': 1, 'b': 2 });
- * // => 2
+ * This avoids repeatedly parsing the same cell value during large default
+ * sorts while preserving normal multi-column ordering.
+ */
+function sortIndexByDefaultComparers(indexes, source, entries, sorting, sortingColumns) {
+    const prepared = entries.map(([prop]) => {
+        const values = [];
+        const column = sortingColumns[prop];
+        for (const index of indexes) {
+            values[index] = getDefaultCompareValue(source[index], prop, column);
+        }
+        return {
+            order: sorting[prop],
+            values,
+        };
+    });
+    return indexes.sort((a, b) => {
+        for (const { order, values } of prepared) {
+            const sorted = compareValues(values[a], values[b]);
+            if (sorted) {
+                return order === 'desc' ? -sorted : sorted;
+            }
+        }
+        return 0;
+    });
+}
+/**
+ * Detects whether the optimized default-comparer path can be used.
  *
- * _.size('pebbles');
- * // => 7
+ * Grouped rows and custom `cellCompare` functions stay on the legacy
+ * comparator path to preserve their exact behavior.
  */
-function size(collection) {
-  if (collection == null) {
-    return 0;
-  }
-  if (isArrayLike(collection)) {
-    return isString(collection) ? stringSize(collection) : collection.length;
-  }
-  var tag = getTag(collection);
-  if (tag == mapTag || tag == setTag) {
-    return collection.size;
-  }
-  return baseKeys(collection).length;
+function canUseDefaultCompareFastPath(entries, indexes, source, sorting, sortingColumns) {
+    return !indexes.some(index => isGrouping(source[index])) && !!sorting && !!sortingColumns && entries.every(([prop]) => {
+        const order = sorting[prop];
+        const column = sortingColumns[prop];
+        return !!order && !(column === null || column === void 0 ? void 0 : column.cellCompare);
+    });
 }
-
-function sortIndexByItems(indexes, source, sortingFunc = {}) {
+/**
+ * Group placeholder rows are generated for their grouping column. If sorting is
+ * requested for another column, the grouped source must be unwrapped first.
+ */
+function hasGroupingRowsForOtherSorting(entries, indexes, source) {
+    return indexes.some(index => {
+        const item = source[index];
+        return isGrouping(item) && !entries.some(([prop]) => isSameColumnProp(item[GROUP_COLUMN_PROP], prop));
+    });
+}
+/**
+ * Sorts row indexes against a source collection.
+ *
+ * @param indexes - Current proxy row indexes to sort.
+ * @param source - Full source collection addressed by the indexes.
+ * @param sortingFunc - Comparator functions by column property.
+ * @param sorting - Active sorting order by column property.
+ * @param sortingColumns - Column metadata by property for default-comparer optimization.
+ * @param sortingOrder - Active sorting priority in click/config insertion order.
+ * @returns Sorted proxy indexes. With no sorting function keys, returns source-order indexes.
+ */
+function sortIndexByItems(indexes, source, sortingFunc = {}, sorting, sortingColumns, sortingOrder) {
+    const hasSortingKeys = Object.keys(sortingFunc).length > 0;
+    const sortingEntries = activeSortingEntries(sortingFunc, sortingOrder);
     // if no sorting - return unsorted indexes
-    if (Object.entries(sortingFunc).length === 0) {
+    if (sortingEntries.length === 0) {
         // Unsorted indexes
-        return [...Array(indexes.length).keys()];
+        return hasSortingKeys ? indexes : [...new Array(indexes.length).keys()];
+    }
+    if (hasGroupingRowsForOtherSorting(sortingEntries, indexes, source)) {
+        return indexes;
+    }
+    if (canUseDefaultCompareFastPath(sortingEntries, indexes, source, sorting, sortingColumns)) {
+        return sortIndexByDefaultComparers(indexes, source, sortingEntries, sorting, sortingColumns);
     }
     //
     /**
@@ -1766,15 +1798,15 @@ function sortIndexByItems(indexes, source, sortingFunc = {}) {
     return indexes.sort((a, b) => {
         const itemA = source[a];
         const itemB = source[b];
-        for (const [prop, cmp] of Object.entries(sortingFunc)) {
+        for (const [prop, cmp] of sortingEntries) {
             if (isGrouping(itemA)) {
-                if (itemA['__rvgr-prop'] !== prop) {
-                    return 0;
+                if (!isSameColumnProp(itemA[GROUP_COLUMN_PROP], prop)) {
+                    return a - b;
                 }
             }
             if (isGrouping(itemB)) {
-                if (itemB['__rvgr-prop'] !== prop) {
-                    return 0;
+                if (!isSameColumnProp(itemB[GROUP_COLUMN_PROP], prop)) {
+                    return a - b;
                 }
             }
             /**
@@ -1794,13 +1826,7 @@ function defaultCellCompare(prop, a, b) {
     const bRaw = this.column ? getCellRaw(b, this.column) : b === null || b === void 0 ? void 0 : b[prop];
     const av = typeof aRaw === 'number' ? aRaw : aRaw === null || aRaw === void 0 ? void 0 : aRaw.toString().toLowerCase();
     const bv = typeof bRaw === 'number' ? bRaw : bRaw === null || bRaw === void 0 ? void 0 : bRaw.toString().toLowerCase();
-    if (av === bv) {
-        return 0;
-    }
-    if (av > bv) {
-        return 1;
-    }
-    return -1;
+    return compareValues(av, bv);
 }
 function descCellCompare(cmp) {
     return (prop, a, b) => {
@@ -1829,6 +1855,21 @@ function getComparer(column, order) {
     return undefined;
 }
 
+function getSortableRowIndexes(indexes, source) {
+    return indexes.filter(index => !isGrouping(source[index]));
+}
+function mergeSortedRowsWithGroups(indexes, source, sortedRows) {
+    if (sortedRows.length === indexes.length) {
+        return sortedRows;
+    }
+    let rowIndex = 0;
+    return indexes.map(index => {
+        if (isGrouping(source[index])) {
+            return index;
+        }
+        return sortedRows[rowIndex++];
+    });
+}
 /**
  * Lifecycle
  * 1. @event `beforesorting` - Triggered when sorting just starts. Nothing has happened yet. This can be triggered from a column or from the source. If the type is from rows, the column will be undefined.
@@ -1843,54 +1884,37 @@ class SortingPlugin extends BasePlugin {
         super(revogrid, providers);
         this.revogrid = revogrid;
         /**
-         * Delayed sorting promise
+         * Delayed sorting promise registered in the grid render job queue.
          */
         this.sortingPromise = null;
         /**
-         * We need to sort only so often
+         * Debounced sorting entry point.
+         *
+         * Sorting can be requested by column changes, source changes, and header
+         * clicks in quick succession, so the actual sort is delayed and coalesced.
          */
-        this.postponeSort = debounce((order, comparison, ignoreViewportUpdate) => this.runSorting(order, comparison, ignoreViewportUpdate), 50);
-        const setConfig = (cfg) => {
-            var _a;
-            if (cfg) {
-                const sortingFunc = {};
-                const order = {};
-                (_a = cfg.columns) === null || _a === void 0 ? void 0 : _a.forEach(col => {
-                    sortingFunc[col.prop] = getComparer(col, col.order);
-                    order[col.prop] = col.order;
-                });
-                if (cfg.additive) {
-                    this.sorting = Object.assign(Object.assign({}, this.sorting), order);
-                    this.sortingFunc = Object.assign(Object.assign({}, this.sortingFunc), sortingFunc);
-                }
-                else {
-                    // // set sorting
-                    this.sorting = order;
-                    this.sortingFunc = sortingFunc;
-                }
-            }
-        };
-        setConfig(config);
+        this.postponeSort = debounce((order, comparison, sortingColumns, sortingOrder, ignoreViewportUpdate) => this.runSorting(order, comparison, sortingColumns, sortingOrder, ignoreViewportUpdate), 50);
+        this.applySortingConfig(config);
         this.addEventListener('sortingconfigchanged', ({ detail }) => {
             config = detail;
-            setConfig(detail);
-            this.startSorting(this.sorting, this.sortingFunc);
+            this.applySortingConfig(detail);
+            this.startSorting(this.sorting, this.sortingFunc, this.sortingColumns, this.sortingOrder);
         });
         this.addEventListener('beforeheaderrender', ({ detail, }) => {
             var _a;
             const { data: column } = detail;
             if (column.sortable) {
-                detail.data = Object.assign(Object.assign({}, column), { order: (_a = this.sorting) === null || _a === void 0 ? void 0 : _a[column.prop] });
+                detail.data = Object.assign(Object.assign({}, column), { order: (_a = this.sorting) === null || _a === void 0 ? void 0 : _a[column.prop], sortIndex: getSortingIndex(this.sorting, column.prop, this.sortingOrder) });
             }
         });
         this.addEventListener('beforeanysource', ({ detail: { type }, }) => {
             // if sorting was provided - sort data
-            if (!!this.sorting && this.sortingFunc) {
+            if (hasActiveSorting(this.sorting) && this.sortingFunc) {
                 const event = this.emit('beforesourcesortingapply', { type, sorting: this.sorting });
                 if (event.defaultPrevented) {
                     return;
                 }
-                this.startSorting(this.sorting, this.sortingFunc);
+                this.startSorting(this.sorting, this.sortingFunc, this.sortingColumns, this.sortingOrder);
             }
         });
         this.addEventListener('aftercolumnsset', ({ detail: { order }, }) => {
@@ -1900,13 +1924,24 @@ class SortingPlugin extends BasePlugin {
             }
             const columns = this.providers.column.getColumns();
             const sortingFunc = {};
+            const sortingColumns = {};
+            const sortingOrder = [];
+            const sorting = {};
             for (let prop in order) {
-                const cmp = getComparer(getColumnByProp(columns, prop), order[prop]);
-                sortingFunc[prop] = cmp;
+                if (order[prop]) {
+                    const column = getColumnByProp(columns, prop);
+                    const cmp = getComparer(column, order[prop]);
+                    sorting[prop] = order[prop];
+                    sortingFunc[prop] = cmp;
+                    sortingColumns[prop] = column;
+                    sortingOrder.push(prop);
+                }
             }
             // set sorting
-            this.sorting = order;
-            this.sortingFunc = order && sortingFunc;
+            this.sorting = hasActiveSorting(sorting) ? sorting : undefined;
+            this.sortingFunc = this.sorting ? sortingFunc : undefined;
+            this.sortingColumns = this.sorting ? sortingColumns : undefined;
+            this.sortingOrder = this.sorting ? sortingOrder : undefined;
         });
         this.addEventListener('beforeheaderclick', (e) => {
             var _a, _b, _c, _d;
@@ -1920,23 +1955,89 @@ class SortingPlugin extends BasePlugin {
         });
     }
     /**
-     * Entry point for sorting, waits for all delays, registers jobs
+     * Creates mutable sorting maps from current state when additive sorting is requested.
+     */
+    createSortingState(additive) {
+        var _a;
+        return {
+            sorting: additive ? Object.assign({}, this.sorting) : {},
+            sortingFunc: additive ? Object.assign({}, this.sortingFunc) : {},
+            sortingColumns: additive ? Object.assign({}, this.sortingColumns) : {},
+            sortingOrder: additive ? [...((_a = this.sortingOrder) !== null && _a !== void 0 ? _a : [])] : [],
+        };
+    }
+    /**
+     * Stores normalized sorting state, clearing inactive empty maps.
+     */
+    setSortingState({ sorting, sortingFunc, sortingColumns, sortingOrder, }) {
+        this.sorting = hasActiveSorting(sorting) ? sorting : undefined;
+        this.sortingFunc = this.sorting ? sortingFunc : undefined;
+        this.sortingColumns = this.sorting ? sortingColumns : undefined;
+        this.sortingOrder = this.sorting ? sortingOrder : undefined;
+    }
+    /**
+     * Adds or replaces a column in a sorting state.
      */
-    startSorting(order, sortingFunc, ignoreViewportUpdate) {
+    setColumnSorting(state, prop, order, cmp, column) {
+        state.sorting[prop] = order;
+        state.sortingFunc[prop] = cmp;
+        state.sortingColumns[prop] = column;
+        if (!state.sortingOrder.some(sortingProp => String(sortingProp) === String(prop))) {
+            state.sortingOrder.push(prop);
+        }
+    }
+    /**
+     * Removes a column from a sorting state.
+     */
+    clearColumnSorting(state, prop) {
+        delete state.sorting[prop];
+        delete state.sortingFunc[prop];
+        delete state.sortingColumns[prop];
+        const index = state.sortingOrder.findIndex(sortingProp => String(sortingProp) === String(prop));
+        if (index >= 0) {
+            state.sortingOrder.splice(index, 1);
+        }
+    }
+    /**
+     * Normalizes external sorting configuration into internal order,
+     * comparator, and column metadata maps.
+     */
+    applySortingConfig(cfg) {
+        var _a;
+        if (!cfg) {
+            return;
+        }
+        const state = this.createSortingState(cfg.additive);
+        (_a = cfg.columns) === null || _a === void 0 ? void 0 : _a.forEach(col => {
+            if (col.order) {
+                this.setColumnSorting(state, col.prop, col.order, getComparer(col, col.order), col);
+                return;
+            }
+            this.clearColumnSorting(state, col.prop);
+        });
+        this.setSortingState(state);
+    }
+    startSorting(order, sortingFunc, sortingColumns, sortingOrder, ignoreViewportUpdate) {
         if (!this.sortingPromise) {
             // add job before render
             this.revogrid.jobsBeforeRender.push(new Promise(resolve => {
                 this.sortingPromise = resolve;
             }));
         }
-        this.postponeSort(order, sortingFunc, ignoreViewportUpdate);
+        if (typeof sortingColumns === 'boolean') {
+            this.postponeSort(order, sortingFunc, undefined, undefined, sortingColumns);
+            return;
+        }
+        this.postponeSort(order, sortingFunc, sortingColumns, sortingOrder, ignoreViewportUpdate);
     }
     /**
-     * Apply sorting to data on header click
-     * If additive - add to existing sorting, multiple columns can be sorted
+     * Applies sorting requested by a sortable header click.
+     *
+     * @param column - Column that initiated sorting.
+     * @param additive - If true, add/remove this column from the current multi-sort state.
      */
     headerclick(column, additive) {
-        var _a, _b, _c;
+        var _a;
         const columnProp = column.prop;
         let order = getNextOrder((_a = this.sorting) === null || _a === void 0 ? void 0 : _a[columnProp]);
         const beforeEvent = this.emit('beforesorting', { column, order, additive });
@@ -1954,52 +2055,59 @@ class SortingPlugin extends BasePlugin {
             return;
         }
         const cmp = getComparer(beforeApplyEvent.detail.column, beforeApplyEvent.detail.order);
-        if (beforeApplyEvent.detail.additive && this.sorting) {
-            const sorting = {};
-            const sortingFunc = {};
-            if (columnProp in sorting && size(sorting) > 1 && order === undefined) {
-                delete sorting[columnProp];
-                delete sortingFunc[columnProp];
-            }
-            else {
-                sorting[columnProp] = order;
-                sortingFunc[columnProp] = cmp;
-            }
-            this.sorting = Object.assign(Object.assign({}, this.sorting), sorting);
-            // extend sorting function with new sorting for multiple columns sorting
-            this.sortingFunc = Object.assign(Object.assign({}, this.sortingFunc), sortingFunc);
+        this.applyHeaderSorting(beforeApplyEvent.detail.column, beforeApplyEvent.detail.additive, order, cmp);
+        this.startSorting(this.sorting, this.sortingFunc, this.sortingColumns, this.sortingOrder);
+    }
+    /**
+     * Applies sorting state produced by a header click.
+     */
+    applyHeaderSorting(column, additive, order, cmp) {
+        if (!additive) {
+            this.setSortingState(order ? {
+                sorting: { [column.prop]: order },
+                sortingFunc: { [column.prop]: cmp },
+                sortingColumns: { [column.prop]: column },
+                sortingOrder: [column.prop],
+            } : this.createSortingState());
+            return;
+        }
+        const state = this.createSortingState(true);
+        if (order) {
+            this.setColumnSorting(state, column.prop, order, cmp, column);
         }
         else {
-            if (order) {
-                // reset sorting
-                this.sorting = { [columnProp]: order };
-                this.sortingFunc = { [columnProp]: cmp };
-            }
-            else {
-                (_b = this.sorting) === null || _b === void 0 ? true : delete _b[columnProp];
-                (_c = this.sortingFunc) === null || _c === void 0 ? true : delete _c[columnProp];
-            }
+            this.clearColumnSorting(state, column.prop);
         }
-        this.startSorting(this.sorting, this.sortingFunc);
+        this.setSortingState(state);
     }
-    runSorting(order, comparison, ignoreViewportUpdate) {
-        var _a;
-        this.sort(order, comparison, undefined, ignoreViewportUpdate);
-        (_a = this.sortingPromise) === null || _a === void 0 ? void 0 : _a.call(this);
+    runSorting(order, comparison, sortingColumns, sortingOrder, ignoreViewportUpdate) {
+        var _a, _b;
+        if (typeof sortingColumns === 'boolean') {
+            this.sort(order, comparison, undefined, undefined, undefined, sortingColumns);
+            (_a = this.sortingPromise) === null || _a === void 0 ? void 0 : _a.call(this);
+            this.sortingPromise = null;
+            return;
+        }
+        this.sort(order, comparison, sortingColumns, sortingOrder, undefined, ignoreViewportUpdate);
+        (_b = this.sortingPromise) === null || _b === void 0 ? void 0 : _b.call(this);
         this.sortingPromise = null;
     }
-    /**
-     * Sort items by sorting function
-     * @requires proxyItems applied to row store
-     * @requires source applied to row store
-     *
-     * @param sorting - per column sorting
-     * @param data - this.stores['rgRow'].store.get('source')
-     */
-    sort(sorting, sortingFunc, types = rowTypes, ignoreViewportUpdate = false) {
+    sort(sorting, sortingFunc, sortingColumns, sortingOrder, types = rowTypes, ignoreViewportUpdate = false) {
+        let activeSortingColumns;
+        let activeSortingOrder;
+        let activeTypes = types;
+        let activeIgnoreViewportUpdate = ignoreViewportUpdate;
+        if (Array.isArray(sortingColumns)) {
+            activeTypes = sortingColumns;
+            activeIgnoreViewportUpdate = typeof sortingOrder === 'boolean' ? sortingOrder : false;
+        }
+        else {
+            activeSortingColumns = sortingColumns;
+            activeSortingOrder = Array.isArray(sortingOrder) ? sortingOrder : undefined;
+        }
         // if no sorting - reset
         if (!Object.keys(sorting || {}).length) {
-            for (let type of types) {
+            for (let type of activeTypes) {
                 const storeService = this.providers.data.stores[type];
                 // row data
                 const source = storeService.store.get('source');
@@ -2008,26 +2116,27 @@ class SortingPlugin extends BasePlugin {
                 // row indexes
                 const newItemsOrder = Array.from({ length: source.length }, (_, i) => i); // recover indexes range(0, source.length)
                 this.providers.dimension.updateSizesPositionByNewDataIndexes(type, newItemsOrder, proxyItems);
-                storeService.setData({ proxyItems: newItemsOrder, source: [...source], });
+                storeService.setData({ proxyItems: newItemsOrder });
             }
         }
         else {
-            for (let type of types) {
+            for (let type of activeTypes) {
                 const storeService = this.providers.data.stores[type];
                 // row data
                 const source = storeService.store.get('source');
                 // row indexes
                 const proxyItems = storeService.store.get('proxyItems');
-                const newItemsOrder = sortIndexByItems([...proxyItems], source, sortingFunc);
+                const sortItems = getSortableRowIndexes(proxyItems, source);
+                const sortedItems = sortIndexByItems([...sortItems], source, sortingFunc, sorting, activeSortingColumns, activeSortingOrder);
+                const newItemsOrder = mergeSortedRowsWithGroups(proxyItems, source, sortedItems);
                 // take row indexes before trim applied and proxy items
                 const prevItems = storeService.store.get('items');
                 storeService.setData({
                     proxyItems: newItemsOrder,
-                    source: [...source],
                 });
                 // take currently visible row indexes
                 const newItems = storeService.store.get('items');
-                if (!ignoreViewportUpdate) {
+                if (!activeIgnoreViewportUpdate) {
                     this.providers.dimension
                         .updateSizesPositionByNewDataIndexes(type, newItems, prevItems);
                 }
@@ -2219,6 +2328,18 @@ function filterOutEmptyGroupRows(source, filterTrimmed) {
     return trimmed;
 }
 
+var __rest = (undefined && undefined.__rest) || function (s, e) {
+    var t = {};
+    for (var p in s)
+        if (Object.prototype.hasOwnProperty.call(s, p) && e.indexOf(p) < 0)
+            t[p] = s[p];
+    if (s != null && typeof Object.getOwnPropertySymbols === "function")
+        for (var i = 0, p = Object.getOwnPropertySymbols(s); i < p.length; i++) {
+            if (e.indexOf(p[i]) < 0 && Object.prototype.propertyIsEnumerable.call(s, p[i]))
+                t[p[i]] = s[p[i]];
+        }
+    return t;
+};
 class GroupingRowPlugin extends BasePlugin {
     getStore(type = GROUPING_ROW_TYPE) {
         return this.providers.data.stores[type].store;
@@ -2302,6 +2423,18 @@ class GroupingRowPlugin extends BasePlugin {
         const sortingPlugin = this.providers.plugins.getByClass(SortingPlugin);
         return !!(sortingPlugin === null || sortingPlugin === void 0 ? void 0 : sortingPlugin.sortingPromise);
     }
+    /**
+     * Returns grouping options for regrouping that must preserve current UI state.
+     *
+     * `expandedAll` and config `prevExpanded` are initial/config instructions.
+     * Reusing them after sorting would reopen groups the user collapsed before
+     * sorting instead of using the current grouped source state.
+     */
+    getCurrentExpandedOptions() {
+        var _a;
+        const _b = (_a = this.options) !== null && _a !== void 0 ? _a : {}, options = __rest(_b, ["expandedAll", "prevExpanded"]);
+        return options;
+    }
     /**
      * Starts global source update with group clearing and applying new one
      * Initiated when need to reapply grouping
@@ -2404,7 +2537,7 @@ class GroupingRowPlugin extends BasePlugin {
             if (!((_b = (_a = this.options) === null || _a === void 0 ? void 0 : _a.props) === null || _b === void 0 ? void 0 : _b.length)) {
                 return;
             }
-            this.doSourceUpdate(Object.assign({}, this.options));
+            this.doSourceUpdate(this.getCurrentExpandedOptions());
         });
         /**
          * Apply logic for focus inside of grouping
@@ -2583,7 +2716,7 @@ class ColumnMovePlugin extends BasePlugin {
         const cols = this.getDimension(data.pin || 'rgCol');
         const gridRect = this.revogrid.getBoundingClientRect();
         const elRect = dataEl.getBoundingClientRect();
-        const startItem = getItemByPosition(cols, getLeftRelative(event.x, gridRect.left, elRect.left - gridRect.left));
+        const startItem = getItemByPosition(cols, getLeftRelative(event.x, gridRect.left, elRect.left - gridRect.left) + (cols.renderOffset || 0));
         this.staticDragData = {
             startPos: event.x,
             startItem,
@@ -2608,13 +2741,13 @@ class ColumnMovePlugin extends BasePlugin {
         const start = this.staticDragData.startPos;
         if (Math.abs(start - e.x) > 10) {
             const x = getLeftRelative(e.x, this.dragData.gridRect.left, this.dragData.scrollOffset);
-            const rgCol = getItemByPosition(this.staticDragData.cols, x);
+            const rgCol = getItemByPosition(this.staticDragData.cols, x + (this.staticDragData.cols.renderOffset || 0));
             this.orderUi.autoscroll(x, dragData.elRect.width);
             // prevent position change if out of bounds
             if (rgCol.itemIndex >= this.staticDragData.cols.count) {
                 return;
             }
-            this.orderUi.showHandler(rgCol.end + dragData.scrollOffset, dragData.gridRect.width);
+            this.orderUi.showHandler(rgCol.end - (this.staticDragData.cols.renderOffset || 0) + dragData.scrollOffset, dragData.gridRect.width);
         }
     }
     move(e) {
@@ -2632,7 +2765,7 @@ class ColumnMovePlugin extends BasePlugin {
             if (relativePos < 0) {
                 relativePos = 0;
             }
-            const newPosition = getItemByPosition(this.staticDragData.cols, relativePos);
+            const newPosition = getItemByPosition(this.staticDragData.cols, relativePos + (this.staticDragData.cols.renderOffset || 0));
             const store = this.providers.column.stores[this.dragData.type].store;
             const source = store.get('source');
             const newItems = [...store.get('items')];
@@ -2687,4 +2820,4 @@ function getLeftRelative(absoluteX, gridPos, offset) {
     return absoluteX - gridPos - offset;
 }
 
-export { AutoSizeColumnPlugin as A, BasePlugin as B, ColumnAutoSizeMode as C, DimensionStore as D, ExportFilePlugin as E, FILTER_TRIMMED_TYPE as F, GroupingRowPlugin as G, SelectionStore as S, StretchColumn as a, ExportCsv as b, FILTER_CONFIG_CHANGED_EVENT as c, FILTE_PANEL as d, FilterPlugin as e, filterCoreFunctionsIndexedByType as f, filterTypes as g, filterNames as h, isStretchPlugin as i, doCollapse as j, doExpand as k, COLUMN_DRAG_MOVE_EVENT as l, COLUMN_DRAG_END_EVENT as m, BEFORE_COLUMN_DRAG_END_EVENT as n, COLUMN_DRAG_START_EVENT as o, ColumnMovePlugin as p, getLeftRelative as q, SortingPlugin as r, sortIndexByItems as s, defaultCellCompare as t, descCellCompare as u, getNextOrder as v, getComparer as w };
+export { AutoSizeColumnPlugin as A, BasePlugin as B, ColumnAutoSizeMode as C, DimensionStore as D, ExportFilePlugin as E, FILTER_TRIMMED_TYPE as F, GroupingRowPlugin as G, SelectionStore as S, StretchColumn as a, ExportCsv as b, FILTER_CONFIG_CHANGED_EVENT as c, FILTE_PANEL as d, FilterPlugin as e, filterCoreFunctionsIndexedByType as f, filterTypes as g, filterNames as h, isStretchPlugin as i, doCollapse as j, doExpand as k, COLUMN_DRAG_MOVE_EVENT as l, COLUMN_DRAG_END_EVENT as m, BEFORE_COLUMN_DRAG_END_EVENT as n, COLUMN_DRAG_START_EVENT as o, ColumnMovePlugin as p, getLeftRelative as q, SortingPlugin as r, hasActiveSorting as s, getSortingIndex as t, sortIndexByItems as u, defaultCellCompare as v, descCellCompare as w, getNextOrder as x, getComparer as y };