@bryntum/calendar-vue-3 7.2.3 → 7.3.0

package/src/components/BryntumYearView.vue

@@ -10,7 +10,7 @@
 
 import { getCurrentInstance, onBeforeUnmount, onMounted, provide, ref, watch, toRaw } from 'vue';
 
-import type { AlignSpec, Base, BryntumScrollOptions, ButtonConfig, CalendarView, Color, Container, ContainerItemConfig, ContainerLayoutConfig, DayCell, DomConfig, EventBar, EventModel, KeyMapConfig, MaskConfig, MenuItemConfig, MenuItemEntry, Model, OverflowPopup, OverflowPopupConfig, PagingToolbarConfig, Panel, PanelCollapserConfig, PanelCollapserOverlayConfig, PanelHeader, Rectangle, ResourceModel, Scroller, ScrollerConfig, StateProvider, TabConfig, Tool, ToolConfig, ToolbarConfig, ToolbarItems, TooltipConfig, Widget, YearCell, YearViewListeners } from '@bryntum/calendar';
+import type { AlignSpec, Base, BryntumScrollOptions, ButtonConfig, CalendarMixinClass, CalendarView, Color, Container, ContainerItemConfig, ContainerLayoutConfig, DayCell, DomConfig, DurationConfig, EventBar, EventModel, KeyMapConfig, MaskConfig, MenuItemConfig, MenuItemEntry, Model, OverflowPopup, OverflowPopupConfig, PagingToolbarConfig, Panel, PanelCollapserConfig, PanelCollapserOverlayConfig, PanelHeader, Rectangle, ResourceModel, Scroller, ScrollerConfig, StateProvider, TabConfig, Tool, ToolConfig, ToolbarConfig, ToolbarItems, TooltipConfig, Widget, YearCell, YearViewListeners } from '@bryntum/calendar';
 import { YearView } from '@bryntum/calendar';
 
 import { WrapperHelper } from '../helper/WrapperHelper';
@@ -19,21 +19,18 @@ defineProps<{
     // Configs
     /**
      * A key to use to activate this view.
-     * ...
-     * [View online docs...](https://bryntum.com/products/calendar/docs/api/Calendar/widget/YearView#config-activationKey)
+     * [More...](https://bryntum.com/products/calendar/docs/api/Calendar/widget/YearView#config-activationKey)
      */
     activationKey ? : string
     /**
      * Element (or element id) to adopt as this Widget's encapsulating element. The widget's
      * content will be placed inside this element.
-     * ...
-     * [View online docs...](https://bryntum.com/products/calendar/docs/api/Calendar/widget/YearView#config-adopt)
+     * [More...](https://bryntum.com/products/calendar/docs/api/Calendar/widget/YearView#config-adopt)
      */
     adopt ? : HTMLElement|string
     /**
      * *Only valid if this Widget is [floating](https://bryntum.com/products/calendar/docs/api/Core/widget/Widget#config-floating).*
-     * ...
-     * [View online docs...](https://bryntum.com/products/calendar/docs/api/Calendar/widget/YearView#config-align)
+     * [More...](https://bryntum.com/products/calendar/docs/api/Calendar/widget/YearView#config-align)
      */
     align ? : AlignSpec|string
     /**
@@ -62,8 +59,7 @@ defineProps<{
     /**
      * By default, when navigating through time, the next time
      * block will be animated in from the appropriate direction.
-     * ...
-     * [View online docs...](https://bryntum.com/products/calendar/docs/api/Calendar/widget/YearView#config-animateTimeShift)
+     * [More...](https://bryntum.com/products/calendar/docs/api/Calendar/widget/YearView#config-animateTimeShift)
      */
     animateTimeShift ? : Boolean
     /**
@@ -74,42 +70,36 @@ defineProps<{
     /**
      * A localizable string (May contain `'L{}'` tokens which resolve in the locale file) to inject
      * into an element which will be linked using the `aria-describedby` attribute.
-     * ...
-     * [View online docs...](https://bryntum.com/products/calendar/docs/api/Calendar/widget/YearView#config-ariaDescription)
+     * [More...](https://bryntum.com/products/calendar/docs/api/Calendar/widget/YearView#config-ariaDescription)
      */
     ariaDescription ? : string
     /**
      * A localizable string (May contain `'L{}'` tokens which resolve in the locale file) to inject as
      * the `aria-label` attribute.
-     * ...
-     * [View online docs...](https://bryntum.com/products/calendar/docs/api/Calendar/widget/YearView#config-ariaLabel)
+     * [More...](https://bryntum.com/products/calendar/docs/api/Calendar/widget/YearView#config-ariaLabel)
      */
     ariaLabel ? : string
     /**
      * If this config is set, then the `gesture` configured (which defaults to `dblclick`) creates a
      * new event at the mouse or touch event's time point.
-     * ...
-     * [View online docs...](https://bryntum.com/products/calendar/docs/api/Calendar/widget/YearView#config-autoCreate)
-     */
-    autoCreate ? : {
-        gesture?: string
-        newName?: Function|string
-        step?: string
-        snapType?: 'round'|'ceil'|'floor'
-        duration?: string
-        startHour?: number
-    }|string|Boolean
+     * [More...](https://bryntum.com/products/calendar/docs/api/Calendar/widget/YearView#config-autoCreate)
+     * @property {string} [gesture] The DOM event name which initiates event creation at the event's position.
+     * @property {Function,string} [newName] The name of an event created using `autoCreate` or a function to call which yields the name. When a function is specified, the following parameters are passed:  * <span class="name">view : <span class="type">CalendarMixin</span></span><div class="description">The view in which the event is being created.</div> * <span class="name">startDate : <span class="type">String</span></span><div class="description">The start date of the event being created.</div> * <span class="name">resourceRecord : <span class="type">ResourceModel</span></span><div class="description">The resource of the event being created.</div>
+     * @property {string} [step] The time unit by which to snap the start click point of auto created events. <strong>Only for views which have a granularity of less than one day such as `WeekView` and `DayView`</strong>. For views which show whole days, the start defaults to 8am. This is a string in the format required by [parseDuration](https://bryntum.com/products/calendar/docs/api/Core/helper/DateHelper#function-parseDuration-static). This value is also used for the [step](https://bryntum.com/products/calendar/docs/api/Core/widget/TimeField#property-step) value in the [EventEdit](https://bryntum.com/products/calendar/docs/api/Calendar/feature/EventEdit)'s time input field.
+     * @property {'round','ceil','floor'} [snapType] How to snap a precise gesture time to a boundary specified by the `step` property. <strong>Only for views which have a granularity of less than one day such as `WeekView` and `DayView`</strong>.
+     * @property {string} [duration] The default start hour for auto created events in the form accepted by [parseDuration](https://bryntum.com/products/calendar/docs/api/Core/helper/DateHelper#function-parseDuration-static)
+     * @property {number} [startHour] The default start hour for auto created events in views where the time granularity is one day. In a `DayView` or `WeekView` where a mouse event position will translate to a time of day, this is not used. This is the hour of the day to start the event at. It may be fractional.
+     */
+    autoCreate ? : object|string|Boolean
     /**
      * A Config object representing the configuration of a [Toolbar](https://bryntum.com/products/calendar/docs/api/Core/widget/Toolbar),
      * or array of config objects representing the child items of a Toolbar. Another way to add a bbar is to use [strips](https://bryntum.com/products/calendar/docs/api/Core/widget/Panel#config-strips).
-     * ...
-     * [View online docs...](https://bryntum.com/products/calendar/docs/api/Calendar/widget/YearView#config-bbar)
+     * [More...](https://bryntum.com/products/calendar/docs/api/Calendar/widget/YearView#config-bbar)
      */
     bbar ? : (ContainerItemConfig|string)[]|ToolbarConfig|PagingToolbarConfig|null
     /**
      * Custom CSS classes to add to the panel's body element.
-     * ...
-     * [View online docs...](https://bryntum.com/products/calendar/docs/api/Calendar/widget/YearView#config-bodyCls)
+     * [More...](https://bryntum.com/products/calendar/docs/api/Calendar/widget/YearView#config-bodyCls)
      */
     bodyCls ? : string|object
     /**
@@ -119,21 +109,18 @@ defineProps<{
     /**
      * An object where property names with a truthy value indicate which events should bubble up the ownership
      * hierarchy when triggered.
-     * ...
-     * [View online docs...](https://bryntum.com/products/calendar/docs/api/Calendar/widget/YearView#config-bubbleEvents)
+     * [More...](https://bryntum.com/products/calendar/docs/api/Calendar/widget/YearView#config-bubbleEvents)
      */
     bubbleEvents ? : object
     /**
      * Set to `false` to not call onXXX method names (e.g. `onShow`, `onClick`), as an easy way to listen for events.
-     * ...
-     * [View online docs...](https://bryntum.com/products/calendar/docs/api/Calendar/widget/YearView#config-callOnFunctions)
+     * [More...](https://bryntum.com/products/calendar/docs/api/Calendar/widget/YearView#config-callOnFunctions)
      */
     callOnFunctions ? : Boolean
     /**
      * By default, if an event handler throws an exception, the error propagates up the stack and the
      * application state is undefined. Code which follows the event handler will *not* be executed.
-     * ...
-     * [View online docs...](https://bryntum.com/products/calendar/docs/api/Calendar/widget/YearView#config-catchEventHandlerExceptions)
+     * [More...](https://bryntum.com/products/calendar/docs/api/Calendar/widget/YearView#config-catchEventHandlerExceptions)
      */
     catchEventHandlerExceptions ? : Boolean
     /**
@@ -145,8 +132,7 @@ defineProps<{
      * Custom CSS classes to add to element.
      * May be specified as a space separated string, or as an object in which property names
      * with truthy values are used as the class names:
-     * ...
-     * [View online docs...](https://bryntum.com/products/calendar/docs/api/Calendar/widget/YearView#config-cls)
+     * [More...](https://bryntum.com/products/calendar/docs/api/Calendar/widget/YearView#config-cls)
      */
     cls ? : string|object
     /**
@@ -156,15 +142,13 @@ defineProps<{
     collapsed ? : Boolean
     /**
      * This config enables collapsibility for the panel. See [collapsed](https://bryntum.com/products/calendar/docs/api/Core/widget/Panel#config-collapsed).
-     * ...
-     * [View online docs...](https://bryntum.com/products/calendar/docs/api/Calendar/widget/YearView#config-collapsible)
+     * [More...](https://bryntum.com/products/calendar/docs/api/Calendar/widget/YearView#config-collapsible)
      */
     collapsible ? : Boolean|PanelCollapserConfig|PanelCollapserOverlayConfig
     /**
      * Applies the specified color to the widget, by setting the `--b-primary` CSS variable in the widgets
      * `style` block.
-     * ...
-     * [View online docs...](https://bryntum.com/products/calendar/docs/api/Calendar/widget/YearView#config-color)
+     * [More...](https://bryntum.com/products/calendar/docs/api/Calendar/widget/YearView#config-color)
      */
     color ? : Color
     /**
@@ -181,8 +165,7 @@ defineProps<{
      * Custom CSS classes to add to the [contentElement](https://bryntum.com/products/calendar/docs/api/Core/widget/Widget#property-contentElement).
      * May be specified as a space separated string, or as an object in which property names
      * with truthy values are used as the class names:
-     * ...
-     * [View online docs...](https://bryntum.com/products/calendar/docs/api/Calendar/widget/YearView#config-contentElementCls)
+     * [More...](https://bryntum.com/products/calendar/docs/api/Calendar/widget/YearView#config-contentElementCls)
      */
     contentElementCls ? : string|object
     /**
@@ -219,8 +202,7 @@ defineProps<{
     dayCellNameFormat ? : string|((date: Date) => string)
     /**
      * An empty function by default, but provided so that you can override it.
-     * ...
-     * [View online docs...](https://bryntum.com/products/calendar/docs/api/Calendar/widget/YearView#config-dayCellRenderer)
+     * [More...](https://bryntum.com/products/calendar/docs/api/Calendar/widget/YearView#config-dayCellRenderer)
      * @param {YearCell} cellData A `DayCell` object that contains data about the cell.
      * @returns {DomConfig,string,void}
      */
@@ -233,8 +215,7 @@ defineProps<{
     /**
      * A [query](https://bryntum.com/products/calendar/docs/api/Core/widget/Container#function-query) selector function which can identify the descendant widget to which
      * focus should be directed by default.
-     * ...
-     * [View online docs...](https://bryntum.com/products/calendar/docs/api/Calendar/widget/YearView#config-defaultFocus)
+     * [More...](https://bryntum.com/products/calendar/docs/api/Calendar/widget/YearView#config-defaultFocus)
      * @param {Core.widget.Widget} widget Widget passed to method
      * @returns {boolean} truthy value if widget is the default one
      */
@@ -245,40 +226,36 @@ defineProps<{
     defaults ? : ContainerItemConfig
     /**
      * Options to add into scroll options when the [scrollTo](https://bryntum.com/products/calendar/docs/api/Calendar/widget/mixin/CalendarMixin#function-scrollTo) method is called.
-     * ...
-     * [View online docs...](https://bryntum.com/products/calendar/docs/api/Calendar/widget/YearView#config-defaultScrollOptions)
+     * [More...](https://bryntum.com/products/calendar/docs/api/Calendar/widget/YearView#config-defaultScrollOptions)
      */
     defaultScrollOptions ? : BryntumScrollOptions
     /**
      * The date format used by the default [descriptionRenderer](https://bryntum.com/products/calendar/docs/api/Scheduler/view/mixin/Describable#config-descriptionRenderer) for rendering the view's description.
      * If this value is `null`, the [dateFormat](https://bryntum.com/products/calendar/docs/api/Scheduler/view/mixin/Describable#config-dateFormat) (and potentially [dateSeparator](#Scheduler/view/mixin/Describable#config-dateSeparator)) will
      * be used.
-     * ...
-     * [View online docs...](https://bryntum.com/products/calendar/docs/api/Calendar/widget/YearView#config-descriptionFormat)
+     * [More...](https://bryntum.com/products/calendar/docs/api/Calendar/widget/YearView#config-descriptionFormat)
      * @param {Date} date The date to format.
      * @returns {string} The formatted date.
      */
-    descriptionFormat ? : string|string[]|Boolean[]|((date: Date) => string)|Function[]
+    descriptionFormat ? : string|string[]|Boolean[]|((date: Date) => string)|(((date: Date) => string)[])
     /**
      * A function that provides the textual description for this view. If provided, this function overrides the
      * [descriptionFormat](https://bryntum.com/products/calendar/docs/api/Scheduler/view/mixin/Describable#config-descriptionFormat).
-     * ...
-     * [View online docs...](https://bryntum.com/products/calendar/docs/api/Calendar/widget/YearView#config-descriptionRenderer)
+     * [More...](https://bryntum.com/products/calendar/docs/api/Calendar/widget/YearView#config-descriptionRenderer)
      * @param {Core.widget.Widget} view The active view in case the function is in another scope.
      * @returns {string} Description string
      */
     descriptionRenderer ? : (view: Widget) => string
     /**
-     * Check for CSS compatibility issues when upgrading to v7. Performs the following checks:
-     * ...
-     * [View online docs...](https://bryntum.com/products/calendar/docs/api/Calendar/widget/YearView#config-detectCSSCompatibilityIssues)
+     * Check for CSS compatibility and inclusion related issues and try to auto fix them. Performs the following
+     * checks:
+     * [More...](https://bryntum.com/products/calendar/docs/api/Calendar/widget/YearView#config-detectCSSCompatibilityIssues)
      */
     detectCSSCompatibilityIssues ? : Boolean
     /**
      * Disable or enable the widget. It is similar to [readOnly](https://bryntum.com/products/calendar/docs/api/Core/widget/Widget#config-readOnly) except a disabled widget
      * cannot be focused, uses a different rendition (usually greyish) and does not allow selecting its value.
-     * ...
-     * [View online docs...](https://bryntum.com/products/calendar/docs/api/Calendar/widget/YearView#config-disabled)
+     * [More...](https://bryntum.com/products/calendar/docs/api/Calendar/widget/YearView#config-disabled)
      */
     disabled ? : Boolean|'inert'
     /**
@@ -286,53 +263,46 @@ defineProps<{
      * [strips collection](https://bryntum.com/products/calendar/docs/api/Core/widget/Panel#config-strips). Typical values for this config are `'top'`,
      * `'bottom'`, `'left'`, or `'right'`, which cause the widget to be placed on that side of the panel's
      * body. Such widgets are called "edge strips".
-     * ...
-     * [View online docs...](https://bryntum.com/products/calendar/docs/api/Calendar/widget/YearView#config-dock)
+     * [More...](https://bryntum.com/products/calendar/docs/api/Calendar/widget/YearView#config-dock)
      */
     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´
      * property which controls when a drag should start.
-     * ...
-     * [View online docs...](https://bryntum.com/products/calendar/docs/api/Calendar/widget/YearView#config-draggable)
+     * [More...](https://bryntum.com/products/calendar/docs/api/Calendar/widget/YearView#config-draggable)
+     * @property {string} handleSelector CSS selector used to determine if drag can be started from a mouse-downed element inside the widget
      */
-    draggable ? : Boolean|{
-        handleSelector?: string
-    }
+    draggable ? : Boolean|object
     /**
      * The [durationUnit](https://bryntum.com/products/calendar/docs/api/Scheduler/model/EventModel#field-durationUnit) to use when drag-creating events
      * in this view.
-     * ...
-     * [View online docs...](https://bryntum.com/products/calendar/docs/api/Calendar/widget/YearView#config-dragUnit)
+     * [More...](https://bryntum.com/products/calendar/docs/api/Calendar/widget/YearView#config-dragUnit)
      */
     dragUnit ? : string
     /**
      * Make this Panel a docked drawer which slides out from one side of the browser viewport by default.
-     * ...
-     * [View online docs...](https://bryntum.com/products/calendar/docs/api/Calendar/widget/YearView#config-drawer)
-     * @param {'start','left','end','right','top','bottom'} side The side of the viewport to dock the drawer to.  * `'start'` means the `inline-start` side. * `'end'` means the `inline-end` side.
-     * @param {string,number} size The size of the drawer in its collapsible axis.
-     * @param {boolean} inline If using the [appendTo](https://bryntum.com/products/calendar/docs/api/Core/widget/Panel#config-appendTo) config to place the drawer inside a host widget, this may be set to `true` to make the drawer inline within that host. Note that, if using this, the layout of the host element must have `flex-direction` set appropriately.
-     * @param {boolean,object} autoClose Specifies what user actions should automatically close the drawer. Defaults to closing when the user clicks outside of the drawer or when focus moves outside of the drawer.
-     * @param {boolean,string} autoClose.mousedown If the user clicks outside of the drawer, the drawer will automatically be hidden. If the value is a string, it is used as a CSS selector to filter clicks which should close the drawer.
-     * @param {boolean,string} autoClose.focusout If focus moves outside of the drawer, the drawer will automatically be hidden.
-     * @param {string} autoClose.mouseout Hides the drawer when the mouse leaves the drawer after the `autoCloseDelay` period.
-     * @param {number} autoCloseDelay When using `mouseout`, this is the delay in milliseconds
-     */
-    drawer ? : Boolean|{side?: 'start'|'left'|'end'|'right'|'top'|'bottom', size?: string|number, inline?: Boolean, autoClose: { mousedown?: Boolean|string, focusout?: Boolean|string, mouseout?: string }, autoCloseDelay?: number}
+     * [More...](https://bryntum.com/products/calendar/docs/api/Calendar/widget/YearView#config-drawer)
+     * @param {'start','left','end','right','top','bottom'} [side] The side of the viewport to dock the drawer to.  * `'start'` means the `inline-start` side. * `'end'` means the `inline-end` side.
+     * @param {string,number} [size] The size of the drawer in its collapsible axis.
+     * @param {boolean} [inline] If using the [appendTo](https://bryntum.com/products/calendar/docs/api/Core/widget/Panel#config-appendTo) config to place the drawer inside a host widget, this may be set to `true` to make the drawer inline within that host. Note that, if using this, the layout of the host element must have `flex-direction` set appropriately.
+     * @param {boolean,object} [autoClose] Specifies what user actions should automatically close the drawer. Defaults to closing when the user clicks outside of the drawer or when focus moves outside of the drawer.
+     * @param {boolean,string} [autoClose.mousedown] If the user clicks outside of the drawer, the drawer will automatically be hidden. If the value is a string, it is used as a CSS selector to filter clicks which should close the drawer.
+     * @param {boolean,string} [autoClose.focusout] If focus moves outside of the drawer, the drawer will automatically be hidden.
+     * @param {string} [autoClose.mouseout] Hides the drawer when the mouse leaves the drawer after the `autoCloseDelay` period.
+     * @param {number} [autoCloseDelay] When using `mouseout`, this is the delay in milliseconds
+     */
+    drawer ? : Boolean|{ side?: 'start'|'left'|'end'|'right'|'top'|'bottom', size?: string|number, inline?: Boolean, autoClose?: Boolean|{ mousedown?: Boolean|string, focusout?: Boolean|string, mouseout?: string }, autoCloseDelay?: number }
     /**
      * An object specifying attributes to assign to the root element of this widget.
      * Set `null` value to attribute to remove it.
-     * ...
-     * [View online docs...](https://bryntum.com/products/calendar/docs/api/Calendar/widget/YearView#config-elementAttributes)
+     * [More...](https://bryntum.com/products/calendar/docs/api/Calendar/widget/YearView#config-elementAttributes)
      */
     elementAttributes ? : Record<string, string|null>
     /**
      * A [DomConfig](https://bryntum.com/products/calendar/docs/api/Core/helper/DomHelper#typedef-DomConfig) object which will be used to create the content of a clickable
      * element which is present when no events are in a cell.
-     * ...
-     * [View online docs...](https://bryntum.com/products/calendar/docs/api/Calendar/widget/YearView#config-emptyCellRenderer)
+     * [More...](https://bryntum.com/products/calendar/docs/api/Calendar/widget/YearView#config-emptyCellRenderer)
      * @param {DayCell} dayCellRenderer A `DayCell` object that contains data about the cell.
      * @returns {DomConfig,void} DomConfig object representing the HTML markup
      */
@@ -341,23 +311,20 @@ defineProps<{
      * When [overflowPopupTrigger](https://bryntum.com/products/calendar/docs/api/Calendar/widget/YearView#config-overflowPopupTrigger) is not a mouseover gesture, setting this to
      * a truthy value means that a tooltip containing the event count will be shown on hover of
      * a day cell.
-     * ...
-     * [View online docs...](https://bryntum.com/products/calendar/docs/api/Calendar/widget/YearView#config-eventCountTip)
+     * [More...](https://bryntum.com/products/calendar/docs/api/Calendar/widget/YearView#config-eventCountTip)
      */
     eventCountTip ? : Boolean|Record<string, Boolean|string>
     /**
      * When [showEvents](https://bryntum.com/products/calendar/docs/api/Calendar/widget/YearView#config-showEvents) is `'dots'`, this controls the layout of the dots
      * below the day number.
-     * ...
-     * [View online docs...](https://bryntum.com/products/calendar/docs/api/Calendar/widget/YearView#config-eventDots)
+     * [More...](https://bryntum.com/products/calendar/docs/api/Calendar/widget/YearView#config-eventDots)
+     * @property {number} marginTop The margin above the dots. Default is 4.
+     * @property {number} max The maximum number of dots to show. Default is 4.
+     * @property {number} gap The gap between dots. Default is 3.
+     * @property {number} size The size of the dots. Default is 5.
+     * @property {boolean} stripe If `true`, the dots will be striped, meaning they will be joined together with *no gap* between them and rounded at each end. Default is `false`.
      */
-    eventDots ? : {
-        marginTop?: number
-        max?: number
-        gap?: number
-        size?: number
-        stripe?: Boolean
-    }
+    eventDots ? : object
     /**
      * A function, or the name of a function in the ownership hierarchy to filter which events
      * are collected into the day cell data blocks.
@@ -369,8 +336,7 @@ defineProps<{
     /**
      * A function, or the name of a function in the ownership hierarchy which you
      * can specify to customize event DOM content.
-     * ...
-     * [View online docs...](https://bryntum.com/products/calendar/docs/api/Calendar/widget/YearView#config-eventHeaderRenderer)
+     * [More...](https://bryntum.com/products/calendar/docs/api/Calendar/widget/YearView#config-eventHeaderRenderer)
      * @param {object} detail An object that contains data about the event being rendered
      * @param {CalendarView} detail.view The view rendering the event
      * @param {Scheduler.model.EventModel} detail.eventRecord The event record
@@ -390,39 +356,36 @@ defineProps<{
     eventHeaderRenderer ? : ((detail: { view: CalendarView, eventRecord: EventModel, resourceRecord: ResourceModel, renderData: { style: object, cls: object, iconStyle: object, iconCls: object, eventColor: string, dataset: object, solidBar: Boolean, bodyColor: string }, showBullet: Boolean }) => DomConfig|DomConfig[]|string|void)|string
     /**
      * The height of event bars if this view creates event bars.
-     * ...
-     * [View online docs...](https://bryntum.com/products/calendar/docs/api/Calendar/widget/YearView#config-eventHeight)
+     * [More...](https://bryntum.com/products/calendar/docs/api/Calendar/widget/YearView#config-eventHeight)
      */
     eventHeight ? : number|string
     /**
      * A function, or the name of a function in the ownership hierarchy which you
      * can specify to customize event DOM content.
-     * ...
-     * [View online docs...](https://bryntum.com/products/calendar/docs/api/Calendar/widget/YearView#config-eventRenderer)
-     * @param {object} detail An object that contains data about the event being rendered
-     * @param {CalendarView} detail.view The view rendering the event
-     * @param {Scheduler.model.EventModel} detail.eventRecord The event record
-     * @param {Scheduler.model.ResourceModel} detail.resourceRecord The Resource record
-     * @param {object} detail.renderData A data object containing properties that will be used to create the event element
-     * @param {object} detail.renderData.style The style property is an object containing style properties for the event element
-     * @param {object} detail.renderData.cls The cls property is an object whose property names will be added to the event element if the property value is truthy
-     * @param {object} detail.renderData.iconStyle The iconStyle property is an object containing style properties for the icon element if an icon element is to be used
-     * @param {object} detail.renderData.iconCls The iconCls property is an object whose property names will be added to the icon element. Initially set from the event record's [iconCls](https://bryntum.com/products/calendar/docs/api/Scheduler/model/EventModel#field-iconCls). Can be mutated by the renderer. If null, or no properties are set, no icon will be rendered
-     * @param {string} detail.renderData.eventColor Color to be applied to the event. This may be a CSS color name or a CSS color value in any of the supported CSS color formats such as `#RRGGBB`, `rgb(255, 0, 0)`, or `rgba(255, 0, 0, 0.5)`.
-     * @param {string} detail.renderData.eventBackground A CSS background style to be applied to the event. This is not set by default, but can be set by the renderer to provide a background image or gradient for the event bar. This overrides the `eventColor` property if present.
-     * @param {string} detail.renderData.textColor A CSS color to be applied to the event text. This is not set by default, but can be set by the renderer to provide a custom color for the event name text in the event bar. This may be a CSS color name or a CSS color value in any of the supported CSS color formats such as `#RRGGBB`, `rgb(255, 0, 0)`, or `rgba(255, 0, 0, 0.5)`.
-     * @param {object} detail.renderData.eventInnerStyle The eventInnerStyle property is an object containing style properties for the inner part of the event element, the `.b-cal-event` element.
-     * @param {object} detail.renderData.dataset An object which produces the `dataset` of the resulting event bar
-     * @param {boolean} detail.renderData.solidBar This is valid for views which create event bars. This is set to `true` by default for all day and interday events so that these appear as a solid block of background color. An eventRenderer may mutate this flag to change in what manner the event bar is colored - as a solid bar of color, or using the foreground color (text and icons) such as the MonthView, the CalendarRow (all day events in a DayView), and OverflowPopups
-     * @param {string} detail.renderData.bodyColor When used in a [DayView](https://bryntum.com/products/calendar/docs/api/Calendar/widget/DayView), this color is applied to the body of the event element. Note that this must be light enough that the text color (From the SASS variable `$dayview-event-color`) is visible
-     * @param {boolean} detail.renderData.showBullet If there is no `iconCls`, and the event is not recurring, then by default a "bullet" circular icon is shown if the view's [showBullet](https://bryntum.com/products/calendar/docs/api/Calendar/widget/mixin/CalendarMixin#config-showBullet) if set. Setting this property in an event renderer overrides this behaviour. <h3>Using JSX (React)</h3> When using the Bryntum React wrapper, the event renderer can return JSX elements: ```javascript eventRenderer({ eventRecord, renderData }) {     return &lt;MyEventComponent event={eventRecord} />; } ``` *Using JSX in the event renderer creates a React portal for each rendered event. For calendars with many visible events or frequently re-rendered views, this may impact scrolling performance compared to returning plain strings or [DomConfig](https://bryntum.com/products/calendar/docs/api/Core/helper/DomHelper#typedef-DomConfig) objects. Consider using JSX primarily for events that require complex interactive React components.*
+     * [More...](https://bryntum.com/products/calendar/docs/api/Calendar/widget/YearView#config-eventRenderer)
+     * @param {object} context An object that contains data about the event being rendered
+     * @param {Calendar.widget.mixin.CalendarMixin} context.view The view rendering the event
+     * @param {Scheduler.model.EventModel} context.eventRecord The event record
+     * @param {Scheduler.model.ResourceModel} context.resourceRecord The Resource record
+     * @param {object} context.renderData A data object containing properties that will be used to create the event element
+     * @param {object} context.renderData.style The style property is an object containing style properties for the event element
+     * @param {object} context.renderData.cls The cls property is an object whose property names will be added to the event element if the property value is truthy
+     * @param {object} context.renderData.iconStyle The iconStyle property is an object containing style properties for the icon element if an icon element is to be used
+     * @param {object} context.renderData.iconCls The iconCls property is an object whose property names will be added to the icon element. Initially set from the event record's [iconCls](https://bryntum.com/products/calendar/docs/api/Scheduler/model/EventModel#field-iconCls). Can be mutated by the renderer. If null, or no properties are set, no icon will be rendered
+     * @param {string} context.renderData.eventColor Color to be applied to the event. This may be a CSS color name or a CSS color value in any of the supported CSS color formats such as `#RRGGBB`, `rgb(255, 0, 0)`, or `rgba(255, 0, 0, 0.5)`.
+     * @param {string} context.renderData.eventBackground A CSS background style to be applied to the event. This is not set by default, but can be set by the renderer to provide a background image or gradient for the event bar. This overrides the `eventColor` property if present.
+     * @param {string} context.renderData.textColor A CSS color to be applied to the event text. This is not set by default, but can be set by the renderer to provide a custom color for the event name text in the event bar. This may be a CSS color name or a CSS color value in any of the supported CSS color formats such as `#RRGGBB`, `rgb(255, 0, 0)`, or `rgba(255, 0, 0, 0.5)`.
+     * @param {object} context.renderData.eventInnerStyle The eventInnerStyle property is an object containing style properties for the inner part of the event element, the `.b-cal-event` element.
+     * @param {object} context.renderData.dataset An object which produces the `dataset` of the resulting event bar
+     * @param {boolean} context.renderData.solidBar This is valid for views which create event bars. This is set to `true` by default for all day and interday events so that these appear as a solid block of background color. An eventRenderer may mutate this flag to change in what manner the event bar is colored - as a solid bar of color, or using the foreground color (text and icons) such as the MonthView, the CalendarRow (all day events in a DayView), and OverflowPopups
+     * @param {string} context.renderData.bodyColor When used in a [DayView](https://bryntum.com/products/calendar/docs/api/Calendar/widget/DayView), this color is applied to the body of the event element. Note that this must be light enough that the text color (From the SASS variable `$dayview-event-color`) is visible
+     * @param {boolean} context.renderData.showBullet If there is no `iconCls`, and the event is not recurring, then by default a "bullet" circular icon is shown if the view's [showBullet](https://bryntum.com/products/calendar/docs/api/Calendar/widget/mixin/CalendarMixin#config-showBullet) if set. Setting this property in an event renderer overrides this behaviour. <h3>Using JSX (React)</h3> When using the Bryntum React wrapper, the event renderer can return JSX elements: ```javascript eventRenderer({ eventRecord, renderData }) {     return &lt;MyEventComponent event={eventRecord} />; } ``` *Using JSX in the event renderer creates a React portal for each rendered event. For calendars with many visible events or frequently re-rendered views, this may impact scrolling performance compared to returning plain strings or [DomConfig](https://bryntum.com/products/calendar/docs/api/Core/helper/DomHelper#typedef-DomConfig) objects. Consider using JSX primarily for events that require complex interactive React components.*
      * @returns {DomConfig,DomConfig[],string,void} The content to be used as the event body.
      */
-    eventRenderer ? : ((detail: { view: CalendarView, eventRecord: EventModel, resourceRecord: ResourceModel, renderData: { style: object, cls: object, iconStyle: object, iconCls: object, eventColor: string, eventBackground: string, textColor: string, eventInnerStyle: object, dataset: object, solidBar: Boolean, bodyColor: string, showBullet: Boolean } }) => DomConfig|DomConfig[]|string|void)|string
+    eventRenderer ? : ((context: { view: CalendarMixinClass, eventRecord: EventModel, resourceRecord: ResourceModel, renderData: { style: object, cls: object, iconStyle: object, iconCls: object, eventColor: string, eventBackground: string, textColor: string, eventInnerStyle: object, dataset: object, solidBar: Boolean, bodyColor: string, showBullet: Boolean } }) => DomConfig|DomConfig[]|string|void)|string
     /**
      * A function which compares events which some views use to decide upon rendering order.
-     * ...
-     * [View online docs...](https://bryntum.com/products/calendar/docs/api/Calendar/widget/YearView#config-eventSorter)
+     * [More...](https://bryntum.com/products/calendar/docs/api/Calendar/widget/YearView#config-eventSorter)
      * @param {Scheduler.model.EventModel,EventBar} lhs The left side value to conpare
      * @param {Scheduler.model.EventModel,EventBar} rhs The right side value to conpare
      * @returns {number}
@@ -436,8 +399,7 @@ defineProps<{
      * By default, the end date of an all day event is displayed in the UI as
      * the last calendar date on which the event falls. For most end users, this is the
      * expected value.
-     * ...
-     * [View online docs...](https://bryntum.com/products/calendar/docs/api/Calendar/widget/YearView#config-extendAllDayEndDay)
+     * [More...](https://bryntum.com/products/calendar/docs/api/Calendar/widget/YearView#config-extendAllDayEndDay)
      */
     extendAllDayEndDay ? : Boolean
     extraData ? : any
@@ -445,8 +407,7 @@ defineProps<{
      * If this is set to `true`, then when determining which assigned resource of a multi assigned event
      * to use to create the event UI, the first resource which is still selected in the
      * [resourceFilter](https://bryntum.com/products/calendar/docs/api/Calendar/widget/Sidebar#property-resourceFilter) is used.
-     * ...
-     * [View online docs...](https://bryntum.com/products/calendar/docs/api/Calendar/widget/YearView#config-filterEventResources)
+     * [More...](https://bryntum.com/products/calendar/docs/api/Calendar/widget/YearView#config-filterEventResources)
      */
     filterEventResources ? : Boolean
     /**
@@ -465,27 +426,23 @@ defineProps<{
     /**
      * Config object of a footer. May contain a `dock`, `html` and a `cls` property. A footer is not a widget,
      * but rather plain HTML that follows the last element of the panel's body and [strips](https://bryntum.com/products/calendar/docs/api/Core/widget/Panel#config-strips).
-     * ...
-     * [View online docs...](https://bryntum.com/products/calendar/docs/api/Calendar/widget/YearView#config-footer)
+     * [More...](https://bryntum.com/products/calendar/docs/api/Calendar/widget/YearView#config-footer)
+     * @property {'top','right','bottom','left','start','end'} dock Where to dock
+     * @property {string} html Html to populate the footer with
+     * @property {string} cls CSS class to add to the footer
      */
-    footer ? : {
-        dock?: 'top'|'right'|'bottom'|'left'|'start'|'end'
-        html?: string
-        cls?: string
-    }|string
+    footer ? : object|string
     /**
      * A Function (or name of a function in the ownership hierarchy) which returns the
      * [resource record](https://bryntum.com/products/calendar/docs/api/Scheduler/model/ResourceModel) to use to create the UI for an event.
-     * ...
-     * [View online docs...](https://bryntum.com/products/calendar/docs/api/Calendar/widget/YearView#config-getPrimaryResource)
+     * [More...](https://bryntum.com/products/calendar/docs/api/Calendar/widget/YearView#config-getPrimaryResource)
      * @param {Scheduler.model.EventModel} eventRecord The event from which to extract the primary resource.
      * @returns {Scheduler.model.ResourceModel} The resource to be used to render the event.
      */
     getPrimaryResource ? : ((eventRecord: EventModel) => ResourceModel)|string
     /**
      * A config [object](https://bryntum.com/products/calendar/docs/api/Core/widget/Panel#typedef-PanelHeader) for the panel's header or a string in place of a `title`.
-     * ...
-     * [View online docs...](https://bryntum.com/products/calendar/docs/api/Calendar/widget/YearView#config-header)
+     * [More...](https://bryntum.com/products/calendar/docs/api/Calendar/widget/YearView#config-header)
      */
     header ? : string|Boolean|PanelHeader
     /**
@@ -500,8 +457,7 @@ defineProps<{
     hidden ? : Boolean
     /**
      * *Only valid if this Widget is [floating](https://bryntum.com/products/calendar/docs/api/Core/widget/Widget#config-floating).*
-     * ...
-     * [View online docs...](https://bryntum.com/products/calendar/docs/api/Calendar/widget/YearView#config-hideAnimation)
+     * [More...](https://bryntum.com/products/calendar/docs/api/Calendar/widget/YearView#config-hideAnimation)
      */
     hideAnimation ? : Boolean|object
     /**
@@ -511,8 +467,7 @@ defineProps<{
     /**
      * Specify `true` to make this container hide when it has no visible children (Either empty
      * or all children hidden).
-     * ...
-     * [View online docs...](https://bryntum.com/products/calendar/docs/api/Calendar/widget/YearView#config-hideWhenEmpty)
+     * [More...](https://bryntum.com/products/calendar/docs/api/Calendar/widget/YearView#config-hideWhenEmpty)
      */
     hideWhenEmpty ? : Boolean
     /**
@@ -526,16 +481,14 @@ defineProps<{
     id ? : string
     /**
      * Determines if the widgets read-only state should be controlled by its parent.
-     * ...
-     * [View online docs...](https://bryntum.com/products/calendar/docs/api/Calendar/widget/YearView#config-ignoreParentReadOnly)
+     * [More...](https://bryntum.com/products/calendar/docs/api/Calendar/widget/YearView#config-ignoreParentReadOnly)
      */
     ignoreParentReadOnly ? : Boolean
     /**
      * Convenience setting to align input fields of child widgets. By default, the Field input element is
      * placed immediately following the `label`. If you prefer to have all input fields aligned to the
      * right, set this config to `'end'`.
-     * ...
-     * [View online docs...](https://bryntum.com/products/calendar/docs/api/Calendar/widget/YearView#config-inputFieldAlign)
+     * [More...](https://bryntum.com/products/calendar/docs/api/Calendar/widget/YearView#config-inputFieldAlign)
      */
     inputFieldAlign ? : 'start'|'end'
     /**
@@ -553,55 +506,52 @@ defineProps<{
     /**
      * An object containing typed child widget config objects or Widgets. May also be specified
      * as an array.
-     * ...
-     * [View online docs...](https://bryntum.com/products/calendar/docs/api/Calendar/widget/YearView#config-items)
+     * [More...](https://bryntum.com/products/calendar/docs/api/Calendar/widget/YearView#config-items)
      */
     items ? : Record<string, ContainerItemConfig|MenuItemEntry>|(ContainerItemConfig|MenuItemEntry|Widget)[]
     /**
      * An object whose keys are the [key](https://developer.mozilla.org/en-US/docs/Web/API/KeyboardEvent/key) name
      * and optional modifier prefixes: `'Ctrl+'`, `'Alt+'`, `'Meta+'`, and `'Shift+'` (case-insensitive). The values
      * are the name of the instance method to call when the keystroke is received.
-     * ...
-     * [View online docs...](https://bryntum.com/products/calendar/docs/api/Calendar/widget/YearView#config-keyMap)
+     * [More...](https://bryntum.com/products/calendar/docs/api/Calendar/widget/YearView#config-keyMap)
      */
     keyMap ? : Record<string, KeyMapConfig>
     /**
      * Convenience setting to use same label placement on all child widgets.
-     * ...
-     * [View online docs...](https://bryntum.com/products/calendar/docs/api/Calendar/widget/YearView#config-labelPosition)
+     * [More...](https://bryntum.com/products/calendar/docs/api/Calendar/widget/YearView#config-labelPosition)
      */
     labelPosition ? : 'before'|'above'|'align-before'|'auto'|null
+    /**
+     * Sets `labelWidth´ for all children of this Container, that does not define their own `labelWidth`.
+     * [More...](https://bryntum.com/products/calendar/docs/api/Calendar/widget/YearView#config-labelWidth)
+     */
+    labelWidth ? : number|null
     /**
      * The short name of a helper class which manages rendering and styling of child items.
-     * ...
-     * [View online docs...](https://bryntum.com/products/calendar/docs/api/Calendar/widget/YearView#config-layout)
+     * [More...](https://bryntum.com/products/calendar/docs/api/Calendar/widget/YearView#config-layout)
      */
     layout ? : string|ContainerLayoutConfig
     /**
      * The CSS style properties to apply to the [contentElement](https://bryntum.com/products/calendar/docs/api/Core/widget/Widget#property-contentElement).
-     * ...
-     * [View online docs...](https://bryntum.com/products/calendar/docs/api/Calendar/widget/YearView#config-layoutStyle)
+     * [More...](https://bryntum.com/products/calendar/docs/api/Calendar/widget/YearView#config-layoutStyle)
      */
     layoutStyle ? : object
     /**
      * An array of [child item](https://bryntum.com/products/calendar/docs/api/Core/widget/Container#config-items) *config objects* which is to be converted into
      * instances only when this Container is rendered, rather than eagerly at construct time.
-     * ...
-     * [View online docs...](https://bryntum.com/products/calendar/docs/api/Calendar/widget/YearView#config-lazyItems)
+     * [More...](https://bryntum.com/products/calendar/docs/api/Calendar/widget/YearView#config-lazyItems)
      */
     lazyItems ? : Record<string, ContainerItemConfig>|ContainerItemConfig[]|Widget[]
     /**
      * The listener set for this object.
-     * ...
-     * [View online docs...](https://bryntum.com/products/calendar/docs/api/Calendar/widget/YearView#config-listeners)
+     * [More...](https://bryntum.com/products/calendar/docs/api/Calendar/widget/YearView#config-listeners)
      */
     listeners ? : YearViewListeners
     /**
      * A class translations of which are used for translating this entity.
      * This is often used when translations of an item are defined on its container class.
      * For example:
-     * ...
-     * [View online docs...](https://bryntum.com/products/calendar/docs/api/Calendar/widget/YearView#config-localeClass)
+     * [More...](https://bryntum.com/products/calendar/docs/api/Calendar/widget/YearView#config-localeClass)
      */
     localeClass ? : typeof Base
     /**
@@ -613,8 +563,7 @@ defineProps<{
      * In case there is a need to localize not typical value (not a String value or a field with re-defined setter/getter),
      * you could use 'localeKey' meta configuration.
      * Example:
-     * ...
-     * [View online docs...](https://bryntum.com/products/calendar/docs/api/Calendar/widget/YearView#config-localizableProperties)
+     * [More...](https://bryntum.com/products/calendar/docs/api/Calendar/widget/YearView#config-localizableProperties)
      */
     localizableProperties ? : string[]
     /**
@@ -644,8 +593,7 @@ defineProps<{
     maxHeight ? : string|number
     /**
      * *Only valid if this Widget is [floating](https://bryntum.com/products/calendar/docs/api/Core/widget/Widget#config-floating).*
-     * ...
-     * [View online docs...](https://bryntum.com/products/calendar/docs/api/Calendar/widget/YearView#config-maximizeOnMobile)
+     * [More...](https://bryntum.com/products/calendar/docs/api/Calendar/widget/YearView#config-maximizeOnMobile)
      */
     maximizeOnMobile ? : number|string
     /**
@@ -671,18 +619,15 @@ defineProps<{
      * When this is configured as `true` a [ResizeObserver](https://developer.mozilla.org/en-US/docs/Web/API/ResizeObserver)
      * is used to monitor this element for size changes caused by either style manipulation, or by CSS
      * layout.
-     * ...
-     * [View online docs...](https://bryntum.com/products/calendar/docs/api/Calendar/widget/YearView#config-monitorResize)
+     * [More...](https://bryntum.com/products/calendar/docs/api/Calendar/widget/YearView#config-monitorResize)
+     * @property {boolean} immediate Set to `true` to receive resize notifications immediately.
      */
-    monitorResize ? : Boolean|{
-        immediate?: Boolean
-    }
+    monitorResize ? : Boolean|object
     /**
      * An object containing default config objects which may be referenced by name in the [items](https://bryntum.com/products/calendar/docs/api/Core/widget/Container#config-items)
      * config. For example, a specialized [Menu](https://bryntum.com/products/calendar/docs/api/Core/widget/Menu) subclass may have a `namedItems` default
      * value defined like this:
-     * ...
-     * [View online docs...](https://bryntum.com/products/calendar/docs/api/Calendar/widget/YearView#config-namedItems)
+     * [More...](https://bryntum.com/products/calendar/docs/api/Calendar/widget/YearView#config-namedItems)
      */
     namedItems ? : Record<string, ContainerItemConfig>
     /**
@@ -694,8 +639,7 @@ defineProps<{
      * A function, or name of a function which is passed the [DomConfig](https://bryntum.com/products/calendar/docs/api/Core/helper/DomHelper#typedef-DomConfig) object which
      * will be used to create the "+n more" button which indicates that a day cell has
      * overflowing events.
-     * ...
-     * [View online docs...](https://bryntum.com/products/calendar/docs/api/Calendar/widget/YearView#config-overflowButtonRenderer)
+     * [More...](https://bryntum.com/products/calendar/docs/api/Calendar/widget/YearView#config-overflowButtonRenderer)
      * @param {DomConfig,object} domConfig A [DomConfig](https://bryntum.com/products/calendar/docs/api/Core/helper/DomHelper#typedef-DomConfig) config object which is used to create the overflow button.
      * @param {string} domConfig.tag The tag name of the element to create.
      * @param {object} domConfig.className An object who's truthy property names will be applied as class names.
@@ -705,33 +649,29 @@ defineProps<{
      * @param {number} overflowCount The number of overflowing events.
      * @returns {DomConfig,string,void}
      */
-    overflowButtonRenderer ? : (domConfig: { tag: string, className: object, text: string, style: object, dataset: object }, overflowCount: number) => DomConfig|string|void
+    overflowButtonRenderer ? : (domConfig: DomConfig|{ tag: string, className: object, text: string, style: object, dataset: object }, overflowCount: number) => DomConfig|string|void
     /**
      * A config object used to create the [OverflowPopup](https://bryntum.com/products/calendar/docs/api/Calendar/widget/OverflowPopup) that this view
      * may show when events for one day overflow the available space.
-     * ...
-     * [View online docs...](https://bryntum.com/products/calendar/docs/api/Calendar/widget/YearView#config-overflowPopup)
+     * [More...](https://bryntum.com/products/calendar/docs/api/Calendar/widget/YearView#config-overflowPopup)
      */
     overflowPopup ? : OverflowPopupConfig
     /**
      * The pointer gesture which shows the popup containing any overflowing events
      * in the current view.
-     * ...
-     * [View online docs...](https://bryntum.com/products/calendar/docs/api/Calendar/widget/YearView#config-overflowPopupTrigger)
+     * [More...](https://bryntum.com/products/calendar/docs/api/Calendar/widget/YearView#config-overflowPopupTrigger)
      */
     overflowPopupTrigger ? : 'click'|'mouseover'|'hover'
     /**
      * The class name to add to events which have an end date in the past. Defaults to `'b-past-event'`.
-     * ...
-     * [View online docs...](https://bryntum.com/products/calendar/docs/api/Calendar/widget/YearView#config-pastEventCls)
+     * [More...](https://bryntum.com/products/calendar/docs/api/Calendar/widget/YearView#config-pastEventCls)
      */
     pastEventCls ? : string
     /**
      * Set to `true` when a widget is rendered into another widget's [contentElement](https://bryntum.com/products/calendar/docs/api/Core/widget/Widget#property-contentElement), but must
      * not participate in the standard layout of that widget, and must be positioned relatively to that
      * widget's [contentElement](https://bryntum.com/products/calendar/docs/api/Core/widget/Widget#property-contentElement).
-     * ...
-     * [View online docs...](https://bryntum.com/products/calendar/docs/api/Calendar/widget/YearView#config-positioned)
+     * [More...](https://bryntum.com/products/calendar/docs/api/Calendar/widget/YearView#config-positioned)
      */
     positioned ? : Boolean
     /**
@@ -742,16 +682,14 @@ defineProps<{
     /**
      * Whether this widget is read-only.  This is only valid if the widget is an input
      * field, <strong>or contains input fields at any depth</strong>.
-     * ...
-     * [View online docs...](https://bryntum.com/products/calendar/docs/api/Calendar/widget/YearView#config-readOnly)
+     * [More...](https://bryntum.com/products/calendar/docs/api/Calendar/widget/YearView#config-readOnly)
      */
     readOnly ? : Boolean
     relayStoreEvents ? : Boolean
     /**
      * Either a default `rendition` to apply to all child widgets, or a map of renditions keyed by child widget
      * `type`.
-     * ...
-     * [View online docs...](https://bryntum.com/products/calendar/docs/api/Calendar/widget/YearView#config-rendition)
+     * [More...](https://bryntum.com/products/calendar/docs/api/Calendar/widget/YearView#config-rendition)
      */
     rendition ? : string|Record<string, string>|null
     /**
@@ -759,16 +697,14 @@ defineProps<{
      * to create URLs using the resource's
      * [image](https://bryntum.com/products/calendar/docs/api/Scheduler/model/ResourceModel#field-image) or
      * [imageUrl](https://bryntum.com/products/calendar/docs/api/Scheduler/model/ResourceModel#field-imageUrl) fields:
-     * ...
-     * [View online docs...](https://bryntum.com/products/calendar/docs/api/Calendar/widget/YearView#config-resourceImagePath)
+     * [More...](https://bryntum.com/products/calendar/docs/api/Calendar/widget/YearView#config-resourceImagePath)
      */
     resourceImagePath ? : string
     /**
      * Specifies the various responsive state objects keyed by their name. Each key (except `'*'`, see below) in
      * this object is a state name (see [responsiveState](https://bryntum.com/products/calendar/docs/api/Core/widget/mixin/Responsive#config-responsiveState)) and its corresponding value is the
      * associated [ResponsiveState](https://bryntum.com/products/calendar/docs/api/Core/widget/mixin/Responsive#typedef-ResponsiveState) object.
-     * ...
-     * [View online docs...](https://bryntum.com/products/calendar/docs/api/Calendar/widget/YearView#config-responsive)
+     * [More...](https://bryntum.com/products/calendar/docs/api/Calendar/widget/YearView#config-responsive)
      */
     responsive ? : object
     /**
@@ -785,31 +721,33 @@ defineProps<{
      * The widget whose size and other properties drive this object's responsive behavior. If this config is not
      * specified, the closest ancestor that specified [responsiveRoot=true](https://bryntum.com/products/calendar/docs/api/Core/widget/mixin/Responsive#config-responsiveRoot) will be
      * used. If there is no such ancestor, then the instance using this mixin is used.
-     * ...
-     * [View online docs...](https://bryntum.com/products/calendar/docs/api/Calendar/widget/YearView#config-responsiveTarget)
+     * [More...](https://bryntum.com/products/calendar/docs/api/Calendar/widget/YearView#config-responsiveTarget)
      */
     responsiveTarget ? : string|Widget
     /**
      * Configure as `true` to have the component display a translucent ripple when its
      * [focusElement](https://bryntum.com/products/calendar/docs/api/Core/widget/Widget#property-focusElement), or [element](#Core/widget/Widget#property-element) is tapped <em>if the
      * current theme supports ripples</em>. Out of the box, only the Material theme supports ripples.
-     * ...
-     * [View online docs...](https://bryntum.com/products/calendar/docs/api/Calendar/widget/YearView#config-ripple)
+     * [More...](https://bryntum.com/products/calendar/docs/api/Calendar/widget/YearView#config-ripple)
+     * @property {string} [delegate] A CSS selector to filter which child elements trigger ripples. By default, the ripple is clipped to the triggering element.
+     * @property {string} [color] A CSS color name or specification.
+     * @property {number} [radius] The ending radius of the ripple. Note that it will be clipped by the target element by default.
+     * @property {string} [clip] A string which describes how to clip the ripple if it is not to be clipped to the default element. Either the property of the widget to use as the clipping element, or a selector to allow clipping to the closest matching ancestor to the target element.
      */
-    ripple ? : Boolean|{
-        delegate?: string
-        color?: string
-        radius?: number
-        clip?: string
-    }
+    ripple ? : Boolean|object
+    /**
+     * The ARIA role to apply to this widget's element. By default, this is set to `'presentation'` to avoid
+     * accidentally applying a role which may interfere with screen readers.
+     * [More...](https://bryntum.com/products/calendar/docs/api/Calendar/widget/YearView#config-role)
+     */
+    role ? : string
     /**
      * If you are rendering this widget to a shadow root inside a web component, set this config to the shadowRoot. If not inside a web component, set it to `document.body`
      */
     rootElement ? : ShadowRoot|HTMLElement
     /**
      * This may be configured as `true` to make the widget's element use the `direction:rtl` style.
-     * ...
-     * [View online docs...](https://bryntum.com/products/calendar/docs/api/Calendar/widget/YearView#config-rtl)
+     * [More...](https://bryntum.com/products/calendar/docs/api/Calendar/widget/YearView#config-rtl)
      */
     rtl ? : Boolean
     /**
@@ -817,8 +755,7 @@ defineProps<{
      * in both axes. May be an object containing boolean `overflowX` and `overflowY` properties which are
      * applied to CSS style properties `overflowX` and `overflowY`. If they are boolean, they are translated to
      * CSS overflow properties thus:
-     * ...
-     * [View online docs...](https://bryntum.com/products/calendar/docs/api/Calendar/widget/YearView#config-scrollable)
+     * [More...](https://bryntum.com/products/calendar/docs/api/Calendar/widget/YearView#config-scrollable)
      */
     scrollable ? : Boolean|ScrollerConfig|Scroller
     /**
@@ -854,38 +791,35 @@ defineProps<{
      */
     shortEventCls ? : string
     /**
-     * The duration at which below and equal to this value, an event's encapsulating element gets
-     * the [shortEventCls](https://bryntum.com/products/calendar/docs/api/Calendar/widget/mixin/CalendarMixin#config-shortEventCls) added to it so that small event bars can have style rearrangements.
-     * ...
-     * [View online docs...](https://bryntum.com/products/calendar/docs/api/Calendar/widget/YearView#config-shortEventDuration)
+     * The duration threshold at or below which an event's encapsulating element gets
+     * the [shortEventCls](https://bryntum.com/products/calendar/docs/api/Calendar/widget/mixin/CalendarMixin#config-shortEventCls) added to it so that small event bars can have
+     * style rearrangements.
+     * [More...](https://bryntum.com/products/calendar/docs/api/Calendar/widget/YearView#config-shortEventDuration)
      */
-    shortEventDuration ? : string|number
+    shortEventDuration ? : DurationConfig|number|string
     /**
      * *Only valid if this Widget is [floating](https://bryntum.com/products/calendar/docs/api/Core/widget/Widget#config-floating).*
-     * ...
-     * [View online docs...](https://bryntum.com/products/calendar/docs/api/Calendar/widget/YearView#config-showAnimation)
+     * [More...](https://bryntum.com/products/calendar/docs/api/Calendar/widget/YearView#config-showAnimation)
      */
     showAnimation ? : Boolean|object
     /**
-     * <strong>Not applicable in a `DayView`</strong>
-     * ...
-     * [View online docs...](https://bryntum.com/products/calendar/docs/api/Calendar/widget/YearView#config-showBullet)
-     * @param {boolean} bar This is `false` by default. Set this to `true` in modes where a solid event bar should show a bullet icon
-     * @param {boolean} noBar This is `true` by default. Events with no background colour, use this to show the event's defined `eventColor`
+     * This specifies whether to show a circular "bullet" icon if there is no
+     * [iconCls](https://bryntum.com/products/calendar/docs/api/Scheduler/model/EventModel#field-iconCls) defined for an event.
+     * [More...](https://bryntum.com/products/calendar/docs/api/Calendar/widget/YearView#config-showBullet)
+     * @param {boolean} [bar] This is `false` by default. Set this to `true` in modes where a solid event bar should show a bullet icon
+     * @param {boolean} [noBar] This is `true` by default. Events with no background colour, use this to show the event's defined `eventColor`
      */
-    showBullet ? : Boolean|{bar?: Boolean, noBar?: Boolean}
+    showBullet ? : Boolean|{ bar?: Boolean, noBar?: Boolean }
     /**
      * How to indicate the presence of events for a date. The default is `heatmap` which adds
      * classes depending on how many events intersect the date.Values may be:
-     * ...
-     * [View online docs...](https://bryntum.com/products/calendar/docs/api/Calendar/widget/YearView#config-showEvents)
+     * [More...](https://bryntum.com/products/calendar/docs/api/Calendar/widget/YearView#config-showEvents)
      */
     showEvents ? : Boolean|'heatmap'|'dots'
     /**
      * Configure as `true` to show avatars of the assigned resources (calendars) at the
      * start of the event bar.
-     * ...
-     * [View online docs...](https://bryntum.com/products/calendar/docs/api/Calendar/widget/YearView#config-showResourceAvatars)
+     * [More...](https://bryntum.com/products/calendar/docs/api/Calendar/widget/YearView#config-showResourceAvatars)
      */
     showResourceAvatars ? : Boolean|string
     /**
@@ -903,30 +837,26 @@ defineProps<{
     span ? : number
     /**
      * This value can be one of the following:
-     * ...
-     * [View online docs...](https://bryntum.com/products/calendar/docs/api/Calendar/widget/YearView#config-stateful)
+     * [More...](https://bryntum.com/products/calendar/docs/api/Calendar/widget/YearView#config-stateful)
      */
     stateful ? : Boolean|object|string[]
     /**
      * The events that, when fired by this component, should trigger it to save its state by calling
      * [saveState](https://bryntum.com/products/calendar/docs/api/Core/mixin/State#function-saveState).
-     * ...
-     * [View online docs...](https://bryntum.com/products/calendar/docs/api/Calendar/widget/YearView#config-statefulEvents)
+     * [More...](https://bryntum.com/products/calendar/docs/api/Calendar/widget/YearView#config-statefulEvents)
      */
     statefulEvents ? : object|string[]
     /**
      * The key to use when saving this object's state in the [stateProvider](https://bryntum.com/products/calendar/docs/api/Core/mixin/State#config-stateProvider). If this config is
      * not assigned, and [stateful](https://bryntum.com/products/calendar/docs/api/Core/mixin/State#config-stateful) is not set to `false`, the [id](#Core/widget/Widget#config-id)
      * (if explicitly specified) will be used as the `stateId`.
-     * ...
-     * [View online docs...](https://bryntum.com/products/calendar/docs/api/Calendar/widget/YearView#config-stateId)
+     * [More...](https://bryntum.com/products/calendar/docs/api/Calendar/widget/YearView#config-stateId)
      */
     stateId ? : string
     /**
      * The `StateProvider` to use to save and restore this object's [state](https://bryntum.com/products/calendar/docs/api/Core/mixin/State#property-state). By default, `state`
      * will be saved using the [default state provider](https://bryntum.com/products/calendar/docs/api/Core/state/StateProvider#property-instance-static).
-     * ...
-     * [View online docs...](https://bryntum.com/products/calendar/docs/api/Calendar/widget/YearView#config-stateProvider)
+     * [More...](https://bryntum.com/products/calendar/docs/api/Calendar/widget/YearView#config-stateProvider)
      */
     stateProvider ? : StateProvider
     /**
@@ -938,35 +868,30 @@ defineProps<{
      * An object containing widgets keyed by name. By default (when no `type` is given), strips are
      * [toolbars](https://bryntum.com/products/calendar/docs/api/Core/widget/Toolbar). If you want to pass an array, you can use
      * the toolbar's [items](https://bryntum.com/products/calendar/docs/api/Core/widget/Container#config-items).
-     * ...
-     * [View online docs...](https://bryntum.com/products/calendar/docs/api/Calendar/widget/YearView#config-strips)
+     * [More...](https://bryntum.com/products/calendar/docs/api/Calendar/widget/YearView#config-strips)
      */
     strips ? : Record<string, ContainerItemConfig>
     /**
      * The converse of [syncViewDate](https://bryntum.com/products/calendar/docs/api/Calendar/widget/mixin/CalendarMixin#property-syncViewDate)
-     * ...
-     * [View online docs...](https://bryntum.com/products/calendar/docs/api/Calendar/widget/YearView#config-syncCalendarDate)
+     * [More...](https://bryntum.com/products/calendar/docs/api/Calendar/widget/YearView#config-syncCalendarDate)
      */
     syncCalendarDate ? : Boolean
     /**
      * The converse of [syncCalendarDate](https://bryntum.com/products/calendar/docs/api/Calendar/widget/mixin/CalendarMixin#property-syncCalendarDate)
-     * ...
-     * [View online docs...](https://bryntum.com/products/calendar/docs/api/Calendar/widget/YearView#config-syncViewDate)
+     * [More...](https://bryntum.com/products/calendar/docs/api/Calendar/widget/YearView#config-syncViewDate)
      */
     syncViewDate ? : Boolean
     /**
      * A configuration for the [tab](https://bryntum.com/products/calendar/docs/api/Core/widget/Tab) created for this widget when it is placed in a
      * [TabPanel](https://bryntum.com/products/calendar/docs/api/Core/widget/TabPanel). For example, this config can be used to control the icon of the `tab` for
      * this widget:
-     * ...
-     * [View online docs...](https://bryntum.com/products/calendar/docs/api/Calendar/widget/YearView#config-tab)
+     * [More...](https://bryntum.com/products/calendar/docs/api/Calendar/widget/YearView#config-tab)
      */
     tab ? : Boolean|TabConfig
     /**
      * When this container is used as a tab in a TabPanel, these items are added to the
      * [TabBar](https://bryntum.com/products/calendar/docs/api/Core/widget/TabBar) when this container is the active tab.
-     * ...
-     * [View online docs...](https://bryntum.com/products/calendar/docs/api/Calendar/widget/YearView#config-tabBarItems)
+     * [More...](https://bryntum.com/products/calendar/docs/api/Calendar/widget/YearView#config-tabBarItems)
      */
     tabBarItems ? : ToolbarItems[]|Widget[]
     /**
@@ -977,14 +902,12 @@ defineProps<{
      * A Config object representing the configuration of a [Toolbar](https://bryntum.com/products/calendar/docs/api/Core/widget/Toolbar),
      * or array of config objects representing the child items of a Toolbar.
      * This creates a toolbar docked to the top of the panel immediately below the header.
-     * ...
-     * [View online docs...](https://bryntum.com/products/calendar/docs/api/Calendar/widget/YearView#config-tbar)
+     * [More...](https://bryntum.com/products/calendar/docs/api/Calendar/widget/YearView#config-tbar)
      */
     tbar ? : (ContainerItemConfig|string)[]|ToolbarConfig|PagingToolbarConfig|null
     /**
      * Text alignment: 'left', 'center' or 'right'. Also accepts direction neutral 'start' and 'end'.
-     * ...
-     * [View online docs...](https://bryntum.com/products/calendar/docs/api/Calendar/widget/YearView#config-textAlign)
+     * [More...](https://bryntum.com/products/calendar/docs/api/Calendar/widget/YearView#config-textAlign)
      */
     textAlign ? : 'left'|'center'|'right'|'start'|'end'
     /**
@@ -996,22 +919,19 @@ defineProps<{
     /**
      * A title to display in the header or owning TabPanel. Causes creation and docking of a header
      * to the top if no header is configured.
-     * ...
-     * [View online docs...](https://bryntum.com/products/calendar/docs/api/Calendar/widget/YearView#config-title)
+     * [More...](https://bryntum.com/products/calendar/docs/api/Calendar/widget/YearView#config-title)
      */
     title ? : string
     /**
      * The [tools](https://bryntum.com/products/calendar/docs/api/Core/widget/Tool) to add either before or after the `title` in the Panel header. Each
      * property name is the reference by which an instantiated tool may be retrieved from the live
      * `[tools](https://bryntum.com/products/calendar/docs/api/Core/widget/mixin/Toolable#property-tools)` property.
-     * ...
-     * [View online docs...](https://bryntum.com/products/calendar/docs/api/Calendar/widget/YearView#config-tools)
+     * [More...](https://bryntum.com/products/calendar/docs/api/Calendar/widget/YearView#config-tools)
      */
     tools ? : Record<string, ToolConfig>|null
     /**
      * Tooltip for the widget, either as a string or as a Tooltip config object.
-     * ...
-     * [View online docs...](https://bryntum.com/products/calendar/docs/api/Calendar/widget/YearView#config-tooltip)
+     * [More...](https://bryntum.com/products/calendar/docs/api/Calendar/widget/YearView#config-tooltip)
      */
     tooltip ? : string|TooltipConfig|null
     /**
@@ -1025,8 +945,7 @@ defineProps<{
      * Custom CSS class name suffixes to apply to the elements rendered by this widget. This may be specified
      * as a space separated string, an array of strings, or as an object in which property names with truthy
      * values are used as the class names.
-     * ...
-     * [View online docs...](https://bryntum.com/products/calendar/docs/api/Calendar/widget/YearView#config-ui)
+     * [More...](https://bryntum.com/products/calendar/docs/api/Calendar/widget/YearView#config-ui)
      */
     ui ? : 'plain'|'toolbar'|string|object
     /**
@@ -1045,16 +964,22 @@ defineProps<{
      * this config is convenient.
      */
     width ? : string|number
+    /**
+     * A Scheduler-compatible working time config object containing `fromDay` and `toDay`
+     * properties which control which days of the week are visible.
+     * [More...](https://bryntum.com/products/calendar/docs/api/Calendar/widget/YearView#config-workingTime)
+     * @property {number} workingTime.fromDay Day index 0-6 (0 is Sunday)
+     * @property {number} workingTime.toDay Day index 0-6 (0 is Sunday)
+     */
+    workingTime ? : { fromDay: number, toDay: number }
     /**
      * The x position for the widget.
-     * ...
-     * [View online docs...](https://bryntum.com/products/calendar/docs/api/Calendar/widget/YearView#config-x)
+     * [More...](https://bryntum.com/products/calendar/docs/api/Calendar/widget/YearView#config-x)
      */
     x ? : number
     /**
      * The y position for the widget.
-     * ...
-     * [View online docs...](https://bryntum.com/products/calendar/docs/api/Calendar/widget/YearView#config-y)
+     * [More...](https://bryntum.com/products/calendar/docs/api/Calendar/widget/YearView#config-y)
      */
     y ? : number
     /**
@@ -1068,8 +993,7 @@ const emit = defineEmits<{
     /**
      * This event fires whenever the [autoCreate gesture](https://bryntum.com/products/calendar/docs/api/Calendar/widget/mixin/CalendarMixin#config-autoCreate) is detected
      * and also when a [drag-create](https://bryntum.com/products/calendar/docs/api/Calendar/feature/CalendarDrag) gesture is detected.
-     * ...
-     * [View online docs...](https://bryntum.com/products/calendar/docs/api/Calendar/widget/YearView#event-beforeAutoCreate)
+     * [More...](https://bryntum.com/products/calendar/docs/api/Calendar/widget/YearView#event-beforeAutoCreate)
      * @param {string} e Event name
      * @param {object} params Event parameters
      * @param {object} params.event Event object
@@ -1083,8 +1007,7 @@ const emit = defineEmits<{
     (e: 'beforeAutoCreate', params: ((event: { domEvent: Event, date: Date, startDate: Date, endDate: Date, resourceRecord: ResourceModel, view: CalendarView }) => Promise<boolean>|boolean|void)|string): Promise<boolean>|boolean|void
     /**
      * Triggered before a view's orientating date changes.
-     * ...
-     * [View online docs...](https://bryntum.com/products/calendar/docs/api/Calendar/widget/YearView#event-beforeChangeDate)
+     * [More...](https://bryntum.com/products/calendar/docs/api/Calendar/widget/YearView#event-beforeChangeDate)
      * @param {string} e Event name
      * @param {object} params Event parameters
      * @param {object} params.event Event object
@@ -1166,8 +1089,7 @@ const emit = defineEmits<{
     (e: 'beforeStateSave', params: ((event: { state: any }) => Promise<boolean>|boolean|void)|string): Promise<boolean>|boolean|void
     /**
      * Fires when any other event is fired from the object.
-     * ...
-     * [View online docs...](https://bryntum.com/products/calendar/docs/api/Calendar/widget/YearView#event-catchAll)
+     * [More...](https://bryntum.com/products/calendar/docs/api/Calendar/widget/YearView#event-catchAll)
      * @param {string} e Event name
      * @param {object} params Event parameters
      * @param {object} params.event Event object
@@ -1194,8 +1116,7 @@ const emit = defineEmits<{
     /**
      * Fired after one day cell's events are collected in sorted order according to the
      * [eventSorter](https://bryntum.com/products/calendar/docs/api/Calendar/widget/mixin/CalendarMixin#config-eventSorter)
-     * ...
-     * [View online docs...](https://bryntum.com/products/calendar/docs/api/Calendar/widget/YearView#event-dayCellPopulated)
+     * [More...](https://bryntum.com/products/calendar/docs/api/Calendar/widget/YearView#event-dayCellPopulated)
      * @param {string} e Event name
      * @param {object} params Event parameters
      * @param {object} params.event Event object
@@ -1241,8 +1162,7 @@ const emit = defineEmits<{
     /**
      * Fired when an [autoCreate](https://bryntum.com/products/calendar/docs/api/Calendar/widget/mixin/CalendarMixin#config-autoCreate) gesture has created a new event
      * and added it to the event store.
-     * ...
-     * [View online docs...](https://bryntum.com/products/calendar/docs/api/Calendar/widget/YearView#event-eventAutoCreated)
+     * [More...](https://bryntum.com/products/calendar/docs/api/Calendar/widget/YearView#event-eventAutoCreated)
      * @param {string} e Event name
      * @param {object} params Event parameters
      * @param {object} params.event Event object
@@ -1253,8 +1173,7 @@ const emit = defineEmits<{
     /**
      * Fires when a day spanning event is found, and the date to which its encapsulating event bar
      * extends has been calculated.
-     * ...
-     * [View online docs...](https://bryntum.com/products/calendar/docs/api/Calendar/widget/YearView#event-eventPropagate)
+     * [More...](https://bryntum.com/products/calendar/docs/api/Calendar/widget/YearView#event-eventPropagate)
      * @param {string} e Event name
      * @param {object} params Event parameters
      * @param {object} params.event Event object
@@ -1314,8 +1233,7 @@ const emit = defineEmits<{
     /**
      * Triggered when a widget which had been in a non-visible state for any reason
      * achieves visibility.
-     * ...
-     * [View online docs...](https://bryntum.com/products/calendar/docs/api/Calendar/widget/YearView#event-paint)
+     * [More...](https://bryntum.com/products/calendar/docs/api/Calendar/widget/YearView#event-paint)
      * @param {string} e Event name
      * @param {object} params Event parameters
      * @param {object} params.event Event object
@@ -1467,6 +1385,7 @@ const widgetData = {
         'responsiveState',
         'responsiveTarget',
         'ripple',
+        'role',
         'rootElement',
         'scrollAction',
         'selectorButton',
@@ -1494,6 +1413,7 @@ const widgetData = {
         'ui',
         'weekStartDay',
         'weight',
+        'workingTime',
         'year'
     ],
     propertyConfigNames : [
@@ -1533,6 +1453,7 @@ const widgetData = {
         'items',
         'keyMap',
         'labelPosition',
+        'labelWidth',
         'layout',
         'layoutStyle',
         'margin',
@@ -1597,16 +1518,7 @@ const widgetData = {
         'y'
     ],
     propertyNames : [
-        'anchorSize',
         'dayCellCls',
-        'firstVisibleCell',
-        'firstVisibleDate',
-        'focusVisible',
-        'hasChanges',
-        'isSettingValues',
-        'isValid',
-        'lastVisibleCell',
-        'lastVisibleDate',
         'parent',
         'record',
         'state',