@bryntum/grid-vue-3 7.3.0 → 7.3.2

package/lib/components/BryntumSlideToggle.js

@@ -1,4 +1,4 @@
-import { _ as f } from "../chunks/DayQ7Rlb.js";
+import { _ as f } from "../chunks/DSedBrt_.js";
 export {
   f as default
 };

package/lib/components/BryntumTextAreaField.js

@@ -1,4 +1,4 @@
-import { _ as f } from "../chunks/NkF4pTV7.js";
+import { _ as f } from "../chunks/C-KNXud_.js";
 export {
   f as default
 };

package/lib/components/BryntumTextAreaPickerField.js

@@ -1,4 +1,4 @@
-import { _ as f } from "../chunks/D61dAL1b.js";
+import { _ as f } from "../chunks/TMpK4xg3.js";
 export {
   f as default
 };

package/lib/components/BryntumTextField.js

@@ -1,4 +1,4 @@
-import { _ as f } from "../chunks/xIdoI0po.js";
+import { _ as f } from "../chunks/Cs5IYq5I.js";
 export {
   f as default
 };

package/lib/components/BryntumTimeField.js

@@ -1,4 +1,4 @@
-import { _ as f } from "../chunks/bLebs42H.js";
+import { _ as f } from "../chunks/BhfZhJQ4.js";
 export {
   f as default
 };

package/lib/components/BryntumTreeCombo.js

@@ -1,4 +1,4 @@
-import { _ as f } from "../chunks/B711lzqw.js";
+import { _ as f } from "../chunks/n-bko5m2.js";
 export {
   f as default
 };

package/lib/index.js

@@ -1,34 +1,34 @@
 import { _ as e } from "./chunks/CjbIP_NG.js";
 import { _ as a } from "./chunks/CxPDvQ4d.js";
 import { _ as u } from "./chunks/CDuji6RM.js";
-import { _ as s } from "./chunks/DTUe-lyS.js";
+import { _ as s } from "./chunks/BX4HI-q4.js";
 import "@bryntum/grid";
-import { _ as i } from "./chunks/D94FCXrL.js";
+import { _ as i } from "./chunks/C3q04kPS.js";
 import { _ as y } from "./chunks/B9Ym-jRB.js";
 import { _ } from "./chunks/BQUiHybJ.js";
 import { _ as d } from "./chunks/PT41l8zv.js";
-import { _ as P } from "./chunks/DTH08WC2.js";
+import { _ as P } from "./chunks/DhhewFEv.js";
 import { _ as c } from "./chunks/COI8HIJL.js";
-import { _ as T } from "./chunks/BwuvAbW5.js";
+import { _ as T } from "./chunks/DbEgVOs1.js";
 import { _ as G } from "./chunks/BoUkRqVY.js";
 import { _ as g } from "./chunks/DRVjD9iN.js";
-import { _ as S } from "./chunks/BMTMMdaC.js";
-import { _ as E } from "./chunks/BkSzOi0v.js";
+import { _ as S } from "./chunks/CLRX9ie2.js";
+import { _ as E } from "./chunks/oOR_enaE.js";
 import { _ as w } from "./chunks/C2x-tjJx.js";
-import { _ as L } from "./chunks/Ccul2l2v.js";
+import { _ as L } from "./chunks/D7f0nsko.js";
 import { _ as I } from "./chunks/CKihfOVz.js";
-import { _ as V } from "./chunks/DiZmRX6M.js";
-import { _ as Y } from "./chunks/B-xu7l3m.js";
+import { _ as V } from "./chunks/BAaaUhdy.js";
+import { _ as Y } from "./chunks/BFLoNIuF.js";
 import { _ as q } from "./chunks/CnUfgMxC.js";
-import { _ as z } from "./chunks/CBRW321y.js";
-import { _ as K } from "./chunks/Byhp0Mwy.js";
+import { _ as z } from "./chunks/DE5aChZi.js";
+import { _ as K } from "./chunks/CoXntcPO.js";
 import { _ as Q } from "./chunks/DskRZNvv.js";
 import { _ as X } from "./chunks/2JP2ap14.js";
 import { _ as $ } from "./chunks/D_rLSr8Y.js";
 import { _ as or } from "./chunks/0gtq8Dk3.js";
-import { _ as er } from "./chunks/CDlTquLg.js";
+import { _ as er } from "./chunks/0G3BOxn8.js";
 import { _ as ar } from "./chunks/s-g3r5g2.js";
-import { _ as ur } from "./chunks/BF1rPMcu.js";
+import { _ as ur } from "./chunks/BWT4Mdsw.js";
 import { _ as sr } from "./chunks/Bfj8ZUAm.js";
 import { _ as ir } from "./chunks/Dm-Ds5Fs.js";
 import { _ as yr } from "./chunks/n4K19P1t.js";
@@ -40,24 +40,24 @@ import { _ as Tr } from "./chunks/gboR1LQ7.js";
 import { _ as Gr } from "./chunks/1RZB5Yja.js";
 import { _ as gr } from "./chunks/cmj1-s1q.js";
 import { _ as Sr } from "./chunks/jla7jldm.js";
-import { _ as Er } from "./chunks/D6pNVhVB.js";
+import { _ as Er } from "./chunks/BArALprx.js";
 import { _ as wr } from "./chunks/DCg2fWiq.js";
 import { _ as Lr } from "./chunks/BZdz0l_5.js";
-import { _ as Ir } from "./chunks/Cex7HFh5.js";
+import { _ as Ir } from "./chunks/CnvevsBu.js";
 import { _ as Vr } from "./chunks/CeJ19ncI.js";
-import { _ as Yr } from "./chunks/BpR2lUkV.js";
+import { _ as Yr } from "./chunks/B_2BdFBO.js";
 import { _ as qr } from "./chunks/D4Cy-qFk.js";
 import { _ as zr } from "./chunks/pP8iMzIE.js";
-import { _ as Kr } from "./chunks/DayQ7Rlb.js";
+import { _ as Kr } from "./chunks/DSedBrt_.js";
 import { _ as Qr } from "./chunks/BK5CVUgh.js";
 import { _ as Xr } from "./chunks/BC_xvNJq.js";
-import { _ as $r } from "./chunks/NkF4pTV7.js";
-import { _ as oo } from "./chunks/D61dAL1b.js";
-import { _ as eo } from "./chunks/xIdoI0po.js";
-import { _ as ao } from "./chunks/bLebs42H.js";
+import { _ as $r } from "./chunks/C-KNXud_.js";
+import { _ as oo } from "./chunks/TMpK4xg3.js";
+import { _ as eo } from "./chunks/Cs5IYq5I.js";
+import { _ as ao } from "./chunks/BhfZhJQ4.js";
 import { _ as uo } from "./chunks/C9YGIUax.js";
 import { _ as so } from "./chunks/UkUlfQx6.js";
-import { _ as io } from "./chunks/B711lzqw.js";
+import { _ as io } from "./chunks/n-bko5m2.js";
 import { _ as yo } from "./chunks/CQUmcVHy.js";
 import { _ as _o } from "./chunks/B9qIhgk1.js";
 import { _ as Fo } from "./chunks/COs57ih1.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bryntum/grid-vue-3",
-  "version": "7.3.0",
+  "version": "7.3.2",
   "description": "Vue 3 wrappers for Bryntum Grid JavaScript component",
   "keywords": [
     "bryntum",

package/src/components/BryntumAIFilterField.vue

@@ -42,6 +42,8 @@ defineProps<{
     /**
      * Element (or the id of an element) to append this widget's element to. Can be configured, or set once at
      * runtime. To access the element of a rendered widget, see [element](https://bryntum.com/products/grid/docs/api/Core/widget/Widget#property-element).
+     * <div class="note">When creating nested trees of widgets, this should only be used on the outermost widget.
+     * [More...](https://bryntum.com/products/grid/docs/api/Grid/widget/AIFilterField#config-appendTo)
      */
     appendTo ? : HTMLElement|string
     /**
@@ -91,6 +93,15 @@ defineProps<{
      * Set to `true` to centre the Widget in browser viewport space.
      */
     centered ? : Boolean
+    /**
+     * A function (or the name of a function in the ownership hierarchy) called during field validation
+     * to perform custom validity checks. The function is called as part of the [isValid](https://bryntum.com/products/grid/docs/api/Core/widget/Field#property-isValid)
+     * evaluation, after the built-in [required](https://bryntum.com/products/grid/docs/api/Core/widget/Field#config-required) check.
+     * [More...](https://bryntum.com/products/grid/docs/api/Grid/widget/AIFilterField#config-checkValidity)
+     * @param {Core.widget.Field} field The field being validated
+     * @returns {void}
+     */
+    checkValidity ? : ((field: Field) => void)|string
     /**
      * Show a trigger to clear field, if this field is not [readOnly](https://bryntum.com/products/grid/docs/api/Core/widget/Field#config-readOnly). The trigger is available
      * in the [triggers](https://bryntum.com/products/grid/docs/api/Core/widget/Field#property-triggers) object under the name `clear`. May also be an object which
@@ -299,10 +310,14 @@ defineProps<{
     inputWidth ? : string|number
     /**
      * Element (or element id) to insert this widget before. If provided, [appendTo](https://bryntum.com/products/grid/docs/api/Core/widget/Widget#config-appendTo) config is ignored.
+     * <div class="note">When creating nested trees of widgets, this should only be used on the outermost widget.
+     * [More...](https://bryntum.com/products/grid/docs/api/Grid/widget/AIFilterField#config-insertBefore)
      */
     insertBefore ? : HTMLElement|string
     /**
      * Element (or element id) to append this widget element to, as a first child. If provided, [appendTo](https://bryntum.com/products/grid/docs/api/Core/widget/Widget#config-appendTo) config is ignored.
+     * <div class="note">When creating nested trees of widgets, this should only be used on the outermost widget.
+     * [More...](https://bryntum.com/products/grid/docs/api/Grid/widget/AIFilterField#config-insertFirst)
      */
     insertFirst ? : HTMLElement|string
     /**
@@ -642,7 +657,7 @@ const emit = defineEmits<{
      * @param {object} params.event Event object
      * @param {Core.widget.Widget} params.event.source The widget being hidden.
      */
-    (e: 'beforeHide', params: ((event: { source: Widget }) => Promise<boolean>|boolean|void)|string): Promise<boolean>|boolean|void
+    (e: 'beforeHide', params: ((event: { source: Widget }) => boolean|void)|string): boolean|void
     /**
      * Triggered before a widget is shown. Return `false` to prevent the action.
      * @param {string} e Event name
@@ -815,6 +830,7 @@ const widgetData = {
         'autoSelect',
         'bubbleEvents',
         'centered',
+        'checkValidity',
         'clearable',
         'client',
         'color',

package/src/components/BryntumAIFilterFieldProps.ts

@@ -28,6 +28,8 @@ export declare type BryntumAIFilterFieldProps = {
     /**
      * Element (or the id of an element) to append this widget's element to. Can be configured, or set once at
      * runtime. To access the element of a rendered widget, see [element](https://bryntum.com/products/grid/docs/api/Core/widget/Widget#property-element).
+     * <div class="note">When creating nested trees of widgets, this should only be used on the outermost widget.
+     * [More...](https://bryntum.com/products/grid/docs/api/Grid/widget/AIFilterField#config-appendTo)
      */
     appendTo ? : HTMLElement|string
     /**
@@ -77,6 +79,15 @@ export declare type BryntumAIFilterFieldProps = {
      * Set to `true` to centre the Widget in browser viewport space.
      */
     centered ? : Boolean
+    /**
+     * A function (or the name of a function in the ownership hierarchy) called during field validation
+     * to perform custom validity checks. The function is called as part of the [isValid](https://bryntum.com/products/grid/docs/api/Core/widget/Field#property-isValid)
+     * evaluation, after the built-in [required](https://bryntum.com/products/grid/docs/api/Core/widget/Field#config-required) check.
+     * [More...](https://bryntum.com/products/grid/docs/api/Grid/widget/AIFilterField#config-checkValidity)
+     * @param {Core.widget.Field} field The field being validated
+     * @returns {void}
+     */
+    checkValidity ? : ((field: Field) => void)|string
     /**
      * Show a trigger to clear field, if this field is not [readOnly](https://bryntum.com/products/grid/docs/api/Core/widget/Field#config-readOnly). The trigger is available
      * in the [triggers](https://bryntum.com/products/grid/docs/api/Core/widget/Field#property-triggers) object under the name `clear`. May also be an object which
@@ -285,10 +296,14 @@ export declare type BryntumAIFilterFieldProps = {
     inputWidth ? : string|number
     /**
      * Element (or element id) to insert this widget before. If provided, [appendTo](https://bryntum.com/products/grid/docs/api/Core/widget/Widget#config-appendTo) config is ignored.
+     * <div class="note">When creating nested trees of widgets, this should only be used on the outermost widget.
+     * [More...](https://bryntum.com/products/grid/docs/api/Grid/widget/AIFilterField#config-insertBefore)
      */
     insertBefore ? : HTMLElement|string
     /**
      * Element (or element id) to append this widget element to, as a first child. If provided, [appendTo](https://bryntum.com/products/grid/docs/api/Core/widget/Widget#config-appendTo) config is ignored.
+     * <div class="note">When creating nested trees of widgets, this should only be used on the outermost widget.
+     * [More...](https://bryntum.com/products/grid/docs/api/Grid/widget/AIFilterField#config-insertFirst)
      */
     insertFirst ? : HTMLElement|string
     /**

package/src/components/BryntumBooleanCombo.vue

@@ -42,6 +42,8 @@ defineProps<{
     /**
      * Element (or the id of an element) to append this widget's element to. Can be configured, or set once at
      * runtime. To access the element of a rendered widget, see [element](https://bryntum.com/products/grid/docs/api/Core/widget/Widget#property-element).
+     * <div class="note">When creating nested trees of widgets, this should only be used on the outermost widget.
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/BooleanCombo#config-appendTo)
      */
     appendTo ? : HTMLElement|string
     /**
@@ -104,6 +106,15 @@ defineProps<{
      * Set to `true` to centre the Widget in browser viewport space.
      */
     centered ? : Boolean
+    /**
+     * A function (or the name of a function in the ownership hierarchy) called during field validation
+     * to perform custom validity checks. The function is called as part of the [isValid](https://bryntum.com/products/grid/docs/api/Core/widget/Field#property-isValid)
+     * evaluation, after the built-in [required](https://bryntum.com/products/grid/docs/api/Core/widget/Field#config-required) check.
+     * [More...](https://bryntum.com/products/grid/docs/api/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/grid/docs/api/Core/widget/ChipView) to display the
      * selected value set when [multiSelect](https://bryntum.com/products/grid/docs/api/Core/widget/Combo#config-multiSelect) is `true`.
@@ -397,10 +408,14 @@ defineProps<{
     inputWidth ? : string|number
     /**
      * Element (or element id) to insert this widget before. If provided, [appendTo](https://bryntum.com/products/grid/docs/api/Core/widget/Widget#config-appendTo) config is ignored.
+     * <div class="note">When creating nested trees of widgets, this should only be used on the outermost widget.
+     * [More...](https://bryntum.com/products/grid/docs/api/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/grid/docs/api/Core/widget/Widget#config-appendTo) config is ignored.
+     * <div class="note">When creating nested trees of widgets, this should only be used on the outermost widget.
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/BooleanCombo#config-insertFirst)
      */
     insertFirst ? : HTMLElement|string
     /**
@@ -830,7 +845,7 @@ const emit = defineEmits<{
      * @param {object} params.event Event object
      * @param {Core.widget.Widget} params.event.source The widget being hidden.
      */
-    (e: 'beforeHide', params: ((event: { source: Widget }) => Promise<boolean>|boolean|void)|string): Promise<boolean>|boolean|void
+    (e: 'beforeHide', params: ((event: { source: Widget }) => boolean|void)|string): boolean|void
     /**
      * Triggered before a widget is shown. Return `false` to prevent the action.
      * @param {string} e Event name
@@ -1018,6 +1033,7 @@ const widgetData = {
         'cacheLastResult',
         'caseSensitive',
         'centered',
+        'checkValidity',
         'chipView',
         'clearable',
         'clearTextOnPickerHide',

package/src/components/BryntumBooleanComboProps.ts

@@ -28,6 +28,8 @@ export declare 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/grid/docs/api/Core/widget/Widget#property-element).
+     * <div class="note">When creating nested trees of widgets, this should only be used on the outermost widget.
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/BooleanCombo#config-appendTo)
      */
     appendTo ? : HTMLElement|string
     /**
@@ -90,6 +92,15 @@ export declare 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/grid/docs/api/Core/widget/Field#property-isValid)
+     * evaluation, after the built-in [required](https://bryntum.com/products/grid/docs/api/Core/widget/Field#config-required) check.
+     * [More...](https://bryntum.com/products/grid/docs/api/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/grid/docs/api/Core/widget/ChipView) to display the
      * selected value set when [multiSelect](https://bryntum.com/products/grid/docs/api/Core/widget/Combo#config-multiSelect) is `true`.
@@ -383,10 +394,14 @@ export declare type BryntumBooleanComboProps = {
     inputWidth ? : string|number
     /**
      * Element (or element id) to insert this widget before. If provided, [appendTo](https://bryntum.com/products/grid/docs/api/Core/widget/Widget#config-appendTo) config is ignored.
+     * <div class="note">When creating nested trees of widgets, this should only be used on the outermost widget.
+     * [More...](https://bryntum.com/products/grid/docs/api/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/grid/docs/api/Core/widget/Widget#config-appendTo) config is ignored.
+     * <div class="note">When creating nested trees of widgets, this should only be used on the outermost widget.
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/BooleanCombo#config-insertFirst)
      */
     insertFirst ? : HTMLElement|string
     /**

package/src/components/BryntumButton.vue

@@ -42,6 +42,8 @@ defineProps<{
     /**
      * Element (or the id of an element) to append this widget's element to. Can be configured, or set once at
      * runtime. To access the element of a rendered widget, see [element](https://bryntum.com/products/grid/docs/api/Core/widget/Widget#property-element).
+     * <div class="note">When creating nested trees of widgets, this should only be used on the outermost widget.
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/Button#config-appendTo)
      */
     appendTo ? : HTMLElement|string
     /**
@@ -235,10 +237,14 @@ defineProps<{
     ignoreParentReadOnly ? : Boolean
     /**
      * Element (or element id) to insert this widget before. If provided, [appendTo](https://bryntum.com/products/grid/docs/api/Core/widget/Widget#config-appendTo) config is ignored.
+     * <div class="note">When creating nested trees of widgets, this should only be used on the outermost widget.
+     * [More...](https://bryntum.com/products/grid/docs/api/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/grid/docs/api/Core/widget/Widget#config-appendTo) config is ignored.
+     * <div class="note">When creating nested trees of widgets, this should only be used on the outermost widget.
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/Button#config-insertFirst)
      */
     insertFirst ? : HTMLElement|string
     /**
@@ -544,7 +550,7 @@ const emit = defineEmits<{
      * @param {object} params.event Event object
      * @param {Core.widget.Widget} params.event.source The widget being hidden.
      */
-    (e: 'beforeHide', params: ((event: { source: Widget }) => Promise<boolean>|boolean|void)|string): Promise<boolean>|boolean|void
+    (e: 'beforeHide', params: ((event: { source: Widget }) => boolean|void)|string): boolean|void
     /**
      * Triggered before a widget is shown. Return `false` to prevent the action.
      * @param {string} e Event name
@@ -563,7 +569,7 @@ const emit = defineEmits<{
      * @param {boolean} params.event.userAction `true` if the toggle was triggered by a user action (click), `false` if it was triggered programmatically.
      * @param {Event} params.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.
      */
-    (e: 'beforeShowMenu', params: ((event: { source: Button, menu: Menu, userAction: boolean, domEvent: Event }) => Promise<boolean>|boolean|void)|string): Promise<boolean>|boolean|void
+    (e: 'beforeShowMenu', params: ((event: { source: Button, menu: Menu, userAction: boolean, domEvent: Event }) => boolean|void)|string): boolean|void
     /**
      * Fires before the button is toggled (the [pressed](https://bryntum.com/products/grid/docs/api/Core/widget/Button#property-pressed) state is changed). If the button is part of
      * a [toggleGroup](https://bryntum.com/products/grid/docs/api/Core/widget/Button#config-toggleGroup) and you need to process the pressed button only, consider using
@@ -577,7 +583,7 @@ const emit = defineEmits<{
      * @param {boolean} params.event.userAction `true` if the toggle was triggered by a user action (click), `false` if it was triggered programmatically.
      * @param {Event} params.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.
      */
-    (e: 'beforeToggle', params: ((event: { source: Button, pressed: boolean, userAction: boolean, domEvent: Event }) => Promise<boolean>|boolean|void)|string): Promise<boolean>|boolean|void
+    (e: 'beforeToggle', params: ((event: { source: Button, pressed: boolean, userAction: boolean, domEvent: Event }) => boolean|void)|string): boolean|void
     /**
      * 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/components/BryntumButtonGroup.vue

@@ -42,6 +42,8 @@ defineProps<{
     /**
      * Element (or the id of an element) to append this widget's element to. Can be configured, or set once at
      * runtime. To access the element of a rendered widget, see [element](https://bryntum.com/products/grid/docs/api/Core/widget/Widget#property-element).
+     * <div class="note">When creating nested trees of widgets, this should only be used on the outermost widget.
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/ButtonGroup#config-appendTo)
      */
     appendTo ? : HTMLElement|string
     /**
@@ -243,10 +245,14 @@ defineProps<{
     inputFieldAlign ? : 'start'|'end'
     /**
      * Element (or element id) to insert this widget before. If provided, [appendTo](https://bryntum.com/products/grid/docs/api/Core/widget/Widget#config-appendTo) config is ignored.
+     * <div class="note">When creating nested trees of widgets, this should only be used on the outermost widget.
+     * [More...](https://bryntum.com/products/grid/docs/api/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/grid/docs/api/Core/widget/Widget#config-appendTo) config is ignored.
+     * <div class="note">When creating nested trees of widgets, this should only be used on the outermost widget.
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/ButtonGroup#config-insertFirst)
      */
     insertFirst ? : HTMLElement|string
     /**
@@ -569,7 +575,7 @@ const emit = defineEmits<{
      * @param {object} params.event Event object
      * @param {Core.widget.Widget} params.event.source The widget being hidden.
      */
-    (e: 'beforeHide', params: ((event: { source: Widget }) => Promise<boolean>|boolean|void)|string): Promise<boolean>|boolean|void
+    (e: 'beforeHide', params: ((event: { source: Widget }) => boolean|void)|string): boolean|void
     /**
      * 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/components/BryntumButtonGroupProps.ts

@@ -28,6 +28,8 @@ export declare 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/grid/docs/api/Core/widget/Widget#property-element).
+     * <div class="note">When creating nested trees of widgets, this should only be used on the outermost widget.
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/ButtonGroup#config-appendTo)
      */
     appendTo ? : HTMLElement|string
     /**
@@ -229,10 +231,14 @@ export declare type BryntumButtonGroupProps = {
     inputFieldAlign ? : 'start'|'end'
     /**
      * Element (or element id) to insert this widget before. If provided, [appendTo](https://bryntum.com/products/grid/docs/api/Core/widget/Widget#config-appendTo) config is ignored.
+     * <div class="note">When creating nested trees of widgets, this should only be used on the outermost widget.
+     * [More...](https://bryntum.com/products/grid/docs/api/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/grid/docs/api/Core/widget/Widget#config-appendTo) config is ignored.
+     * <div class="note">When creating nested trees of widgets, this should only be used on the outermost widget.
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/ButtonGroup#config-insertFirst)
      */
     insertFirst ? : HTMLElement|string
     /**

package/src/components/BryntumButtonProps.ts

@@ -28,6 +28,8 @@ export declare 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/grid/docs/api/Core/widget/Widget#property-element).
+     * <div class="note">When creating nested trees of widgets, this should only be used on the outermost widget.
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/Button#config-appendTo)
      */
     appendTo ? : HTMLElement|string
     /**
@@ -221,10 +223,14 @@ export declare type BryntumButtonProps = {
     ignoreParentReadOnly ? : Boolean
     /**
      * Element (or element id) to insert this widget before. If provided, [appendTo](https://bryntum.com/products/grid/docs/api/Core/widget/Widget#config-appendTo) config is ignored.
+     * <div class="note">When creating nested trees of widgets, this should only be used on the outermost widget.
+     * [More...](https://bryntum.com/products/grid/docs/api/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/grid/docs/api/Core/widget/Widget#config-appendTo) config is ignored.
+     * <div class="note">When creating nested trees of widgets, this should only be used on the outermost widget.
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/Button#config-insertFirst)
      */
     insertFirst ? : HTMLElement|string
     /**

package/src/components/BryntumChatPanel.vue

@@ -46,6 +46,8 @@ defineProps<{
     /**
      * Element (or the id of an element) to append this widget's element to. Can be configured, or set once at
      * runtime. To access the element of a rendered widget, see [element](https://bryntum.com/products/grid/docs/api/Core/widget/Widget#property-element).
+     * <div class="note">When creating nested trees of widgets, this should only be used on the outermost widget.
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/chat/ChatPanel#config-appendTo)
      */
     appendTo ? : HTMLElement|string
     /**
@@ -318,10 +320,14 @@ defineProps<{
     inputFieldAlign ? : 'start'|'end'
     /**
      * Element (or element id) to insert this widget before. If provided, [appendTo](https://bryntum.com/products/grid/docs/api/Core/widget/Widget#config-appendTo) config is ignored.
+     * <div class="note">When creating nested trees of widgets, this should only be used on the outermost widget.
+     * [More...](https://bryntum.com/products/grid/docs/api/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/grid/docs/api/Core/widget/Widget#config-appendTo) config is ignored.
+     * <div class="note">When creating nested trees of widgets, this should only be used on the outermost widget.
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/chat/ChatPanel#config-insertFirst)
      */
     insertFirst ? : HTMLElement|string
     /**
@@ -696,7 +702,7 @@ const emit = defineEmits<{
      * @param {object} params.event Event object
      * @param {Core.widget.Widget} params.event.source The widget being hidden.
      */
-    (e: 'beforeHide', params: ((event: { source: Widget }) => Promise<boolean>|boolean|void)|string): Promise<boolean>|boolean|void
+    (e: 'beforeHide', params: ((event: { source: Widget }) => boolean|void)|string): boolean|void
     /**
      * 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)
@@ -722,7 +728,7 @@ const emit = defineEmits<{
      * @param {object} params.event Event object
      * @param {any} params.event.state State object config
      */
-    (e: 'beforeStateApply', params: ((event: { state: any }) => Promise<boolean>|boolean|void)|string): Promise<boolean>|boolean|void
+    (e: 'beforeStateApply', params: ((event: { state: any }) => boolean|void)|string): boolean|void
     /**
      * Fired before state is saved by the StateProvider. Allows editing the state object or preventing the operation.
      * @param {string} e Event name
@@ -730,7 +736,7 @@ const emit = defineEmits<{
      * @param {object} params.event Event object
      * @param {any} params.event.state State object config
      */
-    (e: 'beforeStateSave', params: ((event: { state: any }) => Promise<boolean>|boolean|void)|string): Promise<boolean>|boolean|void
+    (e: 'beforeStateSave', params: ((event: { state: any }) => boolean|void)|string): boolean|void
     /**
      * Fired when the chat bubble tool icon is clicked.
      * @param {string} e Event name

package/src/components/BryntumChatPanelProps.ts

@@ -32,6 +32,8 @@ export declare 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/grid/docs/api/Core/widget/Widget#property-element).
+     * <div class="note">When creating nested trees of widgets, this should only be used on the outermost widget.
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/chat/ChatPanel#config-appendTo)
      */
     appendTo ? : HTMLElement|string
     /**
@@ -304,10 +306,14 @@ export declare type BryntumChatPanelProps = {
     inputFieldAlign ? : 'start'|'end'
     /**
      * Element (or element id) to insert this widget before. If provided, [appendTo](https://bryntum.com/products/grid/docs/api/Core/widget/Widget#config-appendTo) config is ignored.
+     * <div class="note">When creating nested trees of widgets, this should only be used on the outermost widget.
+     * [More...](https://bryntum.com/products/grid/docs/api/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/grid/docs/api/Core/widget/Widget#config-appendTo) config is ignored.
+     * <div class="note">When creating nested trees of widgets, this should only be used on the outermost widget.
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/chat/ChatPanel#config-insertFirst)
      */
     insertFirst ? : HTMLElement|string
     /**

package/src/components/BryntumCheckbox.vue

@@ -42,6 +42,8 @@ defineProps<{
     /**
      * Element (or the id of an element) to append this widget's element to. Can be configured, or set once at
      * runtime. To access the element of a rendered widget, see [element](https://bryntum.com/products/grid/docs/api/Core/widget/Widget#property-element).
+     * <div class="note">When creating nested trees of widgets, this should only be used on the outermost widget.
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/Checkbox#config-appendTo)
      */
     appendTo ? : HTMLElement|string
     /**
@@ -108,6 +110,15 @@ defineProps<{
      * 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/grid/docs/api/Core/widget/Field#property-isValid)
+     * evaluation, after the built-in [required](https://bryntum.com/products/grid/docs/api/Core/widget/Field#config-required) check.
+     * [More...](https://bryntum.com/products/grid/docs/api/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
@@ -296,10 +307,14 @@ defineProps<{
     inputWidth ? : string|number
     /**
      * Element (or element id) to insert this widget before. If provided, [appendTo](https://bryntum.com/products/grid/docs/api/Core/widget/Widget#config-appendTo) config is ignored.
+     * <div class="note">When creating nested trees of widgets, this should only be used on the outermost widget.
+     * [More...](https://bryntum.com/products/grid/docs/api/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/grid/docs/api/Core/widget/Widget#config-appendTo) config is ignored.
+     * <div class="note">When creating nested trees of widgets, this should only be used on the outermost widget.
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/Checkbox#config-insertFirst)
      */
     insertFirst ? : HTMLElement|string
     /**
@@ -624,7 +639,7 @@ const emit = defineEmits<{
      * @param {boolean} params.event.valid True if this field is in a valid state.
      * @param {Event} params.event.event The triggering DOM event if any
      */
-    (e: 'beforeChange', params: ((event: { source: Checkbox, checked: boolean, value: boolean, oldValue: boolean, userAction: boolean, valid: boolean, event: Event }) => Promise<boolean>|boolean|void)|string): Promise<boolean>|boolean|void
+    (e: 'beforeChange', params: ((event: { source: Checkbox, checked: boolean, value: boolean, oldValue: boolean, userAction: boolean, valid: boolean, event: Event }) => boolean|void)|string): boolean|void
     /**
      * Fires before an object is destroyed.
      * @param {string} e Event name
@@ -640,7 +655,7 @@ const emit = defineEmits<{
      * @param {object} params.event Event object
      * @param {Core.widget.Widget} params.event.source The widget being hidden.
      */
-    (e: 'beforeHide', params: ((event: { source: Widget }) => Promise<boolean>|boolean|void)|string): Promise<boolean>|boolean|void
+    (e: 'beforeHide', params: ((event: { source: Widget }) => boolean|void)|string): boolean|void
     /**
      * Triggered before a widget is shown. Return `false` to prevent the action.
      * @param {string} e Event name
@@ -824,6 +839,7 @@ const widgetData = {
         'bubbleEvents',
         'centered',
         'checkedValue',
+        'checkValidity',
         'color',
         'config',
         'constrainTo',