@bryntum/grid-thin-trial 7.3.1 → 7.3.3

package/grid.d.ts

@@ -673,7 +673,7 @@ type ActionColumnConfig = {
      */
     alwaysClearCell?: boolean
     /**
-     * The `aria-label` to use for this Column`s header element
+     * The `aria-label` to use for this Column's header element
      */
     ariaLabel?: string
     /**
@@ -1316,7 +1316,7 @@ type AggregateColumnConfig = {
      */
     alwaysClearCell?: boolean
     /**
-     * The `aria-label` to use for this Column`s header element
+     * The `aria-label` to use for this Column's header element
      */
     ariaLabel?: string
     /**
@@ -2057,7 +2057,7 @@ type ChartColumnConfig = {
      */
     alwaysClearCell?: boolean
     /**
-     * The `aria-label` to use for this Column`s header element
+     * The `aria-label` to use for this Column's header element
      */
     ariaLabel?: string
     /**
@@ -2795,7 +2795,7 @@ type CheckColumnConfig = {
      */
     alwaysClearCell?: boolean
     /**
-     * The `aria-label` to use for this Column`s header element
+     * The `aria-label` to use for this Column's header element
      */
     ariaLabel?: string
     /**
@@ -3557,7 +3557,7 @@ type ColorColumnConfig = {
      */
     alwaysClearCell?: boolean
     /**
-     * The `aria-label` to use for this Column`s header element
+     * The `aria-label` to use for this Column's header element
      */
     ariaLabel?: string
     /**
@@ -4252,7 +4252,7 @@ type ColumnConfig = {
      */
     alwaysClearCell?: boolean
     /**
-     * The `aria-label` to use for this Column`s header element
+     * The `aria-label` to use for this Column's header element
      */
     ariaLabel?: string
     /**
@@ -4826,7 +4826,7 @@ export class Column extends Model {
      */
     alwaysClearCell: boolean
     /**
-     * The `aria-label` to use for this Column`s header element
+     * The `aria-label` to use for this Column's header element
      */
     ariaLabel: string
     /**
@@ -5522,7 +5522,7 @@ type CurrencyColumnConfig = {
      */
     alwaysClearCell?: boolean
     /**
-     * The `aria-label` to use for this Column`s header element
+     * The `aria-label` to use for this Column's header element
      */
     ariaLabel?: string
     /**
@@ -6240,7 +6240,7 @@ type DateColumnConfig = {
      */
     alwaysClearCell?: boolean
     /**
-     * The `aria-label` to use for this Column`s header element
+     * The `aria-label` to use for this Column's header element
      */
     ariaLabel?: string
     /**
@@ -6965,7 +6965,7 @@ type NumberColumnConfig = {
      */
     alwaysClearCell?: boolean
     /**
-     * The `aria-label` to use for this Column`s header element
+     * The `aria-label` to use for this Column's header element
      */
     ariaLabel?: string
     /**
@@ -7705,7 +7705,7 @@ type PercentColumnConfig = {
      */
     alwaysClearCell?: boolean
     /**
-     * The `aria-label` to use for this Column`s header element
+     * The `aria-label` to use for this Column's header element
      */
     ariaLabel?: string
     /**
@@ -8431,7 +8431,7 @@ type RatingColumnConfig = {
      */
     alwaysClearCell?: boolean
     /**
-     * The `aria-label` to use for this Column`s header element
+     * The `aria-label` to use for this Column's header element
      */
     ariaLabel?: string
     /**
@@ -9154,7 +9154,7 @@ type RowNumberColumnConfig = {
      */
     alwaysClearCell?: boolean
     /**
-     * The `aria-label` to use for this Column`s header element
+     * The `aria-label` to use for this Column's header element
      */
     ariaLabel?: string
     /**
@@ -9715,7 +9715,7 @@ type SparklineColumnConfig = {
      */
     alwaysClearCell?: boolean
     /**
-     * The `aria-label` to use for this Column`s header element
+     * The `aria-label` to use for this Column's header element
      */
     ariaLabel?: string
     /**
@@ -10414,7 +10414,7 @@ type TemplateColumnConfig = {
      */
     alwaysClearCell?: boolean
     /**
-     * The `aria-label` to use for this Column`s header element
+     * The `aria-label` to use for this Column's header element
      */
     ariaLabel?: string
     /**
@@ -11100,7 +11100,7 @@ type TimeColumnConfig = {
      */
     alwaysClearCell?: boolean
     /**
-     * The `aria-label` to use for this Column`s header element
+     * The `aria-label` to use for this Column's header element
      */
     ariaLabel?: string
     /**
@@ -11783,7 +11783,7 @@ type TreeColumnConfig = {
      */
     alwaysClearCell?: boolean
     /**
-     * The `aria-label` to use for this Column`s header element
+     * The `aria-label` to use for this Column's header element
      */
     ariaLabel?: string
     /**
@@ -12519,7 +12519,7 @@ type WidgetColumnConfig = {
      */
     alwaysClearCell?: boolean
     /**
-     * The `aria-label` to use for this Column`s header element
+     * The `aria-label` to use for this Column's header element
      */
     ariaLabel?: string
     /**
@@ -16031,6 +16031,8 @@ type CellTooltipConfig = {
     /**
      * Element (or the id of an element) to append this widget's element to. Can be configured, or set once at
      * runtime. To access the element of a rendered widget, see [element](https://bryntum.com/products/grid/docs/api/Core/widget/Widget#property-element).
+     * <div class="note">When creating nested trees of widgets, this should only be used on the outermost widget.
+     * [More...](https://bryntum.com/products/grid/docs/api/Grid/feature/CellTooltip#config-appendTo)
      */
     appendTo?: HTMLElement|string
     /**
@@ -16098,9 +16100,10 @@ type CellTooltipConfig = {
     catchEventHandlerExceptions?: boolean
     /**
      * *Only valid if this Widget is [floating](https://bryntum.com/products/grid/docs/api/Core/widget/Widget#config-floating).*
-     * Set to `true` to centre the Widget in browser viewport space.
+     * [More...](https://bryntum.com/products/grid/docs/api/Grid/feature/CellTooltip#config-centered)
+     * @property {boolean} [once] If `true`, the Widget will be centred on its first show, but if it is moved at runtime, it will opt out of centering for future shows.
      */
-    centered?: boolean
+    centered?: boolean|object
     /**
      * The widget which this plugin is to attach to.
      */
@@ -16292,10 +16295,11 @@ type CellTooltipConfig = {
      * @param {Core.widget.Tooltip} context.tip The tooltip instance
      * @param {HTMLElement} context.element The Element for which the Tooltip is monitoring mouse movement
      * @param {HTMLElement} context.activeTarget The target element that triggered the show
+     * @param {HTMLElement} [context.forElement] Alias for `activeTarget`, provided for backward compatibility
      * @param {Event} context.event The raw DOM event
      * @returns {string,Promise<any>}
      */
-    getHtml?: ((context: { tip: Tooltip, element: HTMLElement, activeTarget: HTMLElement, event: Event }) => Promise<string|Promise<any>>)|string
+    getHtml?: ((context: { tip: Tooltip, element: HTMLElement, activeTarget: HTMLElement, forElement?: HTMLElement, event: Event }) => Promise<string|Promise<any>>)|string
     /**
      * A config [object](https://bryntum.com/products/grid/docs/api/Core/widget/Panel#typedef-PanelHeader) for the panel's header or a string in place of a `title`.
      * [More...](https://bryntum.com/products/grid/docs/api/Grid/feature/CellTooltip#config-header)
@@ -16371,10 +16375,14 @@ type CellTooltipConfig = {
     inputFieldAlign?: 'start'|'end'
     /**
      * Element (or element id) to insert this widget before. If provided, [appendTo](https://bryntum.com/products/grid/docs/api/Core/widget/Widget#config-appendTo) config is ignored.
+     * <div class="note">When creating nested trees of widgets, this should only be used on the outermost widget.
+     * [More...](https://bryntum.com/products/grid/docs/api/Grid/feature/CellTooltip#config-insertBefore)
      */
     insertBefore?: HTMLElement|string
     /**
      * Element (or element id) to append this widget element to, as a first child. If provided, [appendTo](https://bryntum.com/products/grid/docs/api/Core/widget/Widget#config-appendTo) config is ignored.
+     * <div class="note">When creating nested trees of widgets, this should only be used on the outermost widget.
+     * [More...](https://bryntum.com/products/grid/docs/api/Grid/feature/CellTooltip#config-insertFirst)
      */
     insertFirst?: HTMLElement|string
     /**
@@ -16400,7 +16408,7 @@ type CellTooltipConfig = {
      */
     labelPosition?: 'before'|'above'|'align-before'|'auto'|null
     /**
-     * Sets `labelWidth´ for all children of this Container, that does not define their own `labelWidth`.
+     * Sets `labelWidth` for all children of this Container, that do not define their own `labelWidth`.
      * [More...](https://bryntum.com/products/grid/docs/api/Grid/feature/CellTooltip#config-labelWidth)
      */
     labelWidth?: number|null
@@ -16617,7 +16625,7 @@ type CellTooltipConfig = {
     rtl?: boolean
     /**
      * Defines what to do if document is scrolled while Widget is visible (only relevant when floating is set to `true`).
-     * Valid values: ´null´: do nothing, ´hide´: hide the widget or ´realign´: realign to the target if possible.
+     * Valid values: `null`: do nothing, `hide`: hide the widget or `realign`: realign to the target if possible.
      */
     scrollAction?: 'hide'|'realign'|null
     /**
@@ -26162,8 +26170,8 @@ type PdfExportConfig = {
      */
     fileName?: string
     /**
-     * A template function used to generate a page footer. It is passed an object with ´currentPage´ and
-     * `totalPages´ properties.
+     * A template function used to generate a page footer. It is passed an object with `currentPage` and
+     * `totalPages` properties.
      * [More...](https://bryntum.com/products/grid/docs/api/Grid/feature/export/PdfExport#config-footerTpl)
      * @param {object} data Data object
      * @param {number} data.currentPage Current page number
@@ -26172,8 +26180,8 @@ type PdfExportConfig = {
      */
     footerTpl?: (data: { currentPage: number, totalPages: number }) => string
     /**
-     * A template function used to generate a page header. It is passed an object with ´currentPage´ and
-     * `totalPages´ properties.
+     * A template function used to generate a page header. It is passed an object with `currentPage` and
+     * `totalPages` properties.
      * [More...](https://bryntum.com/products/grid/docs/api/Grid/feature/export/PdfExport#config-headerTpl)
      * @param {object} data Data object
      * @param {number} data.currentPage Current page number
@@ -26603,8 +26611,8 @@ type PrintConfig = {
      */
     exporters?: Exporter[]
     /**
-     * A template function used to generate a page footer. It is passed an object with ´currentPage´ and
-     * `totalPages´ properties.
+     * A template function used to generate a page footer. It is passed an object with `currentPage` and
+     * `totalPages` properties.
      * [More...](https://bryntum.com/products/grid/docs/api/Grid/feature/export/Print#config-footerTpl)
      * @param {object} data Data object
      * @param {number} data.currentPage Current page number
@@ -26613,8 +26621,8 @@ type PrintConfig = {
      */
     footerTpl?: (data: { currentPage: number, totalPages: number }) => string
     /**
-     * A template function used to generate a page header. It is passed an object with ´currentPage´ and
-     * `totalPages´ properties.
+     * A template function used to generate a page header. It is passed an object with `currentPage` and
+     * `totalPages` properties.
      * [More...](https://bryntum.com/products/grid/docs/api/Grid/feature/export/Print#config-headerTpl)
      * @param {object} data Data object
      * @param {number} data.currentPage Current page number
@@ -30553,6 +30561,8 @@ type GridConfig = {
     /**
      * Element (or the id of an element) to append this widget's element to. Can be configured, or set once at
      * runtime. To access the element of a rendered widget, see [element](https://bryntum.com/products/grid/docs/api/Core/widget/Widget#property-element).
+     * <div class="note">When creating nested trees of widgets, this should only be used on the outermost widget.
+     * [More...](https://bryntum.com/products/grid/docs/api/Grid/view/Grid#config-appendTo)
      */
     appendTo?: HTMLElement|string
     /**
@@ -30867,10 +30877,14 @@ type GridConfig = {
     inputFieldAlign?: 'start'|'end'
     /**
      * Element (or element id) to insert this widget before. If provided, [appendTo](https://bryntum.com/products/grid/docs/api/Core/widget/Widget#config-appendTo) config is ignored.
+     * <div class="note">When creating nested trees of widgets, this should only be used on the outermost widget.
+     * [More...](https://bryntum.com/products/grid/docs/api/Grid/view/Grid#config-insertBefore)
      */
     insertBefore?: HTMLElement|string
     /**
      * Element (or element id) to append this widget element to, as a first child. If provided, [appendTo](https://bryntum.com/products/grid/docs/api/Core/widget/Widget#config-appendTo) config is ignored.
+     * <div class="note">When creating nested trees of widgets, this should only be used on the outermost widget.
+     * [More...](https://bryntum.com/products/grid/docs/api/Grid/view/Grid#config-insertFirst)
      */
     insertFirst?: HTMLElement|string
     /**
@@ -30883,7 +30897,7 @@ type GridConfig = {
      */
     labelPosition?: 'before'|'above'|'align-before'|'auto'|null
     /**
-     * Sets `labelWidth´ for all children of this Container, that does not define their own `labelWidth`.
+     * Sets `labelWidth` for all children of this Container, that do not define their own `labelWidth`.
      * [More...](https://bryntum.com/products/grid/docs/api/Grid/view/Grid#config-labelWidth)
      */
     labelWidth?: number|null
@@ -34608,6 +34622,8 @@ type GridBaseConfig = {
     /**
      * Element (or the id of an element) to append this widget's element to. Can be configured, or set once at
      * runtime. To access the element of a rendered widget, see [element](https://bryntum.com/products/grid/docs/api/Core/widget/Widget#property-element).
+     * <div class="note">When creating nested trees of widgets, this should only be used on the outermost widget.
+     * [More...](https://bryntum.com/products/grid/docs/api/Grid/view/GridBase#config-appendTo)
      */
     appendTo?: HTMLElement|string
     /**
@@ -34922,10 +34938,14 @@ type GridBaseConfig = {
     inputFieldAlign?: 'start'|'end'
     /**
      * Element (or element id) to insert this widget before. If provided, [appendTo](https://bryntum.com/products/grid/docs/api/Core/widget/Widget#config-appendTo) config is ignored.
+     * <div class="note">When creating nested trees of widgets, this should only be used on the outermost widget.
+     * [More...](https://bryntum.com/products/grid/docs/api/Grid/view/GridBase#config-insertBefore)
      */
     insertBefore?: HTMLElement|string
     /**
      * Element (or element id) to append this widget element to, as a first child. If provided, [appendTo](https://bryntum.com/products/grid/docs/api/Core/widget/Widget#config-appendTo) config is ignored.
+     * <div class="note">When creating nested trees of widgets, this should only be used on the outermost widget.
+     * [More...](https://bryntum.com/products/grid/docs/api/Grid/view/GridBase#config-insertFirst)
      */
     insertFirst?: HTMLElement|string
     /**
@@ -34938,7 +34958,7 @@ type GridBaseConfig = {
      */
     labelPosition?: 'before'|'above'|'align-before'|'auto'|null
     /**
-     * Sets `labelWidth´ for all children of this Container, that does not define their own `labelWidth`.
+     * Sets `labelWidth` for all children of this Container, that do not define their own `labelWidth`.
      * [More...](https://bryntum.com/products/grid/docs/api/Grid/view/GridBase#config-labelWidth)
      */
     labelWidth?: number|null
@@ -38381,9 +38401,10 @@ type SubGridConfig = {
     catchEventHandlerExceptions?: boolean
     /**
      * *Only valid if this Widget is [floating](https://bryntum.com/products/grid/docs/api/Core/widget/Widget#config-floating).*
-     * Set to `true` to centre the Widget in browser viewport space.
+     * [More...](https://bryntum.com/products/grid/docs/api/Grid/view/SubGrid#config-centered)
+     * @property {boolean} [once] If `true`, the Widget will be centred on its first show, but if it is moved at runtime, it will opt out of centering for future shows.
      */
-    centered?: boolean
+    centered?: boolean|object
     /**
      * Custom CSS classes to add to element.
      * May be specified as a space separated string, or as an object in which property names
@@ -41080,6 +41101,8 @@ type TreeGridConfig = {
     /**
      * Element (or the id of an element) to append this widget's element to. Can be configured, or set once at
      * runtime. To access the element of a rendered widget, see [element](https://bryntum.com/products/grid/docs/api/Core/widget/Widget#property-element).
+     * <div class="note">When creating nested trees of widgets, this should only be used on the outermost widget.
+     * [More...](https://bryntum.com/products/grid/docs/api/Grid/view/TreeGrid#config-appendTo)
      */
     appendTo?: HTMLElement|string
     /**
@@ -41394,10 +41417,14 @@ type TreeGridConfig = {
     inputFieldAlign?: 'start'|'end'
     /**
      * Element (or element id) to insert this widget before. If provided, [appendTo](https://bryntum.com/products/grid/docs/api/Core/widget/Widget#config-appendTo) config is ignored.
+     * <div class="note">When creating nested trees of widgets, this should only be used on the outermost widget.
+     * [More...](https://bryntum.com/products/grid/docs/api/Grid/view/TreeGrid#config-insertBefore)
      */
     insertBefore?: HTMLElement|string
     /**
      * Element (or element id) to append this widget element to, as a first child. If provided, [appendTo](https://bryntum.com/products/grid/docs/api/Core/widget/Widget#config-appendTo) config is ignored.
+     * <div class="note">When creating nested trees of widgets, this should only be used on the outermost widget.
+     * [More...](https://bryntum.com/products/grid/docs/api/Grid/view/TreeGrid#config-insertFirst)
      */
     insertFirst?: HTMLElement|string
     /**
@@ -41410,7 +41437,7 @@ type TreeGridConfig = {
      */
     labelPosition?: 'before'|'above'|'align-before'|'auto'|null
     /**
-     * Sets `labelWidth´ for all children of this Container, that does not define their own `labelWidth`.
+     * Sets `labelWidth` for all children of this Container, that do not define their own `labelWidth`.
      * [More...](https://bryntum.com/products/grid/docs/api/Grid/view/TreeGrid#config-labelWidth)
      */
     labelWidth?: number|null
@@ -43391,6 +43418,8 @@ type ExportDialogConfig = {
     /**
      * Element (or the id of an element) to append this widget's element to. Can be configured, or set once at
      * runtime. To access the element of a rendered widget, see [element](https://bryntum.com/products/grid/docs/api/Core/widget/Widget#property-element).
+     * <div class="note">When creating nested trees of widgets, this should only be used on the outermost widget.
+     * [More...](https://bryntum.com/products/grid/docs/api/Grid/view/export/ExportDialog#config-appendTo)
      */
     appendTo?: HTMLElement|string
     /**
@@ -43458,9 +43487,10 @@ type ExportDialogConfig = {
     catchEventHandlerExceptions?: boolean
     /**
      * *Only valid if this Widget is [floating](https://bryntum.com/products/grid/docs/api/Core/widget/Widget#config-floating).*
-     * Set to `true` to centre the Widget in browser viewport space.
+     * [More...](https://bryntum.com/products/grid/docs/api/Grid/view/export/ExportDialog#config-centered)
+     * @property {boolean} [once] If `true`, the Widget will be centred on its first show, but if it is moved at runtime, it will opt out of centering for future shows.
      */
-    centered?: boolean
+    centered?: boolean|object
     /**
      * Grid instance to build export dialog for
      */
@@ -43692,10 +43722,14 @@ type ExportDialogConfig = {
     inputFieldAlign?: 'start'|'end'
     /**
      * Element (or element id) to insert this widget before. If provided, [appendTo](https://bryntum.com/products/grid/docs/api/Core/widget/Widget#config-appendTo) config is ignored.
+     * <div class="note">When creating nested trees of widgets, this should only be used on the outermost widget.
+     * [More...](https://bryntum.com/products/grid/docs/api/Grid/view/export/ExportDialog#config-insertBefore)
      */
     insertBefore?: HTMLElement|string
     /**
      * Element (or element id) to append this widget element to, as a first child. If provided, [appendTo](https://bryntum.com/products/grid/docs/api/Core/widget/Widget#config-appendTo) config is ignored.
+     * <div class="note">When creating nested trees of widgets, this should only be used on the outermost widget.
+     * [More...](https://bryntum.com/products/grid/docs/api/Grid/view/export/ExportDialog#config-insertFirst)
      */
     insertFirst?: HTMLElement|string
     /**
@@ -43721,7 +43755,7 @@ type ExportDialogConfig = {
      */
     labelPosition?: 'before'|'above'|'align-before'|'auto'|null
     /**
-     * Sets `labelWidth´ for all children of this Container, that does not define their own `labelWidth`.
+     * Sets `labelWidth` for all children of this Container, that do not define their own `labelWidth`.
      * [More...](https://bryntum.com/products/grid/docs/api/Grid/view/export/ExportDialog#config-labelWidth)
      */
     labelWidth?: number|null
@@ -43926,7 +43960,7 @@ type ExportDialogConfig = {
     rtl?: boolean
     /**
      * Defines what to do if document is scrolled while Widget is visible (only relevant when floating is set to `true`).
-     * Valid values: ´null´: do nothing, ´hide´: hide the widget or ´realign´: realign to the target if possible.
+     * Valid values: `null`: do nothing, `hide`: hide the widget or `realign`: realign to the target if possible.
      */
     scrollAction?: 'hide'|'realign'|null
     /**
@@ -44276,7 +44310,7 @@ export class ExportDialog extends Popup {
     /**
      * Returns map of values of dialog fields.
      */
-    readonly values: Record<string, object>
+    values: Record<string, object>
     /**
      * Fires before an object is destroyed.
      * @param {object} event Event object
@@ -45390,6 +45424,8 @@ type AIFilterFieldConfig = {
     /**
      * Element (or the id of an element) to append this widget's element to. Can be configured, or set once at
      * runtime. To access the element of a rendered widget, see [element](https://bryntum.com/products/grid/docs/api/Core/widget/Widget#property-element).
+     * <div class="note">When creating nested trees of widgets, this should only be used on the outermost widget.
+     * [More...](https://bryntum.com/products/grid/docs/api/Grid/widget/AIFilterField#config-appendTo)
      */
     appendTo?: HTMLElement|string
     /**
@@ -45436,9 +45472,10 @@ type AIFilterFieldConfig = {
     catchEventHandlerExceptions?: boolean
     /**
      * *Only valid if this Widget is [floating](https://bryntum.com/products/grid/docs/api/Core/widget/Widget#config-floating).*
-     * Set to `true` to centre the Widget in browser viewport space.
+     * [More...](https://bryntum.com/products/grid/docs/api/Grid/widget/AIFilterField#config-centered)
+     * @property {boolean} [once] If `true`, the Widget will be centred on its first show, but if it is moved at runtime, it will opt out of centering for future shows.
      */
-    centered?: boolean
+    centered?: boolean|object
     /**
      * A function (or the name of a function in the ownership hierarchy) called during field validation
      * to perform custom validity checks. The function is called as part of the [isValid](https://bryntum.com/products/grid/docs/api/Core/widget/Field#property-isValid)
@@ -45539,7 +45576,7 @@ type AIFilterFieldConfig = {
     dock?: 'top'|'bottom'|'left'|'right'|'start'|'end'|'header'|'pre-header'|object
     /**
      * *Only valid if this Widget is [floating](https://bryntum.com/products/grid/docs/api/Core/widget/Widget#config-floating).*
-     * Set to `true` to be able to drag a widget freely on the page. Or set to an object with a ´handleSelector´
+     * Set to `true` to be able to drag a widget freely on the page. Or set to an object with a `handleSelector`
      * property which controls when a drag should start.
      * [More...](https://bryntum.com/products/grid/docs/api/Grid/widget/AIFilterField#config-draggable)
      * @property {string} handleSelector CSS selector used to determine if drag can be started from a mouse-downed element inside the widget
@@ -45654,10 +45691,14 @@ type AIFilterFieldConfig = {
     inputWidth?: string|number
     /**
      * Element (or element id) to insert this widget before. If provided, [appendTo](https://bryntum.com/products/grid/docs/api/Core/widget/Widget#config-appendTo) config is ignored.
+     * <div class="note">When creating nested trees of widgets, this should only be used on the outermost widget.
+     * [More...](https://bryntum.com/products/grid/docs/api/Grid/widget/AIFilterField#config-insertBefore)
      */
     insertBefore?: HTMLElement|string
     /**
      * Element (or element id) to append this widget element to, as a first child. If provided, [appendTo](https://bryntum.com/products/grid/docs/api/Core/widget/Widget#config-appendTo) config is ignored.
+     * <div class="note">When creating nested trees of widgets, this should only be used on the outermost widget.
+     * [More...](https://bryntum.com/products/grid/docs/api/Grid/widget/AIFilterField#config-insertFirst)
      */
     insertFirst?: HTMLElement|string
     /**
@@ -45871,7 +45912,7 @@ type AIFilterFieldConfig = {
     rtl?: boolean
     /**
      * Defines what to do if document is scrolled while Widget is visible (only relevant when floating is set to `true`).
-     * Valid values: ´null´: do nothing, ´hide´: hide the widget or ´realign´: realign to the target if possible.
+     * Valid values: `null`: do nothing, `hide`: hide the widget or `realign`: realign to the target if possible.
      */
     scrollAction?: 'hide'|'realign'|null
     /**
@@ -46536,6 +46577,8 @@ type ChecklistFilterComboConfig = {
     /**
      * Element (or the id of an element) to append this widget's element to. Can be configured, or set once at
      * runtime. To access the element of a rendered widget, see [element](https://bryntum.com/products/grid/docs/api/Core/widget/Widget#property-element).
+     * <div class="note">When creating nested trees of widgets, this should only be used on the outermost widget.
+     * [More...](https://bryntum.com/products/grid/docs/api/Grid/widget/ChecklistFilterCombo#config-appendTo)
      */
     appendTo?: HTMLElement|string
     /**
@@ -46595,9 +46638,10 @@ type ChecklistFilterComboConfig = {
     catchEventHandlerExceptions?: boolean
     /**
      * *Only valid if this Widget is [floating](https://bryntum.com/products/grid/docs/api/Core/widget/Widget#config-floating).*
-     * Set to `true` to centre the Widget in browser viewport space.
+     * [More...](https://bryntum.com/products/grid/docs/api/Grid/widget/ChecklistFilterCombo#config-centered)
+     * @property {boolean} [once] If `true`, the Widget will be centred on its first show, but if it is moved at runtime, it will opt out of centering for future shows.
      */
-    centered?: boolean
+    centered?: boolean|object
     /**
      * A function (or the name of a function in the ownership hierarchy) called during field validation
      * to perform custom validity checks. The function is called as part of the [isValid](https://bryntum.com/products/grid/docs/api/Core/widget/Field#property-isValid)
@@ -46732,7 +46776,7 @@ type ChecklistFilterComboConfig = {
     dock?: 'top'|'bottom'|'left'|'right'|'start'|'end'|'header'|'pre-header'|object
     /**
      * *Only valid if this Widget is [floating](https://bryntum.com/products/grid/docs/api/Core/widget/Widget#config-floating).*
-     * Set to `true` to be able to drag a widget freely on the page. Or set to an object with a ´handleSelector´
+     * Set to `true` to be able to drag a widget freely on the page. Or set to an object with a `handleSelector`
      * property which controls when a drag should start.
      * [More...](https://bryntum.com/products/grid/docs/api/Grid/widget/ChecklistFilterCombo#config-draggable)
      * @property {string} handleSelector CSS selector used to determine if drag can be started from a mouse-downed element inside the widget
@@ -46898,10 +46942,14 @@ type ChecklistFilterComboConfig = {
     inputWidth?: string|number
     /**
      * Element (or element id) to insert this widget before. If provided, [appendTo](https://bryntum.com/products/grid/docs/api/Core/widget/Widget#config-appendTo) config is ignored.
+     * <div class="note">When creating nested trees of widgets, this should only be used on the outermost widget.
+     * [More...](https://bryntum.com/products/grid/docs/api/Grid/widget/ChecklistFilterCombo#config-insertBefore)
      */
     insertBefore?: HTMLElement|string
     /**
      * Element (or element id) to append this widget element to, as a first child. If provided, [appendTo](https://bryntum.com/products/grid/docs/api/Core/widget/Widget#config-appendTo) config is ignored.
+     * <div class="note">When creating nested trees of widgets, this should only be used on the outermost widget.
+     * [More...](https://bryntum.com/products/grid/docs/api/Grid/widget/ChecklistFilterCombo#config-insertFirst)
      */
     insertFirst?: HTMLElement|string
     /**
@@ -47175,7 +47223,7 @@ type ChecklistFilterComboConfig = {
     rtl?: boolean
     /**
      * Defines what to do if document is scrolled while Widget is visible (only relevant when floating is set to `true`).
-     * Valid values: ´null´: do nothing, ´hide´: hide the widget or ´realign´: realign to the target if possible.
+     * Valid values: `null`: do nothing, `hide`: hide the widget or `realign`: realign to the target if possible.
      */
     scrollAction?: 'hide'|'realign'|null
     /**
@@ -47778,6 +47826,8 @@ type GridChartDesignerConfig = {
     /**
      * Element (or the id of an element) to append this widget's element to. Can be configured, or set once at
      * runtime. To access the element of a rendered widget, see [element](https://bryntum.com/products/grid/docs/api/Core/widget/Widget#property-element).
+     * <div class="note">When creating nested trees of widgets, this should only be used on the outermost widget.
+     * [More...](https://bryntum.com/products/grid/docs/api/Grid/widget/GridChartDesigner#config-appendTo)
      */
     appendTo?: HTMLElement|string
     /**
@@ -47811,9 +47861,10 @@ type GridChartDesignerConfig = {
     catchEventHandlerExceptions?: boolean
     /**
      * *Only valid if this Widget is [floating](https://bryntum.com/products/grid/docs/api/Core/widget/Widget#config-floating).*
-     * Set to `true` to centre the Widget in browser viewport space.
+     * [More...](https://bryntum.com/products/grid/docs/api/Grid/widget/GridChartDesigner#config-centered)
+     * @property {boolean} [once] If `true`, the Widget will be centred on its first show, but if it is moved at runtime, it will opt out of centering for future shows.
      */
-    centered?: boolean
+    centered?: boolean|object
     /**
      * Custom CSS classes to add to element.
      * May be specified as a space separated string, or as an object in which property names
@@ -47886,7 +47937,7 @@ type GridChartDesignerConfig = {
     dock?: 'top'|'bottom'|'left'|'right'|'start'|'end'|'header'|'pre-header'|object
     /**
      * *Only valid if this Widget is [floating](https://bryntum.com/products/grid/docs/api/Core/widget/Widget#config-floating).*
-     * Set to `true` to be able to drag a widget freely on the page. Or set to an object with a ´handleSelector´
+     * Set to `true` to be able to drag a widget freely on the page. Or set to an object with a `handleSelector`
      * property which controls when a drag should start.
      * [More...](https://bryntum.com/products/grid/docs/api/Grid/widget/GridChartDesigner#config-draggable)
      * @property {string} handleSelector CSS selector used to determine if drag can be started from a mouse-downed element inside the widget
@@ -47953,10 +48004,14 @@ type GridChartDesignerConfig = {
     ignoreParentReadOnly?: boolean
     /**
      * Element (or element id) to insert this widget before. If provided, [appendTo](https://bryntum.com/products/grid/docs/api/Core/widget/Widget#config-appendTo) config is ignored.
+     * <div class="note">When creating nested trees of widgets, this should only be used on the outermost widget.
+     * [More...](https://bryntum.com/products/grid/docs/api/Grid/widget/GridChartDesigner#config-insertBefore)
      */
     insertBefore?: HTMLElement|string
     /**
      * Element (or element id) to append this widget element to, as a first child. If provided, [appendTo](https://bryntum.com/products/grid/docs/api/Core/widget/Widget#config-appendTo) config is ignored.
+     * <div class="note">When creating nested trees of widgets, this should only be used on the outermost widget.
+     * [More...](https://bryntum.com/products/grid/docs/api/Grid/widget/GridChartDesigner#config-insertFirst)
      */
     insertFirst?: HTMLElement|string
     /**
@@ -48098,7 +48153,7 @@ type GridChartDesignerConfig = {
     rtl?: boolean
     /**
      * Defines what to do if document is scrolled while Widget is visible (only relevant when floating is set to `true`).
-     * Valid values: ´null´: do nothing, ´hide´: hide the widget or ´realign´: realign to the target if possible.
+     * Valid values: `null`: do nothing, `hide`: hide the widget or `realign`: realign to the target if possible.
      */
     scrollAction?: 'hide'|'realign'|null
     /**
@@ -48639,6 +48694,8 @@ type GridFieldFilterPickerConfig = {
     /**
      * Element (or the id of an element) to append this widget's element to. Can be configured, or set once at
      * runtime. To access the element of a rendered widget, see [element](https://bryntum.com/products/grid/docs/api/Core/widget/Widget#property-element).
+     * <div class="note">When creating nested trees of widgets, this should only be used on the outermost widget.
+     * [More...](https://bryntum.com/products/grid/docs/api/Grid/widget/GridFieldFilterPicker#config-appendTo)
      */
     appendTo?: HTMLElement|string
     /**
@@ -48680,9 +48737,10 @@ type GridFieldFilterPickerConfig = {
     catchEventHandlerExceptions?: boolean
     /**
      * *Only valid if this Widget is [floating](https://bryntum.com/products/grid/docs/api/Core/widget/Widget#config-floating).*
-     * Set to `true` to centre the Widget in browser viewport space.
+     * [More...](https://bryntum.com/products/grid/docs/api/Grid/widget/GridFieldFilterPicker#config-centered)
+     * @property {boolean} [once] If `true`, the Widget will be centred on its first show, but if it is moved at runtime, it will opt out of centering for future shows.
      */
-    centered?: boolean
+    centered?: boolean|object
     /**
      * Custom CSS classes to add to element.
      * May be specified as a space separated string, or as an object in which property names
@@ -48770,7 +48828,7 @@ type GridFieldFilterPickerConfig = {
     dock?: 'top'|'bottom'|'left'|'right'|'start'|'end'|'header'|'pre-header'|object
     /**
      * *Only valid if this Widget is [floating](https://bryntum.com/products/grid/docs/api/Core/widget/Widget#config-floating).*
-     * Set to `true` to be able to drag a widget freely on the page. Or set to an object with a ´handleSelector´
+     * Set to `true` to be able to drag a widget freely on the page. Or set to an object with a `handleSelector`
      * property which controls when a drag should start.
      * [More...](https://bryntum.com/products/grid/docs/api/Grid/widget/GridFieldFilterPicker#config-draggable)
      * @property {string} handleSelector CSS selector used to determine if drag can be started from a mouse-downed element inside the widget
@@ -48873,10 +48931,14 @@ type GridFieldFilterPickerConfig = {
     inputFieldAlign?: 'start'|'end'
     /**
      * Element (or element id) to insert this widget before. If provided, [appendTo](https://bryntum.com/products/grid/docs/api/Core/widget/Widget#config-appendTo) config is ignored.
+     * <div class="note">When creating nested trees of widgets, this should only be used on the outermost widget.
+     * [More...](https://bryntum.com/products/grid/docs/api/Grid/widget/GridFieldFilterPicker#config-insertBefore)
      */
     insertBefore?: HTMLElement|string
     /**
      * Element (or element id) to append this widget element to, as a first child. If provided, [appendTo](https://bryntum.com/products/grid/docs/api/Core/widget/Widget#config-appendTo) config is ignored.
+     * <div class="note">When creating nested trees of widgets, this should only be used on the outermost widget.
+     * [More...](https://bryntum.com/products/grid/docs/api/Grid/widget/GridFieldFilterPicker#config-insertFirst)
      */
     insertFirst?: HTMLElement|string
     /**
@@ -48902,7 +48964,7 @@ type GridFieldFilterPickerConfig = {
      */
     labelPosition?: 'before'|'above'|'align-before'|'auto'|null
     /**
-     * Sets `labelWidth´ for all children of this Container, that does not define their own `labelWidth`.
+     * Sets `labelWidth` for all children of this Container, that do not define their own `labelWidth`.
      * [More...](https://bryntum.com/products/grid/docs/api/Grid/widget/GridFieldFilterPicker#config-labelWidth)
      */
     labelWidth?: number|null
@@ -49088,7 +49150,7 @@ type GridFieldFilterPickerConfig = {
     rtl?: boolean
     /**
      * Defines what to do if document is scrolled while Widget is visible (only relevant when floating is set to `true`).
-     * Valid values: ´null´: do nothing, ´hide´: hide the widget or ´realign´: realign to the target if possible.
+     * Valid values: `null`: do nothing, `hide`: hide the widget or `realign`: realign to the target if possible.
      */
     scrollAction?: 'hide'|'realign'|null
     /**
@@ -49698,6 +49760,8 @@ type GridFieldFilterPickerGroupConfig = {
     /**
      * Element (or the id of an element) to append this widget's element to. Can be configured, or set once at
      * runtime. To access the element of a rendered widget, see [element](https://bryntum.com/products/grid/docs/api/Core/widget/Widget#property-element).
+     * <div class="note">When creating nested trees of widgets, this should only be used on the outermost widget.
+     * [More...](https://bryntum.com/products/grid/docs/api/Grid/widget/GridFieldFilterPickerGroup#config-appendTo)
      */
     appendTo?: HTMLElement|string
     /**
@@ -49755,9 +49819,10 @@ type GridFieldFilterPickerGroupConfig = {
     catchEventHandlerExceptions?: boolean
     /**
      * *Only valid if this Widget is [floating](https://bryntum.com/products/grid/docs/api/Core/widget/Widget#config-floating).*
-     * Set to `true` to centre the Widget in browser viewport space.
+     * [More...](https://bryntum.com/products/grid/docs/api/Grid/widget/GridFieldFilterPickerGroup#config-centered)
+     * @property {boolean} [once] If `true`, the Widget will be centred on its first show, but if it is moved at runtime, it will opt out of centering for future shows.
      */
-    centered?: boolean
+    centered?: boolean|object
     /**
      * Custom CSS classes to add to element.
      * May be specified as a space separated string, or as an object in which property names
@@ -49845,7 +49910,7 @@ type GridFieldFilterPickerGroupConfig = {
     dock?: 'top'|'bottom'|'left'|'right'|'start'|'end'|'header'|'pre-header'|object
     /**
      * *Only valid if this Widget is [floating](https://bryntum.com/products/grid/docs/api/Core/widget/Widget#config-floating).*
-     * Set to `true` to be able to drag a widget freely on the page. Or set to an object with a ´handleSelector´
+     * Set to `true` to be able to drag a widget freely on the page. Or set to an object with a `handleSelector`
      * property which controls when a drag should start.
      * [More...](https://bryntum.com/products/grid/docs/api/Grid/widget/GridFieldFilterPickerGroup#config-draggable)
      * @property {string} handleSelector CSS selector used to determine if drag can be started from a mouse-downed element inside the widget
@@ -49944,10 +50009,14 @@ type GridFieldFilterPickerGroupConfig = {
     inputFieldAlign?: 'start'|'end'
     /**
      * Element (or element id) to insert this widget before. If provided, [appendTo](https://bryntum.com/products/grid/docs/api/Core/widget/Widget#config-appendTo) config is ignored.
+     * <div class="note">When creating nested trees of widgets, this should only be used on the outermost widget.
+     * [More...](https://bryntum.com/products/grid/docs/api/Grid/widget/GridFieldFilterPickerGroup#config-insertBefore)
      */
     insertBefore?: HTMLElement|string
     /**
      * Element (or element id) to append this widget element to, as a first child. If provided, [appendTo](https://bryntum.com/products/grid/docs/api/Core/widget/Widget#config-appendTo) config is ignored.
+     * <div class="note">When creating nested trees of widgets, this should only be used on the outermost widget.
+     * [More...](https://bryntum.com/products/grid/docs/api/Grid/widget/GridFieldFilterPickerGroup#config-insertFirst)
      */
     insertFirst?: HTMLElement|string
     /**
@@ -49973,7 +50042,7 @@ type GridFieldFilterPickerGroupConfig = {
      */
     labelPosition?: 'before'|'above'|'align-before'|'auto'|null
     /**
-     * Sets `labelWidth´ for all children of this Container, that does not define their own `labelWidth`.
+     * Sets `labelWidth` for all children of this Container, that do not define their own `labelWidth`.
      * [More...](https://bryntum.com/products/grid/docs/api/Grid/widget/GridFieldFilterPickerGroup#config-labelWidth)
      */
     labelWidth?: number|null
@@ -50154,7 +50223,7 @@ type GridFieldFilterPickerGroupConfig = {
     rtl?: boolean
     /**
      * Defines what to do if document is scrolled while Widget is visible (only relevant when floating is set to `true`).
-     * Valid values: ´null´: do nothing, ´hide´: hide the widget or ´realign´: realign to the target if possible.
+     * Valid values: `null`: do nothing, `hide`: hide the widget or `realign`: realign to the target if possible.
      */
     scrollAction?: 'hide'|'realign'|null
     /**
@@ -50794,6 +50863,8 @@ type GroupBarConfig = {
     /**
      * Element (or the id of an element) to append this widget's element to. Can be configured, or set once at
      * runtime. To access the element of a rendered widget, see [element](https://bryntum.com/products/grid/docs/api/Core/widget/Widget#property-element).
+     * <div class="note">When creating nested trees of widgets, this should only be used on the outermost widget.
+     * [More...](https://bryntum.com/products/grid/docs/api/Grid/widget/GroupBar#config-appendTo)
      */
     appendTo?: HTMLElement|string
     /**
@@ -50827,9 +50898,10 @@ type GroupBarConfig = {
     catchEventHandlerExceptions?: boolean
     /**
      * *Only valid if this Widget is [floating](https://bryntum.com/products/grid/docs/api/Core/widget/Widget#config-floating).*
-     * Set to `true` to centre the Widget in browser viewport space.
+     * [More...](https://bryntum.com/products/grid/docs/api/Grid/widget/GroupBar#config-centered)
+     * @property {boolean} [once] If `true`, the Widget will be centred on its first show, but if it is moved at runtime, it will opt out of centering for future shows.
      */
-    centered?: boolean
+    centered?: boolean|object
     /**
      * Configure as `true` to clear selection when clicking on empty space inside the List´s element.
      */
@@ -50843,9 +50915,11 @@ type GroupBarConfig = {
     /**
      * If [closable](https://bryntum.com/products/grid/docs/api/Core/widget/ChipView#config-closable) is `true`, this is the name of a callback function to handle what the "close"
      * action means. If not provided, the record representing the chip is removed from the store.
+     * @param {Core.data.Model[]} records Records to be closed
+     * @param {object} options Close options
      * @returns {void}
      */
-    closeHandler?: string|(() => void)
+    closeHandler?: string|((records: Model[], options: object) => void)
     /**
      * Custom CSS classes to add to element.
      * May be specified as a space separated string, or as an object in which property names
@@ -50926,7 +51000,7 @@ type GroupBarConfig = {
     dock?: 'top'|'bottom'|'left'|'right'|'start'|'end'|'header'|'pre-header'|object
     /**
      * *Only valid if this Widget is [floating](https://bryntum.com/products/grid/docs/api/Core/widget/Widget#config-floating).*
-     * Set to `true` to be able to drag a widget freely on the page. Or set to an object with a ´handleSelector´
+     * Set to `true` to be able to drag a widget freely on the page. Or set to an object with a `handleSelector`
      * property which controls when a drag should start.
      * [More...](https://bryntum.com/products/grid/docs/api/Grid/widget/GroupBar#config-draggable)
      * @property {string} handleSelector CSS selector used to determine if drag can be started from a mouse-downed element inside the widget
@@ -51020,10 +51094,14 @@ type GroupBarConfig = {
     ignoreParentReadOnly?: boolean
     /**
      * Element (or element id) to insert this widget before. If provided, [appendTo](https://bryntum.com/products/grid/docs/api/Core/widget/Widget#config-appendTo) config is ignored.
+     * <div class="note">When creating nested trees of widgets, this should only be used on the outermost widget.
+     * [More...](https://bryntum.com/products/grid/docs/api/Grid/widget/GroupBar#config-insertBefore)
      */
     insertBefore?: HTMLElement|string
     /**
      * Element (or element id) to append this widget element to, as a first child. If provided, [appendTo](https://bryntum.com/products/grid/docs/api/Core/widget/Widget#config-appendTo) config is ignored.
+     * <div class="note">When creating nested trees of widgets, this should only be used on the outermost widget.
+     * [More...](https://bryntum.com/products/grid/docs/api/Grid/widget/GroupBar#config-insertFirst)
      */
     insertFirst?: HTMLElement|string
     /**
@@ -51188,7 +51266,7 @@ type GroupBarConfig = {
     rtl?: boolean
     /**
      * Defines what to do if document is scrolled while Widget is visible (only relevant when floating is set to `true`).
-     * Valid values: ´null´: do nothing, ´hide´: hide the widget or ´realign´: realign to the target if possible.
+     * Valid values: `null`: do nothing, `hide`: hide the widget or `realign`: realign to the target if possible.
      */
     scrollAction?: 'hide'|'realign'|null
     /**
@@ -51853,6 +51931,8 @@ type TreeComboConfig = {
     /**
      * Element (or the id of an element) to append this widget's element to. Can be configured, or set once at
      * runtime. To access the element of a rendered widget, see [element](https://bryntum.com/products/grid/docs/api/Core/widget/Widget#property-element).
+     * <div class="note">When creating nested trees of widgets, this should only be used on the outermost widget.
+     * [More...](https://bryntum.com/products/grid/docs/api/Grid/widget/TreeCombo#config-appendTo)
      */
     appendTo?: HTMLElement|string
     /**
@@ -51912,9 +51992,10 @@ type TreeComboConfig = {
     catchEventHandlerExceptions?: boolean
     /**
      * *Only valid if this Widget is [floating](https://bryntum.com/products/grid/docs/api/Core/widget/Widget#config-floating).*
-     * Set to `true` to centre the Widget in browser viewport space.
+     * [More...](https://bryntum.com/products/grid/docs/api/Grid/widget/TreeCombo#config-centered)
+     * @property {boolean} [once] If `true`, the Widget will be centred on its first show, but if it is moved at runtime, it will opt out of centering for future shows.
      */
-    centered?: boolean
+    centered?: boolean|object
     /**
      * A function (or the name of a function in the ownership hierarchy) called during field validation
      * to perform custom validity checks. The function is called as part of the [isValid](https://bryntum.com/products/grid/docs/api/Core/widget/Field#property-isValid)
@@ -52049,7 +52130,7 @@ type TreeComboConfig = {
     dock?: 'top'|'bottom'|'left'|'right'|'start'|'end'|'header'|'pre-header'|object
     /**
      * *Only valid if this Widget is [floating](https://bryntum.com/products/grid/docs/api/Core/widget/Widget#config-floating).*
-     * Set to `true` to be able to drag a widget freely on the page. Or set to an object with a ´handleSelector´
+     * Set to `true` to be able to drag a widget freely on the page. Or set to an object with a `handleSelector`
      * property which controls when a drag should start.
      * [More...](https://bryntum.com/products/grid/docs/api/Grid/widget/TreeCombo#config-draggable)
      * @property {string} handleSelector CSS selector used to determine if drag can be started from a mouse-downed element inside the widget
@@ -52215,10 +52296,14 @@ type TreeComboConfig = {
     inputWidth?: string|number
     /**
      * Element (or element id) to insert this widget before. If provided, [appendTo](https://bryntum.com/products/grid/docs/api/Core/widget/Widget#config-appendTo) config is ignored.
+     * <div class="note">When creating nested trees of widgets, this should only be used on the outermost widget.
+     * [More...](https://bryntum.com/products/grid/docs/api/Grid/widget/TreeCombo#config-insertBefore)
      */
     insertBefore?: HTMLElement|string
     /**
      * Element (or element id) to append this widget element to, as a first child. If provided, [appendTo](https://bryntum.com/products/grid/docs/api/Core/widget/Widget#config-appendTo) config is ignored.
+     * <div class="note">When creating nested trees of widgets, this should only be used on the outermost widget.
+     * [More...](https://bryntum.com/products/grid/docs/api/Grid/widget/TreeCombo#config-insertFirst)
      */
     insertFirst?: HTMLElement|string
     /**
@@ -52491,7 +52576,7 @@ type TreeComboConfig = {
     rtl?: boolean
     /**
      * Defines what to do if document is scrolled while Widget is visible (only relevant when floating is set to `true`).
-     * Valid values: ´null´: do nothing, ´hide´: hide the widget or ´realign´: realign to the target if possible.
+     * Valid values: `null`: do nothing, `hide`: hide the widget or `realign`: realign to the target if possible.
      */
     scrollAction?: 'hide'|'realign'|null
     /**