@bryntum/grid-angular-thin 7.2.4 → 7.3.1

package/src/lib/bryntum-tree-combo.component.ts

@@ -7,24 +7,23 @@ import { Component, ElementRef, EventEmitter, Output, Input, SimpleChange, Simpl
 
 import WrapperHelper from './wrapper.helper';
 
-import { AlignSpec, Base, ChipViewConfig, CollectionCompareOperator, CollectionFilterConfig, Color, Combo, ComboModel, DomConfig, Duration, DurationConfig, Field, FieldContainer, FieldContainerConfig, FieldTriggerConfig, KeyMapConfig, List, ListConfig, MaskConfig, Model, Rectangle, Scroller, Store, StoreConfig, TabConfig, TooltipConfig, VueConfig, Widget } from '@bryntum/core-thin';
+import { AlignSpec, Base, ChipViewConfig, CollectionCompareOperator, CollectionFilterConfig, Color, Combo, DomConfig, Duration, DurationConfig, Field, FieldContainerConfig, FieldTriggerConfig, KeyMapConfig, List, ListConfig, MaskConfig, Model, ReactJSX, Rectangle, Scroller, Store, StoreConfig, TabConfig, TooltipConfig, VueConfig, Widget } from '@bryntum/core-thin';
 import { GridContainerItemConfig, TreeCombo, TreeComboListeners } from '@bryntum/grid-thin';
 
-import { StringHelper } from '@bryntum/core-thin';
+import { DomHelper, StringHelper } from '@bryntum/core-thin';
+import { initThemeInShadowRoots } from './shadowdom.helper';
 
 export type BryntumTreeComboProps = {
     // Configs
     /**
      * 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/Grid/widget/TreeCombo#config-adopt)
+     * [More...](https://bryntum.com/products/grid/docs/api/Grid/widget/TreeCombo#config-adopt)
      */
     adopt ? : HTMLElement|string
     /**
      * *Only valid if this Widget is [floating](https://bryntum.com/products/grid/docs/api/Core/widget/Widget#config-floating).*
-     * ...
-     * [View online docs...](https://bryntum.com/products/grid/docs/api/Grid/widget/TreeCombo#config-align)
+     * [More...](https://bryntum.com/products/grid/docs/api/Grid/widget/TreeCombo#config-align)
      */
     align ? : AlignSpec|string
     /**
@@ -46,15 +45,13 @@ export type BryntumTreeComboProps = {
     /**
      * 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/Grid/widget/TreeCombo#config-ariaDescription)
+     * [More...](https://bryntum.com/products/grid/docs/api/Grid/widget/TreeCombo#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/Grid/widget/TreeCombo#config-ariaLabel)
+     * [More...](https://bryntum.com/products/grid/docs/api/Grid/widget/TreeCombo#config-ariaLabel)
      */
     ariaLabel ? : string
     /**
@@ -77,20 +74,17 @@ export type BryntumTreeComboProps = {
     /**
      * 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/Grid/widget/TreeCombo#config-bubbleEvents)
+     * [More...](https://bryntum.com/products/grid/docs/api/Grid/widget/TreeCombo#config-bubbleEvents)
      */
     bubbleEvents ? : object
     /**
      * Enable caching of the last retrieved result until the timeout is reached.
-     * ...
-     * [View online docs...](https://bryntum.com/products/grid/docs/api/Grid/widget/TreeCombo#config-cacheLastResult)
+     * [More...](https://bryntum.com/products/grid/docs/api/Grid/widget/TreeCombo#config-cacheLastResult)
      */
     cacheLastResult ? : number|string|Duration|DurationConfig
     /**
      * 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/Grid/widget/TreeCombo#config-callOnFunctions)
+     * [More...](https://bryntum.com/products/grid/docs/api/Grid/widget/TreeCombo#config-callOnFunctions)
      */
     callOnFunctions ? : boolean
     /**
@@ -100,8 +94,7 @@ export type BryntumTreeComboProps = {
     /**
      * 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/Grid/widget/TreeCombo#config-catchEventHandlerExceptions)
+     * [More...](https://bryntum.com/products/grid/docs/api/Grid/widget/TreeCombo#config-catchEventHandlerExceptions)
      */
     catchEventHandlerExceptions ? : boolean
     /**
@@ -109,11 +102,19 @@ export type BryntumTreeComboProps = {
      * Set to `true` to centre the Widget in browser viewport space.
      */
     centered ? : boolean
+    /**
+     * A function (or the name of a function in the ownership hierarchy) called during field validation
+     * to perform custom validity checks. The function is called as part of the [isValid](https://bryntum.com/products/grid/docs/api/Core/widget/Field#property-isValid)
+     * evaluation, after the built-in [required](https://bryntum.com/products/grid/docs/api/Core/widget/Field#config-required) check.
+     * [More...](https://bryntum.com/products/grid/docs/api/Grid/widget/TreeCombo#config-checkValidity)
+     * @param {Core.widget.Field} field The field being validated
+     * @returns {void}
+     */
+    checkValidity ? : ((field: Field) => void)|string
     /**
      * A config object to configure the [ChipView](https://bryntum.com/products/grid/docs/api/Core/widget/ChipView) to display the
      * selected value set when [multiSelect](https://bryntum.com/products/grid/docs/api/Core/widget/Combo#config-multiSelect) is `true`.
-     * ...
-     * [View online docs...](https://bryntum.com/products/grid/docs/api/Grid/widget/TreeCombo#config-chipView)
+     * [More...](https://bryntum.com/products/grid/docs/api/Grid/widget/TreeCombo#config-chipView)
      */
     chipView ? : ChipViewConfig
     /**
@@ -138,15 +139,13 @@ export type BryntumTreeComboProps = {
      * 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/Grid/widget/TreeCombo#config-cls)
+     * [More...](https://bryntum.com/products/grid/docs/api/Grid/widget/TreeCombo#config-cls)
      */
     cls ? : string|object
     /**
      * 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/Grid/widget/TreeCombo#config-color)
+     * [More...](https://bryntum.com/products/grid/docs/api/Grid/widget/TreeCombo#config-color)
      */
     color ? : Color
     /**
@@ -163,15 +162,13 @@ export type BryntumTreeComboProps = {
      * The configuration for additional items associated to this field. This is typically used to add contextual
      * fields related to a [checkbox](https://bryntum.com/products/grid/docs/api/Core/widget/Checkbox) or [radio button](#Core/widget/Radio). See
      * these classes for examples of nested fields.
-     * ...
-     * [View online docs...](https://bryntum.com/products/grid/docs/api/Grid/widget/TreeCombo#config-container)
+     * [More...](https://bryntum.com/products/grid/docs/api/Grid/widget/TreeCombo#config-container)
      */
-    container ? : Record<string, GridContainerItemConfig>|GridContainerItemConfig[]|FieldContainerConfig|FieldContainer
+    container ? : Record<string, GridContainerItemConfig>|GridContainerItemConfig[]|FieldContainerConfig
     /**
      * The config controls how the value of nested items are handled when a parent container gets or sets its
      * [values](https://bryntum.com/products/grid/docs/api/Core/widget/Container#property-values).
-     * ...
-     * [View online docs...](https://bryntum.com/products/grid/docs/api/Grid/widget/TreeCombo#config-containValues)
+     * [More...](https://bryntum.com/products/grid/docs/api/Grid/widget/TreeCombo#config-containValues)
      * @param {Core.widget.Field} field Field instance
      * @returns {boolean}
      */
@@ -180,16 +177,14 @@ export type BryntumTreeComboProps = {
      * Custom CSS classes to add to the [contentElement](https://bryntum.com/products/grid/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/Grid/widget/TreeCombo#config-contentElementCls)
+     * [More...](https://bryntum.com/products/grid/docs/api/Grid/widget/TreeCombo#config-contentElementCls)
      */
     contentElementCls ? : string|object
     /**
      * If configured as `true`, this means that when an unmatched string is typed into the
      * combo's input field, and <kbd>Enter</kbd>, or the [multiValueSeparator](https://bryntum.com/products/grid/docs/api/Core/widget/Combo#config-multiValueSeparator) is typed,
      * a new record will be created using the typed string as the [displayField](https://bryntum.com/products/grid/docs/api/Core/widget/Combo#config-displayField).
-     * ...
-     * [View online docs...](https://bryntum.com/products/grid/docs/api/Grid/widget/TreeCombo#config-createOnUnmatched)
+     * [More...](https://bryntum.com/products/grid/docs/api/Grid/widget/TreeCombo#config-createOnUnmatched)
      * @param {string} name Record name
      * @param {Core.widget.Combo} combo Combo instance
      * @returns {Core.data.Model} New record
@@ -210,16 +205,15 @@ export type BryntumTreeComboProps = {
      */
     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/Grid/widget/TreeCombo#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/Grid/widget/TreeCombo#config-detectCSSCompatibilityIssues)
      */
     detectCSSCompatibilityIssues ? : boolean
     /**
      * Disable or enable the widget. It is similar to [readOnly](https://bryntum.com/products/grid/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/Grid/widget/TreeCombo#config-disabled)
+     * [More...](https://bryntum.com/products/grid/docs/api/Grid/widget/TreeCombo#config-disabled)
      */
     disabled ? : boolean|'inert'
     /**
@@ -232,26 +226,23 @@ export type BryntumTreeComboProps = {
      * @param {Core.widget.Combo} combo A reference to this Combo
      * @returns {string,void}
      */
-    displayValueRenderer ? : (record: Model|ComboModel, combo: Combo) => string|void
+    displayValueRenderer ? : (record: Model, combo: Combo) => string|void
     /**
      * Controls the placement of this widget when it is added to a [panel's ](https://bryntum.com/products/grid/docs/api/Core/widget/Panel)
      * [strips collection](https://bryntum.com/products/grid/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/Grid/widget/TreeCombo#config-dock)
+     * [More...](https://bryntum.com/products/grid/docs/api/Grid/widget/TreeCombo#config-dock)
      */
     dock ? : 'top'|'bottom'|'left'|'right'|'start'|'end'|'header'|'pre-header'|object
     /**
      * *Only valid if this Widget is [floating](https://bryntum.com/products/grid/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/Grid/widget/TreeCombo#config-draggable)
+     * [More...](https://bryntum.com/products/grid/docs/api/Grid/widget/TreeCombo#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
     /**
      * User can edit text in text field (otherwise only pick from attached picker)
      */
@@ -259,21 +250,18 @@ export type BryntumTreeComboProps = {
     /**
      * 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/Grid/widget/TreeCombo#config-elementAttributes)
+     * [More...](https://bryntum.com/products/grid/docs/api/Grid/widget/TreeCombo#config-elementAttributes)
      */
     elementAttributes ? : Record<string, string|null>
     /**
      * Text to display in the drop down when there are no items in the underlying store.
-     * ...
-     * [View online docs...](https://bryntum.com/products/grid/docs/api/Grid/widget/TreeCombo#config-emptyText)
+     * [More...](https://bryntum.com/products/grid/docs/api/Grid/widget/TreeCombo#config-emptyText)
      */
     emptyText ? : string
     /**
      * A function which creates an array of values for the [filterParamName](https://bryntum.com/products/grid/docs/api/Core/widget/Combo#config-filterParamName) to pass
      * any filters to the server upon load.
-     * ...
-     * [View online docs...](https://bryntum.com/products/grid/docs/api/Grid/widget/TreeCombo#config-encodeFilterParams)
+     * [More...](https://bryntum.com/products/grid/docs/api/Grid/widget/TreeCombo#config-encodeFilterParams)
      * @param {object[]} filters filters
      * @returns {object[]} array of values
      */
@@ -287,8 +275,7 @@ export type BryntumTreeComboProps = {
     /**
      * The name of an operator type as implemented in [operator](https://bryntum.com/products/grid/docs/api/Core/util/CollectionFilter#config-operator)
      * to use when filtering the dropdown list based upon the typed value.
-     * ...
-     * [View online docs...](https://bryntum.com/products/grid/docs/api/Grid/widget/TreeCombo#config-filterOperator)
+     * [More...](https://bryntum.com/products/grid/docs/api/Grid/widget/TreeCombo#config-filterOperator)
      */
     filterOperator ? : CollectionCompareOperator
     /**
@@ -329,8 +316,7 @@ export type BryntumTreeComboProps = {
     hidden ? : boolean
     /**
      * *Only valid if this Widget is [floating](https://bryntum.com/products/grid/docs/api/Core/widget/Widget#config-floating).*
-     * ...
-     * [View online docs...](https://bryntum.com/products/grid/docs/api/Grid/widget/TreeCombo#config-hideAnimation)
+     * [More...](https://bryntum.com/products/grid/docs/api/Grid/widget/TreeCombo#config-hideAnimation)
      */
     hideAnimation ? : boolean|object
     /**
@@ -351,8 +337,7 @@ export type BryntumTreeComboProps = {
     /**
      * An optional string to display inside the input field as an overlay. This can be useful for displaying
      * a field's units.
-     * ...
-     * [View online docs...](https://bryntum.com/products/grid/docs/api/Grid/widget/TreeCombo#config-hint)
+     * [More...](https://bryntum.com/products/grid/docs/api/Grid/widget/TreeCombo#config-hint)
      * @param {object} data A data object
      * @param {Core.widget.Field} data.source A reference to the field instance
      * @param {any} data.value The current value of the field
@@ -363,8 +348,7 @@ export type BryntumTreeComboProps = {
      * This config is similar to [hint](https://bryntum.com/products/grid/docs/api/Core/widget/Field#config-hint) except that this config is used to display HTML content.
      * Since this can allow malicious content to be executed, be sure not to include user-entered data or to
      * encode such data (see [encodeHtml](https://bryntum.com/products/grid/docs/api/Core/helper/StringHelper#function-encodeHtml-static)).
-     * ...
-     * [View online docs...](https://bryntum.com/products/grid/docs/api/Grid/widget/TreeCombo#config-hintHtml)
+     * [More...](https://bryntum.com/products/grid/docs/api/Grid/widget/TreeCombo#config-hintHtml)
      * @param {object} data A data object
      * @param {Core.widget.Field} data.source A reference to the field instance
      * @param {any} data.value The current value of the field
@@ -377,23 +361,20 @@ export type BryntumTreeComboProps = {
     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/Grid/widget/TreeCombo#config-ignoreParentReadOnly)
+     * [More...](https://bryntum.com/products/grid/docs/api/Grid/widget/TreeCombo#config-ignoreParentReadOnly)
      */
     ignoreParentReadOnly ? : boolean
     /**
      * Set this config to `true` to always display items horizontally along with this field. This assigns an
      * [hbox](https://bryntum.com/products/grid/docs/api/Core/widget/layout/Box) as the [layout](#Core/widget/Container#config-layout) to the
      * [container](https://bryntum.com/products/grid/docs/api/Core/widget/Field#config-container).
-     * ...
-     * [View online docs...](https://bryntum.com/products/grid/docs/api/Grid/widget/TreeCombo#config-inline)
+     * [More...](https://bryntum.com/products/grid/docs/api/Grid/widget/TreeCombo#config-inline)
      */
     inline ? : boolean
     /**
      * Configure this as `true` to render the dropdown list as a permanently visible list
      * in the document flow immediately below the input area instead of as a popup.
-     * ...
-     * [View online docs...](https://bryntum.com/products/grid/docs/api/Grid/widget/TreeCombo#config-inlinePicker)
+     * [More...](https://bryntum.com/products/grid/docs/api/Grid/widget/TreeCombo#config-inlinePicker)
      */
     inlinePicker ? : boolean
     /**
@@ -431,30 +412,26 @@ export type BryntumTreeComboProps = {
     insertFirst ? : HTMLElement|string
     /**
      * Rows to display in the dropdown (list items).
-     * ...
-     * [View online docs...](https://bryntum.com/products/grid/docs/api/Grid/widget/TreeCombo#config-items)
+     * [More...](https://bryntum.com/products/grid/docs/api/Grid/widget/TreeCombo#config-items)
      */
     items ? : object[]|string[]|object
     /**
      * 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/Grid/widget/TreeCombo#config-keyMap)
+     * [More...](https://bryntum.com/products/grid/docs/api/Grid/widget/TreeCombo#config-keyMap)
      */
     keyMap ? : Record<string, KeyMapConfig>
     /**
      * The delay in milliseconds to wait after the last keystroke before triggering a change event.
      * Set to 0 to not trigger change events from keystrokes (listen for input event instead to have
      * immediate feedback, change will still be triggered on blur).
-     * ...
-     * [View online docs...](https://bryntum.com/products/grid/docs/api/Grid/widget/TreeCombo#config-keyStrokeChangeDelay)
+     * [More...](https://bryntum.com/products/grid/docs/api/Grid/widget/TreeCombo#config-keyStrokeChangeDelay)
      */
     keyStrokeChangeDelay ? : number
     /**
      * The delay in milliseconds to wait after the last keystroke before filtering the list.
-     * ...
-     * [View online docs...](https://bryntum.com/products/grid/docs/api/Grid/widget/TreeCombo#config-keyStrokeFilterDelay)
+     * [More...](https://bryntum.com/products/grid/docs/api/Grid/widget/TreeCombo#config-keyStrokeFilterDelay)
      */
     keyStrokeFilterDelay ? : number
     /**
@@ -467,15 +444,15 @@ export type BryntumTreeComboProps = {
     labelCls ? : string|object
     /**
      * Label position, either 'before' the field or 'above' the field
-     * ...
-     * [View online docs...](https://bryntum.com/products/grid/docs/api/Grid/widget/TreeCombo#config-labelPosition)
+     * [More...](https://bryntum.com/products/grid/docs/api/Grid/widget/TreeCombo#config-labelPosition)
      */
     labelPosition ? : 'before'|'above'|null
     /**
      * The labels to add either before or after the input field.
      * Each label may have the following properties:
-     * ...
-     * [View online docs...](https://bryntum.com/products/grid/docs/api/Grid/widget/TreeCombo#config-labels)
+     * [More...](https://bryntum.com/products/grid/docs/api/Grid/widget/TreeCombo#config-labels)
+     * @property {string} html Label text
+     * @property {'start','end'} align Which end of the file the label should go
      */
     labels ? : object[]
     /**
@@ -488,24 +465,21 @@ export type BryntumTreeComboProps = {
     listCls ? : string
     /**
      * The listener set for this object.
-     * ...
-     * [View online docs...](https://bryntum.com/products/grid/docs/api/Grid/widget/TreeCombo#config-listeners)
+     * [More...](https://bryntum.com/products/grid/docs/api/Grid/widget/TreeCombo#config-listeners)
      */
     listeners ? : TreeComboListeners
     /**
      * Template string used to render the list items in the dropdown list
-     * ...
-     * [View online docs...](https://bryntum.com/products/grid/docs/api/Grid/widget/TreeCombo#config-listItemTpl)
+     * [More...](https://bryntum.com/products/grid/docs/api/Grid/widget/TreeCombo#config-listItemTpl)
      * @param {Core.data.Model} record The record representing the item being rendered
      * @returns {string,void}
      */
-    listItemTpl ? : (record: Model|ComboModel) => string|void
+    listItemTpl ? : (record: Model) => string|void
     /**
      * 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/Grid/widget/TreeCombo#config-localeClass)
+     * [More...](https://bryntum.com/products/grid/docs/api/Grid/widget/TreeCombo#config-localeClass)
      */
     localeClass ? : typeof Base
     /**
@@ -517,8 +491,7 @@ export type BryntumTreeComboProps = {
      * 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/Grid/widget/TreeCombo#config-localizableProperties)
+     * [More...](https://bryntum.com/products/grid/docs/api/Grid/widget/TreeCombo#config-localizableProperties)
      */
     localizableProperties ? : string[]
     /**
@@ -544,8 +517,7 @@ export type BryntumTreeComboProps = {
     maxHeight ? : string|number
     /**
      * *Only valid if this Widget is [floating](https://bryntum.com/products/grid/docs/api/Core/widget/Widget#config-floating).*
-     * ...
-     * [View online docs...](https://bryntum.com/products/grid/docs/api/Grid/widget/TreeCombo#config-maximizeOnMobile)
+     * [More...](https://bryntum.com/products/grid/docs/api/Grid/widget/TreeCombo#config-maximizeOnMobile)
      */
     maximizeOnMobile ? : number|string
     /**
@@ -559,8 +531,7 @@ export type BryntumTreeComboProps = {
     maxWidth ? : string|number
     /**
      * The minimum string length to trigger the filtering, only relevant when [editable](https://bryntum.com/products/grid/docs/api/Core/widget/Combo#config-editable) is `true`.
-     * ...
-     * [View online docs...](https://bryntum.com/products/grid/docs/api/Grid/widget/TreeCombo#config-minChars)
+     * [More...](https://bryntum.com/products/grid/docs/api/Grid/widget/TreeCombo#config-minChars)
      */
     minChars ? : number
     /**
@@ -581,16 +552,13 @@ export type BryntumTreeComboProps = {
      * 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/Grid/widget/TreeCombo#config-monitorResize)
+     * [More...](https://bryntum.com/products/grid/docs/api/Grid/widget/TreeCombo#config-monitorResize)
+     * @property {boolean} immediate Set to `true` to receive resize notifications immediately.
      */
-    monitorResize ? : boolean|{
-        immediate?: boolean
-    }
+    monitorResize ? : boolean|object
     /**
      * Set to `true` to allow selection of multiple values from the dropdown list.
-     * ...
-     * [View online docs...](https://bryntum.com/products/grid/docs/api/Grid/widget/TreeCombo#config-multiSelect)
+     * [More...](https://bryntum.com/products/grid/docs/api/Grid/widget/TreeCombo#config-multiSelect)
      */
     multiSelect ? : boolean
     /**
@@ -603,8 +571,7 @@ export type BryntumTreeComboProps = {
      * Name of the field which is used as a key to get/set values from/to the field.
      * Used prior to [ref](https://bryntum.com/products/grid/docs/api/Core/widget/Widget#config-ref) and [id](#Core/widget/Widget#config-id) in
      * [Container.values](https://bryntum.com/products/grid/docs/api/Core/widget/Container#property-values).
-     * ...
-     * [View online docs...](https://bryntum.com/products/grid/docs/api/Grid/widget/TreeCombo#config-name)
+     * [More...](https://bryntum.com/products/grid/docs/api/Grid/widget/TreeCombo#config-name)
      */
     name ? : string
     /**
@@ -615,10 +582,9 @@ export type BryntumTreeComboProps = {
     /**
      * Configuration object for the [picker](https://bryntum.com/products/grid/docs/api/Core/widget/List) on initialization. Returns the
      * [picker](https://bryntum.com/products/grid/docs/api/Core/widget/List) instance at runtime.
-     * ...
-     * [View online docs...](https://bryntum.com/products/grid/docs/api/Grid/widget/TreeCombo#config-picker)
+     * [More...](https://bryntum.com/products/grid/docs/api/Grid/widget/TreeCombo#config-picker)
      */
-    picker ? : ListConfig|List
+    picker ? : ListConfig
     /**
      * The name of the element property to which the picker should size and align itself.
      */
@@ -635,8 +601,7 @@ export type BryntumTreeComboProps = {
      * Set to `true` when a widget is rendered into another widget's [contentElement](https://bryntum.com/products/grid/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/grid/docs/api/Core/widget/Widget#property-contentElement).
-     * ...
-     * [View online docs...](https://bryntum.com/products/grid/docs/api/Grid/widget/TreeCombo#config-positioned)
+     * [More...](https://bryntum.com/products/grid/docs/api/Grid/widget/TreeCombo#config-positioned)
      */
     positioned ? : boolean
     /**
@@ -648,22 +613,19 @@ export type BryntumTreeComboProps = {
      * Optionally a [Filter](https://bryntum.com/products/grid/docs/api/Core/util/CollectionFilter) config object which the combo should use for
      * filtering using the typed value.
      * This may use a `filterBy` property to test its `value` against any field in the passed record.
-     * ...
-     * [View online docs...](https://bryntum.com/products/grid/docs/api/Grid/widget/TreeCombo#config-primaryFilter)
+     * [More...](https://bryntum.com/products/grid/docs/api/Grid/widget/TreeCombo#config-primaryFilter)
      */
     primaryFilter ? : CollectionFilterConfig
     /**
      * Makes the field unmodifiable by user action. The input area is not editable, and triggers
      * are unresponsive.
-     * ...
-     * [View online docs...](https://bryntum.com/products/grid/docs/api/Grid/widget/TreeCombo#config-readOnly)
+     * [More...](https://bryntum.com/products/grid/docs/api/Grid/widget/TreeCombo#config-readOnly)
      */
     readOnly ? : boolean
     relayStoreEvents ? : boolean
     /**
      * Predefined style to use for the field. Possible values are:
-     * ...
-     * [View online docs...](https://bryntum.com/products/grid/docs/api/Grid/widget/TreeCombo#config-rendition)
+     * [More...](https://bryntum.com/products/grid/docs/api/Grid/widget/TreeCombo#config-rendition)
      */
     rendition ? : 'outlined'|'filled'|string
     /**
@@ -682,23 +644,26 @@ export type BryntumTreeComboProps = {
      * Configure as `true` to have the component display a translucent ripple when its
      * [focusElement](https://bryntum.com/products/grid/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/Grid/widget/TreeCombo#config-ripple)
-     */
-    ripple ? : boolean|{
-        delegate?: string
-        color?: string
-        radius?: number
-        clip?: string
-    }
+     * [More...](https://bryntum.com/products/grid/docs/api/Grid/widget/TreeCombo#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/Grid/widget/TreeCombo#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/Grid/widget/TreeCombo#config-rtl)
+     * [More...](https://bryntum.com/products/grid/docs/api/Grid/widget/TreeCombo#config-rtl)
      */
     rtl ? : boolean
     /**
@@ -708,8 +673,7 @@ export type BryntumTreeComboProps = {
     scrollAction ? : 'hide'|'realign'|null
     /**
      * *Only valid if this Widget is [floating](https://bryntum.com/products/grid/docs/api/Core/widget/Widget#config-floating).*
-     * ...
-     * [View online docs...](https://bryntum.com/products/grid/docs/api/Grid/widget/TreeCombo#config-showAnimation)
+     * [More...](https://bryntum.com/products/grid/docs/api/Grid/widget/TreeCombo#config-showAnimation)
      */
     showAnimation ? : boolean|object
     /**
@@ -742,8 +706,7 @@ export type BryntumTreeComboProps = {
      * A configuration for the [tab](https://bryntum.com/products/grid/docs/api/Core/widget/Tab) created for this widget when it is placed in a
      * [TabPanel](https://bryntum.com/products/grid/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/Grid/widget/TreeCombo#config-tab)
+     * [More...](https://bryntum.com/products/grid/docs/api/Grid/widget/TreeCombo#config-tab)
      */
     tab ? : boolean|TabConfig
     /**
@@ -751,14 +714,12 @@ export type BryntumTreeComboProps = {
      * is equivalent to natural tab order, but is unnecessary for fields since they are naturally tabbable
      * (i.e., accessible via the TAB key). Setting to `-1` disables tabbability but allows for focus to be set
      * to the element programmatically.
-     * ...
-     * [View online docs...](https://bryntum.com/products/grid/docs/api/Grid/widget/TreeCombo#config-tabIndex)
+     * [More...](https://bryntum.com/products/grid/docs/api/Grid/widget/TreeCombo#config-tabIndex)
      */
     tabIndex ? : number
     /**
      * Text alignment: 'left', 'center' or 'right'. Also accepts direction neutral 'start' and 'end'.
-     * ...
-     * [View online docs...](https://bryntum.com/products/grid/docs/api/Grid/widget/TreeCombo#config-textAlign)
+     * [More...](https://bryntum.com/products/grid/docs/api/Grid/widget/TreeCombo#config-textAlign)
      */
     textAlign ? : 'left'|'center'|'right'|'start'|'end'
     /**
@@ -767,30 +728,26 @@ export type BryntumTreeComboProps = {
     title ? : string
     /**
      * Tooltip for the widget, either as a string or as a Tooltip config object.
-     * ...
-     * [View online docs...](https://bryntum.com/products/grid/docs/api/Grid/widget/TreeCombo#config-tooltip)
+     * [More...](https://bryntum.com/products/grid/docs/api/Grid/widget/TreeCombo#config-tooltip)
      */
     tooltip ? : string|TooltipConfig|null
     /**
      * How to query the store upon click of the expand trigger. Specify one of these values:
-     * ...
-     * [View online docs...](https://bryntum.com/products/grid/docs/api/Grid/widget/TreeCombo#config-triggerAction)
+     * [More...](https://bryntum.com/products/grid/docs/api/Grid/widget/TreeCombo#config-triggerAction)
      */
     triggerAction ? : 'all'|'last'|null
     /**
      * The triggers to add either before or after the input field. Each property name is the reference by which
      * an instantiated Trigger Widget may be retrieved from the live `triggers` property.
-     * ...
-     * [View online docs...](https://bryntum.com/products/grid/docs/api/Grid/widget/TreeCombo#config-triggers)
+     * [More...](https://bryntum.com/products/grid/docs/api/Grid/widget/TreeCombo#config-triggers)
      */
-    triggers ? : Record<string, FieldTriggerConfig>|Record<string, Widget>
+    triggers ? : Record<string, FieldTriggerConfig>
     type ? : 'treecombo'
     /**
      * 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/Grid/widget/TreeCombo#config-ui)
+     * [More...](https://bryntum.com/products/grid/docs/api/Grid/widget/TreeCombo#config-ui)
      */
     ui ? : string|object
     /**
@@ -810,8 +767,7 @@ export type BryntumTreeComboProps = {
     /**
      * Field used for item value when populating from store. Setting this to `null` will
      * yield the selected record as the Combo's [value](https://bryntum.com/products/grid/docs/api/Core/widget/Combo#property-value).
-     * ...
-     * [View online docs...](https://bryntum.com/products/grid/docs/api/Grid/widget/TreeCombo#config-valueField)
+     * [More...](https://bryntum.com/products/grid/docs/api/Grid/widget/TreeCombo#config-valueField)
      */
     valueField ? : string|null
     /**
@@ -827,14 +783,12 @@ export type BryntumTreeComboProps = {
     width ? : string|number
     /**
      * The x position for the widget.
-     * ...
-     * [View online docs...](https://bryntum.com/products/grid/docs/api/Grid/widget/TreeCombo#config-x)
+     * [More...](https://bryntum.com/products/grid/docs/api/Grid/widget/TreeCombo#config-x)
      */
     x ? : number
     /**
      * The y position for the widget.
-     * ...
-     * [View online docs...](https://bryntum.com/products/grid/docs/api/Grid/widget/TreeCombo#config-y)
+     * [More...](https://bryntum.com/products/grid/docs/api/Grid/widget/TreeCombo#config-y)
      */
     y ? : number
 
@@ -895,6 +849,7 @@ export class BryntumTreeComboComponent implements OnInit, OnDestroy {
         'caseSensitive',
         'catchEventHandlerExceptions',
         'centered',
+        'checkValidity',
         'chipView',
         'clearable',
         'clearTextOnPickerHide',
@@ -992,6 +947,7 @@ export class BryntumTreeComboComponent implements OnInit, OnDestroy {
         'required',
         'revertOnEscape',
         'ripple',
+        'role',
         'rootElement',
         'rtl',
         'scrollAction',
@@ -1034,6 +990,7 @@ export class BryntumTreeComboComponent implements OnInit, OnDestroy {
         'cacheLastResult',
         'caseSensitive',
         'centered',
+        'checkValidity',
         'chipView',
         'clearable',
         'clearTextOnPickerHide',
@@ -1104,6 +1061,7 @@ export class BryntumTreeComboComponent implements OnInit, OnDestroy {
         'relayStoreEvents',
         'revertOnEscape',
         'ripple',
+        'role',
         'rootElement',
         'scrollAction',
         'showAnimation',
@@ -1125,7 +1083,6 @@ export class BryntumTreeComboComponent implements OnInit, OnDestroy {
 
     private static bryntumProps: string[] = BryntumTreeComboComponent.bryntumFeatureNames.concat([
         'alignSelf',
-        'anchorSize',
         'appendTo',
         'badge',
         'callOnFunctions',
@@ -1139,7 +1096,6 @@ export class BryntumTreeComboComponent implements OnInit, OnDestroy {
         'extraData',
         'filterOperator',
         'flex',
-        'focusVisible',
         'formula',
         'height',
         'hidden',
@@ -1205,6 +1161,7 @@ export class BryntumTreeComboComponent implements OnInit, OnDestroy {
     @Input() cacheLastResult              ! : number|string|Duration|DurationConfig;
     @Input() caseSensitive                ! : boolean;
     @Input() centered                     ! : boolean;
+    @Input() checkValidity                ! : ((field: Field) => void)|string;
     @Input() chipView                     ! : ChipViewConfig;
     @Input() clearable                    ! : boolean|FieldTriggerConfig;
     @Input() clearTextOnPickerHide        ! : boolean;
@@ -1213,7 +1170,7 @@ export class BryntumTreeComboComponent implements OnInit, OnDestroy {
     @Input() color                        ! : Color;
     @Input() config                       ! : object;
     @Input() constrainTo                  ! : HTMLElement|Widget|Rectangle;
-    @Input() container                    ! : Record<string, GridContainerItemConfig>|GridContainerItemConfig[]|FieldContainerConfig|FieldContainer;
+    @Input() container                    ! : Record<string, GridContainerItemConfig>|GridContainerItemConfig[]|FieldContainerConfig;
     @Input() containValues                ! : boolean|string|((field: Field) => boolean);
     @Input() contentElementCls            ! : string|object;
     @Input() createOnUnmatched            ! : ((name: string, combo: Combo) => Model)|string|boolean;
@@ -1221,11 +1178,9 @@ export class BryntumTreeComboComponent implements OnInit, OnDestroy {
     @Input() defaultBindProperty          ! : string;
     @Input() detectCSSCompatibilityIssues ! : boolean;
     @Input() displayField                 ! : string;
-    @Input() displayValueRenderer         ! : (record: Model|ComboModel, combo: Combo) => string|void;
+    @Input() displayValueRenderer         ! : (record: Model, combo: Combo) => string|void;
     @Input() dock                         ! : 'top'|'bottom'|'left'|'right'|'start'|'end'|'header'|'pre-header'|object;
-    @Input() draggable                    ! : boolean|{
-        handleSelector?: string
-    };
+    @Input() draggable                    ! : boolean|object;
     @Input() elementAttributes            ! : Record<string, string|null>;
     @Input() emptyText                    ! : string;
     @Input() encodeFilterParams           ! : (filters: object[]) => object[];
@@ -1256,7 +1211,7 @@ export class BryntumTreeComboComponent implements OnInit, OnDestroy {
     @Input() labelWidth                   ! : string|number;
     @Input() listCls                      ! : string;
     @Input() listeners                    ! : TreeComboListeners;
-    @Input() listItemTpl                  ! : (record: Model|ComboModel) => string|void;
+    @Input() listItemTpl                  ! : (record: Model) => string|void;
     @Input() localeClass                  ! : typeof Base;
     @Input() localizable                  ! : boolean;
     @Input() localizableProperties        ! : string[];
@@ -1265,9 +1220,7 @@ export class BryntumTreeComboComponent implements OnInit, OnDestroy {
     @Input() maxLength                    ! : number;
     @Input() minChars                     ! : number;
     @Input() minLength                    ! : number;
-    @Input() monitorResize                ! : boolean|{
-        immediate?: boolean
-    };
+    @Input() monitorResize                ! : boolean|object;
     @Input() multiValueSeparator          ! : string;
     @Input() name                         ! : string;
     @Input() overlayAnchor                ! : boolean;
@@ -1278,12 +1231,8 @@ export class BryntumTreeComboComponent implements OnInit, OnDestroy {
     @Input() primaryFilter                ! : CollectionFilterConfig;
     @Input() relayStoreEvents             ! : boolean;
     @Input() revertOnEscape               ! : boolean;
-    @Input() ripple                       ! : boolean|{
-        delegate?: string
-        color?: string
-        radius?: number
-        clip?: string
-    };
+    @Input() ripple                       ! : boolean|object;
+    @Input() role                         ! : string;
     @Input() rootElement                  ! : ShadowRoot|HTMLElement;
     @Input() scrollAction                 ! : 'hide'|'realign'|null;
     @Input() showAnimation                ! : boolean|object;
@@ -1347,14 +1296,12 @@ export class BryntumTreeComboComponent implements OnInit, OnDestroy {
     @Input() y                           ! : number;
 
     // Properties only
-    @Input() anchorSize   ! : number[];
-    @Input() content      ! : string;
-    @Input() focusVisible ! : boolean;
-    @Input() formula      ! : string;
-    @Input() html         ! : string|((widget: Widget) => string)|DomConfig|DomConfig[]|VueConfig;
-    @Input() input        ! : HTMLElement;
-    @Input() parent       ! : Widget;
-    @Input() scrollable   ! : Scroller;
+    @Input() content    ! : string;
+    @Input() formula    ! : string;
+    @Input() html       ! : string|((widget: Widget) => void)|DomConfig|DomConfig[]|VueConfig|ReactJSX;
+    @Input() input      ! : HTMLElement;
+    @Input() parent     ! : Widget;
+    @Input() scrollable ! : Scroller;
 
     // Events emitters
     /**
@@ -1378,7 +1325,7 @@ export class BryntumTreeComboComponent implements OnInit, OnDestroy {
      * @param {object} event Event object
      * @param {Core.widget.Widget} event.source The widget being hidden.
      */
-    @Output() onBeforeHide: any = new EventEmitter<((event: { source: Widget }) => Promise<boolean>|boolean|void)|string>();
+    @Output() onBeforeHide: any = new EventEmitter<((event: { source: Widget }) => boolean|void)|string>();
     /**
      * Triggered before a widget is shown. Return `false` to prevent the action.
      * @param {object} event Event object
@@ -1387,8 +1334,7 @@ export class BryntumTreeComboComponent implements OnInit, OnDestroy {
     @Output() onBeforeShow: any = new EventEmitter<((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/Grid/widget/TreeCombo#event-catchAll)
+     * [More...](https://bryntum.com/products/grid/docs/api/Grid/widget/TreeCombo#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
@@ -1408,8 +1354,7 @@ export class BryntumTreeComboComponent implements OnInit, OnDestroy {
     @Output() onChange: any = new EventEmitter<((event: { source: Field|any, value: string|number|boolean|any, oldValue: string|number|boolean|any, valid: boolean, event: Event, userAction: boolean, checked: boolean }) => void)|string>();
     /**
      * Fired when this field is [cleared](https://bryntum.com/products/grid/docs/api/Core/widget/Field#function-clear).
-     * ...
-     * [View online docs...](https://bryntum.com/products/grid/docs/api/Grid/widget/TreeCombo#event-clear)
+     * [More...](https://bryntum.com/products/grid/docs/api/Grid/widget/TreeCombo#event-clear)
      * @param {object} event Event object
      * @param {Core.widget.Field,any} event.source This Field
      */
@@ -1468,8 +1413,7 @@ export class BryntumTreeComboComponent implements OnInit, OnDestroy {
     /**
      * 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/Grid/widget/TreeCombo#event-paint)
+     * [More...](https://bryntum.com/products/grid/docs/api/Grid/widget/TreeCombo#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.
@@ -1581,11 +1525,69 @@ export class BryntumTreeComboComponent implements OnInit, OnDestroy {
             WrapperHelper.devWarningContainer(instanceName, containerParam);
         }
 
+        // In shadow DOM (e.g. Angular ViewEncapsulation.ShadowDom), theme CSS from document.head
+        // does not cascade into the shadow root. Inject a matching <link> so Bryntum's CSS check
+        // finds the theme. The @font-face rules from component styles are also extracted to
+        // document scope so document.fonts detects them (shadow-root @font-face is not reliably
+        // included in document.fonts across all browsers).
+        const shadowRoot = elementRef.nativeElement.getRootNode();
+        if (shadowRoot instanceof ShadowRoot) {
+            initThemeInShadowRoots();
+            BryntumTreeComboComponent.ensureFontsInDocument(shadowRoot);
+        }
+
         // @ts-ignore
         me.instance = instanceName === 'Widget' ? Widget.create(bryntumConfig) : new instanceClass(bryntumConfig);
 
     }
 
+    /**
+     * Extracts all @font-face declarations from a shadow root's stylesheets and adds them to
+     * document.head as a single <style> element. This is needed because @font-face rules inside
+     * a shadow root are not reliably included in document.fonts across all browsers, causing
+     * Bryntum's CSS compatibility check to incorrectly report missing fonts.
+     * Safe to call multiple times — the extraction runs only once per page.
+     */
+    private static ensureFontsInDocument(shadowRoot: ShadowRoot): void {
+        if (document.querySelector('#b-shadow-root-fonts')) {
+            return;
+        }
+
+        const fontFaceRules: string[] = [];
+
+        const extractFromSheet = (sheet: CSSStyleSheet): void => {
+            try {
+                const rules = sheet.cssRules;
+                for (let i = 0; i < rules.length; i++) {
+                    if (rules[i].type === CSSRule.FONT_FACE_RULE) {
+                        fontFaceRules.push(rules[i].cssText);
+                    }
+                }
+            }
+            catch (_e) {
+                // Cross-origin access may throw; silently skip
+            }
+        };
+
+        // adoptedStyleSheets (Angular 14+ / modern browsers)
+        const adoptedSheets: CSSStyleSheet[] = (shadowRoot as any).adoptedStyleSheets ?? [];
+        adoptedSheets.forEach(sheet => extractFromSheet(sheet));
+
+        // <style> elements (older Angular or fallback)
+        shadowRoot.querySelectorAll('style').forEach(el => {
+            if (el.sheet) {
+                extractFromSheet(el.sheet);
+            }
+        });
+
+        if (fontFaceRules.length > 0) {
+            const style = document.createElement('style');
+            style.id = 'b-shadow-root-fonts';
+            style.textContent = fontFaceRules.join('\n');
+            document.head.appendChild(style);
+        }
+    }
+
     /**
      * Watch for changes
      * @param changes