@bryntum/core-react-thin 7.2.4 → 7.3.0

package/src/BryntumChatPanel.tsx

@@ -3,7 +3,7 @@
  */
 // eslint-disable-next-line @typescript-eslint/no-unused-vars
 import React, { RefObject } from 'react';
-import { AlignSpec, Base, ChatMessageModelConfig, ChatPanel, ChatPanelListeners, Color, Container, CoreContainerItemConfig, CoreContainerLayoutConfig, DomConfig, KeyMapConfig, Layout, MaskConfig, MenuItemConfig, MenuItemEntry, Model, PagingToolbarConfig, Panel, PanelCollapserConfig, PanelCollapserOverlayConfig, PanelHeader, Rectangle, Scroller, ScrollerConfig, StateProvider, Store, TabConfig, Tool, ToolConfig, ToolbarConfig, ToolbarItems, TooltipConfig, VueConfig, Widget } from '@bryntum/core-thin';
+import { AlignSpec, Base, ChatMessageModelConfig, ChatPanel, ChatPanelListeners, Color, Container, CoreContainerItemConfig, CoreContainerLayoutConfig, DomConfig, KeyMapConfig, Layout, MaskConfig, MenuItemConfig, MenuItemEntry, Model, 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';
 
@@ -12,14 +12,12 @@ export type BryntumChatPanelProps = {
     /**
      * 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/chat/ChatPanel#config-adopt)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/chat/ChatPanel#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/chat/ChatPanel#config-align)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/chat/ChatPanel#config-align)
      */
     align? : AlignSpec|string
     /**
@@ -33,6 +31,10 @@ export type BryntumChatPanelProps = {
      * `true` to show a connector arrow pointing to the align target.
      */
     anchor? : boolean
+    /**
+     * Set to `true` to animate incoming messages with a character-by-character typing effect.
+     */
+    animateTyping? : boolean
     /**
      * Element (or the id of an element) to append this widget's element to. Can be configured, or set once at
      * runtime. To access the element of a rendered widget, see [element](https://bryntum.com/products/core/docs/api/Core/widget/Widget#property-element).
@@ -41,15 +43,13 @@ export type BryntumChatPanelProps = {
     /**
      * 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/chat/ChatPanel#config-ariaDescription)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/chat/ChatPanel#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/chat/ChatPanel#config-ariaLabel)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/chat/ChatPanel#config-ariaLabel)
      */
     ariaLabel? : string
     /**
@@ -63,14 +63,12 @@ export type BryntumChatPanelProps = {
     /**
      * 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/chat/ChatPanel#config-bbar)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/chat/ChatPanel#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/chat/ChatPanel#config-bodyCls)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/chat/ChatPanel#config-bodyCls)
      */
     bodyCls? : string|object
     /**
@@ -80,8 +78,7 @@ export type BryntumChatPanelProps = {
     /**
      * 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/chat/ChatPanel#config-bubbleEvents)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/chat/ChatPanel#config-bubbleEvents)
      */
     bubbleEvents? : object
     /**
@@ -92,15 +89,13 @@ export type BryntumChatPanelProps = {
     bubbleTools? : DomConfig
     /**
      * 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/chat/ChatPanel#config-callOnFunctions)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/chat/ChatPanel#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/chat/ChatPanel#config-catchEventHandlerExceptions)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/chat/ChatPanel#config-catchEventHandlerExceptions)
      */
     catchEventHandlerExceptions? : boolean
     /**
@@ -112,8 +107,7 @@ export type BryntumChatPanelProps = {
      * 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/chat/ChatPanel#config-cls)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/chat/ChatPanel#config-cls)
      */
     cls? : string|object
     /**
@@ -123,15 +117,13 @@ export type BryntumChatPanelProps = {
     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/chat/ChatPanel#config-collapsible)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/chat/ChatPanel#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/chat/ChatPanel#config-color)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/chat/ChatPanel#config-color)
      */
     color? : Color
     /**
@@ -155,8 +147,7 @@ export type BryntumChatPanelProps = {
      * 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/chat/ChatPanel#config-contentElementCls)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/chat/ChatPanel#config-contentElementCls)
      */
     contentElementCls? : string|object
     /**
@@ -176,8 +167,7 @@ export type BryntumChatPanelProps = {
     /**
      * 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/chat/ChatPanel#config-defaultFocus)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/chat/ChatPanel#config-defaultFocus)
      * @param {Core.widget.Widget} widget Widget passed to method
      * @returns {boolean} truthy value if widget is the default one
      */
@@ -187,16 +177,15 @@ export type BryntumChatPanelProps = {
      */
     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/chat/ChatPanel#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/chat/ChatPanel#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/chat/ChatPanel#config-disabled)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/chat/ChatPanel#config-disabled)
      */
     disabled? : boolean|'inert'
     /**
@@ -204,41 +193,41 @@ export type BryntumChatPanelProps = {
      * [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/chat/ChatPanel#config-dock)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/chat/ChatPanel#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/chat/ChatPanel#config-draggable)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/chat/ChatPanel#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
     /**
      * 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/chat/ChatPanel#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/chat/ChatPanel#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/chat/ChatPanel#config-elementAttributes)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/chat/ChatPanel#config-elementAttributes)
      */
     elementAttributes? : Record<string, string|null>
+    /**
+     * An array of example prompt strings displayed when the chat is empty. Clicking a prompt fills the
+     * message field with its text.
+     */
+    examplePrompts? : string[]
     extraData? : any
     /**
      * When this widget is a child of a [Container](https://bryntum.com/products/core/docs/api/Core/widget/Container), it will by default be participating in a
@@ -256,18 +245,15 @@ export type BryntumChatPanelProps = {
     /**
      * 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/chat/ChatPanel#config-footer)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/chat/ChatPanel#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/chat/ChatPanel#config-header)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/chat/ChatPanel#config-header)
      */
     header? : string|boolean|PanelHeader
     /**
@@ -282,25 +268,21 @@ export type BryntumChatPanelProps = {
     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/chat/ChatPanel#config-hideAnimation)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/chat/ChatPanel#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/chat/ChatPanel#config-hideWhenEmpty)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/chat/ChatPanel#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/chat/ChatPanel#config-html)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/chat/ChatPanel#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.
      */
@@ -316,16 +298,14 @@ export type BryntumChatPanelProps = {
     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/chat/ChatPanel#config-ignoreParentReadOnly)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/chat/ChatPanel#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/chat/ChatPanel#config-inputFieldAlign)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/chat/ChatPanel#config-inputFieldAlign)
      */
     inputFieldAlign? : 'start'|'end'
     /**
@@ -347,55 +327,52 @@ export type BryntumChatPanelProps = {
     /**
      * 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/chat/ChatPanel#config-items)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/chat/ChatPanel#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/chat/ChatPanel#config-keyMap)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/chat/ChatPanel#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/chat/ChatPanel#config-labelPosition)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/chat/ChatPanel#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/chat/ChatPanel#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/chat/ChatPanel#config-layout)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/chat/ChatPanel#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/chat/ChatPanel#config-layoutStyle)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/chat/ChatPanel#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/chat/ChatPanel#config-lazyItems)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/chat/ChatPanel#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/chat/ChatPanel#config-listeners)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/chat/ChatPanel#config-listeners)
      */
     listeners? : ChatPanelListeners
     /**
      * 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/chat/ChatPanel#config-localeClass)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/chat/ChatPanel#config-localeClass)
      */
     localeClass? : typeof Base
     /**
@@ -407,8 +384,7 @@ export type BryntumChatPanelProps = {
      * 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/chat/ChatPanel#config-localizableProperties)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/chat/ChatPanel#config-localizableProperties)
      */
     localizableProperties? : string[]
     /**
@@ -434,8 +410,7 @@ export type BryntumChatPanelProps = {
     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/chat/ChatPanel#config-maximizeOnMobile)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/chat/ChatPanel#config-maximizeOnMobile)
      */
     maximizeOnMobile? : number|string
     /**
@@ -448,6 +423,13 @@ export type BryntumChatPanelProps = {
      * you?&quot;
      */
     messages? : ChatMessageModelConfig
+    /**
+     * Controls where the message field trigger buttons (send, mic, etc.) are placed relative to the text area.
+     * Use `'side'` to place them next to the text area (in the same row), or `'below'` to place them
+     * underneath it. When placed on the side, use each trigger's `align` config (`'start'`/`'end'`) to
+     * control which side they appear on.
+     */
+    messageTriggersPlacement? : 'side'|'below'
     /**
      * The element's minHeight. Can be either a String or a Number (which will have 'px' appended). Note that
      * like [height](https://bryntum.com/products/core/docs/api/Core/widget/Widget#config-height), *reading* the value will return the numeric value in pixels.
@@ -462,26 +444,22 @@ export type BryntumChatPanelProps = {
      * 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/chat/ChatPanel#config-monitorResize)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/chat/ChatPanel#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/chat/ChatPanel#config-namedItems)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/chat/ChatPanel#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/chat/ChatPanel#config-positioned)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/chat/ChatPanel#config-positioned)
      */
     positioned? : boolean
     /**
@@ -492,45 +470,45 @@ export type BryntumChatPanelProps = {
     /**
      * 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/chat/ChatPanel#config-readOnly)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/chat/ChatPanel#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/chat/ChatPanel#config-record)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/chat/ChatPanel#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/chat/ChatPanel#config-rendition)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/chat/ChatPanel#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/chat/ChatPanel#config-ripple)
-     */
-    ripple? : boolean|{
-        delegate?: string
-        color?: string
-        radius?: number
-        clip?: string
-    }
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/chat/ChatPanel#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/chat/ChatPanel#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/chat/ChatPanel#config-rtl)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/chat/ChatPanel#config-rtl)
      */
     rtl? : boolean
     /**
@@ -538,8 +516,7 @@ export type BryntumChatPanelProps = {
      * 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/chat/ChatPanel#config-scrollable)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/chat/ChatPanel#config-scrollable)
      */
     scrollable? : boolean|ScrollerConfig|Scroller
     /**
@@ -549,8 +526,7 @@ export type BryntumChatPanelProps = {
     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/chat/ChatPanel#config-showAnimation)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/chat/ChatPanel#config-showAnimation)
      */
     showAnimation? : boolean|object
     /**
@@ -567,30 +543,26 @@ export type BryntumChatPanelProps = {
     span? : number
     /**
      * This value can be one of the following:
-     * ...
-     * [View online docs...](https://bryntum.com/products/grid/docs/api/Core/widget/chat/ChatPanel#config-stateful)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/chat/ChatPanel#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/chat/ChatPanel#config-statefulEvents)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/chat/ChatPanel#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/chat/ChatPanel#config-stateId)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/chat/ChatPanel#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/chat/ChatPanel#config-stateProvider)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/chat/ChatPanel#config-stateProvider)
      */
     stateProvider? : StateProvider
     /**
@@ -602,23 +574,20 @@ export type BryntumChatPanelProps = {
      * 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/chat/ChatPanel#config-strips)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/chat/ChatPanel#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/chat/ChatPanel#config-tab)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/chat/ChatPanel#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/chat/ChatPanel#config-tabBarItems)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/chat/ChatPanel#config-tabBarItems)
      */
     tabBarItems? : ToolbarItems[]|Widget[]
     /**
@@ -629,42 +598,36 @@ export type BryntumChatPanelProps = {
      * 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/chat/ChatPanel#config-tbar)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/chat/ChatPanel#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/chat/ChatPanel#config-textAlign)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/chat/ChatPanel#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/chat/ChatPanel#config-textContent)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/chat/ChatPanel#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/chat/ChatPanel#config-title)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/chat/ChatPanel#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/chat/ChatPanel#config-tools)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/chat/ChatPanel#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/chat/ChatPanel#config-tooltip)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/chat/ChatPanel#config-tooltip)
      */
     tooltip? : string|TooltipConfig|null
     /**
@@ -674,12 +637,15 @@ export type BryntumChatPanelProps = {
      */
     trapFocus? : boolean
     type? : 'chatpanel'
+    /**
+     * The delay in milliseconds between each simulated keystroke when typing out a response.
+     */
+    typeInterval? : number
     /**
      * 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/chat/ChatPanel#config-ui)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/chat/ChatPanel#config-ui)
      */
     ui? : 'plain'|'toolbar'|string|object
     /**
@@ -695,14 +661,12 @@ export type BryntumChatPanelProps = {
     width? : string|number
     /**
      * The x position for the widget.
-     * ...
-     * [View online docs...](https://bryntum.com/products/grid/docs/api/Core/widget/chat/ChatPanel#config-x)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/chat/ChatPanel#config-x)
      */
     x? : number
     /**
      * The y position for the widget.
-     * ...
-     * [View online docs...](https://bryntum.com/products/grid/docs/api/Core/widget/chat/ChatPanel#config-y)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/chat/ChatPanel#config-y)
      */
     y? : number
 
@@ -746,7 +710,7 @@ export type BryntumChatPanelProps = {
      */
     onBeforeStateSave? : ((event: { state: any }) => Promise<boolean>|boolean|void)|string
     /**
-     * Fired when chat bubble tool icon is clicked.
+     * Fired when the chat bubble tool icon is clicked.
      * @param {object} event Event object
      * @param {Core.widget.chat.ChatPanel} event.source This panel
      * @param {string} event.tool The tool identifier
@@ -755,8 +719,7 @@ export type BryntumChatPanelProps = {
     onBubbleToolClick? : ((event: { source: ChatPanel, tool: string, message: ChatMessageModelConfig }) => void)|string
     /**
      * Fires when any other event is fired from the object.
-     * ...
-     * [View online docs...](https://bryntum.com/products/grid/docs/api/Core/widget/chat/ChatPanel#event-catchAll)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/chat/ChatPanel#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
@@ -834,13 +797,19 @@ export type BryntumChatPanelProps = {
     /**
      * 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/chat/ChatPanel#event-paint)
+     * [More...](https://bryntum.com/products/grid/docs/api/Core/widget/chat/ChatPanel#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.
      */
     onPaint? : ((event: { source: Widget, firstPaint: boolean }) => void)|string
+    /**
+     * Fired when the prompt history changes. Listen to this event to persist the
+     * history (e.g. to localStorage).
+     * @param {object} event Event object
+     * @param {string[]} event.promptHistory The updated prompt history array
+     */
+    onPromptHistoryChange? : ((event: { promptHistory: string[] }) => void)|string
     /**
      * Fired when a Widget's read only state is toggled
      * @param {object} event Event object
@@ -928,12 +897,14 @@ export class BryntumChatPanel extends React.Component<BryntumChatPanelProps> {
         'localizableProperties',
         'maskDefaults',
         'masked',
+        'messageTriggersPlacement',
         'monitorResize',
         'namedItems',
         'positioned',
         'preventTooltipOnTouch',
         'relayStoreEvents',
         'ripple',
+        'role',
         'rootElement',
         'scrollAction',
         'showAnimation',
@@ -957,6 +928,7 @@ export class BryntumChatPanel extends React.Component<BryntumChatPanelProps> {
 
     static propertyConfigNames = [
         'alignSelf',
+        'animateTyping',
         'appendTo',
         'avatar',
         'bubbleTools',
@@ -968,6 +940,7 @@ export class BryntumChatPanel extends React.Component<BryntumChatPanelProps> {
         'content',
         'dataset',
         'disabled',
+        'examplePrompts',
         'extraData',
         'flex',
         'height',
@@ -981,6 +954,7 @@ export class BryntumChatPanel extends React.Component<BryntumChatPanelProps> {
         'items',
         'keyMap',
         'labelPosition',
+        'labelWidth',
         'layout',
         'layoutStyle',
         'margin',
@@ -1008,6 +982,7 @@ export class BryntumChatPanel extends React.Component<BryntumChatPanelProps> {
         'onHide',
         'onLocalMessage',
         'onPaint',
+        'onPromptHistoryChange',
         'onReadOnly',
         'onRecompose',
         'onResize',
@@ -1024,20 +999,15 @@ export class BryntumChatPanel extends React.Component<BryntumChatPanelProps> {
         'title',
         'tools',
         'tooltip',
+        'typeInterval',
         'width',
         'x',
         'y'
     ];
 
     static propertyNames = [
-        'anchorSize',
-        'focusVisible',
-        'hasChanges',
-        'isSettingValues',
-        'isValid',
         'parent',
         'state',
-        'store',
         'values'
     ];