@bryntum/calendar-vue-3 7.3.1 → 7.3.3

package/src/components/BryntumDateTimeField.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/calendar/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/calendar/docs/api/Core/widget/DateTimeField#config-appendTo)
      */
     appendTo ? : HTMLElement|string
     /**
@@ -83,9 +85,10 @@ defineProps<{
     catchEventHandlerExceptions ? : Boolean
     /**
      * *Only valid if this Widget is [floating](https://bryntum.com/products/calendar/docs/api/Core/widget/Widget#config-floating).*
-     * Set to `true` to centre the Widget in browser viewport space.
+     * [More...](https://bryntum.com/products/calendar/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/calendar/docs/api/Core/widget/Field#property-isValid)
@@ -186,7 +189,7 @@ defineProps<{
     dock ? : 'top'|'bottom'|'left'|'right'|'start'|'end'|'header'|'pre-header'|object
     /**
      * *Only valid if this Widget is [floating](https://bryntum.com/products/calendar/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/calendar/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
@@ -284,10 +287,14 @@ defineProps<{
     inputTag ? : string
     /**
      * Element (or element id) to insert this widget before. If provided, [appendTo](https://bryntum.com/products/calendar/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/calendar/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/calendar/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/calendar/docs/api/Core/widget/DateTimeField#config-insertFirst)
      */
     insertFirst ? : HTMLElement|string
     /**
@@ -477,7 +484,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
     /**
@@ -777,7 +784,6 @@ const widgetData = {
         'ariaLabel',
         'autoSelect',
         'bubbleEvents',
-        'centered',
         'checkValidity',
         'clearable',
         'color',
@@ -840,6 +846,7 @@ const widgetData = {
         'badge',
         'callOnFunctions',
         'catchEventHandlerExceptions',
+        'centered',
         'cls',
         'column',
         'dataset',

package/src/components/BryntumDateTimeFieldProps.ts

@@ -28,6 +28,8 @@ export declare 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/calendar/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/calendar/docs/api/Core/widget/DateTimeField#config-appendTo)
      */
     appendTo ? : HTMLElement|string
     /**
@@ -69,9 +71,10 @@ export declare type BryntumDateTimeFieldProps = {
     catchEventHandlerExceptions ? : Boolean
     /**
      * *Only valid if this Widget is [floating](https://bryntum.com/products/calendar/docs/api/Core/widget/Widget#config-floating).*
-     * Set to `true` to centre the Widget in browser viewport space.
+     * [More...](https://bryntum.com/products/calendar/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/calendar/docs/api/Core/widget/Field#property-isValid)
@@ -172,7 +175,7 @@ export declare type BryntumDateTimeFieldProps = {
     dock ? : 'top'|'bottom'|'left'|'right'|'start'|'end'|'header'|'pre-header'|object
     /**
      * *Only valid if this Widget is [floating](https://bryntum.com/products/calendar/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/calendar/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
@@ -270,10 +273,14 @@ export declare type BryntumDateTimeFieldProps = {
     inputTag ? : string
     /**
      * Element (or element id) to insert this widget before. If provided, [appendTo](https://bryntum.com/products/calendar/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/calendar/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/calendar/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/calendar/docs/api/Core/widget/DateTimeField#config-insertFirst)
      */
     insertFirst ? : HTMLElement|string
     /**
@@ -463,7 +470,7 @@ export declare 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
     /**

package/src/components/BryntumDayAgendaView.vue

@@ -10,7 +10,7 @@
 
 import { getCurrentInstance, onBeforeUnmount, onMounted, provide, ref, watch, toRaw } from 'vue';
 
-import type { ActionButtonsConfig, AlignSpec, Base, BryntumScrollOptions, ButtonConfig, CalendarMixinClass, CalendarRow, CalendarRowConfig, CalendarView, Color, Container, ContainerItemConfig, ContainerLayoutConfig, DateRangeOwner, DayAgendaViewListeners, DayCell, DayCellWithEvents, DayView, DomConfig, DurationConfig, EventBar, EventModel, KeyMapConfig, MaskConfig, MenuItemConfig, MenuItemEntry, Model, OverflowPopupConfig, PagingToolbarConfig, Panel, PanelCollapserConfig, PanelCollapserOverlayConfig, PanelHeader, Rectangle, ResourceModel, Scroller, ScrollerConfig, StateProvider, TabConfig, Tool, ToolConfig, ToolbarConfig, ToolbarItems, TooltipConfig, Widget } from '@bryntum/calendar';
+import type { ActionButtonsConfig, AlignSpec, Base, BryntumScrollOptions, ButtonConfig, CalendarMixinClass, CalendarRow, CalendarRowConfig, CalendarView, Color, Container, ContainerItemConfig, ContainerLayoutConfig, DateRangeOwner, DayAgendaViewListeners, DayCell, DayCellWithEvents, DayView, DomConfig, DurationConfig, EventBar, EventModel, KeyMapConfig, MaskConfig, MenuItemConfig, MenuItemEntry, Model, OverflowPopupConfig, PagingToolbarConfig, Panel, PanelCollapserConfig, PanelCollapserOverlayConfig, PanelHeader, Rectangle, ResourceModel, Scroller, ScrollerConfig, StateProvider, TabConfig, Tool, ToolConfig, ToolbarConfig, ToolbarItems, TooltipConfig, VisibleStartTimeOptions, Widget } from '@bryntum/calendar';
 import { DayAgendaView } from '@bryntum/calendar';
 
 import { WrapperHelper } from '../helper/WrapperHelper';
@@ -83,6 +83,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/calendar/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/calendar/docs/api/Calendar/widget/DayAgendaView#config-appendTo)
      */
     appendTo ? : HTMLElement|string
     /**
@@ -147,9 +149,10 @@ defineProps<{
     catchEventHandlerExceptions ? : Boolean
     /**
      * *Only valid if this Widget is [floating](https://bryntum.com/products/calendar/docs/api/Core/widget/Widget#config-floating).*
-     * Set to `true` to centre the Widget in browser viewport space.
+     * [More...](https://bryntum.com/products/calendar/docs/api/Calendar/widget/DayAgendaView#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
@@ -367,7 +370,7 @@ defineProps<{
     dock ? : 'top'|'bottom'|'left'|'right'|'start'|'end'|'header'|'pre-header'|object
     /**
      * *Only valid if this Widget is [floating](https://bryntum.com/products/calendar/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/calendar/docs/api/Calendar/widget/DayAgendaView#config-draggable)
      * @property {string} handleSelector CSS selector used to determine if drag can be started from a mouse-downed element inside the widget
@@ -617,10 +620,14 @@ defineProps<{
     inputFieldAlign ? : 'start'|'end'
     /**
      * Element (or element id) to insert this widget before. If provided, [appendTo](https://bryntum.com/products/calendar/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/calendar/docs/api/Calendar/widget/DayAgendaView#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/calendar/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/calendar/docs/api/Calendar/widget/DayAgendaView#config-insertFirst)
      */
     insertFirst ? : HTMLElement|string
     /**
@@ -657,7 +664,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/calendar/docs/api/Calendar/widget/DayAgendaView#config-labelWidth)
      */
     labelWidth ? : number|null
@@ -908,7 +915,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
     /**
@@ -1140,7 +1147,7 @@ defineProps<{
      * @property {number} [animate.duration] The number of milliseconds to animate over.
      * @property {string} [animate.easing] The name of an easing function.
      */
-    visibleStartTime ? : string|number|object|null
+    visibleStartTime ? : string|number|VisibleStartTimeOptions|null
     /**
      * The week start day, 0 meaning Sunday, 6 meaning Saturday.
      * Defaults to [weekStartDay](https://bryntum.com/products/calendar/docs/api/Core/helper/DateHelper#property-weekStartDay-static).
@@ -1561,7 +1568,6 @@ const widgetData = {
         'bodyCls',
         'border',
         'bubbleEvents',
-        'centered',
         'collapsible',
         'color',
         'columnHeaderRenderer',
@@ -1660,6 +1666,7 @@ const widgetData = {
         'borderColor',
         'callOnFunctions',
         'catchEventHandlerExceptions',
+        'centered',
         'cls',
         'collapsed',
         'column',

package/src/components/BryntumDayAgendaViewProps.ts

@@ -1,4 +1,4 @@
-import type { ActionButtonsConfig, AlignSpec, Base, BryntumScrollOptions, ButtonConfig, CalendarMixinClass, CalendarRow, CalendarRowConfig, CalendarView, Color, ContainerItemConfig, ContainerLayoutConfig, DayAgendaViewListeners, DayCell, DayCellWithEvents, DomConfig, DurationConfig, EventBar, EventModel, KeyMapConfig, MaskConfig, MenuItemConfig, MenuItemEntry, OverflowPopupConfig, PagingToolbarConfig, PanelCollapserConfig, PanelCollapserOverlayConfig, PanelHeader, Rectangle, ResourceModel, Scroller, ScrollerConfig, StateProvider, TabConfig, ToolConfig, ToolbarConfig, ToolbarItems, TooltipConfig, Widget } from '@bryntum/calendar';
+import type { ActionButtonsConfig, AlignSpec, Base, BryntumScrollOptions, ButtonConfig, CalendarMixinClass, CalendarRow, CalendarRowConfig, CalendarView, Color, ContainerItemConfig, ContainerLayoutConfig, DayAgendaViewListeners, DayCell, DayCellWithEvents, DomConfig, DurationConfig, EventBar, EventModel, KeyMapConfig, MaskConfig, MenuItemConfig, MenuItemEntry, OverflowPopupConfig, PagingToolbarConfig, PanelCollapserConfig, PanelCollapserOverlayConfig, PanelHeader, Rectangle, ResourceModel, Scroller, ScrollerConfig, StateProvider, TabConfig, ToolConfig, ToolbarConfig, ToolbarItems, TooltipConfig, VisibleStartTimeOptions, Widget } from '@bryntum/calendar';
 import {  } from '@bryntum/calendar';
 
 export declare type BryntumDayAgendaViewProps = {
@@ -69,6 +69,8 @@ export declare type BryntumDayAgendaViewProps = {
     /**
      * 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/calendar/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/calendar/docs/api/Calendar/widget/DayAgendaView#config-appendTo)
      */
     appendTo ? : HTMLElement|string
     /**
@@ -133,9 +135,10 @@ export declare type BryntumDayAgendaViewProps = {
     catchEventHandlerExceptions ? : Boolean
     /**
      * *Only valid if this Widget is [floating](https://bryntum.com/products/calendar/docs/api/Core/widget/Widget#config-floating).*
-     * Set to `true` to centre the Widget in browser viewport space.
+     * [More...](https://bryntum.com/products/calendar/docs/api/Calendar/widget/DayAgendaView#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
@@ -353,7 +356,7 @@ export declare type BryntumDayAgendaViewProps = {
     dock ? : 'top'|'bottom'|'left'|'right'|'start'|'end'|'header'|'pre-header'|object
     /**
      * *Only valid if this Widget is [floating](https://bryntum.com/products/calendar/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/calendar/docs/api/Calendar/widget/DayAgendaView#config-draggable)
      * @property {string} handleSelector CSS selector used to determine if drag can be started from a mouse-downed element inside the widget
@@ -603,10 +606,14 @@ export declare type BryntumDayAgendaViewProps = {
     inputFieldAlign ? : 'start'|'end'
     /**
      * Element (or element id) to insert this widget before. If provided, [appendTo](https://bryntum.com/products/calendar/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/calendar/docs/api/Calendar/widget/DayAgendaView#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/calendar/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/calendar/docs/api/Calendar/widget/DayAgendaView#config-insertFirst)
      */
     insertFirst ? : HTMLElement|string
     /**
@@ -643,7 +650,7 @@ export declare type BryntumDayAgendaViewProps = {
      */
     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/calendar/docs/api/Calendar/widget/DayAgendaView#config-labelWidth)
      */
     labelWidth ? : number|null
@@ -894,7 +901,7 @@ export declare type BryntumDayAgendaViewProps = {
     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
     /**
@@ -1126,7 +1133,7 @@ export declare type BryntumDayAgendaViewProps = {
      * @property {number} [animate.duration] The number of milliseconds to animate over.
      * @property {string} [animate.easing] The name of an easing function.
      */
-    visibleStartTime ? : string|number|object|null
+    visibleStartTime ? : string|number|VisibleStartTimeOptions|null
     /**
      * The week start day, 0 meaning Sunday, 6 meaning Saturday.
      * Defaults to [weekStartDay](https://bryntum.com/products/calendar/docs/api/Core/helper/DateHelper#property-weekStartDay-static).

package/src/components/BryntumDayResourceView.vue

@@ -10,7 +10,7 @@
 
 import { getCurrentInstance, onBeforeUnmount, onMounted, provide, ref, watch, toRaw } from 'vue';
 
-import type { ActionButtonsConfig, AlignSpec, Base, BryntumScrollOptions, ButtonConfig, CalendarMixinClass, CalendarRow, CalendarRowConfig, CalendarView, Color, Container, ContainerItemConfig, ContainerLayoutConfig, DateRangeOwner, DayCell, DayCellWithEvents, DayResourceViewListeners, DayView, DomConfig, DurationConfig, EventBar, EventModel, FluidDayLayoutConfig, KeyMapConfig, MaskConfig, MenuItemConfig, MenuItemEntry, Model, OverflowPopupConfig, PagingToolbarConfig, Panel, PanelCollapserConfig, PanelCollapserOverlayConfig, PanelHeader, Rectangle, ResourceModel, Scroller, ScrollerConfig, StateProvider, TabConfig, Tool, ToolConfig, ToolbarConfig, ToolbarItems, TooltipConfig, Widget } from '@bryntum/calendar';
+import type { ActionButtonsConfig, AlignSpec, Base, BryntumScrollOptions, ButtonConfig, CalendarMixinClass, CalendarRow, CalendarRowConfig, CalendarView, Color, Container, ContainerItemConfig, ContainerLayoutConfig, DateRangeOwner, DayCell, DayCellWithEvents, DayResourceViewListeners, DayView, DomConfig, DurationConfig, EventBar, EventModel, FluidDayLayoutConfig, KeyMapConfig, MaskConfig, MenuItemConfig, MenuItemEntry, Model, OverflowPopupConfig, PagingToolbarConfig, Panel, PanelCollapserConfig, PanelCollapserOverlayConfig, PanelHeader, Rectangle, ResourceModel, Scroller, ScrollerConfig, StateProvider, TabConfig, Tool, ToolConfig, ToolbarConfig, ToolbarItems, TooltipConfig, VisibleStartTimeOptions, Widget } from '@bryntum/calendar';
 import { DayResourceView } from '@bryntum/calendar';
 
 import { WrapperHelper } from '../helper/WrapperHelper';
@@ -83,6 +83,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/calendar/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/calendar/docs/api/Calendar/widget/DayResourceView#config-appendTo)
      */
     appendTo ? : HTMLElement|string
     /**
@@ -143,9 +145,10 @@ defineProps<{
     catchEventHandlerExceptions ? : Boolean
     /**
      * *Only valid if this Widget is [floating](https://bryntum.com/products/calendar/docs/api/Core/widget/Widget#config-floating).*
-     * Set to `true` to centre the Widget in browser viewport space.
+     * [More...](https://bryntum.com/products/calendar/docs/api/Calendar/widget/DayResourceView#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
@@ -363,7 +366,7 @@ defineProps<{
     dock ? : 'top'|'bottom'|'left'|'right'|'start'|'end'|'header'|'pre-header'|object
     /**
      * *Only valid if this Widget is [floating](https://bryntum.com/products/calendar/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/calendar/docs/api/Calendar/widget/DayResourceView#config-draggable)
      * @property {string} handleSelector CSS selector used to determine if drag can be started from a mouse-downed element inside the widget
@@ -621,10 +624,14 @@ defineProps<{
     inputFieldAlign ? : 'start'|'end'
     /**
      * Element (or element id) to insert this widget before. If provided, [appendTo](https://bryntum.com/products/calendar/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/calendar/docs/api/Calendar/widget/DayResourceView#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/calendar/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/calendar/docs/api/Calendar/widget/DayResourceView#config-insertFirst)
      */
     insertFirst ? : HTMLElement|string
     /**
@@ -661,7 +668,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/calendar/docs/api/Calendar/widget/DayResourceView#config-labelWidth)
      */
     labelWidth ? : number|null
@@ -921,7 +928,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
     /**
@@ -1190,7 +1197,7 @@ defineProps<{
      * @property {number} [animate.duration] The number of milliseconds to animate over.
      * @property {string} [animate.easing] The name of an easing function.
      */
-    visibleStartTime ? : string|number|object|null
+    visibleStartTime ? : string|number|VisibleStartTimeOptions|null
     /**
      * The week start day, 0 meaning Sunday, 6 meaning Saturday.
      * Defaults to [weekStartDay](https://bryntum.com/products/calendar/docs/api/Core/helper/DateHelper#property-weekStartDay-static).
@@ -1618,7 +1625,6 @@ const widgetData = {
         'bodyCls',
         'border',
         'bubbleEvents',
-        'centered',
         'collapsible',
         'color',
         'columnHeaderRenderer',
@@ -1722,6 +1728,7 @@ const widgetData = {
         'autoCreate',
         'callOnFunctions',
         'catchEventHandlerExceptions',
+        'centered',
         'cls',
         'collapsed',
         'column',

package/src/components/BryntumDayResourceViewProps.ts

@@ -1,4 +1,4 @@
-import type { ActionButtonsConfig, AlignSpec, Base, BryntumScrollOptions, ButtonConfig, CalendarMixinClass, CalendarRow, CalendarRowConfig, CalendarView, Color, ContainerItemConfig, ContainerLayoutConfig, DayCell, DayCellWithEvents, DayResourceViewListeners, DomConfig, DurationConfig, EventBar, EventModel, FluidDayLayoutConfig, KeyMapConfig, MaskConfig, MenuItemConfig, MenuItemEntry, OverflowPopupConfig, PagingToolbarConfig, PanelCollapserConfig, PanelCollapserOverlayConfig, PanelHeader, Rectangle, ResourceModel, Scroller, ScrollerConfig, StateProvider, TabConfig, ToolConfig, ToolbarConfig, ToolbarItems, TooltipConfig, Widget } from '@bryntum/calendar';
+import type { ActionButtonsConfig, AlignSpec, Base, BryntumScrollOptions, ButtonConfig, CalendarMixinClass, CalendarRow, CalendarRowConfig, CalendarView, Color, ContainerItemConfig, ContainerLayoutConfig, DayCell, DayCellWithEvents, DayResourceViewListeners, DomConfig, DurationConfig, EventBar, EventModel, FluidDayLayoutConfig, KeyMapConfig, MaskConfig, MenuItemConfig, MenuItemEntry, OverflowPopupConfig, PagingToolbarConfig, PanelCollapserConfig, PanelCollapserOverlayConfig, PanelHeader, Rectangle, ResourceModel, Scroller, ScrollerConfig, StateProvider, TabConfig, ToolConfig, ToolbarConfig, ToolbarItems, TooltipConfig, VisibleStartTimeOptions, Widget } from '@bryntum/calendar';
 import {  } from '@bryntum/calendar';
 
 export declare type BryntumDayResourceViewProps = {
@@ -69,6 +69,8 @@ export declare type BryntumDayResourceViewProps = {
     /**
      * 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/calendar/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/calendar/docs/api/Calendar/widget/DayResourceView#config-appendTo)
      */
     appendTo ? : HTMLElement|string
     /**
@@ -129,9 +131,10 @@ export declare type BryntumDayResourceViewProps = {
     catchEventHandlerExceptions ? : Boolean
     /**
      * *Only valid if this Widget is [floating](https://bryntum.com/products/calendar/docs/api/Core/widget/Widget#config-floating).*
-     * Set to `true` to centre the Widget in browser viewport space.
+     * [More...](https://bryntum.com/products/calendar/docs/api/Calendar/widget/DayResourceView#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
@@ -349,7 +352,7 @@ export declare type BryntumDayResourceViewProps = {
     dock ? : 'top'|'bottom'|'left'|'right'|'start'|'end'|'header'|'pre-header'|object
     /**
      * *Only valid if this Widget is [floating](https://bryntum.com/products/calendar/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/calendar/docs/api/Calendar/widget/DayResourceView#config-draggable)
      * @property {string} handleSelector CSS selector used to determine if drag can be started from a mouse-downed element inside the widget
@@ -607,10 +610,14 @@ export declare type BryntumDayResourceViewProps = {
     inputFieldAlign ? : 'start'|'end'
     /**
      * Element (or element id) to insert this widget before. If provided, [appendTo](https://bryntum.com/products/calendar/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/calendar/docs/api/Calendar/widget/DayResourceView#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/calendar/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/calendar/docs/api/Calendar/widget/DayResourceView#config-insertFirst)
      */
     insertFirst ? : HTMLElement|string
     /**
@@ -647,7 +654,7 @@ export declare type BryntumDayResourceViewProps = {
      */
     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/calendar/docs/api/Calendar/widget/DayResourceView#config-labelWidth)
      */
     labelWidth ? : number|null
@@ -907,7 +914,7 @@ export declare type BryntumDayResourceViewProps = {
     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
     /**
@@ -1176,7 +1183,7 @@ export declare type BryntumDayResourceViewProps = {
      * @property {number} [animate.duration] The number of milliseconds to animate over.
      * @property {string} [animate.easing] The name of an easing function.
      */
-    visibleStartTime ? : string|number|object|null
+    visibleStartTime ? : string|number|VisibleStartTimeOptions|null
     /**
      * The week start day, 0 meaning Sunday, 6 meaning Saturday.
      * Defaults to [weekStartDay](https://bryntum.com/products/calendar/docs/api/Core/helper/DateHelper#property-weekStartDay-static).

package/src/components/BryntumDayView.vue

@@ -10,7 +10,7 @@
 
 import { getCurrentInstance, onBeforeUnmount, onMounted, provide, ref, watch, toRaw } from 'vue';
 
-import type { ActionButtonsConfig, AlignSpec, Base, BryntumScrollOptions, ButtonConfig, CalendarMixinClass, CalendarRow, CalendarRowConfig, CalendarView, Color, Container, ContainerItemConfig, ContainerLayoutConfig, DateRangeOwner, DayCell, DayCellWithEvents, DayViewListeners, DomConfig, DurationConfig, EventBar, EventModel, FluidDayLayoutConfig, KeyMapConfig, MaskConfig, MenuItemConfig, MenuItemEntry, Model, OverflowPopupConfig, PagingToolbarConfig, Panel, PanelCollapserConfig, PanelCollapserOverlayConfig, PanelHeader, Rectangle, ResourceModel, Scroller, ScrollerConfig, StateProvider, TabConfig, Tool, ToolConfig, ToolbarConfig, ToolbarItems, TooltipConfig, Widget } from '@bryntum/calendar';
+import type { ActionButtonsConfig, AlignSpec, Base, BryntumScrollOptions, ButtonConfig, CalendarMixinClass, CalendarRow, CalendarRowConfig, CalendarView, Color, Container, ContainerItemConfig, ContainerLayoutConfig, DateRangeOwner, DayCell, DayCellWithEvents, DayViewListeners, DomConfig, DurationConfig, EventBar, EventModel, FluidDayLayoutConfig, KeyMapConfig, MaskConfig, MenuItemConfig, MenuItemEntry, Model, OverflowPopupConfig, PagingToolbarConfig, Panel, PanelCollapserConfig, PanelCollapserOverlayConfig, PanelHeader, Rectangle, ResourceModel, Scroller, ScrollerConfig, StateProvider, TabConfig, Tool, ToolConfig, ToolbarConfig, ToolbarItems, TooltipConfig, VisibleStartTimeOptions, Widget } from '@bryntum/calendar';
 import { DayView } from '@bryntum/calendar';
 
 import { WrapperHelper } from '../helper/WrapperHelper';
@@ -83,6 +83,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/calendar/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/calendar/docs/api/Calendar/widget/DayView#config-appendTo)
      */
     appendTo ? : HTMLElement|string
     /**
@@ -143,9 +145,10 @@ defineProps<{
     catchEventHandlerExceptions ? : Boolean
     /**
      * *Only valid if this Widget is [floating](https://bryntum.com/products/calendar/docs/api/Core/widget/Widget#config-floating).*
-     * Set to `true` to centre the Widget in browser viewport space.
+     * [More...](https://bryntum.com/products/calendar/docs/api/Calendar/widget/DayView#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
@@ -363,7 +366,7 @@ defineProps<{
     dock ? : 'top'|'bottom'|'left'|'right'|'start'|'end'|'header'|'pre-header'|object
     /**
      * *Only valid if this Widget is [floating](https://bryntum.com/products/calendar/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/calendar/docs/api/Calendar/widget/DayView#config-draggable)
      * @property {string} handleSelector CSS selector used to determine if drag can be started from a mouse-downed element inside the widget
@@ -610,10 +613,14 @@ defineProps<{
     inputFieldAlign ? : 'start'|'end'
     /**
      * Element (or element id) to insert this widget before. If provided, [appendTo](https://bryntum.com/products/calendar/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/calendar/docs/api/Calendar/widget/DayView#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/calendar/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/calendar/docs/api/Calendar/widget/DayView#config-insertFirst)
      */
     insertFirst ? : HTMLElement|string
     /**
@@ -650,7 +657,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/calendar/docs/api/Calendar/widget/DayView#config-labelWidth)
      */
     labelWidth ? : number|null
@@ -897,7 +904,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
     /**
@@ -1155,7 +1162,7 @@ defineProps<{
      * @property {number} [animate.duration] The number of milliseconds to animate over.
      * @property {string} [animate.easing] The name of an easing function.
      */
-    visibleStartTime ? : string|number|object|null
+    visibleStartTime ? : string|number|VisibleStartTimeOptions|null
     /**
      * The week start day, 0 meaning Sunday, 6 meaning Saturday.
      * Defaults to [weekStartDay](https://bryntum.com/products/calendar/docs/api/Core/helper/DateHelper#property-weekStartDay-static).
@@ -1583,7 +1590,6 @@ const widgetData = {
         'bodyCls',
         'border',
         'bubbleEvents',
-        'centered',
         'collapsible',
         'color',
         'columnHeaderRenderer',
@@ -1686,6 +1692,7 @@ const widgetData = {
         'autoCreate',
         'callOnFunctions',
         'catchEventHandlerExceptions',
+        'centered',
         'cls',
         'collapsed',
         'column',