@bryntum/core-react-thin 7.2.4 → 7.3.1

package/src/BryntumList.tsx

@@ -3,7 +3,7 @@
  */
 // eslint-disable-next-line @typescript-eslint/no-unused-vars
 import React, { RefObject } from 'react';
-import { AlignSpec, Base, Collection, CollectionConfig, Color, DomConfig, KeyMapConfig, List, ListListeners, MaskConfig, Model, ModelConfig, Rectangle, Scroller, ScrollerConfig, Store, StoreConfig, TabConfig, TooltipConfig, VueConfig, Widget } from '@bryntum/core-thin';
+import { AlignSpec, Base, Collection, CollectionConfig, Color, DomConfig, KeyMapConfig, List, ListListeners, MaskConfig, Model, ModelConfig, ReactJSX, Rectangle, Scroller, ScrollerConfig, Store, StoreConfig, TabConfig, TooltipConfig, VueConfig, Widget } from '@bryntum/core-thin';
 
 import { createWidget, shouldComponentUpdate, processWidgetContent } from './WrapperHelper.js';
 
@@ -17,14 +17,12 @@ export type BryntumListProps = {
     /**
      * 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/List#config-adopt)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/List#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/List#config-align)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/List#config-align)
      */
     align? : AlignSpec|string
     /**
@@ -51,35 +49,30 @@ export type BryntumListProps = {
     /**
      * 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/List#config-ariaDescription)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/List#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/List#config-ariaLabel)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/List#config-ariaLabel)
      */
     ariaLabel? : string
     /**
      * 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/List#config-bubbleEvents)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/List#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/List#config-callOnFunctions)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/List#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/List#config-catchEventHandlerExceptions)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/List#config-catchEventHandlerExceptions)
      */
     catchEventHandlerExceptions? : boolean
     /**
@@ -95,8 +88,7 @@ export type BryntumListProps = {
      * 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/List#config-cls)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/List#config-cls)
      */
     cls? : string|object
     /**
@@ -106,8 +98,7 @@ export type BryntumListProps = {
     /**
      * 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/List#config-color)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/List#config-color)
      */
     color? : Color
     /**
@@ -131,8 +122,7 @@ export type BryntumListProps = {
      * 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/List#config-contentElementCls)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/List#config-contentElementCls)
      */
     contentElementCls? : string|object
     /**
@@ -150,16 +140,15 @@ export type BryntumListProps = {
      */
     defaultBindProperty? : string
     /**
-     * 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/List#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/List#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/List#config-disabled)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/List#config-disabled)
      */
     disabled? : boolean|'inert'
     /**
@@ -171,25 +160,21 @@ export type BryntumListProps = {
      * [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/List#config-dock)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/List#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/List#config-draggable)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/List#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
     /**
      * 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/List#config-elementAttributes)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/List#config-elementAttributes)
      */
     elementAttributes? : Record<string, string|null>
     /**
@@ -244,18 +229,15 @@ export type BryntumListProps = {
     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/List#config-hideAnimation)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/List#config-hideAnimation)
      */
     hideAnimation? : boolean|object
     /**
      * 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/List#config-html)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/List#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.
      */
@@ -266,8 +248,7 @@ export type BryntumListProps = {
     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/List#config-ignoreParentReadOnly)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/List#config-ignoreParentReadOnly)
      */
     ignoreParentReadOnly? : boolean
     /**
@@ -301,22 +282,19 @@ export type BryntumListProps = {
      * 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/List#config-keyMap)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/List#config-keyMap)
      */
     keyMap? : Record<string, KeyMapConfig>
     /**
      * The listener set for this object.
-     * ...
-     * [View online docs...](https://bryntum.com/products/grid/docs/api/Core/widget/List#config-listeners)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/List#config-listeners)
      */
     listeners? : ListListeners
     /**
      * 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/List#config-localeClass)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/List#config-localeClass)
      */
     localeClass? : typeof Base
     /**
@@ -328,8 +306,7 @@ export type BryntumListProps = {
      * 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/List#config-localizableProperties)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/List#config-localizableProperties)
      */
     localizableProperties? : string[]
     /**
@@ -355,8 +332,7 @@ export type BryntumListProps = {
     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/List#config-maximizeOnMobile)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/List#config-maximizeOnMobile)
      */
     maximizeOnMobile? : number|string
     /**
@@ -378,12 +354,10 @@ export type BryntumListProps = {
      * 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/List#config-monitorResize)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/List#config-monitorResize)
+     * @property {boolean} immediate Set to `true` to receive resize notifications immediately.
      */
-    monitorResize? : boolean|{
-        immediate?: boolean
-    }
+    monitorResize? : boolean|object
     /**
      * Configure as `true` to allow multi select and add checkboxes to the items
      */
@@ -392,8 +366,7 @@ export type BryntumListProps = {
      * 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/List#config-positioned)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/List#config-positioned)
      */
     positioned? : boolean
     /**
@@ -404,8 +377,7 @@ export type BryntumListProps = {
     /**
      * 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/List#config-readOnly)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/List#config-readOnly)
      */
     readOnly? : boolean
     relayStoreEvents? : boolean
@@ -413,23 +385,26 @@ export type BryntumListProps = {
      * 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/List#config-ripple)
-     */
-    ripple? : boolean|{
-        delegate?: string
-        color?: string
-        radius?: number
-        clip?: string
-    }
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/List#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/List#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/List#config-rtl)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/List#config-rtl)
      */
     rtl? : boolean
     /**
@@ -437,8 +412,7 @@ export type BryntumListProps = {
      * 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/List#config-scrollable)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/List#config-scrollable)
      */
     scrollable? : boolean|ScrollerConfig|Scroller
     /**
@@ -454,14 +428,12 @@ export type BryntumListProps = {
     /**
      * A [Collection](https://bryntum.com/products/core/docs/api/Core/util/Collection), or Collection config object to use to contain this List's selected
      * records.
-     * ...
-     * [View online docs...](https://bryntum.com/products/grid/docs/api/Core/widget/List#config-selected)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/List#config-selected)
      */
     selected? : object[]|number[]|string[]|Collection|CollectionConfig|CollectionConfig[]
     /**
      * *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/List#config-showAnimation)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/List#config-showAnimation)
      */
     showAnimation? : boolean|object
     /**
@@ -475,16 +447,14 @@ export type BryntumListProps = {
     /**
      * A [Store](https://bryntum.com/products/core/docs/api/Core/data/Store) which provides the records which map to List items. Each record is passed through the
      * [itemTpl](https://bryntum.com/products/core/docs/api/Core/widget/List#config-itemTpl) to produce the DOM structure of the List. May be generated from an array of [items](#Core/widget/List#config-items).
-     * ...
-     * [View online docs...](https://bryntum.com/products/grid/docs/api/Core/widget/List#config-store)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/List#config-store)
      */
     store? : object|object[]|StoreConfig|Store|StoreConfig[]
     /**
      * 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/List#config-tab)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/List#config-tab)
      */
     tab? : boolean|TabConfig
     /**
@@ -493,8 +463,7 @@ export type BryntumListProps = {
     tag? : string
     /**
      * 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/List#config-textAlign)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/List#config-textAlign)
      */
     textAlign? : 'left'|'center'|'right'|'start'|'end'
     /**
@@ -507,8 +476,7 @@ export type BryntumListProps = {
     toggleAllIfCtrlPressed? : boolean
     /**
      * 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/List#config-tooltip)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/List#config-tooltip)
      */
     tooltip? : string|TooltipConfig|null
     /**
@@ -522,16 +490,14 @@ export type BryntumListProps = {
      * 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/List#config-ui)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/List#config-ui)
      */
     ui? : string|object
     /**
      * Controls virtualization of list items using the `IntersectionObserver` API to render items only when
      * scrolled into view. This is only useful for lists with complex markup, for simple lists it likely adds
      * overhead.
-     * ...
-     * [View online docs...](https://bryntum.com/products/grid/docs/api/Core/widget/List#config-virtualize)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/List#config-virtualize)
      */
     virtualize? : boolean|number
     /**
@@ -547,14 +513,12 @@ export type BryntumListProps = {
     width? : string|number
     /**
      * The x position for the widget.
-     * ...
-     * [View online docs...](https://bryntum.com/products/grid/docs/api/Core/widget/List#config-x)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/List#config-x)
      */
     x? : number
     /**
      * The y position for the widget.
-     * ...
-     * [View online docs...](https://bryntum.com/products/grid/docs/api/Core/widget/List#config-y)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/List#config-y)
      */
     y? : number
 
@@ -570,7 +534,7 @@ export type BryntumListProps = {
      * @param {object} event Event object
      * @param {Core.widget.Widget} event.source The widget being hidden.
      */
-    onBeforeHide? : ((event: { source: Widget }) => Promise<boolean>|boolean|void)|string
+    onBeforeHide? : ((event: { source: Widget }) => boolean|void)|string
     /**
      * User going to activate an item in the list either by pointer or keyboard.
      * The active record, list item index, and the triggering event are passed.
@@ -582,7 +546,7 @@ export type BryntumListProps = {
      * @param {number} event.index List item index
      * @param {Event} event.event Triggering event
      */
-    onBeforeItem? : ((event: { source: List, item: HTMLElement, record: Model, index: number, event: Event }) => Promise<boolean>|boolean|void)|string
+    onBeforeItem? : ((event: { source: List, item: HTMLElement, record: Model, index: number, event: Event }) => boolean|void)|string
     /**
      * Triggered before a widget is shown. Return `false` to prevent the action.
      * @param {object} event Event object
@@ -591,8 +555,7 @@ export type BryntumListProps = {
     onBeforeShow? : ((event: { source: Widget|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/List#event-catchAll)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/List#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
@@ -654,8 +617,7 @@ export type BryntumListProps = {
     /**
      * 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/List#event-paint)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/List#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.
@@ -760,6 +722,7 @@ export class BryntumList extends React.Component<BryntumListProps> {
         'preventTooltipOnTouch',
         'relayStoreEvents',
         'ripple',
+        'role',
         'rootElement',
         'scrollAction',
         'selectAllItem',
@@ -840,8 +803,6 @@ export class BryntumList extends React.Component<BryntumListProps> {
     ];
 
     static propertyNames = [
-        'anchorSize',
-        'focusVisible',
         'parent'
     ];