@bryntum/core-react-thin 7.3.0 → 7.3.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bryntum/core-react-thin",
-  "version": "7.3.0",
+  "version": "7.3.2",
   "description": "React wrappers for Bryntum Core JavaScript component",
   "keywords": [
     "bryntum",

package/src/BryntumBooleanCombo.tsx

@@ -34,6 +34,8 @@ export type BryntumBooleanComboProps = {
     /**
      * 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/core/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/Core/widget/BooleanCombo#config-appendTo)
      */
     appendTo? : HTMLElement|string
     /**
@@ -96,6 +98,15 @@ export type BryntumBooleanComboProps = {
      * 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/core/docs/api/Core/widget/Field#property-isValid)
+     * evaluation, after the built-in [required](https://bryntum.com/products/core/docs/api/Core/widget/Field#config-required) check.
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/BooleanCombo#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/core/docs/api/Core/widget/ChipView) to display the
      * selected value set when [multiSelect](https://bryntum.com/products/core/docs/api/Core/widget/Combo#config-multiSelect) is `true`.
@@ -389,10 +400,14 @@ export type BryntumBooleanComboProps = {
     inputWidth? : string|number
     /**
      * Element (or element id) to insert this widget before. If provided, [appendTo](https://bryntum.com/products/core/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/Core/widget/BooleanCombo#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/core/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/Core/widget/BooleanCombo#config-insertFirst)
      */
     insertFirst? : HTMLElement|string
     /**
@@ -814,7 +829,7 @@ export type BryntumBooleanComboProps = {
      * @param {object} event Event object
      * @param {Core.widget.Widget} event.source The widget being hidden.
      */
-    onBeforeHide? : ((event: { source: Widget }) => Promise<boolean>|boolean|void)|string
+    onBeforeHide? : ((event: { source: Widget }) => boolean|void)|string
     /**
      * Triggered before a widget is shown. Return `false` to prevent the action.
      * @param {object} event Event object
@@ -975,6 +990,7 @@ export class BryntumBooleanCombo extends React.Component<BryntumBooleanComboProp
         'cacheLastResult',
         'caseSensitive',
         'centered',
+        'checkValidity',
         'chipView',
         'clearable',
         'clearTextOnPickerHide',

package/src/BryntumButton.tsx

@@ -34,6 +34,8 @@ export type BryntumButtonProps = {
     /**
      * 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/core/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/Core/widget/Button#config-appendTo)
      */
     appendTo? : HTMLElement|string
     /**
@@ -227,10 +229,14 @@ export type BryntumButtonProps = {
     ignoreParentReadOnly? : boolean
     /**
      * Element (or element id) to insert this widget before. If provided, [appendTo](https://bryntum.com/products/core/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/Core/widget/Button#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/core/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/Core/widget/Button#config-insertFirst)
      */
     insertFirst? : HTMLElement|string
     /**
@@ -528,7 +534,7 @@ export type BryntumButtonProps = {
      * @param {object} event Event object
      * @param {Core.widget.Widget} event.source The widget being hidden.
      */
-    onBeforeHide? : ((event: { source: Widget }) => Promise<boolean>|boolean|void)|string
+    onBeforeHide? : ((event: { source: Widget }) => boolean|void)|string
     /**
      * Triggered before a widget is shown. Return `false` to prevent the action.
      * @param {object} event Event object
@@ -543,7 +549,7 @@ export type BryntumButtonProps = {
      * @param {boolean} event.userAction `true` if the toggle was triggered by a user action (click), `false` if it was triggered programmatically.
      * @param {Event} event.domEvent The original DOM event that triggered the action, if any. Using the `pointerType` property of this event can help determine if it was a mouse, touch or pen action.
      */
-    onBeforeShowMenu? : ((event: { source: Button, menu: Menu, userAction: boolean, domEvent: Event }) => Promise<boolean>|boolean|void)|string
+    onBeforeShowMenu? : ((event: { source: Button, menu: Menu, userAction: boolean, domEvent: Event }) => boolean|void)|string
     /**
      * Fires before the button is toggled (the [pressed](https://bryntum.com/products/core/docs/api/Core/widget/Button#property-pressed) state is changed). If the button is part of
      * a [toggleGroup](https://bryntum.com/products/core/docs/api/Core/widget/Button#config-toggleGroup) and you need to process the pressed button only, consider using
@@ -555,7 +561,7 @@ export type BryntumButtonProps = {
      * @param {boolean} event.userAction `true` if the toggle was triggered by a user action (click), `false` if it was triggered programmatically.
      * @param {Event} event.domEvent The original DOM event that triggered the action, if any. Using the `pointerType` property of this event can help determine if it was a mouse, touch or pen action.
      */
-    onBeforeToggle? : ((event: { source: Button, pressed: boolean, userAction: boolean, domEvent: Event }) => Promise<boolean>|boolean|void)|string
+    onBeforeToggle? : ((event: { source: Button, pressed: boolean, userAction: boolean, domEvent: Event }) => boolean|void)|string
     /**
      * Fires when any other event is fired from the object.
      * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/Button#event-catchAll)

package/src/BryntumButtonGroup.tsx

@@ -34,6 +34,8 @@ export type BryntumButtonGroupProps = {
     /**
      * 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/core/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/Core/widget/ButtonGroup#config-appendTo)
      */
     appendTo? : HTMLElement|string
     /**
@@ -235,10 +237,14 @@ export type BryntumButtonGroupProps = {
     inputFieldAlign? : 'start'|'end'
     /**
      * Element (or element id) to insert this widget before. If provided, [appendTo](https://bryntum.com/products/core/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/Core/widget/ButtonGroup#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/core/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/Core/widget/ButtonGroup#config-insertFirst)
      */
     insertFirst? : HTMLElement|string
     /**
@@ -553,7 +559,7 @@ export type BryntumButtonGroupProps = {
      * @param {object} event Event object
      * @param {Core.widget.Widget} event.source The widget being hidden.
      */
-    onBeforeHide? : ((event: { source: Widget }) => Promise<boolean>|boolean|void)|string
+    onBeforeHide? : ((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/BryntumChatPanel.tsx

@@ -38,6 +38,8 @@ export type BryntumChatPanelProps = {
     /**
      * 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/core/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/Core/widget/chat/ChatPanel#config-appendTo)
      */
     appendTo? : HTMLElement|string
     /**
@@ -310,10 +312,14 @@ export type BryntumChatPanelProps = {
     inputFieldAlign? : 'start'|'end'
     /**
      * Element (or element id) to insert this widget before. If provided, [appendTo](https://bryntum.com/products/core/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/Core/widget/chat/ChatPanel#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/core/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/Core/widget/chat/ChatPanel#config-insertFirst)
      */
     insertFirst? : HTMLElement|string
     /**
@@ -682,7 +688,7 @@ export type BryntumChatPanelProps = {
      * @param {object} event Event object
      * @param {Core.widget.Widget} event.source The widget being hidden.
      */
-    onBeforeHide? : ((event: { source: Widget }) => Promise<boolean>|boolean|void)|string
+    onBeforeHide? : ((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)
@@ -702,13 +708,13 @@ export type BryntumChatPanelProps = {
      * @param {object} event Event object
      * @param {any} event.state State object config
      */
-    onBeforeStateApply? : ((event: { state: any }) => Promise<boolean>|boolean|void)|string
+    onBeforeStateApply? : ((event: { state: any }) => 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 {any} event.state State object config
      */
-    onBeforeStateSave? : ((event: { state: any }) => Promise<boolean>|boolean|void)|string
+    onBeforeStateSave? : ((event: { state: any }) => boolean|void)|string
     /**
      * Fired when the chat bubble tool icon is clicked.
      * @param {object} event Event object

package/src/BryntumCheckbox.tsx

@@ -34,6 +34,8 @@ export type BryntumCheckboxProps = {
     /**
      * 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/core/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/Core/widget/Checkbox#config-appendTo)
      */
     appendTo? : HTMLElement|string
     /**
@@ -100,6 +102,15 @@ export type BryntumCheckboxProps = {
      * A value of `undefined` will cause this widget not to include its value when checked.
      */
     checkedValue? : any
+    /**
+     * 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/core/docs/api/Core/widget/Field#property-isValid)
+     * evaluation, after the built-in [required](https://bryntum.com/products/core/docs/api/Core/widget/Field#config-required) check.
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/Checkbox#config-checkValidity)
+     * @param {Core.widget.Field} field The field being validated
+     * @returns {void}
+     */
+    checkValidity? : ((field: Field) => void)|string
     /**
      * Custom CSS classes to add to element.
      * May be specified as a space separated string, or as an object in which property names
@@ -288,10 +299,14 @@ export type BryntumCheckboxProps = {
     inputWidth? : string|number
     /**
      * Element (or element id) to insert this widget before. If provided, [appendTo](https://bryntum.com/products/core/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/Core/widget/Checkbox#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/core/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/Core/widget/Checkbox#config-insertFirst)
      */
     insertFirst? : HTMLElement|string
     /**
@@ -610,7 +625,7 @@ export type BryntumCheckboxProps = {
      * @param {boolean} event.valid True if this field is in a valid state.
      * @param {Event} event.event The triggering DOM event if any
      */
-    onBeforeChange? : ((event: { source: Checkbox, checked: boolean, value: boolean, oldValue: boolean, userAction: boolean, valid: boolean, event: Event }) => Promise<boolean>|boolean|void)|string
+    onBeforeChange? : ((event: { source: Checkbox, checked: boolean, value: boolean, oldValue: boolean, userAction: boolean, valid: boolean, event: Event }) => boolean|void)|string
     /**
      * Fires before an object is destroyed.
      * @param {object} event Event object
@@ -622,7 +637,7 @@ export type BryntumCheckboxProps = {
      * @param {object} event Event object
      * @param {Core.widget.Widget} event.source The widget being hidden.
      */
-    onBeforeHide? : ((event: { source: Widget }) => Promise<boolean>|boolean|void)|string
+    onBeforeHide? : ((event: { source: Widget }) => boolean|void)|string
     /**
      * Triggered before a widget is shown. Return `false` to prevent the action.
      * @param {object} event Event object
@@ -779,6 +794,7 @@ export class BryntumCheckbox extends React.Component<BryntumCheckboxProps> {
         'bubbleEvents',
         'centered',
         'checkedValue',
+        'checkValidity',
         'color',
         'config',
         'constrainTo',

package/src/BryntumCheckboxGroup.tsx

@@ -34,6 +34,8 @@ export type BryntumCheckboxGroupProps = {
     /**
      * 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/core/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/Core/widget/CheckboxGroup#config-appendTo)
      */
     appendTo? : HTMLElement|string
     /**
@@ -297,10 +299,14 @@ export type BryntumCheckboxGroupProps = {
     inputFieldAlign? : 'start'|'end'
     /**
      * Element (or element id) to insert this widget before. If provided, [appendTo](https://bryntum.com/products/core/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/Core/widget/CheckboxGroup#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/core/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/Core/widget/CheckboxGroup#config-insertFirst)
      */
     insertFirst? : HTMLElement|string
     /**
@@ -693,7 +699,7 @@ export type BryntumCheckboxGroupProps = {
      * @param {object} event Event object
      * @param {Core.widget.Widget} event.source The widget being hidden.
      */
-    onBeforeHide? : ((event: { source: Widget }) => Promise<boolean>|boolean|void)|string
+    onBeforeHide? : ((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)
@@ -713,13 +719,13 @@ export type BryntumCheckboxGroupProps = {
      * @param {object} event Event object
      * @param {any} event.state State object config
      */
-    onBeforeStateApply? : ((event: { state: any }) => Promise<boolean>|boolean|void)|string
+    onBeforeStateApply? : ((event: { state: any }) => 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 {any} event.state State object config
      */
-    onBeforeStateSave? : ((event: { state: any }) => Promise<boolean>|boolean|void)|string
+    onBeforeStateSave? : ((event: { state: any }) => boolean|void)|string
     /**
      * Fires when any other event is fired from the object.
      * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/CheckboxGroup#event-catchAll)

package/src/BryntumChipView.tsx

@@ -44,6 +44,8 @@ export type BryntumChipViewProps = {
     /**
      * 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/core/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/Core/widget/ChipView#config-appendTo)
      */
     appendTo? : HTMLElement|string
     /**
@@ -93,9 +95,11 @@ export type BryntumChipViewProps = {
     /**
      * If [closable](https://bryntum.com/products/core/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
@@ -272,10 +276,14 @@ export type BryntumChipViewProps = {
     ignoreParentReadOnly? : boolean
     /**
      * Element (or element id) to insert this widget before. If provided, [appendTo](https://bryntum.com/products/core/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/Core/widget/ChipView#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/core/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/Core/widget/ChipView#config-insertFirst)
      */
     insertFirst? : HTMLElement|string
     /**
@@ -553,7 +561,7 @@ export type BryntumChipViewProps = {
      * @param {object} event Event object
      * @param {Core.widget.Widget} event.source The widget being hidden.
      */
-    onBeforeHide? : ((event: { source: Widget }) => Promise<boolean>|boolean|void)|string
+    onBeforeHide? : ((event: { source: Widget }) => boolean|void)|string
     /**
      * User going to activate an item in the list either by pointer or keyboard.
      * The active record, list item index, and the triggering event are passed.
@@ -565,7 +573,7 @@ export type BryntumChipViewProps = {
      * @param {number} event.index List item index
      * @param {Event} event.event Triggering event
      */
-    onBeforeItem? : ((event: { source: List, item: HTMLElement, record: Model, index: number, event: Event }) => Promise<boolean>|boolean|void)|string
+    onBeforeItem? : ((event: { source: List, item: HTMLElement, record: Model, index: number, event: Event }) => boolean|void)|string
     /**
      * Triggered before a widget is shown. Return `false` to prevent the action.
      * @param {object} event Event object

package/src/BryntumCodeEditor.tsx

@@ -34,6 +34,8 @@ export type BryntumCodeEditorProps = {
     /**
      * 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/core/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/Core/widget/CodeEditor#config-appendTo)
      */
     appendTo? : HTMLElement|string
     /**
@@ -300,10 +302,14 @@ export type BryntumCodeEditorProps = {
     inputFieldAlign? : 'start'|'end'
     /**
      * Element (or element id) to insert this widget before. If provided, [appendTo](https://bryntum.com/products/core/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/Core/widget/CodeEditor#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/core/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/Core/widget/CodeEditor#config-insertFirst)
      */
     insertFirst? : HTMLElement|string
     /**
@@ -663,7 +669,7 @@ export type BryntumCodeEditorProps = {
      * @param {object} event Event object
      * @param {Core.widget.Widget} event.source The widget being hidden.
      */
-    onBeforeHide? : ((event: { source: Widget }) => Promise<boolean>|boolean|void)|string
+    onBeforeHide? : ((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)
@@ -683,13 +689,13 @@ export type BryntumCodeEditorProps = {
      * @param {object} event Event object
      * @param {any} event.state State object config
      */
-    onBeforeStateApply? : ((event: { state: any }) => Promise<boolean>|boolean|void)|string
+    onBeforeStateApply? : ((event: { state: any }) => 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 {any} event.state State object config
      */
-    onBeforeStateSave? : ((event: { state: any }) => Promise<boolean>|boolean|void)|string
+    onBeforeStateSave? : ((event: { state: any }) => boolean|void)|string
     /**
      * Fires when any other event is fired from the object.
      * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/CodeEditor#event-catchAll)

package/src/BryntumColorField.tsx

@@ -38,6 +38,8 @@ export type BryntumColorFieldProps = {
     /**
      * 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/core/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/Core/widget/ColorField#config-appendTo)
      */
     appendTo? : HTMLElement|string
     /**
@@ -91,6 +93,15 @@ export type BryntumColorFieldProps = {
      * 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/core/docs/api/Core/widget/Field#property-isValid)
+     * evaluation, after the built-in [required](https://bryntum.com/products/core/docs/api/Core/widget/Field#config-required) check.
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/ColorField#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/core/docs/api/Core/widget/Field#config-readOnly). The trigger is available
      * in the [triggers](https://bryntum.com/products/core/docs/api/Core/widget/Field#property-triggers) object under the name `clear`. May also be an object which
@@ -288,10 +299,14 @@ export type BryntumColorFieldProps = {
     inputWidth? : string|number
     /**
      * Element (or element id) to insert this widget before. If provided, [appendTo](https://bryntum.com/products/core/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/Core/widget/ColorField#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/core/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/Core/widget/ColorField#config-insertFirst)
      */
     insertFirst? : HTMLElement|string
     /**
@@ -623,7 +638,7 @@ export type BryntumColorFieldProps = {
      * @param {object} event Event object
      * @param {Core.widget.Widget} event.source The widget being hidden.
      */
-    onBeforeHide? : ((event: { source: Widget }) => Promise<boolean>|boolean|void)|string
+    onBeforeHide? : ((event: { source: Widget }) => boolean|void)|string
     /**
      * Triggered before a widget is shown. Return `false` to prevent the action.
      * @param {object} event Event object
@@ -772,6 +787,7 @@ export class BryntumColorField extends React.Component<BryntumColorFieldProps> {
         'autoSelect',
         'bubbleEvents',
         'centered',
+        'checkValidity',
         'clearable',
         'config',
         'constrainTo',

package/src/BryntumCombo.tsx

@@ -34,6 +34,8 @@ export type BryntumComboProps = {
     /**
      * 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/core/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/Core/widget/Combo#config-appendTo)
      */
     appendTo? : HTMLElement|string
     /**
@@ -96,6 +98,15 @@ export type BryntumComboProps = {
      * 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/core/docs/api/Core/widget/Field#property-isValid)
+     * evaluation, after the built-in [required](https://bryntum.com/products/core/docs/api/Core/widget/Field#config-required) check.
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/Combo#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/core/docs/api/Core/widget/ChipView) to display the
      * selected value set when [multiSelect](https://bryntum.com/products/core/docs/api/Core/widget/Combo#config-multiSelect) is `true`.
@@ -389,10 +400,14 @@ export type BryntumComboProps = {
     inputWidth? : string|number
     /**
      * Element (or element id) to insert this widget before. If provided, [appendTo](https://bryntum.com/products/core/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/Core/widget/Combo#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/core/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/Core/widget/Combo#config-insertFirst)
      */
     insertFirst? : HTMLElement|string
     /**
@@ -799,7 +814,7 @@ export type BryntumComboProps = {
      * @param {object} event Event object
      * @param {Core.widget.Widget} event.source The widget being hidden.
      */
-    onBeforeHide? : ((event: { source: Widget }) => Promise<boolean>|boolean|void)|string
+    onBeforeHide? : ((event: { source: Widget }) => boolean|void)|string
     /**
      * Triggered before a widget is shown. Return `false` to prevent the action.
      * @param {object} event Event object
@@ -960,6 +975,7 @@ export class BryntumCombo extends React.Component<BryntumComboProps> {
         'cacheLastResult',
         'caseSensitive',
         'centered',
+        'checkValidity',
         'chipView',
         'clearable',
         'clearTextOnPickerHide',

package/src/BryntumContainer.tsx

@@ -34,6 +34,8 @@ export type BryntumContainerProps = {
     /**
      * 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/core/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/Core/widget/Container#config-appendTo)
      */
     appendTo? : HTMLElement|string
     /**
@@ -238,10 +240,14 @@ export type BryntumContainerProps = {
     inputFieldAlign? : 'start'|'end'
     /**
      * Element (or element id) to insert this widget before. If provided, [appendTo](https://bryntum.com/products/core/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/Core/widget/Container#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/core/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/Core/widget/Container#config-insertFirst)
      */
     insertFirst? : HTMLElement|string
     /**
@@ -533,7 +539,7 @@ export type BryntumContainerProps = {
      * @param {object} event Event object
      * @param {Core.widget.Widget} event.source The widget being hidden.
      */
-    onBeforeHide? : ((event: { source: Widget }) => Promise<boolean>|boolean|void)|string
+    onBeforeHide? : ((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/BryntumDateField.tsx

@@ -34,6 +34,8 @@ export type BryntumDateFieldProps = {
     /**
      * 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/core/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/Core/widget/DateField#config-appendTo)
      */
     appendTo? : HTMLElement|string
     /**
@@ -87,6 +89,15 @@ export type BryntumDateFieldProps = {
      * 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/core/docs/api/Core/widget/Field#property-isValid)
+     * evaluation, after the built-in [required](https://bryntum.com/products/core/docs/api/Core/widget/Field#config-required) check.
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/DateField#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/core/docs/api/Core/widget/Field#config-readOnly). The trigger is available
      * in the [triggers](https://bryntum.com/products/core/docs/api/Core/widget/Field#property-triggers) object under the name `clear`. May also be an object which
@@ -291,10 +302,14 @@ export type BryntumDateFieldProps = {
     inputWidth? : string|number
     /**
      * Element (or element id) to insert this widget before. If provided, [appendTo](https://bryntum.com/products/core/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/Core/widget/DateField#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/core/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/Core/widget/DateField#config-insertFirst)
      */
     insertFirst? : HTMLElement|string
     /**
@@ -684,7 +699,7 @@ export type BryntumDateFieldProps = {
      * @param {object} event Event object
      * @param {Core.widget.Widget} event.source The widget being hidden.
      */
-    onBeforeHide? : ((event: { source: Widget }) => Promise<boolean>|boolean|void)|string
+    onBeforeHide? : ((event: { source: Widget }) => boolean|void)|string
     /**
      * Triggered before a widget is shown. Return `false` to prevent the action.
      * @param {object} event Event object
@@ -833,6 +848,7 @@ export class BryntumDateField extends React.Component<BryntumDateFieldProps> {
         'autoSelect',
         'bubbleEvents',
         'centered',
+        'checkValidity',
         'clearable',
         'color',
         'config',