survey-react 1.9.54 → 1.9.55

package/survey.react.d.ts

@@ -1,5 +1,5 @@
 /*
-* Type definition for Survey JavaScript library for React v1.9.54
+* Type definition for Survey JavaScript library for React v1.9.55
 * Copyright (c) 2015-2022 Devsoft Baltic OÜ  - https://surveyjs.io/
 * License: MIT (http://www.opensource.org/licenses/mit-license.php)
 */
@@ -388,6 +388,7 @@ export interface ISurvey extends ITextProcessor, ISurveyErrorOwner {
   getQuestionByValueNameFromArray(valueName: string, name: string, index: number): IQuestion;
   canChangeChoiceItemsVisibility(): boolean;
   getChoiceItemVisibility(question: IQuestion, item: any, val: boolean): boolean;
+  loadQuestionChoices(options: any): void;
   matrixRowAdded(question: IQuestion, row: any): any;
   matrixBeforeRowAdded(options: any): any;
   matrixRowRemoved(question: IQuestion, rowIndex: number, row: any): any;
@@ -1459,6 +1460,7 @@ export declare class SurveyActionBarSeparator extends React.Component<any, any>
 export declare class SurveyElementBase<P, S> extends React.Component<P, S> {
   constructor(props: any);
   static renderLocString(locStr: any, style?: any, key?: string): JSX.Element;
+  static renderQuestionDescription(question: any): JSX.Element;
   changedStatePropNameValue: string;
   componentDidMount(): void;
   componentWillUnmount(): void;
@@ -1484,7 +1486,6 @@ export declare class SurveyElementHeader extends React.Component<any, any> {
   constructor(props: any);
   constructor(props: any, context: any);
   render(): JSX.Element;
-  protected renderDescription(): JSX.Element;
 }
 export declare class SurveyError {
   constructor(text?: string, errorOwner?: ISurveyErrorOwner);
@@ -2013,6 +2014,7 @@ export declare class DropdownListModel extends Base {
   constructor(question: Question, onSelectionChanged?: (item: IAction, ...params: any) => void);
   _popupModel: any;
   focusFirstInputSelector: string;
+  itemsSettings: any;
   protected listModel: ListModel;
   protected popupCssClasses: string;
   protected onHidePopup(): void;
@@ -2023,6 +2025,7 @@ export declare class DropdownListModel extends Base {
   setInputHasValue(newValue: boolean): void;
   searchEnabled: boolean;
   filterString: string;
+  hasScroll: boolean;
   get popupModel(): any;
   get inputReadOnly(): boolean;
   setSearchEnabled(newValue: boolean): void;
@@ -2031,6 +2034,7 @@ export declare class DropdownListModel extends Base {
   onClear(event: any): void;
   getSelectedAction(): Action;
   keyHandler(event: any): void;
+  onScroll(event: any): void;
   onBlur(event: any): void;
   scrollToFocusedItem(): void;
 }
@@ -2283,10 +2287,12 @@ export declare class KeyDuplicationError extends SurveyError {
 }
 export declare class List extends SurveyElementBase<IListProps, any> {
   constructor(props: any);
+  listContainerRef: any;
   get model(): any;
   handleKeydown: (event: any) => void;
   handleMouseMove: (event: any) => void;
   getStateElement(): any;
+  componentDidMount(): void;
   renderElement(): JSX.Element;
   renderItems(): any;
   searchElementContent(): JSX.Element;
@@ -2299,6 +2305,7 @@ export declare class ListItem extends SurveyElementBase<IListItemProps, any> {
   handleKeydown: (event: any) => void;
   getStateElement(): any;
   render(): JSX.Element;
+  componentDidMount(): void;
 }
 /*
 * The class represents the string that supports multi-languages and markdown.
@@ -3111,6 +3118,7 @@ export declare class SurveyElementCore extends Base implements ILocalizableOwner
   getTitleToolbar(): AdaptiveActionContainer;
   getTitleOwner(): ITitleOwner;
   get isTitleOwner(): boolean;
+  get isTitleRenderedAsString(): boolean;
   toggleState(): boolean;
   get cssClasses(): any;
   get cssTitle(): string;
@@ -3119,6 +3127,7 @@ export declare class SurveyElementCore extends Base implements ILocalizableOwner
   get titleAriaExpanded(): boolean;
   get ariaLabel(): string;
   get titleAriaLabel(): string;
+  protected getIsTitleRenderedAsString(): boolean;
   getLocale(): string;
   getMarkdownHtml(text: string, name: string): string;
   getRenderer(name: string): string;
@@ -3552,14 +3561,18 @@ export declare class ListModel extends ActionContainer {
   constructor(items: any, onSelectionChanged: (item: Action, ...params: any) => void, allowSelection: boolean, selectedItem?: IAction, onFilterStringChangedCallback?: (text: string) => void);
   onSelectionChanged: (item: Action, ...params: any) => void;
   allowSelection: boolean;
+  listContainerHtmlElement: any;
   searchEnabled: boolean;
   showFilter: boolean;
   isExpanded: boolean;
   selectedItem: IAction;
   focusedItem: Action;
   filterString: string;
+  hasVerticalScroller: boolean;
+  isAllDataLoaded: boolean;
   static INDENT: number;
   static MINELEMENTCOUNT: number;
+  scrollHandler: (e?: any) => void;
   isItemVisible(item: Action): boolean;
   get visibleItems(): any;
   protected onSet(): void;
@@ -3573,6 +3586,7 @@ export declare class ListModel extends ActionContainer {
   getItemIndent: (itemValue: any) => string;
   get filterStringPlaceholder(): string;
   get emptyMessage(): string;
+  get scrollableContainer(): any;
   goToItems(event: any): void;
   onMouseMove(event: any): void;
   onKeyDown(event: any): void;
@@ -3585,6 +3599,11 @@ export declare class ListModel extends ActionContainer {
   focusNextVisibleItem(): void;
   focusPrevVisibleItem(): void;
   selectFocusedItem(): void;
+  initListContainerHtmlElement(htmlElement: any): void;
+  onLastItemRended(item: Action): void;
+  scrollToFocusedItem(): void;
+  addScrollEventListener(handler: (e?: any) => void): void;
+  removeScrollEventListener(): void;
 }
 export declare class MatrixDropdownRowModel extends MatrixDropdownRowModelBase {
   constructor(name: string, item: ItemValue, data: IMatrixDropdownData, value: any);
@@ -3919,7 +3938,7 @@ export declare class SurveyElement<E = any> extends SurveyElementCore implements
   protected moveToBase(parent: IPanel, container: IPanel, insertBefore?: any): boolean;
   protected setPage(parent: IPanel, newPage: IPage): void;
   protected getSearchableLocKeys(keys: any): void;
-  protected get isDefaultV2Theme(): boolean;
+  get isDefaultV2Theme(): boolean;
   get isErrorsModeTooltip(): boolean;
   protected getIsErrorsModeTooltip(): boolean;
   protected getIsTooltipErrorSupportedByParent(): boolean;
@@ -4440,6 +4459,7 @@ export declare class SurveyModel extends SurveyElementCore implements ISurvey, I
   * - `options.visible` - A Boolean value that specifies the item visibility. Set it to `false` to hide the item.
   */
   onShowingChoiceItem: EventBase<SurveyModel>;
+  onChoicesLazyLoad: EventBase<SurveyModel>;
   /*
   * The event is fired on adding a new row in Matrix Dynamic question.
   * - `sender` - the survey object that fires the event
@@ -5523,6 +5543,7 @@ export declare class SurveyModel extends SurveyElementCore implements ISurvey, I
   whenPanelFocusIn(panel: IPanel): void;
   canChangeChoiceItemsVisibility(): boolean;
   getChoiceItemVisibility(question: IQuestion, item: any, val: boolean): boolean;
+  loadQuestionChoices(options: any): void;
   matrixBeforeRowAdded(options: any): void;
   matrixRowAdded(question: IQuestion, row: any): void;
   getQuestionByValueNameFromArray(valueName: string, name: string, index: number): IQuestion;
@@ -5790,6 +5811,8 @@ export declare class SurveyModel extends SurveyElementCore implements ISurvey, I
   */
   get widthMode(): string;
   set widthMode(val: string);
+  calculatedWidthModeUpdater: any;
+  setCalculatedWidthModeUpdater(): void;
   calculatedWidthMode: string;
   calculateWidthMode(): string;
   /*
@@ -6730,6 +6753,7 @@ export declare class Question extends SurveyElement<Question> implements IQuesti
   get titleLocation(): string;
   set titleLocation(val: string);
   getTitleOwner(): ITitleOwner;
+  protected getIsTitleRenderedAsString(): boolean;
   /*
   * Returns title location calculated based on the question's `titleLocation` property and the `questionTitleLocation` property of the question's containers (survey, page, or panel).
   */
@@ -7082,6 +7106,7 @@ export declare class Question extends SurveyElement<Question> implements IQuesti
   protected getValidName(name: string): string;
   updateValueFromSurvey(newValue: any): void;
   updateCommentFromSurvey(newValue: any): any;
+  protected onChangeQuestionValue(newValue: any): void;
   protected setQuestionValue(newValue: any, updateIsAnswered?: boolean): void;
   onSurveyValueChanged(newValue: any): void;
   setVisibleIndex(val: number): number;
@@ -7522,10 +7547,12 @@ export declare class QuestionBooleanModel extends Question {
   set defaultValue(val: any);
   getDefaultValue(): any;
   get locTitle(): LocalizableString;
+  showTitle: boolean;
   get label(): string;
   set label(val: string);
   get locLabel(): LocalizableString;
-  get locDisplayLabel(): LocalizableString;
+  get isLabelRendered(): boolean;
+  get canRenderLabelDescription(): boolean;
   /*
   * Gets or sets a text label that corresponds to a positive answer.
   * 
@@ -7543,7 +7570,6 @@ export declare class QuestionBooleanModel extends Question {
   get labelFalse(): any;
   set labelFalse(val: any);
   get locLabelFalse(): LocalizableString;
-  showTitle: boolean;
   /*
   * A value to save in survey results when respondents give a positive answer.
   * 
@@ -7719,6 +7745,7 @@ export declare class QuestionFileModel extends Question {
   * - `sender` - A question instance that raised the event.
   * - `options.state` - Current upload state: `"empty"`, `"loading"`, `"loaded"`, or `"error"`.
   */
+  onUploadStateChanged: EventBase<QuestionFileModel>;
   onStateChanged: EventBase<QuestionFileModel>;
   previewValue: any;
   currentState: string;
@@ -7829,7 +7856,6 @@ export declare class QuestionFileModel extends Question {
   get showRemoveButton(): any;
   get showRemoveButtonBottom(): any;
   defaultImage(data: any): boolean;
-  get imageWidthRendered(): string;
   /*
   * Removes a file with a specified name.
   */
@@ -7841,7 +7867,6 @@ export declare class QuestionFileModel extends Question {
   loadFiles(files: any): void;
   canPreviewImage(fileItem: any): boolean;
   protected loadPreview(newValue: any): void;
-  protected setQuestionValue(newValue: any, updateIsAnswered?: boolean): void;
   protected onCheckForErrors(errors: any, isOnValueChanged: boolean): void;
   protected stateChanged(state: string): void;
   getPlainData(options?: any): any;
@@ -7850,6 +7875,7 @@ export declare class QuestionFileModel extends Question {
   getReadOnlyFileCss(): string;
   get fileRootCss(): string;
   getFileDecoratorCss(): string;
+  protected onChangeQuestionValue(newValue: any): void;
   rootElement: any;
   afterRender(el: any): void;
   dragCounter: number;
@@ -7863,7 +7889,7 @@ export declare class QuestionFileModel extends Question {
   doDownloadFile: (event: any, data: any) => void;
 }
 /*
-* A Model for a matrix base question.
+* A base class for all matrix question types.
 */
 export declare class QuestionMatrixBaseModel<TRow, TColumn> extends Question {
   constructor(name: string);
@@ -7877,34 +7903,56 @@ export declare class QuestionMatrixBaseModel<TRow, TColumn> extends Question {
   endLoadingFromJson(): void;
   get isCompositeQuestion(): boolean;
   /*
-  * Set this property to false, to hide table header. The default value is true.
+  * Specifies whether to display the table header that contains column captions.
+  * 
+  * Default value: `true`
   */
   get showHeader(): boolean;
   set showHeader(val: boolean);
   /*
-  * The list of columns. A column has a value and an optional text
+  * An array of matrix columns.
+  * 
+  * This array can contain primitive values or objects with the `text` (display value) and `value` (value to be saved in survey results) properties.
+  * 
+  * [View Demo](https://surveyjs.io/form-library/examples/single-selection-matrix-table-question/ (linkStyle))
   */
   get columns(): any;
   set columns(val: any);
   get visibleColumns(): any;
   /*
-  * The list of rows. A row has a value and an optional text
+  * An array of matrix rows.
+  * 
+  * This array can contain primitive values or objects with the `text` (display value) and `value` (value to be saved in survey results) properties.
+  * 
+  * [View Demo](https://surveyjs.io/form-library/examples/single-selection-matrix-table-question/ (linkStyle))
   */
   get rows(): any;
   set rows(val: any);
   protected processRowsOnSet(newRows: any): any;
   protected getVisibleRows(): Array<TRow>;
   /*
-  * Returns the list of visible rows as model objects.
+  * Returns an array of visible matrix rows.
   */
   get visibleRows(): any;
   /*
-  * An expression that returns true or false. It runs against each row item and if for this item it returns true, then the item is visible otherwise the item becomes invisible. Please use {item} to get the current item value in the expression.
+  * A Boolean expression that is evaluated against each matrix row. If the expression evaluates to `false`, the row becomes hidden.
+  * 
+  * A survey parses and runs all expressions on startup. If any values used in the expression change, the survey re-evaluates it.
+  * 
+  * Use the `{item}` placeholder to reference the current row in the expression.
+  * 
+  * Refer to the following help topic for more information: [Conditional Visibility](https://surveyjs.io/form-library/documentation/design-survey-conditional-logic#conditional-visibility).
   */
   get rowsVisibleIf(): string;
   set rowsVisibleIf(val: string);
   /*
-  * An expression that returns true or false. It runs against each column item and if for this item it returns true, then the item is visible otherwise the item becomes invisible. Please use {item} to get the current item value in the expression.
+  * A Boolean expression that is evaluated against each matrix column. If the expression evaluates to `false`, the column becomes hidden.
+  * 
+  * A survey parses and runs all expressions on startup. If any values used in the expression change, the survey re-evaluates it.
+  * 
+  * Use the `{item}` placeholder to reference the current column in the expression.
+  * 
+  * Refer to the following help topic for more information: [Conditional Visibility](https://surveyjs.io/form-library/documentation/design-survey-conditional-logic#conditional-visibility).
   */
   get columnsVisibleIf(): string;
   set columnsVisibleIf(val: string);
@@ -9073,6 +9121,8 @@ export declare class QuestionDropdownModel extends QuestionSelectBase {
   searchEnabled: boolean;
   inputHasValue: boolean;
   readOnlyText: string;
+  choicesLazyLoadEnabled: boolean;
+  choicesLazyLoadPageSize: number;
   getControlClass(): string;
   get selectedItemLocText(): LocalizableString;
   get inputFieldComponentName(): string;
@@ -9088,7 +9138,9 @@ export declare class QuestionDropdownModel extends QuestionSelectBase {
   onKeyUp(event: any): void;
 }
 /*
-* A Model for html question. Unlike other questions it doesn't have value and title.
+* A class that describes the Html question type. Unlike other question types, Html cannot have a title or value.
+* 
+* [View Demo](https://surveyjs.io/form-library/examples/questiontype-html/ (linkStyle))
 */
 export declare class QuestionHtmlModel extends QuestionNonValue {
   constructor(name: string);
@@ -9097,7 +9149,9 @@ export declare class QuestionHtmlModel extends QuestionNonValue {
   get isCompositeQuestion(): boolean;
   getProcessedText(text: string): string;
   /*
-  * Set html to display it
+  * HTML markup to display.
+  * 
+  * > IMPORTANT: If you get the markup from a third party, ensure that it does not contain malicious code.
   */
   get html(): string;
   set html(val: string);
@@ -9105,7 +9159,9 @@ export declare class QuestionHtmlModel extends QuestionNonValue {
   get processedHtml(): string;
 }
 /*
-* A Model for image question. This question hasn't any functionality and can be used to improve the appearance of the survey.
+* A class that describes the Image question type. Unlike other question types, Image cannot have a title or value.
+* 
+* [View Demo](https://surveyjs.io/form-library/examples/questiontype-image/ (linkStyle))
 */
 export declare class QuestionImageModel extends QuestionNonValue {
   constructor(name: string);
@@ -9113,48 +9169,65 @@ export declare class QuestionImageModel extends QuestionNonValue {
   get isCompositeQuestion(): boolean;
   onSurveyLoad(): void;
   /*
-  * The image URL.
+  * Specifies an image or video URL.
   */
   get imageLink(): string;
   set imageLink(val: string);
   get locImageLink(): LocalizableString;
   /*
-  * The image alt text.
+  * Specifies a value for the `alt` attribute of the underlying `<img>` element.
   */
   get altText(): string;
   set altText(val: string);
   get locAltText(): LocalizableString;
   /*
-  * The image height.
+  * Specifies the height of a container for the image or video. Accepts positive numbers and CSS values.
+  * 
+  * Default value: 150
+  * 
+  * Use the `imageFit` property to specify how to fit the image or video into the container.
   */
   get imageHeight(): string;
   set imageHeight(val: string);
   get renderedHeight(): string;
   /*
-  * The image width.
+  * Specifies the width of a container for the image or video. Accepts positive numbers and CSS values.
+  * 
+  * Default value: 200
+  * 
+  * Use the `imageFit` property to specify how to fit the image or video into the container.
   */
   get imageWidth(): string;
   set imageWidth(val: string);
   get renderedWidth(): string;
   /*
-  * The image fit mode.
+  * Specifies how to resize the image or video to fit it into its container.
+  * 
+  * Refer to the [`object-fit`](https://developer.mozilla.org/en-US/docs/Web/CSS/object-fit) CSS property description for information on accepted values.
   */
   get imageFit(): string;
   set imageFit(val: string);
   /*
-  * The content mode.
+  * Specifies the type of content that the Image question displays.
+  * 
+  * Possible values:
+  * 
+  * - `"image"` - An image in one of the following formats: JPEG, GIF, PNG, APNG, SVG, BMP, ICO.
+  * - `"video"` - A video in one of the following formats: MP4, MOV, WMV, FLV, AVI, MKV.
+  * - `"youtube"` - A link to a YouTube video.
+  * - `"auto"` (default) - Selects one of the above based on the [`imageLink`](https://surveyjs.io/form-library/documentation/questionimagemodel#imageLink) property.
   */
   get contentMode(): string;
   set contentMode(val: string);
   /*
-  * The rendered mode.
+  * Returns the type of content that the Image question displays: `"image"`, `"video"`, or `"youtube"`.
   */
   get renderedMode(): string;
   getImageCss(): string;
   protected calculateRenderedMode(): void;
 }
 /*
-* A base class for matrix dropdown and matrix dynamic questions.
+* A base class for the [QuestionMatrixDropdownModel](https://surveyjs.io/form-library/documentation/questionmatrixdropdownmodel) and [QuestionMatrixDynamicModel](https://surveyjs.io/form-library/documentation/questionmatrixdynamicmodel) classes.
 */
 export declare class QuestionMatrixDropdownModelBase extends QuestionMatrixBaseModel<MatrixDropdownRowModelBase, MatrixDropdownColumn> implements IMatrixDropdownData {
   constructor(name: string);
@@ -9210,34 +9283,53 @@ export declare class QuestionMatrixDropdownModelBase extends QuestionMatrixBaseM
   protected updateColumnsAndRows(): void;
   itemValuePropertyChanged(item: ItemValue, name: string, oldValue: any, newValue: any): void;
   /*
-  * Set columnLayout to 'vertical' to place columns vertically and rows horizontally. It makes sense when we have many columns and few rows.
+  * Specifies the matrix layout. Set this property to `"vertical"` if you want to display columns instead of rows and rows instead of columns.
+  * 
+  * Default value: `"horizontal"`
   */
   get columnLayout(): string;
   set columnLayout(val: string);
   get columnsLocation(): string;
   set columnsLocation(val: string);
   /*
-  * Returns true if columns are located horizontally
+  * Returns `true` if columns are placed in the horizontal direction and rows in the vertical direction.
+  * 
+  * To specify the layout, use the `columnLayout` property. If you set it to `"vertical"`, the survey applies it only when the screen has enough space. Otherwise, the survey falls back to the horizontal layout, but the `columnLayout` property remains set to `"vertical"`. Unlike `columnLayout`, the `isColumnLayoutHorizontal` property always indicates the current layout.
   */
   get isColumnLayoutHorizontal(): boolean;
   /*
-  * Set this property to true if you want to differ case sensitive values in unique columns, for example to allow enter "ABC" into the first row and "abc" into the second.
-  * It doesn't allow by default.
+  * Enables case-sensitive comparison in columns with the `isUnique` property set to `true`.
+  * 
+  * When this property is `true`, `"ABC"` and `"abc"` are considered different values.
+  * 
+  * Default value: `false`
   */
   get isUniqueCaseSensitive(): boolean;
   set isUniqueCaseSensitive(val: boolean);
   /*
-  * Set the value to "underRow" to show the detailPanel under the row.
+  * Specifies the location of detail sections.
+  * 
+  * Possible values:
+  * 
+  * - `"underRow"` - Displays detail sections under their respective rows. Users can expand any number of detail sections.
+  * - `"underRowSingle"` - Displays detail sections under their respective rows, but only one detail section can be expanded at a time.
+  * - `"none"` (default) - Hides detail sections.
+  * 
+  * Use the `detailElements` property to specify content of detail sections.
   */
   get detailPanelMode(): string;
   set detailPanelMode(val: string);
   /*
-  * The detail template Panel. This panel is used as a template on creating detail panel for a row.
+  * Contains a [`PanelModel`](https://surveyjs.io/form-library/documentation/panelmodel) instance that represents a detail section template.
   */
   get detailPanel(): PanelModel;
   getPanel(): IPanel;
   /*
-  * The template Panel elements, questions and panels.
+  * An array of survey elements (questions and panels) to be displayed in detail sections.
+  * 
+  * Detail sections are expandable panels displayed under each matrix row. You can use them to display questions that do not fit into the row.
+  * 
+  * Set the `detailPanelMode` property to `"underRow"` or `"underRowSingle"` to display detail sections.
   */
   get detailElements(): any;
   protected createNewDetailPanel(): PanelModel;
@@ -9259,12 +9351,27 @@ export declare class QuestionMatrixDropdownModelBase extends QuestionMatrixBaseM
   protected createRenderedTable(): QuestionMatrixDropdownRenderedTable;
   protected onMatrixRowCreated(row: MatrixDropdownRowModelBase): void;
   /*
-  * Use this property to change the default cell type.
+  * Specifies the type of matrix cells. You can override this property for individual columns.
+  * 
+  * Possible values:
+  * 
+  * - `"dropdown"`
+  * - `"checkbox"`
+  * - `"radiogroup"`
+  * - `"text"`
+  * - `"comment"`
+  * - `"boolean"`
+  * - `"expression"`
+  * - `"rating"`
+  * 
+  * Default value: "dropdown" (inherited from [`settings.matrixDefaultCellType`](https://surveyjs.io/form-library/documentation/settings#matrixDefaultCellType))
   */
   get cellType(): string;
   set cellType(val: string);
   /*
-  * The default column count for radiogroup and checkbox  cell types.
+  * Specifies the number of columns in Radiogroup and Checkbox cells.
+  * 
+  * Default value: 0 (the number of columns is selected automatically based on the available column width)
   */
   get columnColCount(): number;
   set columnColCount(val: number);
@@ -9273,14 +9380,8 @@ export declare class QuestionMatrixDropdownModelBase extends QuestionMatrixBaseM
   */
   get columnMinWidth(): string;
   set columnMinWidth(val: string);
-  /*
-  * Set this property to true to show the horizontal scroll.
-  */
   get horizontalScroll(): boolean;
   set horizontalScroll(val: boolean);
-  /*
-  * The Matrix toolbar and inner panel toolbars get adaptive if the property is set to true.
-  */
   get allowAdaptiveActions(): boolean;
   set allowAdaptiveActions(val: boolean);
   getRequiredText(): string;
@@ -9308,21 +9409,29 @@ export declare class QuestionMatrixDropdownModelBase extends QuestionMatrixBaseM
   protected runTotalsCondition(values: any, properties: any): void;
   locStrsChanged(): void;
   /*
-  * Returns the column by it's name. Returns null if a column with this name doesn't exist.
+  * Returns a matrix column with a given `name` or `null` if a column with this is not found.
   */
   getColumnByName(columnName: string): MatrixDropdownColumn;
   getColumnName(columnName: string): MatrixDropdownColumn;
-  /*
-  * Returns the column width.
-  */
   getColumnWidth(column: MatrixDropdownColumn): string;
   /*
-  * The default choices for dropdown, checkbox and radiogroup cell types.
+  * Gets or sets choice items for Dropdown, Checkbox, and Radiogroup matrix cells. You can override this property for individual columns.
+  * 
+  * This property accepts an array of objects with the following structure:
+  * 
+  * ```js
+  * {
+  *   "value": any, // A value to be saved in survey results
+  *   "text": String, // A display text. This property supports Markdown. When `text` is undefined, `value` is used.
+  * }
+  * ```
+  * 
+  * If you need to specify only the `value` property, you can set the `choices` property to an array of primitive values, for example, `[ "item1", "item2", "item3" ]`. These values are both saved in survey results and used as display text.
   */
   get choices(): any;
   set choices(val: any);
   /*
-  * The default placeholder for dropdown cell type.
+  * A placeholder for Dropdown matrix cells.
   */
   get placeholder(): string;
   set placeholder(val: string);
@@ -9330,7 +9439,9 @@ export declare class QuestionMatrixDropdownModelBase extends QuestionMatrixBaseM
   get optionsCaption(): string;
   set optionsCaption(val: string);
   /*
-  * The duplication value error text. Set it to show the text different from the default.
+  * An error message displayed when users enter a duplicate value into a column that accepts only unique values (`isUnique` is set to `true`).
+  * 
+  * A default value for this property is taken from a [localization dictionary](https://github.com/surveyjs/survey-library/tree/master/src/localization). Refer to the following help topic for more information: [Localization & Globalization](https://surveyjs.io/form-library/documentation/localization).
   */
   get keyDuplicationError(): string;
   set keyDuplicationError(val: string);
@@ -9343,12 +9454,12 @@ export declare class QuestionMatrixDropdownModelBase extends QuestionMatrixBaseM
   get visibleTotalRow(): MatrixDropdownRowModelBase;
   onSurveyLoad(): void;
   /*
-  * Returns the row value. If the row value is empty, the object is empty: {}.
+  * Returns an object with row values. If a row has no answers, this method returns an empty object.
   */
   getRowValue(rowIndex: number): any;
   checkIfValueInRowDuplicated(checkedRow: MatrixDropdownRowModelBase, cellQuestion: Question): boolean;
   /*
-  * Set the row value.
+  * Assigns values to a row.
   */
   setRowValue(rowIndex: number, rowValue: any): any;
   protected generateRows(): Array<MatrixDropdownRowModelBase>;
@@ -9696,7 +9807,9 @@ export declare class QuestionCheckboxModel extends QuestionCheckboxBase {
   get checkBoxSvgPath(): string;
 }
 /*
-* A Model for a select image question.
+* A class that describes the Image Picker question type.
+* 
+* [View Demo](https://surveyjs.io/form-library/examples/image-picker-question/ (linkStyle))
 */
 export declare class QuestionImagePickerModel extends QuestionCheckboxBase {
   constructor(name: string);
@@ -9709,18 +9822,17 @@ export declare class QuestionImagePickerModel extends QuestionCheckboxBase {
   supportNone(): boolean;
   isAnswerCorrect(): boolean;
   /*
-  * Multi select option. If set to true, then allows to select multiple images.
+  * Specifies whether users can select multiple images or videos.
+  * 
+  * Default value: `false`
   */
   get multiSelect(): boolean;
   set multiSelect(val: boolean);
-  /*
-  * Returns true if item is checked
-  */
   isItemSelected(item: ItemValue): boolean;
   clearIncorrectValues(): void;
   protected getDisplayValueCore(keysAsText: boolean, value: any): any;
   /*
-  * Show label under the image.
+  * Specifies whether to display labels under images or videos. Labels text are taken from the `text` property of each object in the `choices` array.
   */
   get showLabel(): boolean;
   set showLabel(val: boolean);
@@ -9729,26 +9841,43 @@ export declare class QuestionImagePickerModel extends QuestionCheckboxBase {
   protected renderedValueFromDataCore(val: any): any;
   protected rendredValueToDataCore(val: any): any;
   /*
-  * The image height.
+  * Specifies the height of containers for images or videos. Accepts positive numbers and CSS values.
+  * 
+  * Default value: undefined
+  * 
+  * Use the `imageFit` property to specify how to fit the images or videos into their containers.
   */
   get imageHeight(): number;
   set imageHeight(val: number);
   responsiveImageHeight: number;
   get renderedImageHeight(): string;
   /*
-  * The image width.
+  * Specifies the width of containers for images or videos. Accepts positive numbers and CSS values.
+  * 
+  * Default value: 200
+  * 
+  * Use the `imageFit` property to specify how to fit the images or videos into their containers.
   */
   get imageWidth(): number;
   set imageWidth(val: number);
   responsiveImageWidth: number;
   get renderedImageWidth(): string;
   /*
-  * The image fit mode.
+  * Specifies how to resize images or videos to fit them into their containers.
+  * 
+  * Refer to the [`object-fit`](https://developer.mozilla.org/en-US/docs/Web/CSS/object-fit) CSS property description for information on accepted values.
   */
   get imageFit(): string;
   set imageFit(val: string);
   /*
-  * The content mode.
+  * Specifies the type of content that choice items display.
+  * 
+  * Possible values:
+  * 
+  * - `"image"` - Images in one of the following formats: JPEG, GIF, PNG, APNG, SVG, BMP, ICO.
+  * - `"video"` - Videos in one of the following formats: MP4, MOV, WMV, FLV, AVI, MKV.
+  * - `"youtube"` - Links to YouTube videos.
+  * - `"auto"` (default) - Selects one of the above based on the `imageLink` property value of each choice item.
   */
   get contentMode(): string;
   set contentMode(val: string);
@@ -10065,6 +10194,8 @@ export declare class QuestionTagboxModel extends QuestionCheckboxModel {
   * Specifies whether to remove selected items from the drop-down list.
   */
   hideSelectedItems: boolean;
+  choicesLazyLoadEnabled: boolean;
+  choicesLazyLoadPageSize: number;
   /*
   * A text displayed in the input field when it doesn't have a value.
   */
@@ -10737,6 +10868,7 @@ export declare var matrixDropdownColumnTypes: {
   radiogroup: {
     onCellQuestionUpdate: (cellQuestion: any, column: any, question: any, data: any) => void,
   },
+  tagbox: any,
   text: any,
   comment: any,
   boolean: {