@bryntum/grid-vue-3 7.3.1 → 7.3.3

package/lib/index.js

@@ -1,66 +1,66 @@
 import { _ as e } from "./chunks/CjbIP_NG.js";
-import { _ as a } from "./chunks/CxPDvQ4d.js";
+import { _ as a } from "./chunks/EDrONM4R.js";
 import { _ as u } from "./chunks/CDuji6RM.js";
-import { _ as s } from "./chunks/BX4HI-q4.js";
+import { _ as s } from "./chunks/DbrwZpmC.js";
 import "@bryntum/grid";
-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/DhhewFEv.js";
-import { _ as c } from "./chunks/COI8HIJL.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/CLRX9ie2.js";
-import { _ as E } from "./chunks/oOR_enaE.js";
-import { _ as w } from "./chunks/C2x-tjJx.js";
-import { _ as L } from "./chunks/D7f0nsko.js";
-import { _ as I } from "./chunks/CKihfOVz.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/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/0G3BOxn8.js";
-import { _ as ar } from "./chunks/s-g3r5g2.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";
-import { _ as _r } from "./chunks/Dm8ipdVr.js";
-import { _ as dr } from "./chunks/BWIgghsj.js";
-import { _ as Pr } from "./chunks/CC_mnQeM.js";
-import { _ as cr } from "./chunks/D2GsXOvn.js";
-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/BArALprx.js";
-import { _ as wr } from "./chunks/DCg2fWiq.js";
-import { _ as Lr } from "./chunks/BZdz0l_5.js";
-import { _ as Ir } from "./chunks/CnvevsBu.js";
-import { _ as Vr } from "./chunks/CeJ19ncI.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/DSedBrt_.js";
-import { _ as Qr } from "./chunks/BK5CVUgh.js";
-import { _ as Xr } from "./chunks/BC_xvNJq.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/n-bko5m2.js";
-import { _ as yo } from "./chunks/CQUmcVHy.js";
-import { _ as _o } from "./chunks/B9qIhgk1.js";
-import { _ as Fo } from "./chunks/COs57ih1.js";
+import { _ as i } from "./chunks/5lrk73y1.js";
+import { _ as y } from "./chunks/BnIr624L.js";
+import { _ } from "./chunks/BE2L6l65.js";
+import { _ as d } from "./chunks/DHnVgGqv.js";
+import { _ as P } from "./chunks/Y9GwSYZp.js";
+import { _ as c } from "./chunks/WdqYgsIV.js";
+import { _ as T } from "./chunks/CmnkBkJt.js";
+import { _ as G } from "./chunks/CnANXww_.js";
+import { _ as g } from "./chunks/BSnQw-7W.js";
+import { _ as S } from "./chunks/CuOyCCRP.js";
+import { _ as E } from "./chunks/D4FfOpv3.js";
+import { _ as w } from "./chunks/CKCahWsb.js";
+import { _ as L } from "./chunks/a5QWc4xg.js";
+import { _ as I } from "./chunks/nnsZUupq.js";
+import { _ as V } from "./chunks/Ds99tE2L.js";
+import { _ as Y } from "./chunks/BmHFb_fq.js";
+import { _ as q } from "./chunks/se0G2gur.js";
+import { _ as z } from "./chunks/DzxpyRrw.js";
+import { _ as K } from "./chunks/CZQNr8fW.js";
+import { _ as Q } from "./chunks/C9rWVdCR.js";
+import { _ as X } from "./chunks/Bmsih8lx.js";
+import { _ as $ } from "./chunks/BDKwMPQ8.js";
+import { _ as or } from "./chunks/B900JgqI.js";
+import { _ as er } from "./chunks/5M8wIxvQ.js";
+import { _ as ar } from "./chunks/Do4BHTHV.js";
+import { _ as ur } from "./chunks/o0XBZuno.js";
+import { _ as sr } from "./chunks/D6_Uw7dX.js";
+import { _ as ir } from "./chunks/BlBnb0Cz.js";
+import { _ as yr } from "./chunks/BK3PfJJm.js";
+import { _ as _r } from "./chunks/4qG0wGEN.js";
+import { _ as dr } from "./chunks/C-6n8xmH.js";
+import { _ as Pr } from "./chunks/BBTqZ2iq.js";
+import { _ as cr } from "./chunks/jkUc5Qss.js";
+import { _ as Tr } from "./chunks/CgBmT2zb.js";
+import { _ as Gr } from "./chunks/CTSWNZOV.js";
+import { _ as gr } from "./chunks/DKQixwf0.js";
+import { _ as Sr } from "./chunks/Bh44kABq.js";
+import { _ as Er } from "./chunks/BLsjiEAP.js";
+import { _ as wr } from "./chunks/C7WrhhTn.js";
+import { _ as Lr } from "./chunks/DECEQtDG.js";
+import { _ as Ir } from "./chunks/Bl36V69E.js";
+import { _ as Vr } from "./chunks/DX54e0Vl.js";
+import { _ as Yr } from "./chunks/DsNGo6BB.js";
+import { _ as qr } from "./chunks/DVEc5LrM.js";
+import { _ as zr } from "./chunks/Ds2F_OMv.js";
+import { _ as Kr } from "./chunks/CRLsQJxH.js";
+import { _ as Qr } from "./chunks/Cy6_ZSga.js";
+import { _ as Xr } from "./chunks/Dg6Yfx5Z.js";
+import { _ as $r } from "./chunks/CfueqVEZ.js";
+import { _ as oo } from "./chunks/CoAzsoAd.js";
+import { _ as eo } from "./chunks/CyHeEHVg.js";
+import { _ as ao } from "./chunks/9byyIDfp.js";
+import { _ as uo } from "./chunks/K-h7bldz.js";
+import { _ as so } from "./chunks/B4h7KI-R.js";
+import { _ as io } from "./chunks/B8sjMlQa.js";
+import { _ as yo } from "./chunks/DWrEycHn.js";
+import { _ as _o } from "./chunks/BH6uUlzZ.js";
+import { _ as Fo } from "./chunks/DikDoYUc.js";
 export {
   s as BryntumAIFilterField,
   i as BryntumBooleanCombo,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bryntum/grid-vue-3",
-  "version": "7.3.1",
+  "version": "7.3.3",
   "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
     /**
@@ -88,9 +90,10 @@ defineProps<{
     catchEventHandlerExceptions ? : Boolean
     /**
      * *Only valid if this Widget is [floating](https://bryntum.com/products/grid/docs/api/Core/widget/Widget#config-floating).*
-     * Set to `true` to centre the Widget in browser viewport space.
+     * [More...](https://bryntum.com/products/grid/docs/api/Grid/widget/AIFilterField#config-centered)
+     * @property {boolean} [once] If `true`, the Widget will be centred on its first show, but if it is moved at runtime, it will opt out of centering for future shows.
      */
-    centered ? : Boolean
+    centered ? : Boolean|object
     /**
      * 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)
@@ -192,7 +195,7 @@ defineProps<{
     dock ? : 'top'|'bottom'|'left'|'right'|'start'|'end'|'header'|'pre-header'|object
     /**
      * *Only valid if this Widget is [floating](https://bryntum.com/products/grid/docs/api/Core/widget/Widget#config-floating).*
-     * Set to `true` to be able to drag a widget freely on the page. Or set to an object with a ´handleSelector´
+     * Set to `true` to be able to drag a widget freely on the page. Or set to an object with a `handleSelector`
      * property which controls when a drag should start.
      * [More...](https://bryntum.com/products/grid/docs/api/Grid/widget/AIFilterField#config-draggable)
      * @property {string} handleSelector CSS selector used to determine if drag can be started from a mouse-downed element inside the widget
@@ -308,10 +311,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
     /**
@@ -513,7 +520,7 @@ defineProps<{
     rtl ? : Boolean
     /**
      * Defines what to do if document is scrolled while Widget is visible (only relevant when floating is set to `true`).
-     * Valid values: ´null´: do nothing, ´hide´: hide the widget or ´realign´: realign to the target if possible.
+     * Valid values: `null`: do nothing, `hide`: hide the widget or `realign`: realign to the target if possible.
      */
     scrollAction ? : 'hide'|'realign'|null
     /**
@@ -823,7 +830,6 @@ const widgetData = {
         'autoComplete',
         'autoSelect',
         'bubbleEvents',
-        'centered',
         'checkValidity',
         'clearable',
         'client',
@@ -894,6 +900,7 @@ const widgetData = {
         'badge',
         'callOnFunctions',
         'catchEventHandlerExceptions',
+        'centered',
         'cls',
         'column',
         'dataset',

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
     /**
@@ -74,9 +76,10 @@ export declare type BryntumAIFilterFieldProps = {
     catchEventHandlerExceptions ? : Boolean
     /**
      * *Only valid if this Widget is [floating](https://bryntum.com/products/grid/docs/api/Core/widget/Widget#config-floating).*
-     * Set to `true` to centre the Widget in browser viewport space.
+     * [More...](https://bryntum.com/products/grid/docs/api/Grid/widget/AIFilterField#config-centered)
+     * @property {boolean} [once] If `true`, the Widget will be centred on its first show, but if it is moved at runtime, it will opt out of centering for future shows.
      */
-    centered ? : Boolean
+    centered ? : Boolean|object
     /**
      * 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)
@@ -178,7 +181,7 @@ export declare type BryntumAIFilterFieldProps = {
     dock ? : 'top'|'bottom'|'left'|'right'|'start'|'end'|'header'|'pre-header'|object
     /**
      * *Only valid if this Widget is [floating](https://bryntum.com/products/grid/docs/api/Core/widget/Widget#config-floating).*
-     * Set to `true` to be able to drag a widget freely on the page. Or set to an object with a ´handleSelector´
+     * Set to `true` to be able to drag a widget freely on the page. Or set to an object with a `handleSelector`
      * property which controls when a drag should start.
      * [More...](https://bryntum.com/products/grid/docs/api/Grid/widget/AIFilterField#config-draggable)
      * @property {string} handleSelector CSS selector used to determine if drag can be started from a mouse-downed element inside the widget
@@ -294,10 +297,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
     /**
@@ -499,7 +506,7 @@ export declare type BryntumAIFilterFieldProps = {
     rtl ? : Boolean
     /**
      * Defines what to do if document is scrolled while Widget is visible (only relevant when floating is set to `true`).
-     * Valid values: ´null´: do nothing, ´hide´: hide the widget or ´realign´: realign to the target if possible.
+     * Valid values: `null`: do nothing, `hide`: hide the widget or `realign`: realign to the target if possible.
      */
     scrollAction ? : 'hide'|'realign'|null
     /**

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
     /**
@@ -101,9 +103,10 @@ defineProps<{
     catchEventHandlerExceptions ? : Boolean
     /**
      * *Only valid if this Widget is [floating](https://bryntum.com/products/grid/docs/api/Core/widget/Widget#config-floating).*
-     * Set to `true` to centre the Widget in browser viewport space.
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/BooleanCombo#config-centered)
+     * @property {boolean} [once] If `true`, the Widget will be centred on its first show, but if it is moved at runtime, it will opt out of centering for future shows.
      */
-    centered ? : Boolean
+    centered ? : Boolean|object
     /**
      * 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)
@@ -239,7 +242,7 @@ defineProps<{
     dock ? : 'top'|'bottom'|'left'|'right'|'start'|'end'|'header'|'pre-header'|object
     /**
      * *Only valid if this Widget is [floating](https://bryntum.com/products/grid/docs/api/Core/widget/Widget#config-floating).*
-     * Set to `true` to be able to drag a widget freely on the page. Or set to an object with a ´handleSelector´
+     * Set to `true` to be able to drag a widget freely on the page. Or set to an object with a `handleSelector`
      * property which controls when a drag should start.
      * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/BooleanCombo#config-draggable)
      * @property {string} handleSelector CSS selector used to determine if drag can be started from a mouse-downed element inside the widget
@@ -406,10 +409,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
     /**
@@ -686,7 +693,7 @@ defineProps<{
     rtl ? : Boolean
     /**
      * Defines what to do if document is scrolled while Widget is visible (only relevant when floating is set to `true`).
-     * Valid values: ´null´: do nothing, ´hide´: hide the widget or ´realign´: realign to the target if possible.
+     * Valid values: `null`: do nothing, `hide`: hide the widget or `realign`: realign to the target if possible.
      */
     scrollAction ? : 'hide'|'realign'|null
     /**
@@ -1026,7 +1033,6 @@ const widgetData = {
         'bubbleEvents',
         'cacheLastResult',
         'caseSensitive',
-        'centered',
         'checkValidity',
         'chipView',
         'clearable',
@@ -1127,6 +1133,7 @@ const widgetData = {
         'badge',
         'callOnFunctions',
         'catchEventHandlerExceptions',
+        'centered',
         'cls',
         'column',
         'dataset',

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
     /**
@@ -87,9 +89,10 @@ export declare type BryntumBooleanComboProps = {
     catchEventHandlerExceptions ? : Boolean
     /**
      * *Only valid if this Widget is [floating](https://bryntum.com/products/grid/docs/api/Core/widget/Widget#config-floating).*
-     * Set to `true` to centre the Widget in browser viewport space.
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/BooleanCombo#config-centered)
+     * @property {boolean} [once] If `true`, the Widget will be centred on its first show, but if it is moved at runtime, it will opt out of centering for future shows.
      */
-    centered ? : Boolean
+    centered ? : Boolean|object
     /**
      * 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)
@@ -225,7 +228,7 @@ export declare type BryntumBooleanComboProps = {
     dock ? : 'top'|'bottom'|'left'|'right'|'start'|'end'|'header'|'pre-header'|object
     /**
      * *Only valid if this Widget is [floating](https://bryntum.com/products/grid/docs/api/Core/widget/Widget#config-floating).*
-     * Set to `true` to be able to drag a widget freely on the page. Or set to an object with a ´handleSelector´
+     * Set to `true` to be able to drag a widget freely on the page. Or set to an object with a `handleSelector`
      * property which controls when a drag should start.
      * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/BooleanCombo#config-draggable)
      * @property {string} handleSelector CSS selector used to determine if drag can be started from a mouse-downed element inside the widget
@@ -392,10 +395,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
     /**
@@ -672,7 +679,7 @@ export declare type BryntumBooleanComboProps = {
     rtl ? : Boolean
     /**
      * Defines what to do if document is scrolled while Widget is visible (only relevant when floating is set to `true`).
-     * Valid values: ´null´: do nothing, ´hide´: hide the widget or ´realign´: realign to the target if possible.
+     * Valid values: `null`: do nothing, `hide`: hide the widget or `realign`: realign to the target if possible.
      */
     scrollAction ? : 'hide'|'realign'|null
     /**

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
     /**
@@ -83,9 +85,10 @@ defineProps<{
     catchEventHandlerExceptions ? : Boolean
     /**
      * *Only valid if this Widget is [floating](https://bryntum.com/products/grid/docs/api/Core/widget/Widget#config-floating).*
-     * Set to `true` to centre the Widget in browser viewport space.
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/Button#config-centered)
+     * @property {boolean} [once] If `true`, the Widget will be centred on its first show, but if it is moved at runtime, it will opt out of centering for future shows.
      */
-    centered ? : Boolean
+    centered ? : Boolean|object
     /**
      * Custom CSS classes to add to element.
      * May be specified as a space separated string, or as an object in which property names
@@ -159,7 +162,7 @@ defineProps<{
     dock ? : 'top'|'bottom'|'left'|'right'|'start'|'end'|'header'|'pre-header'|object
     /**
      * *Only valid if this Widget is [floating](https://bryntum.com/products/grid/docs/api/Core/widget/Widget#config-floating).*
-     * Set to `true` to be able to drag a widget freely on the page. Or set to an object with a ´handleSelector´
+     * Set to `true` to be able to drag a widget freely on the page. Or set to an object with a `handleSelector`
      * property which controls when a drag should start.
      * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/Button#config-draggable)
      * @property {string} handleSelector CSS selector used to determine if drag can be started from a mouse-downed element inside the widget
@@ -235,10 +238,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
     /**
@@ -408,7 +415,7 @@ defineProps<{
     scrollable ? : Boolean|ScrollerConfig|Scroller
     /**
      * Defines what to do if document is scrolled while Widget is visible (only relevant when floating is set to `true`).
-     * Valid values: ´null´: do nothing, ´hide´: hide the widget or ´realign´: realign to the target if possible.
+     * Valid values: `null`: do nothing, `hide`: hide the widget or `realign`: realign to the target if possible.
      */
     scrollAction ? : 'hide'|'realign'|null
     /**
@@ -720,7 +727,6 @@ const widgetData = {
         'ariaDescription',
         'ariaLabel',
         'bubbleEvents',
-        'centered',
         'color',
         'config',
         'constrainTo',
@@ -767,6 +773,7 @@ const widgetData = {
         'behaviorType',
         'callOnFunctions',
         'catchEventHandlerExceptions',
+        'centered',
         'cls',
         'column',
         'content',

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
     /**
@@ -83,9 +85,10 @@ defineProps<{
     catchEventHandlerExceptions ? : Boolean
     /**
      * *Only valid if this Widget is [floating](https://bryntum.com/products/grid/docs/api/Core/widget/Widget#config-floating).*
-     * Set to `true` to centre the Widget in browser viewport space.
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/ButtonGroup#config-centered)
+     * @property {boolean} [once] If `true`, the Widget will be centred on its first show, but if it is moved at runtime, it will opt out of centering for future shows.
      */
-    centered ? : Boolean
+    centered ? : Boolean|object
     /**
      * Custom CSS class to add to element.
      * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/ButtonGroup#config-cls)
@@ -168,7 +171,7 @@ defineProps<{
     dock ? : 'top'|'bottom'|'left'|'right'|'start'|'end'|'header'|'pre-header'|object
     /**
      * *Only valid if this Widget is [floating](https://bryntum.com/products/grid/docs/api/Core/widget/Widget#config-floating).*
-     * Set to `true` to be able to drag a widget freely on the page. Or set to an object with a ´handleSelector´
+     * Set to `true` to be able to drag a widget freely on the page. Or set to an object with a `handleSelector`
      * property which controls when a drag should start.
      * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/ButtonGroup#config-draggable)
      * @property {string} handleSelector CSS selector used to determine if drag can be started from a mouse-downed element inside the widget
@@ -243,10 +246,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
     /**
@@ -270,7 +277,7 @@ defineProps<{
      */
     labelPosition ? : 'before'|'above'|'align-before'|'auto'|null
     /**
-     * Sets `labelWidth´ for all children of this Container, that does not define their own `labelWidth`.
+     * Sets `labelWidth` for all children of this Container, that do not define their own `labelWidth`.
      * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/ButtonGroup#config-labelWidth)
      */
     labelWidth ? : number|null
@@ -435,7 +442,7 @@ defineProps<{
     scrollable ? : Boolean|ScrollerConfig|Scroller
     /**
      * Defines what to do if document is scrolled while Widget is visible (only relevant when floating is set to `true`).
-     * Valid values: ´null´: do nothing, ´hide´: hide the widget or ´realign´: realign to the target if possible.
+     * Valid values: `null`: do nothing, `hide`: hide the widget or `realign`: realign to the target if possible.
      */
     scrollAction ? : 'hide'|'realign'|null
     /**
@@ -738,7 +745,6 @@ const widgetData = {
         'autoUpdateRecord',
         'border',
         'bubbleEvents',
-        'centered',
         'color',
         'config',
         'constrainTo',
@@ -792,6 +798,7 @@ const widgetData = {
         'appendTo',
         'callOnFunctions',
         'catchEventHandlerExceptions',
+        'centered',
         'cls',
         'column',
         'content',

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
     /**
@@ -69,9 +71,10 @@ export declare type BryntumButtonGroupProps = {
     catchEventHandlerExceptions ? : Boolean
     /**
      * *Only valid if this Widget is [floating](https://bryntum.com/products/grid/docs/api/Core/widget/Widget#config-floating).*
-     * Set to `true` to centre the Widget in browser viewport space.
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/ButtonGroup#config-centered)
+     * @property {boolean} [once] If `true`, the Widget will be centred on its first show, but if it is moved at runtime, it will opt out of centering for future shows.
      */
-    centered ? : Boolean
+    centered ? : Boolean|object
     /**
      * Custom CSS class to add to element.
      * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/ButtonGroup#config-cls)
@@ -154,7 +157,7 @@ export declare type BryntumButtonGroupProps = {
     dock ? : 'top'|'bottom'|'left'|'right'|'start'|'end'|'header'|'pre-header'|object
     /**
      * *Only valid if this Widget is [floating](https://bryntum.com/products/grid/docs/api/Core/widget/Widget#config-floating).*
-     * Set to `true` to be able to drag a widget freely on the page. Or set to an object with a ´handleSelector´
+     * Set to `true` to be able to drag a widget freely on the page. Or set to an object with a `handleSelector`
      * property which controls when a drag should start.
      * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/ButtonGroup#config-draggable)
      * @property {string} handleSelector CSS selector used to determine if drag can be started from a mouse-downed element inside the widget
@@ -229,10 +232,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
     /**
@@ -256,7 +263,7 @@ export declare type BryntumButtonGroupProps = {
      */
     labelPosition ? : 'before'|'above'|'align-before'|'auto'|null
     /**
-     * Sets `labelWidth´ for all children of this Container, that does not define their own `labelWidth`.
+     * Sets `labelWidth` for all children of this Container, that do not define their own `labelWidth`.
      * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/ButtonGroup#config-labelWidth)
      */
     labelWidth ? : number|null
@@ -421,7 +428,7 @@ export declare type BryntumButtonGroupProps = {
     scrollable ? : Boolean|ScrollerConfig|Scroller
     /**
      * Defines what to do if document is scrolled while Widget is visible (only relevant when floating is set to `true`).
-     * Valid values: ´null´: do nothing, ´hide´: hide the widget or ´realign´: realign to the target if possible.
+     * Valid values: `null`: do nothing, `hide`: hide the widget or `realign`: realign to the target if possible.
      */
     scrollAction ? : 'hide'|'realign'|null
     /**