@bryntum/grid-trial 7.2.2 → 7.2.4

package/grid.d.ts

@@ -1,6 +1,6 @@
 /*!
  *
- * Bryntum Grid 7.2.2 (TRIAL VERSION)
+ * Bryntum Grid 7.2.4 (TRIAL VERSION)
  *
  * Copyright(c) 2026 Bryntum AB
  * https://bryntum.com/contact
@@ -1312,6 +1312,25 @@ type BryntumListenerConfig = Record<string, Function|boolean|object|object[]|num
     asap?: boolean
 }
 
+type PluginConfigObject = {
+    /**
+     * Method names to add to the client (when they don't already exist)
+     */
+    assign?: string[]
+    /**
+     * Methods called <strong>before</strong> the client's original method
+     */
+    before?: string[]
+    /**
+     * Methods called <strong>after</strong> the client's original method
+     */
+    after?: string[]|object
+    /**
+     * Methods that replace the client's method (original accessible via `this.overridden`)
+     */
+    override?: string[]
+}
+
 /**
  * The operator to use when comparing a collection object.
  * ...
@@ -2420,6 +2439,12 @@ type GlobalEventsListenersTypes = {
      * @param {string} event.theme The new theme name
      */
     theme: (event: { source: typeof GlobalEvents, theme: string }) => void
+    /**
+     * Fired when the browser zoom level is changed by the user
+     * @param {object} event Event object
+     * @param {typeof GlobalEvents} event.source
+     */
+    zoomChange: (event: { source: typeof GlobalEvents }) => void
 }
 
 /**
@@ -2458,6 +2483,12 @@ type GlobalEventsListeners = {
      * @param {string} event.theme The new theme name
      */
     theme?: ((event: { source: typeof GlobalEvents, theme: string }) => void)|string
+    /**
+     * Fired when the browser zoom level is changed by the user
+     * @param {object} event Event object
+     * @param {typeof GlobalEvents} event.source
+     */
+    zoomChange?: ((event: { source: typeof GlobalEvents }) => void)|string
 }
 
 export class GlobalEventsSingleton {
@@ -2506,6 +2537,12 @@ export class GlobalEventsSingleton {
      * @param {string} event.theme The new theme name
      */
     onTheme: ((event: { source: typeof GlobalEvents, theme: string }) => void)|string
+    /**
+     * Fired when the browser zoom level is changed by the user
+     * @param {object} event Event object
+     * @param {typeof GlobalEvents} event.source
+     */
+    onZoomChange: ((event: { source: typeof GlobalEvents }) => void)|string
     /**
      * Adds an event listener. This method accepts parameters in the following format:
      * @param {BryntumListenerConfig,string} config An object containing listener definitions, or the event name to listen for
@@ -3612,6 +3649,13 @@ type AjaxStoreConfig = {
      * [View online docs...](https://bryntum.com/products/grid/docs/api/Core/data/AjaxStore#config-catchEventHandlerExceptions)
      */
     catchEventHandlerExceptions?: boolean
+    /**
+     * Set to `true` to have the chained store react to expand/collapse changes in the master store.
+     * By default, expand/collapse in the master store does not trigger a refill of the chained store.
+     * ...
+     * [View online docs...](https://bryntum.com/products/grid/docs/api/Core/data/AjaxStore#config-chainExpandCollapse)
+     */
+    chainExpandCollapse?: boolean
     /**
      * If `true`, chained stores will apply filters from the master store. Filters flagged with `ignoreForChain`
      * will be ignored.
@@ -6413,6 +6457,13 @@ type StoreConfig = {
      * [View online docs...](https://bryntum.com/products/grid/docs/api/Core/data/Store#config-catchEventHandlerExceptions)
      */
     catchEventHandlerExceptions?: boolean
+    /**
+     * Set to `true` to have the chained store react to expand/collapse changes in the master store.
+     * By default, expand/collapse in the master store does not trigger a refill of the chained store.
+     * ...
+     * [View online docs...](https://bryntum.com/products/grid/docs/api/Core/data/Store#config-chainExpandCollapse)
+     */
+    chainExpandCollapse?: boolean
     /**
      * If `true`, chained stores will apply filters from the master store. Filters flagged with `ignoreForChain`
      * will be ignored.
@@ -7111,6 +7162,11 @@ export class Store extends Base {
      * Setting `autoCommit` to `true` automatically commits changes to records.
      */
     autoCommit: boolean
+    /**
+     * Returns the root store in the chain — the store that is not itself chained. For a store chained
+     * off another chained store, this walks up the full chain. Returns `this` if the store is not chained.
+     */
+    readonly baseStore: Store
     /**
      * Set to `true` to call onXXX method names (e.g. `onShow`, `onClick`), as an easy way to listen for events.
      */
@@ -7198,6 +7254,11 @@ export class Store extends Base {
      * Yields `true` if this Store is loaded page by page. See the [remotePaging](https://bryntum.com/products/grid/docs/api/Core/data/mixin/StorePaging#config-remotePaging) config.
      */
     readonly isPaged: boolean
+    /**
+     * Returns `true` if the data in this store depends on a remote data source. That is this
+     * Store is an AjaxStore, or uses [requestData](https://bryntum.com/products/grid/docs/api/Core/data/Store#config-requestData), or is chained off an AjaxStore.
+     */
+    readonly isRemoteLoad: boolean
     /**
      * Is store sorted?
      */
@@ -9958,6 +10019,13 @@ export const StoreCRUD : <T extends AnyConstructor<Base>>(base : T) => AnyConstr
  * Type with configuration options for [StoreChained](https://bryntum.com/products/grid/docs/api/Core/data/mixin/StoreChained) class.
  */
 type StoreChainedClassConfig = {
+    /**
+     * Set to `true` to have the chained store react to expand/collapse changes in the master store.
+     * By default, expand/collapse in the master store does not trigger a refill of the chained store.
+     * ...
+     * [View online docs...](https://bryntum.com/products/grid/docs/api/Core/data/mixin/StoreChained#config-chainExpandCollapse)
+     */
+    chainExpandCollapse?: boolean
     /**
      * If `true`, chained stores will apply filters from the master store. Filters flagged with `ignoreForChain`
      * will be ignored.
@@ -10032,6 +10100,11 @@ export class StoreChainedClass {
      * Identifies an object as an instance of [StoreChained](https://bryntum.com/products/grid/docs/api/Core/data/mixin/StoreChained) class, or subclass thereof.
      */
     static readonly isStoreChained: boolean
+    /**
+     * Returns the root store in the chain — the store that is not itself chained. For a store chained
+     * off another chained store, this walks up the full chain. Returns `this` if the store is not chained.
+     */
+    readonly baseStore: Store
     /**
      * Is this a chained store?
      */
@@ -16038,7 +16111,8 @@ export class ObjectHelper {
 }
 
 /**
- * Helper for string manipulation.
+ * A static utility class providing common string manipulation methods such as HTML encoding, camelCase
+ * conversion, regular expression escaping, and markdown-to-HTML processing.
  * ...
  * [View online docs...](https://bryntum.com/products/grid/docs/api/Core/helper/StringHelper)
  */
@@ -16622,8 +16696,9 @@ export class Rectangle {
      * @param {HTMLElement,Core.widget.Widget,Core.widget.Mask,string} element The element (or selector) to calculate the Rectangle for.
      * @param {HTMLElement,string} relativeTo Optionally, a parent element (or selector) in whose space to calculate the Rectangle.
      * @param {boolean} ignorePageScroll Use browser viewport based coordinates.
+     * @param {boolean} rtl Pass `true` when the `relativeTo` element uses RTL direction. Normalizes the negative `scrollLeft` values that browsers use in RTL mode so that content-space coordinates are correct.
      */
-    static from(element: HTMLElement|Widget|Mask|string, relativeTo?: HTMLElement|string, ignorePageScroll?: boolean): Rectangle;
+    static from(element: HTMLElement|Widget|Mask|string, relativeTo?: HTMLElement|string, ignorePageScroll?: boolean, rtl?: boolean): Rectangle;
     /**
      * Returns the Rectangle in viewport coordinates of the passed element.
      * @param {HTMLElement} element The element to calculate the Rectangle for.
@@ -17157,8 +17232,8 @@ export class Scroller extends Base {
     resumeEvents(): boolean;
     /**
      * Scrolls by the passed deltas according to the passed options.
-     * @param {number} xDelta How far to scroll in the X axis.
-     * @param {number} yDelta How far to scroll in the Y axis.
+     * @param {number} xDelta How far to scroll along the X axis.
+     * @param {number} yDelta How far to scroll along the Y axis.
      * @param {object,boolean} options How to scroll. May be passed as `true` to animate.
      */
     scrollBy(xDelta?: number, yDelta?: number, options?: {
@@ -17818,6 +17893,11 @@ export class InstancePlugin extends Base {
      * Identifies an object as an instance of [Localizable](https://bryntum.com/products/grid/docs/api/Core/localization/Localizable) class, or subclass thereof.
      */
     static readonly isLocalizable: boolean
+    /**
+     * Defines how the plugin's methods integrate with its client (the widget it is attached to).
+     * Override this static getter in subclasses.
+     */
+    static readonly pluginConfig: PluginConfigObject
     /**
      * Set to `true` to call onXXX method names (e.g. `onShow`, `onClick`), as an easy way to listen for events.
      */
@@ -42889,7 +42969,7 @@ type DateTimeFieldConfig = {
     value?: string
     /**
      * The week start day in the [picker](https://bryntum.com/products/grid/docs/api/Core/widget/DateField#config-picker), 0 meaning Sunday, 6 meaning Saturday.
-     * Uses localized value per default.
+     * Uses a localized value by default.
      */
     weekStartDay?: number
     /**
@@ -107501,12 +107581,9 @@ type ActionColumnConfig = {
      */
     cellMenuItems?: Record<string, MenuItemEntry>
     /**
-     * Child nodes. To allow loading children on demand, specify `children : true` in your data. Omit the field for leaf
-     * tasks.
-     * ...
-     * [View online docs...](https://bryntum.com/products/grid/docs/api/Grid/column/ActionColumn#config-children)
+     * Child columns. To create grouped headers, specify an array of column configs as children of a parent column.
      */
-    children?: boolean|object[]|Model[]|ModelConfig[]
+    children?: GridColumnConfig[]|Column[]
     /**
      * CSS class added to the header of this column
      */
@@ -107637,8 +107714,9 @@ type ActionColumnConfig = {
      * @param {object} renderData
      * @param {Grid.column.Column} renderData.column This column
      * @param {HTMLElement} renderData.headerElement The header element
+     * @returns {string,object,void,void} The text or markup to show in the column header
      */
-    headerRenderer?: (renderData: { column: Column, headerElement: HTMLElement }) => string|object|null|void
+    headerRenderer?: (renderData: { column: Column, headerElement: HTMLElement }) => string|object|void
     /**
      * An array of the widgets to append to the column header. These widgets have this Column instance
      * as their `owner` which can be used to reference the column, and the owning Grid via `this.owner.grid`.
@@ -108179,12 +108257,9 @@ type AggregateColumnConfig = {
      */
     cellMenuItems?: Record<string, MenuItemEntry>
     /**
-     * Child nodes. To allow loading children on demand, specify `children : true` in your data. Omit the field for leaf
-     * tasks.
-     * ...
-     * [View online docs...](https://bryntum.com/products/grid/docs/api/Grid/column/AggregateColumn#config-children)
+     * Child columns. To create grouped headers, specify an array of column configs as children of a parent column.
      */
-    children?: boolean|object[]|Model[]|ModelConfig[]
+    children?: GridColumnConfig[]|Column[]
     /**
      * CSS class added to the header of this column
      */
@@ -108356,8 +108431,9 @@ type AggregateColumnConfig = {
      * @param {object} renderData
      * @param {Grid.column.Column} renderData.column This column
      * @param {HTMLElement} renderData.headerElement The header element
+     * @returns {string,object,void,void} The text or markup to show in the column header
      */
-    headerRenderer?: (renderData: { column: Column, headerElement: HTMLElement }) => string|object|null|void
+    headerRenderer?: (renderData: { column: Column, headerElement: HTMLElement }) => string|object|void
     /**
      * An array of the widgets to append to the column header. These widgets have this Column instance
      * as their `owner` which can be used to reference the column, and the owning Grid via `this.owner.grid`.
@@ -108969,12 +109045,9 @@ type ChartColumnConfig = {
      */
     chartCls?: string
     /**
-     * Child nodes. To allow loading children on demand, specify `children : true` in your data. Omit the field for leaf
-     * tasks.
-     * ...
-     * [View online docs...](https://bryntum.com/products/grid/docs/api/Grid/column/ChartColumn#config-children)
+     * Child columns. To create grouped headers, specify an array of column configs as children of a parent column.
      */
-    children?: boolean|object[]|Model[]|ModelConfig[]
+    children?: GridColumnConfig[]|Column[]
     /**
      * CSS class added to the header of this column
      */
@@ -109126,8 +109199,9 @@ type ChartColumnConfig = {
      * @param {object} renderData
      * @param {Grid.column.Column} renderData.column This column
      * @param {HTMLElement} renderData.headerElement The header element
+     * @returns {string,object,void,void} The text or markup to show in the column header
      */
-    headerRenderer?: (renderData: { column: Column, headerElement: HTMLElement }) => string|object|null|void
+    headerRenderer?: (renderData: { column: Column, headerElement: HTMLElement }) => string|object|void
     /**
      * An array of the widgets to append to the column header. These widgets have this Column instance
      * as their `owner` which can be used to reference the column, and the owning Grid via `this.owner.grid`.
@@ -109744,12 +109818,9 @@ type CheckColumnConfig = {
      */
     checkCls?: string
     /**
-     * Child nodes. To allow loading children on demand, specify `children : true` in your data. Omit the field for leaf
-     * tasks.
-     * ...
-     * [View online docs...](https://bryntum.com/products/grid/docs/api/Grid/column/CheckColumn#config-children)
+     * Child columns. To create grouped headers, specify an array of column configs as children of a parent column.
      */
-    children?: boolean|object[]|Model[]|ModelConfig[]
+    children?: GridColumnConfig[]|Column[]
     /**
      * CSS class added to the header of this column
      */
@@ -109901,8 +109972,9 @@ type CheckColumnConfig = {
      * @param {object} renderData
      * @param {Grid.column.Column} renderData.column This column
      * @param {HTMLElement} renderData.headerElement The header element
+     * @returns {string,object,void,void} The text or markup to show in the column header
      */
-    headerRenderer?: (renderData: { column: Column, headerElement: HTMLElement }) => string|object|null|void
+    headerRenderer?: (renderData: { column: Column, headerElement: HTMLElement }) => string|object|void
     /**
      * An array of the widgets to append to the column header. These widgets have this Column instance
      * as their `owner` which can be used to reference the column, and the owning Grid via `this.owner.grid`.
@@ -110531,12 +110603,9 @@ type ColorColumnConfig = {
      */
     cellMenuItems?: Record<string, MenuItemEntry>
     /**
-     * Child nodes. To allow loading children on demand, specify `children : true` in your data. Omit the field for leaf
-     * tasks.
-     * ...
-     * [View online docs...](https://bryntum.com/products/grid/docs/api/Grid/column/ColorColumn#config-children)
+     * Child columns. To create grouped headers, specify an array of column configs as children of a parent column.
      */
-    children?: boolean|object[]|Model[]|ModelConfig[]
+    children?: GridColumnConfig[]|Column[]
     /**
      * CSS class added to the header of this column
      */
@@ -110691,8 +110760,9 @@ type ColorColumnConfig = {
      * @param {object} renderData
      * @param {Grid.column.Column} renderData.column This column
      * @param {HTMLElement} renderData.headerElement The header element
+     * @returns {string,object,void,void} The text or markup to show in the column header
      */
-    headerRenderer?: (renderData: { column: Column, headerElement: HTMLElement }) => string|object|null|void
+    headerRenderer?: (renderData: { column: Column, headerElement: HTMLElement }) => string|object|void
     /**
      * An array of the widgets to append to the column header. These widgets have this Column instance
      * as their `owner` which can be used to reference the column, and the owning Grid via `this.owner.grid`.
@@ -111269,12 +111339,9 @@ type ColumnConfig = {
      */
     cellMenuItems?: Record<string, MenuItemEntry>
     /**
-     * Child nodes. To allow loading children on demand, specify `children : true` in your data. Omit the field for leaf
-     * tasks.
-     * ...
-     * [View online docs...](https://bryntum.com/products/grid/docs/api/Grid/column/Column#config-children)
+     * Child columns. To create grouped headers, specify an array of column configs as children of a parent column.
      */
-    children?: boolean|object[]|Model[]|ModelConfig[]
+    children?: GridColumnConfig[]|Column[]
     /**
      * CSS class added to the header of this column
      */
@@ -111426,8 +111493,9 @@ type ColumnConfig = {
      * @param {object} renderData
      * @param {Grid.column.Column} renderData.column This column
      * @param {HTMLElement} renderData.headerElement The header element
+     * @returns {string,object,void,void} The text or markup to show in the column header
      */
-    headerRenderer?: (renderData: { column: Column, headerElement: HTMLElement }) => string|object|null|void
+    headerRenderer?: (renderData: { column: Column, headerElement: HTMLElement }) => string|object|void
     /**
      * An array of the widgets to append to the column header. These widgets have this Column instance
      * as their `owner` which can be used to reference the column, and the owning Grid via `this.owner.grid`.
@@ -111835,6 +111903,12 @@ export class Column extends Model {
      * Set to `true` to call onXXX method names (e.g. `onShow`, `onClick`), as an easy way to listen for events.
      */
     callOnFunctions: boolean
+    /**
+     * Returns `true` if this column can currently be sorted by the user.
+     * Checks both the column's own [sortable](https://bryntum.com/products/grid/docs/api/Grid/column/Column#config-sortable) config and whether the
+     * [Sort](https://bryntum.com/products/grid/docs/api/Grid/feature/Sort) feature is enabled on the grid.
+     */
+    readonly canSort: boolean
     /**
      * By default, if an event handler throws an exception, the error propagates up the stack and the
      * application state is undefined. Code which follows the event handler will *not* be executed.
@@ -111975,7 +112049,7 @@ export class Column extends Model {
     /**
      * Renderer function for the column header.
      */
-    headerRenderer: (renderData: { column: Column, headerElement: HTMLElement }) => string|object|null|void
+    headerRenderer: (renderData: { column: Column, headerElement: HTMLElement }) => string|object|void
     /**
      * An array of the widgets to append to the column header. These widgets have this Column instance
      * as their `owner` which can be used to reference the column, and the owning Grid via `this.owner.grid`.
@@ -112555,12 +112629,9 @@ type CurrencyColumnConfig = {
      */
     cellMenuItems?: Record<string, MenuItemEntry>
     /**
-     * Child nodes. To allow loading children on demand, specify `children : true` in your data. Omit the field for leaf
-     * tasks.
-     * ...
-     * [View online docs...](https://bryntum.com/products/grid/docs/api/Grid/column/CurrencyColumn#config-children)
+     * Child columns. To create grouped headers, specify an array of column configs as children of a parent column.
      */
-    children?: boolean|object[]|Model[]|ModelConfig[]
+    children?: GridColumnConfig[]|Column[]
     /**
      * CSS class added to the header of this column
      */
@@ -112723,8 +112794,9 @@ type CurrencyColumnConfig = {
      * @param {object} renderData
      * @param {Grid.column.Column} renderData.column This column
      * @param {HTMLElement} renderData.headerElement The header element
+     * @returns {string,object,void,void} The text or markup to show in the column header
      */
-    headerRenderer?: (renderData: { column: Column, headerElement: HTMLElement }) => string|object|null|void
+    headerRenderer?: (renderData: { column: Column, headerElement: HTMLElement }) => string|object|void
     /**
      * An array of the widgets to append to the column header. These widgets have this Column instance
      * as their `owner` which can be used to reference the column, and the owning Grid via `this.owner.grid`.
@@ -113312,12 +113384,9 @@ type DateColumnConfig = {
      */
     cellMenuItems?: Record<string, MenuItemEntry>
     /**
-     * Child nodes. To allow loading children on demand, specify `children : true` in your data. Omit the field for leaf
-     * tasks.
-     * ...
-     * [View online docs...](https://bryntum.com/products/grid/docs/api/Grid/column/DateColumn#config-children)
+     * Child columns. To create grouped headers, specify an array of column configs as children of a parent column.
      */
-    children?: boolean|object[]|Model[]|ModelConfig[]
+    children?: GridColumnConfig[]|Column[]
     /**
      * CSS class added to the header of this column
      */
@@ -113475,8 +113544,9 @@ type DateColumnConfig = {
      * @param {object} renderData
      * @param {Grid.column.Column} renderData.column This column
      * @param {HTMLElement} renderData.headerElement The header element
+     * @returns {string,object,void,void} The text or markup to show in the column header
      */
-    headerRenderer?: (renderData: { column: Column, headerElement: HTMLElement }) => string|object|null|void
+    headerRenderer?: (renderData: { column: Column, headerElement: HTMLElement }) => string|object|void
     /**
      * An array of the widgets to append to the column header. These widgets have this Column instance
      * as their `owner` which can be used to reference the column, and the owning Grid via `this.owner.grid`.
@@ -114075,12 +114145,9 @@ type NumberColumnConfig = {
      */
     cellMenuItems?: Record<string, MenuItemEntry>
     /**
-     * Child nodes. To allow loading children on demand, specify `children : true` in your data. Omit the field for leaf
-     * tasks.
-     * ...
-     * [View online docs...](https://bryntum.com/products/grid/docs/api/Grid/column/NumberColumn#config-children)
+     * Child columns. To create grouped headers, specify an array of column configs as children of a parent column.
      */
-    children?: boolean|object[]|Model[]|ModelConfig[]
+    children?: GridColumnConfig[]|Column[]
     /**
      * CSS class added to the header of this column
      */
@@ -114238,8 +114305,9 @@ type NumberColumnConfig = {
      * @param {object} renderData
      * @param {Grid.column.Column} renderData.column This column
      * @param {HTMLElement} renderData.headerElement The header element
+     * @returns {string,object,void,void} The text or markup to show in the column header
      */
-    headerRenderer?: (renderData: { column: Column, headerElement: HTMLElement }) => string|object|null|void
+    headerRenderer?: (renderData: { column: Column, headerElement: HTMLElement }) => string|object|void
     /**
      * An array of the widgets to append to the column header. These widgets have this Column instance
      * as their `owner` which can be used to reference the column, and the owning Grid via `this.owner.grid`.
@@ -114854,12 +114922,9 @@ type PercentColumnConfig = {
      */
     cellMenuItems?: Record<string, MenuItemEntry>
     /**
-     * Child nodes. To allow loading children on demand, specify `children : true` in your data. Omit the field for leaf
-     * tasks.
-     * ...
-     * [View online docs...](https://bryntum.com/products/grid/docs/api/Grid/column/PercentColumn#config-children)
+     * Child columns. To create grouped headers, specify an array of column configs as children of a parent column.
      */
-    children?: boolean|object[]|Model[]|ModelConfig[]
+    children?: GridColumnConfig[]|Column[]
     /**
      * CSS class added to the header of this column
      */
@@ -115017,8 +115082,9 @@ type PercentColumnConfig = {
      * @param {object} renderData
      * @param {Grid.column.Column} renderData.column This column
      * @param {HTMLElement} renderData.headerElement The header element
+     * @returns {string,object,void,void} The text or markup to show in the column header
      */
-    headerRenderer?: (renderData: { column: Column, headerElement: HTMLElement }) => string|object|null|void
+    headerRenderer?: (renderData: { column: Column, headerElement: HTMLElement }) => string|object|void
     /**
      * An array of the widgets to append to the column header. These widgets have this Column instance
      * as their `owner` which can be used to reference the column, and the owning Grid via `this.owner.grid`.
@@ -115620,12 +115686,9 @@ type RatingColumnConfig = {
      */
     cellMenuItems?: Record<string, MenuItemEntry>
     /**
-     * Child nodes. To allow loading children on demand, specify `children : true` in your data. Omit the field for leaf
-     * tasks.
-     * ...
-     * [View online docs...](https://bryntum.com/products/grid/docs/api/Grid/column/RatingColumn#config-children)
+     * Child columns. To create grouped headers, specify an array of column configs as children of a parent column.
      */
-    children?: boolean|object[]|Model[]|ModelConfig[]
+    children?: GridColumnConfig[]|Column[]
     /**
      * CSS class added to the header of this column
      */
@@ -115795,8 +115858,9 @@ type RatingColumnConfig = {
      * @param {object} renderData
      * @param {Grid.column.Column} renderData.column This column
      * @param {HTMLElement} renderData.headerElement The header element
+     * @returns {string,object,void,void} The text or markup to show in the column header
      */
-    headerRenderer?: (renderData: { column: Column, headerElement: HTMLElement }) => string|object|null|void
+    headerRenderer?: (renderData: { column: Column, headerElement: HTMLElement }) => string|object|void
     /**
      * An array of the widgets to append to the column header. These widgets have this Column instance
      * as their `owner` which can be used to reference the column, and the owning Grid via `this.owner.grid`.
@@ -116377,12 +116441,9 @@ type RowNumberColumnConfig = {
      */
     cellMenuItems?: Record<string, MenuItemEntry>
     /**
-     * Child nodes. To allow loading children on demand, specify `children : true` in your data. Omit the field for leaf
-     * tasks.
-     * ...
-     * [View online docs...](https://bryntum.com/products/grid/docs/api/Grid/column/RowNumberColumn#config-children)
+     * Child columns. To create grouped headers, specify an array of column configs as children of a parent column.
      */
-    children?: boolean|object[]|Model[]|ModelConfig[]
+    children?: GridColumnConfig[]|Column[]
     /**
      * CSS class added to the header of this column
      */
@@ -116475,8 +116536,9 @@ type RowNumberColumnConfig = {
      * @param {object} renderData
      * @param {Grid.column.Column} renderData.column This column
      * @param {HTMLElement} renderData.headerElement The header element
+     * @returns {string,object,void,void} The text or markup to show in the column header
      */
-    headerRenderer?: (renderData: { column: Column, headerElement: HTMLElement }) => string|object|null|void
+    headerRenderer?: (renderData: { column: Column, headerElement: HTMLElement }) => string|object|void
     /**
      * An array of the widgets to append to the column header. These widgets have this Column instance
      * as their `owner` which can be used to reference the column, and the owning Grid via `this.owner.grid`.
@@ -116986,12 +117048,9 @@ type SparklineColumnConfig = {
      */
     chartType?: 'line'|'bar'|'pie'
     /**
-     * Child nodes. To allow loading children on demand, specify `children : true` in your data. Omit the field for leaf
-     * tasks.
-     * ...
-     * [View online docs...](https://bryntum.com/products/grid/docs/api/Grid/column/SparklineColumn#config-children)
+     * Child columns. To create grouped headers, specify an array of column configs as children of a parent column.
      */
-    children?: boolean|object[]|Model[]|ModelConfig[]
+    children?: GridColumnConfig[]|Column[]
     /**
      * CSS class added to the header of this column
      */
@@ -117143,8 +117202,9 @@ type SparklineColumnConfig = {
      * @param {object} renderData
      * @param {Grid.column.Column} renderData.column This column
      * @param {HTMLElement} renderData.headerElement The header element
+     * @returns {string,object,void,void} The text or markup to show in the column header
      */
-    headerRenderer?: (renderData: { column: Column, headerElement: HTMLElement }) => string|object|null|void
+    headerRenderer?: (renderData: { column: Column, headerElement: HTMLElement }) => string|object|void
     /**
      * An array of the widgets to append to the column header. These widgets have this Column instance
      * as their `owner` which can be used to reference the column, and the owning Grid via `this.owner.grid`.
@@ -117710,12 +117770,9 @@ type TemplateColumnConfig = {
      */
     cellMenuItems?: Record<string, MenuItemEntry>
     /**
-     * Child nodes. To allow loading children on demand, specify `children : true` in your data. Omit the field for leaf
-     * tasks.
-     * ...
-     * [View online docs...](https://bryntum.com/products/grid/docs/api/Grid/column/TemplateColumn#config-children)
+     * Child columns. To create grouped headers, specify an array of column configs as children of a parent column.
      */
-    children?: boolean|object[]|Model[]|ModelConfig[]
+    children?: GridColumnConfig[]|Column[]
     /**
      * CSS class added to the header of this column
      */
@@ -117867,8 +117924,9 @@ type TemplateColumnConfig = {
      * @param {object} renderData
      * @param {Grid.column.Column} renderData.column This column
      * @param {HTMLElement} renderData.headerElement The header element
+     * @returns {string,object,void,void} The text or markup to show in the column header
      */
-    headerRenderer?: (renderData: { column: Column, headerElement: HTMLElement }) => string|object|null|void
+    headerRenderer?: (renderData: { column: Column, headerElement: HTMLElement }) => string|object|void
     /**
      * An array of the widgets to append to the column header. These widgets have this Column instance
      * as their `owner` which can be used to reference the column, and the owning Grid via `this.owner.grid`.
@@ -118434,12 +118492,9 @@ type TimeColumnConfig = {
      */
     cellMenuItems?: Record<string, MenuItemEntry>
     /**
-     * Child nodes. To allow loading children on demand, specify `children : true` in your data. Omit the field for leaf
-     * tasks.
-     * ...
-     * [View online docs...](https://bryntum.com/products/grid/docs/api/Grid/column/TimeColumn#config-children)
+     * Child columns. To create grouped headers, specify an array of column configs as children of a parent column.
      */
-    children?: boolean|object[]|Model[]|ModelConfig[]
+    children?: GridColumnConfig[]|Column[]
     /**
      * CSS class added to the header of this column
      */
@@ -118596,8 +118651,9 @@ type TimeColumnConfig = {
      * @param {object} renderData
      * @param {Grid.column.Column} renderData.column This column
      * @param {HTMLElement} renderData.headerElement The header element
+     * @returns {string,object,void,void} The text or markup to show in the column header
      */
-    headerRenderer?: (renderData: { column: Column, headerElement: HTMLElement }) => string|object|null|void
+    headerRenderer?: (renderData: { column: Column, headerElement: HTMLElement }) => string|object|void
     /**
      * An array of the widgets to append to the column header. These widgets have this Column instance
      * as their `owner` which can be used to reference the column, and the owning Grid via `this.owner.grid`.
@@ -119155,12 +119211,9 @@ type TreeColumnConfig = {
      */
     cellMenuItems?: Record<string, MenuItemEntry>
     /**
-     * Child nodes. To allow loading children on demand, specify `children : true` in your data. Omit the field for leaf
-     * tasks.
-     * ...
-     * [View online docs...](https://bryntum.com/products/grid/docs/api/Grid/column/TreeColumn#config-children)
+     * Child columns. To create grouped headers, specify an array of column configs as children of a parent column.
      */
-    children?: boolean|object[]|Model[]|ModelConfig[]
+    children?: GridColumnConfig[]|Column[]
     /**
      * CSS class added to the header of this column
      */
@@ -119328,8 +119381,9 @@ type TreeColumnConfig = {
      * @param {object} renderData
      * @param {Grid.column.Column} renderData.column This column
      * @param {HTMLElement} renderData.headerElement The header element
+     * @returns {string,object,void,void} The text or markup to show in the column header
      */
-    headerRenderer?: (renderData: { column: Column, headerElement: HTMLElement }) => string|object|null|void
+    headerRenderer?: (renderData: { column: Column, headerElement: HTMLElement }) => string|object|void
     /**
      * An array of the widgets to append to the column header. These widgets have this Column instance
      * as their `owner` which can be used to reference the column, and the owning Grid via `this.owner.grid`.
@@ -119930,12 +119984,9 @@ type WidgetColumnConfig = {
      */
     cellMenuItems?: Record<string, MenuItemEntry>
     /**
-     * Child nodes. To allow loading children on demand, specify `children : true` in your data. Omit the field for leaf
-     * tasks.
-     * ...
-     * [View online docs...](https://bryntum.com/products/grid/docs/api/Grid/column/WidgetColumn#config-children)
+     * Child columns. To create grouped headers, specify an array of column configs as children of a parent column.
      */
-    children?: boolean|object[]|Model[]|ModelConfig[]
+    children?: GridColumnConfig[]|Column[]
     /**
      * CSS class added to the header of this column
      */
@@ -120087,8 +120138,9 @@ type WidgetColumnConfig = {
      * @param {object} renderData
      * @param {Grid.column.Column} renderData.column This column
      * @param {HTMLElement} renderData.headerElement The header element
+     * @returns {string,object,void,void} The text or markup to show in the column header
      */
-    headerRenderer?: (renderData: { column: Column, headerElement: HTMLElement }) => string|object|null|void
+    headerRenderer?: (renderData: { column: Column, headerElement: HTMLElement }) => string|object|void
     /**
      * An array of the widgets to append to the column header. These widgets have this Column instance
      * as their `owner` which can be used to reference the column, and the owning Grid via `this.owner.grid`.
@@ -121204,6 +121256,13 @@ type ColumnStoreConfig = {
      * [View online docs...](https://bryntum.com/products/grid/docs/api/Grid/data/ColumnStore#config-catchEventHandlerExceptions)
      */
     catchEventHandlerExceptions?: boolean
+    /**
+     * Set to `true` to have the chained store react to expand/collapse changes in the master store.
+     * By default, expand/collapse in the master store does not trigger a refill of the chained store.
+     * ...
+     * [View online docs...](https://bryntum.com/products/grid/docs/api/Grid/data/ColumnStore#config-chainExpandCollapse)
+     */
+    chainExpandCollapse?: boolean
     /**
      * If `true`, chained stores will apply filters from the master store. Filters flagged with `ignoreForChain`
      * will be ignored.
@@ -121932,16 +121991,11 @@ export class ColumnStore extends Store {
      */
     static registerColumnType(columnClass: Function, simpleRenderer?: boolean): void;
     /**
-     * Get column by field. To be sure that you are getting exactly the intended column, use [Store#getById()](https://bryntum.com/products/grid/docs/api/Core/data/Store#function-getById) with the
-     * columns id instead.
+     * Get column by field. To be sure that you are getting exactly the intended column, use
+     * [getById](https://bryntum.com/products/grid/docs/api/Core/data/Store#function-getById) with the columns id instead.
      * @param {string} field Field name
      */
     get(field: string): Column;
-    /**
-     * Get column by id.
-     * @param {string,number} id
-     */
-    getById(id: string|number): Column;
     /**
      * indexOf extended to also accept a columns field, for backward compatibility.
      * @param {Core.data.Model,string} recordOrId
@@ -128023,7 +128077,7 @@ export class LockRows extends Split {
      */
     readonly isLockRows: boolean
     /**
-     * Locking rows leads to two chained stores that holds a subset of the records, one for the locked records and one
+     * Locking rows results in two chained stores that holds a subset of the records, one for the locked records and one
      * for the rest. This property holds the original store, if you need to access it.
      */
     originalStore: Store
@@ -144777,7 +144831,7 @@ export class GridBase extends Panel {
      */
     longPressTime: number
     /**
-     * Locking rows leads to two chained stores that holds a subset of the records, one for the locked records and one
+     * Locking rows results in two chained stores that holds a subset of the records, one for the locked records and one
      * for the rest. This property holds the original store, if you need to access it.
      */
     originalStore: Store