@bryntum/core-react-thin 7.3.1 → 7.3.3

package/src/BryntumDateField.tsx

@@ -34,6 +34,8 @@ export type BryntumDateFieldProps = {
     /**
      * Element (or the id of an element) to append this widget's element to. Can be configured, or set once at
      * runtime. To access the element of a rendered widget, see [element](https://bryntum.com/products/core/docs/api/Core/widget/Widget#property-element).
+     * <div class="note">When creating nested trees of widgets, this should only be used on the outermost widget.
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/DateField#config-appendTo)
      */
     appendTo? : HTMLElement|string
     /**
@@ -84,9 +86,10 @@ export type BryntumDateFieldProps = {
     catchEventHandlerExceptions? : boolean
     /**
      * *Only valid if this Widget is [floating](https://bryntum.com/products/core/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/DateField#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/core/docs/api/Core/widget/Field#property-isValid)
@@ -183,7 +186,7 @@ export type BryntumDateFieldProps = {
     dock? : 'top'|'bottom'|'left'|'right'|'start'|'end'|'header'|'pre-header'|object
     /**
      * *Only valid if this Widget is [floating](https://bryntum.com/products/core/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/DateField#config-draggable)
      * @property {string} handleSelector CSS selector used to determine if drag can be started from a mouse-downed element inside the widget
@@ -300,10 +303,14 @@ export type BryntumDateFieldProps = {
     inputWidth? : string|number
     /**
      * Element (or element id) to insert this widget before. If provided, [appendTo](https://bryntum.com/products/core/docs/api/Core/widget/Widget#config-appendTo) config is ignored.
+     * <div class="note">When creating nested trees of widgets, this should only be used on the outermost widget.
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/DateField#config-insertBefore)
      */
     insertBefore? : HTMLElement|string
     /**
      * Element (or element id) to append this widget element to, as a first child. If provided, [appendTo](https://bryntum.com/products/core/docs/api/Core/widget/Widget#config-appendTo) config is ignored.
+     * <div class="note">When creating nested trees of widgets, this should only be used on the outermost widget.
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/DateField#config-insertFirst)
      */
     insertFirst? : HTMLElement|string
     /**
@@ -535,7 +542,7 @@ export type BryntumDateFieldProps = {
     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
     /**
@@ -841,7 +848,6 @@ export class BryntumDateField extends React.Component<BryntumDateFieldProps> {
         'autoExpand',
         'autoSelect',
         'bubbleEvents',
-        'centered',
         'checkValidity',
         'clearable',
         'color',
@@ -918,6 +924,7 @@ export class BryntumDateField extends React.Component<BryntumDateFieldProps> {
         'badge',
         'callOnFunctions',
         'catchEventHandlerExceptions',
+        'centered',
         'cls',
         'column',
         'dataset',

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
     /**
@@ -117,9 +119,10 @@ export type BryntumDatePickerProps = {
     cellRenderer? : ((renderData: { cell: HTMLElement, innerCell: HTMLElement, cellPayload: HTMLElement, date: Date, day: number, rowIndex: number[], row: HTMLElement, source: CalendarPanel, cellIndex: number[], columnIndex: number[], visibleColumnIndex: number[] }) => string|DomConfig|void)|string
     /**
      * *Only valid if this Widget is [floating](https://bryntum.com/products/core/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/DatePicker#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
@@ -249,7 +252,7 @@ export type BryntumDatePickerProps = {
     dock? : 'top'|'bottom'|'left'|'right'|'start'|'end'|'header'|'pre-header'|object
     /**
      * *Only valid if this Widget is [floating](https://bryntum.com/products/core/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/DatePicker#config-draggable)
      * @property {string} handleSelector CSS selector used to determine if drag can be started from a mouse-downed element inside the widget
@@ -394,10 +397,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
     /**
@@ -423,7 +430,7 @@ export type BryntumDatePickerProps = {
      */
     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/DatePicker#config-labelWidth)
      */
     labelWidth? : number|null
@@ -638,7 +645,7 @@ export type BryntumDatePickerProps = {
     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
     /**
@@ -1051,7 +1058,6 @@ export class BryntumDatePicker extends React.Component<BryntumDatePickerProps> {
         'border',
         'bubbleEvents',
         'cellRenderer',
-        'centered',
         'collapsible',
         'color',
         'config',
@@ -1143,6 +1149,7 @@ export class BryntumDatePicker extends React.Component<BryntumDatePickerProps> {
         'appendTo',
         'callOnFunctions',
         'catchEventHandlerExceptions',
+        'centered',
         'cls',
         'collapsed',
         'column',

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
     /**
@@ -84,9 +86,10 @@ export type BryntumDateRangeFieldProps = {
     catchEventHandlerExceptions? : boolean
     /**
      * *Only valid if this Widget is [floating](https://bryntum.com/products/core/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/DateRangeField#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/core/docs/api/Core/widget/Field#property-isValid)
@@ -197,7 +200,7 @@ export type BryntumDateRangeFieldProps = {
     dock? : 'top'|'bottom'|'left'|'right'|'start'|'end'|'header'|'pre-header'|object
     /**
      * *Only valid if this Widget is [floating](https://bryntum.com/products/core/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/DateRangeField#config-draggable)
      * @property {string} handleSelector CSS selector used to determine if drag can be started from a mouse-downed element inside the widget
@@ -322,10 +325,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
     /**
@@ -546,7 +553,7 @@ export type BryntumDateRangeFieldProps = {
     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
     /**
@@ -829,7 +836,6 @@ export class BryntumDateRangeField extends React.Component<BryntumDateRangeField
         'autoExpand',
         'autoSelect',
         'bubbleEvents',
-        'centered',
         'checkValidity',
         'clearable',
         'color',
@@ -905,6 +911,7 @@ export class BryntumDateRangeField extends React.Component<BryntumDateRangeField
         'badge',
         'callOnFunctions',
         'catchEventHandlerExceptions',
+        'centered',
         'cls',
         'column',
         'confirmable',

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
     /**
@@ -75,9 +77,10 @@ export type BryntumDateTimeFieldProps = {
     catchEventHandlerExceptions? : boolean
     /**
      * *Only valid if this Widget is [floating](https://bryntum.com/products/core/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/DateTimeField#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/core/docs/api/Core/widget/Field#property-isValid)
@@ -178,7 +181,7 @@ export type BryntumDateTimeFieldProps = {
     dock? : 'top'|'bottom'|'left'|'right'|'start'|'end'|'header'|'pre-header'|object
     /**
      * *Only valid if this Widget is [floating](https://bryntum.com/products/core/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/DateTimeField#config-draggable)
      * @property {string} handleSelector CSS selector used to determine if drag can be started from a mouse-downed element inside the widget
@@ -276,10 +279,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
     /**
@@ -469,7 +476,7 @@ export type BryntumDateTimeFieldProps = {
     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
     /**
@@ -736,7 +743,6 @@ export class BryntumDateTimeField extends React.Component<BryntumDateTimeFieldPr
         'ariaLabel',
         'autoSelect',
         'bubbleEvents',
-        'centered',
         'checkValidity',
         'clearable',
         'color',
@@ -800,6 +806,7 @@ export class BryntumDateTimeField extends React.Component<BryntumDateTimeFieldPr
         'badge',
         'callOnFunctions',
         'catchEventHandlerExceptions',
+        'centered',
         'cls',
         'column',
         'dataset',

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
     /**
@@ -90,9 +92,10 @@ export type BryntumDemoCodeEditorProps = {
     catchEventHandlerExceptions? : boolean
     /**
      * *Only valid if this Widget is [floating](https://bryntum.com/products/core/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/DemoCodeEditor#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
@@ -193,7 +196,7 @@ export type BryntumDemoCodeEditorProps = {
     dock? : 'top'|'bottom'|'left'|'right'|'start'|'end'|'header'|'pre-header'|object
     /**
      * *Only valid if this Widget is [floating](https://bryntum.com/products/core/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/DemoCodeEditor#config-draggable)
      * @property {string} handleSelector CSS selector used to determine if drag can be started from a mouse-downed element inside the widget
@@ -304,10 +307,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
     /**
@@ -333,7 +340,7 @@ export type BryntumDemoCodeEditorProps = {
      */
     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/DemoCodeEditor#config-labelWidth)
      */
     labelWidth? : number|null
@@ -511,7 +518,7 @@ export type BryntumDemoCodeEditorProps = {
     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
     /**
@@ -838,7 +845,6 @@ export class BryntumDemoCodeEditor extends React.Component<BryntumDemoCodeEditor
         'bodyCls',
         'border',
         'bubbleEvents',
-        'centered',
         'codePath',
         'collapsible',
         'color',
@@ -906,6 +912,7 @@ export class BryntumDemoCodeEditor extends React.Component<BryntumDemoCodeEditor
         'appendTo',
         'callOnFunctions',
         'catchEventHandlerExceptions',
+        'centered',
         'cls',
         'collapsed',
         'column',

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
     /**
@@ -80,9 +82,10 @@ export type BryntumDisplayFieldProps = {
     catchEventHandlerExceptions? : boolean
     /**
      * *Only valid if this Widget is [floating](https://bryntum.com/products/core/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/DisplayField#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/core/docs/api/Core/widget/Field#property-isValid)
@@ -179,7 +182,7 @@ export type BryntumDisplayFieldProps = {
     dock? : 'top'|'bottom'|'left'|'right'|'start'|'end'|'header'|'pre-header'|object
     /**
      * *Only valid if this Widget is [floating](https://bryntum.com/products/core/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/DisplayField#config-draggable)
      * @property {string} handleSelector CSS selector used to determine if drag can be started from a mouse-downed element inside the widget
@@ -295,10 +298,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
     /**
@@ -483,7 +490,7 @@ export type BryntumDisplayFieldProps = {
     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
     /**
@@ -768,7 +775,6 @@ export class BryntumDisplayField extends React.Component<BryntumDisplayFieldProp
         'autoComplete',
         'autoSelect',
         'bubbleEvents',
-        'centered',
         'checkValidity',
         'clearable',
         'color',
@@ -837,6 +843,7 @@ export class BryntumDisplayField extends React.Component<BryntumDisplayFieldProp
         'badge',
         'callOnFunctions',
         'catchEventHandlerExceptions',
+        'centered',
         'cls',
         'column',
         'dataset',

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
     /**
@@ -89,9 +91,10 @@ export type BryntumDurationFieldProps = {
     catchEventHandlerExceptions? : boolean
     /**
      * *Only valid if this Widget is [floating](https://bryntum.com/products/core/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/DurationField#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/core/docs/api/Core/widget/Field#property-isValid)
@@ -192,7 +195,7 @@ export type BryntumDurationFieldProps = {
     dock? : 'top'|'bottom'|'left'|'right'|'start'|'end'|'header'|'pre-header'|object
     /**
      * *Only valid if this Widget is [floating](https://bryntum.com/products/core/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/DurationField#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 @@ 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
     /**
@@ -522,7 +529,7 @@ export type BryntumDurationFieldProps = {
     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
     /**
@@ -816,7 +823,6 @@ export class BryntumDurationField extends React.Component<BryntumDurationFieldPr
         'autoComplete',
         'autoSelect',
         'bubbleEvents',
-        'centered',
         'checkValidity',
         'clearable',
         'color',
@@ -890,6 +896,7 @@ export class BryntumDurationField extends React.Component<BryntumDurationFieldPr
         'badge',
         'callOnFunctions',
         'catchEventHandlerExceptions',
+        'centered',
         'cls',
         'column',
         'dataset',

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
     /**
@@ -89,9 +91,10 @@ export type BryntumEditorProps = {
     catchEventHandlerExceptions? : boolean
     /**
      * *Only valid if this Widget is [floating](https://bryntum.com/products/core/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/Editor#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
@@ -186,7 +189,7 @@ export type BryntumEditorProps = {
     dock? : 'top'|'bottom'|'left'|'right'|'start'|'end'|'header'|'pre-header'|object
     /**
      * *Only valid if this Widget is [floating](https://bryntum.com/products/core/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/Editor#config-draggable)
      * @property {string} handleSelector CSS selector used to determine if drag can be started from a mouse-downed element inside the widget
@@ -276,10 +279,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
     /**
@@ -310,7 +317,7 @@ export type BryntumEditorProps = {
      */
     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/Editor#config-labelWidth)
      */
     labelWidth? : number|null
@@ -488,7 +495,7 @@ export type BryntumEditorProps = {
     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
     /**
@@ -793,7 +800,6 @@ export class BryntumEditor extends React.Component<BryntumEditorProps> {
         'border',
         'bubbleEvents',
         'cancelKey',
-        'centered',
         'color',
         'completeKey',
         'completeOnChange',
@@ -853,6 +859,7 @@ export class BryntumEditor extends React.Component<BryntumEditorProps> {
         'appendTo',
         'callOnFunctions',
         'catchEventHandlerExceptions',
+        'centered',
         'cls',
         'column',
         'content',