@bryntum/core-react-thin 7.3.0 → 7.3.2

package/src/BryntumSlideToggle.tsx

@@ -34,6 +34,8 @@ export type BryntumSlideToggleProps = {
     /**
      * 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/SlideToggle#config-appendTo)
      */
     appendTo? : HTMLElement|string
     /**
@@ -100,6 +102,15 @@ export type BryntumSlideToggleProps = {
      * 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/SlideToggle#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 BryntumSlideToggleProps = {
     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/SlideToggle#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/SlideToggle#config-insertFirst)
      */
     insertFirst? : HTMLElement|string
     /**
@@ -610,7 +625,7 @@ export type BryntumSlideToggleProps = {
      * @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 BryntumSlideToggleProps = {
      * @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 BryntumSlideToggle extends React.Component<BryntumSlideToggleProps>
         'bubbleEvents',
         'centered',
         'checkedValue',
+        'checkValidity',
         'color',
         'config',
         'constrainTo',

package/src/BryntumSlider.tsx

@@ -34,6 +34,8 @@ export type BryntumSliderProps = {
     /**
      * 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/Slider#config-appendTo)
      */
     appendTo? : HTMLElement|string
     /**
@@ -205,10 +207,14 @@ export type BryntumSliderProps = {
     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/Slider#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/Slider#config-insertFirst)
      */
     insertFirst? : HTMLElement|string
     /**
@@ -498,7 +504,7 @@ export type BryntumSliderProps = {
      * @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

package/src/BryntumSplitter.tsx

@@ -34,6 +34,8 @@ export type BryntumSplitterProps = {
     /**
      * 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/Splitter#config-appendTo)
      */
     appendTo? : HTMLElement|string
     /**
@@ -205,10 +207,14 @@ export type BryntumSplitterProps = {
     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/Splitter#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/Splitter#config-insertFirst)
      */
     insertFirst? : HTMLElement|string
     /**
@@ -440,7 +446,7 @@ export type BryntumSplitterProps = {
      * @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

package/src/BryntumTabPanel.tsx

@@ -42,6 +42,8 @@ export type BryntumTabPanelProps = {
     /**
      * 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/TabPanel#config-appendTo)
      */
     appendTo? : HTMLElement|string
     /**
@@ -303,10 +305,14 @@ export type BryntumTabPanelProps = {
     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/TabPanel#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/TabPanel#config-insertFirst)
      */
     insertFirst? : HTMLElement|string
     /**
@@ -664,7 +670,7 @@ export type BryntumTabPanelProps = {
      * @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)
@@ -684,13 +690,13 @@ export type BryntumTabPanelProps = {
      * @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
     /**
      * The active tab is about to be changed. Return `false` to prevent this.
      * @param {object} event Event object
@@ -699,7 +705,7 @@ export type BryntumTabPanelProps = {
      * @param {number} event.prevActiveIndex The previous active index.
      * @param {Core.widget.Widget} event.prevActiveItem The previous active child widget.
      */
-    onBeforeTabChange? : ((event: { activeIndex: number, activeItem: Widget, prevActiveIndex: number, prevActiveItem: Widget }) => Promise<boolean>|boolean|void)|string
+    onBeforeTabChange? : ((event: { activeIndex: number, activeItem: Widget, prevActiveIndex: number, prevActiveItem: Widget }) => boolean|void)|string
     /**
      * Fires when any other event is fired from the object.
      * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/TabPanel#event-catchAll)

package/src/BryntumTextAreaField.tsx

@@ -34,6 +34,8 @@ export type BryntumTextAreaFieldProps = {
     /**
      * 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/TextAreaField#config-appendTo)
      */
     appendTo? : HTMLElement|string
     /**
@@ -89,6 +91,15 @@ export type BryntumTextAreaFieldProps = {
      * 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/TextAreaField#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
@@ -292,10 +303,14 @@ export type BryntumTextAreaFieldProps = {
     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/TextAreaField#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/TextAreaField#config-insertFirst)
      */
     insertFirst? : HTMLElement|string
     /**
@@ -619,7 +634,7 @@ export type BryntumTextAreaFieldProps = {
      * @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
@@ -768,6 +783,7 @@ export class BryntumTextAreaField extends React.Component<BryntumTextAreaFieldPr
         'autoSelect',
         'bubbleEvents',
         'centered',
+        'checkValidity',
         'clearable',
         'color',
         'config',

package/src/BryntumTextAreaPickerField.tsx

@@ -34,6 +34,8 @@ export type BryntumTextAreaPickerFieldProps = {
     /**
      * 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/TextAreaPickerField#config-appendTo)
      */
     appendTo? : HTMLElement|string
     /**
@@ -87,6 +89,15 @@ export type BryntumTextAreaPickerFieldProps = {
      * 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/TextAreaPickerField#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
@@ -283,10 +294,14 @@ export type BryntumTextAreaPickerFieldProps = {
     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/TextAreaPickerField#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/TextAreaPickerField#config-insertFirst)
      */
     insertFirst? : HTMLElement|string
     /**
@@ -628,7 +643,7 @@ export type BryntumTextAreaPickerFieldProps = {
      * @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
@@ -777,6 +792,7 @@ export class BryntumTextAreaPickerField extends React.Component<BryntumTextAreaP
         'autoSelect',
         'bubbleEvents',
         'centered',
+        'checkValidity',
         'clearable',
         'color',
         'config',

package/src/BryntumTextField.tsx

@@ -34,6 +34,8 @@ export type BryntumTextFieldProps = {
     /**
      * 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/TextField#config-appendTo)
      */
     appendTo? : HTMLElement|string
     /**
@@ -83,6 +85,15 @@ export type BryntumTextFieldProps = {
      * 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/TextField#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
@@ -286,10 +297,14 @@ export type BryntumTextFieldProps = {
     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/TextField#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/TextField#config-insertFirst)
      */
     insertFirst? : HTMLElement|string
     /**
@@ -617,7 +632,7 @@ export type BryntumTextFieldProps = {
      * @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
@@ -765,6 +780,7 @@ export class BryntumTextField extends React.Component<BryntumTextFieldProps> {
         'autoSelect',
         'bubbleEvents',
         'centered',
+        'checkValidity',
         'clearable',
         'color',
         'config',

package/src/BryntumTimeField.tsx

@@ -34,6 +34,8 @@ export type BryntumTimeFieldProps = {
     /**
      * 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/TimeField#config-appendTo)
      */
     appendTo? : HTMLElement|string
     /**
@@ -87,6 +89,15 @@ export type BryntumTimeFieldProps = {
      * 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/TimeField#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
@@ -292,10 +303,14 @@ export type BryntumTimeFieldProps = {
     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/TimeField#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/TimeField#config-insertFirst)
      */
     insertFirst? : HTMLElement|string
     /**
@@ -669,7 +684,7 @@ export type BryntumTimeFieldProps = {
      * @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
@@ -818,6 +833,7 @@ export class BryntumTimeField extends React.Component<BryntumTimeFieldProps> {
         'autoSelect',
         'bubbleEvents',
         'centered',
+        'checkValidity',
         'clearable',
         'color',
         'config',

package/src/BryntumTimePicker.tsx

@@ -34,6 +34,8 @@ export type BryntumTimePickerProps = {
     /**
      * 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/TimePicker#config-appendTo)
      */
     appendTo? : HTMLElement|string
     /**
@@ -243,10 +245,14 @@ export type BryntumTimePickerProps = {
     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/TimePicker#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/TimePicker#config-insertFirst)
      */
     insertFirst? : HTMLElement|string
     /**
@@ -553,7 +559,7 @@ export type BryntumTimePickerProps = {
      * @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/BryntumToolbar.tsx

@@ -34,6 +34,8 @@ export type BryntumToolbarProps = {
     /**
      * 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/Toolbar#config-appendTo)
      */
     appendTo? : HTMLElement|string
     /**
@@ -242,10 +244,14 @@ export type BryntumToolbarProps = {
     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/Toolbar#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/Toolbar#config-insertFirst)
      */
     insertFirst? : HTMLElement|string
     /**
@@ -555,7 +561,7 @@ export type BryntumToolbarProps = {
      * @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
     /**
      * This event is fired on the owning Toolbar prior to starting a drag gesture. The drag is canceled if
      * a listener returns `false`.
@@ -564,7 +570,7 @@ export type BryntumToolbarProps = {
      * @param {Core.widget.Widget} event.item The dragged item.
      * @param {Event} event.domEvent The browser event.
      */
-    onBeforeItemDragStart? : ((event: { source: Toolbar, item: Widget, domEvent: Event }) => Promise<boolean>|boolean|void)|string
+    onBeforeItemDragStart? : ((event: { source: Toolbar, item: Widget, domEvent: Event }) => 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/BryntumWidget.tsx

@@ -34,6 +34,8 @@ export type BryntumWidgetProps = {
     /**
      * 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/Widget#config-appendTo)
      */
     appendTo? : HTMLElement|string
     /**
@@ -205,10 +207,14 @@ export type BryntumWidgetProps = {
     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/Widget#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/Widget#config-insertFirst)
      */
     insertFirst? : HTMLElement|string
     /**
@@ -429,7 +435,7 @@ export type BryntumWidgetProps = {
      * @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

package/src/BryntumYearPicker.tsx

@@ -34,6 +34,8 @@ export type BryntumYearPickerProps = {
     /**
      * 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/YearPicker#config-appendTo)
      */
     appendTo? : HTMLElement|string
     /**
@@ -291,10 +293,14 @@ export type BryntumYearPickerProps = {
     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/YearPicker#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/YearPicker#config-insertFirst)
      */
     insertFirst? : HTMLElement|string
     /**
@@ -659,7 +665,7 @@ export type BryntumYearPickerProps = {
      * @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)
@@ -679,13 +685,13 @@ export type BryntumYearPickerProps = {
      * @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/YearPicker#event-catchAll)