@bryntum/grid-thin-trial 7.3.2 → 7.3.4

package/grid.d.ts

@@ -243,6 +243,16 @@ type ExportConfig = {
      * Set to true to output as a CSV file, or as an object where you can specify delimiters.
      */
     csv?: boolean|object
+    /**
+     * MIME type used when creating the CSV Blob. Defaults to `text/csv`. Use
+     * `application/octet-stream` in Salesforce LWS environments.
+     */
+    csvMimeType?: string
+    /**
+     * MIME type used when creating the XLSX download Blob. Use
+     * `application/octet-stream` in Salesforce LWS environments.
+     */
+    xlsxMimeType?: string
 }
 
 type XLSColumn = {
@@ -673,7 +683,7 @@ type ActionColumnConfig = {
      */
     alwaysClearCell?: boolean
     /**
-     * The `aria-label` to use for this Column`s header element
+     * The `aria-label` to use for this Column's header element
      */
     ariaLabel?: string
     /**
@@ -1316,7 +1326,7 @@ type AggregateColumnConfig = {
      */
     alwaysClearCell?: boolean
     /**
-     * The `aria-label` to use for this Column`s header element
+     * The `aria-label` to use for this Column's header element
      */
     ariaLabel?: string
     /**
@@ -2057,7 +2067,7 @@ type ChartColumnConfig = {
      */
     alwaysClearCell?: boolean
     /**
-     * The `aria-label` to use for this Column`s header element
+     * The `aria-label` to use for this Column's header element
      */
     ariaLabel?: string
     /**
@@ -2795,7 +2805,7 @@ type CheckColumnConfig = {
      */
     alwaysClearCell?: boolean
     /**
-     * The `aria-label` to use for this Column`s header element
+     * The `aria-label` to use for this Column's header element
      */
     ariaLabel?: string
     /**
@@ -3557,7 +3567,7 @@ type ColorColumnConfig = {
      */
     alwaysClearCell?: boolean
     /**
-     * The `aria-label` to use for this Column`s header element
+     * The `aria-label` to use for this Column's header element
      */
     ariaLabel?: string
     /**
@@ -4252,7 +4262,7 @@ type ColumnConfig = {
      */
     alwaysClearCell?: boolean
     /**
-     * The `aria-label` to use for this Column`s header element
+     * The `aria-label` to use for this Column's header element
      */
     ariaLabel?: string
     /**
@@ -4826,7 +4836,7 @@ export class Column extends Model {
      */
     alwaysClearCell: boolean
     /**
-     * The `aria-label` to use for this Column`s header element
+     * The `aria-label` to use for this Column's header element
      */
     ariaLabel: string
     /**
@@ -5522,7 +5532,7 @@ type CurrencyColumnConfig = {
      */
     alwaysClearCell?: boolean
     /**
-     * The `aria-label` to use for this Column`s header element
+     * The `aria-label` to use for this Column's header element
      */
     ariaLabel?: string
     /**
@@ -6240,7 +6250,7 @@ type DateColumnConfig = {
      */
     alwaysClearCell?: boolean
     /**
-     * The `aria-label` to use for this Column`s header element
+     * The `aria-label` to use for this Column's header element
      */
     ariaLabel?: string
     /**
@@ -6965,7 +6975,7 @@ type NumberColumnConfig = {
      */
     alwaysClearCell?: boolean
     /**
-     * The `aria-label` to use for this Column`s header element
+     * The `aria-label` to use for this Column's header element
      */
     ariaLabel?: string
     /**
@@ -7705,7 +7715,7 @@ type PercentColumnConfig = {
      */
     alwaysClearCell?: boolean
     /**
-     * The `aria-label` to use for this Column`s header element
+     * The `aria-label` to use for this Column's header element
      */
     ariaLabel?: string
     /**
@@ -8431,7 +8441,7 @@ type RatingColumnConfig = {
      */
     alwaysClearCell?: boolean
     /**
-     * The `aria-label` to use for this Column`s header element
+     * The `aria-label` to use for this Column's header element
      */
     ariaLabel?: string
     /**
@@ -9154,7 +9164,7 @@ type RowNumberColumnConfig = {
      */
     alwaysClearCell?: boolean
     /**
-     * The `aria-label` to use for this Column`s header element
+     * The `aria-label` to use for this Column's header element
      */
     ariaLabel?: string
     /**
@@ -9715,7 +9725,7 @@ type SparklineColumnConfig = {
      */
     alwaysClearCell?: boolean
     /**
-     * The `aria-label` to use for this Column`s header element
+     * The `aria-label` to use for this Column's header element
      */
     ariaLabel?: string
     /**
@@ -10414,7 +10424,7 @@ type TemplateColumnConfig = {
      */
     alwaysClearCell?: boolean
     /**
-     * The `aria-label` to use for this Column`s header element
+     * The `aria-label` to use for this Column's header element
      */
     ariaLabel?: string
     /**
@@ -11100,7 +11110,7 @@ type TimeColumnConfig = {
      */
     alwaysClearCell?: boolean
     /**
-     * The `aria-label` to use for this Column`s header element
+     * The `aria-label` to use for this Column's header element
      */
     ariaLabel?: string
     /**
@@ -11783,7 +11793,7 @@ type TreeColumnConfig = {
      */
     alwaysClearCell?: boolean
     /**
-     * The `aria-label` to use for this Column`s header element
+     * The `aria-label` to use for this Column's header element
      */
     ariaLabel?: string
     /**
@@ -12519,7 +12529,7 @@ type WidgetColumnConfig = {
      */
     alwaysClearCell?: boolean
     /**
-     * The `aria-label` to use for this Column`s header element
+     * The `aria-label` to use for this Column's header element
      */
     ariaLabel?: string
     /**
@@ -16100,9 +16110,10 @@ type CellTooltipConfig = {
     catchEventHandlerExceptions?: boolean
     /**
      * *Only valid if this Widget is [floating](https://bryntum.com/products/grid/docs/api/Core/widget/Widget#config-floating).*
-     * Set to `true` to centre the Widget in browser viewport space.
+     * [More...](https://bryntum.com/products/grid/docs/api/Grid/feature/CellTooltip#config-centered)
+     * @property {boolean} [once] If `true`, the Widget will be centred on its first show, but if it is moved at runtime, it will opt out of centering for future shows.
      */
-    centered?: boolean
+    centered?: boolean|object
     /**
      * The widget which this plugin is to attach to.
      */
@@ -16407,7 +16418,7 @@ type CellTooltipConfig = {
      */
     labelPosition?: 'before'|'above'|'align-before'|'auto'|null
     /**
-     * Sets `labelWidth´ for all children of this Container, that does not define their own `labelWidth`.
+     * Sets `labelWidth` for all children of this Container, that do not define their own `labelWidth`.
      * [More...](https://bryntum.com/products/grid/docs/api/Grid/feature/CellTooltip#config-labelWidth)
      */
     labelWidth?: number|null
@@ -16624,7 +16635,7 @@ type CellTooltipConfig = {
     rtl?: boolean
     /**
      * Defines what to do if document is scrolled while Widget is visible (only relevant when floating is set to `true`).
-     * Valid values: ´null´: do nothing, ´hide´: hide the widget or ´realign´: realign to the target if possible.
+     * Valid values: `null`: do nothing, `hide`: hide the widget or `realign`: realign to the target if possible.
      */
     scrollAction?: 'hide'|'realign'|null
     /**
@@ -25607,6 +25618,11 @@ type ExcelExporterConfig = {
      * [More...](https://bryntum.com/products/grid/docs/api/Grid/feature/experimental/ExcelExporter#config-convertEmptyValueToEmptyString)
      */
     convertEmptyValueToEmptyString?: boolean
+    /**
+     * MIME type used when creating the CSV Blob for download. Some environments (e.g. Salesforce Lightning Web
+     * Security) block `text/csv` for `URL.createObjectURL`. Use `application/octet-stream` there instead.
+     */
+    csvMimeType?: string
     /**
      * Defines how dates in a cell will be formatted
      */
@@ -25662,6 +25678,12 @@ type ExcelExporterConfig = {
      * [More...](https://bryntum.com/products/grid/docs/api/Grid/feature/experimental/ExcelExporter#config-xlsProvider)
      */
     xlsProvider?: typeof XlsProviderBase
+    /**
+     * MIME type used when creating the XLSX download Blob. Some environments (e.g. Salesforce Lightning Web
+     * Security) block the default XLSX MIME type for `URL.createObjectURL`. Use `application/octet-stream` in such case
+     * instead.
+     */
+    xlsxMimeType?: string
     /**
      * Fires before an object is destroyed.
      * @param {object} event Event object
@@ -25744,10 +25766,12 @@ export class ExcelExporter extends InstancePlugin {
      * @param {boolean,object} [config.csv] Set to `true` to output as a CSV file, or as an object where you can specify delimiters.
      * @param {string} [config.csv.columnDelimiter] The CSV delimiter to separate values on one line, defaults to `,`.
      * @param {string} [config.csv.lineDelimiter] The CSV delimiter to separate lines, defaults to `\n`.
+     * @param {string} [config.csvMimeType] MIME type used when creating the CSV Blob. Overrides [csvMimeType](https://bryntum.com/products/grid/docs/api/Grid/feature/experimental/ExcelExporter#config-csvMimeType).
+     * @param {string} [config.xlsxMimeType] MIME type used when creating the XLSX download Blob. Overrides [xlsxMimeType](https://bryntum.com/products/grid/docs/api/Grid/feature/experimental/ExcelExporter#config-xlsxMimeType).
      * @param {string[],object[]} [config.columns] An array of column configuration objects
      * @param {Core.data.Model[]} [config.rows] An array of records to export
      */
-    export(config: { filename?: string, dateFormat?: string, csv?: boolean|{ columnDelimiter?: string, lineDelimiter?: string }, columns?: string[]|object[], rows?: Model[] }): Promise<any>;
+    export(config: { filename?: string, dateFormat?: string, csv?: boolean|{ columnDelimiter?: string, lineDelimiter?: string }, csvMimeType?: string, xlsxMimeType?: string, columns?: string[]|object[], rows?: Model[] }): Promise<any>;
 }
 
 /**
@@ -25971,9 +25995,10 @@ export class WriteExcelFileProvider {
      * @param {object} config.sheet *deprecated, to be removed in 7.0* Object with columns and data
      * @param {any[][]} config.sheet.data Array of rows, each row is an array of cells
      * @param {XLSColumn[]} config.sheet.cols Array of columns
-     * @param {string} config.MIME File MIME type
+     * @param {string} config.mimeType MIME type used when creating the download Blob, passed from [xlsxMimeType](https://bryntum.com/products/grid/docs/api/Grid/feature/experimental/ExcelExporter#config-xlsxMimeType).
+     * @param {string} [config.MIME] *deprecated, use `mimeType` instead*
      */
-    static write(config: { filename: string, rows: any[], columns: XLSColumn[], sheet: { data: any[], cols: XLSColumn[] }, MIME: string }): void;
+    static write(config: { filename: string, rows: any[], columns: XLSColumn[], sheet: { data: any[], cols: XLSColumn[] }, mimeType: string, MIME?: string }): Promise<any>;
 }
 
 /**
@@ -25982,17 +26007,18 @@ export class WriteExcelFileProvider {
  */
 export class XlsProviderBase {
     /**
-     * Implement this method to write data to an xls file
+     * Implement this method to write data to an xls file. May return a Promise if the
+     * implementation needs to perform asynchronous work (e.g. awaiting a 3rd-party library).
+     * [ExcelExporter](https://bryntum.com/products/grid/docs/api/Grid/feature/experimental/ExcelExporter) awaits the return value, so both sync
+     * and async implementations are supported.
      * @param {object} config
      * @param {string} config.filename Name of the exported file
      * @param {any[][]} config.rows Array of rows, each row is an array of cells
      * @param {XLSColumn[]} config.columns Array of columns
-     * @param {object} config.sheet *deprecated, to be removed in 7.0* Object with columns and data
-     * @param {any[][]} config.sheet.data Array of rows, each row is an array of cells
-     * @param {XLSColumn[]} config.sheet.cols Array of columns
-     * @param {string} config.MIME File MIME type
+     * @param {string} config.mimeType MIME type to use when creating the download Blob. Configured via [xlsxMimeType](https://bryntum.com/products/grid/docs/api/Grid/feature/experimental/ExcelExporter#config-xlsxMimeType).
+     * @param {string} [config.MIME] *deprecated, use `mimeType` instead*
      */
-    static write(config: { filename: string, rows: any[], columns: XLSColumn[], sheet: { data: any[], cols: XLSColumn[] }, MIME: string }): void;
+    static write(config: { filename: string, rows: any[], columns: XLSColumn[], mimeType: string, MIME?: string }): Promise<void|any>;
 }
 
 /**
@@ -26169,8 +26195,8 @@ type PdfExportConfig = {
      */
     fileName?: string
     /**
-     * A template function used to generate a page footer. It is passed an object with ´currentPage´ and
-     * `totalPages´ properties.
+     * A template function used to generate a page footer. It is passed an object with `currentPage` and
+     * `totalPages` properties.
      * [More...](https://bryntum.com/products/grid/docs/api/Grid/feature/export/PdfExport#config-footerTpl)
      * @param {object} data Data object
      * @param {number} data.currentPage Current page number
@@ -26179,8 +26205,8 @@ type PdfExportConfig = {
      */
     footerTpl?: (data: { currentPage: number, totalPages: number }) => string
     /**
-     * A template function used to generate a page header. It is passed an object with ´currentPage´ and
-     * `totalPages´ properties.
+     * A template function used to generate a page header. It is passed an object with `currentPage` and
+     * `totalPages` properties.
      * [More...](https://bryntum.com/products/grid/docs/api/Grid/feature/export/PdfExport#config-headerTpl)
      * @param {object} data Data object
      * @param {number} data.currentPage Current page number
@@ -26610,8 +26636,8 @@ type PrintConfig = {
      */
     exporters?: Exporter[]
     /**
-     * A template function used to generate a page footer. It is passed an object with ´currentPage´ and
-     * `totalPages´ properties.
+     * A template function used to generate a page footer. It is passed an object with `currentPage` and
+     * `totalPages` properties.
      * [More...](https://bryntum.com/products/grid/docs/api/Grid/feature/export/Print#config-footerTpl)
      * @param {object} data Data object
      * @param {number} data.currentPage Current page number
@@ -26620,8 +26646,8 @@ type PrintConfig = {
      */
     footerTpl?: (data: { currentPage: number, totalPages: number }) => string
     /**
-     * A template function used to generate a page header. It is passed an object with ´currentPage´ and
-     * `totalPages´ properties.
+     * A template function used to generate a page header. It is passed an object with `currentPage` and
+     * `totalPages` properties.
      * [More...](https://bryntum.com/products/grid/docs/api/Grid/feature/export/Print#config-headerTpl)
      * @param {object} data Data object
      * @param {number} data.currentPage Current page number
@@ -30896,7 +30922,7 @@ type GridConfig = {
      */
     labelPosition?: 'before'|'above'|'align-before'|'auto'|null
     /**
-     * Sets `labelWidth´ for all children of this Container, that does not define their own `labelWidth`.
+     * Sets `labelWidth` for all children of this Container, that do not define their own `labelWidth`.
      * [More...](https://bryntum.com/products/grid/docs/api/Grid/view/Grid#config-labelWidth)
      */
     labelWidth?: number|null
@@ -34957,7 +34983,7 @@ type GridBaseConfig = {
      */
     labelPosition?: 'before'|'above'|'align-before'|'auto'|null
     /**
-     * Sets `labelWidth´ for all children of this Container, that does not define their own `labelWidth`.
+     * Sets `labelWidth` for all children of this Container, that do not define their own `labelWidth`.
      * [More...](https://bryntum.com/products/grid/docs/api/Grid/view/GridBase#config-labelWidth)
      */
     labelWidth?: number|null
@@ -38400,9 +38426,10 @@ type SubGridConfig = {
     catchEventHandlerExceptions?: boolean
     /**
      * *Only valid if this Widget is [floating](https://bryntum.com/products/grid/docs/api/Core/widget/Widget#config-floating).*
-     * Set to `true` to centre the Widget in browser viewport space.
+     * [More...](https://bryntum.com/products/grid/docs/api/Grid/view/SubGrid#config-centered)
+     * @property {boolean} [once] If `true`, the Widget will be centred on its first show, but if it is moved at runtime, it will opt out of centering for future shows.
      */
-    centered?: boolean
+    centered?: boolean|object
     /**
      * Custom CSS classes to add to element.
      * May be specified as a space separated string, or as an object in which property names
@@ -41435,7 +41462,7 @@ type TreeGridConfig = {
      */
     labelPosition?: 'before'|'above'|'align-before'|'auto'|null
     /**
-     * Sets `labelWidth´ for all children of this Container, that does not define their own `labelWidth`.
+     * Sets `labelWidth` for all children of this Container, that do not define their own `labelWidth`.
      * [More...](https://bryntum.com/products/grid/docs/api/Grid/view/TreeGrid#config-labelWidth)
      */
     labelWidth?: number|null
@@ -43485,9 +43512,10 @@ type ExportDialogConfig = {
     catchEventHandlerExceptions?: boolean
     /**
      * *Only valid if this Widget is [floating](https://bryntum.com/products/grid/docs/api/Core/widget/Widget#config-floating).*
-     * Set to `true` to centre the Widget in browser viewport space.
+     * [More...](https://bryntum.com/products/grid/docs/api/Grid/view/export/ExportDialog#config-centered)
+     * @property {boolean} [once] If `true`, the Widget will be centred on its first show, but if it is moved at runtime, it will opt out of centering for future shows.
      */
-    centered?: boolean
+    centered?: boolean|object
     /**
      * Grid instance to build export dialog for
      */
@@ -43752,7 +43780,7 @@ type ExportDialogConfig = {
      */
     labelPosition?: 'before'|'above'|'align-before'|'auto'|null
     /**
-     * Sets `labelWidth´ for all children of this Container, that does not define their own `labelWidth`.
+     * Sets `labelWidth` for all children of this Container, that do not define their own `labelWidth`.
      * [More...](https://bryntum.com/products/grid/docs/api/Grid/view/export/ExportDialog#config-labelWidth)
      */
     labelWidth?: number|null
@@ -43957,7 +43985,7 @@ type ExportDialogConfig = {
     rtl?: boolean
     /**
      * Defines what to do if document is scrolled while Widget is visible (only relevant when floating is set to `true`).
-     * Valid values: ´null´: do nothing, ´hide´: hide the widget or ´realign´: realign to the target if possible.
+     * Valid values: `null`: do nothing, `hide`: hide the widget or `realign`: realign to the target if possible.
      */
     scrollAction?: 'hide'|'realign'|null
     /**
@@ -44307,7 +44335,7 @@ export class ExportDialog extends Popup {
     /**
      * Returns map of values of dialog fields.
      */
-    readonly values: Record<string, object>
+    values: Record<string, object>
     /**
      * Fires before an object is destroyed.
      * @param {object} event Event object
@@ -45469,9 +45497,10 @@ type AIFilterFieldConfig = {
     catchEventHandlerExceptions?: boolean
     /**
      * *Only valid if this Widget is [floating](https://bryntum.com/products/grid/docs/api/Core/widget/Widget#config-floating).*
-     * Set to `true` to centre the Widget in browser viewport space.
+     * [More...](https://bryntum.com/products/grid/docs/api/Grid/widget/AIFilterField#config-centered)
+     * @property {boolean} [once] If `true`, the Widget will be centred on its first show, but if it is moved at runtime, it will opt out of centering for future shows.
      */
-    centered?: boolean
+    centered?: boolean|object
     /**
      * 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)
@@ -45485,6 +45514,7 @@ type AIFilterFieldConfig = {
      * Show a trigger to clear field, if this field is not [readOnly](https://bryntum.com/products/grid/docs/api/Core/widget/Field#config-readOnly). The trigger is available
      * in the [triggers](https://bryntum.com/products/grid/docs/api/Core/widget/Field#property-triggers) object under the name `clear`. May also be an object which
      * configures the `clear` [trigger](https://bryntum.com/products/grid/docs/api/Core/widget/Field#property-triggers).
+     * [More...](https://bryntum.com/products/grid/docs/api/Grid/widget/AIFilterField#config-clearable)
      */
     clearable?: boolean|FieldTriggerConfig
     /**
@@ -45572,7 +45602,7 @@ type AIFilterFieldConfig = {
     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´
+     * 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.
      * [More...](https://bryntum.com/products/grid/docs/api/Grid/widget/AIFilterField#config-draggable)
      * @property {string} handleSelector CSS selector used to determine if drag can be started from a mouse-downed element inside the widget
@@ -45908,7 +45938,7 @@ type AIFilterFieldConfig = {
     rtl?: boolean
     /**
      * Defines what to do if document is scrolled while Widget is visible (only relevant when floating is set to `true`).
-     * Valid values: ´null´: do nothing, ´hide´: hide the widget or ´realign´: realign to the target if possible.
+     * Valid values: `null`: do nothing, `hide`: hide the widget or `realign`: realign to the target if possible.
      */
     scrollAction?: 'hide'|'realign'|null
     /**
@@ -46634,9 +46664,10 @@ type ChecklistFilterComboConfig = {
     catchEventHandlerExceptions?: boolean
     /**
      * *Only valid if this Widget is [floating](https://bryntum.com/products/grid/docs/api/Core/widget/Widget#config-floating).*
-     * Set to `true` to centre the Widget in browser viewport space.
+     * [More...](https://bryntum.com/products/grid/docs/api/Grid/widget/ChecklistFilterCombo#config-centered)
+     * @property {boolean} [once] If `true`, the Widget will be centred on its first show, but if it is moved at runtime, it will opt out of centering for future shows.
      */
-    centered?: boolean
+    centered?: boolean|object
     /**
      * 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)
@@ -46668,6 +46699,7 @@ type ChecklistFilterComboConfig = {
      * Show a trigger to clear field, if this field is not [readOnly](https://bryntum.com/products/grid/docs/api/Core/widget/Field#config-readOnly). The trigger is available
      * in the [triggers](https://bryntum.com/products/grid/docs/api/Core/widget/Field#property-triggers) object under the name `clear`. May also be an object which
      * configures the `clear` [trigger](https://bryntum.com/products/grid/docs/api/Core/widget/Field#property-triggers).
+     * [More...](https://bryntum.com/products/grid/docs/api/Grid/widget/ChecklistFilterCombo#config-clearable)
      */
     clearable?: boolean|FieldTriggerConfig
     /**
@@ -46771,7 +46803,7 @@ type ChecklistFilterComboConfig = {
     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´
+     * 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.
      * [More...](https://bryntum.com/products/grid/docs/api/Grid/widget/ChecklistFilterCombo#config-draggable)
      * @property {string} handleSelector CSS selector used to determine if drag can be started from a mouse-downed element inside the widget
@@ -47218,7 +47250,7 @@ type ChecklistFilterComboConfig = {
     rtl?: boolean
     /**
      * Defines what to do if document is scrolled while Widget is visible (only relevant when floating is set to `true`).
-     * Valid values: ´null´: do nothing, ´hide´: hide the widget or ´realign´: realign to the target if possible.
+     * Valid values: `null`: do nothing, `hide`: hide the widget or `realign`: realign to the target if possible.
      */
     scrollAction?: 'hide'|'realign'|null
     /**
@@ -47856,9 +47888,10 @@ type GridChartDesignerConfig = {
     catchEventHandlerExceptions?: boolean
     /**
      * *Only valid if this Widget is [floating](https://bryntum.com/products/grid/docs/api/Core/widget/Widget#config-floating).*
-     * Set to `true` to centre the Widget in browser viewport space.
+     * [More...](https://bryntum.com/products/grid/docs/api/Grid/widget/GridChartDesigner#config-centered)
+     * @property {boolean} [once] If `true`, the Widget will be centred on its first show, but if it is moved at runtime, it will opt out of centering for future shows.
      */
-    centered?: boolean
+    centered?: boolean|object
     /**
      * Custom CSS classes to add to element.
      * May be specified as a space separated string, or as an object in which property names
@@ -47931,7 +47964,7 @@ type GridChartDesignerConfig = {
     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´
+     * 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.
      * [More...](https://bryntum.com/products/grid/docs/api/Grid/widget/GridChartDesigner#config-draggable)
      * @property {string} handleSelector CSS selector used to determine if drag can be started from a mouse-downed element inside the widget
@@ -48147,7 +48180,7 @@ type GridChartDesignerConfig = {
     rtl?: boolean
     /**
      * Defines what to do if document is scrolled while Widget is visible (only relevant when floating is set to `true`).
-     * Valid values: ´null´: do nothing, ´hide´: hide the widget or ´realign´: realign to the target if possible.
+     * Valid values: `null`: do nothing, `hide`: hide the widget or `realign`: realign to the target if possible.
      */
     scrollAction?: 'hide'|'realign'|null
     /**
@@ -48731,9 +48764,10 @@ type GridFieldFilterPickerConfig = {
     catchEventHandlerExceptions?: boolean
     /**
      * *Only valid if this Widget is [floating](https://bryntum.com/products/grid/docs/api/Core/widget/Widget#config-floating).*
-     * Set to `true` to centre the Widget in browser viewport space.
+     * [More...](https://bryntum.com/products/grid/docs/api/Grid/widget/GridFieldFilterPicker#config-centered)
+     * @property {boolean} [once] If `true`, the Widget will be centred on its first show, but if it is moved at runtime, it will opt out of centering for future shows.
      */
-    centered?: boolean
+    centered?: boolean|object
     /**
      * Custom CSS classes to add to element.
      * May be specified as a space separated string, or as an object in which property names
@@ -48821,7 +48855,7 @@ type GridFieldFilterPickerConfig = {
     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´
+     * 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.
      * [More...](https://bryntum.com/products/grid/docs/api/Grid/widget/GridFieldFilterPicker#config-draggable)
      * @property {string} handleSelector CSS selector used to determine if drag can be started from a mouse-downed element inside the widget
@@ -48957,7 +48991,7 @@ type GridFieldFilterPickerConfig = {
      */
     labelPosition?: 'before'|'above'|'align-before'|'auto'|null
     /**
-     * Sets `labelWidth´ for all children of this Container, that does not define their own `labelWidth`.
+     * Sets `labelWidth` for all children of this Container, that do not define their own `labelWidth`.
      * [More...](https://bryntum.com/products/grid/docs/api/Grid/widget/GridFieldFilterPicker#config-labelWidth)
      */
     labelWidth?: number|null
@@ -49143,7 +49177,7 @@ type GridFieldFilterPickerConfig = {
     rtl?: boolean
     /**
      * Defines what to do if document is scrolled while Widget is visible (only relevant when floating is set to `true`).
-     * Valid values: ´null´: do nothing, ´hide´: hide the widget or ´realign´: realign to the target if possible.
+     * Valid values: `null`: do nothing, `hide`: hide the widget or `realign`: realign to the target if possible.
      */
     scrollAction?: 'hide'|'realign'|null
     /**
@@ -49812,9 +49846,10 @@ type GridFieldFilterPickerGroupConfig = {
     catchEventHandlerExceptions?: boolean
     /**
      * *Only valid if this Widget is [floating](https://bryntum.com/products/grid/docs/api/Core/widget/Widget#config-floating).*
-     * Set to `true` to centre the Widget in browser viewport space.
+     * [More...](https://bryntum.com/products/grid/docs/api/Grid/widget/GridFieldFilterPickerGroup#config-centered)
+     * @property {boolean} [once] If `true`, the Widget will be centred on its first show, but if it is moved at runtime, it will opt out of centering for future shows.
      */
-    centered?: boolean
+    centered?: boolean|object
     /**
      * Custom CSS classes to add to element.
      * May be specified as a space separated string, or as an object in which property names
@@ -49902,7 +49937,7 @@ type GridFieldFilterPickerGroupConfig = {
     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´
+     * 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.
      * [More...](https://bryntum.com/products/grid/docs/api/Grid/widget/GridFieldFilterPickerGroup#config-draggable)
      * @property {string} handleSelector CSS selector used to determine if drag can be started from a mouse-downed element inside the widget
@@ -50034,7 +50069,7 @@ type GridFieldFilterPickerGroupConfig = {
      */
     labelPosition?: 'before'|'above'|'align-before'|'auto'|null
     /**
-     * Sets `labelWidth´ for all children of this Container, that does not define their own `labelWidth`.
+     * Sets `labelWidth` for all children of this Container, that do not define their own `labelWidth`.
      * [More...](https://bryntum.com/products/grid/docs/api/Grid/widget/GridFieldFilterPickerGroup#config-labelWidth)
      */
     labelWidth?: number|null
@@ -50215,7 +50250,7 @@ type GridFieldFilterPickerGroupConfig = {
     rtl?: boolean
     /**
      * Defines what to do if document is scrolled while Widget is visible (only relevant when floating is set to `true`).
-     * Valid values: ´null´: do nothing, ´hide´: hide the widget or ´realign´: realign to the target if possible.
+     * Valid values: `null`: do nothing, `hide`: hide the widget or `realign`: realign to the target if possible.
      */
     scrollAction?: 'hide'|'realign'|null
     /**
@@ -50890,9 +50925,10 @@ type GroupBarConfig = {
     catchEventHandlerExceptions?: boolean
     /**
      * *Only valid if this Widget is [floating](https://bryntum.com/products/grid/docs/api/Core/widget/Widget#config-floating).*
-     * Set to `true` to centre the Widget in browser viewport space.
+     * [More...](https://bryntum.com/products/grid/docs/api/Grid/widget/GroupBar#config-centered)
+     * @property {boolean} [once] If `true`, the Widget will be centred on its first show, but if it is moved at runtime, it will opt out of centering for future shows.
      */
-    centered?: boolean
+    centered?: boolean|object
     /**
      * Configure as `true` to clear selection when clicking on empty space inside the List´s element.
      */
@@ -50991,7 +51027,7 @@ type GroupBarConfig = {
     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´
+     * 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.
      * [More...](https://bryntum.com/products/grid/docs/api/Grid/widget/GroupBar#config-draggable)
      * @property {string} handleSelector CSS selector used to determine if drag can be started from a mouse-downed element inside the widget
@@ -51257,7 +51293,7 @@ type GroupBarConfig = {
     rtl?: boolean
     /**
      * Defines what to do if document is scrolled while Widget is visible (only relevant when floating is set to `true`).
-     * Valid values: ´null´: do nothing, ´hide´: hide the widget or ´realign´: realign to the target if possible.
+     * Valid values: `null`: do nothing, `hide`: hide the widget or `realign`: realign to the target if possible.
      */
     scrollAction?: 'hide'|'realign'|null
     /**
@@ -51983,9 +52019,10 @@ type TreeComboConfig = {
     catchEventHandlerExceptions?: boolean
     /**
      * *Only valid if this Widget is [floating](https://bryntum.com/products/grid/docs/api/Core/widget/Widget#config-floating).*
-     * Set to `true` to centre the Widget in browser viewport space.
+     * [More...](https://bryntum.com/products/grid/docs/api/Grid/widget/TreeCombo#config-centered)
+     * @property {boolean} [once] If `true`, the Widget will be centred on its first show, but if it is moved at runtime, it will opt out of centering for future shows.
      */
-    centered?: boolean
+    centered?: boolean|object
     /**
      * 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)
@@ -52017,6 +52054,7 @@ type TreeComboConfig = {
      * Show a trigger to clear field, if this field is not [readOnly](https://bryntum.com/products/grid/docs/api/Core/widget/Field#config-readOnly). The trigger is available
      * in the [triggers](https://bryntum.com/products/grid/docs/api/Core/widget/Field#property-triggers) object under the name `clear`. May also be an object which
      * configures the `clear` [trigger](https://bryntum.com/products/grid/docs/api/Core/widget/Field#property-triggers).
+     * [More...](https://bryntum.com/products/grid/docs/api/Grid/widget/TreeCombo#config-clearable)
      */
     clearable?: boolean|FieldTriggerConfig
     /**
@@ -52120,7 +52158,7 @@ type TreeComboConfig = {
     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´
+     * 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.
      * [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
@@ -52566,7 +52604,7 @@ type TreeComboConfig = {
     rtl?: boolean
     /**
      * Defines what to do if document is scrolled while Widget is visible (only relevant when floating is set to `true`).
-     * Valid values: ´null´: do nothing, ´hide´: hide the widget or ´realign´: realign to the target if possible.
+     * Valid values: `null`: do nothing, `hide`: hide the widget or `realign`: realign to the target if possible.
      */
     scrollAction?: 'hide'|'realign'|null
     /**