@bryntum/core-react-thin 7.3.0 → 7.3.2

package/src/BryntumDatePicker.tsx

@@ -47,6 +47,8 @@ export type BryntumDatePickerProps = {
     /**
      * 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/DatePicker#config-appendTo)
      */
     appendTo? : HTMLElement|string
     /**
@@ -394,10 +396,14 @@ export type BryntumDatePickerProps = {
     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/DatePicker#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/DatePicker#config-insertFirst)
      */
     insertFirst? : HTMLElement|string
     /**
@@ -840,7 +846,7 @@ export type BryntumDatePickerProps = {
      * @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
     /**
      * Fires before this CalendarPanel refreshes in response to changes in its month.
      * @param {object} event Event object
@@ -866,13 +872,13 @@ export type BryntumDatePickerProps = {
      * @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/DatePicker#event-catchAll)

package/src/BryntumDateRangeField.tsx

@@ -34,6 +34,8 @@ export type BryntumDateRangeFieldProps = {
     /**
      * 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/DateRangeField#config-appendTo)
      */
     appendTo? : HTMLElement|string
     /**
@@ -87,6 +89,15 @@ export type BryntumDateRangeFieldProps = {
      * 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/DateRangeField#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
@@ -313,10 +324,14 @@ export type BryntumDateRangeFieldProps = {
     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/DateRangeField#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/DateRangeField#config-insertFirst)
      */
     insertFirst? : HTMLElement|string
     /**
@@ -672,7 +687,7 @@ export type BryntumDateRangeFieldProps = {
      * @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
@@ -821,6 +836,7 @@ export class BryntumDateRangeField extends React.Component<BryntumDateRangeField
         'autoSelect',
         'bubbleEvents',
         'centered',
+        'checkValidity',
         'clearable',
         'color',
         'config',

package/src/BryntumDateTimeField.tsx

@@ -34,6 +34,8 @@ export type BryntumDateTimeFieldProps = {
     /**
      * 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/DateTimeField#config-appendTo)
      */
     appendTo? : HTMLElement|string
     /**
@@ -78,6 +80,15 @@ export type BryntumDateTimeFieldProps = {
      * 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/DateTimeField#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
@@ -267,10 +278,14 @@ export type BryntumDateTimeFieldProps = {
     inputTag? : string
     /**
      * 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/DateTimeField#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/DateTimeField#config-insertFirst)
      */
     insertFirst? : HTMLElement|string
     /**
@@ -581,7 +596,7 @@ export type BryntumDateTimeFieldProps = {
      * @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
@@ -728,6 +743,7 @@ export class BryntumDateTimeField extends React.Component<BryntumDateTimeFieldPr
         'autoSelect',
         'bubbleEvents',
         'centered',
+        'checkValidity',
         'clearable',
         'color',
         'config',

package/src/BryntumDemoCodeEditor.tsx

@@ -34,6 +34,8 @@ export type BryntumDemoCodeEditorProps = {
     /**
      * 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/DemoCodeEditor#config-appendTo)
      */
     appendTo? : HTMLElement|string
     /**
@@ -304,10 +306,14 @@ export type BryntumDemoCodeEditorProps = {
     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/DemoCodeEditor#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/DemoCodeEditor#config-insertFirst)
      */
     insertFirst? : HTMLElement|string
     /**
@@ -676,7 +682,7 @@ export type BryntumDemoCodeEditorProps = {
      * @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)
@@ -696,13 +702,13 @@ export type BryntumDemoCodeEditorProps = {
      * @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/DemoCodeEditor#event-catchAll)

package/src/BryntumDisplayField.tsx

@@ -34,6 +34,8 @@ export type BryntumDisplayFieldProps = {
     /**
      * 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/DisplayField#config-appendTo)
      */
     appendTo? : HTMLElement|string
     /**
@@ -83,6 +85,15 @@ export type BryntumDisplayFieldProps = {
      * 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/DisplayField#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 BryntumDisplayFieldProps = {
     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/DisplayField#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/DisplayField#config-insertFirst)
      */
     insertFirst? : HTMLElement|string
     /**
@@ -612,7 +627,7 @@ export type BryntumDisplayFieldProps = {
      * @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
@@ -760,6 +775,7 @@ export class BryntumDisplayField extends React.Component<BryntumDisplayFieldProp
         'autoSelect',
         'bubbleEvents',
         'centered',
+        'checkValidity',
         'clearable',
         'color',
         'config',

package/src/BryntumDurationField.tsx

@@ -43,6 +43,8 @@ export type BryntumDurationFieldProps = {
     /**
      * 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/DurationField#config-appendTo)
      */
     appendTo? : HTMLElement|string
     /**
@@ -92,6 +94,15 @@ export type BryntumDurationFieldProps = {
      * 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/DurationField#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
@@ -299,10 +310,14 @@ export type BryntumDurationFieldProps = {
     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/DurationField#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/DurationField#config-insertFirst)
      */
     insertFirst? : HTMLElement|string
     /**
@@ -660,7 +675,7 @@ export type BryntumDurationFieldProps = {
      * @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
@@ -808,6 +823,7 @@ export class BryntumDurationField extends React.Component<BryntumDurationFieldPr
         'autoSelect',
         'bubbleEvents',
         'centered',
+        'checkValidity',
         'clearable',
         'color',
         'config',

package/src/BryntumEditor.tsx

@@ -33,6 +33,8 @@ export type BryntumEditorProps = {
     /**
      * 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/Editor#config-appendTo)
      */
     appendTo? : HTMLElement|string
     /**
@@ -276,10 +278,14 @@ export type BryntumEditorProps = {
     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/Editor#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/Editor#config-insertFirst)
      */
     insertFirst? : HTMLElement|string
     /**
@@ -593,7 +599,7 @@ export type BryntumEditorProps = {
      * @param {Event} event.event Included if the cancellation was triggered by a DOM event
      * @param {Core.widget.Editor} event.source The Editor that triggered the event.
      */
-    onBeforeCancel? : ((event: { oldValue: object, value: object, event: Event, source: Editor }) => Promise<boolean>|boolean|void)|string
+    onBeforeCancel? : ((event: { oldValue: object, value: object, event: Event, source: Editor }) => boolean|void)|string
     /**
      * Fired when an edit completion has been requested, either by <kbd>Enter</kbd>, or focus loss (if configured to complete on blur).
      * The completion may be vetoed, in which case, focus is moved back into the editor.
@@ -604,7 +610,7 @@ export type BryntumEditorProps = {
      * @param {Function} [event.finalize] An async function may be injected into this property which performs asynchronous finalization tasks such as complex validation of confirmation. The value `true` or `false` must be returned.
      * @param {object} [event.finalize.context] An object describing the editing context upon requested completion of the edit.
      */
-    onBeforeComplete? : ((event: { oldValue: object, value: object, source: Editor, finalize: { context?: object } }) => Promise<boolean>|boolean|void)|string
+    onBeforeComplete? : ((event: { oldValue: object, value: object, source: Editor, finalize: { context?: object } }) => boolean|void)|string
     /**
      * Fires before an object is destroyed.
      * @param {object} event Event object
@@ -616,7 +622,7 @@ export type BryntumEditorProps = {
      * @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)
@@ -634,7 +640,7 @@ export type BryntumEditorProps = {
     /**
      * Fired before the editor is shown to start an edit operation. Returning `false` from a handler vetoes the edit operation.
      * @param {object} event Event object
-     * @param {HTMLElement} event.target The element which the Editor is to overlay to edit its content.
+     * @param {Element} event.target The element which the Editor is to overlay to edit its content.
      * @param {Core.data.Model} [event.record] The record being edited.
      * @param {string} [event.field] The name of the field if a record is being edited.
      * @param {object} event.value The value to be edited.
@@ -646,7 +652,7 @@ export type BryntumEditorProps = {
      * @param {boolean} event.matchFont Whether to match the target's font. See [matchFont](https://bryntum.com/products/core/docs/api/Core/widget/Editor#config-matchFont)
      * @param {boolean} event.focus Whether to focus the editor's field.
      */
-    onBeforeStart? : ((event: { target: HTMLElement, record?: Model, field?: string, value: object, align: string|AlignSpec, hideTarget: boolean, matchSize: { width: boolean, height: boolean }, matchFont: boolean, focus: boolean }) => Promise<boolean>|boolean|void)|string
+    onBeforeStart? : ((event: { target: Element, record?: Model, field?: string, value: object, align: string|AlignSpec, hideTarget: boolean, matchSize: { width: boolean, height: boolean }, matchFont: boolean, focus: boolean }) => boolean|void)|string
     /**
      * Edit has been canceled without updating the associated record or element.
      * @param {object} event Event object

package/src/BryntumFieldFilterPicker.tsx

@@ -34,6 +34,8 @@ export type BryntumFieldFilterPickerProps = {
     /**
      * 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/FieldFilterPicker#config-appendTo)
      */
     appendTo? : HTMLElement|string
     /**
@@ -262,10 +264,14 @@ export type BryntumFieldFilterPickerProps = {
     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/FieldFilterPicker#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/FieldFilterPicker#config-insertFirst)
      */
     insertFirst? : HTMLElement|string
     /**
@@ -592,7 +598,7 @@ export type BryntumFieldFilterPickerProps = {
      * @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/BryntumFieldFilterPickerGroup.tsx

@@ -44,6 +44,8 @@ export type BryntumFieldFilterPickerGroupProps = {
     /**
      * 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/FieldFilterPickerGroup#config-appendTo)
      */
     appendTo? : HTMLElement|string
     /**
@@ -290,10 +292,14 @@ export type BryntumFieldFilterPickerGroupProps = {
     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/FieldFilterPickerGroup#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/FieldFilterPickerGroup#config-insertFirst)
      */
     insertFirst? : HTMLElement|string
     /**
@@ -608,7 +614,7 @@ export type BryntumFieldFilterPickerGroupProps = {
      * @param {Core.widget.FieldFilterPicker} event.source The FieldFilterPicker instance that fired the event.
      * @param {CollectionFilterConfig} event.filter The [CollectionFilter](https://bryntum.com/products/core/docs/api/Core/util/CollectionFilter) configuration object for the filter represented by this [FieldFilterPicker](https://bryntum.com/products/core/docs/api/Core/widget/FieldFilterPicker).
      */
-    onBeforeAddFilter? : ((event: { source: FieldFilterPicker, filter: CollectionFilterConfig }) => Promise<boolean>|boolean|void)|string
+    onBeforeAddFilter? : ((event: { source: FieldFilterPicker, filter: CollectionFilterConfig }) => boolean|void)|string
     /**
      * Fires before an object is destroyed.
      * @param {object} event Event object
@@ -620,7 +626,7 @@ export type BryntumFieldFilterPickerGroupProps = {
      * @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/BryntumFieldSet.tsx

@@ -34,6 +34,8 @@ export type BryntumFieldSetProps = {
     /**
      * 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/FieldSet#config-appendTo)
      */
     appendTo? : HTMLElement|string
     /**
@@ -297,10 +299,14 @@ export type BryntumFieldSetProps = {
     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/FieldSet#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/FieldSet#config-insertFirst)
      */
     insertFirst? : HTMLElement|string
     /**
@@ -653,7 +659,7 @@ export type BryntumFieldSetProps = {
      * @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)
@@ -673,13 +679,13 @@ export type BryntumFieldSetProps = {
      * @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/FieldSet#event-catchAll)

package/src/BryntumFileField.tsx

@@ -39,6 +39,8 @@ export type BryntumFileFieldProps = {
     /**
      * 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/FileField#config-appendTo)
      */
     appendTo? : HTMLElement|string
     /**
@@ -88,6 +90,15 @@ export type BryntumFileFieldProps = {
      * 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/FileField#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 BryntumFileFieldProps = {
     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/FileField#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/FileField#config-insertFirst)
      */
     insertFirst? : HTMLElement|string
     /**
@@ -615,7 +630,7 @@ export type BryntumFileFieldProps = {
      * @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
@@ -764,6 +779,7 @@ export class BryntumFileField extends React.Component<BryntumFileFieldProps> {
         'autoSelect',
         'bubbleEvents',
         'centered',
+        'checkValidity',
         'clearable',
         'color',
         'config',

package/src/BryntumFilePicker.tsx

@@ -34,6 +34,8 @@ export type BryntumFilePickerProps = {
     /**
      * 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/FilePicker#config-appendTo)
      */
     appendTo? : HTMLElement|string
     /**
@@ -246,10 +248,14 @@ export type BryntumFilePickerProps = {
     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/FilePicker#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/FilePicker#config-insertFirst)
      */
     insertFirst? : HTMLElement|string
     /**
@@ -545,7 +551,7 @@ export type BryntumFilePickerProps = {
      * @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)