@bryntum/core-react-thin 7.2.4 → 7.3.0

package/src/BryntumMenu.tsx

@@ -3,7 +3,7 @@
  */
 // eslint-disable-next-line @typescript-eslint/no-unused-vars
 import React, { RefObject } from 'react';
-import { AlignSpec, Base, Color, Container, CoreContainerItemConfig, CoreContainerLayoutConfig, DomConfig, KeyMapConfig, Layout, MaskConfig, Menu, MenuItem, MenuItemConfig, MenuItemEntry, MenuListeners, Model, PagingToolbarConfig, Panel, PanelCollapserConfig, PanelCollapserOverlayConfig, PanelHeader, Popup, Rectangle, StateProvider, TabConfig, Tool, ToolConfig, ToolbarConfig, ToolbarItems, TooltipConfig, VueConfig, Widget } from '@bryntum/core-thin';
+import { AlignSpec, Base, Color, Container, CoreContainerItemConfig, CoreContainerLayoutConfig, DomConfig, KeyMapConfig, Layout, MaskConfig, Menu, MenuItem, MenuItemConfig, MenuItemEntry, MenuListeners, Model, PagingToolbarConfig, Panel, PanelCollapserConfig, PanelCollapserOverlayConfig, PanelHeader, Popup, ReactJSX, Rectangle, StateProvider, TabConfig, Tool, ToolConfig, ToolbarConfig, ToolbarItems, TooltipConfig, VueConfig, Widget } from '@bryntum/core-thin';
 
 import { createWidget, shouldComponentUpdate, processWidgetContent } from './WrapperHelper.js';
 
@@ -12,14 +12,12 @@ export type BryntumMenuProps = {
     /**
      * 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/Menu#config-adopt)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/Menu#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/Menu#config-align)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/Menu#config-align)
      */
     align? : AlignSpec|string
     /**
@@ -41,22 +39,19 @@ export type BryntumMenuProps = {
     /**
      * 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/Menu#config-ariaDescription)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/Menu#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/Menu#config-ariaLabel)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/Menu#config-ariaLabel)
      */
     ariaLabel? : string
     /**
      * By default, a Popup is transient, and will [close](https://bryntum.com/products/core/docs/api/Core/widget/Popup#function-close) when the user clicks or
      * taps outside its owned widgets and when focus moves outside its owned widgets.
-     * ...
-     * [View online docs...](https://bryntum.com/products/grid/docs/api/Core/widget/Menu#config-autoClose)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/Menu#config-autoClose)
      */
     autoClose? : boolean
     /**
@@ -71,14 +66,12 @@ export type BryntumMenuProps = {
     /**
      * 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/Menu#config-bbar)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/Menu#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/Menu#config-bodyCls)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/Menu#config-bodyCls)
      */
     bodyCls? : string|object
     /**
@@ -88,21 +81,18 @@ export type BryntumMenuProps = {
     /**
      * 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/Menu#config-bubbleEvents)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/Menu#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/Menu#config-callOnFunctions)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/Menu#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/Menu#config-catchEventHandlerExceptions)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/Menu#config-catchEventHandlerExceptions)
      */
     catchEventHandlerExceptions? : boolean
     /**
@@ -120,8 +110,7 @@ export type BryntumMenuProps = {
     /**
      * The action to take when calling the [close](https://bryntum.com/products/core/docs/api/Core/widget/Popup#function-close) method.
      * By default, the popup is hidden.
-     * ...
-     * [View online docs...](https://bryntum.com/products/grid/docs/api/Core/widget/Menu#config-closeAction)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/Menu#config-closeAction)
      */
     closeAction? : 'hide'|'destroy'
     /**
@@ -132,8 +121,7 @@ export type BryntumMenuProps = {
      * 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/Menu#config-cls)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/Menu#config-cls)
      */
     cls? : string|object
     /**
@@ -143,15 +131,13 @@ export type BryntumMenuProps = {
     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/Menu#config-collapsible)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/Menu#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/Menu#config-color)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/Menu#config-color)
      */
     color? : Color
     /**
@@ -175,8 +161,7 @@ export type BryntumMenuProps = {
      * 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/Menu#config-contentElementCls)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/Menu#config-contentElementCls)
      */
     contentElementCls? : string|object
     /**
@@ -196,8 +181,7 @@ export type BryntumMenuProps = {
     /**
      * 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/Menu#config-defaultFocus)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/Menu#config-defaultFocus)
      * @param {Core.widget.Widget} widget Widget passed to method
      * @returns {boolean} truthy value if widget is the default one
      */
@@ -207,16 +191,15 @@ export type BryntumMenuProps = {
      */
     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/Menu#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/Menu#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/Menu#config-disabled)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/Menu#config-disabled)
      */
     disabled? : boolean|'inert'
     /**
@@ -224,35 +207,31 @@ export type BryntumMenuProps = {
      * [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/Menu#config-dock)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/Menu#config-dock)
      */
     dock? : 'top'|'bottom'|'left'|'right'|'start'|'end'|'header'|'pre-header'|object
     /**
      * Set to `false` to prevent dragging the popup element.
+     * @property {string} handleSelector CSS selector used to determine if a drag operation can be started from a mouse-downed element inside the popup
      */
-    draggable? : boolean|{
-        handleSelector?: string
-    }
+    draggable? : boolean|object
     /**
      * 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/Menu#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/Menu#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 }
     /**
      * 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/Menu#config-elementAttributes)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/Menu#config-elementAttributes)
      */
     elementAttributes? : Record<string, string|null>
     extraData? : any
@@ -281,22 +260,19 @@ export type BryntumMenuProps = {
     /**
      * 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/Menu#config-footer)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/Menu#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
     /**
      * DOM element to attach popup.
      */
     forElement? : HTMLElement
     /**
      * 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/Menu#config-header)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/Menu#config-header)
      */
     header? : string|boolean|PanelHeader
     /**
@@ -311,25 +287,21 @@ export type BryntumMenuProps = {
     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/Menu#config-hideAnimation)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/Menu#config-hideAnimation)
      */
     hideAnimation? : boolean|object
     /**
      * 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/Menu#config-hideWhenEmpty)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/Menu#config-hideWhenEmpty)
      */
     hideWhenEmpty? : 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/Menu#config-html)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/Menu#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.
      */
@@ -345,16 +317,14 @@ export type BryntumMenuProps = {
     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/Menu#config-ignoreParentReadOnly)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/Menu#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/grid/docs/api/Core/widget/Menu#config-inputFieldAlign)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/Menu#config-inputFieldAlign)
      */
     inputFieldAlign? : 'start'|'end'
     /**
@@ -372,55 +342,52 @@ export type BryntumMenuProps = {
     /**
      * 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/Menu#config-items)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/Menu#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/Menu#config-keyMap)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/Menu#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/Menu#config-labelPosition)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/Menu#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/Menu#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/Menu#config-layout)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/Menu#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/Menu#config-layoutStyle)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/Menu#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/Menu#config-lazyItems)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/Menu#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/Menu#config-listeners)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/Menu#config-listeners)
      */
     listeners? : MenuListeners
     /**
      * 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/Menu#config-localeClass)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/Menu#config-localeClass)
      */
     localeClass? : typeof Base
     /**
@@ -432,8 +399,7 @@ export type BryntumMenuProps = {
      * 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/Menu#config-localizableProperties)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/Menu#config-localizableProperties)
      */
     localizableProperties? : string[]
     /**
@@ -467,8 +433,7 @@ export type BryntumMenuProps = {
     maximized? : 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/Menu#config-maximizeOnMobile)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/Menu#config-maximizeOnMobile)
      */
     maximizeOnMobile? : number|string
     /**
@@ -489,37 +454,31 @@ export type BryntumMenuProps = {
     /**
      * Optionally show an opaque mask below this Popup when shown.
      * Configure this as `true` to show the mask.
-     * ...
-     * [View online docs...](https://bryntum.com/products/grid/docs/api/Core/widget/Menu#config-modal)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/Menu#config-modal)
+     * @property {boolean} [closeOnMaskTap] Specify as `true` to close when mask is tapped.
+     * @property {boolean} [transparent] Specify as `true` to use a transparent mask.
      */
-    modal? : boolean|{
-        closeOnMaskTap?: boolean
-        transparent?: boolean
-    }
+    modal? : boolean|object
     /**
      * 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/Menu#config-monitorResize)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/Menu#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/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/Menu#config-namedItems)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/Menu#config-namedItems)
      */
     namedItems? : Record<string, CoreContainerItemConfig>
     /**
      * 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/Menu#config-positioned)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/Menu#config-positioned)
      */
     positioned? : boolean
     /**
@@ -530,58 +489,64 @@ export type BryntumMenuProps = {
     /**
      * 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/Menu#config-readOnly)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/Menu#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/Menu#config-record)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/Menu#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/Menu#config-rendition)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/Menu#config-rendition)
      */
     rendition? : string|Record<string, string>|null
     /**
      * Configure this property to allow the widget/component to be resized. Pressing <kbd>Shift</kbd> while resizing will
      * constrain the aspect ratio.
-     * ...
-     * [View online docs...](https://bryntum.com/products/grid/docs/api/Core/widget/Menu#config-resizable)
-     */
-    resizable? : boolean|{
-        minWidth?: number
-        maxWidth?: number
-        minHeight?: number
-        maxHeight?: number
-        handles?: object
-    }
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/Menu#config-resizable)
+     * @property {number} [resizable.minWidth] The minimum width of the element.
+     * @property {number} [resizable.maxWidth] The maximum width of the element.
+     * @property {number} [resizable.minHeight] The minimum height of the element.
+     * @property {number} [resizable.maxHeight] The maximum height of the element
+     * @property {object} [resizable.handles] An object controlling which edges/corners are resizable.
+     * @property {boolean} [resizable.handles.topStart] Resizable from top-start corner
+     * @property {boolean} [resizable.handles.top] Resizable from top edge
+     * @property {boolean} [resizable.handles.topEnd] Resizable from top-end corner
+     * @property {boolean} [resizable.handles.end] Resizable from end edge
+     * @property {boolean} [resizable.handles.bottomEnd] Resizable from bottom-end corner
+     * @property {boolean} [resizable.handles.bottom] Resizable from bottom edge
+     * @property {boolean} [resizable.handles.bottomStart] Resizable from bottom-start corner
+     * @property {boolean} [resizable.handles.start] Resizable from start edge
+     */
+    resizable? : boolean|{ minWidth?: number, maxWidth?: number, minHeight?: number, maxHeight?: number, handles?: { topStart?: boolean, top?: boolean, topEnd?: boolean, end?: boolean, bottomEnd?: boolean, bottom?: boolean, bottomStart?: boolean, start?: boolean } }
     /**
      * 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/Menu#config-ripple)
-     */
-    ripple? : boolean|{
-        delegate?: string
-        color?: string
-        radius?: number
-        clip?: string
-    }
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/Menu#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/Menu#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/Menu#config-rtl)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/Menu#config-rtl)
      */
     rtl? : boolean
     /**
@@ -591,8 +556,7 @@ export type BryntumMenuProps = {
     scrollAction? : 'hide'|'realign'|null
     /**
      * *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/Menu#config-showAnimation)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/Menu#config-showAnimation)
      */
     showAnimation? : boolean|object
     /**
@@ -610,30 +574,26 @@ export type BryntumMenuProps = {
     span? : number
     /**
      * This value can be one of the following:
-     * ...
-     * [View online docs...](https://bryntum.com/products/grid/docs/api/Core/widget/Menu#config-stateful)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/Menu#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/Menu#config-statefulEvents)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/Menu#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/Menu#config-stateId)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/Menu#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/Menu#config-stateProvider)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/Menu#config-stateProvider)
      */
     stateProvider? : StateProvider
     /**
@@ -645,23 +605,20 @@ export type BryntumMenuProps = {
      * 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/Menu#config-strips)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/Menu#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/Menu#config-tab)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/Menu#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/Menu#config-tabBarItems)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/Menu#config-tabBarItems)
      */
     tabBarItems? : ToolbarItems[]|Widget[]
     /**
@@ -672,42 +629,36 @@ export type BryntumMenuProps = {
      * 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/Menu#config-tbar)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/Menu#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/Menu#config-textAlign)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/Menu#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/Menu#config-textContent)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/Menu#config-textContent)
      */
     textContent? : boolean
     /**
      * 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/Menu#config-title)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/Menu#config-title)
      */
     title? : string
     /**
      * 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/Menu#config-tools)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/Menu#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/Menu#config-tooltip)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/Menu#config-tooltip)
      */
     tooltip? : string|TooltipConfig|null
     /**
@@ -720,8 +671,7 @@ export type BryntumMenuProps = {
      * 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/Menu#config-ui)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/Menu#config-ui)
      */
     ui? : 'plain'|'toolbar'|string|object
     /**
@@ -737,14 +687,12 @@ export type BryntumMenuProps = {
     width? : string|number
     /**
      * The x position for the widget.
-     * ...
-     * [View online docs...](https://bryntum.com/products/grid/docs/api/Core/widget/Menu#config-x)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/Menu#config-x)
      */
     x? : number
     /**
      * The y position for the widget.
-     * ...
-     * [View online docs...](https://bryntum.com/products/grid/docs/api/Core/widget/Menu#config-y)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/Menu#config-y)
      */
     y? : number
 
@@ -796,8 +744,7 @@ export type BryntumMenuProps = {
     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/Menu#event-catchAll)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/Menu#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
@@ -866,8 +813,7 @@ export type BryntumMenuProps = {
     onHide? : ((event: { source: Widget }) => void)|string
     /**
      * A descendant menu item has been activated.
-     * ...
-     * [View online docs...](https://bryntum.com/products/grid/docs/api/Core/widget/Menu#event-item)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/Menu#event-item)
      * @param {object} event Event object
      * @param {Core.widget.MenuItem} event.item The menu item which is being actioned.
      * @param {Core.widget.Menu} event.menu Menu containing the menu item
@@ -876,8 +822,7 @@ export type BryntumMenuProps = {
     /**
      * 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/Menu#event-paint)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/Menu#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.
@@ -912,8 +857,7 @@ export type BryntumMenuProps = {
     onShow? : ((event: { source: Widget }) => void)|string
     /**
      * The checked state of a descendant menu item has changed.
-     * ...
-     * [View online docs...](https://bryntum.com/products/grid/docs/api/Core/widget/Menu#event-toggle)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/Menu#event-toggle)
      * @param {object} event Event object
      * @param {Core.widget.MenuItem} event.item The menu item whose checked state changed.
      * @param {Core.widget.Menu} event.menu Menu containing the menu item
@@ -996,6 +940,7 @@ export class BryntumMenu extends React.Component<BryntumMenuProps> {
         'preventTooltipOnTouch',
         'relayStoreEvents',
         'ripple',
+        'role',
         'rootElement',
         'scrollAction',
         'showAnimation',
@@ -1041,6 +986,7 @@ export class BryntumMenu extends React.Component<BryntumMenuProps> {
         'items',
         'keyMap',
         'labelPosition',
+        'labelWidth',
         'layout',
         'layoutStyle',
         'margin',
@@ -1090,13 +1036,7 @@ export class BryntumMenu extends React.Component<BryntumMenuProps> {
     ];
 
     static propertyNames = [
-        'anchorSize',
-        'focusVisible',
-        'hasChanges',
-        'isSettingValues',
-        'isValid',
         'parent',
-        'parentMenu',
         'selectedElement',
         'state',
         'values'