@bryntum/grid-angular-thin 7.3.0 → 7.3.2

package/src/lib/bryntum-grid-base.component.ts

@@ -48,6 +48,8 @@ export type BryntumGridBaseProps = {
     /**
      * 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
     /**
@@ -359,10 +361,14 @@ export type BryntumGridBaseProps = {
     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
     /**
@@ -1620,7 +1626,7 @@ export class BryntumGridBaseComponent implements OnInit, OnDestroy {
      * @param {Grid.view.Grid} event.source Owner grid
      * @param {Grid.util.GridLocation} event.editorContext Editing context
      */
-    @Output() onBeforeCancelCellEdit: any = new EventEmitter<((event: { source: Grid, editorContext: GridLocation }) => Promise<boolean>|boolean|void)|string>();
+    @Output() onBeforeCancelCellEdit: any = new EventEmitter<((event: { source: Grid, editorContext: GridLocation }) => boolean|void)|string>();
     /**
      * Fires on the owning Grid before the row editing is canceled, return false to signal that the value is invalid and editing should not be finalized.
      * [More...](https://bryntum.com/products/grid/docs/api/Grid/view/GridBase#event-beforeCancelRowEdit)
@@ -1635,7 +1641,7 @@ export class BryntumGridBaseComponent implements OnInit, OnDestroy {
      * @param {Grid.view.Grid} event.source Owner grid
      * @param {CellEditorContext} event.editorContext Editing context
      */
-    @Output() onBeforeCellEditStart: any = new EventEmitter<((event: { source: Grid, editorContext: CellEditorContext }) => Promise<boolean>|boolean|void)|string>();
+    @Output() onBeforeCellEditStart: any = new EventEmitter<((event: { source: Grid, editorContext: CellEditorContext }) => boolean|void)|string>();
     /**
      * Fires on the owning Grid before deleting a range of selected cell values by pressing <kbd>Backspace</kbd> or <kbd>Delete</kbd>
      * buttons while [autoEdit](https://bryntum.com/products/grid/docs/api/Grid/feature/CellEdit#config-autoEdit) is set to `true`. Return `false` to prevent editing.
@@ -1643,7 +1649,7 @@ export class BryntumGridBaseComponent implements OnInit, OnDestroy {
      * @param {Grid.view.Grid} event.source Owner grid
      * @param {(Grid.util.GridLocation|Core.data.Model)[]} event.gridSelection An array of cell selectors or records that will have their values deleted (the records themselves will not get deleted, only visible column values).
      */
-    @Output() onBeforeCellRangeDelete: any = new EventEmitter<((event: { source: Grid, gridSelection: (GridLocation|Model)[] }) => Promise<boolean>|boolean|void)|string>();
+    @Output() onBeforeCellRangeDelete: any = new EventEmitter<((event: { source: Grid, gridSelection: (GridLocation|Model)[] }) => boolean|void)|string>();
     /**
      * Fires for each selected record on the owning Grid before editing a range of selected cell values
      * @param {object} event Event object
@@ -1651,7 +1657,7 @@ export class BryntumGridBaseComponent implements OnInit, OnDestroy {
      * @param {string} event.field The field being changed
      * @param {any} event.value The value being set
      */
-    @Output() onBeforeCellRangeEdit: any = new EventEmitter<((event: { record: Model, field: string, value: any }) => Promise<boolean>|boolean|void)|string>();
+    @Output() onBeforeCellRangeEdit: any = new EventEmitter<((event: { record: Model, field: string, value: any }) => boolean|void)|string>();
     /**
      * This event is triggered before a parent column is collapsed or expanded.
      * @param {object} event Event object
@@ -1667,7 +1673,7 @@ export class BryntumGridBaseComponent implements OnInit, OnDestroy {
      * @param {Grid.column.Column} event.column The dragged column.
      * @param {Event} event.event The browser event.
      */
-    @Output() onBeforeColumnDragStart: any = new EventEmitter<((event: { source: Grid, column: Column, event: Event }) => Promise<boolean>|boolean|void)|string>();
+    @Output() onBeforeColumnDragStart: any = new EventEmitter<((event: { source: Grid, column: Column, event: Event }) => boolean|void)|string>();
     /**
      * This event is fired when a column is dropped, and you can return false from a listener to abort the operation.
      * @param {object} event Event object
@@ -1678,7 +1684,7 @@ export class BryntumGridBaseComponent implements OnInit, OnDestroy {
      * @param {Event} event.event The browser event.
      * @param {string} event.region The region where the column was dropped.
      */
-    @Output() onBeforeColumnDropFinalize: any = new EventEmitter<((event: { source: Grid, column: Column, insertBefore: Column, newParent: Column, event: Event, region: string }) => Promise<boolean>|boolean|void)|string>();
+    @Output() onBeforeColumnDropFinalize: any = new EventEmitter<((event: { source: Grid, column: Column, insertBefore: Column, newParent: Column, event: Event, region: string }) => boolean|void)|string>();
     /**
      * This event is fired prior to starting a column resize gesture. The resize is canceled if a listener returns
      * `false`.
@@ -1687,7 +1693,7 @@ export class BryntumGridBaseComponent implements OnInit, OnDestroy {
      * @param {Grid.column.Column} event.column The column
      * @param {Event} event.domEvent The browser event
      */
-    @Output() onBeforeColumnResize: any = new EventEmitter<((event: { source: Grid, column: Column, domEvent: Event }) => Promise<boolean>|boolean|void)|string>();
+    @Output() onBeforeColumnResize: any = new EventEmitter<((event: { source: Grid, column: Column, domEvent: Event }) => boolean|void)|string>();
     /**
      * Fires on the owning Grid before a copy action is performed, return `false` to prevent the action
      * @param {object} event Event object
@@ -1707,7 +1713,7 @@ export class BryntumGridBaseComponent implements OnInit, OnDestroy {
      * @param {string} event.lineDelimiter The CSV delimiter to separate lines
      * @param {string} event.columnDelimiter The CSV delimiter to separate values on one line
      */
-    @Output() onBeforeCSVExport: any = new EventEmitter<((event: { config: ExportConfig, columns: Column[], rows: Model[], lineDelimiter: string, columnDelimiter: string }) => Promise<boolean>|boolean|void)|string>();
+    @Output() onBeforeCSVExport: any = new EventEmitter<((event: { config: ExportConfig, columns: Column[], rows: Model[], lineDelimiter: string, columnDelimiter: string }) => boolean|void)|string>();
     /**
      * Fires before an object is destroyed.
      * @param {object} event Event object
@@ -1721,14 +1727,14 @@ export class BryntumGridBaseComponent implements OnInit, OnDestroy {
      * @param {XLSColumn[]} event.columns An array of columns to export
      * @param {any[][]} event.rows An array of records to export
      */
-    @Output() onBeforeExcelExport: any = new EventEmitter<((event: { config: ExportConfig, columns: XLSColumn[], rows: any[] }) => Promise<boolean>|boolean|void)|string>();
+    @Output() onBeforeExcelExport: any = new EventEmitter<((event: { config: ExportConfig, columns: XLSColumn[], rows: any[] }) => boolean|void)|string>();
     /**
      * Fired before dragging of the FillHandle starts, return `false` to prevent the drag operation.
      * @param {object} event Event object
      * @param {Grid.util.GridLocation} event.cell Information about the column / record
      * @param {MouseEvent} event.domEvent The raw DOM event
      */
-    @Output() onBeforeFillHandleDragStart: any = new EventEmitter<((event: { cell: GridLocation, domEvent: MouseEvent }) => Promise<boolean>|boolean|void)|string>();
+    @Output() onBeforeFillHandleDragStart: any = new EventEmitter<((event: { cell: GridLocation, domEvent: MouseEvent }) => boolean|void)|string>();
     /**
      * Fires on the owning Grid before the cell editing is finished, return false to signal that the value is invalid and editing should not be finalized.
      * @param {object} event Event object
@@ -1749,7 +1755,7 @@ export class BryntumGridBaseComponent implements OnInit, OnDestroy {
      * @param {object} event Event object
      * @param {Core.widget.Widget} event.source The widget being hidden.
      */
-    @Output() onBeforeHide: any = new EventEmitter<((event: { source: Widget }) => Promise<boolean>|boolean|void)|string>();
+    @Output() onBeforeHide: any = new EventEmitter<((event: { source: Widget }) => boolean|void)|string>();
     /**
      * Fires on the owning Grid before a paste action is performed, return `false` to prevent the action
      * @param {object} event Event object
@@ -1765,7 +1771,7 @@ export class BryntumGridBaseComponent implements OnInit, OnDestroy {
      * @param {object} event Event object
      * @param {PdfExportConfig} event.config Export config
      */
-    @Output() onBeforePdfExport: any = new EventEmitter<((event: { config: PdfExportConfig }) => Promise<boolean>|boolean|void)|string>();
+    @Output() onBeforePdfExport: any = new EventEmitter<((event: { config: PdfExportConfig }) => boolean|void)|string>();
     /**
      * Fires before a row is rendered.
      * @param {object} event Event object
@@ -1808,7 +1814,7 @@ export class BryntumGridBaseComponent implements OnInit, OnDestroy {
      * @param {Grid.util.GridLocation[]} event.selectedCells The cells to be selected in this operation.
      * @param {Grid.util.GridLocation[]} event.cellSelection The cells in the current selection, before applying `selectedCells` and `deselectedCells`
      */
-    @Output() onBeforeSelectionChange: any = new EventEmitter<((event: { action: string, mode: 'row'|'cell', source: Grid, deselected: Model[], selected: Model[], selection: Model[], deselectedCells: GridLocation[], selectedCells: GridLocation[], cellSelection: GridLocation[] }) => Promise<boolean>|boolean|void)|string>();
+    @Output() onBeforeSelectionChange: any = new EventEmitter<((event: { action: string, mode: 'row'|'cell', source: Grid, deselected: Model[], selected: Model[], selection: Model[], deselectedCells: GridLocation[], selectedCells: GridLocation[], cellSelection: GridLocation[] }) => boolean|void)|string>();
     /**
      * Fired before this container will load record values into its child fields. This is useful if you
      * want to modify the UI before data is loaded (e.g. set some input field to be readonly)
@@ -1829,19 +1835,19 @@ export class BryntumGridBaseComponent implements OnInit, OnDestroy {
      * @param {Grid.view.Grid} event.source Owner grid
      * @param {RowEditorContext} event.editorContext Editing context
      */
-    @Output() onBeforeStartRowEdit: any = new EventEmitter<((event: { source: Grid, editorContext: RowEditorContext }) => Promise<boolean>|boolean|void)|string>();
+    @Output() onBeforeStartRowEdit: any = new EventEmitter<((event: { source: Grid, editorContext: RowEditorContext }) => boolean|void)|string>();
     /**
      * Fired before state is applied to the source. Allows editing the state object or preventing the operation.
      * @param {object} event Event object
      * @param {GridStateInfo} event.state State object config
      */
-    @Output() onBeforeStateApply: any = new EventEmitter<((event: { state: GridStateInfo }) => Promise<boolean>|boolean|void)|string>();
+    @Output() onBeforeStateApply: any = new EventEmitter<((event: { state: GridStateInfo }) => boolean|void)|string>();
     /**
      * Fired before state is saved by the StateProvider. Allows editing the state object or preventing the operation.
      * @param {object} event Event object
      * @param {GridStateInfo} event.state State object config
      */
-    @Output() onBeforeStateSave: any = new EventEmitter<((event: { state: GridStateInfo }) => Promise<boolean>|boolean|void)|string>();
+    @Output() onBeforeStateSave: any = new EventEmitter<((event: { state: GridStateInfo }) => boolean|void)|string>();
     /**
      * Fired when a group is going to be expanded or collapsed using the UI.
      * Returning `false` from a listener prevents the operation
@@ -1851,7 +1857,7 @@ export class BryntumGridBaseComponent implements OnInit, OnDestroy {
      * @param {boolean} event.collapse Collapsed (true) or expanded (false)
      * @param {Event} event.domEvent The user interaction event (eg a `click` event) if the toggle request was instigated by user interaction.
      */
-    @Output() onBeforeToggleGroup: any = new EventEmitter<((event: { groupRecord: Model, groupRecords: Model[], collapse: boolean, domEvent: Event }) => Promise<boolean>|boolean|void)|string>();
+    @Output() onBeforeToggleGroup: any = new EventEmitter<((event: { groupRecord: Model, groupRecords: Model[], collapse: boolean, domEvent: Event }) => boolean|void)|string>();
     /**
      * Fired before a parent node record toggles its collapsed state.
      * @param {object} event Event object
@@ -1920,7 +1926,7 @@ export class BryntumGridBaseComponent implements OnInit, OnDestroy {
      * @param {Grid.column.Column} event.column Column
      * @param {Core.data.Model} event.record Record
      */
-    @Output() onCellMenuBeforeShow: any = new EventEmitter<((event: { source: Grid, menu: Menu, items: Record<string, MenuItemEntry>, column: Column, record: Model }) => Promise<boolean>|boolean|void)|string>();
+    @Output() onCellMenuBeforeShow: any = new EventEmitter<((event: { source: Grid, menu: Menu, items: Record<string, MenuItemEntry>, column: Column, record: Model }) => boolean|void)|string>();
     /**
      * This event fires on the owning grid when an item is selected in the cell context menu.
      * @param {object} event Event object
@@ -2047,7 +2053,7 @@ export class BryntumGridBaseComponent implements OnInit, OnDestroy {
      * @param {Event} event.event The browser event.
      * @param {string} event.region The region where the column was dropped.
      */
-    @Output() onColumnDrop: any = new EventEmitter<((event: { source: Grid, column: Column, insertBefore: Column, newParent: Column, valid: boolean, event: Event, region: string }) => Promise<boolean>|boolean|void)|string>();
+    @Output() onColumnDrop: any = new EventEmitter<((event: { source: Grid, column: Column, insertBefore: Column, newParent: Column, valid: boolean, event: Event, region: string }) => boolean|void)|string>();
     /**
      * This event is fired after a resize gesture is completed.
      * @param {object} event Event object
@@ -2187,7 +2193,7 @@ export class BryntumGridBaseComponent implements OnInit, OnDestroy {
      * @param {Grid.util.GridLocation} event.cell Information about the column / record
      * @param {MouseEvent} event.domEvent The raw DOM event
      */
-    @Output() onFillHandleDragStart: any = new EventEmitter<((event: { cell: GridLocation, domEvent: MouseEvent }) => Promise<boolean>|boolean|void)|string>();
+    @Output() onFillHandleDragStart: any = new EventEmitter<((event: { cell: GridLocation, domEvent: MouseEvent }) => boolean|void)|string>();
     /**
      * Fires on the owning Grid when cell editing is finished
      * @param {object} event Event object
@@ -2235,7 +2241,7 @@ export class BryntumGridBaseComponent implements OnInit, OnDestroy {
      * @param {Core.data.Model[]} event.context.records The dragged row records
      * @param {MouseEvent,TouchEvent} event.event
      */
-    @Output() onGridRowBeforeDragStart: any = new EventEmitter<((event: { source: GridBase, context: { records: Model[] }, event: MouseEvent|TouchEvent }) => Promise<boolean>|boolean|void)|string>();
+    @Output() onGridRowBeforeDragStart: any = new EventEmitter<((event: { source: GridBase, context: { records: Model[] }, event: MouseEvent|TouchEvent }) => boolean|void)|string>();
     /**
      * Fired before the row drop operation is finalized. You can return false to abort the drop operation, or a
      * Promise yielding `true` / `false` which allows for asynchronous abort (e.g. first show user a confirmation dialog).
@@ -2302,7 +2308,7 @@ export class BryntumGridBaseComponent implements OnInit, OnDestroy {
      * @param {Event} event.domEvent The triggering DOM event.
      * @param {Grid.column.Column} event.column The column clicked on.
      */
-    @Output() onHeaderClick: any = new EventEmitter<((event: { domEvent: Event, column: Column }) => Promise<boolean>|boolean|void)|string>();
+    @Output() onHeaderClick: any = new EventEmitter<((event: { domEvent: Event, column: Column }) => boolean|void)|string>();
     /**
      * This event fires on the owning Grid before the context menu is shown for a header.
      * Allows manipulation of the items to show in the same way as in the [processItems](https://bryntum.com/products/grid/docs/api/Grid/feature/HeaderMenu#config-processItems).
@@ -2313,7 +2319,7 @@ export class BryntumGridBaseComponent implements OnInit, OnDestroy {
      * @param {Record<string, MenuItemEntry>} event.items Menu item configs
      * @param {Grid.column.Column} event.column Column
      */
-    @Output() onHeaderMenuBeforeShow: any = new EventEmitter<((event: { source: Grid, menu: Menu, items: Record<string, MenuItemEntry>, column: Column }) => Promise<boolean>|boolean|void)|string>();
+    @Output() onHeaderMenuBeforeShow: any = new EventEmitter<((event: { source: Grid, menu: Menu, items: Record<string, MenuItemEntry>, column: Column }) => boolean|void)|string>();
     /**
      * This event fires on the owning Grid when an item is selected in the header context menu.
      * @param {object} event Event object
@@ -2524,7 +2530,7 @@ export class BryntumGridBaseComponent implements OnInit, OnDestroy {
      * @param {Grid.view.SubGrid} event.subGrid The subgrid
      * @param {Event} event.domEvent The native DOM event
      */
-    @Output() onSplitterCollapseClick: any = new EventEmitter<((event: { source: Grid, subGrid: SubGrid, domEvent: Event }) => Promise<boolean>|boolean|void)|string>();
+    @Output() onSplitterCollapseClick: any = new EventEmitter<((event: { source: Grid, subGrid: SubGrid, domEvent: Event }) => boolean|void)|string>();
     /**
      * Fired by the Grid after a sub-grid has been resized using the splitter
      * @param {object} event Event object
@@ -2549,7 +2555,7 @@ export class BryntumGridBaseComponent implements OnInit, OnDestroy {
      * @param {Grid.view.SubGrid} event.subGrid The subgrid
      * @param {Event} event.domEvent The native DOM event
      */
-    @Output() onSplitterExpandClick: any = new EventEmitter<((event: { source: Grid, subGrid: SubGrid, domEvent: Event }) => Promise<boolean>|boolean|void)|string>();
+    @Output() onSplitterExpandClick: any = new EventEmitter<((event: { source: Grid, subGrid: SubGrid, domEvent: Event }) => boolean|void)|string>();
     /**
      * Fires on the owning Grid when editing starts
      * @param {object} event Event object

package/src/lib/bryntum-grid-chart-designer.component.ts

@@ -40,6 +40,8 @@ export type BryntumGridChartDesignerProps = {
     /**
      * 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
     /**
@@ -217,10 +219,14 @@ export type BryntumGridChartDesignerProps = {
     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
     /**
@@ -746,7 +752,7 @@ export class BryntumGridChartDesignerComponent implements OnInit, OnDestroy {
      * @param {object} event Event object
      * @param {Core.widget.Widget} event.source The widget being hidden.
      */
-    @Output() onBeforeHide: any = new EventEmitter<((event: { source: Widget }) => Promise<boolean>|boolean|void)|string>();
+    @Output() onBeforeHide: any = new EventEmitter<((event: { source: Widget }) => boolean|void)|string>();
     /**
      * Triggered before a widget is shown. Return `false` to prevent the action.
      * @param {object} event Event object

package/src/lib/bryntum-grid-field-filter-picker-group.component.ts

@@ -50,6 +50,8 @@ export type BryntumGridFieldFilterPickerGroupProps = {
     /**
      * 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
     /**
@@ -298,10 +300,14 @@ export type BryntumGridFieldFilterPickerGroupProps = {
     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
     /**
@@ -1005,7 +1011,7 @@ export class BryntumGridFieldFilterPickerGroupComponent implements OnInit, OnDes
      * @param {Core.widget.FieldFilterPicker} event.source The FieldFilterPicker instance that fired the event.
      * @param {CollectionFilterConfig} event.filter The [CollectionFilter](https://bryntum.com/products/grid/docs/api/Core/util/CollectionFilter) configuration object for the filter represented by this [FieldFilterPicker](https://bryntum.com/products/grid/docs/api/Core/widget/FieldFilterPicker).
      */
-    @Output() onBeforeAddFilter: any = new EventEmitter<((event: { source: FieldFilterPicker, filter: CollectionFilterConfig }) => Promise<boolean>|boolean|void)|string>();
+    @Output() onBeforeAddFilter: any = new EventEmitter<((event: { source: FieldFilterPicker, filter: CollectionFilterConfig }) => boolean|void)|string>();
     /**
      * Fires before an object is destroyed.
      * @param {object} event Event object
@@ -1017,7 +1023,7 @@ export class BryntumGridFieldFilterPickerGroupComponent implements OnInit, OnDes
      * @param {object} event Event object
      * @param {Core.widget.Widget} event.source The widget being hidden.
      */
-    @Output() onBeforeHide: any = new EventEmitter<((event: { source: Widget }) => Promise<boolean>|boolean|void)|string>();
+    @Output() onBeforeHide: any = new EventEmitter<((event: { source: Widget }) => boolean|void)|string>();
     /**
      * Fired before this container will load record values into its child fields. This is useful if you
      * want to modify the UI before data is loaded (e.g. set some input field to be readonly)

package/src/lib/bryntum-grid-field-filter-picker.component.ts

@@ -47,6 +47,8 @@ export type BryntumGridFieldFilterPickerProps = {
     /**
      * 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
     /**
@@ -283,10 +285,14 @@ export type BryntumGridFieldFilterPickerProps = {
     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
     /**
@@ -1003,7 +1009,7 @@ export class BryntumGridFieldFilterPickerComponent implements OnInit, OnDestroy
      * @param {object} event Event object
      * @param {Core.widget.Widget} event.source The widget being hidden.
      */
-    @Output() onBeforeHide: any = new EventEmitter<((event: { source: Widget }) => Promise<boolean>|boolean|void)|string>();
+    @Output() onBeforeHide: any = new EventEmitter<((event: { source: Widget }) => boolean|void)|string>();
     /**
      * Fired before this container will load record values into its child fields. This is useful if you
      * want to modify the UI before data is loaded (e.g. set some input field to be readonly)

package/src/lib/bryntum-grid.component.ts

@@ -48,6 +48,8 @@ export type BryntumGridProps = {
     /**
      * 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
     /**
@@ -359,10 +361,14 @@ export type BryntumGridProps = {
     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
     /**
@@ -1624,7 +1630,7 @@ export class BryntumGridComponent implements OnInit, OnDestroy {
      * @param {Grid.view.Grid} event.source Owner grid
      * @param {Grid.util.GridLocation} event.editorContext Editing context
      */
-    @Output() onBeforeCancelCellEdit: any = new EventEmitter<((event: { source: Grid, editorContext: GridLocation }) => Promise<boolean>|boolean|void)|string>();
+    @Output() onBeforeCancelCellEdit: any = new EventEmitter<((event: { source: Grid, editorContext: GridLocation }) => boolean|void)|string>();
     /**
      * Fires on the owning Grid before the row editing is canceled, return false to signal that the value is invalid and editing should not be finalized.
      * [More...](https://bryntum.com/products/grid/docs/api/Grid/view/Grid#event-beforeCancelRowEdit)
@@ -1639,7 +1645,7 @@ export class BryntumGridComponent implements OnInit, OnDestroy {
      * @param {Grid.view.Grid} event.source Owner grid
      * @param {CellEditorContext} event.editorContext Editing context
      */
-    @Output() onBeforeCellEditStart: any = new EventEmitter<((event: { source: Grid, editorContext: CellEditorContext }) => Promise<boolean>|boolean|void)|string>();
+    @Output() onBeforeCellEditStart: any = new EventEmitter<((event: { source: Grid, editorContext: CellEditorContext }) => boolean|void)|string>();
     /**
      * Fires on the owning Grid before deleting a range of selected cell values by pressing <kbd>Backspace</kbd> or <kbd>Delete</kbd>
      * buttons while [autoEdit](https://bryntum.com/products/grid/docs/api/Grid/feature/CellEdit#config-autoEdit) is set to `true`. Return `false` to prevent editing.
@@ -1647,7 +1653,7 @@ export class BryntumGridComponent implements OnInit, OnDestroy {
      * @param {Grid.view.Grid} event.source Owner grid
      * @param {(Grid.util.GridLocation|Core.data.Model)[]} event.gridSelection An array of cell selectors or records that will have their values deleted (the records themselves will not get deleted, only visible column values).
      */
-    @Output() onBeforeCellRangeDelete: any = new EventEmitter<((event: { source: Grid, gridSelection: (GridLocation|Model)[] }) => Promise<boolean>|boolean|void)|string>();
+    @Output() onBeforeCellRangeDelete: any = new EventEmitter<((event: { source: Grid, gridSelection: (GridLocation|Model)[] }) => boolean|void)|string>();
     /**
      * Fires for each selected record on the owning Grid before editing a range of selected cell values
      * @param {object} event Event object
@@ -1655,7 +1661,7 @@ export class BryntumGridComponent implements OnInit, OnDestroy {
      * @param {string} event.field The field being changed
      * @param {any} event.value The value being set
      */
-    @Output() onBeforeCellRangeEdit: any = new EventEmitter<((event: { record: Model, field: string, value: any }) => Promise<boolean>|boolean|void)|string>();
+    @Output() onBeforeCellRangeEdit: any = new EventEmitter<((event: { record: Model, field: string, value: any }) => boolean|void)|string>();
     /**
      * This event is triggered before a parent column is collapsed or expanded.
      * @param {object} event Event object
@@ -1671,7 +1677,7 @@ export class BryntumGridComponent implements OnInit, OnDestroy {
      * @param {Grid.column.Column} event.column The dragged column.
      * @param {Event} event.event The browser event.
      */
-    @Output() onBeforeColumnDragStart: any = new EventEmitter<((event: { source: Grid, column: Column, event: Event }) => Promise<boolean>|boolean|void)|string>();
+    @Output() onBeforeColumnDragStart: any = new EventEmitter<((event: { source: Grid, column: Column, event: Event }) => boolean|void)|string>();
     /**
      * This event is fired when a column is dropped, and you can return false from a listener to abort the operation.
      * @param {object} event Event object
@@ -1682,7 +1688,7 @@ export class BryntumGridComponent implements OnInit, OnDestroy {
      * @param {Event} event.event The browser event.
      * @param {string} event.region The region where the column was dropped.
      */
-    @Output() onBeforeColumnDropFinalize: any = new EventEmitter<((event: { source: Grid, column: Column, insertBefore: Column, newParent: Column, event: Event, region: string }) => Promise<boolean>|boolean|void)|string>();
+    @Output() onBeforeColumnDropFinalize: any = new EventEmitter<((event: { source: Grid, column: Column, insertBefore: Column, newParent: Column, event: Event, region: string }) => boolean|void)|string>();
     /**
      * This event is fired prior to starting a column resize gesture. The resize is canceled if a listener returns
      * `false`.
@@ -1691,7 +1697,7 @@ export class BryntumGridComponent implements OnInit, OnDestroy {
      * @param {Grid.column.Column} event.column The column
      * @param {Event} event.domEvent The browser event
      */
-    @Output() onBeforeColumnResize: any = new EventEmitter<((event: { source: Grid, column: Column, domEvent: Event }) => Promise<boolean>|boolean|void)|string>();
+    @Output() onBeforeColumnResize: any = new EventEmitter<((event: { source: Grid, column: Column, domEvent: Event }) => boolean|void)|string>();
     /**
      * Fires on the owning Grid before a copy action is performed, return `false` to prevent the action
      * @param {object} event Event object
@@ -1711,7 +1717,7 @@ export class BryntumGridComponent implements OnInit, OnDestroy {
      * @param {string} event.lineDelimiter The CSV delimiter to separate lines
      * @param {string} event.columnDelimiter The CSV delimiter to separate values on one line
      */
-    @Output() onBeforeCSVExport: any = new EventEmitter<((event: { config: ExportConfig, columns: Column[], rows: Model[], lineDelimiter: string, columnDelimiter: string }) => Promise<boolean>|boolean|void)|string>();
+    @Output() onBeforeCSVExport: any = new EventEmitter<((event: { config: ExportConfig, columns: Column[], rows: Model[], lineDelimiter: string, columnDelimiter: string }) => boolean|void)|string>();
     /**
      * Fires before an object is destroyed.
      * @param {object} event Event object
@@ -1725,14 +1731,14 @@ export class BryntumGridComponent implements OnInit, OnDestroy {
      * @param {XLSColumn[]} event.columns An array of columns to export
      * @param {any[][]} event.rows An array of records to export
      */
-    @Output() onBeforeExcelExport: any = new EventEmitter<((event: { config: ExportConfig, columns: XLSColumn[], rows: any[] }) => Promise<boolean>|boolean|void)|string>();
+    @Output() onBeforeExcelExport: any = new EventEmitter<((event: { config: ExportConfig, columns: XLSColumn[], rows: any[] }) => boolean|void)|string>();
     /**
      * Fired before dragging of the FillHandle starts, return `false` to prevent the drag operation.
      * @param {object} event Event object
      * @param {Grid.util.GridLocation} event.cell Information about the column / record
      * @param {MouseEvent} event.domEvent The raw DOM event
      */
-    @Output() onBeforeFillHandleDragStart: any = new EventEmitter<((event: { cell: GridLocation, domEvent: MouseEvent }) => Promise<boolean>|boolean|void)|string>();
+    @Output() onBeforeFillHandleDragStart: any = new EventEmitter<((event: { cell: GridLocation, domEvent: MouseEvent }) => boolean|void)|string>();
     /**
      * Fires on the owning Grid before the cell editing is finished, return false to signal that the value is invalid and editing should not be finalized.
      * @param {object} event Event object
@@ -1753,7 +1759,7 @@ export class BryntumGridComponent implements OnInit, OnDestroy {
      * @param {object} event Event object
      * @param {Core.widget.Widget} event.source The widget being hidden.
      */
-    @Output() onBeforeHide: any = new EventEmitter<((event: { source: Widget }) => Promise<boolean>|boolean|void)|string>();
+    @Output() onBeforeHide: any = new EventEmitter<((event: { source: Widget }) => boolean|void)|string>();
     /**
      * Fires on the owning Grid before a paste action is performed, return `false` to prevent the action
      * @param {object} event Event object
@@ -1769,7 +1775,7 @@ export class BryntumGridComponent implements OnInit, OnDestroy {
      * @param {object} event Event object
      * @param {PdfExportConfig} event.config Export config
      */
-    @Output() onBeforePdfExport: any = new EventEmitter<((event: { config: PdfExportConfig }) => Promise<boolean>|boolean|void)|string>();
+    @Output() onBeforePdfExport: any = new EventEmitter<((event: { config: PdfExportConfig }) => boolean|void)|string>();
     /**
      * Fires before a row is rendered.
      * @param {object} event Event object
@@ -1812,7 +1818,7 @@ export class BryntumGridComponent implements OnInit, OnDestroy {
      * @param {Grid.util.GridLocation[]} event.selectedCells The cells to be selected in this operation.
      * @param {Grid.util.GridLocation[]} event.cellSelection The cells in the current selection, before applying `selectedCells` and `deselectedCells`
      */
-    @Output() onBeforeSelectionChange: any = new EventEmitter<((event: { action: string, mode: 'row'|'cell', source: Grid, deselected: Model[], selected: Model[], selection: Model[], deselectedCells: GridLocation[], selectedCells: GridLocation[], cellSelection: GridLocation[] }) => Promise<boolean>|boolean|void)|string>();
+    @Output() onBeforeSelectionChange: any = new EventEmitter<((event: { action: string, mode: 'row'|'cell', source: Grid, deselected: Model[], selected: Model[], selection: Model[], deselectedCells: GridLocation[], selectedCells: GridLocation[], cellSelection: GridLocation[] }) => boolean|void)|string>();
     /**
      * Fired before this container will load record values into its child fields. This is useful if you
      * want to modify the UI before data is loaded (e.g. set some input field to be readonly)
@@ -1833,19 +1839,19 @@ export class BryntumGridComponent implements OnInit, OnDestroy {
      * @param {Grid.view.Grid} event.source Owner grid
      * @param {RowEditorContext} event.editorContext Editing context
      */
-    @Output() onBeforeStartRowEdit: any = new EventEmitter<((event: { source: Grid, editorContext: RowEditorContext }) => Promise<boolean>|boolean|void)|string>();
+    @Output() onBeforeStartRowEdit: any = new EventEmitter<((event: { source: Grid, editorContext: RowEditorContext }) => boolean|void)|string>();
     /**
      * Fired before state is applied to the source. Allows editing the state object or preventing the operation.
      * @param {object} event Event object
      * @param {GridStateInfo} event.state State object config
      */
-    @Output() onBeforeStateApply: any = new EventEmitter<((event: { state: GridStateInfo }) => Promise<boolean>|boolean|void)|string>();
+    @Output() onBeforeStateApply: any = new EventEmitter<((event: { state: GridStateInfo }) => boolean|void)|string>();
     /**
      * Fired before state is saved by the StateProvider. Allows editing the state object or preventing the operation.
      * @param {object} event Event object
      * @param {GridStateInfo} event.state State object config
      */
-    @Output() onBeforeStateSave: any = new EventEmitter<((event: { state: GridStateInfo }) => Promise<boolean>|boolean|void)|string>();
+    @Output() onBeforeStateSave: any = new EventEmitter<((event: { state: GridStateInfo }) => boolean|void)|string>();
     /**
      * Fired when a group is going to be expanded or collapsed using the UI.
      * Returning `false` from a listener prevents the operation
@@ -1855,7 +1861,7 @@ export class BryntumGridComponent implements OnInit, OnDestroy {
      * @param {boolean} event.collapse Collapsed (true) or expanded (false)
      * @param {Event} event.domEvent The user interaction event (eg a `click` event) if the toggle request was instigated by user interaction.
      */
-    @Output() onBeforeToggleGroup: any = new EventEmitter<((event: { groupRecord: Model, groupRecords: Model[], collapse: boolean, domEvent: Event }) => Promise<boolean>|boolean|void)|string>();
+    @Output() onBeforeToggleGroup: any = new EventEmitter<((event: { groupRecord: Model, groupRecords: Model[], collapse: boolean, domEvent: Event }) => boolean|void)|string>();
     /**
      * Fired before a parent node record toggles its collapsed state.
      * @param {object} event Event object
@@ -1924,7 +1930,7 @@ export class BryntumGridComponent implements OnInit, OnDestroy {
      * @param {Grid.column.Column} event.column Column
      * @param {Core.data.Model} event.record Record
      */
-    @Output() onCellMenuBeforeShow: any = new EventEmitter<((event: { source: Grid, menu: Menu, items: Record<string, MenuItemEntry>, column: Column, record: Model }) => Promise<boolean>|boolean|void)|string>();
+    @Output() onCellMenuBeforeShow: any = new EventEmitter<((event: { source: Grid, menu: Menu, items: Record<string, MenuItemEntry>, column: Column, record: Model }) => boolean|void)|string>();
     /**
      * This event fires on the owning grid when an item is selected in the cell context menu.
      * @param {object} event Event object
@@ -2051,7 +2057,7 @@ export class BryntumGridComponent implements OnInit, OnDestroy {
      * @param {Event} event.event The browser event.
      * @param {string} event.region The region where the column was dropped.
      */
-    @Output() onColumnDrop: any = new EventEmitter<((event: { source: Grid, column: Column, insertBefore: Column, newParent: Column, valid: boolean, event: Event, region: string }) => Promise<boolean>|boolean|void)|string>();
+    @Output() onColumnDrop: any = new EventEmitter<((event: { source: Grid, column: Column, insertBefore: Column, newParent: Column, valid: boolean, event: Event, region: string }) => boolean|void)|string>();
     /**
      * This event is fired after a resize gesture is completed.
      * @param {object} event Event object
@@ -2191,7 +2197,7 @@ export class BryntumGridComponent implements OnInit, OnDestroy {
      * @param {Grid.util.GridLocation} event.cell Information about the column / record
      * @param {MouseEvent} event.domEvent The raw DOM event
      */
-    @Output() onFillHandleDragStart: any = new EventEmitter<((event: { cell: GridLocation, domEvent: MouseEvent }) => Promise<boolean>|boolean|void)|string>();
+    @Output() onFillHandleDragStart: any = new EventEmitter<((event: { cell: GridLocation, domEvent: MouseEvent }) => boolean|void)|string>();
     /**
      * Fires on the owning Grid when cell editing is finished
      * @param {object} event Event object
@@ -2239,7 +2245,7 @@ export class BryntumGridComponent implements OnInit, OnDestroy {
      * @param {Core.data.Model[]} event.context.records The dragged row records
      * @param {MouseEvent,TouchEvent} event.event
      */
-    @Output() onGridRowBeforeDragStart: any = new EventEmitter<((event: { source: GridBase, context: { records: Model[] }, event: MouseEvent|TouchEvent }) => Promise<boolean>|boolean|void)|string>();
+    @Output() onGridRowBeforeDragStart: any = new EventEmitter<((event: { source: GridBase, context: { records: Model[] }, event: MouseEvent|TouchEvent }) => boolean|void)|string>();
     /**
      * Fired before the row drop operation is finalized. You can return false to abort the drop operation, or a
      * Promise yielding `true` / `false` which allows for asynchronous abort (e.g. first show user a confirmation dialog).
@@ -2306,7 +2312,7 @@ export class BryntumGridComponent implements OnInit, OnDestroy {
      * @param {Event} event.domEvent The triggering DOM event.
      * @param {Grid.column.Column} event.column The column clicked on.
      */
-    @Output() onHeaderClick: any = new EventEmitter<((event: { domEvent: Event, column: Column }) => Promise<boolean>|boolean|void)|string>();
+    @Output() onHeaderClick: any = new EventEmitter<((event: { domEvent: Event, column: Column }) => boolean|void)|string>();
     /**
      * This event fires on the owning Grid before the context menu is shown for a header.
      * Allows manipulation of the items to show in the same way as in the [processItems](https://bryntum.com/products/grid/docs/api/Grid/feature/HeaderMenu#config-processItems).
@@ -2317,7 +2323,7 @@ export class BryntumGridComponent implements OnInit, OnDestroy {
      * @param {Record<string, MenuItemEntry>} event.items Menu item configs
      * @param {Grid.column.Column} event.column Column
      */
-    @Output() onHeaderMenuBeforeShow: any = new EventEmitter<((event: { source: Grid, menu: Menu, items: Record<string, MenuItemEntry>, column: Column }) => Promise<boolean>|boolean|void)|string>();
+    @Output() onHeaderMenuBeforeShow: any = new EventEmitter<((event: { source: Grid, menu: Menu, items: Record<string, MenuItemEntry>, column: Column }) => boolean|void)|string>();
     /**
      * This event fires on the owning Grid when an item is selected in the header context menu.
      * @param {object} event Event object
@@ -2528,7 +2534,7 @@ export class BryntumGridComponent implements OnInit, OnDestroy {
      * @param {Grid.view.SubGrid} event.subGrid The subgrid
      * @param {Event} event.domEvent The native DOM event
      */
-    @Output() onSplitterCollapseClick: any = new EventEmitter<((event: { source: Grid, subGrid: SubGrid, domEvent: Event }) => Promise<boolean>|boolean|void)|string>();
+    @Output() onSplitterCollapseClick: any = new EventEmitter<((event: { source: Grid, subGrid: SubGrid, domEvent: Event }) => boolean|void)|string>();
     /**
      * Fired by the Grid after a sub-grid has been resized using the splitter
      * @param {object} event Event object
@@ -2553,7 +2559,7 @@ export class BryntumGridComponent implements OnInit, OnDestroy {
      * @param {Grid.view.SubGrid} event.subGrid The subgrid
      * @param {Event} event.domEvent The native DOM event
      */
-    @Output() onSplitterExpandClick: any = new EventEmitter<((event: { source: Grid, subGrid: SubGrid, domEvent: Event }) => Promise<boolean>|boolean|void)|string>();
+    @Output() onSplitterExpandClick: any = new EventEmitter<((event: { source: Grid, subGrid: SubGrid, domEvent: Event }) => boolean|void)|string>();
     /**
      * Fires on the owning Grid when editing starts
      * @param {object} event Event object