@bryntum/scheduler-vue-3-thin 7.3.1 → 7.3.3

package/lib/components/BryntumEventColorField.js

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

package/lib/components/BryntumProjectCombo.js

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

package/lib/components/BryntumResourceCombo.js

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

package/lib/components/BryntumResourceFilter.js

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

package/lib/components/BryntumScheduler.js

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

package/lib/components/BryntumSchedulerBase.js

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

package/lib/components/BryntumSchedulerDatePicker.js

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

package/lib/components/BryntumTimeZoomSlider.js

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

package/lib/components/BryntumTimelineHistogram.js

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

package/lib/components/BryntumUndoRedo.js

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

package/lib/components/BryntumViewPresetCombo.js

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

package/lib/index.js

@@ -1,15 +1,15 @@
-import { _ as e } from "./chunks/LNqNYJck.js";
-import { _ as t } from "./chunks/WykRcMCN.js";
+import { _ as e } from "./chunks/BfjWO3kK.js";
+import { _ as t } from "./chunks/LMHMtS2k.js";
 import { _ as s } from "./chunks/DB0UHrA3.js";
-import { _ as n } from "./chunks/COFzBhB8.js";
-import { _ as f } from "./chunks/eUISgYXE.js";
-import { _ as x } from "./chunks/DJSlX0qP.js";
-import { _ } from "./chunks/CCTV8qn0.js";
-import { _ as c } from "./chunks/R69sJLmF.js";
-import { _ as i } from "./chunks/DP61St-u.js";
-import { _ as h } from "./chunks/BXIuEgYD.js";
-import { _ as P } from "./chunks/t8aiH3XL.js";
-import { _ as R } from "./chunks/BTSObfAz.js";
+import { _ as n } from "./chunks/B6aQqhFM.js";
+import { _ as f } from "./chunks/BTLisl7r.js";
+import { _ as x } from "./chunks/DmIsgejh.js";
+import { _ } from "./chunks/VDhd_o2j.js";
+import { _ as c } from "./chunks/5GdIc4FM.js";
+import { _ as i } from "./chunks/nAc8iihR.js";
+import { _ as h } from "./chunks/i2tQo2S7.js";
+import { _ as P } from "./chunks/DDmSlw_T.js";
+import { _ as R } from "./chunks/CHeY7FaY.js";
 export {
   e as BryntumEventColorField,
   t as BryntumProjectCombo,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bryntum/scheduler-vue-3-thin",
-  "version": "7.3.1",
+  "version": "7.3.3",
   "description": "Vue 3 wrappers for Bryntum Scheduler JavaScript component",
   "keywords": [
     "bryntum",

package/src/components/BryntumEventColorField.vue

@@ -47,6 +47,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/scheduler/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/scheduler/docs/api/Scheduler/widget/EventColorField#config-appendTo)
      */
     appendTo ? : HTMLElement|string
     /**
@@ -97,9 +99,10 @@ defineProps<{
     catchEventHandlerExceptions ? : Boolean
     /**
      * *Only valid if this Widget is [floating](https://bryntum.com/products/scheduler/docs/api/Core/widget/Widget#config-floating).*
-     * Set to `true` to centre the Widget in browser viewport space.
+     * [More...](https://bryntum.com/products/scheduler/docs/api/Scheduler/widget/EventColorField#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/scheduler/docs/api/Core/widget/Field#property-isValid)
@@ -197,7 +200,7 @@ defineProps<{
     dock ? : 'top'|'bottom'|'left'|'right'|'start'|'end'|'header'|'pre-header'|object
     /**
      * *Only valid if this Widget is [floating](https://bryntum.com/products/scheduler/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/scheduler/docs/api/Scheduler/widget/EventColorField#config-draggable)
      * @property {string} handleSelector CSS selector used to determine if drag can be started from a mouse-downed element inside the widget
@@ -306,10 +309,14 @@ defineProps<{
     inputWidth ? : string|number
     /**
      * Element (or element id) to insert this widget before. If provided, [appendTo](https://bryntum.com/products/scheduler/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/scheduler/docs/api/Scheduler/widget/EventColorField#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/scheduler/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/scheduler/docs/api/Scheduler/widget/EventColorField#config-insertFirst)
      */
     insertFirst ? : HTMLElement|string
     /**
@@ -511,7 +518,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
     /**
@@ -822,7 +829,6 @@ const widgetData = {
         'autoExpand',
         'autoSelect',
         'bubbleEvents',
-        'centered',
         'checkValidity',
         'clearable',
         'config',
@@ -892,6 +898,7 @@ const widgetData = {
         'badge',
         'callOnFunctions',
         'catchEventHandlerExceptions',
+        'centered',
         'cls',
         'colors',
         'column',

package/src/components/BryntumEventColorFieldProps.ts

@@ -32,6 +32,8 @@ export declare type BryntumEventColorFieldProps = {
     /**
      * 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/scheduler/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/scheduler/docs/api/Scheduler/widget/EventColorField#config-appendTo)
      */
     appendTo ? : HTMLElement|string
     /**
@@ -82,9 +84,10 @@ export declare type BryntumEventColorFieldProps = {
     catchEventHandlerExceptions ? : Boolean
     /**
      * *Only valid if this Widget is [floating](https://bryntum.com/products/scheduler/docs/api/Core/widget/Widget#config-floating).*
-     * Set to `true` to centre the Widget in browser viewport space.
+     * [More...](https://bryntum.com/products/scheduler/docs/api/Scheduler/widget/EventColorField#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/scheduler/docs/api/Core/widget/Field#property-isValid)
@@ -182,7 +185,7 @@ export declare type BryntumEventColorFieldProps = {
     dock ? : 'top'|'bottom'|'left'|'right'|'start'|'end'|'header'|'pre-header'|object
     /**
      * *Only valid if this Widget is [floating](https://bryntum.com/products/scheduler/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/scheduler/docs/api/Scheduler/widget/EventColorField#config-draggable)
      * @property {string} handleSelector CSS selector used to determine if drag can be started from a mouse-downed element inside the widget
@@ -291,10 +294,14 @@ export declare type BryntumEventColorFieldProps = {
     inputWidth ? : string|number
     /**
      * Element (or element id) to insert this widget before. If provided, [appendTo](https://bryntum.com/products/scheduler/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/scheduler/docs/api/Scheduler/widget/EventColorField#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/scheduler/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/scheduler/docs/api/Scheduler/widget/EventColorField#config-insertFirst)
      */
     insertFirst ? : HTMLElement|string
     /**
@@ -496,7 +503,7 @@ export declare type BryntumEventColorFieldProps = {
     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/BryntumProjectCombo.vue

@@ -43,6 +43,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/scheduler/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/scheduler/docs/api/Scheduler/widget/ProjectCombo#config-appendTo)
      */
     appendTo ? : HTMLElement|string
     /**
@@ -102,9 +104,10 @@ defineProps<{
     catchEventHandlerExceptions ? : Boolean
     /**
      * *Only valid if this Widget is [floating](https://bryntum.com/products/scheduler/docs/api/Core/widget/Widget#config-floating).*
-     * Set to `true` to centre the Widget in browser viewport space.
+     * [More...](https://bryntum.com/products/scheduler/docs/api/Scheduler/widget/ProjectCombo#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/scheduler/docs/api/Core/widget/Field#property-isValid)
@@ -240,7 +243,7 @@ defineProps<{
     dock ? : 'top'|'bottom'|'left'|'right'|'start'|'end'|'header'|'pre-header'|object
     /**
      * *Only valid if this Widget is [floating](https://bryntum.com/products/scheduler/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/scheduler/docs/api/Scheduler/widget/ProjectCombo#config-draggable)
      * @property {string} handleSelector CSS selector used to determine if drag can be started from a mouse-downed element inside the widget
@@ -407,10 +410,14 @@ defineProps<{
     inputWidth ? : string|number
     /**
      * Element (or element id) to insert this widget before. If provided, [appendTo](https://bryntum.com/products/scheduler/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/scheduler/docs/api/Scheduler/widget/ProjectCombo#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/scheduler/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/scheduler/docs/api/Scheduler/widget/ProjectCombo#config-insertFirst)
      */
     insertFirst ? : HTMLElement|string
     /**
@@ -622,7 +629,7 @@ defineProps<{
     /**
      * Project to reconfigure when picking an item.
      */
-    project ? : ProjectModel|object
+    project ? : ProjectModel|object|null
     /**
      * Makes the field unmodifiable by user action. The input area is not editable, and triggers
      * are unresponsive.
@@ -675,7 +682,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
     /**
@@ -1014,7 +1021,6 @@ const widgetData = {
         'bubbleEvents',
         'cacheLastResult',
         'caseSensitive',
-        'centered',
         'checkValidity',
         'chipView',
         'clearable',
@@ -1112,6 +1118,7 @@ const widgetData = {
         'badge',
         'callOnFunctions',
         'catchEventHandlerExceptions',
+        'centered',
         'cls',
         'column',
         'dataset',

package/src/components/BryntumProjectComboProps.ts

@@ -28,6 +28,8 @@ export declare type BryntumProjectComboProps = {
     /**
      * 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/scheduler/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/scheduler/docs/api/Scheduler/widget/ProjectCombo#config-appendTo)
      */
     appendTo ? : HTMLElement|string
     /**
@@ -87,9 +89,10 @@ export declare type BryntumProjectComboProps = {
     catchEventHandlerExceptions ? : Boolean
     /**
      * *Only valid if this Widget is [floating](https://bryntum.com/products/scheduler/docs/api/Core/widget/Widget#config-floating).*
-     * Set to `true` to centre the Widget in browser viewport space.
+     * [More...](https://bryntum.com/products/scheduler/docs/api/Scheduler/widget/ProjectCombo#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/scheduler/docs/api/Core/widget/Field#property-isValid)
@@ -225,7 +228,7 @@ export declare type BryntumProjectComboProps = {
     dock ? : 'top'|'bottom'|'left'|'right'|'start'|'end'|'header'|'pre-header'|object
     /**
      * *Only valid if this Widget is [floating](https://bryntum.com/products/scheduler/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/scheduler/docs/api/Scheduler/widget/ProjectCombo#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 BryntumProjectComboProps = {
     inputWidth ? : string|number
     /**
      * Element (or element id) to insert this widget before. If provided, [appendTo](https://bryntum.com/products/scheduler/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/scheduler/docs/api/Scheduler/widget/ProjectCombo#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/scheduler/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/scheduler/docs/api/Scheduler/widget/ProjectCombo#config-insertFirst)
      */
     insertFirst ? : HTMLElement|string
     /**
@@ -607,7 +614,7 @@ export declare type BryntumProjectComboProps = {
     /**
      * Project to reconfigure when picking an item.
      */
-    project ? : ProjectModel|object
+    project ? : ProjectModel|object|null
     /**
      * Makes the field unmodifiable by user action. The input area is not editable, and triggers
      * are unresponsive.
@@ -660,7 +667,7 @@ export declare type BryntumProjectComboProps = {
     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/BryntumResourceCombo.vue

@@ -43,6 +43,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/scheduler/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/scheduler/docs/api/Scheduler/widget/ResourceCombo#config-appendTo)
      */
     appendTo ? : HTMLElement|string
     /**
@@ -102,9 +104,10 @@ defineProps<{
     catchEventHandlerExceptions ? : Boolean
     /**
      * *Only valid if this Widget is [floating](https://bryntum.com/products/scheduler/docs/api/Core/widget/Widget#config-floating).*
-     * Set to `true` to centre the Widget in browser viewport space.
+     * [More...](https://bryntum.com/products/scheduler/docs/api/Scheduler/widget/ResourceCombo#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/scheduler/docs/api/Core/widget/Field#property-isValid)
@@ -240,7 +243,7 @@ defineProps<{
     dock ? : 'top'|'bottom'|'left'|'right'|'start'|'end'|'header'|'pre-header'|object
     /**
      * *Only valid if this Widget is [floating](https://bryntum.com/products/scheduler/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/scheduler/docs/api/Scheduler/widget/ResourceCombo#config-draggable)
      * @property {string} handleSelector CSS selector used to determine if drag can be started from a mouse-downed element inside the widget
@@ -407,10 +410,14 @@ defineProps<{
     inputWidth ? : string|number
     /**
      * Element (or element id) to insert this widget before. If provided, [appendTo](https://bryntum.com/products/scheduler/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/scheduler/docs/api/Scheduler/widget/ResourceCombo#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/scheduler/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/scheduler/docs/api/Scheduler/widget/ResourceCombo#config-insertFirst)
      */
     insertFirst ? : HTMLElement|string
     /**
@@ -671,7 +678,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
     /**
@@ -1016,7 +1023,6 @@ const widgetData = {
         'bubbleEvents',
         'cacheLastResult',
         'caseSensitive',
-        'centered',
         'checkValidity',
         'chipView',
         'clearable',
@@ -1114,6 +1120,7 @@ const widgetData = {
         'badge',
         'callOnFunctions',
         'catchEventHandlerExceptions',
+        'centered',
         'cls',
         'column',
         'dataset',

package/src/components/BryntumResourceComboProps.ts

@@ -28,6 +28,8 @@ export declare type BryntumResourceComboProps = {
     /**
      * 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/scheduler/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/scheduler/docs/api/Scheduler/widget/ResourceCombo#config-appendTo)
      */
     appendTo ? : HTMLElement|string
     /**
@@ -87,9 +89,10 @@ export declare type BryntumResourceComboProps = {
     catchEventHandlerExceptions ? : Boolean
     /**
      * *Only valid if this Widget is [floating](https://bryntum.com/products/scheduler/docs/api/Core/widget/Widget#config-floating).*
-     * Set to `true` to centre the Widget in browser viewport space.
+     * [More...](https://bryntum.com/products/scheduler/docs/api/Scheduler/widget/ResourceCombo#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/scheduler/docs/api/Core/widget/Field#property-isValid)
@@ -225,7 +228,7 @@ export declare type BryntumResourceComboProps = {
     dock ? : 'top'|'bottom'|'left'|'right'|'start'|'end'|'header'|'pre-header'|object
     /**
      * *Only valid if this Widget is [floating](https://bryntum.com/products/scheduler/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/scheduler/docs/api/Scheduler/widget/ResourceCombo#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 BryntumResourceComboProps = {
     inputWidth ? : string|number
     /**
      * Element (or element id) to insert this widget before. If provided, [appendTo](https://bryntum.com/products/scheduler/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/scheduler/docs/api/Scheduler/widget/ResourceCombo#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/scheduler/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/scheduler/docs/api/Scheduler/widget/ResourceCombo#config-insertFirst)
      */
     insertFirst ? : HTMLElement|string
     /**
@@ -656,7 +663,7 @@ export declare type BryntumResourceComboProps = {
     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/BryntumResourceFilter.vue

@@ -53,6 +53,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/scheduler/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/scheduler/docs/api/Scheduler/widget/ResourceFilter#config-appendTo)
      */
     appendTo ? : HTMLElement|string
     /**
@@ -86,9 +88,10 @@ defineProps<{
     catchEventHandlerExceptions ? : Boolean
     /**
      * *Only valid if this Widget is [floating](https://bryntum.com/products/scheduler/docs/api/Core/widget/Widget#config-floating).*
-     * Set to `true` to centre the Widget in browser viewport space.
+     * [More...](https://bryntum.com/products/scheduler/docs/api/Scheduler/widget/ResourceFilter#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
     /**
      * Configure as `true` to clear selection when clicking on empty space inside the List´s element.
      */
@@ -174,7 +177,7 @@ defineProps<{
     dock ? : 'top'|'bottom'|'left'|'right'|'start'|'end'|'header'|'pre-header'|object
     /**
      * *Only valid if this Widget is [floating](https://bryntum.com/products/scheduler/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/scheduler/docs/api/Scheduler/widget/ResourceFilter#config-draggable)
      * @property {string} handleSelector CSS selector used to determine if drag can be started from a mouse-downed element inside the widget
@@ -274,10 +277,14 @@ defineProps<{
     ignoreParentReadOnly ? : Boolean
     /**
      * Element (or element id) to insert this widget before. If provided, [appendTo](https://bryntum.com/products/scheduler/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/scheduler/docs/api/Scheduler/widget/ResourceFilter#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/scheduler/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/scheduler/docs/api/Scheduler/widget/ResourceFilter#config-insertFirst)
      */
     insertFirst ? : HTMLElement|string
     /**
@@ -446,7 +453,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
     /**
@@ -523,7 +530,7 @@ defineProps<{
      */
     ui ? : string|object
     /**
-     * Configure as `false` to not use the Resource`s color field to style the checkbox
+     * Configure as `false` to not use the Resource's color field to style the checkbox
      */
     useResourceColor ? : Boolean
     /**
@@ -766,7 +773,6 @@ const widgetData = {
         'ariaDescription',
         'ariaLabel',
         'bubbleEvents',
-        'centered',
         'color',
         'config',
         'constrainTo',
@@ -823,6 +829,7 @@ const widgetData = {
         'appendTo',
         'callOnFunctions',
         'catchEventHandlerExceptions',
+        'centered',
         'clearSelectionOnEmptySpaceClick',
         'cls',
         'collapsibleGroups',