@bryntum/grid-angular-thin 7.3.0 → 7.3.2

package/lib/bryntum-a-i-filter-field.component.d.ts

@@ -31,6 +31,8 @@ export declare type BryntumAIFilterFieldProps = {
     /**
      * 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;
     /**
@@ -80,6 +82,15 @@ export declare type BryntumAIFilterFieldProps = {
      * Set to `true` to centre the Widget in browser viewport space.
      */
     centered?: boolean;
+    /**
+     * 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)
+     * evaluation, after the built-in [required](https://bryntum.com/products/grid/docs/api/Core/widget/Field#config-required) check.
+     * [More...](https://bryntum.com/products/grid/docs/api/Grid/widget/AIFilterField#config-checkValidity)
+     * @param {Core.widget.Field} field The field being validated
+     * @returns {void}
+     */
+    checkValidity?: ((field: Field) => void) | string;
     /**
      * Show a trigger to clear field, if this field is not [readOnly](https://bryntum.com/products/grid/docs/api/Core/widget/Field#config-readOnly). The trigger is available
      * in the [triggers](https://bryntum.com/products/grid/docs/api/Core/widget/Field#property-triggers) object under the name `clear`. May also be an object which
@@ -294,10 +305,14 @@ export declare type BryntumAIFilterFieldProps = {
     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;
     /**
@@ -624,6 +639,7 @@ export declare class BryntumAIFilterFieldComponent implements OnInit, OnDestroy
     autoSelect: boolean;
     bubbleEvents: object;
     centered: boolean;
+    checkValidity: ((field: Field) => void) | string;
     clearable: boolean | FieldTriggerConfig;
     client: Grid;
     color: Color;
@@ -910,5 +926,5 @@ export declare class BryntumAIFilterFieldComponent implements OnInit, OnDestroy
      */
     ngOnDestroy(): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<BryntumAIFilterFieldComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<BryntumAIFilterFieldComponent, "bryntum-a-i-filter-field", never, { "adopt": "adopt"; "align": "align"; "anchor": "anchor"; "ariaDescription": "ariaDescription"; "ariaLabel": "ariaLabel"; "autoComplete": "autoComplete"; "autoSelect": "autoSelect"; "bubbleEvents": "bubbleEvents"; "centered": "centered"; "clearable": "clearable"; "client": "client"; "color": "color"; "config": "config"; "constrainTo": "constrainTo"; "container": "container"; "containValues": "containValues"; "contentElementCls": "contentElementCls"; "dataField": "dataField"; "defaultBindProperty": "defaultBindProperty"; "detectCSSCompatibilityIssues": "detectCSSCompatibilityIssues"; "dock": "dock"; "draggable": "draggable"; "elementAttributes": "elementAttributes"; "floating": "floating"; "hideAnimation": "hideAnimation"; "highlightExternalChange": "highlightExternalChange"; "hint": "hint"; "hintHtml": "hintHtml"; "ignoreParentReadOnly": "ignoreParentReadOnly"; "inline": "inline"; "inputAlign": "inputAlign"; "inputAttributes": "inputAttributes"; "inputTag": "inputTag"; "inputType": "inputType"; "inputWidth": "inputWidth"; "keyStrokeChangeDelay": "keyStrokeChangeDelay"; "labelCls": "labelCls"; "labelPosition": "labelPosition"; "labels": "labels"; "labelWidth": "labelWidth"; "listeners": "listeners"; "localeClass": "localeClass"; "localizable": "localizable"; "localizableProperties": "localizableProperties"; "maskDefaults": "maskDefaults"; "masked": "masked"; "maxLength": "maxLength"; "minLength": "minLength"; "monitorResize": "monitorResize"; "name": "name"; "positioned": "positioned"; "preventTooltipOnTouch": "preventTooltipOnTouch"; "progressText": "progressText"; "relayStoreEvents": "relayStoreEvents"; "revertOnEscape": "revertOnEscape"; "ripple": "ripple"; "role": "role"; "rootElement": "rootElement"; "scrollAction": "scrollAction"; "showAnimation": "showAnimation"; "showTooltipWhenDisabled": "showTooltipWhenDisabled"; "skipValidation": "skipValidation"; "spellCheck": "spellCheck"; "tab": "tab"; "tabIndex": "tabIndex"; "textAlign": "textAlign"; "title": "title"; "type": "type"; "ui": "ui"; "validateOnInput": "validateOnInput"; "weight": "weight"; "alignSelf": "alignSelf"; "appendTo": "appendTo"; "badge": "badge"; "callOnFunctions": "callOnFunctions"; "catchEventHandlerExceptions": "catchEventHandlerExceptions"; "cls": "cls"; "column": "column"; "dataset": "dataset"; "disabled": "disabled"; "editable": "editable"; "extraData": "extraData"; "flex": "flex"; "height": "height"; "hidden": "hidden"; "id": "id"; "insertBefore": "insertBefore"; "insertFirst": "insertFirst"; "keyMap": "keyMap"; "label": "label"; "margin": "margin"; "maxHeight": "maxHeight"; "maximizeOnMobile": "maximizeOnMobile"; "maxWidth": "maxWidth"; "minHeight": "minHeight"; "minWidth": "minWidth"; "placeholder": "placeholder"; "readOnly": "readOnly"; "rendition": "rendition"; "required": "required"; "rtl": "rtl"; "showRequiredIndicator": "showRequiredIndicator"; "span": "span"; "tooltip": "tooltip"; "triggers": "triggers"; "value": "value"; "width": "width"; "x": "x"; "y": "y"; "content": "content"; "formula": "formula"; "html": "html"; "input": "input"; "parent": "parent"; "scrollable": "scrollable"; }, { "onAction": "onAction"; "onBeforeDestroy": "onBeforeDestroy"; "onBeforeHide": "onBeforeHide"; "onBeforeShow": "onBeforeShow"; "onCatchAll": "onCatchAll"; "onChange": "onChange"; "onClear": "onClear"; "onDestroy": "onDestroy"; "onElementCreated": "onElementCreated"; "onFocusIn": "onFocusIn"; "onFocusOut": "onFocusOut"; "onHide": "onHide"; "onInput": "onInput"; "onPaint": "onPaint"; "onReadOnly": "onReadOnly"; "onRecompose": "onRecompose"; "onResize": "onResize"; "onShow": "onShow"; "onTrigger": "onTrigger"; }, never, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<BryntumAIFilterFieldComponent, "bryntum-a-i-filter-field", never, { "adopt": "adopt"; "align": "align"; "anchor": "anchor"; "ariaDescription": "ariaDescription"; "ariaLabel": "ariaLabel"; "autoComplete": "autoComplete"; "autoSelect": "autoSelect"; "bubbleEvents": "bubbleEvents"; "centered": "centered"; "checkValidity": "checkValidity"; "clearable": "clearable"; "client": "client"; "color": "color"; "config": "config"; "constrainTo": "constrainTo"; "container": "container"; "containValues": "containValues"; "contentElementCls": "contentElementCls"; "dataField": "dataField"; "defaultBindProperty": "defaultBindProperty"; "detectCSSCompatibilityIssues": "detectCSSCompatibilityIssues"; "dock": "dock"; "draggable": "draggable"; "elementAttributes": "elementAttributes"; "floating": "floating"; "hideAnimation": "hideAnimation"; "highlightExternalChange": "highlightExternalChange"; "hint": "hint"; "hintHtml": "hintHtml"; "ignoreParentReadOnly": "ignoreParentReadOnly"; "inline": "inline"; "inputAlign": "inputAlign"; "inputAttributes": "inputAttributes"; "inputTag": "inputTag"; "inputType": "inputType"; "inputWidth": "inputWidth"; "keyStrokeChangeDelay": "keyStrokeChangeDelay"; "labelCls": "labelCls"; "labelPosition": "labelPosition"; "labels": "labels"; "labelWidth": "labelWidth"; "listeners": "listeners"; "localeClass": "localeClass"; "localizable": "localizable"; "localizableProperties": "localizableProperties"; "maskDefaults": "maskDefaults"; "masked": "masked"; "maxLength": "maxLength"; "minLength": "minLength"; "monitorResize": "monitorResize"; "name": "name"; "positioned": "positioned"; "preventTooltipOnTouch": "preventTooltipOnTouch"; "progressText": "progressText"; "relayStoreEvents": "relayStoreEvents"; "revertOnEscape": "revertOnEscape"; "ripple": "ripple"; "role": "role"; "rootElement": "rootElement"; "scrollAction": "scrollAction"; "showAnimation": "showAnimation"; "showTooltipWhenDisabled": "showTooltipWhenDisabled"; "skipValidation": "skipValidation"; "spellCheck": "spellCheck"; "tab": "tab"; "tabIndex": "tabIndex"; "textAlign": "textAlign"; "title": "title"; "type": "type"; "ui": "ui"; "validateOnInput": "validateOnInput"; "weight": "weight"; "alignSelf": "alignSelf"; "appendTo": "appendTo"; "badge": "badge"; "callOnFunctions": "callOnFunctions"; "catchEventHandlerExceptions": "catchEventHandlerExceptions"; "cls": "cls"; "column": "column"; "dataset": "dataset"; "disabled": "disabled"; "editable": "editable"; "extraData": "extraData"; "flex": "flex"; "height": "height"; "hidden": "hidden"; "id": "id"; "insertBefore": "insertBefore"; "insertFirst": "insertFirst"; "keyMap": "keyMap"; "label": "label"; "margin": "margin"; "maxHeight": "maxHeight"; "maximizeOnMobile": "maximizeOnMobile"; "maxWidth": "maxWidth"; "minHeight": "minHeight"; "minWidth": "minWidth"; "placeholder": "placeholder"; "readOnly": "readOnly"; "rendition": "rendition"; "required": "required"; "rtl": "rtl"; "showRequiredIndicator": "showRequiredIndicator"; "span": "span"; "tooltip": "tooltip"; "triggers": "triggers"; "value": "value"; "width": "width"; "x": "x"; "y": "y"; "content": "content"; "formula": "formula"; "html": "html"; "input": "input"; "parent": "parent"; "scrollable": "scrollable"; }, { "onAction": "onAction"; "onBeforeDestroy": "onBeforeDestroy"; "onBeforeHide": "onBeforeHide"; "onBeforeShow": "onBeforeShow"; "onCatchAll": "onCatchAll"; "onChange": "onChange"; "onClear": "onClear"; "onDestroy": "onDestroy"; "onElementCreated": "onElementCreated"; "onFocusIn": "onFocusIn"; "onFocusOut": "onFocusOut"; "onHide": "onHide"; "onInput": "onInput"; "onPaint": "onPaint"; "onReadOnly": "onReadOnly"; "onRecompose": "onRecompose"; "onResize": "onResize"; "onShow": "onShow"; "onTrigger": "onTrigger"; }, never, never>;
 }

package/lib/bryntum-checklist-filter-combo.component.d.ts

@@ -31,6 +31,8 @@ export declare type BryntumChecklistFilterComboProps = {
     /**
      * 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;
     /**
@@ -93,6 +95,15 @@ export declare type BryntumChecklistFilterComboProps = {
      * Set to `true` to centre the Widget in browser viewport space.
      */
     centered?: boolean;
+    /**
+     * 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)
+     * evaluation, after the built-in [required](https://bryntum.com/products/grid/docs/api/Core/widget/Field#config-required) check.
+     * [More...](https://bryntum.com/products/grid/docs/api/Grid/widget/ChecklistFilterCombo#config-checkValidity)
+     * @param {Core.widget.Field} field The field being validated
+     * @returns {void}
+     */
+    checkValidity?: ((field: Field) => void) | string;
     /**
      * A config object to configure the [ChipView](https://bryntum.com/products/grid/docs/api/Core/widget/ChipView) to display the
      * selected value set when [multiSelect](https://bryntum.com/products/grid/docs/api/Core/widget/Combo#config-multiSelect) is `true`.
@@ -392,10 +403,14 @@ export declare type BryntumChecklistFilterComboProps = {
     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;
     /**
@@ -813,6 +828,7 @@ export declare class BryntumChecklistFilterComboComponent implements OnInit, OnD
     cacheLastResult: number | string | Duration | DurationConfig;
     caseSensitive: boolean;
     centered: boolean;
+    checkValidity: ((field: Field) => void) | string;
     chipView: ChipViewConfig;
     clearable: boolean | FieldTriggerConfig;
     clearTextOnPickerHide: boolean;
@@ -1138,5 +1154,5 @@ export declare class BryntumChecklistFilterComboComponent implements OnInit, OnD
      */
     ngOnDestroy(): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<BryntumChecklistFilterComboComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<BryntumChecklistFilterComboComponent, "bryntum-checklist-filter-combo", never, { "adopt": "adopt"; "align": "align"; "anchor": "anchor"; "ariaDescription": "ariaDescription"; "ariaLabel": "ariaLabel"; "autoComplete": "autoComplete"; "autoExpand": "autoExpand"; "autoSelect": "autoSelect"; "bubbleEvents": "bubbleEvents"; "cacheLastResult": "cacheLastResult"; "caseSensitive": "caseSensitive"; "centered": "centered"; "chipView": "chipView"; "clearable": "clearable"; "clearTextOnPickerHide": "clearTextOnPickerHide"; "clearTextOnSelection": "clearTextOnSelection"; "clearWhenInputEmpty": "clearWhenInputEmpty"; "color": "color"; "config": "config"; "constrainTo": "constrainTo"; "container": "container"; "containValues": "containValues"; "contentElementCls": "contentElementCls"; "createOnUnmatched": "createOnUnmatched"; "dataField": "dataField"; "defaultBindProperty": "defaultBindProperty"; "detectCSSCompatibilityIssues": "detectCSSCompatibilityIssues"; "displayField": "displayField"; "displayValueRenderer": "displayValueRenderer"; "dock": "dock"; "draggable": "draggable"; "elementAttributes": "elementAttributes"; "emptyText": "emptyText"; "encodeFilterParams": "encodeFilterParams"; "filterOnEnter": "filterOnEnter"; "filterParamName": "filterParamName"; "filterSelected": "filterSelected"; "floating": "floating"; "hideAnimation": "hideAnimation"; "hidePickerOnSelect": "hidePickerOnSelect"; "hideTrigger": "hideTrigger"; "highlightExternalChange": "highlightExternalChange"; "hint": "hint"; "hintHtml": "hintHtml"; "ignoreParentReadOnly": "ignoreParentReadOnly"; "inline": "inline"; "inlinePicker": "inlinePicker"; "inputAlign": "inputAlign"; "inputAttributes": "inputAttributes"; "inputTag": "inputTag"; "inputType": "inputType"; "inputWidth": "inputWidth"; "items": "items"; "keyStrokeChangeDelay": "keyStrokeChangeDelay"; "keyStrokeFilterDelay": "keyStrokeFilterDelay"; "labelCls": "labelCls"; "labelPosition": "labelPosition"; "labels": "labels"; "labelWidth": "labelWidth"; "listCls": "listCls"; "listeners": "listeners"; "listItemTpl": "listItemTpl"; "localeClass": "localeClass"; "localizable": "localizable"; "localizableProperties": "localizableProperties"; "maskDefaults": "maskDefaults"; "masked": "masked"; "maxLength": "maxLength"; "minChars": "minChars"; "minLength": "minLength"; "monitorResize": "monitorResize"; "multiValueSeparator": "multiValueSeparator"; "name": "name"; "overlayAnchor": "overlayAnchor"; "pickerAlignElement": "pickerAlignElement"; "pickerWidth": "pickerWidth"; "positioned": "positioned"; "preventTooltipOnTouch": "preventTooltipOnTouch"; "primaryFilter": "primaryFilter"; "relayStoreEvents": "relayStoreEvents"; "revertOnEscape": "revertOnEscape"; "ripple": "ripple"; "role": "role"; "rootElement": "rootElement"; "scrollAction": "scrollAction"; "showAnimation": "showAnimation"; "showTooltipWhenDisabled": "showTooltipWhenDisabled"; "skipValidation": "skipValidation"; "spellCheck": "spellCheck"; "tab": "tab"; "tabIndex": "tabIndex"; "textAlign": "textAlign"; "title": "title"; "triggerAction": "triggerAction"; "type": "type"; "ui": "ui"; "validateFilter": "validateFilter"; "validateOnInput": "validateOnInput"; "valueField": "valueField"; "weight": "weight"; "alignSelf": "alignSelf"; "appendTo": "appendTo"; "badge": "badge"; "callOnFunctions": "callOnFunctions"; "catchEventHandlerExceptions": "catchEventHandlerExceptions"; "cls": "cls"; "column": "column"; "dataset": "dataset"; "disabled": "disabled"; "editable": "editable"; "extraData": "extraData"; "filterOperator": "filterOperator"; "flex": "flex"; "height": "height"; "hidden": "hidden"; "id": "id"; "insertBefore": "insertBefore"; "insertFirst": "insertFirst"; "keyMap": "keyMap"; "label": "label"; "listItemPillTpl": "listItemPillTpl"; "margin": "margin"; "maxHeight": "maxHeight"; "maximizeOnMobile": "maximizeOnMobile"; "maxWidth": "maxWidth"; "minHeight": "minHeight"; "minWidth": "minWidth"; "picker": "picker"; "placeholder": "placeholder"; "readOnly": "readOnly"; "rendition": "rendition"; "required": "required"; "rtl": "rtl"; "searchText": "searchText"; "showApplyButton": "showApplyButton"; "showRequiredIndicator": "showRequiredIndicator"; "span": "span"; "store": "store"; "tooltip": "tooltip"; "triggers": "triggers"; "value": "value"; "width": "width"; "x": "x"; "y": "y"; "content": "content"; "formula": "formula"; "html": "html"; "input": "input"; "multiSelect": "multiSelect"; "parent": "parent"; "scrollable": "scrollable"; }, { "onAction": "onAction"; "onBeforeDestroy": "onBeforeDestroy"; "onBeforeHide": "onBeforeHide"; "onBeforeShow": "onBeforeShow"; "onCatchAll": "onCatchAll"; "onChange": "onChange"; "onClear": "onClear"; "onDestroy": "onDestroy"; "onElementCreated": "onElementCreated"; "onFocusIn": "onFocusIn"; "onFocusOut": "onFocusOut"; "onHide": "onHide"; "onInput": "onInput"; "onPaint": "onPaint"; "onReadOnly": "onReadOnly"; "onRecompose": "onRecompose"; "onResize": "onResize"; "onSelect": "onSelect"; "onShow": "onShow"; "onTrigger": "onTrigger"; }, never, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<BryntumChecklistFilterComboComponent, "bryntum-checklist-filter-combo", never, { "adopt": "adopt"; "align": "align"; "anchor": "anchor"; "ariaDescription": "ariaDescription"; "ariaLabel": "ariaLabel"; "autoComplete": "autoComplete"; "autoExpand": "autoExpand"; "autoSelect": "autoSelect"; "bubbleEvents": "bubbleEvents"; "cacheLastResult": "cacheLastResult"; "caseSensitive": "caseSensitive"; "centered": "centered"; "checkValidity": "checkValidity"; "chipView": "chipView"; "clearable": "clearable"; "clearTextOnPickerHide": "clearTextOnPickerHide"; "clearTextOnSelection": "clearTextOnSelection"; "clearWhenInputEmpty": "clearWhenInputEmpty"; "color": "color"; "config": "config"; "constrainTo": "constrainTo"; "container": "container"; "containValues": "containValues"; "contentElementCls": "contentElementCls"; "createOnUnmatched": "createOnUnmatched"; "dataField": "dataField"; "defaultBindProperty": "defaultBindProperty"; "detectCSSCompatibilityIssues": "detectCSSCompatibilityIssues"; "displayField": "displayField"; "displayValueRenderer": "displayValueRenderer"; "dock": "dock"; "draggable": "draggable"; "elementAttributes": "elementAttributes"; "emptyText": "emptyText"; "encodeFilterParams": "encodeFilterParams"; "filterOnEnter": "filterOnEnter"; "filterParamName": "filterParamName"; "filterSelected": "filterSelected"; "floating": "floating"; "hideAnimation": "hideAnimation"; "hidePickerOnSelect": "hidePickerOnSelect"; "hideTrigger": "hideTrigger"; "highlightExternalChange": "highlightExternalChange"; "hint": "hint"; "hintHtml": "hintHtml"; "ignoreParentReadOnly": "ignoreParentReadOnly"; "inline": "inline"; "inlinePicker": "inlinePicker"; "inputAlign": "inputAlign"; "inputAttributes": "inputAttributes"; "inputTag": "inputTag"; "inputType": "inputType"; "inputWidth": "inputWidth"; "items": "items"; "keyStrokeChangeDelay": "keyStrokeChangeDelay"; "keyStrokeFilterDelay": "keyStrokeFilterDelay"; "labelCls": "labelCls"; "labelPosition": "labelPosition"; "labels": "labels"; "labelWidth": "labelWidth"; "listCls": "listCls"; "listeners": "listeners"; "listItemTpl": "listItemTpl"; "localeClass": "localeClass"; "localizable": "localizable"; "localizableProperties": "localizableProperties"; "maskDefaults": "maskDefaults"; "masked": "masked"; "maxLength": "maxLength"; "minChars": "minChars"; "minLength": "minLength"; "monitorResize": "monitorResize"; "multiValueSeparator": "multiValueSeparator"; "name": "name"; "overlayAnchor": "overlayAnchor"; "pickerAlignElement": "pickerAlignElement"; "pickerWidth": "pickerWidth"; "positioned": "positioned"; "preventTooltipOnTouch": "preventTooltipOnTouch"; "primaryFilter": "primaryFilter"; "relayStoreEvents": "relayStoreEvents"; "revertOnEscape": "revertOnEscape"; "ripple": "ripple"; "role": "role"; "rootElement": "rootElement"; "scrollAction": "scrollAction"; "showAnimation": "showAnimation"; "showTooltipWhenDisabled": "showTooltipWhenDisabled"; "skipValidation": "skipValidation"; "spellCheck": "spellCheck"; "tab": "tab"; "tabIndex": "tabIndex"; "textAlign": "textAlign"; "title": "title"; "triggerAction": "triggerAction"; "type": "type"; "ui": "ui"; "validateFilter": "validateFilter"; "validateOnInput": "validateOnInput"; "valueField": "valueField"; "weight": "weight"; "alignSelf": "alignSelf"; "appendTo": "appendTo"; "badge": "badge"; "callOnFunctions": "callOnFunctions"; "catchEventHandlerExceptions": "catchEventHandlerExceptions"; "cls": "cls"; "column": "column"; "dataset": "dataset"; "disabled": "disabled"; "editable": "editable"; "extraData": "extraData"; "filterOperator": "filterOperator"; "flex": "flex"; "height": "height"; "hidden": "hidden"; "id": "id"; "insertBefore": "insertBefore"; "insertFirst": "insertFirst"; "keyMap": "keyMap"; "label": "label"; "listItemPillTpl": "listItemPillTpl"; "margin": "margin"; "maxHeight": "maxHeight"; "maximizeOnMobile": "maximizeOnMobile"; "maxWidth": "maxWidth"; "minHeight": "minHeight"; "minWidth": "minWidth"; "picker": "picker"; "placeholder": "placeholder"; "readOnly": "readOnly"; "rendition": "rendition"; "required": "required"; "rtl": "rtl"; "searchText": "searchText"; "showApplyButton": "showApplyButton"; "showRequiredIndicator": "showRequiredIndicator"; "span": "span"; "store": "store"; "tooltip": "tooltip"; "triggers": "triggers"; "value": "value"; "width": "width"; "x": "x"; "y": "y"; "content": "content"; "formula": "formula"; "html": "html"; "input": "input"; "multiSelect": "multiSelect"; "parent": "parent"; "scrollable": "scrollable"; }, { "onAction": "onAction"; "onBeforeDestroy": "onBeforeDestroy"; "onBeforeHide": "onBeforeHide"; "onBeforeShow": "onBeforeShow"; "onCatchAll": "onCatchAll"; "onChange": "onChange"; "onClear": "onClear"; "onDestroy": "onDestroy"; "onElementCreated": "onElementCreated"; "onFocusIn": "onFocusIn"; "onFocusOut": "onFocusOut"; "onHide": "onHide"; "onInput": "onInput"; "onPaint": "onPaint"; "onReadOnly": "onReadOnly"; "onRecompose": "onRecompose"; "onResize": "onResize"; "onSelect": "onSelect"; "onShow": "onShow"; "onTrigger": "onTrigger"; }, never, never>;
 }

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

@@ -39,6 +39,8 @@ export declare 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;
     /**
@@ -360,10 +362,14 @@ export declare 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;
     /**

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

@@ -31,6 +31,8 @@ export declare 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;
     /**
@@ -208,10 +210,14 @@ export declare 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;
     /**

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

@@ -41,6 +41,8 @@ export declare 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;
     /**
@@ -289,10 +291,14 @@ export declare 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;
     /**

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

@@ -38,6 +38,8 @@ export declare 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;
     /**
@@ -274,10 +276,14 @@ export declare 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;
     /**

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

@@ -39,6 +39,8 @@ export declare 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;
     /**
@@ -360,10 +362,14 @@ export declare 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;
     /**

package/lib/bryntum-group-bar.component.d.ts

@@ -41,6 +41,8 @@ export declare type BryntumGroupBarProps = {
     /**
      * 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;
     /**
@@ -90,9 +92,11 @@ export declare type BryntumGroupBarProps = {
     /**
      * 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
@@ -269,10 +273,14 @@ export declare type BryntumGroupBarProps = {
     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;
     /**
@@ -559,7 +567,7 @@ export declare class BryntumGroupBarComponent implements OnInit, OnDestroy {
     bubbleEvents: object;
     centered: boolean;
     closable: boolean;
-    closeHandler: string | (() => void);
+    closeHandler: string | ((records: Model[], options: object) => void);
     color: Color;
     config: object;
     constrainTo: HTMLElement | Widget | Rectangle;

package/lib/bryntum-tree-combo.component.d.ts

@@ -31,6 +31,8 @@ export declare type BryntumTreeComboProps = {
     /**
      * 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;
     /**
@@ -93,6 +95,15 @@ export declare type BryntumTreeComboProps = {
      * Set to `true` to centre the Widget in browser viewport space.
      */
     centered?: boolean;
+    /**
+     * 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)
+     * evaluation, after the built-in [required](https://bryntum.com/products/grid/docs/api/Core/widget/Field#config-required) check.
+     * [More...](https://bryntum.com/products/grid/docs/api/Grid/widget/TreeCombo#config-checkValidity)
+     * @param {Core.widget.Field} field The field being validated
+     * @returns {void}
+     */
+    checkValidity?: ((field: Field) => void) | string;
     /**
      * A config object to configure the [ChipView](https://bryntum.com/products/grid/docs/api/Core/widget/ChipView) to display the
      * selected value set when [multiSelect](https://bryntum.com/products/grid/docs/api/Core/widget/Combo#config-multiSelect) is `true`.
@@ -392,10 +403,14 @@ export declare type BryntumTreeComboProps = {
     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;
     /**
@@ -804,6 +819,7 @@ export declare class BryntumTreeComboComponent implements OnInit, OnDestroy {
     cacheLastResult: number | string | Duration | DurationConfig;
     caseSensitive: boolean;
     centered: boolean;
+    checkValidity: ((field: Field) => void) | string;
     chipView: ChipViewConfig;
     clearable: boolean | FieldTriggerConfig;
     clearTextOnPickerHide: boolean;
@@ -1126,5 +1142,5 @@ export declare class BryntumTreeComboComponent implements OnInit, OnDestroy {
      */
     ngOnDestroy(): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<BryntumTreeComboComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<BryntumTreeComboComponent, "bryntum-tree-combo", never, { "adopt": "adopt"; "align": "align"; "anchor": "anchor"; "ariaDescription": "ariaDescription"; "ariaLabel": "ariaLabel"; "autoComplete": "autoComplete"; "autoExpand": "autoExpand"; "autoSelect": "autoSelect"; "bubbleEvents": "bubbleEvents"; "cacheLastResult": "cacheLastResult"; "caseSensitive": "caseSensitive"; "centered": "centered"; "chipView": "chipView"; "clearable": "clearable"; "clearTextOnPickerHide": "clearTextOnPickerHide"; "clearTextOnSelection": "clearTextOnSelection"; "clearWhenInputEmpty": "clearWhenInputEmpty"; "color": "color"; "config": "config"; "constrainTo": "constrainTo"; "container": "container"; "containValues": "containValues"; "contentElementCls": "contentElementCls"; "createOnUnmatched": "createOnUnmatched"; "dataField": "dataField"; "defaultBindProperty": "defaultBindProperty"; "detectCSSCompatibilityIssues": "detectCSSCompatibilityIssues"; "displayField": "displayField"; "displayValueRenderer": "displayValueRenderer"; "dock": "dock"; "draggable": "draggable"; "elementAttributes": "elementAttributes"; "emptyText": "emptyText"; "encodeFilterParams": "encodeFilterParams"; "filterOnEnter": "filterOnEnter"; "filterParamName": "filterParamName"; "filterSelected": "filterSelected"; "floating": "floating"; "hideAnimation": "hideAnimation"; "hidePickerOnSelect": "hidePickerOnSelect"; "hideTrigger": "hideTrigger"; "highlightExternalChange": "highlightExternalChange"; "hint": "hint"; "hintHtml": "hintHtml"; "ignoreParentReadOnly": "ignoreParentReadOnly"; "inline": "inline"; "inlinePicker": "inlinePicker"; "inputAlign": "inputAlign"; "inputAttributes": "inputAttributes"; "inputTag": "inputTag"; "inputType": "inputType"; "inputWidth": "inputWidth"; "items": "items"; "keyStrokeChangeDelay": "keyStrokeChangeDelay"; "keyStrokeFilterDelay": "keyStrokeFilterDelay"; "labelCls": "labelCls"; "labelPosition": "labelPosition"; "labels": "labels"; "labelWidth": "labelWidth"; "listCls": "listCls"; "listeners": "listeners"; "listItemTpl": "listItemTpl"; "localeClass": "localeClass"; "localizable": "localizable"; "localizableProperties": "localizableProperties"; "maskDefaults": "maskDefaults"; "masked": "masked"; "maxLength": "maxLength"; "minChars": "minChars"; "minLength": "minLength"; "monitorResize": "monitorResize"; "multiValueSeparator": "multiValueSeparator"; "name": "name"; "overlayAnchor": "overlayAnchor"; "pickerAlignElement": "pickerAlignElement"; "pickerWidth": "pickerWidth"; "positioned": "positioned"; "preventTooltipOnTouch": "preventTooltipOnTouch"; "primaryFilter": "primaryFilter"; "relayStoreEvents": "relayStoreEvents"; "revertOnEscape": "revertOnEscape"; "ripple": "ripple"; "role": "role"; "rootElement": "rootElement"; "scrollAction": "scrollAction"; "showAnimation": "showAnimation"; "showTooltipWhenDisabled": "showTooltipWhenDisabled"; "skipValidation": "skipValidation"; "spellCheck": "spellCheck"; "tab": "tab"; "tabIndex": "tabIndex"; "textAlign": "textAlign"; "title": "title"; "triggerAction": "triggerAction"; "type": "type"; "ui": "ui"; "validateFilter": "validateFilter"; "validateOnInput": "validateOnInput"; "valueField": "valueField"; "weight": "weight"; "alignSelf": "alignSelf"; "appendTo": "appendTo"; "badge": "badge"; "callOnFunctions": "callOnFunctions"; "catchEventHandlerExceptions": "catchEventHandlerExceptions"; "cls": "cls"; "column": "column"; "dataset": "dataset"; "disabled": "disabled"; "editable": "editable"; "extraData": "extraData"; "filterOperator": "filterOperator"; "flex": "flex"; "height": "height"; "hidden": "hidden"; "id": "id"; "insertBefore": "insertBefore"; "insertFirst": "insertFirst"; "keyMap": "keyMap"; "label": "label"; "margin": "margin"; "maxHeight": "maxHeight"; "maximizeOnMobile": "maximizeOnMobile"; "maxWidth": "maxWidth"; "minHeight": "minHeight"; "minWidth": "minWidth"; "multiSelect": "multiSelect"; "picker": "picker"; "placeholder": "placeholder"; "readOnly": "readOnly"; "rendition": "rendition"; "required": "required"; "rtl": "rtl"; "showRequiredIndicator": "showRequiredIndicator"; "span": "span"; "store": "store"; "tooltip": "tooltip"; "triggers": "triggers"; "value": "value"; "width": "width"; "x": "x"; "y": "y"; "content": "content"; "formula": "formula"; "html": "html"; "input": "input"; "parent": "parent"; "scrollable": "scrollable"; }, { "onAction": "onAction"; "onBeforeDestroy": "onBeforeDestroy"; "onBeforeHide": "onBeforeHide"; "onBeforeShow": "onBeforeShow"; "onCatchAll": "onCatchAll"; "onChange": "onChange"; "onClear": "onClear"; "onDestroy": "onDestroy"; "onElementCreated": "onElementCreated"; "onFocusIn": "onFocusIn"; "onFocusOut": "onFocusOut"; "onHide": "onHide"; "onInput": "onInput"; "onPaint": "onPaint"; "onReadOnly": "onReadOnly"; "onRecompose": "onRecompose"; "onResize": "onResize"; "onSelect": "onSelect"; "onShow": "onShow"; "onTrigger": "onTrigger"; }, never, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<BryntumTreeComboComponent, "bryntum-tree-combo", never, { "adopt": "adopt"; "align": "align"; "anchor": "anchor"; "ariaDescription": "ariaDescription"; "ariaLabel": "ariaLabel"; "autoComplete": "autoComplete"; "autoExpand": "autoExpand"; "autoSelect": "autoSelect"; "bubbleEvents": "bubbleEvents"; "cacheLastResult": "cacheLastResult"; "caseSensitive": "caseSensitive"; "centered": "centered"; "checkValidity": "checkValidity"; "chipView": "chipView"; "clearable": "clearable"; "clearTextOnPickerHide": "clearTextOnPickerHide"; "clearTextOnSelection": "clearTextOnSelection"; "clearWhenInputEmpty": "clearWhenInputEmpty"; "color": "color"; "config": "config"; "constrainTo": "constrainTo"; "container": "container"; "containValues": "containValues"; "contentElementCls": "contentElementCls"; "createOnUnmatched": "createOnUnmatched"; "dataField": "dataField"; "defaultBindProperty": "defaultBindProperty"; "detectCSSCompatibilityIssues": "detectCSSCompatibilityIssues"; "displayField": "displayField"; "displayValueRenderer": "displayValueRenderer"; "dock": "dock"; "draggable": "draggable"; "elementAttributes": "elementAttributes"; "emptyText": "emptyText"; "encodeFilterParams": "encodeFilterParams"; "filterOnEnter": "filterOnEnter"; "filterParamName": "filterParamName"; "filterSelected": "filterSelected"; "floating": "floating"; "hideAnimation": "hideAnimation"; "hidePickerOnSelect": "hidePickerOnSelect"; "hideTrigger": "hideTrigger"; "highlightExternalChange": "highlightExternalChange"; "hint": "hint"; "hintHtml": "hintHtml"; "ignoreParentReadOnly": "ignoreParentReadOnly"; "inline": "inline"; "inlinePicker": "inlinePicker"; "inputAlign": "inputAlign"; "inputAttributes": "inputAttributes"; "inputTag": "inputTag"; "inputType": "inputType"; "inputWidth": "inputWidth"; "items": "items"; "keyStrokeChangeDelay": "keyStrokeChangeDelay"; "keyStrokeFilterDelay": "keyStrokeFilterDelay"; "labelCls": "labelCls"; "labelPosition": "labelPosition"; "labels": "labels"; "labelWidth": "labelWidth"; "listCls": "listCls"; "listeners": "listeners"; "listItemTpl": "listItemTpl"; "localeClass": "localeClass"; "localizable": "localizable"; "localizableProperties": "localizableProperties"; "maskDefaults": "maskDefaults"; "masked": "masked"; "maxLength": "maxLength"; "minChars": "minChars"; "minLength": "minLength"; "monitorResize": "monitorResize"; "multiValueSeparator": "multiValueSeparator"; "name": "name"; "overlayAnchor": "overlayAnchor"; "pickerAlignElement": "pickerAlignElement"; "pickerWidth": "pickerWidth"; "positioned": "positioned"; "preventTooltipOnTouch": "preventTooltipOnTouch"; "primaryFilter": "primaryFilter"; "relayStoreEvents": "relayStoreEvents"; "revertOnEscape": "revertOnEscape"; "ripple": "ripple"; "role": "role"; "rootElement": "rootElement"; "scrollAction": "scrollAction"; "showAnimation": "showAnimation"; "showTooltipWhenDisabled": "showTooltipWhenDisabled"; "skipValidation": "skipValidation"; "spellCheck": "spellCheck"; "tab": "tab"; "tabIndex": "tabIndex"; "textAlign": "textAlign"; "title": "title"; "triggerAction": "triggerAction"; "type": "type"; "ui": "ui"; "validateFilter": "validateFilter"; "validateOnInput": "validateOnInput"; "valueField": "valueField"; "weight": "weight"; "alignSelf": "alignSelf"; "appendTo": "appendTo"; "badge": "badge"; "callOnFunctions": "callOnFunctions"; "catchEventHandlerExceptions": "catchEventHandlerExceptions"; "cls": "cls"; "column": "column"; "dataset": "dataset"; "disabled": "disabled"; "editable": "editable"; "extraData": "extraData"; "filterOperator": "filterOperator"; "flex": "flex"; "height": "height"; "hidden": "hidden"; "id": "id"; "insertBefore": "insertBefore"; "insertFirst": "insertFirst"; "keyMap": "keyMap"; "label": "label"; "margin": "margin"; "maxHeight": "maxHeight"; "maximizeOnMobile": "maximizeOnMobile"; "maxWidth": "maxWidth"; "minHeight": "minHeight"; "minWidth": "minWidth"; "multiSelect": "multiSelect"; "picker": "picker"; "placeholder": "placeholder"; "readOnly": "readOnly"; "rendition": "rendition"; "required": "required"; "rtl": "rtl"; "showRequiredIndicator": "showRequiredIndicator"; "span": "span"; "store": "store"; "tooltip": "tooltip"; "triggers": "triggers"; "value": "value"; "width": "width"; "x": "x"; "y": "y"; "content": "content"; "formula": "formula"; "html": "html"; "input": "input"; "parent": "parent"; "scrollable": "scrollable"; }, { "onAction": "onAction"; "onBeforeDestroy": "onBeforeDestroy"; "onBeforeHide": "onBeforeHide"; "onBeforeShow": "onBeforeShow"; "onCatchAll": "onCatchAll"; "onChange": "onChange"; "onClear": "onClear"; "onDestroy": "onDestroy"; "onElementCreated": "onElementCreated"; "onFocusIn": "onFocusIn"; "onFocusOut": "onFocusOut"; "onHide": "onHide"; "onInput": "onInput"; "onPaint": "onPaint"; "onReadOnly": "onReadOnly"; "onRecompose": "onRecompose"; "onResize": "onResize"; "onSelect": "onSelect"; "onShow": "onShow"; "onTrigger": "onTrigger"; }, never, never>;
 }

package/lib/bryntum-tree-grid.component.d.ts

@@ -39,6 +39,8 @@ export declare type BryntumTreeGridProps = {
     /**
      * 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;
     /**
@@ -360,10 +362,14 @@ export declare type BryntumTreeGridProps = {
     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;
     /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bryntum/grid-angular-thin",
-  "version": "7.3.0",
+  "version": "7.3.2",
   "description": "Angular IVY wrappers for Bryntum Grid JavaScript component",
   "keywords": [
     "bryntum",

package/src/lib/bryntum-a-i-filter-field.component.ts

@@ -40,6 +40,8 @@ export type BryntumAIFilterFieldProps = {
     /**
      * 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
     /**
@@ -89,6 +91,15 @@ export type BryntumAIFilterFieldProps = {
      * Set to `true` to centre the Widget in browser viewport space.
      */
     centered ? : boolean
+    /**
+     * 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)
+     * evaluation, after the built-in [required](https://bryntum.com/products/grid/docs/api/Core/widget/Field#config-required) check.
+     * [More...](https://bryntum.com/products/grid/docs/api/Grid/widget/AIFilterField#config-checkValidity)
+     * @param {Core.widget.Field} field The field being validated
+     * @returns {void}
+     */
+    checkValidity ? : ((field: Field) => void)|string
     /**
      * Show a trigger to clear field, if this field is not [readOnly](https://bryntum.com/products/grid/docs/api/Core/widget/Field#config-readOnly). The trigger is available
      * in the [triggers](https://bryntum.com/products/grid/docs/api/Core/widget/Field#property-triggers) object under the name `clear`. May also be an object which
@@ -297,10 +308,14 @@ export type BryntumAIFilterFieldProps = {
     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
     /**
@@ -659,6 +674,7 @@ export class BryntumAIFilterFieldComponent implements OnInit, OnDestroy {
         'callOnFunctions',
         'catchEventHandlerExceptions',
         'centered',
+        'checkValidity',
         'clearable',
         'client',
         'cls',
@@ -766,6 +782,7 @@ export class BryntumAIFilterFieldComponent implements OnInit, OnDestroy {
         'autoSelect',
         'bubbleEvents',
         'centered',
+        'checkValidity',
         'clearable',
         'client',
         'color',
@@ -903,6 +920,7 @@ export class BryntumAIFilterFieldComponent implements OnInit, OnDestroy {
     @Input() autoSelect                   ! : boolean;
     @Input() bubbleEvents                 ! : object;
     @Input() centered                     ! : boolean;
+    @Input() checkValidity                ! : ((field: Field) => void)|string;
     @Input() clearable                    ! : boolean|FieldTriggerConfig;
     @Input() client                       ! : Grid;
     @Input() color                        ! : Color;
@@ -1040,7 +1058,7 @@ export class BryntumAIFilterFieldComponent 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-checklist-filter-combo.component.ts

@@ -40,6 +40,8 @@ export type BryntumChecklistFilterComboProps = {
     /**
      * 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
     /**
@@ -102,6 +104,15 @@ export type BryntumChecklistFilterComboProps = {
      * Set to `true` to centre the Widget in browser viewport space.
      */
     centered ? : boolean
+    /**
+     * 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)
+     * evaluation, after the built-in [required](https://bryntum.com/products/grid/docs/api/Core/widget/Field#config-required) check.
+     * [More...](https://bryntum.com/products/grid/docs/api/Grid/widget/ChecklistFilterCombo#config-checkValidity)
+     * @param {Core.widget.Field} field The field being validated
+     * @returns {void}
+     */
+    checkValidity ? : ((field: Field) => void)|string
     /**
      * A config object to configure the [ChipView](https://bryntum.com/products/grid/docs/api/Core/widget/ChipView) to display the
      * selected value set when [multiSelect](https://bryntum.com/products/grid/docs/api/Core/widget/Combo#config-multiSelect) is `true`.
@@ -395,10 +406,14 @@ export type BryntumChecklistFilterComboProps = {
     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
     /**
@@ -849,6 +864,7 @@ export class BryntumChecklistFilterComboComponent implements OnInit, OnDestroy {
         'caseSensitive',
         'catchEventHandlerExceptions',
         'centered',
+        'checkValidity',
         'chipView',
         'clearable',
         'clearTextOnPickerHide',
@@ -991,6 +1007,7 @@ export class BryntumChecklistFilterComboComponent implements OnInit, OnDestroy {
         'cacheLastResult',
         'caseSensitive',
         'centered',
+        'checkValidity',
         'chipView',
         'clearable',
         'clearTextOnPickerHide',
@@ -1164,6 +1181,7 @@ export class BryntumChecklistFilterComboComponent implements OnInit, OnDestroy {
     @Input() cacheLastResult              ! : number|string|Duration|DurationConfig;
     @Input() caseSensitive                ! : boolean;
     @Input() centered                     ! : boolean;
+    @Input() checkValidity                ! : ((field: Field) => void)|string;
     @Input() chipView                     ! : ChipViewConfig;
     @Input() clearable                    ! : boolean|FieldTriggerConfig;
     @Input() clearTextOnPickerHide        ! : boolean;
@@ -1330,7 +1348,7 @@ export class BryntumChecklistFilterComboComponent 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