@bryntum/core-react-thin 7.2.3 → 7.3.0

package/src/BryntumDatePicker.tsx

@@ -3,7 +3,7 @@
  */
 // eslint-disable-next-line @typescript-eslint/no-unused-vars
 import React, { RefObject } from 'react';
-import { AlignSpec, Base, CalendarPanel, Color, Container, CoreContainerItemConfig, CoreContainerLayoutConfig, DatePicker, DatePickerListeners, DomConfig, KeyMapConfig, Layout, MaskConfig, MenuItemConfig, MenuItemEntry, Model, Month, MonthConfig, PagingToolbarConfig, Panel, PanelCollapserConfig, PanelCollapserOverlayConfig, PanelHeader, Rectangle, Scroller, ScrollerConfig, StateProvider, TabConfig, Tool, ToolConfig, ToolbarConfig, ToolbarItems, TooltipConfig, VueConfig, Widget } from '@bryntum/core-thin';
+import { AlignSpec, Base, CalendarPanel, Color, Container, CoreContainerItemConfig, CoreContainerLayoutConfig, DatePicker, DatePickerListeners, DomConfig, KeyMapConfig, Layout, MaskConfig, MenuItemConfig, MenuItemEntry, Model, Month, MonthConfig, PagingToolbarConfig, Panel, PanelCollapserConfig, PanelCollapserOverlayConfig, PanelHeader, ReactJSX, Rectangle, Scroller, ScrollerConfig, StateProvider, TabConfig, Tool, ToolConfig, ToolbarConfig, ToolbarItems, TooltipConfig, VueConfig, Widget } from '@bryntum/core-thin';
 
 import { createWidget, shouldComponentUpdate, processWidgetContent } from './WrapperHelper.js';
 
@@ -13,21 +13,18 @@ export type BryntumDatePickerProps = {
      * The date that the user has navigated to using the UI *prior* to setting the widget's
      * value by selecting it. The initial default is today's date. Can also be supplied as a `YYYY-MM-DD` date
      * string.
-     * ...
-     * [View online docs...](https://bryntum.com/products/grid/docs/api/Core/widget/DatePicker#config-activeDate)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/DatePicker#config-activeDate)
      */
     activeDate? : Date|'today'|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/grid/docs/api/Core/widget/DatePicker#config-adopt)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/DatePicker#config-adopt)
      */
     adopt? : HTMLElement|string
     /**
      * *Only valid if this Widget is [floating](https://bryntum.com/products/core/docs/api/Core/widget/Widget#config-floating).*
-     * ...
-     * [View online docs...](https://bryntum.com/products/grid/docs/api/Core/widget/DatePicker#config-align)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/DatePicker#config-align)
      */
     align? : AlignSpec|string
     /**
@@ -44,8 +41,7 @@ export type BryntumDatePickerProps = {
     /**
      * 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/grid/docs/api/Core/widget/DatePicker#config-animateTimeShift)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/DatePicker#config-animateTimeShift)
      */
     animateTimeShift? : boolean
     /**
@@ -56,15 +52,13 @@ export type BryntumDatePickerProps = {
     /**
      * 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/grid/docs/api/Core/widget/DatePicker#config-ariaDescription)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/DatePicker#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/grid/docs/api/Core/widget/DatePicker#config-ariaLabel)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/DatePicker#config-ariaLabel)
      */
     ariaLabel? : string
     /**
@@ -74,14 +68,12 @@ export type BryntumDatePickerProps = {
     /**
      * A Config object representing the configuration of a [Toolbar](https://bryntum.com/products/core/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/core/docs/api/Core/widget/Panel#config-strips).
-     * ...
-     * [View online docs...](https://bryntum.com/products/grid/docs/api/Core/widget/DatePicker#config-bbar)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/DatePicker#config-bbar)
      */
     bbar? : (CoreContainerItemConfig|string)[]|ToolbarConfig|PagingToolbarConfig|null
     /**
      * Custom CSS classes to add to the panel's body element.
-     * ...
-     * [View online docs...](https://bryntum.com/products/grid/docs/api/Core/widget/DatePicker#config-bodyCls)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/DatePicker#config-bodyCls)
      */
     bodyCls? : string|object
     /**
@@ -91,27 +83,23 @@ export type BryntumDatePickerProps = {
     /**
      * 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/grid/docs/api/Core/widget/DatePicker#config-bubbleEvents)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/DatePicker#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/grid/docs/api/Core/widget/DatePicker#config-callOnFunctions)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/DatePicker#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/grid/docs/api/Core/widget/DatePicker#config-catchEventHandlerExceptions)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/DatePicker#config-catchEventHandlerExceptions)
      */
     catchEventHandlerExceptions? : boolean
     /**
      * A function (or the name of a function) which creates content in, and may mutate a day cell element.
-     * ...
-     * [View online docs...](https://bryntum.com/products/grid/docs/api/Core/widget/DatePicker#config-cellRenderer)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/DatePicker#config-cellRenderer)
      * @param {object} renderData
      * @param {HTMLElement} renderData.cell The cell's encapsulating element. This has the `b-calendar-panel-cell` class and is the element which receives focus, so this should be the target of any accessibility attributes.
      * @param {HTMLElement} renderData.innerCell The inner element of the cell which contains the date number. This is the `aspect-ratio : 1` element which contains the date. It is not recommeneded to mutate this element. Instead use the `cellPayload` element (see below).
@@ -136,8 +124,7 @@ export type BryntumDatePickerProps = {
      * 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/grid/docs/api/Core/widget/DatePicker#config-cls)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/DatePicker#config-cls)
      */
     cls? : string|object
     /**
@@ -147,15 +134,13 @@ export type BryntumDatePickerProps = {
     collapsed? : boolean
     /**
      * This config enables collapsibility for the panel. See [collapsed](https://bryntum.com/products/core/docs/api/Core/widget/Panel#config-collapsed).
-     * ...
-     * [View online docs...](https://bryntum.com/products/grid/docs/api/Core/widget/DatePicker#config-collapsible)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/DatePicker#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/grid/docs/api/Core/widget/DatePicker#config-color)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/DatePicker#config-color)
      */
     color? : Color
     /**
@@ -179,8 +164,7 @@ export type BryntumDatePickerProps = {
      * Custom CSS classes to add to the [contentElement](https://bryntum.com/products/core/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/grid/docs/api/Core/widget/DatePicker#config-contentElementCls)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/DatePicker#config-contentElementCls)
      */
     contentElementCls? : string|object
     /**
@@ -208,8 +192,7 @@ export type BryntumDatePickerProps = {
     /**
      * A [query](https://bryntum.com/products/core/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/grid/docs/api/Core/widget/DatePicker#config-defaultFocus)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/DatePicker#config-defaultFocus)
      * @param {Core.widget.Widget} widget Widget passed to method
      * @returns {boolean} truthy value if widget is the default one
      */
@@ -219,16 +202,15 @@ export type BryntumDatePickerProps = {
      */
     defaults? : CoreContainerItemConfig
     /**
-     * Check for CSS compatibility issues when upgrading to v7. Performs the following checks:
-     * ...
-     * [View online docs...](https://bryntum.com/products/grid/docs/api/Core/widget/DatePicker#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/grid/docs/api/Core/widget/DatePicker#config-detectCSSCompatibilityIssues)
      */
     detectCSSCompatibilityIssues? : boolean
     /**
      * Disable or enable the widget. It is similar to [readOnly](https://bryntum.com/products/core/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/grid/docs/api/Core/widget/DatePicker#config-disabled)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/DatePicker#config-disabled)
      */
     disabled? : boolean|'inert'
     /**
@@ -245,8 +227,7 @@ export type BryntumDatePickerProps = {
     disabledDates? : ((date: Date) => boolean)|string|Date[]|string[]
     /**
      * Configure as `true` to render non working days as [disabledDates](https://bryntum.com/products/core/docs/api/Core/widget/CalendarPanel#config-disabledDates).
-     * ...
-     * [View online docs...](https://bryntum.com/products/grid/docs/api/Core/widget/DatePicker#config-disableNonWorkingDays)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/DatePicker#config-disableNonWorkingDays)
      */
     disableNonWorkingDays? : boolean
     /**
@@ -263,41 +244,36 @@ export type BryntumDatePickerProps = {
      * [strips collection](https://bryntum.com/products/core/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/grid/docs/api/Core/widget/DatePicker#config-dock)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/DatePicker#config-dock)
      */
     dock? : 'top'|'bottom'|'left'|'right'|'start'|'end'|'header'|'pre-header'|object
     /**
      * *Only valid if this Widget is [floating](https://bryntum.com/products/core/docs/api/Core/widget/Widget#config-floating).*
      * Set to `true` to be able to drag a widget freely on the page. Or set to an object with a ´handleSelector´
      * property which controls when a drag should start.
-     * ...
-     * [View online docs...](https://bryntum.com/products/grid/docs/api/Core/widget/DatePicker#config-draggable)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/DatePicker#config-draggable)
+     * @property {string} handleSelector CSS selector used to determine if drag can be started from a mouse-downed element inside the widget
      */
-    draggable? : boolean|{
-        handleSelector?: string
-    }
+    draggable? : boolean|object
     /**
      * This property is only valid if [multiSelect](https://bryntum.com/products/core/docs/api/Core/widget/DatePicker#config-multiSelect) is set to `'range'`
      * or `true`.
-     * ...
-     * [View online docs...](https://bryntum.com/products/grid/docs/api/Core/widget/DatePicker#config-dragSelect)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/DatePicker#config-dragSelect)
      */
     dragSelect? : boolean
     /**
      * 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/grid/docs/api/Core/widget/DatePicker#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/core/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/grid/docs/api/Core/widget/DatePicker#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/core/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 }
     /**
      * By default, the month and year are editable. Configure this as `false` to prevent that.
      */
@@ -305,8 +281,7 @@ export type BryntumDatePickerProps = {
     /**
      * 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/grid/docs/api/Core/widget/DatePicker#config-elementAttributes)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/DatePicker#config-elementAttributes)
      */
     elementAttributes? : Record<string, string|null>
     extraData? : any
@@ -332,24 +307,20 @@ export type BryntumDatePickerProps = {
     /**
      * 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/core/docs/api/Core/widget/Panel#config-strips).
-     * ...
-     * [View online docs...](https://bryntum.com/products/grid/docs/api/Core/widget/DatePicker#config-footer)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/DatePicker#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 config [object](https://bryntum.com/products/core/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/grid/docs/api/Core/widget/DatePicker#config-header)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/DatePicker#config-header)
      */
     header? : string|boolean|PanelHeader
     /**
      * A function (or the name of a function) which creates content in, and may mutate a day header element.
-     * ...
-     * [View online docs...](https://bryntum.com/products/grid/docs/api/Core/widget/DatePicker#config-headerRenderer)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/DatePicker#config-headerRenderer)
      * @param {HTMLElement} cell The header element
      * @param {number} columnIndex The day column. Will be in the range `0` to `6`
      * @param {number} weekDay The canonical day number where Monday is `0` and Sunday is `6`
@@ -368,8 +339,7 @@ export type BryntumDatePickerProps = {
     hidden? : boolean
     /**
      * *Only valid if this Widget is [floating](https://bryntum.com/products/core/docs/api/Core/widget/Widget#config-floating).*
-     * ...
-     * [View online docs...](https://bryntum.com/products/grid/docs/api/Core/widget/DatePicker#config-hideAnimation)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/DatePicker#config-hideAnimation)
      */
     hideAnimation? : boolean|object
     /**
@@ -379,8 +349,7 @@ export type BryntumDatePickerProps = {
     /**
      * 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/grid/docs/api/Core/widget/DatePicker#config-hideWhenEmpty)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/DatePicker#config-hideWhenEmpty)
      */
     hideWhenEmpty? : boolean
     /**
@@ -390,12 +359,10 @@ export type BryntumDatePickerProps = {
     highlightSelectedWeek? : boolean
     /**
      * The HTML to display initially or a function returning the markup (called at widget construction time).
-     * ...
-     * [View online docs...](https://bryntum.com/products/grid/docs/api/Core/widget/DatePicker#config-html)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/DatePicker#config-html)
      * @param {Core.widget.Widget} widget The calling Widget
-     * @returns {string}
      */
-    html? : string|((widget: Widget) => string)|DomConfig|DomConfig[]|VueConfig
+    html? : string|((widget: Widget) => void)|DomConfig|DomConfig[]|VueConfig|ReactJSX
     /**
      * The CSS class(es) to add when HTML content is being applied to this widget.
      */
@@ -411,8 +378,7 @@ export type BryntumDatePickerProps = {
     id? : string
     /**
      * Determines if the widgets read-only state should be controlled by its parent.
-     * ...
-     * [View online docs...](https://bryntum.com/products/grid/docs/api/Core/widget/DatePicker#config-ignoreParentReadOnly)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/DatePicker#config-ignoreParentReadOnly)
      */
     ignoreParentReadOnly? : boolean
     /**
@@ -423,8 +389,7 @@ export type BryntumDatePickerProps = {
      * 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/grid/docs/api/Core/widget/DatePicker#config-inputFieldAlign)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/DatePicker#config-inputFieldAlign)
      */
     inputFieldAlign? : 'start'|'end'
     /**
@@ -442,55 +407,52 @@ export type BryntumDatePickerProps = {
     /**
      * An object containing typed child widget config objects or Widgets. May also be specified
      * as an array.
-     * ...
-     * [View online docs...](https://bryntum.com/products/grid/docs/api/Core/widget/DatePicker#config-items)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/DatePicker#config-items)
      */
     items? : Record<string, CoreContainerItemConfig|MenuItemEntry>|(CoreContainerItemConfig|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/grid/docs/api/Core/widget/DatePicker#config-keyMap)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/DatePicker#config-keyMap)
      */
     keyMap? : Record<string, KeyMapConfig>
     /**
      * Convenience setting to use same label placement on all child widgets.
-     * ...
-     * [View online docs...](https://bryntum.com/products/grid/docs/api/Core/widget/DatePicker#config-labelPosition)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/DatePicker#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/grid/docs/api/Core/widget/DatePicker#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/grid/docs/api/Core/widget/DatePicker#config-layout)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/DatePicker#config-layout)
      */
     layout? : string|CoreContainerLayoutConfig
     /**
      * The CSS style properties to apply to the [contentElement](https://bryntum.com/products/core/docs/api/Core/widget/Widget#property-contentElement).
-     * ...
-     * [View online docs...](https://bryntum.com/products/grid/docs/api/Core/widget/DatePicker#config-layoutStyle)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/DatePicker#config-layoutStyle)
      */
     layoutStyle? : object
     /**
      * An array of [child item](https://bryntum.com/products/core/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/grid/docs/api/Core/widget/DatePicker#config-lazyItems)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/DatePicker#config-lazyItems)
      */
     lazyItems? : Record<string, CoreContainerItemConfig>|CoreContainerItemConfig[]|Widget[]
     /**
      * The listener set for this object.
-     * ...
-     * [View online docs...](https://bryntum.com/products/grid/docs/api/Core/widget/DatePicker#config-listeners)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/DatePicker#config-listeners)
      */
     listeners? : DatePickerListeners
     /**
      * 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/grid/docs/api/Core/widget/DatePicker#config-localeClass)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/DatePicker#config-localeClass)
      */
     localeClass? : typeof Base
     /**
@@ -502,8 +464,7 @@ export type BryntumDatePickerProps = {
      * 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/grid/docs/api/Core/widget/DatePicker#config-localizableProperties)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/DatePicker#config-localizableProperties)
      */
     localizableProperties? : string[]
     /**
@@ -534,8 +495,7 @@ export type BryntumDatePickerProps = {
     maxHeight? : string|number
     /**
      * *Only valid if this Widget is [floating](https://bryntum.com/products/core/docs/api/Core/widget/Widget#config-floating).*
-     * ...
-     * [View online docs...](https://bryntum.com/products/grid/docs/api/Core/widget/DatePicker#config-maximizeOnMobile)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/DatePicker#config-maximizeOnMobile)
      */
     maximizeOnMobile? : number|string
     /**
@@ -545,8 +505,7 @@ export type BryntumDatePickerProps = {
     maxWidth? : string|number
     /**
      * By default, day cells flex to share available Panel width equally.
-     * ...
-     * [View online docs...](https://bryntum.com/products/grid/docs/api/Core/widget/DatePicker#config-minColumnWidth)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/DatePicker#config-minColumnWidth)
      */
     minColumnWidth? : number
     /**
@@ -561,8 +520,7 @@ export type BryntumDatePickerProps = {
     minHeight? : string|number
     /**
      * By default, week rows flex to share available Panel height equally.
-     * ...
-     * [View online docs...](https://bryntum.com/products/grid/docs/api/Core/widget/DatePicker#config-minRowHeight)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/DatePicker#config-minRowHeight)
      */
     minRowHeight? : number|string
     /**
@@ -574,12 +532,10 @@ export type BryntumDatePickerProps = {
      * 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/grid/docs/api/Core/widget/DatePicker#config-monitorResize)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/DatePicker#config-monitorResize)
+     * @property {boolean} immediate Set to `true` to receive resize notifications immediately.
      */
-    monitorResize? : boolean|{
-        immediate?: boolean
-    }
+    monitorResize? : boolean|object
     /**
      * A [Month](https://bryntum.com/products/core/docs/api/Core/util/Month) Month utility object which encapsulates this Panel's month
      * and provides contextual information and navigation services.
@@ -587,23 +543,20 @@ export type BryntumDatePickerProps = {
     month? : Month|MonthConfig
     /**
      * The format string to use to create the text of the month button.
-     * ...
-     * [View online docs...](https://bryntum.com/products/grid/docs/api/Core/widget/DatePicker#config-monthButtonFormat)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/DatePicker#config-monthButtonFormat)
      */
     monthButtonFormat? : string
     /**
      * Configure as `true` to enable selecting multiple discontiguous date ranges using
      * click and Shift+click to create ranges and Ctrl+click to select/deselect individual dates.
-     * ...
-     * [View online docs...](https://bryntum.com/products/grid/docs/api/Core/widget/DatePicker#config-multiSelect)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/DatePicker#config-multiSelect)
      */
     multiSelect? : boolean|'range'|'simple'
     /**
      * An object containing default config objects which may be referenced by name in the [items](https://bryntum.com/products/core/docs/api/Core/widget/Container#config-items)
      * config. For example, a specialized [Menu](https://bryntum.com/products/core/docs/api/Core/widget/Menu) subclass may have a `namedItems` default
      * value defined like this:
-     * ...
-     * [View online docs...](https://bryntum.com/products/grid/docs/api/Core/widget/DatePicker#config-namedItems)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/DatePicker#config-namedItems)
      */
     namedItems? : Record<string, CoreContainerItemConfig>
     /**
@@ -623,8 +576,7 @@ export type BryntumDatePickerProps = {
      * Set to `true` when a widget is rendered into another widget's [contentElement](https://bryntum.com/products/core/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/core/docs/api/Core/widget/Widget#property-contentElement).
-     * ...
-     * [View online docs...](https://bryntum.com/products/grid/docs/api/Core/widget/DatePicker#config-positioned)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/DatePicker#config-positioned)
      */
     positioned? : boolean
     /**
@@ -635,45 +587,45 @@ export type BryntumDatePickerProps = {
     /**
      * 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/grid/docs/api/Core/widget/DatePicker#config-readOnly)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/DatePicker#config-readOnly)
      */
     readOnly? : boolean
     /**
      * [Record](https://bryntum.com/products/core/docs/api/Core/data/Model) whose values will be used to populate fields in the container.
-     * ...
-     * [View online docs...](https://bryntum.com/products/grid/docs/api/Core/widget/DatePicker#config-record)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/DatePicker#config-record)
      */
     record? : Model
     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/grid/docs/api/Core/widget/DatePicker#config-rendition)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/DatePicker#config-rendition)
      */
     rendition? : string|Record<string, string>|null
     /**
      * Configure as `true` to have the component display a translucent ripple when its
      * [focusElement](https://bryntum.com/products/core/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/grid/docs/api/Core/widget/DatePicker#config-ripple)
-     */
-    ripple? : boolean|{
-        delegate?: string
-        color?: string
-        radius?: number
-        clip?: string
-    }
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/DatePicker#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|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/grid/docs/api/Core/widget/DatePicker#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/grid/docs/api/Core/widget/DatePicker#config-rtl)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/DatePicker#config-rtl)
      */
     rtl? : boolean
     /**
@@ -681,8 +633,7 @@ export type BryntumDatePickerProps = {
      * 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/grid/docs/api/Core/widget/DatePicker#config-scrollable)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/DatePicker#config-scrollable)
      */
     scrollable? : boolean|ScrollerConfig|Scroller
     /**
@@ -693,8 +644,7 @@ export type BryntumDatePickerProps = {
     /**
      * If [multiSelect](https://bryntum.com/products/core/docs/api/Core/widget/DatePicker#config-multiSelect) is configured as `true`, this is an array of dates
      * which are selected. There may be multiple, discontiguous date ranges.
-     * ...
-     * [View online docs...](https://bryntum.com/products/grid/docs/api/Core/widget/DatePicker#config-selection)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/DatePicker#config-selection)
      */
     selection? : Date[]|string[]
     /**
@@ -703,8 +653,7 @@ export type BryntumDatePickerProps = {
     shadePastDates? : boolean
     /**
      * *Only valid if this Widget is [floating](https://bryntum.com/products/core/docs/api/Core/widget/Widget#config-floating).*
-     * ...
-     * [View online docs...](https://bryntum.com/products/grid/docs/api/Core/widget/DatePicker#config-showAnimation)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/DatePicker#config-showAnimation)
      */
     showAnimation? : boolean|object
     /**
@@ -725,30 +674,26 @@ export type BryntumDatePickerProps = {
     span? : number
     /**
      * This value can be one of the following:
-     * ...
-     * [View online docs...](https://bryntum.com/products/grid/docs/api/Core/widget/DatePicker#config-stateful)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/DatePicker#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/core/docs/api/Core/mixin/State#function-saveState).
-     * ...
-     * [View online docs...](https://bryntum.com/products/grid/docs/api/Core/widget/DatePicker#config-statefulEvents)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/DatePicker#config-statefulEvents)
      */
     statefulEvents? : object|string[]
     /**
      * The key to use when saving this object's state in the [stateProvider](https://bryntum.com/products/core/docs/api/Core/mixin/State#config-stateProvider). If this config is
      * not assigned, and [stateful](https://bryntum.com/products/core/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/grid/docs/api/Core/widget/DatePicker#config-stateId)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/DatePicker#config-stateId)
      */
     stateId? : string
     /**
      * The `StateProvider` to use to save and restore this object's [state](https://bryntum.com/products/core/docs/api/Core/mixin/State#property-state). By default, `state`
      * will be saved using the [default state provider](https://bryntum.com/products/core/docs/api/Core/state/StateProvider#property-instance-static).
-     * ...
-     * [View online docs...](https://bryntum.com/products/grid/docs/api/Core/widget/DatePicker#config-stateProvider)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/DatePicker#config-stateProvider)
      */
     stateProvider? : StateProvider
     /**
@@ -760,23 +705,20 @@ export type BryntumDatePickerProps = {
      * An object containing widgets keyed by name. By default (when no `type` is given), strips are
      * [toolbars](https://bryntum.com/products/core/docs/api/Core/widget/Toolbar). If you want to pass an array, you can use
      * the toolbar's [items](https://bryntum.com/products/core/docs/api/Core/widget/Container#config-items).
-     * ...
-     * [View online docs...](https://bryntum.com/products/grid/docs/api/Core/widget/DatePicker#config-strips)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/DatePicker#config-strips)
      */
     strips? : Record<string, CoreContainerItemConfig>
     /**
      * A configuration for the [tab](https://bryntum.com/products/core/docs/api/Core/widget/Tab) created for this widget when it is placed in a
      * [TabPanel](https://bryntum.com/products/core/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/grid/docs/api/Core/widget/DatePicker#config-tab)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/DatePicker#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/core/docs/api/Core/widget/TabBar) when this container is the active tab.
-     * ...
-     * [View online docs...](https://bryntum.com/products/grid/docs/api/Core/widget/DatePicker#config-tabBarItems)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/DatePicker#config-tabBarItems)
      */
     tabBarItems? : ToolbarItems[]|Widget[]
     /**
@@ -787,35 +729,30 @@ export type BryntumDatePickerProps = {
      * A Config object representing the configuration of a [Toolbar](https://bryntum.com/products/core/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/grid/docs/api/Core/widget/DatePicker#config-tbar)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/DatePicker#config-tbar)
      */
     tbar? : (CoreContainerItemConfig|string)[]|ToolbarConfig|PagingToolbarConfig|null
     /**
      * Text alignment: 'left', 'center' or 'right'. Also accepts direction neutral 'start' and 'end'.
-     * ...
-     * [View online docs...](https://bryntum.com/products/grid/docs/api/Core/widget/DatePicker#config-textAlign)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/DatePicker#config-textAlign)
      */
     textAlign? : 'left'|'center'|'right'|'start'|'end'
     /**
      * Specify `true` for a container used to show text markup. It will apply the CSS class `b-text-content`
      * which specifies a default max-width that makes long text more readable.
-     * ...
-     * [View online docs...](https://bryntum.com/products/grid/docs/api/Core/widget/DatePicker#config-textContent)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/DatePicker#config-textContent)
      */
     textContent? : boolean
     /**
      * A config object to create a tooltip which will show on hover of a date cell including disabled, weekend,
      * and "other month" cells.
-     * ...
-     * [View online docs...](https://bryntum.com/products/grid/docs/api/Core/widget/DatePicker#config-tip)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/DatePicker#config-tip)
      */
     tip? : TooltipConfig
     /**
      * 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/grid/docs/api/Core/widget/DatePicker#config-title)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/DatePicker#config-title)
      */
     title? : string
     /**
@@ -826,14 +763,12 @@ export type BryntumDatePickerProps = {
      * The [tools](https://bryntum.com/products/core/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/core/docs/api/Core/widget/mixin/Toolable#property-tools)` property.
-     * ...
-     * [View online docs...](https://bryntum.com/products/grid/docs/api/Core/widget/DatePicker#config-tools)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/DatePicker#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/grid/docs/api/Core/widget/DatePicker#config-tooltip)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/DatePicker#config-tooltip)
      */
     tooltip? : string|TooltipConfig|null
     /**
@@ -847,8 +782,7 @@ export type BryntumDatePickerProps = {
      * 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/grid/docs/api/Core/widget/DatePicker#config-ui)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/DatePicker#config-ui)
      */
     ui? : 'plain'|'toolbar'|string|object
     /**
@@ -861,8 +795,7 @@ export type BryntumDatePickerProps = {
     weekendCls? : string
     /**
      * A function (or the name of a function) which creates content in, and may mutate the week cell element at the start of a week row.
-     * ...
-     * [View online docs...](https://bryntum.com/products/grid/docs/api/Core/widget/DatePicker#config-weekRenderer)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/DatePicker#config-weekRenderer)
      * @param {HTMLElement} weekCell The header element
      * @param {number[]} week An array containing `[year, weekNumber]`
      * @returns {string,DomConfig,void}
@@ -886,14 +819,12 @@ export type BryntumDatePickerProps = {
     width? : string|number
     /**
      * The x position for the widget.
-     * ...
-     * [View online docs...](https://bryntum.com/products/grid/docs/api/Core/widget/DatePicker#config-x)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/DatePicker#config-x)
      */
     x? : number
     /**
      * The y position for the widget.
-     * ...
-     * [View online docs...](https://bryntum.com/products/grid/docs/api/Core/widget/DatePicker#config-y)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/DatePicker#config-y)
      */
     y? : number
 
@@ -944,8 +875,7 @@ export type BryntumDatePickerProps = {
     onBeforeStateSave? : ((event: { state: any }) => Promise<boolean>|boolean|void)|string
     /**
      * Fires when any other event is fired from the object.
-     * ...
-     * [View online docs...](https://bryntum.com/products/grid/docs/api/Core/widget/DatePicker#event-catchAll)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/DatePicker#event-catchAll)
      * @param {object} event Event object
      * @param {{[key: string]: any, type: string}} event.event The Object that contains event details
      * @param {string} event.event.type The type of the event which is caught by the listener
@@ -1036,8 +966,7 @@ export type BryntumDatePickerProps = {
     /**
      * Triggered when a widget which had been in a non-visible state for any reason
      * achieves visibility.
-     * ...
-     * [View online docs...](https://bryntum.com/products/grid/docs/api/Core/widget/DatePicker#event-paint)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/DatePicker#event-paint)
      * @param {object} event Event object
      * @param {Core.widget.Widget} event.source The widget being painted.
      * @param {boolean} event.firstPaint `true` if this is the first paint.
@@ -1180,6 +1109,7 @@ export class BryntumDatePicker extends React.Component<BryntumDatePickerProps> {
         'preventTooltipOnTouch',
         'relayStoreEvents',
         'ripple',
+        'role',
         'rootElement',
         'scrollAction',
         'showAnimation',
@@ -1234,6 +1164,7 @@ export class BryntumDatePicker extends React.Component<BryntumDatePickerProps> {
         'items',
         'keyMap',
         'labelPosition',
+        'labelWidth',
         'layout',
         'layoutStyle',
         'margin',
@@ -1289,11 +1220,6 @@ export class BryntumDatePicker extends React.Component<BryntumDatePickerProps> {
     ];
 
     static propertyNames = [
-        'anchorSize',
-        'focusVisible',
-        'hasChanges',
-        'isSettingValues',
-        'isValid',
         'parent',
         'state',
         'values'