@revolist/revogrid 4.26.2 → 4.27.1

package/dist/{esm/text-editor-DlMnLkRK.js → revo-grid/text-editor-eHtrwvxH.js}

@@ -1,8 +1,8 @@
 /*!
  * Built by Revolist OU ❤️
  */
-import { d as isTab, f as isEnterKeyValue } from './edit.utils-4e9fsqOR.js';
-import { t as timeout } from './index-D24ku9ej.js';
+import { d as isTab, f as isEnterKeyValue } from './edit.utils-3ZbhQCv_.js';
+import { t as timeout } from './index-BvMNbQyq.js';
 
 class TextEditor {
     constructor(data, saveCallback) {

package/dist/{esm/throttle-Cpk1LoGk.js → revo-grid/throttle-3rhqdcLy.js}

@@ -195,7 +195,7 @@ class LocalScrollTimer {
      * Remember last mw event time
      */
     latestScrollUpdate(dimension) {
-        this.mouseWheelScrollTimestamp[dimension] = new Date().getTime();
+        this.mouseWheelScrollTimestamp[dimension] = Date.now();
     }
     isReady(type, coordinate) {
         // if there is a callback, clear it
@@ -206,7 +206,7 @@ class LocalScrollTimer {
         return this.verifyChange(type, coordinate);
     }
     verifyChange(type, coordinate) {
-        const now = new Date().getTime();
+        const now = Date.now();
         const change = now - this.mouseWheelScrollTimestamp[type];
         return change > this.scrollThrottling &&
             coordinate !== this.lastKnownScrollCoordinate[type];
@@ -224,7 +224,7 @@ class LocalScrollTimer {
             // save lastScrollUpdate callback
             const callback = this.lastScrollUpdateCallbacks[type] = {
                 callback: lastScrollUpdate,
-                timestamp: new Date().getTime(),
+                timestamp: Date.now(),
                 coordinate,
                 timeout: 0,
             };

package/dist/{esm/viewport.store-BSXmsiZc.js → revo-grid/viewport.store-DWMKRDSH.js}

@@ -1,7 +1,7 @@
 /*!
  * Built by Revolist OU ❤️
  */
-import { j as getItemByPosition, K as createStore, l as setStore } from './dimension.helpers-fl4HSSK9.js';
+import { k as getItemByPosition, L as createStore, m as setStore } from './dimension.helpers-Cln9sALu.js';
 
 const LETTER_BLOCK_SIZE = 10;
 const calculateRowHeaderSize = (itemsLength, rowHeaderColumn, minWidth = 50) => {

package/dist/types/components/data/revogr-data.d.ts

@@ -103,5 +103,6 @@ export declare class RevogrData {
     componentWillRender(): Promise<any[]>;
     componentDidRender(): void;
     render(): any;
+    private triggerBeforeRowRender;
     triggerBeforeCellRender(model: CellTemplateProp, row: VirtualPositionItem, column: VirtualPositionItem): CustomEvent<BeforeCellRenderEvent<CellTemplateProp<DataType<any, import("@type").ColumnProp>, ColumnRegular<import("@type").ColumnProp, DataType<any, import("@type").ColumnProp>>, import("@type").ColumnProp>>>;
 }

package/dist/types/components/overlay/keyboard.service.d.ts

@@ -14,7 +14,13 @@ type Config = {
 };
 export declare class KeyboardService {
     private readonly sv;
+    /** Keep focus transitions in keydown order so rendering can scroll each cell into view. */
+    private keyChangeQueue;
+    private keyChangeGeneration;
+    private applyingKeyChange;
     constructor(sv: Config);
+    /** Cancel delayed directional input after focus or edit context changes externally. */
+    invalidatePendingChanges(): void;
     /**
      * Appends printable key input that arrives after edit mode was requested
      * but before the editor input has mounted or received focus.

package/dist/types/components/overlay/revogr-overlay-selection.d.ts

@@ -4,6 +4,7 @@ import { type DSourceState } from "../../store/index";
 import { EventData } from './selection.utils';
 import { type Observable } from '../../utils';
 import type { SelectionStoreState, DimensionSettingsState, DataType, DimensionRows, ColumnRegular, DimensionCols, DragStartEvent, Cell, MultiDimensionType, Nullable, RangeClipboardCopyEventProps, RangeClipboardPasteEvent, FocusRenderEvent, ApplyFocusEvent, AllDimensionType, Editors, BeforeSaveDataDetails, BeforeEdit, RangeArea, TempRange, ChangedRange, BeforeRangeSaveDataDetails, SaveDataDetails, EditCellStore, ClipboardConfig } from "../../types/index";
+type CellInteractionEvent = MouseEvent | TouchEvent | KeyboardEvent;
 /**
  * Component for overlaying the grid with the selection.
  */
@@ -268,10 +269,11 @@ export declare class OverlaySelection {
     /**
      * Sets the focus on a cell and optionally edits a range.
      */
-    focus(cell?: Cell, isRangeEdit?: boolean, originalEvent?: MouseEvent | TouchEvent | KeyboardEvent): boolean;
+    focus(cell?: Cell, isRangeEdit?: boolean, originalEvent?: CellInteractionEvent): boolean;
     get types(): AllDimensionType;
     /**
      * Collect data
      */
     protected getData(): EventData;
 }
+export {};

package/dist/types/components/revoGrid/revo-grid.d.ts

@@ -19,6 +19,7 @@ import { ColumnCollection } from '../../utils/column.utils';
 import { ColumnFilterConfig, FilterCollectionItem } from '../../plugins/filter/filter.types';
 import { PluginService } from './plugin.service';
 import { AfterSortingApplyEvent, SortingConfig, SortingOrder } from '../../plugins';
+import { type RowResizeConfig } from '../../plugins/row-resize';
 /**
  * Revogrid - High-performance, customizable grid library for managing large datasets.
  * ### Events guide
@@ -65,6 +66,11 @@ export declare class RevoGridComponent {
     readonly: boolean;
     /** When true, columns are resizable. */
     resize: boolean;
+    /**
+     * Enables row resizing. Pass a configuration object to customize the
+     * height limits or enable resize edges across the full row.
+     */
+    resizeRow: boolean | RowResizeConfig;
     /**
      * Prevents horizontal scroll state from being mirrored across viewport sections.
      */
@@ -137,7 +143,7 @@ export declare class RevoGridComponent {
      */
     autoSizeColumn: boolean | AutoSizeColumnConfig;
     /**
-     * Enables filter plugin.
+     * Enables filter plugin. Enabled by default; set to `false` to opt out.
      * Can be boolean.
      * Or can be filter collection See `FilterCollection` for more info.
      */
@@ -684,6 +690,7 @@ export declare class RevoGridComponent {
     applyFilter(cfg: boolean | ColumnFilterConfig): void;
     applySorting(cfg?: SortingConfig): void;
     rowHeadersChange(rowHeaders?: RowHeaders | boolean): void;
+    resizeRowChanged(): void;
     /**
      * Register external VNodes
      */
@@ -699,6 +706,7 @@ export declare class RevoGridComponent {
     pluginsChanged(plugins?: GridPlugin[], prevPlugins?: GridPlugin[]): void;
     private setPlugins;
     private setCorePlugins;
+    private syncRowResizeConfig;
     getPluginData(): PluginProviders | undefined;
     private removePlugins;
     connectedCallback(): void;

package/dist/types/components/revoGrid/viewport.scrolling.service.d.ts

@@ -1,9 +1,11 @@
 import { DimensionColPin, ViewPortScrollEvent, ElementsScroll, ElementScroll, MultiDimensionType } from "../../types/index";
 export default class GridScrollingService {
-    private setViewport;
+    private readonly setViewport;
     private elements;
     constructor(setViewport: (e: ViewPortScrollEvent<MultiDimensionType>) => void);
     proxyScroll(e: ViewPortScrollEvent, key?: DimensionColPin | string, skipEvent?: boolean): Promise<void>;
+    private changeScroll;
+    private setScroll;
     /**
      * Silent scroll update for mobile devices when we have negative scroll top
      */

package/dist/types/components.d.ts

@@ -6,6 +6,7 @@
  */
 import { HTMLStencilElement, JSXBase } from "./stencil-public-runtime";
 import { AdditionalData, AfterEditEvent, AllDimensionType, ApplyFocusEvent, BeforeCellRenderEvent, BeforeEdit, BeforeRangeSaveDataDetails, BeforeRowRenderEvent, BeforeSaveDataDetails, Cell, CellTemplateProp, ChangedRange, ClipboardConfig, ColumnDataSchemaModel, ColumnGrouping, ColumnProp, ColumnRegular, ColumnType, DataFormat, DataType, DimensionCols, DimensionRows, DimensionSettingsState, DimensionType, DimensionTypeCol, DragStartEvent, EditCell, EditorCtr, Editors, ElementScroll, ExtraNodeFuncConfig, FocusAfterRenderEvent, FocusRenderEvent, FocusTemplateFunc, InitialHeaderClick, MultiDimensionType, Nullable, PluginBaseComponent, PluginProviders, PositionItem, ProvidersColumns, RangeArea, RangeClipboardCopyEventProps, RangeClipboardPasteEvent, RowDefinition, RowDragStartDetails, RowHeaders, SaveDataDetails, SelectionStoreState, TempRange, ThemeDefinition, ViewportData, ViewPortResizeEvent, ViewPortScrollEvent, ViewportState, ViewSettingSizeProp } from "./types/index";
+import { RowResizeConfig } from "./plugins/row-resize";
 import { GridPlugin } from "./plugins/base.plugin";
 import { AutoSizeColumnConfig } from "./plugins/column.auto-size.plugin";
 import { ColumnFilterConfig, FilterCaptions, FilterCollectionItem, LogicFunction, MultiFilterItem, ShowData } from "./plugins/filter/filter.types";
@@ -22,6 +23,7 @@ import { HeaderRenderProps } from "./components/header/header-renderer";
 import { HeaderGroupRendererProps } from "./components/header/header-group-renderer";
 import { EventData } from "./components/overlay/selection.utils";
 export { AdditionalData, AfterEditEvent, AllDimensionType, ApplyFocusEvent, BeforeCellRenderEvent, BeforeEdit, BeforeRangeSaveDataDetails, BeforeRowRenderEvent, BeforeSaveDataDetails, Cell, CellTemplateProp, ChangedRange, ClipboardConfig, ColumnDataSchemaModel, ColumnGrouping, ColumnProp, ColumnRegular, ColumnType, DataFormat, DataType, DimensionCols, DimensionRows, DimensionSettingsState, DimensionType, DimensionTypeCol, DragStartEvent, EditCell, EditorCtr, Editors, ElementScroll, ExtraNodeFuncConfig, FocusAfterRenderEvent, FocusRenderEvent, FocusTemplateFunc, InitialHeaderClick, MultiDimensionType, Nullable, PluginBaseComponent, PluginProviders, PositionItem, ProvidersColumns, RangeArea, RangeClipboardCopyEventProps, RangeClipboardPasteEvent, RowDefinition, RowDragStartDetails, RowHeaders, SaveDataDetails, SelectionStoreState, TempRange, ThemeDefinition, ViewportData, ViewPortResizeEvent, ViewPortScrollEvent, ViewportState, ViewSettingSizeProp } from "./types/index";
+export { RowResizeConfig } from "./plugins/row-resize";
 export { GridPlugin } from "./plugins/base.plugin";
 export { AutoSizeColumnConfig } from "./plugins/column.auto-size.plugin";
 export { ColumnFilterConfig, FilterCaptions, FilterCollectionItem, LogicFunction, MultiFilterItem, ShowData } from "./plugins/filter/filter.types";
@@ -87,7 +89,7 @@ export namespace Components {
         "canFocus": boolean;
         /**
           * Enable column move plugin.
-          * @default false
+          * @default true
          */
         "canMoveColumns": boolean;
         /**
@@ -130,12 +132,12 @@ export namespace Components {
         "editors": Editors;
         /**
           * Enable export plugin.
-          * @default false
+          * @default true
          */
         "exporting": boolean;
         /**
-          * Enables filter plugin. Can be boolean. Or can be filter collection See `FilterCollection` for more info.
-          * @default false
+          * Enables filter plugin. Enabled by default; set to `false` to opt out. Can be boolean. Or can be filter collection See `FilterCollection` for more info.
+          * @default true
          */
         "filter": boolean | ColumnFilterConfig;
         /**
@@ -252,9 +254,14 @@ export namespace Components {
   )[];
         /**
           * When true, columns are resizable.
-          * @default false
+          * @default true
          */
         "resize": boolean;
+        /**
+          * Enables row resizing. Pass a configuration object to customize the height limits or enable resize edges across the full row.
+          * @default false
+         */
+        "resizeRow": boolean | RowResizeConfig;
         /**
           * Row class property mapping. Map custom classes to rows from row object data. Define this property in rgRow object and this will be mapped as rgRow class.
           * @default ''
@@ -1415,7 +1422,7 @@ declare namespace LocalJSX {
         "canFocus"?: boolean;
         /**
           * Enable column move plugin.
-          * @default false
+          * @default true
          */
         "canMoveColumns"?: boolean;
         /**
@@ -1450,12 +1457,12 @@ declare namespace LocalJSX {
         "editors"?: Editors;
         /**
           * Enable export plugin.
-          * @default false
+          * @default true
          */
         "exporting"?: boolean;
         /**
-          * Enables filter plugin. Can be boolean. Or can be filter collection See `FilterCollection` for more info.
-          * @default false
+          * Enables filter plugin. Enabled by default; set to `false` to opt out. Can be boolean. Or can be filter collection See `FilterCollection` for more info.
+          * @default true
          */
         "filter"?: boolean | ColumnFilterConfig;
         /**
@@ -1726,9 +1733,14 @@ declare namespace LocalJSX {
   )[];
         /**
           * When true, columns are resizable.
-          * @default false
+          * @default true
          */
         "resize"?: boolean;
+        /**
+          * Enables row resizing. Pass a configuration object to customize the height limits or enable resize edges across the full row.
+          * @default false
+         */
+        "resizeRow"?: boolean | RowResizeConfig;
         /**
           * Row class property mapping. Map custom classes to rows from row object data. Define this property in rgRow object and this will be mapped as rgRow class.
           * @default ''
@@ -2531,6 +2543,7 @@ declare namespace LocalJSX {
         "range": boolean;
         "readonly": boolean;
         "resize": boolean;
+        "resizeRow": boolean | RowResizeConfig;
         "noHorizontalScrollTransfer": boolean;
         "canFocus": boolean;
         "useClipboard": boolean | ClipboardConfig;

package/dist/types/plugins/filter/filter.constants.d.ts

@@ -0,0 +1,6 @@
+/** Fewer rows keep the existing synchronous filtering behavior. */
+export declare const ASYNC_FILTER_ROW_THRESHOLD = 15000;
+/** Maximum rows evaluated in one filtering chunk. */
+export declare const FILTER_CHUNK_SIZE = 1000;
+/** Yield after approximately this much accumulated filtering work. */
+export declare const FILTER_TIME_BUDGET_MS = 5;

package/dist/types/plugins/filter/filter.plugin.d.ts

@@ -48,6 +48,7 @@ export declare class FilterPlugin extends BasePlugin {
     filterFunctionsIndexedByType: Record<string, LogicFunction>;
     filterProp: string;
     private allowDuplicateOperators;
+    private filteringRunId;
     extraHyperContent?: (data: ShowData) => VNode | VNode[];
     extraBottomHyperContent?: (data: ShowData) => VNode | VNode[];
     constructor(revogrid: HTMLRevoGridElement, providers: PluginProviders, config?: ColumnFilterConfig | undefined);
@@ -68,6 +69,20 @@ export declare class FilterPlugin extends BasePlugin {
     doFiltering(collection: Record<ColumnProp, FilterCollectionItem>, source: DataType[], columns: ColumnRegular[], filterItems: MultiFilterItem): Promise<void>;
     clearFiltering(): Promise<void>;
     runFiltering(multiFilterItems: MultiFilterItem): Promise<void>;
+    /** Whether this plugin currently owns filter state that must follow a new source. */
+    protected hasActiveFilters(): boolean;
+    /** Preserve whole-source semantics for plugins that override getRowFilter. */
+    protected supportsChunkedFiltering(): boolean;
+    /**
+     * Hide visible rows and invalidate current filtering until a deferred filter
+     * run is ready. Used by filter extensions with their own debounced state.
+     */
+    protected deferFiltering(): void;
+    private beginFiltering;
+    private releaseFiltering;
+    private cancelFiltering;
+    private getRowFilterInChunks;
+    destroy(): void;
     /**
      * Get trimmed rows based on filter
      */

package/dist/types/plugins/groupingRow/grouping.const.d.ts

@@ -9,4 +9,5 @@ export declare const GROUP_COLUMN_PROP = "__rvgr-prop";
 export declare const GROUP_ORIGINAL_INDEX = "__rvgr-original-index";
 export declare const GROUP_EXPAND_BTN = "group-expand";
 export declare const GROUP_EXPAND_EVENT = "groupexpandclick";
+export declare const BEFORE_GROUPING_APPLY_EVENT = "beforegroupingapply";
 export declare const GROUPING_ROW_TYPE: DimensionRows;

package/dist/types/plugins/groupingRow/grouping.row.plugin.d.ts

@@ -19,15 +19,12 @@ export declare class GroupingRowPlugin extends BasePlugin {
     private onDrag;
     private beforeTrimmedApply;
     private beforeFilterTrimmed;
-    private isSortingRunning;
     /**
-     * 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.
+     * Sorting changes proxy order without changing the physical source baseline.
+     * Other proxy changes, such as row dragging, are user-authored source order
+     * and must be retained when grouping is rebuilt.
      */
-    private getCurrentExpandedOptions;
+    private isSortingActiveOrPending;
     /**
      * Starts global source update with group clearing and applying new one
      * Initiated when need to reapply grouping
@@ -44,5 +41,6 @@ export declare class GroupingRowPlugin extends BasePlugin {
      */
     setGrouping(options: GroupingOptions): void;
     clearGrouping(): void;
+    private remapRowDefinitions;
     private updateTrimmed;
 }

package/dist/types/plugins/groupingRow/grouping.sorting.service.d.ts

@@ -0,0 +1,7 @@
+import type { DataType } from "../../types/index";
+/**
+ * Restores group headers around already-sorted data indexes without rebuilding
+ * the physical source. Group insertion order follows the first sorted member,
+ * matching the order produced by regrouping a sorted source.
+ */
+export declare function gatherGroupedRowIndexes(source: DataType[], sortedDataIndexes: number[]): number[] | undefined;

package/dist/types/plugins/groupingRow/grouping.trimmed.service.d.ts

@@ -1,6 +1,15 @@
 import { Trimmed, TrimmedEntity } from "../../store/index";
 import type { DataType } from "../../types/index";
 export declare const TRIMMED_GROUPING = "grouping";
+/**
+ * Converts a trim row index through the index maps produced while regrouping.
+ *
+ * Group rows are synthetic, so they may not exist in the first map. When a
+ * second map is available, fall back to the original index so trims created
+ * against the grouped physical source can still be remapped. If neither path
+ * resolves to a number, the caller drops the stale trim entry.
+ */
+export declare function convertGroupingIndex(initialIndex: string | number, firstLevelMap: Record<number, number>, secondLevelMap?: Record<number, number>): number;
 /**
  * Prepare trimming updated indexes for grouping
  * @param initiallyTrimed

package/dist/types/plugins/index.d.ts

@@ -6,6 +6,7 @@ export * from './export/export.plugin';
 export * from './filter/filter.plugin';
 export * from './groupingRow/grouping.row.plugin';
 export * from './moveColumn/column.drag.plugin';
+export * from './row-resize';
 export * from './sorting/sorting.plugin';
 export * from './sorting/sorting.sign';
 export * from './add-rows-on-paste.plugin';

package/dist/types/plugins/row-resize/index.d.ts

@@ -0,0 +1,3 @@
+export * from './row-resize.plugin';
+export * from './row-resize.types';
+export * from './row-resize.utils';

package/dist/types/plugins/row-resize/row-resize.plugin.d.ts

@@ -0,0 +1,46 @@
+import type { PluginProviders } from "../../types/index";
+import { BasePlugin } from '../base.plugin';
+import type { RowResizeConfig } from './row-resize.types';
+export declare const ROW_RESIZE_HANDLE_CLASS = "row-resize-handle";
+export declare const BEFORE_ROW_RESIZE_EVENT = "beforerowresize";
+export declare const ROW_RESIZE_EVENT = "rowresize";
+export declare const AFTER_ROW_RESIZE_EVENT = "afterrowresize";
+export declare const ROW_RESIZE_CANCEL_EVENT = "rowresizecancel";
+export declare class RowResizePlugin extends BasePlugin {
+    private config;
+    private enabled;
+    private active?;
+    private readonly appliedDefinitionIndexes;
+    private animationFrame?;
+    private pendingHeight?;
+    private pendingBottomAnchor;
+    private keepBottomAnchor;
+    private rowDefinitionRemapQueued;
+    private readonly pendingSourceCounts;
+    private previousBodyCursor;
+    constructor(revogrid: HTMLRevoGridElement, providers: PluginProviders, config?: RowResizeConfig);
+    private registerEventListeners;
+    syncGridConfig(refresh?: boolean): void;
+    private readonly decorateRow;
+    private readonly cancelForDataChange;
+    private startResize;
+    private readonly onPointerMove;
+    private readonly onPointerUp;
+    private readonly onPointerCancel;
+    private readonly onKeyDown;
+    private readonly onWindowBlur;
+    private flushPendingResize;
+    private cancel;
+    private eventDetail;
+    private commitResize;
+    private requestBottomAnchor;
+    private isMainViewportAtBottom;
+    private readonly updateBottomAnchorState;
+    private readonly applyPendingBottomAnchor;
+    private readonly scheduleRowDefinitionRemap;
+    private pruneRowDefinitions;
+    /** Map source-indexed row definitions back onto the current virtual order. */
+    private readonly reapplyRowDefinitionSizes;
+    private finishGesture;
+    destroy(): void;
+}

package/dist/types/plugins/row-resize/row-resize.types.d.ts

@@ -0,0 +1,40 @@
+import type { DimensionRows, ViewSettingSizeProp } from "../../types/index";
+export type RowResizeConfig = {
+    /** Smallest height a user can assign. Defaults to 20px. */
+    minHeight?: number;
+    /** Optional largest height a user can assign. */
+    maxHeight?: number;
+    /** Makes the resize edge available across data rows, not only row headers. */
+    fullRow?: boolean;
+};
+export type ResolvedRowResizeConfig = {
+    minHeight: number;
+    maxHeight?: number;
+    fullRow: boolean;
+};
+export type RowResizeEventDetail = {
+    /** Row dimension containing the resized rows. */
+    rowType: DimensionRows;
+    /** Boundary row whose handle started the gesture. */
+    index: number;
+    /** All virtual row indexes affected by this gesture. */
+    indexes: number[];
+    /** Current absolute height applied to every affected row. */
+    size: number;
+    /** Heights at the start of the gesture. */
+    previousSizes: ViewSettingSizeProp;
+    /** Most recent pointer event associated with this lifecycle event. */
+    originalEvent: PointerEvent;
+};
+export type RowResizeCancelReason = 'escape' | 'pointercancel' | 'blur' | 'destroy' | 'config-change' | 'data-change' | 'row-headers-hidden';
+export type RowResizeCancelEventDetail = RowResizeEventDetail & {
+    reason: RowResizeCancelReason;
+};
+declare global {
+    interface HTMLRevoGridElementEventMap {
+        beforerowresize: RowResizeEventDetail;
+        rowresize: RowResizeEventDetail;
+        afterrowresize: RowResizeEventDetail;
+        rowresizecancel: RowResizeCancelEventDetail;
+    }
+}

package/dist/types/plugins/row-resize/row-resize.utils.d.ts

@@ -0,0 +1,14 @@
+import type { DimensionRows, RangeArea, RowDefinition, ViewSettingSizeProp } from "../../types/index";
+import type { ResolvedRowResizeConfig, RowResizeConfig } from './row-resize.types';
+export declare const DEFAULT_MIN_ROW_HEIGHT = 20;
+export declare function resolveRowResizeConfig(config?: RowResizeConfig): ResolvedRowResizeConfig;
+export declare function clampRowResizeHeight(height: number, config: ResolvedRowResizeConfig): number;
+export declare function getRowResizeIndexes({ rowType, rowIndex, rowCount, selectedRange, selectedRowType, }: {
+    rowType: DimensionRows;
+    rowIndex: number;
+    rowCount: number;
+    selectedRange?: RangeArea | null;
+    selectedRowType?: DimensionRows;
+}): number[];
+export declare function createRowResizePatch(indexes: number[], size: number): ViewSettingSizeProp;
+export declare function mergeRowResizeDefinitions(definitions: readonly RowDefinition[], rowType: DimensionRows, physicalIndexes: readonly number[], size: number): RowDefinition[];

package/dist/types/plugins/sorting/sorting.plugin.d.ts

@@ -85,6 +85,11 @@ export declare class SortingPlugin extends BasePlugin {
      */
     startSorting(order?: SortingOrder, sortingFunc?: SortingOrderFunction, ignoreViewportUpdate?: boolean): void;
     startSorting(order?: SortingOrder, sortingFunc?: SortingOrderFunction, sortingColumns?: SortingColumnMap, sortingOrder?: SortingColumnOrder, ignoreViewportUpdate?: boolean): void;
+    /**
+     * Schedules the current active sort again after another plugin rebuilds row
+     * proxy indexes while keeping the physical source unchanged.
+     */
+    reapplySorting(): void;
     /**
      * Applies sorting requested by a sortable header click.
      *

package/dist/types/services/data.provider.d.ts

@@ -50,4 +50,6 @@ export declare class DataProvider {
         cellRenderer?: GroupCellTemplateFunc;
     }, type?: DimensionRows): void;
     setTrimmed(trimmed: Trimmed, type?: DimensionRows): void;
+    /** Keep a row source empty until its current asynchronous update is ready. */
+    setItemsPending(pending: boolean, type?: DimensionRows): void;
 }

package/dist/types/services/dimension.provider.d.ts

@@ -1,8 +1,9 @@
 import ViewportProvider from './viewport.provider';
 import { DimensionStoreCollection, Trimmed } from "../store/index";
-import type { DimensionCols, DimensionType, MultiDimensionType, ColumnRegular, DimensionSettingsState, ViewPortScrollEvent, ViewSettingSizeProp } from "../types/index";
+import type { DimensionCols, DimensionType, MultiDimensionType, ColumnRegular, DimensionSettingsState, ViewPortScrollEvent, ViewSettingSizeProp, RowDefinition } from "../types/index";
 export type DimensionConfig = {
     realSizeChanged(k: MultiDimensionType): void;
+    rowDefinitionsChanged?(definitions: RowDefinition[]): void;
 };
 export declare const DEFAULT_VIRTUAL_X: readonly DimensionCols[];
 export declare function isVirtualXDimension(type: DimensionCols, disableVirtualX?: boolean, virtualX?: readonly DimensionCols[]): boolean;
@@ -14,7 +15,9 @@ export declare function isVirtualXDimension(type: DimensionCols, disableVirtualX
  */
 export default class DimensionProvider {
     private viewports;
+    private config;
     readonly stores: DimensionStoreCollection;
+    private rowDefinitions;
     constructor(viewports: ViewportProvider, config: DimensionConfig);
     /**
      * Clear old sizes from dimension and viewports
@@ -22,6 +25,9 @@ export default class DimensionProvider {
      * @param count - count of items
      */
     clearSize(t: MultiDimensionType, count: number): void;
+    getRowDefinitions(): RowDefinition[];
+    syncRowDefinitions(definitions: RowDefinition[]): void;
+    setRowDefinitions(definitions: RowDefinition[]): void;
     /**
      * Apply new custom sizes to dimension and view port
      * @param type - dimension type

package/dist/types/store/dataSource/data.pending.plugin.d.ts

@@ -0,0 +1,9 @@
+import type { Observable, PluginSubscribe } from '../../utils';
+import type { DSourceState, GDataType } from './data.store';
+/**
+ * Keeps the visible item collection empty while an asynchronous data operation
+ * is pending. Proxy, trim, and source updates may still calculate new items,
+ * but they must not expose those items until the owning operation releases the
+ * pending state.
+ */
+export declare const pendingItemsPlugin: <T extends GDataType>(store: Observable<DSourceState<T, any>>, isPending: () => boolean) => PluginSubscribe<DSourceState<T, any>>;

package/dist/types/store/dataSource/data.store.d.ts

@@ -20,6 +20,11 @@ export type DSourceState<T1 extends GDataType, T2 extends GDimension> = DataSour
  */
 export declare class DataStore<T extends GDataType, ST extends GDimension> {
     private readonly dataStore;
+    /**
+     * The source, proxy order, and trims may continue changing,
+     * but visible items must remain empty until the operation finishes.
+     */
+    private itemsPending;
     get store(): Observable<DSourceState<T, ST>>;
     constructor(type: ST, storeData?: DSourceState<T, ST>);
     /**
@@ -36,6 +41,11 @@ export declare class DataStore<T extends GDataType, ST extends GDimension> {
         cellRenderer?: GroupCellTemplateFunc;
     }, silent?: boolean, preserveTrimmed?: boolean): void;
     addTrimmed(some: Partial<Trimmed>): void;
+    /**
+     * Keeps visible items empty while an asynchronous source operation is pending.
+     * Releasing the state restores the current proxy order with all trims applied.
+     */
+    setItemsPending(pending: boolean): void;
     setSourceData(items: Record<number, any>, mutate?: boolean): void;
     setData(input: Partial<DSourceState<T, ST>>): void;
     refresh(): void;

package/dist/types/store/dataSource/trimmed.plugin.d.ts

@@ -10,3 +10,8 @@ export type Trimmed = Record<string, TrimmedEntity>;
  */
 export declare const trimmedPlugin: <T extends GDataType>(store: Observable<DSourceState<T, any>>) => PluginSubscribe<DSourceState<T, any>>;
 export declare function gatherTrimmedItems(trimmedItems: Trimmed): TrimmedEntity;
+/**
+ * Preserve proxy order while removing physical indexes hidden by any trim
+ * layer.
+ */
+export declare function getVisibleItems(proxyItems: number[], trimmedItems: Trimmed): number[];

package/dist/types/types/events.d.ts

@@ -1,2 +1,2 @@
-export type RevogridEvents = 'contentsizechanged' | 'beforeedit' | 'beforerangeedit' | 'afteredit' | 'beforeautofill' | 'beforerange' | 'afterfocus' | 'roworderchanged' | 'beforesorting' | 'beforesourcesortingapply' | 'beforesortingapply' | 'aftersortingapply' | 'rowdragstart' | 'headerclick' | 'beforecellfocus' | 'beforefocuslost' | 'beforesourceset' | 'beforeanysource' | 'aftersourceset' | 'afteranysource' | 'beforecolumnsgather' | 'beforecolumnsset' | 'beforecolumnapplied' | 'aftercolumnsset' | 'beforefilterapply' | 'beforefiltertrimmed' | 'beforetrimmed' | 'aftertrimmed' | 'viewportscroll' | 'beforeexport' | 'beforeeditstart' | 'aftercolumnresize' | 'beforerowdefinition' | 'filterconfigchanged' | 'sortingconfigchanged' | 'rowheaderschanged' | 'beforegridrender' | 'aftergridrender' | 'aftergridinit' | 'additionaldatachanged' | 'afterthemechanged' | 'created' | 'beforepaste' | 'beforepasteapply' | 'pasteregion' | 'afterpasteapply' | 'beforecut' | 'clearregion' | 'beforecopy' | 'beforecopyapply' | 'copyregion' | 'beforerowrender' | 'afterrender' | 'beforecellrender' | 'beforedatarender' | 'dragstartcell' | 'celleditinit' | 'closeedit' | 'filterChange' | 'resetChange' | 'beforefocusrender' | 'beforescrollintoview' | 'afterfocus' | 'beforeheaderclick' | 'headerresize' | 'beforeheaderresize' | 'headerdblclick' | 'beforeheaderrender' | 'beforegroupheaderrender' | 'afterheaderrender' | 'columndragstart' | 'columndragmousemove' | 'beforecolumndragend' | 'columndragend' | 'rowdragstartinit' | 'rowdragendinit' | 'rowdragmoveinit' | 'rowdragmousemove' | 'rowdropinit' | 'roworderchange' | 'beforecopyregion' | 'beforepasteregion' | 'celleditapply' | 'beforecellfocusinit' | 'beforenextvpfocus' | 'setedit' | 'beforeapplyrange' | 'beforesetrange' | 'setrange' | 'beforeeditrender' | 'selectall' | 'canceledit' | 'settemprange' | 'beforesettemprange' | 'applyfocus' | 'focuscell' | 'beforerangedataapply' | 'selectionchangeinit' | 'beforerangecopyapply' | 'rangeeditapply' | 'clipboardrangecopy' | 'clipboardrangepaste' | 'beforekeydown' | 'beforekeyup' | 'beforecellsave' | 'celledit' | 'scrollview' | 'ref' | 'scrollvirtual' | 'scrollviewport' | 'resizeviewport' | 'scrollchange' | 'scrollviewportsilent' | 'html';
+export type RevogridEvents = 'contentsizechanged' | 'beforeedit' | 'beforerangeedit' | 'afteredit' | 'beforeautofill' | 'beforerange' | 'afterfocus' | 'roworderchanged' | 'beforesorting' | 'beforesourcesortingapply' | 'beforesortingapply' | 'aftersortingapply' | 'rowdragstart' | 'headerclick' | 'beforecellfocus' | 'beforefocuslost' | 'beforesourceset' | 'beforeanysource' | 'aftersourceset' | 'afteranysource' | 'beforecolumnsgather' | 'beforecolumnsset' | 'beforecolumnapplied' | 'aftercolumnsset' | 'beforefilterapply' | 'beforefiltertrimmed' | 'beforetrimmed' | 'aftertrimmed' | 'viewportscroll' | 'beforeexport' | 'beforeeditstart' | 'aftercolumnresize' | 'beforerowdefinition' | 'filterconfigchanged' | 'sortingconfigchanged' | 'rowheaderschanged' | 'beforegridrender' | 'aftergridrender' | 'aftergridinit' | 'additionaldatachanged' | 'afterthemechanged' | 'created' | 'beforepaste' | 'beforepasteapply' | 'pasteregion' | 'afterpasteapply' | 'beforecut' | 'clearregion' | 'beforecopy' | 'beforecopyapply' | 'copyregion' | 'beforerowrender' | 'afterrender' | 'beforecellrender' | 'beforedatarender' | 'dragstartcell' | 'celleditinit' | 'closeedit' | 'filterChange' | 'resetChange' | 'beforefocusrender' | 'beforescrollintoview' | 'beforeheaderclick' | 'headerresize' | 'beforeheaderresize' | 'headerdblclick' | 'beforeheaderrender' | 'beforegroupheaderrender' | 'afterheaderrender' | 'columndragstart' | 'columndragmousemove' | 'beforecolumndragend' | 'columndragend' | 'beforerowresize' | 'rowresize' | 'afterrowresize' | 'rowresizecancel' | 'rowdragstartinit' | 'rowdragendinit' | 'rowdragmoveinit' | 'rowdragmousemove' | 'rowdropinit' | 'roworderchange' | 'beforecopyregion' | 'beforepasteregion' | 'celleditapply' | 'beforecellfocusinit' | 'beforenextvpfocus' | 'setedit' | 'beforeapplyrange' | 'beforesetrange' | 'setrange' | 'beforeeditrender' | 'selectall' | 'canceledit' | 'settemprange' | 'beforesettemprange' | 'applyfocus' | 'focuscell' | 'beforerangedataapply' | 'selectionchangeinit' | 'beforerangecopyapply' | 'rangeeditapply' | 'clipboardrangecopy' | 'clipboardrangepaste' | 'beforekeydown' | 'beforekeyup' | 'beforecellsave' | 'celledit' | 'scrollview' | 'ref' | 'scrollvirtual' | 'scrollviewport' | 'resizeviewport' | 'scrollchange' | 'scrollviewportsilent' | 'html';
 export declare const REVOGRID_EVENTS: Map<RevogridEvents, RevogridEvents>;

package/dist/types/types/interfaces.d.ts

@@ -687,7 +687,9 @@ export interface BeforeCellRenderEvent<T = any> extends AllDimensionType {
  * Represents the event object that is emitted before row rendering.
  * It includes information about the dimension type, data item, item, and node.
  */
-export interface BeforeRowRenderEvent<T = any> extends AllDimensionType {
+export interface BeforeRowRenderEvent<T = any> extends Pick<AllDimensionType, 'rowType'> {
+    /** Column viewport rendering the row, including the row-header viewport. */
+    colType: DimensionCols | 'rowHeaders';
     /**
      * Represents the data item being rendered.
      */